Agora no Bluesoft ERP, é possível informar um prazo de pagamento específico de Força de Vendas na integração de pedidos de e-commerce via API

Como Era o Processo Antes?

Anteriormente, a integração de pedidos de e-commerce gerenciados pelo módulo de Força de Vendas permitia apenas a utilização de boletos com prazos fixos. Caso o cliente necessitasse de um parcelamento personalizado, o sistema não comportava a recepção dessas parcelas via API, gerando apenas uma duplicata única no faturamento e exigindo ajustes manuais.

Como Irá Funcionar a Partir de Agora?

A API de pedidos e-commerce foi atualizada para suportar uma operação dinâmica nos prazos de pagamento através da inclusão de um novo atributo:

  • Endpoint: /api/venda/pedidovenda/e-commerce.
  • Novo Atributo: prazoPagamentoFvKey (Integer). Este campo é opcional e deve conter a chave do prazo de pagamento cadastrado no ERP.
  • Geração de Duplicatas: Ao realizar o faturamento da nota fiscal, as duplicatas financeiras serão geradas automaticamente respeitando os vencimentos e divisões percentuais (ex: 33,33% / 33,34% / 33,33%) configurados para aquela chave.

Observações e Validações

  • Restrição de Meio de Pagamento: Esta lógica de sobreposição de prazo é exclusiva para a forma de pagamento BOLETO_BANCARIO. Para outros meios, como Cartão de Crédito, a chave informada será ignorada e a regra padrão será aplicada.
  • Integridade das Parcelas (Check-sum): O sistema valida se a soma dos percentuais das parcelas no cadastro do prazo totaliza exatamente 100%. Caso haja divergência (ex: 99% ou 101%), a integração retornará erro 400 e interromperá o processo.
  • Status do Prazo: A prazoPagamentoFvKey informada deve existir e estar com o status Ativo no ERP. Caso esteja inativa ou seja inexistente, o sistema retornará erro 400 (Bad Request).

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 r366.71