Nadal rozwijamy możliwości publicznego API v2 w RO App. Teraz przez API można zarządzać zadaniami pracowników, ustawiać minimalne i maksymalne stany magazynowe towarów w magazynach, a także dokładniej powiązywać faktury ze zleceniami. Pomoże to synchronizować dane z innymi systemami i nie wprowadzać ich ręcznie. Ponadto pojawiły się nowe webhooki dla zadań.
Zadania przez API
W publicznym API v2 pojawiły się endpointy do pracy z zadaniami. Obsługują one statusy i priorytet zadań, dzięki czemu dane w API są zgodne z tym, co widzisz w RO App.
Teraz możesz:
pobierać listę zadań lub pojedyncze zadanie – z nazwą, opisem, statusem, priorytetem, autorem, wykonawcami, terminem końcowym i powiązanym rekordem;
tworzyć, edytować i usuwać zadania;
zmieniać status zadania i dodawać do niego komentarze;
pobierać listę statusów zadań.
Zadania można filtrować według statusów, priorytetu, autora, wykonawców, daty utworzenia i terminu końcowego. Dostępne są też osobne filtry dla zadań przeterminowanych i zadań bez wykonawcy. Listę można sortować według daty utworzenia, daty zmiany, terminu końcowego lub priorytetu.
Zwróć uwagę: nowe zadanie jest zawsze tworzone w początkowym statusie, a zmienić go można osobnym żądaniem. Przez API można ustawić tylko taki status, który jest dostępny dla roli pracownika, tak jak w wersji webowej. Zmiana statusu przez API jest rejestrowana w zadaniu tak samo jak zmiana ręczna.
Dodaliśmy też nowe webhooki dla zadań – na zmianę statusu i priorytetu. Dzięki temu inne systemy od razu się o tym dowiadują, bez regularnych zapytań do API. Aby je podłączyć, podczas konfiguracji webhooka wybierz zdarzenia "Status zmieniony" i "Priorytet zmieniony" w bloku "Zadania".
Więcej informacji – w dokumentacji endpointów dla zadań.
Minimalne i maksymalne stany magazynowe
Teraz minimalne i maksymalne stany magazynowe towarów można ustawiać przez API – osobno dla każdego magazynu. Możesz:
pobierać minimalne i maksymalne stany magazynowe towaru we wszystkich magazynach lub w konkretnym magazynie;
ustawiać i zmieniać je dla magazynu;
usuwać je dla magazynu, jeśli nie są już potrzebne.
Towary ze stanem poniżej minimalnego pojawiają się na stronie "Towary do ponownego zamówienia". Jeśli planujesz zakupy w innym systemie, możesz przekazywać te ustawienia z niego automatycznie, zamiast ręcznie uzupełniać karty towarów.
Więcej informacji – w dokumentacji endpointów dla minimalnych i maksymalnych stanów magazynowych.
Faktury i zlecenia
Ulepszyliśmy również endpointy do pracy z fakturami, aby łatwiej było powiązywać faktury ze zleceniami. Teraz:
pozycje faktury zawierają ID zlecenia, z którego zostały dodane;
listę faktur można filtrować według zlecenia – otrzymasz wszystkie faktury, w których jest co najmniej jedna pozycja z tego zlecenia;
za pomocą nowego endpointu można dodawać do faktury pozycje ze zleceń.
Więcej informacji – w dokumentacji endpointu do dodawania pozycji ze zleceń do faktury.
Jak nowe endpointy pomogą Twojej firmie
Na przykład dzięki nim możesz:
synchronizować zadania z narzędziami do zarządzania zadaniami i kalendarzami pracowników;
automatycznie tworzyć zadania na podstawie zdarzeń w innych systemach – na przykład przypomnienie o oddzwonieniu do klienta;
tworzyć własne raporty dotyczące realizacji i przeterminowania zadań;
jednocześnie aktualizować minimalne i maksymalne stany magazynowe dla wielu towarów i magazynów – na przykład przed sezonem;
automatycznie wystawiać faktury na pozycje ze zleceń i sprawdzać, czy wszystko zostało już zafakturowane klientowi.
Dostęp do endpointów
Klucz API należy do konkretnego pracownika RO App i ma te same uprawnienia dostępu co on. Na przykład, aby pracować z zadaniami przez API, pracownik potrzebuje odpowiednich uprawnień w roli: do przeglądania, tworzenia, edytowania lub usuwania zadań.
Jeśli masz pytania, sugestie lub uwagi dotyczące publicznego API i webhooków RO App, skontaktuj się z nami przez czat pomocy technicznej.