Integrare API avize de expediție: conectati ERP-ul la portal
Ghid tehnic pentru integrarea ERP-ului sau DMS-ului cu portalul de avize de expediție electronice prin API: autentificare, endpoint-uri și formate.
De ce este esentiala integrarea API
Portalul are o interfata web pentru introducere manuala, dar pentru companiile care trimit mai mult de 5-10 avize de expediție zilnic, introducerea manuala este nesustenabila. Integrarea API permite crearea automata, confirmarea recepției și sincronizarea stării.
Arhitectura sistemului
- Protocol: HTTPS (TLS 1.2+)
- Format: JSON
- Autentificare: Certificat electronic calificat (mutual TLS) + cheie API
- Documentație: Disponibila pe portal după înregistrare
Endpoint-uri API cheie
| Endpoint | Metoda | Descriere |
|---|---|---|
| /api/v1/delivery-notes | POST | Creare aviz de expediție electronic nou |
| /api/v1/delivery-notes/{id} | GET | Vizualizare aviz de expediție individual |
| /api/v1/delivery-notes | GET | Listare avize de expediție (cu filtre) |
| /api/v1/receipt-notes | POST | Creare aviz de primire (confirmare recepție) |
| /api/v1/delivery-notes/{id}/status | GET | Starea avizului de expediție |
| /api/v1/delivery-notes/{id}/pdf | GET | Versiune PDF pentru tipărire |
Integrare cu sisteme ERP populare
SAP
Folositi SAP PI/PO sau SAP Integration Suite. Mapati din modulul SD (document Expediere/Livrare) la formatul API.
Microsoft Dynamics
Folositi Power Automate sau conectori personalizati. Mapati din Comenzi de vanzare/transfer.
Sisteme ERP locale
Cele mai multe soluții ERP locale (Pantheon, Lidder, Bild, 4D) dezvolta sau au deja module pentru avize de expediție electronice.
Probleme frecvente de integrare
- Certificat neconfigutat corespunzător: trebuie sa fie pe server, nu doar pe stația de lucru
- Format de data greșit: API-ul așteaptă ISO 8601 (YYYY-MM-DDTHH:mm:ss)
- Câmpuri obligatorii lipsa: API-ul returneaza 400 cu lista câmpurilor
- Destinatar neînregistrat: destinatarul trebuie sa existe în sistem
- Timeout cu expediții mari: împărțiți 100+ articole în mai multe avize
Notificări Webhook
Portalul suporta webhook-uri pentru actualizări de stare în timp real: confirmare recepție, acceptare/respingere, avertismente de termene.
Concluzie
Integrarea API este singura abordare sustenabila pentru operațiuni cu volum mare.
Docavelo are o integrare gata facuta cu portalul: conectati ERP-ul dumneavoastră la Docavelo, iar acesta comunica cu portalul pentru dumneavoastră.
