---
title: 5.4. Criar Nota Comercial com Dados Manuais
url: https://docs.vehub.com.br/API/Nota%20Comercial/5.%20Nota%20Comercial/5.4.%20Criar%20com%20Dados%20Manuais/
---
# 5.4. Criar Nota Comercial com Dados Manuais

## 🔗 Endpoint

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

---

## 🧾 Descrição

Cria uma nova Nota Comercial informando todos os parâmetros financeiros manualmente, sem a necessidade de uma simulação prévia. O financiador e o emitente são obrigatórios desde o primeiro momento.

Este endpoint também permite o envio de **parcelas personalizadas**, útil quando o fluxo de pagamento não segue um padrão regular.

O emitente informado deve estar com status **Aprovado** no escriturador para a operação ser criada.

A NC criada ficará com status **Em Digitação** (`1`).

---

## 📤 Requisição

### 📋 Payload (JSON) — Parcelas Regulares

```json
{
  "idEmitente": 42,
  "idFinanciador": 3,
  "idEsteira": 10,
  "dataEmissao": "2025-10-01",
  "dataPrimeiraParcela": "2025-11-01",
  "valorSolicitado": 500000.00,
  "valorPartida": 1,
  "idIndice": 1,
  "idTabelaCalculo": 1,
  "idBaseCalculo": 1,
  "taxa": 1.25,
  "periodicidade": 1,
  "quantidadeParcelas": 12,
  "capitalizacao": 2,
  "intervaloAmortizacao": 1,
  "idIndexador": null,
  "percentualIndexador": null,
  "carenciaPrincipal": 0,
  "periodicidadeTaxa": 1,
  "valorSeguro": null,
  "valorGravame": null,
  "parcelasPersonalizadas": []
}
```

### 📋 Payload (JSON) — Com Parcelas Personalizadas

```json
{
  "idEmitente": 42,
  "idFinanciador": 3,
  "idEsteira": 10,
  "dataEmissao": "2025-10-01",
  "dataPrimeiraParcela": "2025-11-01",
  "valorSolicitado": 500000.00,
  "valorPartida": 1,
  "idIndice": 1,
  "idTabelaCalculo": 1,
  "idBaseCalculo": 1,
  "taxa": 1.25,
  "periodicidade": 1,
  "quantidadeParcelas": 3,
  "capitalizacao": 2,
  "intervaloAmortizacao": 1,
  "carenciaPrincipal": 0,
  "parcelasPersonalizadas": [
    {
      "numeroParcela": 1,
      "dataVencimento": "2025-11-01",
      "valorParcela": 100000.00
    },
    {
      "numeroParcela": 2,
      "dataVencimento": "2025-12-01",
      "valorParcela": 200000.00
    },
    {
      "numeroParcela": 3,
      "dataVencimento": "2026-01-01",
      "valorParcela": 300000.00
    }
  ]
}
```

### 🧾 Detalhamento dos Campos

| Campo | Tipo | Obrigatório | Descrição |
|-------|------|-------------|-----------|
| idEmitente | integer | Sim | ID do emitente (deve estar aprovado no escriturador) |
| idFinanciador | integer | Sim | ID do financiador |
| idEsteira | integer | Sim | ID da esteira a utilizar (ver `3.3. Esteiras`) |
| dataEmissao | string | Sim | Data de emissão (YYYY-MM-DD) |
| dataPrimeiraParcela | string | Sim | Data da 1ª parcela (YYYY-MM-DD) |
| valorSolicitado | number | Sim | Valor da operação |
| valorPartida | integer | Sim | `1` = Valor Líquido, `2` = Valor Bruto |
| idIndice | integer | Sim | `1` = Pré-fixado, `2` = Pós-fixado |
| idTabelaCalculo | integer | Sim | `1` = PRICE, `2` = SAC |
| idBaseCalculo | integer | Sim | Base de cálculo (ver Enumerações) |
| taxa | number | Sim | Taxa de juros no período |
| periodicidade | integer | Sim | Periodicidade das parcelas (ver Enumerações) |
| quantidadeParcelas | integer | Sim | Número total de parcelas |
| capitalizacao | integer | Sim | `1` = Diária, `2` = Mensal |
| intervaloAmortizacao | integer | Sim | Intervalo de amortização em períodos |
| idIndexador | integer | Não | Obrigatório quando `idIndice` = `2` |
| percentualIndexador | number | Não | Percentual sobre o indexador (ex: `100` = 100% CDI) |
| carenciaPrincipal | integer | Não | Carência em dias (padrão: `0`) |
| periodicidadeTaxa | integer | Não | Periodicidade da taxa |
| valorSeguro | number | Não | Custo de seguro |
| valorGravame | number | Não | Custo de gravame |
| parcelasPersonalizadas | array | Não | Parcelas com valores e datas customizadas |

#### 🔹 parcelasPersonalizadas[]

| Campo | Tipo | Obrigatório | Descrição |
|-------|------|-------------|-----------|
| numeroParcela | integer | Sim | Número sequencial da parcela |
| dataVencimento | string | Sim | Data de vencimento (YYYY-MM-DD) |
| valorParcela | number | Sim | Valor total desta parcela |

---

## 🧪 Exemplo de cURL

```bash
curl -X POST https://api.vehub.com.br/public/v1/nota-comercial/manual \
  -H "Authorization: Bearer {seu_token}" \
  -H "GrupoEconomico: {seu_grupo_economico}" \
  -H "Content-Type: application/json" \
  -d '{
    "idEmitente": 42,
    "idFinanciador": 3,
    "idEsteira": 10,
    "dataEmissao": "2025-10-01",
    "dataPrimeiraParcela": "2025-11-01",
    "valorSolicitado": 500000.00,
    "valorPartida": 1,
    "idIndice": 1,
    "idTabelaCalculo": 1,
    "idBaseCalculo": 1,
    "taxa": 1.25,
    "periodicidade": 1,
    "quantidadeParcelas": 12,
    "capitalizacao": 2,
    "intervaloAmortizacao": 1,
    "carenciaPrincipal": 0
  }'
```

---

## 📥 Responses

### ✅ 201 Created

```json
{
  "mensagem": "Nota Comercial criada com sucesso.",
  "id": 101,
  "status": 1,
  "descricaoStatus": "Em Digitação"
}
```

---

### ❌ 400 Bad Request

```json
{
  "tipo": "https://tools.ietf.org/html/rfc9110#section-15.5.1",
  "titulo": "Atenção",
  "status": 400,
  "erros": [
    "Campo 'idEmitente' é obrigatório.",
    "Campo 'idFinanciador' é obrigatório.",
    "As parcelas personalizadas informadas não zeram o saldo devedor ao final da operação.",
    "O emitente informado não está aprovado em nenhum escriturador."
  ]
}
```