Cliente: Kipoint Spa
Data: 10.05.2024
Release: 3.9
MANUALE
API KSYNC
KSync 4.0
Guttadauro Srl | via F.lli Bandiera, 4 – 21012 - Cassano Magnago (VA)
C.F./Partita IVA/Iscriz. Reg. Imp. VA: n. 01757550122 - R.E.A. VA: n. 205035 - Capitale sociale € 78.000,00 I.V.
T. 0331 729511 - Help Desk 0331 729512 - info@guttadauro.it - web.guttadauro.it
2
SOMMARIO
1. Prefazione .................................................................................................................................................. 4
2. Organizzazione del documento ................................................................................................................. 4
3. Regole di Escaping XML ........................................................................................................................... 5
4. Sicurezza dei Servizi WEB ........................................................................................................................ 7
5. Emissione Lettera di vettura Request (Prodotto EXTRA LARGE) ............................................................ 8
6. Emissione Lettera di vettura Tracciato Request (Prodotto EXTRA LARGE) .......................................... 10
6.1. Esempio Payload EXTRA LARGE base mono collo .......................................................................... 13
6.2. Esempio Payload EXTRA LARGE multi-collo .................................................................................... 15
6.3. Esempio Payload EXTRA LARGE con Contrassegno ....................................................................... 16
6.4. Esempio Payload EXTRA LARGE Assicurata SDA a valore ............................................................. 17
6.5. Esempio Payload EXTRA LARGE Assicurata SDA in Percentuale ................................................... 18
6.6. Esempio Payload EXTRA LARGE Smart Alert KSync ....................................................................... 20
6.7. Esempio Payload EXTRA LARGE Time Definite ............................................................................... 21
6.8. Esempio Payload EXTRA LARGE Consegna Al Piano ..................................................................... 23
6.9. Esempio Payload EXTRA LARGE Consegna Al Piano con Ascensore ............................................ 24
6.10. Esempio Payload EXTRA LARGE Consegna al Sabato.................................................................... 25
6.11. Esempio Payload EXTRA LARGE Consegna di Sera ....................................................................... 27
6.12. Esempio Payload EXTRA LARGE Consegna Programmata ............................................................. 29
6.13. Esempio Payload EXTRA LARGE Consegna Stabilita ...................................................................... 31
6.14. Esempio Payload EXTRA LARGE Consegna su Appuntamento ...................................................... 33
7. Emissione Lettera di vettura tracciato Response (Prodotto EXTRA LARGE)......................................... 34
7.1. Esempio Response Emissione Lettera di vettura (EXTRA LARGE) mono collo ............................... 36
7.2. Esempio Response Emissione Lettera di vettura (EXTRA LARGE) multi-collo................................. 38
7.3. Esempio Response Emissione Lettera di vettura (EXTRA LARGE) con errore BackEnd KSync ..... 40
7.4. Esempio Response Emissione Lettera di vettura (EXTRA LARGE) con errore WebService ............ 41
8. Tracking Lettera di vettura v2 .................................................................................................................. 42
8.1. Esempio Response Tracking Lettera di vettura v2 ............................................................................. 44
9. Prenotazione Ritiro Request (PF Porto Franco) ...................................................................................... 46
10. Prenotazione Ritiro tracciato Request (PF Porto Franco) .................................................................. 48
10.1. Esempio Payload Ritiro Tipo Busta .................................................................................................... 49
10.2. Esempio Payload Ritiro Tipo Pacchi .................................................................................................. 51
10.3. Esempio Payload Ritiro Tipo Pacchi Assicurato ................................................................................ 53
11. Prenotazione Ritiro tracciato Response ............................................................................................. 55
11.1. Esempio Response Prenotazione Ritiro terminato con successo ...................................................... 56
11.2. Esempio Response Prenotazione Ritiro con errore BackEnd KSync ................................................ 57
Guttadauro Srl | via F.lli Bandiera, 4 – 21012 - Cassano Magnago (VA)
C.F./Partita IVA/Iscriz. Reg. Imp. VA: n. 01757550122 - R.E.A. VA: n. 205035 - Capitale sociale € 78.000,00 I.V.
T. 0331 729511 - Help Desk 0331 729512 - info@guttadauro.it - web.guttadauro.it
3
11.3. Esempio Response Prenotazione Ritiro con errore WebService ....................................................... 58
12. Elenco Località Presenti in KSync ...................................................................................................... 59
12.1. Esempio Response elenco Località terminato con successo ............................................................ 60
13. Elenco Spedizioni Generate Presenti in KSync ................................................................................. 61
13.1. Esempio Response Elenco Spedizioni Generate terminato con successo........................................ 63
Guttadauro Srl | via F.lli Bandiera, 4 – 21012 - Cassano Magnago (VA)
C.F./Partita IVA/Iscriz. Reg. Imp. VA: n. 01757550122 - R.E.A. VA: n. 205035 - Capitale sociale € 78.000,00 I.V.
T. 0331 729511 - Help Desk 0331 729512 - info@guttadauro.it - web.guttadauro.it
4
1. Prefazione
I servizi web sono componenti software tramite i quali è possibile creare soluzioni di business integrate con
KSync.
Tali componenti possono essere richiamati in modo indipendente dalla piattaforma e dall’interfaccia cliente.
I servizi messi a disposizione da KSync possono essere, ad esempio, incapsulati in una generica
applicazione lato client, creando soluzioni semplici e accessibili direttamente attraverso l'interfaccia
dell'applicativo che le ospita.
Nell’ambito di KSync sono disponibili le seguenti API di integrazione:
Emissione Lettera di vettura
Nei paragrafi successivi sono illustrate le specifiche di invocazione dei servizi con relativi esempi.
2. Organizzazione del documento
Il presente documento è scritto per lo sviluppatore dell’applicazione che consuma i servizi web per
progettare e distribuire applicazioni abilitate da KSync.
Contiene le informazioni e gli strumenti necessari per seguire il processo di creazione di una propria
soluzione in tempi rapidi.
Sono inoltre indicati, dove necessario, i documenti tecnici o di offerta, contenenti i dettagli di specifica
necessari alla corretta compilazione delle request.
Guttadauro Srl | via F.lli Bandiera, 4 – 21012 - Cassano Magnago (VA)
C.F./Partita IVA/Iscriz. Reg. Imp. VA: n. 01757550122 - R.E.A. VA: n. 205035 - Capitale sociale € 78.000,00 I.V.
T. 0331 729511 - Help Desk 0331 729512 - info@guttadauro.it - web.guttadauro.it
5
3. Regole di Escaping XML
La comunicazione con le API del portale KSync funzionano tramite protocollo SOAP basato su linguaggio
XML.
Per poter comunicare correttamente con il portale è necessario generare in maniera corretta le richieste.
Sono accettati payload XML con encoding UTF-8.
Come prima cosa nella preparazione delle http request è necessario generare XML con intestazione
<?xml version="1.0" encoding="UTF-8"?>
Nel caso in cui i raw data (valori) contenuti nei tag es. Nome , Cognome , Indirizzo dovessero contenere
caratteri di controllo non ammessi in un file XML questi vanno rimpiazzati con i relativi tag.
' è rimpiazzato con &apos;
" è rimpiazzato con &quot;
& è rimpiazzato con &amp;
< è rimpiazzato con &lt;
> è rimpiazzato con &gt;
<?xml version="1.0" encoding="UTF-8"?>
<root>
<formatoStampa>A4</formatoStampa>
<destinatario>
<cap>74121</cap>
<codNazione>ITA</codNazione>
<email>pippo@baudo.it</email>
<indirizzo>Via Col Vento, 10/A</indirizzo>
<intestatario>&lt;&lt;&lt;&lt;Baudo&gt;&gt;&gt;&gt;&gt;&amp;Pippo&apos;&quot;&apos;&quot;&apos;&apos;&apos;</intestatario>
<localita>Taranto</localita>
<provincia>TA</provincia>
<referente/>
<telefono>0991234567</telefono>
<tipoAnagrafica>S</tipoAnagrafica>
</destinatario>
</root>
Guttadauro Srl | via F.lli Bandiera, 4 – 21012 - Cassano Magnago (VA)
C.F./Partita IVA/Iscriz. Reg. Imp. VA: n. 01757550122 - R.E.A. VA: n. 205035 - Capitale sociale € 78.000,00 I.V.
T. 0331 729511 - Help Desk 0331 729512 - info@guttadauro.it - web.guttadauro.it
6
Costruito il documento XML di richiesta questo deve essere linearizzato evitando la trasmissione di caratteri
TAB , SPACE o CRLF inutili, ed essere escapato prima di poter essere inviato al portale KSync.
Procedere quindi a linearizzare la stringa XML fino ad ottenere questo risultato
<?xml version="1.0" encoding="UTF-
8"?><root><formatoStampa>A4</formatoStampa><destinatario><cap>74121</cap><codNazione>ITA</cod
Nazione><email>pippo@baudo.it</email><indirizzo>Via Col Vento,
10/A</indirizzo><intestatario>&lt;&lt;&lt;&lt;Baudo&gt;&gt;&gt;&gt;&gt;&amp;Pippo&apos;&quot;&apos;&quot
;&apos;&apos;&apos;</intestatario><localita>Taranto</localita><provincia>TA</provincia><referente/><telef
ono>0991234567</telefono><tipoAnagrafica>S</tipoAnagrafica></destinatario></root>
Procedere quindi all’escaping della stringa XML fino ad ottenere questo risultato
&lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-
8&quot;?&gt;&lt;root&gt;&lt;formatoStampa&gt;A4&lt;/formatoStampa&gt;&lt;destinatario&gt;&lt;cap&gt;7412
1&lt;/cap&gt;&lt;codNazione&gt;ITA&lt;/codNazione&gt;&lt;email&gt;pippo@baudo.it&lt;/email&gt;&lt;indirizzo
&gt;Via Col Vento,
10/A&lt;/indirizzo&gt;&lt;intestatario&gt;&amp;lt;&amp;lt;&amp;lt;&amp;lt;Baudo&amp;gt;&amp;gt;&amp;gt;&a
mp;gt;&amp;gt;&amp;amp;Pippo&amp;apos;&amp;quot;&amp;apos;&amp;quot;&amp;apos;&amp;apos;&am
p;apos;&lt;/intestatario&gt;&lt;localita&gt;Taranto&lt;/localita&gt;&lt;provincia&gt;TA&lt;/provincia&gt;&lt;refere
nte/&gt;&lt;telefono&gt;0991234567&lt;/telefono&gt;&lt;tipoAnagrafica&gt;S&lt;/tipoAnagrafica&gt;&lt;/destina
tario&gt;&lt;/root&gt;
La stringa di request è ora pronta per essere trasmessa all’ API del portale KSYNC
Guttadauro Srl | via F.lli Bandiera, 4 – 21012 - Cassano Magnago (VA)
C.F./Partita IVA/Iscriz. Reg. Imp. VA: n. 01757550122 - R.E.A. VA: n. 205035 - Capitale sociale € 78.000,00 I.V.
T. 0331 729511 - Help Desk 0331 729512 - info@guttadauro.it - web.guttadauro.it
7
4. Sicurezza dei Servizi WEB
Prima dell’invocazione delle API è necessario conoscere le credenziali di KSync che verranno utilizzate per
effettuare la richiesta al portale web.
Ogni punto vendita appartenente alla catena KiPoint ha delle credenziali KSync con le quali può accedere
al portale per emettere lettere di vettura.
Le credenziali di accesso al portale possono essere utilizzate per effettuare chiamate al portale KSync ma
hanno lo svantaggio che posso essere resettate dall’utente oppure scadere come da policy dopo n mesi.
Per ovviare a questa problematica ogni punto vendita abilitato ad emettere lettere di vettura tramite web
service avrà associata una login di “servizio”.
Questa è a tutti gli effetti un utente con tutti i permessi per poter emettere lettere di vettura ma non può
accedere al portale web KSync.
Un tentativo di accesso al portale con le credenziali di “servizio” restituisce l’errore “IMPOSSIBILE
ACCEDERE CON QUESTA TIPOLOGIA DI UTENTE”.
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<gt_btc_ldv_soap_Run xmlns="http://gt_btc_ldv_soap.ws.localhost/">
<m_UserName>utente</m_UserName>
<m_Password>password</m_Password>
<m_Company>001</m_Company>
<XMLData>..........</XMLData>
</gt_btc_ldv_soap_Run>
</soap:Body>
</soap:Envelope>
Endpoint collaudo:
https://ksync.guttadauro.it/KIPOINT_20_DEBUG
Endpoint Produzione:
https://ksync.guttadauro.it/KIPOINT_20
Guttadauro Srl | via F.lli Bandiera, 4 – 21012 - Cassano Magnago (VA)
C.F./Partita IVA/Iscriz. Reg. Imp. VA: n. 01757550122 - R.E.A. VA: n. 205035 - Capitale sociale € 78.000,00 I.V.
T. 0331 729511 - Help Desk 0331 729512 - info@guttadauro.it - web.guttadauro.it
8
5. Emissione Lettera di vettura Request (Prodotto EXTRA LARGE)
Endpoint collaudo:
https://ksync.guttadauro.it/KIPOINT_20_DEBUG/servlet/gt_btc_ldv_soap
Endpoint Produzione:
https://ksync.guttadauro.it/KIPOINT_20/servlet/gt_btc_ldv_soap
Schema:
https (TLS 1.2)
Method:
POST
Authorization:
None
Header:
Content-Type: text/xml; charset=utf-8
Body:
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<gt_btc_ldv_soap_Run xmlns="http://gt_btc_ldv_soap.ws.localhost/">
<m_UserName>KI266_WS</m_UserName>
<m_Password>password</m_Password>
<m_Company>001</m_Company>
<XMLData>[XML PAYLOAD]</XMLData>
<UUID>[UUID IDENTIFICATIVO DELLA TRANSAZIONE]</UUID>
</gt_btc_ldv_soap_Run>
</soap:Body>
</soap:Envelope>
[XML PAYLOAD]:
Eseguire metodo di Escape sulla stringa xml prima di valorizzare il campo
' è rimpiazzato con &apos;
" è rimpiazzato con &quot;
& è rimpiazzato con &amp;
< è rimpiazzato con &lt;
> è rimpiazzato con &gt;
Guttadauro Srl | via F.lli Bandiera, 4 – 21012 - Cassano Magnago (VA)
C.F./Partita IVA/Iscriz. Reg. Imp. VA: n. 01757550122 - R.E.A. VA: n. 205035 - Capitale sociale € 78.000,00 I.V.
T. 0331 729511 - Help Desk 0331 729512 - info@guttadauro.it - web.guttadauro.it
9
[UUID IDENTIFICATIVO DELLA TRANSAZIONE]
La PRIMA volta che viene effettuata la richiesta di generazione della Ldv lasciare vuoto “” in
quanto non ancora disponibile al client chiamante.
Nel caso in cui la richiesta è stata presa in carico correttamente dal BackEnd KSync il verrà
restituito nella Response della chiamata WS (vedere paragrafo Emissione Lettera di vettura
tracciato Response (Prodotto EXTRA LARGE)).
Memorizzare questo valore lato client associato alla richiesta di generazione.
Nel caso in cui la Ldv non sia stata generata per qualche errore SW (es. down temporaneo dei
sevizi WS di SDA), nel successivo tentativo di generazione passare il valore UUID
precedentemente restituito. Questo alleggerisce il carico di lavoro del server KSync dalla
seconda richiesta in poi e velocizza l’operazione di generazione della Ldv.
Guttadauro Srl | via F.lli Bandiera, 4 – 21012 - Cassano Magnago (VA)
C.F./Partita IVA/Iscriz. Reg. Imp. VA: n. 01757550122 - R.E.A. VA: n. 205035 - Capitale sociale € 78.000,00 I.V.
T. 0331 729511 - Help Desk 0331 729512 - info@guttadauro.it - web.guttadauro.it
10
6. Emissione Lettera di vettura Tracciato Request (Prodotto
EXTRA LARGE)
Tipo Descrizione
formatoStampa A4 C *3 Valori Ammessi
A4,A3,ZPL
ldv datiSpedizione accessori
smartalert smartalertksync S C*1
Valori Ammessi
S = Smart Alert KSync attivo
N = Smart Alert KSync disattivo
consegnaStabilita
dataConsegna 10/05/2024 D*gg/MM/yyyy
fasciaOraria AM C*2
Valori Ammessi
AM = mattina
PM = pomeriggio
consegnaProgrammata
finestraAM A C*1
Valori Ammessi
A = 9:00-11:00
B = 10:00-12:00
C= 11:00-13:00
giorniAM 1,2
Lista Valori
separata da
virgola ,
esempio 1,2,3
Valori Ammessi
1 = Lunedì
2 = Martedì
3 = Mercoledì
4 = Giovedì
5 = Venerdì
finestraPM E C*1
Valori Ammessi
D = 14:00-16:00
E = 15:00-17:00
F= 16:00-18:00
giorniPM 3,4,5
Lista Valori
separata da
virgola ,
esempio 4,5
Valori Ammessi
1 = Lunedì
2 = Martedì
3 = Mercoledì
4 = Giovedì
5 = Venerdì
sera S C*1 Valori Ammessi
S = Consegna di sera
sabato S C*1 Valori Ammessi
S = Consegna al Sabato
Guttadauro Srl | via F.lli Bandiera, 4 – 21012 - Cassano Magnago (VA)
C.F./Partita IVA/Iscriz. Reg. Imp. VA: n. 01757550122 - R.E.A. VA: n. 205035 - Capitale sociale € 78.000,00 I.V.
T. 0331 729511 - Help Desk 0331 729512 - info@guttadauro.it - web.guttadauro.it
11
alPiano conAscensore S C*1
Valori Ammessi
S = Con Ascensore
N = Senza Ascensore
timeDefinite timeDefCodice T09 C*3
Valori Ammessi
T09 = ore 9:00
T10 = ore 10:00
T12 = ore 12:00
assicurata assicurataCodice AS01 C*4
Valori Ammessi
AS01 = FINO A EURO 258,23
AS02 = FINO A EURO 516,46
AS03 = FINO A EURO 1.549,37
AS04=FINO A EURO 2.582,28
assicurataPercentuale assicurataValore 555.78 N*10,2 Importo Assicurata
contrassegno
codTipoPagamento VAR C*3
Valori Ammessi
CON=Contanti
ABM=Ass.Banc.Mittente
ABS=Ass.Banc.SDA
ACM=Ass.Circ.Mittente
ACS=Ass.Circ.SDA
VAR=Tutti
contrassegnoValore 1000.0 N*10,2 Valore Contrassegno
codiceServizio S09 C*3 S09 (EXTRA LARGE)
datiGenerali
contenuto CONTENUTO C*50
dataSpedizione 18/02/2022 D*gg/MM/yyyy Data Spedizione
note NOTE DI TEST C*255
numRifInterno ORDINE NUMERO 0 C*50
sezioneColli colli element
altezza 1.0 N*10,2 Altezza
larghezza 1.0 N*10,2 Larghezza
peso 1.0 N*10,2 Peso
profondita 1.0 N*10,2 Profondità
destinatario
cap 21100 C*5 CAP
codNazione ITA C*3 ITA
email mario.rossi@email.com C*50 Email
indirizzo VIA DEI CICLAMINI C*50 Indirizzo
intestatario MARIO ROSSI C*50 Destinatario
localita MILANO C*50 Località
provincia MI C*5 Provincia
referente MARIO ROSSI C*50 Riferimento
telefono 2000000 C*50 Telefono
tipoAnagrafica S C*1 S
mittente
cap 21012 C*5 CAP
codNazione ITA C*3 ITA
email USER@GUTTADAURO.IT C*50 Email
indirizzo VIA F.LLI BANDIERA 4 C*50 Indirizzo
intestatario GUTTADAURO COMPUTERS SRL C*50 Mittente
localita CASSANO MAGNAGO C*50 Località
provincia VA C*5 Provincia
referente C*50 Riferimento
Guttadauro Srl | via F.lli Bandiera, 4 – 21012 - Cassano Magnago (VA)
C.F./Partita IVA/Iscriz. Reg. Imp. VA: n. 01757550122 - R.E.A. VA: n. 205035 - Capitale sociale € 78.000,00 I.V.
T. 0331 729511 - Help Desk 0331 729512 - info@guttadauro.it - web.guttadauro.it
12
telefono 0331729511 C*50 Telefono
tipoAnagrafica S C*1 S
Guttadauro Srl | via F.lli Bandiera, 4 – 21012 - Cassano Magnago (VA)
C.F./Partita IVA/Iscriz. Reg. Imp. VA: n. 01757550122 - R.E.A. VA: n. 205035 - Capitale sociale € 78.000,00 I.V.
T. 0331 729511 - Help Desk 0331 729512 - info@guttadauro.it - web.guttadauro.it
13
6.1. Esempio Payload EXTRA LARGE base mono collo
<?xml version="1.0" encoding="UTF-8"?>
<root>
<formatoStampa>A4 </formatoStampa>
<ldv>
<datiSpedizione>
<accessori/>
<codiceServizio>S09</codiceServizio>
<datiGenerali>
<contenuto>CONTENUTO</contenuto>
<dataSpedizione>18/02/2022</dataSpedizione>
<note>NOTE DI TEST</note>
<numRifInterno>ORDINE NUMERO 0</numRifInterno>
</datiGenerali>
<sezioneColli>
<colli>
<element>
<altezza>1.0</altezza>
<larghezza>1.0</larghezza>
<peso>1.0</peso>
<profondita>1.0</profondita>
</element>
</colli>
</sezioneColli>
</datiSpedizione>
<destinatario>
<cap>21100</cap>
<codNazione>ITA</codNazione>
<email>mario.rossi@email.com</email>
<indirizzo>VIA DEI CICLAMINI</indirizzo>
<intestatario>MARIO ROSSI</intestatario>
<localita>MILANO</localita>
<provincia>MI</provincia>
<referente>MARIO ROSSI</referente>
<telefono>02000000</telefono>
<tipoAnagrafica>S</tipoAnagrafica>
</destinatario>
<mittente>
<cap>21012</cap>
<codNazione>ITA</codNazione>
<email>USER@GUTTADAURO.IT</email>
<indirizzo>VIA F.LLI BANDIERA 4</indirizzo>
<intestatario>GUTTADAURO COMPUTERS SRL</intestatario>
<localita>CASSANO MAGNAGO</localita>
<provincia>VA</provincia>
<referente/>
<telefono>0331729511</telefono>
<tipoAnagrafica>S</tipoAnagrafica>
</mittente>
</ldv>
</root>
Guttadauro Srl | via F.lli Bandiera, 4 – 21012 - Cassano Magnago (VA)
C.F./Partita IVA/Iscriz. Reg. Imp. VA: n. 01757550122 - R.E.A. VA: n. 205035 - Capitale sociale € 78.000,00 I.V.
T. 0331 729511 - Help Desk 0331 729512 - info@guttadauro.it - web.guttadauro.it
14
Sequenza Escape:
&lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot;?&gt;&lt;root&gt;&lt;formatoStampa&gt;A4
&lt;/formatoStampa&gt;&lt;ldv&gt;&lt;datiSpedizione&gt;&lt;accessori/&gt;&lt;codiceServizio&gt;S09&lt;/codiceServizio&gt
;&lt;datiGenerali&gt;&lt;contenuto&gt;CONTENUTO&lt;/contenuto&gt;&lt;dataSpedizione&gt;18/02/2022&lt;/dataSpedizio
ne&gt;&lt;note&gt;NOTE DI TEST&lt;/note&gt;&lt;numRifInterno&gt;ORDINE NUMERO
0&lt;/numRifInterno&gt;&lt;/datiGenerali&gt;&lt;sezioneColli&gt;&lt;colli&gt;&lt;element&gt;&lt;altezza&gt;1.0&lt;/altezza&g
t;&lt;larghezza&gt;1.0&lt;/larghezza&gt;&lt;peso&gt;1.0&lt;/peso&gt;&lt;profondita&gt;1.0&lt;/profondita&gt;&lt;/element&g
t;&lt;/colli&gt;&lt;/sezioneColli&gt;&lt;/datiSpedizione&gt;&lt;destinatario&gt;&lt;cap&gt;21100&lt;/cap&gt;&lt;codNazione&
gt;ITA&lt;/codNazione&gt;&lt;email&gt;mario.rossi@email.com&lt;/email&gt;&lt;identificativoFiscale/&gt;&lt;indirizzo&gt;VI
A DEI CICLAMINI&lt;/indirizzo&gt;&lt;intestatario&gt;MARIO
ROSSI&lt;/intestatario&gt;&lt;localita&gt;MILANO&lt;/localita&gt;&lt;provincia&gt;MI&lt;/provincia&gt;&lt;referente&gt;MA
RIO
ROSSI&lt;/referente&gt;&lt;telefono&gt;02000000&lt;/telefono&gt;&lt;tipoAnagrafica&gt;S&lt;/tipoAnagrafica&gt;&lt;/destin
atario&gt;&lt;mittente&gt;&lt;cap&gt;21012&lt;/cap&gt;&lt;codNazione&gt;ITA&lt;/codNazione&gt;&lt;email&gt;USER@GU
TTADAURO.IT&lt;/email&gt;&lt;identificativoFiscale/&gt;&lt;indirizzo&gt;VIA F.LLI BANDIERA
4&lt;/indirizzo&gt;&lt;intestatario&gt;GUTTADAURO COMPUTERS SRL&lt;/intestatario&gt;&lt;localita&gt;CASSANO
MAGNAGO&lt;/localita&gt;&lt;provincia&gt;VA&lt;/provincia&gt;&lt;referente/&gt;&lt;telefono&gt;0331729511&lt;/telefono
&gt;&lt;tipoAnagrafica&gt;S&lt;/tipoAnagrafica&gt;&lt;/mittente&gt;&lt;/ldv&gt;&lt;/root&gt;
Guttadauro Srl | via F.lli Bandiera, 4 – 21012 - Cassano Magnago (VA)
C.F./Partita IVA/Iscriz. Reg. Imp. VA: n. 01757550122 - R.E.A. VA: n. 205035 - Capitale sociale € 78.000,00 I.V.
T. 0331 729511 - Help Desk 0331 729512 - info@guttadauro.it - web.guttadauro.it
15
6.2. Esempio Payload EXTRA LARGE multi-collo
<?xml version="1.0" encoding="UTF-8"?>
<root>
<formatoStampa>A4 </formatoStampa>
<ldv>
<datiSpedizione>
<accessori/>
<codiceServizio>S09</codiceServizio>
<datiGenerali>
<contenuto>CONTENUTO</contenuto>
<dataSpedizione>18/02/2022</dataSpedizione>
<note>NOTE DI TEST</note>
<numRifInterno>ORDINE NUMERO 0</numRifInterno>
</datiGenerali>
<sezioneColli>
<colli>
<element>
<altezza>1.0</altezza>
<larghezza>1.0</larghezza>
<peso>1.0</peso>
<profondita>1.0</profondita>
</element>
<element>
<altezza>2.0</altezza>
<larghezza>2.0</larghezza>
<peso>2.0</peso>
<profondita>2.0</profondita>
</element>
</colli>
</sezioneColli>
</datiSpedizione>
<destinatario>
<cap>21100</cap>
<codNazione>ITA</codNazione>
<email>mario.rossi@email.com</email>
<indirizzo>VIA DEI CICLAMINI</indirizzo>
<intestatario>MARIO ROSSI</intestatario>
<localita>MILANO</localita>
<provincia>MI</provincia>
<referente>MARIO ROSSI</referente>
<telefono>02000000</telefono>
<tipoAnagrafica>S</tipoAnagrafica>
</destinatario>
<mittente>
<cap>21012</cap>
<codNazione>ITA</codNazione>
<email>USER@GUTTADAURO.IT</email>
<indirizzo>VIA F.LLI BANDIERA 4</indirizzo>
<intestatario>GUTTADAURO COMPUTERS SRL</intestatario>
<localita>CASSANO MAGNAGO</localita>
<provincia>VA</provincia>
<referente/>
<telefono>0331729511</telefono>
<tipoAnagrafica>S</tipoAnagrafica>
</mittente>
</ldv>
</root>
Guttadauro Srl | via F.lli Bandiera, 4 – 21012 - Cassano Magnago (VA)
C.F./Partita IVA/Iscriz. Reg. Imp. VA: n. 01757550122 - R.E.A. VA: n. 205035 - Capitale sociale € 78.000,00 I.V.
T. 0331 729511 - Help Desk 0331 729512 - info@guttadauro.it - web.guttadauro.it
16
6.3. Esempio Payload EXTRA LARGE con Contrassegno
<?xml version="1.0" encoding="UTF-8"?>
<root>
<formatoStampa>A4 </formatoStampa>
<ldv>
<datiSpedizione>
<accessori>
<contrassegno>
<codTipoPagamento>VAR</codTipoPagamento>
<contrassegnoValore>1000.0</contrassegnoValore>
</contrassegno>
</accessori>
<codiceServizio>S09</codiceServizio>
<datiGenerali>
<contenuto>CONTENUTO</contenuto>
<dataSpedizione>18/02/2022</dataSpedizione>
<note>NOTE DI TEST</note>
<numRifInterno>ORDINE NUMERO 0</numRifInterno>
</datiGenerali>
<sezioneColli>
<colli>
<element>
<altezza>1.0</altezza>
<larghezza>1.0</larghezza>
<peso>1.0</peso>
<profondita>1.0</profondita>
</element>
</colli>
</sezioneColli>
</datiSpedizione>
<destinatario>
<cap>21100</cap>
<codNazione>ITA</codNazione>
<email>mario.rossi@email.com</email>
<indirizzo>VIA DEI CICLAMINI</indirizzo>
<intestatario>MARIO ROSSI</intestatario>
<localita>MILANO</localita>
<provincia>MI</provincia>
<referente>MARIO ROSSI</referente>
<telefono>02000000</telefono>
<tipoAnagrafica>S</tipoAnagrafica>
</destinatario>
<mittente>
<cap>21012</cap>
<codNazione>ITA</codNazione>
<email>USER@GUTTADAURO.IT</email>
<indirizzo>VIA F.LLI BANDIERA 4</indirizzo>
<intestatario>GUTTADAURO COMPUTERS SRL</intestatario>
<localita>CASSANO MAGNAGO</localita>
<provincia>VA</provincia>
<referente/>
<telefono>0331729511</telefono>
<tipoAnagrafica>S</tipoAnagrafica>
</mittente>
</ldv>
</root>
Guttadauro Srl | via F.lli Bandiera, 4 – 21012 - Cassano Magnago (VA)
C.F./Partita IVA/Iscriz. Reg. Imp. VA: n. 01757550122 - R.E.A. VA: n. 205035 - Capitale sociale € 78.000,00 I.V.
T. 0331 729511 - Help Desk 0331 729512 - info@guttadauro.it - web.guttadauro.it
17
6.4. Esempio Payload EXTRA LARGE Assicurata SDA a valore
<?xml version="1.0" encoding="UTF-8"?>
<root>
<formatoStampa>A4 </formatoStampa>
<ldv>
<datiSpedizione>
<accessori>
<assicurata>
<assicurataCodice>AS04</assicurataCodice>
</assicurata>
</accessori>
<codiceServizio>S09</codiceServizio>
<datiGenerali>
<contenuto>CONTENUTO</contenuto>
<dataSpedizione>18/02/2022</dataSpedizione>
<note>NOTE DI TEST</note>
<numRifInterno>ORDINE NUMERO 0</numRifInterno>
</datiGenerali>
<sezioneColli>
<colli>
<element>
<altezza>1.0</altezza>
<larghezza>1.0</larghezza>
<peso>1.0</peso>
<profondita>1.0</profondita>
</element>
</colli>
</sezioneColli>
</datiSpedizione>
<destinatario>
<cap>21100</cap>
<codNazione>ITA</codNazione>
<email>mario.rossi@email.com</email>
<indirizzo>VIA DEI CICLAMINI</indirizzo>
<intestatario>MARIO ROSSI</intestatario>
<localita>MILANO</localita>
<provincia>MI</provincia>
<referente>MARIO ROSSI</referente>
<telefono>02000000</telefono>
<tipoAnagrafica>S</tipoAnagrafica>
</destinatario>
<mittente>
<cap>21012</cap>
<codNazione>ITA</codNazione>
<email>USER@GUTTADAURO.IT</email>
<indirizzo>VIA F.LLI BANDIERA 4</indirizzo>
<intestatario>GUTTADAURO COMPUTERS SRL</intestatario>
<localita>CASSANO MAGNAGO</localita>
<provincia>VA</provincia>
<referente/>
<telefono>0331729511</telefono>
<tipoAnagrafica>S</tipoAnagrafica>
</mittente>
</ldv>
</root>
Guttadauro Srl | via F.lli Bandiera, 4 – 21012 - Cassano Magnago (VA)
C.F./Partita IVA/Iscriz. Reg. Imp. VA: n. 01757550122 - R.E.A. VA: n. 205035 - Capitale sociale € 78.000,00 I.V.
T. 0331 729511 - Help Desk 0331 729512 - info@guttadauro.it - web.guttadauro.it
18
6.5. Esempio Payload EXTRA LARGE Assicurata SDA in Percentuale
<?xml version="1.0" encoding="UTF-8"?>
<root>
<formatoStampa>A4 </formatoStampa>
<ldv>
<datiSpedizione>
<accessori>
<assicurataPercentuale>
<assicurataValore>555.78</assicurataValore>
</assicurataPercentuale>
</accessori>
<codiceServizio>S09</codiceServizio>
<datiGenerali>
<contenuto>CONTENUTO</contenuto>
<dataSpedizione>18/02/2022</dataSpedizione>
<note>NOTE DI TEST</note>
<numRifInterno>ORDINE NUMERO 0</numRifInterno>
</datiGenerali>
<sezioneColli>
<colli>
<element>
<altezza>1.0</altezza>
<larghezza>1.0</larghezza>
<peso>1.0</peso>
<profondita>1.0</profondita>
</element>
</colli>
</sezioneColli>
</datiSpedizione>
<destinatario>
<cap>21100</cap>
<codNazione>ITA</codNazione>
<email>mario.rossi@email.com</email>
<indirizzo>VIA DEI CICLAMINI</indirizzo>
<intestatario>MARIO ROSSI</intestatario>
<localita>MILANO</localita>
<provincia>MI</provincia>
<referente>MARIO ROSSI</referente>
<telefono>02000000</telefono>
<tipoAnagrafica>S</tipoAnagrafica>
</destinatario>
<mittente>
<cap>21012</cap>
<codNazione>ITA</codNazione>
<email>USER@GUTTADAURO.IT</email>
<indirizzo>VIA F.LLI BANDIERA 4</indirizzo>
<intestatario>GUTTADAURO COMPUTERS SRL</intestatario>
<localita>CASSANO MAGNAGO</localita>
<provincia>VA</provincia>
<referente/>
<telefono>0331729511</telefono>
<tipoAnagrafica>S</tipoAnagrafica>
</mittente>
</ldv>
</root>
Guttadauro Srl | via F.lli Bandiera, 4 – 21012 - Cassano Magnago (VA)
C.F./Partita IVA/Iscriz. Reg. Imp. VA: n. 01757550122 - R.E.A. VA: n. 205035 - Capitale sociale € 78.000,00 I.V.
T. 0331 729511 - Help Desk 0331 729512 - info@guttadauro.it - web.guttadauro.it
19
Guttadauro Srl | via F.lli Bandiera, 4 – 21012 - Cassano Magnago (VA)
C.F./Partita IVA/Iscriz. Reg. Imp. VA: n. 01757550122 - R.E.A. VA: n. 205035 - Capitale sociale € 78.000,00 I.V.
T. 0331 729511 - Help Desk 0331 729512 - info@guttadauro.it - web.guttadauro.it
20
6.6. Esempio Payload EXTRA LARGE Smart Alert KSync
<?xml version="1.0" encoding="UTF-8"?>
<root>
<formatoStampa>A4 </formatoStampa>
<ldv>
<datiSpedizione>
<accessori>
<smartalert>
<smartalertksync>S</smartalertksync>
</smartalert>
</accessori>
<codiceServizio>S09</codiceServizio>
<datiGenerali>
<contenuto>CONTENUTO</contenuto>
<dataSpedizione>18/02/2022</dataSpedizione>
<note>NOTE DI TEST</note>
<numRifInterno>ORDINE NUMERO 0</numRifInterno>
</datiGenerali>
<sezioneColli>
<colli>
<element>
<altezza>1.0</altezza>
<larghezza>1.0</larghezza>
<peso>1.0</peso>
<profondita>1.0</profondita>
</element>
</colli>
</sezioneColli>
</datiSpedizione>
<destinatario>
<cap>21100</cap>
<codNazione>ITA</codNazione>
<email>mario.rossi@email.com</email>
<indirizzo>VIA DEI CICLAMINI</indirizzo>
<intestatario>MARIO ROSSI</intestatario>
<localita>MILANO</localita>
<provincia>MI</provincia>
<referente>MARIO ROSSI</referente>
<telefono>02000000</telefono>
<tipoAnagrafica>S</tipoAnagrafica>
</destinatario>
<mittente>
<cap>21012</cap>
<codNazione>ITA</codNazione>
<email>USER@GUTTADAURO.IT</email>
<indirizzo>VIA F.LLI BANDIERA 4</indirizzo>
<intestatario>GUTTADAURO COMPUTERS SRL</intestatario>
<localita>CASSANO MAGNAGO</localita>
<provincia>VA</provincia>
<referente/>
<telefono>0331729511</telefono>
<tipoAnagrafica>S</tipoAnagrafica>
</mittente>
</ldv>
</root>
Guttadauro Srl | via F.lli Bandiera, 4 – 21012 - Cassano Magnago (VA)
C.F./Partita IVA/Iscriz. Reg. Imp. VA: n. 01757550122 - R.E.A. VA: n. 205035 - Capitale sociale € 78.000,00 I.V.
T. 0331 729511 - Help Desk 0331 729512 - info@guttadauro.it - web.guttadauro.it
21
6.7. Esempio Payload EXTRA LARGE Time Definite
Accessorio compilabile se non attivo Esempio Payload EXTRA LARGE Consegna Stabilita
Accessorio compilabile se non attivo Esempio Payload EXTRA LARGE Consegna Programmata
Accessorio compilabile se non attivo Esempio Payload EXTRA LARGE Consegna al Sabato
Accessorio compilabile se non attivo Esempio Payload EXTRA LARGE Consegna di Sera
Accessorio compilabile se non attivo Esempio Payload EXTRA LARGE Consegna su Appuntamento
<?xml version="1.0" encoding="UTF-8"?>
<root>
<formatoStampa>A4 </formatoStampa>
<ldv>
<datiSpedizione>
<accessori>
<timeDefinite>
<timeDefCodice>T09</timeDefCodice>
</timeDefinite>
</accessori>
<codiceServizio>S09</codiceServizio>
<datiGenerali>
<contenuto>CONTENUTO</contenuto>
<dataSpedizione>18/02/2022</dataSpedizione>
<note>NOTE DI TEST</note>
<numRifInterno>ORDINE NUMERO 0</numRifInterno>
</datiGenerali>
<sezioneColli>
<colli>
<element>
<altezza>1.0</altezza>
<larghezza>1.0</larghezza>
<peso>1.0</peso>
<profondita>1.0</profondita>
</element>
</colli>
</sezioneColli>
</datiSpedizione>
<destinatario>
<cap>21100</cap>
<codNazione>ITA</codNazione>
<email>mario.rossi@email.com</email>
<indirizzo>VIA DEI CICLAMINI</indirizzo>
<intestatario>MARIO ROSSI</intestatario>
<localita>MILANO</localita>
<provincia>MI</provincia>
<referente>MARIO ROSSI</referente>
<telefono>02000000</telefono>
<tipoAnagrafica>S</tipoAnagrafica>
</destinatario>
<mittente>
<cap>21012</cap>
<codNazione>ITA</codNazione>
<email>USER@GUTTADAURO.IT</email>
<indirizzo>VIA F.LLI BANDIERA 4</indirizzo>
<intestatario>GUTTADAURO COMPUTERS SRL</intestatario>
<localita>CASSANO MAGNAGO</localita>
<provincia>VA</provincia>
<referente/>
<telefono>0331729511</telefono>
Guttadauro Srl | via F.lli Bandiera, 4 – 21012 - Cassano Magnago (VA)
C.F./Partita IVA/Iscriz. Reg. Imp. VA: n. 01757550122 - R.E.A. VA: n. 205035 - Capitale sociale € 78.000,00 I.V.
T. 0331 729511 - Help Desk 0331 729512 - info@guttadauro.it - web.guttadauro.it
22
<tipoAnagrafica>S</tipoAnagrafica>
</mittente>
</ldv>
</root>
Guttadauro Srl | via F.lli Bandiera, 4 – 21012 - Cassano Magnago (VA)
C.F./Partita IVA/Iscriz. Reg. Imp. VA: n. 01757550122 - R.E.A. VA: n. 205035 - Capitale sociale € 78.000,00 I.V.
T. 0331 729511 - Help Desk 0331 729512 - info@guttadauro.it - web.guttadauro.it
23
6.8. Esempio Payload EXTRA LARGE Consegna Al Piano
<?xml version="1.0" encoding="UTF-8"?>
<root>
<formatoStampa>A4 </formatoStampa>
<ldv>
<datiSpedizione>
<accessori>
<alPiano/>
</accessori>
<codiceServizio>S09</codiceServizio>
<datiGenerali>
<contenuto>CONTENUTO</contenuto>
<dataSpedizione>18/02/2022</dataSpedizione>
<note>NOTE DI TEST</note>
<numRifInterno>ORDINE NUMERO 0</numRifInterno>
</datiGenerali>
<sezioneColli>
<colli>
<element>
<altezza>1.0</altezza>
<larghezza>1.0</larghezza>
<peso>1.0</peso>
<profondita>1.0</profondita>
</element>
</colli>
</sezioneColli>
</datiSpedizione>
<destinatario>
<cap>21100</cap>
<codNazione>ITA</codNazione>
<email>mario.rossi@email.com</email>
<indirizzo>VIA DEI CICLAMINI</indirizzo>
<intestatario>MARIO ROSSI</intestatario>
<localita>MILANO</localita>
<provincia>MI</provincia>
<referente>MARIO ROSSI</referente>
<telefono>02000000</telefono>
<tipoAnagrafica>S</tipoAnagrafica>
</destinatario>
<mittente>
<cap>21012</cap>
<codNazione>ITA</codNazione>
<email>USER@GUTTADAURO.IT</email>
<indirizzo>VIA F.LLI BANDIERA 4</indirizzo>
<intestatario>GUTTADAURO COMPUTERS SRL</intestatario>
<localita>CASSANO MAGNAGO</localita>
<provincia>VA</provincia>
<referente/>
<telefono>0331729511</telefono>
<tipoAnagrafica>S</tipoAnagrafica>
</mittente>
</ldv>
</root>
Guttadauro Srl | via F.lli Bandiera, 4 – 21012 - Cassano Magnago (VA)
C.F./Partita IVA/Iscriz. Reg. Imp. VA: n. 01757550122 - R.E.A. VA: n. 205035 - Capitale sociale € 78.000,00 I.V.
T. 0331 729511 - Help Desk 0331 729512 - info@guttadauro.it - web.guttadauro.it
24
6.9. Esempio Payload EXTRA LARGE Consegna Al Piano con Ascensore
<?xml version="1.0" encoding="UTF-8"?>
<root>
<formatoStampa>A4 </formatoStampa>
<ldv>
<datiSpedizione>
<accessori>
<alPiano>
<conAscensore>S</conAscensore>
</alPiano>
</accessori>
<codiceServizio>S09</codiceServizio>
<datiGenerali>
<contenuto>CONTENUTO</contenuto>
<dataSpedizione>18/02/2022</dataSpedizione>
<note>NOTE DI TEST</note>
<numRifInterno>ORDINE NUMERO 0</numRifInterno>
</datiGenerali>
<sezioneColli>
<colli>
<element>
<altezza>1.0</altezza>
<larghezza>1.0</larghezza>
<peso>1.0</peso>
<profondita>1.0</profondita>
</element>
</colli>
</sezioneColli>
</datiSpedizione>
<destinatario>
<cap>21100</cap>
<codNazione>ITA</codNazione>
<email>mario.rossi@email.com</email>
<indirizzo>VIA DEI CICLAMINI</indirizzo>
<intestatario>MARIO ROSSI</intestatario>
<localita>MILANO</localita>
<provincia>MI</provincia>
<referente>MARIO ROSSI</referente>
<telefono>02000000</telefono>
<tipoAnagrafica>S</tipoAnagrafica>
</destinatario>
<mittente>
<cap>21012</cap>
<codNazione>ITA</codNazione>
<email>USER@GUTTADAURO.IT</email>
<indirizzo>VIA F.LLI BANDIERA 4</indirizzo>
<intestatario>GUTTADAURO COMPUTERS SRL</intestatario>
<localita>CASSANO MAGNAGO</localita>
<provincia>VA</provincia>
<referente/>
<telefono>0331729511</telefono>
<tipoAnagrafica>S</tipoAnagrafica>
</mittente>
</ldv>
</root>
Guttadauro Srl | via F.lli Bandiera, 4 – 21012 - Cassano Magnago (VA)
C.F./Partita IVA/Iscriz. Reg. Imp. VA: n. 01757550122 - R.E.A. VA: n. 205035 - Capitale sociale € 78.000,00 I.V.
T. 0331 729511 - Help Desk 0331 729512 - info@guttadauro.it - web.guttadauro.it
25
6.10. Esempio Payload EXTRA LARGE Consegna al Sabato
Accessorio compilabile se non attivo Esempio Payload EXTRA LARGE Consegna Stabilita
Accessorio compilabile se non attivo Esempio Payload EXTRA LARGE Consegna Programmata
Accessorio compilabile se non attivo Esempio Payload EXTRA LARGE Consegna di Sera
Accessorio compilabile se non attivo Esempio Payload EXTRA LARGE Time Definite
<?xml version="1.0" encoding="UTF-8"?>
<root>
<formatoStampa>A4 </formatoStampa>
<ldv>
<datiSpedizione>
<accessori>
<sabato>S</sabato>
</accessori>
<codiceServizio>S09</codiceServizio>
<datiGenerali>
<contenuto>CONTENUTO</contenuto>
<dataSpedizione>18/02/2022</dataSpedizione>
<note>NOTE DI TEST</note>
<numRifInterno>ORDINE NUMERO 0</numRifInterno>
</datiGenerali>
<sezioneColli>
<colli>
<element>
<altezza>1.0</altezza>
<larghezza>1.0</larghezza>
<peso>1.0</peso>
<profondita>1.0</profondita>
</element>
</colli>
</sezioneColli>
</datiSpedizione>
<destinatario>
<cap>21100</cap>
<codNazione>ITA</codNazione>
<email>mario.rossi@email.com</email>
<indirizzo>VIA DEI CICLAMINI</indirizzo>
<intestatario>MARIO ROSSI</intestatario>
<localita>MILANO</localita>
<provincia>MI</provincia>
<referente>MARIO ROSSI</referente>
<telefono>02000000</telefono>
<tipoAnagrafica>S</tipoAnagrafica>
</destinatario>
<mittente>
<cap>21012</cap>
<codNazione>ITA</codNazione>
<email>USER@GUTTADAURO.IT</email>
<indirizzo>VIA F.LLI BANDIERA 4</indirizzo>
<intestatario>GUTTADAURO COMPUTERS SRL</intestatario>
<localita>CASSANO MAGNAGO</localita>
<provincia>VA</provincia>
<referente/>
<telefono>0331729511</telefono>
<tipoAnagrafica>S</tipoAnagrafica>
</mittente>
</ldv>
</root>
Guttadauro Srl | via F.lli Bandiera, 4 – 21012 - Cassano Magnago (VA)
C.F./Partita IVA/Iscriz. Reg. Imp. VA: n. 01757550122 - R.E.A. VA: n. 205035 - Capitale sociale € 78.000,00 I.V.
T. 0331 729511 - Help Desk 0331 729512 - info@guttadauro.it - web.guttadauro.it
26
Guttadauro Srl | via F.lli Bandiera, 4 – 21012 - Cassano Magnago (VA)
C.F./Partita IVA/Iscriz. Reg. Imp. VA: n. 01757550122 - R.E.A. VA: n. 205035 - Capitale sociale € 78.000,00 I.V.
T. 0331 729511 - Help Desk 0331 729512 - info@guttadauro.it - web.guttadauro.it
27
6.11. Esempio Payload EXTRA LARGE Consegna di Sera
Accessorio compilabile se non attivo Esempio Payload EXTRA LARGE Consegna Stabilita
Accessorio compilabile se non attivo Esempio Payload EXTRA LARGE Consegna Programmata
Accessorio compilabile se non attivo Esempio Payload EXTRA LARGE Consegna al Sabato
Accessorio compilabile se non attivo Esempio Payload EXTRA LARGE Time Definite
<?xml version="1.0" encoding="UTF-8"?>
<root>
<formatoStampa>A4 </formatoStampa>
<ldv>
<datiSpedizione>
<accessori>
<sera>S</sera>
</accessori>
<codiceServizio>S09</codiceServizio>
<datiGenerali>
<contenuto>CONTENUTO</contenuto>
<dataSpedizione>18/02/2022</dataSpedizione>
<note>NOTE DI TEST</note>
<numRifInterno>ORDINE NUMERO 0</numRifInterno>
</datiGenerali>
<sezioneColli>
<colli>
<element>
<altezza>1.0</altezza>
<larghezza>1.0</larghezza>
<peso>1.0</peso>
<profondita>1.0</profondita>
</element>
</colli>
</sezioneColli>
</datiSpedizione>
<destinatario>
<cap>21100</cap>
<codNazione>ITA</codNazione>
<email>mario.rossi@email.com</email>
<indirizzo>VIA DEI CICLAMINI</indirizzo>
<intestatario>MARIO ROSSI</intestatario>
<localita>MILANO</localita>
<provincia>MI</provincia>
<referente>MARIO ROSSI</referente>
<telefono>02000000</telefono>
<tipoAnagrafica>S</tipoAnagrafica>
</destinatario>
<mittente>
<cap>21012</cap>
<codNazione>ITA</codNazione>
<email>USER@GUTTADAURO.IT</email>
<indirizzo>VIA F.LLI BANDIERA 4</indirizzo>
<intestatario>GUTTADAURO COMPUTERS SRL</intestatario>
<localita>CASSANO MAGNAGO</localita>
<provincia>VA</provincia>
<referente/>
<telefono>0331729511</telefono>
<tipoAnagrafica>S</tipoAnagrafica>
</mittente>
</ldv>
</root>
Guttadauro Srl | via F.lli Bandiera, 4 – 21012 - Cassano Magnago (VA)
C.F./Partita IVA/Iscriz. Reg. Imp. VA: n. 01757550122 - R.E.A. VA: n. 205035 - Capitale sociale € 78.000,00 I.V.
T. 0331 729511 - Help Desk 0331 729512 - info@guttadauro.it - web.guttadauro.it
28
Guttadauro Srl | via F.lli Bandiera, 4 – 21012 - Cassano Magnago (VA)
C.F./Partita IVA/Iscriz. Reg. Imp. VA: n. 01757550122 - R.E.A. VA: n. 205035 - Capitale sociale € 78.000,00 I.V.
T. 0331 729511 - Help Desk 0331 729512 - info@guttadauro.it - web.guttadauro.it
29
6.12. Esempio Payload EXTRA LARGE Consegna Programmata
Accessorio compilabile se non attivo Esempio Payload EXTRA LARGE Consegna Stabilita
Accessorio compilabile se non attivo Esempio Payload EXTRA LARGE Consegna al Sabato
Accessorio compilabile se non attivo Esempio Payload EXTRA LARGE Consegna di Sera
Accessorio compilabile se non attivo Esempio Payload EXTRA LARGE Time Definite
Accessorio compilabile se non attivo Esempio Payload EXTRA LARGE Consegna su Appuntamento
<?xml version="1.0" encoding="UTF-8"?>
<root>
<formatoStampa>A4 </formatoStampa>
<ldv>
<datiSpedizione>
<accessori>
<consegnaProgrammata>
<finestraAM>A</finestraAM>
<giorniAM>1,2</giorniAM>
<finestraPM>D</finestraPM>
<giorniPM>3,4,5</giorniPM>
</consegnaProgrammata>
</accessori>
<codiceServizio>S09</codiceServizio>
<datiGenerali>
<contenuto>CONTENUTO</contenuto>
<dataSpedizione>18/02/2022</dataSpedizione>
<note>NOTE DI TEST</note>
<numRifInterno>ORDINE NUMERO 0</numRifInterno>
</datiGenerali>
<sezioneColli>
<colli>
<element>
<altezza>1.0</altezza>
<larghezza>1.0</larghezza>
<peso>1.0</peso>
<profondita>1.0</profondita>
</element>
</colli>
</sezioneColli>
</datiSpedizione>
<destinatario>
<cap>21100</cap>
<codNazione>ITA</codNazione>
<email>mario.rossi@email.com</email>
<indirizzo>VIA DEI CICLAMINI</indirizzo>
<intestatario>MARIO ROSSI</intestatario>
<localita>MILANO</localita>
<provincia>MI</provincia>
<referente>MARIO ROSSI</referente>
<telefono>02000000</telefono>
Guttadauro Srl | via F.lli Bandiera, 4 – 21012 - Cassano Magnago (VA)
C.F./Partita IVA/Iscriz. Reg. Imp. VA: n. 01757550122 - R.E.A. VA: n. 205035 - Capitale sociale € 78.000,00 I.V.
T. 0331 729511 - Help Desk 0331 729512 - info@guttadauro.it - web.guttadauro.it
30
<tipoAnagrafica>S</tipoAnagrafica>
</destinatario>
<mittente>
<cap>21012</cap>
<codNazione>ITA</codNazione>
<email>USER@GUTTADAURO.IT</email>
<indirizzo>VIA F.LLI BANDIERA 4</indirizzo>
<intestatario>GUTTADAURO COMPUTERS SRL</intestatario>
<localita>CASSANO MAGNAGO</localita>
<provincia>VA</provincia>
<referente/>
<telefono>0331729511</telefono>
<tipoAnagrafica>S</tipoAnagrafica>
</mittente>
</ldv>
</root>
Guttadauro Srl | via F.lli Bandiera, 4 – 21012 - Cassano Magnago (VA)
C.F./Partita IVA/Iscriz. Reg. Imp. VA: n. 01757550122 - R.E.A. VA: n. 205035 - Capitale sociale € 78.000,00 I.V.
T. 0331 729511 - Help Desk 0331 729512 - info@guttadauro.it - web.guttadauro.it
31
6.13. Esempio Payload EXTRA LARGE Consegna Stabilita
Accessorio compilabile se non attivo Esempio Payload EXTRA LARGE Consegna Programmata
Accessorio compilabile se non attivo Esempio Payload EXTRA LARGE Consegna al Sabato
Accessorio compilabile se non attivo Esempio Payload EXTRA LARGE Consegna di Sera
Accessorio compilabile se non attivo Esempio Payload EXTRA LARGE Time Definite
Accessorio compilabile se non attivo Esempio Payload EXTRA LARGE Consegna su Appuntamento
<?xml version="1.0" encoding="UTF-8"?>
<root>
<formatoStampa>A4 </formatoStampa>
<ldv>
<datiSpedizione>
<accessori>
<consegnaStabilita>
<dataConsegna>11/05/2024</dataConsegna>
<fasciaOraria>PM</fasciaOraria>
</consegnaStabilita>
</accessori>
<codiceServizio>S09</codiceServizio>
<datiGenerali>
<contenuto>CONTENUTO</contenuto>
<dataSpedizione>18/02/2022</dataSpedizione>
<note>NOTE DI TEST</note>
<numRifInterno>ORDINE NUMERO 0</numRifInterno>
</datiGenerali>
<sezioneColli>
<colli>
<element>
<altezza>1.0</altezza>
<larghezza>1.0</larghezza>
<peso>1.0</peso>
<profondita>1.0</profondita>
</element>
</colli>
</sezioneColli>
</datiSpedizione>
<destinatario>
<cap>21100</cap>
<codNazione>ITA</codNazione>
<email>mario.rossi@email.com</email>
<indirizzo>VIA DEI CICLAMINI</indirizzo>
<intestatario>MARIO ROSSI</intestatario>
<localita>MILANO</localita>
<provincia>MI</provincia>
<referente>MARIO ROSSI</referente>
<telefono>02000000</telefono>
<tipoAnagrafica>S</tipoAnagrafica>
</destinatario>
<mittente>
<cap>21012</cap>
<codNazione>ITA</codNazione>
<email>USER@GUTTADAURO.IT</email>
<indirizzo>VIA F.LLI BANDIERA 4</indirizzo>
<intestatario>GUTTADAURO COMPUTERS SRL</intestatario>
<localita>CASSANO MAGNAGO</localita>
<provincia>VA</provincia>
<referente/>
Guttadauro Srl | via F.lli Bandiera, 4 – 21012 - Cassano Magnago (VA)
C.F./Partita IVA/Iscriz. Reg. Imp. VA: n. 01757550122 - R.E.A. VA: n. 205035 - Capitale sociale € 78.000,00 I.V.
T. 0331 729511 - Help Desk 0331 729512 - info@guttadauro.it - web.guttadauro.it
32
<telefono>0331729511</telefono>
<tipoAnagrafica>S</tipoAnagrafica>
</mittente>
</ldv>
</root>
Guttadauro Srl | via F.lli Bandiera, 4 – 21012 - Cassano Magnago (VA)
C.F./Partita IVA/Iscriz. Reg. Imp. VA: n. 01757550122 - R.E.A. VA: n. 205035 - Capitale sociale € 78.000,00 I.V.
T. 0331 729511 - Help Desk 0331 729512 - info@guttadauro.it - web.guttadauro.it
33
6.14. Esempio Payload EXTRA LARGE Consegna su Appuntamento
Accessorio compilabile se non attivo Esempio Payload EXTRA LARGE Consegna Stabilita
Accessorio compilabile se non attivo Esempio Payload EXTRA LARGE Consegna Programmata
Accessorio compilabile se non attivo Esempio Payload EXTRA LARGE Time Definite
<?xml version="1.0" encoding="UTF-8"?>
<root>
<formatoStampa>A4 </formatoStampa>
<ldv>
<datiSpedizione>
<accessori>
<appuntamento>S</appuntamento>
</accessori>
<codiceServizio>S09</codiceServizio>
<datiGenerali>
<contenuto>CONTENUTO</contenuto>
<dataSpedizione>18/02/2022</dataSpedizione>
<note>NOTE DI TEST</note>
<numRifInterno>ORDINE NUMERO 0</numRifInterno>
</datiGenerali>
<sezioneColli>
<colli>
<element>
<altezza>1.0</altezza>
<larghezza>1.0</larghezza>
<peso>1.0</peso>
<profondita>1.0</profondita>
</element>
</colli>
</sezioneColli>
</datiSpedizione>
<destinatario>
<cap>21100</cap>
<codNazione>ITA</codNazione>
<email>mario.rossi@email.com</email>
<indirizzo>VIA DEI CICLAMINI</indirizzo>
<intestatario>MARIO ROSSI</intestatario>
<localita>MILANO</localita>
<provincia>MI</provincia>
<referente>MARIO ROSSI</referente>
<telefono>02000000</telefono>
<tipoAnagrafica>S</tipoAnagrafica>
</destinatario>
<mittente>
<cap>21012</cap>
<codNazione>ITA</codNazione>
<email>USER@GUTTADAURO.IT</email>
<indirizzo>VIA F.LLI BANDIERA 4</indirizzo>
<intestatario>GUTTADAURO COMPUTERS SRL</intestatario>
<localita>CASSANO MAGNAGO</localita>
<provincia>VA</provincia>
<referente/>
<telefono>0331729511</telefono>
<tipoAnagrafica>S</tipoAnagrafica>
</mittente>
</ldv>
</root>
Guttadauro Srl | via F.lli Bandiera, 4 – 21012 - Cassano Magnago (VA)
C.F./Partita IVA/Iscriz. Reg. Imp. VA: n. 01757550122 - R.E.A. VA: n. 205035 - Capitale sociale € 78.000,00 I.V.
T. 0331 729511 - Help Desk 0331 729512 - info@guttadauro.it - web.guttadauro.it
34
7. Emissione Lettera di vettura tracciato Response (Prodotto
EXTRA LARGE)
BackEndStatus OK Valori Ammessi
OK,KO
BackEndMessage Ldv Inserita in KSync
Descrizione
Messaggio Backend
KSync
Data
Status true Valori Ammessi
true,false
Stickers
sticker 2810538131724 Array [] Ldv /
Sticker Generati
status
result OK Valori Ammessi
OK,KO
code 0
spedizione
valoreAssicurato 0.0
cliente
ragioneSociale
codiceCliente 1038310
mittente
localita TARANTO
cap 74100
indirizzo VIA BRANCUZZA, 11 A
ragioneSociale AENNE DELIVERY S.R.L.S.[00000]
provincia TA
pesoDichiarato 0.0
idLdv 2810538131724 Ldv / Sticker
Generato
numeroColli 0
tracking
stato ???
data 22/02/2022
descrizioneStato LA SPEDIZIONE E' STATA GENERATA DA KSYNC
importoContrassegno 0.0
prodotto S09 S09
destinatario
localita MILANO
referente None
cap 21100
indirizzo VIA DEI CICLAMINI
ragioneSociale MARIO ROSSI
provincia MI
telefono 2000000
email mario.rossi@email.com
messages messages []
Array [] Messaggi
WS
SDA/PosteItaliane
outcome ?
PDFBase64 JVBERi0xLjQKJeLjz9MKNCAwIG9iago8PC9Db2xvclNwYWNlWy9............JbmRleGVkL0RldmljZVJHQiAxKAKc3RhcnR4cmVmCjIwNTMzNwolJUVPRgo= BASE64 Data
Message message Ldv Generata Correttamente
HttpStatusCode 200 Codice Stato Http
Guttadauro Srl | via F.lli Bandiera, 4 – 21012 - Cassano Magnago (VA)
C.F./Partita IVA/Iscriz. Reg. Imp. VA: n. 01757550122 - R.E.A. VA: n. 205035 - Capitale sociale € 78.000,00 I.V.
T. 0331 729511 - Help Desk 0331 729512 - info@guttadauro.it - web.guttadauro.it
35
ResponseTime 2022-02-22 10:02:54 Data Ora Richiesta
Ldv 2810538131724 Ldv Collo Madre
Generato
UUID 0000000958
Identificativo della
transione.
Viene tornato nel
momento in cui
viene presa in
carico la richiesta di
generazione dal
BackEnd KSync.
Questo valore deve
essere salvato lato
client e passato
nelle eventuali
successive
chiamate
nell’opportuno
campo di Request.
Guttadauro Srl | via F.lli Bandiera, 4 – 21012 - Cassano Magnago (VA)
C.F./Partita IVA/Iscriz. Reg. Imp. VA: n. 01757550122 - R.E.A. VA: n. 205035 - Capitale sociale € 78.000,00 I.V.
T. 0331 729511 - Help Desk 0331 729512 - info@guttadauro.it - web.guttadauro.it
36
7.1. Esempio Response Emissione Lettera di vettura (EXTRA LARGE) mono collo
<SoapResponse xmlns="">
<BackEndStatus>OK</BackEndStatus>
<BackEndMessage>Ldv Inserita in KSync</BackEndMessage>
<Data>
<Status>true</Status>
<Stickers>
<sticker>2810538131724</sticker>
<status>
<result>OK</result>
<code>0</code>
<spedizione>
<valoreAssicurato>0.0</valoreAssicurato>
<cliente>
<ragioneSociale/>
<codiceCliente>000001038310</codiceCliente>
</cliente>
<mittente>
<localita>TARANTO</localita>
<cap>74100 </cap>
<indirizzo>VIA BRANCUZZA, 11 A</indirizzo>
<ragioneSociale>AENNE DELIVERY
S.R.L.S.[00000]</ragioneSociale>
<provincia>TA</provincia>
</mittente>
<pesoDichiarato>0.0</pesoDichiarato>
<idLdv>2810538131724</idLdv>
<numeroColli>0</numeroColli>
<tracking>
<stato>???</stato>
<data>22/02/2022</data>
<descrizioneStato>LA SPEDIZIONE E&apos; STATA
GENERATA DA KSYNC</descrizioneStato>
</tracking>
<importoContrassegno>0.0</importoContrassegno>
<prodotto>S09</prodotto>
<destinatario>
<localita>MILANO</localita>
<referente/>
<cap>21100 </cap>
<indirizzo>VIA DEI CICLAMINI</indirizzo>
<ragioneSociale>MARIO ROSSI</ragioneSociale>
<provincia>MI</provincia>
<telefono>02000000</telefono>
<email>mario.rossi@email.com</email>
</destinatario>
</spedizione>
<messages>
<messages>[]</messages>
</messages>
<outcome>?</outcome>
</status>
</Stickers>
<PDFBase64>JVBERi0xLjQKJeLjz9MKNCAwIG9iago8PC9Db2xvclNwYWNlWy9JbmRleGVkL0Rld
mljZVJHQiAxKAKc3[CUT]RhcnR4cmVmCjIwNTMzNwolJUVPRgo=</PDFBase64>
<Message>
<message>Ldv Generata Correttamente</message>
</Message>
<HttpStatusCode>200</HttpStatusCode>
<ResponseTime>2022-02-22 10:02:54</ResponseTime>
<Ldv>2810538131724</Ldv>
<UUID>[UUID IDENTIFICATIVO DELLA TRANSAZIONE]</UUID>
</Data>
</SoapResponse>
Guttadauro Srl | via F.lli Bandiera, 4 – 21012 - Cassano Magnago (VA)
C.F./Partita IVA/Iscriz. Reg. Imp. VA: n. 01757550122 - R.E.A. VA: n. 205035 - Capitale sociale € 78.000,00 I.V.
T. 0331 729511 - Help Desk 0331 729512 - info@guttadauro.it - web.guttadauro.it
37
Nell’esempio è stata effettuata una chiamata andata a buon fine che ha generato una lettera di vettura da
parte dei sistemi di SDA/Poste Italiane.
BackEndStatus=OK
BackEndMessage= “Ldv Inserita in KSync”
Status=true (stato generazione servizio SDA/Poste Italiane)
Stickers= [Array contente informazioni aggiuntive sui colli generati]
Ldv= Numero Ldv generata. In caso di spedizione multi-collo sarà il collo madre di tutta la spedizione.
PDFBase64=Continente i byte relativi al documento richiesto. Per poter essere utilizzati i byte devono
essere Decodificati da Base64.
UUID=Identificativo della transazione con il BackEnd KSync. Salvare Questo valore lato client associato alla
richiesta di generazione. Questo valore è da utilizzare nel caso in cui la generazione della Ldv non vada
correttamente a buon fine al primo tentativo. Nei tentativi successivi passare questo valore nell’opportuno
campo di Request (vedere paragrafo Emissione Lettera di vettura Request (Prodotto EXTRA LARGE))
Guttadauro Srl | via F.lli Bandiera, 4 – 21012 - Cassano Magnago (VA)
C.F./Partita IVA/Iscriz. Reg. Imp. VA: n. 01757550122 - R.E.A. VA: n. 205035 - Capitale sociale € 78.000,00 I.V.
T. 0331 729511 - Help Desk 0331 729512 - info@guttadauro.it - web.guttadauro.it
38
7.2. Esempio Response Emissione Lettera di vettura (EXTRA LARGE) multi-collo
<SoapResponse xmlns="">
<BackEndStatus>OK</BackEndStatus>
<BackEndMessage>Ldv Inserita in KSync</BackEndMessage>
<Data>
<Status>true</Status>
<Stickers>
<sticker>2810538131726</sticker>
<status>
<result>OK</result>
<code>0</code>
<spedizione>
<valoreAssicurato>0.0</valoreAssicurato>
<cliente>
<ragioneSociale/>
<codiceCliente>000001038310</codiceCliente>
</cliente>
<mittente>
<localita>TARANTO</localita>
<cap>74100 </cap>
<indirizzo>VIA BRANCUZZA, 11 A</indirizzo>
<ragioneSociale>AENNE DELIVERY
S.R.L.S.[00000]</ragioneSociale>
<provincia>TA</provincia>
</mittente>
<pesoDichiarato>0.0</pesoDichiarato>
<idLdv>2810538131726</idLdv>
<numeroColli>0</numeroColli>
<tracking>
<stato>???</stato>
<data>22/02/2022</data>
<descrizioneStato>LA SPEDIZIONE E&apos; STATA
GENERATA DA KSYNC</descrizioneStato>
</tracking>
<importoContrassegno>0.0</importoContrassegno>
<prodotto>S09</prodotto>
<destinatario>
<localita>MILANO</localita>
<referente/>
<cap>21100 </cap>
<indirizzo>VIA DEI CICLAMINI</indirizzo>
<ragioneSociale>MARIO ROSSI</ragioneSociale>
<provincia>MI</provincia>
<telefono>02000000</telefono>
<email>mario.rossi@email.com</email>
</destinatario>
</spedizione>
<messages>
<messages>[]</messages>
</messages>
<outcome>?</outcome>
</status>
</Stickers>
<Stickers>
<sticker>0538NB0OC</sticker>
<status>
<result>OK</result>
<code>0</code>
<spedizione>
<valoreAssicurato>0.0</valoreAssicurato>
<cliente>
<ragioneSociale/>
<codiceCliente>000001038310</codiceCliente>
</cliente>
<mittente>
<localita>TARANTO</localita>
<cap>74100 </cap>
Guttadauro Srl | via F.lli Bandiera, 4 – 21012 - Cassano Magnago (VA)
C.F./Partita IVA/Iscriz. Reg. Imp. VA: n. 01757550122 - R.E.A. VA: n. 205035 - Capitale sociale € 78.000,00 I.V.
T. 0331 729511 - Help Desk 0331 729512 - info@guttadauro.it - web.guttadauro.it
39
<indirizzo>VIA BRANCUZZA, 11 A</indirizzo>
<ragioneSociale>AENNE DELIVERY
S.R.L.S.[00000]</ragioneSociale>
<provincia>TA</provincia>
</mittente>
<pesoDichiarato>0.0</pesoDichiarato>
<idLdv>0538NB0OC</idLdv>
<numeroColli>0</numeroColli>
<tracking>
<stato>???</stato>
<data>22/02/2022</data>
<descrizioneStato>LA SPEDIZIONE E&apos; STATA
GENERATA DA KSYNC</descrizioneStato>
</tracking>
<importoContrassegno>0.0</importoContrassegno>
<prodotto>S09</prodotto>
<destinatario>
<localita>MILANO</localita>
<referente/>
<cap>21100 </cap>
<indirizzo>VIA DEI CICLAMINI</indirizzo>
<ragioneSociale>MARIO ROSSI</ragioneSociale>
<provincia>MI</provincia>
<telefono>02000000</telefono>
<email>mario.rossi@email.com</email>
</destinatario>
</spedizione>
<messages>
<messages>[]</messages>
</messages>
<outcome>?</outcome>
</status>
</Stickers>
<PDFBase64>JVBERi0xLjQKJeLjz9MKNCAwIG9iago8PC9Db2xvclNwYWNlWy9JbmRleGVkL0AgbiAKMDAwMDM0OT
EwNyAwMDAwMCBuIAo[CUT]gUj4+CnN0YXJ0eHJlZgo0MTc4NDAKJSVFT0YK</PDFBase64>
<Message>
<message>Ldv Generata Correttamente</message>
</Message>
<HttpStatusCode>200</HttpStatusCode>
<ResponseTime>2022-02-22 11:16:02</ResponseTime>
<Ldv>2810538131726</Ldv>
<UUID>[UUID IDENTIFICATIVO DELLA TRANSAZIONE]</UUID>
</Data>
</SoapResponse>
Guttadauro Srl | via F.lli Bandiera, 4 – 21012 - Cassano Magnago (VA)
C.F./Partita IVA/Iscriz. Reg. Imp. VA: n. 01757550122 - R.E.A. VA: n. 205035 - Capitale sociale € 78.000,00 I.V.
T. 0331 729511 - Help Desk 0331 729512 - info@guttadauro.it - web.guttadauro.it
40
7.3. Esempio Response Emissione Lettera di vettura (EXTRA LARGE) con errore
BackEnd KSync
<SoapResponse xmlns="">
<BackEndStatus>KO</BackEndStatus>
<BackEndMessage>Servizio Non Supportato</BackEndMessage>
<Data/>
</SoapResponse>
Nell’esempio è stata effettuata una chiamata dove il campo codiceServizio NON contiene il codice S09.
Poiché la richiesta non è stata storicizzata nel BackEnd Ksync la response conterrà:
BackEndStatus=KO
BackEndMessage=Descrizione Errore tornato dal Business Object del BackEnd KSync
Data= NULL (la richiesta non è mai stata inoltrata al servizio di generazione lettere di vettura di SDA/Poste
Italiane)
Guttadauro Srl | via F.lli Bandiera, 4 – 21012 - Cassano Magnago (VA)
C.F./Partita IVA/Iscriz. Reg. Imp. VA: n. 01757550122 - R.E.A. VA: n. 205035 - Capitale sociale € 78.000,00 I.V.
T. 0331 729511 - Help Desk 0331 729512 - info@guttadauro.it - web.guttadauro.it
41
7.4. Esempio Response Emissione Lettera di vettura (EXTRA LARGE) con errore
WebService
Errore di SDA/Poste Italiane
<SoapResponse xmlns="">
<BackEndStatus>OK</BackEndStatus>
<BackEndMessage>Ldv Inserita in KSync</BackEndMessage>
<Data>
<Status>false</Status>
<PDFBase64/>
<Message>
<message>La data di spedizione non puo&apos;&apos; essere inferiore alla
data corrente</message>
</Message>
<HttpStatusCode>200</HttpStatusCode>
<ResponseTime>2022-02-22 16:27:55</ResponseTime>
<Ldv/>
<UUID>[UUID IDENTIFICATIVO DELLA TRANSAZIONE]</UUID>
</Data>
</SoapResponse>
Nell’esempio è stata effettuata una chiamata dove il campo dataSpedizione è antecedente alla data odierna.
Poiché la richiesta è stata storicizzata nel BackEnd KSync ma è stata scarta dal servizio di generazione
lettere di vettura di SDA/Poste Italiane la response conterrà:
BackEndStatus=OK
BackEndMessage= “Ldv Inserita in KSync”
Status=false (stato generazione servizio SDA/Poste Italiane)
Message= [è un array di message ritornati dal servizio di generazione lettere di vettura di SDA/Poste
Italiane]
Ldv=NULL (nessuna lettera di vettura generata)
PDFBase64=NULL (nessun file PDF o ZPL generato)
UUID=Identificativo della transazione con il BackEnd KSync. Salvare Questo valore lato client associato alla
richiesta di generazione. Questo valore è da utilizzare nel caso in cui la generazione della Ldv non vada
correttamente a buon fine al primo tentativo. Nei tentativi successivi passare questo valore nell’opportuno
campo di Request (vedere paragrafo Emissione Lettera di vettura Request (Prodotto EXTRA LARGE))
Guttadauro Srl | via F.lli Bandiera, 4 – 21012 - Cassano Magnago (VA)
C.F./Partita IVA/Iscriz. Reg. Imp. VA: n. 01757550122 - R.E.A. VA: n. 205035 - Capitale sociale € 78.000,00 I.V.
T. 0331 729511 - Help Desk 0331 729512 - info@guttadauro.it - web.guttadauro.it
42
8. Tracking Lettera di vettura v2
Endpoint collaudo:
https://ksync.guttadauro.it/KIPOINT_20_DEBUG/servlet/SQLDataProviderServer/gt_qry_tracking_s
oap_v2
Endpoint Produzione:
https://ksync.guttadauro.it/KIPOINT_20/servlet/SQLDataProviderServer/gt_qry_tracking_soap_v2
Schema:
https (TLS 1.2)
Method:
POST
Authorization:
None
Header:
Content-Type: text/xml; charset=utf-8
Body:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" x
mlns:gt="http://gt_qry_tracking_soap_v2.ws.localhost/">
<soapenv:Header/>
<soapenv:Body>
<gt:gt_qry_tracking_soap_v2_TabularQuery>
<gt:m_UserName>KI266B</gt:m_UserName>
<gt:m_Password>password</gt:m_Password>
<gt:m_Company>001</gt:m_Company>
<gt:pLdv>287097I019286</gt:pLdv>
<gt:pUltimoStato>N</gt:pUltimoStato>
</gt:gt_qry_tracking_soap_v2_TabularQuery>
</soapenv:Body>
</soapenv:Envelope>
Guttadauro Srl | via F.lli Bandiera, 4 – 21012 - Cassano Magnago (VA)
C.F./Partita IVA/Iscriz. Reg. Imp. VA: n. 01757550122 - R.E.A. VA: n. 205035 - Capitale sociale € 78.000,00 I.V.
T. 0331 729511 - Help Desk 0331 729512 - info@guttadauro.it - web.guttadauro.it
43
Nell’esempio è stata effettuata una chiamata di tracking della Ldv 287097I019286ra generata dal PV
KI226B.
I parametri in ingresso richiesti sono:
pLdv : Rappresenta la Ldv di cui si vuole chiedere il tracking.
pUltimoStato:
o N Torna la lista di tutti i cambiamenti di stato presenti nel database di KSync
o S Torna solo l’ultimo stato conosciuto nel database di KSync
Guttadauro Srl | via F.lli Bandiera, 4 – 21012 - Cassano Magnago (VA)
C.F./Partita IVA/Iscriz. Reg. Imp. VA: n. 01757550122 - R.E.A. VA: n. 205035 - Capitale sociale € 78.000,00 I.V.
T. 0331 729511 - Help Desk 0331 729512 - info@guttadauro.it - web.guttadauro.it
44
8.1. Esempio Response Tracking Lettera di vettura v2
Nel caso in cui la ricerca del Tracking va a buon fine con pUltimoStato=S viene tornato l’ultimo stato
conosciuto e attualmente memorizzato all’interno di KSync.
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<gt_qry_tracking_soap_v2_TabularQueryResponse xmlns="http://gt_qry_tracking_soap_
v2.ws.localhost/">
<Records>
<item>
<Company>KI266B</Company>
<Ldv>287097I019183</Ldv>
<DataPartenza>30/06/2023</DataPartenza>
<Corriere>SDA</Corriere>
<OutCome>OK</OutCome>
<DataEvento>03/07/2023 13:07:00</DataEvento>
<Stato>000</Stato>
<DescrizioneStato>LA SPEDIZIONE E' STATA CONSEGNATA</DescrizioneStato
>
</item>
</Records>
</gt_qry_tracking_soap_v2_TabularQueryResponse>
</soap:Body>
</soap:Envelope>
Nel caso in cui la ricerca del Tracking va a buon fine con pUltimoStato=N vengono tornati gli stati conosciuti
e attualmente memorizzato all’interno di KSync.
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<gt_qry_tracking_soap_v2_TabularQueryResponse xmlns="http://gt_qry_tracking_soap_
v2.ws.localhost/">
<Records>
<item>
<Company>KI266B</Company>
<Ldv>287097I019183</Ldv>
<DataPartenza>30/06/2023</DataPartenza>
<Corriere>SDA</Corriere>
<OutCome>OK</OutCome>
<DataEvento>03/07/2023 13:07:00</DataEvento>
<Stato>000</Stato>
<DescrizioneStato>LA SPEDIZIONE E' STATA CONSEGNATA</DescrizioneStato
>
</item>
<item>
<Company>KI266B</Company>
<Ldv>287097I019183</Ldv>
<DataPartenza>30/06/2023</DataPartenza>
Guttadauro Srl | via F.lli Bandiera, 4 – 21012 - Cassano Magnago (VA)
C.F./Partita IVA/Iscriz. Reg. Imp. VA: n. 01757550122 - R.E.A. VA: n. 205035 - Capitale sociale € 78.000,00 I.V.
T. 0331 729511 - Help Desk 0331 729512 - info@guttadauro.it - web.guttadauro.it
45
<Corriere>SDA</Corriere>
<OutCome>OK</OutCome>
<DataEvento>02/07/2023 22:07:00</DataEvento>
<Stato>000</Stato>
<DescrizioneStato>IN TRANSITO</DescrizioneStato>
</item>
.. MORE ITEMS ..
</Records>
</gt_qry_tracking_soap_v2_TabularQueryResponse>
</soap:Body>
</soap:Envelope>
Nel caso in cui la ricerca del Tracking non produce risultati la response non conterrà alcun dato.
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<gt_qry_tracking_soap_v2_TabularQueryResponse xmlns="http://gt_qry_tracking_soap_
v2.ws.localhost/">
<Records></Records>
</gt_qry_tracking_soap_v2_TabularQueryResponse>
</soap:Body>
</soap:Envelope>
N.B.
Nel caso in cui la spedizione sia multi-collo le informazioni di tracking tornate sono sempre quella della Ldv
Madre.
Guttadauro Srl | via F.lli Bandiera, 4 – 21012 - Cassano Magnago (VA)
C.F./Partita IVA/Iscriz. Reg. Imp. VA: n. 01757550122 - R.E.A. VA: n. 205035 - Capitale sociale € 78.000,00 I.V.
T. 0331 729511 - Help Desk 0331 729512 - info@guttadauro.it - web.guttadauro.it
46
9. Prenotazione Ritiro Request (PF Porto Franco)
Endpoint collaudo:
https://ksync.guttadauro.it/KIPOINT_20_DEBUG/servlet/gt_btc_ritiro_soap
Endpoint Produzione:
https://ksync.guttadauro.it/KIPOINT_20/servlet/gt_btc_ ritiro soap
Schema:
https (TLS 1.2)
Method:
POST
Authorization:
None
Header:
Content-Type: text/xml; charset=utf-8
Body:
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<gt_btc_ritiro_soap_Run xmlns="http://gt_btc_ritiro_soap.ws.localhost/">
<m_UserName>KI266_WS</m_UserName>
<m_Password>password</m_Password>
<m_Company>001</m_Company>
<XMLData>[XML PAYLOAD]</XMLData>
<UUID>[UUID IDENTIFICATIVO DELLA TRANSAZIONE]</UUID>
</gt_btc_ritiro_soap_Run>
</soap:Body>
</soap:Envelope>
[XML PAYLOAD]:
Eseguire metodo di Escape sulla stringa xml prima di valorizzare il campo
' è rimpiazzato con &apos;
" è rimpiazzato con &quot;
& è rimpiazzato con &amp;
< è rimpiazzato con &lt;
> è rimpiazzato con &gt;
Guttadauro Srl | via F.lli Bandiera, 4 – 21012 - Cassano Magnago (VA)
C.F./Partita IVA/Iscriz. Reg. Imp. VA: n. 01757550122 - R.E.A. VA: n. 205035 - Capitale sociale € 78.000,00 I.V.
T. 0331 729511 - Help Desk 0331 729512 - info@guttadauro.it - web.guttadauro.it
47
[UUID IDENTIFICATIVO DELLA TRANSAZIONE]
La PRIMA volta che viene effettuata la richiesta di prenotazione di un ritiro lasciare vuoto “” in
quanto non ancora disponibile al client chiamante.
Nel caso in cui la richiesta è stata presa in carico correttamente dal BackEnd KSync il verrà
restituito nella Response della chiamata WS (vedere paragrafo Prenotazione Ritiro tracciato
Response).
Memorizzare questo valore lato client associato alla richiesta di prenotazione.
Nel caso in cui il Ritiro non sia stato prenotato per qualche errore SW (es. down temporaneo dei
sevizi WS di SDA), nel successivo tentativo di generazione passare il valore UUID
precedentemente restituito. Questo alleggerisce il carico di lavoro del server KSync dalla
seconda richiesta in poi e velocizza l’operazione di prenotazione del Ritiro.
Guttadauro Srl | via F.lli Bandiera, 4 – 21012 - Cassano Magnago (VA)
C.F./Partita IVA/Iscriz. Reg. Imp. VA: n. 01757550122 - R.E.A. VA: n. 205035 - Capitale sociale € 78.000,00 I.V.
T. 0331 729511 - Help Desk 0331 729512 - info@guttadauro.it - web.guttadauro.it
48
10. Prenotazione Ritiro tracciato Request (PF Porto Franco)
Tipo Descrizione
mittente
ragioneSociale C*50 Nomimativo del mittente
nominativoContatto C*50 Nomimativo del mittente se diverso dalla ragione sociale
codiceFiscale C*16 Codice fiscale del mittente
partitaIva C*11 Partita Iva del mittente
datoFiscaleInternazionale C*20 Codice fiscale internazionale del mittente
indirizzo C*50 Indirizzo del mittente
cap C*5 Cap del mittente
localita C*50 Località del mittente
provincia C*2 Provincia del mittente
email C*60 E-mail del mittente
telefono C*50 Telefono del mittente
palazzina C*10 Palazzina del mittente
scala C*10 Scala del mittente
interno C*10 Interno del mittente
ufficio C*20 Ufficio del mittente
ritiro_presso_portineria false B true/false
citofono C*20 Citofono del mittente
oraAperturaMattino C*5 HH:mm
oraAperturaPomeriggio C*5 HH:mm
oraChiusuraMattino C*5 HH:mm
oraChiusuraPomeriggio C*5 HH:mm
note C*50 Note mittente
ritiro
assicurata ldv C*13 Ldv
importo N*10,2 Importo Assicurata
note1 NOTE PIEDE C*50 Note
dataRichiesta 2023-10-16 15:57:00 DT Data Richiesta YYYY-MM-DD HH:mm:ss (data sistema)
dataRitiro 2023-10-17 00:00:00 DT Data Ritiro YYYY-MM-DD HH:mm:ss
ldv C*13 Ldv
tiporitiro
servizio PF C*2 PF=Porto Franco
buste numeroColli 1 N*9 Numero Colli
peso 0.50 N*10,2 Peso
pacchi
numeroColli 2 N*9 Numero Colli
peso 10 N*10,2 Peso
altezza 10 N*10,2 Altezza
larghezza 100 N*10,2 Larghezza
profondita 10 N*10,2 Profondità
voluminoso false B true/false
Guttadauro Srl | via F.lli Bandiera, 4 – 21012 - Cassano Magnago (VA)
C.F./Partita IVA/Iscriz. Reg. Imp. VA: n. 01757550122 - R.E.A. VA: n. 205035 - Capitale sociale € 78.000,00 I.V.
T. 0331 729511 - Help Desk 0331 729512 - info@guttadauro.it - web.guttadauro.it
49
10.1. Esempio Payload Ritiro Tipo Busta
<?xml version="1.0" encoding="UTF-8"?>
<root>
<ritiro>
<note1>NOTE DI PIEDE</note1>
<dataRichiesta>2023-10-12 13:23:00</dataRichiesta>
<dataRitiro>2023-10-13 00:00:00</dataRitiro>
<ldv>2883316178851</ldv>
<tiporitiro>
<servizio>PF</servizio>
<buste>
<numeroColli>1</numeroColli>
<peso>0.50</peso>
</buste>
</tiporitiro>
</ritiro>
<mittente>
<ragioneSociale>Mario Rossi</ragioneSociale>
<nominativoContatto>Marios</nominativoContatto>
<codiceFiscale>MRORSS77A19L452N</codiceFiscale>
<partitaIva>12345678901</partitaIva>
<datoFiscaleInternazionale/>
<indirizzo>Via del Pescaccio, 90</indirizzo>
<cap>00118</cap>
<localita>Roma</localita>
<provincia>RM</provincia>
<email>mario.rossi@gmail.com</email >
<telefono>3470000000</telefono>
<palazzina/>
<scala/>
<interno/>
<ufficio/>
<ritiro_presso_portineria>true</ritiro_presso_portineria>
<citofono/>
<oraAperturaMattino/>
<oraAperturaPomeriggio/>
<oraChiusuraMattino/>
<oraChiusuraPomeriggio/>
<note>SUONARE CAMPANELLO ROSSO</note>
</mittente>
Guttadauro Srl | via F.lli Bandiera, 4 – 21012 - Cassano Magnago (VA)
C.F./Partita IVA/Iscriz. Reg. Imp. VA: n. 01757550122 - R.E.A. VA: n. 205035 - Capitale sociale € 78.000,00 I.V.
T. 0331 729511 - Help Desk 0331 729512 - info@guttadauro.it - web.guttadauro.it
50
</root>
Sequenza Escape:
&lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot;?&gt;&lt;root&gt;&lt;ritiro&gt;&lt;note1&gt;NOTE DI
PIEDE&lt;/note1&gt;&lt;dataRichiesta&gt;2023-10-12 13:23:00&lt;/dataRichiesta&gt;&lt;dataRitiro&gt;2023-10-13
10:13:23&lt;/dataRitiro&gt;&lt;ldv&gt;2883316178851&lt;/ldv&gt;&lt;tiporitiro&gt;&lt;servizio&gt;PF&lt;/servizio&gt;&lt;bust
e&gt;&lt;numeroColli&gt;1&lt;/numeroColli&gt;&lt;peso&gt;0.50&lt;/peso&gt;&lt;/buste&gt;&lt;/tiporitiro&gt;&lt;/ritiro&gt;&lt;
mittente&gt;&lt;ragioneSociale&gt;Mario
Rossi&lt;/ragioneSociale&gt;&lt;nominativoContatto&gt;Marios&lt;/nominativoContatto&gt;&lt;codiceFiscale&gt;MRORSS
77A19L452N&lt;/codiceFiscale&gt;&lt;partitaIva&gt;12345678901&lt;/partitaIva&gt;&lt;datoFiscaleInternazionale/&gt;&lt;i
ndirizzo&gt;Via del
Pescaccio,90&lt;/indirizzo&gt;&lt;cap&gt;00118&lt;/cap&gt;&lt;localita&gt;Roma&lt;/localita&gt;&lt;provincia&gt;RM&lt;/pro
vincia&gt;&lt;email&gt;mario.rossi@gmail.com&lt;/email&gt;&lt;telefono&gt;3470000000&lt;/telefono&gt;&lt;palazzina/&gt;
&lt;scala/&gt;&lt;interno/&gt;&lt;ufficio/&gt;&lt;ritiro_presso_portineria&gt;true&lt;/ritiro_presso_portineria&gt;&lt;citofono/&
gt;&lt;oraAperturaMattino/&gt;&lt;oraAperturaPomeriggio/&gt;&lt;oraChiusuraMattino/&gt;&lt;oraChiusuraPomeriggio/&gt;
&lt;note&gt;SUONARE CAMPANELLO ROSSO&lt;/note&gt;&lt;/mittente&gt;&lt;/root&gt;
Guttadauro Srl | via F.lli Bandiera, 4 – 21012 - Cassano Magnago (VA)
C.F./Partita IVA/Iscriz. Reg. Imp. VA: n. 01757550122 - R.E.A. VA: n. 205035 - Capitale sociale € 78.000,00 I.V.
T. 0331 729511 - Help Desk 0331 729512 - info@guttadauro.it - web.guttadauro.it
51
10.2. Esempio Payload Ritiro Tipo Pacchi
<?xml version="1.0" encoding="UTF-8"?>
<root>
<ritiro>
<note1>NOTE DI PIEDE</note1>
<dataRichiesta>2023-10-12 13:23:00</dataRichiesta>
<dataRitiro>2023-10-13 10:13:23</dataRitiro>
<ldv>2883316178851</ldv>
<tiporitiro>
<servizio>PF</servizio>
<pacchi>
<numeroColli>2</numeroColli>
<peso>4.50</peso>
<altezza>10.1</altezza>
<larghezza>100.2</larghezza>
<profondita>10.3</profondita>
<voluminoso>true</voluminoso>
</pacchi>
</tiporitiro>
</ritiro>
<mittente>
<ragioneSociale>Mario Rossi</ragioneSociale>
<nominativoContatto>Marios</nominativoContatto>
<codiceFiscale>MRORSS77A19L452N</codiceFiscale>
<partitaIva>12345678901</partitaIva>
<datoFiscaleInternazionale/>
<indirizzo>Via del Pescaccio, 90</indirizzo>
<cap>00118</cap>
<localita>Roma</localita>
<provincia>RM</provincia>
<email>mario.rossi@gmail.com</email >
<telefono>3470000000</telefono>
<palazzina/>
<scala/>
<interno/>
<ufficio/>
Guttadauro Srl | via F.lli Bandiera, 4 – 21012 - Cassano Magnago (VA)
C.F./Partita IVA/Iscriz. Reg. Imp. VA: n. 01757550122 - R.E.A. VA: n. 205035 - Capitale sociale € 78.000,00 I.V.
T. 0331 729511 - Help Desk 0331 729512 - info@guttadauro.it - web.guttadauro.it
52
<ritiro_presso_portineria>true</ritiro_presso_portineria>
<citofono/>
<oraAperturaMattino/>
<oraAperturaPomeriggio/>
<oraChiusuraMattino/>
<oraChiusuraPomeriggio/>
<note>SUONARE CAMPANELLO ROSSO</note>
</mittente>
</root>
Sequenza Escape:
&lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot;?&gt;&lt;root&gt;&lt;ritiro&gt;&lt;note1&gt;NOTE DI
PIEDE&lt;/note1&gt;&lt;dataRichiesta&gt;2023-10-12 13:23:00&lt;/dataRichiesta&gt;&lt;dataRitiro&gt;2023-10-13
10:13:23&lt;/dataRitiro&gt;&lt;ldv&gt;2883316178851&lt;/ldv&gt;&lt;tiporitiro&gt;&lt;servizio&gt;PF&lt;/servizio&gt;&lt;pacc
hi&gt;&lt;numeroColli&gt;2&lt;/numeroColli&gt;&lt;peso&gt;4.50&lt;/peso&gt;&lt;altezza&gt;10.1&lt;/altezza&gt;&lt;larghez
za&gt;100.2&lt;/larghezza&gt;&lt;profondita&gt;10.3&lt;/profondita&gt;&lt;voluminoso&gt;true&lt;/voluminoso&gt;&lt;/pacc
hi&gt;&lt;/tiporitiro&gt;&lt;/ritiro&gt;&lt;mittente&gt;&lt;ragioneSociale&gt;Mario
Rossi&lt;/ragioneSociale&gt;&lt;nominativoContatto&gt;Marios&lt;/nominativoContatto&gt;&lt;codiceFiscale&gt;MRORSS
77A19L452N&lt;/codiceFiscale&gt;&lt;partitaIva&gt;12345678901&lt;/partitaIva&gt;&lt;datoFiscaleInternazionale/&gt;&lt;i
ndirizzo&gt;Via del Pescaccio,
90&lt;/indirizzo&gt;&lt;cap&gt;00118&lt;/cap&gt;&lt;localita&gt;Roma&lt;/localita&gt;&lt;provincia&gt;RM&lt;/provincia&gt;
&lt;email&gt;mario.rossi@gmail.com&lt;/email
&gt;&lt;telefono&gt;3470000000&lt;/telefono&gt;&lt;palazzina/&gt;&lt;scala/&gt;&lt;interno/&gt;&lt;ufficio/&gt;&lt;ri
tiro_presso_portineria&gt;true&lt;/ritiro_presso_portineria&gt;&lt;citofono/&gt;&lt;oraAperturaMattino/&gt;&lt;oraAperturaP
omeriggio/&gt;&lt;oraChiusuraMattino/&gt;&lt;oraChiusuraPomeriggio/&gt;&lt;note&gt;SUONARE CAMPANELLO
ROSSO&lt;/note&gt;&lt;/mittente&gt;&lt;/root&gt;
Guttadauro Srl | via F.lli Bandiera, 4 – 21012 - Cassano Magnago (VA)
C.F./Partita IVA/Iscriz. Reg. Imp. VA: n. 01757550122 - R.E.A. VA: n. 205035 - Capitale sociale € 78.000,00 I.V.
T. 0331 729511 - Help Desk 0331 729512 - info@guttadauro.it - web.guttadauro.it
53
10.3. Esempio Payload Ritiro Tipo Pacchi Assicurato
<?xml version="1.0" encoding="UTF-8"?>
<root>
<ritiro>
<assicurata>
<ldv>2883316178851</ldv>
<importo>56.90</importo>
</assicurata>
<note1>NOTE DI PIEDE</note1>
<dataRichiesta>2023-10-12 13:23:00</dataRichiesta>
<dataRitiro>2023-10-13 10:13:23</dataRitiro>
<ldv>2883316178851</ldv>
<tiporitiro>
<servizio>PF</servizio>
<pacchi>
<numeroColli>2</numeroColli>
<peso>4.50</peso>
<altezza>10.1</altezza>
<larghezza>100.2</larghezza>
<profondita>10.3</profondita>
<voluminoso>true</voluminoso>
</pacchi>
</tiporitiro>
</ritiro>
<mittente>
<ragioneSociale>Mario Rossi</ragioneSociale>
<nominativoContatto>Marios</nominativoContatto>
<codiceFiscale>MRORSS77A19L452N</codiceFiscale>
<partitaIva>12345678901</partitaIva>
<datoFiscaleInternazionale/>
<indirizzo>Via del Pescaccio, 90</indirizzo>
<cap>00118</cap>
<localita>Roma</localita>
<provincia>RM</provincia>
<email>mario.rossi@gmail.com</email >
<telefono>3470000000</telefono>
Guttadauro Srl | via F.lli Bandiera, 4 – 21012 - Cassano Magnago (VA)
C.F./Partita IVA/Iscriz. Reg. Imp. VA: n. 01757550122 - R.E.A. VA: n. 205035 - Capitale sociale € 78.000,00 I.V.
T. 0331 729511 - Help Desk 0331 729512 - info@guttadauro.it - web.guttadauro.it
54
<palazzina/>
<scala/>
<interno/>
<ufficio/>
<ritiro_presso_portineria>true</ritiro_presso_portineria>
<citofono/>
<oraAperturaMattino/>
<oraAperturaPomeriggio/>
<oraChiusuraMattino/>
<oraChiusuraPomeriggio/>
<note>SUONARE CAMPANELLO ROSSO</note>
</mittente>
</root>
Sequenza Escape:
&lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-
8&quot;?&gt;&lt;root&gt;&lt;ritiro&gt;&lt;assicurata&gt;&lt;ldv&gt;2883316178851&lt;/ldv&gt;&lt;importo&gt;56.90&lt;/impor
to&gt;&lt;/assicurata&gt;&lt;note1&gt;NOTE DI PIEDE&lt;/note1&gt;&lt;dataRichiesta&gt;2023-10-12
13:23:00&lt;/dataRichiesta&gt;&lt;dataRitiro&gt;2023-10-13
10:13:23&lt;/dataRitiro&gt;&lt;ldv&gt;2883316178851&lt;/ldv&gt;&lt;tiporitiro&gt;&lt;servizio&gt;PF&lt;/servizio&gt;&lt;pacc
hi&gt;&lt;numeroColli&gt;2&lt;/numeroColli&gt;&lt;peso&gt;4.50&lt;/peso&gt;&lt;altezza&gt;10.1&lt;/altezza&gt;&lt;larghez
za&gt;100.2&lt;/larghezza&gt;&lt;profondita&gt;10.3&lt;/profondita&gt;&lt;voluminoso&gt;true&lt;/voluminoso&gt;&lt;/pacc
hi&gt;&lt;/tiporitiro&gt;&lt;/ritiro&gt;&lt;mittente&gt;&lt;ragioneSociale&gt;Mario
Rossi&lt;/ragioneSociale&gt;&lt;nominativoContatto&gt;Marios&lt;/nominativoContatto&gt;&lt;codiceFiscale&gt;MRORSS
77A19L452N&lt;/codiceFiscale&gt;&lt;partitaIva&gt;12345678901&lt;/partitaIva&gt;&lt;datoFiscaleInternazionale/&gt;&lt;i
ndirizzo&gt;Via del Pescaccio,
90&lt;/indirizzo&gt;&lt;cap&gt;00118&lt;/cap&gt;&lt;localita&gt;Roma&lt;/localita&gt;&lt;provincia&gt;RM&lt;/provincia&gt;
&lt;email&gt;mario.rossi@gmail.com&lt;/email
&gt;&lt;telefono&gt;3470000000&lt;/telefono&gt;&lt;palazzina/&gt;&lt;scala/&gt;&lt;interno/&gt;&lt;ufficio/&gt;&lt;ri
tiro_presso_portineria&gt;true&lt;/ritiro_presso_portineria&gt;&lt;citofono/&gt;&lt;oraAperturaMattino/&gt;&lt;oraAperturaP
omeriggio/&gt;&lt;oraChiusuraMattino/&gt;&lt;oraChiusuraPomeriggio/&gt;&lt;note&gt;SUONARE CAMPANELLO
ROSSO&lt;/note&gt;&lt;/mittente&gt;&lt;/root&gt;
Guttadauro Srl | via F.lli Bandiera, 4 – 21012 - Cassano Magnago (VA)
C.F./Partita IVA/Iscriz. Reg. Imp. VA: n. 01757550122 - R.E.A. VA: n. 205035 - Capitale sociale € 78.000,00 I.V.
T. 0331 729511 - Help Desk 0331 729512 - info@guttadauro.it - web.guttadauro.it
55
11. Prenotazione Ritiro tracciato Response
Descrizione
BackEndStatus OK
Valori Ammessi
OK,KO
BackEndMessage Ritiro Inserito in KSync Descrizione Messaggio Backend
KSync
Data
Status true
Valori Ammessi
true,false
Message message Ritiro Prenotato Correttamente
HttpStatusCode 200 Codice Stato Http
ResponseTime 22/02/2022 10:02 Data Ora Richiesta
CodicePrenotazione CP41591252 Codice Prenotazione Generato
UUID 0000001548
Identificativo della transione.
Viene tornato nel momento in cui
viene presa in carico la richiesta di
prenotazione dal BackEnd KSync.
Questo valore deve essere salvato
lato client e passato nelle eventuali
successive chiamate
nell’opportuno campo di Request.
Guttadauro Srl | via F.lli Bandiera, 4 – 21012 - Cassano Magnago (VA)
C.F./Partita IVA/Iscriz. Reg. Imp. VA: n. 01757550122 - R.E.A. VA: n. 205035 - Capitale sociale € 78.000,00 I.V.
T. 0331 729511 - Help Desk 0331 729512 - info@guttadauro.it - web.guttadauro.it
56
11.1. Esempio Response Prenotazione Ritiro terminato con successo
<SoapResponse xmlns="">
<BackEndStatus>OK</BackEndStatus>
<BackEndMessage>Ritiro Inserito in KSync</BackEndMessage>
<Data>
<Status>true</Status>
<Message>
<message>Ritiro Prenotato Correttamente</message>
</Message>
<HttpStatusCode>200</HttpStatusCode>
<ResponseTime>2023-10-16 16:32:30</ResponseTime>
<CodicePrenotazione>CP41591252</CodicePrenotazione>
<UUID>[UUID IDENTIFICATIVO DELLA TRANSAZIONE]</UUID>
</Data>
</SoapResponse>
Guttadauro Srl | via F.lli Bandiera, 4 – 21012 - Cassano Magnago (VA)
C.F./Partita IVA/Iscriz. Reg. Imp. VA: n. 01757550122 - R.E.A. VA: n. 205035 - Capitale sociale € 78.000,00 I.V.
T. 0331 729511 - Help Desk 0331 729512 - info@guttadauro.it - web.guttadauro.it
57
11.2. Esempio Response Prenotazione Ritiro con errore BackEnd KSync
<SoapResponse xmlns="">
<BackEndStatus>KO</BackEndStatus>
<BackEndMessage>Mittente Indirizzo : campo obbligatorio.</BackEndMessage>
<Data/>
</SoapResponse>
Guttadauro Srl | via F.lli Bandiera, 4 – 21012 - Cassano Magnago (VA)
C.F./Partita IVA/Iscriz. Reg. Imp. VA: n. 01757550122 - R.E.A. VA: n. 205035 - Capitale sociale € 78.000,00 I.V.
T. 0331 729511 - Help Desk 0331 729512 - info@guttadauro.it - web.guttadauro.it
58
11.3. Esempio Response Prenotazione Ritiro con errore WebService
<SoapResponse xmlns="">
<BackEndStatus>OK</BackEndStatus>
<BackEndMessage>Ritiro Inserito in KSync</BackEndMessage>
<Data>
<Status>false</Status>
<Message>
<message>Error</message>
</Message>
<HttpStatusCode>500</HttpStatusCode>
<ResponseTime>2023-10-16 17:01:57</ResponseTime>
<UUID>[UUID IDENTIFICATIVO DELLA TRANSAZIONE]</UUID>
</Data>
</SoapResponse>
Guttadauro Srl | via F.lli Bandiera, 4 – 21012 - Cassano Magnago (VA)
C.F./Partita IVA/Iscriz. Reg. Imp. VA: n. 01757550122 - R.E.A. VA: n. 205035 - Capitale sociale € 78.000,00 I.V.
T. 0331 729511 - Help Desk 0331 729512 - info@guttadauro.it - web.guttadauro.it
59
12. Elenco Località Presenti in KSync
Per favorire l’integrazione di sistemi esterni e pilotare meglio l’elenco delle località e quindi evitare che la
spedizione possa “bloccarsi” o subire ritardi sono state esposte le località anagrafate in KSync.
Endpoint collaudo:
https://ksync.guttadauro.it/KIPOINT_20_DEBUG/servlet/SQLDataProviderServer/gt
_qry_ldv_soap_localita
Endpoint Produzione:
https://ksync.guttadauro.it/KIPOINT_20/servlet/SQLDataProviderServer/gt_qry_l
dv_soap_localita
Schema:
https (TLS 1.2)
Method:
POST
Authorization:
None
Header:
Content-Type: text/xml;charset=utf-8
Body:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:gt=
"http://gt_qry_ldv_soap_localita.ws.localhost/">
<soapenv:Header/>
<soapenv:Body>
<gt:gt_qry_ldv_soap_localita_TabularQuery>
<gt:m_UserName>KI266_WS</gt:m_UserName>
<gt:m_Password>password</gt:m_Password>
<gt:m_Company>001</gt:m_Company>
<gt:pLocalita>[OPZIONALE]</gt:pLocalita>
<gt:pProvincia>[OPZIONALE]</gt:pProvincia>
</gt:gt_qry_ldv_soap_localita_TabularQuery>
</soapenv:Body>
</soapenv:Envelope>
Guttadauro Srl | via F.lli Bandiera, 4 – 21012 - Cassano Magnago (VA)
C.F./Partita IVA/Iscriz. Reg. Imp. VA: n. 01757550122 - R.E.A. VA: n. 205035 - Capitale sociale € 78.000,00 I.V.
T. 0331 729511 - Help Desk 0331 729512 - info@guttadauro.it - web.guttadauro.it
60
12.1. Esempio Response elenco Località terminato con successo
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<gt_qry_ldv_soap_localita_TabularQueryResponse xmlns="http://gt_qry_ldv_soap_loca
lita.ws.localhost/">
<Records>
..
<item>
<CTCODEID>0000004011</CTCODEID>
<CTLOCAL>CASTRONNO</CTLOCAL>
<CTPROV>VA</CTPROV>
</item>
..
</Records>
</gt_qry_ldv_soap_localita_TabularQueryResponse>
</soap:Body>
</soap:Envelope>
Guttadauro Srl | via F.lli Bandiera, 4 – 21012 - Cassano Magnago (VA)
C.F./Partita IVA/Iscriz. Reg. Imp. VA: n. 01757550122 - R.E.A. VA: n. 205035 - Capitale sociale € 78.000,00 I.V.
T. 0331 729511 - Help Desk 0331 729512 - info@guttadauro.it - web.guttadauro.it
61
13. Elenco Spedizioni Generate Presenti in KSync
Endpoint collaudo:
https://ksync.guttadauro.it/KIPOINT_20_DEBUG/servlet/SQLDataProviderServer/gt
_qry_shipments_soap
Endpoint Produzione:
https://ksync.guttadauro.it/KIPOINT_20/servlet/SQLDataProviderServer/gt_qry_s
hipments_soap
Schema:
https (TLS 1.2)
Method:
POST
Authorization:
None
Header:
Content-Type: text/xml; charset=utf-8
Body:
<soapenv:Envelope xmlns:soapenv=http://schemas.xmlsoap.org/soap/envelope/
xmlns:gt="http://gt_qry_shipments_soap.ws.localhost/">
<soapenv:Header/>
<soapenv:Body>
<gt:gt_qry_shipments_soap_TabularQuery>
<gt:m_UserName>KI266B</gt:m_UserName>
<gt:m_Password>password</gt:m_Password>
<gt:m_Company>001</gt:m_Company>
<gt:pOrdering>[CODE]</gt:pOrdering>
<gt:pPayer>[CODE]</gt:pPayer>
<gt:pReferenceTime>[yyyy-MM-dd]</gt:pReferenceTime>
</gt:gt_qry_shipments_soap_TabularQuery>
</soapenv:Body>
</soapenv:Envelope>
Guttadauro Srl | via F.lli Bandiera, 4 – 21012 - Cassano Magnago (VA)
C.F./Partita IVA/Iscriz. Reg. Imp. VA: n. 01757550122 - R.E.A. VA: n. 205035 - Capitale sociale € 78.000,00 I.V.
T. 0331 729511 - Help Desk 0331 729512 - info@guttadauro.it - web.guttadauro.it
62
Nell’esempio è stata effettuata una chiamata per recuperare la lista dei colli generati dal PV KI226B.
I parametri in ingresso richiesti sono:
pOrdering: Rappresenta il codice cliente Ordinante della spedizione (opzionale).
pPayer: Rappresenta il codice cliente Pagante della spedizione (opzionale).
pReferenceTime: Data Spedizione in formato yyyy-MM-dd (obbligatorio)
Guttadauro Srl | via F.lli Bandiera, 4 – 21012 - Cassano Magnago (VA)
C.F./Partita IVA/Iscriz. Reg. Imp. VA: n. 01757550122 - R.E.A. VA: n. 205035 - Capitale sociale € 78.000,00 I.V.
T. 0331 729511 - Help Desk 0331 729512 - info@guttadauro.it - web.guttadauro.it
63
13.1. Esempio Response Elenco Spedizioni Generate terminato con successo
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<gt_qry_shipments_soap_TabularQueryResponse
xmlns="http://gt_qry_shipments_soap.ws.localhost/">
<Records>

<item>
<CompanyId>KI266B</CompanyId>
<Customer>000001038310</Customer>
<Station>7097I</Station>
<ReferenceTime>2023-11-29T00:00:00+01:00</ReferenceTime>
<Ldv>287097I0****5</Ldv>
<Sticker></Sticker>
<Ordering>00000</Ordering>
<Payer>(default)</Payer>
<TotWeight>0.0</TotWeight>
<Width>0.0</Width>
<Length>0.0</Length>
<Depth>0.0</Depth>
<SenderName>FR******NZIA SRLS</SenderName>
<SenderCountry></SenderCountry>
<SenderAddress>VIA ****** PO 39</SenderAddress>
<SenderPostaCode>74121</SenderPostaCode>
<SenderCity>TARANTO</SenderCity>
<SenderProvince>TA</SenderProvince>
<ReciverName>Fr******oce</ReciverName>
<ReciverCountry></ReciverCountry>
<ReciverAddress>Via ****** 9c</ReciverAddress>
<ReciverPostalCode>88900</ReciverPostalCode>
<ReciverCity>CROTONE</ReciverCity>
<ReciverProvince>KR</ReciverProvince>
</item>

</Records>
</gt_qry_shipments_soap_TabularQueryResponse>
</soap:Body>
Guttadauro Srl | via F.lli Bandiera, 4 – 21012 - Cassano Magnago (VA)
C.F./Partita IVA/Iscriz. Reg. Imp. VA: n. 01757550122 - R.E.A. VA: n. 205035 - Capitale sociale € 78.000,00 I.V.
T. 0331 729511 - Help Desk 0331 729512 - info@guttadauro.it - web.guttadauro.it
64
</soap:Envelope>
I campi
TotWeight
Width
Length
Depth
sono forniti dal servizio OneTracking di PosteItaliane e sono consultabili non
appena disponibili in KSync.