O serviço de impressão por encomenda Fabrixa API permite que qualquer plataforma ou loja online POD envie uma encomenda e acompanhe o seu ciclo de vida através de order.created e order.updated webhooks, e a Fabrixa encarrega-se de imprimir, embalar e enviar o produto com marca branca — desde uma única peça, para toda a UE. Vós criais a experiência de compra; nós tratamos da produção têxtil à medida das necessidades. Sem quantidade mínima de encomenda, sem taxas de configuração, sem a marca da Fabrixa na encomenda.
Este artigo é uma visão geral, em linguagem simples, da Integração API (v2) destinada a programadores que estejam a avaliar a Fabrixa como camada de execução de encomendas. Se preferir dar uma vista de olhos à documentação de referência, o texto completo Documentação da API e passo a passo guia de integração estamos prontos quando estiveres.
Para que serve a API
Fabrixa é um plataforma de estampagem têxtil reativa: um painel único para canais de vendas, designs, produção e expedição. A maioria dos clientes liga-se através do Shopify, do WooCommerce ou da Fabrixa Studio. A integração API é a quarta opção — concebida para as plataformas POD e para os programadores que já possuem a sua própria loja online e pretendem ter controlo programático sobre o processamento de encomendas.
Liga para a API para enviar encomendas. A Fabrixa encarrega-se da produção: impressão reativa em algodão e linho em Portugal e Espanha, e impressão por sublimação em poliéster nos Países Baixos. As encomendas são enviadas com a sua marca, com o seu endereço de remetente e sem qualquer referência à Fabrixa na embalagem. Os seus clientes nunca saberão que existimos, a menos que lhes diga.
O que a API faz
- Ping — uma verificação rápida para confirmar se as suas credenciais e a sua ligação estão ativas antes de enviar qualquer informação real.
- Produtos — consulte o catálogo que está a elaborar: vestuário, têxteis para o lar e tecidos ao metro, com as bases e variantes disponíveis para impressão.
- Encomendas — criar uma encomenda e consultar o seu estado. Este é o cerne de qualquer integração: introduzem-se linhas, fontes, dados do cliente e de envio; obtém-se, em troca, uma encomenda com acompanhamento.
- Execuções — acompanhe a produção e a expedição à medida que os artigos são fabricados e enviados, para que a sua plataforma possa apresentar um estado preciso aos vendedores.
- Studio — anexe um desenho personalizado em Fabrixa Studio (o nosso configurador de produtos incorporável e de marca branca) a uma encomenda através do seu
cart_item_key, pelo que o que o comprador concebeu é exatamente o que é impresso.
Autenticação e rate limits
A integração API (v2) encontra-se na URL base https://api.fabrixa.com/v2/integration. Cada pedido implica dois cabeçalhos:
| Cabeçalho | Objetivo |
|---|---|
Autorização: Portador |
O seu token API — identifica e autoriza o pedido. |
X-Application-Key: |
A chave da sua aplicação — está associada ao token, pelo que ambas têm de estar presentes. |
O limite de taxa é 30 pedidos por minuto. Isso é suficiente para o tráfego gerado por pedidos, mas significa que as operações em massa devem ser realizadas de forma gradual, em vez de serem executadas num ciclo contínuo. Lide com o limite de forma adequada, abrande quando o atingir e recorra aos webhooks (abaixo) em vez de utilizar o polling.
Webhooks: reaja ao estado, não o verifique continuamente
Em vez de perguntar repetidamente “já está pronto?”, subscreva os webhooks e deixe que a Fabrixa o avise quando houver alguma alteração. A integração API emite dois eventos:
- order.created — é acionado quando uma encomenda é aceite para produção. Utilize-o para confirmar a receção ao vendedor e marcar a encomenda como em curso.
- order.updated — aciona-se à medida que a encomenda avança pelas etapas de produção e expedição, incluindo o acompanhamento. Utilize-o para manter o estado da sua plataforma sincronizado sem esgotar o seu limite de requisições.
Entre dois eventos e um limite máximo de 30 por minuto, uma integração bem concebida mal chega a atingir esse limite: enviar a ordem e, em seguida, reagir ao que for recebido.
O fluxo de encomendas, de início a fim
Seja qual for o caminho que escolher, o formato é o mesmo:
- Ligar — uma loja (Shopify ou WooCommerce) ou a API.
- Conceção — personalize no Fabrixa Studio ou envie um ficheiro PDF pronto para impressão.
- Enviar a encomenda — através da API, com linhas de produtos, cliente e morada de entrega.
- Produzimos e enviamos — A Fabrixa imprime, embala e envia, em marca branca.
Uma breve nota sobre a qualidade, porque é por isso que os vendedores optam pelo corante reativo: o corante reativo forma uma ligação covalente com a celulose da fibra de algodão e fica fixado de forma permanente sob o efeito do calor e do vapor. A cor torna-se parte integrante da fibra — sem camada superficial, sem fissuras nos pontos de flexão — pelo que ao toque parece algodão não estampado e, normalmente, mantém a cor durante mais de 600 ciclos de lavagem. A título de exemplo de prazo de entrega, o vestuário fabricado em Portugal demora cerca de 6 a 9 dias úteis.
Por que razão as plataformas se baseiam no Fabrixa
- MOQ 1 — desde uma peça até dezenas de milhares. Sem quantidade mínima de encomenda, sem taxas de configuração, sem contratos.
- Marca branca por predefinição — a marca do cliente em cada encomenda, e não a nossa.
- Cadeia de abastecimento curta da UE — produção em Portugal, Espanha e Países Baixos, e não transporte de mercadorias de longo curso.
- Impressão reativa real — Algodão biológico com certificação GOTS como base padrão, além das certificações OEKO-TEX Standard 100 e Made in Green.
Perguntas frequentes
É necessário utilizar a Fabrixa Studio para utilizar a API?
Não. O Studio é opcional. Em vez disso, pode enviar um PDF pronto a imprimir juntamente com a encomenda. O Studio só é necessário quando pretende que os compradores personalizem um produto na sua loja online e anexa esse design à encomenda ao cart_item_key.
Como posso autenticar os pedidos?
Enviar dois cabeçalhos em cada chamada: Autorização: Portador e X-Application-Key:. Ambos são obrigatórios — se faltar um deles, o pedido será rejeitado.
O que acontece se eu atingir o limite de frequência?
A API tem um limite máximo de 30 pedidos por minuto. Se exceder esse limite, aguarde um pouco e volte a tentar, em vez de sobrecarregar o ponto final. Para alterações de estado, utilize o order.created e order.updated webhooks em vez de polling — mantêm-te em sincronia sem gastar pedidos.
O serviço de fulfillment é mesmo de marca branca?
Sim. As encomendas são enviadas com a sua marca, com o seu endereço de devolução e, por norma, sem qualquer referência à marca Fabrixa. Os seus clientes finais nunca nos vêem.
Comece a construir
A forma mais rápida de entrar é a guia de integração, com o total apoio de Documentação da API. Se preferires ver primeiro como tudo se encaixa, o visão geral da plataforma passa pelos canais, pelo Estúdio, pela produção e pela expedição. E se quiser testar a compatibilidade com a sua plataforma, falar com a nossa equipa — teremos todo o prazer em analisar o seu caso de utilização.
