ChannelEngine integratie

Doel: Leer hoe je ChannelEngine in een paar eenvoudige stappen kunt integreren met Sendcloud. 

Verwante artikelen:

→ Welkom bij Sendcloud

Voordat je ChannelEngine met Sendcloud kunt integreren, maak je hier een account aan en kies je een abonnementsplan. 

Stap 1: Stel je integratie in

1. Ga in je Sendcloud account naar Instellingen > Integraties 
2. Zoek ChannelEngine in de lijst van integraties en klik op Koppelen
   
   
   
   
3. Vul de volgende velden in*:
   • Naam (van de integratie)
   • Account Naam
   • API key
4. Klik op Opslaan als je klaar bent.

*Zie Stap 2 om te zien waar je deze credentials vindt

Stap 2: Zoek je ChannelEngine inloggegevens

1. Ga in je ChannelEngine account naar Instellingen > Merchant API Keys
2. Je vindt je Account Naam (1) onder API URL. Het is het subdomein voor je ChannelEngine omgeving. In het voorbeeld hieronder zie je dat de Account naam "sendcloud-dev" is.
   
   
   
   
3. Voer de Account Naam bij het relevante veld in Sendcloud in, zoals beschreven in Stap 1. 
4. Om een API key te genereren, klik je op de Toevoegen (2) knop. De API key verschijnt naast een veld waarin je de naam voor de API verbinding moet invullen.
   
   
   
5. Klik op Toevoegen als je klaar bent. 
6. Kopieer en plak de sleutel in het API Key veld in Sendcloud zoals beschreven in Stap 1. 

Stap 3: Configuratie

Zodra je de credentials in Sendcloud hebt ingevoerd en op Opslaan hebt geklikt, zie je bovenaan de pagina met integratie-instellingen een knop verschijnen die je vraagt verder te gaan met de configuratie.

1. Klik op Ga naar configuratie 
   
   
   
   
2. Je wordt doorgestuurd naar een pagina waar je het gewicht en de gewichtseenheid kunt mappen zoals je dit ook in ChannelEngine hebt gedaan. De waarden moeten overeenkomen met die in ChannelEngine zijn opgeslagen. 
3. Als je een ChannelEngine attribuut hebt voor Verzendmethode Naam, moet je de attribuutnaam in dit veld invoeren zoals die in ChannelEngine is opgeslagen. 
   
   
   
   
4. Voor meer informatie over extra gegevensattributen in ChannelEngine, zie het volgende: ChannelEngine extra data

Stap 4: Custom fields 

Er zijn drie manieren om een custom field toe te voegen aan ChannelEngine: via de interface, via de product feed en via de API. Voor meer informatie, zie het ChannelEngine: product custom fields/extra data fields artikel.

1. Wanneer je klaar bent met het toevoegen van het Gewicht, de Gewichtseenheid en de Verzendmethode naam, ga je naar Products > Custom fields in ChannelEngine. Hier vind je het overzicht van je custom fields. 
2. Vervolgens moet je het custom field configureren met de Key, Type en IsPublic opties. Dit doe je volgens de informatie in je product feed. 
   
   
   Let op: Key is als default leeg, Type is gezet op Text, IsPublic is gezet op Nee en je moet iedere optie aanpassen voordat je op opslaan klikt.
3. Bij het gebruiken van het product feed voorbeeld hierboven, moet je de volgende informatie invullen in de custom fields en deze daarna op opslaan klikken: 

• Custom field = Weight
• Key = Weight
• Type = Number
• IsPublic = Yes
  
  

• Custom field = Weight unit
• Key = weight_unit
• Type = Text
• IsPublic = Yes
  
  

• IsPublic moet altijd op Yes worden gezet, zodat Sendcloud toegang heeft om custom fields aan te maken in ChannelEngine.

Nadat je alle nieuw gecreëerde custom fields hebt opgeslagen, kun je deze terugvinden op je ChannelEngine Custom fields pagina. Controleer nog een keer of alle velden correct zijn geconfigureerd.

Stap 5: Configureren gewicht en gewichtseenheid

Zodra je jouw custom fields hebt aangemaakt in ChannelEngine, kun je deze mappen op de Sendcloud mapping pagina. Dit zorgt ervoor dat Sendcloud relevante data kan ophalen uit je product feed. Het opslaan van de mapping op Sendcloud doe je als volgt:

• Weight = weight
• Weight unit = weight_unit

Stap 6: Configureren verzendmethode naam

In het Shipping method name veld vul je "SHIPPING_METHOD" in: 

Problemen oplossen

Als een bestelling ongeldige velden heeft in ChannelEngine, wordt het verzendlabel en volgnummer niet gegenereerd in Sendcloud. Ze verschijnen in het inkomende orderoverzicht met een foutmelding. Je moet de inkomende bestelling corrigeren met het orderbewerkingsoverzicht en het label opnieuw aanmaken in Sendcloud.