Integração do Printful com o Jumpseller via Zapier

Conecte o Jumpseller ao Printful através do Zapier para criar automaticamente pedidos de fulfillment quando uma compra é marcada como paga. A ação para o Printful é realizada através do Webhooks by Zapier, enviando um POST direto para a API do Printful.

⚡ Criar Zap · Jumpseller → Printful

Conceito chave

Cada variante de produto no Jumpseller deve ter o identificador exato da variante de catálogo do Printful atribuído. Esse valor é armazenado em um campo personalizado do tipo select, e o Zapier o lê ao receber o evento do pedido para incluí-lo no payload enviado ao Printful.

Não são realizadas buscas de catálogo nem mapeamentos dinâmicos: o Jumpseller atua como a fonte de verdade.

Passo 1: Configurar o campo personalizado no Jumpseller

Antes de criar o Zap, você precisa configurar o campo que armazenará o ID do Printful.

1. Acesse Configurações → Campos personalizados → Variantes
2. Crie um campo do tipo Select com o nome printful_catalog_variant_id
3. Adicione uma opção para cada variante de catálogo do Printful que você usa, por exemplo:
   • 4011 — Camiseta preta / P
   • 4012 — Camiseta preta / M
   • 4013 — Camiseta preta / G
4. Salve o campo

Em seguida, em cada produto:

1. Acesse a variante correspondente
2. Atribua o valor correto do campo printful_catalog_variant_id
3. Repita para todas as combinações de tamanho e cor

Cada combinação de tamanho e cor deve ter seu próprio identificador do Printful.

Passo 2: Configurar o Zap no Zapier

Trigger: Pedido pago no Jumpseller

• App: Jumpseller
• Evento: New Paid Order
• Conecte sua conta do Jumpseller e teste o trigger com um pedido real ou de teste para verificar que os campos do pedido aparecem corretamente

Action: Criar pedido no Printful via Webhooks

• App: Webhooks by Zapier
• Evento: POST
• URL: https://api.printful.com/orders
• Headers:
  • Authorization: Bearer SUA_API_KEY_DO_PRINTFUL
  • Content-Type: application/json Body (JSON):

{
  "recipient": {
    "name": "{{customer_name}}",
    "address1": "{{shipping_address_line1}}",
    "city": "{{shipping_city}}",
    "country_code": "{{shipping_country_code}}",
    "zip": "{{shipping_zip}}"
  },
  "items": [
    {
      "catalog_variant_id": "{{variant_custom_fields_printful_catalog_variant_id}}",
      "quantity": "{{quantity}}",
      "files": [
        {
          "url": "{{product_options_artwork_url}}"
        }
      ]
    }
  ]
}

Os nomes entre `` são referências aos campos do trigger do Jumpseller como aparecem no Zapier. Ajuste-os conforme os nomes exatos expostos pelo trigger ao fazer o teste.

Arquivos de impressão

O Printful exige que os arquivos de impressão estejam disponíveis por meio de uma URL pública no momento do pedido. Esse valor é obtido a partir da opção de produto artwork configurada no Jumpseller.

Certifique-se de que a URL do arquivo seja acessível sem autenticação.

Vantagens dessa abordagem

• Não requer código nem servidor próprio
• Configuração visual pelo Zapier
• Fluxo determinístico e auditável
• Erros visíveis no histórico de Zaps com falha

Considerações importantes

• O campo printful_catalog_variant_id deve estar atribuído em todas as variantes do produto antes de receber pedidos
• O arquivo de impressão deve ser acessível publicamente no momento do pedido
• Se algum desses dados estiver faltando, o Zap falhará e ficará registrado no histórico do Zapier
• Os pedidos criados via API no Printful exigem confirmação manual antes de entrar em produção, a menos que você tenha o fulfillment automático ativado na sua conta do Printful

Precisa de ajuda para implementar esta integração?

Se precisar adaptar esta integração a um fluxo mais avançado, você pode solicitar suporte profissional. Isso é útil se você precisar de:

• Lógica condicional por produto ou variante
• Tratamento de erros e notificações automáticas
• Geração automática de mockups
• Integração com outros sistemas

Preço indicativo: serviços profissionais a partir de 400 EUR.

Solicitar ajuda profissional