| public SetPartySizeForInvoice ( Context context, long invoiceNumber, int partySize ) : bool | ||
| context | Context | The store id, station id, and cashier id the information should be restricted to. |
| invoiceNumber | long | The number of the invoice that should be returned |
| partySize | int | The new number of guests in the party |
| return | bool | |
static void NewTest()
{
try
{
SalesAPI api = new SalesAPI();
pcAmerica.DesktopPOS.API.Client.SalesService.Context salesContext = new pcAmerica.DesktopPOS.API.Client.SalesService.Context();
salesContext.CashierID = "100101";
salesContext.StoreID = "1001";
salesContext.StationID = "07";
pcAmerica.DesktopPOS.API.Client.SalesService.Context context =
new pcAmerica.DesktopPOS.API.Client.SalesService.Context();
context.CashierID = "100101";
context.StoreID = "1001";
context.StationID = "07";
InventoryAPI InvApi = new InventoryAPI();
pcAmerica.DesktopPOS.API.Client.InventoryService.Context InvContext = new pcAmerica.DesktopPOS.API.Client.InventoryService.Context();
InvContext.CashierID = "100101";
InvContext.StationID = "07";
InvContext.StoreID = "1001";
// StartNewInvoice - this also automatically locks an invoice so it can't be opened by a terminal
Invoice inv = api.StartNewInvoice(context, "Luigi" + DateTime.Now.Second.ToString(), "XXOPEN TABS");
Console.WriteLine(String.Format("Started new invoice with #: {0}", inv.InvoiceNumber));
// getting invoice to show locked status should be locked by this station(7)
inv = api.GetInvoice(context, inv.InvoiceNumber);
if (inv.Locked == true)
{
Console.WriteLine("Invoice #{0} is locked by Station: {1}", inv.InvoiceNumber.ToString(), inv.LockedByStation);
}
else
{
Console.WriteLine("Invoice #{0} is unlocked", inv.InvoiceNumber.ToString());
}
//setting party size
api.SetPartySizeForInvoice(context, inv.InvoiceNumber, 3);
InventoryItem itemToAdd = InvApi.GetItem(InvContext, "SALAD1");
Guid itemToAddID = Guid.NewGuid();
LineItem LineItemToAdd = new LineItem() { Id = itemToAddID, ItemName = itemToAdd.ItemName, ItemNumber = itemToAdd.ItemNumber, Price = itemToAdd.Price, Quantity = 1, State = EntityState.Added, Guest = "42" };
inv.LineItems.Add(LineItemToAdd);
itemToAdd.ModifierGroups = InvApi.GetModiferGroupsForItem(InvContext, itemToAdd.ItemNumber);
foreach (ModifierGroup ModGroup in itemToAdd.ModifierGroups)
{
Console.WriteLine("ModifierGroup:{0}", ModGroup.ItemName);
Console.WriteLine("{0}", ModGroup.Prompt);
int i = 1;
if (ModGroup.Forced == false)
{
Console.WriteLine("{0} - NONE", i);
i++;
}
//NOTE THIS HAS CHANGED Modifier Items for Groups now are retrieved by calling GetModiferItemsForModiferGroups
ModGroup.ModifierItems = InvApi.GetModifierItemsForModifierGroup(InvContext, ModGroup.ItemNumber);
foreach (ModifierItem ModItem in ModGroup.ModifierItems)
{
Console.WriteLine("{0} - {1} : {2}", i, ModItem.ItemNumber, ModItem.ItemName);
i++;
}
string answer = Console.ReadLine();
if (answer.Length > 1)
{
Console.WriteLine("Invalid answer i Choose option 1 is chosen by default");
answer = "1";
}
else if (char.IsDigit(answer[0]) == false)
{
Console.WriteLine("Invalid answer i Choose option 1 chosen by defualt");
answer = "1";
}
InventoryItem dressing = InvApi.GetItem(InvContext, ModGroup.ModifierItems[Convert.ToInt32(answer) - 1].ItemNumber);
decimal Price = 0;
if (ModGroup.Charged == true) { Price = dressing.Price; }
inv.LineItems.Add(new LineItem() { Id = Guid.NewGuid(), ItemName = itemToAdd.ItemName, ItemNumber = dressing.ItemNumber, Price = dressing.Price, Quantity = 1, State = EntityState.Added, Guest = "42" });
}
// I created this item with the prompt description status set.
itemToAdd = InvApi.GetItem(InvContext, "MiscItem");
itemToAddID = Guid.NewGuid();
LineItemToAdd = new LineItem() { Id = itemToAddID, ItemName = "Keychain", ItemNumber = itemToAdd.ItemNumber, Price = itemToAdd.Price, Quantity = 1, State = EntityState.Added, Guest = "11" };
inv.LineItems.Add(LineItemToAdd);
api.ModifyItems(context, inv.InvoiceNumber, inv.LineItems);
api.UnLockInvoice(context, inv.InvoiceNumber);
inv = api.GetInvoice(context, inv.InvoiceNumber);
Console.WriteLine("The invoice has {0} guests", inv.PartySize);
foreach (LineItem individualItem in inv.LineItems)
{
Console.WriteLine("Guest {0} has ordered: {1}-{2}", individualItem.Guest, individualItem.ItemNumber, individualItem.ItemName);
}
//should show this invoice as locked by this station
api.LockInvoice(context, inv.InvoiceNumber);
List<OnHoldInfo> onHoldInfos = api.GetAllOnHoldInvoices(context);
Console.WriteLine(String.Format("Retrieved {0} OnHoldInfo from GetAllOnHoldInvoices",
onHoldInfos.Count));
foreach (OnHoldInfo onHoldInfo in onHoldInfos)
{
foreach (OnHoldInfo OHI in onHoldInfos)
{
if (OHI.Locked == true)
{
Console.WriteLine(String.Format("Invoice {0} is locked by Station {1}",
OHI.InvoiceNumber, OHI.LockedByStation));
}
}
}
//checking locked status should be locked by this station
inv = api.GetInvoice(context, inv.InvoiceNumber);
if (inv.Locked == true)
{
Console.WriteLine("Invoice #{0} is locked by Station: {1}", inv.InvoiceNumber.ToString(), inv.LockedByStation);
}
else
{
Console.WriteLine("Invoice #{0} is unlocked", inv.InvoiceNumber.ToString());
}
api.UnLockInvoice(context, inv.InvoiceNumber);
onHoldInfos.Clear();
onHoldInfos = api.GetAllOnHoldInvoices(context);
//should show this invoice as unlocked.
Console.WriteLine(String.Format("Retrieved {0} OnHoldInfo from GetAllOnHoldInvoices",
onHoldInfos.Count));
foreach (OnHoldInfo onHoldInfo in onHoldInfos)
{
foreach (OnHoldInfo OHI in onHoldInfos)
{
if (OHI.Locked == true)
{
Console.WriteLine(String.Format("Invoice {0} is locked by Station {1}",
OHI.InvoiceNumber, OHI.LockedByStation));
}
}
}
}
finally
{
Console.WriteLine("PRESS ENTER TO CONTINUE...");
Console.ReadLine();
}
}
// more examples to work specificly with the sample database Burger Express that comes bundled with Resturant Pro Express
// shows getting list of all inventory items, adding items two different ways, selecting a modifier for an item and splitting a check by guest
static void TestBurgerExpress()
{
try
{
SalesAPI api = new SalesAPI();
DateTime startDateTime = DateTime.Parse("1/1/2010");
DateTime endDateTime = DateTime.Parse("12/31/2010");
SalesTotals totals = api.GetTotals(startDateTime, endDateTime);
Console.WriteLine(String.Format("Sales totals between {0}-{1} -- NetSales:{2} TotalTax:{3} GrandTotal:{4}", startDateTime, endDateTime, totals.NetSales, totals.TotalTax, totals.GrandTotal));
List<ItemSale> sales = api.GetItemsSold(startDateTime, endDateTime);
Console.WriteLine(String.Format("Between {0}-{1}, there are {2} records of items being sold", startDateTime, endDateTime, sales.Count));
pcAmerica.DesktopPOS.API.Client.SalesService.Context context = new pcAmerica.DesktopPOS.API.Client.SalesService.Context();
context.CashierID = "100101";
context.StoreID = "1001";
context.StationID = "01";
// StartNewInvoice - this also automatically locks an invoice so it can't be opened by a terminal
Invoice inv = api.StartNewInvoice(context, "Dan" + DateTime.Now.Second.ToString(), "XXOPEN TABS");
Console.WriteLine(String.Format("Started new invoice with #: {0}", inv.InvoiceNumber));
// Unlock Invoice
if (api.UnLockInvoice(context, inv.InvoiceNumber))
Console.WriteLine(String.Format("Unlocked invoice # {0}", inv.InvoiceNumber));
else
Console.WriteLine(String.Format("Failed to unlock invoice # {0}", inv.InvoiceNumber));
// Lock Invoice
if (api.LockInvoice(context, inv.InvoiceNumber))
Console.WriteLine(String.Format("Locked invoice # {0}", inv.InvoiceNumber));
else
Console.WriteLine(String.Format("Failed to lock invoice # {0}", inv.InvoiceNumber));
// GetInvoiceHeader
inv = api.GetInvoiceHeader(context, inv.InvoiceNumber);
Console.WriteLine(String.Format("GetInvoiceHeader with #: {0}", inv.InvoiceNumber));
// GetInvoice
inv = api.GetInvoice(context, inv.InvoiceNumber);
Console.WriteLine(String.Format("GetInvoice with #: {0}", inv.InvoiceNumber));
InventoryAPI InvApi = new InventoryAPI();
pcAmerica.DesktopPOS.API.Client.InventoryService.Context InvContext = new pcAmerica.DesktopPOS.API.Client.InventoryService.Context();
InvContext.CashierID = "100101";
InvContext.StationID = "01";
InvContext.StoreID = "1001";
api.SetPartySizeForInvoice(context, inv.InvoiceNumber, 2);
List<InventoryItem> items = InvApi.GetItemListExtended(InvContext);
Console.WriteLine("*******************All Inventory Items************************");
foreach (InventoryItem singleItem in items)
{
Console.WriteLine(String.Format("Item#: {0} ItemName:{1}", singleItem.ItemNumber, singleItem.ItemName));
}
Console.WriteLine("***************************************************************");
// ModifyItems
inv.LineItems.Add(new LineItem() { Id = Guid.NewGuid(), ItemName = "TRIPPLE CHEESE BURGER", ItemNumber = "SAND4", Price = 3.99M, Quantity = 1, State = EntityState.Added, Guest = "1" });
InventoryItem itemToAdd = InvApi.GetItem(InvContext, "SALAD3");
Guid itemToAddID = Guid.NewGuid();
LineItem LineItemToAdd = new LineItem() { Id = itemToAddID, ItemName = itemToAdd.ItemName, ItemNumber = itemToAdd.ItemNumber, Price = itemToAdd.Price, Quantity = 1, State = EntityState.Added, Guest = "2" };
inv.LineItems.Add(LineItemToAdd);
itemToAdd.ModifierGroups = InvApi.GetModiferGroupsForItem(InvContext, itemToAdd.ItemNumber);
foreach (ModifierGroup ModGroup in itemToAdd.ModifierGroups)
{
Console.WriteLine("ModifierGroup:{0}", ModGroup.ItemName);
Console.WriteLine("{0}", ModGroup.Prompt);
int i = 1;
if (ModGroup.Forced == false)
{
Console.WriteLine("{0} - NONE", i);
i++;
}
//NOTE THIS HAS CHANGED Modifier Items for Groups now are retrieved by calling GetModiferItemsForModiferGroups
ModGroup.ModifierItems = InvApi.GetModifierItemsForModifierGroup(InvContext, ModGroup.ItemNumber);
foreach (ModifierItem ModItem in ModGroup.ModifierItems)
{
Console.WriteLine("{0} - {1} : {2}", i, ModItem.ItemNumber, ModItem.ItemName);
i++;
}
string answer = Console.ReadLine();
if (answer.Length > 1)
{
Console.WriteLine("Invalid answer i Choose option 1 is chosen by default");
answer = "1";
}
else if (char.IsDigit(answer[0]) == false)
{
Console.WriteLine("Invalid answer i Choose option 1 chosen by defualt");
answer = "1";
}
InventoryItem dressing = InvApi.GetItem(InvContext, ModGroup.ModifierItems[Convert.ToInt32(answer) - 1].ItemNumber);
decimal Price = 0;
if (ModGroup.Charged == true) { Price = dressing.Price; }
inv.LineItems.Add(new LineItem() { Id = Guid.NewGuid(), ItemName = dressing.ItemName, ItemNumber = dressing.ItemNumber, Price = dressing.Price, Quantity = 1, State = EntityState.Added, Guest = "2" });
}
itemToAdd = InvApi.GetItem(InvContext, "DaveBurger");
itemToAddID = Guid.NewGuid();
LineItemToAdd = new LineItem() { Id = itemToAddID, ItemName = itemToAdd.ItemName, ItemNumber = itemToAdd.ItemNumber, Price = itemToAdd.Price, Quantity = 1, State = EntityState.Added, Guest = "2" };
inv.LineItems.Add(LineItemToAdd);
itemToAdd.ModifierItems = InvApi.GetIndividualModifiers(InvContext, itemToAdd.ItemNumber);
if (itemToAdd.ModifierItems.Count > 0)
inv.LineItems.Add(new LineItem() { Id = Guid.NewGuid(), ItemName = itemToAdd.ModifierItems[0].ItemName, ItemNumber = itemToAdd.ModifierItems[0].ItemNumber, Price = 0.00M, Quantity = 1, State = EntityState.Added, Guest = "1" });
// This is a sample Kit Item I made that i added some items to you just have to ring up the base item(test) and the kit items will add along with it automaticly
itemToAdd = InvApi.GetItem(InvContext, "test");
itemToAddID = Guid.NewGuid();
LineItemToAdd = new LineItem() { Id = itemToAddID, ItemName = itemToAdd.ItemName, ItemNumber = itemToAdd.ItemNumber, Price = itemToAdd.Price, Quantity = 1, State = EntityState.Added, Guest = "2" };
inv.LineItems.Add(LineItemToAdd);
itemToAdd = InvApi.GetItem(InvContext, "test");
itemToAddID = Guid.NewGuid();
LineItemToAdd = new LineItem() { Id = itemToAddID, ItemName = itemToAdd.ItemName, ItemNumber = itemToAdd.ItemNumber, Price = itemToAdd.Price, Quantity = 1, State = EntityState.Added, Guest = "2" };
inv.LineItems.Add(LineItemToAdd);
itemToAdd = InvApi.GetItem(InvContext, "DRINKCHOICE");
int j = 1;
Console.WriteLine(itemToAdd.ItemName2);
InventoryItem Choice;
foreach (String choiceItemNumber in itemToAdd.ChoiceItems)
{
Choice = InvApi.GetItem(InvContext, choiceItemNumber);
Console.WriteLine(string.Format("{0}: ", Choice.ItemName));
j++;
}
int choiceItemSelection = Convert.ToInt32(Console.ReadLine()) - 1;
itemToAdd = InvApi.GetItem(InvContext, itemToAdd.ChoiceItems[choiceItemSelection]);
itemToAddID = Guid.NewGuid();
LineItemToAdd = new LineItem() { Id = itemToAddID, ItemName = itemToAdd.ItemName, ItemNumber = itemToAdd.ItemNumber, Price = itemToAdd.Price, Quantity = 1, State = EntityState.Added, Guest = "1" };
inv.LineItems.Add(LineItemToAdd);
inv = api.ModifyItems(context, inv.InvoiceNumber, inv.LineItems);
Console.WriteLine(String.Format("ModifyItems new invoice value: {0}", inv.GrandTotal));
inv.LineItems[0].Quantity = 2;
inv.LineItems[0].State = EntityState.Modified;
inv = api.ModifyItems(context, inv.InvoiceNumber, inv.LineItems);
Console.WriteLine(String.Format("ModifyItems CHANGED 1st item QUANTITY, new invoice value: {0}", inv.GrandTotal));
// SendToKitchen
if (api.SendToKitchen(context, inv.InvoiceNumber))
Console.WriteLine("Invoice was printed in kitchen");
else
Console.WriteLine("***ERROR*** Invoice was NOT printed in kitchen");
// Splitcheck
inv = api.SplitInvoiceByGuest(context, inv.InvoiceNumber);
if (inv.SplitInfo.NumberOfSplitChecks == 2)
Console.WriteLine("Split invoice by guest");
else
Console.WriteLine("***ERROR*** Invoice could be split");
// ApplyCashPayment - applying grand total minus 1 dollar (NOTE SPLITS Starts counting at 0 not 1)
AppliedPaymentResponse payResponse = api.ApplyCashPayment(context, inv.InvoiceNumber, 0, inv.SplitInfo.GrandTotalForSplit[0] - 1);
if (payResponse.Success)
Console.WriteLine(String.Format("Applied cash payment to split 1, change due {0}", payResponse.ChangeAmount));
else
Console.WriteLine("***ERROR*** Could not apply payment");
// ApplyCardPayment - applying remaining 1 dollar as a credit card
payResponse = api.ApplyCardPayment(context,
inv.InvoiceNumber,
0,
new pcAmerica.DesktopPOS.API.Client.SalesService.CreditCardPaymentProcessingResponse()
{
Amount = 1,
CardNumber = "4***********1",
ReferenceNumber = "123456",
Result = true,
TipAmount = 1,
TransactionNumber = 1234
}, -1);
if (payResponse.Success)
Console.WriteLine(String.Format("Applied card payment to split 1, change due {0}", payResponse.ChangeAmount));
else
Console.WriteLine("***ERROR*** Could not apply card payment");
payResponse = api.ApplyCashPayment(context, inv.InvoiceNumber, 1, inv.SplitInfo.GrandTotalForSplit[1] + 13);
if (payResponse.Success)
Console.WriteLine(String.Format("Applied cash payment to split 2, change due {0}", payResponse.ChangeAmount));
else
Console.WriteLine("***ERROR*** Could not apply payment");
// EndInvoice
if (api.EndInvoice(context, inv.InvoiceNumber))
Console.WriteLine("Ended invoice successfully");
else
Console.WriteLine("***ERROR*** Could not end invoice");
// looping and printing receipt for all splits
for (int i = 0; i < inv.SplitInfo.NumberOfSplitChecks; i++)
{
if (api.PrintReceipt(context, inv.InvoiceNumber, i))
Console.WriteLine("Receipt was printed");
else
Console.WriteLine("***ERROR*** Receive was NOT printed");
}
}
catch (Exception ex)
{
Console.WriteLine(ex);
}
finally
{
Console.WriteLine("PRESS ENTER TO CONTINUE...");
Console.ReadLine();
}
}
static void TestSplits()
{
try
{
SalesAPI api = new SalesAPI();
pcAmerica.DesktopPOS.API.Client.SalesService.Context context = new pcAmerica.DesktopPOS.API.Client.SalesService.Context();
context.CashierID = "100101";
context.StoreID = "1001";
context.StationID = "01";
Invoice inv = api.StartNewInvoice(context, "Rich", "XXOPEN TABS");
api.LockInvoice(context, inv.InvoiceNumber);
inv.LineItems.Add(new LineItem() { Id = Guid.NewGuid(), ItemName = "TRIPPLE CHEESE BURGER", ItemNumber = "SAND4", Price = 3.99M, Quantity = 3, State = EntityState.Added, Guest = "1" });
api.ModifyItems(context, inv.InvoiceNumber, inv.LineItems);
api.UnLockInvoice(context, inv.InvoiceNumber);
inv = api.SplitInvoice(context, inv.InvoiceNumber, 3);
for (int i = 0; i <= inv.SplitInfo.NumberOfSplitChecks - 1; i++)
{
Console.WriteLine(String.Format("Rich - Guest #{0}: ${1}", i + 1, inv.SplitInfo.GrandTotalForSplit[i]));
}
inv = api.StartNewInvoice(context, "Steve", "XXOPEN TABS");
api.SetPartySizeForInvoice(context, inv.InvoiceNumber, 3);
api.LockInvoice(context, inv.InvoiceNumber);
inv.LineItems.Add(new LineItem() { Id = Guid.NewGuid(), ItemName = "TRIPPLE CHEESE BURGER", ItemNumber = "SAND4", Price = 3.99M, Quantity = 1, State = EntityState.Added, Guest = "1" });
inv.LineItems.Add(new LineItem() { Id = Guid.NewGuid(), ItemName = "TRIPPLE CHEESE BURGER", ItemNumber = "SAND4", Price = 3.99M, Quantity = 1, State = EntityState.Added, Guest = "2" });
inv.LineItems.Add(new LineItem() { Id = Guid.NewGuid(), ItemName = "TRIPPLE CHEESE BURGER", ItemNumber = "SAND4", Price = 3.99M, Quantity = 1, State = EntityState.Added, Guest = "3" });
api.ModifyItems(context, inv.InvoiceNumber, inv.LineItems);
api.UnLockInvoice(context, inv.InvoiceNumber);
inv = api.SplitInvoice(context, inv.InvoiceNumber, 3);
api.ApplyCashPayment(context, inv.InvoiceNumber, 1, 2.00M);
api.ApplyCashPayment(context, inv.InvoiceNumber, 2, 50.00M);
//updates the split information so it has the payment info
inv = api.GetInvoiceHeader(context, inv.InvoiceNumber);
// shows split info grand total and if it is completly paid
// NOTE: Even if you have fully paid a sub check it won't be marked as paid until you run EndSubCheck on it
for (int i = 0; i <= inv.SplitInfo.NumberOfSplitChecks - 1; i++)
{
Console.WriteLine(String.Format("Steve - Grand Total SPLIT #{0}: ${1}", i + 1, inv.SplitInfo.GrandTotalForSplit[i]));
Console.WriteLine(String.Format("Steve - Paid SPLIT #{0}: {1}", i + 1, inv.SplitInfo.IsSplitPaid[i]));
}
api.EndSubCheck(context, inv.InvoiceNumber, 2);
inv = api.GetInvoiceHeader(context, inv.InvoiceNumber);
for (int i = 0; i <= inv.SplitInfo.NumberOfSplitChecks - 1; i++)
{
Console.WriteLine(String.Format("Steve - Grand Total SPLIT #{0}: ${1}", i + 1, inv.SplitInfo.GrandTotalForSplit[i]));
Console.WriteLine(String.Format("Steve - Paid SPLIT #{0}: {1}", i + 1, inv.SplitInfo.IsSplitPaid[i]));
}
}
finally
{
Console.WriteLine("PRESS ENTER TO CONTINUE...");
Console.ReadLine();
}
}
