Alles over ChannelEngine

ChannelEngine: Zendingen naar ChannelEngine sturen

Registreer een zending bij een order in ChannelEngine, met vervoerder en track & trace. APIcenter bevestigt een nieuwe order eerst.

Bijgewerkt op 9 november 2026

Deze flow stuurt zendingen uit een andere applicatie, zoals je webshop of ERP, naar ChannelEngine. Zo weet ChannelEngine dat de order is verzonden en waar de zending is.

Hoe een zending wordt verwerkt

  1. APIcenter controleert of het ordernummer van het verkoopkanaal (Channel order number) is ingevuld. Zonder dat nummer mislukt de zending.
  2. APIcenter zoekt de order in ChannelEngine op dat ordernummer. Vindt APIcenter de order niet, dan mislukt de zending.
  3. Heeft de order al de status verzonden (SHIPPED), dan mislukt de zending, want een verzonden order kan niet nog een keer worden verzonden.
  4. Heeft de order de status nieuw (NEW), dan bevestigt APIcenter de order eerst in ChannelEngine (acknowledge), met het Merchant order number uit je gegevens. Dat nummer staat daarna op de order en gebruikt ChannelEngine voor de zending.
  5. APIcenter controleert de orderregels van de zending. Zie hieronder.
  6. APIcenter stuurt de zending naar ChannelEngine, met het zendingsnummer, de vervoerder, de track & trace-code en de regels.

ChannelEngine geeft na het aanmaken van een zending geen gegevens terug en de zending is ook niet op te halen. De flow meldt daarom alleen dat de zending is aangemaakt voor de order.

De orderregels

  • Is een orderregel in ChannelEngine al verzonden, dan mislukt de zending.
  • Is het aantal in de zending kleiner dan het aantal op de orderregel, dan mislukt de zending. Verstuur dus de volledige hoeveelheid van elke regel die je meestuurt.

Wat de data mapping omvat

Standaard stuurt APIcenter mee: het zendingsnummer, het ordernummer als Merchant order number, de referentie als ordernummer van het verkoopkanaal, de naam van de vervoerder, de track & trace-code en per regel het productnummer en het aantal. Zie Data mapping.

Wat je eerst nodig hebt

Tips

  • Mislukt de zending omdat de order niet wordt gevonden? Controleer of de referentie in de mapping het ordernummer van het verkoopkanaal bevat, zoals ChannelEngine dat kent.
  • Zie ChannelEngine: veelvoorkomende fouten voor de meldingen bij een zending.
  • Meer over zendingen volgens ChannelEngine staat in Merchant API: shipments.

Hieronder vind je alle instellingen van deze flow, elk met een eigen uitleg.

Instellingen

De instellingen die je in het dashboard ziet, met wat elke instelling doet.

Hiermee codeer je de waarden in het adres (de URL) van de bronapplicatie, dus bij flows die gegevens ophalen. Dit werkt alleen als Enable URL encoding of data in endpoints aanstaat. Standaard staat dit uit.

Hiermee codeer je de waarden in het adres (de URL) van de doelapplicatie, dus bij flows die gegevens versturen. Dit werkt alleen als Enable URL encoding of data in endpoints aanstaat. Standaard staat dit uit.

Zet dit aan als er speciale tekens in de data staan die in het adres (de URL) van een verzoek terechtkomen, zoals in een SKU of categorienaam. De waarden worden dan URL-gecodeerd, zodat het verzoek niet misgaat. Met Enable URL Encoding of data in the endpoints of the source application en Enable URL Encoding of data in the endpoints of the target application bepaal je voor welke kant dit geldt. Standaard staat dit uit.

Use administration mapping table

General flow setting

Zet dit aan om de administratie om te zetten met een koppeltabel tussen de twee applicaties. Wat er gebeurt met een waarde die niet in de tabel staat, bepaal je met What to do with a value that cannot be mapped using the mapping table. Standaard staat dit uit.

Hier kies je wat er gebeurt met een administratie die niet in de koppeltabel staat. Bij Waarde negeren wordt de waarde leeggelaten, bij Waarde gebruiken blijft de oorspronkelijke waarde staan en bij Standaardwaarde gebruiken wordt de standaardwaarde uit Default administration id gebruikt, als je die hebt ingeschakeld. Deze instelling werkt alleen als Use administration mapping table aanstaat. Standaard is Standaardwaarde gebruiken gekozen.

Vul hier het e-mailadres in waarnaar APIcenter meldingen stuurt over mislukte activiteiten van deze flow. Dit werkt alleen als Receive Notifications aan staat. Laat je het veld leeg, dan gebruikt APIcenter bij Direct het e-mailadres van je account. Er is geen standaardwaarde.

Vul hier de Slack-webhook van je Slack-werkruimte in om meldingen over mislukte activiteiten ook in Slack te ontvangen. Dit werkt alleen als Receive Notifications aan staat. Laat je het veld leeg, dan stuurt APIcenter geen Slack-melding. Er is geen standaardwaarde.

Notifications frequency

Notifications

Kies hoe vaak APIcenter meldt dat activiteiten van deze flow zijn mislukt. Bij Direct volgt de melding zodra een activiteit mislukt. Bij Elke 30 minuten, Elk uur, Dagelijks en Wekelijks stuurt APIcenter een overzicht van de mislukte activiteiten die nog niet gemeld zijn. Dit werkt alleen als Receive Notifications aan staat. Standaard is dit Direct.

Receive Notifications

Notifications

Zet dit aan om een melding te krijgen als een activiteit van deze flow mislukt. Met Notifications frequency bepaal je hoe vaak je de melding krijgt, en met Notifications Email address en Notifications Slack webhook waar die naartoe gaat. Standaard staat dit uit.

Skip negativity flip process

Product Settings

Standaard zet APIcenter negatieve bedragen bij prijzen, kortingen en belasting om naar positieve bedragen. Bedragen inclusief en exclusief belasting worden dan ook omgewisseld als de belasting negatief is. Zet je deze instelling aan, dan slaat APIcenter deze omzetting over en blijven negatieve waarden negatief. De standaardwaarde is uit.

Deze instelling heeft geen effect voor ChannelEngine. In de flows voor zendingen en voorraad haalt APIcenter geen pagina's op. Je kunt de instelling laten staan zoals hij staat.

Use page size

Run behaviour

Dit is het aantal items dat de flow per API-verzoek ophaalt. Samen met Maximum number of pages to retrieve bepaalt dit hoeveel items één run kan ophalen. De standaardwaarde is 50.

Zet deze instelling aan om een standaard verzendmethode te gebruiken. De waarde vul je in bij Value to use as the default shipping method id. Met Force the use of the default shipping method bepaal je of deze altijd wordt gebruikt of alleen als de bron geen verzendmethode meegeeft. De standaardwaarde is uit.

Hiermee bepaal je wanneer de standaard verzendmethode wordt gebruikt. Staat de instelling aan, dan wordt altijd de standaard verzendmethode gebruikt. Staat de instelling uit, dan wordt alleen de standaard gebruikt als de gegevens uit de bronapplicatie geen verzendmethode bevatten. Dit werkt alleen als Enable the use of a default shipping method aan staat. De standaardwaarde is uit.

Zet deze instelling aan om verzendmethoden uit de bronapplicatie via een toewijzingstabel om te zetten naar verzendmethoden van de doelapplicatie. Je vult de toewijzingstabel zelf in. Wat er gebeurt met een waarde die niet in de tabel staat, bepaal je met What to do with a value that cannot be mapped using the mapping table. Er is geen standaardwaarde.

Hier vul je de waarde in die als standaard verzendmethode wordt gebruikt. Dit is het id van de verzendmethode in de doelapplicatie. De waarde wordt gebruikt als Enable the use of a default shipping method aan staat. Staat die aan en is hier niets ingevuld, dan geeft APIcenter een melding. Er is geen standaardwaarde.

Hiermee bepaal je wat er gebeurt met een verzendmethode die niet in de toewijzingstabel staat. Bij Waarde gebruiken wordt de oorspronkelijke waarde gebruikt. Bij Waarde negeren wordt de waarde weggelaten. Bij Standaardwaarde gebruiken wordt de standaardwaarde gebruikt. De standaardwaarde van deze instelling is Standaardwaarde gebruiken.

Nog vragen?

Stel je vraag aan de supportassistent in je dashboard of maak een supportticket aan.

Naar support