• 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

Empresas

Gestão e cadastro de empresas prestadoras de serviço, consulta por CNPJ na Receita Federal e configuração fiscal.

Percentual de completude do cadastro da empresa

GET
https://nfse.labds.com.br/api/v1
/empresas/cadastro-percentual

Retorna um cálculo de completude do cadastro da empresa do usuário logado, baseado em campos essenciais (dados cadastrais, endereço, contato e certificado).

Percentual de completude do cadastro da empresa › Responses

Percentual e itens avaliados

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

Listar empresas

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

Lista todas as empresas prestadoras cadastradas no workspace, com paginação e filtros por status e CNPJ.

Listar empresas › Responses

Lista de empresas

success
​boolean
​object[]
GET/empresas
curl --request GET \ --url https://nfse.labds.com.br/api/v1/empresas
shell
Example Responses
{ "success": true, "data": [ { "id": "00000000-0000-0000-0000-000000000000", "cnpj": "12.345.678/0001-90", "razaoSocial": "razaoSocial", "nomeFantasia": "nomeFantasia", "inscricaoMunicipal": "inscricaoMunicipal", "cep": "cep", "logradouro": "logradouro", "numero": "numero", "bairro": "bairro", "nomeMunicipio": "nomeMunicipio", "uf": "uf", "telefone": "telefone", "email": "test@example.com", "optanteSimplesNacional": true } ] }
json
application/json

Criar empresa

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

Cadastra uma nova empresa prestadora de serviços no workspace, incluindo dados cadastrais, regime tributário e endereço.

Criar empresa › Request Body

cnpj
​string · required
razaoSocial
​string · required
nomeFantasia
​string
inscricaoMunicipal
​string
cep
​string
logradouro
​string
numero
​string
bairro
​string
codigoMunicipioIbge
​string
nomeMunicipio
​string
uf
​string
telefone
​string
email
​string
optanteSimplesNacional
​boolean

Criar empresa › Responses

Empresa criada

No data returned
POST/empresas
curl --request POST \ --url https://nfse.labds.com.br/api/v1/empresas \ --header 'Content-Type: application/json' \ --data ' { "cnpj": "12.345.678/0001-90", "razaoSocial": "razaoSocial", "nomeFantasia": "nomeFantasia", "inscricaoMunicipal": "inscricaoMunicipal", "cep": "cep", "logradouro": "logradouro", "numero": "numero", "bairro": "bairro", "codigoMunicipioIbge": "codigoMunicipioIbge", "nomeMunicipio": "nomeMunicipio", "uf": "uf", "telefone": "telefone", "email": "email", "optanteSimplesNacional": true } '
shell
Example Request Body
{ "cnpj": "12.345.678/0001-90", "razaoSocial": "razaoSocial", "nomeFantasia": "nomeFantasia", "inscricaoMunicipal": "inscricaoMunicipal", "cep": "cep", "logradouro": "logradouro", "numero": "numero", "bairro": "bairro", "codigoMunicipioIbge": "codigoMunicipioIbge", "nomeMunicipio": "nomeMunicipio", "uf": "uf", "telefone": "telefone", "email": "email", "optanteSimplesNacional": true }
json
Example Responses
No example specified for this content type

Consultar dados de empresa por CNPJ (Minha Receita)

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

Consulta os dados cadastrais de uma empresa diretamente na base da Receita Federal a partir do número do CNPJ informado.

Consultar dados de empresa por CNPJ (Minha Receita) › path Parameters

cnpj
​string · required

CNPJ (com ou sem máscara)

Consultar dados de empresa por CNPJ (Minha Receita) › Responses

Dados retornados pela API Minha Receita

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

Consultar validade do certificado digital

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

Retorna informações sobre a validade do certificado digital da empresa do usuário logado

Consultar validade do certificado digital › Responses

200

Dados do certificado

success
​boolean
​object
GET/empresas/certificado
curl --request GET \ --url https://nfse.labds.com.br/api/v1/empresas/certificado
shell
Example Responses
{ "success": true, "data": { "configurado": true, "validadeCertificado": "2024-08-25T15:00:00Z", "diasParaVencer": 0, "status": "VALIDO" } }
json
application/json

Obter empresa por ID

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

Retorna os dados cadastrais detalhados de uma empresa prestadora específica pelo seu identificador único (UUID).

Obter empresa por ID › path Parameters

id
​string · uuid · required

Obter empresa por ID › Responses

Dados da empresa

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

Atualizar empresa

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

Atualiza os dados cadastrais, contatos ou endereço de uma empresa prestadora existente.

Atualizar empresa › path Parameters

id
​string · uuid · required

Atualizar empresa › Request Body

id
​string · uuid
cnpj
​string
razaoSocial
​string
nomeFantasia
​string
inscricaoMunicipal
​string
cep
​string
logradouro
​string
numero
​string
bairro
​string
nomeMunicipio
​string
uf
​string · maxLength: 2
telefone
​string
email
​string · email
optanteSimplesNacional
​boolean

Atualizar empresa › Responses

Empresa atualizada

No data returned
PUT/empresas/{id}
curl --request PUT \ --url https://nfse.labds.com.br/api/v1/empresas/:id \ --header 'Content-Type: application/json' \ --data ' { "id": "00000000-0000-0000-0000-000000000000", "cnpj": "12.345.678/0001-90", "razaoSocial": "razaoSocial", "nomeFantasia": "nomeFantasia", "inscricaoMunicipal": "inscricaoMunicipal", "cep": "cep", "logradouro": "logradouro", "numero": "numero", "bairro": "bairro", "nomeMunicipio": "nomeMunicipio", "uf": "uf", "telefone": "telefone", "email": "test@example.com", "optanteSimplesNacional": true } '
shell
Example Request Body
{ "id": "00000000-0000-0000-0000-000000000000", "cnpj": "12.345.678/0001-90", "razaoSocial": "razaoSocial", "nomeFantasia": "nomeFantasia", "inscricaoMunicipal": "inscricaoMunicipal", "cep": "cep", "logradouro": "logradouro", "numero": "numero", "bairro": "bairro", "nomeMunicipio": "nomeMunicipio", "uf": "uf", "telefone": "telefone", "email": "test@example.com", "optanteSimplesNacional": true }
json
Example Responses
No example specified for this content type

Desativar empresa

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

Remove uma empresa prestadora do workspace. Esta ação só é permitida se não houver notas fiscais emitidas vinculadas a ela.

Desativar empresa › path Parameters

id
​string · uuid · required

Desativar empresa › Responses

Empresa desativada

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

Upload de certificado digital A1

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

Faz upload do certificado digital A1 (.pfx ou .p12). O backend extrai automaticamente a validade e informações do certificado.

Upload de certificado digital A1 › path Parameters

id
​string · uuid · required

Upload de certificado digital A1 › Request Body

certificado
​string · required

Arquivo .pfx ou .p12

senha
​string · required

Senha do certificado

Upload de certificado digital A1 › Responses

Certificado configurado

success
​boolean
message
​string
​object
POST/empresas/{id}/certificado
curl --request POST \ --url https://nfse.labds.com.br/api/v1/empresas/:id/certificado \ --header 'Content-Type: multipart/form-data' \ --form certificado=certificado \ --form senha=senha
shell
Example Request Body
{ "certificado": "certificado", "senha": "senha" }
json
Example Responses
{ "success": true, "message": "message", "data": { "subject": "subject", "issuer": "issuer", "validade": "2024-08-25T15:00:00Z", "serialNumber": "serialNumber" } }
json
application/json
Tomadores