• 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

Séries

Gerenciamento de séries de notas fiscais, controle de numeração sequencial e alternância entre ambientes de homologação e produção.

Listar séries da empresa

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

Lista todas as séries de notas fiscais configuradas para a empresa no ambiente atual (produção ou homologação).

Listar séries da empresa › Responses

200

Lista de séries

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

Criar nova série

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

Cadastra uma nova série de notas fiscais para a empresa, definindo a numeração inicial e o ambiente de emissão.

Criar nova série › Request Body

serie
​string · required
ambiente
​string · enum
Enum values:
homologacao
producao
Default: homologacao
ultimoNumero
​integer
Default: 0

Criar nova série › Responses

Série criada

No data returned
POST/series
curl --request POST \ --url https://nfse.labds.com.br/api/v1/series \ --header 'Content-Type: application/json' \ --data ' { "serie": "NFSE", "ambiente": "homologacao", "ultimoNumero": 0 } '
shell
Example Request Body
{ "serie": "NFSE", "ambiente": "homologacao", "ultimoNumero": 0 }
json
Example Responses
No example specified for this content type

Obtém a série ativa para um ambiente

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

Retorna a série atualmente ativa configurada como padrão para emissão de notas fiscais pela empresa selecionada.

Obtém a série ativa para um ambiente › query Parameters

ambiente
​string · enum

Ambiente (default homologacao)

Enum values:
homologacao
producao

Obtém a série ativa para um ambiente › Responses

200

Série ativa

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

Obtém o próximo número da série ativa

GET
https://nfse.labds.com.br/api/v1
/series/proximo-numero

Calcula e retorna o próximo número sequencial que será utilizado na emissão da próxima NFS-e para a série ativa.

Obtém o próximo número da série ativa › query Parameters

ambiente
​string · enum
Enum values:
homologacao
producao

Obtém o próximo número da série ativa › Responses

200

Próximo número

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

Obtém uma série por ID

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

Consulta as configurações detalhadas de uma série específica de notas fiscais pelo seu identificador.

Obtém uma série por ID › path Parameters

id
​string · required

Obtém uma série por ID › Responses

Dados da série

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

Atualizar série

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

Atualiza as configurações de uma série de notas fiscais, como status ativo e controle de numeração.

Atualizar série › path Parameters

id
​string · required

Atualizar série › Request Body

ultimoNumero
​integer
ativo
​boolean

Atualizar série › Responses

Série atualizada

No data returned
PUT/series/{id}
curl --request PUT \ --url https://nfse.labds.com.br/api/v1/series/:id \ --header 'Content-Type: application/json' \ --data ' { "ultimoNumero": 0, "ativo": true } '
shell
Example Request Body
{ "ultimoNumero": 0, "ativo": true }
json
Example Responses
No example specified for this content type

Define o número inicial de uma série (para migração)

POST
https://nfse.labds.com.br/api/v1
/series/numero-inicial

Útil quando migra de outro sistema e precisa continuar a numeração. O próximo número emitido será o numero_inicial informado.

Define o número inicial de uma série (para migração) › Request Body

serie
​string · required
numeroInicial
​integer · required
ambiente
​string · enum
Enum values:
homologacao
producao
Default: producao

Define o número inicial de uma série (para migração) › Responses

Número inicial definido

No data returned
POST/series/numero-inicial
curl --request POST \ --url https://nfse.labds.com.br/api/v1/series/numero-inicial \ --header 'Content-Type: application/json' \ --data ' { "serie": "NFSE", "ambiente": "producao", "numeroInicial": 1001 } '
shell
Example Request Body
{ "serie": "NFSE", "ambiente": "producao", "numeroInicial": 1001 }
json
Example Responses
No example specified for this content type
ServiçosNFS-e