Waarom API-integratie Essentieel Is
Het portaal heeft een webinterface voor handmatige invoer, maar voor bedrijven die meer dan 5-10 vrachtbrieven per dag versturen, is handmatige invoer onhoudbaar. API-integratie maakt automatische aanmaak, ontvangstbevestiging en statussynchronisatie mogelijk.
Systeemarchitectuur
- Protocol: HTTPS (TLS 1.2+)
- Formaat: JSON
- Authenticatie: Gekwalificeerd elektronisch certificaat (wederzijdse TLS) + API-sleutel
- Documentatie: Beschikbaar op het portaal na registratie
Belangrijkste API-eindpunten
| Eindpunt | Methode | Beschrijving |
|---|---|---|
| /api/v1/delivery-notes | POST | Nieuwe e-vrachtbrief aanmaken |
| /api/v1/delivery-notes/{id} | GET | Enkele vrachtbrief bekijken |
| /api/v1/delivery-notes | GET | Vrachtbrieven lijst (met filters) |
| /api/v1/receipt-notes | POST | Ontvangstbrief aanmaken (ontvangst bevestigen) |
| /api/v1/delivery-notes/{id}/status | GET | Status vrachtbrief |
| /api/v1/delivery-notes/{id}/pdf | GET | PDF-versie voor afdrukken |
Integratie met Populaire ERP-systemen
SAP
Gebruik SAP PI/PO of SAP Integration Suite. Map vanuit SD-module (Shipping/Delivery document) naar API-formaat.
Microsoft Dynamics
Gebruik Power Automate of aangepaste connectors. Map vanuit Verkoop-/Overboekingsorders.
Lokale ERP-systemen
De meeste lokale ERP-oplossingen (Pantheon, Lidder, Bild, 4D) ontwikkelen of hebben e-vrachtbriefmodules.
Veelvoorkomende Integratieproblemen
- Certificaat niet correct geconfigureerd -- moet op de server staan, niet alleen op het werkstation
- Verkeerd datumformaat -- API verwacht ISO 8601 (YYYY-MM-DDTHH:mm:ss)
- Ontbrekende verplichte velden -- API retourneert 400 met veldenlijst
- Ontvanger niet geregistreerd -- ontvanger moet in het systeem bestaan
- Timeout bij grote zendingen -- splits 100+ artikelen over meerdere vrachtbrieven
Webhook-meldingen
Het portaal ondersteunt webhooks voor realtime statusupdates -- ontvangstbevestiging, acceptatie/afwijzing, termijnwaarschuwingen.
Conclusie
API-integratie is de enige houdbare aanpak voor operaties met hoog volume.
Arhivix heeft een kant-en-klare portaalintegratie -- verbind uw ERP met Arhivix en het communiceert met het portaal voor u.
