Sync Etsy voor PrestaShop: documentatie

Sync Etsy verbindt uw PrestaShop-winkel met uw Etsy-shop: het exporteert uw producten als listings, houdt uw voorraad gelijk en importeert uw Etsy-bestellingen automatisch in PrestaShop. Deze gids behandelt de installatie, de verbinding met Etsy, de instellingen en het dagelijkse gebruik.

Vereisten

• Een werkende PrestaShop 8- of 9-winkel, met toegang tot de backoffice.
• Een actieve Etsy-shop.
• Een toepassing die op het ontwikkelaarsportaal van Etsy is geregistreerd (gratis), zie de volgende stap.
• Een cron op de server (of een externe cron-dienst) om de voorraadsynchronisatie en het importeren van de bestellingen te automatiseren.

Installatie

1. Ga in de PrestaShop-backoffice naar Modules > Modulebeheer.
2. Klik op Een module installeren en plaats het bestand dfetsy.zip.
3. Klik na de installatie op Configureren. U komt op de beheerpagina van de module, die uit tabbladen bestaat: Verbinding, Producten, Bestellingen, Instellingen, Cron en Logboeken.

Uw Etsy-toepassing aanmaken

De module verbindt met Etsy via uw eigen ontwikkelaarstoepassing. De procedure is gratis en duurt enkele minuten.

1. Ga naar het ontwikkelaarsportaal van Etsy (etsy.com/developers) en maak een nieuwe toepassing aan.
2. Etsy geeft u een API-sleutel, de keystring (dat is uw Client ID).
3. Geef in de configuratie van uw Etsy-toepassing de omleidings-URL (Callback URL) op, precies zoals die in het tabblad Verbinding van de module staat.

Verbinden met Etsy

In het tabblad Verbinding:

1. Plak uw keystring in het daarvoor bestemde veld en klik op Opslaan.
2. Klik op Mijn Etsy-shop verbinden. Er opent een Etsy-tabblad dat u vraagt de toepassing toe te laten.
3. Na de toelating komt u op een bevestigingspagina. Ga terug naar de backoffice en herlaad de pagina: de banner hoort Verbonden te tonen, met de naam en de identificatie van uw shop.
4. Gebruik de knop De verbinding testen om na te gaan of alles werkt.

Het toegangstoken wordt automatisch door de module ververst. De knop Verbinding verbreken wist de tokens en de koppeling met de shop.

Instellingen

Het tabblad Instellingen bundelt het synchronisatiegedrag en de standaardkenmerken voor Etsy.

Synchronisatie

• De PS-voorraad naar Etsy sturen: elke wijziging van een hoeveelheid komt in de wachtrij en vertrekt bij de volgende crondoorloop.
• Het listing bijwerken bij elke productopslag: exporteert het listing automatisch opnieuw wanneer u een gekoppeld product wijzigt.
• De Etsy-bestellingen importeren: schakelt het automatisch importeren van de betaalde bestellingen in.
• De productafbeeldingen versturen: voegt de afbeeldingen van het product bij het listing tijdens de export.
• De prijzen synchroniseren: stuurt de PrestaShop-prijs naar Etsy.
• Prijsopslag voor Etsy (%): past een percentage op de geëxporteerde prijs toe om de Etsy-kosten op te vangen, zonder de PrestaShop-prijs aan te raken.
• Exporttaal: de taal van de titel en de beschrijving van de listings.

Standaardkenmerken voor Etsy

• Wie het maakte en wanneer: de verplichte Etsy-waarden (who_made en when_made) die op nieuwe listings gelden.
• Taxonomy ID: de standaard Etsy-categorie van de listings (zie de Seller Taxonomy van Etsy).
• Verzendprofiel en Retourbeleid: lijsten die automatisch uit uw Etsy-shop worden geladen zodra u verbonden bent.
• Status van het listing bij de export: Concept (aanbevolen, u leest na vóór u publiceert) of Actief (meteen publiceren, waarbij Etsy plaatsingskosten aanrekent).

Bestellingen importeren

• Besteltoestand: de PrestaShop-status die geïmporteerde bestellingen krijgen.
• Vervoerder: de standaard gekoppelde vervoerder.
• PrestaShop-e-mails versturen bij het importeren: standaard uit, want Etsy verwittigt de koper al. In de meeste gevallen laat u dat uit staan.

Producten naar Etsy exporteren

Zoek in het tabblad Producten een artikel op naam, referentie of identificatie.

• Naar Etsy exporteren maakt een listing met de titel, de beschrijving, de tags, de afbeeldingen en de prijs van het product. Het listing wordt als concept aangemaakt (of als actief, volgens uw instellingen), en daarna vertrekt de voorraadinformatie (SKU, prijs en hoeveelheid).
• Bijwerken stuurt de gegevens opnieuw naar een listing dat al gekoppeld is.
• Koppelen (listing-ID) koppelt een PrestaShop-product handmatig aan een bestaand Etsy-listing, door de identificatie van het listing in te vullen.
• Ontkoppelen wist de koppeling (het Etsy-listing zelf verdwijnt niet).

Voorraadsynchronisatie

Wijzigt de hoeveelheid van een gekoppeld product in PrestaShop, dan komt er een synchronisatietaak in een ontdubbelde wachtrij. Er vertrekt tijdens het surfen geen enkele aanroep naar Etsy: de wachtrij wordt door de cron verwerkt, wat elke vertraging aan de front- en de backoffice voorkomt. U kunt de verwerking ook handmatig starten vanuit het tabblad Cron.

Bestellingen importeren

Betaalde Etsy-bestellingen komen als PrestaShop-bestellingen binnen:

• Er wordt een gastklant aangemaakt (of hergebruikt als die voor dat e-mailadres al bestaat).
• Het Etsy-leveradres wordt overgenomen. Wordt het land niet herkend, dan wordt de bestelling overgeslagen en verschijnt er een melding in de logboeken.
• De betaalde prijs wordt tot op de cent toegepast: het totaal van de PrestaShop-bestelling komt overeen met het bedrag dat op Etsy is betaald.
• De opmerking van de koper komt als bericht in de klantenservicedraad van de bestelling.
• Een dubbelcontrole op de Etsy-bestelidentificatie (receipt) voorkomt elk dubbel importeren.

De cron instellen

Het tabblad Cron toont een URL die met een token is beveiligd. Roep die om de 5 tot 15 minuten aan om de wachtrij (voorraad en producten) te verwerken en de nieuwe bestellingen te importeren.

*/10 * * * * curl -s "https://uw-winkel/index.php?fc=module&module=dfetsy&controller=cron&token=UW_TOKEN" > /dev/null

Met de knop De wachtrij nu uitvoeren start u een handmatige verwerking om te testen.

Logboeken en diagnose

Het tabblad Logboeken toont het gebeurtenissenjournaal (export, voorraad, import en fouten). Loopt er iets mis bij een synchronisatie, kijk daar dan eerst: elke Etsy-fout komt er met haar melding in terecht. Vermeldingen ouder dan 30 dagen worden automatisch opgeruimd.

Grenzen van versie 1.0

• Eén product is één listing met één referentie (geen native Etsy-variaties).
• Eén Etsy-shop tegelijk verbonden.
• De zendingsopvolging gaat nog niet naar Etsy terug.
• De gedetailleerde verdeling van de verzendkosten per regel wordt niet heropgebouwd (het totaal dat op Etsy is betaald, geldt).

Veelgestelde vragen

Worden mijn listings automatisch gepubliceerd?

Standaard niet: zij worden als concept aangemaakt zodat u ze kunt nalezen vóór u ze op Etsy publiceert. U kunt in de instellingen voor de status « Actief » kiezen om meteen te publiceren.

Hoe voorkom ik oververkoop tussen de twee kanalen?

Schakel de voorraadsynchronisatie in en zorg voor een regelmatige cron: elke verkoop of hoeveelheidswijziging in PrestaShop werkt de Etsy-hoeveelheid bij de volgende crondoorloop bij.

Waar vind ik de broncode?

De volledige code zit onversleuteld in de ZIP (PSR-4, SPL-autoloader), klaar voor audit of aanpassing.