Integração do Printful com o Jumpseller via Zapier

Ligue o Jumpseller ao Printful através do Zapier para criar automaticamente encomendas 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. Este é armazenado num campo personalizado do tipo select, e o Zapier lê-o ao receber o evento da encomenda para o incluir no payload enviado ao Printful.

Não são realizadas pesquisas 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, é necessário configurar o campo que armazenará o ID do Printful.

1. Aceda a Configurações → Campos personalizados → Variantes
2. Crie um campo do tipo Select com o nome printful_catalog_variant_id
3. Adicione uma opção por cada variante de catálogo do Printful que utilize, por exemplo:
   • 4011 — T-shirt preta / S
   • 4012 — T-shirt preta / M
   • 4013 — T-shirt preta / L
4. Guarde o campo

De seguida, em cada produto:

1. Aceda à 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 o seu próprio identificador do Printful.

Passo 2: Configurar o Zap no Zapier

Trigger: Encomenda paga no Jumpseller

• App: Jumpseller
• Evento: New Paid Order
• Ligue a sua conta do Jumpseller e teste o trigger com uma encomenda real ou de teste para verificar que os campos da encomenda aparecem corretamente

Action: Criar encomenda no Printful via Webhooks

• App: Webhooks by Zapier
• Evento: POST
• URL: https://api.printful.com/orders
• Headers:
  • Authorization: Bearer A_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 tal como aparecem no Zapier. Ajuste-os de acordo com os nomes exatos expostos pelo trigger ao fazer o teste.

Ficheiros de impressão

O Printful requer que os ficheiros de impressão estejam disponíveis através de um URL público no momento da encomenda. Este valor é obtido a partir da opção de produto artwork configurada no Jumpseller.

Certifique-se de que o URL do ficheiro é acessível sem autenticação.

Vantagens desta abordagem

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

Considerações importantes

• O campo printful_catalog_variant_id deve estar atribuído em todas as variantes do produto antes de receber encomendas
• O ficheiro de impressão deve ser acessível publicamente no momento da encomenda
• Se algum destes dados estiver em falta, o Zap falhará e ficará registado no histórico do Zapier
• As encomendas criadas via API no Printful requerem confirmação manual antes de entrar em produção, a menos que tenha o fulfillment automático ativado na sua conta do Printful

Precisa de ajuda para implementar esta integração?

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

• Lógica condicional por produto ou variante
• Gestão 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