API i integracja z ERP
Jak DGAssistant współpracuje z Państwa systemem ERP, WMS lub platformą wysyłkową.
Czy DGAssistant można zintegrować z systemem ERP, takim jak SAP, SAGE X3, Dynamics czy Navision?
Tak. JSON REST API DGAssistant zaprojektowano z myślą o integracji z systemami ERP i logistycznymi. Klienci zintegrowali je z SAP, SAGE X3 i kilkoma innymi systemami. Samą integrację przeprowadza Państwa dział IT lub partner wdrażający system ERP, przy stałym wsparciu zespołu DGAssistant na etapie analizy, implementacji i uruchomienia produkcyjnego.
Czy do korzystania z API potrzebny jest specjalny moduł?
Tak, API jest osobno licencjonowanym modułem, dodawanym do standardowych licencji. Dołącza się go do subskrypcji w momencie podjęcia decyzji o integracji.
Jak mierzy się i wycenia korzystanie z API?
Korzystanie z API jest rozliczane według licencji: każda z nich obejmuje 1500 przesyłek i 10 000 wywołań usługi rocznie oraz pozwala przechowywać w bazie danych do 5000 obiektów innych niż przesyłki, takich jak produkty i uczestnicy (odbiorcy, dostawcy, kierowcy i pozostali). Jeżeli przewidują Państwo większy wolumen, wystarczy dokupić kolejne licencje. Dokładna cena jednostkowa modułu API jest podana wraz z resztą oferty w naszym sklepie i może zostać uwzględniona w każdej indywidualnej ofercie.
Jakie są dwa sposoby korzystania z API: tryb wsadowy i tryb interaktywny?
Tryb wsadowy przyjmuje pełną specyfikację przesyłki w jednym wywołaniu usługi – to idealne rozwiązanie, gdy system ERP zna już towary, uczestników i ilości. Tryb interaktywny pozwala budować przesyłkę krok po kroku, z weryfikacją każdego towaru w chwili jego dodania; jest bliższy sposobowi działania aplikacji internetowej i przydaje się, gdy na bazie API potrzebne są procesy sterowane przez użytkownika.
Czy produkty i uczestników należy tworzyć z wyprzedzeniem, czy „na bieżąco”?
Obsługiwane są oba podejścia. Zalecane jest podejście „dane predefiniowane”: towary i uczestników tworzy się jednorazowo w aplikacji internetowej (lub importuje), a w wywołaniach API odwołuje się do nich za pomocą kodu. Podejście „na bieżąco” pozwala przesyłać wszystkie dane w każdym wywołaniu, co jest wygodne, gdy źródłem tych danych jest system ERP i nie chcą Państwo wczytywać ich wcześniej.
Jak pobrać wygenerowane pliki PDF przez API?
Są dwie możliwości. Dokumenty można otrzymać w odpowiedzi API jako pliki PDF zakodowane w base64 (dokument przewozowy, deklaracja nadawcy, lista kontrolna, oznakowanie sztuk przesyłek itp.) albo zlecić platformie ich automatyczne wysyłanie pocztą elektroniczną na skonfigurowany adres.
Czy dokumenty wygenerowane przez API można drukować automatycznie?
Tak. Sprawdzają się dwa rozwiązania: (a) system ERP pobiera plik PDF z API i wysyła go do własnej kolejki wydruku; (b) DGAssistant wysyła dokumenty pocztą elektroniczną na wydzieloną skrzynkę, a niewielkie narzędzie do automatycznego drukowania po Państwa stronie drukuje je na właściwej drukarce. Wielu klientów korzysta z rozwiązania opartego na poczcie elektronicznej, ponieważ nie wymaga ono dodatkowego kodu po stronie ERP.
Gdzie znajduje się specyfikacja API?
Pełna specyfikacja OpenAPI jest opublikowana w dokumentacji API dla towarów niebezpiecznych. Udostępniamy również projekt SoapUI z gotowymi, realistycznymi wywołaniami testowymi, dzięki któremu Państwa programiści mogą poznać API w kilka minut.
Czym jest requestGuid i dlaczego jest wymagany?
Każde wywołanie API musi zawierać unikalny requestGuid, który identyfikuje żądanie w naszych logach i pozwala zespołowi wsparcia odnaleźć dokładnie tę transakcję, gdy zgłaszają Państwo problem. Akceptowana jest dowolna unikalna wartość alfanumeryczna; zalecamy generowanie standardowego identyfikatora UUID/GUID po stronie klienta.
Jaka jest najczęstsza przyczyna niepowodzenia wywołania API przy pierwszej próbie?
Dane uwierzytelniające, których usługa nie akceptuje: brakujący lub nieprawidłowy nagłówek HTTP Basic Authorization albo – gdy wywołanie jest uwierzytelniane za pomocą OAuth2 – token dostępu, o który nigdy nie wystąpiono, który należy do innego środowiska lub który już wygasł. Istnieje specjalny adres URL pomocy technicznej, pod którym można sprawdzić, czy API działa i czy dane uwierzytelniające są prawidłowe. Jeżeli problemu nie udaje się rozwiązać, prosimy przesłać nam pełne żądanie i odpowiedź HTTP (wraz z requestGuid) oraz opis oczekiwanego zachowania – to najszybciej pozwala usunąć problem.