IUNGO BDI / Approfondimento tecnico

IUNGO BDI.
Flusso, attivazione e test.

Per integrare IUNGO BDI con il tuo ERP, consulta il flusso di scambio, le operazioni POP, ACK e PUSH, le fasi di attivazione e i documenti tecnici. Il collegamento tra BDI e l'ERP del fornitore è responsabilità del fornitore.

Che cos'è IUNGO BDI

Lo scambio dei documenti.
Il flusso dell'integrazione.

IUNGO Business Data Integration è la soluzione che permette ai Fornitori dei Clienti integrati sulla piattaforma IUNGO di automatizzare lo scambio di documenti commerciali.

Torna a funzionalità e benefici
Schema originale del flusso di integrazione IUNGO BDI
Come funziona? Guarda il flusso. Puoi aprire lo schema per consultarlo a piena risoluzione.
Come funziona? Ecco il processo

Le operazioni POP, ACK e PUSH.

Le specifiche di connessione riportate nella pagina originale, organizzate per operazione.

POST

POP

Download di un documento da IUNGO BDI.

Permette al partner di scaricare tutti i documenti che gli sono stati mandati, uno alla volta.

Connection Methods

Protocol
https
URL-host
icn.iungoapps.com
Request type
POST
Service
v2.0/webapi/pop/orders v2.0/webapi/pop/ordrsp v2.0/webapi/pop/desadv
Accept
application/xml
Authorization
Bearer APIKEY
POST

ACK

Conferma del download.

Permette al partner di confermare il corretto download di un documento da IUNGO BDI.

Connection Methods

Protocol
https
URL-host
icn.iungoapps.com
Request type
POST
Service
v2.0/webapi/ack
X-Receipt-Handle
receiptHandle
Authorization
Bearer APIKEY

{receiptHandle} is automatically generated for each document and is used to confirm the document download

POST

PUSH

Upload di un documento su IUNGO BDI.

Permette al partner di collegarsi e inviare un documento su IUNGO BDI.

Connection Methods

Protocol
https
URL-host
icn.iungoapps.com
Request type
POST
Service
v2.0/webapi/push/orders v2.0/webapi/push/ordrsp v2.0/webapi/push/desadv
Content-type
application/xml
Authorization
Bearer APIKEY
Attivazione del servizio

Prepara l'integrazione e la fase di test.

L'attivazione deve essere eseguita in autonomia dall'utente.

01

Segui il RUNBOOK

Il RUNBOOK descrive tutti i test dei casi d'uso necessari per una completa integrazione.

02

Utilizza IUNGObptest

"TEST Business partner" chiamato "IUNGObptest" è disponibile sulla piattaforma, per testare e validare l'integrazione del servizio BDI, utilizzando casi d'uso certificati. Si tratta di un'azienda fittizia su cui testare.

Dettaglio delle fasi di test

Tre sottogruppi per validare l'integrazione.

01

Download e acquisizione

Test sul download del documento e caricamento della conferma dell'acquisizione dei dati.

02

Righe d'ordine e split

Test sull'aggiornamento delle righe d'ordine per tutti i tipi di ordine, verifica la gestione dello split ove richiesto.

03

Invio DESADV

Test di invio di DESADV.

Documenti tecnici condivisi

Specifiche, schemi e file di esempio.

I collegamenti originali alla documentazione per l'integrazione e la fase di test.

PDF

[BDI]_Platform_Integration_Specifications

Documento che dettaglia la connessione con la piattaforma.

Apri il documento
PDF

[BDI]_Standard_XML_record

Documento XML usato per comunicare con la piattaforma.

Apri il documento
XSD

[BDI]_SCHEMA ORDERS_ORDRSP.xsd

Schema che dettaglia la struttura di ORDER e ORDRSP.

Apri il file
XSD

[BDI]_IUNGO_SCHEMA DESADV.xsd

Schema che dettaglia la struttura di DESADV.

Apri il file
XLSX

[BDI]_RUNBOOK

Schema che dettaglia la fase di test.

Apri il file
ZIP

EXAMPLE FILES

File di esempio per la consultazione tecnica.

Apri il file
FAQ tecniche

Responsabilità, dati e integrazione.

IUNGO BDI garantisce che il mio partner commerciale mi invii tutti i documenti: per esempio tutte le conferme, tutti i Desadv e/o tutti gli ordini?

NO, spetta al mittente decidere quali e quanti documenti inviare (o non inviare) al destinatario. Pertanto, è responsabilità del fornitore decidere se inviare tutte le conferme e/o Desadv al cliente, così come è responsabilità del cliente decidere se inviare tutti gli ordini al fornitore e aggiornarli dopo ogni modifica.

Posso modificare il contenuto dei documenti inviati tramite IUNGO BDI? Per esempio, aggiungendo un campo solo per un destinatario specifico?

SI, il servizio IUNGO BDI verifica solo il rispetto del formato per ogni tipo di documento e la presenza di "dati obbligatori" (come indicato nelle specifiche tecniche). Il contenuto dei dati scambiati rientra nella completa autonomia e responsabilità del mittente.

IUNGO BDI controlla il significato dei dati scambiati?

BDI garantisce la consegna e la sintassi dei documenti commerciali, ma non il significato dei dati. Il significato dei dati contenuti nei documenti scambiati ed eventuali regole di business, devono essere concordati tra i partner, al di fuori della piattaforma.

IUNGO BDI garantisce che tutti i dati per me importanti siano presenti nei documenti che ricevo?

NO, IUNGO BDI garantisce la presenza dei dati "obbligatori" richiesti dallo standard di comunicazione. Se un documento non contiene le informazioni "obbligatorie", IUNGO BDI lo rifiuta, informando il mittente. È responsabilità del mittente inserire le informazioni "opzionali" di cui il destinatario ha bisogno.

Chi crea la connessione tra IUNGO BDI e l'ERP del fornitore?

IUNGO non crea il collegamento tra il BDI e l'ERP del fornitore. Il collegamento con il BDI è responsabilità del fornitore.