Zakaj je API integracija bistvena
Portal ima spletni vmesnik za rocni vnos, vendar je za podjetja, ki posiljajo vec kot 5-10 dobavnic dnevno, rocni vnos nevzdrzen. API integracija omogoca samodejno ustvarjanje, potrditev prevzema in sinhronizacijo statusov.
Arhitektura sistema
- Protokol: HTTPS (TLS 1.2+)
- Format: JSON
- Avtentikacija: Kvalificirano elektronsko potrdilo (obojestransko TLS) + API kljuc
- Dokumentacija: Na voljo na portalu po registraciji
Kljucne API koncne tocke
| Koncna tocka | 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 razlicica 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
Vecina lokalnih ERP resitev (Pantheon, Lidder, Bild, 4D) razvija ali ze ima module za e-dobavnice.
Pogoste tezave pri integraciji
- Potrdilo ni pravilno nastavljeno -- mora biti na strezniku, ne le na delovni postaji
- Napacen format datuma -- API pricakuje ISO 8601 (YYYY-MM-DDTHH:mm:ss)
- Manjkajoca obvezna polja -- API vrne 400 s seznamom polj
- Prejemnik ni registriran -- prejemnik mora obstajati v sistemu
- Casovna prekoracitev pri velikih posiljkah -- razdelite 100+ postavk na vec dobavnic
Zakljucek
API integracija je edini vzdrzen pristop za operacije z velikim obsegom.
Arhivix ima pripravljeno integracijo s portalom -- povezite vas ERP z Arhivixom in ta komunicira s portalom namesto vas.
