Skip to content

Gerencial Api (v1.0.0)

API Gerencial

A API Gerencial foi desenvolvida para oferecer um controle abrangente e eficiente sobre diversos dados mestres e configurações essenciais para as operações e funções administrativas do sistema. Com ela, é possível gerenciar entidades como cargos, CNAEs, grupos empresariais, integrações, perfis de usuário, políticas fiscais, ramos de atividade, setores, tipos de empresas, pessoas jurídicas e regimes tributários. Esta API visa simplificar a administração de entidades de negócio centrais, garantindo a consistência e acessibilidade dos dados.

Simplificando a gestão de dados mestres e configurações com o poder e a flexibilidade de uma API de alta performance!

A seguir, detalhamos as principais funcionalidades oferecidas por cada um dos endpoints.

Overview
Languages
Servers
Mock server
https://apidocs.ger26.com.br/_mock/api_gerenciais_extend/
http://rgbsys.dyndns.info/ger2025-gerencial-api-desenvolvimento/

Cargos

Este conjunto de recursos permite a manipulação e consulta de dados de cargos no sistema:

  • Cadastrar Cargo:
    • Cria um novo cargo no sistema.
  • Alterar Cargo:
    • Atualiza os dados de um cargo existente pelo seu identificador.
  • Listar Cargos:
    • Recupera todos os cargos com opções de filtragem por nome e paginação.
  • Consultar Cargo por ID:
    • Busca um cargo específico pelo seu identificador único.
  • Listar Cargos Ativos:
    • Recupera somente os cargos que estão ativos no sistema.
Operations

Feriados

Este conjunto de recursos permite a administração de feriados:

  • Cadastrar Feriado:
    • Cria um novo feriado na base de dados.
  • Alterar Feriado:
    • Atualiza os dados de um feriado existente pelo seu identificador.
  • Listar Feriados:
    • Lista todos os feriados com opções de filtragem por data, nome, UF, município e paginação.
  • Consultar Feriado por ID:
    • Recupera um feriado específico pelo seu identificador.
  • Listar Feriados Ativos:
    • Lista apenas os feriados ativos com base em uma data de referência e período específico.
Operations

Grupos Empresariais

Este conjunto de recursos permite a administração de grupos empresariais:

  • Cadastrar Grupo Empresarial:
    • Cria um novo grupo empresarial.
  • Alterar Grupo Empresarial:
    • Atualiza os dados de um grupo empresarial existente.
  • Listar Grupos Empresariais:
    • Lista todos os grupos empresariais com opções de filtragem por nome, cedente/sacado e paginação.
  • Consultar Grupo Empresarial por ID:
    • Recupera um grupo empresarial específico pelo seu identificador.
  • Listar Grupos Empresariais Ativos:
    • Lista apenas os grupos empresariais ativos.
  • Associar Cedente/Sacado:
    • Associa um cedente ou sacado a um grupo empresarial pela raiz do CNPJ.
Operations

Perfis

Este conjunto de recursos permite a administração de perfis de usuário:

  • Cadastrar Perfil:
    • Cria um novo perfil no sistema.
  • Alterar Perfil:
    • Atualiza as informações de um perfil existente.
  • Listar Perfis:
    • Obtém todos os perfis com opções de filtragem por nome, nível, tipo de pessoa física e paginação.
  • Consultar Perfil por ID:
    • Busca um perfil específico pelo seu identificador único.
  • Listar Perfis Ativos:
    • Lista somente os perfis que estão ativos no sistema.
  • Excluir Perfil:
    • Remove um perfil do sistema.
Operations

Politicas Checagens

Este conjunto de recursos permite a administração de políticas de checagens:

  • Cadastrar Política de Checagem:
    • Cria uma nova política de checagem no tenant.
  • Alterar Política de Checagem:
    • Atualiza os dados de uma política de checagem existente pelo seu identificador.
  • Listar Políticas de Checagens:
    • Lista todas as políticas de checagens com opções de filtragem por nome, empresas, grupos empresariais, cedentes, sacados, tipos de operação/ativo e paginação.
  • Consultar Política de Checagem por ID:
    • Recupera uma política de checagem específica pelo seu identificador.
  • Listar Políticas de Checagens Ativas:
    • Lista apenas as políticas de checagens ativas do tenant.
  • Listar por Empresa:
    • Lista políticas de checagens associadas a uma empresa específica.
  • Listar por Cedente:
    • Lista políticas de checagens associadas a um cedente específico.
  • Listar por Sacado:
    • Lista políticas de checagens associadas a um sacado específico.
  • Listar por Grupo Empresarial:
    • Lista políticas de checagens associadas a um grupo empresarial específico.
  • Consultar Associações:
    • Recupera os primeiros 10 nomes das empresas, grupos empresariais, cedentes e sacados associados a uma política de checagem.
  • Excluir Política de Checagem:
    • Remove uma política de checagem do sistema.
Operations

Politicas Comissoes Agentes

Este conjunto de recursos permite a administração de políticas de comissões de agentes:

  • Cadastrar Política de Comissão de Agente:
    • Cria uma nova política de comissão com configurações de cálculo, fórmulas personalizadas ou faixas de taxa, e vincula aos agentes especificados.
  • Alterar Política de Comissão de Agente:
    • Atualiza os dados de uma política de comissão existente, incluindo nome, tipo de cálculo, fórmula e agentes vinculados.
  • Consultar Política de Comissão por ID:
    • Recupera os dados detalhados de uma política de comissão específica, incluindo configurações de cálculo e agentes vinculados.
  • Listar Políticas de Comissões de Agentes:
    • Lista todas as políticas de comissão com filtros opcionais por nome, agente, status e paginação.
  • Listar Políticas de Comissões Ativas:
    • Lista apenas as políticas de comissão que estão ativas no tenant, com opção de filtro por nome e paginação.
Operations

Politicas

Este conjunto de recursos permite o gerenciamento de associações de políticas:

  • Associar Política:
    • Associa uma política de limite, taxa, tarifa ou checagem à empresa, grupo empresarial, cedente ou sacado de um tenant.
  • Desassociar Políticas:
    • Remove todas as associações de políticas de limite, taxa e checagem de uma empresa, grupo empresarial, cedente ou sacado específico.
Operations

Associar uma política de limite, taxa, tarifa ou checagem à empresa, grupo empresarial, cedente ou sacado de um tenant

Request

Associa uma política de limite, taxa, tarifa ou checagem à empresa, grupo empresarial, cedente ou sacado de um tenant

Path
idstringrequired

Id da limite

Bodyrequired
idstring or null

Id da política

associacaoIdsArray of strings or null

Ids dos itens a serem associados a política

tipoPoliticainteger(TipoPoliticaEnum)

Tipo de política

tipoAssociacaointeger(TipoPoliticaAssociacaoEnum)

Tipo de associação

curl -i -X PATCH \
  'https://apidocs.ger26.com.br/_mock/api_gerenciais_extend/api/v1/gerencial/politicas/limites/{id}/associar' \
  -H 'Content-Type: application/json' \
  -d '{
    "id": "string",
    "associacaoIds": [
      "string"
    ],
    "tipoPolitica": 0,
    "tipoAssociacao": 0
  }'

Responses

OK

Bodyapplication/json
Response
application/json
null

Associar uma política de limite, taxa, tarifa ou checagem à empresa, grupo empresarial, cedente ou sacado de um tenant

Request

Associa uma política de limite, taxa, tarifa ou checagem à empresa, grupo empresarial, cedente ou sacado de um tenant

Path
idstringrequired

Id da limite

Bodyrequired
idstring or null

Id da política

associacaoIdsArray of strings or null

Ids dos itens a serem associados a política

tipoPoliticainteger(TipoPoliticaEnum)

Tipo de política

tipoAssociacaointeger(TipoPoliticaAssociacaoEnum)

Tipo de associação

curl -i -X PATCH \
  'https://apidocs.ger26.com.br/_mock/api_gerenciais_extend/api/v1/gerencial/politicas/taxas/{id}/associar' \
  -H 'Content-Type: application/json' \
  -d '{
    "id": "string",
    "associacaoIds": [
      "string"
    ],
    "tipoPolitica": 0,
    "tipoAssociacao": 0
  }'

Responses

OK

Bodyapplication/json
Response
application/json
null

Associar uma política de limite, taxa, tarifa ou checagem à empresa, grupo empresarial, cedente ou sacado de um tenant

Request

Associa uma política de limite, taxa, tarifa ou checagem à empresa, grupo empresarial, cedente ou sacado de um tenant

Path
idstringrequired

Id da limite

Bodyrequired
idstring or null

Id da política

associacaoIdsArray of strings or null

Ids dos itens a serem associados a política

tipoPoliticainteger(TipoPoliticaEnum)

Tipo de política

tipoAssociacaointeger(TipoPoliticaAssociacaoEnum)

Tipo de associação

curl -i -X PATCH \
  'https://apidocs.ger26.com.br/_mock/api_gerenciais_extend/api/v1/gerencial/politicas/tarifas/{id}/associar' \
  -H 'Content-Type: application/json' \
  -d '{
    "id": "string",
    "associacaoIds": [
      "string"
    ],
    "tipoPolitica": 0,
    "tipoAssociacao": 0
  }'

Responses

OK

Bodyapplication/json
Response
application/json
null

Associar uma política de limite, taxa, tarifa ou checagem à empresa, grupo empresarial, cedente ou sacado de um tenant

Request

Associa uma política de limite, taxa, tarifa ou checagem à empresa, grupo empresarial, cedente ou sacado de um tenant

Path
idstringrequired

Id da limite

Bodyrequired
idstring or null

Id da política

associacaoIdsArray of strings or null

Ids dos itens a serem associados a política

tipoPoliticainteger(TipoPoliticaEnum)

Tipo de política

tipoAssociacaointeger(TipoPoliticaAssociacaoEnum)

Tipo de associação

curl -i -X PATCH \
  'https://apidocs.ger26.com.br/_mock/api_gerenciais_extend/api/v1/gerencial/politicas/checagens/{id}/associar' \
  -H 'Content-Type: application/json' \
  -d '{
    "id": "string",
    "associacaoIds": [
      "string"
    ],
    "tipoPolitica": 0,
    "tipoAssociacao": 0
  }'

Responses

OK

Bodyapplication/json
Response
application/json
null

Desassociar política de limite, taxa e checagem à empresa, grupo empresarial, cedente ou sacado de um tenant

Request

Desassociar política de limite, taxa e checagem à empresa, grupo empresarial, cedente ou sacado de um tenant

Bodyrequired
associacaoIdsArray of strings or nullrequired

Ids dos itens a serem associados a política

tipoAssociacaointeger(TipoPoliticaAssociacaoEnum)required

Tipo de associação

curl -i -X PATCH \
  https://apidocs.ger26.com.br/_mock/api_gerenciais_extend/api/v1/gerencial/politicas/desassociar \
  -H 'Content-Type: application/json' \
  -d '{
    "associacaoIds": [
      "string"
    ],
    "tipoAssociacao": 0
  }'

Responses

OK

Bodyapplication/json
Response
application/json
null

Politicas Limites

Este conjunto de recursos permite a administração de políticas de limites:

  • Cadastrar Política de Limite:
    • Cria uma nova política de limite no tenant.
  • Alterar Política de Limite:
    • Atualiza os dados de uma política de limite existente pelo seu identificador.
  • Listar Políticas de Limites:
    • Lista todas as políticas de limites com opções de filtragem por nome, empresas, grupos empresariais, cedentes, sacados, tipos de operação/ativo e paginação.
  • Consultar Política de Limite por ID:
    • Recupera uma política de limite específica pelo seu identificador.
  • Listar Políticas de Limites Ativas:
    • Lista apenas as políticas de limites ativas do tenant.
  • Listar por Empresa:
    • Lista políticas de limites associadas a uma empresa específica.
  • Listar por Cedente:
    • Lista políticas de limites associadas a um cedente específico.
  • Listar por Sacado:
    • Lista políticas de limites associadas a um sacado específico.
  • Listar por Grupo Empresarial:
    • Lista políticas de limites associadas a um grupo empresarial específico.
  • Consultar Associações:
    • Recupera os primeiros 10 nomes das empresas, grupos empresariais, cedentes e sacados associados a uma política de limite.
  • Excluir Política de Limite:
    • Remove uma política de limite do sistema.
Operations

Politicas Taxas

Este conjunto de recursos permite a administração de políticas de taxas:

  • Cadastrar Política de Taxa:
    • Cria uma nova política de taxa no tenant.
  • Alterar Política de Taxa:
    • Atualiza os dados de uma política de taxa existente pelo seu identificador.
  • Excluir Política de Taxa:
    • Remove uma política de taxa do sistema.
  • Listar Políticas de Taxas:
    • Lista todas as políticas de taxas com opções de filtragem por nome, empresas, grupos empresariais, cedentes, sacados, tipos de operação/ativo e paginação.
  • Consultar Política de Taxa por ID:
    • Recupera uma política de taxa específica pelo seu identificador.
  • Listar Políticas de Taxas Ativas:
    • Lista apenas as políticas de taxas ativas do tenant.
  • Listar por Empresa:
    • Lista políticas de taxas associadas a uma empresa específica.
  • Listar por Cedente:
    • Lista políticas de taxas associadas a um cedente específico.
  • Listar por Sacado:
    • Lista políticas de taxas associadas a um sacado específico.
  • Listar por Grupo Empresarial:
    • Lista políticas de taxas associadas a um grupo empresarial específico.
  • Consultar Associações:
    • Recupera os primeiros 10 nomes das empresas, grupos empresariais, cedentes e sacados associados a uma política de taxa.
Operations

Ramos

Este conjunto de recursos permite a administração de ramos de atividade:

  • Cadastrar Ramo:
    • Cria um novo ramo em um tenant.
  • Alterar Ramo:
    • Atualiza os dados de um ramo existente em um tenant.
  • Listar Ramos:
    • Obtém todos os ramos de um tenant com opções de filtragem por nome e paginação.
  • Consultar Ramo por ID:
    • Busca um ramo específico de um tenant pelo seu identificador único.
  • Listar Ramos Ativos:
    • Lista somente os ramos ativos de um tenant, ideais para utilização em listas de seleção.
Operations

Setores

Estes recursos são dedicados ao gerenciamento de setores:

  • Cadastrar Setor:
    • Cria um novo setor no sistema.
  • Alterar Setor:
    • Atualiza os dados de um setor existente.
  • Excluir Setor:
    • Remove um setor do sistema.
  • Listar Setores:
    • Obtém todos os setores com opções de filtragem por nome, descrição e paginação.
  • Consultar Setor por ID:
    • Busca um setor específico pelo seu identificador único.
  • Listar Setores Ativos:
    • Lista somente os setores ativos, ideais para utilização em listas de seleção.
Operations

Empresas

Operations

Sacados

Operations