Agora no Bluesoft ERP, é possível realizar a importação em lote de cartões históricos não ativos (como cancelados, inativos ou suspensos) para participantes que já possuem um cartão cadastrado no sistema via API.

Objetivo

O objetivo desta melhoria é permitir que os clientes complementem a base histórica de cartões de convênio via API.

Como Irá Funcionar a Partir de Agora?

A API de importação passou a diferenciar se o registro enviado se trata de um cartão ativo ou de um cartão histórico com base no campo statusCartao.

O fluxo foi reestruturado com as seguintes diretrizes:

  • Cartões Históricos Permitidos: Se o statusCartao for diferente de ATIVO (ex: CANCELADO, INATIVO, BLOQUEADO, SUSPENSO, entre outros), o sistema valida o número e permite a inserção do registro no histórico do participante.
  • Trava do Maior Número Cadastrado: Para garantir a consistência com a tela de manutenção de convênios, o número do cartão histórico enviado deve ser menor ou igual ao maior número de cartão já cadastrado para aquele participante. Se o número for superior, a API abortará a inclusão.
  • Bloqueio de Novo Cartão Ativo: Caso o participante já possua um cartão no ERP e o item da requisição possua o status ATIVO, o sistema manterá o bloqueio de segurança para impedir múltiplos cartões vigentes.
  • Registro de Ocorrência: A gravação do histórico no cadastro do conveniado é realizada de forma automática.

O endpoint impactado permanece o mesmo:

  • POST /api/v2/convenios/cartao/{convenioKey}/importacao

Exemplo de Payload Aceito (Múltiplos Históricos):

JSON

{
  "cartoes": [
    {
      "participanteKey": 1923,
      "numeroCartao": "4500008012560100",
      "statusCartao": "CANCELADO"
    },
    {
      "participanteKey": 1923,
      "numeroCartao": "4523860806340110",
      "statusCartao": "CANCELADO"
    }
  ]
}

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 r370.01