API integracija e-dobavnic: Povezava vašega ERP/DMS s portalom

Zakaj je API integracija bistvena

Portal ima spletni vmesnik za ročni vnos, vendar je za podjetja, ki pošiljajo več kot 5-10 dobavnic dnevno, ročni vnos nevzdržen. API integracija omogoča samodejno ustvarjanje, potrditev prevzema in sinhronizacijo statusov.

Arhitektura sistema

• Protokol: HTTPS (TLS 1.2+)
• Format: JSON
• Avtentikacija: Kvalificirano elektronsko potrdilo (obojestransko TLS) + API ključ
• Dokumentacija: Na voljo na portalu po registraciji

Ključne API končne točke

Končna točka	Metoda	Opis
/api/v1/delivery-notes	POST	Ustvari novo e-dobavnico
/api/v1/delivery-notes/{id}	GET	Ogled posamezne dobavnice
/api/v1/delivery-notes	GET	Seznam dobavnic (s filtri)
/api/v1/receipt-notes	POST	Ustvari prijemnico (potrditev prevzema)
/api/v1/delivery-notes/{id}/status	GET	Status dobavnice
/api/v1/delivery-notes/{id}/pdf	GET	PDF različica za tiskanje

Integracija s priljubljenimi ERP sistemi

SAP

Uporabite SAP PI/PO ali SAP Integration Suite. Preslikajte iz modula SD (Shipping/Delivery document) v format API.

Microsoft Dynamics

Uporabite Power Automate ali prilagojene povezovalnike. Preslikajte iz prodajnih/prenosnih nalogov.

Lokalni ERP sistemi

Večina lokalnih ERP rešitev (Pantheon, Lidder, Bild, 4D) razvija ali že ima module za e-dobavnice.

Pogoste težave pri integraciji

1. Potrdilo ni pravilno nastavljeno: mora biti na strežniku, ne le na delovni postaji
2. Napačen format datuma: API pričakuje ISO 8601 (YYYY-MM-DDTHH:mm:ss)
3. Manjkajoča obvezna polja: API vrne 400 s seznamom polj
4. Prejemnik ni registriran: prejemnik mora obstajati v sistemu
5. Časovna prekoračitev pri velikih pošiljkah: razdelite 100+ postavk na več dobavnic

Zaključek

API integracija je edini vzdržen pristop za operacije z velikim obsegom.

Docavelo ima pripravljeno integracijo s portalom: povežite vas ERP z Docavelom in ta komunicira s portalom namesto vas.