Existem duas formas de enviar encomendas para a Fabrixa: ligar a loja que já gere — Shopify ou WooCommerce — sem necessidade de programação, ou criar diretamente na integração API. Este guia aborda ambas as opções: ligue um canal de vendas em poucos minutos ou passe da autorização ao processamento da encomenda em quinze.
A maioria das lojas nunca utiliza a API. Adicione a Fabrixa como canal de vendas e as encomendas da sua loja passam diretamente para a produção — os produtos são sincronizados, os estados são atualizados automaticamente, sem necessidade de escrever ou manter código. A rota API, mais adiante, destina-se a lojas personalizadas e plataformas POD.
No seu painel de controlo, abra Create channel e escolha o tipo de integração. Cada canal mantém os seus próprios produtos, encomendas importadas e regras de importação — ligue quantos canais pretender.
Não é necessário copiar nenhuma chave. Autorize a Fabrixa a partir do seu painel de administração do Shopify e a ligação fica ativa.
Create channel, selecione Shopify.Uma loja WordPress liga-se através de um par de chaves REST de leitura/escrita — gerado no WooCommerce e colado no Fabrixa uma única vez.
Settings → Advanced → REST API → Add key com Leitura/Escrita permissões.ck_ e o segredo cs_ e o domínio da sua loja na Fabrixa.Vende produtos personalizados? Fabrixa Studio — o editor de design de marca branca — também está disponível nas lojas Shopify e WooCommerce, para que os seus clientes possam personalizar os produtos com a sua marca. Ver Fabrixa Studio →
As lojas conectadas aparecem ao lado do seu API e dos canais dos seus parceiros na vista «Canais» — produtos sincronizados, encomendas recebidas, a última referência importada e a receita por canal. Mude um canal do estado «rascunho» para «ativo» quando estiver pronto; nada muda a jusante.
Prefere criar uma loja online personalizada ou a sua própria plataforma POD? O resto deste guia aborda a abordagem API — desde a autenticação até ao cumprimento da encomenda, em quatro passos.
Há três passos que o levam do zero até à ativação de uma encomenda. Todos eles são efetuados a partir do seu painel de controlo Fabrixa ou pelo seu engenheiro de soluções.
Um token de acesso da aplicação e uma chave da aplicação. Ambos são obrigatórios em todas as solicitações — o token no cabeçalho «Authorization» e a chave no cabeçalho «X-Application-Key». Crie um canal de vendas no seu painel de controlo para os gerar instantaneamente — sem necessidade de enviar qualquer solicitação.
Um ponto final HTTPS acessível ao público que aceita pedidos POST em JSON. O localhost funciona em ambiente de desenvolvimento através de um túnel. Deve verificar a assinatura HMAC-SHA256 em cada carga antes do processamento.
O seu ficheiro de arte final — PDF, TIFF, JPG ou PNG — acessível via HTTPS sem autenticação. Cor RGB, até 50 MB e 15 000 px por lado. Os PDFs com várias páginas têm uma página por camada. Recebemos o ficheiro e criamos os ficheiros de impressão corretos quando processamos o trabalho.
Todas as solicitações são encaminhadas para o URL base https://api.fabrixa.com/v2/integration com ambos os cabeçalhos definidos. GET /ping confirma se o token e a chave são válidos antes de fazer qualquer outra coisa.
Estado 401 significa que falta um cabeçalho ou que o token foi revogado. Estado 403 significa que as credenciais são válidas, mas não têm permissão para aceder ao recurso.
# 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
O catálogo apresenta as variantes do produto com os seus códigos SKU e variant_id. Cada resposta da lista é envolvida no links / meta / data envelope, por isso, paginar com o next_page link. Armazenar em cache localmente — o catálogo não é específico para cada pedido.
Os detalhes completos do campo encontram-se no Referência do Swagger.
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" }
]
}
Enviar rows (SKU + quantidade + um ficheiro PDF de referência), customer e shipping_address. Defina o seu próprio number como referência — se a omitir, iremos gerar uma. Guarde o ID da encomenda Fabrixa devolvido associado à sua encomenda.
As encomendas do estúdio substituem as sources ficheiro com o cart_item_key do desenho guardado; tudo o resto é idêntico.
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"
}
}
Defina o URL do seu webhook no painel de controlo. Enviamos um pedido POST order.created e order.updated para ele com o corpo completo da encomenda, x-webhook-signature (HMAC-SHA256) e x-webhook-topic nos cabeçalhos. Verifique a assinatura, devolva 200 rápido, processe de forma assíncrona.
Todos os eventos e os excertos de verificação encontram-se no referência de 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" }
Os erros são devolvidos em formato JSON, nunca em HTML. O errors.messages A variável `array` indica o que falhou; no caso de um erro 400, apresenta os campos que não foram validados.
Erro de validação, credenciais em falta ou revogadas, permissão insuficiente ou recurso desconhecido.
30 pedidos por aplicação por minuto. X-RateLimit-Limit e X-RateLimit-Remaining estão presentes em todas as respostas.
Do lado do servidor. Tente novamente com um intervalo de espera; se o problema persistir, envie o ID do pedido ao seu engenheiro de soluções.
{
"links": { "self": ".../v2/integration/orders" },
"meta": [],
"errors": {
"messages": [
"Application Key is not specified."
]
}
}
A Fabrixa permite 30 pedidos por aplicação por minuto; se esse limite for ultrapassado, é devolvida uma resposta 429 Too Many Requests. Os cabeçalhos X-RateLimit-Limit e X-RateLimit-Remaining são incluídos em todas as respostas, para que uma integração possa acompanhar a quota restante antes de atingir o limite.
A Fabrixa aceita ficheiros de arte final em formato PDF, TIFF, JPG ou PNG na cor RGB, com um tamanho máximo de 50 MB e 15 000 px por lado, acessíveis através de HTTPS sem autenticação. Os PDFs com várias páginas são tratados como uma página por camada, e a Fabrixa obtém o próprio ficheiro para criar os ficheiros de impressão corretos quando o trabalho é renderizado.
No WooCommerce, aceda a «Definições», depois a «Avançado» e, em seguida, a «REST API», e adicione uma chave com permissões de leitura/escrita. Cole a chave «ck_» resultante, o segredo «cs_» e o domínio da sua loja no Fabrixa, guarde e as encomendas serão sincronizadas automaticamente — as regras de importação podem ser alteradas posteriormente nas definições do canal.
Antes de efetuar a primeira encomenda, necessita de um «Token de Acesso da Aplicação» e de uma «Chave da Aplicação» de um canal de vendas, de um ponto final público de webhook HTTPS que verifique a assinatura HMAC-SHA256 em cada payload e de material gráfico acessível via HTTPS sem autenticação. Todos estes três elementos são emitidos ou configurados a partir do painel de controlo da Fabrixa, e as credenciais são geradas instantaneamente quando o canal de vendas é criado.
Um código de erro 403 significa que o token de acesso da aplicação e a chave da aplicação são válidos, mas não têm permissão para aceder ao recurso solicitado. Isto difere de um código de erro 401, que significa que falta um cabeçalho obrigatório ou que o token foi revogado; ambos podem ser verificados com um pedido GET /ping antes de se prosseguir com o desenvolvimento.
Para assistência na integração, questões relacionadas com credenciais ou canais de vendas, requisitos personalizados ou planeamento de capacidade — contacte o canal técnico de Engenheiros de Vendas (SE), e não a linha de vendas. Resposta no prazo de um dia útil.
Pode estabelecer ligação através do nosso REST API e de um feed de produtos, e a Fabrixa Studio, o nosso editor de design, pode ser integrado na sua própria plataforma, de modo a que apareça como uma funcionalidade da sua própria plataforma.
Ler a resposta →Está atualmente em desenvolvimento; a nossa equipa está a trabalhar no envio automatizado de encomendas, na sincronização de produtos, preços e stock e no acompanhamento automático das devoluções.
Ler a resposta →Recursos para programadores: Documentação da API https://www.fabrixa.com/developers/api-documentation · Guia de integração https://www.fabrixa.com/developers/integration-guide/ · Webhooks https://api.fabrixa.com/docs/integration#webhooks
Ler a resposta →Todas as 8 respostas sobre Integrações e API → Contacte a nossa equipa de apoio →
