Od API V8PreviewV7:

1. Metoda pobierania wszystkich użytkowników IOperationService.GetUsers domyślnie zwraca tylko pracowników aktualnego przedsiębiorstwa. Aby uzyskać wszystkich użytkowników Syrve HQ, należy przekazać parametr fromAllDepartments = true.
2. Dodano właściwość IUser.AssignedToCurrentDepartment — właściwość „czy użytkownicy należą do aktualnego przedsiębiorstwa”.

Począwszy od API V8PreviewV7, stało się możliwe zwracanie zakończonych płatności i przedpłat za pomocą IOperationService.UnprocessPayment.
Może to być wymagane w scenariuszach, gdy płatność została zainicjowana, ale paragon fiskalny nie został wydrukowany. Lub gdy płatność została dokonana wcześniej za pomocą metody IOperationService.ProcessPrepay, a teraz wymaga zwrotu.

Począwszy od V8Preview5, możesz ułatwić wypełnianie pól podczas edycji danych organizacji. Użytkownik będzie musiał wpisać tylko NIP, a następnie wtyczka wykona wyszukiwanie w zewnętrznym systemie, a Syrve POS uzupełni pozostałe dane firmy.

Do API dodano nową metodę RegisterExternalCompanyInfoSearchProvider, za pomocą której możesz zarejestrować w Syrve POS metodę pełniącą funkcję dostawcy wyszukiwania organizacji po NIP. Zakłada się, że w metodzie zwrotnej getCompanyInfoCallback twórcy wtyczki wywołają zewnętrzną usługę wyszukiwania firmy po NIP. To znaczy, że kelner, będąc w oknie "Szczegóły organizacji", będzie mógł automatycznie uzyskać informacje o nowej lub zaktualizować dane istniejącej organizacji.

Dodano klasę do przekazywania informacji o organizacji z wtyczki do Syrve POS ExternalCompanyInfo. Argumenty do RegisterExternalCompanyInfoSearchProvider przekazują metodę zwrotną Func<string, ExternalCompanyInfo> getCompanyInfoCallback, która jako wejście przyjmuje ciąg znaków z NIP wyszukiwanej organizacji i zwraca informacje o organizacji w dto typu ExternalCompanyInfo.

Dane organizacji zwrócone przez metodę getCompanyInfoCallback będą wyświetlane w oknie "Szczegóły organizacji". Dla organizacji, która już istnieje w Syrve POS, metoda getCompanyInfoCallback zostanie wywołana w oknie "Szczegóły organizacji" za pomocą przycisku "Aktualizuj", przyjmując jako wejście wartość z pola "NIP". Dla nowej organizacji dodawanej do Syrve POS metoda getCompanyInfoCallback zostanie wywołana po kliknięciu przycisku "Wyszukiwanie zewnętrzne" w oknie "Szczegóły organizacji", gdy w otwartym oknie dialogowym "Znajdź i dodaj nową organizację" zostanie kliknięty przycisk "Szukaj". W tym przypadku argumentem metody zwrotnej będzie wartość wpisana w polu wyszukiwania.

Wydano wersję pośrednią V8Preview6.

Teraz wersje pośrednie będą publikowane przed wydaniem kolejnej wersji Syrve Office (w tym przypadku przed wydaniem wersji 8.5), a usunięcie przestarzałej wersji Preview nastąpi jedną wersją później.
W ten sposób czas życia jednej wersji Preview wydłuża się o 3 miesiące.

Wersja V8Preview6 będzie wspierana w wersjach 8.5, 8.6 oraz 8.7.
Okres wsparcia dla wersji V8Preview4 i V8Preview5 również został wydłużony.
Czas wsparcia dla wersji LTS API nie ulegnie zmianie i wyniesie około 4 lat.
Wersja V7Preview7 nie będzie już wspierana począwszy od wersji 8.6.
Więcej informacji o wersjach API znajdziesz tutaj.

W API V8Preview7, w celu unifikacji z OperationServiceExtensions, gdzie typ parametru ICredentials jest ostatnim z parametrów bez wartości domyślnej, w metodach interfejsu IOperationService ten parametr jest teraz przekazywany jako ostatni.

Przykład zmiany: os.DeteteOrder(auth, order) => os.DeteteOrder(order, auth)

W Api V8Preview6 dla zamówień kuchennych dodano możliwość tworzenia zamówień uzupełniających dla zamówień kuchennych.

Tworzenie zamówienia uzupełniającego kuchni następuje po utworzeniu odpowiedniego zamówienia uzupełniającego dla zamkniętego zamówienia na stanowisku kelnera. Oznacza to, że jeśli zamówienie uzupełniające zostanie utworzone na stanowisku kelnera, to podczas jego wydruku utworzone zamówienie kuchenne będzie również zamówieniem uzupełniającym dla zamówienia kuchennego, dla części kelnerskiej którego zamówienie uzupełniające zostało wykonane.

W tym celu do IKitchenOrder dodano pole GroupKitchenOrderId, które zawiera identyfikator zamówienia kuchennego, dla którego to zamówienie jest zamówieniem uzupełniającym.

Alternatywnie można oznaczyć zamówienie jako uzupełniające za pomocą operacji MarkOrderAsAdditional. Istniejące zamówienia kuchenne otrzymają takie samo powiązanie jak ich części kelnerskie.

W API V8Preview6 opisano nową listę w RemovedItems w news.

Interfejs IRemovedOrderItem został rozszerzony. Dodano do niego dwa pola Id oraz ParentId. Pola te pozwolą znaleźć powiązanie między usuniętymi modyfikatorami a daniami, do których się odnoszą.

Warto zwrócić uwagę na osobny przypadek przy usuwaniu pizz: ponieważ pizza składa się faktycznie z PrimaryComponent oraz SecondaryComponent, to podczas usuwania wspólne modyfikatory z listy CommonModifiers zostaną równomiernie podzielone pomiędzy wszystkie składniki pizzy.

Począwszy od API V8Preview4, do zamówienia dodano nową właściwość IOrder.ExternalNumber, która przechowuje numer zamówienia w systemie zewnętrznym.
Wartość tej właściwości można zmienić za pomocą nowej metody IEditSession.ChangeOrderExternalNumber.

Właściwość ExternalNumber może być teraz używana do tworzenia raportów sprzedaży OLAP dla zamówień, które trafiły do SyrvePOS z systemów zewnętrznych. Wartość ExternalNumber jest wyświetlana w Raporcie Sprzedaży w kolumnie „Numer zamówienia zewnętrznego”.

API V8Preview6 dodało możliwość pobierania dodatkowych właściwości za pomocą IOperationService.GetCashRegisterStatus.

Nowo dodane pola:

• SerialNumber - Numer seryjny kasy fiskalnej
• SessionNumber - Numer bieżącej sesji
• RefundsCount - Liczba zwrotów na zmianę
• RefundsSum - Suma zwrotów na zmianę
• CancelCount - Liczba anulowań na zmianę
• CancelSum - Suma anulowań na zmianę
• SalesCount - Liczba sprzedaży na zmianę
• SalesSum - Suma sprzedaży na zmianę
• SalesSumTotal - Całkowita suma sprzedaży kasy fiskalnej
• CashPaymentSum - Suma sprzedaży płatności gotówkowych na zmianę
• NonCashPaymentsSum - Suma sprzedaży płatności bezgotówkowych na zmianę

Aby otrzymać dane, należy przekazać dodatkowe wartości w GetCashRegisterStatusTask.StatusFields, które odpowiadają wymaganym danym.
Lista wszystkich możliwych wartości - CashRegisterStatusField.

W Api V8Preview6 dla zamówień kuchennych dodano możliwość ustawienia publiczności danych dla ExternalData.

Aby to zrobić, w metodzie AddOrUpdateKitchenOrderExternalData dodano dodatkowy parametr isPublic.