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 despesas
        • POSTCriar despesa
        • PUTAtualizar despesa
  • Entrada pública de leads
LogoLogo
Integrações privadasFinanceiroDespesas

Criar despesa

||View as Markdown|
POST
/simplificav2/despesa
POST
/ords/gestao/simplificav2/despesa
$curl -X POST https://gestao.simplificagestao.com.br/ords/gestao/simplificav2/despesa \
>     -H "Authorization: Bearer <token>" \
>     -H "Content-Type: application/json" \
>     -d '{
>  "conta_bancaria_id": 3,
>  "categoria_id": 41,
>  "tipo_pagamento_id": 9,
>  "nome": "Fornecedor abril",
>  "valor": 350,
>  "data_emissao": "2026-04-06",
>  "data_vencimento": "2026-04-10",
>  "pessoa_id": 164272,
>  "centro_custo_id": 12,
>  "descricao": "Despesa avulsa registrada pela integração.",
>  "pagar_despesa": "N"
>}'
1{
2  "status": "sucesso",
3  "mensagem": "Despesa criada com sucesso.",
4  "data": {
5    "id": 1204
6  }
7}
Cria uma nova despesa 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; - `pagar_despesa` aceita `S` ou `N`; - quando `pagar_despesa = "S"`, a API exige `data_pagamento` e permite informar `desconto`, `acrescimo`, `multa`, `juros` e `taxa`; - campos omitidos de pagamento assumem `0`; - a data de emissão não pode ser maior que a data de vencimento; - quando houver pagamento imediato, a data de emissão não pode ser maior que a data de pagamento; - o valor da despesa e o valor líquido do pagamento precisam ser maiores que zero.
Was this page helpful?
Previous

Listar despesas

Next

Atualizar despesa

Built with

Cria uma nova despesa 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;
  • pagar_despesa aceita S ou N;
  • quando pagar_despesa = "S", a API exige data_pagamento e permite informar desconto, acrescimo, multa, juros e taxa;
  • campos omitidos de pagamento assumem 0;
  • a data de emissão não pode ser maior que a data de vencimento;
  • quando houver pagamento imediato, a data de emissão não pode ser maior que a data de pagamento;
  • o valor da despesa e o valor líquido do pagamento precisam ser maiores que zero.

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
pagar_despesaenumOptional
Allowed values:
data_pagamentodateOptional
descontodoubleOptional
acrescimodoubleOptional
multadoubleOptional
jurosdoubleOptional
taxadoubleOptional

Response

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