Począwszy od API V8, stało się możliwe uzyskanie drukarki do dań.

Drukarkę do jedzenia można uzyskać za pośrednictwem IOperationService, używając metody TryGetDishPrinter.

Dla każdego działu (IRestaurantSection) można uzyskać własną, oddzielną drukarkę do jedzenia.
Jeśli nie określisz działu, dla którego chcesz uzyskać drukarkę do dań, domyślnie zostanie podjęta próba uzyskania drukarki do dań dla działu restauracyjnego stołu.

Następna wersja Syrve Office 8.3 została wydana, a wraz z nią wersja tymczasowa V8Preview4. Ta wersja będzie wspierana w 8.3 i 8.4.

Wersja V7Preview7, pomimo informacji z artykułu, nadal jest wspierana w 8.3. Więcej informacji o wersjach API tutaj.

Począwszy od API V8, stało się możliwe przerwanie płatności/anulowanie zamówienia, dokonanie/zwrot zaliczki.

Po dokonaniu płatności w systemie płatności (jeśli jest obsługiwany przez typ płatności), przed rozpoczęciem fiskalizacji, w rejestratorze fiskalnym wywoływane jest powiadomienie w API BeforeDoCheque. Wcześniej pozwalało to na zmianę zamówienia za pomocą IOperationService, dostępnego w argumentach powiadomienia, na przykład dodanie danych zewnętrznych (AddOrderExternalData. Pozwalało to również na interakcję z użytkownikiem poprzez IViewManager, wyświetlanie różnych okien w Syrve POS, jeśli płatność nie została wykonana w tle.

Teraz, oprócz tego wszystkiego, dodaliśmy możliwość anulowania procesu płatności poprzez wygenerowanie wyjątku OperationCanceledException w odpowiednim subskrybencie. Może to być wymagane w przypadkach, gdy sprawdzane są dodatkowe warunki, których niespełnienie może uniemożliwić zamknięcie/odwrócenie zamówienia lub płatność/zwrot zaliczki.

Ponadto, w argumentach powiadomienia pojawiła się lista płatności, na których obecnie wykonywana jest operacja i dla których należy wydrukować paragon.

Powiadomienie jest generowane zarówno dla fiskalnych, jak i niefiskalnych typów płatności.

W API V8 stało się możliwe rozróżnienie płatności rabatowych.

Wcześniej pisaliśmy note o płatnościach dokonanych jako rabat. Teraz istnieją płatności, które są fiskalizowane jako rabat. Takie płatności również są niefiskalne i są fiskalizowane po stronie kasy nie jako płatności, lecz jako rabaty poprzez obniżenie ceny potraw. Jednak w raportach OLAP na serwerze nadal są wyświetlane nie jako rabaty, lecz jako zwykłe niefiskalne płatności (podczas gdy płatności zaksięgowane jako rabat udają rabaty również w raportach OLAP).

W związku z tym nasze API przeszło następujące zmiany:

• Właściwość typu płatności IPaymentType.IsDiscount została usunięta. Zamiast niej dodano 2 właściwości:
  • IPaymentType.ProcessAsDiscount — czy typ płatności jest księgowany jako rabat.
  • IPaymentType.FiscalizeAsDiscount — czy typ płatności jest fiskalizowany jako rabat.
• Do elementu płatności zamówienia IPaymentItem dodano 2 właściwości:
  • IPaymentItem.IsProcessedAsDiscount — czy ta płatność została dokonana jako rabat. Ta właściwość ma sens tylko dla przedpłat: IPaymentItem.IsPrepay. Dla zwykłych płatności należy używać odpowiedniej właściwości typu płatności: IPaymentType.ProcessAsDiscount.
  • IPaymentItem.IsFiscalizedAsDiscount — czy ta płatność została fiskalizowana jako rabat. Ta właściwość ma sens tylko dla przedpłat: IPaymentItem.IsPrepay. Dla zwykłych płatności należy używać odpowiedniej właściwości typu płatności: IPaymentType.FiscalizeAsDiscount.
• Do elementu rabatu zamówienia IDiscountItem dodano nową właściwość IDiscountItem.DiscountPaymentItem — element płatności z listy IOrder.Payments, dokonanej lub fiskalizowanej jako rabat. Jeśli rabat nie jest opłacony, ta właściwość ma wartość null.
• Lista rabatów płatności nadal znajduje się w IOrder.PaymentDiscounts.

W API V8 stało się możliwe rozróżnienie zamówienia utworzonego w trybie szybkiej obsługi od zamówienia dla stolika. A także tworzenie tego lub innego zamówienia lub ich konwersja.

Do zamówienia dodano nową właściwość IOrder.IsFastFoodOrder, która wskazuje, czy zamówienie zostało utworzone w typie usługi Fast Food, czy też czy zamówienie zostało utworzone jako szybka obsługa w typie usługi Restauracja. Dla kart zamówień ta właściwość jest również ustawiona na true, więc dodatkowa kontrola dla kart pozostaje sprawdzaniem właściwości IOrder.TabName na null.

W metodzie CreateOrder pojawił się nowy opcjonalny argument z wartością domyślną: bool? isFastFoodOrder = null. Jeśli ustawisz jego wartość na true, zamówienie będzie wyświetlane jako szybki paragon.

Dodano również nową metodę do konwersji karty lub zamówienia utworzonego w trybie szybkiej obsługi na zamówienie dla stolika: ConvertToTableServiceOrder.

O kartach możesz przeczytać w notatce, w aktualnościach tutaj oraz w aktualnościach tutaj.

O nowej pracy w trybie szybkiej obsługi możesz przeczytać w artykułach.

Następna wersja została wydana Syrve 8.2, a wraz z nią wersja tymczasowa V8Preview3. Ta wersja będzie wspierana w 8.2 i 8.3.

Wersja V7Preview7, pomimo informacji z artykułu, nadal jest wspierana w 8.2. Dowiedz się więcej o wersjach API tutaj.

Dodano koncepcję przejazdu związanego z dostawą do V8Preview2 (Ride, a także kilka metod do pracy z nowym bytem.

Przejazd jest używany podczas dostarczania zamówień za pomocą zewnętrznych usług kurierskich, aby śledzić zamówienie od początkowego statusu poszukiwania zewnętrznego kuriera aż do końcowego statusu dostarczenia zamówienia klientowi.

Podstawowe właściwości przejazdu:

• Status pozwala kelnerowi zobaczyć, na jakim etapie jest dostawa zamówienia do klienta.
• StatusDetails pozwala przekazać dodatkowe informacje o przejeździe z systemu zewnętrznego do frontu.
• ExternalId — identyfikator przejazdu w systemie zewnętrznym.
• EcsId — ID zewnętrznej usługi kurierskiej.

Dodano trzy metody do pracy z przejazdami:

• ChangeRideStatus zmienia status przejazdu (Ride.Status).
• ChangeRideExternalId pozwala określić ID przejazdu w systemie zewnętrznym (Ride.ExternalId).
• ChangeRideExternalCouier zmienia kuriera zewnętrznej usługi kurierskiej na przejeździe związanym z dostawą.
  Ta metoda zastępuje ChangeDeliveryExternalCourier, która była wcześniej używana do zmiany zewnętrznego kuriera w samej dostawie.

API V8Preview2 ma teraz możliwość odbierania stawek podatkowych i kodów produktów.

Dodano możliwość poznania:

• Stawki podatku od produktu - TaxCategory;
• Kod UKTZED - OuterEconomicActivityNomenclatureCode. Do API dodano również interfejs IOuterEconomicActivityNomenclatureCode z następującymi polami:
  • IsMarked - czy produkt jest oznaczony;
  • AllowSkipMarkScan - czy można pominąć skanowanie znaku;
  • OuterEanCode - ciąg znaków z kodem UKTZED;
• Kod akcyzy zeskanowany podczas dodawania produktu - CommodityMark.

API V8Preview2 ma teraz możliwość pracy z zespołami kelnerów.

Dodano interfejs brygady kelnerów IWaiterTeam.

W API udostępniono również metody GetWaiterTeams, które umożliwiają uzyskanie listy wszystkich brygad, oraz TryGetWaiterTeamForUser, pozwalające na pobranie zespołu, do którego przypisany jest pracownik.

Więcej szczegółów na temat działania zespołów kelnerów w dokumentacji.

Następna wersja została wydana Syrve 8.1, a wraz z nią wersja pośrednia V8Preview2. Ta wersja będzie wspierana w 8.1 i 8.2.

Wersje V7Preview7 i V8Preview1 nadal są wspierane w 8.1, ale nie będą już wspierane w przyszłości. Więcej informacji o wersjach API tutaj.