Miert elengedhetetlen az API integracio
A portal rendelkezik webes felulettel a manualis bevitelhez, de napi 5-10-nel tobb szallitoleveleket kuldo vallalatok szamara a manualis bevitel nem fenntarthato. Az API integracio lehetove teszi az automatikus letrehozast, atveteeli megerositest es allapot-szinkronizaciot.
Rendszer architektura
- Protokoll: HTTPS (TLS 1.2+)
- Formatum: JSON
- Hitelesites: Minositett elektronikus tanusitvany (kolcsonos TLS) + API kulcs
- Dokumentacio: Elerheto a portalon regisztracio utan
Legfontosabb API vegpontok
| Vegpont | Metodus | Leiras |
|---|---|---|
| /api/v1/delivery-notes | POST | Uj e-szallitolevl letrehozasa |
| /api/v1/delivery-notes/{id} | GET | Egyedi szallitolevl megtekintese |
| /api/v1/delivery-notes | GET | Szallitolevelek listaja (szurokkel) |
| /api/v1/receipt-notes | POST | Atveveny letrehozasa (atvetel megerositese) |
| /api/v1/delivery-notes/{id}/status | GET | Szallitolevl allapota |
| /api/v1/delivery-notes/{id}/pdf | GET | PDF valtozat nyomtatashoz |
Integracio nepszeru 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 legtobb helyi ERP megoldas (Pantheon, Lidder, Bild, 4D) fejleszti vagy rendelkezik e-szallitolevl modulokkal.
Gyakori integracios problemak
- A tanusitvany nincs megfeleloen konfigurallva -- a szerveren kell lennie, nem csak a munkallomaason
- Hibas datum formatum -- az API ISO 8601-et var (YYYY-MM-DDTHH:mm:ss)
- Hianyzo kotelezo mezok -- az API 400-as hibat ad a mezolistaval
- Nem regisztralt cimzett -- a cimzettnek lezetenie kell a rendszerben
- Idotullepes nagy szallitmanyoknal -- ossza szet a 100+ tetelt tobb szallitolevelre
Webhook ertesitesek
A portal tamogatja a webhookokat valos ideju allapotfrissitesekhez -- atveteli megerosites, elfogadas/elutasitas, hataridok figyelmeztetesek.
Osszefoglalas
Az API integracio az egyetlen fenntarthato megkozelites a nagy volumenu muveletekhz.
Az Arhivix kesz portal integracioval rendelkezik -- csatlakoztassa az ERP-jet az Arhivix-hez, es az kommunikal a portallal On helyett.
