Ir para o conteúdo

4.2. Criar Emitente

🔗 Endpoint

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

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

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

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

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

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