[Melhoria] CRM: Convênios – Alteração de Senha do Participantes via API

Agora no Bluesoft ERP, é possível realizar a atualização da senha de participantes de convênio via API.

A integração entre o PDV e o ERP foi otimizada com a criação de um novo endpoint que processa a troca de senha seguindo os critérios abaixo:

• Fluxo de Chamada: Deve utilizar o método PUT na rota api/convenios/{codigoConvenio}/participantes/{cpfCnpj}/alterar-senha
• Critérios da Nova Senha:
  • A senha deve ser enviada em formato Base64.
  • Após decodificada, deve conter obrigatoriamente apenas números.
  • O tamanho máximo permitido é de 6 dígitos.
• Validação de Segurança (Checksum): Para garantir que a requisição é autêntica, é obrigatório o envio de um checksum no cabeçalho, calculado via MD5 utilizando a chave configurada no ERP.

Exemplo de JSON:

{
    "senha": "formato base64",
    "checkSum": "formato MD5"
}

• Retorno do Sistema:
  • Sucesso: Retorna status 200 OK.
  • Erro: Caso a senha contenha letras ou o participante não seja encontrado, o sistema retornará 400 Bad Request com a descrição do erro.

Observações / Validações

• Configuração da Palavra-chave: É imprescindível que a rede configure a “Palavra-chave” (entre 10 e 100 caracteres) no menu: Administração > Integrações > Parâmetros de Integrações.
• Auditoria: Toda alteração realizada via API será registrada automaticamente na aba Ocorrências do cadastro do convênio, indicando a data, hora e o usuário.

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.