Er zijn twee manieren om bestellingen naar Fabrixa te verzenden: koppel de webwinkel die je al beheert — Shopify of WooCommerce — zonder te hoeven programmeren, of bouw rechtstreeks via de API-integratie. In deze handleiding komen beide manieren aan bod: koppel een verkoopkanaal binnen enkele minuten, of doorloop het hele proces van autorisatie tot afhandeling in een kwartier.
De meeste winkels maken nooit gebruik van API. Voeg Fabrixa toe als verkoopkanaal en bestellingen uit je winkel worden direct naar de productie doorgestuurd — producten worden gesynchroniseerd, statussen worden teruggemeld, en je hoeft geen code te schrijven of te onderhouden. De API-route verderop is bedoeld voor aangepaste webwinkels en POD-platforms.
Open in je dashboard Create channel en kies het type integratie. Elk kanaal behoudt zijn eigen producten, geïmporteerde bestellingen en importregels — je kunt er zoveel koppelen als je wilt.
Er hoeven geen sleutels te worden gekopieerd. Geef Fabrixa toestemming via je Shopify-beheerderspaneel en de verbinding is actief.
Create channel, kies Shopify.Een WordPress-webwinkel maakt verbinding via een REST-sleutelpaar voor lezen en schrijven — dat in WooCommerce wordt gegenereerd en eenmalig in Fabrixa wordt ingevoerd.
Settings → Advanced → REST API → Add key met Lezen/Schrijven machtigingen.ck_ sleutel, cs_ het wachtwoord en het domein van je winkel in Fabrixa.Verkoop je producten op maat? Fabrixa Studio — de white-label-ontwerpeditor — is ook beschikbaar in Shopify- en WooCommerce-winkels, zodat je klanten producten onder jouw merknaam kunnen personaliseren. Zie Fabrixa Studio →
Aangesloten winkels staan naast je API- en partnerkanalen in het overzicht ‘Kanalen’ — gesynchroniseerde producten, ontvangen bestellingen, de laatst geïmporteerde referentie en omzet per kanaal. Zet een kanaal van ‘concept’ naar ‘live’ zodra je er klaar voor bent; er verandert verder niets in de keten.
Wil je liever een op maat gemaakte webwinkel bouwen of je eigen POD-platform? De rest van deze handleiding gaat over de API-aanpak: van authenticatie tot afhandeling in vier stappen.
Er zijn drie stappen die je van nul naar een live-order brengen. Deze worden allemaal in gang gezet via je Fabrixa-dashboard of door je solutions engineer.
Een applicatietoegangstoken en een applicatiesleutel. Beide zijn bij elk verzoek vereist: het token in de Authorization-header en de sleutel in X-Application-Key. Maak een verkoopkanaal aan in je dashboard om ze direct te genereren — hiervoor is geen verzoek nodig.
Een voor het publiek toegankelijk HTTPS-endpoint dat JSON POST-verzoeken accepteert. Localhost werkt tijdens de ontwikkeling via een tunnel. Je controleert de HMAC-SHA256-handtekening van elke payload voordat je deze verwerkt.
Je ontwerpbestand — PDF, TIFF, JPG of PNG — moet via HTTPS zonder authenticatie toegankelijk zijn. RGB-kleur, maximaal 50 MB en 15.000 px per zijde. Bij PDF’s met meerdere pagina’s geldt: één pagina per laag. Wij halen het bestand op en genereren de juiste drukbestanden wanneer we de opdracht verwerken.
Elk verzoek wordt naar de basis-URL gestuurd https://api.fabrixa.com/v2/integration waarbij beide headers zijn ingesteld. GET /ping controleert of het token en de sleutel geldig zijn voordat je verdergaat.
A 401 betekent dat er een header ontbreekt of dat het token is ingetrokken. Een 403 betekent dat de inloggegevens weliswaar geldig zijn, maar dat er geen toestemming is voor de bron.
# Verify auth before anything else curl https://api.fabrixa.com/v2/integration/ping \ -H "Accept: application/json" \ -H "Authorization: Bearer APPLICATION_ACCESS_TOKEN" \ -H "X-Application-Key: APPLICATION_KEY" # 200 OK → credentials valid # 401 → missing header or revoked token # 403 → valid, but no access to the resource
De catalogus geeft productvarianten weer met hun SKU en variant_id. Elk antwoord op de lijst wordt omgeven door de standaard links / meta / data envelope, dus pagineren met de next_page link. Lokaal in de cache opslaan — de catalogus wordt niet per verzoek opgevraagd.
Alle details over het veld staan in de Swagger-referentie.
GET /v2/integration/products?page=1
{
"links": {
"self": ".../products?page=1",
"next_page": ".../products?page=2",
"prev_page": null
},
"meta": { "total": 248, "current_page": 1, "per_page": 10 },
"data": [
{ "id": 1306, "name": "Unisex AOP T-shirt", "SKU": "COF099191" }
]
}
Verzenden rows (SKU + aantal + een bron-PDF), customer en shipping_address. Stel je eigen number als referentie — laat deze weg en wij genereren er een. Sla het geretourneerde Fabrixa-order-id op bij je bestelling.
Bij Studio-bestellingen vervang je sources door een cart_item_key — al het andere is hetzelfde.
POST /v2/integration/orders
{
"number": "ORD-2026-0142",
"purchased_at": "2026-05-28 14:22:01",
"rows": [
{
"sku": "COF099191",
"quantity": 1,
"sources": [
{ "type": "file", "url": "https://cdn.you.com/art/9812.pdf" }
]
}
],
"customer": {
"first_name": "Maria", "last_name": "Silva",
"email": "maria@example.com", "phone": "+351912345678"
},
"shipping_address": {
"address": "Rua do Carmo 42", "city": "Lisboa",
"postal_code": "1200-094",
"country_code": "PT", "country": "Portugal"
}
}
Stel je webhook-URL in via het dashboard. We sturen daar een POST met order.created en order.updated naartoe, met de volledige body van de bestelling, een x-webhook-signature (HMAC-SHA256) en een x-webhook-topic header. Controleer de handtekening, stuur snel een 200 terug en verwerk asynchroon.
Alle gebeurtenissen en de verificatiefragmenten staan op de webhooks referentie.
# Request headers content-type: application/json x-webhook-topic: order.updated x-webhook-signature: YmEwNjBhMGMy...AxMw== # Body (truncated) { "id": 23069, "number": "1250211835", "status": "imported", "fulfillment_status": "unfulfilled", "updated_at": "2026-05-28T07:43:52Z" }
Fouten worden weergegeven als JSON, nooit als HTML. De errors.messages array geeft aan wat er mis is gegaan; bij een 400-fout worden de velden weergegeven die niet zijn gevalideerd.
Validatiefout, ontbrekende of ingetrokken inloggegevens, onvoldoende rechten of onbekende bron.
30 verzoeken per applicatie per minuut. X-RateLimit-Limit en X-RateLimit-Remaining staan in elk antwoord.
Aan de serverzijde. Probeer het opnieuw met een back-off; als het probleem zich blijft voordoen, stuur dan het verzoek-ID naar je solutions engineer.
{
"links": { "self": ".../v2/integration/orders" },
"meta": [],
"errors": {
"messages": [
"Application Key is not specified."
]
}
}
Voor ondersteuning bij integratie, problemen met inloggegevens of verkoopkanalen, specifieke vereisten of capaciteitsplanning: neem contact op met het technische SE-kanaal, niet met de verkoopafdeling. Reactie binnen één werkdag.
