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
# Produçãohttps://api.emissordenota.com/v1# Sandboxhttps://sandbox.api.emissordenota.com/v1Endpoints
- 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
idstringIdentificador do serviço, com o prefixo srv_.
empresa_idstringA empresa que presta o serviço.
nomestringNome curto, para identificar o serviço no seu sistema e no painel.
codigo_tributacao_nacionalstringCódigo de seis dígitos da lista nacional de serviços.
descricaostringDiscriminação padrão do serviço, usada como texto inicial da nota.
valor_padraonumberValor sugerido, em reais. Vem null quando não foi definido.
iss_retidobooleanSe o tomador costuma reter o ISS neste serviço.
criado_emstringData e hora do cadastro, em ISO 8601.
{ "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órioA empresa que presta o serviço.
nomestringobrigatórioNome curto, com até 60 caracteres.
codigo_tributacao_nacionalstringobrigatórioCódigo de seis dígitos da lista nacional de serviços.
descricaostringobrigatórioDiscriminação padrão do serviço.
valor_padraonumberopcionalValor sugerido, em reais, com ponto decimal.
iss_retidobooleanopcionalO padrão é false.
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órioA empresa que presta os serviços.
limiteintegeropcionalItens por página. O padrão e o máximo são 50.
cursorstringopcionalO proximo_cursor da página anterior.
{ "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_encontradoO id não existe nesse ambiente.
- 422codigo_tributacao_invalidoO código não é aceito no município.
- 422dados_invalidosHá campos inválidos no corpo.