ChannelDock biedt een breed scala aan kant-en-klare vervoerdersintegraties die verkopers en fulfilmentcentra direct kunnen gebruiken. Omdat het echter 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 een specifiek 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
- Fulfillmentcentrum: https://channeldock.com/portal/public/centersettings/api_keys
Stap 2:
De volgende stap is het toevoegen van de verzendmethoden die u als vervoerder levert in ChannelDock. U kunt meer informatie over het endpoint en de JSON-structuur die wij verwachten hier vinden:
- Verkoper: Postman-documentatie
- Fulfillmentcentrum: Postman-documentatie
Stap 3:
Wanneer een ChannelDock-gebruiker probeert een verzendlabel te maken met uw verzendmethoden, sturen wij u een JSON-object met de bestelgegevens 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 de volgende respons retourneert:
{
"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 (bijv.: 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 label PDF-bestand als Base64-tekst (A6 papierformaat). |
ChannelDock zal vervolgens het PDF-label afdrukken en het trackingnummer naar het verkoopkanaal sturen om de bestelling te verwerken.
Foutrespons - HTTP-code in de 400-reeks
{
"error": {
"message": "Human readable error explanation here"
}
}Dit artikel is automatisch vertaald uit het Engels.