Služba Fabrixa „print on demand“ API umožňuje jakékoli platformě nebo internetovému obchodu POD odeslat objednávku a sledovat její životní cyklus prostřednictvím order.created a order.updated webhooky a nechte společnost Fabrixa zajistit tisk, balení a odeslání pod vaší vlastní značkou – a to již od jednoho kusu, a to po celé EU. Vy vytváříte nákupní zážitek; my za tím zajišťujeme flexibilní textilní výrobu. Žádné minimální objednávky, žádné zřizovací poplatky, žádné označení Fabrixa na balíku.
Tento příspěvek představuje srozumitelný přehled integrace API (v2) určený pro vývojáře, kteří zvažují využití Fabrixa jako vrstvy pro vyřizování objednávek. Pokud si raději chcete prohlédnout referenční dokument, úplná verze Dokumentace k API a krok za krokem průvodce integrací jsme připraveni, až budete připraveni.
K čemu slouží API
Fabrixa je platforma pro reaktivní textilní tisk: jeden řídicí panel pro prodejní kanály, návrhy, výrobu a expedici. Většina zákazníků se připojuje přes Shopify, WooCommerce nebo Fabrixa Studio. Integrace API představuje čtvrtou možnost – je určena pro platformy POD a vývojáře, kteří již mají vlastní internetový obchod a chtějí programově řídit proces vyřizování objednávek.
Zavoláte společnosti API, aby odeslala objednávky. Společnost Fabrixa je vyrobí: reaktivní potisk na bavlně a lnu v Portugalsku a Španělsku, sublimační potisk na polyesteru v Nizozemsku. Balíčky se odesílají pod vaší značkou, s vaší zpáteční adresou a bez jakýchkoli označení společnosti Fabrixa na obalu. Vaši zákazníci se o naší existenci nikdy nedozví, pokud jim to sami neřeknete.
Jak funguje API
- Ping — jednoduchá kontrola, která ověří, zda jsou vaše přihlašovací údaje a připojení funkční, než odešlete jakékoli skutečné údaje.
- Produkty — prostudujte si katalog, na jehož základě sestavujete nabídku: oděvy, bytový textil a metráž, včetně základních modelů a variant vhodných pro potisk.
- Objednávky — vytvořit objednávku a zjistit její stav. To je jádro každé integrace: zadají se řádky, zdroje, údaje o zákazníkovi a dodání; výsledkem je sledovaná objednávka.
- Plnění — sledujte výrobu a expedici v průběhu výroby a odesílání zboží, aby vaše platforma mohla prodejcům zobrazovat přesné informace o stavu zásilek.
- Studio — přiložte návrh přizpůsobený pro Fabrixa Studio (náš nástroj pro přizpůsobení produktů, který lze zabudovat a používat pod vlastní značkou) k objednávce podle jejího
cart_item_key, takže to, co kupující navrhl, se přesně tak i vytiskne.
Ověřování a omezení počtu požadavků
Integrace API (v2) je dostupná na základní adrese URL https://api.fabrixa.com/v2/integration. Každý požadavek obsahuje dvě záhlaví:
| Záhlaví | Účel |
|---|---|
Oprávnění: Na předložení |
Váš token API – identifikuje a autorizuje požadavek. |
X-Application-Key: |
Váš aplikační klíč – tvoří pár s tokenem, takže musí být k dispozici oba. |
Limit počtu operací je 30 požadavků za minutu. To je pro provoz generovaný objednávkami dostačující, znamená to však, že hromadné operace by měly být prováděny s určitým časovým odstupem, nikoli v těsných cyklech. S tímto limitem zacházejte ohleduplně – jakmile ho dosáhnete, zpomalte a místo opakovaného dotazování využívejte webhooky (viz níže).
Webhooky: reagujte na stav, nečekejte na něj
Místo toho, abyste se neustále ptali “už je to hotové?”, přihlaste se k odběru webhooků a nechte Fabrixa, aby vám dalo vědět, když se něco změní. Integrace API vysílá dvě události:
- order.created — spustí se, když je objednávka přijata do výroby. Použijte tuto funkci k potvrzení přijetí objednávky prodejci a k označení objednávky jako „v zpracování“.
- order.updated — spouští se v průběhu celého procesu výroby a expedice, včetně sledování zásilek. Využijte tuto funkci k synchronizaci stavu vaší platformy, aniž byste překročili limit počtu požadavků.
Při dvou událostech a maximálním počtu 30 za minutu se správně provedená integrace tohoto limitu sotva dotkne: nejprve odešlete příkaz a poté reagujte na zpětnou odezvu.
Průběh objednávky od začátku do konce
Ať už si vyberete jakoukoli variantu, postup je stejný:
- Připojit se — internetový obchod (Shopify nebo WooCommerce) nebo API.
- Návrh — přizpůsobte si design v Fabrixa Studio, nebo nám zašlete soubor PDF připravený k tisku.
- Odeslat objednávku — prostřednictvím API, s řádky produktů, zákazníkem a dodací adresou.
- Vyrábíme a expedujeme — Společnost Fabrixa zajišťuje tisk, balení a expedici v rámci služby „white-label“.
Krátká poznámka ke kvalitě, protože právě proto si prodejci volí reaktivní barvení: reaktivní barvivo vytváří kovalentní vazbu s celulózou v bavlněném vlákně a je trvale zafixováno působením tepla a páry. Barva se stává součástí vlákna – nevytváří se žádná povrchová vrstva, nedochází k popraskání v místech ohybu – takže se na dotek chová jako nepotisknutá bavlna a barva obvykle vydrží více než 600 pracích cyklů. Jako příklad dodací lhůty lze uvést, že výroba oděvů v Portugalsku trvá přibližně 6–9 pracovních dnů.
Proč platformy využívají model Fabrixa
- MOQ 1 — od jednoho kusu až po desítky tisíc. Žádné minimální množství objednávky, žádné náklady na přípravu, žádné smlouvy.
- Ve výchozím nastavení jako white-label — na každém balíku je uvedena značka zákazníka, nikoli naše.
- Krátký dodavatelský řetězec v EU — přeprava v rámci Portugalska, Španělska a Nizozemska, nikoli dálková nákladní přeprava.
- Skutečný reaktivní tisk — Organická bavlna s certifikátem GOTS jako standardní základ pro oděvy, dále certifikáty OEKO-TEX Standard 100 a Made in Green.
Často kladené otázky
Musím k používání API používat Fabrixa Studio?
Ne. Funkce „Studio“ je volitelná. Místo toho můžete k objednávce přiložit PDF soubor připravený k tisku. Funkce „Studio“ se používá pouze v případě, že chcete, aby si zákazníci mohli produkt ve vašem internetovém obchodě přizpůsobit, a tento návrh k objednávce připojíte tím, že cart_item_key.
Jak mám ověřovat požadavky?
Při každém volání odešlete dvě hlavičky: Oprávnění: Na předložení a X-Application-Key:. Oba údaje jsou povinné – pokud jeden z nich chybí, bude žádost zamítnuta.
Co se stane, když dosáhnu limitu počtu požadavků?
Limit API je 30 požadavků za minutu. Pokud tento limit překročíte, počkejte chvíli a zkuste to znovu, místo abyste na koncový bod neustále posílali požadavky. Pro změny stavu použijte order.created a order.updated webhooky místo opakovaných dotazů — zajišťují synchronizaci, aniž by docházelo k plýtvání požadavky.
Je to opravdu white-labelové řešení?
Ano. Balíčky se standardně odesílají pod vaší značkou s vaší zpáteční adresou a bez jakéhokoli označení Fabrixa. Vaši koncoví zákazníci nás nikdy neuvidí.
Začněte stavět
Nejrychlejší způsob, jak se tam dostat, je průvodce integrací, s plnou podporou Dokumentace k API. Pokud byste si raději nejprve chtěli prohlédnout, jak to celé do sebe zapadá, tak přehled platformy prochází jednotlivými kanály – studiem, produkcí a expedicí. A pokud byste chtěli otestovat, zda se to hodí pro vaši platformu, obraťte se na náš tým — rádi s vámi projdeme váš konkrétní případ použití.
