Guia de Arquivos BALANÇA TOPMAX II TCP/IP - Wi-Fi (US MS/MD)
ESTRUTURA DE ARQUIVOS A balança opera com 4 tipos de arquivos, conforme abaixo. Arquivos recebidos pela balança: Arquivo gerado pela balança: Arquivo de Configuração da balança Configuracoes_usuario.txt Arquivo de Produtos Produtos.txt Arquivo de Layouts Layouts_usuario.txt Arquivo de Demandas e logs Demandas_usuario.txt Estes arquivos seguem uma formatação que deve ser seguida fielmente para que a balança entenda as informações contidas nos mesmos. Qualquer erro no formato dos arquivos do banco de dados faz com que a balança não imprima ou imprima erroneamente as informações na etiqueta. Por este motivo, aconselha-se que somente pessoas que tenham o completo entendimento da estrutura dos arquivos gere e edite os mesmos. O formato de cada tipo de arquivo segue abaixo. ARQUIVO DE CONFIGURAÇÕES DA BALANÇA Nomenclatura: Configuracoes_usuario.txt (onde usuario corresponde ao usuário de FTP da balança). Este arquivo é gerado pelo Software Urano Integra para fazer a configuração da balança, ele contém todas as informações necessárias para a configuração de uso da balança. ARQUIVO DE PRODUTOS Nomenclatura: Produtos.txt Este arquivo é gerado pelo Software Urano Integra, porém pode ser gerado por outro software de retaguarda caso necessário. Portanto, a estrutura deste arquivo é vista em detalhes neste manual. Formatação Cada produto exportado para a balança pode conter informações de pesagem, informações nutricionais e informações adicionais (também conhecida como receita). Dependendo de quais informações estão associadas a a cada produto, podemos ter até 3 montagens para o produto em questão. Para cada caso, existe uma formatação específica a ser seguida: Para o caso do produto conter apenas [Pesagem] [Inf. Adicionais] os 105 bytes da informação nutricional devem ser preenchidos com espaços. Os números descritos entre parênteses representam o número total de bytes que cada campo contém. Os campos que contém informações 0x são representações de números em hexadecimal. 2
Descrição dos itens Código do produto com 5 dígitos, alinhados a direita com preenchimento de zeros a esquerda. OBS: O tipo de produto pode ser preenchido com P para produtos pesáveis e Q para produtos de venda por unidade. Somatório dos bytes contidos em [Código] + [Pesagem] + [Inf. Nutricional] + [Inf. Adicionais]. O resultado deve ser de 16 bits (2 bytes) representada na forma de uma string de 4 chars. Exemplo: 0xA12F deve ser preenchido no arquivo como A12F. Montagem do Arquivo O nome do arquivo deve ser Produtos.txt. O arquivo deve conter os produtos ordenados de forma crescente conforme valor do código do produto. Cada produto listado deve seguir a formatação de acordo com as informações associadas a ele (pesagem, inf. Nutricional e inf adicionais). 3
Exemplo de arquivo: Produtos.txt ARQUIVO DE LAYOUTS Nomenclatura: Layouts_usuario.txt (onde usuario corresponde ao usuário de FTP da balança). A balança utiliza o arquivo de Layouts.txt para receber do servidor de FTP os layouts de impressão customizados. Este arquivo é gerado única e exclusivamente através do software Urano Integra, sendo assim, o formato deste arquivo não será abordado neste manual. ARQUIVO DE DEMANDAS Nomenclatura: Demanda_usuario.txt (onde usuario corresponde ao usuário de FTP da balança). A balança exporta os registros de operação e as impressões registradas em sua memória interna. O software Urano Integra importa este arquivo para seu banco de dados interno sendo possível gerar relatórios. Formatação O arquivo de demandas pode conter dois tipos de registros: de operação e de impressão. Os registros de operação são todas as ações feitas na balança que não são intrinsecamente uma impressão de etiqueta, tais como: Configuração manual da rede, Solicitação Manual de Carga, Horário da Balança Ligada, Carga Automática de Produtos, etc. Já os registros de impressão são as informações de pesagem quando disparada uma impressão. Os registros de ambas seguem a mesma formatação dentro do arquivo Demanda_usuário.txt, porém seu preenchimento é conforme seu tipo. Cada registro é composto por uma linha e prevê as seguintes informações: þ [Código da Demanda] þ [MAC Address] þ [Data] þ [Hora] þ [Código do Operador] þ [Código da Operação] þ [Descrição da Operação] þ [Código do Produto] þ [Peso/Qtd.] þ [Tara] þ [Total] Cada registro contido no arquivo de demanda possui a seguinte formatação: 4
Total = 101 bytes. Os números escritos entre parênteses representam o número total de bytes que cada campo contém. Os campos que contém informações 0x são representações de números em hexadecimal. 0x17 0x02 Cód. da Demanda (7) MAC Address (6) Data (10) Hora (8) Cód. do Operador (2) Cód. da Operação (2) Código do registro de demanda. Registro único por equipamento. Exemplo: 0 0 0 2 1 6 6 Endereço físico de rede da balança. Número único por equipamento. Exemplo: 5 0 1 8 F 4 Data do registro. Formato: DD/MM/AAAA. Exemplo: 2 5 / 1 0 / 2 0 1 0 Hora do registro. Formato: HH:MM:SS. Exemplo: 0 5 : 3 2 : 5 0 Código que representa o operador da balança. Exemplo: 0 4 Código que identifica a operação efetuada na balança. Exemplo: 3 7 0x20 Também representado em ASCII por espaço:. Descr. da Operação (27) Cód. do Produto (5) Peso/Qtd. (9) Tara (6) Total (9) Checksum (4) 0x03 0x0D 0x0A Campo para a descrição do código da operação. Exemplo: B a n a n a u r r a Código que identifica o produto. Exemplo: 0 0 5 6 9 Valor de peso ou quantidade da impressão. O preenchimento deste campo vai depender se o produto está cadastrado como venda por quilo ou venda por unidade. Na venda por quantidade, os 5 primeiros dígitos são utilizados para Exemplo: preencher quantidade. Na venda por quilo, os 7 últimos dígitos são utilizados para preencher o peso. Q t d. C a t 0 0 0 0 5. 0 0 0 Valor de tara utilizada na impressão. Exemplo: 0 0. 0 2 4 Valor do total a pagar da impressão. Este valor pode estar sendo representado com e sem centavos, dependendo da configuração da balança. Exemplo: Quando sem centavos, os primeiros 6 dígitos representam o Total. Quando com centavos, os últimos 7 dígitos representam o Total. É o somatório dos 92 bytes contidos em [Código da Demanda] + [MAC Address] + [Data] + [Hora] + [Código do Operador] + [Código da Operação] + [Descrição da Operação] + [Código do Produto] + [Peso/Qtd.] + [Tara] + [Total] Exemplo: O resultado deve ser de 16 bits (2 bytes) representada através de uma string de 4chars, ou seja, o valor 0xA12F deve ser preenchido como A12F. S / c e n t P e s o 0 0 0 3 6 7. 0 0 A 1 2 F C / c e n t 5
Registros de Operação Os registros de operação se caracterizam por possuir preenchimento zerado nos campos: [Código do Produto], [Peso/Qtd.], [Tara] e [Total]. Exemplo: 0x17 0x02 Cód. da Demanda (7) 0 0 0 2 1 6 6 MAC Address (6) 5 0 1 8 F 4 Data (10) 2 5 / 1 0 / 2 0 1 0 Hora (8) 0 5 : 3 2 : 5 0 Cód. do Operador (2) 0 4 Cód. da Operação (2) 3 7 0x20 Descr. da Operação (27) S o l i c i t a c a o M a n u a l d e C a r g a Cód. do Produto (5) 0 0 0 0 0 Peso/Qtd. (9) 0 0 0 0 0. 0 0 0 Tara (6) 0 0. 0 0 0 Total (9) 0 0 0 0 0 0. 0 0 Checksum (4) 0x03 0x0D 0x0A A 1 2 F Registros de Impressão Os registros de impressão se caracterizam por conter preenchidos [Código do Produto], [Peso/Qtd.], [Tara] e [Total]. No campo [Descrição da Operação] está a descrição do produto impresso. Exemplo: 0x17 0x02 Cód. da Demanda (7) 0 0 0 2 1 6 7 MAC Address (6) 5 0 1 8 F 4 Data (10) 2 5 / 1 0 / 2 0 1 0 Hora (8) 0 5 : 3 4 : 1 2 Cód. do Operador (2) 0 4 Cód. da Operação (2) 0 0 0x20 Descr. da Operação (27) B a n a n a C a t u r r a Cód. do Produto (5) 0 0 5 6 9 Peso/Qtd. (9) 0 0 0 5 0. 0 0 0 Tara (6) 0 0. 0 2 4 Total (9) 0 0 0 3 6 7. 0 0 Checksum (4) 0x03 0x0D 0x0A 5 4 C D 6