Agora no Bluesoft ERP, é possível realizar a consulta de limite de convênio no PDV informando diretamente a placa do veículo.

O objetivo desta melhoria é otimizar as operações de venda em postos de combustíveis e estabelecimentos conveniados, permitindo a identificação ágil do convênio no momento do atendimento quando o motorista não dispuser do CPF/CNPJ da empresa ou do número do cartão convênio.

O Que Mudou?

Antes, a consulta de limite de convênio exigia obrigatoriamente o CPF/CNPJ do participante ou o número do cartão. Quando o condutor do veículo não sabia o documento da empresa e não possuía o cartão físico, o PDV ficava impossibilitado de consultar o limite diretamente.

Agora, a API pública de consulta de limite de convênio aceita a placa do veículo (placaVeiculo) como um identificador de entrada alternativo. O sistema localiza o vínculo operacional do veículo, valida as regras de disponibilidade e devolve as informações do convênio junto ao CPF/CNPJ completo do participante para a continuidade da venda.

Benefícios:

• Maior agilidade e autonomia no atendimento a frotas no momento do abastecimento ou compra.
• Eliminação de erros operacionais e de chamados para localização manual de cadastros.
• Segurança mantida com validações automáticas de situação do veículo, do participante e da loja.

Como Irá Funcionar a Partir de Agora?

1. Consulta por Placa: Na chamada da API (GET /api/clientes/limite-convenio), o PDV pode enviar o parâmetro placaVeiculo de forma isolada.
2. Normalização Automática: O ERP converte letras minúsculas para maiúsculas e remove espaços e hífens da placa informada, aceitando os padrões de placa tradicional brasileira e Mercosul.
3. Exclusividade do Identificador: A placa não pode ser combinada com outros identificadores na mesma requisição. Se for enviada junto com cpfCnpj ou numeroCartao, a chamada é bloqueada por conflito de parâmetros.
4. Validação de Vínculo Único: A consulta exige um único vínculo ativo e disponível (veículo ativo, participante ativo com CPF/CNPJ e convênio liberado). Caso existam múltiplos vínculos para a mesma placa, veículo inativo ou cadastro inconsistente, a consulta é recusada sem devolver dados de limite.
5. Retorno do Veículo e CPF/CNPJ Completo: Na modalidade por placa, o ERP devolve apenas o convênio correspondente e somente o veículo consultado. Além disso, em todas as modalidades de consulta (por documento, cartão ou placa), cada item retornado passa a devolver o CPF/CNPJ na consulta.
6. Restrição de Convênio por Loja: Se a regra de restrição por loja estiver ativa no sistema, o envio de lojaKey permanece obrigatório e convênios bloqueados para a loja informada serão recusados.

Observações Importantes!

• Permissões de Acesso: A consulta por placa é autorizada tanto pela nova permissão específica (4735 – API – Consulta de limite de convênio do cliente via placa) quanto pelas permissões existentes da rota (3183 e 4393).
• Processos Posteriores: A validação de senha, o empenho de limite e o cancelamento da venda continuam utilizando suas rotas e regras atuais, aproveitando o CPF/CNPJ retornado na consulta de limite.
• Impacto Financeiro e Contábil: A consulta trata-se de uma operação de leitura e não produz nenhuma movimentação financeira ou contábil no ERP.

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