ChannelDock biedt een breed scala aan voorafgebouwde vervoerdersintegraties die verkopers en fulfillmentcentra direct kunnen gebruiken. Omdat het voor ons echter niet haalbaar is om een koppeling 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 een specifiek fulfillmentcentrum.
Deze handleiding 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
- Fulfillment center: 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 de endpoint en de JSON-structuur die we verwachten vindt u hier:
- Verkoper: Postman-documentatie
- Fulfillment center: Postman-documentatie
Stap 3:
Telkens wanneer een ChannelDock-gebruiker een verzendlabel probeert aan te maken met uw verzendmethoden, sturen wij u een JSON-object met de ordergegevens en details over de geselecteerde verzendmethode.
{
"order_id": 774,
"seller_id": 1223,
"center_id": 0,
"api_id": 456,
"api_description": "Bol.com - Main shop",
"channel_name": "Bol.com",
"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",
"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": "",
"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.0,
"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 het volgende antwoord terugstuurt:
{
"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 gemaakt. |
tracking_number_url | De link om deze zending bij die vervoerder te volgen. |
pdf_content_base64 | Het labelbestand PDF 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-statuscode in de 400-reeks
{
"error": {
"message": "Human readable error explanation here"
}
}Dit artikel is automatisch vertaald uit het Engels.