Ir para o conteúdo

4.3. Atualizar Emitente

Atualizar Dados Cadastrais

🔗 Endpoint

Método URL
PUT /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)

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

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

Atualizar Parâmetros de Emissão

🔗 Endpoint

Método URL
PATCH /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)

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

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

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

❌ Erros Comuns

404 Not Found

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

{
  "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."
  ]
}