Documentação da API

POST /list_group_categories

Resumo

Este endpoint permite listar todos os grupos de categorias ativos no sistema, filtrados por tipo de módulo.

---

Descrição

Utilize este endpoint para obter uma lista de grupos de categorias ativos, incluindo seus nomes, descrições e códigos, filtrados pelo tipo de módulo especificado. A requisição exige autenticação e associação com uma unidade específica.

---

Requisição

Body da Requisição

O corpo deve ser um objeto JSON com os seguintes parâmetros:

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
access_token	string	Sim	Token de autenticação do usuário.	aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee
unit_token	string	Sim	Token identificador da unidade.	aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee
type	string	Sim	Tipo de módulo para filtrar os grupos de categorias (ex.: in, out).	out
search	string	Não	Filtro por nome de categoria ou discrição.	Nome da categoria ou discrição

---

Exemplo de Requisição

Curl

curl -X POST 'https://portal.fipli.pro/api/v1/list_group_categories' \
-H 'Content-Type: application/json' \
-d '{
  "access_token": "<access_token>",
  "unit_token": "<unit_token>",
  "type": "<type>"
}'

---

Resposta

200 OK

Lista de grupos de categorias retornada com sucesso.

{
  "success": true,
  "data": [
    {
      "name": "Despesas Operacionais",
      "description": "Categorias relacionadas a despesas operacionais da empresa",
      "code": 1
    },
    {
      "name": "Receitas",
      "description": "Categorias relacionadas a entradas financeiras",
      "code": 2
    }
  ]
}

Erros Comuns

Status	Mensagem	Descrição
400	"Missing parameters"	Algum parâmetro obrigatório (access_token, unit_token, type) não foi enviado.
403	"Invalid data"	Token de autenticação inválido ou não autorizado.
500	"Something went wrong. Please try again later."	Erro interno no servidor.

---

Observações

• A lista retornada inclui apenas os grupos de categorias ativos que correspondem ao tipo de módulo especificado no parâmetro type, ordenados por nome.
• Cada item na resposta contém:
  • name: Nome do grupo de categorias.
  • description: Descrição ou observação sobre o grupo.
  • code: ID numérico inteiro do grupo — não é um token UUID. É esse valor que deve ser enviado no campo category_master (ou id_token_category_master) ao inserir ou atualizar uma categoria via /insert_category ou /update_category.