Manuele zendingen – integratie, voorinvullen van formulier

Wanneer we geen integratie met uw platform of custom CMS ondersteunen, kan u gebruik maken van enkele parameters.
Deze zorgen er alsnog voor dat de nodige gegevens kunnen aangevuld worden bij het aanmaken van een label en zodoende het verzendproces een tijdswinst te geven.

API Documentatie:
https://www.shopwedo.com/developer › “Get shipper add label”

Het automatisch aanvullen werkt aan de hand van de volgende GET-parameters:

ext
Verplichte parameter om aan te geven dat dit een manuele invulling is.
De alsook verplichte waarde voor deze parameter is: "manual"

trackingReference
String met de referentie van je zending
Bijvb. Bestelnummer

```
addressCompany
String met bedrijfsnaam
```
```
addressVat
String met BTW/VAT-nummer
```

```
addressFirstname
String met Voornaam
```
```
addressLastname
String met Achternaam
```

```
addressStreet
String met Straatnaam
```
```
addressNumber
String met Huisnummer
```

addressBox
String met Huisnummerextensie
Bijvb. bus, verdiep

```
addressZip
String(8) met Postcode
```
```
addressCity
String met Achternaam
```

addressCountry
String(2) met Land
Formaat: ISO 3166-1 alpha-2

addressLanguage
String(2) met Taal
Formaat: ISO_639-1

```
addressPhone
String met Telefoonnummer
```

```
addressEmail
String met E-mailadres
```

Bij het genereren van de URL plaatst u deze parameters en hun waarde als GET-parameters in de URL.

De URL waar deze parameters kunnen worden gebruikt betreft de “Creëer label”-pagina:

https://shopwedo.com/admin/shipper/add/?ext=manual&addressStreet={street}&...

Voorbeeld PHP:
zie http_build_query

<?php
// De waarden zouden van de Order-object(en) moeten komen uit de e-commerce software, we vullen hier momenteel enkel voorbeeldwaarden in.
// Opgelet: Vaak is er een verschil tussen Facturatie- en Verzendadres, dit gedrag verschilt van platform tot platform.

$esParams = array(

    'ext'=>'manual',
    'trackingReference'=>'ORDER000012',

    'addressCompany'=>'ShopWeDo',
    'addressStreet'=>'Egide Walschaertstraat',
    'addressNumber'=>'22',
    'addressBox'=>'E',

    'addressLanguage'=>'NL',
    'addressCountry'=>'BE',

    'addressEmail'=>'support@shopwedo.com',
    'addressPhone'=>'003215616500'

);

$url = 'https://shopwedo.com/admin/shipper/add/';
$url .= '?' . http_build_query($esParams);
?>

Related

Related Articles