Inleiding
Met de JSON-integratie kun je klant-, bestel- en productgegevens automatisch naar Xendy sturen vanuit je eigen systeem of webshop. Zo blijven je data dagelijks up-to-date en kun je segmenteren, personaliseren en automations inzetten op basis van actuele informatie.
Wat heb je nodig?
Je levert drie URL’s aan waar Xendy de gegevens in JSON-formaat kan ophalen:
- customers.json (klantgegevens)
- orders.json (bestelgegevens)
- products.json (productgegevens)
Deze URL’s moeten beveiligd zijn met een authenticatieheader, zodat alleen geverifieerde systemen toegang hebben.
Voorbeelden
Voorbeeld customers.json
[{
“email”: “klant@example.com”,
“first_name”: “Jan”,
“last_name”: “Jansen”,
“phone”: “+31612345678”,
“xendy_vip_status”: “gold”
}
]
Voorbeeld orders.json
[{
“email”: “klant@example.com”,
“order_date”: “2025-09-07”,
“order_id”: “12345”,
“product_id”: “sku123”,
“quantity”: 2,
“line_amount”: 49.98
},
{
“email”: “klant@example.com”,
“order_date”: “2025-09-07”,
“order_id”: “12345”,
“product_id”: “sku987”,
“quantity”: 1,
“line_amount”: 19.99
},
{
“email”: “andereklant@example.com”,
“order_date”: “2025-09-06”,
“order_id”: “54321”,
“product_id”: “sku555”,
“quantity”: 3,
“line_amount”: 74.97
}
]
Voorbeeld products.json
[{
“product_id”: “sku123”,
“name”: “Blauwe Hoodie”,
“price”: 24.99,
“product_link”: “https://jouwwinkel.nl/product/blauwe-hoodie”,
“image_url”: “https://jouwwinkel.nl/media/blauwe-hoodie.jpg”,
“xendy_category”: “wintercollectie”
}
]
Vereiste velden en extra velden
De velden zonder xendy_ prefix in de voorbeelden zijn verplicht. Deze basisvelden (zoals email, order_date, product_id, line_amount) zijn nodig om de koppeling goed te laten werken en de data correct te synchroniseren met Xendy.
Je kunt zelf extra velden toevoegen met de prefix xendy_ wanneer je meer data mee wilt sturen naar Xendy. Voorbeelden zijn xendy_vip_status, xendy_coupon of xendy_channel.
Deze extra velden worden automatisch herkend in Xendy en verschijnen onder ‘Filterregels’ bij ‘Dynamische segmenten’. Je kunt deze velden ook toevoegen in een email.
Maatwerk koppeling instellen in Xendy
Je kunt een maatwerk-koppeling nog niet zelf instellen. Zodra je de drie URL’s plus authenticatie header ingeregeld hebt kun je deze delen met support@xendy.me. Deel ook de URL van je webshop. Het instellen van je koppeling duurt ongeveer 1-2 dagen.
Hoe vaak wordt data opgehaald?
Xendy haalt de gegevens uit jouw maatwerk webshop automatisch één keer per dag in de nacht op. Zo blijft je data actueel zonder dat je hier zelf iets voor hoeft te doen. Wanneer de data niet opgehaald kan worden, ontvang je hierover pro-actief een notificatie via email.
Veelgestelde vragen
Xendy haalt de gegevens uit jouw maatwerk webshop automatisch één keer per dag in de nacht op. Zo blijft je data actueel zonder dat je hier zelf iets voor hoeft te doen. Wanneer de data niet opgehaald kan worden, ontvang je hierover pro-actief een notificatie via email.
