Integrações privadasComercialVendas

Atualizar venda

View as Markdown
Atualiza uma venda ativa e em aberto. 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; - pagamentos são atualizados pela rota específica de pagamentos; - não existe rota de inativação por API para venda. Exemplo de uso: ```http PUT {{base_url}}/simplificav2/venda/41521 Authorization: Bearer {{bearer_token}} Content-Type: application/json { "consultor_closer_id": 61, "observacao_interna": "Closer ajustado na 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 venda.

Request

This endpoint expects an object.
pessoa_idinteger or nullOptional
Novo identificador do lead ou cliente.
etapa_negociacao_idinteger or nullOptional
Nova etapa comercial.
origem_idinteger or nullOptional
Nova origem comercial.
data_vendastring or nullOptional

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

data_previsao_entregastring or nullOptional

Nova data prevista de entrega 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 da venda.

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 venda. Quando enviada, substitui os itens atuais.

Response

Venda 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