Der er to måder at sende ordrer til Fabrixa på: Du kan forbinde den webshop, du allerede driver — Shopify eller WooCommerce — uden at skulle programmere, eller du kan oprette en konto direkte via API-integrationen. Denne vejledning dækker begge muligheder: Forbind en salgskanal på få minutter, eller gå fra godkendelse til ekspedition på femten minutter.
De fleste butikker bruger aldrig API. Tilføj Fabrixa som salgskanal, og ordrer fra din butik sendes direkte til produktionen — produkterne synkroniseres, statusoplysninger sendes tilbage, og der er ingen kode, der skal skrives eller vedligeholdes. API-vejen længere nede er beregnet til tilpassede butiksfronter og POD-platforme.
Åbn følgende i dit kontrolpanel: Create channel og vælg din integrationstype. Hver kanal har sine egne produkter, importerede ordrer og importregler — du kan tilslutte lige så mange, som du bruger.
Der er ingen nøgler, der skal kopieres. Godkend Fabrixa fra din Shopify-administrationsside, så er forbindelsen klar.
Create channel, vælg Shopify.En WordPress-butik opretter forbindelse ved hjælp af et REST-nøglepar til læse-/skriveadgang — genereret i WooCommerce og indsat én gang i Fabrixa.
Settings → Advanced → REST API → Add key med Læs/Skriv rettigheder.ck_ nøgle, cs_ adgangskoden og dit butiksdomæne i Fabrixa.Sælger du skræddersyede produkter? Fabrixa Studio — designredigeringsværktøjet til white-label — findes også i Shopify- og WooCommerce-butikker, så dine kunder kan tilpasse produkterne under dit brand. Se Fabrixa Studio →
De tilknyttede butikker vises ved siden af dine API- og partnerkanaler i visningen »Kanaler« — synkroniserede produkter, modtagne ordrer, den senest importerede reference og omsætning pr. kanal. Skift en kanal fra udkast til live, når du er klar; det ændrer ikke noget i de efterfølgende led.
Vil du hellere oprette en skræddersyet webshop eller din egen POD-platform? Resten af denne vejledning beskriver API-metoden — fra brugergodkendelse til levering i fire trin.
Der er tre ting, der fører dig fra nul til en aktiv ordre. De udstedes alle fra dit Fabrixa-dashboard eller af din løsningsingeniør.
Et applikationsadgangstoken og en applikationsnøgle. Begge dele skal angives ved hver anmodning — tokenet i Authorization-headeren og nøglen i X-Application-Key. Opret en salgskanal i dit kontrolpanel for at generere dem med det samme — der kræves ingen anmodning.
Et offentligt tilgængeligt HTTPS-endpoint, der accepterer JSON POST-anmodninger. Localhost fungerer under udvikling via en tunnel. Du verificerer HMAC-SHA256-signaturen på hver enkelt datapakke, inden den behandles.
Din grafiske fil — PDF, TIFF, JPG eller PNG — skal være tilgængelig via HTTPS uden godkendelse. RGB-farve, op til 50 MB og 15.000 px pr. side. Fler-siders PDF-filer skal bestå af én side pr. lag. Vi henter filen og opretter de korrekte udskriftsfiler, når vi udfører opgaven.
Hver anmodning sendes til basis-URL’en https://api.fabrixa.com/v2/integration hvor begge overskrifter er angivet. GET /ping kontrollerer, at tokenet og nøglen er gyldige, før du foretager dig noget andet.
A 401 betyder, at en header mangler, eller at tokenet er blevet tilbagekaldt. A 403 betyder, at legitimationsoplysningerne er gyldige, men at der mangler tilladelse til ressourcen.
# 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
Kataloget viser produktvarianter med deres SKU og variant_id. Hvert svar på listen er indrammet af standard- links / meta / data konvolut, så sæt sidetal med next_page link. Gem i lokal cachen — kataloget hentes ikke ved hver forespørgsel.
Alle detaljer om feltet findes i Swagger-reference.
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" }
]
}
Send rows (SKU + antal + en PDF-fil som kilde), customer og shipping_address. Indstil dit eget number som reference — hvis du udelader den, genererer vi en. Gem det returnerede Fabrixa-ordre-id sammen med din ordre.
Bytning af studieordrer sources til en cart_item_key — alt andet er det samme.
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"
}
}
Indstil din webhook-URL i kontrolpanelet. Vi sender en POST-anmodning order.created og order.updated til den med den fulde ordretekst, en x-webhook-signature (HMAC-SHA256) og en x-webhook-topic overskrift. Bekræft signaturen, returner 200 hurtigt, behandles asynkront.
Alle begivenheder og verifikationsuddragene findes på Vejledning til webhooks.
# 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" }
Fejl returneres som JSON, aldrig som HTML. Den errors.messages array angiver, hvad der gik galt; ved en 400-fejl viser den de felter, der ikke blev godkendt.
Valideringsfejl, manglende eller tilbagekaldte legitimationsoplysninger, utilstrækkelig tilladelse eller ukendt ressource.
30 anmodninger pr. applikation pr. minut. X-RateLimit-Limit og X-RateLimit-Remaining findes i hvert eneste svar.
På serversiden. Prøv igen med back-off; hvis problemet fortsætter, skal du sende anmodnings-id’et til din løsningsingeniør.
{
"links": { "self": ".../v2/integration/orders" },
"meta": [],
"errors": {
"messages": [
"Application Key is not specified."
]
}
}
Ved spørgsmål om integrationssupport, adgangsoplysninger eller salgskanaler, specifikke krav eller kapacitetsplanlægning — skal du henvende dig til den tekniske SE-kanal, ikke salgsafdelingen. Svar inden for én hverdag.
