Manuale-ExpressConnect 1.2

TNT Express Connect Technical Guide
Version 2.0
Page 1 of 74 TNT Express
wwwtntit
Indice
1 Overview 3
1.1 Tabella degli elementi XML (Input) . . . . . . . . . . . . . . . . . . . 8
2 Appendice A: Operational Options 16
3 Campi Obbligatori 18
4 Regole 19
5 Esempio di XML in input 21
6 Tabella dei codici di errore 25
7 Il WebService 27
8 Il Booking 30
9 Il Tracking 31
10 Il PriceChecker 34
11 Esempio di XML in input 37
12 Il CheckAddress 39
13 Tabella Prodotti e Opzioni 40
14 Codici Nazione (ISO) 42
15 ExpressLabel Light 48
16 TNT Manifest Design: Raccomandazioni per il posizionamento dei

Barcodes 51
16.1 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
16.2 Barcode Struttura e Contenuto . . . . . . . . . . . . . . . . . . . . . 51
16.3 Code 128 Linee guida per il posizionamento . . . . . . . . . . . . . . 51
16.4 Code 39 (3 of 9) Linee guida per il posizionamento . . . . . . . . . . 52
wwwtntit
17 Documentazione Cartacea 53
17.1 Address Label Layout . . . . . . . . . . . . . . . . . . . . . . . . . . 53
18 Consignment Note Layout 57
19 Layout Manifesto riepilogativo (Summary) 61
20 Layout Manifesto dettagliato (Detailed) 63
21 Etichetta Termica 66
22 Le Etichette 67
1 Overview
Che cos’é ExpressConnect ?
É un’ interfaccia web che consente ai tuoi sistemi informatici di interagire con i nostri.
A chi é destinato?
ExpressConnect é particolarmente adatto per le aziende che accettano ordini on-line
da clienti interni ed esterni e che desiderano operare in tempo reale con la nostra
azienda
Quali sono le funzionalitá di ExpressConnect ?

ExpressConnect é un’ interfaccia per lo scambio di dati via web basato sul linguaggio
XML.
L’ interscambio di dati XML via Https consente ad un server web di parlare con
un altro server in modalitá sicura. ExpressConnect consente di:
• Prenotare on-line e on-time il ritiro delle spedizioni
• Trasmettere I dati delle spedizione e riceverne conferma
• Realizzare e stampare i documenti di trasporto
• Monitorare le spedizioni in tempo reale
• Stampare le etichette TNT in formato PDF
wwwtntit
A chi posso chiedere informazioni su ExpressConnect ?
Supporto Tecnico
E -mail: supportotecnico IT@tntitaly.it
Telefono: 011/2226222
Orario: dal Lunedı́ al Venerdı́ orario continuato dalle 8.30 alle 19.00
Architettura Logica(sistemi e applicazioni in relazione)

L’archiettura tecnologica di ExpresslLabel ideata per relazionere il Cliente e TNT in
tempo reale ricevendo e rendendo disponibili informazioni on-line. Ogni funzionalitá
Web in TNT é disponibile/fruibile anche attraverso l’interfacciamento via XML alla
rispettiva applicazione.
L’accesso é fortemente vincolato alla presenza dei parametri di accesso (login
details) da dichiarare all’interno dell’ XML per poter operare sulla piattaforma web.
I requisiti iniziali per l’attivazione dei processi ExpressConnect sono:
• un’utenza dedicata ad operare verso myTNT da richiedere on-line su

hiips://wwwmytntit/myTNT/Login.do
NB: l’utenza sará assegnata e notificata, via e-mail, all’indirizzo specificato nel
form di registrazione. L’ Admin (colei/colui che ha effetuato la registrazione)
potrá creare autonomamente eventuali altre utenze interne myTNT(ad esempio
per i collaboratori) nonché quella dedicata ai processi Express Connect
• la registrazione di uno o piú indirizzi IP abilitati alla comunicazione tra il vostro

Server e TNT;
NB: Gli indirizzi IP pubblici andranno comunicati a TNT precedentemente alla
fase di test. L’abilitazione dell’indirizzo IP é necessario per poter impostare
correttamente le regole sui Firewall di TNT e garantire quindi l’accesso ai
servizi WEB in modalitá XML.
• consentire la comunicazione in Https attraverso un’attenta configurazione dei

sistemi preposti; questo comporta:
1. l’accettazione e l’installazione dei certificati SSL di myTNT (scaricabili

semplicemente collegandosi al sito myTNT)
2. l’utilizzo della porta 443 dedicata all’HTTPS.
wwwtntit
• verificare la procedura ed il file XML nell’ambiente di test agli Url:
1. hiips://wwwmytntit/xmltest_htmlresponse.html per ottenere la ri-

sposta in Html (visualizzabile su qualsiasi browser) e di quella in XML
• testare la procedura in ambiente di pre-produzione, dove:
1. il protocollo dovrá essere Https

2. il metodo di invio sará un Post
3. la variabile (il file XML) dovrá necessariamente chiamarsi xmlin=
4. l’indirizzo di produzione sará hiips://wwwmytntit/XMLServices
L’utilizzo di un ambiente di pre-produzione consente di simulare liintero processo

in ambiente protetto ed é propedeutico al rilascio, in ambiente di produzione, della
release definitiva e testata.
La validazione (parsing) dei files XML prodotti potrá essere verificata con gli schemi
ufficiali, costantemente aggiornati, che sono pubblicati all’indirizzo
hiip://wwwtntit/dtd/ seguito dal nome dello schema richiesto (per es.
hiip://wwwtntit/dtd/traIN.dtd corrisponde allo schema DTD del file di input
per il tracking).
Cos’é l’XML ?
XML é un linguaggio che serve a contrassegnare (mark-up) i dati. Questo avviene
racchiudendo i singoli dati in etichette (tag) che, attraverso una struttura (DTD),
ne definiscono la natura e le caratteristiche. La trasmissione di dati XML garantisce
i migliori standard di qualitá e di sicurezza delle informazioni, oltreché la massima
velocitá di comunicazione. XML opera direttamente sulla base dati e sugli applicativi
di myTNT. Per integrare questa tipologia di linguaggio nei sistemi di un cliente é
bene contattare risorse di sviluppo dotate di competenze sul codice XML e sui servizi
web e ne conoscano caratteristiche, peculiaritá e limiti.
Di cosa ho bisogno ?
Dopo aver deciso di integrare l’XML é necessario consultare un team tecnico che
conosca la codifica XML ed i servizi web.
Tipicamente ci si rivolge al proprio team di sviluppo interno, laddove disponibile, o in
alternativa ad una software house esterna. Lo sviluppatore interno é una risorsa IT
della vostra azienda che deve possedere le competenze necessarie a integrare l’XML.
wwwtntit
Lo sviluppatore esterno (o un Team fornito da una software house esterna) é colui
che dovrá essere coinvolto nelle fasi di sviluppo.
wwwtntit
Cosa devo tenere in considerazione prima di cominciare a
sviluppare / adottare l’XML?
Nonostante i servizi web di TNT siano accessibili ed erogati a titolo gratuito é ne-
cessario considerare il tempo e le risorse che il cliente deve impiegare per integrare
nei propri sistemi aziendali questa tipologia di linguaggio.
I costi derivanti dallo sviluppo necessario possono variare in funzione di diversi fat-
tori, quali ad esempio l’impiego di un team di sviluppo interno o esterno, dei tempi
legati allo sviluppo stesso, dalla complessitá dell’architettura informatica del cliente,
dalla quantitá di funzionalitá web di TNT da integrare, ecc.
Per questo motivo suggeriamo di:
• Mappare e documentare i processi aziendali, le difficoltá o nuove opportunitá.
• Dettagliare le esigenze aziendali e documentare le funzionalitá richieste allo

sviluppo per risolvere le difficoltá o consolidare nuove opportunitá.
• Identificare le funzionalitá Web di TNT piú idonee alle necessitá aziendali.
• Richiedere al personale IT di stimare se é piú opportuno creare la tecnologia o

acquistarla.
• Determinare il livello di capacitá dello sviluppatore (relativamente a XML e/o

servizi web).
• Valutare i costi e i tempi per l’integrazione dell’XML . La valutazione deve

comprendere:
1. Numero e tipo di piattaforme e sistemi interessati

2. Impatti sulle interfacce e sulla logica di elaborazione interna di ciascun
sistema
3. Numero di funzionalitá da integrare
4. Un’analisi completa di costi e benefici, compresa l’assistenza (se esterna).
ATTENZIONE : Sino a quando non avviene la lettura di un qualsiasi collo, la

spedizione potrá essere modificata o cancellata da parte del cliente se pur giá pre-
sente sui sistemi TNT come PRESUNTA Dopo la lettura del collo, lo stato della
spedizione passa da PRESUNTA a CONFERMATA nei nostri processi e i dati
non saranno piú modificabili.
Per le spedizioni internazionali, la modifica della spedizione é possibile solo fino allo
wwwtntit
scadere dell’orario di Cut-Off stabilito/concordato.
La validazione (parsing) dei files XML prodotti potrá essere verificata con gli schemi
ufficiali, costantemente aggiornati, che sono pubblicati all’indirizzo
hiip://wwwtntit/dtd/ seguito dal nome dello schema richiesto (per es.
hiip://wwwtntit/dtd/rtlOU.dtd ).
Le strutture di Input e di Output

Shipping:
hiip://wwwtntit/dtd/routinglabel.xsd
hiip://wwwtntit/dtd/rtlOU.dtd
Tracking:
hiip://wwwtntit/dtd/traIN.dtd
hiip://wwwtntit/dtd/traOU.dtd
hiip://wwwtntit/dtd/hidOU.dtd
Price Checker:
hiip://wwwtntit/dtd/traIN.dtd
hiip://wwwtntit/dtd/traOU.dtd
Check Address
hiip://wwwtntit/dtd/ckaIN.dtd
hiip://wwwtntit/dtd/ckaOU.dtd
1.1 Tabella degli elementi XML (Input)
XML Element Data Description Vincoli/ Parent Tag

Attrribute Req. lunghezze
<software> Y </shipment>
<application> Y MYRTL= Nazionale, MYR- <=6 digit </software>
TLI= Internazionale
<version> Y Fisso = 1.0 minore <=3 digit </software>
</software> Y </shipment>
<security> Y </shipment>
<customer> Y Dato fornito da TNT Alphanumeric <= </security>
6 digit
<user> Y Dato fornito da TNT Alphanumeric </security>
<=12 digit
wwwtntit
<password> Y Dato fornito da TNT Alphanumeric </security>
<=20 digit
<langid> Y IT= in Italiano EN= in Alphanumeric <=2 </security>
Inglese digit
</security> Y </shipment>
<consignment Y action= “I” (inserimento nuo- Alphanumeric <= </shipment>
action> va spedizione); 1 digit
“M” (Modifica);
“D” (Cancellazione);
“R” (Ristampa) Internazio-
nale= Y/N;
insurance= Y/N
hazardous=Y/N
cashondeliver=Y/N
codcommission=
“S”(Mittente);
“R”(Destinatario) insurance-
commission= “S”(Mittente;
“R”(Destinatario) operatio-
naloption= LockerBox vedi
Appendice A
<laroseDepot> N Fornito da TNT Alpha Numeric </consignment>
<senderAccId> Y Codice cliente fornito da TNT Numeric <=9 digit </consignment>
Internazionale
<= 11 digit Nazio-
nale
<consignmentno> N (Chiave della Chiamata) Alphanumeric </consignment>
<=15 digit
<consignmenttype> Y T= La chiave viene fornita da Alphanumeric <=1 </consignment>
TNT ed equivale alla Lettera digit
di vettura ; C= la chiave viene
fornita dal cliente
<actualweight> Y KKKKKggg virgola virtuale </consignment>
<=8 digit (peso
espresso in grammi)
<actualvolume> N Valore obbligatorio per le Numeric <=7 digit </consignment>
spedizioni Internazionli.
MMMMmmm
<totalpackages> Y numero totale colli. Att.ne <=5 digit </consignment>
per l’internazionale il numero
max di colli é 99
wwwtntit
<packagetype> Y C= Colli, S= Buste; B Alpha <=1 digit </consignment>
Bauletti piccoli; D Bauletti
grandi
<division> Y Fornita da TNT Alphanumeric <=1 </consignment>
digit
<product> Y Vedi tabella servizi Alphanumeric <=3 </consignment>
digit
<vehicle> N non usato </consignment>
<insurancevalue> N Indicare il valore da assicura- Numeric <=13 di- </consignment>
re EEEEEEEEEEEcc git
<insurancecurrency> N valore fisso= EUR Alphanumeric <=3 </consignment>
digit
<packingdesc> N Alphanumeric </consignment>
<=20 digit
<reference> N Riferimento mittente del Alpha Numeric </consignment>
cliente <=10 digit per
domestico e
<=24 digit per in-
ternazionale
<collectiondate> Y data di affidamento della Numeri <=8 digit </consignment>
spedizione, YYYYMMDD
<collectiontime> N Ora di affidamento, HHMM Numeric <=4 digit </consignment>
<invoicevalue> N Valore della spedizione Numeric <=13 di- </consignment>
(solo per internazionale), git
EEEEEEEEEEEcc
<invoicecurrency> N valore fisso= EUR Alphanumeric <=3 </consignment>
digit
<specialinstructions> N note di consegna Alphanumeric </consignment>
<=60 digit per
Internaziona-
le e <=80 per
Domestico
<option/> Y <option/>
<option> N Vedi tabella opzioni Alphanumeric <= <option/>
3digit
<option> N Vedi tabella opzioni Alphanumeric <=3 <option/>
digit
termsofpayment> Y S= Mittente, Alpha <=1 digit <option/>
R = Destinatario
<systemcode> Y Valore Fisso <option/>
<systemversion> Y valore fisso = 1.0 <option/>
<codfvalue> N valore contrassegno, Numeric <=13 di- <option/>
EEEEEEEEEEEcc git
wwwtntit
<codfcurrency> N valore fisso= EUR Alphanumeric <=3 <option/>
digit
<goodsdesc> N descrizione merce Alphanumeric <option/>
<=30 digit
<eomenclosure> N valido solo per domestico Alphanumeric <option/>
<=15 digit
<eomofferno> N valido solo per domestico Numeric <=5 digit <option/>
<eomdivision> N valido solo per domestico Alphanumeric <=5 <option/>
digit
<eomunification> N valido solo per domestico Alphanumeric <=8 <option/>
digit
<dropoffpoint> N vedi tabella TNT Point Alphanumeric <=5 <option/>
digit
<addressType> Y valore fisso = S </addressType>
<vatno> N partita IVA committente Alphanumeric </addressType>
</vatno> <=20 digit
<addrline1 > Y Alpha Numeric </addressType>
<=35 digit
<addrline2> N disponibile solo per l’interna- Alphanumeric </addressType>
zionale <=35 digit
<addrline3> N disponibile solo per interna- Alphanumeric </addressType>
zionale <=35 digit
<postcode> Y CAP Alphanumeric <=9 </addressType>
digit
<phone1> Y prefisso Numeric <=7 digit </addressType>
<phone2> Y numero telefono Numeric <=9 digit </addressType>
<name> N ragione sociale committente Alphanumeric </addressType>
<=50 digit
<country> Y codice nazione (vedi tabella di Alphanumeric <=2 </addressType>
riferimento) digit
<town> Y localitá Alphanumeric </addressType>
<=30 digit
<contactname> N valido solo per internazionale Alphanumeric </addressType>
<=22 digit
<fax1> N non usato </addressType>
<email> O Alphanumeric </addressType>
<=50 digit
<telex> N non usato </addressType>
<province> Y codice provincia Alphanumeric <=5 </addressType>
digit
<custcountry> N non usato </addressType>
<title> N non usato </addressType>
wwwtntit
</address> Y </shipment>
<addressType> N valore fisso = C da compilare Compilare solo se </addressType>
solo se i tag successivi lo sono, usato<=5 digit
vice versa lasciare blank
<vatno> N partita IVA mittente Alphanumeric </addressType>
<=20 digit
<addrline1> Y Alphanumeric <=35 digit </addressType>
zionale <=35 digit
zionale <=35 digit
<postcode> Y CAP Alphanumeric <= </addressType>
9 digit
<phone1> Y prefisso Numeric<=7 digit </addressType>
<phone2> Y numero telefono Numeric<=9 digit </addressType>
<name> N ragione sociale mittente Alphanumeric </addressType>
<=50 digit
riferimento) digit
<=30 digit
<=22 digit
<=50 digit
digit
</address> N
<addressType> Y valore fisso=R Alphanumeric <=5 </addressType>
digit
<vatno> N partita IVA destinatario Alphanumeric </addressType>
<=20 digit
<addrline1> Y Alphanumeric </addressType>
<=35 digit
<addrline2> N disponibile solo per Interna- Alphanumeric </addressType>
zionale <=35 digit
zionale <=35 digit
wwwtntit
<postcode> Y CAP Alphanumeric <=9 </addressType>
digit
<phone2> Y numero telefono Numeric<= 9 digit </addressType>
<name> N ragione sociale destinatario Alphanumeric </addressType>
<=50 digit
riferimento) digit
<=30 digit
<=22 digit
<fax2> N non usato <=5 digit </addressType>
<=50 digit
digit
</address> Y
<addressType> N valore fisso= D da compilare <=5 digit </addressType>
solo se i tag successivi lo sono,
vice versa lasciare blank
<vatno> N Partita IVA ricevente Alphanumeric </addressType>
<=20 digit
<addrline1> Y Alphanumeric </addressType>
<=35 digit
zionale <=35 digit
zionale <=35 digit
<postcode> Y CAP/Zip Code Alphanumeric <=9 </addressType>
digit
<phone2> Y numero telefono Numeric<=9 digit </addressType>
<name> N ragione sociale ricevente Alphanumeric </addressType>
<=50 digit
<country> Y Codice nazione (vedi tabella Alphanumeric <=2 </addressType>
di riferimento) digit
<=30 digit
wwwtntit
<=22 digit
<email> N Alphanumeric </addressType>
<=50 digit
digit
</address> Y
</addresses> Y
<dimensions Y itemaction=“I” (inserimento </shipment>
itemaction=“”> nuovo collo);
“M” (Modifica);
“D” (Cancellazione);
“R” (Ristampa)
<itemsequenceno> N <=5 digit <dimensions>
<itemtype> Y C= Coll S= Buste; <=1 digit <dimensions>
B Bauletti piccoli;
D Bauletti grandi
<itemreference> N <=24 digit <dimensions>
<volume> N NNNNddd <=7 digit <dimensions>
(N)umeri
(d)ecimali
1mcubo = 0001000
<weight> Y NNNNNddd <=8 digit <dimensions>
(N)umeri
(d)ecimali
1Kg = 00001000
<length> N NNNddd <=6 digit <dimensions>
(N)umeri
(d)ecimal
1cm = 001000
<height> N NNNddd <=6 digit <dimensions>
(N)umeri
(d)ecimali
1cm = 001000
<width> N NNNddd <=6 digit <dimensions>
(N)umeri
(d)ecimali
1cm = 001000
wwwtntit
<quantity> Y numero dei colli che rispetta- <=99 <dimensions>
no questo dettaglio
</dimensions> Y </shipment>
<origcountry> N valore fisso IT <articles>
</articles> N </shipment>
</articles> N </shipment>
</consignment> Y </shipment>
</shipment> Y
i nomi dei tag devono essere riportati esattamente come indicato nel manuale
(maiuscole e minuscole)
wwwtntit
2 Appendice A: Operational Options
0 Consegna all’indi-
rizzo
1 Fermo deposito
TNT
2 Fermo Deposito Nel file XML devo- highvalue=Y/N
TNT Point no essere indicati: specialgoods=Y/N
- il codice del TNT hazardous=Y/N
Point
- il numero di tele-
fono del destinata-
rio
- il contatto del
destinatario
3 Consegna Program- Nel file XML devo-
mata no essere indicati:
- il numero di tele-
fono del destinata-
rio
- il contatto del
destinatario
Le stesse informa-
zioni devono com-
parire nelle note i
consegna
5 Consegna in Locker Nel file XML devo- highvalue=Y/N
Box no essere indicati: specialgoods=N
- il codice del Loc- hazardous=N
ker Box
- il numero di cellu-
lare del destinatario
- l’e-mail del dest-
natario
- il contatto del
destinatario
- le dimensioni del
collo
Ogni spedizione de-
ve avere un solo
collo
wwwtntit
6 Reso in Locker Box Nel file XML devo- highvalue=Y/N
no essere indicati: specialgoods=N
- il codice del Loc- hazardous=N
ker Box
- il numero di cellu-
lare del destinatario
- l’e-mail del dest-
natario
- il contatto del
destinatario
- le dimensioni del
collo
Ogni spedizione de-
ve avere un solo
collo
wwwtntit
3 Campi Obbligatori
application Se il luogo di ritiro é compilato
version (Ritiro) addressType
customer (Ritiro) addrline1
user (Ritiro) postcode
password (Ritiro) name
langid (Ritiro) country
senderAccId (Ritiro) town
consignmentno (Ritiro) province
consignmenttype Se il luogo di consegna é compilato
actualweight (Consegna) addressType
actualvolume (Consegna) addrline1
totalpackages (Consegna) postcode
packagetype (Consegna) name
division (Consegna) country
product (Consegna) town
collectiondate (Consegna) province
termsofpayment
systemcode itemsequenceno
systemversion itemtype
(Sender) addressType volume
(Sender) addrline1 weight
(Sender) postcode
(Sender) name
(Sender) country
(Sender) town
(Sender) province
(Sender) custcountry
Receiver Tag
(Destinatario) addressType
(Destinatario) addrline1
(Destinatario) postcode
(Destinatario) name
(Destinatario) country
(Destinatario) town
(Destinatario) province
wwwtntit
4 Regole
• customer é un campo obbligatorio e viene fornito da TNT. Questo campo é soggetto alla
registrazione alla Webpage di myTNT.
• user é un campo obbligatorio e viene fornito da TNT. Questo campo é soggetto alla regi-
strazione alla Webpage di myTNT.
• password é un campo obbligatorio e viene fornito da TNT. Questo campo é soggetto alla
registrazione alla Webpage di myTNT.
• langid se indicato IT il sistema replicherá in Italiano, se indicato EN i messaggio risulteranno
in lingua Inglese.
• senderAccId é un campo necessario e viene fornito da TNT. Per l’internazionale é necessario
sempre aggiungere il valore “8” davanti al codice . per il Nazionale é necessario compilare il
campo valorizzando 8 cifre, 11 se comprensivo del riferimento FM.
• consignmentno é la chiave della chiamata riferita alla singola spedizione. Questa verrá
usata come referenza univoca ogniqualvota sará necessario modificare i dati di spedizione.
Puó essere fornita da TNT o dichiarata dal cliente.
• consignmenttype se valorizzato con la “C”, la chiave del “consignmentno” sará fornita dal
cliente, se valorizzata con al “T”, da TNT.
• actualweight qualora il valore indicato non fosse replicato sui tag riferiti all’Item, il peso
sará moltiplicato per il numero dei colli indicati nel tag “totalpackages”.
• totalpackages per le spedizioni Internazionali, il numero massimo di colli gestibili é 99. Una
spedizione con un numero piú elevato di colli deve essere gestita con piú spedizioni.
• packagetype usare i soli valori presenti alla tabella .
• division fornito da TNT secondo le specifiche del business.
• product da compilare secondo la tabella.
• collectiondate deve essere sempre quella corrente o in avanti rispetto al calendario. Atten-
zione perché questo parametro guida l’attivazione delle spedizioni Internazionali.
• termsofpayment con il valore S la sepdizione sará a carico del codice indicato al tag
“senderAccId”, se R sará a carico del destinatario.
• (Destinatario) addrline1 serve per indicare l’indirizzo del destinatario
• (Destinatario) addrline2 questo tag é disponibile solo per le spedizioni internazionali.
• (Destinatario) addrline3 questo tag é disponibile solo per le spedizioni internazionali.
• (Destinatario) country il codice nazione deve sempre essere espresso in formato
ISO a due cifre.
• (Destinatario) town I caratteri speciali sul nome della cittá comportano difficoltá negli
instradamenti.
wwwtntit
• (Destinatario) province il campo provincia é importante per le spedizioni domestiche,
viceversa non sempre é presente nelle spedizioni internazionali.
• Itemreference in questo campo puó essere inserito un vs riferimento collo. il valore non
verrá riportato sulla label Internazionale ma solo su quella nazionale e non in barcode format.
• quantity in questo campo puó essere riportano il numero dei colli che rispecchiamo i valori
identificati nei tag dimension. Questo provocherá la replica per tutti i colli dichiarati.
• Caratteri speciali si consiglia di usare sempre il CDATA nei campi alfanumeri in modo tale
che eventuali “&” non possano essere mal interpretati dal parser XML.
• XML é case sensitive.Gli elementi dei TAGS devono essere scritti in minuscolo.
• San Marino, Cittá del Vaticano spedizioni destinate a queste localitá devono essere
gestite come Nazionali.
• DTD/XSD TNT si riserva di aggiungere o eliminare eventuali Tag che non avranno co-
munque effetto sull’efficacia . Consigliamo di non validare le risposte.
wwwtntit
5 Esempio di XML in input
1 <? xml v e r s i o n =”1.0” e n c o d i n g=”u t f −8” ?>
2 <shipment xmlns : x s i=” h t t p : / /www. w3 . o r g /2001/XMLSchema−i n s t a n c e ”
3 x s i : noNamespaceSchemaLocation=”W: E x p r e s s L a b e l \ I n t e r n a z i o n a l e \
r o u t i n g l a b e l . xsd ”>
4 <s o f t w a r e>
5 <a p p l i c a t i o n>MYRTL</ a p p l i c a t i o n> ( i n c a s o d i i n t e r n a z i o n a l e u s a r e
MYRTLI)
6 <v e r s i o n>1 . 0</ v e r s i o n> ( v a l o r e f i s s o s i a I n t e r n a z i o n a l e che d o m e s t i c o )
7 </ s o f t w a r e>
8 <s e c u r i t y>
9 <customer>s t r i n g</ customer>
10 <!−−−dato f o r n i t o da TNT p r e v i a r e g i s t r a z i o n e www.myTNT. i t −−>
11 s t r i n g
13 <password>s t r i n g</ password>
15 <l a n g i d>IT</ l a n g i d>
16 </ s e c u r i t y>
17 <!−−−− Tag u t i l e n e l c a s o s i d e s i d e r i stampare l ’ e t i c h e t t a i n formato
Termico
18 Nel c a s o i l t a g non s i a p r e s e n t e oppure non s i a v a l o r i z z a t o con
T ,
19 v e r r a n n o emesse d e l l e e t i c h e t t e normali , d i v e r s a m e n t e v e r r a n n o
prodotte
20 e t i c h e t t e n e l formato normale .
21 N. B . : T u t t i i documenti che non sono l a b e l ( e s . i s t r u z i o n i d i
t r i a n g o l a z i o n e , manifest , etc . )
22 c o n t i n u e r a n n o ad e s s e r e p r o d o t t i con i l medesimo formato a t t u a l m e n t e
u t i l i z z a t o . −−>
23 <la be lT yp e >T</la be lT yp e >
24 <consignment a c t i o n=” I ” c a s h o n d e l i v e r y=”N” h a z a r d o u s=”N” h i g h v a l u e=”N”
25 i n s u r a n c e=”N” i n t e r n a t i o n a l=”Y” s p e c i a l g o o d s=”N”>
26 <l a r o s e D e p o t></ l a r o s e D e p o t>
27 <!−−− l a s c i a r e sempre vuoto s e n z a i n d i c a z i o n i c o n t r a r i e d i TNT −−>
28 <s e n d e r A c c I d>s t r i n g</ s e n d e r A c c I d>
30 <consignmentno>t e s t 1</ consignmentno>
31 <!−−− Questa r a p p r e s e n t a l a c h i a v e d e l l a s p e d i z i o n e , puo ’ e s s e r e
fornita
32 d a l c l i e n t e g e s t e n d o i l t a g s u c c e s s i v o con l a C p i u t t o s t o che da
TNT
33 compilando i l t a g s u c c e s s i v o con l a T . In q u e s t o s e c o n d o c a s o l a
chiave
wwwtntit
34 s a r a ’ l a l e t t e r a d i v e t t u r a . Ogni r i c h i e s t a d i m o d i f i c a a l l a
spedizione
35 s a r a ’ sempre g u i d a t a da q u e s t a c h i a v e −−>
36 <c o n s i g n m e n t t y p e>C</ c o n s i g n m e n t t y p e>
37 <a c t u a l w e i g h t>00010500</ a c t u a l w e i g h t>
38 <a c t u a l v o l u m e></ a c t u a l v o l u m e>
39 <t o t a l p a c k a g e s>1</ t o t a l p a c k a g e s>
40 C
41 <d i v i s i o n>D</ d i v i s i o n>
42 NC
43 <v e h i c l e> </ v e h i c l e>
44 <!−−− s e n z a i n d i c a z i o n i c o n t r a r i e d i TNT, l a s c i a r e vuoto i l t a g −−>
45 0000000010000
46 EUR
47 BOX
48 <r e f e r e n c e>DDT1</ r e f e r e n c e>
49 < c o l l e c t i o n d a t e>26062012</ c o l l e c t i o n d a t e>
50 <c o l l e c t i o n t i m e></ c o l l e c t i o n t i m e>
51 
52 
53 < s p e c i a l i n s t r u c t i o n s>A t t e n z i o n e c o n s e g n a r e sempre dopo l e 1 2 : 0 0</
s p e c i a l i n s t r u c t i o n s>
54 <o p t i o n s></ o p t i o n>
55 <o p t i o n></ o p t i o n>
56 <o p t i o n></ o p t i o n>
57 </ o p t i o n s>
58 <termsofpayment>S </ termsofpayment />
59 <systemcode>RL</ systemcode>
60 <s y s t e m v e r s i o n>1 . 0</ s y s t e m v e r s i o n>
61 <c o d f v a l u e>0000000015000</ c o d f v a l u e>
62 <c o d f c u r r e n c y>EUR</ c o d f c u r r e n c y>
63 <g o o d s d e s c>ABBIGLIAMENTO</ g o o d s d e s c>
64 <e o m e n c l o s u r e></ e o m e n c l o s u r e>
66 <e o m o f f e r n o></ e o m o f f e r n o>
68 <e o m d i v i s i o n></ e o m d i v i s i o n>
70 <e o m u n i f i c a t i o n></ e o m u n i f i c a t i o n>
72 <d r o p o f f p o i n t></ d r o p o f f p o i n t>
73 <a d d r e s s e s><a d d r e s s>
74 <addressType>S</ addressType>
75 <vatno></ vatno>
76 <a d d r l i n e 1>v i a Roma 1</ a d d r l i n e 1>
77 <a d d r l i n e 2></ a d d r l i n e 2>
wwwtntit
79 10100
80 <phone1>011</ phone1>
81 <phone2>2226111</ phone2>
82 <name>TEST SPA</name>
83 <c o u n t r y>IT</ c o u n t r y>
84 <town>Torino</town>
85 <contactname>Mario R o s s i</ contactname>
86 TO
87 <c u s t c o u n t r y></ c u s t c o u n t r y>
89 </ a d d r e s s><a d d r e s s>
90 <addressType>R</ addressType>
91 <vatno></ vatno>
92 <a d d r l i n e 1>Via Torino 1</ a d d r l i n e 1>
95 00100
96 phone1 >06</ phone1>
97 <phone2>111112222</ phone2>
98 <name>B i a n c h i SRL</name>
99 <c o u n t r y>IT</ c o u n t r y>
100 <town>Roma</town>
101 <contactname>Mario B i a n c h i</ contactname>
102 RO
105 </ a d d r e s s>
106 <a d d r e s s>
107 <addressType>C</ addressType>
108 <vatno></ vatno>
112 
113 <phone1></ phone1>
115 <name></name>
116 <c o u n t r y></ c o u n t r y>
117 <town></town>
118 <contactname></ contactname>
119 
122 </ a d d r e s s>
123 <a d d r e s s>
wwwtntit
124 <addressType>D</ addressType>
125 <vatno></ vatno>
129 
132 <name></name>
133 <c o u n t r y></ c o u n t r y>
134 <town></town>
135 <contactname></ contactname>
136 
137 </ c u s t c o u n t r y>
138 </ a d d r e s s>
139 </ a d d r e s s e s>
140 <d i m e n s i o n s>
141 1
142 C
143 0123456789
144 <volume></ volume>
145 <w e i g h t>0010000</ w e i g h t>
146 <l e n g t h></ l e n g t h>
147 <h e i g h t></ h e i g h t>
148 <width></ width>
149 <q u a n t i t y></ q u a n t i t y>
150 </ d i m e n s i o n s>
151 < a r t i c l e s>
152 < t a r i f f></ t a r i f f>
153 <o r i g c o u n t r y>IT</ o r i g c o u n t r y>
154 </ a r t i c l e s>
155 </ consignment>
156 </ shipment>
wwwtntit
6 Tabella dei codici di errore
Codice Descrizione
0001 Cliente non valido
0012 Indirizzo IP non valido
0415 Campo non valido o mancante
2014 Lettera di vettura errata
2015 Check Digits errato su lettera di controllo
2016 Peso errato
2017 Volume errato
2018 Numero totale colli errato
2019 Valore assicurato errato
2020 Valore fattura errato
2021 Valore contrassegno errato
2022 Indirizzo mittente ambiguo
2023 Indirizzo destinatario ambiguo
2024 Spedizione giá chiusa
2025 Lettera di spedizione giá presente come effettiva
2026 Lettera di spedizione giá presente come presunta
2027 Incongruenza spedizione
2031 Non é concesso eliminare colli da una spedizione spuntata.
2032 Non é concesso modificare un collo spuntato.
2033 Non é concesso eliminare un collo spuntato.
2035 Impossibile aggiornare spedizioni dopo l’orario di Cut-Off
2038 Indirizzo mittente valido solo su localitá
2039 Indirizzo destinatario valido solo su localitá
2040 Localitá mittente errata
2041 Localitá destinatario errata
2042 La lettera di vettura inviata é stata sostituita.
2043 Tagliando errato
2044 Telefono destinatario non indicato.
2045 Non é concessa la ristampa su spedizioni errate.
2046 Il servizio richiesto é stato sostituito.
2047 Impossibile operare su spedizioni annullate.
2054 Riferimento fattura errato o mancante.
2055 Allegato fattura errato o mancante.
2056 Numero offerta errata o mancante.
2057 Riferimento fattura non richiesto.
2058 Riferimento allegato fattura non richiesto.
2059 Numero offerta non richiesto.
2060 Operazione non possibile, il numero di spedizione non é presente
2061 Numero di spedizione gia’ inserito
2062 Localitá di consegna errata
2063 Localitá di ritiro errata
2064 Collo nr. <????> inesistente
2231 Dati di ritiro non validi . collectiondate
wwwtntit
89024 Riferimento allegato fattura non richiesto.
90019 Numero offerta non richiesto.
99995 Errore generico su connessione rifiutata
wwwtntit
7 Il WebService
TNT mette a disposizione il servizio web denominato “ResiServiceImpl”. Questo servizio espone il
metodo getPDFLabel attraverso il quale é possibile ottenere le seguenti informazioni:
• Stringa XML di output dell’applicativo TNT
• Indicazione sulla presenza di eventuali errori di processo
• Documento PDF contenente Etichette e, se specificato <PrintInstrDocs>Y</PrintInstrDocs>
nell’XML di input, documentazione TNT e lettera di istruzioni.
Il “documento” wsdl che descrive il servizio web é raggiungibile al seguente url web:
hiips://wwwmytntit/ResiService/ResiServiceImpl.wsdl
Attraverso il WSDL é possibile determinare le funzioni disponibili sul server utili per generare il
client di consumo.
La classe ResiServiceImplServiceLocator restituisce un istanza della classe ResiServiceImpl che rap-
presenta il client di consumo del webservice.
Il metodo getPDFLabel della classe ResiServiceImpl, riceve come parametro la stringa xml di input
relativa al servizio MyRTL e restituisce un oggetto Document che contiene a sua volta i seguenti
oggetti:
• documentCorrect: é un booleano (true/false). Se é uguale a true la transazione é corretta
e l’oggetto Document contiene anche il PDF relativo alle etichette della richiesta.
• binaryDocument: é un documento PDF relativo alle etichette ed é presente solo se l’og-

getto documentCorrect è = true.
• outputString: é la stringa di output completa restituita dal servizio.
wwwtntit
Esempio delle classi inserite nel codice PHP
1 <?php
2 $xml =
3 ’ i n s e r i r e l a s t r i n g a XML con a c t i o n I o R ’ ;
4 try {
5 $ g s e a r c h = new S o a p C l i e n t ( ’ h t t p s : / /www. mytnt . i t / R e s i S e r v i c e /
R e s i S e r v i c e I m p l . wsdl ’ ) ;
6 $ r e s u l t = $ g s e a r c h −> s o a p C a l l ( ’ getPDFLabel ’ , a r r a y ( a r r a y ( ’ inputXml
’=>$xml ) ) ) ;
7
8 $ r e s u l t 2 = $ r e s u l t −>getPDFLabelReturn ;
9 echo $ r e s u l t 2 −>documentCorrect ;
10 i f ( $ r e s u l t 2 −>documentCorrect == 1 && s t r l e n ( $ r e s u l t 2 −>
binaryDocument ) >0){
11 // s p a r a r e i l pdf $ r e s u l t 2 −>binaryDocument ;
12 h e a d e r ( ’ Content−D e s c r i p t i o n : F i l e T r a n s f e r ’ ) ;
13 h e a d e r ( ’ Content−Type : a p p l i c a t i o n / pdf ’ ) ;
14 h e a d e r ( ’ Content−D i s p o s i t i o n : attachment ; f i l e n a m e =” l a b e l . pdf
” ’) ;
15 header ( ’ Expires : 0 ’) ;
16 echo $ r e s u l t 2 −>binaryDocument ;
17 } else {
18 // s p a r a r e l ’ xml $ r e s u l t 2 −>o u t p u t S t r i n g ;
19 h e a d e r ( ’ Content−Type : t e x t /xml ’ ) ;
21 echo $ r e s u l t 2 −>o u t p u t S t r i n g ;
22 }
23 unset ( $gsearch ) ;
24 } c a t c h ( SoapFault $e ) {
25 h e a d e r ( ’ Content−Type : t e x t / html ’ ) ;
27 p r i n t r ( $e ) ;
28 }
29 ?>
30 } c a t c h ( SoapFault $e ) {
31 h e a d e r ( ’ Content−Type : t e x t / html ’ ) ;
33 p r i n t r ( $e ) ;
34 }
35 ?>
wwwtntit
Esempio delle classi inserite nel codice .NET 4.5
1 s t a t i c class LabelPrinter
2 {
3
4 p u b l i c s t a t i c v o i d printPDF ( s t r i n g xmlResponse , s t r i n g conNo
)
5 {
6
7 ResiServiceImplClient c l i e n t = new
ResiServiceImplClient () ;
8 try
9 {
10
11 Document labelDocument=c l i e n t . getPDFLabel (
xmlResponse ) ;
12 // S c r i v i i l PDF su d i s c o
13 byte [ ] byteArray = new byte [ 8 1 9 2 ] ;
14 Stream stream = new MemoryStream ( labelDocument .
binaryDocument ) ;
15 Write ( stream , conNo ) ;
16 Trace . WriteLine ( ” E t i c h e t t a stampata su ”+C o n f i g .
j h P e r c o r s o S a l v a t a g g i o + conNo + ” . pdf ” ) ;
17
18 }
19 catch ( Exception )
20 {
21 throw ;
22 }
23
24 }
25 s t a t i c v o i d Write ( Stream stream , s t r i n g conNo )
26 {
27 var f i l e S t r e a m = F i l e . C r e a t e ( C o n f i g .
j h P e r c o r s o S a l v a t a g g i o+conNo+” . pdf ” ) ; // Metti qua i l
percorso
28 stream . Seek ( 0 , S e e k O r i g i n . Begin ) ;
29 stream . CopyTo ( f i l e S t r e a m ) ;
30 f il e St r ea m . Close () ;
31 }
32
33
34 }
wwwtntit
8 Il Booking
Di seguito il dettaglio dei tag:

<collectiontrg> Y </shipment>
<priopntime> Y Orario apertura mattino <=4 digit </collectiontrg>
hhmm
<priclotime> Y Orario chiusura mattino <= 4 digit </collectiontrg>
hhmm
<secopntime> Y Orario apertura pomeriggio <=4 digit </collectiontrg>
hhmm
<secclotime> Y Orario chiusura pomeriggio <=4 digit </collectiontrg>
hhmm
<availabilitytime> Y Disponibilitá della merce <=4 digit </collectiontrg>
<pickupdate> Y Data ritiro DD.MM.YYYY <=10 digit </collectiontrg>
<pickupdays> Y Valore fisso=1 <=1 digit </collectiontrg>
<pickuptime> Y Orario ritiro (Max) <=4 digit </collectiontrg>
<pickupinstr> N Istruzioni <=50 digit </collectiontrg>
</collectiontrg> Y </shipment>
I “tags” utili per la realizzazione di una chiamata di “Booking” dovranno risultare integrati ad
una chiamata di inserimento inclusi tra gli elementi “Consignment”.
Per poter richiedere la presa é necessario specificare l’indirizzo email di colui dove la effettueremo
e inviare i dati considerando l’orario di cut-off
1 < c o l l e c t i o n t r g>
2 < ! [CDATA[ 0 9 0 0 ] ]>
3 < ! [CDATA[ 1 2 0 0 ] ]>
4 <s e c o p n t i m e>< ! [CDATA[ 1 2 0 0 ] ]></ s e c o p n t i m e>
5 <s e c c l o t i m e>< ! [CDATA[ 1 8 0 0 ] ]></ s e c c l o t i m e>
6 < a v a i l a b i l i t y t i m e>< ! [CDATA[ 1 0 0 0 ] ]></ a v a i l a b i l i t y t i m e>
7 < ! [CDATA[ 2 7 . 0 7 . 2 0 1 2 ] ]>
8 1
9 < ! [CDATA[ 1 0 0 0 ] ]>
10 < ! [CDATA[ TEST RITIRO TEST RITIRO]]>
11 </ c o l l e c t i o n t r g >
wwwtntit
9 Il Tracking
<Application> Y MYTRA <=6 digit </Document>
<Version> Y Fisso=2.0 <=3 digit </Document>
<Login> Y </Document>
<Customer> Y Dato fornito da TNT Alphanumeric <=6 </Login>
digit
<User> Y Dato fornito da TNT Alphanumeric <Login>
<=12 digit
<Password> Y Dato fornito da TNT Alphanumeric </Login>
<=20 digit
<LangID> Y IT=in Italiano EN=in Inglese Alphanumeric <=2 </Login>
digit
</Login> Y </Document>
<SearchCriteria> Y Indica la modalitá di interro- </Document>
gazione: ConNo=Lettera di
vettura, AccountNo=Codice
Cliente, StartDate= Data
Inizio ricerca, EndDate= Da-
ta fine ricerca, Status=Stato
di avanzamento spedizio-
ne, Receiver=Destinatario,
SenderRef=Riferimento,
ReceiverPay=Solo PA, All-
Records=Tutti i records,
PODSearch=Ricerca POD,
NB.Se presente la “ConNo”
le altre modalitá di ricerca
saranno ignorate.
<ConNo> Y Consignment number/ Lette- Alphanumeric </SearchCriteria>
ra di Vettura <=15 digit
<AccountNo> Y Account number/Codice Numeric<=9 </SearchCriteria>
cliente digit Internazio-
nale <=11 digit
Nazionale
<StartDate> Y Data inizio ricerca Alphanumeric </SearchCriteria>
<=10 digit
gg/mm/aaaa
<EndDate> Y Data fine ricerca Alphanumeric </SearchCriteria>
<=10 digit
gg/mm/aaaa
<Status> N Status associati ad una spedi- </SearchCriteria>
zione inserita
wwwtntit
<Level1> N </Status>
<Level2> N </Status>
</Status> N </SearchCriteria>
<Receiver> N </SearchCriteria>
<ReceiverName> O Nome ricevente Alphanumeric </Receiver>
<=50 digit
<ReceiverTown> O Localitá Alphanumeric </Receiver>
<=30 digit
<ReceiverZIP> O Cap Alphanumeric <=9 </Receiver>
digit
<ReceiverProvince> O Codice provincia Alphanumeric <=5 </Receiver>
digit
<ReceiverCountry> O Codice nazione Alphanumeric <=2 </Receiver>
digit
</Receiver> N </SearchCriteria>
<SenderRef> O Riferimento del cliente Alphanumeric </SearchCriteria>
<=10 digit per
domestico e
<=24 digit per
internazionale
<ReceiverPay> Y Include i Porti Assegnati “Y” Alphanumeric <=1 </SearchCriteria>
o “N”. digit
<PODSearch> Y Include POD “Y” o “N”. Alphanumeric <=1 </SearchCriteria>
digit
</SearchCriteria> N </Document>
<SearchParameters> Y Contiene i parametri che </Document>
identificano il tipo di ricerca
<SearchType> Y “Count” o “Detail”. “Count” </SearchParameters>
restituisce il numero di lette-
ra di vettura “Detail” restitui-
sce le informazioni di tracking
piú eventuali dettagli aggiun-
tivi specificati nell’elemento
“ExtraDetails”.
<SearchOption> Y Indica le opzioni di ricerca: </SearchParameters>
ConsignmentTracking,
NegativeCons,
ShipmentsNotDelivered,
ShipmentsHeldInDepot,
HIDHandling
wwwtntit
<SearchKeyValue> Y É il valore della chiave del set </SearchParameters>
di record recuperato, consente
di andare avanti o indietro nei
set di records di ricerca
<SearchMethod> Y “Forward” o “Back” </SearchParameters>
“Forward” indica il recupero
del set di records successivi.
“Back” indica il recupero del
set di records precedente.
<PageNo> N </SearchParameters>
</SearchParameters>N </Document>
<ExtraDetails> Y Specifica quali dettagli ag- </Document>
giuntivi dovranno essere resti-
tuiti. I valori validi sono: Ori-
ginDepot, HeldInDepot, Con-
signmentDetail
wwwtntit
10 Il PriceChecker
Insieme alla risposta positiva ad una interrogazione di tracking, vengono restituiti anche i dati re-
lativi al costo della spedizione e il tempo di resa.
Questi dati possono essere gestiti per una verifica interna del costo che verrá fatturato da parte di
TNT. Il costo é da considerarsi indicativo poiché viene calcolato con precisione SOLO al momento
dell’affidamento delle merci e delle conseguenti rilevazioni di peso e volume.
wwwtntit
XML Element Attribu- Data / Description Constraints Max lenght Parent Tag
te Required
<Document> N Top level element None
<Application> Y Application ID Must be ’MYSHP’ <=5 digit <Document>
<Version> Y Application Version Must be ’3.0’ <= 3 digit <Document>
<Login> N Holds login elements <Document>
<Customer> Y Customer ID As allocated by TNT <=6 digit <Login>
<User> Y User ID As allocated by TNT <=12 digit <Login>
<Password> Y Customer Password As allocated by TNT <=20 digit <Login>
<LangID> Y Language Indicator EN = English; IT = <=2 digit <Login>
Italian
<ApplicationFunction> Y Function ID Must be ’priceCheck’ <=10 digit <Document>
<Details> N Holds consignment de- <Document>
tails elements
<AccountNo> Y Company account Must be numeric and <=11 digit <Details>
upon which collection be registered against
is to be rated the customers logon de-
tails
<Package> N Holds package details <Details>
elements
<Items> N <Package>
<ItemSeqNo> N Item sequential number <=2 digit <Items>
<Type> Y Package description Must be ’0’(Parcel) ’1’ <=1 digit <Items>
(Envelope) or ’2’ (Gar-
ment On Hanger)
<INumber> Y Total number of packa- <=2 digit <Items>
ges in consignment
<IWeight> Y Total weight of all pac- Must be in kilograms <=4 digit <Items>
kages
<Length> Y Length of package Must be in cm <=2 digit <Items>
<Height> Y Height of package Must be in cm <=2 digit <Items>
<Width> Y Width of package Must be in cm <=2 digit <Items>
<Common> Y Holds common elemen- <Details>
ts for domestic and
international consign-
ments
<ContactName> Y <Common>
<Service> Y The TNT service requi- Must be valid TNT <=3 digit <Common>
red service code
<Insurance> N Insurance value of con- <=13 digit <Common>
signment in specified
currency
<InsuranceCurrency> N Insurance currency Must contain a valid <=3 digit <Common>
TNT currency code
<SenderReference> N Customer reference <=15 digit <Common>
<Payment> Y Payment indicator Must be 0 (sender <=1 digit <Common>
pays) or 1 (receiver
pays)
<Instructions> N Delivery Instructions <=60 digit <Common>
<SpecialGoods> N Special handling based Y’ or ’N’ <=1 digit <Common>
on value
<Domestic> N Holds elements valid <Details>
for domestic shipments
only
<COD> N Cash on delivery <Domestic>
wwwtntit
XML Element Attribu- Data / Description Constraints Max lenght Parent Tag
te Required
<Amount> N Value to be paid for the <=13 digit <COD>
item in specified cur-
rency. Payment is to be
made on the delivery of
the goods
<Currency> N Currency to be used Must be ’EUR’ <=3 digit <COD>
<SenderComm> N Charge the C.O.D. fee Y’ or ’N’ <=1 digit <COD>
to the sender?
<SenderRefund> N Y’ or ’N’ <=1 digit <COD>
<OperationalOptions> Y The delivery option re- Must be ’1’ (Held in <=1 digit <Domestic>
quired TNT depot)
’2’ (Held at drop-off
point)
’3’ (Delivery on ap-
pointment)
or ’4’ (Delivery on Loc-
kerBox)
<Option> Y
<OperationalOptions>
<International> N Holds elements valid <Details>
for international ship-
ments only
<GoodsValue > Y <International>
<GoodsValue > N Value of consignment <=13 digit <International>
in specified currency
<GoodsValueCurrency> N Currency to be used Must contain a valid <=3 digit
TNT currency code
<Priority> N Priority option? Y’ or ’N’ <=1 digit
<FDA> N Food and Drug Admi- Y’ or ’N’ <=1 digit
nistration?
<DryIce> N Dry Ice option? Y’ or ’N’ <=1 digit
<CheckPriceEnabled> Y Must be ’Y’ <=1 digit <Details>
<Shipment> N <Document>
<Date> Y Date on which collec- Must be formatted <=10 digit <Shipment>
tion is to be shipped dd.mm.yyyy. Cannot
be in the past.
<Receiver> N Holds recipient’s de- <Shipment>
tails elements
<Address> Y <Receiver>
<Address> Y First line of address <=30 digit <Receiver>
<CompanyName> Y Full company name <=50 digit <Receiver>
<ReceiverAccountNo> N Receiver company ac- Must be numeric and <=11 digit <Receiver>
count upon which col- be registered against
lection is to be rated the customers logon de-
tails
<Town> Y Town name <=30 digit <Receiver>
<ProvinceState> N Province name <=30 digit <Receiver>
<Postcode> Y Postcode <=9 digit <Receiver>
<CountryID> Y Country code Must be TNT country <=2 digit <Receiver>
code
<CMessage> N <Document>
<ExtraCee> Y Extra UE Country? Y’ or ’N’ <=1 digit <Document>
wwwtntit
11 Esempio di XML in input
1 <R e s u l t S e t>
2 <A p p l i c a t i o n F u n c t i o n>
3 <Complete>
4 <Address>
5 <ShortName>
6 <A d d r e s s L i n e 1>
7 <Town>
8 <Postco de>
9 <CountryID>
10 <ContactName>
11 <CompanyName>
12 
13 </ Address>
14 <ShipmentKey>
15 <S e r v i c e cod=”A” i d=” e x p r e s s ”>E x p r e s s</ S e r v i c e>
16 <PromoID/>
17 <PromoDesc/>
18 <CMessage />
19 <AccountNo>
20 <Booking>
21 <Date>>
22 <D e t a i l s>
23 <Package>
24 <Items>
25 <ItemSeqNo>
26 <Type>
27 <INumber>
28 <IWeight>
29 
30 <Length>
31 <Height>
32 <Width>
33 <Volume>
34 <Items>
35 <Package>
36 <D e t a i l s>
37 
38 
39 
40 <S e r v i c e s L i s t>
41 <S e r v i c e>
42 <Code>D</Code>
43 <D e s c r i p t i o n>1 0 : 0 0 E x p r e s s</ D e s c r i p t i o n>
44 1 6 , 8 0
wwwtntit
45 <Timing>e n t r o o r e 1 0 . 0 0 g i o r n o s u c c e s s i v o</ Timing>
46 </ S e r v i c e>
47 <S e r v i c e>
48 <Code>T</Code>
49 <D e s c r i p t i o n>1 2 : 0 0 E x p r e s s</ D e s c r i p t i o n>
50 1 1 , 6 0
51 <Timing>e n t r o o r e 1 2 . 0 0 g i o r n o s u c c e s s i v o</ Timing>
52 </ S e r v i c e>
53 <S e r v i c e>
54 <Code>A</Code>
55 <D e s c r i p t i o n>E x p r e s s</ D e s c r i p t i o n>
56 6 , 3 0
57 <Timing>g i o r n i l a v o r a t i v i : 1</ Timing>
58 </ S e r v i c e>
59 </ S e r v i c e s L i s t>
60 </ Complete>
61 <TransactionTimeId>
62 </ R e s u l t S e t>
wwwtntit
12 Il CheckAddress
Di seguito i tag necessari per il controllo delle localitá

<software> </Shipment>
<application> Y MYRTL=Nazionale, MYR- <=6 digit </software>
TLI=Internazionale
<version> Y Fisso=1.0 <=3 digit </software>
</software> Y </shipment>
<security> Y </shipment>
<customer> Y Dato fornito da TNT Alphanumeric <=6 </security>
digit
<user> Y Dato fornito da TNT Alphanumeric ‘</security>
<=12 digit
<password> Y Dato fornito da TNT Alphanumeric </security>
<=20 digit
<langid> Y IT= in Italiano, EN= in Alphanumeric <=2 </security>
Inglese digit
</security> Y </shipment>
<consignment Y action=“V” validazione Alphanumeric <=1 </shipment>
action=“”> digit
<addresses> Y </consignment
action>
<address> Y </addresses>
<addressType> Y R=Receiver (Destinatario), Alphanumeric <=1 </address>
D=Delivery (Indirizzo di digit
Consegna)
<postcode> Y CAP/Zip Code Alphanumeric <=9 </address>
digit
<country> Y Codice Nazione/Country Co- Alpha<=2 digit </address>
de
<town> Y Localitá/Town Name Alphanumeric </address>
<=30 digit
<province> Y Provincia/County Alphanumeric <=5 </address>
digit
<address> Y </addresses>
<addresses> Y </consignment>
<consignment> Y </shipment>
</shipment> Y
wwwtntit
13 Tabella Prodotti e Opzioni
descrizione doc non opzione descrizione opzione divisione prodotto
Economy Express NONDOC AU Automotive G 48N
Economy Express NONDOC BB Biological Substance Cat. B G 48N
Economy Express NONDOC DI Dry Ice G 48N
Economy Express NONDOC ES Enhanced Security Program G 48N
Economy Express NONDOC FD US Food & Drug Administration G 48N
Economy Express NONDOC HZ Hazardous Goods G 48N
Economy Express NONDOC IN Insurance G 48N
Economy Express NONDOC LB Excepted Lithium Batteries G 48N
Economy Express NONDOC LQ Hazardous (Limited Quantity) G 48N
Economy Express NONDOC PR Priority G 48N
Economy Express NONDOC SA Saturday Delivery G 48N
Economy Express NONDOC TD Time Definite G 48N
12:00 Economy Express NONDOC ESP Enhanced Security Program G 412
12:00 Economy Express NONDOC FDA US Food & Drug Administration G 412
12:00 Economy Express NONDOC IN Insurance G 412
Express DOC IN Insurance G 15D
Express DOC PR Priority G 15D
Express DOC SA Saturday Delivery G 15D
Express DOC TD Time Definite G 15D
Express NONDOC AU Automotive G 15N
Express NONDOC BB Biological Substance Cat. B G 15N
Express NONDOC CL Central Clearance G 15N
Express NONDOC DI Dry Ice G 15N
Express NONDOC ESP Enhanced Security Program G 15N
Express NONDOC FDA US Food & Drug Administration G 15N
Express NONDOC HZ Hazardous Goods G 15N
Express NONDOC IN Insurance G 15N
Express NONDOC LB Excepted Lithium Batteries G 15N
Express NONDOC PP Prepaid G 15N
Express NONDOC PR Priority G 15N
Express NONDOC SA Saturday Delivery G 15N
Express NONDOC TD Time Definite G 15N
9:00 Express DOC IN Insurance G 09D
9:00 Express NONDOC BB Biological Substance Cat. B G 09N
9:00 Express NONDOC CL Central Clearance G 09N
9:00 Express NONDOC ESP Enhanced Security Program G 09N
9:00 Express NONDOC FDA US Food & Drug Administration G 09N
9:00 Express NONDOC IN Insurance G 09N
9:00 Express NONDOC LB Excepted Lithium Batteries G 09N
9:00 Express NONDOC SA Saturday Delivery G 09N
wwwtntit
descrizione doc non opzione descrizione opzione divisione prodotto
10:00 Express NONDOC AU Automotive G 10N
10:00 Express NONDOC IN Insurance G 10N
10:00 Express NONDOC LB Excepted Lithium Batteries G 10N
12:00 Express DOC SA Saturday Delivery G 12D
12:00 Express NONDOC AU Automotive G 12N
12:00 Express NONDOC DI Dry Ice G 12N
10:00 Express NONDOC D D
10:00 Express DOC D D
12:00 Express NONDOC D T
12:00 Express DOC D T
Express NONDOC D N
Express DOC D N
Express (Air SCS) NONDOC D A
Express (Air SCS) DOC D A
Economy Express (Road SCS) NONDOC D N
Economy Express (Road SCS) DOC D N
wwwtntit
14 Codici Nazione (ISO)
Codice Nazione Nome Nazione

AF Afghanistan
AX Aland Islands
AL Albania
DZ Algeria
AS American Samoa
AD Andorra
AO Angola
AI Anguilla
AQ Antarctica
AG Antigua and Barbuda
AR Argentina
AM Armenia
AW Aruba
AC Ascension Island
AU Australia
AT Austria
AZ Azerbaijan
BS Bahamas
BH Bahrain
BB Barbados
BD Bangladesh
BY Belarus
BE Belgium
BZ Belize
BJ Benin
BM Bermuda
BT Bhutan
BW Botswana
BO Bolivia
BA Bosnia and Herzegovina
BV Bouvet Island
BR Brazil
IO British Indian Ocean Territory
BN Brunei Darussalam
BG Bulgaria
BF Burkina Faso
BI Burundi
KH Cambodia
CM Cameroon
CA Canada
CV Cape Verde
wwwtntit
KY Cayman Islands
CF Central African Republic
TD Chad
CL Chile
CN China
CX Christmas Island
CC Cocos (Keeling) Islands
CO Colombia
KM Comoros
CG Congo
CD Congo, Democratic Republic
CK Cook Islands
CR Costa Rica
CI Cote D’Ivoire (Ivory Coast)
HR Croatia (Hrvatska)
CU Cuba
CY Cyprus
CZ Czech Republic
CS Czechoslovakia (former)
DK Denmark
DJ Djibouti
DM Dominica
DO Dominican Republic
TP East Timor
EC Ecuador
EG Egypt
SV El Salvador
GQ Equatorial Guinea
ER Eritrea
EE Estonia
ET Ethiopia
EU European Union
FK Falkland Islands (Malvinas)
FO Faroe Islands
FJ Fiji
FI Finland
FR France
FX France, Metropolitan
GF French Guiana
PF French Polynesia
TF French Southern Territories
MK F.Y.R.O.M. (Macedonia)
GA Gabon
wwwtntit
GM Gambia
GE Georgia
DE Germany
GH Ghana
GI Gibraltar
GB Great Britain (UK)
GR Greece
GL Greenland
GD Grenada
GP Guadeloupe
GU Guam
GT Guatemala
GG Guernsey
GN Guinea
GW Guinea
GY Guyana
HT Haiti
HM Heard and McDonald Islands
HN Honduras
HK Hong Kong
HU Hungary
IS Iceland
IN India
ID Indonesia
IR Iran
IQ Iraq
IE Ireland
IL Israel
IM Isle of Man
IT Italy
JE Jersey
JM Jamaica
JP Japan
JO Jordan
KZ Kazakhstan
KE Kenya
KI Kiribati
KP Korea (North)
KR Korea (South)
XK Kosovo*
KW Kuwait
KG Kyrgyzstan
LA Laos
wwwtntit
LV Latvia
LB Lebanon
LI Liechtenstein
LR Liberia
LY Libya
LS Lesotho
LT Lithuania
LU Luxembourg
MO Macau
MG Madagascar
MW Malawi
MY Malaysia
MV Maldives
ML Mali
MT Malta
MH Marshall Islands
MQ Martinique
MR Mauritania
MU Mauritius
YT Mayotte
MX Mexico
FM Micronesia
MC Monaco
MD Moldova
MN Mongolia
ME Montenegro
MS Montserrat
MA Morocco
MZ Mozambique
MM Myanmar
NA Namibia
NR Nauru
NP Nepal
NL Netherlands
AN Netherlands Antilles
NT Neutral Zone
NC New Caledonia
NZ New Zealand (Aotearoa)
NI Nicaragua
NE Niger
NG Nigeria
NU Niue
NF Norfolk Island
wwwtntit
MP Northern Mariana Islands
NO Norway
OM Oman
PK Pakistan
PW Palau
PS Palestinian Territory, Occupied
PA Panama
PG Papua New Guinea
PY Paraguay
PE Peru
PH Philippines
PN Pitcairn
PL Poland
PT Portugal
PR Puerto Rico
QA Qatar
RE Reunion
RO Romania
RU Russian Federation
RW Rwanda
GS S. Georgia and S. Sandwich Isls.
SH Saint Helena
KN Saint Kitts and Nevis
LC Saint Lucia
MF Saint Martin
VC Saint Vincent & the Grenadines
WS Samoa
SM San Marino
ST Sao Tome and Principe
SA Saudi Arabia
SN Senegal
RS Serbia
YU Serbia and Montenegro (former)
SC Seychelles
SL Sierra Leone
SG Singapore
SI Slovenia
SK Slovak Republic
SB Solomon Islands
SO Somalia
ZA South Africa
SS South Sudan
ES Spain
wwwtntit
LK Sri Lanka
SD Sudan
SR Suriname
SJ Svalbard & Jan Mayen Islands
SZ Swaziland
SE Sweden
CH Switzerland
SY Syria
TW Taiwan
TJ Tajikistan
TZ Tanzania
TH Thailand
TG Togo
TK Tokelau
TO Tonga
TT Trinidad and Tobago
TN Tunisia
TR Turkey
TM Turkmenistan
TC Turks and Caicos Islands
TV Tuvalu
UG Uganda
UA Ukraine
AE United Arab Emirates
UK United Kingdom
US United States
UM US Minor Outlying Islands
UY Uruguay
SU USSR (former)
UZ Uzbekistan
VU Vanuatu
VA Vatican City State (Holy See)
VE Venezuela
VN Viet Nam
VG British Virgin Islands
VI Virgin Islands (U.S.)
WF Wallis and Futuna Islands
EH Western Sahara
YE Yemen
ZM Zambia
ZR Zaire see Congo, Democratic Republic
ZW Zimbabwe
wwwtntit
15 ExpressLabel Light
grazie al sistema di conversione dati di TNT, consente ai clienti che non hanno la possibilitá di
sviluppare il complesso sistema di comunicazione e gestione dei dati necessario al funzionamento di
ExpressLabel, di accedere alle stesse informazioni e di produrre la stessa documentazione.
Come funziona
I dati corrispondenti ai colli del cliente pronti per essere spediti, sono inviati via email o via ftp ai
sistemi di TNT.
Il file ricevuto da TNT in formato Microsoft xls, csv o altro (se concordato) viene convertito
in formato standard ExpressLabel. L’elaborazione rende le spedizioni disponibili su www.myTNT.
it per la stampa, eventuale ristampa delle etichette oppure per la correzione di eventuali errori
direttamente dal sito. É prevista la possibilitá di ottenere un file di stampa in formato pdf o zpl
ritrasmesso al cliente per le operazioni di etichettatura dei colli (opzionale).
Il file di input
É possibile contattare l’helpdesk tecnico di TNT per ottenere la personalizzazione del formato file
di input oppure semplicemente per ottenere un file di esempio in formato testo o Microsoft Excel.
Il file di esempio in formato xls, contiene il dettaglio dei codici servizio, opzione e nazione utili per
la corretta gestione delle spedizioni. La lettera di vettura, ovvero il numero di AWB nazionale o
internazionale che TNT acquisirá ed utilizzerá per il trattamento operativo ed amministrativo della
vostra spedizione.
La definizione della modalitd́i attribuzione é governata dal tag <consignmenttype>.
T= La chiave viene fornita da TNT ed equivale alla Lettera di vettura ;

C= la chiave viene fornita dal cliente.
Se si intende attribuire una lettera di vettura in formato TNT occorre considerare che:
Le Lettere di Vettura nazionali e le Connotes (Consignment Notes) internazionali hanno formato
diverso.
Il nostro Supporto Tecnico, vi fornirá quindi DUE differenti range di numerazioni, ovvero di
Connotes (internazionali) e di Lettere di Vettura (nazionali) , per ognuna di queste é previsto l’u-
tilizzo di un Check-Digit, il cui valore é determinato con un algoritmo.
wwwtntit
- Per spedizioni internazionali:
É un numero composto da 8 cifre numeriche ed un check digit su base 11, la cui formula é di
seguito espressa: Nr lettera di vettura = 8 numeri. Il 9 sará il check digit
A= 1 x 8 +
2x6+
3x4+
4x2+
5x3+
6x5+
7x9+
8x7
B= Integer(A/11) x 11
chk = A - B
Se chk = 0 il check digit sará 5
Se chk = 1 il check digit sará 0
se chk <> 0 o 1 allora il check digit sará = 11 CHK
di seguito alcuni esempi. Data la numerazione 77772900 andiamo a calcolare il Check digit
A=
7x8+
7x6+
7x4+
7x2+
2x3+
9x5+
0x9+
0 x 7 Risultato = 191
B=Integer [(quindi il valore intero che risulta dalla seguente operazione) 191/11] x 11 = 187
191-187= 4
Check digit= 7
La Lettera di Vettura generata comprensiva di check digit sará: 777729007
- Per spedizioni nazionali:
É composta da un prefisso alfabetico (2 byte) in testa , 8 cifre numeriche ed un check digit su

base 7.
I valori del check digit possono assumere un valore compreso tra 0 e 6.
Il calcolo é semplicissimo. Ipotizziamo di usare la seguente numerazione di partenza 44433370

( se il valore fosse inferiore alle 8 cifre, si aggiunge uno 0 in testa sino al raggiungimento di 8 byte)
highvalue= Y/N
Il numero delle ldv deve essere diviso per 7
wwwtntit
(44433370 / 7 = 6347624,28)
il numero ottenuto senza i decimali, si moltiplica per 7.
(6347624 * 7 = 44433368)
a questo punto dal numero della lettera di vettura si sottrae il risultato della moltiplicazione,
si otterrá il check-digit
(44433370 - 44433368 = 2)
La Lettera di Vettura generata comprensiva di check digit sará: MT444333702
wwwtntit
16 TNT Manifest Design: Raccomandazioni per
il posizionamento dei Barcodes
16.1 Overview
In questo documento sono descritti gli standard di settore per il posizionamento di codici a barre
code 128 e code 39 (3of9). I codici a barre inclusi nei manifesti, dovranno essere conformi alle
specifiche descritte in questo documento e garantire ottimi valori di leggibilitá.
I codici a barre stampati senza rispettare gli standard specificati si prestano maggiormente ad
interferenze e scarsa leggibilitá. Questo causa rallentamenti nella gestione operative, ripetizione
delle scansioni e digitazioni manuali. Si presume che la scansione sará effettuata a 200dpi.
16.2 Barcode Struttura e Contenuto

I codici a barre devono essere circondati da una “quit zone” come illustrato di seguito.
16.3 Code 128 Linee guida per il posizionamento

• I codici a barre dovranno essere circondati da una quiet-zone’ di almeno 0.25 pollici per
consentire il riconoscimento ottimale durante la scansione.
• Un codice a barre Code 128 include una quiet zone’ (10 x-dimensions), un carattere di inizio,
i dati codificati, un carattere di controllo, un carattere di stop, e una trailing quiet zone (10
x-dimensions).
• Per il riconoscimento ottimale, la quit zone’ deve essere almeno di 0.25 pollici.
wwwtntit
• Il valore minimo consentito per x-dimension (spessore del modulo) é di 7.5 mm (0.0075
pollici) per carattere.
• L’altezza minima é il 15% della lunghezza del simbolo oppure 0.25 pollici, qualunque sia il
maggiore.
• L’altezza delle barre deve essere almeno .15 volte la lunghezza del simbolo oppure .25 pollici,
a seconda di quale é piú grande. La lunghezza del simbolo é data dall’equazione:
L = (11C + 35)X (alfanumerico) L = (5.5C + 35)X (solo numerico per Code C)
dove:
L = lunghezza minima del simbolo, escludendo la quiet zone.
C = il numero di caratteri, pi il numero di caratteri funzione, pi il numero di caratteri di
selezione (esclusi start, stop e checksum. Che vengono aggiunti automaticamente.)
X = X-dimension (spessore del modulo)
16.4 Code 39 (3 of 9) Linee guida per il posizionamento

• I codici a barre devono essere circondati da una “quit zone” di almeno 0.25 pollici per
consentirne il riconoscimento ottimale durante la scansione.
• Il valore minimo consentito per x-dimension (spessore del modulo) é di 7.5 mm per carattere.
• L’altezza minima é il 15% della lunghezza del simbolo oppure 0.25 pollici, qualunque sia il
maggiore.
• Il rapporto di stampa dello spessore pu variare di larghezza nell’intervallo di 1.8 - 3.1, ma
un valore pari a 3.0 é fortemente raccomandato.
• Come da standard dei codice a barre industriali, é richiesto un asterisco (*) come codice di
controllo prima e dopo i dati, stampato utilizzando il font barcode Code. Il carattere speciale
(*) assume la funzione di carattere di controllo Start/Stop.
wwwtntit
17 Documentazione Cartacea
Il layout della documentazione di spedizione si basa su quella prodotta da ExpressShipper.
17.1 Address Label Layout
Number Field Description Mandatory Format / Comments Max Length

1. Consignment Number Yes * A A 9 9 9 9 9 9 9 9 9 A A * (double spacing) 30 (Including * and
If Piece Level Tracking switched on Yes e.g. spaces)
*GE944990008WW* 39 (Including * and
*9999999999999999999* spaces)
In the format of “* 1” Then the numeric sec-
tion of the consignment number Then the pie-
ce number The second piece of consignment
GE000002032WW would be
*1000002032000000002*
wwwtntit
2. Sender TNT Account Number Yes 9
3. Sender Company Name (or Collec- Yes 30
tion if present)
4. Sender Address Line 1 (or Collec- Yes 30
tion if present)
5. Sender Address Line 2 (or Collec- No 30
tion if present)
6. Sender Address Line 3 (or Collec- No 30
tion if present)
7. Sender City / Town (or Collection Yes 30
if present)
8. Sender County / Province (or No 30
Collection if present)
9. Sender Postcode (or Collection if Country 9
present) Dependant
10. Sender Contact Name (or Collec- No 22
tion if present)
11. Sender Telephone Number (or N 1st partof T elN o. + +2nd part. The telephone 17 (7 + + 9) 16 for
Collection if present) number in ExpressShipper is defined as one ExpressShipper
single field of 16 characters.
12. Receiver Company Name (or Deli- Yes 30
very if present)
13. Receiver Address Line 1 (or Delive- Yes 30
ry if present)
14. Receiver Address Line 2 (or Delive- No 30
ry if present)
15. Receiver Address Line 3 (or Delive- No 30
ry if present)
16. Receiver Town (or Delivery if Yes 30
present)
17. Receiver County (or Delivery if No 30
present)
18. Receiver Postcode (or Delivery if Country 9
present) Dependant
19 Receiver Country Name (or Delive- Yes 30
ry if present)
20. Receiver Contact Name (or Delive- No 22
ry if present)
21. Receiver Telephone Number (or No 1st partof T elN o. + +2nd part The telephone 17 (7 + + 9) 16 for
Delivery if present) number in ExpressShipper is defined as one ExpressShipper
22. Special Instructions No Split over 2 lines if ¿ 47 characters so that no 60
split words
23. Service (Product) Code Yes ( + TNT Product Codes Table + ) 4 (Excluding brackets)
24. Service Description Yes 30
25. Option Code 1 No ( + TNT Option Codes Table + ) 3 (Excluding brackets)
26. Option Description 1 No 30
33. Customer (or Shipping) Consign- No 24
ment Reference
wwwtntit
34. Piece Reference No 24
35. Shipping Date Yes DD MMM YYYY 11
36. Package Description No If document consignment then display Docu- 20
ments else display Package Description. No-
te: For UK domestic consignments within
ExpressShipper this field is left blank
37. Literal Dimensions: or Consign- No For document consignment the field is blank. 19
ment Volume: For a non-document consignment if the di-
mensions are specified display Dimensions:
otherwise display Consignment Volume:
38. Package Dimensions or Consign- No For a document consignment the field is blank.
ment Volume For a non document consignment without
dimensions:
Metric: 9999999.999 m3
Imperial: 9999999.99 f 2
For a non document consignment with
dimensions:
For Metric:
Package Length + cm x + Package Width +
cm x + Package Height + cm
For Imperial:
Package Length + in x + Package Width + in
x + Package Height + in
39. 1st Article Description No For document consignment the field is blank. 30
ExpressShipper does not display this field.
40. 2nd Article Description No For document consignment the field is 30
blank.ExpressShipper does not display this
field.
41. 3rd Article Description No For document consignment the field is blank. 30
ExpressShipper does not display this field.
42. 4th Article Description No For document consignment the field is 30
field.
field.
field.
field.
field.
47. Dangerous Goods Indicator No If the consignment contains Dangerous Goods
then display DANGEROUS GOODS otherwise
the field is blank.
For consignments that do not contain Dange-
rous Goods ExpressShipper will display NON
DANGEROUS GOODS
48. Piece Number (Package Sequence) Yes 999 3
49. Total number of packages in the Yes 999 3
consignment
wwwtntit
50. Total Weight of Consignment Yes For metric settings the format is: 12
9999999.999Kgs
For Imperial settings the format is:
99999lbs99oz
Nota: Il formato barcode per il consignment number un code 39.
wwwtntit
18 Consignment Note Layout

1. Consignment Number Yes 15
3. Sender Company Name (or Collec- Yes 30
tion if present)
4. Sender Address Line 1 (or Collec- Yes 30
tion if present)
5. Sender Address Line 2 + Sender No Address Line 2 + , + Address Line 3 30 + , + 30
Address Line 3 (or Collection if
present)
6. Sender City / Town (or Collection Yes 30
if present)
7. Sender Postcode (or Collection if Country 9
present) Dependant
8. Sender Province / County (or No 30
Collection if present)
wwwtntit
9. Sender Country Name (or Collec- Yes 30
tion if present)
10. Sender Contact Name (or Collec- No 22
tion if present)
11. Sender Telephone Number (or No 1st partof T elN o. + +2nd part The telephone 17 (7 + + 9) 16 for
Collection if present) number in ExpressShipper is defined as one ExpressShipper
12. Receiver Company Name Yes 30
13. Receiver Address Line 1 Yes 30
14. Receiver Address Line 2 + Receiver No Address Line 2 + , + Address Line 3 30 + , + 30
Address Line 3
15. Receiver City / Town Yes 30
16. Receiver Postcode Country 9
Dependant
17. Receiver Province / County No 30
18. Receiver Country Name Yes 30
19. Receiver Contact Name No 22
20. Receiver Telephone Number No 1st partof T elN o. + +2nd part The telephone 17 (7 + + 9) 16 for
number in ExpressShipper is defined as one ExpressShipper
21. Literal ** Additional Items ** No If consignment contains more than four packa- 22
ges display ** Additional Items ** otherwise
the field is blank.
22. Package Description Line 1 No If document consignment then display Docu- 20
ments else display Package Description Line
1.
23. Package Description Line 2 No For document consignment the field is blank. 20
For Non Document consignment display
Package Description Line 2.
26. Tariff Code No Display the first Tariff Code defined against the 15
consignment, the field is blank for document
consignments.
27. Total number of packages in the Yes ZZ9 3
Consignment
28. Total weight of the Consignment Yes For metric settings the format is: 11
9999999.999Kgs
99999lbs99oz
29. Total volume of the Consignment No For metric settings the format is: 9999999.999 14
m3
For Imperial settings the format is: 9999999.99
f2
30. Service (Product) Code Yes (‘ + TNT Product Codes Table +’ ) No- 4 (Excluding brackets)
te: Does not appear on ExpressShipper
Consignment Note.
Note: Does not appear on ExpressShipper
Consignment Note.
wwwtntit
Consignment Note.
Consignment Note.
Consignment Note.
40. Dangerous Goods Indicator No If the Consignment contains Dangerous Goods 19
then display DANGEROUS GOODS otherwise
display NON DANGEROUS GOODS
41. Sender or Receiver Pays Yes If payment indicator is Sender Pays then 13
display SENDER PAYS otherwise display
RECEIVER PAYS
42. Literal Insurance Currency: No Only appears on the Customs copy of the 19
Consignment
43. Insurance Currency Name No Only appears on the Customs copy of the Con- 30
signment. If the Consignment has insurance di-
splay the Insurance Currency Name otherwise
the field is blank.
44. Literal Value: No Only appears on the Customs copy of the 6
Consignment
45. Insurance Value No Only appears on the Customs copy of the Con- 14
signment. If the Consignment has insurance
display the Insurance Value otherwise the field
is blank. 99999999999.99
Note: The decimal separator is dependant on
the Windows Regional Settings.
47. Delivery Company Name No 30
48. Delivery Address Line 1 No 30
49. Delivery Address Line 2 + Receiver No Address Line 2 + , + Address Line 3 30 + , + 30
Address Line 3
50. Delivery City / Town No 30
51. Delivery Postcode No 9
52. Delivery Province / County No 30
53. Delivery Country Name No 30
54. Delivery Contact Name No 22
55. Delivery Telephone Number No 1st partof T elN o. + + ‘2nd part. The telepho- 17 (7 + + 9) 16 for
ne number in ExpressShipper is defined as one ExpressShipper
56. Receivers VAT Number No 20
57. Literal “Invoice value of dutiables” No Only appears on the Customs copy of the 26
consignment
58. Literal “Currency:” No Only appears on the Customs copy of the 9
consignment
59. Currency Description No Only appears on the Customs copy of the 30
consignment
60. Literal “Value:” No Only appears on the Customs copy of the 6
consignment
wwwtntit
61. Consignment Value No Only appears on the Customs copy of the 14
consignment 99999999999.99
Note: The decimal separator is dependant on
the Windows Regional Settings.
62. Special Instructions No 60
63. Customer (or Shipper) Consign- No 24
ment Reference
64. Receivers Account Number No Only displayed if consignment is receivers pay. 9
65. Literal “Consignment Note Identi- Yes ExpressShipper: For the receivers copy of the
fier” consignment display “Receiver Copy”. For
the customs copy of the consignment display
“Customs Copy”
ExpressManager: For the receivers copy of the
consignment display “Receivers Copy”. For
the customs copy of the consignment display
“Customs Copy”
Both copies include the text “Please Keep For
Reference”
wwwtntit
19 Layout Manifesto riepilogativo (Summary)

1. Manifest Number Yes
2. Carrier Name No Only appears for ExpressManager
3. Sender TNT Account Yes 9
Number
4. Sender Company Name Yes 30
wwwtntit
5. Sender Address Yes Sender Address Line 1 + , + Sender Address 30 + , + 30 + , + 30
Line 2 + , + Sender Address Line 3
6. Sender Address Yes Sender Town + , + Sender County + , + 30 + , + 30 + , + 9
Sender Postcode + , + Sender Country + , + 30
7. Page Number Yes
8. Total Number of Pages Yes
10. Metric / Imperial Weight Indicator Yes For Metric display: 8
(Kgs)
For Imperial display:
(Lbs.oz)
11. Consignment Number Yes AA999999999AA 15
12. Total number of consignment pac- Yes 99999 5
kages
13. Total Weight of Consignment Yes For metric settings the format is: 11
9999999.999
999 99
ment Reference
15. Receiver Company Name (or Deli- Yes 30
very if present)
16. Receiver Town (or Delivery if Yes 30
present)
17. Receiver Country Name (or Delive- Yes 30
ry if present)
20. Total Number of consignments for Yes
Sender Account
21. Total Number of packages for Yes
Sender Account
22. Total Weight for Sender Account Yes For metric settings the format is: 11
9999999.999
999 99
24. Total Number of consignments for Yes
Sender Company Name
25. Total Number of packages for Yes
Sender Company Name
26 Total Weight for Sender Company Yes For metric settings the format is: 11
Name 9999999.999
999 99
27. Overall Total number of consign- Yes
ments
28. Overall Total number of packages Yes
29. Overall consignment weight Yes For metric settings the format is: 11
9999999.999
999 99
30. Print Date Yes DD MMM YYYY 11
31. Print Time Yes HH:MM 5
wwwtntit
20 Layout Manifesto dettagliato (Detailed)

1. Manifest Description Yes
2. Manifest Number Yes
3. Page Number Yes
4. Total Number of Pages Yes
wwwtntit
6. Pickup Id Yes For ExpressShipper this is populated with “Ex-
pressShipper XXXXXX where XXXXXX re-
presents the version number of ExpressShipper
used to produce the manifest”.
7. Registration Number Yes Populated with the customers registration 8
number within ExpressShipper.
This field does not appear on the ExpressMa-
nager manifest.
10. Sender Address Yes Sender Address Line 1 + , + Sender Address 30 + , + 30 + , + 30
Line 2 + , + Sender Address Line 3
11. Sender Address Yes Sender Town + , + Sender County + , + 30 + , + 30 + , + 9
Sender Postcode + , + Sender Country + , + 30
12. Print Date Yes DD MMM YYYY 11
13. Print Time Yes HH:MM 5
15. Literal “Sending Depot” No Only displayed if the Origin Depot has been 13
supplied
16. Literal “Receiving Depot” No Only displayed if the Destination Depot has 15
been supplied
17. Origin Depot No Not used for ExpressShipper
18. Destination Depot No Not used for ExpressShipper 60
19. Special Instructions No
20. Dangerous Goods Indicator No If the Consignment contains Dangerous Goods 19
then display “DANGEROUS GOODS” other-
wise display “NON DANGEROUS GOODS”
21. Sender or Receiver Pays Yes If payment indicator is Sender Pays then 13
display “SENDER PAYS” otherwise display
“RECEIVER PAYS”
22. Sender Contact Name No 22
23. Sender Telephone Number No 1st part of Tel No. + + 2nd part 17 (7 + + 9)
The telephone number in ExpressShipper is 16 for ExpressShipper
defined as one single field of 16 characters.
ment Reference
25. Receivers VAT Number No 20
26. Receivers Account Number No Only displayed if consignment is receivers pay. 9
27. Receiver Address Yes Receiver Name + , Receiver Address Line 1 + 30 + , + 30 + , + 30
, + Receiver Address Line 2 + , + Receiver + , + 30 + ,
Address Line 3 + ,
28. Receiver Address Yes Receiver Town + , + Receiver County + , + 30 + , + 30 + , + 9
Receiver Postcode + , + Receiver Country + + , + 30 + .
.
29. Service Yes ( + Service Code + ) + Service Description ( + 4 + ) + 30
30. Receiver Telephone Number No 1st part of Tel No. + + 2nd part 17 (7 + + 9)
The telephone number in ExpressShipper is 16 for ExpressShipper
defined as one single field of 16 characters.
31. Receiver Contact Name No 22
32. Collection Address No Collection Name + , Collection Address Line 30 + , + 30 + , + 30
1 + , + Collection Address Line 2 + , + + , + 30 + ,
Collection Address Line 3 + ,
33. Collection Address No Collection Town + , + Collection County + 30 + , + 30 + , + 9
, + Collection Postcode + , + Collection + , + 30 + .
Country + .
wwwtntit
34. Delivery Address No Delivery Name + , Delivery Address Line 1 + 30 + , + 30 + , + 30
, + Delivery Address Line 2 + , + Delivery + , + 30 + ,
Address Line 3 + ,
35. Delivery Address No Delivery Town + , + Delivery County + , + 30 + , + 30 + , + 9
Delivery Postcode + , + Delivery Country + + , + 30 + .
.
36. Option 1 No ( + Option Code 1 + ) + Option 1 Description (+ 3 + ) + 30
40. Total number of packages in the Yes 99999 5
Consignment
41. Total weight of the Consignment Yes For metric settings the format is: 11
9999999.999Kgs
99999lbs99oz
42. Insurance Value No 99999999999.99 14
43. Consignment Value No 99999999999.99 14
44. Package Line 1 Description No Not populated for document consignment 20
47. Package Line 1 Dimensions No Formatted depending on the metric / imperial
setting:
For Metric:
Package Line 1 Length + cm x + Package Line
1 Width + cm x + Package Line 1 Height +
cm
For Imperial:
Package Line 1 Length + in x + Package Line
1 Width + in x + Package Line 1 Height + in
setting:
For Metric:
cm
For Imperial:
setting:
For Metric:
cm
For Imperial:
50. Total Volume of the Consignment No For metric settings the format is: 14
9999999.999 m’
For imperial settings the format is:
9999999.99 f
51. Piece Reference Literal No Not used within ExpressShipper
wwwtntit
21 Etichetta Termica
Alcuni clienti che utilizzano il servizio web TNT di immissione e stampa delle etichette, necessitano ottenere queste
ultime in un formato adeguato per poterle produrre tramite stampante termica. Il formato delletichetta che verr
prodotto il medesimo gi emesso per alcuni altri clienti che utilizzano il mytnt.it, con tipo di barcode 128. Sará
possibile utilizzare l’etichetta nelle chiamate MYRTL e MYRTLI
1 <? xml v e r s i o n =”1.0” e n c o d i n g=”u t f −8”?>

2 <shipment xmlns : x s i=” h t t p : / /www. w3 . o r g /2001/XMLSchema−i n s t a n c e ” x s i :
noNamespaceSchemaLocation=” r o u t i n g l a b e l . xsd ”>
3 <s o f t w a r e>
4 <a p p l i c a t i o n>MYRTL</ a p p l i c a t i o n>
5 <v e r s i o n>1 . 0</ v e r s i o n>
6 </ s o f t w a r e>
7 <s e c u r i t y>
8 <customer>CUSTOMER01</ customer>
9 USER01
10 <password>USER01</ password>
11 <l a n g i d>IT</ l a n g i d>
12 </ s e c u r i t y>
13 <consignment a c t i o n=”R” c a s h o n d e l i v e r y=”N” h a z a r d o u s=”N” h i g h v a l u e
=”N” i n s u r a n c e=”N” s p e c i a l g o o d s=”N”>
14 <consignmentno>RL00000000</ consignmentno>
15 <s e n d e r A c c I d>123456</ s e n d e r A c c I d>
16 N
17 <l a b e l T y p e>T</ l a b e l T y p e>
18 </ consignment>
19 </ shipment>
wwwtntit
22 Le Etichette
Figura 1: Etichetta TNT
wwwtntit
Figura 2: Dettaglio ZPL TNT 1
wwwtntit
Figura 3: Dettaglio ZPL TNT 2
wwwtntit
Page 70 of 74 Figura 4: Dettaglio EtichettaTNT
1 Express
wwwtntit
Figura 5: Dettaglio Etichetta 2
wwwtntit
Figura 6: barcode TNT
wwwtntit
Figura 7: Domestic Label Layout
wwwtntit
Figura 8: Etichetta Termica
wwwtntit

Manuale-ExpressConnect 1.2

Caricato da

Informazioni sul documento

Titolo originale

Copyright

Formati disponibili

Condividi questo documento

Condividi o incorpora il documento

Opzioni di condivisione

Hai trovato utile questo documento?

Questo contenuto è inappropriato?

Copyright:

Formati disponibili

Manuale-ExpressConnect 1.2

Caricato da

Copyright:

Formati disponibili

TNT Express Connect Technical Guide

Page 1 of 74 TNT Express

2 Appendice A: Operational Options 16

5 Esempio di XML in input 21

6 Tabella dei codici di errore 25

11 Esempio di XML in input 37

13 Tabella Prodotti e Opzioni 40

14 Codici Nazione (ISO) 42

16 TNT Manifest Design: Raccomandazioni per il posizionamento dei

Page 2 of 74 TNT Express

18 Consignment Note Layout 57

19 Layout Manifesto riepilogativo (Summary) 61

20 Layout Manifesto dettagliato (Detailed) 63

Quali sono le funzionalitá di ExpressConnect ?

Page 3 of 74 TNT Express

Architettura Logica(sistemi e applicazioni in relazione)

• un’utenza dedicata ad operare verso myTNT da richiedere on-line su

• la registrazione di uno o piú indirizzi IP abilitati alla comunicazione tra il vostro

• consentire la comunicazione in Https attraverso un’attenta configurazione dei

1. l’accettazione e l’installazione dei certificati SSL di myTNT (scaricabili

Page 4 of 74 TNT Express

1. hiips://wwwmytntit/xmltest_htmlresponse.html per ottenere la ri-

• testare la procedura in ambiente di pre-produzione, dove:

1. il protocollo dovrá essere Https

L’utilizzo di un ambiente di pre-produzione consente di simulare liintero processo

Page 5 of 74 TNT Express

Page 6 of 74 TNT Express

• Mappare e documentare i processi aziendali, le difficoltá o nuove opportunitá.

• Dettagliare le esigenze aziendali e documentare le funzionalitá richieste allo

• Identificare le funzionalitá Web di TNT piú idonee alle necessitá aziendali.

• Richiedere al personale IT di stimare se é piú opportuno creare la tecnologia o

• Determinare il livello di capacitá dello sviluppatore (relativamente a XML e/o

• Valutare i costi e i tempi per l’integrazione dell’XML . La valutazione deve

1. Numero e tipo di piattaforme e sistemi interessati

ATTENZIONE : Sino a quando non avviene la lettura di un qualsiasi collo, la

Page 7 of 74 TNT Express

Le strutture di Input e di Output

1.1 Tabella degli elementi XML (Input)

XML Element Data Description Vincoli/ Parent Tag

Page 8 of 74 TNT Express

Page 9 of 74 TNT Express

Page 10 of 74 TNT Express

Page 11 of 74 TNT Express

Page 12 of 74 TNT Express

Page 13 of 74 TNT Express

Page 14 of 74 TNT Express

Page 15 of 74 TNT Express

Page 16 of 74 TNT Express

Page 17 of 74 TNT Express

Page 18 of 74 TNT Express

Page 19 of 74 TNT Express

Page 20 of 74 TNT Express

Page 21 of 74 TNT Express

Page 22 of 74 TNT Express

Page 23 of 74 TNT Express

Page 24 of 74 TNT Express

Page 25 of 74 TNT Express

Page 26 of 74 TNT Express

• binaryDocument: é un documento PDF relativo alle etichette ed é presente solo se l’og-

• outputString: é la stringa di output completa restituita dal servizio.

Page 27 of 74 TNT Express

Page 28 of 74 TNT Express

Page 29 of 74 TNT Express