Agora no Bluesoft ERP, é possível realizar a gestão de cartões de convênio via API
Para oferecer mais flexibilidade e permitir a integração com sistemas externos de gestão, disponibilizamos novos endpoints nas APIs do Bluesoft ERP focados na administração de Cartões de Convênio.
Agora, é possível consultar, incluir e atualizar o status dos cartões dos participantes de forma automatizada e segura.
O que mudou?
Foram criadas rotas específicas para cobrir todo o ciclo de vida do cartão de convênio:
• Inclusão de Novo Cartão: Permite gerar um novo cartão para um participante. Por segurança, novos cartões criados individualmente via API nascem obrigatoriamente com o status PENDENTE_EMISSAO e respeitam a faixa configurada no ERP.
Método POST: api/v2/convenios/cartao/{convenioKey}/participantes/{participanteKey}
• Importação em Lote: Ideal para migração de dados legados. Permite incluir múltiplos cartões de uma vez, aceitando numerações e status preexistentes (ignorando a validação sequencial do ERP, mas mantendo a unicidade global do número).
Método POST: api/v2/convenios/cartao/{convenioKey}/importacao
• Manutenção de Status: É possível alterar o status do cartão (ex: de PENDENTE_EMISSAO para ATIVO ou BLOQUEADO).
Método PUT: api/v2/convenios/cartao/{convenioKey}/participantes/{participanteKey}/status
◦ Atenção: Ao definir um cartão como INATIVO, é obrigatório informar o motivo (campo motivo) e a operação torna-se irreversível (o cartão não poderá ser reativado).
• Consulta de Cartões: Busca simplificada dos cartões vinculados a um participante ou pessoa, retornando apenas dados essenciais como número, status e chaves de vínculo, garantindo a privacidade de dados sensíveis como saldos e limites.
Método GET: api/v2/convenios/cartao
Parâmetros: participanteKey ou pessoaKey
Regras de Negócio e Segurança
• Unicidade: O sistema valida a unicidade global do número do cartão, impedindo duplicidade entre participantes ou convênios diferentes.
• Auditoria: Todas as operações realizadas via API são registradas no Histórico de Cartões e nas ocorrências do sistema, identificando o usuário da API, data, hora e alterações realizadas.
Essa novidade visa agilizar a operação no PDV e otimizar a gestão de convênios, facilitando o sincronismo de dados com aplicações de terceiros.
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.