Criar venda | Simplifica Gestão

Cria uma venda em aberto com dados básicos, itens e pagamentos opcionais.

Regras:

informe os dados básicos da venda e ao menos um item em itens;
a venda nasce em aberto;
os pagamentos são opcionais na criação;
quando enviados, os pagamentos não podem ultrapassar o total da venda;
use os identificadores publicados em GET /simplificav2/tipo_pagamento para forma_pagamento_id.

Exemplo de uso:

1 POST {{base_url}}/simplificav2/venda
2 Authorization: Bearer {{bearer_token}}
3 Content-Type: application/json
4 
5 {
6   "pessoa_id": 164272,
7   "etapa_negociacao_id": 4,
8   "origem_id": 12,
9   "data_venda": "2026-04-06",
10   "data_previsao_entrega": "2026-04-08",
11   "consultor_sdr_id": 52,
12   "consultor_closer_id": 52,
13   "observacao": "Venda criada pela integração.",
14   "observacao_interna": "Pedido com entrega local.",
15   "vl_acrescimo": 0,
16   "vl_frete": 35,
17   "itens": [
18     {
19       "produto_servico_id": 981,
20       "quantidade": 1,
21       "valor_unitario": 1500,
22       "valor_desconto": 100
23     }
24   ],
25   "pagamentos": [
26     {
27       "forma_pagamento_id": 3,
28       "numero_parcela": 1,
29       "valor_parcela": 1435,
30       "data_vencimento": "2026-04-06"
31     }
32   ]
33 }

Cria uma venda em aberto com dados básicos, itens e pagamentos opcionais. Regras: - informe os dados básicos da venda e ao menos um item em `itens`; - a venda nasce em aberto; - os pagamentos são opcionais na criação; - quando enviados, os pagamentos não podem ultrapassar o total da venda; - use os identificadores publicados em `GET /simplificav2/tipo_pagamento` para `forma_pagamento_id`. Exemplo de uso: ```http POST {{base_url}}/simplificav2/venda Authorization: Bearer {{bearer_token}} Content-Type: application/json { "pessoa_id": 164272, "etapa_negociacao_id": 4, "origem_id": 12, "data_venda": "2026-04-06", "data_previsao_entrega": "2026-04-08", "consultor_sdr_id": 52, "consultor_closer_id": 52, "observacao": "Venda criada pela integração.", "observacao_interna": "Pedido com entrega local.", "vl_acrescimo": 0, "vl_frete": 35, "itens": [ { "produto_servico_id": 981, "quantidade": 1, "valor_unitario": 1500, "valor_desconto": 100 } ], "pagamentos": [ { "forma_pagamento_id": 3, "numero_parcela": 1, "valor_parcela": 1435, "data_vencimento": "2026-04-06" } ] } ```

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.

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.

Request

This endpoint expects an object.

pessoa_idintegerRequired

Identificador do lead ou cliente da venda.

etapa_negociacao_idintegerRequired

Identificador da etapa comercial ativa.

origem_idintegerRequired

Identificador da origem comercial ativa.

data_vendastringRequired

Data da venda no formato YYYY-MM-DD.

consultor_sdr_idintegerRequired

Identificador do SDR responsável.

consultor_closer_idintegerRequired

Identificador do closer responsável.

itenslist of objectsRequired

Lista de itens da venda.

data_previsao_entregastring or nullOptional

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

endereco_entrega_idinteger or nullOptional

Identificador do endereço de entrega vinculado à pessoa.

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.

vl_fretedouble or nullOptional

Valor de frete aplicado à venda.

pagamentoslist of objects or nullOptional

Lista opcional de pagamentos iniciais da venda.

Response

Venda criada com sucesso.

statusstring

mensagemstring

dataobject

Errors

400

Bad Request Error

401

Unauthorized Error

409

Conflict Error

422

Unprocessable Entity Error

500

Internal Server Error

Cria uma venda em aberto com dados básicos, itens e pagamentos opcionais.

Regras:

informe os dados básicos da venda e ao menos um item em itens;
a venda nasce em aberto;
os pagamentos são opcionais na criação;
quando enviados, os pagamentos não podem ultrapassar o total da venda;
use os identificadores publicados em GET /simplificav2/tipo_pagamento para forma_pagamento_id.

Exemplo de uso:

1 POST {{base_url}}/simplificav2/venda
2 Authorization: Bearer {{bearer_token}}
3 Content-Type: application/json
4 
5 {
6   "pessoa_id": 164272,
7   "etapa_negociacao_id": 4,
8   "origem_id": 12,
9   "data_venda": "2026-04-06",
10   "data_previsao_entrega": "2026-04-08",
11   "consultor_sdr_id": 52,
12   "consultor_closer_id": 52,
13   "observacao": "Venda criada pela integração.",
14   "observacao_interna": "Pedido com entrega local.",
15   "vl_acrescimo": 0,
16   "vl_frete": 35,
17   "itens": [
18     {
19       "produto_servico_id": 981,
20       "quantidade": 1,
21       "valor_unitario": 1500,
22       "valor_desconto": 100
23     }
24   ],
25   "pagamentos": [
26     {
27       "forma_pagamento_id": 3,
28       "numero_parcela": 1,
29       "valor_parcela": 1435,
30       "data_vencimento": "2026-04-06"
31     }
32   ]
33 }

$	curl -X POST https://gestao.simplificagestao.com.br/ords/gestao/simplificav2/venda \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"pessoa_id": 1,
>	"etapa_negociacao_id": 1,
>	"origem_id": 1,
>	"data_venda": "string",
>	"consultor_sdr_id": 1,
>	"consultor_closer_id": 1,
>	"itens": [
>	{
>	"produto_servico_id": 1,
>	"quantidade": 1.1,
>	"valor_unitario": 1.1
>	}
>	]
>	}'

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

1	POST {{base_url}}/simplificav2/venda
2	Authorization: Bearer {{bearer_token}}
3	Content-Type: application/json
4
5	{
6	"pessoa_id": 164272,
7	"etapa_negociacao_id": 4,
8	"origem_id": 12,
9	"data_venda": "2026-04-06",
10	"data_previsao_entrega": "2026-04-08",
11	"consultor_sdr_id": 52,
12	"consultor_closer_id": 52,
13	"observacao": "Venda criada pela integração.",
14	"observacao_interna": "Pedido com entrega local.",
15	"vl_acrescimo": 0,
16	"vl_frete": 35,
17	"itens": [
18	{
19	"produto_servico_id": 981,
20	"quantidade": 1,
21	"valor_unitario": 1500,
22	"valor_desconto": 100
23	}
24	],
25	"pagamentos": [
26	{
27	"forma_pagamento_id": 3,
28	"numero_parcela": 1,
29	"valor_parcela": 1435,
30	"data_vencimento": "2026-04-06"
31	}
32	]
33	}