Met de Piggy voucher import koppel je het loyaliteitsplatform Piggy aan je webshop. De webshop haalt automatisch je actieve vouchers (kortingscodes) op uit Piggy en zet ze klaar als coupons in de shop. Klanten kunnen die codes vervolgens bij de checkout invoeren voor de bijbehorende korting.
Handig wanneer je vouchers in Piggy beheert (bijv. via spaarpunten, campagnes, of fysieke voucherkaarten) en die zonder handmatig overtypen in je webshop wilt gebruiken.
Waar vind je het?
De koppeling stel je in via de Transfer-app (de import/export manager van Mach3). Importconfiguraties worden daar als JSON-bestand opgeslagen.
Hoe werkt het?
Voorbereiding bij Piggy
- Log in op je Piggy-account.
- Maak een OAuth-app aan onder de developer-instellingen.
- Noteer de Client ID en de Client Secret — die heb je nodig voor de koppeling.
- Optioneel: noteer het Promotie-UUID als je vouchers van één specifieke promotie wilt importeren.
Importconfiguratie in de shop
- Open de Transfer-app.
- Ga naar Importconfiguraties.
- Voeg een nieuwe importconfiguratie toe met type Piggy en subtype Vouchers.
- Vul in het parameters-veld de volgende waarden in (gescheiden door
||):client_id|<jouw client id>client_secret|<jouw client secret>type|voucherspromotion_uuid|<optionele UUID>(laat leeg om álle vouchers op te halen)default_percentage|<bijv. 10>(fallback als de voucher-naam geen percentage bevat)default_fixed_price|<bijv. 5>(fallback als de voucher-naam geen vast bedrag bevat)use_one_time|1(0 = code mag meermaals gebruikt worden, 1 = eenmalig)
- Sla de configuratie op en draai de import handmatig of via een geplande taak.
Wat wordt er geïmporteerd?
Voor elke actieve voucher uit Piggy:
| Veld in shop | Bron in Piggy |
|---|---|
| Code | De voucher-code |
| Naam | De voucher-naam of, als die ontbreekt, de promotie-naam |
| Kortingspercentage | Automatisch herkend uit de naam (bijv. "10% korting" → 10%) |
| Vast kortingsbedrag | Automatisch herkend uit de naam (bijv. "€5 korting" → €5) |
| Eenmalig gebruik | Op basis van de use_one_time-parameter |
| Startdatum | De activatiedatum uit Piggy |
| Einddatum | De vervaldatum uit Piggy |
Vouchers waarvan de code langer is dan 20 tekens of die geen code hebben, worden overgeslagen.
Bevat de naam geen percentage of vast bedrag? Dan vallen de waarden terug op de default-instellingen uit de parameters.
Wanneer wordt de import uitgevoerd?
Standaard draait de import handmatig vanuit de Transfer-app. Wil je hem automatisch laten draaien (bijv. elke nacht), dan kun je een cron-job koppelen aan de importconfiguratie. Neem hierover contact op met je beheerder of partner.
Veelgestelde vragen
De import gebruikt de unieke voucher-UUID uit Piggy om de bijbehorende coupon in de shop te vinden. Bestaat de coupon al? Dan wordt deze bijgewerkt met de nieuwste data uit Piggy. Bestaat hij nog niet? Dan wordt hij aangemaakt.
Verwijderde vouchers worden niet meer opgehaald, maar bestaande coupons in de shop blijven staan. Wil je ze ook in de shop kwijt? Verwijder ze handmatig via Beheer > Coupons of laat de Transfer-app dat instellen.
Controleer:
- Zijn de Client ID en Client Secret correct ingevuld?
- Staan de vouchers in Piggy op status ACTIVE? Alleen actieve vouchers worden geïmporteerd.
- Is de voucher-code maximaal 20 tekens lang?
- Bekijk de logs in de Transfer-app voor foutmeldingen.
Ja. Laat de parameter promotion_uuid leeg, dan haalt de webshop alle actieve vouchers op, ongeacht promotie. Wil je specifieke promoties? Maak dan per promotie een eigen importconfiguratie aan.