Zuppy
A Zuppy é uma ferramenta para a gestão de pagamentos e sistemas. Através dela, é possível 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.
A Zuppy permite que seja realizado o split da nota fiscal. Essa função faz a divisão das notas fiscais entre o produtor e os co-produtores de forma automática. Para saber como, entre em contato com o suporte da Zuppy.
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.
Etapas:
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:
Split de notas fiscais: selecione se o produto terá split das notas fiscais emitidas;
Nome do produto: informe o nome do produto;
Empresa: selecione a empresa, que deseja associar o produto;
Tipo de produto: selecione o tipo de produto;
Tema: selecione o tema relacionado ao tipo de produto;
Valor do Produto em Reais: informe o valor do produto;
Quando deseja que as notas fiscais comecem a ser emitidas: selecione quando as notas fiscais devem ser emitidas;
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:
Provedor: selecione Digital Manager Guru;
ID de integração: informe o ID (código) do produto, copiado no passo 1 item 4;
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;
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.
Etapas:
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:
Selecionar: Se webhook é de venda, seleciona o status das vendas; e Se o webhook é de assinatura, seleciona o status das assinaturas.
Nome: coloque o nome do seu Webhook;
URL: URL do Webhook, copiada do passo 2 item 4;
Envios simultâneos: selecione os envios simultâneos;
Status: selecione todos os status de venda ou status das assinaturas desejados; e
Filtrar por: marcar filtrar por
todos
,Marketplaces
ouProdutos
(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:
API Token de verificação: copiado passo 4 item 6
11 - Clique em Cadastrar o API Token de verificação.