Panoramica

I webservice consentono lo scambio automatizzato e intersistemico di dati aziendali tramite protocolli web standardizzati. Si basano tipicamente su tecnologie come HTTP/HTTPS, SOAP o REST e permettono una comunicazione diretta tra applicazioni.

Le principali caratteristiche dei webservice includono:

• Comunicazione standardizzata tramite protocolli web.
• Scambio automatizzato di dati tra applicazioni e sistemi, indipendentemente dalla piattaforma.
• Supporto di diversi formati di dati, ad esempio XML o JSON.
• Trasmissione dei dati in tempo reale, che consente l’elaborazione immediata delle informazioni.
• Integrazione flessibile nei sistemi IT esistenti come ERP, sistemi di gestione delle merci o sistemi logistici.
• Trasmissione sicura dei dati tramite crittografia e meccanismi di autenticazione (ad es. TLS, API keys o certificati).
• Elevata scalabilità ed espandibilità, che consente di collegare facilmente nuovi partner o sistemi.

Tipi di messaggi supportati (TYPES):

• ORDERS – Ordine
• ORDRSP – Conferma d’ordine
• ORDRCHG – Modifica dell’ordine
• DESADV – Avviso di spedizione
• RECADV – Conferma di ricezione della merce
• INVOIC – Fattura
• INVRPT – Report di inventario
• DELFOR – Piano di consegna
• IFTMIN – Ordine di trasporto
• PRODAT – Ordine di trasporto
• APERAK – Messaggio di conferma
• REMADV – Avviso di pagamento
• SORDERS – Ordine cumulativo
• HANMOV – Movimento di magazzino

Invio di dati a noi

Nomi dei file:
Caratteri alfanumerici (a-z, A-Z, 0-9)
Caratteri speciali consentiti: “-“, “.”, “_”, “~”

Descrizione dei campi:
I singoli campi hanno il seguente significato:

• name
  Nome del file trasmesso.
  Viene utilizzato per identificare il file nel sistema e deve essere univoco per ogni file.
• type
  Tipo di messaggio (tipo EDI) che descrive il contenuto del file.
  Esempi:
  • ORDERS
  • INVOIC
  • DESADV
• content
  Contenuto del file.
  Il file originale deve essere convertito in una stringa Base64 prima della trasmissione.

{
"name": "22a2ac8f-9bb3-4938-9425-31079a5fa9bc",
"type": "ORDERS",
"content": "dGhlIGNvbnRlbnQgbXVzdCBiZSBiYXNlNjQgZW5jb2RlZA=="
}

curl -L \ -X POST \ -H "Content-Type: application/json" \ -H "Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=" \ https://bridge.test.service.avenum.com/v1 \ -d '{"type":"ORDERS","content":"dGhlIGNvbnRlbnQgbXVzdCBiZSBiYXNlNjQgZW5jb2RlZA=="}'





 

Recuperare dati da noi

curl -L \
-X POST \
-H "Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=" \

https://bridge.test.service.avenum.com/v1/out/INVOIC

[
{
"name": "test-1"
"type": "INVOIC",
},
{
"name": "test-2"
"type": "INVOIC",
} 
]

Recuperare il contenuto del file

GET /out/${type}/${name}

Restituisce il file con il tipo e il nome specificati.

{
"name": "Name der Datei", "type": "Typ der Datei", "content": "Inhalt der Datei (Base64 encoded)"


}

200 OK = Tutto ha funzionato correttamente
403 Forbidden = Nessuna autorizzazione o credenziali errate
404 Not found = Il contenuto richiesto non è stato trovato

Eliminare un file

DELETE /out/${type}/${name}

Elimina il file con il tipo e il nome specificati.

Importante: i file recuperati non vengono eliminati automaticamente. Dopo l’elaborazione riuscita, il file deve essere eliminato manualmente.

204 No content = Operazione completata correttamente
403 Forbidden = Nessuna autorizzazione o credenziali errate
404 Not found = Il contenuto richiesto non è stato trovato