Dit artikel bevat de technische details van het XML-bestand dat vervoerders op de SFTP plaatsen om de bezorgstatus van een bestelling in Paazl bij te werken. Het bestand moet Paazl-bezorgstatussen bevatten en de unieke identificatie voor pakketten is de barcode zoals gecommuniceerd via het registratiebestand.
Het bestand kan op elk moment door de vervoerder worden geplaatst; Paazl controleert de SFTP-map elke 30 minuten op activiteit. Afhankelijk van de configuratie van jouw webshop kun je de bestellingsupdates gebruiken om jouw klanten te informeren over de actuele bezorgstatus van het pakket.
Formaat van bestandsnaam
Er zijn geen vereisten voor de bestandsnaam. Paazl verwerkt alle bestanden die door de vervoerder in de SFTP-map worden geplaatst.
Elementspecificaties
| Element | Type | Verplicht? | Omschrijving |
|---|---|---|---|
statuses | Complex element | Verplicht | Bevat informatie over de bezorgstatussen van de verschillende zendingen waaruit een bestelling bestaat. |
status | Complex element | Verplicht | Bevat informatie over de bezorgstatus van een zending in een bestelling. |
timestamp | dateTime | Verplicht | De tijd waarop de bezorgstatus van een zending is geregistreerd. Optioneel kun je de oorspronkelijke tijdzone opnemen, uitgedrukt als een afwijking (offset) ten opzichte van UTC. Bijvoorbeeld: 2019-03-27T15:11:11 in New York (EDT) wordt dan 2019-03-27T15:11:11-04:00. |
barcode | String | Verplicht | De barcode die een vervoerder toekent aan een verzendbestelling. |
trackingURL | String | Optioneel | De trackinglink die door de vervoerder wordt gegenereerd. Kan worden gebruikt om de bestelling te volgen. |
carrierStatus | String | Optioneel | De code van de bezorgstatus van een zending, zoals verstrekt door de vervoerder. |
carrierStatusDescription | String | Optioneel | De omschrijving van de bezorgstatus van een zending, zoals verstrekt door de vervoerder. |
status | statusType | Verplicht | De Paazl-bezorgstatuscode voor een zending. Zie About Paazl delivery status codes voor de betekenis van de verschillende codes. |
town | String | Optioneel | De stad of plaats van het adres waarnaar een bestelling wordt verzonden. |
country | String | Optioneel | De ISO 3166-2-code voor het land van het adres waarnaar een bestelling wordt verzonden. |
deliveryInformation | String | Optioneel | Aanvullende informatie over de status van een bezorging. |
deliveryWindowFrom | time | Optioneel | De start van het bezorgtijdvenster van een specifieke verzendoptie. |
deliveryWindowTo | time | Optioneel | Het einde van het bezorgtijdvenster van een specifieke verzendoptie. |
version | String | Verplicht | De status van de mapping voor bezorgstatuscodes die door een vervoerder wordt gebruikt. |
timestamp | dateTime | Verplicht | De tijd waarop dit trackingbestand is verzonden. |
Het <status>-element
Het status-element moet een van de volgende waarden bevatten. Koppel elke status aan een verzendstatus die overeenkomt met de actuele status van de zending.
| Bezorgstatus | Statuscode | Uitleg |
|---|---|---|
| Gesorteerd door vervoerder | SCANNED | Het pakket is opgehaald door jouw vervoerder en gescand in het sorteercentrum |
| Onderweg voor bezorging | UITLEVERING | De bezorging van het pakket is gaande |
| Bezorgd | DELIVERED | Het pakket is afgeleverd op het afleveradres |
| Afgeleverd bij afhaalpunt | AVAILABLE_AT_PICKUP_POINT | Het pakket ligt klaar om opgehaald te worden op de desbetreffende afhaallocatie |
| Bezorgd bij buren | DELIVEREDBB | Het pakket is afgeleverd op het adres van de buren |
| Opgehaald bij afhaalpunt | PICKEDUP | Het desbetreffende pakket is opgehaald |
| Geadresseerde niet thuis | NOT_AT_HOME | Het pakket kon niet worden bezorgd omdat er niemand thuis was om het in ontvangst te nemen |
| Onbezorgbaar | MANCO | Het pakket kon niet worden bezorgd. Verdere actie is vereist om jouw klant te informeren |
| Retour | RETOUR | De bestelling wordt door jouw klant geretourneerd |
XSD
<xs:schema targetNamespace="http://www.paazl.com/schemas/tracking" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:tracking="http://www.paazl.com/schemas/tracking">
<xs:element name="tracking">
<xs:complexType>
<xs:sequence>
<xs:element name="statuses" type="tracking:StatusesType"/>
</xs:sequence>
<xs:attribute name="version" type="xs:string" use="required"/>
<xs:attribute name="timestamp" type="xs:dateTime" use="required"/>
</xs:complexType>
</xs:element>
<xs:complexType name="StatusesType">
<xs:sequence>
<xs:element name="status" type="tracking:StatusData" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="StatusData">
<xs:sequence>
<xs:element name="timestamp" type="xs:dateTime"/>
<xs:element name="barcode" type="xs:string"/>
<xs:element name="trackingURL" type="xs:string"/>
<xs:element name="carrierStatus" type="xs:string"/>
<xs:element name="carrierStatusDescription" type="xs:string"/>
<xs:element name="status" type="tracking:statusType" minOccurs="0"/>
<xs:element name="town" type="xs:string" minOccurs="0"/>
<xs:element name="country" type="xs:string" minOccurs="0"/>
<xs:element name="deliveryInformation" type="xs:string" minOccurs="0"/>
<xs:element name="deliveryWindowFrom" type="xs:time" minOccurs="0"/>
<xs:element name="deliveryWindowTo" type="xs:time" minOccurs="0"/>
</xs:sequence>
</xs:complexType>
<xs:simpleType name="statusType">
<xs:restriction base="xs:string">
<xs:enumeration value="READY_TO_POST"/>
<xs:enumeration value="SCANNED"/>
<xs:enumeration value="AVAILABLE_AT_PICKUP_POINT"/>
<xs:enumeration value="DELIVERED"/>
<xs:enumeration value="DELIVEREDBB"/>
<xs:enumeration value="RETOUR"/>
<xs:enumeration value="PICKEDUP"/>
<xs:enumeration value="UITLEVERING"/>
<xs:enumeration value="MANCO"/>
<xs:enumeration value="NOT_AT_HOME"/>
</xs:restriction>
</xs:simpleType>
</xs:schema>Voorbeeld
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<tracking xmlns="http://www.paazl.com/schemas/tracking" version="1.0" timestamp="2019-03-27T15:29:52.321Z">
<statuses>
<status>
<timestamp>2019-03-27T15:11:11+00:00</timestamp>
<barcode>231300687629631</barcode>
<trackingURL>https://www.carrier.com/en/orderinformation?12345</trackingURL>
<carrierStatus>4</carrierStatus>
<carrierStatusDescription>Shipper approves shipment for collection</carrierStatusDescription>
<status>SCANNED</status>
<town>Vianen</town>
<country>NL</country>
<deliveryInformation>Your package is colored blue</deliveryInformation>
<deliveryWindowFrom>10:00:00</deliveryWindowFrom>
<deliveryWindowTo>19:00:00</deliveryWindowTo>
</status>
</statuses>
</tracking>Was dit artikel nuttig?
Dat is fantastisch!
Hartelijk dank voor uw beoordeling
Sorry dat we u niet konden helpen
Hartelijk dank voor uw beoordeling
Feedback verzonden
We stellen uw moeite op prijs en zullen proberen het artikel te verbeteren