Skip to main content
Skip table of contents

Zuppy

A Zuppy é uma ferramenta para a gestão de pagamentos e sistemas. Através dela, é possivel criar e emitir notas fiscais de vendas de forma automática.

A integração entre o Guru e a Zuppy ajuda você a:

  • Enviar dados da venda para a plataforma Zuppy; e

  • Tratar e emitir a nota fiscal de venda automaticamente.

A integração do Guru com a Zuppy é feita através de webhooks. Caso tenha atingido o limite disponível de webhooks, basta realizar um upgrade de plano para a categoria Plus 2 ou Plus 3.

Para ativar a integração com Zuppy você deve realizar os 4 passos a seguir.


Nessa página:

  • Passo 1: Obter Código do Produto e associá-lo na Zuppy

  • Passo 2: Obter a URL para Webhook

  • Passo 3: Criar o Webhook

  • Passo 4: Obter Token API e inserir na Zuppy


Antes de começar você precisa:

  • Ter uma conta ativa na Zuppy.

  • Ter uma empresa cadastrada na Zuppy.

  • Possuir limite de webhook disponível para uso em sua conta Guru.

  • Ser usuário administrador no Guru ou ter permissões para executar os passos a seguir.

Passo 1: Obter Código do Produto e associá-lo na Zuppy

Nesse passo, você deve copiar o código do produto no Guru e informar na Zuppy.

1 - Acesse o admin do Guru com seu usuário e senha.

2 - No menu lateral, acesse produtos

3- Selecione o produto que deseja associar na Zuppy

4 - Em detalhe, copie e armazene o código

5 - Em seguida, acesse seu ambiente da Zuppy com usuário e senha.

6 - No menu lateral, clique em Produto.

7 - Clique em Adicionar novo Produto.

8- Informe:

  1. Split de notas fiscais: selecione se o produto terá split das notas fiscais emitidas;

  2. Nome do produto: informe o nome do produto;

  3. Empresa: selecione a empresa, que deseja associar o produto;

  4. Tipo de produto: selecione o tipo de produto;

  5. Tema: selecione o tema relacionado ao tipo de produto;

  6. Valor do Produto em Reais: informe o valor do produto;

  7. Quando deseja que as notas fiscais comecem a ser emitidas:

  8. Período de Garantia em Dias: informe o período de garantia em dias, que deseja para a nota fiscal;

9 - Em Integração, clique em Adiconar ID de Integração.

10 - Informe:

  1. Provedor: selecione Digital Manager Guru;

  2. ID de integração: informe o ID (código) do produto, copiado no passo 1 item 4;

  3. Voce deseja que seja enviado emails com as notas emitidas para este produto: selecione a opção se deseja enviar e-mail com a nota fiscal emitida;

  4. Esse produto possui coprodutores: informe se o produto possui coprodutores.

11 - Clique em Cadastrar produto.


Passo 2: Obter URL do Webhook

Neste passo, você vai obter na Zuppy o URL do Webhook para informar na Guru.

1- Acesse seu ambiente da Zuppy com usuário e senha.

2 - No menu lateral, clique em Integracões.

3 - Em seguida, selecione a Empresa e a Digital Manager Guru.

4 - Copie e armazene a URL do Webhook.


Passo 3: Criar o Webhook

Neste passo, você deve acessar sua conta no Guru (Configurações » Webhooks) e criar um webhook de venda ou de assinatura, para enviar as notificações para a Zuppy.

Ao criar o Webhook, lembre-se de:

  1. Selecionar: Se webhook é de venda, seleciona o status das vendas; e Se o webhook é de assinatura, seleciona o status das assinaturas.

  2. Nome: coloque o nome do seu Webhook;

  3. URL: URL do Webhook, copiada do passo 2 item 4;

  4. Envios simultâneos: selecione os envios simultâneos;

  5. Status: selecione todos os status de venda ou status das assinaturas desejados; e

  6. Filtrar por: marcar filtrar por todos, Marketplaces ou Produtos (1);

(1) Ao escolher filtrar por “todos” ou “marketplaces”qualquer produto novo criado será associado ao webhook automaticamente

Passo 4: Obter Token API e inserir na Zuppy

Neste passo, você vai obter na Guru o Token API, para informar na Zuppy.

Etapas:

1 - Acesse o admin do Guru com seu usuário e senha.

2 - No menu superior direito, clique em Meu Perfil.

3 - No menu lateral, clique em Tokens API, e em seguida em Adicionar.

4 - Informe o nome do Token API.

5 - Clique em Enviar.

6 - Em seguida, copie e armazene o Token API.

7 - Retorne ao seu ambiente da Zuppy com usuário e senha.

8 - No menu lateral, clique em Integracões.

9 - Selecione a Empresa e a Digital Manager Guru.

10 - Em seguida, no passo 3 em Configure sua chave de autenticação do Webhook, informe:

  1. API Token de verificação: copiado passo 4 item 6

11 - Clique em Cadastrar o API Token de verificação.


Mais Recursos

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.