Como integrar a Zuppy com a TMB

A integração com a TMB permite que suas vendas sejam recebidas automaticamente na Zuppy para emissão de notas fiscais. Diferente de outros provedores, na TMB cada produto precisa ser integrado individualmente, pois é necessário informar o ID interno do produto na Zuppy durante a configuração.

A seguir, veja o passo a passo completo.

PASSO 1 — Gerar e configurar seu Token de Acesso na TMB

1. Acesse a área de API dentro da TMB.

2. Clique em Gerar Token ou copie o token já existente.

3. Na Zuppy, você deve inserir somente o trecho do token após o último ponto final.

Exemplo:

Token: xxxxx.xxxxxx.ABC123 → Valor correto: ABC123

📌 Importante: O Passo 1 é feito apenas uma vez. Você só precisa gerar o token uma única vez para a sua conta.

Depois de salvar o token, você não precisa mais voltar ao formulário para salvar novamente — apenas para copiar a URL quando for usar no passo 3.

PASSO 2 — Escolher o produto que será integrado

Agora, na TMB:

1. Acesse o menu de Integrações.

2. Selecione o produto que você deseja integrar.

3. Clique em Webhook de Vendas.

📌 Observação: Os passos 2 e 3 devem ser repetidos para cada produto que você deseja integrar com a Zuppy. Antes de integrar um produto, ele precisa existir na Zuppy, pois você usará o ID interno dele na configuração.

PASSO 3 — Configurar o Webhook de Vendas na TMB

1. Clique no botão + Nova Configuração.

2. Preencha os campos da seguinte forma:

• Nome da Integração: [Zuppy] - Emissão de Nota Fiscal

• URL: Copie diretamente da Zuppy

• Chave: x-tmb-token

• Valor: Deixe vazio

• ID Externo: Informe o ID interno do produto na Zuppy

• Status: Ativar

Após salvar, seu produto estará integrado.

Pontos importantes

• O token deve ser salvo uma única vez na Zuppy.

• Para novos produtos, você só repete os passos 2 e 3, não precisa salvar o token novamente.

• Você pode voltar ao formulário da integração na Zuppy somente para copiar a URL, quando necessário.

• Cada produto precisa estar cadastrado na Zuppy para obter o ID interno.

Se precisar de ajuda, você pode entrar em contato com o nosso suporte.