API koppeling - Orders verzenden

Lees dit artikel om meer informatie te vinden over het bevestigen van verzonden orders doormiddel van een carrier ID en track & trace code.

IOm de orders op de status 'Shipped' te krijgen, zal de verzending bevestigd moeten worden.

De orders verzenden

Zodra de orders verzonden zijn, verwacht Vendiro een verzendbevestiging. Op dit moment wordt deze call gedaan op order niveau, niet op order regel niveau. Het bericht dient minimaal de carrier en de track & trace code te bevatten. De overige velden zijn optioneel, maar indien deze velden meegegeven worden mogen ze niet leeg zijn en dienen ze een geldige waarde te bevatten.

Indien er een datum en tijd van verzenden wordt meegegeven, dient dit de tijd uit de tijdzone Europa/Amsterdam te zijn

Voorbeeld: Mocht je een verzending naar een consument in Engeland versturen vanuit een opslag in Engeland, dan is de lokale tijd van verzending bijvoorbeeld 14:20. Er moet echter 15:20 meegestuurd worden, aangezien op dat moment dat de tijd is in de tijdzone Europa/Amsterdam

Op deze pagina is meer informatie te vinden over de verzendbevestiging call, inclusief een voorbeeld bericht.

Carriers

Bij het doorgeven van de verzendbevestiging is het doorgeven van de carrier verplicht. Deze carriers zijn in Vendiro gekoppeld aan de carriers van de verschillende marketplaces.

De actuele carrier lijst is via de API op te vragen, zie hiervoor ook de documentatie op deze pagina. Daarnaast staat hieronder de actuele lijst;

ID Carrier naam
1 - Unknown
2 DHL
3 BPost
4 PostNL
5 DPD
7 UPS
9 Colissimo
11 Dachser
13 TransMission
15 DHL (NL/Tracknet)
16 PostNL (Brievenbus)
17 Courier
18 Van der Heuvel
19 GLS
20 Colis Prive
21 Fadello
22 Hermes
23 B2C Europe
24 Custom / other
25 Deutsche Post
26 Dynalogic
27 Red je Pakketje
28 PostNL (Pakjes Tracked)
29 Mondial Relay
30 Trunkrs
31 LaPoste
32 Packs
33 Correos Express
34 Chronopost
35 Parcelforce
36 Yodel
37 FedEx
 

 

Return code

Bij sommige marketplaces is het verplicht om de consument direct een retourlabel te verstrekken en de marketplace wil hiervan de track&trace code dan ook ontvangen.

Omdat bij het bevestigen van de shipment bij de marketplace de returncode tegelijk moet worden meegegeven, dient deze ook met de confirm shipment meegegeven te worden in het veld return_code.
In dat veld moet de track&trace code meegegeven worden. Een url of carier is dus niet nodig van het retourlabel.

return_code is een optioneel veld en is dus nooit verplicht om mee te geven. Als het veld echter wel wordt meegegeven dan dient het veld gevuld te zijn.

HTTP Code 422

Bij het doorgeven van een verzendbevestiging kan Vendiro een HTTP Code 422 teruggeven. In dit geval is de order al verzonden. Er hoeft dus geen nieuwe poging gedaan te worden om de verzendbevestiging door te geven.