Uso de parâmetros com gestão de empresas

Objetivo

Permitir que o cadastramento de parâmetros do sistema (dicionário SX6) possa ser efetuado considerando a máscara da gestão de empresas.

Definição da Regra de Negócio

O dicionário de parâmetros permite o cadastramento de parâmetros usando o campo filial em branco (situação padrão) e filial preenchida (caso específico).

O preenchimento da filial permite que um mesmo parâmetro possa ser cadastrado em filiais diferentes com conteúdos diferentes. O sistema sempre efetua primeiro a busca pela filial corrente para depois pesquisar o parâmetro buscando a filial em branco.

Com o advento do recurso de gestão de empresas, no entanto, ficou mais trabalhoso operar com parâmetros por filial. Isso porque, assim como em outras tabelas, o campo filial do cadastro de parâmetros aumentou de tamanho e pode armazenar um código concatenado contendo código da empresa + código da unidade de negócio + código da filial (a situação real pode variar em função da máscara utilizada na gestão de empresas).

Caso o usuário desejasse atribuir um parâmetro específico para uma empresa que possuísse 2 unidades de negócios e 10 filiais, o parâmetro deveria ser cadastrado 10 vezes, e o código completo da filial (composição de empresa + unidade + filial) deveria ser registrado em cada um deles.

Através do recurso de cadastramento de parâmetros para gestão de empresas, é possível informar um parâmetro considerando a máscara do campo filial, preenchendo apenas os níveis que se deseja especificar e mantendo o restante da máscara em branco.

Fluxo do Processo

Casos de Uso

Exemplo: no grupo de empresas hipotético X a máscara da gestão de empresas está definida da seguinte forma: 2 dígitos para o código da empresa, 2 dígitos para o código da unidade de negócio e 3 dígitos para o código da filial.

O Protheus define internamente a máscara da gestão de empresas como EEUUFFF. Todos os campos filial do sistema devem ser gravados respeitando essa formatação.

O grupo de empresas X possui 2 empresas.

A empresa 01 está localizada em São Paulo e possui 2 unidades de negócio e um total de 10 filiais.

A empresa 02 está localizada no Rio de Janeiro e possui 3 unidades de negócio e um total de 8 filiais.

O grupo X precisa informar o parâmetro MV_ESTADO (sigla da unidade federativa) adequadamente para que suas empresas calculem corretamente os impostos. No modelo tradicional, seria necessário cadastrar 10 vezes o parâmetro MV_ESTADO com conteúdo “SP” e informar o código completo de cada filial da empresa 01, e cadastrar 8 vezes o parâmetro MV_ESTADO com conteúdo “RJ” e informar o código completo de cada filial da empresa 02.

No novo modelo, é possível preencher parcialmente o campo filial dos parâmetros, informando apenas o código da empresa e mantendo o restante da informação em branco.

No caso hipotético, seria necessário cadastrar apenas duas vezes o parâmetro MV_ESTADO, como segue:

No exemplo acima, o campo filial é preenchido com o código da empresa ( 01 ou 02 ) alinhado à esquerda, e o restante dos caracteres em branco.

Seria possível também definir outras situações, como um parâmetro para uma filial específica ( Campinas ou Resende ), ou por unidade de negócio. No caso de parâmetro por unidade de negócio, seriam preenchidos os 4 primeiros dígitos do campo filial (2 para a filial mais 2 para a unidade de negócio).

A pesquisa por um parâmetro possui uma prioridade de busca. A definição abaixo é para um layout configurado com empresas, unidades de negócio e filiais.

• Primeiro consulta a Filial completa ( empresa + unidade + filial ) preenchidos
• Em seguida consulta a empresa + unidade preenchidas e filial em branco
• Em seguida consulta a empresa preenchida e restante do campo em branco
• Finalmente pesquisa todo o campo filial em branco

Ou seja, sempre a informação de exceção tem prioridade sobre a informação genérica. Se o parâmetro desejado for encontrado em qualquer um dos níveis da pesquisa, a pesquisa cessa e o registro encontrado será o considerado pelo sistema.

Observação: o novo recurso estará presente nas funções de manipulação de parâmetros oficiais do Framework Protheus, a saber:

• GETMV()
• SuperGetMV()
• GetNewPar()
• PutMV()

O recurso não funcionará em funções não oficiais ou que façam consultas diretas ao dicionário SX6.

Atenção: para uso deste recurso na versão 11 pode ser necessária a atualização do binário e pacote de LIB.