---
title: 4.3. Atualizar Emitente
url: https://docs.vehub.com.br/API/Nota%20Comercial/4.%20Emitentes/4.3.%20Atualizar%20Emitente/
---
# 4.3. Atualizar Emitente

---

## Atualizar Dados Cadastrais

### 🔗 Endpoint

| Método | URL |
|--------|-----|
| ![PUT](https://img.shields.io/badge/PUT-orange) | `/public/v1/emitentes/{id}` |

### 🧾 Descrição

Atualiza os dados cadastrais completos de um emitente existente. Todos os campos obrigatórios devem ser enviados.

### 🔹 Path Parameter

| Parâmetro | Tipo | Descrição |
|-----------|------|-----------|
| id | integer | Identificador único do emitente |

### 📋 Payload (JSON)

```json
{
  "razaoSocial": "Empresa Emissora LTDA",
  "documento": "12345678000199",
  "email": "financeiro@empresaemissora.com.br",
  "telefone": "11999990000",
  "dataFundacao": "2010-03-15",
  "site": "https://www.empresaemissora.com.br",
  "idRamoAtividade": 5,
  "endereco": "Rua das Empresas",
  "enderecoCep": "01310100",
  "enderecoNumero": "200",
  "enderecoComplemento": "Andar 10",
  "enderecoBairro": "Centro",
  "enderecoCidade": "São Paulo",
  "enderecoUF": "SP",
  "idBanco": 341,
  "agencia": "0001",
  "conta": "12345-6",
  "tipoConta": 1
}
```

> Os campos de payload são os mesmos descritos em `4.2. Criar Emitente`, exceto `numeroProximaEmissao` e `serieEmissao`, que são atualizados via endpoint específico abaixo.

### 📥 Response — `200 OK`

```json
{
  "mensagem": "Emitente atualizado com sucesso."
}
```

---

## Atualizar Parâmetros de Emissão

### 🔗 Endpoint

| Método | URL |
|--------|-----|
| ![PATCH](https://img.shields.io/badge/PATCH-yellow) | `/public/v1/emitentes/{id}/parametros` |

### 🧾 Descrição

Atualiza os parâmetros de emissão do emitente: número da próxima emissão e série da emissão. Utilizado para configurar a numeração sequencial das Notas Comerciais.

### 🔹 Path Parameter

| Parâmetro | Tipo | Descrição |
|-----------|------|-----------|
| id | integer | Identificador único do emitente |

### 📋 Payload (JSON)

```json
{
  "serieEmissao": "A"
}
```

### 🧾 Detalhamento dos Campos

| Campo | Tipo | Obrigatório | Descrição |
|-------|------|-------------|-----------|
| serieEmissao | string | Sim | Série da emissão (ex: `"A"`, `"B"`) |

### 🧪 Exemplo de cURL

```bash
curl -X PATCH https://api.vehub.com.br/public/v1/emitentes/42/parametros \
  -H "Authorization: Bearer {seu_token}" \
  -H "GrupoEconomico: {seu_grupo_economico}" \
  -H "Content-Type: application/json" \
  -d '{ "serieEmissao": "A" }'
```

### 📥 Response — `200 OK`

```json
{
  "mensagem": "Parâmetros atualizados com sucesso."
}
```

---

## ❌ Erros Comuns

### 404 Not Found

```json
{
  "tipo": "https://tools.ietf.org/html/rfc9110#section-15.5.5",
  "titulo": "Não encontrado",
  "status": 404,
  "erros": ["Emitente não encontrado."]
}
```

### 400 Bad Request

```json
{
  "tipo": "https://tools.ietf.org/html/rfc9110#section-15.5.1",
  "titulo": "Atenção",
  "status": 400,
  "erros": [
    "Campo 'enderecoUF' inválido.",
    "Campo 'email' deve conter um e-mail válido."
  ]
}
```