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

## 🔗 Endpoint

| Método | URL |
|--------|-----|
| ![POST](https://img.shields.io/badge/POST-blue) | `/public/v1/emitentes` |

---

## 🧾 Descrição

Realiza o cadastro de um novo emitente. O processo de cadastro completo compreende as seguintes etapas, realizadas em endpoints separados:

1. **Ficha cadastral** (este endpoint) — dados da empresa, conta bancária e parâmetros de emissão
2. **Assinantes** — representantes e sócios (ver `4.4. Assinantes`)
3. **Documentos** — envio de arquivos obrigatórios (ver `4.5. Documentos`)
4. **Vínculo com financiador** (ver `4.6. Vincular Financiador`)
5. **Habilitação no escriturador** (ver `4.7. Habilitar em Escriturador`)

> Apenas emitentes com status **Aprovado** no escriturador poderão emitir Notas Comerciais.

---

## 📤 Requisição

### 📋 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,
  "numeroProximaEmissao": 1,
  "serieEmissao": "A",
  "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
}
```

### 🧾 Detalhamento dos Campos

| Campo | Tipo | Obrigatório | Descrição |
|-------|------|-------------|-----------|
| razaoSocial | string | Sim | Razão social da empresa |
| documento | string | Sim | CNPJ (somente números, 14 dígitos) |
| email | string | Sim | E-mail corporativo |
| telefone | string | Não | Telefone (somente números) |
| dataFundacao | string | Não | Data de fundação (YYYY-MM-DD) |
| site | string | Não | URL do site da empresa |
| idRamoAtividade | integer | Não | ID do ramo de atividade (ver Enumerações) |
| numeroProximaEmissao | integer | Não | Número da próxima emissão (padrão: 1) |
| serieEmissao | string | Não | Série da emissão (ex: `"A"`) |
| endereco | string | Sim | Logradouro |
| enderecoCep | string | Sim | CEP (somente números, 8 dígitos) |
| enderecoNumero | string | Sim | Número do endereço |
| enderecoComplemento | string | Não | Complemento |
| enderecoBairro | string | Sim | Bairro |
| enderecoCidade | string | Sim | Cidade |
| enderecoUF | string | Sim | Sigla do estado (ex: `"SP"`) |
| idBanco | integer | Sim | ID do banco (ver Enumerações — Bancos) |
| agencia | string | Sim | Agência bancária |
| conta | string | Sim | Número da conta |
| tipoConta | integer | Sim | `1` = Corrente, `2` = Poupança |

---

## 🧪 Exemplo de cURL

```bash
curl -X POST https://api.vehub.com.br/public/v1/emitentes \
  -H "Authorization: Bearer {seu_token}" \
  -H "GrupoEconomico: {seu_grupo_economico}" \
  -H "Content-Type: application/json" \
  -d '{
    "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,
    "numeroProximaEmissao": 1,
    "serieEmissao": "A",
    "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
  }'
```

---

## 📥 Responses

### ✅ 201 Created

```json
{
  "mensagem": "Emitente cadastrado com sucesso.",
  "id": 42
}
```

| Campo | Tipo | Descrição |
|-------|------|-----------|
| mensagem | string | Confirmação da operação |
| id | integer | ID do emitente criado |

---

### ❌ 400 Bad Request

```json
{
  "tipo": "https://tools.ietf.org/html/rfc9110#section-15.5.1",
  "titulo": "Atenção",
  "status": 400,
  "erros": [
    "Campo 'razaoSocial' é obrigatório.",
    "Campo 'documento' deve conter um CNPJ válido com 14 dígitos.",
    "Campo 'enderecoCep' deve conter 8 dígitos numéricos."
  ]
}
```

---

### ❌ 409 Conflict

```json
{
  "tipo": "https://tools.ietf.org/html/rfc9110#section-15.5.10",
  "titulo": "Conflito",
  "status": 409,
  "erros": ["Já existe um emitente cadastrado com o documento informado."]
}
```