Referência da APIServiços

Serviços

Os serviços que cada empresa presta, com o código de tributação e a descrição padrão. Mantenha o cadastro aqui e use os dados no objeto servico na hora de emitir.

Escoposcadastros:ler · cadastros:escrever

Linguagem dos exemplos
URL base
# Produçãohttps://api.emissordenota.com/v1# Sandboxhttps://sandbox.api.emissordenota.com/v1

Endpoints

  • GET/v1/servicosLista os serviços de uma empresa
  • POST/v1/servicosCadastra um serviço
  • POST/v1/servicos/{id}Atualiza um serviço
  • DELETE/v1/servicos/{id}Remove um serviço

O objeto serviço

idstring
Identificador do serviço, com o prefixo srv_.
empresa_idstring
A empresa que presta o serviço.
nomestring
Nome curto, para identificar o serviço no seu sistema e no painel.
codigo_tributacao_nacionalstring
Código de seis dígitos da lista nacional de serviços.
descricaostring
Discriminação padrão do serviço, usada como texto inicial da nota.
valor_padraonumber
Valor sugerido, em reais. Vem null quando não foi definido.
iss_retidoboolean
Se o tomador costuma reter o ISS neste serviço.
criado_emstring
Data e hora do cadastro, em ISO 8601.
O objeto serviço
{  "id": "srv_2Hx7vBn4Tq",  "empresa_id": "emp_8Kq2mXv41c",  "nome": "Suporte técnico mensal",  "codigo_tributacao_nacional": "010701",  "descricao": "Suporte técnico em informática",  "valor_padrao": 1500.00,  "iss_retido": false,  "criado_em": "2026-10-14T16:12:09-03:00"}

Cadastrar um serviço

POST/v1/servicos

Cria o serviço para uma empresa. O código de tributação é conferido contra a lista nacional e contra o município da empresa.

Corpo da requisição

empresa_idstringobrigatório
A empresa que presta o serviço.
nomestringobrigatório
Nome curto, com até 60 caracteres.
codigo_tributacao_nacionalstringobrigatório
Código de seis dígitos da lista nacional de serviços.
descricaostringobrigatório
Discriminação padrão do serviço.
valor_padraonumberopcional
Valor sugerido, em reais, com ponto decimal.
iss_retidobooleanopcional
O padrão é false.
POST /v1/servicos
curl -X POST https://api.emissordenota.com/v1/servicos \  -H "Authorization: Bearer $EDN_KEY" \  -H "Content-Type: application/json" \  -d '{    "empresa_id": "emp_8Kq2mXv41c",    "nome": "Suporte técnico mensal",    "codigo_tributacao_nacional": "010701",    "descricao": "Suporte técnico em informática",    "valor_padrao": 1500.00  }'

Listar serviços

GET/v1/servicos

Devolve os serviços de uma empresa, do mais recente para o mais antigo.

Parâmetros de consulta

empresa_idstringobrigatório
A empresa que presta os serviços.
limiteintegeropcional
Itens por página. O padrão e o máximo são 50.
cursorstringopcional
O proximo_cursor da página anterior.
GET /v1/servicos · 200 OK
{  "dados": [    {      "id": "srv_2Hx7vBn4Tq",      "nome": "Suporte técnico mensal",      "codigo_tributacao_nacional": "010701",      "valor_padrao": 1500.00    }  ],  "proximo_cursor": null}

Atualizar um serviço

POST/v1/servicos/{id}

Envie só os campos que mudaram. As notas já emitidas não são alteradas.

Erros

StatusCódigoQuando

  • 404servico_nao_encontrado
    O id não existe nesse ambiente.
  • 422codigo_tributacao_invalido
    O código não é aceito no município.
  • 422dados_invalidos
    Há campos inválidos no corpo.