Integração BlueSoft - Produto e Caixa

Esta integração sincroniza o cadastro de produtos, suas embalagens e as estruturas de caixas (embalagens múltiplas) do ERP BlueSoft para o RuB.

Jobs de Importação

Job de Produto

  • Identificador: PRODUTO
  • Endpoint API: https://erp.bluesoft.com.br/{tenant}/api/comercial/produtos?caixa=false&ultimaAlteracao={data}

Job de Caixa

  • Identificador: CAIXA
  • Endpoint API: https://erp.bluesoft.com.br/{tenant}/api/comercial/produtos?caixa=true&ultimaAlteracao={data}

Funcionamento

  1. Produto:

    • Importa dados básicos como descrição, classe (subgrupo), fabricante e gtin principal.
    • Trata produtos com peso variável (multiplicando o fator de estoque por 1000 quando necessário).
    • Cria associações de cadeia (preço equivalente) caso configurado.
    • Sincroniza GTINs adicionais.
    • Atribui o produto às lojas ativas conforme o sortimento retornado.

  2. Caixa:

    • Importa embalagens do tipo "Caixa".
    • Alimenta a tabela de de-para (bluesoft_produto_depara) relacionando o código da caixa com o código do produto unitário e sua quantidade.
    • Garante que a embalagem múltipla esteja cadastrada para processos de inventário e recebimento.

Propriedades Extras

O RuB preenche automaticamente as seguintes propriedades caso existam metadados configurados:

  • curva_abc
  • descricao_gondola
  • ean_principal
  • vida_util (Shelf Life)
  • Atributos dinâmicos enviados no nó atributos do JSON (convertidos para minúsculo).

Configurações Relacionadas

  • bluesoftProdutoComoCadeia: (Boolean) Torna o produto como sua própria cadeia caso não possua preço de referência.
  • bluesoftCaixaApenasPDV: (Boolean) Filtra apenas caixas exportadas para o PDV na API.
  • Parâmetro produtoProcessar no agendamento: Permite forçar o processamento de códigos específicos separados por vírgula.

Observações

  • A integração utiliza o campo produtoKey como identificador principal.
  • ::: destaque Importante: Produtos marcados como caixa: true no ERP são ignorados pelo job de PRODUTO e processados exclusivamente pelo job de CAIXA. :::