Dodaliśmy do komunikacji z klientem dodatkową wiadomość, informującą o odbiorze naprawy w serwisie. Wiadomość działa dla napraw przyjętych przez panel kliencki i zostanie wysłana do klienta w momencie, kiedy stan naprawy zmieni się z „oczekuje na doręczenie” na „oczekuje na diagnozę” lub późniejszy. Wiadomość ma na celu poinformowanie klienta, o odbiorze wysłanej przez niego naprawy w serwisie. Standardowo wysyłamy wiadomości email – opcjonalnie mogą Państwo w konfiguracji włączyć wysyłkę wiadomości SMS. Także tam, standardowo można zaktualizować treść wysyłanych wiadomości.
Archiwum miesiąca: czerwiec 2022
4 wpisy
Dla tych Państwa, którzy korzystają z pełnego panelu klienckiego w kontakcie z klientami oddajemy kolejną nowość. Od dzisiaj automatycznie generowane adresy panelu można samodzielnie zmienić, używając np. nazwy firmy.
Fukcjonalność obejmuje zachowanie używanych poprzednio adresów – klienci, którzy mają zapisane adresy panelu przed zmianą nadal będą mogli się do nich dostać.
Adres panelu można zmienić przy użyciu narzędzia do konfiguracji panelu klienckiego, które można znaleźć tutaj: https://serwisant.online/internet_modules
Wszystkich Państwa korzystających z API serwisant.online prosimy o zapoznanie się z komunikatem o zmianach zamieszczonych na stronie serwisant.online API – wymagana akcja związana ze zmianą w API
Po 20 września 2022:
- usuniemy typ Money zastępując do typem Decimal
- wdrożymy rozszerzoną obsługę tzw. complexity dla zapytań GraphQL
Money
Z uwagi na redundancję typów, typ Money zastąpimy typem Decimal. Różnica polega na formacie który będzie zwracany – zamiast łańcucha znaków zwracać będziemy liczbę decymalną, o stałej precyzji, prezentowaną jako typ numeryczny.
Co muszę zrobić?
Zweryfikuj swój kod i upewnij się, że zwracaną przez API wartość poprawnie konwertujesz na pożądany typ oraz używany przez ciebie język podczas konwersji poprawnie zachowuje się podczas rzutowania łańcucha znaków (string) oraz liczby zmiennoprzecinkowej (float) na pożądany typ.
Dodatkowo, jeśli opierasz formatowanie wartości, np ceny, na tym, co uzyskujesz z API będziesz musiał zapewnić samodzielne formatowanie wartości zgodnie z potrzebami. Po 20 września zwracana wartość będzie pozbawiona formatowania typowego dla waluty.
Complexity
Informacje o zagadnieniu complexity znajdą Państwo tutaj: https://github.com/SerwisantOnline/serwisant-api#complexity
Ogólnie: zbyt złożone zapytania do API będą blokowane na etapie parsowania składni zapytania i zwrócą komunikat błędu.
Aby uniknąć tej sytuacji, należy zastosować się do następujących wskazówek:
- dla zapytań pobierających pełne listy encji, np. spis napraw, klientów podawać minimalny zestaw pól (np ID i nazwa wyświetlana)
- pojedyncze encje, które wymagają większej ilości pól (danych) pobierać z filtrem ID i zawsze określać wprost parametr limit: 1
Prosimy o zweryfikowanie Państwa kodu i optymalizację przed 20 września. Zwracamy uwagę szczególnie na drugie zalecenie, ponieważ będzie ono wymagało zmiany w Państwa integracjach.
Nie podajemy teraz wartości granicznej complexity, ponieważ tę ustalimy stosownie do sytuacji, tak, aby zminimalizować wpływ tej zmiany na Państwa. W limit complexity wpadną wyłącznie aplikacje napisane w sposób mocno nieprawidłowy.
Dodatkowo:
- zastrzegamy sobie prawo do wprowadzania przed 20 września trwałego ograniczenia complexity dla indywidualnych integracji, które w sposób abuzywny bedą korzystały z API, powodując zakłócenia w działaniu naszej infrastruktury.
- po 20 września będzie istniała możliwość indywidualnego podniesienia wartości complexity, o ile będzie to miało uzasadnienie z Państwa strony.