9 - Parâmetro de Nível de compartilhamento de filiais do Protheus

EXPLICAÇÃO CONCEITUAL (muito importante ler)

O Protheus permite que ambientes multiempresa e filiais compartilhem ou isolem dados conforme a necessidade do negócio.

Essa funcionalidade é configurada através do nível de compartilhamento de tabelas, permitindo o controle sobre como os dados são acessados entre empresas, filiais e ambientes distintos.

Modos de Compartilhamento

O Protheus trabalha com dois principais modos de compartilhamento de tabelas:

🔒 1. Modo Exclusivo

No modo exclusivo, os dados de cada filial ou empresa são armazenados separadamente. Ou seja:

• • Cada filial possui suas próprias entradas nas tabelas do banco de dados.

  • A chave primária das tabelas inclui os campos de identificação de empresa (filial/empresa).

  • As operações de consulta, inserção e alteração respeitam esse isolamento.

Características:

• • Isolamento total dos dados por filial ou empresa.

  • Recomendado quando há necessidade de manter dados separados por razões contábeis, fiscais ou organizacionais.

  • Maior controle e segurança sobre dados específicos de cada unidade.

Exemplo de uso:

• • Filiais que operam em países diferentes e precisam atender legislações locais específicas.

  • Empresas do mesmo grupo econômico que compartilham o ERP, mas com CNPJs diferentes.

🔄 2. Modo Compartilhado

No modo compartilhado, os dados são armazenados de forma única, sendo acessíveis por múltiplas filiais. Ou seja:

• • A tabela ignora os campos de empresa/filial como parte da chave primária.

  • Todas as filiais visualizam e manipulam os mesmos dados.

  • Ideal para cadastros mestres comuns a todas as unidades.

Características:

• • Unificação dos dados entre filiais.

  • Redução de redundância de cadastros (ex: produtos, clientes, fornecedores).

  • Simplificação na manutenção de dados mestres.

Exemplo de uso:

• • Cadastro de produtos padronizados em uma rede de lojas.

  • Cadastro de transportadoras ou bancos que atendem a todas as unidades.

UTILIZAÇÃO NA INTEGRAÇÃO COM O TOTVS CRM

Dentro do iPaaS existe a variável totvscrmimportationsharinglevel que possibilita deixar as integrações de algumas entidades de forma exclusiva, ou seja, preenchendo o campo empresa (companyId) do TOTVS CRM.

As entidades são: Vendedor (SA3), Produto (SB1), Tabela de Preço (DA0) e Cliente (SA1).

Para parametrizar deixando exclusivo, basta ir até a variável mencionada acima dentro do componente Data Storage do iPaaS e adicionar o seguinte JSON (em uma linha apenas):

[
    {
        "entidade": "vendedor",
        "nivel": "exclusivo"
    },
    {
        "entidade": "produto",
        "nivel": "exclusivo"
    },
    {
        "entidade": "tabela_preco",
        "nivel": "exclusivo"
    },
    {
        "entidade": "cliente",
        "nivel": "exclusivo"
    }
]

Segue a imagem de exemplo:

De forma bem simples:

Caso você tenha alguma dessas entidades no modo exclusivo e queira replicar no TOTVS CRM, basta inseri-las da forma que foi colocado acima.

Caso seja compartilhado, você pode optar por não preencher a variável, ou colocar o valor igual a compartilhado. No caso de vendedor, se você não preencher a variável, ela será setada como exclusivo.