Criar oportunidade | Simplifica Gestão

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 }

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 } ] } ```

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

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 }

$	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	}