Atualizar receita

PUT

/simplificav2/receita/:id

Atualiza uma receita existente. Regras: - a operação atualiza somente os campos enviados; - campos omitidos continuam com o valor atual; - receitas pagas não permitem alterar conta bancária, tipo de pagamento ou valores do recebimento; - a data de emissão não pode ser maior que a data de vencimento; - quando a receita ainda estiver em aberto, o valor líquido continua precisando ser maior que zero. Exemplo de uso: ```http PUT {{base_url}}/simplificav2/receita/1204 Authorization: Bearer {{bearer_token}} Content-Type: application/json { "descricao": "Receita ajustada pela integração.", "data_vencimento": "2026-04-12", "centro_custo_id": 18 } ```

Atualizar receita

PUT

/simplificav2/receita/:id

Atualiza uma receita existente.

Regras:

a operação atualiza somente os campos enviados;
campos omitidos continuam com o valor atual;
receitas pagas não permitem alterar conta bancária, tipo de pagamento ou valores do recebimento;
a data de emissão não pode ser maior que a data de vencimento;
quando a receita ainda estiver em aberto, o valor líquido continua precisando ser maior que zero.

Exemplo de uso:

1 PUT {{base_url}}/simplificav2/receita/1204
2 Authorization: Bearer {{bearer_token}}
3 Content-Type: application/json
4 
5 {
6   "descricao": "Receita ajustada pela integração.",
7   "data_vencimento": "2026-04-12",
8   "centro_custo_id": 18
9 }

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 receita.

Request

This endpoint expects an object.

conta_bancaria_idinteger or nullOptional

categoria_idinteger or nullOptional

tipo_pagamento_idinteger or nullOptional

pessoa_idinteger or nullOptional

centro_custo_idinteger or nullOptional

nomestring or nullOptional<=200 characters

descricaostring or nullOptional<=4000 characters

valordouble or nullOptional

data_emissaodate or nullOptional

data_vencimentodate or nullOptional

descontodouble or nullOptional

acrescimodouble or nullOptional

multadouble or nullOptional

jurosdouble or nullOptional

taxadouble or nullOptional

Response

Receita 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/receita/1 \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{}'

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

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

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

1	PUT {{base_url}}/simplificav2/receita/1204
2	Authorization: Bearer {{bearer_token}}
3	Content-Type: application/json
4
5	{
6	"descricao": "Receita ajustada pela integração.",
7	"data_vencimento": "2026-04-12",
8	"centro_custo_id": 18
9	}