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çãoClasse do WriterDescrição
etiqueta_txt_eancom.gicbrasil.rub.etiqueta.intf.writer.EtiquetaEANTXTWriterExporta arquivo de texto priorizando o código de barras (EAN com 13 ou mais dígitos) e quantidade.
etiqueta_txt_skucom.gicbrasil.rub.etiqueta.intf.writer.EtiquetaSKUTXTWriterExporta 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 arquivo TXT será 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

TokenDescriçãoExemplo 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.txt
  • ETQ_${ID_LOJA}_${USER}_${Y}${M}${D}${H}${m}${S} -> ETQ_101_operador1_20260824183045.txt

Resumo comparativo dos formatos TXT

Característicaetiqueta_txt_eanetiqueta_txt_skutxt_etiqueta_consinco
Identificador principalCódigo de Barras / EANCódigo Interno (SKU)EAN formatado com 14 dígitos
Quantidade de itensSuportada na linhaNão incluída (somente SKU)Posições fixas no layout (ex: 00001)
Customização de linhaSuporta conteudo.arquivo.txtFormato fixo (apenas SKU)Formato fixo posicional de 25 caracteres
Customização de nomeMáscara via ${TOKEN}Padrão TXT<USUARIO>_<DATA_HORA>.txt / Máscara
Documentação específicaEsta páginaEsta páginaIntegração Consinco