XML Importeercodes voor Parcelware Desktop en Web. PostNL Pakketten

Transcriptie

1 XML Importeercodes voor Parcelware Desktop en Web PostNL Pakketten

2 Inhoudsopgave 1 INLEIDING BELANGRIJKE AANWIJZINGEN ZENDINGCONFIGURATIE BESCHRIJVING VAN DE INTERFACES POSTNL PostNL Pakketten Zendingconfiguratie Product- en dienstcodes Pakketten Vracht (pallet) Checkpay, Online en Offline Code Validatie...18 XML Importeercodes voor Parcelware /20

3 1 Inleiding Bedankt dat u gekozen hebt voor Parcelware, de moderne en flexibele software voor distributielogistiek van PostNL Pakketten. 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 Parcelware. Veel verzendgemak gewenst! Het Parcelware Team PostNL Pakketten XML Importeercodes voor Parcelware /20

4 2 Belangrijke aanwijzingen Deze handleiding beschrijft hoe gegevensbestanden afkomstig van externe systemen vorm dienen te worden gegeven om goed ingelezen te kunnen worden door Parcelware. 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 het importeren gebruikt. 2.1 Zendingconfiguratie De configuratie van een zending (producten en diensten) bestaat uit XML-elementen. Deze elementen hebben het volgende formaat: <item id="..."/> <item id="..."/> <item id="..."/> 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: 5 <attributes> <DutyDocuments> <DutyEntries> <DutyEntry> <ContentDescription> Clothes </ContentDescription> <Quantity> 2 </Quantity> <NettoWeight> 4 </NettoWeight> <CountryISOCodeNum> 51 </CountryISOCodeNum> XML Importeercodes voor Parcelware /20

5 <HSTariffNumber> 1 </HSTariffNumber> <DutyValue> 10 </DutyValue> </DutyEntry> </DutyEntries> <HandleNonDeliverable> true </HandleNonDeliverable> <SendDate> </SendDate> <Kind> CommercialSample </Kind> <Invoice> i1234 </Invoice> <Certificate> c5678 </Certificate> <Licence> L9012 </Licence> </DutyDocuments> </attributes> De beschrijving van het contract geeft aan voor welke producten en diensten specifieke XMLgegevens 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: "<item id=""311101""><weight >5<item id=""311106"" value=""1000""/><item id=""311108""/>" XML Importeercodes voor Parcelware /20

6 3 Beschrijving van de interfaces 3.1 PostNL 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 PostNL Pakketten Contract PostNL Pakketten PostNL Pakketten Zendingconfiguratie Product- en dienstcodes De volgende tabel geeft aan welke codes aan welke producten zijn toegewezen: ID Product Pakket Pallet De volgende tabel geeft aan welke codes aan welke diensten zijn toegewezen: ID Service Rembours Verhoogd aansprakelijk Handtekening voor ontvangst Retour bij geen gehoor Alleen huisadres PakjeGemak SMS Afhaalservice Plus Afhaalservice Basis Postkamer XML Importeercodes voor Parcelware /20

7 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 Standaard/EPS Voor Pakketten worden het gewicht, de inhoud en het aantal stuks vermeld als substructuur onder het element pakket. <item id="311108"/> In de bovenstaande configuratie gaat het om een zending (Pakket) van TNT Post Pakketservice bestaande uit één pakket met een gewicht van kg, inhoudende kleding. Een vergelijkbare zending bestaande uit twee pakketten (kg en 5,4kg) wordt als volgt gedefinieerd: 5,4 fruits XML Importeercodes voor Parcelware /20

8 <item id="311108"/> 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. TotalWeight 4,0 <Count>1</Count> <item id="311108"/> 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. PackageWeight 4,0 <Count>1</Count> <item id="311108"/> XML Importeercodes voor Parcelware /20

9 Hieronder vindt u een tabel met de beschrijving van de diverse elementen van de structuur: Element ParcelWeight EvaluatorWorkMode Pieces TNTPiece Weight Content Count CODAttribute Beschrijving Na deze code volgt informatie over het Pakket. Hier zijn drie waarden mogelijk:, PackageWeight and TotalWeight (= gewicht per stuk, gewicht pakket en totaal gewicht Dit element bevat de gegevens over het pakket 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). Gewicht in kg Beschrijving van de inhoud Aantal pakketten bij gebruik van PackageWeight of TotalWeight. Standaard staat deze waarde op 1. 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 XML Importeercodes voor Parcelware /20

10 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: <item id="311105" value="100,00"> <CODAttribute> <UseBarcodeInKenmerk> True </UseBarcodeInKenmerk> <Kenmerk> </Kenmerk> </CODAttribute> <item id="311106" value="500,00"/> 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. XML Importeercodes voor Parcelware /20

11 Een dergelijk configuratie ziet er als volgt uit: <item id="311108"/> <attributes> <OwnBarcode> <Barcode> </Barcode> </OwnBarcode> </attributes> Element Attributes OwnBarcode Barcode Beschrijving Een element met aanvullende informatie over de zending Een element met informatie over eigen barcodenummer Barcodenummer Global Pack Voor Global Pack P ack zendingen moet informatie over invoerrechten en douanedocumenten worden gegeven: 11,5 <attributes> <DutyDocuments> <DutyEntries> <DutyEntry> <ContentDescription> </ContentDescription> <Quantity> 12 </Quantity> <NettoWeight> 9 </NettoWeight> <CountryISOCodeNum> XML Importeercodes voor Parcelware /20

12 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> </SendDate> <Kind> CommercialSample </Kind> <Invoice> i1234 </Invoice> <Certificate> c5678 </Certificate> <Licence> L9012 </Licence> </DutyDocuments> </attributes> 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. 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 De zending mag niet als onbestelbaar worden behandeld. Hieronder vindt u een tabel met de beschrijving van de diverse elementen van de structuur: XML Importeercodes voor Parcelware /20

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

14 <item id="311132"/> In het geval dat het een SMS service betreft, kan deze service gespecificeerd worden als item in onderstaande structuur: <item id="311132"/> <item id="311133"/> Hieronder vindt u een tabel met de beschrijving van de diverse elementen van de structuur: Element ParcelWeight EvaluatorWorkMode Pieces TNTPiece Weight Content Description Na deze code volgt informatie over het Pakket. Constante waarde: Dit element bevat de gegevens over het pakket 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). Gewicht in kg Beschrijving van de inhoud Afhaalservice Plus Voor Afhaalservice Plus moet het afhaaladres worden ingevoerd in een substructuur onder het element pickup : XML Importeercodes voor Parcelware /20

15 <item id="311122"> <PickupPLUSAddress> <Name1> Adam </Name1> <Name2> Mortenseen </Name2> <Street> Damrak </Street> <HomeNr> 12 </HomeNr> <HomeExt> -12 </HomeExt> <ISOCode> 528 </ISOCode> <ZIP> 1012 LG </ZIP> <City> Amsterdam </City> <PickupDate> </PickupDate> </PickupPLUSAddress> 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 XML Importeercodes voor Parcelware /20

16 Pick up Basis Voor Afhaalservice Basis moet het afhaaladres worden ingevoerd in een substructuur onder het element pickup : TotalWeight <item id="311123"> <PickupBasisAddress> <Name1> Adam </Name1> <Name2> Mortenseen </Name2> <Street> Damrak </Street> <HomeNr> 12 </HomeNr> <HomeExt> -15 </HomeExt> <ISOCode> 528 </ISOCode> <ZIP> 1012 LG </ZIP> <City> Amsterdam </City> <PickupDate> </PickupDate> </PickupBasisAddress> XML Importeercodes voor Parcelware /20

17 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 Vracht (pallet) Voor Pallet zendingen wordt het gewicht als volgt in een substructuur ingevoerd: <item id="311114"> <FreightPalletWeight> 100 tools </FreightPalletWeight> Voor Stukgoed zendingen wordt het gewicht als volgt in een substructuur ingevoerd: <item id="311116"> <FreightPalletWeight> </FreightPalletWeight> XML Importeercodes voor Parcelware /20

18 Hieronder vindt u een tabel met de beschrijving van de diverse elementen van de substructuur: Element FreightPalletWeight EvaluatorWorkMode Pieces TNTPiece Weight Content Beschrijving Dit element bevat het gewicht van de vrachtzending. Constante waarde: Dit element bevat de gegevens over het pakket 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). Gewicht in kg Beschrijving van de inhoud Checkpay,, Online en Offline Code Validatie Hieronder vindt u een tabel met de beschrijving van de diverse elementen van de substructuur: Element Description ParcelWeight EvaluatorWorkMode Pieces TNTPiece Weight Content Information that Parcel specification follows. Constant value: An element enclosing parcels data Data for one parcel. If you need to specify multiple parcels, use the TNTPiece -structure (containing all needed sub-elements) multiple times. Weight in kilograms Description of parcel s content Checkpay In het geval van een Checkpay - zending worden het remboursbedrag aangegeven in het desbetreffende element. Bij wijze van voorbeeld ziet de volledige configuratie van een zending bestaande uit één pakje, met een bedrag van 100,- er als volgt uit: <item id="311108"/> <item id="311117" value="100,00"> <Order> <OrderNumber> </OrderNumber> XML Importeercodes voor Parcelware /20

19 </Order> <Transaction> <TransactionNumber> </TransactionNumber> </Transaction> Hieronder vindt u een tabel met de beschrijving van de diverse elementen van de substructuur: Element Order OrderNumber Transaction TransactionNumber Description Dit element bevat de gegevens voor Order Order nummer Dit element bevat de gegevens voor Transaction Transaction nummer XML Importeercodes voor Parcelware /20

20 Code Validatie Voor Code Validatie zendingen wordt het gewicht als volgt in een substructuur ingevoerd: <item id="311108"/> <item id="311119"> <Order> <OrderNumber> </OrderNumber> </Order> XML Importeercodes voor Parcelware /20