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 authenticatie tot fulfilment in een kwartier.
De meeste winkels maken nooit gebruik van de 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 fulfilment in vier stappen.
Drie dingen brengen je van nul naar een live bestelling. Alle drie worden verstrekt via je Fabrixa-dashboard of door je solutions engineer.
Een Application Access Token en een Application Key. 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.
Status 401 betekent dat er een header ontbreekt of dat het token is ingetrokken. Status 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.
Studio-opdrachten vervangen de sources bestand met de cart_item_key van het opgeslagen ontwerp; al het andere is identiek.
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."
]
}
}
Fabrixa staat 30 verzoeken per applicatie per minuut toe; als deze limiet wordt overschreden, wordt een 429 Too Many Requests-antwoord teruggestuurd. De headers X-RateLimit-Limit en X-RateLimit-Remaining worden bij elk antwoord meegestuurd, zodat een integratie het resterende quotum kan bijhouden voordat de limiet wordt bereikt.
Fabrixa accepteert PDF-, TIFF-, JPG- of PNG-bestanden in RGB-kleur, met een maximale grootte van 50 MB en 15.000 px per zijde, die via HTTPS zonder authenticatie toegankelijk zijn. PDF’s met meerdere pagina’s worden behandeld als één pagina per laag, en Fabrixa haalt het bestand zelf op om de juiste drukbestanden samen te stellen wanneer de opdracht wordt verwerkt.
Ga in WooCommerce naar Instellingen, vervolgens naar Geavanceerd en daarna naar REST API, en voeg daar een sleutel toe met lees- en schrijfrechten. Plak de gegenereerde ck_-sleutel, het cs_-geheim en het domein van je winkel in Fabrixa, sla de wijzigingen op, en de bestellingen worden automatisch gesynchroniseerd — de importregels kun je later aanpassen in de kanaalinstellingen.
Voordat je een eerste bestelling plaatst, heb je een Application Access Token en een Application Key van een verkoopkanaal nodig, een openbaar HTTPS-webhook-endpoint dat de HMAC-SHA256-handtekening op elke payload verifieert, en afbeeldingen die via HTTPS zonder authenticatie toegankelijk zijn. Deze drie worden allemaal uitgegeven of geconfigureerd via het Fabrixa-dashboard, en de inloggegevens worden direct gegenereerd wanneer het verkoopkanaal wordt aangemaakt.
Een 403-foutcode betekent dat het Application Access Token en de Application Key weliswaar geldig zijn, maar dat er geen toestemming is voor de aangevraagde bron. Dit verschilt van een 401-foutcode, die aangeeft dat een vereiste header ontbreekt of dat het token is ingetrokken; beide kunnen worden gecontroleerd met een GET /ping-verzoek voordat je verder gaat met de ontwikkeling.
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.
Je kunt verbinding maken via onze REST API en een productfeed, en Fabrixa Studio, onze ontwerp-editor, kan in je eigen platform worden geïntegreerd, zodat deze als een eigen functie van je platform wordt weergegeven.
Lees het antwoord →Het project bevindt zich momenteel in de ontwikkelingsfase; ons team werkt aan het geautomatiseerd indienen van bestellingen, het synchroniseren van producten, prijzen en voorraden, en het automatisch volgen van retourzendingen.
Lees het antwoord →Bronnen voor ontwikkelaars: API-documentatie https://www.fabrixa.com/developers/api-documentation · Integratiehandleiding https://www.fabrixa.com/developers/integration-guide/ · Webhooks https://api.fabrixa.com/docs/integration#webhooks
Lees het antwoord →Alle 8 antwoorden over Integraties & API → Neem contact op met ons ondersteuningsteam →
