Skip to main content
POST
Inserir Categoria
Campos obrigatórios ausentes ou inválidos retornam 400 com o detalhe em notifications/errors.

Authorizations

Authorization
string
header
required

Envie o token retornado por /v2/autenticar no header Authorization, no formato Bearer {token}.

Body

application/json

Categoria (Item de Lançamento), usada para classificar lançamentos financeiros como receita ou despesa. Usada tanto na inclusão (POST) quanto na alteração (PUT) e nas respostas de consulta.

codigoDaCategoria
string | null
required

Código da Categoria. Obrigatório.

Example:

"DESP-ALUGUEL"

descricaoDaCategoria
string | null
required

Nome/descrição da Categoria. Obrigatório.

Example:

"Aluguel"

codigoDoGrupoDeLancamento
integer<int16> | null
required

Código do Grupo de Categoria. Obrigatório.

Example:

4

descricaoDoHistorico
string | null

Histórico padrão sugerido ao usar esta Categoria em um lançamento.

codigoDaFilial
integer<int16> | null

Código da Filial. Quando informado, deve ser uma Filial válida.

codigoDaContaCorrente
integer<int16> | null

Código da Conta Corrente padrão para esta Categoria. Quando informado, deve ser uma Conta Corrente válida da Filial informada.

codigoDoGrupoContabil
string | null

Código do Grupo Contábil vinculado, quando aplicável.

codigoDoCentroDeCusto
string | null

Código do Centro de Custo padrão para esta Categoria, quando aplicável.

idItemDeLancamentoWS
string | null

Identificador externo da Categoria, usado por integrações.

idContaDebito
string | null

Id da Conta de Débito no Plano de Contas, usada na contabilização do lançamento.

idContaCredito
string | null

Id da Conta de Crédito no Plano de Contas, usada na contabilização do lançamento.

idContaDebitoBaixa
string | null

Id da Conta de Débito usada na baixa do lançamento.

codigoDaContaBaixaDebito
string | null
descricaoDaContaBaixaDebito
string | null
idContaCreditoBaixa
string | null

Id da Conta de Crédito usada na baixa do lançamento.

codigoDaContaBaixaCredito
string | null
descricaoDaContaBaixaCredito
string | null

Response

Categoria inserida com sucesso.

success
boolean
Example:

true

data
object

Categoria (Item de Lançamento), usada para classificar lançamentos financeiros como receita ou despesa. Usada tanto na inclusão (POST) quanto na alteração (PUT) e nas respostas de consulta.