Integrazione e dati

Dieci errori di mapping tra ERP, TMS ed eCMR

Un mapping corretto non copia soltanto nomi di campo. Deve conservare il significato dei dati, identificare la fonte e rendere visibili le decisioni che non possono essere automatizzate.

Ambito

Prima di applicare la checklist.

Pubblicato e verificato il . Informazioni generali, non consulenza legale.

Fixture

Dieci casi sintetici da aggiungere ai test.

Questi esempi sono sintetici: non sono incidenti di clienti né risultati di test eseguiti da eFTI Compliance.

  1. 00182 diventa 182: un identificatore convertito in numero perde gli zeri. Testa la round-trip come stringa.
  2. Ordine usato come spedizione: due consegne condividono lo stesso ordine. Mantieni identità separate e relazioni.
  3. Quantità prevista uguale a caricata: il WMS riporta una differenza. Richiedi riconciliazione invece di sovrascrivere.
  4. Colli sommati ai pallet: unità e supporti di carico sono confusi. Separa grandezze e ledger.
  5. kg trattati come tonnellate: il valore resta valido numericamente ma cambia significato. Trasforma con unità esplicita.
  6. Un destinatario per tutto il viaggio: il documento della seconda fermata finisce alla prima. Testa la relazione consegna–parte.
  7. UTC cambia il giorno locale: una data è ricostruita senza offset. Conserva istante e contesto locale.
  8. Il più recente vince: due sistemi forniscono valori diversi. Usa un’ownership approvata o richiedi revisione.
  9. Null diventa zero: dato mancante ed effettiva quantità nulla diventano indistinguibili. Mantieni stati distinti.
  10. La bozza aggiorna una firma vecchia: il mapping sostituisce il contenuto senza nuova versione. Verifica il legame tra evento e contenuto.
Correzione

Una regola ripetibile, non una patch per documento.

Per ogni caso registra input sintetico, output atteso, trasformazione, owner e versione del mapping. Se manca una decisione sul significato, mantieni il risultato da revisionare. Un test dovrebbe fallire sul valore semanticamente errato anche quando il formato JSON è accettato.

Versione del mapping, schema sorgente e contratto destinatario sono riferimenti separati. Quando cambia uno schema, riesegui i casi pertinenti e verifica quali campi sono impattati. Non dichiarare che tutti i provider siano compatibili perché passa la fixture interna.

Provenienza

Che cosa conservare e che cosa non esporre.

Il report dovrebbe indicare percorsi dei campi, versioni e regole applicate. Non deve divulgare token, URL di accesso firmati o valori di clienti a destinatari non autorizzati. La traccia del mapping spiega il risultato ma non conferisce diritti di riuso né assegna responsabilità legali.

Riferimenti

Fonti e percorso successivo.

EUR-Lex · modello dati eFTI ↗

Le indicazioni operative sono una traccia di progettazione, non una verifica già eseguita sul tuo flusso. Il check gratuito usa selezioni generiche nel browser e non riceve documenti. Connettori e accesso a pagamento restano in preparazione.

Progettare un mapping versionato

Checklist IT in dieci punti

Tutte le guide italiane
Percorso software

Individua le lacune prima dell’integrazione.

Il check gratuito è indicativo e locale. L’accesso a pagamento non è ancora disponibile.

Fai il check