OmieapiDocumentaçãoOperações
← Referência das operações

IncluirCategoriaaltera dados

Inclusão de categoria

Identificação

Operaçãogeral/categorias:IncluirCategoria
ServiçoCategoriasCadastro
MóduloGeral
Endpoint/api/v1/geral/categorias/

Como as pessoas pedem isso

incluir categoria

Parâmetros

CampoTipoDescrição
categoria_superiorstringCódigo do grupo da categoria Para inclusão essa informação pode ser obtida pela API: /api/v1/geral/categorias/ Utilizando o método ListarCategorias, o código é retornado na tag "codigo" Para que esse código seja válido, é necessário que: - "codigo" tenha 4 dígitos - "totalizadora" deve ser igual a "S"
codigo_drestringCódigo no DRE (Demonstrativo de Resultados do Exercício) Essa informação pode ser obtida pela API: /api/v1/geral/dre/ Utilizando o método ListarCadastroDRE, o código é retornado na tag "codigoDRE" Para que esse código seja válido, é necessário que: - "nivelDRE" seja igual a 3 - "naoExibirDRE" seja igual a "N" - "totalizaDRE" seja igual a "N"
descricao obrigatóriostringDescrição para a Categoria Informação obrigatória para os métodos IncluirCategoria e IncluirGrupoCategoria.
naturezastringDescrição da Natureza da conta, equivalente ao campo "Observação" da categoria no ERP
tipo_categoriastringTipo de gasto/receita realizado com esta categoria Essa informação pode ser obtida pela API: /api/v1/geral/tipocategoria/ Utilizando o método ListarTipoCategoria, o código é retornado na tag "cCodigo" Para que esse código seja válido, é necessário que: Inclusão: - "categoria_superior" começar com "1", então "cTipo" deve ser igual a "R" - "categoria_superior" começar com "2", então "cTipo" deve ser igual a "P" Alteração: - "codigo" começar com "1", então "cTipo" deve ser igual a "R" - "codigo" começar com "2", então "cTipo" deve ser igual a "P"

Exemplo de chamada

{
  "categoria_superior": "",
  "descricao": "",
  "natureza": "",
  "tipo_categoria": "",
  "codigo_dre": ""
}
Esta operação altera dados de verdade, na hora. Não existe ambiente de ensaio neste endereço.
api.omie.com.br/mcp · Documentação · Operações