Digitar proposta

Sandbox

http://localhost:4500/api/v1

POST

/propostas

Digita uma proposta na esteira Nexxus (fase inicial: digitada).
Os valores são calculados pelo servidor a partir da tabela:
bruto_liberado = parcela / coeficiente e troco = bruto_liberado − saldo_devedor − seguro.
Troco negativo é rejeitado (422 TROCO_NEGATIVO).

Idempotência: envie referencia_externa (seu ID único). Reenviar a mesma
referência retorna 409 REFERENCIA_DUPLICADA com o código da proposta já criada.

Requisição

Parâmetros Bodyapplication/jsonNecessário

Examples

Respostas

🟢201Criado

application/json

Proposta digitada na esteira

Bodyapplication/json

🟠403Proibido

🟠409

🟠422Erro de Parâmetro

🟠429

Request Example

Shell

JavaScript

Java

Swift

curl --location 'http://localhost:4500/api/v1/propostas' \
--header 'Content-Type: application/json' \
--data-raw '{
    "referencia_externa": "CRM-2026-0001",
    "cliente": {
        "cpf": "529.982.247-25",
        "nome": "Maria de Teste Silva",
        "matricula": "12345-6",
        "dt_nascimento": "1965-06-03",
        "sexo": "F",
        "celular": "62999998888",
        "email": "maria@example.com"
    },
    "endereco": {
        "cep": "74000-000",
        "logradouro": "Rua Um",
        "numero": "10",
        "bairro": "Centro",
        "cidade": "Goiânia",
        "uf": "GO"
    },
    "dados_bancarios": {
        "banco": "104",
        "agencia": "0001",
        "conta": "123456",
        "conta_dv": "7"
    },
    "operacao": {
        "tabela_id": 1,
        "parcela": 300,
        "saldo_devedor": 1000,
        "banco_origem": "Banco Santander"
    }
}'

Response Example

201 - Exemplo 1

{
    "codigo": "NXX-20260708-0001",
    "fase": "digitada",
    "origem": "api",
    "referencia_externa": "string",
    "cliente": {
        "cpf": "529.982.247-25",
        "nome": "string",
        "dt_nascimento": "string",
        "matricula": "string",
        "sexo": "string",
        "celular": "string",
        "email": "string"
    },
    "operacao": {
        "convenio": "Gov. Goiás",
        "banco_origem": "string",
        "tabela_id": 0,
        "tabela_nome": "string",
        "parcela": 0,
        "saldo_devedor": 0,
        "coeficiente": 0,
        "seguro": 0,
        "bruto_liberado": 0,
        "troco": 0
    },
    "criada_em": "2019-08-24T14:15:22.123Z",
    "atualizada_em": "2019-08-24T14:15:22.123Z"
}

Modificado em 2026-07-08 01:52:25

Página anterior

Listar tabelas de operação

Próxima página

Listar propostas