E-commerce
Printful no seu produto e nos seus agentes de IA, por uma API
O toolkit do Printful cobre pedidos, taxas de frete, o catálogo de produtos em branco, os produtos da própria loja e estatísticas de vendas: criar um pedido em rascunho, atualizá-lo, confirmá-lo para produção ou cancelá-lo e ler os códigos de rastreio. O lojista conecta com uma API key do Printful, e seu produto ou agente de IA chama cada operação por um único endpoint do Connect.
15 dias para testar. Sem cartão de crédito.
POST https://connect.reportei.com/api/tools/printful_create_order/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"recipient": {},
"items": []
}
}Como funciona
Do cliente conectado à primeira chamada no Printful.
- 1
O cliente conecta a conta
Seu sistema abre uma sessão do Connect para o toolkit e o cliente conecta a conta do Printful. Você recebe o id da conexão.
- 2
Seu produto chama a tool
Um POST em /api/tools/{tool}/execute com o id da conexão e os argumentos. Em caso de sucesso, o Connect preserva o status e o corpo da resposta do app.
- 3
O Connect cuida do resto
Guarda a credencial criptografada, renova tokens quando a conexão usa OAuth com suporte a renovação e registra as execuções numa trilha de auditoria consultável pela API.
Para que usar
O que o seu produto faz com o Printful.
Atender pedidos da sua loja
Crie um pedido em rascunho com destinatário, itens e arquivos de impressão, cote o frete e confirme para o Printful iniciar a produção.
Status do pedido no seu painel
Liste os pedidos e leia os envios com transportadora e código de rastreio para mostrar aos clientes onde está o pacote.
Agente de IA para lojas de merch
Deixe um agente navegar pelo catálogo e suas variantes, consultar produtos da loja, calcular taxas de frete e cancelar um pedido ainda em rascunho ou pendente.
Tools
12 tools do Printful
- Listar pedidosGETLista os pedidos da loja com status, destinatário, itens, custos e envios. Pagine com offset e limit; paging.total na resposta é o número de pedidos.
- Obter pedidoGETRetorna um pedido com status, destinatário, itens, custos e os envios com transportadora e código de rastreio.
- Criar pedidoPOSTCria um pedido como rascunho e o retorna com os custos que o Printful calculou. Nada é cobrado até Confirmar pedido. recipient e items são obrigatórios, e os arquivos de impressão são baixados de URLs públicas.
- Atualizar pedidoPUTAltera um pedido que ainda não foi enviado para produção e o retorna. Envie só os campos que mudam; enviar items substitui a lista de itens. Nada é cobrado até Confirmar pedido.
- Confirmar pedidoPOSTEnvia um pedido em rascunho para produção e o retorna. O Printful cobra a forma de pagamento do dono da loja neste momento; um pedido pendente ainda pode ser cancelado com Cancelar pedido.
- Cancelar pedidoDELETECancela um pedido em rascunho ou pendente e o retorna. Um valor cobrado volta para o cartão do dono da loja. Pedidos em revisão, em processo ou já enviados não podem ser cancelados.
- Calcular taxas de fretePOSTRetorna os métodos de envio para uma lista de itens e um destino, com taxa, moeda e estimativa de entrega. O id de um método vai em shipping de Criar pedido e Atualizar pedido. Chame logo antes de fazer o pedido, pois as taxas mudam.
- Listar produtos do catálogoGETLista os produtos em branco do catálogo do Printful, como camisetas, canecas e pôsteres, com id, title, type, brand e main_category_id. Obter produto do catálogo retorna as variantes de um deles.
- Obter produto do catálogoGETRetorna um produto do catálogo e suas variantes. Cada variante tem o id que pedidos e taxas de frete recebem como variant_id, com tamanho, cor, preço e estoque; o produto lista as posições de arquivo de impressão (files) e as opções que aceita.
- Listar produtos da lojaGETLista os produtos de uma loja criados no Printful para pedidos manuais e para a API, com id, external_id, name e quantas variantes cada um tem. Obter produto da loja retorna as variantes.
Chave de API
O cliente cola a chave do app numa tela do Connect, ou o seu sistema envia a chave por POST /api/customer-toolkits, sem tela.
Perguntas sobre o toolkit do Printful
Preciso implementar a API do Printful?
Não. O Connect já traz 12 tools do Printful descritas e prontas. Seu cliente conecta a conta e o seu sistema chama cada tool pelo mesmo endpoint, com o mesmo formato de requisição.
Como o cliente conecta a conta do Printful?
Pelo modo que o toolkit aceita: Chave de API. O Connect guarda a credencial criptografada e nunca a devolve ao seu sistema.
Funciona com agentes de IA?
Sim. O input de cada tool é descrito em JSON Schema, que o seu agente usa direto como definição de tool. O agente escolhe a tool e os argumentos, e o seu sistema faz a chamada ao Connect.
Meu cliente precisa ter conta no Reportei?
Não. O cliente conecta a conta numa tela do Connect, ou o seu sistema envia a credencial pela API, e ele continua usando só o seu produto.
Veja o Connect aplicado ao seu produto.
Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.
