Atualizar venda

PUT

/simplificav2/venda/:id

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

Atualizar venda

PUT

/simplificav2/venda/:id

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:

1 PUT {{base_url}}/simplificav2/venda/41521
2 Authorization: Bearer {{bearer_token}}
3 Content-Type: application/json
4 
5 {
6   "consultor_closer_id": 61,
7   "observacao_interna": "Closer ajustado na 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 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

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

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

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

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

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