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 |
리턴 | 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(); } }