# Atualizar Configuração Fiscal
`PUT /v1/invoices/notas/config/:configid`
**Área:** Notas Fiscais

**Scopes necessários:** `nota.fiscal/write`

Atualiza uma configuração fiscal. Envie apenas os campos que mudam — os demais são preservados.

> ⚠️ **Atenção:** o merge é por campo do primeiro nível, não por campo aninhado. Enviar `prestador` com dois campos substitui o objeto `prestador` inteiro, apagando o que não veio. O mesmo vale para `endereco` e `certificate`: monte o objeto completo antes de enviar.

`prefeitura` é a exceção: os campos enviados são mesclados com os já gravados, então dá para alterar só a série do RPS sem reenviar a senha.

Enviar `null` em um campo o remove da configuração.

`certificate` com `pfx_base64` e `password` substitui o certificado e revalida a empresa emissora; o certificado anterior é apagado, a menos que outra configuração da conta use o mesmo arquivo.

Qualquer alteração revalida a empresa emissora. Se essa etapa falhar, nada é gravado.

Case de uso:

_Como plataforma, quero trocar o certificado digital antes do vencimento, sem recriar a configuração._

### Path parameters

| Campo | Obrigatório | Descrição |
|---|---|---|
| `configid` | **sim** | Configid |

### Request body

```json
{
  "config_name": "Matriz",
  "enabled": true,
  "invoiceTiming": "AFTER_CONFIRMATION",
  "daysAfterConfirmation": 3,
  "descricao_servico": "Consultoria em tecnologia da informação",
  "codigo_tributacao_nacional_iss": "010701",
  "tributacao_iss": 1,
  "tipo_retencao_iss": 1,
  "aliquota_iss": 2,
  "item_lista_servico": "07.02",
  "serie_dps": "1",
  "prefeitura": {
    "login": "usuario-do-portal",
    "senha": "chave-ou-senha-do-portal",
    "serie_rps": "1",
    "proximo_numero_rps": 145
  },
  "certificate": {
    "pfx_base64": "MIIQ…",
    "password": "senha-do-certificado"
  }
}
```

### Campos do body

**Obrigatórios:** `certificate.pfx_base64`, `certificate.password`

| Campo | Descrição |
|---|---|
| `certificate.pfx_base64` |  |
| `certificate.password` |  |

**Opcionais**

| Campo | Descrição |
|---|---|
| `config_name` |  |
| `enabled` | false desliga a emissão sem apagar a configuração |
| `invoiceTiming` | Momento da emissão nas notas geradas por cobrança (valores: IMMEDIATE, AFTER_CONFIRMATION, DAYS_AFTER_CONFIRMATION) |
| `daysAfterConfirmation` | Só com invoiceTiming DAYS_AFTER_CONFIRMATION (mín.: 1) |
| `descricao_servico` |  |
| `codigo_tributacao_nacional_iss` |  |
| `tributacao_iss` |  |
| `tipo_retencao_iss` |  |
| `aliquota_iss` | NFS-e municipal |
| `item_lista_servico` | NFS-e municipal |
| `serie_dps` | NFS-en: série da DPS |
| `prefeitura` | Mesclado com o que já está gravado; envie só o que muda |
| `prefeitura.login` |  |
| `prefeitura.senha` | Só quando a credencial muda |
| `prefeitura.serie_rps` | Série do RPS registrada na prefeitura |
| `prefeitura.proximo_numero_rps` | Número do próximo RPS a emitir (mín.: 1) |
| `certificate` | Só para substituir o certificado |

### Resposta 200 — 200

```json
{
  "id": "unc_1788193720141_65g0zh12p",
  "accountId": "460851686",
  "config_name": "Matriz",
  "enabled": true,
  "invoiceTiming": "IMMEDIATE",
  "codigo_tributacao_nacional_iss": "010701",
  "tributacao_iss": 1,
  "tipo_retencao_iss": 1,
  "serie_dps": "1",
  "descricao_servico": "Prestação de Serviços",
  "prestador": {
    "cnpj": "99988877000108",
    "nome_fantasia": "EMPRESA EXEMPLO LTDA",
    "inscricao_municipal": "1234567",
    "codigo_municipio": "4205407",
    "codigo_municipio_prestacao": "4205407",
    "codigo_opcao_simples_nacional": 1,
    "regime_especial_tributacao": 0
  },
  "prefeitura": {
    "login": "usuario-do-portal",
    "has_senha": true,
    "serie_rps": "1",
    "proximo_numero_rps": 145
  },
  "certificate": {
    "has_certificate": true,
    "expiry_date": "2026-11-18T11:01:15.000Z"
  },
  "createdAt": "2026-08-31T16:28:43.167Z",
  "updatedAt": "2026-08-31T16:28:43.167Z"
}
```

### Resposta 404 — 404

```json
{
    "error": {
        "message": "Configuração não encontrada",
        "code": "NOTA_CONFIG_NOT_FOUND",
        "details": null,
        "timestamp": "2026-07-14T21:39:36.322Z"
    }
}
```

---
Página: https://docs.validapay.com.br/documentacao-validapay2/put-atualizar-configuracao-fiscal
Contrato OpenAPI: https://docs.validapay.com.br/openapi.json