Integracja API e-listow przewozowych: Podłączenie ERP/DMS do portalu

Dlaczego integracja API jest niezbedna

Portal ma interfejs webowy do ręcznego wprowadzania, ale dla firm wysyłających więcej niż 5-10 listów przewozowych dziennie ręczne wprowadzanie jest nie do utrzymania. Integracja API umozliwia automatyczne tworzenie, potwierdzanie odbioru i synchronizacje statusów.

Architektura systemu

Protokół: HTTPS (TLS 1.2+)
Format: JSON
Uwierzytelnianie: Kwalifikowany certyfikat elektroniczny (wzajemny TLS) + klucz API
Dokumentacja: Dostepna na portalu po rejestracji

Kluczowe endpointy API

Endpoint	Metoda	Opis
/api/v1/delivery-notes	POST	Utworzenie nowego e-listu przewozowego
/api/v1/delivery-notes/{id}	GET	Podgląd pojedynczego listu przewozowego
/api/v1/delivery-notes	GET	Lista listów przewozowych (z filtrami)
/api/v1/receipt-notes	POST	Utworzenie potwierdzenia odbioru
/api/v1/delivery-notes/{id}/status	GET	Status listu przewozowego
/api/v1/delivery-notes/{id}/pdf	GET	Wersja PDF do druku

Integracja z popularnymi systemami ERP

SAP

Użyjcie SAP PI/PO lub SAP Integration Suitę. Mapowanie z modułu SD (Shipping/Delivery document) do formatu API.

Microsoft Dynamics

Użyjcie Power Automate lub niestandardowych konektorow. Mapowanie z Sales/Transfer Orders.

Lokalne systemy ERP

Większość lokalnych rozwiązań ERP (Pantheon, Lidder, Bild, 4D) rozwija lub już posiada moduły e-listow przewozowych.

Typowe problemy integracyjne

Certyfikat nieprawidłowo skonfigurowany: musi być na serwerze, nie tylko na stacji roboczej
Błędny format daty: API oczekuje ISO 8601 (YYYY-MM-DDTHH:mm:ss)
Brakujące pola wymagane: API zwraca 400 z lista pol
Odbiorca niezarejestrowany: odbiorca musi istnieć w systemie
Timeout przy dużych przesyłkach: rozdzielcie 100+ pozycji na kilka listów

Powiadomienia Webhook

Portal obsluguje webhooki do aktualizacji statusu w czasie rzeczywistym: potwierdzenie odbioru, akceptacja/odrzucenie, ostrzeżenia o terminach.

Podsumowanie

Integracja API to jedyne trwale podejście dla operacji o dużej skali.

Docavelo ma gotowa integracje z portalem: podłączcie swój ERP do Docavelo, a on komunikuje się z portalem za Was.