Existují dva způsoby, jak odesílat objednávky do Fabrixa: propojit obchod, který již provozujete – Shopify nebo WooCommerce – bez nutnosti programování, nebo vytvořit obchod přímo v integraci API. Tento průvodce se zabývá oběma možnostmi: propojte prodejní kanál během několika minut, nebo proveďte celý proces od autorizace až po vyřízení objednávky za patnáct minut.
Většina obchodů se k modelu API vůbec nedostane. Přidejte Fabrixa jako prodejní kanál a objednávky z vašeho obchodu budou směřovat přímo do výroby – produkty se synchronizují, stavy se aktualizují, nemusíte psát ani spravovat žádný kód. Model API, o kterém se zmíníme dále, je určen pro vlastní internetové obchody a platformy typu POD.
Na svém ovládacím panelu otevřete Create channel a vyberte si typ integrace. Každý kanál si uchovává své vlastní produkty, importované objednávky a pravidla importu – připojte jich tolik, kolik jich provozujete.
Není třeba kopírovat žádné klíče. Stačí v administračním rozhraní Shopify autorizovat Fabrixa a připojení je aktivní.
Create channel, vyberte Shopify.E-shop na platformě WordPress se připojuje pomocí páru klíčů REST pro čtení a zápis – tyto klíče se vygenerují v WooCommerce a jednou se vloží do Fabrixa.
Settings → Advanced → REST API → Add key s Čtení/zápis oprávnění.ck_ klíč, cs_ tajný kód a doménu vašeho obchodu zadejte do Fabrixa.Prodáváte výrobky na míru? Fabrixa Studio — editor designu typu „white label“ — je k dispozici také v obchodech Shopify a WooCommerce, takže si vaši zákazníci mohou produkty přizpůsobit pod vaší značkou. Viz Fabrixa Studio →
Propojené obchody se v zobrazení „Kanály“ zobrazují vedle vašich kanálů API a partnerských kanálů – se synchronizovanými produkty, přijatými objednávkami, naposledy importovanou referencí a tržbami podle jednotlivých kanálů. Jakmile budete připraveni, přepněte kanál z režimu „návrh“ do režimu „živý“; nic v navazujících procesech se tím nezmění.
Chcete si raději vytvořit vlastní internetový obchod nebo vlastní platformu POD? Zbytek tohoto průvodce se věnuje postupu API – od autorizace až po vyřízení objednávky ve čtyřech krocích.
K realizaci objednávky vás dovedou tři kroky. Všechny se provádějí z vašeho ovládacího panelu Fabrixa nebo prostřednictvím vašeho technického poradce.
Přístupový token aplikace a klíč aplikace. Oba jsou vyžadovány při každém požadavku – token v hlavičce Authorization, klíč v hlavičce X-Application-Key. Chcete-li je okamžitě vygenerovat, vytvořte prodejní kanál ve svém ovládacím panelu – není třeba odesílat žádný požadavek.
Veřejně přístupný HTTPS koncový bod, který přijímá požadavky typu POST ve formátu JSON. Při vývoji lze použít localhost prostřednictvím tunelu. Před zpracováním ověříte podpis HMAC-SHA256 u každého datového obsahu.
Váš grafický soubor – ve formátu PDF, TIFF, JPG nebo PNG – přístupný přes HTTPS bez ověření. Barvy RGB, maximálně 50 MB a 15 000 px na každou stranu. Více stránkové soubory PDF mají jednu stránku na jednu vrstvu. Soubor načteme a při renderování zakázky vytvoříme správné tiskové soubory.
Každý požadavek směřuje na základní URL https://api.fabrixa.com/v2/integration s nastavenými oběma záhlavími. GET /ping nejprve ověří, zda jsou token a klíč platné, než provedete jakoukoli další akci.
Stav 401 znamená, že chybí záhlaví nebo že byl token zrušen. Stav 403 znamená, že přihlašovací údaje jsou platné, ale nemají oprávnění k přístupu k danému zdroji.
# 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
Katalog vrací varianty produktů s jejich kódy SKU a variant_id. Každá odpověď v seznamu je uzavřena ve standardním links / meta / data obálka, takže stránkujte pomocí next_page odkaz. Ukládat do lokální mezipaměti – katalog není generován pro každý požadavek zvlášť.
Podrobné informace o celém poli najdete v Referenční příručka k Swaggeru.
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" }
]
}
Odeslat rows (SKU + počet + zdrojový soubor PDF), customer a shipping_address. Nastavte si vlastní number jako referenci – pokud ji vynecháte, vygenerujeme ji. Uložte vrácené ID objednávky ve formátu Fabrixa k vaší objednávce.
Objednávky studia nahrazují sources soubor s cart_item_key uloženého návrhu; vše ostatní je stejné.
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"
}
}
Nastavte si v ovládacím panelu adresu URL webhooku. Odesíláme požadavek POST order.created a order.updated k němu s úplným textem objednávky, a x-webhook-signature (HMAC-SHA256) a x-webhook-topic záhlaví. Ověřte podpis, vraťte 200 rychle, zpracovávat asynchronně.
Všechny události a úryvky k ověření jsou na stránce Referenční příručka k webhookům.
# 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" }
Chyby se vrací ve formátu JSON, nikdy v HTML. The errors.messages pole uvádí, co se nepodařilo; v případě chyby 400 uvádí pole, u nichž nedošlo k ověření.
Chyba ověření, chybějící nebo zrušené přihlašovací údaje, nedostatečná oprávnění nebo neznámý zdroj.
30 požadavků na aplikaci za minutu. X-RateLimit-Limit a X-RateLimit-Remaining jsou uvedeny v každé odpovědi.
Na straně serveru. Zkuste to znovu s prodlevou; pokud problém přetrvává, zašlete identifikátor požadavku svému technickému specialistovi.
{
"links": { "self": ".../v2/integration/orders" },
"meta": [],
"errors": {
"messages": [
"Application Key is not specified."
]
}
}
Fabrixa povoluje 30 požadavků na aplikaci za minutu; při překročení tohoto limitu je vrácena odpověď 429 Too Many Requests. V každé odpovědi jsou obsaženy hlavičky X-RateLimit-Limit a X-RateLimit-Remaining, takže integrační řešení může sledovat zbývající kvótu ještě předtím, než dojde k překročení limitu.
Fabrixa přijímá grafické soubory ve formátech PDF, TIFF, JPG nebo PNG v barevném režimu RGB, s velikostí až 50 MB a rozlišením 15 000 px na jednu stranu, které jsou dostupné přes protokol HTTPS bez nutnosti ověření. Více stránkové soubory PDF jsou zpracovávány jako jedna stránka na jednu vrstvu a Fabrixa si při vykreslování úlohy sám stáhne soubor, aby vytvořil správné tiskové soubory.
Ve WooCommerce přejděte do sekce Nastavení, poté do sekce Pokročilé, následně do sekce REST API a přidejte klíč s oprávněními pro čtení a zápis. Vložte získaný klíč ck_, tajný klíč cs_ a doménu vašeho obchodu do Fabrixa, uložte a objednávky se automaticky synchronizují – pravidla importu lze později změnit v nastavení kanálu.
Před zadáním první objednávky potřebujete přístupový token aplikace a klíč aplikace z prodejního kanálu, veřejný koncový bod webhooku HTTPS, který ověřuje podpis HMAC-SHA256 u každého datového bloku, a grafické podklady dostupné přes HTTPS bez nutnosti ověření. Všechny tři položky se vydávají nebo konfigurují z řídicího panelu Fabrixa a přihlašovací údaje se generují okamžitě při vytvoření prodejního kanálu.
Chyba 403 znamená, že přístupový token aplikace a klíč aplikace jsou platné, ale chybí oprávnění k požadovanému zdroji. To se liší od chyby 401, která znamená, že chybí povinná hlavička nebo že byl token zrušen; obojí lze před pokračováním ve vývoji ověřit pomocí požadavku GET /ping.
Ať už jde o podporu při integraci, problémy s přihlašovacími údaji nebo prodejními kanály, specifické požadavky či plánování kapacit – obraťte se na technický kanál SE, nikoli na obchodní oddělení. Odpovíme do jednoho pracovního dne.
Můžete se připojit prostřednictvím našeho rozhraní REST API a produktového feedu, přičemž náš editor designu Fabrixa Studio lze zabudovat do vaší vlastní platformy, takže bude vypadat jako vaše vlastní funkce.
Přečtěte si odpověď →V současné době je tento projekt ve fázi vývoje; náš tým pracuje na automatizovaném odesílání objednávek, synchronizaci produktů, cen a skladových zásob a automatickém sledování vrácených zásilek.
Přečtěte si odpověď →Zdroje pro vývojáře: Dokumentace k API https://www.fabrixa.com/developers/api-documentation · Průvodce integrací https://www.fabrixa.com/developers/integration-guide/ · Webhooky https://api.fabrixa.com/docs/integration#webhooks
Přečtěte si odpověď →Všech 8 odpovědí na téma „Integrace a API“ → Zeptejte se našeho týmu podpory →
