Agora no Bluesoft ERP, é possível alterar senha de cartões de convênio via API

O objetivo desta melhoria é descentralizar a gestão de senhas, permitindo que a atualização ocorra diretamente no ponto de venda (PDV) através de uma integração segura, agilizando o atendimento e garantindo a autonomia dos participantes do convênio.

A partir desta atualização, foi disponibilizada uma nova rota na API de Integração para permitir a alteração segura da senha do cartão.

Detalhes Técnicos da Integração:

  • Método: PUT.
  • Endpoint: /api/v2/convenios/cartao/{numeroCartao}/alterar-senha.
  • Payload (Corpo da Requisição): O sistema exige dois campos obrigatórios:
    • senha: A nova senha deve ser enviada codificada em formato Base64.
    • checkSum: Para garantir a integridade, deve ser enviado o hash MD5 resultante da concatenação: Palavra-chave de Integração + Nova Senha.

Exemplo de JSON:

{
    "senha": "MTIzNDU2Nw==",
    "checkSum": "aaeee57454163fc1b238661c75ddb4a0"
}

Regras de Validação e Segurança:

  1. Formato da Senha: Após a decodificação do Base64, o sistema valida se a senha consiste exclusivamente em números de até 6 dígitos.
  2. Status do Cartão: A alteração só é processada para cartões que estejam com o status ATIVO no ERP.
  3. Vínculo de Segurança: O sistema valida se o numeroCartao informado pertence ao participante e convênio correspondentes.
  4. Palavra-chave: A validação do checkSum utiliza a string configurada na tela Parâmetros de Integrações > API de convênio do cliente.

Observações e Validações

  • Registro de Histórico: Toda alteração realizada via API é registrada automaticamente na tabela de histórico de cartões, permitindo rastrear a origem da operação através do log de auditoria.
  • Auditoria: O log contém o usuário autenticado pela API e a data/hora exata da operação.
  • Permissão Necessária: Para utilizar o novo endpoint, o usuário da API deve possuir a permissão 4472 - API - Alterar senha de cartão convenio (Alterar).

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.

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