Agora no Bluesoft ERP, é possível cadastrar uma Matriz de Rateio de Centro de Resultado completa através da API, além de consultar os Centros de Resultado Contábeis, a composição gerencial e os processos contábeis vinculados à matriz. O objetivo desta melhoria é ampliar as possibilidades de integração, permitindo que aplicações integradas realizem o cadastro e obtenham a composição completa da matriz sem depender da operação manual pela tela do ERP.

Como Era o Processo Antes?

A API já permitia consultar as Matrizes de Rateio, porém disponibilizava principalmente os dados gerais da matriz. Para realizar um novo cadastro completo, era necessário utilizar a rotina Contábil > Cadastros > Matriz de Rateio de Centro de Resultado.

Com a melhoria, o cadastro completo também poderá ser realizado pela integração, enquanto o fluxo existente pela tela continuará disponível sem alteração.

Como Irá Funcionar a Partir de Agora?

Para realizar o cadastro de uma nova Matriz de Rateio pela integração, será disponibilizado o caminho:

POST /contabil/matriz-de-rateio

O cadastro utilizará a permissão 4736 – API Matriz de Rateio Centro de Resultado (Incluir). A integração poderá informar o código, a descrição, o tipo da matriz e os Centros de Resultado Contábeis com seus respectivos percentuais. Quando aplicável ao tipo escolhido, também poderão ser informados os Centros de Resultado Gerenciais, as lojas e os processos contábeis.

Exemplo de cadastro de uma Matriz de Rateio do tipo Produto:

{
  "codigo": 9003,
  "descricao": "Matriz Produto",
  "tipoMatriz": "PRODUTO",
  "centroCustos": [
    {
      "centroCustoKey": 1,
      "porcentagem": 100.00
    }
  ],
  "centroCustosGerencial": [
    {
      "lojaKey": 1,
      "centroCustoKey": 102,
      "porcentagem": 100.00
    }
  ],
  "processosContabeis": [
    1
  ]
}

Após a inclusão concluída com sucesso, a matriz será criada ativa e a API retornará sua identificação.

Exemplo de retorno:

{
  "matrizRateioKey": 12345
}

As regras da composição serão respeitadas conforme o tipo da matriz. Para Produto, deverão ser informados a composição gerencial e os processos contábeis aplicáveis. Para Funcionário e Acordos Financeiros, a composição gerencial não deverá ser enviada. Os Centros de Resultado utilizados deverão existir e estar ativos, e as composições deverão atender às regras de percentual e de não repetição previstas para a matriz.

Para consultar as Matrizes de Rateio, continuará disponível o caminho:

GET /contabil/matriz-de-rateio

A consulta mantém a permissão 4102, os filtros por status e tipo e a paginação. A partir desta melhoria, cada resultado poderá apresentar também os Centros de Resultado Contábeis, a composição gerencial e os processos contábeis relacionados. As matrizes serão apresentadas em ordem de código e, quando não houver composição gerencial ou processos vinculados, os respectivos conjuntos serão apresentados vazios.

Dessa forma, as integrações passam a contar com o ciclo de cadastro e consulta da Matriz de Rateio, enquanto o cadastro realizado pela rotina Contábil > Cadastros > Matriz de Rateio de Centro de Resultado permanece disponível com o comportamento atual.

Observações:

A melhoria não disponibiliza pela API operações de alteração, ativação, inativação ou exclusão das matrizes. O cadastro realizado pela API cria a matriz ativa e global para a base.

Para conhecer mais sobre como é a utilização dessa ferramenta, clique aqui

Para saber mais sobre a utilização das APIs do ERP, clique aqui.

Disponível a partir da versão r374.03