Gerar venda a partir da oportunidade

POST

/simplificav2/oportunidade/:id/venda

Cria uma venda em aberto a partir de uma oportunidade ativa e pendente. Regras: - a oportunidade precisa estar ativa e pendente; - a venda nasce com os itens ativos da oportunidade; - você pode enviar pagamentos junto com a geração da venda; - o total dos pagamentos não pode ser maior que o total da venda; - a rota gera a venda, mas não finaliza a venda automaticamente. Exemplo de uso: ```http POST {{base_url}}/simplificav2/oportunidade/29627/venda Authorization: Bearer {{bearer_token}} Content-Type: application/json { "data_venda": "2026-04-06", "data_previsao_entrega": "2026-04-10", "pagamentos": [ { "forma_pagamento_id": 3, "numero_parcela": 1, "valor_parcela": 1400, "data_vencimento": "2026-04-06" } ] } ```

Gerar venda a partir da oportunidade

POST

/simplificav2/oportunidade/:id/venda

Cria uma venda em aberto a partir de uma oportunidade ativa e pendente.

Regras:

a oportunidade precisa estar ativa e pendente;
a venda nasce com os itens ativos da oportunidade;
você pode enviar pagamentos junto com a geração da venda;
o total dos pagamentos não pode ser maior que o total da venda;
a rota gera a venda, mas não finaliza a venda automaticamente.

Exemplo de uso:

1 POST {{base_url}}/simplificav2/oportunidade/29627/venda
2 Authorization: Bearer {{bearer_token}}
3 Content-Type: application/json
4 
5 {
6   "data_venda": "2026-04-06",
7   "data_previsao_entrega": "2026-04-10",
8   "pagamentos": [
9     {
10       "forma_pagamento_id": 3,
11       "numero_parcela": 1,
12       "valor_parcela": 1400,
13       "data_vencimento": "2026-04-06"
14     }
15   ]
16 }

Authentication

AuthorizationBearer

Token privado usado para consultar dados da plataforma. Como usar: - obtenha o token privado da sua empresa; - envie `Authorization: Bearer SEU_TOKEN_PRIVADO`; - não use `x-api-key` neste módulo.

Path parameters

idintegerRequired

Identificador da oportunidade.

Request

This endpoint expects an object.

data_vendastring or nullOptional

Data da venda no formato YYYY-MM-DD.

data_previsao_entregastring or nullOptional

Data prevista de entrega no formato YYYY-MM-DD.

endereco_entrega_idinteger or nullOptional

Endereço de entrega da venda gerada.

observacaostring or nullOptional

Observação visível no documento da venda.

observacao_internastring or nullOptional

Observação interna da venda.

vl_acrescimodouble or nullOptional

Valor adicional aplicado à venda gerada.

vl_fretedouble or nullOptional

Valor de frete aplicado à venda gerada.

pagamentoslist of objects or nullOptional

Lista opcional de pagamentos iniciais da venda gerada.

Response

Venda gerada com sucesso.

statusstring

mensagemstring

dataobject

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

409

Conflict Error

422

Unprocessable Entity Error

500

Internal Server Error

$	curl -X POST https://gestao.simplificagestao.com.br/ords/gestao/simplificav2/oportunidade/1/venda \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{}'

1	{
2	"status": "sucesso",
3	"mensagem": "Venda criada com sucesso.",
4	"data": {
5	"id": 41521
6	}
7	}

$	curl -X POST https://gestao.simplificagestao.com.br/ords/gestao/simplificav2/oportunidade/1/venda \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{}'

1	{
2	"status": "sucesso",
3	"mensagem": "Venda criada com sucesso.",
4	"data": {
5	"id": 41521
6	}
7	}

1	POST {{base_url}}/simplificav2/oportunidade/29627/venda
2	Authorization: Bearer {{bearer_token}}
3	Content-Type: application/json
4
5	{
6	"data_venda": "2026-04-06",
7	"data_previsao_entrega": "2026-04-10",
8	"pagamentos": [
9	{
10	"forma_pagamento_id": 3,
11	"numero_parcela": 1,
12	"valor_parcela": 1400,
13	"data_vencimento": "2026-04-06"
14	}
15	]
16	}