Agora no Bluesoft ERP, é possível gerenciar de forma centralizada, segura e reutilizável as informações de autenticação utilizadas por integrações externas na nova tela Credenciais de Integração, iniciando pelo Portal Único Siscomex.

O objetivo desta melhoria é otimizar a gestão de autenticações do ERP, permitindo que uma mesma credencial atenda a múltiplas lojas autorizadas, aumentando a rastreabilidade e impedindo que valores sensíveis de chaves e senhas fiquem expostos na interface após a gravação.

Agora, com o novo módulo centralizado de credenciais, o sistema unifica o cadastro de dados de autenticação e permite definir explicitamente quais lojas podem utilizar cada credencial. Para o Portal Único Siscomex, o método de autenticação utiliza o par de Chaves de Acesso (Client-Id e Client-Secret), e a configuração do ambiente (Produção ou Validação) passa a ser definida individualmente no Cadastro da Loja.

Benefícios:

  • Segurança Reforçada: As informações sensíveis de autenticação são salvas de forma protegida e nunca mais são exibidas na tela ou retornadas via API/JSON após a gravação.
  • Fim da Duplicação: Permite reutilizar com segurança a mesma credencial em diversas lojas da rede.
  • Controle de Conflitos: O sistema impede que uma mesma loja possua mais de uma credencial ativa simultaneamente para a mesma integração.
  • Rastreabilidade: Permite consultar o histórico de alterações (inclusão, alteração de abrangência, substituição de par e trocas de situação) sem expor senhas nos registros.

Como Irá Funcionar?

1. Novo Cadastro Centralizado de Credenciais

A acesse a nova funcionalidade no caminho: Administração > Integrações > Credenciais de Integração.

  1. Consulta e Filtros: Na tela principal, é possível filtrar as credenciais cadastradas por Integração, Identificação, Método de Autenticação, Loja abrangida e Situação (Ativa ou Inativa).
  2. Inclusão de Credencial: Ao clicar em + Cadastrar Credencial, o usuário com permissão de manutenção deverá preencher:
    • Integração: Selecionar a integração suportada (disponível inicialmente: Portal Único Siscomex).
    • Identificação: Nome/descrição para identificar a credencial (até 300 caracteres).
    • Método de Autenticação: Método suportado para a integração (para Siscomex: Chaves de Acesso).
    • Chaves de Acesso: Informe os valores para os campos obrigatórios Chave (Client-Id) e Senha (Client-Secret).
    • Situação: Definir entre Ativa ou Inativa.
    • Validade: Campo cadastral opcional de data informativa (não inativa a credencial automaticamente ao vencer).
  3. Seleção de Lojas Abrangidas:
    • É obrigatório vincular pelo menos uma loja para salvar a credencial.
    • O botão Selecionar todas atua como um facilitador do momento, marcando todas as lojas existentes na tela. Lojas cadastradas posteriormente no ERP não serão vinculadas automaticamente.
  4. Substituição Segura do Par de Chaves:
    • Ao editar uma credencial cadastrada, os campos Chave (Client-Id) e Senha (Client-Secret) serão apresentados totalmente vazios por segurança.
    • Se os campos permanecerem vazios durante a alteração de outros dados (como identificação ou lojas), o par de chaves originalmente salvo será preservado.
  5. Regra de Bloqueio por Loja:
    • O sistema valida se alguma loja selecionada já está vinculada a outra credencial Ativa da mesma integração. Se houver sobreposição, a gravação/ativação será bloqueada e o sistema indicará as lojas em conflito.

2. Configuração do Ambiente no Cadastro da Loja

A definição do ambiente utilizado para o Portal Único Siscomex é feita diretamente no cadastro de cada estabelecimento:

  1. Acesse: Administração > Lojas > Consulta e Pré-Cadastro de Lojas.
  2. Abra a edição da loja desejada e navegue até a aba: Contábil/Fiscal > Geral.
  3. Localize o campo Ambiente do Portal Único Siscomex e selecione a opção desejada:
    • Produção
    • Validação
  4. Para lojas novas ou já existentes sem configuração prévia, o campo iniciará sem valor selecionado (Selecione), cabendo ao usuário definir o ambiente desejado. Lojas diferentes que compartilham a mesma credencial podem utilizar ambientes distintos conforme sua parametrização individual.

Observações Importantes!

  • Permissões de Acesso: Foram criadas permissões específicas no grupo de usuários para controlar a funcionalidade:
    • Permissão de consulta das Credenciais de Integração.
    • Permissão de manutenção das Credenciais de Integração.
  • Inativação e Reativação: Ao inativar uma credencial, ela permanece salva no histórico, mas deixa de ser disponibilizada para as rotinas consumidoras do ERP.
  • Histórico de Ocorrências: Ao clicar na ação Ocorrências, o sistema exibe a rastreabilidade das ações executadas (inclusão, alteração de lojas, troca de situação), garantindo que nenhum valor sensível seja registrado nos logs.

Para saber mais sobre a funcionalidade, acesse o link a seguir:

Cadastro de Pessoas – Lojas

Disponível a partir da versão r343.01