Criar oportunidade

POST

/simplificav2/oportunidade

Cria uma nova oportunidade com dados básicos e itens comerciais. Regras: - informe a pessoa, a etapa, a origem, as datas e os responsáveis; - envie ao menos um item em `itens`; - os itens aceitam produto, serviço ou kit; - a oportunidade nasce ativa; - esta rota não possui opção de inativação. Exemplo de uso: ```http POST {{base_url}}/simplificav2/oportunidade Authorization: Bearer {{bearer_token}} Content-Type: application/json { "pessoa_id": 164272, "etapa_negociacao_id": 7, "origem_id": 12, "data_oportunidade": "2026-04-05", "data_previsao_fechamento": "2026-04-30", "consultor_sdr_id": 52, "consultor_closer_id": 52, "observacao": "Proposta inicial enviada.", "observacao_interna": "Negociação em andamento.", "vl_acrescimo": 0, "vl_frete": 35, "itens": [ { "produto_servico_id": 981, "quantidade": 1, "valor_unitario": 1500, "valor_desconto": 100 } ] } ```

Criar oportunidade

POST

/simplificav2/oportunidade

Cria uma nova oportunidade com dados básicos e itens comerciais.

Regras:

informe a pessoa, a etapa, a origem, as datas e os responsáveis;
envie ao menos um item em itens;
os itens aceitam produto, serviço ou kit;
a oportunidade nasce ativa;
esta rota não possui opção de inativação.

Exemplo de uso:

1 POST {{base_url}}/simplificav2/oportunidade
2 Authorization: Bearer {{bearer_token}}
3 Content-Type: application/json
4 
5 {
6   "pessoa_id": 164272,
7   "etapa_negociacao_id": 7,
8   "origem_id": 12,
9   "data_oportunidade": "2026-04-05",
10   "data_previsao_fechamento": "2026-04-30",
11   "consultor_sdr_id": 52,
12   "consultor_closer_id": 52,
13   "observacao": "Proposta inicial enviada.",
14   "observacao_interna": "Negociação em andamento.",
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 }

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 oportunidade.

etapa_negociacao_idintegerRequired

Identificador da etapa de negociação ativa.

origem_idintegerRequired

Identificador da origem comercial ativa.

data_oportunidadestringRequired

Data da oportunidade no formato YYYY-MM-DD.

data_previsao_fechamentostringRequired

Data prevista de fechamento 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 oportunidade.

endereco_entrega_idinteger or nullOptional

Identificador do endereço de entrega vinculado à pessoa.

observacaostring or nullOptional

Observação visível no documento comercial.

observacao_internastring or nullOptional

Observação interna da oportunidade.

vl_acrescimodouble or nullOptional

Valor adicional aplicado à oportunidade.

vl_fretedouble or nullOptional

Valor de frete aplicado à oportunidade.

Response

Oportunidade 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

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

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

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

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

1	POST {{base_url}}/simplificav2/oportunidade
2	Authorization: Bearer {{bearer_token}}
3	Content-Type: application/json
4
5	{
6	"pessoa_id": 164272,
7	"etapa_negociacao_id": 7,
8	"origem_id": 12,
9	"data_oportunidade": "2026-04-05",
10	"data_previsao_fechamento": "2026-04-30",
11	"consultor_sdr_id": 52,
12	"consultor_closer_id": 52,
13	"observacao": "Proposta inicial enviada.",
14	"observacao_interna": "Negociação em andamento.",
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	}