Channable
Globe icon
Nederlands Deutsch English (US) Español Français Italiano
  1. Help Center - Channable
  2. Kanalen - Marketplaces
  3. Amazon API

Artikelen in deze sectie

Zie meer

Hoe migreer ik een Amazon API naar Amazon V2

VEREISTE ACTIE

Amazon vereist dat alle gebruikers hun API updaten naar V2. Na 1 april 2025 kunnen we de volledige functionaliteit van Amazon V1 in Channable niet meer garanderen.

Wat gebeurt er als ik niet migreer?

Vanaf 1 april 2025

  • Channable biedt geen technische ondersteuning of probleemoplossing meer voor je Amazon V1 API.
  • De volledige functionaliteit van V1 wordt niet gegarandeerd.
  • Je werkt met een verouderd datamodel.

Vanaf 30 juni 2025

  • Zal Amazon V1 volledig stoppen met werken.
  • Eventuele updates die je maakt aan je productvermeldingen in Channable (bijv. voorraad, prijs, content) worden niet meer gesynchroniseerd.
  • Klanten zien geen wijzigingen in je vermeldingen en we kunnen niet garanderen dat ze op Amazon verschijnen.
  • Gemiste updates kunnen leiden tot downtime van de listing en gemiste verkopen.

Om dit te voorkomen, migreer vóór 30 juni naar Amazon V2 en probeer mogelijke problemen zelfstandig op te lossen voordat je contact opneemt met Support.

Opmerking: Migratie zal je Amazon-services niet verstoren, dus je aanbiedingen blijven actief. Zodra je bent geëmigreerd kun je wijzigingen aanbrengen aan je producten via de gemigreerde Amazon V2-versie van je API.

*Deze deadline wordt bepaald door Amazon en kan veranderen.

Inhoud

Goed om te weten

Als je meerdere Amazon API's hebt met ouder-kind relaties, zorg er dan voor dat je deze stappen voor elke API herhaalt.

Stap 1: Begin met het migreren van je API

  1. Ga naar Projecten > [Jouw project] > Kanalen.
  2. Klik op de Instellen-stap voor de API die je wilt migreren.
  3. Klik op ⚠ Migreer jouw API. Dit opent een overzichtspagina van wat we automatisch kunnen migreren en wat je handmatig moet wijzigen.
Attributen
Bericht Actie nodig? Beschrijving
Succesvol Nee Deze attributen kunnen automatisch worden gemigreerd.
Automatische migratie is niet mogelijk Ja We kunnen deze attributen niet automatisch voor je migreren. Wijs deze opnieuw handmatig toe in de tabbladen Gedeelde attributen en Attributen per categorie (te vinden in de Opbouw-stap).
Geen migratie voorgesteld door Amazon Ja Amazon kon niet bepalen welke attributen voor deze velden worden aanbevolen voor Amazon V2. Wijs deze velden handmatig toe en controleer deze na het uitvoeren van de API of neem contact op met Amazon support voor hulp.
Lege attributen Optioneel Deze attributen waren leeg in je oude API.
Categoriën
Bericht Actie nodig? Beschrijving
Succesvol Nee We hebben deze categorieën automatisch kunnen migreren naar Amazon V2.
Automatische migratie is niet mogelijk Ja We kunnen deze categorieën niet automatisch overzetten. Je moet deze opnieuw handmatig toewijzen in de Categorieën-stap.
Geen migratie voorgesteld door Amazon Ja Amazon kon niet bepalen welke categorieën worden aanbevolen voor deze items voor Amazon V2. Wijs deze velden handmatig toe of neem contact op met de Amazon support voor hulp.
Lege attributen Optioneel Deze attributen waren leeg in je oude API.
  1. Klik op Migreer. Dit maakt een inactieve kopie van je Amazon API voor Amazon V2 met de naam: [Jouw Amazon API naam] (Migrated).
Let op: Migreren heeft geen invloed op je Amazon-services, dus je vermeldingen blijven actief. Zodra je migreert, kun je wijzigingen aanbrengen in je producten via de gemigreerde Amazon V2-versie van je API.

 

Stap 2: Categorieën toewijzen

  1. In je nieuw gemigreerde API, ga naar de Categorieën-stap.
  2. Categoriseer handmatig de producten die niet automatisch zijn gemigreerd.
  3. Klik op Opslaan.

 

Stap 3: Gedeelde attributen koppelen

  1. Ga naar de stap Opbouw. In het tabblad Gedeelde attributen, zorg ervoor dat alle velden die door de marktplaats als verplicht zijn gemarkeerd, worden gekoppeld aan het juiste veld uit je gegevens. 
    1. Vul afhankelijk van je situatie het veld Externe id van product of Door de verkoper voorgestelde ASIN in.
    2. Als je geen prijsgegevens wilt verzenden, negeer dan het veld Aanbiedingen die te koop zijn.
  2. Klik op Opslaan. 
Belangrijk: De waarde van het veld Type voor je Externe id van product is hoofdlettergevoelig en moet ean, gtin of upc zijn. Als je EAN, GTIN of UPC hebt, moet je een regel aanmaken om het om te zetten naar kleine letters.

Stap 4: Categorieattributen koppelen

Selecteer je situatie:

Ik verzend mijn producten zelf (MFN - Merchant Fulfilled Network)
Belangrijk: Als je onze repricer (add-on) gebruikt, zorg er dan voor dat je de Fulfillment-kanaalcode instelt op DEFAULT en het veld Hoeveelheid koppelt aan je voorraad. 

Als je dit niet correct koppelt, ontvangt de repricer onjuiste gegevens waardoor het niet lukt om de prijzen van bepaalde items aan te passen. Dit kan leiden tot een daling in gewonnen buy boxes.
  1. Klik in de stap Opbouw op het tabblad Gedeelde attributen en scroll naar de sectie Aanbod. 
  2. Klik naast Beschikbaarheid van fulfillment op de knop + Toevoegen.
    1. Stel bij Fulfillment-kanaalcode het veld in op DEFAULT (Klik op het dropdown-veld > Vaste waarden > DEFAULT).  
    2. Voor Hoeveelheid, selecteer je voorraadveld.
  3. Koppel alle overige verplichte velden aan een passend veld.
    1. Als je verkoopt op Amazon US en het attribuut Item Type Keyword verschijnt in de sectie Information to uniquely identify your product, klik op het veld en selecteer Interne velden > recommended_browse_nodes.
  4. Ga naar de stap Kwaliteit. 
  5. Controleer en los eventuele items op die gemarkeerd zijn met fouten.
Amazon verzendt mijn producten (AFN - Amazon Fulfilment Network / FBA - Fulfillment by Amazon)
Belangrijk: Als je onze repricer (add-on) gebruikt, zorg er dan voor dat je de juiste Amazon-magazijnlocatie instelt voor de Fulfillment-kanaalcode (bijv. AMAZON_EU). Koppel Hoeveelheid niet.

Als je dit niet correct koppelt, ontvangt de repricer onjuiste gegevens waardoor het niet lukt om prijzen aan te passen. Dit kan leiden tot minder gewonnen buy boxes.
  1. Klik in de stap Opbouw op het tabblad Gedeelde attributen en scroll naar de sectie Aanbod. 
  2. Klik naast Beschikbaarheid van fulfillment op de knop + Toevoegen.
    1. Stel Fulfillment-kanaalcode in op de Amazon-magazijncode (Klik op het dropdown-veld > Vaste waarden > [jouw relevante Amazon-code]). 
    2. Als je verkoopt op Amazon US en het attribuut Item Type Keyword verschijnt in de sectie "Information to uniquely identify your product", klik op het veld en selecteer Interne velden > recommended_browse_nodes.
  3. Ga naar de stap Kwaliteit.
  4. Controleer en los eventuele items op die gemarkeerd zijn met fouten.
Opmerking: Amazon kan je vragen om aanvullende velden toe te voegen die niet relevant zijn voor jouw producten. Je kunt deze verplichte velden negeren.

Voorbeeld: Je verkoopt kleding, maar Amazon geeft aan dat je moet aangeven of het product een batterij heeft.

 

Tip: Klik op Velden automatisch koppelen om automatisch verplichte velden te koppelen (matchen en invullen) op basis van je importgegevens.

 

Stap 5: Test je API

  1. Ga naar de Bekijk-stap en open het tabblad Gekoppelde items.
  2. Klik op Start nu de test (dry run) om te controleren hoe je vermeldingen in Channable overeenkomen met de items in je Amazon-account. 
Let op: Meer informatie over Dry runs kan je hier vinden.

Stap 6: Activeer API en los fouten op

Je originele Amazon V1 API blijft actief totdat je deze deactiveert.

Belangrijk: Als je meerdere geplande runs per dag hebt, kan het actief houden van beide API’s prestatieproblemen en vertragingen veroorzaken. Om dit te voorkomen, deactiveer je V1 API voordat je je V2 API activeert.
  1. Als je klaar bent om de nieuwe API live te zetten, navigeer terug naar de Instellen-stap en klik op Activeer API.
  2. Klik op de blauwe Uitvoeren-knop om je productvermeldingen naar Amazon te sturen.
  3. Ga naar de Resultaat-stap om te controleren of er producten met fouten zijn.
    1. Klik op een fout om een overzicht van de fout te bekijken. Vanaf hier kun je klikken op Ga naar attribuut om het relevante veld toe te wijzen en het probleem op te lossen.
  4. Op de Attributen-pagina, klik op het ‘?’-tool tip-icoon voor meer informatie over de geaccepteerde waarden, of klik op het veld en selecteer Statische waardes om een lijst met de door-Amazon-geaccepteerde invoerwaarden te bekijken.

Als je meerdere Amazon APIs hebt, herhaal dan de stappen in dit artikel voor elke API.

 

Stap 7 (optioneel): Activeer de Repricer

Deze stap is alleen van toepassing als je onze repricer (add-on) gebruikt.

  1. In [jouw Amazon API], ga naar Regels en controleer de reprice regels die automatisch zijn gemigreerd.
  2. Ga naar de Instellen-stap en klik op Activeer repricer.
  3. Klik op Opslaan.

 

Stap 8: Deactiveer je oude V1 API

Op dit punt heb je twee geactiveerde API’s – je originele Amazon API op V1 en je nieuwe API op V2.

We raden aan om je V1 API te deactiveren nadat je de fouten in V2 hebt opgelost. Dit komt omdat, hoewel je productvermeldingen actief blijven, het draaien van twee actieve API’s tegelijkertijd hun prestaties kan vertragen.

Zo deactiveer je je Amazon V1 API:

  1. Ga in [je originele Amazon API] naar de stap Instellen en klik op Deactiveer API.