DataFirefly Amazon Connector: PrestaShop koppelen aan Amazon Seller Central

Installatie

Installeer de module via Modules > Modulebeheer > Een module uploaden door het ZIP-bestand te verzenden. De PHP-extensie cURL is vereist.

Bij de installatie maakt de module zijn tabellen aan, een tabblad Amazon Connector in het menu Verkopen, een vervoerder „Amazon” die alleen voor geïmporteerde bestellingen dient (klanten zien hem nooit) en twee bestelstatussen: „Amazon: wacht op verzending” en „Amazon FBA: verzonden”.

Uw Amazon-account voorbereiden

De module maakt verbinding met uw verkopersaccount via uw eigen privé-applicatie voor de Selling Partner API. U hebt een professioneel Seller Central-account nodig.

1. Open in Seller Central Apps en services > Apps ontwikkelen en registreer u als privé-ontwikkelaar als u dat nog niet gedaan hebt.
2. Maak een applicatie aan en vraag de rollen aan die de gebruikte functies nodig hebben: Product Listing en Pricing voor de catalogus, Inventory and Order Tracking voor bestellingen, Direct-to-Consumer Shipping (Restricted) voor het afleveradres en het e-mailadres van de koper, Amazon Fulfillment voor de FBA-voorraad, Finance and Accounting voor terugbetalingen, Tax Invoicing voor het uploaden van facturen.
3. Autoriseer de applicatie zelf op uw account om een refresh token te krijgen en noteer de LWA-client-ID en het clientgeheim.
4. Kopieer uw Merchant Token via Instellingen > Accountgegevens.

Verbinding en marktplaatsen

Kies in Amazon Connector > Instellingen de regio (Europa, Noord-Amerika of Verre Oosten), vul de LWA-client, het geheim, de refresh token en de Merchant Token in en sla op. Geheimen worden versleuteld opgeslagen; laat de velden leeg om de opgeslagen waarden te behouden.

Klik in het dashboard op Verbinding testen. De marktplaatsen van uw account verschijnen in het tabblad Marktplaatsen, standaard uitgeschakeld. Stel voor elke marktplaats in:

• de activering;
• de taal van de verzonden inhoud (titel, beschrijving);
• prijzen incl. of excl. btw, afhankelijk van het land;
• de prijssynchronisatie, uit te schakelen als u een Amazon-repricer gebruikt;
• de procentuele opslag, het vaste bedrag en de afronding (geen, x,99, x,90, geheel getal).

Cron-taak

De synchronisatie draait via een cron-taak, bij voorkeur elke 5 tot 15 minuten. Het dashboard toont de met een token beveiligde URL en het opdrachtregelcommando:

php /pad/naar/modules/dfamazonconnector/cron.php --shop=1

Bij elke run importeert de module bestellingen, bevestigt verzendingen, verstuurt facturen en annuleringen, leest terugbetalingen en FBA-voorraad en verstuurt daarna openstaande aanbiedingen, voorraden en prijzen als gebundelde feeds. Een rode melding verschijnt in de module als de taak langer dan een uur niet heeft gedraaid. De knop Nieuw token maakt de oude URL ongeldig.

Categoriekoppeling

De koppeling is alleen nodig om nieuwe aanbiedingen op Amazon aan te maken. Een product dat op een bestaande ASIN verkocht wordt of via zijn EAN gekoppeld is, heeft alleen een aanbod nodig.

Kies in het tabblad Categoriekoppeling een PrestaShop-categorie en een Amazon-producttype (ingebouwde zoekfunctie op trefwoorden). Een product gebruikt de koppeling van zijn standaardcategorie of, als die er niet is, van de dichtstbijzijnde gekoppelde bovenliggende categorie.

• Browse node: het navigatieknooppunt van Amazon, optioneel afhankelijk van het producttype.
• Variatiethema: bijvoorbeeld SIZE_NAME/COLOR_NAME. Is het ingevuld, dan worden combinaties gegroepeerd als familie; is het leeg, dan wordt elke combinatie als zelfstandig product gepubliceerd.
• Combinatie-attributen en Kenmerken: koppelen een Amazon-attribuut aan een PrestaShop-attribuutgroep of -kenmerk.
• Vaste attributen: waarden die ongewijzigd worden verzonden, in Listings Items-formaat. Beschikbare variabelen: {marketplace_id}, {language_tag}, {currency}, {reference}, {ean13}, {mpn}, {brand}.

De knop Verplichte attributen leest het schema van het producttype bij Amazon en somt de attributen op die de module niet zelf invult. Kies voor elk een bron (vaste waarde, kenmerk, combinatie-attribuut) en daarna Toepassen: de JSON-velden worden automatisch ingevuld.

Producten publiceren

Vanuit de productpagina

Het tabblad Modules van de productpagina bevat een Amazon-blok:

• Verkopen op Amazon activeert het product.
• Publicatiemodus: automatisch, aanbod op een bestaand product (ASIN of EAN) of volledige aanbieding aanmaken.
• Verzending: door u (FBM) of door Amazon (FBA).
• ASIN, producttype, staat en vaste Amazon-prijs vervangen de standaardwaarden voor dit product.
• Extra attributen: JSON die na de vaste attributen van de categorie wordt samengevoegd; een waarde null verwijdert een attribuut.
• Marktplaatsen: vink een land uit om het product van die marktplaats te verwijderen.

De tabel „Wat naar Amazon wordt verzonden” toont per combinatie en land de prijs, de actieprijs met data, de minimumprijs, de Business-prijs en het aantal. Er zijn vier acties: Controleren bij Amazon (validatie zonder publicatie, fouten per attribuut), Nu verzenden, Toevoegen aan volgende synchronisatie en Status vernieuwen.

In bulk

Het tabblad Producten toont de catalogus met de status van elk product per land (actief, bezig, inactief, fout). Filter op naam, categorie of staat, vink producten aan of de optie „Alle producten die aan het filter voldoen” en pas een actie toe: activeren en publiceren, opnieuw publiceren, prijzen verzenden, aantallen verzenden, deactiveren (aantal 0) of verwijderen van Amazon.

Aanbiedingen die al op Amazon staan

De knop Bestaande Amazon-aanbiedingen koppelen in het dashboard vraagt het rapport van uw aanbiedingen op bij Amazon. Bij de volgende cron-run wordt elke SKU gekoppeld aan het PrestaShop-product met dezelfde SKU, referentie of EAN. Niet gevonden SKU’s staan in de log.

Amazon-SKU

De SKU wordt bij de eerste publicatie aangemaakt volgens de gekozen instelling: referentie, EAN13 of patroon (standaard PS{id_product}-{id_product_attribute}). Een bestaande SKU verandert nooit, ook niet als de referentie verandert.

Prijzen

De prijs wordt berekend in de valuta van de marktplaats met de gekozen prijsgroep, waarna de opslag, het vaste bedrag en de afronding van het land worden toegepast. Opties in het tabblad Instellingen:

• Winkelkortingen toepassen: specifieke prijzen en catalogusregels worden in de Amazon-prijs verwerkt.
• Winkelkortingen als Amazon-actieprijzen verzenden: de normale prijs blijft de referentieprijs en de korting wordt een actieprijs met de data van de PrestaShop-korting. Een aangemaakte, gewijzigde of verwijderde korting werkt Amazon direct bij; gedateerde acties en catalogusregels worden elke nacht opnieuw gecontroleerd.
• Minimale marge op inkoopprijs: verstuurt een minimumprijs (omgerekende inkoopprijs plus marge, incl. btw van het land) waaronder een repricer niet kan verkopen.
• Amazon Business-prijzen: de prijs van de gekozen klantengroep wordt de Business-prijs en haar staffelkortingen worden staffels (maximaal 5). Alleen voor verkopers die bij Amazon Business zijn ingeschreven.

Prijsupdates raken alleen de aanbiedingen die de module beheert: een aanbod dat in Seller Central met de hand voor een andere doelgroep is aangemaakt, blijft behouden.

Voorraad en FBA

Elke voorraadbeweging in PrestaShop zet de SKU in de verzendwachtrij. Beschikbare instellingen: veiligheidsvoorraad (eenheden die niet op Amazon worden aangeboden), maximaal aantal, verwerkingstijd, aantal 0 voor gedeactiveerde producten en een volledige hersynchronisatie elke nacht na 3 uur.

FBA-producten krijgen geen aantal uit PrestaShop. De optie FBA-voorraad lezen haalt elk uur de beschikbare voorraad in de Amazon-magazijnen op en toont die op de productpagina; FBA-voorraad naar PrestaShop kopiëren past die toe op de winkelvoorraad van FBA-producten.

Bestellingen

Bestellingen worden gelezen met de Orders API v2026-01-01 vanaf de ingestelde startdatum. Een bestelling die op betaling wacht wordt onthouden maar niet aangemaakt; ze wordt geïmporteerd zodra Amazon ze vrijgeeft voor verzending.

Elke geïmporteerde bestelling maakt een gastklant aan of hergebruikt die (één per koper of één gezamenlijke klant, naar keuze), een adres „Amazon + bestelnummer” en een PrestaShop-bestelling met de Amazon-vervoerder, de prijzen en verzendkosten van Amazon, het Amazon-bestelnummer als transactie-ID en optioneel de aankoopdatum van Amazon. De voorraad wordt verlaagd zoals bij een verkoop in de winkel.

FBA-bestellingen worden geïmporteerd zodra ze verzonden zijn, met de status „Amazon FBA: verzonden”. De optie „FBA-bestellingen wijzigen de winkelvoorraad niet” zet de aantallen na het aanmaken terug.

Het tabblad Bestellingen toont alle Amazon-bestellingen met de filters „Te verzenden”, „Annuleringsverzoeken”, „Terugbetaald” en „Niet geïmporteerd”. Een niet geïmporteerde bestelling (onbekende SKU, valuta of land niet ingesteld) toont de oorzaak en een knop Opnieuw proberen.

Verzendingen

Kies in de instellingen de statussen die de verzending bevestigen (bijvoorbeeld Verzonden). Wanneer een Amazon-bestelling een van die statussen krijgt, stuurt de module de vervoerderscode, het trackingnummer en de verzenddatum naar Amazon. Is het trackingnummer nog niet ingevuld, dan wacht de module tot een uur voordat ze zonder tracking bevestigt.

De tabel met vervoerderskoppelingen verbindt elke PrestaShop-vervoerder met een Amazon-vervoerderscode. Geïmporteerde bestellingen gebruiken de Amazon-vervoerder: wijzig de vervoerder van de bestelling vóór verzending zodat de juiste code wordt verstuurd. Het Amazon-blok op de bestelpagina heeft ook een knop Verzending nu bevestigen.

Facturen

Bent u ingeschreven voor de btw-berekeningsservice van Amazon met de optie om uw eigen facturen te uploaden, schakel dan PrestaShop-facturen uploaden naar Amazon in. Na de verzendbevestiging wordt de pdf-factuur van de bestelling verstuurd met het nummer, het totaal en het btw-bedrag. De status (verzonden, in afwachting, afgewezen) staat in de lijst en op de bestelpagina.

Annuleringen

Vraagt een koper een niet-verzonden bestelling te annuleren, dan wordt de bestelling rood gemarkeerd in de lijst en op haar pagina, met de reden van de koper. Verzend niet: annuleer de bestelling vanuit het Amazon-blok met de juiste reden, of schakel Annuleren op Amazon wanneer de bestelling in PrestaShop wordt geannuleerd in. Een annulering op verzoek van de koper wordt verstuurd met de reden BuyerCanceled en telt niet mee in uw annuleringspercentage.

Omgekeerd krijgt een op Amazon geannuleerde bestelling in PrestaShop de gekozen annuleringsstatus, zonder e-mail naar de klant.

Terugbetalingen

Met de optie Amazon-terugbetalingen lezen worden terugbetalingen in Seller Central gelezen via de Finances API. Elke terugbetaling wordt in de privénotitie van de bestelling vermeld met datum, artikelen en nettobedrag. Zijn alle eenheden terugbetaald, dan krijgt de bestelling de gekozen status (standaard Terugbetaald). Het getoonde bedrag is het nettobedrag dat op uw Amazon-account is geboekt, na de terugbetaalde kosten.

Dashboard, meldingen en log

Het dashboard toont actieve en foutieve aanbiedingen, bestellingen van de laatste 24 uur en 30 dagen, openstaande taken, de laatste synchronisatie, de meest voorkomende Amazon-fouten per code en de laatst verzonden feeds.

De dagelijkse meldingsmail gaat na 8 uur naar de gekozen ontvangers, alleen als er actie nodig is: annuleringsverzoeken, bestellingen die meer dan 2 dagen na aankoop niet als verzonden zijn bevestigd, niet geïmporteerde bestellingen, afgewezen facturen, foutieve aanbiedingen, afgewezen feeds, gestopte cron. De knop Test-e-mail verzenden controleert de instellingen.

Het tabblad Logs bewaart elke handeling (feeds, bestellingen, verzendingen, terugbetalingen, FBA, fouten) met technische details, te filteren op niveau en kanaal. De bewaartermijn stelt u in bij de instellingen.

Problemen oplossen

De verbindingstest mislukt

Controleer de gekozen regio, de LWA-client, het geheim en de refresh token. Een refresh token hoort bij één applicatie en één account: genereer hem opnieuw nadat u de rollen van de applicatie hebt gewijzigd.

Een aanbieding heeft een fout

Open de productpagina: de Amazon-fouten staan onder elke aanbieding. Code 90220 betekent dat een verplicht attribuut ontbreekt; vul het aan in de categoriekoppeling of in de extra attributen van het product. Gebruik Controleren bij Amazon om de correctie vóór verzending te valideren.

Een bestelling wordt niet geïmporteerd

De reden staat in het tabblad Bestellingen. Meestal gaat het om een Amazon-SKU die bij geen enkel product hoort: koppel bestaande aanbiedingen of corrigeer de referentie en klik op Opnieuw proberen. Controleer ook of de valuta en het afleverland actief zijn in PrestaShop.

Voorraad of prijzen worden niet bijgewerkt

Controleer de laatste synchronisatie in het dashboard en in de log. Updates gaan bij de volgende cron-run weg en Amazon verwerkt ze binnen enkele minuten. Gebruik Alle aantallen opnieuw verzenden om een volledige verzending te forceren.

Compatibiliteit

• PrestaShop 8.0 tot 9.x, dezelfde ZIP dekt beide versies.
• Multistore en meertalig.
• Amazon-regio’s Europa, Noord-Amerika en Verre Oosten.
• Architectuur ModuleAdminController, zonder Composer-afhankelijkheden.
• Interface beschikbaar in het Frans, Engels, Spaans, Duits, Italiaans, Nederlands, Pools en Portugees.