Guia de integração

Esse guia orienta o passo a passo para realizar a integração de emissão de notas fiscais. Siga cada etapa atentamente para garantir uma implementação correta e eficiente.

Antes de começar

Antes de iniciar o processo, é necessário que a empresa já esteja criada. Sem a empresa, você não conseguirá realizar os passos seguintes.

Criar empresa

Passo a passo

Siga os passos abaixo para configurar a emissão de notas fiscais para sua empresa. Cada etapa é fundamento para garantir que o processo de emissão seja realizado de maneira correta e eficiente. Qualquer dúvida, basta entrar em contato!

Configurar a Empresa

Iremos começar configurando a emissão de nota fiscal, esse processo só precisa ser executado uma única vez para cada empresa que deseja emitir uma nota fiscal.

Preencher dados da empresa

O primeiro passo é preencher os dados da empresa. Para realizar esse processo, você precisará atualizar os dados da empresa.

Preencha os campos email, phone_number, tax_regime e state_registration/municipal_registration

Atualizar empresa

string

requerido

E-mail

phone_number

string

requerido

Telefone

tax_regime

enum<string>

requerido

Regime tributário

Valores permitidos:

ISENTOLUCRO_PRESUMIDOSIMPLES_NACIONALSIMPLES_NACIONAL_EXCESSOLUCRO_REALMEI

state_registration

string

opcional

Inscrição Estadual (Apenas para Nota de Produto)

municipal_registration

string

opcional

Inscrição Municipal (Apenas para Nota de Serviço)

Pré-configuração da empresa

Após atualizar os dados da empresa, você deverá fazer a configuração da empresa para emissão.

NÃO será necessário informar login, password e rps nesse momento.

Configurar acesso

Agora que sua empresa está pré-configurada, você precisará configurar o acesso por meio de Certificado A1 ou Login e Senha da Prefeitura/Portal Nacional

💡

Para tomar a decisão de qual acesso escolher, use o Status do Município.

Certificado A1

Para preencher o Certificado A1, basta executar a [requisição] (/criar-certificado-14333049e0) com o arquivo e senha.

Para preencher o Login e Senha, basta executar a requisição informando o login e password no corpo.

Recibos Provisórios de Serviços (RPS) - Opcional

Após configurar o acesso, você já está apto para Emitir uma Nota Fiscal. Porém, é importante definir o RPS de suas notas, para que não haja conflitos no momento da emissão.

Faça uma requisição informando o objeto de RPS, com o tipo (kind) do RPS que você deseja configurar, número da próxima nota e número de série.

Informações úteis

Caso você não faça essa etapa, nós iremos definir o número da próxima nota para 1500 e a série para 100 em ambos os modelos de emissão.

Emitir Nota de Serviço

Caso a empresa configurada tenha uma Inscrição Municipal já é possível realizar emissões.

Para encontrar o Código de Serviço (LC116) de acordo com o município da empresa, utilize o endpoint de Consultar Serviços Municipais.

Emitir Nota de Serviço

💡

Para MEI, será necessário criar uma Classe de Imposto [levar para endpoint quando ele existir] e atrelar a Classe no momento da emissão.

Notificações

WIP...

Passo a passo#

Configurar a Empresa#

Emitir Nota de Serviço#

Notificações#

Passo a passo

Configurar a Empresa

Emitir Nota de Serviço

Notificações