Este artigo explica como configurar a integração entre a Zuppy e a Digital Manager Guru utilizando Webhooks, quando os produtos possuem coprodução entre duas ou mais empresas.

Essa configuração garante que as vendas sejam corretamente identificadas e que a emissão das notas fiscais ocorra de forma adequada para cada empresa participante da coprodução.

Quando utilizar este tipo de integração

Utilize esta configuração somente se:

• Seus produtos possuem coprodução cadastrada na Digital Manager Guru

• Mais de uma empresa participa da mesma venda

• Cada coprodutor precisa receber corretamente as informações de venda para emissão de nota fiscal

⚠️ Importante
Se seus produtos não possuem coprodução, utilize o método padrão de integração:
Integração Zuppy + Digital Manager Guru (sem coprodução)

Pré-requisitos importantes

Antes de iniciar a configuração, é importante entender alguns pontos fundamentais:

• Todas as empresas coprodutoras devem, preferencialmente, estar cadastradas na Zuppy. Caso alguma ainda não esteja cadastrada no momento da criação do produto com coprodução, a Zuppy enviará automaticamente um convite por e-mail para que o coprodutor conclua o cadastro.

• Na Digital Manager Guru, os coprodutores não possuem credenciais próprias de integração. Eles têm apenas uma visão de dashboard, enquanto a integração técnica é feita a partir da conta principal do produtor.

• Integrações já existentes para produtos sem coprodução continuam funcionando normalmente e não devem ser alteradas.

• Para produtos com coprodução, é obrigatório criar uma nova integração com a Digital Manager Guru.

Por isso, a configuração da integração exige alguns cuidados específicos, explicados a seguir.

Como organizar os webhooks em cenários de coprodução

Quando existem diferentes combinações de coprodução entre empresas, a melhor prática é separar os webhooks por combinação de coprodutores.

Exemplo prático

Imagine um cenário com três empresas coprodutoras:

• Empresa X

• Empresa Y

• Empresa Z

Nesse caso, a organização recomendada é:

🔹 Webhook para coprodução entre todas as empresas

• 1 webhook contendo apenas os produtos que envolvem X + Y + Z

🔹 Webhooks para coprodução entre duas empresas

• 1 webhook para produtos da coprodução X + Y

• 1 webhook para produtos da coprodução Y + Z

• 1 webhook para produtos da coprodução X + Z

🔹 Webhooks individuais (sem coprodução)

• 1 webhook exclusivo para produtos apenas da empresa X

• 1 webhook exclusivo para produtos apenas da empresa Y

• 1 webhook exclusivo para produtos apenas da empresa Z

Essa separação evita que empresas recebam notificações sobre produtos que não fazem parte de suas vendas.

Passo a passo de configuração

Passo 1 – Produtor cria os webhooks na Digital Manager Guru

O produtor (titular da conta principal) deve:

1. Acessar a Digital Manager Guru

2. Criar um webhook para cada coprodutor ou combinação de coprodução

3. Selecionar, em cada webhook, apenas os produtos correspondentes àquela combinação

4. Configurar todos os webhooks apontando para a mesma URL da Zuppy (fornecida durante a integração)

Mesmo usando a mesma URL, a separação dos produtos garante que cada empresa receba apenas as vendas corretas.

Passo 2 – Coprodutor inicia a integração na Zuppy

Cada coprodutor deve:

1. Acessar sua conta na Zuppy

2. Ir até Integrações

3. Clicar em Adicionar Integração

4. Selecionar a integração com a Digital Manager Guru

Passo 3 – Utilizar um único API Token

Durante a configuração:

• Deve ser informado o API Token gerado a partir da conta principal do produtor

• O mesmo API Token será utilizado por todos os coprodutores

Isso significa que:

• Todos os webhooks utilizam a mesma URL da Zuppy

• Todos os coprodutores utilizam o mesmo API Token

Passo 4 – Finalizar e validar a integração

Após:

• O produtor configurar corretamente os webhooks na Guru

• E os coprodutores cadastrarem a integração na Zuppy

A comunicação estará ativa.

Cada coprodutor:

• Terá suas vendas processadas corretamente

• Poderá emitir notas fiscais normalmente

• Desde que possua empresa cadastrada e plano ativo na Zuppy

Resumo rápido

• Produtos sem coprodução → mantêm a integração padrão

• Produtos com coprodução → exigem nova integração

• O produtor cria webhooks separados por coprodução

• Todos os webhooks apontam para a mesma URL da Zuppy

• Os produtos devem ser selecionados corretamente em cada webhook

• Coprodutores utilizam o mesmo API Token

Pronto! Cada empresa consegue emitir suas notas fiscais de forma organizada e sem alertas desnecessários.

Se precisar de ajuda, nosso time está aqui para te apoiar 💜