Zasto je API integracija neophodna
Portal ima web sucelje za rucni unos, ali za tvrtke koje salju vise od 5-10 otpremnica dnevno, rucni unos je neodrziv. API integracija omogucuje automatsko kreiranje, potvrdu primitka i sinkronizaciju statusa.
Arhitektura sustava
- Protokol: HTTPS (TLS 1.2+)
- Format: JSON
- Autentifikacija: Kvalificirani elektronicki certifikat (uzajamni TLS) + API kljuc
- Dokumentacija: Dostupna na portalu nakon registracije
Kljucne API krajnje tocke
| Krajnja tocka | Metoda | Opis |
|---|---|---|
| /api/v1/delivery-notes | POST | Kreiranje nove e-otpremnice |
| /api/v1/delivery-notes/{id} | GET | Pregled pojedinacne otpremnice |
| /api/v1/delivery-notes | GET | Popis otpremnica (s filterima) |
| /api/v1/receipt-notes | POST | Kreiranje prijemnice (potvrda primitka) |
| /api/v1/delivery-notes/{id}/status | GET | Status otpremnice |
| /api/v1/delivery-notes/{id}/pdf | GET | PDF verzija za ispis |
Integracija s popularnim ERP sustavima
SAP
Koristite SAP PI/PO ili SAP Integration Suite. Mapirajte iz SD modula (Shipping/Delivery document) u API format.
Microsoft Dynamics
Koristite Power Automate ili prilagodene konektore. Mapirajte iz Sales/Transfer Orders.
Lokalni ERP sustavi
Vecina lokalnih ERP rjesenja (Pantheon, Lidder, Bild, 4D) razvija ili vec ima module za e-otpremnice.
Cesti problemi s integracijom
- Certifikat nije pravilno konfiguriran -- mora biti na posluzitelju, ne samo na radnoj stanici
- Pogresan format datuma -- API ocekuje ISO 8601 (YYYY-MM-DDTHH:mm:ss)
- Nedostajuca obavezna polja -- API vraca 400 s popisom polja
- Primatelj nije registriran -- primatelj mora postojati u sustavu
- Timeout s velikim posiljkama -- podijelite 100+ stavki na vise otpremnica
Webhook obavijesti
Portal podrzava webhookove za azuriranja statusa u stvarnom vremenu -- potvrda primitka, prihvacanje/odbijanje, upozorenja o rokovima.
Zakljucak
API integracija je jedini odrzivi pristup za operacije s velikim volumenom.
Arhivix ima gotovu integraciju s portalom -- povežite svoj ERP s Arhivixom, a on komunicira s portalom umjesto vas.
