Channable koppeling: je webshop en ERP koppelen aan Channable

Wat is Channable en wie gebruikt het?

Channable is een platform voor productfeeds en marktplaatsen. Je leest je productdata in, bewerkt die met regels en zet hem op prijsvergelijkers, advertentiekanalen en marktplaatsen. Met de add-on Order sync haalt Channable ook orders van die marktplaatsen op. De order-API kent 75 kanaalnamen, waaronder bol, Amazon, Kaufland, Zalando, Otto en tientallen marktplaatsen die op Mirakl draaien, zoals die van Decathlon, MediaMarkt en Leen Bakker.

Voor een koppeling staat Channable tussen je eigen systemen en de marktplaatsen. Channable praat met elke marktplaats in diens eigen API; de koppeling praat met Channable. Voor onder meer Shopify, Magento, WooCommerce en Lightspeed heeft Channable eigen orderkoppelingen. De Channable API is er voor de rest: een ERP of magazijnsysteem dat de orders zelf moet ontvangen, of een webshop waarvoor Channable geen orderkoppeling heeft. Per project kan Channable orders aan één systeem leveren. Loopt de webshop al via een eigen orderkoppeling, dan haalt het ERP de orders uit de webshop, of komt er een tweede project.

Wat je met Channable koppelt

De productdata gaat niet via de order-API maar via een import. Channable leest een feed van een URL, tot 10 miljoen artikelen en 10 GB per bestand, met platte XML of JSON: waarden uit XML-attributen neemt Channable niet over. Standaard leest Channable één keer per dag in; op Core Plus en Core Pro kan dat tot 24 keer per dag, met een kwartier tussen twee runs. Welke velden een marktplaats per artikel vraagt, staat op productdata koppelen.

Hoe Channable data vrijgeeft

Token per bedrijf, paden per project

Alleen de eigenaar van een Channable-bedrijf maakt een API-token aan, onder Company settings, Channable API. Channable bewaart het token zelf niet: wie het kwijtraakt, maakt een nieuw. Een token verloopt na een jaar en er kunnen twee tegelijk geldig zijn, zodat je zonder onderbreking wisselt. Elk pad begint met /v1/companies/{company_id}/projects/{project_id} of de v2-variant.

De orderlijst van v1 is als deprecated gemarkeerd; v2 vervangt hem. Datums in filters leest Channable als UTC en tijdstempels in orders hebben offset +00:00. Een order die om 00:30 Nederlandse tijd binnenkomt, staat in Channable op 22:30 de dag ervoor. Een koppeling die met lokale tijd filtert, mist orders rond middernacht. Zie datums en tijdzones.

Limiet en rekensom

Channable gebruikt een leaky bucket per bedrijf. Een extra token levert geen extra ruimte op. Boven de limiet volgt een 429. Voorraad gaat in blokken van 50 artikelen, met de volledige nieuwe stand en geen verschil. De rekensom voor een volledige ronde van 15.000 artikelen: 15.000 / 50 = 300 aanroepen, bij 4 per seconde 300 / 4 = 75 seconden. Dat past ruim, maar dezelfde 4 per seconde delen orders ophalen, zendingen melden en elk ander project van het bedrijf. De koppeling stuurt daarom alleen artikelen waarvan de voorraad veranderd is en houdt een eigen teller per seconde bij. Zie wat is een rate limit.

Waar het bij Channable op vastloopt

Het product-ID moet gelijk zijn aan je webshop

In een order staat per artikel het id uit je Channable-import, plus ean en article_number als die er zijn. Channable zegt zelf dat het product-ID gelijk moet zijn aan het unieke ID van het artikel in je webshop. Leest Channable een feed met 012608-BLUE-XXL als id en kent je ERP het artikel als 10482, dan kan de koppeling de orderregel niet plaatsen. Dan is er een vertaaltabel nodig, of een feed die het ERP-nummer als id gebruikt. Dezelfde sleutel geldt voor stock_updates. Zie SKU of EAN.

Drie wegen voor voorraad, drie snelheden

Voorraad kan via het feedveld stock, via een orderkoppeling of via stock_updates. Het feedveld gaat mee met de geplande runs, dus één keer per dag op het standaardabonnement. Een artikel dat om 10:00 uitverkocht raakt, staat dan tot de volgende run op de marktplaats. Een actieve orderkoppeling werkt de voorraad elke 5 minuten bij, Mirakl elke 15 minuten. De koppeling stuurt een wijziging direct via stock_updates, en de dagelijkse feed blijft de volledige controle.

Adres en orderfouten

{
  "shipping": {
    "street": "Dorpsstraat",
    "house_number": 12,
    "house_number_ext": "A",
    "address1": "Dorpsstraat 12 A",
    "zip_code": "1234 AB",
    "country_code": "NL"
  }
}

house_number is in Channable een geheel getal en de toevoeging staat apart in house_number_ext. Daarnaast staat het hele adres in address1. Een ERP met één adresregel neemt address1, een ERP met drie velden neemt de losse velden. Lukt het Channable niet het adres te splitsen, dan krijgt de order error true met error_reason address_parsing. Andere redenen zijn onder meer orphan, missing_reference en pricing. De koppeling leest die orders apart uit met errors=true en zet ze op de controlelijst. Zie adresvelden mappen.

Status zonder track-and-trace

Channable zet een order die in je systeem afgerond is, op Waiting zolang er geen track-and-trace is. Na 3 uur zonder code zet Channable hem toch op Shipped, zonder vervoerder en code. Channable schrijft zelf dat marktplaatsen tracking vaak vragen voor een goede verkopersbeoordeling. De koppeling stuurt daarom vervoerder en code in dezelfde shipment-aanroep. Deelzendingen gaan met order_item_ids; bij Spartoo en Veepee kan dat niet, en annuleren per regel kan niet bij Amazon, Cdiscount en Spartoo.

Systemen die we aan Channable koppelen

Aan de ERP-kant: Exact Online koppeling, AFAS webshop koppeling en Business Central koppeling. Voor het magazijn: Picqer koppeling en GoedGepickt koppeling. Verkoop je op bol zonder Channable ertussen, dan staat het op bol koppeling. Hoe orders in je ERP landen staat op orders, klanten en verzending, en alle stromen op koppelingen.

We bouwen de koppeling voor een vaste prijs en hosten, draaien en bewaken hem daarna voor een vast bedrag per maand. Orders met een error_reason en zendingen die Channable weigert, komen op de controlelijst met de reden erbij. Vertel welk ERP of magazijn je naast Channable gebruikt, dan hoor je welke stromen erbij horen.