W wersji API V8Preview6 dla zamówień kuchennych stało się możliwe uzyskanie szczegółów dotyczących modyfikatorów, które powinny być ukryte, oraz modyfikatorów zdalnych, które byłyby ukryte, gdyby były częścią dania.

• Do modyfikatora kuchennego IKitchenOrderModifierItem dodano właściwość IsHidden, która oznacza, że modyfikator nie powinien być wyświetlany ani na paragonie serwisowym, ani na ekranie kuchennym (KDS). Taki modyfikator ma zaznaczoną opcję „Ukryj, jeśli ilość domyślna”, „Ilość domyślna” jest większa od zera, a modyfikator został dodany do dania tylko z domyślną ilością.

• Dodano listę modyfikatorów do zwykłego dania, dania złożonego oraz komponentu dania złożonego, które zostały dodane do dania z niezerową domyślną ilością, a następnie usunięte z dania (modyfikatory x0):

  • IKitchenOrderProductItem.ZeroAmountModifiersData
  • IKitchenOrderCompoundItem.ZeroAmountCommonModifiersData
  • IKitchenOrderCompoundItemComponent.ZeroAmountModifiersData

W API V8Preview6 dla metody ChangeSelectiveDiscount dodano przeciążenie. To przeciążenie pozwala przekazać listę par składających się z elementów Id zamówienia oraz odpowiadających im kwot zniżek, które mają zostać im przypisane.

W API V8Preview6 w [IKitchenOrder](https://syrve.github.io/front.api.sdk/v8/html/Properties_T_Resto_Front_Api_Data_Kitchen_IKitchenOrder.htm właściwości została ustawiona ExternalNumber, która reprezentuje numer zamówienia w systemie zewnętrznym.

W API V8Preview6 dodano do informacji o zamówieniu listę RemovedItems. Ta lista zawiera dania, które zostały usunięte z zamówienia bez drukowania. Interfejs API został ustawiony dla tych dań IRemovedOrderItem.

Do API V8Preview6 dodano metody do pracy bezpośrednio z kasą fiskalną

Otwarcie sesji kasy fiskalnej na kasie
OpenCashRegisterSession
Obsługiwane tylko jeśli moduł 21052601 jest zawarty w licencji. Dla poprawnego działania urządzenie musi być włączone, a zmiana na urządzeniu musi być zamknięta.
Aby wykonać operację, użytkownik musi mieć uprawnienie CAN_EXECUTE_FISCAL_REGISTER_COMMANDS.

Zamknięcie sesji kasy fiskalnej (wydruk raportu Z)
DoZReport
Obsługiwane tylko jeśli moduł 21052601 jest zawarty w licencji. Dla poprawnego działania urządzenie musi być włączone, a zmiana na urządzeniu musi być zamknięta.
Aby wykonać operację, użytkownik musi mieć uprawnienie CAN_EXECUTE_FISCAL_REGISTER_COMMANDS.
Jeśli parametr [printCashRegisterTape] jest ustawiony, dziennik dobowy zostanie wydrukowany wraz z raportem Z.

Otwarcie szuflady kasowej
CashRegisterOpenDrawer
Aby wykonać operację, użytkownik musi mieć uprawnienie CAN_EXECUTE_FISCAL_REGISTER_COMMANDS.
Ta wersja obsługuje tylko otwieranie szuflady kasowej podłączonej do kasy fiskalnej; praca z zewnętrzną szufladą kasową nie jest wspierana.

Pobranie aktualnego statusu kasy fiskalnej
GetCashRegisterStatus
Aby wykonać operację, użytkownik musi mieć uprawnienie CAN_EXECUTE_FISCAL_REGISTER_COMMANDS.
Metoda przyjmuje listę CashRegisterStatusField
i wypełnia właściwości zwracanego obiektu CashRegisterStatus odpowiadające tym przekazanym na liście.
Przy przekazaniu pustej listy zwracany jest domyślny obiekt CashRegisterStatus.

Zwracanie dodatkowych obsługiwanych operacji
GetQueryInfo
Zwraca dodatkowe obsługiwane operacje QueryInfoResult.SupportedCommands,
które można wywołać metodą CashRegisterDirectIO.

Wykonanie dodatkowej operacji
CashRegisterDirectIO
Aby wykonać operację, użytkownik musi mieć uprawnienie CAN_EXECUTE_FISCAL_REGISTER_COMMANDS.
Pozwala wykonać dodatkową operację, należy przekazać ją w parametrze CommandExecute
nazwa dodatkowej operacji Name oraz wartości parametrów Parameters.
Metoda ta służy do wykonywania operacji specyficznych dla konkretnego modelu kasy fiskalnej, które nie odpowiadają żadnej metodzie ogólnego interfejsu ICashRegister.

Start kasy fiskalnej
CashRegisterStart

Stop kasy fiskalnej
CashRegisterStop
Urządzenia startują wraz z uruchomieniem SyrvePOS i zatrzymują się przy zamknięciu SyrvePOS (jeśli w ustawieniach urządzenia jest włączony autostart).
Polecenia startu i zatrzymania kasy fiskalnej są potrzebne, aby można było zatrzymać urządzenie i zwolnić port COM lub inny port zajmowany przez urządzenie, a następnie uruchomić urządzenie
bez konieczności ponownego uruchamiania SyrvePOS.

Sprawdzanie kodu znakowania
CheckFfd12Marking
Aby wykonać operację, użytkownik musi mieć uprawnienie CAN_EXECUTE_FISCAL_REGISTER_COMMANDS.
Sprawdza kod znakowania w formacie FFD 1.2 pozycji paragonu ChequeSale.
Parametr musi mieć niepustą właściwość Ffd12.

W Api V8 stało się możliwe dodanie dania w tylko jednym rozmiarze lub bez określania rozmiaru do listy wycofanych produktów AddProductToStopList.

Teraz można zobaczyć, że danie o określonym rozmiarze zostało dodane do listy wycofanych produktów IsStopListProductSellingRestricted.

Aby uzyskać pełną listę wycofanych produktów, należy teraz użyć wywołania GetStopListProductsRemainingAmounts, które zwraca słownik z kluczem instancji ProductAndSize, zawierający konkretny produkt IProduct oraz jego rozmiar IProductSize.

Aby usunąć wszystkie elementy z listy wycofanych produktów, należy użyć funkcji ClearStopList.

Usunięcie konkretnego dania z listy wycofanych produktów RemoveProductFromStopList, gdzie musi być podany produkt/danie, ale rozmiar jest opcjonalny i może być null.

Ustawianie pozostałej ilości dla dania na liście wycofanych produktów SetStopListProductRemainingAmount - można podać tylko wartości od 0.001 do 999.999, rozmiar jest opcjonalny i może być null.

Sprawdzenie limitu sprzedaży produktów zostało przemianowane na CheckStopListProductsSellingRestrictions i teraz przyjmuje słownik, gdzie kluczem jest ProductAndSize, ale wartość pozostaje tą samą ilością.

Gdy użytkownik, który nie ma prawa do czyszczenia/usuwania/dodawania/ustawiania salda na listach wycofanych produktów (Edycja listy wycofanych i szybkie menu F_EM), próbuje użyć wywołań API, zostanie wyświetlony wyjątek.

Przy próbie dodania dania z rozmiarem do listy wycofanych produktów zawsze sprawdzane jest, czy rozmiar dla dania może być zastosowany zgodnie z jego skalą rozmiarów, w przeciwnym razie zostanie zgłoszony wyjątek.

Aby śledzić zmiany na listach wycofanych produktów, zdarzenie zostało przemianowane z ProductsRemainingAmountsChanged na StopListProductsRemainingAmountsChanged.

Kolejna wersja została wydana Syrve Office 8.4, a wraz z nią wersja tymczasowa V8Preview5. Ta wersja będzie wspierana w 8.4 i 8.5.

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

W Api V8 dodano metodę do uzyskania kwoty gotówki przy kasie dla ICafeSession obecna metoda terminala GetHostTerminalCafeSessionCashSum.

Dodano właściwość do Api V8Preview6 IUser.PublicExternalData.
Te dane nie są ustawiane z poziomu interfejsu Syrve Office.
Zakłada się, że są przypisane do zadań biznesowych konkretnego klienta.
Dane te będą zapisywane bezpośrednio do obiektu Syrve Office user za pomocą API serwera lub przez specjalne wtyczki SyrveApp.

W Api V8 dodano możliwość zapisywania ExternalData dla zamówień kuchennych. Pozwoli to na przechowywanie i przesyłanie niezbędnych dodatkowych informacji związanych z zamówieniem.

W tym celu w API utworzono 3 metody:

• AddOrUpdateKitchenOrderExternalData(IKitchenOrder order, string key, string value) - Dodawanie informacji value z kluczem key do zamówienia kuchennego order;
• TryGetKitchenOrderExternalDataByKey(IKitchenOrder order, string key - Próba pobrania informacji ExternalData z zamówienia order o kluczu key;
• DeleteKitchenOrderExternalData(IKitchenOrder order, string key) - Usunięcie rekordu z zamówienia order o kluczu key.