E-szallitolevelek API integráció: Az ERP/DMS csatlakoztatasa a portalhoz
Technikai útmutató az ERP vagy DMS integraciojahoz az e-szallitolevelek portallal API-n keresztül.

Miért elengedhetetlen az API integráció
A portál rendelkezik webes felulettel a manuális bevitelhez, de napi 5-10-nel több szállítóleveleket kuldo vállalatok számára a manuális bevitel nem fenntarthato. Az API integráció lehetővé teszi az automatikus letrehozast, atveteeli megerositest és allapot-szinkronizaciot.
Rendszer architektúra
- Protokoll: HTTPS (TLS 1.2+)
- Formátum: JSON
- Hitelesítés: Minősített elektronikus tanúsítvány (kölcsönös TLS) + API kulcs
- Dokumentáció: Elérhető a portalon regisztráció után
Legfontosabb API vegpontok
| Végpont | Metódus | Leírás |
|---|---|---|
| /api/v1/delivery-notes | POST | Új e-szallitolevl létrehozása |
| /api/v1/delivery-notes/{id} | GET | Egyedi szallitolevl megtekintese |
| /api/v1/delivery-notes | GET | Szállítólevelek listája (szurokkel) |
| /api/v1/receipt-notes | POST | Atveveny létrehozása (átvétel megerositese) |
| /api/v1/delivery-notes/{id}/status | GET | Szallitolevl allapota |
| /api/v1/delivery-notes/{id}/pdf | GET | PDF változat nyomtatashoz |
Integráció népszerű ERP rendszerekkel
SAP
Hasznaljon SAP PI/PO-t vagy SAP Integration Suite-ot. Megfeltetes az SD modulbol (Szallitas/Kiszallitasi dokumentum) az API formatumra.
Microsoft Dynamics
Hasznaljon Power Automate-ot vagy egyedi csatlakoztokat.
Helyi ERP rendszerek
A legtöbb helyi ERP megoldás (Pantheon, Lidder, Bild, 4D) fejleszti vagy rendelkezik e-szallitolevl modulokkal.
Gyakori integracios problemak
- A tanúsítvány nincs megfelelően konfigurallva: a szerveren kell lennie, nem csak a munkallomaason
- Hibás dátum formátum: az API ISO 8601-et vár (YYYY-MM-DDTHH:mm:ss)
- Hiányzó kötelező mezők: az API 400-as hibat ad a mezolistaval
- Nem regisztrált címzett: a cimzettnek lezetenie kell a rendszerben
- Időtúllépés nagy szallitmanyoknal: ossza szét a 100+ tetelt több szallitolevelre
Webhook ertesitesek
A portál támogatja a webhookokat valós idejű allapotfrissitesekhez: átvételi megerősítés, elfogadas/elutasitas, hataridok figyelmeztetések.
Összefoglalás
Az API integráció az egyetlen fenntarthato megközelítés a nagy volumenu muveletekhz.
A Docavelo kész portál integracioval rendelkezik: csatlakoztassa az ERP-jet a Docavelóhoz, és az kommunikál a portallal On helyett.


