Dlaczego integracja API jest niezbedna
Portal ma interfejs webowy do recznego wprowadzania, ale dla firm wysylajacych wiecej niz 5-10 listow przewozowych dziennie reczne wprowadzanie jest nie do utrzymania. Integracja API umozliwia automatyczne tworzenie, potwierdzanie odbioru i synchronizacje statusow.
Architektura systemu
- Protokol: 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 | Podglad pojedynczego listu przewozowego |
| /api/v1/delivery-notes | GET | Lista listow 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
Uzyjcie SAP PI/PO lub SAP Integration Suite. Mapowanie z modulu SD (Shipping/Delivery document) do formatu API.
Microsoft Dynamics
Uzyjcie Power Automate lub niestandardowych konektorow. Mapowanie z Sales/Transfer Orders.
Lokalne systemy ERP
Wiekszosc lokalnych rozwiazan ERP (Pantheon, Lidder, Bild, 4D) rozwija lub juz posiada moduly e-listow przewozowych.
Typowe problemy integracyjne
- Certyfikat nieprawidlowo skonfigurowany — musi byc na serwerze, nie tylko na stacji roboczej
- Bledny format daty — API oczekuje ISO 8601 (YYYY-MM-DDTHH:mm:ss)
- Brakujace pola wymagane — API zwraca 400 z lista pol
- Odbiorca niezarejestrowany — odbiorca musi istniec w systemie
- Timeout przy duzych przesylkach — rozdzielcie 100+ pozycji na kilka listow
Powiadomienia Webhook
Portal obsluguje webhooki do aktualizacji statusu w czasie rzeczywistym — potwierdzenie odbioru, akceptacja/odrzucenie, ostrzezenia o terminach.
Podsumowanie
Integracja API to jedyne trwale podejscie dla operacji o duzej skali.
Arhivix ma gotowa integracje z portalem — podlaczcie swoj ERP do Arhivix, a on komunikuje sie z portalem za Was.
