Integração de Local por Banco de Dados

A integração de Etiqueta de Local por Banco de Dados registra as solicitações de impressão de identificação de endereços físicos (gôndolas, corredores, prateleiras e docas) em uma tabela intermediária (RUBW_ETIQUETA_LOCAL) no banco de dados relacional de integração.

Nessa modalidade, o RuB grava as solicitações solicitadas pelos operadores para que o ERP, WMS ou serviço externo leia os registros e realize a impressão física das etiquetas de identificação de local.

graph LR
    A[Operador RuB: Web / Coletor Mobile] -->|1. Solicita Etiqueta de Local| B[IntfEtiquetaLocal]
    B -->|2. Driver DB em INTF_ETIQUETA_LOCAL| C[EtiquetaLocalDBWriter]
    C -->|3. INSERT via JDBC connname.etiqueta| D[(Tabela RUBW_ETIQUETA_LOCAL)]
    D -->|4. Leitura e Emissão| E[ERP / WMS / Serviço de Impressão]

Configuração da Conexão JDBC

No RuB, configure a conexão JDBC identificada por connname.etiqueta (por padrão, aponta para rub_integracao).
Garanta que o usuário de banco de dados tenha privilégios de INSERT na tabela RUBW_ETIQUETA_LOCAL.
Certifique-se de que o de-para de código de lojas (ID_LOJA) entre RuB e ERP esteja devidamente configurado.

Interface em `INTF_ETIQUETA_LOCAL`

Para utilizar a integração por banco de dados para locais, selecione a opção desejada na configuração INTF_ETIQUETA_LOCAL:

Interface (`ConfigEntry`)	Nome em tela / Descrição	Colunas preenchidas na `RUBW_ETIQUETA_LOCAL`	Quando utilizar
`etiqueta_local_db`	Banco de Dados de Local	`ID_LOJA`, `USUARIO`, `CODIGO`, `DESCRICAO`, `DATA_HORA`, `QTD_PRINT`	Gravação direta no banco de integração para consumo por ERP/WMS.
`writeremoteintf`	Interface via Empresa	Definidas pelo writer configurado no servidor central	Lojas filiais remotas sem conexão direta com o banco de dados central (ver seção abaixo).

Especificação da Tabela `RUBW_ETIQUETA_LOCAL`

A tabela RUBW_ETIQUETA_LOCAL armazena as solicitações pendentes de etiquetas de local.

Dicionário de Colunas

Coluna	Tipo sugerido	Nulo?	Preenchimento pelo RuB
`ID_LOJA`	`INT`	Não	Código da loja convertido de RuB para ERP (`translateIdLojaFromRuBToERP`).
`USUARIO`	`VARCHAR(20)`	Sim	Nome de login ou matrícula do operador solicitante.
`CODIGO`	`VARCHAR(20)`	Não	Código identificador do local / endereço cadastrado.
`DESCRICAO`	`VARCHAR(100)`	Sim	Descrição ou nome do local / gôndola / corredor.
`DATA_HORA`	`DATETIME` / `TIMESTAMP`	Sim	Data e hora em que a solicitação foi criada pelo RuB.
`QTD_PRINT`	`INT`	Não	Quantidade de etiquetas solicitadas (quando não informada, grava `1`).

DDL de Criação Sugerido (SQL ANSI)

CREATE TABLE RUBW_ETIQUETA_LOCAL (
    ID_LOJA        INT NOT NULL,
    USUARIO        VARCHAR(20),
    CODIGO         VARCHAR(20) NOT NULL,
    DESCRICAO      VARCHAR(100),
    DATA_HORA      TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    QTD_PRINT      INT NOT NULL DEFAULT 1
);

CREATE INDEX IDX_RUBW_ETQ_LOC_LOJA_COD ON RUBW_ETIQUETA_LOCAL (ID_LOJA, CODIGO);

Interface via Empresa (Proxy Remoto)

A opção Interface via Empresa serve exclusivamente para integração com banco de dados fazendo proxy via servidor central.

graph LR
    A[Loja / Filial] -->|1. Envia solicitação HTTP| B[Servidor Central RuB]
    B -->|2. Executa Gravação no Banco Central| C[(Tabela RUBW_ETIQUETA_LOCAL / rub_integracao)]

Para que serve

Em filiais que não possuem acesso direto à rede do banco de dados central do ERP, a filial não pode executar comandos diretos na tabela RUBW_ETIQUETA_LOCAL.
A Interface via Empresa atua como um proxy transparente: a filial encaminha a carga da solicitação ao servidor central do RuB via HTTP, e o servidor central efetua a inserção na tabela RUBW_ETIQUETA_LOCAL.

A Interface via Empresa não efetua impressões em impressoras físicas nem gera arquivos em disco na filial: sua única finalidade é encaminhar a solicitação de integração de banco de dados para gravação centralizada.

Disponibilidade em tela

A opção Interface via Empresa só é exibida na seleção de interfaces quando a loja estiver configurada como remota com servidor central ativo.

Parâmetros Funcionais Relacionados

Configuração	Padrão	Impacto na integração de local
`EtiquetaLocaLPadrao`	vazio	Tipo de etiqueta padrão atribuído à solicitação de local quando não informado.
`TipoImpressoraPadrao`	vazio	Tipo de impressora associado ao contexto.
`etiquetaExibicaoNomeImpressora`	`0`	Define se exibe IP e nome (`0`) ou somente o nome (`1`) da impressora nos coletores.

Procedimento de Validação e Ativação

Testar Conexão: Valide a conexão connname.etiqueta no painel de conexões do RuB.
Validar Estrutura: Certifique-se de que a tabela RUBW_ETIQUETA_LOCAL esteja criada com todas as colunas especificadas.
Emitir Solicitação de Teste:
- Pelo RuB Web ou RuB Mobile, solicite a impressão de uma etiqueta para um local existente.
- Execute a consulta:
```
SELECT * FROM RUBW_ETIQUETA_LOCAL WHERE CODIGO = 'CODIGO_DO_LOCAL';
```
- Verifique se os campos ID_LOJA, USUARIO, CODIGO, DESCRICAO, DATA_HORA e QTD_PRINT foram populados.
Verificar Consumo: Garanta que o serviço ou rotina do ERP/WMS consuma os dados da tabela e efetue a emissão das etiquetas.