Atualizar oportunidade

PUT

/simplificav2/oportunidade/:id

Atualiza uma oportunidade ativa e pendente. Regras: - a operação atualiza somente os campos enviados; - campos omitidos continuam com o valor atual; - se `itens` for enviado, a lista atual de itens é substituída pela nova lista; - é possível atualizar somente os itens, sem alterar os demais dados; - esta rota não inativa a oportunidade. Exemplo de uso: ```http PUT {{base_url}}/simplificav2/oportunidade/29627 Authorization: Bearer {{bearer_token}} Content-Type: application/json { "consultor_closer_id": 61, "observacao_interna": "Closer atualizado pela integração.", "itens": [ { "produto_servico_id": 981, "quantidade": 2, "valor_unitario": 1500, "valor_desconto": 150 } ] } ```

Atualizar oportunidade

PUT

/simplificav2/oportunidade/:id

Atualiza uma oportunidade ativa e pendente.

Regras:

a operação atualiza somente os campos enviados;
campos omitidos continuam com o valor atual;
se itens for enviado, a lista atual de itens é substituída pela nova lista;
é possível atualizar somente os itens, sem alterar os demais dados;
esta rota não inativa a oportunidade.

Exemplo de uso:

1 PUT {{base_url}}/simplificav2/oportunidade/29627
2 Authorization: Bearer {{bearer_token}}
3 Content-Type: application/json
4 
5 {
6   "consultor_closer_id": 61,
7   "observacao_interna": "Closer atualizado pela integração.",
8   "itens": [
9     {
10       "produto_servico_id": 981,
11       "quantidade": 2,
12       "valor_unitario": 1500,
13       "valor_desconto": 150
14     }
15   ]
16 }

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.

Path parameters

idintegerRequired

Identificador da oportunidade.

Request

This endpoint expects an object.

pessoa_idinteger or nullOptional

Novo identificador do lead ou cliente.

etapa_negociacao_idinteger or nullOptional

Nova etapa de negociação.

origem_idinteger or nullOptional

Nova origem comercial.

data_oportunidadestring or nullOptional

Nova data da oportunidade no formato YYYY-MM-DD.

data_previsao_fechamentostring or nullOptional

Nova data prevista de fechamento no formato YYYY-MM-DD.

consultor_sdr_idinteger or nullOptional

Novo SDR responsável.

consultor_closer_idinteger or nullOptional

Novo closer responsável.

endereco_entrega_idinteger or nullOptional

Novo endereço de entrega.

observacaostring or nullOptional

Nova observação visível no documento comercial.

observacao_internastring or nullOptional

Nova observação interna.

vl_acrescimodouble or nullOptional

Novo valor adicional.

vl_fretedouble or nullOptional

Novo valor de frete.

itenslist of objects or nullOptional

Nova lista completa de itens da oportunidade. Quando enviada, substitui os itens atuais.

Response

Oportunidade atualizada com sucesso.

statusstring

mensagemstring

dataobject

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

409

Conflict Error

422

Unprocessable Entity Error

500

Internal Server Error

$	curl -X PUT https://gestao.simplificagestao.com.br/ords/gestao/simplificav2/oportunidade/1 \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{}'

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

$	curl -X PUT https://gestao.simplificagestao.com.br/ords/gestao/simplificav2/oportunidade/1 \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{}'

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

1	PUT {{base_url}}/simplificav2/oportunidade/29627
2	Authorization: Bearer {{bearer_token}}
3	Content-Type: application/json
4
5	{
6	"consultor_closer_id": 61,
7	"observacao_interna": "Closer atualizado pela integração.",
8	"itens": [
9	{
10	"produto_servico_id": 981,
11	"quantidade": 2,
12	"valor_unitario": 1500,
13	"valor_desconto": 150
14	}
15	]
16	}