---
title: "Referência: Serviços"
description: "Referência do recurso Serviços da API: objeto serviço com código de tributação nacional, cadastrar, listar, atualizar e remover serviços e erros possíveis."
url: https://docs.emissordenota.com/referencia/servicos
language: pt-BR
---
# 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.

**Escopos**: cadastros:ler · cadastros:escrever

**URL base**

```bash
# Produção
https://api.emissordenota.com/v1

# Sandbox
https://sandbox.api.emissordenota.com/v1
```

## Endpoints

- `GET /v1/servicos`: Lista os serviços de uma empresa
- `POST /v1/servicos`: Cadastra um serviço
- `POST /v1/servicos/{id}`: Atualiza um serviço
- `DELETE /v1/servicos/{id}`: Remove um serviço

## O objeto serviço

- `id` (string): Identificador do serviço, com o prefixo srv_.
- `empresa_id` (string): A empresa que presta o serviço.
- `nome` (string): Nome curto, para identificar o serviço no seu sistema e no painel.
- `codigo_tributacao_nacional` (string): Código de seis dígitos da lista nacional de serviços.
- `descricao` (string): Discriminação padrão do serviço, usada como texto inicial da nota.
- `valor_padrao` (number): Valor sugerido, em reais. Vem null quando não foi definido.
- `iss_retido` (boolean): Se o tomador costuma reter o ISS neste serviço.
- `criado_em` (string): Data e hora do cadastro, em ISO 8601.

**O objeto serviço**

```json
{
  "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_id` (string, obrigatório): A empresa que presta o serviço.
- `nome` (string, obrigatório): Nome curto, com até 60 caracteres.
- `codigo_tributacao_nacional` (string, obrigatório): Código de seis dígitos da lista nacional de serviços.
- `descricao` (string, obrigatório): Discriminação padrão do serviço.
- `valor_padrao` (number, opcional): Valor sugerido, em reais, com ponto decimal.
- `iss_retido` (boolean, opcional): O padrão é false.

**POST /v1/servicos**

```bash
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_id` (string, obrigatório): A empresa que presta os serviços.
- `limite` (integer, opcional): Itens por página. O padrão e o máximo são 50.
- `cursor` (string, opcional): O proximo_cursor da página anterior.

**GET /v1/servicos · 200 OK**

```json
{
  "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

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