🚀 Novas APIs REST para Integrações Básicas

• Data de publicação: 18 de Junho de 2026
• Versão necessária: Plugin Core 11.261.9411

Objetivo

Dando continuidade à nossa jornada de facilitação de integrações entre o RUB e sistemas externos (como ERPs e sistemas de retaguarda), temos o prazer de anunciar o lançamento do novo pacote de APIs de Integração Básica (Core).

Este conjunto de APIs REST foi desenvolvido para permitir a automação completa do ciclo de vida de produtos, estoques e entidades organizacionais, utilizando um formato padronizado (JSON) e garantindo alta performance e segurança.

O que há de novo?

Foram disponibilizados novos endpoints cobrindo as principais entidades do sistema. Agora é possível consultar, criar e atualizar as seguintes estruturas diretamente via API:

🏪 API de Lojas

• Listagem completa de lojas (com filtro por status alive).
• Consulta de loja específica por código de integração.
• Criação e atualização de lojas via POST.
• Desabilitação de lojas via DELETE.

📦 Catálogo de Produtos

• Cadeias (/group/v1): Gestão de cadeias, incluindo deleção em cascata (desvinculação automática de produtos).
• Classes de Produto (/category/v1): Organização hierárquica do seu catálogo.
• Fornecedores (/supplier/v1): Cadastro completo, incluindo múltiplos contatos.
• Produto Empresa (/product/v1): Criação de produtos (PLU/SKU), definindo regras de peso variável, embalagens múltiplas e códigos de barras associados.
• Produto Loja (/product-store/v1): Associação de produtos a lojas específicas, incluindo gestão de preços por embalagem, custos e produtos derivados/associados.

📊 Controle de Tarefas

• Estoque (/stock/v1): Ajuste e atualização de saldos de estoque por local e loja.
• Movimentos (/movement/v1): Registro detalhado de movimentações (entradas, saídas e transferências), permitindo rastrear facilmente a origem e destino das mercadorias.

🏪 Tarefas

• Setores e Filas (/sector/v1 e /queue/v1): Mapeamento físico e lógico de setores da empresa e lojas, para organização e distribuição de tarefas dentro do RUB.

Principais Recursos e Benefícios

• Padronização de Endpoints: Todas as APIs seguem o padrão REST com métodos GET, POST e DELETE, facilitando a integração com qualquer sistema externo.
• Sincronização Flexível (POST vs PUT): Maior controle sobre a atualização de dados. Utilize requisições POST para sincronização incremental (adicionar novos dados sem apagar os existentes) ou PUT para sincronização total (substituir dados, removendo códigos de barras ou propriedades que não constem no novo envio).
• Propriedades Dinâmicas (Metadados): Todos os principais endpoints suportam o envio do campo properties, permitindo que os integradores alimentem e leiam campos extras e dinâmicos customizados para a regra de negócio da empresa sem necessidade de alterações no banco de dados.
• Alta Performance: Todos os endpoints de listagem (buscas gerais) contam com suporte a paginação dinâmica (parâmetros page e pageSize), garantindo que grandes volumes de dados sejam trafegados de forma rápida e segura.
• Segurança e Governança: Cada um dos recursos conta com novos níveis granulares de permissão. Foi implementada uma separação clara entre as permissões de Leitura para cada Entidade.

Os endpoints disponíveis, bem como sua documentação, estão disponíveis em Documentação API.

Disponibilidade

Melhoria incorporada ao plugin core, disponibilizada em 18/06/2026.