API integracija e-otpremnica: Povezivanje vašeg ERP-a/DMS-a s portalom
Tehnički vodič za integraciju vašeg ERP-a ili DMS-a s portalom e-otpremnica putem API-ja. Autentifikacija, krajnje točke, formati i cesti problemi.
Zašto je API integracija neophodna
Portal ima web sučelje za ručni unos, ali za tvrtke koje šalju vise od 5-10 otpremnica dnevno, ručni unos je neodrživ. API integracija omogućuje automatsko kreiranje, potvrdu primitka i sinkronizaciju statusa.
Arhitektura sustava
- Protokol: HTTPS (TLS 1.2+)
- Format: JSON
- Autentifikacija: Kvalificirani elektronički certifikat (uzajamni TLS) + API ključ
- Dokumentacija: Dostupna na portalu nakon registracije
Kljucne API krajnje točke
| Krajnja točka | Metoda | Opis |
|---|---|---|
| /api/v1/delivery-notes | POST | Kreiranje nove e-otpremnice |
| /api/v1/delivery-notes/{id} | GET | Pregled pojedinačne otpremnice |
| /api/v1/delivery-notes | GET | Popis otpremnica (s filterima) |
| /api/v1/receipt-notes | POST | Kreiranje prijemnice (potvrda primitka) |
| /api/v1/delivery-notes/{id}/status | GET | Status otpremnice |
| /api/v1/delivery-notes/{id}/pdf | GET | PDF verzija za ispis |
Integracija s popularnim ERP sustavima
SAP
Koristite SAP PI/PO ili SAP Integration Suite. Mapirajte iz SD modula (Shipping/Delivery document) u API format.
Microsoft Dynamics
Koristite Power Automate ili prilagođene konektore. Mapirajte iz Sales/Transfer Orders.
Lokalni ERP sustavi
Većina lokalnih ERP rješenja (Pantheon, Lidder, Bild, 4D) razvija ili već ima module za e-otpremnice.
Cesti problemi s integracijom
- Certifikat nije pravilno konfiguriran: mora biti na poslužitelju, ne samo na radnoj stanici
- Pogrešan format datuma: API očekuje ISO 8601 (YYYY-MM-DDTHH:mm:ss)
- Nedostajuća obavezna polja: API vraca 400 s popisom polja
- Primatelj nije registriran: primatelj mora postojati u sustavu
- Timeout s velikim pošiljkama: podijelite 100+ stavki na vise otpremnica
Webhook obavijesti
Portal podržava webhookove za ažuriranja statusa u stvarnom vremenu: potvrda primitka, prihvaćanje/odbijanje, upozorenja o rokovima.
Zaključak
API integracija je jedini održivi pristup za operacije s velikim volumenom.
Docavelo ima gotovu integraciju s portalom: povežite svoj ERP s Docavelom, a on komunicira s portalom umjesto vas.
