Criar receita | Simplifica Gestão

Cria uma nova receita avulsa.

Regras:

informe conta bancária, categoria, tipo de pagamento, nome, valor, data de emissão e data de vencimento;
pessoa_id e centro_custo_id são opcionais;
receber_receita aceita S ou N;
quando receber_receita = "S", a API exige data_recebimento e permite informar desconto, acrescimo, multa, juros e taxa;
campos omitidos de recebimento assumem 0;
a data de emissão não pode ser maior que a data de vencimento;
quando houver recebimento imediato, a data de emissão não pode ser maior que a data de recebimento;
o valor da receita e o valor líquido do recebimento precisam ser maiores que zero.

Exemplo de uso:

1 POST {{base_url}}/simplificav2/receita
2 Authorization: Bearer {{bearer_token}}
3 Content-Type: application/json
4 
5 {
6   "conta_bancaria_id": 3,
7   "categoria_id": 41,
8   "tipo_pagamento_id": 9,
9   "pessoa_id": 164272,
10   "centro_custo_id": 12,
11   "nome": "Mensalidade de abril",
12   "descricao": "Receita avulsa registrada pela integração.",
13   "valor": 350,
14   "data_emissao": "2026-04-06",
15   "data_vencimento": "2026-04-10",
16   "receber_receita": "N"
17 }

Cria uma nova receita avulsa. Regras: - informe conta bancária, categoria, tipo de pagamento, nome, valor, data de emissão e data de vencimento; - `pessoa_id` e `centro_custo_id` são opcionais; - `receber_receita` aceita `S` ou `N`; - quando `receber_receita = "S"`, a API exige `data_recebimento` e permite informar `desconto`, `acrescimo`, `multa`, `juros` e `taxa`; - campos omitidos de recebimento assumem `0`; - a data de emissão não pode ser maior que a data de vencimento; - quando houver recebimento imediato, a data de emissão não pode ser maior que a data de recebimento; - o valor da receita e o valor líquido do recebimento precisam ser maiores que zero. Exemplo de uso: ```http POST {{base_url}}/simplificav2/receita Authorization: Bearer {{bearer_token}} Content-Type: application/json { "conta_bancaria_id": 3, "categoria_id": 41, "tipo_pagamento_id": 9, "pessoa_id": 164272, "centro_custo_id": 12, "nome": "Mensalidade de abril", "descricao": "Receita avulsa registrada pela integração.", "valor": 350, "data_emissao": "2026-04-06", "data_vencimento": "2026-04-10", "receber_receita": "N" } ```

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.

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.

Request

This endpoint expects an object.

conta_bancaria_idintegerRequired

categoria_idintegerRequired

tipo_pagamento_idintegerRequired

nomestringRequired<=200 characters

valordoubleRequired

data_emissaodateRequired

data_vencimentodateRequired

pessoa_idinteger or nullOptional

centro_custo_idinteger or nullOptional

descricaostring or nullOptional<=4000 characters

receber_receitaenumOptional

Allowed values:

data_recebimentodateOptional

descontodoubleOptional

acrescimodoubleOptional

multadoubleOptional

jurosdoubleOptional

taxadoubleOptional

Response

Receita criada com sucesso.

statusstring

mensagemstring

dataobject

Errors

400

Bad Request Error

401

Unauthorized Error

409

Conflict Error

422

Unprocessable Entity Error

500

Internal Server Error

Cria uma nova receita avulsa.

Regras:

informe conta bancária, categoria, tipo de pagamento, nome, valor, data de emissão e data de vencimento;
pessoa_id e centro_custo_id são opcionais;
receber_receita aceita S ou N;
quando receber_receita = "S", a API exige data_recebimento e permite informar desconto, acrescimo, multa, juros e taxa;
campos omitidos de recebimento assumem 0;
a data de emissão não pode ser maior que a data de vencimento;
quando houver recebimento imediato, a data de emissão não pode ser maior que a data de recebimento;
o valor da receita e o valor líquido do recebimento precisam ser maiores que zero.

Exemplo de uso:

1 POST {{base_url}}/simplificav2/receita
2 Authorization: Bearer {{bearer_token}}
3 Content-Type: application/json
4 
5 {
6   "conta_bancaria_id": 3,
7   "categoria_id": 41,
8   "tipo_pagamento_id": 9,
9   "pessoa_id": 164272,
10   "centro_custo_id": 12,
11   "nome": "Mensalidade de abril",
12   "descricao": "Receita avulsa registrada pela integração.",
13   "valor": 350,
14   "data_emissao": "2026-04-06",
15   "data_vencimento": "2026-04-10",
16   "receber_receita": "N"
17 }

$	curl -X POST https://gestao.simplificagestao.com.br/ords/gestao/simplificav2/receita \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"conta_bancaria_id": 1,
>	"categoria_id": 1,
>	"tipo_pagamento_id": 1,
>	"nome": "string",
>	"valor": 1.1,
>	"data_emissao": "2023-01-15",
>	"data_vencimento": "2023-01-15"
>	}'

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

1	POST {{base_url}}/simplificav2/receita
2	Authorization: Bearer {{bearer_token}}
3	Content-Type: application/json
4
5	{
6	"conta_bancaria_id": 3,
7	"categoria_id": 41,
8	"tipo_pagamento_id": 9,
9	"pessoa_id": 164272,
10	"centro_custo_id": 12,
11	"nome": "Mensalidade de abril",
12	"descricao": "Receita avulsa registrada pela integração.",
13	"valor": 350,
14	"data_emissao": "2026-04-06",
15	"data_vencimento": "2026-04-10",
16	"receber_receita": "N"
17	}