Criar categoria financeira | Simplifica Gestão

Cria uma nova categoria financeira. Regras: - informe `nome`, `tipo` e `ordem`; - `tipo` aceita `R` para receita ou `D` para despesa; - `categoria_pai_id` é opcional e deve apontar para uma categoria do mesmo tipo; - a categoria nasce ativa; - a ordenação precisa ser única dentro do mesmo nível hierárquico.

Cria uma nova categoria financeira.

Regras:

informe nome, tipo e ordem;
tipo aceita R para receita ou D para despesa;
categoria_pai_id é opcional e deve apontar para uma categoria do mesmo tipo;
a categoria nasce ativa;
a ordenação precisa ser única dentro do mesmo nível hierárquico.

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.

nomestringRequired<=100 characters

tipoenumRequired

Allowed values:

ordemintegerRequired>=1

categoria_pai_idinteger or nullOptional

Response

Categoria financeira 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 categoria financeira.

Regras:

informe nome, tipo e ordem;
tipo aceita R para receita ou D para despesa;
categoria_pai_id é opcional e deve apontar para uma categoria do mesmo tipo;
a categoria nasce ativa;
a ordenação precisa ser única dentro do mesmo nível hierárquico.

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.

This endpoint expects an object.

Categoria financeira criada com sucesso.

$	curl -X POST https://gestao.simplificagestao.com.br/ords/gestao/simplificav2/categoria_financeira \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"nome": "Receita de serviços",
>	"tipo": "R",
>	"ordem": 10
>	}'

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

$	curl -X POST https://gestao.simplificagestao.com.br/ords/gestao/simplificav2/categoria_financeira \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"nome": "Receita de serviços",
>	"tipo": "R",
>	"ordem": 10
>	}'

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