Informamos que a nova versão do Bluesoft ERP traz uma melhoria estratégica para o monitoramento de vendas de produtos compostos. A partir desta atualização, o sistema passará a gravar com exatidão os dados referentes às vendas de Cestas de Natal e Kits Natalinos enviados pela API de cupons de venda da sua frente de caixa (PDV).

Para garantir o vínculo correto entre os itens individuais comercializados e o produto principal (o Kit ou Cesta) que originou a venda, a integração da frente de caixa deverá enviar essa identificação por meio do novo campo codigoDoItemCesta. Ao receber as requisições, o ERP realizará a leitura deste campo e armazenará o relacionamento estruturado entre a venda do item e o seu respectivo kit.

API de Cupons fiscais(/fiscal/cupomfiscal/lote):

O produtoKey (kit/Cesta) deve ser informado no payload através do campo: codigoDoItemCesta

 "itens": [
    {
        "valorTotal": 47.25,
        "codigoDeBarras": 7891151043106,
        "codigoDoItemCesta": 2026,
        "quantidadeTotal": 5,
        "codigoIcms": "00"

Essa adequação elimina a necessidade de realizar ajustes manuais posteriores — como a dedução de volumes baseada apenas na saída de embalagens avulsas —, garantindo a integridade dos dados e assegurando que o sistema reflita a realidade exata da operação do PDV.

Destacamos, por fim, que com a recepção e o armazenamento estruturado desses novos dados enviados pela frente de caixa, o ERP permitirá a disponibilização dessas informações de forma consolidada em relatórios de vendas. Essa evolução entregará à diretoria e aos gestores uma visão clara, com números reais e confiáveis sobre o desempenho das campanhas sazonais, otimizando o acompanhamento de resultados e a tomada de decisão.

Recomendamos que a equipe técnica ou de TI consulte a documentação atualizada da API de Cupons para realizar o alinhamento da integração com o envio do campo codigoDoItemCesta

Observações Importantes

  • Exclusivo via API: A rotina de leitura deste novo dado funciona especificamente para integrações via API. Arquivos de vendas (formato SDF) continuarão ignorando o campo, realizando a baixa dos itens pelo cenário padrão.
  • Tratamento de Divergências: Se houver erro na composição (ex: o cálculo não resultar em um número inteiro exato de kits, ou o item vendido não pertencer à receita), o sistema interromperá o vínculo e o cupom será direcionado para a tela 'OCORRÊNCIAS DA VENDA ONLINE'. O mesmo ocorre caso o produto pai não seja encontrado.
  • Vendas Avulsas: Caso o campo codigoDoItemCesta venha nulo, zerado ou vazio, o ERP processará a venda normalmente como itens avulsos, sem interagir com a tabela de vínculos.
  • Estorno de Vendas: Ao realizar o estorno de uma venda através da tela 'ESTORNO DE VENDA', o sistema executará a exclusão lógica dos registros vinculados aos kits, garantindo que os relatórios não contabilizem vendas canceladas.
  • Integridade Financeira: O novo registro é puramente informativo/quantitativo e não soma o valor financeiro do “Produto Pai” ao total do cupom, prevenindo a duplicidade de receita.

Para saber mais sobre a funcionalidade, acesse o link a seguir: Monitoramento da Venda Online

Disponível a partir da versão r367.01