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 expeditie zilnic, introducerea manuala este nesustenabila. Integrarea API permite crearea automata, confirmarea receptiei si sincronizarea starii.
Arhitectura sistemului
- Protocol: HTTPS (TLS 1.2+)
- Format: JSON
- Autentificare: Certificat electronic calificat (mutual TLS) + cheie API
- Documentatie: Disponibila pe portal dupa inregistrare
Endpoint-uri API cheie
| Endpoint | Metoda | Descriere |
|---|---|---|
| /api/v1/delivery-notes | POST | Creare aviz de expeditie electronic nou |
| /api/v1/delivery-notes/{id} | GET | Vizualizare aviz de expeditie individual |
| /api/v1/delivery-notes | GET | Listare avize de expeditie (cu filtre) |
| /api/v1/receipt-notes | POST | Creare aviz de primire (confirmare receptie) |
| /api/v1/delivery-notes/{id}/status | GET | Starea avizului de expeditie |
| /api/v1/delivery-notes/{id}/pdf | GET | Versiune PDF pentru tiparire |
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 solutii ERP locale (Pantheon, Lidder, Bild, 4D) dezvolta sau au deja module pentru avize de expeditie electronice.
Probleme frecvente de integrare
- Certificat neconfigutat corespunzator -- trebuie sa fie pe server, nu doar pe statia de lucru
- Format de data gresit -- API-ul asteapta ISO 8601 (YYYY-MM-DDTHH:mm:ss)
- Campuri obligatorii lipsa -- API-ul returneaza 400 cu lista campurilor
- Destinatar neinregistrat -- destinatarul trebuie sa existe in sistem
- Timeout cu expeditii mari -- impartiti 100+ articole in mai multe avize
Notificari Webhook
Portalul suporta webhook-uri pentru actualizari de stare in timp real -- confirmare receptie, acceptare/respingere, avertismente de termene.
Concluzie
Integrarea API este singura abordare sustenabila pentru operatiuni cu volum mare.
Arhivix are o integrare gata facuta cu portalul -- conectati ERP-ul dumneavoastra la Arhivix, iar acesta comunica cu portalul pentru dumneavoastra.
