Pular para o conteúdo principal

Já é cliente eNotas? Acesse o material com as orientações sobre a Reforma Tributária e o Portal de Gestão NFS-e.

[IUGU] Como habilitar a integração no eNotas

Atualizado

Neste tutorial, você aprenderá a ativar e configurar a integração entre a IUGU e o eNotas para automatizar a emissão de suas notas fiscais de serviço ou produto.

Como ativar a integração

Para conectar as plataformas, você precisará gerar um token de API dentro do painel da IUGU e inseri-lo no eNotas.

Na IUGU:

  1. Acesse sua conta na Iugu e faça login.
  2. No painel inicial, acesse o menu Configurações.
  3. Localize a opção Desenvolvedor e clique em Integração via API.

⚠️ IMPORTANTE! Esta opção só está disponível para usuários com perfil de Administrador.

  1. Clique em Novo para criar um token.
  2. Selecione a opção Produção, adicione uma descrição (ex.: eNotas) e clique em Salvar.
  3. Copie o token gerado.

No eNotas:

  1. Faça login em sua conta.
  2. No menu lateral, vá em Gerenciar e clique em Apps.
  3. Localize o app da Iugu e clique em Ativar.
  4. Insira o token copiado e clique em Confirmar.

Configuração dos momentos de emissão

Após ativar a integração, você deve definir em qual momento o eNotas deve emitir a nota fiscal. As opções são:

  • Na geração da fatura: a nota é emitida assim que a fatura é criada na IUGU.
  • No pagamento da fatura: a emissão ocorre quando o pagamento é confirmado.
  • Após a garantia: o eNotas aguarda um período de dias (definido por você) após o pagamento para emitir a nota.

Regras de importação de vendas

  • Vendas novas: após a ativação, o eNotas importará automaticamente apenas as faturas criadas a partir daquele momento.
  • Vendas antigas: faturas criadas antes da integração não são importadas por padrão, mesmo que sejam pagas depois. Caso precise importar vendas passadas, verifique a disponibilidade em seu plano e solicite ao nosso suporte via chat.
  • Tempo de processamento: as vendas são importadas em intervalos de tempo (não é tempo real). O processo pode levar até 15 minutos após a geração na IUGU.
❯ Vendi pela iugu, como o eNotas preenche a descrição da minha nota fiscal?

Como a nota fiscal é preenchida


O eNotas utiliza os dados da fatura da IUGU para preencher a discriminação de serviços:


  1. Itens da fatura: todos os itens da fatura são incluídos na descrição da nota, contendo nome, quantidade e valor unitário.
  2. Ordem dos itens: como a IUGU não mantém uma ordem fixa, o eNotas organiza os itens por ordem alfabética.
  3. Cadastro de produto: o primeiro item da lista (após a ordenação alfabética) é cadastrado como o produto principal no eNotas.
  • Dica: se você deseja que um item específico seja o principal, utilize numeração no início do nome (ex.: "01 - Meu Produto").
❯ Configurações avançadas (Metadados e Retenção)

Você pode automatizar regras específicas, como retenção de impostos ou alteração de valores, utilizando os Metadados da IUGU.


O que são metadados?

São variáveis que você configura na IUGU (via API ou painel) e que o eNotas interpreta para mudar o comportamento da nota.


Como configurar no eNotas:

  1. Vá em Gerenciar > Apps.
  2. Clique em Editar no app IUGU.
  3. Acesse Metadados configurados e clique em Alterar.
  4. Defina os nomes dos campos que você utilizará na IUGU para cada função.


Principais usos:

  • Retenção de ISS: você pode configurar um metadado (ex.: "Reter ISS") para que, quando o valor for "True", o eNotas aplique a retenção automaticamente.
  • Valor NFe: utilize este metadado se precisar que a nota tenha um valor diferente da fatura (ex.: fatura com desconto, mas nota pelo valor bruto).
  • Quando emitir: permite mudar o gatilho de emissão para uma venda específica via API.


Ajuste manual

Caso não utilize metadados, você pode abrir a venda no eNotas antes da emissão, clicar em Editar, ajustar o valor ou marcar as retenções manualmente.


FAQ

❯ Em qual momento minha nota fiscal será emitida?

Você define o gatilho de emissão nas configurações do App IUGU dentro do eNotas. As opções são: no momento da geração da fatura, no pagamento confirmado ou após um período de garantia (dias após o pagamento).

❯ Habilitei a integração agora, as vendas de ontem serão importadas?

Não. Por padrão, o eNotas importa apenas faturas criadas após o momento da ativação. Se você precisa importar vendas antigas, verifique a disponibilidade do seu plano e solicite a importação ao nosso time de suporte via chat.

❯ Por que minha venda demora a aparecer no eNotas?

A integração não ocorre em tempo real. O eNotas busca novas vendas na IUGU em intervalos periódicos, por isso

❯ Como o eNotas escolhe o que escrever na descrição da nota?

Nós utilizamos os itens da fatura da IUGU. Como a IUGU envia os itens em ordem aleatória, o eNotas os organiza por ordem alfabética. O primeiro item dessa lista é cadastrado como o "Produto" no eNotas, e todos os itens são listados na discriminação da nota com seus respectivos valores.

❯ Posso emitir uma nota com valor diferente da fatura da IUGU?

Sim. Isso é comum quando a fatura tem descontos, mas a nota deve ser emitida pelo valor bruto. Você pode fazer isso de duas formas:

  • Manual: Editando a venda no eNotas antes da emissão.
  • Automática: Configurando o metadado valor_nfe no App IUGU.


❯ É possível reter o ISS automaticamente?

Sim. Você deve configurar os Metadados no menu do App IUGU dentro do eNotas. Ao definir um campo para retenção (ex: reter_iss), o eNotas aplicará a regra sempre que receber esse comando da IUGU (via API ou metadado da fatura).

Ficou alguma dúvida? É só acionar o nosso time de suporte 😊

Relativo a

Artigos relacionados