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.
Prima di applicare la checklist.
Pubblicato e verificato il . Informazioni generali, non consulenza legale.
Dieci casi sintetici da aggiungere ai test.
Questi esempi sono sintetici: non sono incidenti di clienti né risultati di test eseguiti da eFTI Compliance.
- 00182 diventa 182: un identificatore convertito in numero perde gli zeri. Testa la round-trip come stringa.
- Ordine usato come spedizione: due consegne condividono lo stesso ordine. Mantieni identità separate e relazioni.
- Quantità prevista uguale a caricata: il WMS riporta una differenza. Richiedi riconciliazione invece di sovrascrivere.
- Colli sommati ai pallet: unità e supporti di carico sono confusi. Separa grandezze e ledger.
- kg trattati come tonnellate: il valore resta valido numericamente ma cambia significato. Trasforma con unità esplicita.
- Un destinatario per tutto il viaggio: il documento della seconda fermata finisce alla prima. Testa la relazione consegna–parte.
- UTC cambia il giorno locale: una data è ricostruita senza offset. Conserva istante e contesto locale.
- Il più recente vince: due sistemi forniscono valori diversi. Usa un’ownership approvata o richiedi revisione.
- Null diventa zero: dato mancante ed effettiva quantità nulla diventano indistinguibili. Mantieni stati distinti.
- La bozza aggiorna una firma vecchia: il mapping sostituisce il contenuto senza nuova versione. Verifica il legame tra evento e contenuto.
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.
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.
Fonti e percorso successivo.
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.
Tutte le guide italiane