ChannelDock biedt een breed scala aan vooraf gebouwde vervoerdersintegraties die verkopers en fulfilmentcentra direct kunnen gebruiken. Omdat het voor ons niet haalbaar is om een verbinding met elk vervoerdersplatform te bouwen, hebben we een set API's ontwikkeld waarmee u, als vervoerder, verzendmethoden in ChannelDock kunt aanmaken voor een specifieke verkoper of fulfilmentcentrum.
Deze gids beschrijft de stappen die u moet volgen om deze integratie te voltooien.
Stap 1:
Genereer API-referenties:
- Verkoper: https://channeldock.com/portal/public/settings/api_keys
- Fulfilmentcentrum: https://channeldock.com/portal/public/centersettings/api_keys
Stap 2:
De volgende stap is het toevoegen van de verzendmethoden die u als vervoerder aanbiedt in ChannelDock. Meer informatie over het eindpunt en de JSON-structuur die wij verwachten vindt u hier:
- Verkoper: Postman-documentatie
- Fulfilmentcentrum: Postman-documentatie
Stap 3:
Telkens wanneer een ChannelDock-gebruiker probeert een verzendlabel aan te maken met uw verzendmethoden, sturen we u een JSON-object met de ordergegevens en details over de geselecteerde verzendmethode. Voor een voorbeeld, zie dit bestand: callback_data.json
{
"order_id": 774,
"seller_id": 1223, // The label is requested by the Seller when center_id is 0
"center_id": 0, // The label is requested by the Center when center_id is not 0
"remote_order_id": "ORD-2025-4055",
"order_date": "2025-05-13 08:49:28",
"ship_on_date": "2025-05-14",
"remote_carrier_id": "postnl_standard_001",
"carrier_code": "given carrier_code", // Value is in lowercase
"sender_details": {
"name": "John Doe",
"company_name": "Doe Logistics BV",
"street": "Keizersgracht",
"address_line_2": "Suite 301",
"country": "NL",
"house_number": "241",
"zipcode": "1016 EA",
"city": "Amsterdam",
"state_province_code": "",
"phone_number": "+31 20 123 4567",
"email": "[email protected]",
"signature_full_name": "John Doe",
"signature_initials": "JD",
"vat_number": "NL123456789B01",
"eori_number": "NL123456789000"
}
"shipping_address1": "Keizersgracht 123",
"shipping_address2": "2nd floor",
"shipping_address_supplement": "Entrance via side door",
"shipping_city": "Amsterdam",
"shipping_company": "KiteGear BV",
"shipping_country_code": "NL",
"shipping_email": "[email protected]",
"shipping_first_name": "Emma",
"shipping_house_number": "123",
"shipping_house_number_ext": "B",
"shipping_last_name": "van Dijk",
"shipping_middle_name": null,
"shipping_region": "Noord-Holland",
"shipping_street": "Keizersgracht",
"shipping_zip_code": "1015 CJ",
"shipping_address_accurate": 1,
"shipping_phone_number": "+31 6 12345678",
"shipping_service": "", // JSON string
"billing_address1": "Keizersgracht 123",
"billing_address2": "2nd floor",
"billing_address_supplement": "Finance dept.",
"billing_city": "Amsterdam",
"billing_company": "KiteGear BV",
"billing_country_code": "NL",
"billing_email": "[email protected]",
"billing_first_name": "Emma",
"billing_house_number": "123",
"billing_house_number_ext": "B",
"billing_last_name": "van Dijk",
"billing_middle_name": null,
"billing_region": "Noord-Holland",
"billing_street": "Keizersgracht",
"billing_zip_code": "1015 CJ",
"billing_address_accurate": 1,
"billing_phone_number": "+31 20 1234567",
"total_weight": 8.0,
"total_length": 80,
"total_width": 25,
"total_height": 25,
"total_order_price": 749.95,
"total_order_currency": "EUR",
"order_products": [
{
"order_product_id": 868,
"order_product_price": 699.95,
"order_product_price_currency": "EUR",
"ean": "8719326583655",
"sku": null,
"quantity": 1,
"product_title": "North Orbit Kite 2025 - 12m",
"product_weight": "5.00",
"product_length": 80,
"product_width": 25,
"product_height": 15,
"product_hs_code": "95062900",
"remote_order_product_id": "NL-PROD-001",
"product_origin_country_code": "NL"
},
{
"order_product_id": 869,
"order_product_price": 50.00,
"order_product_price_currency": "EUR",
"ean": "8719326583617",
"sku": "TSHIRT-BLACK-M",
"quantity": 1,
"product_title": "Mystic Kite Pump Pro",
"product_weight": "3.00",
"product_length": 40,
"product_width": 10,
"product_height": 10,
"product_hs_code": "84142080",
"remote_order_product_id": "NL-PROD-002",
"product_origin_country_code": "DE"
}
]
}
Na ontvangst van deze gegevens wordt van u verwacht dat u een verzendlabel-PDF genereert, deze in Base64 codeert en de volgende reactie retourneert: callback_response.json
{
"label_id": 99999, // Your internal label id
"carrier_code": "DHL",
"tracking_number": "DHL87623654234",
"tracking_number_url": "https://dhl.com/tracking?DHL87623654234",
"pdf_content_base64": "JVBERi0xLjQKJeLjzgo8PC9UeXBlL0NhdGFsb2cvUG..."
}Attribuut | Beschrijving |
label_id | De label-ID in uw systeem. |
carrier_code | De vervoerder die dit label heeft aangemaakt (bijvoorbeeld: DHL, PostNL, UPS). |
tracking_number | Het trackingnummer van dezelfde vervoerder die het label heeft aangemaakt. |
tracking_number_url | De link om deze zending bij die vervoerder te volgen. |
pdf_content_base64 | Het label PDF-bestand als Base64-tekst (A6-papierformaat). |
ChannelDock zal vervolgens het PDF-label afdrukken en het trackingnummer naar het verkoopkanaal sturen zodat de bestelling verwerkt kan worden.
Foutrespons - HTTP-code 400-reeks
{
"error": {
"message": "Human readable error explanation here"
}
}Dit artikel is automatisch vertaald uit het Engels.