Arquivos TXT (EAN e SKU)
O RuB disponibiliza drivers de exportação de etiquetas em arquivos de texto plano (TXT), permitindo a integração com sistemas de automação comercial e centrais de impressão legadas ou de terceiros através de diretórios monitorados.
graph LR
A[Solicitação de Etiqueta] --> B[Script de Impressão RUB]
B --> C{Tipo de Interface TXT}
C -->|etiqueta_txt_ean| D[EtiquetaEANTXTWriter: Gera TXT com EAN/Barras]
C -->|etiqueta_txt_sku| E[EtiquetaSKUTXTWriter: Gera TXT com SKU/Código Interno]
D --> F[Arquivo .txt em path.Etiqueta]
E --> F
Interfaces disponíveis
| Chave de Configuração | Classe do Writer | Descrição |
|---|---|---|
etiqueta_txt_ean | com.gicbrasil.rub.etiqueta.intf.writer.EtiquetaEANTXTWriter | Exporta arquivo de texto priorizando o código de barras (EAN com 13 ou mais dígitos) e quantidade. |
etiqueta_txt_sku | com.gicbrasil.rub.etiqueta.intf.writer.EtiquetaSKUTXTWriter | Exporta arquivo de texto contendo somente os códigos internos dos produtos (SKU). |
1. Exportação por Código de Barras (etiqueta_txt_ean)
Utilizado quando o sistema consumidor ou impressora externa identifica o item através do código de barras principal.
Parâmetros de configuração
- Interface (
INTF_ETIQUETA_PRODUTO):etiqueta_txt_ean - Destino (
path.Etiqueta): caminho do diretório onde o arquivoTXTserá gerado. - Nome do arquivo (
interface.nome.arquivo/etiquetaFormatoDoNomeDoArquivo): padrão ou máscara do nome do arquivo gerado (veja tabela de tokens abaixo). - Cabeçalho (
cabecalho.arquivo.txt/cabecalhoArquivoTxt): linha inicial opcional inserida no topo do arquivo. - Conteúdo da linha (
conteudo.arquivo.txt/formatoConteudoArquivoTxt): máscara de formatação da linha gerada para cada produto.
Regra de seleção do código de barras
O writer prioriza os códigos de barras cadastrados com 13 ou mais dígitos. Quando configurado formato de linha, os dados são substituídos conforme os tokens informados.
Exemplo de arquivo gerado (etiqueta_txt_ean)
7891020304050;2
7894900011517;1
7891000123456;5
2. Exportação por SKU / Código Interno (etiqueta_txt_sku)
Utilizado quando o sistema de impressão ou ERP externo opera diretamente com a referência interna da loja (SKU).
Parâmetros de configuração
- Interface (
INTF_ETIQUETA_PRODUTO):etiqueta_txt_sku - Destino (
path.Etiqueta): diretório de saída do arquivo gerado. - Nome do arquivo: definido pelas propriedades de nome de arquivo de etiqueta.
Formato de saída
Cada linha do arquivo contém estritamente o código interno (SKU) do produto solicitado, sem delimitadores adicionais:
Exemplo de arquivo gerado (etiqueta_txt_sku)
102030
102031
102045
3. Customização do Nome do Arquivo TXT
A nomenclatura dos arquivos gerados pelo exportador de etiquetas (EtiquetaEANTXTWriter) é configurada no parâmetro etiquetaFormatoDoNomeDoArquivo (ou interface.nome.arquivo no config.ini).
O padrão de fábrica é:
${ID_LOJA}${LOJA_3}${USER}${D}${M}${Y}${H}${m}
Variáveis e Tokens de Nomenclatura Suportados
| Token | Descrição | Exemplo de Valor |
|---|---|---|
${ID_LOJA} | Código da loja convertido para o identificador do ERP (translateIdLojaFromRuBToERP). | 101 |
${USER} | Nome de login do operador solicitante. | operador1 |
${LOJA} | Nome / Razão social completa da loja filial. | HIPERMERCADO |
${LOJA_5} | Primeiros 5 caracteres do nome da loja. | HIPER |
${LOJA_3} | Primeiros 3 caracteres do nome da loja. | HIP |
${D} | Dia do mês com 2 dígitos (01 a 31). | 24 |
${M} | Mês com 2 dígitos (01 a 12). | 08 |
${Y} | Ano com 4 dígitos. | 2026 |
${H} | Hora do dia com 2 dígitos (00 a 23). | 18 |
${m} | Minuto com 2 dígitos (00 a 59). | 30 |
${S} | Segundo com 2 dígitos (00 a 59). | 45 |
${MS} | Milissegundo com 3 dígitos (000 a 999). | 123 |
Exemplos de máscaras customizadas:
etiquetas_${LOJA_3}_${Y}${M}${D}_${H}${m}->etiquetas_HIP_20260824_1830.txtETQ_${ID_LOJA}_${USER}_${Y}${M}${D}${H}${m}${S}->ETQ_101_operador1_20260824183045.txt
Resumo comparativo dos formatos TXT
| Característica | etiqueta_txt_ean | etiqueta_txt_sku | txt_etiqueta_consinco |
|---|---|---|---|
| Identificador principal | Código de Barras / EAN | Código Interno (SKU) | EAN formatado com 14 dígitos |
| Quantidade de itens | Suportada na linha | Não incluída (somente SKU) | Posições fixas no layout (ex: 00001) |
| Customização de linha | Suporta conteudo.arquivo.txt | Formato fixo (apenas SKU) | Formato fixo posicional de 25 caracteres |
| Customização de nome | Máscara via ${TOKEN} | Padrão TXT | <USUARIO>_<DATA_HORA>.txt / Máscara |
| Documentação específica | Esta página | Esta página | Integração Consinco |