No Bluesoft ERP, é possível integrar cupons de venda via API contendo múltiplos convênios no mesmo cupom fiscal, garantindo o processamento e o fechamento de caixa corretos quando enviada mais de uma finalizadora do tipo convênio.

O objetivo é proporcionar maior flexibilidade nas integrações de vendas via API, permitindo que pagamentos divididos entre diferentes convênios sejam processados com precisão, sem perdas de informações financeiras ou divergências no fechamento de caixa.

Como Funciona?

A API de integração de lote de cupons fiscais está totalmente preparada para receber e registrar múltiplos convênios em um mesmo cupom de venda.

  1. Envio da Requisição (POST):
    • Ao realizar o envio para o endpoint POST /api/fiscal/cupomfiscal/lote, a estrutura do payload na tag finalizadoras permite informar múltiplos objetos com a finalizadora de convênio (ex: "finalizadora": "20"), cada um com seu respectivo codigoConvenio, cpfCnpjConveniado, valor e parcelamento.
    • Exemplo de estrutura de finalizadoras:

JSON

"finalizadoras": [
  {
    "finalizadora": "20",
    "valorTroco": 0,
    "valor": 11.45,
    "codigoConvenio": 253221,
    "cpfCnpjConveniado": "{cpfCnpj}",
    "numeroCartao": "{numeroCartaoConvenio}",
    "numeroParcela": 1
  },
  {
    "finalizadora": "20",
    "valorTroco": 0,
    "valor": 11.45,
    "codigoConvenio": 256816,
    "cpfCnpjConveniado": "{cpfCnpj}",
    "numeroParcela": 1
  }
]
  1. Processamento e Conferência de Caixa:
    • O sistema realiza a leitura individualizada de cada finalizadora convênio informada na requisição.
    • Na tela de Fechamento de Caixa (Lançamentos > Venda Convênio > Lançamento Detalhado), cada convênio utilizado no cupom é registrado de forma discriminada, exibindo os respectivos valores, parcelas e informações do cliente/conveniado corretamente.

Observações Importantes!

  • Validação de Limite e Regras de Convênio: Antes do envio da venda, o sistema integrado pode consultar o limite dos convênios através do endpoint GET /api/clientes/limite-convenio.
  • Compatibilidade: O comportamento padrão para cupons com apenas uma finalizadora convênio ou outras formas de pagamento permanece inalterado.

Para saber mais sobre a funcionalidade, acesse o link a seguir: Cupom Fiscal Lote

Disponível a partir da versão: 370.01