Услугата „Fabrixa Print on Demand API“ позволява на всяка платформа или онлайн магазин от типа POD да изпраща поръчки и да проследява целия им цикъл чрез order.created и order.updated уебхукове, а Fabrixa ще се погрижи за отпечатването, опаковането и изпращането на пратката под Ваша марка — от една бройка нагоре, навсякъде в ЕС. Вие създавате потребителското преживяване при покупката; ние се занимаваме с производството на текстил по поръчка. Няма минимална поръчка, няма такси за настройка, няма лого на Fabrixa върху пратката.
Тази публикация представлява обзор на интеграцията API (v2), изложен на достъпен език, предназначен за разработчици, които разглеждат Fabrixa като слой за изпълнение на поръчки. Ако предпочитате да прегледате набързо справочника, пълният Документация за API и стъпка по стъпка ръководство за интеграция сме готови, когато и Вие сте готови.
За какво служи API
Fabrixa е платформа за реактивен текстилен печат: единен контролен панел за каналите за продажби, дизайните, производството и изпращането. Повечето клиенти се свързват чрез Shopify, WooCommerce или Fabrixa Studio. Интеграцията API е четвъртият вариант — създадена за платформите POD и за разработчиците, които вече разполагат със собствен онлайн магазин и искат програмно управление на изпълнението на поръчките.
Вие се свързвате с API, за да изпратите поръчки. Fabrixa ги произвежда: реактивен печат върху памук и лен в Португалия и Испания, сублимационен печат върху полиестер в Нидерландия. Колетните пратки се изпращат под Вашата марка, с Вашия адрес за връщане и без никакви обозначения на Fabrixa върху опаковката. Вашите клиенти никога няма да разберат за нашето съществуване, освен ако Вие сами не им кажете.
Какво прави API
- Пинг — лека проверка, с която да се уверите, че Вашите идентификационни данни и връзката Ви функционират правилно, преди да изпратите каквато и да е реална информация.
- Продукти — запознайте се с каталога, върху който работите: облекло, текстил за дома и платове на метър, като са налични основни модели и варианти за печат.
- Поръчки — създаване на поръчка и проверка на нейния статус. Това е сърцевината на всяка интеграция: въвеждат се редове, източници, данни за клиента и доставката; в отговор се получава проследяема поръчка.
- Изпълнения — проследявайте производството и експедирането в момента, в който артикулите се произвеждат и изпращат, за да може платформата Ви да предоставя точна информация за статуса на продавачите.
- Студио — приложете персонализиран дизайн в Fabrixa Studio (нашият инструмент за персонализиране на продукти, който може да се вгражда и се предлага под собствена марка) към дадена поръчка чрез нейния
cart_item_key, така че това, което купувачът е проектирал, е точно това, което се отпечатва.
Удостоверяване на автентичността и ограничения на честотата
Интеграцията API (v2) се намира на основния URL адрес https://api.fabrixa.com/v2/integration. Всяко заявка съдържа два заглавия:
| Заглавие | Цел |
|---|---|
Упълномощаване: На притежателя |
Вашият токен API — идентифицира и удостоверява заявката. |
X-Application-Key: |
Ключът на Вашето приложение — свързва се с токена, така че и двете трябва да са налице. |
Ограничението на честотата е 30 заявки на минута. Това е напълно достатъчно за трафик, генериран от поръчки, но означава, че масовите операции трябва да се изпълняват с умерено темпо, а не в кратък цикъл. Справяйте се с ограничението по подходящ начин – отстъпете, когато го достигнете, и разчитайте на уебхукове (по-долу), вместо да използвате периодично запитване.
Уебхукове: реагирайте на състоянието, вместо да го проверявате периодично
Вместо постоянно да питате “Готово ли е вече?”, абонирайте се за уебхукове и оставете Fabrixa да Ви уведоми, когато нещо се промени. Интеграцията API генерира две събития:
- order.created — задейства се, когато поръчката бъде приета за изпълнение. Използвайте го, за да потвърдите получаването на поръчката пред продавача и да маркирате поръчката като „в процес на изпълнение“.
- order.updated — изпраща заявки по време на преминаването на поръчката през етапите на производство и експедиране, включително проследяване. Използвайте я, за да поддържате статуса на платформата си синхронизиран, без да изчерпвате лимита си за заявки.
При две събития и ограничение от 30 на минута една добре организирана интеграция едва достига границата: изпраща се заявката, след което се реагира на получената отговор.
Потокът на поръчките – от начало до край
Независимо от това какъв път изберете, схемата е една и съща:
- Свържи се — онлайн магазин (Shopify или WooCommerce) или API.
- Дизайн — персонализирайте в Fabrixa Studio или ни изпратете PDF файл, готов за печат.
- Изпрати поръчката — чрез API, с редове за продукти, клиент и адрес за доставка.
- Ние произвеждаме и изпращаме — Fabrixa отпечатва, опакова и изпраща продукти под собствена марка.
Кратка бележка относно качеството, тъй като именно това е причината продавачите да избират реактивни багрила: реактивното багрило образува ковалентна връзка с целулозата в памучното влакно и се фиксира трайно под въздействието на топлина и пара. Цветът става част от влакното — няма повърхностен слой, няма напукване в местата на огъване — така че на допир се усеща като непечатан памук и обикновено запазва цвета си за над 600 цикъла на пране. Като пример за срок на изработка, облеклото, произведено в Португалия, отнема приблизително 6–9 работни дни.
Защо платформите се изграждат на базата на Fabrixa
- MOQ 1 — от една бройка до десетки хиляди. Без минимална поръчка, без такси за настройка, без договори.
- По подразбиране – „White-label“ — марката на клиента върху всяка пратка, а не нашата.
- Кратка верига на доставки в ЕС — превоз в Португалия, Испания и Нидерландия, а не превоз на дълги разстояния.
- Истински реактивен печат — Органичен памук със сертификат GOTS като основна материя за облекло, както и сертификати OEKO-TEX Standard 100 и Made in Green.
Често задавани въпроси
Трябва ли да използвам Fabrixa Studio, за да ползвам API?
Не. „Studio“ е по избор. Вместо това можете да изпратите PDF файл, готов за печат, заедно с поръчката. „Studio“ се използва само когато искате купувачите да персонализират продукт във Вашия онлайн магазин и прикачвате този дизайн към поръчката чрез cart_item_key.
Как да удостоверявам автентичността на заявките?
Изпращайте два заглавни реда при всяко обаждане: Упълномощаване: На притежателя и X-Application-Key:. И двете са задължителни — ако липсва едното, заявлението ще бъде отхвърлено.
Какво ще стане, ако достигна лимита на заявките?
API има ограничение от 30 заявки на минута. Ако го надвишите, изчакайте малко и опитайте отново, вместо да бомбардирате крайната точка. За промени в състоянието използвайте order.created и order.updated уебхукове вместо периодично запитване — те Ви поддържат в синхрон, без да се изразходват заявки.
Действително ли услугата за изпълнение на поръчки е „white-label“?
Да. Пратките се изпращат под Вашата марка, с Вашия адрес за връщане и по подразбиране без логото на Fabrixa. Вашите крайни клиенти никога не ни виждат.
Започнете да създавате
Най-бързият начин да влезете е ръководство за интеграция, подкрепено от пълната Документация за API. Ако предпочитате първо да видите как всичко това се съчетава, то общ преглед на платформата преминава през отделите „Канали“, „Студио“, „Производство“ и „Експедиция“. А ако искате да проверите дали дадена функция е подходяща за Вашата платформа, свържете се с нашия екип — с удоволствие ще разгледаме Вашия конкретен случай.
