Criar despesa | Simplifica Gestão

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.

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.

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

$	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	}