Integração BlueSoft - Inventário

Esta integração permite a carga de inventários abertos no ERP para contagem no RuB e o posterior retorno dos resultados apurados.

Carga de Inventários (ERP -> RuB)

Job de Importação

  • Identificador: INVENTARIO
  • Endpoint API:
    • Lista: https://erp.bluesoft.com.br/{tenant}/api/estoques/inventarios?lojaKey={lojaKey}&dataAberturaInicial={data}
    • Itens: https://erp.bluesoft.com.br/{tenant}/api/administracao/exportacao/relatorios/exportacao_inventario_congelado/json?codigo={inventarioKey}

Funcionamento da Carga

  1. O Job busca inventários com situação "aberto" ou "congelado" no ERP.
  2. Para cada inventário encontrado, busca a lista de itens congelados (estoque contábil).
  3. Cria a entidade Inventario no RuB para que os coletores possam realizar as contagens.

Retorno de Resultados (RuB -> ERP)

Driver de Exportação

  • Identificador: InventarioWriter
  • Nome: IntfConfig.Inventario: BlueSoft.
  • Endpoint API (PUT): https://erp.bluesoft.com.br/{tenant}/api/estoques/inventarios/{codigo}/{local}/lotes/{lote}

📍 Origem no RuB

Os dados são enviados quando um grupo de contagem é finalizado no módulo de Inventário do RuB.

📝 Campos Enviados (JSON)

CampoTipoOrigem no RuBDescrição
gtinTextogtinCódigo de barras (GTIN) do item contado.
quantidadeDecimalqtdQuantidade apurada (convertida p/ unitário se for pesável).
sequenciaNúmeroseqSequencial da contagem (extraído do grupo de contagem).

Configurações e Ativação

Para habilitar o retorno, configure o driver InventarioWriter no cadastro do inventário ou nas configurações gerais de exportação.

Composição do Grupo de Contagem

O RuB utiliza uma chave composta no campo grupo_contagem para facilitar o mapeamento:

  • Formato: {lote}.{gtin}.{seq}

Observações

  • O campo lote é essencial para que o ERP identifique em qual lote do inventário a contagem deve ser registrada.
  • A quantidade enviada para produtos pesáveis é dividida por 1000, pois o RuB armazena em gramas e a BlueSoft espera em quilos.