Integrações RUB

Esta seção documenta a integração do RUB com os sistemas corporativos (ERP, retaguarda, PDV, e-commerce, entre outros): o que o RUB é, o que ele espera receber desses sistemas e como as entidades de integração se relacionam.

O que é o RUB

O RUB é um sistema de aplicação e suporte colaborativo focado na automação do chão de loja do varejo. Ele otimiza a alocação dos colaboradores e o fluxo de informação dentro da loja, reduz os níveis de ruptura de exposição (produto em estoque, mas ausente na gôndola) e acompanha a correta precificação dos itens, com o objetivo de maximizar vendas e melhorar a experiência de compra do cliente final.

Na prática, o RUB automatiza e controla grande parte dos processos e colaboradores envolvidos na operação da loja, entre eles:

  • Recebimento de mercadorias — conferência de entrada contra o pedido/nota.
  • Presença e alocação de itens em endereços — onde cada produto está (gôndola, depósito, ponta de gôndola, etc.) e se ele está de fato exposto.
  • Auditoria de etiquetas de preço — comparação entre o preço praticado e o preço exposto.
  • Ressuprimento / reposição — geração de tarefas de reposição a partir da leitura de vendas e estoque.
  • Inventário, atendimento ao cliente, papa-filas, separação de mercadorias e controle de promotores, dentre outras funcionalidades.

O RUB opera de forma proativa: seus algoritmos entendem como o consumo evolui dentro da loja (a partir das vendas, entradas e saldos de estoque informados pelos sistemas corporativos) e geram tarefas para os colaboradores — por exemplo, identificar a falta de um produto na gôndola e disparar a necessidade de reposição, mesmo antes que alguém perceba a ruptura.

Onde o RUB se encaixa

O RUB não substitui o ERP, o PDV ou o sistema de retaguarda. Ele é um sistema operacional de loja que consome o cadastro e os fatos (vendas, compras, estoque) gerados por esses sistemas e, a partir deles, orquestra o trabalho das pessoas na loja. Por isso a integração é um pré-requisito: sem cadastro de produtos, preços, estoque e movimentos, o RUB não tem como raciocinar sobre a operação.

graph LR
    ERP["Sistemas Corporativos<br/>(ERP / Retaguarda / PDV)"] -->|cadastros, preços,<br/>estoque, movimentos| RUB["RUB<br/>(Empresa + Lojas)"]
    RUB -->|tarefas, auditorias,<br/>leituras| DEV["Dispositivos móveis<br/>e colaboradores"]
    DEV -->|execução, contagens,<br/>ajustes| RUB
    RUB -.->|eventos e ajustes<br/> RUB → ERP| ERP

Contextos: Empresa e Loja

O RUB trabalha com dois contextos (tenants):

  • Empresa (Central) — visão corporativa. Concentra os cadastros que são iguais para toda a rede: Classes de Produto, Fornecedores, Cadeias, Produto Empresa e suas Embalagens/Códigos de Barras, além do cadastro das próprias Lojas.
  • Loja — visão de uma unidade. Concentra o que varia por unidade: vínculo do produto com a loja (ativo, custo, vida útil), preços por embalagem, estoque e movimentos.

Essa divisão é refletida diretamente na API pública (https://api.docs.rub.gicbrasil.com): rotas iniciadas por /{tenantEmpresa}/... aceitam apenas o contexto corporativo (ex.: /empresa/api/rest/product/v2), rotas iniciadas por /{tenantLoja}/... operam sobre uma loja específica (ex.: /loja1/api/rest/product/v2) e rotas /{tenant}/... aceitam ambos.

Integrações Nativas Homologadas

Para redes varejistas que utilizam sistemas de gestão consolidados no mercado supermercadista, o RUB disponibiliza integrações nativas pré-construídas e homologadas. Essas soluções eliminam a necessidade de as equipes internas de tecnologia ou fornecedores terceiros desenvolverem integrações manuais do zero via API REST genérica.

Ao optar por um conector nativo homologado, o projeto ganha em agilidade e segurança operacional:

  • Redução drástica do tempo de implantação (time-to-market): Os fluxos essenciais de carga cadastral, estoque e movimentos já estão mapeados, testados e validados em ambiente produtivo.
  • Mapeamento semântico automatizado: Particularidades de conversão de unidades de medida, fatores de embalagem, múltiplos códigos de barras (EAN/GTIN/DUN), tributação e estruturas mercadológicas já são tratadas nativamente pelo conector.
  • Robustez e resiliência: Mecanismos automáticos de reprocessamento, controle de concorrência, paginação eficiente e sincronização incremental garantem alto desempenho mesmo sob grandes volumes de dados.

Abaixo estão detalhados os ecossistemas parceiros que contam com conectores homologados e seus respectivos canais oficiais de documentação:

Integrações Nativas Homologadas:
Se a sua rede utiliza os ERPs parceiros Bluesoft ou RpInfo, o RUB já possui conectores e integrações nativas pré-construídas para uso, dispensando o desenvolvimento manual de rotinas de integração via API. Veja os detalhes nos portais dedicados:

Organização da Documentação

A documentação da interface está organizada nas seguintes seções complementares:

  • Integração Básica — o alicerce indispensável de dados que atende e viabiliza a operação dos módulos essenciais do RUB: Auditoria de Presença, Etiqueta, Consulta, Ressuprimentos ( Tarefas) e Endereçamento. Apresenta a lógica de negócio, as entidades do chão de loja, o modelo de dados conceitual (campos, chaves, tipos e obrigatoriedade), o diagrama de relacionamentos, a ordem recomendada de carga e cenários práticos de uso.
  • Propriedades Extras — mecanismo extensível do RUB para enriquecimento dinâmico de entidades corporativas e de loja (produtos, embalagens, fornecedores, classes, movimentos, etc.) com atributos customizados fortemente tipados, visibilidade no portal web (exibe_list), coletores móveis (exibe_mobile) e regras operacionais.
  • Referência da API REST — visão geral da API REST do RUB, estrutura de tenancy ({tenantEmpresa}, {tenantLoja}), autenticação Basic, regras de comunicação (JSON 1:1 e CSV massivo assíncrono), ciclo de vida de lotes e tratamento de erros. A especificação técnica detalhada de cada contrato, endpoint e schema de dados está disponível diretamente no Swagger oficial.
  • Integrações Nativas Homologadas — conectores pré-construídos e documentações técnicas dedicadas para sistemas ERP parceiros homologados: Bluesoft e RpInfo.