IT

Home / Guida EDI / Checklist linee guida EDI

Che cosa contengono le linee guida EDI e come verificarle?

Le linee guida EDI descrivono quali messaggi si aspetta il vostro partner, in quale formato, con quali dati obbligatori e su quale canale. In inglese si chiamano Message Implementation Guide (MIG), in italiano anche guida o manuale di implementazione EDI. Chi le legge con attenzione prima di iniziare il progetto evita la maggior parte delle richieste di chiarimento e dei cicli di test ripetuti. La checklist qui sotto aiuta a non tralasciare nulla.

Aggiornato al 18 ottobre 2026 · fokus it solutions, Jens Musleh

Che cos'è una guida di implementazione

Norme come EDIFACT sono molto ampie. Un ordine (ORDERS) prevede centinaia di dati possibili, la maggior parte dei quali nessuna singola azienda usa. Le associazioni di settore restringono quindi la norma in subset. EANCOM, per esempio, è il subset di GS1 per il commercio; GS1 lo descrive come un sottoinsieme di UN/EDIFACT che contiene solo gli elementi necessari.

Le linee guida del vostro partner fanno un passo in più. Stabiliscono quali segmenti legge davvero nella sua azienda, quali codici si aspetta e come segnala gli errori. Due distributori che inviano entrambi ordini EANCOM possono differire molto nei dettagli. Per questo vale sempre la guida del partner, non la norma generale. Sulla norma stessa vedi EDIFACT spiegato.

Una guida tipica contiene:

  • una panoramica dei tipi di messaggio e del flusso, spesso come grafico
  • per ogni messaggio un elenco dei segmenti con stato (obbligatorio, facoltativo, condizionato)
  • per ogni segmento i qualificatori e i codici ammessi
  • messaggi di esempio
  • indicazioni su codici identificativi, canale di trasmissione, test e referenti

Checklist in 20 punti per le vostre linee guida EDI

Scorrete la guida con questo elenco e annotate per ogni punto la pagina in cui si trova la risposta. Ciò che non trovate, chiedetelo al partner tutto insieme.

  1. Tipi di messaggio: quali messaggi vanno in quale direzione? Per esempio ordine (ORDERS) in entrata, avviso di spedizione (DESADV) e fattura (INVOIC) in uscita. Una panoramica è nella pagina Tipi di messaggio.
  2. Standard e versione: EDIFACT, EANCOM, VDA, un formato Global secondo raccomandazione VDA o un XML proprio? Per EDIFACT anche la directory, per esempio D.96A o D.01B.
  3. Subset e versione della guida: quale subset vale e quale versione della guida avete? Le guide vengono riviste; lavorate con l'ultima versione.
  4. Sintassi e set di caratteri: quale identificativo di sintassi c'è nella testata (per esempio UNOC), quali separatori, ed è previsto un segmento UNA?
  5. Segmenti obbligatori: segnate tutti i segmenti e gli elementi dati con stato obbligatorio. Se ne manca uno, il sistema del partner spesso respinge il messaggio.
  6. Dati condizionati: alcuni dati sono obbligatori solo a certe condizioni, per esempio un numero di lotto solo per determinati articoli. Annotate la condizione.
  7. Qualificatori e liste di codici: quali codici si aspetta il partner, per esempio per tipi di data, ruoli delle parti o unità di misura? Usate solo i valori indicati nella guida.
  8. Codici identificativi delle parti: voi e il partner siete identificati da numeri, spesso GLN, Odette ID o codice fornitore. Dettagli in GLN e altri codici identificativi.
  9. Codici articolo: il partner lavora con il GTIN, con il proprio codice materiale o con il vostro codice articolo? Spesso ne vengono chiesti due contemporaneamente.
  10. Canale di trasmissione: AS2, OFTP2, SFTP o una rete? Vedi Canali di trasmissione.
  11. Dati di connessione e certificati: AS2 ID, Odette ID, indirizzi, porte, cifratura, firma, scambio e durata dei certificati.
  12. Conferme di ricezione: sono attese ricevute tecniche, come la MDN in AS2 o la EERP in OFTP2?
  13. Controllo sintattico (CONTRL): il partner richiede un messaggio CONTRL? Conferma o respinge un interscambio a livello di sintassi. Si richiede tramite un campo nella testata UNB.
  14. Riscontro applicativo (APERAK): il partner invia APERAK in caso di errori di elaborazione, e dovete inviarne anche voi? APERAK segnala errori dell'applicazione, non della trasmissione.
  15. Numerazioni: come devono essere costruiti numeri di documento, riferimenti e numero di controllo nella testata? Possono ripetersi?
  16. Collegamenti tra messaggi: quale riferimento collega avviso di spedizione e fattura all'ordine, per esempio numero d'ordine e numero di riga?
  17. Etichette e SSCC: ogni pallet o collo deve avere un SSCC, e l'etichetta deve corrispondere all'avviso di spedizione? GS1 descrive l'SSCC come numero univoco a livello mondiale per le unità logistiche.
  18. Dati anagrafici: spesso vanno concordati in anticipo luoghi di consegna, punti di scarico, abbinamenti degli articoli e prezzi.
  19. Procedura di test e scadenze: quanti cicli di test, con quali dati di prova, su quale ambiente di test? Entro quando deve partire la produzione?
  20. Referenti e anomalie: chi è competente per gli aspetti funzionali e tecnici, e come si procede in caso di interruzioni o messaggi errati?

Un breve esempio

Ecco l'inizio di un ordine in formato EANCOM che un distributore invia al suo fornitore. I GLN sono numeri di esempio fittizi:

UNB+UNOC:3+9520000000028:14+9520000000011:14+261016:0930+00042++++1'
UNH+1+ORDERS:D:96A:UN:EAN008'
NAD+BY+9520000000028::9'
NAD+SU+9520000000011::9'

Nella testata UNB ci sono mittente, destinatario, data, ora e un numero di controllo. L'1 alla fine del segmento UNB richiede una conferma di ricezione. Nei segmenti NAD i qualificatori BY (acquirente) e SU (fornitore) attribuiscono il GLN a un ruolo. Sono proprio questi i dettagli che la guida regola.

Gli errori più comuni

  • Versione superata. Il partner ha rivisto la guida, voi lavorate con un PDF più vecchio.
  • Esempio invece di regola. I messaggi di esempio mostrano un caso, non tutti. Ciò che manca nell'esempio può comunque essere obbligatorio.
  • Codici scambiati. Il vostro codice articolo finisce nel campo per il codice del cliente o viceversa.
  • Unità di misura. Il vostro ERP ragiona in cartoni, il partner ordina in pezzi. Senza conversione quantità e prezzi non tornano.
  • Ricevute dimenticate. La trasmissione funziona, ma il partner aspetta un CONTRL o un APERAK e considera la mancanza un errore.
  • Etichetta e avviso di spedizione non corrispondono. L'SSCC sul pallet non coincide con quello nel DESADV e il ricevimento merce si blocca.
  • Dati di test presi dalla produzione. Ordini reali nel test possono far partire processi reali presso il partner. Chiarite quale ambiente e quali codici identificativi valgono per il test.

Come aiuta edi-service.eu con la guida EDI

Nell'onboarding di edi-service.eu caricate proprio questa guida, insieme a lettera di accompagnamento e file di esempio. Un'IA ne ricava tipi di messaggio, standard e versione, codici identificativi, canale di trasmissione e procedura di test e vi mostra il risultato per la conferma. Correggete solo ciò che non è giusto; i punti aperti vengono registrati come domande invece di essere indovinati. Che cosa comprende il prezzo fisso lo spiega la pagina Domande frequenti. Se avete una guida e volete sapere se è compatibile con noi, potete inviare una richiesta.

Domande frequenti

Che cosa sono le linee guida EDI?

Le linee guida EDI sono le specifiche tecniche del vostro partner per lo scambio elettronico di dati. Fissano tipi di messaggio, formato, dati obbligatori, codici, codici identificativi e canale di trasmissione. Altri nomi sono guida di implementazione, Message Implementation Guide o specifica EDI.

Dove si trovano le linee guida EDI del mio cliente?

Chiedetele al vostro referente acquisti o EDI presso il cliente. Le grandi aziende le mettono spesso a disposizione in un portale fornitori o le inviano insieme alla richiesta di collegamento EDI. Chiedete anche file di esempio e codici identificativi di test.

Qual è la differenza tra CONTRL e APERAK?

CONTRL conferma o respinge un interscambio ricevuto a livello di sintassi. APERAK segnala se l'applicazione del destinatario è riuscita a elaborare il messaggio e indica gli errori di contenuto. Quale dei due usi il vostro partner lo indica la guida.

Quanto tempo serve per implementare una guida EDI?

Dipende da ampiezza, formato e procedura di test del partner. Articoli specializzati tedeschi indicano per il collegamento con un grande cliente, in un progetto classico, da tre a quattro mesi. La parte più lunga è spesso il ciclo di test con il partner. Altre informazioni su impegno e costi in Quanto costa l'EDI?.

Fonti

Inviare una richiesta · Domande frequenti · Tutti gli articoli della guida