Venda (Cupons Online)

Esta integração importa os cupons de venda em tempo real (ou quase real) do ERP RPInfo para o RuB, permitindo a atualização do estoque virtual e geração de indicadores de venda.

Identificação na Agenda de Execuções

  • Nome do Job: Venda
  • Grupo: RPInfo
  • Chave do Job: rpintoVENDA
  • Endpoint API: /v1.5/vdonline/lastid/{lastId}?datainicial={dataInicial}&datafinal={dataFinal}&unidade={cnpj}

Funcionamento Geral

  1. Consulta: O Job consulta as vendas "online" do ERP para o período (ontem, hoje e amanhã) da loja configurada (baseado no CNPJ).
  2. Incremental: Utiliza o controle de lastId para processar apenas novos cupons a cada execução.
  3. De-Para de Produtos: Se houver um mapeamento na tabela rpinfo_produto_depara, o código do produto será convertido para o código interno do RuB. Caso contrário, utiliza o código retornado pelo ERP.
  4. Conversão de Unidade: Se o produto possuir de-para com fator de conversão ou se for de peso variável (multiplicado por 1000), a quantidade é ajustada adequadamente.
  5. Persistência: Os dados são salvos como movimentos do tipo VENDA no RuB.

Fluxo de Execução

graph TD
    A["Job Venda Agendado por Loja (CNPJ)"] --> B["GET /v1.5/vdonline/lastid/{lastId}?datainicial={dataInicial}&datafinal={dataFinal}&unidade={cnpj}"]
    B --> C["Para cada Cupom de Venda Retornado"]
    C --> D{"Verificar Deduplicação (rpinfo_processado)"}
    D -- "Já Processado" --> E["Ignorar Registro"]
    D -- "Novo" --> F["De-Para de Produto (rpinfo_produto_depara)"]
    F --> G["Ajustar Quantidade (Fator de Conversão e Peso Variável)"]
    G --> H["Gerar Chave Única da Venda (formatoCodigoVenda)"]
    H --> I["Criar Movimento VENDA no RuB"]
    I --> J["Registrar em rpinfo_processado"]
    J --> K[("Estoque Virtual e Indicadores Atualizados")]

Composição do Campo Chave

Para garantir a unicidade de cada item de venda importado, o RuB utiliza a configuração formatoCodigoVenda.

  • Padrão: ${codigoPDV}-${cupom}-${sequencial}
  • Exemplo: 1-123456-1

Configurações Avançadas e Aplicação

Acesse no RuB em Configurações > Configurações Avançadas > Integração > RPInfo:

Configuração (Chave)TipoPadrãoDescrição e Como é Aplicada
Formato do Código da Venda (formatoCodigoVenda)Texto${codigoPDV}-${cupom}-${sequencial}Define como será gerada a chave primária única da venda no RuB via interpolação de campos retornados pela API (como codigoPDV, cupom, sequencial, dataMovimento).

Nota: Os placeholders ${campo} são substituídos dinamicamente pelos atributos correspondentes do JSON retornado pela API do RPInfo.

Observações

  • CNPJ: A integração depende da configuração correta do CNPJ da loja no RuB.
  • Frequência: ::: destaque Recomenda-se agendar o job a cada 15-30 minutos para manter o estoque virtual atualizado. :::
  • Manutenção: Certifique-se de que o job MANUTENCAO_RPINFO está ativo para limpar os logs de processamento antigos.