Integrações privadasComercialOportunidades

Atualizar oportunidade

View as Markdown
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 } ] } ```

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