For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
DocumentaçãoReferência da API
DocumentaçãoReferência da API
  • Integrações privadas
        • GETListar vendas
        • POSTCriar venda
        • PUTAtualizar venda
        • PUTAtualizar pagamentos da venda
        • POSTFinalizar venda
        • GETListar itens de venda
  • Entrada pública de leads
LogoLogo
Integrações privadasComercialVendas

Criar venda

||View as Markdown|
POST
/simplificav2/venda
POST
/ords/gestao/simplificav2/venda
$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}
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" } ] } ```
Was this page helpful?
Previous

Listar vendas

Next

Atualizar venda

Built with

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:

1POST {{base_url}}/simplificav2/venda
2Authorization: Bearer {{bearer_token}}
3Content-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}

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.

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

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.