Etiqueta

Esta integração permite a solicitação de impressão de etiquetas de gôndola diretamente para a fila de impressão do ERP RPInfo, a partir de ações realizadas nos dispositivos móveis ou no monitor do sistema RuB.

Identificação no RuB (Driver de Exportação)

Driver de Exportação (Writer): etiqueta_rpinfo
Nome da Interface: RPInfo (Configurações > Etiquetas)
Endpoint API (Padrão): /v1.1/produtounidade/unidade/{identificadorUnidade}/atualizaretiquetaprecos
Endpoint API (Campo Extra): /v1.0/produtounidade/{codigoProduto}/unidade/{identificadorUnidade}

Funcionamento Geral

O sistema suporta dois tipos de integração, configuráveis através de TipoIntegracaoEtiquetaRPInfo:

Padrão: Envio em lote dos produtos para atualização de preços (POST).
Campo Extra: Atualização individual de um campo específico do produto (PUT), utilizando threads para processamento paralelo.

Integração Padrão

O usuário solicita a impressão de etiquetas em diversos pontos do sistema RuB (Coletor de Dados, Monitor de Etiquetas ou Auditoria de Preço).
O sistema captura os códigos dos produtos e resolve o identificador da unidade conforme configuração.
Os dados são enviados via protocolo HTTP POST para o ERP RPInfo.
O ERP recebe a solicitação e insere os itens em sua fila interna de impressão de etiquetas.

Integração via Campo Extra

O usuário solicita a impressão/atualização de etiqueta.
O RuB verifica o valor do campo extra configurado (ex: promoção, valor específico) no produto daquela unidade.
O RuB dispara requisições HTTP PUT paralelas (conforme threads configuradas) para o endpoint de cada produto.
O RPInfo atualiza o valor do campo extra para aquele produto na unidade.

Fluxo de Execução

graph TD
    A["Ação no RuB (Coletor / Auditoria / Monitor)"] --> B{"Tipo de Integração?"}
    B -- "PADRAO (Lote)" --> C["POST /v1.1/produtounidade/unidade/{unidade}/atualizaretiquetaprecos"]
    B -- "EXTRA (Individual)" --> D["Obter Valor do Campo Extra"]
    D --> E["PUT /v1.0/produtounidade/{codProduto}/unidade/{unidade} (Threads Paralelas)"]
    C --> F[("ERP RPInfo - Fila de Impressão / Atualização")]
    E --> F

Origem dos Dados no RuB

A solicitação de etiqueta no RuB pode ser disparada pelos seguintes processos:

Coletor de Dados: Função "Imprimir Etiqueta" disponível nos módulos de pesquisa de preço e conferência.
Monitor de Etiquetas: Solicitação manual através da interface web do RuB ou automática via regras de monitoramento.
Auditoria de Preço: Disparo automático quando o sistema detecta divergência entre o preço na gôndola e o preço no ERP.

Detalhamento dos Campos (JSON)

Padrão

Os dados são enviados em lote via protocolo HTTP POST:

Campo RPInfo	Tipo	Origem RuB / Valor	Descrição
`codigoProduto`	Texto	`produto`	Código de barras ou código interno do produto.
`preco`	Decimal	`0.00`	Preço enviado como zero (o ERP utiliza o preço vigente em sua base).
`preco2` a `5`	Decimal	`0.00`	Demais faixas de preço enviadas como zero para atualização automática pelo ERP.

Campo Extra

Enviado via PUT para cada produto:

Campo	Descrição
`{campo}`	O nome do campo configurado em `ConfigRPInfo.CAMPO_EXTRA_ETIQUETA`
`{valor}`	O valor do campo extra (obtido da propriedade do produto ou valor padrão configurado)

Configurações Avançadas e Aplicação

Acesse no RuB em Configurações > Configurações Avançadas > Integração > RPInfo:

Configuração (Chave)	Tipo	Padrão	Descrição e Como é Aplicada
Tipo de Integração (`rpinfoTipoIntegracaoEtiqueta`)	Enum	`ATUALIZARETIQUETAPRECO`	Define a estratégia de envio: `ATUALIZARETIQUETAPRECO` (envio em lote via POST) ou `EXTRA` (atualização individual via PUT paralelo).
Identificador da Unidade (`rpinfoIdentificadorUnidadeEtiqueta`)	Enum	`CNPJ`	Define se o parâmetro `{identificadorUnidade}` nos endpoints da API será preenchido com o `CNPJ` da loja ou com o `CODIGO_LOJA_ERP`.
Tamanho Mínimo do Identificador (`rpinfoTamanhoMinimoIdentificadorUnidadeEtiqueta`)	Inteiro	`3`	Quando o identificador for `CODIGO_LOJA_ERP`, completa o código da loja com zeros à esquerda até atingir este tamanho (ex.: `19` -> `019`).
Campo Extra da Etiqueta (`rpinfoCampoExtraEtiqueta`)	Texto	`extra99`	Utilizado exclusivamente no modo `EXTRA`. Define o nome da propriedade/campo que será atualizado no RPInfo via PUT.
Valor Extra da Etiqueta (`rpinfoValorExtraEtiqueta`)	Texto	`S`	Utilizado exclusivamente no modo `EXTRA`. Valor padrão enviado ao ERP caso o produto não possua a propriedade configurada no RuB.
Quantidade de Threads (`rpinfoQtdThreads`)	Inteiro (1-20)	`5`	Define a quantidade de threads em paralelo disparadas simultaneamente para as requisições HTTP PUT no modo `EXTRA`.

Ativação

A ativação do driver de exportação deve ser realizada em Configurações > Etiquetas, selecionando a interface RPInfo.