API de Emissão de NFSe (1.0.0)
Bem-vindo à nossa plataforma de emissão de Nota Fiscal de Serviços Eletrônica (NFSe)!
Estamos aqui para simplificar sua experiência, tornando o processo de emissão rápido, intuitivo, seguro e eficiente. Nossa API proporciona a melhor comunicação entre as softhouses e prefeituras, tirando a burocracia na preparação dos dados essenciais para emissão das notas fiscais.
Com nossa solução, informações recorrentes, como os dados do prestador, regime tributário e certificado digital, serão previamente configuradas no portal, enquanto nossa API facilitará a integração, solicitando apenas informações específicas, como tomador, serviços e valores de impostos, em um formato JSON simples.
É importante mencionar que o município precisa estar homologado com a nossa plataforma. Caso o município desejado não esteja na lista de estados e cidades homologadas, você poderá entrar em contato com nossa equipe comercial para viabilizar a homologação.
Vamos começar?
Para seguir nos passos abaixo é preciso do cadastro da empresa em nossa plataforma. Esse é um requisito para obter as credenciais de homologação e produção para utilização de nossos serviços.
Acesse nosso portal de parceiros Integro Parceiros para cadastro de sua empresa:
Informar os seguintes dados no formulário:
- Razão Social
- CNPJ
- Inscrição Municipal
- Endereço completo
- ...Imagem do Formulário de Cadastro...
O certificado digital é uma peça fundamental para garantir a autenticidade e validade jurídica das notas fiscais emitidas. Ele é utilizado exclusivamente para assinar os documentos fiscais, assegurando sua conformidade com os padrões legais e proteção contra alterações indevidas.
Passos para Importação
- Acesse o portal e faça login com suas credenciais.
- No menu de configurações, selecione a opção Certificado Digital.
- Faça o upload do arquivo do certificado (A1 ou A3) e insira a senha correspondente.
- Conclua o processo para associar o certificado ao cadastro do prestador.
Segurança do Certificado
Entendemos que a segurança do seu certificado digital é essencial. Por isso, nossa plataforma foi projetada para utilizar o certificado apenas durante o processo de assinatura dos documentos fiscais, mantendo-o armazenado de forma segura e criptografada. Não realizamos nenhum uso indevido ou acesso não autorizado aos seus dados.
Upload de Certificado Digital
Realiza o upload de um certificado digital no formato Base64, valida a senha e armazena o certificado com uma chave única gerada pelo sistema.
Request Body schema: application/jsonrequired
| cnpjEmissor required | string CNPJ da empresa emitente associada ao certificado |
| base64 required | string Conteúdo do certificado digital codificado em Base64 (formato .pfx) |
| senha required | string Senha de acesso ao certificado digital |
Responses
Response Schema: application/json
| chaveCertificado | string Identificador único gerado para o certificado armazenado |
Request samples
- Payload
{- "cnpjEmissor": "string",
- "base64": "string",
- "senha": "string"
}Response samples
- 200
- 422
- 500
{- "chaveCertificado": "string"
}Consulta de Emitentes
Retorna todos os emitentes cadastrados na plataforma associados ao usuário autenticado. Cada emitente inclui dados cadastrais básicos e seu respectivo endereço.
Responses
Response Schema: application/json
| codigo | integer or null Código interno do emitente |
| razaoSocial | string Razão social da empresa emitente |
| nomeFantasia | string Nome fantasia da empresa emitente |
| cpfCnpj | string CNPJ ou CPF do emitente |
| inscricaoEstadual | string or null Inscrição estadual do emitente |
| inscricaoMunicipal | string or null Inscrição municipal do emitente |
| telefone | string Telefone de contato |
string or null E-mail de contato | |
| usuarioPrefeitura | string or null Usuário da prefeitura (para autenticação em prefeituras que exigem) |
| senhaPrefeitura | string or null Senha da prefeitura (para autenticação em prefeituras que exigem) |
| codigoCnae | string Código CNAE principal do emitente |
| incentivadorCultural | boolean Indica se o emitente é incentivador cultural |
| incentivoFiscal | string Descrição do incentivo fiscal se houver |
| optanteSimples | boolean Indica se o emitente é optante pelo Simples Nacional |
| regimeTributacao | integer Código do regime de tributação do emitente |
| ativo | boolean Indica se o emitente está ativo |
object (EnderecoEmitente) Endereço cadastrado do emitente |
Response samples
- 200
- 404
- 500
[- {
- "codigo": 0,
- "razaoSocial": "string",
- "nomeFantasia": "string",
- "cpfCnpj": "string",
- "inscricaoEstadual": "string",
- "inscricaoMunicipal": "string",
- "telefone": "string",
- "email": "string",
- "usuarioPrefeitura": "string",
- "senhaPrefeitura": "string",
- "codigoCnae": "string",
- "incentivadorCultural": true,
- "incentivoFiscal": "string",
- "optanteSimples": true,
- "regimeTributacao": 0,
- "ativo": true,
- "endereco": {
- "codigo": 0,
- "codigoEmitente": 0,
- "logradouro": "string",
- "bairro": "string",
- "numero": "string",
- "cep": "string",
- "complemento": "string",
- "codigoIBGEMunicipio": 0,
- "codigoIBGEUF": 0
}
}
]Consulta de Emitente por Código
Retorna os dados do emitente com o código informado, caso esteja cadastrado na base de dados do usuário autenticado.
path Parameters
| codigo required | integer Código interno do emitente |
Responses
Response Schema: application/json
| codigo | integer or null Código interno do emitente |
| razaoSocial | string Razão social da empresa emitente |
| nomeFantasia | string Nome fantasia da empresa emitente |
| cpfCnpj | string CNPJ ou CPF do emitente |
| inscricaoEstadual | string or null Inscrição estadual do emitente |
| inscricaoMunicipal | string or null Inscrição municipal do emitente |
| telefone | string Telefone de contato |
string or null E-mail de contato | |
| usuarioPrefeitura | string or null Usuário da prefeitura (para autenticação em prefeituras que exigem) |
| senhaPrefeitura | string or null Senha da prefeitura (para autenticação em prefeituras que exigem) |
| codigoCnae | string Código CNAE principal do emitente |
| incentivadorCultural | boolean Indica se o emitente é incentivador cultural |
| incentivoFiscal | string Descrição do incentivo fiscal se houver |
| optanteSimples | boolean Indica se o emitente é optante pelo Simples Nacional |
| regimeTributacao | integer Código do regime de tributação do emitente |
| ativo | boolean Indica se o emitente está ativo |
object (EnderecoEmitente) Endereço cadastrado do emitente |
Response samples
- 200
- 404
- 500
{- "codigo": 0,
- "razaoSocial": "string",
- "nomeFantasia": "string",
- "cpfCnpj": "string",
- "inscricaoEstadual": "string",
- "inscricaoMunicipal": "string",
- "telefone": "string",
- "email": "string",
- "usuarioPrefeitura": "string",
- "senhaPrefeitura": "string",
- "codigoCnae": "string",
- "incentivadorCultural": true,
- "incentivoFiscal": "string",
- "optanteSimples": true,
- "regimeTributacao": 0,
- "ativo": true,
- "endereco": {
- "codigo": 0,
- "codigoEmitente": 0,
- "logradouro": "string",
- "bairro": "string",
- "numero": "string",
- "cep": "string",
- "complemento": "string",
- "codigoIBGEMunicipio": 0,
- "codigoIBGEUF": 0
}
}Consulta de Emitente por CPF/CNPJ
Retorna os dados do emitente associado ao CPF ou CNPJ informado, se houver.
path Parameters
| cpfCnpj required | string^[0-9]{11}|[0-9]{14}$ Example: 12345678000199 CPF ou CNPJ do emitente (somente números) |
Responses
Response Schema: application/json
| codigo | integer or null Código interno do emitente |
| razaoSocial | string Razão social da empresa emitente |
| nomeFantasia | string Nome fantasia da empresa emitente |
| cpfCnpj | string CNPJ ou CPF do emitente |
| inscricaoEstadual | string or null Inscrição estadual do emitente |
| inscricaoMunicipal | string or null Inscrição municipal do emitente |
| telefone | string Telefone de contato |
string or null E-mail de contato | |
| usuarioPrefeitura | string or null Usuário da prefeitura (para autenticação em prefeituras que exigem) |
| senhaPrefeitura | string or null Senha da prefeitura (para autenticação em prefeituras que exigem) |
| codigoCnae | string Código CNAE principal do emitente |
| incentivadorCultural | boolean Indica se o emitente é incentivador cultural |
| incentivoFiscal | string Descrição do incentivo fiscal se houver |
| optanteSimples | boolean Indica se o emitente é optante pelo Simples Nacional |
| regimeTributacao | integer Código do regime de tributação do emitente |
| ativo | boolean Indica se o emitente está ativo |
object (EnderecoEmitente) Endereço cadastrado do emitente |
Response samples
- 200
- 404
- 500
{- "codigo": 0,
- "razaoSocial": "string",
- "nomeFantasia": "string",
- "cpfCnpj": "string",
- "inscricaoEstadual": "string",
- "inscricaoMunicipal": "string",
- "telefone": "string",
- "email": "string",
- "usuarioPrefeitura": "string",
- "senhaPrefeitura": "string",
- "codigoCnae": "string",
- "incentivadorCultural": true,
- "incentivoFiscal": "string",
- "optanteSimples": true,
- "regimeTributacao": 0,
- "ativo": true,
- "endereco": {
- "codigo": 0,
- "codigoEmitente": 0,
- "logradouro": "string",
- "bairro": "string",
- "numero": "string",
- "cep": "string",
- "complemento": "string",
- "codigoIBGEMunicipio": 0,
- "codigoIBGEUF": 0
}
}Cadastra um novo emitente
Registra um novo emitente no sistema, vinculando-o ao usuário da sessão.
Request Body schema: application/jsonrequired
| codigo | integer or null Código interno do emitente |
| razaoSocial | string Razão social da empresa emitente |
| nomeFantasia | string Nome fantasia da empresa emitente |
| cpfCnpj | string CNPJ ou CPF do emitente |
| inscricaoEstadual | string or null Inscrição estadual do emitente |
| inscricaoMunicipal | string or null Inscrição municipal do emitente |
| telefone | string Telefone de contato |
string or null E-mail de contato | |
| usuarioPrefeitura | string or null Usuário da prefeitura (para autenticação em prefeituras que exigem) |
| senhaPrefeitura | string or null Senha da prefeitura (para autenticação em prefeituras que exigem) |
| codigoCnae | string Código CNAE principal do emitente |
| incentivadorCultural | boolean Indica se o emitente é incentivador cultural |
| incentivoFiscal | string Descrição do incentivo fiscal se houver |
| optanteSimples | boolean Indica se o emitente é optante pelo Simples Nacional |
| regimeTributacao | integer Código do regime de tributação do emitente |
| ativo | boolean Indica se o emitente está ativo |
object (EnderecoEmitente) Endereço cadastrado do emitente |
Responses
Response Schema: application/json
| mensagem | string |
| cpfCnpj | string |
| codigo | integer |
Request samples
- Payload
{- "codigo": 0,
- "razaoSocial": "string",
- "nomeFantasia": "string",
- "cpfCnpj": "string",
- "inscricaoEstadual": "string",
- "inscricaoMunicipal": "string",
- "telefone": "string",
- "email": "string",
- "usuarioPrefeitura": "string",
- "senhaPrefeitura": "string",
- "codigoCnae": "string",
- "incentivadorCultural": true,
- "incentivoFiscal": "string",
- "optanteSimples": true,
- "regimeTributacao": 0,
- "ativo": true,
- "endereco": {
- "codigo": 0,
- "codigoEmitente": 0,
- "logradouro": "string",
- "bairro": "string",
- "numero": "string",
- "cep": "string",
- "complemento": "string",
- "codigoIBGEMunicipio": 0,
- "codigoIBGEUF": 0
}
}Response samples
- 200
- 400
- 500
{- "mensagem": "Emitente cadastrado com sucesso.",
- "cpfCnpj": "12345678000199",
- "codigo": 101
}Atualiza os dados de um emitente
Atualiza as informações de um emitente já existente com base no seu código.
Request Body schema: application/jsonrequired
| codigo | integer or null Código interno do emitente |
| razaoSocial | string Razão social da empresa emitente |
| nomeFantasia | string Nome fantasia da empresa emitente |
| cpfCnpj | string CNPJ ou CPF do emitente |
| inscricaoEstadual | string or null Inscrição estadual do emitente |
| inscricaoMunicipal | string or null Inscrição municipal do emitente |
| telefone | string Telefone de contato |
string or null E-mail de contato | |
| usuarioPrefeitura | string or null Usuário da prefeitura (para autenticação em prefeituras que exigem) |
| senhaPrefeitura | string or null Senha da prefeitura (para autenticação em prefeituras que exigem) |
| codigoCnae | string Código CNAE principal do emitente |
| incentivadorCultural | boolean Indica se o emitente é incentivador cultural |
| incentivoFiscal | string Descrição do incentivo fiscal se houver |
| optanteSimples | boolean Indica se o emitente é optante pelo Simples Nacional |
| regimeTributacao | integer Código do regime de tributação do emitente |
| ativo | boolean Indica se o emitente está ativo |
object (EnderecoEmitente) Endereço cadastrado do emitente |
Responses
Response Schema: application/json
| mensagem | string |
| cpfCnpj | string |
| codigo | integer |
Request samples
- Payload
{- "codigo": 0,
- "razaoSocial": "string",
- "nomeFantasia": "string",
- "cpfCnpj": "string",
- "inscricaoEstadual": "string",
- "inscricaoMunicipal": "string",
- "telefone": "string",
- "email": "string",
- "usuarioPrefeitura": "string",
- "senhaPrefeitura": "string",
- "codigoCnae": "string",
- "incentivadorCultural": true,
- "incentivoFiscal": "string",
- "optanteSimples": true,
- "regimeTributacao": 0,
- "ativo": true,
- "endereco": {
- "codigo": 0,
- "codigoEmitente": 0,
- "logradouro": "string",
- "bairro": "string",
- "numero": "string",
- "cep": "string",
- "complemento": "string",
- "codigoIBGEMunicipio": 0,
- "codigoIBGEUF": 0
}
}Response samples
- 200
- 400
- 500
{- "mensagem": "Emitente atualizado com sucesso.",
- "cpfCnpj": "12345678000199",
- "codigo": 101
}Exclui um emitente
Remove logicamente (ou fisicamente, dependendo da implementação) um emitente a partir do seu código.
path Parameters
| codigo required | integer Example: 101 Código do emitente a ser excluído |
Responses
Response Schema: application/json
| mensagem | string |
Response samples
- 200
- 400
- 500
{- "mensagem": "Emitente excluido com sucesso."
}Envio de NFSe
Este endpoint permite enviar notas fiscais de serviço.
Request Body schema:
| identificacaoEmitente required | string non-empty Identificação única do emitente do lote |
required | Array of objects (NotaFiscalResumida) non-empty Lista de notas fiscais que compõem o lote |
| enviarParaProducao | boolean Define se a nota será enviada para produção (true) ou apenas homologação/teste (false) |
| urlWebhook | string or null URL para notificação via webhook (opcional) |
Responses
Response Schema: application/json
| protocolo | string Protocolo de envio da NFSe |
| mensagem | string Mensagem informativa ou de alerta |
Request samples
- Payload
{- "identificacaoEmitente": "string",
- "notas": [
- {
- "rps": {
- "numeroRPS": "string",
- "numeroNota": "string",
- "serie": "string",
- "tipo": "string",
- "status": 0,
- "dataEmissao": "2019-08-24T14:15:22Z",
- "dataCompetencia": "2019-08-24T14:15:22Z",
- "codigoVerificacao": "string"
}, - "destinatario": {
- "razaoSocial": "string",
- "nomeFantasia": "string",
- "cpfCnpj": "string",
- "inscricaoEstadual": "string",
- "inscricaoMunicipal": "string",
- "telefone": "string",
- "endereco": {
- "logradouro": "string",
- "numero": "string",
- "bairro": "string",
- "cep": "string",
- "complemento": "string",
- "codigoPais": 0,
- "codigoIBGEUF": 0,
- "codigoIBGEMunicipio": 0,
- "descricaoUF": "string",
- "descricaoMunicipio": "string",
- "siglaUF": "string"
}
}, - "servicos": [
- {
- "codigo": "string",
- "descricao": "string",
- "codigoTributacao": "string",
- "localPrestacao": "string",
- "responsavelPelaRetencao": 0,
- "exibilidadeISS": 0,
- "tipoTributacao": 0,
- "municipioIncidencia": 0,
- "aliquotaISS": 0.1,
- "retemISS": 0,
- "quantidade": 0.1,
- "valorUnitario": 0.1,
- "valorDesconto": 0.1,
- "valorAcrescimo": 0.1,
- "codigoCnae": "string",
- "numeroProcesso": "string"
}
], - "condicoesPagamentos": [
- {
- "condicao": "string",
- "pagamentos": [
- {
- "parcela": 0,
- "dataPagamento": "2019-08-24T14:15:22Z",
- "valor": 0.1
}
]
}
], - "observacao": "string",
- "subtituicaoRps": {
- "numeroRPS": "string",
- "numeroNota": "string",
- "serie": "string",
- "tipo": "string"
}
}
], - "enviarParaProducao": true,
- "urlWebhook": "string"
}Response samples
- 200
- 500
{- "protocolo": "string",
- "mensagem": "string"
}Consulta de Nota Fiscal
Retorna os dados da nota fiscal eletrônica, incluindo links para o XML e PDF.
path Parameters
| codigoNota required | integer Código identificador da nota fiscal. |
Responses
Response Schema: application/json
| codigo | integer Código identificador da nota fiscal |
| tipoNota | string or null Tipo da nota fiscal |
| numero | string or null Número da nota fiscal emitida |
| rps | string Número do RPS (Recibo Provisório de Serviços) |
| serie | string Série da nota fiscal |
| dataEmissao | string <date> Data de emissão da nota |
| codigoVerificacao | string or null Código de verificação da nota (quando aplicável) |
| xml | string or null <uri> URL para download do XML da nota fiscal. |
string or null <uri> URL para download do PDF da nota fiscal. | |
| dataHoraCancelamento | string or null <date-time> Data e hora do cancelamento da nota (se houver). |
Response samples
- 200
- 400
- 500
{- "codigoNota": 99999,
- "tipoNota": "1",
- "numero": "1",
- "rps": "99",
- "serie": "1",
- "dataEmissao": "2025-01-01",
- "codigoVerificacao": "ABCDEFGH",
- "dataHoraCancelamento": "2025-01-01T20:11:44.0000000-03:00"
}Consulta de NFSe por protocolo
Permite consultar as notas fiscais de serviço associadas a um determinado protocolo de envio. O protocolo é informado como parâmetro de rota.
path Parameters
| protocolo required | integer Número do protocolo gerado no envio da NFSe |
Responses
Response Schema: application/json
| protocolo | integer Número do protocolo consultado |
| mensagem | string Mensagem de status ou retorno da consulta |
object (ProtocoloNotaResponse) Informações resumidas da nota fiscal vinculada ao protocolo |
Response samples
- 200
- 404
- 500
{- "protocolo": 0,
- "mensagem": "string",
- "notas": {
- "codigo": 0,
- "tipoNota": "string",
- "numero": "string",
- "rps": "string",
- "serie": "string",
- "dataEmissao": "2019-08-24",
- "codigoVerificacao": "string",
- "dataHoraCancelamento": "2019-08-24T14:15:22Z"
}
}Cancelamento de NFSe
Permite cancelar uma nota fiscal de serviço previamente emitida. O cancelamento é realizado com base no código da nota fiscal. É possível informar opcionalmente uma URL de webhook para ser notificado com o resultado do processamento.
path Parameters
| codigoNota required | integer Código da nota fiscal a ser cancelada |
Request Body schema: application/json
| urlWebhook | string <uri> URL para notificação via webhook (opcional) |
Responses
Response Schema: application/json
| protocolo | string Protocolo de envio da NFSe para cancelamento |
| mensagem | string Mensagem informativa ou de alerta |
Request samples
- Payload
{
}Response samples
- 200
- 404
- 500
{- "protocolo": "string",
- "mensagem": "string"
}Download do XML da nota fiscal
Retorna o arquivo XML referente à nota fiscal identificada pelo codigoNota.
path Parameters
| codigoNota required | integer Código da nota fiscal. |
Responses
Response Schema: application/xml
Response samples
- 404
- 500
{- "mensagem": "string"
}Download do PDF da nota fiscal
Retorna o arquivo PDF referente à nota fiscal identificada pelo codigoNota.
path Parameters
| codigoNota required | integer Código da nota fiscal. |
Responses
Response Schema: application/pdf
Response samples
- 404
- 500
{- "mensagem": "string"
}