• Primeiros Passos
  • Emissão Avançada
  • Gestão de Notas
  • Autenticação
  • API Reference
Information
Empresas
    Percentual de completude do cadastro da empresagetListar empresasgetCriar empresapostConsultar dados de empresa por CNPJ (Minha Receita)getConsultar validade do certificado digitalgetObter empresa por IDgetAtualizar empresaputDesativar empresadeleteUpload de certificado digital A1post
Tomadores
    Listar tomadoresgetCriar tomadorpostObter tomador por IDgetAtualizar tomadorputExcluir tomadordeleteListar países disponíveis (ISO 3166-1 alpha-2)get
Serviços
    Listar serviços da LC 116/03getObter serviço por códigoget
Séries
    Listar séries da empresagetCriar nova sériepostObtém a série ativa para um ambientegetObtém o próximo número da série ativagetObtém uma série por IDgetAtualizar sérieputDefine o número inicial de uma série (para migração)post
NFS-e
    Listar NFS-egetEmitir NFS-epostDownload de XMLs em ZIP por períodogetObter NFS-e por IDgetExcluir NFS-e pendentedeleteCancelar NFS-epostRetransmitir NFS-e rejeitadapostDownload do XML da NFS-egetDownload do DANFSE em PDFget
Endereços
    Buscar endereço por CEPget
NBS
    Lista códigos NBSgetBusca código NBS específicoget
Schemas
powered by Zudoku
Nottou API
Nottou API

NFS-e

Emissão, consulta, cancelamento e download de XML de Notas Fiscais de Serviço Eletrônicas (NFS-e) no padrão nacional.

Listar NFS-e

GET
https://nfse.labds.com.br/api/v1
/nfse

Lista as Notas Fiscais de Serviço Eletrônicas (NFS-e) emitidas, com suporte a filtros avançados por período, tomador, status e paginação.

Listar NFS-e › query Parameters

page
​integer
Default: 1
limit
​integer
Default: 20
status
​string · enum
Enum values:
PENDENTE
AUTORIZADA
REJEITADA
CANCELADA
EXCLUIDA
dataInicio
​string · date
dataFim
​string · date
cpfCnpj
​string

Filtro parcial por CPF/CNPJ do cliente

nomeCliente
​string

Filtro parcial por nome/razão social do cliente (case-insensitive)

valorInicial
​number

Valor mínimo do serviço (ignora se 0)

valorFinal
​number

Valor máximo do serviço (ignora se 0)

Listar NFS-e › Responses

200

Lista de NFS-e

success
​boolean
​object[]
GET/nfse
curl --request GET \ --url https://nfse.labds.com.br/api/v1/nfse
shell
Example Responses
{ "success": true, "data": [ { "id": "00000000-0000-0000-0000-000000000000", "serie": "serie", "numero": 0, "chaveAcesso": "chaveAcesso", "numeroNfse": "numeroNfse", "dataEmissao": "2024-08-25T15:00:00Z", "dataCompetencia": "2024-08-25", "valorServico": 0, "valorDeducoes": 0, "valorDesconto": 0, "baseCalculo": 0, "aliquotaIss": 0, "valorIss": 0, "descricaoServico": "descricaoServico", "status": "PENDENTE" } ] }
json
application/json

Emitir NFS-e

POST
https://nfse.labds.com.br/api/v1
/nfse

Gera o XML DPS, assina digitalmente e envia para a API da Sefin Nacional

Emitir NFS-e › Request Body

tomadorId
​string · uuid · required
servicoCodigo
​string · required
valorServico
​number · required
descricaoServico
​string · required
dataCompetencia
​string · date · required
ambiente
​string · enum

Ambiente de emissão (homologacao ou producao)

Enum values:
homologacao
producao
Default: homologacao
codigoNbs
​string

Código NBS (9 dígitos) - se não informado, usa o cadastrado no serviço

Example: 123456789
deducoes
​number

Valor das deduções

descontoIncondicionado
​number

Desconto incondicionado

descontoCondicionado
​number

Desconto condicionado

retencaoIssqn
​boolean

Se há retenção de ISSQN

aliquotaIss
​number

Alíquota do ISS (%). Obrigatória para Simples Nacional com retenção (mín: 2%)

Example: 5
observacoes
​string

Observações adicionais na nota

​object

Dados de obra (obrigatório para serviços do grupo 07 - construção civil)

Emitir NFS-e › Responses

NFS-e emitida com sucesso

success
​boolean
​object
POST/nfse
curl --request POST \ --url https://nfse.labds.com.br/api/v1/nfse \ --header 'Content-Type: application/json' \ --data ' { "ambiente": "homologacao", "tomadorId": "00000000-0000-0000-0000-000000000000", "servicoCodigo": "01.01", "codigoNbs": "123456789", "valorServico": 1000, "descricaoServico": "descricaoServico", "dataCompetencia": "2024-01-15", "deducoes": 0, "descontoIncondicionado": 0, "descontoCondicionado": 0, "retencaoIssqn": true, "aliquotaIss": 5, "observacoes": "observacoes", "obra": { "inscImobFisc": "inscImobFisc", "codigo": "codigo", "cep": "cep", "logradouro": "logradouro", "numero": "numero", "complemento": "complemento", "bairro": "bairro", "nomeMunicipio": "nomeMunicipio" } } '
shell
Example Request Body
{ "ambiente": "homologacao", "tomadorId": "00000000-0000-0000-0000-000000000000", "servicoCodigo": "01.01", "codigoNbs": "123456789", "valorServico": 1000, "descricaoServico": "descricaoServico", "dataCompetencia": "2024-01-15", "deducoes": 0, "descontoIncondicionado": 0, "descontoCondicionado": 0, "retencaoIssqn": true, "aliquotaIss": 5, "observacoes": "observacoes", "obra": { "inscImobFisc": "inscImobFisc", "codigo": "codigo", "cep": "cep", "logradouro": "logradouro", "numero": "numero", "complemento": "complemento", "bairro": "bairro", "nomeMunicipio": "nomeMunicipio" } }
json
Example Responses
{ "success": true, "data": { "id": "id", "chaveAcesso": "chaveAcesso", "numeroNfse": "numeroNfse", "status": "status" } }
json
application/json

Download de XMLs em ZIP por período

GET
https://nfse.labds.com.br/api/v1
/nfse/download-xmls

Baixa todos os XMLs de NFS-e de um período específico em um arquivo ZIP. Máximo de 31 dias entre dataInicio e dataFim. Inclui NFS-e com status AUTORIZADA e CANCELADA. Arquivos são nomeados como: nfse-[status]-{numero}.xml (ex: nfse-autorizada-123.xml)

Download de XMLs em ZIP por período › query Parameters

dataInicio
​string · date · required

Data de início do período (formato YYYY-MM-DD)

Example: 2026-03-01
dataFim
​string · date · required

Data de fim do período (formato YYYY-MM-DD, máximo 31 dias após dataInicio)

Example: 2026-03-31

Download de XMLs em ZIP por período › Responses

Arquivo ZIP contendo XMLs das NFS-e (autorizada e cancelada)

string
GET/nfse/download-xmls
curl --request GET \ --url 'https://nfse.labds.com.br/api/v1/nfse/download-xmls?dataInicio=%3Cstring%3E&dataFim=%3Cstring%3E'
shell
Example Responses
string
text
application/zip

Obter NFS-e por ID

GET
https://nfse.labds.com.br/api/v1
/nfse/{id}

Consulta os dados completos de uma NFS-e emitida, incluindo status de autorização, chaves de acesso, valores, tributos e dados do tomador.

Obter NFS-e por ID › path Parameters

id
​string · uuid · required

Obter NFS-e por ID › Responses

Dados da NFS-e

No data returned
GET/nfse/{id}
curl --request GET \ --url https://nfse.labds.com.br/api/v1/nfse/:id
shell
Example Responses
No example specified for this content type

Excluir NFS-e pendente

DELETE
https://nfse.labds.com.br/api/v1
/nfse/{id}

Exclui uma NFS-e com status PENDENTE (soft delete). A nota não é removida do banco, apenas muda para status EXCLUIDA. Isso mantém a rastreabilidade e permite inutilização futura se necessário.

Excluir NFS-e pendente › path Parameters

id
​string · uuid · required

Excluir NFS-e pendente › Request Body

motivo
​string

Motivo da exclusão (opcional)

Excluir NFS-e pendente › Responses

NFS-e excluída com sucesso

success
​boolean
​object
DELETE/nfse/{id}
curl --request DELETE \ --url https://nfse.labds.com.br/api/v1/nfse/:id \ --header 'Content-Type: application/json' \ --data ' { "motivo": "motivo" } '
shell
Example Request Body
{ "motivo": "motivo" }
json
Example Responses
{ "success": true, "data": { "id": "id", "numero": 0, "serie": "serie", "status": "EXCLUIDA", "message": "message" } }
json
application/json

Cancelar NFS-e

POST
https://nfse.labds.com.br/api/v1
/nfse/{id}/cancelar

Solicita o cancelamento de uma NFS-e já autorizada junto ao ambiente nacional/prefeitura, informando a justificativa legal.

Cancelar NFS-e › path Parameters

id
​string · uuid · required

Cancelar NFS-e › Request Body

motivo
​string · minLength: 15 · maxLength: 255 · required

Motivo do cancelamento

Cancelar NFS-e › Responses

NFS-e cancelada

No data returned
POST/nfse/{id}/cancelar
curl --request POST \ --url https://nfse.labds.com.br/api/v1/nfse/:id/cancelar \ --header 'Content-Type: application/json' \ --data ' { "motivo": "motivoaaaaaaaaa" } '
shell
Example Request Body
{ "motivo": "motivoaaaaaaaaa" }
json
Example Responses
No example specified for this content type

Retransmitir NFS-e rejeitada

POST
https://nfse.labds.com.br/api/v1
/nfse/{id}/retransmitir

Reenvia uma NFS-e que foi rejeitada ou teve erro, mantendo o mesmo número/série. Regenera o XML DPS com dados atualizados da empresa e permite atualizar todos os campos. O codigoNbs é obrigatório se não estiver cadastrado no serviço.

Retransmitir NFS-e rejeitada › path Parameters

id
​string · uuid · required

Retransmitir NFS-e rejeitada › Request Body

tomadorId
​string · uuid

ID do tomador (para trocar tomador)

servicoCodigo
​string

Código do serviço LC 116/03

Example: 010101
codigoNbs
​string

Código NBS (9 dígitos) - obrigatório se não estiver no cadastro do serviço

Example: 122011200
valorServico
​number

Valor do serviço

Example: 10.4
descricaoServico
​string

Descrição do serviço prestado

dataCompetencia
​string · date

Data de competência (YYYY-MM-DD)

Example: 2025-12-01
retencaoIssqn
​boolean

Indica se há retenção de ISSQN

Example: true
observacoes
​string

Observações da NFS-e

aliquotaIss
​number

Alíquota ISS (obrigatória quando retencaoIssqn=true para SN)

Example: 2
deducoes
​number

Valor das deduções

descontoIncondicionado
​number

Valor do desconto incondicionado

Retransmitir NFS-e rejeitada › Responses

NFS-e retransmitida com sucesso

success
​boolean
​object
POST/nfse/{id}/retransmitir
curl --request POST \ --url https://nfse.labds.com.br/api/v1/nfse/:id/retransmitir \ --header 'Content-Type: application/json' \ --data ' { "tomadorId": "00000000-0000-0000-0000-000000000000", "servicoCodigo": "010101", "codigoNbs": "122011200", "valorServico": 10.4, "descricaoServico": "descricaoServico", "dataCompetencia": "2025-12-01", "retencaoIssqn": true, "observacoes": "observacoes", "aliquotaIss": 2, "deducoes": 0, "descontoIncondicionado": 0 } '
shell
Example Request Body
{ "tomadorId": "00000000-0000-0000-0000-000000000000", "servicoCodigo": "010101", "codigoNbs": "122011200", "valorServico": 10.4, "descricaoServico": "descricaoServico", "dataCompetencia": "2025-12-01", "retencaoIssqn": true, "observacoes": "observacoes", "aliquotaIss": 2, "deducoes": 0, "descontoIncondicionado": 0 }
json
Example Responses
{ "success": true, "data": { "id": "id", "chaveAcesso": "chaveAcesso", "numeroNfse": "numeroNfse", "status": "status" } }
json
application/json

Download do XML da NFS-e

GET
https://nfse.labds.com.br/api/v1
/nfse/{id}/xml

Obtém o arquivo XML oficial e assinado digitalmente da NFS-e autorizada para arquivamento fiscal ou envio ao tomador.

Download do XML da NFS-e › path Parameters

id
​string · uuid · required

Download do XML da NFS-e › Responses

XML da NFS-e

string
GET/nfse/{id}/xml
curl --request GET \ --url https://nfse.labds.com.br/api/v1/nfse/:id/xml
shell
Example Responses
string
xml
application/xml

Download do DANFSE em PDF

GET
https://nfse.labds.com.br/api/v1
/nfse/{id}/danfse/pdf

Busca o DANFSE em formato PDF diretamente da API da Sefin Nacional.

Download do DANFSE em PDF › path Parameters

id
​string · uuid · required

Download do DANFSE em PDF › Responses

DANFSE em PDF

string
GET/nfse/{id}/danfse/pdf
curl --request GET \ --url https://nfse.labds.com.br/api/v1/nfse/:id/danfse/pdf
shell
Example Responses
string
text
application/pdf
SériesEndereços