Parcelware

Structuur Databestanden

Versie 1.29, Revisiedatum 04-04-2007

Inhoudsopgave
1 INLEIDING .......................................................................................................... 3
2 BELANGRIJKE AANWIJZINGEN ...................................................................... 4
2.1 ZENDINGCONFIGURATIE ................................................................................... 4
3 BESCHRIJVING VAN DE INTERFACES ........................................................... 6
3.1 TNT .............................................................................................................. 6
3.1.1 TNT Post Pakketservice ........................................................................ 6
3.1.1.1 Zendingconfiguratie ....................................................................... 6
3.1.1.1.1 Product- en dienstcodes ............................................................. 6
3.1.1.1.2 Pakketten .................................................................................... 7
3.1.1.1.3 Vracht (pallet) ........................................................................... 15

Parcelware Data Structures version 1.29 14.05.2007 14.05.2007 2/16

1 Inleiding

Bedankt dat u gekozen hebt voor Parcelware, de moderne en flexibele software voor
distributielogistiek van XLogics GmbH.

In deze handleiding krijgt u een uitleg over de belangrijkste informatie over de

samenstelling en de structuur van externe gegevensbestanden voor de import in en
export uit het Parcelware-systeem.

We wensen u veel succes en genoegen in het gebruik van de applicatie en hopen op

een goede en constructieve samenwerking.

Het XLogics-team

Parcelware Data Structures version 1.29 14.05.2007 14.05.2007 3/16

2 Belangrijke aanwijzingen
Deze handleiding beschrijft hoe gegevensbestanden afkomstig van externe
systemen vorm dienen te worden gegeven om goed ingelezen te kunnen worden
door het Parcelware-systeem. Er is gekozen voor XML omdat dit bestandsformaat
een grote mate van flexibiliteit biedt. Dit betekent dat een toekomstige uitbreiding of
aanpassing van de gegevensstructuur (zoals nieuwe contracten of labels) geen
probleem zal opleveren.

Voor Zendingconfiguratie dient u het onderstaande formaat te gebruiken als de

gegevens als XML-bestand worden gegeven. Deze configuratiegegevens worden
voor de polling gebruikt..

2.1 Zendingconfiguratie

De configuratie van een zending (producten en diensten) bestaat uit XML-elementen.

Deze elementen hebben het volgende formaat:

<items>
<item id="..."/>
<item id="..."/>
<item id="..."/>
…
</items>

Sommige soorten zendingen hebben een bepaalde waarde. Deze wordt dan als volgt
aangegeven:

<item id="331105" value="123"/>

Voor sommige producten en diensten is aanvullende informatie vereist, bijvoorbeeld:

<items>
<item id="311101">
<ParcelWeight>
<Weight>
5
</Weight>
</ParcelWeight>
</item>
<attributes>
<DutyDocuments>
<DutyEntries>
<DutyEntry>
<ContentDescription>
Clothes
</ContentDescription>
<Quantity>
2
</Quantity>
<NettoWeight>
4

Parcelware Data Structures version 1.29 14.05.2007 14.05.2007 4/16

 </NettoWeight>
<CountryISOCodeNum>
51
</CountryISOCodeNum>
<HSTariffNumber>
1
</HSTariffNumber>
<DutyValue>
10
</DutyValue>
</DutyEntry>
</DutyEntries>
<HandleNonDeliverable>
true
</HandleNonDeliverable>
<SendDate>
2006-04-13
</SendDate>
<Kind>
CommercialSample
</Kind>
<Invoice>
i1234
</Invoice>
<Certificate>
c5678
</Certificate>
<Licence>
L9012
</Licence>
</DutyDocuments>
</attributes>
</items>

De beschrijving van het contract geeft aan voor welke producten en diensten
specifieke XML-gegevens vereist zijn.

2.2 CSV opmerkingen

De xml regel dient bij CSV formaat tussen Quotes (") geplaatst worden.
Items Id in elke xml regel dient tussen dubbele Quotes's ("") geplaatst
te worden:
"<items><item
id=""311101""><ParcelWeight><EvaluatorWorkMode>IndividualWeight</EvaluatorWorkMode>
<Pieces><TNTPiece><Weight>5</Weight></TNTPiece></Pieces></ParcelWeight></item><item
id=""311106"" value=""1000""/><item id=""311108""/></items>"

Parcelware Data Structures version 1.29 14.05.2007 14.05.2007 5/16

3 Beschrijving van de interfaces
3.1 TNT

Contracten worden bij naam geïdentificeerd. Deze naam wordt bepaald op het
moment dat het contract wordt geconfigureerd. De volgende tabel geeft de relaties
aan tussen de standaard benaming en de contractnaam:

Naam Contract
TNT Post Pakketservice TNT Post Pakketservice

3.1.1 TNT Post Pakketservice

3.1.1.1 Zendingconfiguratie

3.1.1.1.1 Product- en dienstcodes

De volgende tabel geeft aan welke codes aan welke producten zijn toegewezen:

ID Product
311101 Pakket
311114 Pallet

De volgende tabel geeft aan welke codes aan welke diensten zijn toegewezen:

ID Service
311103 Pakket met Handtekening Retour
311104 Contract Pakket
311105 Rembours
311106 Verhoogd aansprakelijk
311107 Handtekening voor ontvangst
311108 Retour bij geen gehoor
311109 Alleen huisadres
311111 EPS Light
311132 PakjeGemak
311122 Afhaalservice Plus
311123 Afhaalservice Basis

Parcelware Data Structures version 1.29 14.05.2007 14.05.2007 6/16

3.1.1.1.2 Pakketten

Onder pakketten vallen de producten: Standaard, EPS en Global Pack. Het product
wordt automatisch gekozen op basis van het land van bestemming.
Afhaalservice Basis en Plus zijn aanvullende diensten voor Pakketten.

3.1.1.1.2.1 Standaard/EPS

Voor Pakketten worden het gewicht, de inhoud en het aantal stuks vermeld als
substructuur onder het element “pakket”.

<items>
<item id="311101">
<ParcelWeight>
<EvaluatorWorkMode>
IndividualWeight
</EvaluatorWorkMode>
<Pieces>
<TNTPiece>
<Weight>
3,4
</Weight>
<Content>
clothes
</Content>
</TNTPiece>
</Pieces>
</ParcelWeight>
</item>
<item id="311108"/>
</items>

In de bovenstaande configuratie gaat het om een zending (Pakket) van TNT Post
Pakketservice bestaande uit één pakket met een gewicht van 3,4kg, inhoudende
kleding. Een vergelijkbare zending bestaande uit twee pakketten (3,4kg en 5,4kg)
wordt als volgt gedefinieerd:

<items>
<item id="311101">
<ParcelWeight>
<EvaluatorWorkMode>
IndividualWeight
</EvaluatorWorkMode>
<Pieces>
<TNTPiece>
<Weight>
3,4
</Weight>
<Content>
clothes
</Content>
</TNTPiece>
<TNTPiece>
<Weight>
5,4
</Weight>
<Content>
fruits

Parcelware Data Structures version 1.29 14.05.2007 14.05.2007 7/16

 </Content>
</TNTPiece>
</Pieces>
</ParcelWeight>
</item>
<item id="311108"/>
</items>

Voor EvaluatorWorkMode (zie voor een beschrijving van de diverse elementen

onderstaande tabel) zijn ook andere waarden mogelijk. In het volgende voorbeeld
wordt gebruik gemaakt van TotalWeight (=totaal gewicht). Het element Pieces (=
stuks) wordt hier dan niet gebruikt. De elementen Weight, Count, Content kunnen dan wel
worden gebruikt, maar niet als subelementen van TNTPiece.

<items>
<item id="311101">
<ParcelWeight>
<EvaluatorWorkMode>
TotalWeight
</EvaluatorWorkMode>
<Weight>4,0</Weight>
<Count>1</Count>
<Content>clothes</Content>
</ParcelWeight>
</item>
<item id="311108"/>
</items>

In het volgende voorbeeld wordt gebruikt gemaakt van het element PackageWeight.
Het element Pieces wordt hier dan niet gebruikt. De elementen Weight, Count, Content
kunnen wel worden gebruikt, maar niet als subelementen van TNTPiece.

<items>
<item id="311101">
<ParcelWeight>
<EvaluatorWorkMode>
PackageWeight
</EvaluatorWorkMode>
<Weight>4,0</Weight>
<Count>1</Count>
<Content>clothes</Content>
</ParcelWeight>
</item>
<item id="311108"/>
</items>

Hieronder vindt u een tabel met de beschrijving van de diverse elementen van de
structuur:

Parcelware Data Structures version 1.29 14.05.2007 14.05.2007 8/16

Element Beschrijving
ParcelWeight Na deze code volgt informatie over het Pakket.
EvaluatorWorkMode Hier zijn drie waarden mogelijk: IndividualWeight, PackageWeight and
TotalWeight (= gewicht per stuk, gewicht pakket en totaal gewicht
Pieces Dit element bevat de gegevens over het pakket
TNTPiece De gegevens voor één pakket. Om gegevens over meerdere pakketten van
één zending in te voeren gebruikt u meerdere malen de structuur TNTPiece
(die alle nodige subelementen bevat).
Weight Gewicht in kg
Content Beschrijving van de inhoud
Count Aantal pakketten bij gebruik van PackageWeight of TotalWeight. Standaard
staat deze waarde op 1.
CODAttribute Een element waarin aanvullende remboursgegevens worden aangegeven
UseBarcodeInKenmerk U gebruikt de waarde True wanneer Parcelware de barcode in het
rembourskenmerk veld dient te plaatsen. Parcelware overschrijft elke waarde
die in dit veld staat.
Kenmerk Rembourskenmerk

In het geval van een Rembours-zending en/of Verhoogd aansprakelijk worden het
remboursbedrag of het verzekerd bedrag aangegeven in het desbetreffende element.
Bij wijze van voorbeeld ziet de volledige configuratie van een zending bestaande uit
één pakje, met een remboursbedrag van € 100,- en een verzekerde waarde van
€ 500,- er als volgt uit:

<items>
<item id="311101">
<ParcelWeight>
<EvaluatorWorkMode>
IndividualWeight
</EvaluatorWorkMode>
<Pieces>
<TNTPiece>
<Weight>
3,4
</Weight>
<Content>
clothes
</Content>
</TNTPiece>
</Pieces>
</ParcelWeight>
</item>
<item id="311105" value="100,00">
<CODAttribute>
<UseBarcodeInKenmerk>
True
</UseBarcodeInKenmerk>
<Kenmerk>
12345678
</Kenmerk>
</CODAttribute>
</item>
<item id="311106" value="500,00"/>
</items>

Wanneer het contract (Mijn Contractgegevens) het gebruik van eigen

barcodenummer toelaat, dan is het mogelijk om een eigen barcodenummer in het
importbestand op te nemen.

Parcelware Data Structures version 1.29 14.05.2007 14.05.2007 9/16

Een dergelijk configuratie ziet er als volgt uit:

<items>
<item id="311101">
<ParcelWeight>
<EvaluatorWorkMode>
IndividualWeight
</EvaluatorWorkMode>
<Pieces>
<TNTPiece>
<Weight>
3,4
</Weight>
<Content>
clothes
</Content>
</TNTPiece>
</Pieces>
</ParcelWeight>
</item>
<item id="311108"/>
<attributes>
<OwnBarcode>
<Barcode>123456789</Barcode>
</OwnBarcode>
</attributes>
</items>

Element Beschrijving
Attributes Een element met aanvullende informatie over de zending
OwnBarcode Een element met informatie over eigen barcodenummer
Barcode Barcodenummer

3.1.1.1.2.2 Global Pack

Voor Global Pack–zendingen moet informatie over invoerrechten en

douanedocumenten worden gegeven:

<items>
<item id="311101">
<ParcelWeight>
<Weight>
11,5
</Weight>
</ParcelWeight>
</item>
<attributes>
<DutyDocuments>
<DutyEntries>
<DutyEntry>
<ContentDescription>
clothes
</ContentDescription>
<Quantity>
12
</Quantity>
<NettoWeight>

Parcelware Data Structures version 1.29 14.05.2007 14.05.2007 10/16

 9
</NettoWeight>
<CountryISOCodeNum>
528
</CountryISOCodeNum>
<HSTariffNumber>
111/234
</HSTariffNumber>
<DutyValue>
100
</DutyValue>
</DutyEntry>
<DutyEntry>
<ContentDescription>
books
</ContentDescription>
<Quantity>
1
</Quantity>
<NettoWeight>
1,5
</NettoWeight>
<CountryISOCodeNum>
528
</CountryISOCodeNum>
<HSTariffNumber>
333/456
</HSTariffNumber>
<DutyValue>
10
</DutyValue>
</DutyEntry>
</DutyEntries>
<HandleNonDeliverable>
False
</HandleNonDeliverable>
<SendDate>
2006-04-13
</SendDate>
<Kind>
CommercialSample
</Kind>
<Invoice>
i1234
</Invoice>
<Certificate>
c5678
</Certificate>
<Licence>
L9012
</Licence>
</DutyDocuments>
</attributes>
</items>

De XML-code hierboven beschrijft één Global Pack-zending met een gewicht van
11,5 kg, bevattende twee soorten goederen:
- 12 kledingstukken: gewicht van 9 kg, verzonden vanuit Nederland met een
douanewaarde van € 100,-, HS-tarief nr. 111/234
- 1 boek: gewicht van 1,5kg, verzonden vanuit Nederland, met een
douanewaarde van € 10,-, HS-tarief nr. 333/456.

Parcelware Data Structures version 1.29 14.05.2007 14.05.2007 11/16

Het gaat in dit voorbeeld om monsters. Het factuurnummer is i1234, het
certificaatnummer is c5678 en het vergunningnummer is L9012. De verzenddatum
van deze zending is 2006-04-13. De zending mag niet als onbestelbaar worden
behandeld.

Hieronder vindt u een tabel met de beschrijving van de diverse elementen van de
structuur:

Element Beschrijving
DutyDocuments Dit element bevat de douane-informatie
DutyEntries Dit element bevat de gegevens voor de invoerrechten voor de (diverse
soorten) goederen
DutyEntry Dit element bevat de gegevens voor de invoerrechten van de
(afzonderlijke soorten) goederen
ContentDescription Beschrijving van de inhoud t.b.v. de invoerrechten
Quantity Aantal stuks t.b.v. invoerrechten
NettoWeight Nettogewicht in kg t.b.v. de invoerrechten
CountryISOCodeNum ISO-code land van oorsprong t.b.v. de invoerrechten
HSTariffNumber Nr. HS-tarief t.b.v. de invoerrechten
DutyValue Douanewaarde t.b.v. de invoerrechten
HandleNonDeliverable Informatie over de behandeling van de zending
Waarde Betekenis
“true” Zendingen mogen als onbestelbaar worden
behandeld
“false” Zending mogen niet als onbestelbaar worden
behandeld
SendDate Datum van verzending van de zending
Kind Soort pakket. Mogelijke waarden zijn uitsluitend:
Waarde Soort pakket
Gift Geschenk
Documents Documenten
CommercialGoods Handelsgoederen
CommercialSample Monsters
ReturnedGoods Retourgoederen
Invoice Nummer factuur (indien er sprake is van een factuur)
Certificate Nummer certificaat (indien er sprake is van een certificaat)
Licence Nummer vergunning (indien er sprake is van een vergunning)

3.1.1.1.2.3 PakjeGemak

Voor Pakjegemak, worden het gewicht en de inhoud vermeld als substructuur onder
het element “pakket”.

<items>
<item id="311101">
<ParcelWeight>
<EvaluatorWorkMode>
IndividualWeight
</EvaluatorWorkMode>
<Pieces>
<TNTPiece>
<Weight>
3,4
</Weight>
<Content>
clothes
</Content>
</TNTPiece>
</Pieces>

Parcelware Data Structures version 1.29 14.05.2007 14.05.2007 12/16

 </ParcelWeight>
</item>
<item id="311132"/>
</items>

Hieronder vindt u een tabel met de beschrijving van de diverse elementen van de
structuur:

Element Description
ParcelWeight Na deze code volgt informatie over het Pakket.
EvaluatorWorkMode Constante waarde: IndividualWeight
Pieces Dit element bevat de gegevens over het pakket
TNTPiece De gegevens voor één pakket. Om gegevens over meerdere pakketten van één
zending in te voeren gebruikt u meerdere malen de structuur TNTPiece (die alle
nodige subelementen bevat).
Weight Gewicht in kg
Content Beschrijving van de inhoud

3.1.1.1.2.4 Afhaalservice Plus

Voor Afhaalservice Plus moet het afhaaladres worden ingevoerd in een

substructuur onder het element “pickup”:

<items>
<item id="311101">
<ParcelWeight>
<EvaluatorWorkMode>
IndividualWeight
</EvaluatorWorkMode>
<Pieces>
<TNTPiece>
<Weight>
3,4
</Weight>
<Content>
clothes
</Content>
</TNTPiece>
</Pieces>
</ParcelWeight>
</item>

<item id="311122">
<PickupPLUSAddress>
<Name1>
Adam
</Name1>
<Name2>
Mortenseen
</Name2>
<Street>
Damrak
</Street>
<HomeNr>
12
</HomeNr>
<HomeExt>
-12
</HomeExt>
<ISOCode>

Parcelware Data Structures version 1.29 14.05.2007 14.05.2007 13/16

 528
</ISOCode>
<ZIP>
1012 LG
</ZIP>
<City>
Amsterdam
</City>
<PickupDate>
10052006
</PickupDate>
</PickupPLUSAddress>
</item>
</items>

Hieronder vindt u een tabel met de beschrijving van de diverse elementen van de
structuur:

Element Beschrijving
PickupPLUSAddress Dit element bevat de gegevens voor Afhaalservice Plus.
Name1 Afhaaladres Naam 1
Name2 Afhaaladres Naam 2
Street Afhaaladres Straat
HomeNr Afhaaladres Huisnummer
HomeExt Afhaaladres Huisnummertoevoeging
ISOCode Afhaaladres ISO-code land
ZIP Afhaaladres Postcode
City Afhaaladres Plaats
PickupDate Datum afhalen

3.1.1.1.2.5 Pick up Basis

Voor Afhaalservice Basis moet het afhaaladres worden ingevoerd in een

substructuur onder het element “pickup”:

<items>
<item id="311101">
<ParcelWeight>
<EvaluatorWorkMode>
TotalWeight
</EvaluatorWorkMode>
<Weight>
3,4
</Weight>
<Content>
clothes
</Content>
</ParcelWeight>
</item>

<item id="311123">
<PickupBasisAddress>
<Name1>
Adam
</Name1>
<Name2>
Mortenseen
</Name2>
<Street>
Damrak

Parcelware Data Structures version 1.29 14.05.2007 14.05.2007 14/16

 </Street>
<HomeNr>
12
</HomeNr>
<HomeExt>
-15
</HomeExt>
<ISOCode>
528
</ISOCode>
<ZIP>
1012 LG
</ZIP>
<City>
Amsterdam
</City>
<PickupDate>
10052006
</PickupDate>
</PickupBasisAddress>
</item>
</items>

Hieronder vindt u een tabel met de beschrijving van de diverse elementen van de
structuur:

Element Beschrijving
PickupBasisAddress Dit element bevat de gegevens voor Afhaalservice Basis.
Name1 Afhaaladres Naam 1
Name2 Afhaaladres Naam 2
Street Afhaaladres Straat
HomeNr Afhaaladres Huisnummer
HomeExt Afhaaladres Huisnummertoevoeging
ISOCode Afhaaladres ISO-code land
ZIP Afhaaladres Postcode
City Afhaaladres Plaats
PickupDate Datum afhalen

3.1.1.1.3 Vracht (pallet)

Voor Vracht-zendingen wordt het gewicht als volgt in een substructuur ingevoerd:

<items>
<item id="311114">
<FreightPalletWeight>
<Weight>
5
</Weight>
</FreightPalletWeight>
<ContentPallet>
<Content>
Clothes
</Content>
</ContentPallet>
</item>
</items>

Hieronder vindt u een tabel met de beschrijving van de diverse elementen van de
substructuur:

Parcelware Data Structures version 1.29 14.05.2007 14.05.2007 15/16

Element Beschrijving
FreightPalletWeight Dit element bevat het gewicht van de vrachtzending.
Weight Gewicht in kg
ContentPallet Dit element bevat informatie over de inhoud.
Content Beschrijving van de inhoud.

Parcelware Data Structures version 1.29 14.05.2007 14.05.2007 16/16