Agora no Bluesoft ERP, é possível identificar e utilizar o convênio correto nas operações do PDV quando o mesmo participante possui mais de um vínculo. Nas operações realizadas por cartão, o próprio cartão determina o convênio utilizado na consulta, na validação da senha, no empenho e no cancelamento. O objetivo desta melhoria é proporcionar mais precisão na integração entre o PDV e a API de Convênios, mantendo independentes os vínculos de um mesmo participante e preservando os processos realizados sem cartão.

Como Era o Processo Antes?

Nas operações iniciadas por cartão, a integração já validava o cartão e o titular e também recebia o código do convênio informado pelo PDV. A partir desta evolução, o cartão passa a ser a referência para identificar o vínculo consultado ou movimentado quando o participante possui mais de um convênio.

Como Irá Funcionar a Partir de Agora?

Consulta de limite

  • Na consulta por CPF/CNPJ, serão retornados os convênios ativos e elegíveis do participante.
  • Cada item apresentará o nome do titular separado da descrição do convênio.
  • Na consulta por cartão, será retornado somente o vínculo associado ao cartão informado.

Validação da senha

  • Na validação por cartão, o código do convênio poderá ser omitido.
  • Quando enviado, o código não participará da autenticação nem selecionará outro convênio.
  • O fluxo sem cartão continuará utilizando o CPF/CNPJ e o código do convênio selecionado pelo PDV.

Empenho e cancelamento

  • Nas operações por cartão, o vínculo e o convênio serão determinados pelo próprio cartão.
  • O código do convênio poderá ser omitido ou corresponder ao convênio do cartão.
  • Quando for informado o código de outro convênio, a operação será recusada e os valores permanecerão inalterados.
  • A resposta do empenho e do cancelamento informará o convênio efetivamente afetado.

Exemplos de uso

Os valores abaixo são ilustrativos e devem ser substituídos pelos dados e pela autenticação do ambiente.

1. Consultar os convênios pelo CPF/CNPJ

GET {{baseUrl}}/api/clientes/limite-convenio?cpfCnpj={{cpfCnpjTitular}}

Exemplo de resposta com dois vínculos do mesmo titular:

{
  "nomeCliente": "FULANO",
  "lista": [
    {
      "codigoConvenio": 25353,
      "nomeCliente": "FULANO",
      "descricao": "TESTE DESCRIÇAO",
      "numeroCartao": "0000000012345678",
      "saldo": 63.15
    },
    {
      "codigoConvenio": {{codigoConvenioB}},
      "nomeCliente": "FULANO",
      "descricao": "CONVENIO SECUNDARIO 468868"
    }
  ]
}

2. Consultar somente o vínculo do cartão

GET {{baseUrl}}/api/clientes/limite-convenio/12345678/limite

{
  "nomeCliente": "FULANO",
  "lista": [
    {
      "codigoConvenio": 25353,
      "nomeCliente": "FULANO",
      "descricao": "TESTE DESCRIÇAO",
      "numeroCartao": "0000000012345678",
      "saldo": 63.15
    }
  ]
}

3. Validar a senha do cartão sem informar o convênio

POST {{baseUrl}}/api/clientes/validar-senha
Content-Type: application/json
{
  "cpfCnpj": "{{cpfCnpjTitular}}",
  "numeroCartao": "12345678",
  "senha": "{{senhaCartaoBase64}}",
  "checkSum": "{{checkSumSenhaCartao}}"
}

Resposta esperada: HTTP 200 com corpo vazio. O mesmo resultado será obtido quando o código do convênio for correspondente ou divergente, pois ele não participa da autenticação por cartão.

4. Realizar o empenho pelo cartão sem informar o convênio

POST {{baseUrl}}/api/clientes/empenho-convenio
Content-Type: application/json
{
  "cpfCnpj": "{{cpfCnpjTitular}}",
  "numeroCartao": "12345678",
  "valor": 43.25,
  "lojaKey": 1
}

Exemplo de resposta:

{
  "codigoConvenio": 25353
}

5. Cancelar o empenho pelo cartão

POST {{baseUrl}}/api/clientes/12345678/cancelar-empenho-convenio
Content-Type: application/json
{
  "cpfCnpj": "{{cpfCnpjTitular}}",
  "codigoConvenio": 25353,
  "valor": 43.25,
  "lojaKey": 1
}

Exemplo de resposta:

{
  "codigoConvenio": 25353
}

6. Informar o código de outro convênio

POST {{baseUrl}}/api/clientes/12345678/empenho-convenio
Content-Type: application/json
{
  "cpfCnpj": "{{cpfCnpjTitular}}",
  "codigoConvenio": {{codigoConvenioB}},
  "valor": 43.25,
  "lojaKey": 1
}

Resposta esperada: erro HTTP 4xx, sem alteração dos valores. Mensagem validada:

O código do convênio informado não corresponde ao convênio do cartão.

Observações e validações

  • Somente cartões ativos poderão ser utilizados.
  • Nas operações por cartão que recebem CPF/CNPJ, o documento deverá pertencer ao titular do cartão.
  • As permissões existentes serão mantidas conforme a operação e a forma de acesso.
  • Quando a restrição de uso por loja estiver habilitada, a loja deverá ser informada e o convênio deverá estar disponível para ela.
  • As regras de limite individual ou compartilhado, tolerância, parcelamento e bloqueio para novo empenho serão preservadas.

Para conhecer as funcionalidades relacionadas, consulte as documentações:

Para saber mais sobre a utilização das APIs do ERP, clique aqui.

Disponível a partir da versão r374.03