Como funciona a integração da TMB com produtos em coprodução na Zuppy

Para integrar produtos da TBM na Zuppy, o processo é diferente das demais integrações.
Nas outras plataformas, cada empresa faz a integração com o provedor apenas uma vez, independentemente da quantidade de produtos. Já na TBM, além da integração inicial da empresa, é necessário integrar cada produto individualmente. Ou seja, sempre que você criar um novo produto na TBM, será preciso integrá-lo separadamente na Zuppy.

1. A integração é feita apenas pela empresa principal

Para produtos com coprodução, apenas uma das empresas precisa configurar a integração com a TMB.

Essa empresa deverá seguir o passo a passo de integração (Veja aqui o passo a passo):

• Fazer a integração da TMB na Zuppy (salvar o token)

• Criar a configuração de Webhook de vendas na TMB

• Integrar somente o produtor principal

Os demais coprodutores não precisam integrar nada na TBM.
Depois que o produtor principal cria e integra o produto corretamente, todos os coprodutores passam a receber suas vendas conforme o percentual definido.
Ou seja: a TBM envia a venda apenas para o produtor principal, e a Zuppy divide automaticamente o valor entre os coprodutores de acordo com a porcentagem configurada.

2. Integração é feita por produto

Assim como no fluxo normal da TMB, você precisa criar uma configuração de Webhook por produto da empresa principal.

Mesmo em produtos com coprodução, cada produto principal deve possuir sua própria integração na TMB.

3. Como a venda é distribuída entre os coprodutores

Quando uma venda chega pelo Webhook da TMB:

1. A TMB envia apenas um webhook, referente ao produto que você integrou.

2. A Zuppy recebe essa venda.

3. Se o produto estiver configurado com coprodução, a Zuppy automaticamente:

   • Cria uma cópia da venda para cada empresa coprodutora daquele produto

   • Aplica corretamente a porcentagem de participação definida na coprodução

   • Cria a estrutura necessária para que cada empresa emita sua própria nota fiscal

Ou seja, basta integrar somente o produto principal, e a Zuppy cuida do restante.

4. Teste de integração

Para validar:

• Solicite ao responsável da TMB que envie uma venda de teste

• Acompanhe na Zuppy se a venda:

  • Entrou corretamente

  • Foi distribuída para todas as empresas coprodutoras

  • Criou as vendas individuais automaticamente

Resumo

• Integrar apenas uma empresa na TMB

• Criar uma integração por produto dessa empresa

• A TMB envia 1 venda, e a Zuppy divide automaticamente entre os coprodutores

• Cada empresa recebe sua venda para emissão de nota, conforme sua participação

Se precisar de ajuda durante o processo, entre em contato com o nosso suporte.