Agora no Bluesoft ERP, é possível ler e persistir os dados transacionais de pagamento via API.

O objetivo desta melhoria é eliminar lacunas de rastreabilidade e garantir a integridade financeira das vendas de e-commerce faturadas em plataformas externas, permitindo que os identificadores da transação (como NSU e código de autorização) sejam centralizados de forma automatizada no ERP.

Como Irá Funcionar a Partir de Agora?

O processo de enriquecimento financeiro ocorrerá de forma automatizada durante a execução das rotas de integração:

  1. A plataforma externa realiza o faturamento e envia o XML da nota fiscal através da rota:POST /api/venda/pedidovenda/e-commerce/vincular-xml
  2. O sistema localiza o pedido correspondente, valida o contexto da loja emitente e realiza o vínculo fiscal.
  3. Durante o processamento das tags de pagamento, o ERP passará a mapear os seguintes campos do XML:
    • pag/detPag/tPag: Identifica a forma de pagamento principal.
    • pag/detPag/vPag: Compõe o valor associado à forma de pagamento.
    • pag/detPag/card/tpIntegra: Indica o suporte de integração do pagamento.
    • pag/detPag/card/CNPJ: Utilizado pelo sistema para identificar a credenciadora cadastrada.
    • pag/detPag/card/tBand: Gravado no ERP como a Bandeira do cartão.
    • pag/detPag/card/cAut: Alimenta o campo de Código de Autorização da transação.
  4. Com o processamento concluído com sucesso, o lançamento financeiro ficará visível e disponível para conciliação na tela de 'Manutenção e Baixa de Cartões'.

Observações / Validações

  • Tratamento do Campo cAut (Código de Autorização e NSU):
    • Se a tag <cAut> for enviada no formato codigoAutorizacao|NSU (utilizando o separador pipe |), o sistema irá separar as informações gravando o código de autorização e o NSU em seus respectivos campos.
    • Caso a tag <cAut> contenha apenas o formato codigoAutorizacao (sem o caractere separador), o valor completo será persistido como código de autorização, e o campo NSU manterá o valor previamente informado na criação original do pedido. A ausência do separador não causará bloqueios na importação.
  • Importação Não Bloqueante: A ausência ou preenchimento parcial dos dados transacionais do cartão no grupo <card> não impedirá a vinculação da nota fiscal ou a geração das duplicatas. O sistema gravará os dados válidos recebidos ou manterá o comportamento padrão para meios que não sejam cartões (como Boleto ou PIX).
  • Mensagens de Validação Operacional: O sistema validará a consistência da operação retornando rejeições específicas caso ocorram divergências, tais como:
    • “Não foi possível localizar o pedido de venda correspondente ao XML informado.”
    • “O XML informado não corresponde ao pedido de venda esperado para vinculação.” (Incompatibilidade de filiais/lojas).
    • “Não foi possível processar o XML da nota fiscal informada.” (Estrutura de XML inválida).

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.08