Magmodules_Channable

Channable is een tool om data vanuit een E-Commerce systeem aan te bieden bij bijvoorbeeld Google Shopping, Amazon of Bol.com.

Voor de integratie tussen Magento en Channable wordt gebruik gemaakt van de Magmodules_Channable module.

Functionaliteiten binnen de module

• Generatie van een productfeed (per storeview) met daarin de relevante product-informatie

• Filteren van de productfeed om producten op basis van bepaalde eigenschappen wel/niet in de feed op te nemen

• Productfeed importeren/koppelen aan het Channable portal

• Importeren van Channable orders naar Magento (indien gewenst)

Onderdelen om vooraf over na te denken

• Moeten alle producten worden aangeboden bij Channable? Hoe wordt - indien relevant - de filtering bepaald? Producten kunnen worden gefilterd/uitgesloten binnen zowel Magento als binnen het Channable portal.

• Is een order import geweest? Zo ja, moeten de orders binnen Magento binnen een losse website of storeview worden aangemaakt?

• Channable vereist traceercodes (track & trace codes) dus die moeten zijn toegevoegd aan de webshop.

• Bepaalde Marketplaces hebben specifieke eisen aan product-data. Denk aan het minimale afbeeldingsformaat van 1.00 * 500 pixels voor Amazon of een verplichte lijst met ingrediënten. 

• Custom product types worden niet standaard ondersteund en vergen een stukje maatwerk.

Benodigde informatie en acties vooraf

• Er dient een contract te zijn met Channable en moet toereikend zijn voor het aantal marketplaces, talen en producten.

• HappyHorizon dient toegang te hebben tot het Channable portal.

• Elk product dient te zijn voorzien van een EAN code

Implementatie - To do's op de staging omgeving 

Installatie module

Installatie van de module zodat deze beschikbaar wordt gesteld en getest kan worden

Controleren productfeed

Onder Stores > Configuration > Channable > Productfeed is de productfeed in te zien (middels de JSON link). Op de staging kan worden gecontroleerd of deze productfeed volledig is.

Samen stellen en filteren productfeed

Onder Stores > Configuration > Channable > Productfeed is de productfeed samen te stellen door bijvoorbeeld bepaalde velden te mappen en door producten te filteren.

Op de staging hoeft niet de volledige feed samengesteld/geconfigureerd te worden, maar het is wel aan te raden een aantal basis-tests uit te voeren.

Creatie van een test-order

Onder Stores > Configuration > Channable > Orders is onder het kopje "Webhook" een url te vinden om een test-order aan te maken. Op deze manier kun je controleren of het mogelijk is een order aan te maken en deze de juiste data bevat.

Implementatie - To do's op de productie omgeving 

Controle basisfunctionaliteiten

• Installatie module (zie bovenstaande uitleg)

• Controleren productfeed (zie bovenstaande uitleg)

• Samenstellen en filteren productfeed (zie bovenstaande uitleg)

• Creatie van een testorder (zie bovenstaande uitleg)

Productfeed koppelen aan het Channable portal

Onder Stores > Configuration > Channable > Productfeed is een link "Auto Connect with Channable" te vinden om de productfeed vanuit Magento te importen/mappen aan het Channable portal.

Controleren volledigheid van de feed en vervolgacties bepalen binnen het Channable portal

Binnen het Channable portal kan de volledigheid van de feed worden gecontroleerd en kunnen vervolgacties worden bepaald.

Orderflow koppelen

Elke order die op een marketplace als Bol.com of Amazon wordt geplaatst, wordt geïmporteerd naar Channable. Deze orders kunnen weer worden geïmporteerd naar Magento om vanuit daar te worden opgevolgd.

Aandachtspunten

• Wanneer de Marketplace orders op een bepaalde post in de administratie/boekhoudig terecht moeten komen, is er mogelijk een actie binnen de koppeling noodzakelijk.

• Wanneer de Magento 2 staging omgeving wordt gekoppeld met het Channable portal; dient Channable te worden opgenomen in de whitelist van de staging-omgeving.

• Bij gebruik van een headless front-end (GrapQL) moet de server-configuratie worden aangepast zodat de user agent 'channable' de Magento front-end kan benaderen.

Channable FAQ

Waarom worden Channable orders niet getoond in Google Analytics?

Deze orders worden niet via de cart geplaatst en worden daarom niet doorgestuurd naar Google Analytics. 

Hoe moet ik omgaan met meertaligheid?

Een Channable project is in de basis niet meertalig. Dat betekent dat je voor een Nederlandstalige en Engelstalige storeview het beste twee losse projecten in Channable kunt inrichten. Dit zorgt ervoor dat je voor Nederlandstalige marketplaces/feeds dus de Nederlandstalige content kunt inladen.

In Magento toont de preview van Magento meer sku's dan dat er worden geimporteerd in Channable?

• Controleer als eerste de filtering in Magento en of het product wel in de feed staat. Dit kun je controleren door /pid/[product_entity_id] achter de feed-url te plaatsen (zie bovenstaande onderdeel).

• Het aantal sku's in de Magento feed (website.nl/channable/feed/json/id) zou identiek moeten zijn aan het aantal sku's dat in Channable wordt ingeladen. De filtering in Channable vanuit Channable naar andere platformen vindt namelijk plaats NADAT de producten zijn ingeladen.

• Wanneer het aantal sku's in Channable afwijkt, dan kan dit worden veroorzaakt doordat er één of meerdere sku's met invalide data in de feed staan en die betreffende pagina/collectie met producten vervolgens in zijn geheel niet wordt ingeladen.

Je kunt dit controleren door de waarde Products per page binnen Channable (magmodules_channable/general/limit) aan te passen naar 1 en te controleren of er daarna meer producten worden ingeladen. Dit betekent wel dat het inladen van producten meer tijd in beslag zal nemen.

Om in beeld te brengen welke producten invalide zijn, kun je de experius_restore module gebruiken. De optie validate laat hierbij zien welke data invalide is.

De item import in Channable werkt niet?

Check de firewall settings en neem contact op met Channable om aan te geven dat je een firewall gebruikt. Zij dienen dit ook in de tool aan te geven.

Hoe herken in Channable Marketplace order details?

In Magento is er bij een Channable Order onder het kopje "Payment information" extra informatie te vinden over de order.

In de API staat deze informatie onder de payment_additional_info sectie

"payment_additional_info": [

...

{

"key": "channable_id",

"value": "#####"

},

{

"key": "channel_id",

"value": "#####"

},

{ "key": "channel_name",

"value": "Bol"

},

{

"key": "channel_label",

"value": "Bol NL orders"

},

...

]

of

"payment_additional_info": [

...

{

"key": "channel_name",

"value": "Bol"

},

{

"key": "channel_label",

"value": "Bol BE"

},

...

]

Deze labels zijn statisch en worden door Channable bepaald:

• channel_label = toelichting voor bijvoorbeeld Bol BE en Bol NL

• channel_id = ordernummer in de betreffende marketplace (bijvoorbeeld Bol.com ordernummer)

Aanvullend:

• channable_id = ordernummer binnen Channable

Kan ik in Channable test-orders plaatsen of een Channable Sandbox gebruiken?

Ja, je kunt binnen een project koppelen aan Channable Sandbox en zo test-orders aanmaken. Op https://docs.channable.com/api/v1/#sandbox-testing vind je een uitleg.