Partijen importeren

Gebruikershandleiding
MijnPost – partijen importeren
5 mei2014
Auteur
PostNL
Rapport
Handleiding partijen importeren
Versie
1.0
Handleiding partijen importeren
Inhoudsopgave
1
Gegevens importeren algemeen
3
2
2.1
2.2
Partijen importeren
Partijen importeren met XML
Partijen importeren met CSV
6
6
10
Handleiding partijen importeren
1
Gegevens importeren algemeen
Het is mogelijk dat u uw partijen initieel niet aanmaakt in MijnPost, maar in een ander systeem. Deze
gegevens kunt u opnemen in een XML-importbe stand en vervolgens kunt u dit importeren in MijnPost.
Het XML-importbe stand kan één of meerdere partijen bevatten, maximaal 250 partije n kunnen in één
bestand worden opgenomen.
Importeren van partijen kan worden gestart met de link in stap 1: “nieuwe partijen importeren uit
bestand’, zoals hieronder getoond.
Klik op de link ‘nieuwe partijen importeren uit bestand’. Het scherm hieronder wordt getoond.
Als de knop 'Bladeren' wordt geselecteerd wordt een standaard Windows 'Kies bestand' venster
geopend waar een bestand geselecteerd kan worden. (Het bestand mag niet groter zijn dan 1mb).
1 Gegevens importeren algemeen
Pagina 3 van 10
Handleiding partijen importeren
Klik op de knop ‘Ga verder’ als het bestand is geselecteerd.
Als de inhoudelijke validatie van een importbestand fouten constateert dan worden die als volgt op het
scherm getoond:
Zolang er fouten geconstateerd worden, zal er niets worden geïmporteerd.
1 Gegevens importeren algemeen
Pagina 4 van 10
Handleiding partijen importeren
Als de inhoudelijke validatie goed gaat, wordt onderstaand scherm getoond.
Selecteer een van de opties om op te slaan en klik op ‘Ga verder’
1 Gegevens importeren algemeen
Pagina 5 van 10
Handleiding partijen importeren
2
Partijen importeren
Via de functie importeren partijen is het mogelijk om bestanden met partij gegevens, die u
wellicht in een ander systeem heeft aangemaakt, te importeren in MijnPost.
U kunt partijen importeren in XML (zie hoofdstuk 2.1) of met een CSV bestand (zie hoofdstuk
2.2).
2.1
Partijen importeren met XML
Het XML-bestand om orders voor partijenpost te importeren, bestaat uit de volgende onderdelen:
de tag <PartijIm port>, deze bevat één of meerdere partijen
de tag <Partij>, deze bevat alle relevante gegevens van een partij
Voorbeeld:
<?xml version="1.0" encoding="iso-8859-1"?>
<PartijImport>
<Partij>
……
</Partij>
<Partij>
……
</Partij>
</PartijIm port>
Deze worden in de volgende paragrafen toegelicht. Bij de verschillende tags is aangegeven of ze
verplicht zijn (J), niet verplicht (N) of verplicht bij sommige producten (A).
Als u na het lezen van deze informatie nog vragen heeft over het importeren van partijen in MijnPost,
dan kunt u hiervoor de service desk bellen: tel 088 8686868.
De tag <partijimport >
De <PartijImport> tag is de roottag van het XML document. Binnen deze tag zijn de te importeren
partijen gedefinieerd als <Partij>-tag s. Elke partij-tag representeert een aparte, te importeren partij. Er
moet minimaal één partij aanwezig zijn om te kunnen importeren.
Tag-naam
Verplicht
Onderdeel van tag
Beschrijving / inhoud
<PartijImport>
J
XML-document
Dit is de verplichte roottag van het XMLdocument. De partijimport tag dient minimaal
te bevatten:
2 Partijen importeren
Pagina 6 van 10
Handleiding partijen importeren
<Partij>
J
PartijImport
<partij> (minimaal één)
Inhoud: partijgegevens, kan één of meerdere
keren voorkomen.
De tag <partij>
Elke partij-tag bevat informatie van een specifieke partij. De mogelijke tags zijn hieronder beschreven
waarbij aangegeven is welke gegevens verplicht en welke optioneel in het importbestand opgenomen
moeten zijn:
J – veld is verplicht in elke partij
N – veld is optioneel
A – veld is voor sommige partijen verplicht
Tag-naam
Verplicht
<Partij>
J
Onderdeel
van tag
PartijImport
<client-id-provide r>
J
Partij
<product-id>
<nr-of-units>
J
J
Partij
Partij
Inhoud: Productnummer
Inhoud: Aantal stuks
<weight-per-unit>
N
Partij
Inhoud: Gewicht per stuk in grammen.
<weight-total>
<franking>
N
J
Partij
Partij
<contract-nr>
A
Partij
<position-nr>
A
Partij
Inhoud: Totaalgewicht in grammen.
Inhoud: Frankeeraanduiding in twee letters, deze kan
de volgende waarden hebben:
PB (Port Betaald)
FM (FrankeerMachine)
PZ (PostZegels)
FR (FRanco)
Inhoud: Contractnummer, is verplicht voor (niet
openbare) producten waarvoor de klant een contract
heeft met PostNL. In MijnPost in scherm nieuwe partij
invoeren kunt u zien welke contractnummers bij welke
producten geldig zijn. Dit wordt zichtbaar nadat u (in
het scherm) het productnummer ingevoerd heeft.
Inhoud: Positienummer (= regelnummer van het
contract), dit staat achter het contractnummer in het
scherm invoeren nieuwe partij.
Indien het contractnumme r gevuld is, moet het
positienummer ook gevuld zijn.
2 Partijen importeren
Pagina 7 van 10
Beschrijving
De partij-tag bevat alle verplichte en optionele
gegevens per partij.
Het kan de hieronder opgenomen gegevens bevatten.
Inhoud: Het klantnummer waarop de partij wordt
aangeboden
Handleiding partijen importeren
In MijnPost in scherm nieuwe partij invoeren kunt u
zien welke contractnum mers en positienummers bij
welke producten geldig zijn. Dit wordt zichtbaar nadat
u (in het scherm) het productnummer ingevoerd
heeft.
Inhoud: Machtigingsnumm er bij product periodieken,
verplicht voor periodieken.
<authorization-nr>
N
Partij
<edition>
<country>
A
A
Partij
Partij
Inhoud: Editienummer, verplicht voor periodieken.
Inhoud: Landcode (2 letters conform ISO-landencode)
Is verplicht voor alle producten naar het buitenland.
Als landcode gevuld is, dan hoeft zone niet gevuld te
worden.
Als landcode niet gevuld is wordt NL gehanteerd.
Zie paragraaf “2.3 Lijst met zone- en landcodes” met
alle landcodes per product.
<zone>
A
Partij
<description>
J
Partij
Inhoud: Zone.
Per product zijn er verschillende zones mogelijk zoals
002 = Europa
003 = Buiten Europa
Als landcode gevuld is, dan hoeft zone niet gevuld te
worden.
Zie paragraaf “2.3 Lijst met zone- en landcodes” met
alle zonecodes per product.
Inhoud: omschrijving van de partij (waarde van het
eerste ingestelde veld voor een partij)
<costcentre-code>
A
Partij
<reference-number>
A
Partij
<aanbieddatum>
J
Partij
2 Partijen importeren
Pagina 8 van 10
Inhoud: kostenplaats van de partij (waarde van het
tweede ingestelde veld voor een partij). Dit veld is
verplicht als dit gegeven in MijnPost voor uw
klantnummer is ingesteld.
Inhoud: referentienummer (waarde van het derde
ingestelde veld voor een partij) van de partij. Dit veld
is verplicht als dit gegeven in MijnPost voor uw
klantnummer is ingesteld.
Inhoud: verzenddatum. Deze moet groter of gelijk aan
de huidige datum zijn. Format: jjjj-mm-dd
Handleiding partijen importeren
Voorbeeld
Een importbestand in xml kan er als volgt uitzien:
<?xml version="1.0" encoding="iso-8859-1"?>
<PartijImport>
<Partijen>
<Partij>
<client-id-provide r>9915811 </client-id-provide r>
<product-id>1600</product-id>
<nr-of-units>400</nr-of-units>
<weight-per-unit>10</weight-per-unit>
<weight-total>4000</we ight-total>
<franking>PB</franking>
<country>NL</country>
<description>Import partij 1</description>
<costcentre-code>111</costcentre-code>
<reference-number>test</refe rence-numbe r>
<aanbieddatum>2011 -03-09</aanbieddatum >
</Partij>
<Partij>
<client-id-provide r>9915811 </client-id-provide r>
<product-id>6100</product-id>
<nr-of-units>399</nr-of-units>
<weight-per-unit>22</weight-per-unit>
<weight-total></we ight-total>
<franking>PB</franking>
<authorization-nr></authorization-nr>
<edition></edition>
<contract-nr>45011299</contract-nr>
<position-nr>50</position-nr>
<country>BE</country>
<zone></zone>
<description>Import partij 2</description>
<costcentre-code>112</costcentre-code>
<reference-number>test</refe rence-numbe r>
<aanbieddatum>2011 -03-09</aanbieddatum >
</Partij>
</Partijen>
</PartijIm port>
2 Partijen importeren
Pagina 9 van 10
Handleiding partijen importeren
2.2
Partijen importeren met CSV
Het csv bestand moet komma gescheiden zijn. Verder gelden dezelfde eisen m.b.t. vereist en
omschrijving van ‘kopjes’ (tags in xml) als hierboven is beschreven. Hieronder een voorbeeld hoe csv
eruit kan zien.
2.3
Lijst met zone- en landcodes
Als u het bestand hieronder opent (dubbelklik op icoontje), wordt een Excel bestand geopend met
daarin drie tabbladen: “Zone”, “Landcode per product” en “Landcode”.
Dit bestand kunt u gebruiken om de juiste zonecode of landcode op te zoeken voor importeren van een
zending naar buitenland. Het kan zijn dat u voor een bepaald product een contract heeft waardoor een
kleinere set van landen van toepassing is dan in de lijst wordt getoond. De landen zijn wel altijd een
subset van de landen die in de lijst worden genoemd. Het gaat om de volgende productcodes:
5910
5911
5912
5913
5914
5915
5918
5960
5961
2 Partijen importeren
Pagina 10 van 10
6475
6800
6930
6931
6932
6933
6934
6935

Download Report