Skip to main content
Skip table of contents

BIU

A BIU é 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 a Guru e a BIU ajuda você a:

  • Enviar dados da venda para a plataforma BIU; e

  • Tratar e emitir a nota fiscal de venda automaticamente.

A integração da Guru com a BIU é 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 BIU você deve realizar os 5 passos a seguir.


Nessa página:

  • Passo 1: Obter Token API

  • Passo 2: Obter Chave API

  • Passo 3: Ativar Integração na BIU

  • Passo 4: Obter URL do Webhook

  • Passo 5: Criar o Webhook


Antes de começar, você precisa:

  • Ter uma conta ativa na BIU.

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

Passo 1: Obter Token API

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

Etapas:

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

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

biu-meu perfil-ícone.png

3 - Clique na aba Tokens API.

tokens api-aba.png

4 - Em Tokens API, clique em Adicionar.

biu-token api-adicionar.png

5 - Informe o nome do Token API.

biu-tokens api-adicionar.png

6 - Clique em Enviar.

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

biu-token api-copiar.png

Passo 2: Obter Chave API

Neste passo, você vai obter na Guru a Chave API, para informar na BIU.

Etapas:

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

2 - No menu superior direito, clique em Minha Conta.

minha conta-ícone.png

3 - Clique na aba Detalhe.

detalhe-aba.png

4 - Em API, copie e armazene o Token API.

biu-detalhe-copiar API.png

Passo 3: Ativar Integração na BIU

Neste passo, você vai ativar a integração na BIU.

Etapas:

1- Acesse seu ambiente do BIU com usuário e senha.

2 - No menu superior, clique em Meu Negócio, e em seguida em Integrações.

3 - Clique em Nova Integração.

4 - Clique em Guru.

5 - Informe:

  1. Nome: o nome da sua integração;

  2. Status: selecione se deseja o status ativo ou inativo;

  3. Início da importação: a data de início da importação;

  4. Considerar juros para emissão: selecione se deseja que a nota fiscal seja emitida com ou sem taxas de parcelamento - sim ou não;

  5. Token API - Dentro de Meu Perfil na Guru: obtido do passo 1 - item 7;

  6. Token Webhook - Dentro de Minha Conta na Guru: obtido do passo 2 - item 4.

biu-ativar integração.png

6- Clique em Salvar.


Passo 4: Obter URL do Webhook

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

Etapas:

1- Acesse seu ambiente do BIU com usuário e senha.

2 - No menu superior, clique em Meu Negócio, e, em seguida, em Integrações.

3 - Clique em Editar na Integrações Guru.

4 - Copie e armazene a URL do Webhook.


Passo 5: Criar o Webhook

Neste passo, você deve acessar sua conta na Guru (Configurações » Webhooks) e criar um webhook de assinaturas, de e-tickets ou de vendas para enviar as notificações para a BIU.

Ao criar o Webhook, lembre-se de:

  1. Selecionar: se o webhook é de assinatura, selecione o status das assinaturas; se o webhook é de e-tickets, selecione o status dos e-tickets; se o webhook é de vendas, selecione o status das vendas;

  2. Nome: coloque o nome do seu Webhook;

  3. URL: coloque a URL do Webhook, obtido do passo 4 - item 4;

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

  5. Status: selecione todos os status de venda; status das assinaturasou status dos e-tickets desejados;

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

  7. Mude o botão Ativo para a posição ligado.

(1) Ao escolher filtrar por “todos” ou “marketplaces”qualquer produto novo criado será associado ao webhook automaticamente.
criar webhook.png
desligado - ligado.png

Consulte o passo a passo completo:

Como Configurar um Webhook

Pronto! A partir deste momento, cada venda atualizada que atender aos critérios definidos no webhook configurado será enviada para a BIU.


Mais Recursos

JavaScript errors detected

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

If this problem persists, please contact our support.