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.
- 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).
- 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)eSenha (Client-Secret). - Situação: Definir entre Ativa ou Inativa.
- Validade: Campo cadastral opcional de data informativa (não inativa a credencial automaticamente ao vencer).
- Seleção de Lojas Abrangidas:
- É obrigatório vincular pelo menos uma loja para salvar a credencial.
- O botão
Selecionar todasatua como um facilitador do momento, marcando todas as lojas existentes na tela. Lojas cadastradas posteriormente no ERP não serão vinculadas automaticamente.
- Substituição Segura do Par de Chaves:
- Ao editar uma credencial cadastrada, os campos
Chave (Client-Id)eSenha (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.
- Ao editar uma credencial cadastrada, os campos
- 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:
- Acesse: Administração > Lojas > Consulta e Pré-Cadastro de Lojas.
- Abra a edição da loja desejada e navegue até a aba: Contábil/Fiscal > Geral.
- Localize o campo Ambiente do Portal Único Siscomex e selecione a opção desejada:
- Produção
- Validação
- 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:
Disponível a partir da versão r343.01
