Perche l'integrazione API e essenziale
Il portale ha un'interfaccia web per l'inserimento manuale, ma per le aziende che inviano piu di 5-10 bolle di consegna al giorno, l'inserimento manuale e insostenibile. L'integrazione API consente la creazione automatica, la conferma della ricezione e la sincronizzazione degli stati.
Architettura del sistema
- Protocollo: HTTPS (TLS 1.2+)
- Formato: JSON
- Autenticazione: certificato elettronico qualificato (mutual TLS) + chiave API
- Documentazione: disponibile sul portale dopo la registrazione
Endpoint API principali
| Endpoint | Metodo | Descrizione |
|---|---|---|
| /api/v1/delivery-notes | POST | Creare nuova bolla di consegna elettronica |
| /api/v1/delivery-notes/{id} | GET | Visualizzare singola bolla di consegna |
| /api/v1/delivery-notes | GET | Elenco bolle di consegna (con filtri) |
| /api/v1/receipt-notes | POST | Creare nota di ricezione (confermare ricezione) |
| /api/v1/delivery-notes/{id}/status | GET | Stato bolla di consegna |
| /api/v1/delivery-notes/{id}/pdf | GET | Versione PDF per la stampa |
Integrazione con i sistemi ERP piu diffusi
SAP
Utilizzate SAP PI/PO o SAP Integration Suite. Mappate dal modulo SD (Spedizione/Documento di consegna) al formato API.
Microsoft Dynamics
Utilizzate Power Automate o connettori personalizzati. Mappate da Ordini di vendita/trasferimento.
Sistemi ERP locali
La maggior parte delle soluzioni ERP locali (Pantheon, Lidder, Bild, 4D) stanno sviluppando o hanno moduli per le bolle di consegna elettroniche.
Problemi comuni di integrazione
- Certificato non correttamente configurato -- deve essere sul server, non solo sulla workstation
- Formato data errato -- l'API si aspetta ISO 8601 (YYYY-MM-DDTHH:mm:ss)
- Campi obbligatori mancanti -- l'API restituisce 400 con elenco dei campi
- Destinatario non registrato -- il destinatario deve esistere nel sistema
- Timeout con spedizioni grandi -- dividete oltre 100 articoli in piu note
Notifiche webhook
Il portale supporta webhook per aggiornamenti di stato in tempo reale -- conferma della ricezione, accettazione/rifiuto, avvisi di scadenza.
Conclusione
L'integrazione API e l'unico approccio sostenibile per le operazioni ad alto volume.
Arhivix ha un'integrazione gia pronta con il portale -- collegate il vostro ERP ad Arhivix e lui comunica con il portale per voi.
