For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
DocumentaçãoReferência da API
DocumentaçãoReferência da API
  • Integrações privadas
        • GETListar receitas
        • POSTCriar receita
        • PUTAtualizar receita
  • Entrada pública de leads
LogoLogo
Integrações privadasFinanceiroReceitas

Criar receita

||View as Markdown|
POST
/simplificav2/receita
POST
/ords/gestao/simplificav2/receita
$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}
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" } ```
Was this page helpful?
Previous

Listar receitas

Next

Atualizar receita

Built with

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:

1POST {{base_url}}/simplificav2/receita
2Authorization: Bearer {{bearer_token}}
3Content-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}

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.

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

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.