Met de Fabrixa print-on-demand-oplossing API kan elk POD-platform of elke webwinkel een bestelling versturen en de levenscyclus ervan volgen via order.created en order.updated webhooks, en laat Fabrixa het in white-label-uitvoering bedrukken, verpakken en verzenden — vanaf één stuk, in de hele EU. Jij zorgt voor de aankoopervaring; wij verzorgen de flexibele textielproductie daarachter. Geen minimumafname, geen opstartkosten, geen Fabrixa-logo op het pakket.
Dit bericht biedt een overzicht in begrijpelijke taal van de API-integratie (v2) voor ontwikkelaars die Fabrixa als fulfilmentlaag overwegen. Als je liever de referentiedocumentatie wilt doorbladeren, dan is de volledige API-documentatie en stap voor stap integratiegids zijn er klaar voor als jij er klaar voor bent.
Waarvoor dient de API?
Fabrixa is een platform voor reactief textieldruk: één dashboard voor verkoopkanalen, ontwerpen, productie en verzending. De meeste klanten maken verbinding via Shopify, WooCommerce of Fabrixa Studio. De API-integratie is de vierde optie — ontwikkeld voor POD-platforms en ontwikkelaars die al een eigen webwinkel hebben en programmatische controle willen over de afhandeling van bestellingen.
Je belt API om bestellingen door te geven. Fabrixa zorgt voor de productie: reactieve bedrukking op katoen en linnen in Portugal en Spanje, en sublimatiedruk op polyester in Nederland. De pakketten worden verzonden onder jouw merknaam, met jouw retouradres, en er staan nergens op de verpakking vermeldingen van Fabrixa. Je klanten komen nooit te weten dat wij bestaan, tenzij je het ze zelf vertelt.
Wat de API doet
- Ping — een eenvoudige controle om te verifiëren of je inloggegevens en verbinding in orde zijn, voordat je daadwerkelijk gegevens verstuurt.
- Producten — bekijk de catalogus waarop je je werk baseert: kleding, woontextiel en stoffen per meter, met de basisartikelen en varianten die beschikbaar zijn voor bedrukking.
- Bestellingen — een bestelling aanmaken en de status ervan opvragen. Dit vormt de kern van elke integratie: rijen, bronnen, klant- en verzendgegevens worden ingevoerd; een bestelling met trackingnummer wordt teruggestuurd.
- Uitvoeringen — houd de productie en verzending bij naarmate artikelen worden geproduceerd en verzonden, zodat je platform de verkopers een nauwkeurig statusoverzicht kan bieden.
- Studio — voeg een gepersonaliseerd ontwerp toe in Fabrixa Studio (onze in te bouwen, white-label productconfigurator) aan een bestelling toe te voegen op basis van de
cart_item_key, dus wat de koper heeft ontworpen, wordt precies zo afgedrukt.
Authenticatie en rate limits
De Integration API (v2) is te vinden op de basis-URL https://api.fabrixa.com/v2/integration. Elk verzoek bevat twee kopteksten:
| Kop | Doel |
|---|---|
Autorisatie: Toonhouder |
Je API-token — identificeert het verzoek en geeft hiervoor toestemming. |
X-Application-Key: |
Je applicatiesleutel — vormt een koppel met het token, dus beide moeten aanwezig zijn. |
De tarieflimiet is 30 verzoeken per minuut. Dat is ruim voldoende voor bestellingsgedreven verkeer, maar het betekent wel dat bulkbewerkingen in een rustig tempo moeten worden uitgevoerd in plaats van in een strakke lus. Ga op een soepele manier om met de limiet: trek je terug zodra je die bereikt, en maak gebruik van webhooks (zie hieronder) in plaats van polling.
Webhooks: reageer op de status, ga er niet steeds naar op zoek
In plaats van steeds te vragen “is het al klaar?”, kun je je abonneren op webhooks en Fabrixa je laten weten wanneer er iets verandert. De integratie API genereert twee gebeurtenissen:
- order.created — wordt geactiveerd wanneer een bestelling in productie wordt opgenomen. Gebruik deze functie om de ontvangst aan je verkoper te bevestigen en de bestelling als ‘in behandeling’ te markeren.
- order.updated — activeringen terwijl de order door de productie- en verzendprocessen loopt, inclusief het volgen ervan. Gebruik deze functie om de status van je platform up-to-date te houden zonder je limiet te overschrijden.
Tussen twee gebeurtenissen en een limiet van 30 per minuut raakt een goed functionerende integratie die limiet nauwelijks: verstuur de opdracht en reageer vervolgens op wat er terugkomt.
De orderstroom, van begin tot eind
Welke route je ook kiest, de vorm is hetzelfde:
- Verbinden — een webwinkel (Shopify of WooCommerce) of het API.
- Ontwerp — personaliseer het ontwerp in Fabrixa Studio, of lever een drukklare PDF aan.
- De bestelling verzenden — via het API-systeem, met productrijen, klant- en verzendadres.
- Wij produceren en verzenden — Fabrixa verzorgt het drukken, verpakken en verzenden, onder eigen merknaam.
Even een opmerking over de kwaliteit, want dat is de reden waarom verkopers voor reactieve verf kiezen: de reactieve kleurstof vormt een covalente binding met de cellulose in de katoenvezel en wordt onder invloed van hitte en stoom permanent gefixeerd. De kleur wordt onderdeel van de vezel — geen oppervlaktelaag, geen barsten op buigpunten — waardoor het aanvoelt als onbedrukt katoen en de kleur doorgaans meer dan 600 wasbeurten behoudt. Wat de levertijd betreft: kleding die in Portugal wordt gemaakt, heeft een levertijd van ongeveer 6–9 werkdagen.
Waarom platforms gebruikmaken van Fabrixa
- MOQ 1 — van één stuk tot tienduizenden. Geen minimumafname, geen instelkosten, geen contracten.
- Standaard white-label — op elk pakket staat het merk van de klant, niet het onze.
- Korte toeleveringsketen binnen de EU — productie in Portugal, Spanje en Nederland, geen langeafstandsvracht.
- Echte reactieve druk — GOTS-gecertificeerd biologisch katoen als standaardbasis, plus OEKO-TEX Standard 100 en Made in Green.
Veelgestelde vragen
Moet ik Fabrixa Studio gebruiken om de API te kunnen gebruiken?
Nee. Studio is optioneel. Je kunt in plaats daarvan een drukklare PDF bij de bestelling meesturen. Studio komt pas in beeld als je wilt dat kopers een product in je webshop kunnen personaliseren, en je dat ontwerp aan de bestelling toevoegt door cart_item_key.
Hoe verifieer ik verzoeken?
Stuur bij elke aanroep twee headers mee: Autorisatie: Toonhouder en X-Application-Key:. Beide zijn samen vereist — als de ene ontbreekt, wordt de aanvraag afgewezen.
Wat gebeurt er als ik de limiet bereik?
De API-limiet ligt op 30 verzoeken per minuut. Als je dit aantal overschrijdt, wacht dan even en probeer het opnieuw, in plaats van het endpoint te overbelasten. Gebruik voor statuswijzigingen de order.created en order.updated webhooks in plaats van polling — zo blijf je op de hoogte zonder dat je verzoeken hoeft te versturen.
Is de afhandeling echt white-label?
Ja. Pakketten worden standaard onder je merknaam verzonden, met je retouradres en zonder Fabrixa-branding. Je eindklanten krijgen ons nooit te zien.
Begin met bouwen
De snelste manier om binnen te komen is de integratiegids, met de volledige steun van de API-documentatie. Als je liever eerst wilt zien hoe het geheel in elkaar zit, dan is de platformoverzicht loopt door de verschillende fasen: Studio, productie en verzending. En als je wilt testen of iets geschikt is voor jouw platform, praat met ons team — we nemen graag je gebruiksscenario met je door.
