Atualizar pagamentos da venda

PUT

/simplificav2/venda/:id/pagamentos

Atualiza os pagamentos de uma venda ativa e em aberto. Regras: - envie `pagamentos` para substituir a lista atual inteira; - use essa mesma rota para incluir, editar, remover ou refazer pagamentos antes da finalização; - você também pode ajustar `vl_acrescimo` e `vl_frete` na mesma chamada; - o total dos pagamentos não pode ser maior que o total da venda; - não é permitido substituir pagamentos quando já existirem receitas ativas vinculadas. Exemplo de uso: ```http PUT {{base_url}}/simplificav2/venda/41521/pagamentos Authorization: Bearer {{bearer_token}} Content-Type: application/json { "vl_frete": 50, "pagamentos": [ { "forma_pagamento_id": 3, "numero_parcela": 1, "valor_parcela": 725, "data_vencimento": "2026-04-06" }, { "forma_pagamento_id": 5, "numero_parcela": 2, "valor_parcela": 725, "data_vencimento": "2026-05-06", "bandeira_cartao": "VISA" } ] } ```

Atualizar pagamentos da venda

PUT

/simplificav2/venda/:id/pagamentos

Atualiza os pagamentos de uma venda ativa e em aberto.

Regras:

envie pagamentos para substituir a lista atual inteira;
use essa mesma rota para incluir, editar, remover ou refazer pagamentos antes da finalização;
você também pode ajustar vl_acrescimo e vl_frete na mesma chamada;
o total dos pagamentos não pode ser maior que o total da venda;
não é permitido substituir pagamentos quando já existirem receitas ativas vinculadas.

Exemplo de uso:

1 PUT {{base_url}}/simplificav2/venda/41521/pagamentos
2 Authorization: Bearer {{bearer_token}}
3 Content-Type: application/json
4 
5 {
6   "vl_frete": 50,
7   "pagamentos": [
8     {
9       "forma_pagamento_id": 3,
10       "numero_parcela": 1,
11       "valor_parcela": 725,
12       "data_vencimento": "2026-04-06"
13     },
14     {
15       "forma_pagamento_id": 5,
16       "numero_parcela": 2,
17       "valor_parcela": 725,
18       "data_vencimento": "2026-05-06",
19       "bandeira_cartao": "VISA"
20     }
21   ]
22 }

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.

vl_acrescimodouble or nullOptional

Novo valor adicional da venda.

vl_fretedouble or nullOptional

Novo valor de frete da venda.

pagamentoslist of objects or nullOptional

Nova lista completa de pagamentos da venda.

Response

Pagamentos da venda atualizados 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/pagamentos \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{}'

1	{
2	"status": "sucesso",
3	"mensagem": "Pagamentos da venda atualizados com sucesso.",
4	"data": {
5	"id": 41521
6	}
7	}

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

1	{
2	"status": "sucesso",
3	"mensagem": "Pagamentos da venda atualizados com sucesso.",
4	"data": {
5	"id": 41521
6	}
7	}

1	PUT {{base_url}}/simplificav2/venda/41521/pagamentos
2	Authorization: Bearer {{bearer_token}}
3	Content-Type: application/json
4
5	{
6	"vl_frete": 50,
7	"pagamentos": [
8	{
9	"forma_pagamento_id": 3,
10	"numero_parcela": 1,
11	"valor_parcela": 725,
12	"data_vencimento": "2026-04-06"
13	},
14	{
15	"forma_pagamento_id": 5,
16	"numero_parcela": 2,
17	"valor_parcela": 725,
18	"data_vencimento": "2026-05-06",
19	"bandeira_cartao": "VISA"
20	}
21	]
22	}