Integração BlueSoft - Venda (Cupons Online)

Esta integração importa as vendas em tempo real do ERP BlueSoft para o RuB, permitindo a atualização do estoque virtual.

Job de Importação

  • Identificador: VENDA
  • Endpoint API: https://erp.bluesoft.com.br/{tenant}/api/vendas/vendaonline?dataHoraInicial={data}

Funcionamento

  1. O Job consulta as vendas ocorridas desde a última execução (padrão: últimas 24h caso não haja registro).
  2. Identifica a loja através do CNPJ ou mapeamento de chaves.
  3. Processa cada item do cupom de venda.
  4. Converte quantidades de produtos pesáveis para gramas (multiplica por 1000).
  5. Gera registros de movimento no RuB com o tipo VENDA.

Composição do Campo Chave

Para garantir a unicidade de cada item de venda importado, o RuB compõe o campo codigo (chave primária do movimento) da seguinte forma:

  • Formato: VDA.{cupomFiscalKey}-{ordem}
  • Exemplo: VDA.123456-1

Observações

  • Depende da existência do produto no RuB (busca realizada pelo produtoKey).
  • ::: destaque Recomendação: Recomenda-se agendamento frequente (ex: a cada 10 ou 15 minutos) para manter o estoque virtual atualizado em tempo real. :::