> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.simplificagestao.com.br/llms.txt.
> For full documentation content, see https://docs.simplificagestao.com.br/llms-full.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.simplificagestao.com.br/_mcp/server.

# Comercial · oportunidades

# Comercial · oportunidades

Esta página concentra as operações privadas de escrita para oportunidades do Comercial.

Escopo atual:

* `POST /simplificav2/oportunidade`
* `PUT /simplificav2/oportunidade/{id}`
* `POST /simplificav2/oportunidade/{id}/ganho`
* `POST /simplificav2/oportunidade/{id}/perda`
* `POST /simplificav2/oportunidade/{id}/sdr`
* `POST /simplificav2/oportunidade/{id}/closer`
* `POST /simplificav2/oportunidade/{id}/reuniao`
* `POST /simplificav2/oportunidade/{id}/duplicar`
* `POST /simplificav2/oportunidade/{id}/venda`

## Autenticação

```http
Authorization: Bearer {{bearer_token}}
Content-Type: application/json
```

## Regras gerais

* todas as chamadas usam JSON;
* cada chamada opera em uma única oportunidade;
* `POST /oportunidade` exige dados básicos e ao menos um item;
* `PUT /oportunidade/{id}` faz atualização parcial;
* campos omitidos continuam com o valor atual;
* quando `itens` é enviado no `PUT`, a lista atual é substituída pela nova lista;
* é possível atualizar somente os itens;
* não existe rota de inativação por API para oportunidade.

## Criar oportunidade

**Rota**

* `POST /simplificav2/oportunidade`

Campos principais:

* `pessoa_id`
* `etapa_negociacao_id`
* `origem_id`
* `data_oportunidade`
* `data_previsao_fechamento`
* `consultor_sdr_id`
* `consultor_closer_id`
* `itens`

Campos opcionais:

* `endereco_entrega_id`
* `observacao`
* `observacao_interna`
* `vl_acrescimo`
* `vl_frete`

## Atualizar oportunidade

**Rota**

* `PUT /simplificav2/oportunidade/{id}`

Observações:

* atualiza somente os atributos enviados;
* exige oportunidade ativa e pendente;
* aceita atualizar dados básicos, totais adicionais e itens;
* se `itens` for enviado, os itens atuais são substituídos pela nova lista.

## Ações da oportunidade

**Rotas**

* `POST /simplificav2/oportunidade/{id}/ganho`
* `POST /simplificav2/oportunidade/{id}/perda`
* `POST /simplificav2/oportunidade/{id}/sdr`
* `POST /simplificav2/oportunidade/{id}/closer`
* `POST /simplificav2/oportunidade/{id}/reuniao`
* `POST /simplificav2/oportunidade/{id}/duplicar`
* `POST /simplificav2/oportunidade/{id}/venda`

Observações:

* `ganho` exige `data_encerramento`;
* `perda` exige `motivo_id` e `observacao`;
* `sdr` e `closer` trocam somente o responsável informado;
* `reuniao` vincula uma reunião já existente;
* `duplicar` cria uma nova oportunidade a partir da atual.
* `venda` gera uma venda em aberto a partir da oportunidade, reaproveitando os itens ativos da negociação.

## Resposta de sucesso

Todas as operações usam o mesmo retorno mínimo:

```json
{
  "status": "sucesso",
  "mensagem": "Solicitação executada com sucesso.",
  "data": {
    "id": 123
  }
}
```