Manual Do Usuario Ti Instalacao e Interface de Dados Guardian Versao 6 7 PDF

guardianPRO
guardianTI
guardianTAG
guardianEIXO Manual válido

para versão 6.7
guardian do Guardian.
Manual do Usuário - TI
INSTALAÇÃO E INTERFACE DE DADOS
www.toledobrasil.com.br
ÍNDICE GERAL
1. INSTALAÇÃO .................................................................................................................... 4
2. COMPOSIÇÃO DO SISTEMA .......................................................................................... 16

Controle de Licenças ...................................................................................................................................................... 16
3. REQUISITOS E CARACTERÍSTICAS ............................................................................. 17

Requisitos mínimos do sistema ...................................................................................................................................... 17
Requisitos de Instalação do SQL ................................................................................................................................... 18
Crescimento do banco de dados do Guardian ............................................................................................................. 18
Crescimento de arquivos de Foto do Guardian ........................................................................................................... 18
Tamanho dos arquivos texto de Importação e exportação ......................................................................................... 18
Portas de comunicação necessárias para os serviços Guardian: ................................................................................ 18
4. INTEGRAÇÃO DE DADOS .............................................................................................. 19

WEB SERVICE GUARDIAN (WS) ............................................................................................................................. 19
4.1.1 WEB METODOS ..................................................................................................................................................... 19
4.1.2 ESTRUTURAS E TABELAS .................................................................................................................................. 20
4.1.3 WEB METODOS - DETALHAMENTO ................................................................................................................. 33
ARQUIVO TEXTO E BANCO TANQUE ................................................................................................................... 48

4.2.1 Instalação ......................................................................................................................................................................... 48
4.2.2 Configuração no MIE ...................................................................................................................................................... 48
4.2.3 Configuração no Guardian .............................................................................................................................................. 49
ARQUIVO TEXTO ........................................................................................................................................................ 50

Visão Geral............................................................................................................................................................................... 50
Funcionamento Exportação ...................................................................................................................................................... 50
Arquivo de exportação ............................................................................................................................................................. 50
Exemplo ................................................................................................................................................................................... 51
Exportação................................................................................................................................................................................ 51
Funcionamento Importação ...................................................................................................................................................... 54
Funcionamento Alteração do Ticket ........................................................................................................................................ 54
Arquivo de Importação ............................................................................................................................................................. 55
Exemplo: .................................................................................................................................................................................. 56
Dados Importação .................................................................................................................................................................... 56
BANCO TANQUE ......................................................................................................................................................... 59

Tabelas de importação .............................................................................................................................................................. 59
Tabelas de exportação .............................................................................................................................................................. 59
Funcionamento da Importação ................................................................................................................................................. 60
Funcionamento Alteração do Ticket ........................................................................................................................................ 60
Atualização Código do Ticket no Banco Tanque (a partir da versão 6.6.78) .......................................................................... 61
Estrutura das Tabelas................................................................................................................................................................ 62
Funcionamento da Exportação ................................................................................................................................................. 64
Estrutura das Tabelas................................................................................................................................................................ 65
2
Limpeza .................................................................................................................................................................................... 68
5. SERVIÇOS DE APOIO AO CLIENTE .............................................................................. 70
3
1. INSTALAÇÃO
A instalação deve ser feita por técnico habilitado Toledo.
Deve ser executado o programa InstalaçãoGuardian. Não pode existir outra instalação do Guardian no
computador.
Caso exista Guardian instalado no computador e seja versão 6.7 inferior à que será instalada, deve ser executado
o programa UpdateGuardian.
A tela do Assistente para Instalação do Guardian será aberta.
Selecione Português nesta tela e clique em OK.
Clique em Próximo nestas telas
4
Selecione o item a ser instalado e clique em Próximo.
Sendo que:
 GTT - Marcar esta opção para instalar o aplicativo GTT responsável por Backup e Restore.
 Servidor de Hardkey – Marcar esta opção se o Servidor de Hardkey for local. Caso não for não marcar,
porém deverá ser informado o IP do computador que possui o Servidor de Hardkey no Assistente de
inicialização, após a instalação.
 MIE – Marcar esta opção se houver integração de dados por arquivo texto ou banco de dados.
 SQL Server – Marcar esta opção quando for instalar a versão do SQL Express que acompanha o
instalador do Guardian. Normalmente instalado em aplicações onde o cliente não possui Servidor SQL.
5
Clique em Próximo nestas telas
Instalação do Servidor de hardkey
Clique em Avançar.
Selecione a pasta de instalação e Avançar nas próximas telas.
6
Instalação do SQL Server
7
Instalação do GTT
Clique em Avançar nas próximas telas.
8
Instalação do MIE
Clique em Continuar e/ou Próximo nas próximas telas.
9
Clique em Finalizar.
Após concluir a instalação das opções selecionadas no pacote de instalação do Guardian, execute o programa
Guardian.
Usuário: Administrador
Senha: Administrador
Clique em OK.
Será aberta a tela do Assistente de Inicialização do Guardian. Clicar em Próximo.
10
Clique em Configurar.
Na tela de Configuração do Banco de Dados Guardian, efetuar as configurações destacadas abaixo:
O instalador do Guardian cria uma

instância SQL durante a instalação do
programa, nomeada SQLEXPRESS.
O ponto faz referência ao computador

local e pode ser substituído pelo nome do
computador.
Selecionar esta opção para criar o

banco. Será sugerido o nome
GUARDIAN.
Em seguida configure o servidor de hardkey.
Selecionar a opção Registrar nova Hardkey e clicar no botão Próximo.
11
Colocar a Hardkey na porta USB do no computador e clicar em Próximo.
Após concluir a instalação do servidor de Hardkey, clicar em Terminar.
12
Em seguida será exibida a tela de Configuração do Banco de Dados de Contingência. Clicar em Próximo até ser
exibida a tela de Configuração do Servidor de Hardkey.
Confirmar as informações abaixo e clique em em Próximo.
13
Configurar o IP da estação de controle, no caso, o IP do computador onde o Guardian foi instalado. Para confirmar
o IP basta clicar no botão ao lado do campo Endereço IP da estação de Controle e visualizar a tela de IP. Clicar
em próximo e, em seguida, em Concluir.
Em seguida, clicar em Concluir.
14
Clique em Install nesta tela.
Clique em Close nesta tela.
Após a conclusão da instalação será necessário executar o “Guardian Configuração” e configurar os cenários
desejados. Após este processo o “Guardian Operação” estará pronto para ser executado e utilizado.
Usuário: Administrador
Senha: Administrador
15
2. COMPOSIÇÃO DO SISTEMA
A solução Guardian está distribuída em cinco aplicativos, com diferentes responsabilidades, que irão auxiliar na
configuração e operação do ambiente:
APLICATIVO RESPONSABILIDADE
Assistente que irá auxiliar na inicialização da aplicação, permitindo a
Assistente de Inicialização do
instalação e configuração do Banco de Dados SQL, Módulo de
Guardian
Importação e Exportação (MIE) e Servidor de Hardkey.
Configurações relacionadas à Permissão, Usuários, Periféricos,

Estações de Controle, Pontos de Controle, Operações, Fluxos, Cenários,
Guardian Configuração
Cálculos, etc. que serão realizadas no ambiente.
Operação do programa propriamente dito, com opções de cadastro de

itens, embalagens, motoristas, transportadores, emissores, bem como
Guardian Operação execução das operações de pesagem, importação e exportação de
dados e emissão de relatórios.
Serviço responsável pelo controle das operações sem intervenção

Guardian Service humana e de todos os periféricos cadastrados na solução.
Serviço responsável pelo controle das operações do banco de

contingência. Esse serviço tem por objetivo manter a operação do
Serviço de Contingência Guardian em caso de falha de rede no acesso ao banco de dados
central.
Além destes aplicativos, outros aplicativos de suporte estão integrados à solução:
APLICATIVO RESPONSABILIDADE
Servidor de Hardkey Controle de licença centralizado.
Importação e exportação de arquivos texto.

* MIE
*Será ativado/configurado somente quando houver integração de dados TXT ou BT
Aplicativo responsável por realizar a atualização do sistema.

MAT
Gerenciador de tarefas de backup e outros.
GTT
Controle de Licenças
O software Guardian tem seu controle de licenças feito por hardkey.
É necessária 1 licença para cada Estação de Controle (computador), 1 para cada MCA e 1 para cada MCD que for
configurado no sistema.
Todas as licenças do sistema são gravadas em uma única hardkey.
16
3. REQUISITOS E CARACTERÍSTICAS
Requisitos mínimos do sistema
Microcomputador exclusivo
Um (01) para cada ponto de controle onde seja necessária intervenção humana (operador).
Um (01) para configuração e manutenção do sistema, e pode ser o mesmo utilizado no ponto de controle.
O microcomputador deve ser de uso exclusivo do Guardian quando estiver controlando a automação.
O Guardian pode ser instalado em conjunto com outras aplicações quando o microcomputador for utilizado
exclusivamente para pré-cadastro, cadastros, consultas e configurações.
Nota: o Guardian é homologado num ambiente controlado, com a mínima quantidade de softwares instalados,
e qualquer combinação com outros aplicativos pode causar instabilidade no sistema e até mesmo a sua parada
total.
Servidor exclusivo para banco de dados

Obrigatório para aplicações com mais de 03 pontos de controle ou, acima de 200 pesagens/dia ou, operações
contínuas sem paradas (24 horas x 7 dias), ou operações que necessitam de alta disponibilidade.
Nota 1: Alta disponibilidade é a garantia que o servidor, controle de automação e banco dados estejam sempre
disponíveis, de forma ininterrupta, para todos os serviços e recursos utilizados pelo sistema por meio do uso da
redundância, e neste caso o cliente deve contratar serviço especializado para projetar a arquitetura com eventual
redundância de servidores.
Nota 2: Para operações críticas em 24x7 ou alta disponibilidade, prever contingências no servidor como
configuração de Raid de HD, sistemas automáticos de back-up, troca de equipamentos energizados (Hot swap) e
outras.
Nota 3: Quando houver fornecimento de OCR, este deverá ser instalado em um servidor dedicado e exclusivo.
Requisitos mínimos para o Microcomputador e o Servidor:
17
Os requisitos são considerados mínimos para o correto funcionamento do Guardian. Porém, antes de mais nada,
deve-se respeitar os requisitos mínimos necessários para o Sistema Operacional e Banco de Dados. O Sistema
Operacional e Banco de Dados devem estar sempre atualizados com todos os Services Packs possíveis.
Requisitos de Instalação do SQL

O Collation da Instância de SQL que o Guardian irá utilizar deve ser: Latin1_General_CI_AI.
O usuário do banco SQL que o Guardian irá utilizar para se conectar deve ter no mínimo as seguintes permissões:
 Incluir, excluir e alterar registros em todas as tabelas do Banco.
 Modificar Schema do Banco.
 Acesso a todas a procedures, functions e view do Banco.
Crescimento do banco de dados do Guardian

Tamanho do arquivo que trafega na rede (pesagem inicial e pesagem final): em torno de 1Kbyte por operação
realizada.
As fotos dos caminhões ficam armazenadas em pastas específicas da rede e não no banco de dados. Caso não
seja determinado um nome para a foto, será gerado um nome padrão composto por, placa, código, operação, data,
hora e posição da câmera.
Cálculo do crescimento anual do banco de dados, considerando 2.000 pesagens em regime 24 (horas) x 7 (dias):
 2.000 pesagens são referentes a 1.000 caminhões fazendo Pesagem Inicial e Pesagem Final.
 Crescimento anual: 2000*1KB*30*12=720.000Kbytes = 703,2MBytes
Crescimento de arquivos de Foto do Guardian

Crescimento anual de arquivos de foto em pasta (Files Server) considerando a mesma situação de utilizada para
cálculo do crescimento do banco de dados: 2000*25KB*2*30*12=36.000.000 Kbytes ~= 34GBytes
Tamanho dos arquivos texto de Importação e exportação

O tamanho médio de um arquivo texto de importação ou exportação é de 1Kbyte, porém esse valor pode variar em
função dos dados utilizados no Guardian e da quantidade de operações executadas.
Portas de comunicação necessárias para os serviços Guardian:
18
4. INTEGRAÇÃO DE DADOS
Recurso/funcionalidade Guardian Guardian Guardian Guardian Guardian
EIXO TAG TI PRO
INTEGRAÇÃO DE DADOS  
WEB SERVICE GUARDIAN (WS)

(Versão 6.7.120)

EIXO TAG TI PRO
WEB SERVICE  
Web Service responsável pela interface entre o Guardian e um Sistema de Retaguarda, Legado ou
ERP.
Por isso os Web Metodos que podem ser utilizados nas Integrações entre sistemas estarão indicados
nessa documentação com a Tag [INTERFACE].
Atenção!!!
Os Web Métodos indicados com a Tag [OBSOLETOS], preferencialmente, não deve ser utilizado
pois estão disponíveis apenas para compatibilização com versões anteriores do Guardian.
Todas as datas, com campos ou parâmetros no formato DATA E HORA estão sendo trafegadas no
seguinte formato: YYYY-MM-DDTHH:mm:SS que é padrão do .Net exemplo: 2012-01-
14T15:58:00.
Todas as datas, com campos ou parâmetros no formato STRING estão sendo trafegadas no
seguinte formato: DD/MM/YYYY HH:mm:SS.
Antes de executar as funções abaixo, configure a conexão com o banco de dados através do
programa CFG_WS_GUARDIAN.EXE, que se encontra na pasta bin do diretório virtual do
WS_GUARDIAN_PLUS
4.1.1 WEB METODOS
Método Status
AcionaCancela Disponível
AcionaCancela_G4 Obsoleto
AlteraTicketGuardian Disponível
CadastraTicket Obsoleto
CadastraTicketGuardian Disponível
CapturaPeso Disponível
CapturaPeso_G4 Obsoleto
ConfirmaLeituraTicketsMarcados Disponível
ConfirmaTicketUnico Disponível
ConfirmaVeiculosQuePossamTerPassadoSemPesarPelaBalanca Disponível
ConsultaIntervencoesManuaisTicket * Disponível
ConsultaLogAplicacao Disponível
ConsultaLogPerifericos Disponível
ConsultaMovimentoOCR Disponível
ConsultaPedidoDeExecucao Disponível
ConsultarLogAuditoria Disponível
ConsultaTicketsPorPeriodo Disponível
19
DadosDoTicket_G4 Obsoleto
EnviaMensagemDisplay Disponível
EnviaMensagem_G4 Obsoleto
ExportaTicketParametro Disponível
ExportaTicketPeriodo Obsoleto
ExportaTicketUnico Disponível
ExportaTicketsMarcados Disponível
ExportaVeiculosQuePossamTerPassadoSemPesarPelaBalanca Disponível
IdentificaVagao Obsoleto
IdentificaVeiculoNoPonto Disponível
ImportaTicketPreCadastro Obsoleto
ManutencaoTicket Disponível
ObtemVersaoWS Disponível
RefazUltimaOperacao Disponível
RetornaVeiculosQuePossamTerPassadoSemPesarPelaBalanca Disponível
SimulaPesagemAvulsaSemAutomacao Disponível
TrocaFluxoTicket Disponível
SolicitaFotoAvulsa Disponível
SolicitaRetornoFotoAvulsa Disponível
* Métodos em desenvolvimento não utilizar
4.1.2 ESTRUTURAS E TABELAS
VO PreCadastro
Valores
Campo Tipo Obrigatório Descrição
Possíveis
Quando Verdadeira
Indica que o resultado
do Peso Líquido na Valor padrão:
AceitaPesoLiquidoZero Booleano NÃO
Pesagem Final pode Verdadeiro(True)
ser 0 para esse
veículo
PesoAlvo Decimal NÃO Peso Alvo da Dosagem -
Peso para Corte da
Corte Decimal NÃO -
Dosagem
Peso de início da
DosagemLenta Decimal NÃO -
dosagem lenta
Preencher sempre
DataPesagem Data e Hora SIM NÃO UTILIZADO com uma Data e
Hora qualquer
Documentos
Documentos Lista de VO Documento NÃO -
associados
Dados do Emissor
Emissor VO EmissorIntegracao NÃO -
associado
Lista de VO NÃO UTILIZAR - Em
FatoresCorrecao NÃO -
ListaFatoresCorrecaoTicket manutenção
Código do Fluxo
Fluxo String(50) NÃO -
Associado
20
Lista de VO
Item NÃO Itens associados -
ItemIntegracao
Motorista VO MotoristaIntegracao NÃO Motorista associado -
Observacao String(8000) NÃO Observação -
PesoBruto Decimal NÃO Peso bruto do veículo. -
Tara Decimal NÃO Tara do veículo. -
Peso de referência
para checagem do
PesoBrutoOrigem Decimal NÃO -
peso total na primeira
pesagem do veículo
PesoMinimoOrigem Decimal NÃO Peso mínimo origem -
PesoMaximoOrigem Decimal NÃO Peso máximo origem -
Peso de origem total -
Soma de todos os
PesoTotalOrigem Decimal NÃO documentos -
adicionados à lista de
documentos do ticket
Armazena a
identificação da
PlacaCarreta String(20) SIM -
carreta e do vagão,
quando aplicável
Armazena a
identificação do Valor padrão:
PlacaVeiculo String(20) NÃO
veículo e do vagão, PlacaCarreta
quando aplicável
Identificação
associada referente ao
TagAssociado String(250) NÃO -
TAG, Transponder ou
Código de Barras
NÃO UTILIZAR - Em
TipoDoFatorDeCorrecao Inteiro NÃO -
manutenção
TipoVeiculo String(20) NÃO Tipo do Veículo -
Dados da
VO
Transportadora NÃO Transportadora -
TransportadoraIntegracao
associada
Unidade de Medida
UnidadeAposConversao String(10) NÃO Após Conversão do -
Peso
Lista de VO Campos adicionais do
CamposAdicionais NÃO -
CampoAdicionalTicket Ticket
Operação a ser
registrada como
pesagem inicial.
Obrigatório quando for
OperacaoDaPesagemInicial String NÃO informar peso da -
pesagem inicial.
Equivale ao campo
código da tela de
operação
Balança ou MCA
(mesmo que inativos)
a ser registrado como
PerifericoDaPesagemInicial String NÃO -
utilizado na pesagem
inicial. Obrigatório
quando for informar
21
peso da pesagem
inicial. Equivale ao
campo código da tela
de periféricos
Peso da Pesagem
Inicial. Quando
PesoDaPesagemInicial Decimal NÃO informado o peso -
obrigatoriamente deve
ser maior que 0 (zero)
Data e Hora da
DataDaPesagemInicial Data e Hora NÃO -
Pesagem Inicial
EmbalagensTicket Lista de EmbalagensTicket NÃO Embalagens do ticket -
VO EmissorIntegracao
Campo Tipo Obrigatório Descrição Valores Possíveis
Sequencial Inteiro NÃO NÃO UTILIZADO -
Codigo String(20) SIM Código do Emissor -
Descrição ou Nome do
Descricao String(50) SIM -
Emissor
519 = Fornecedor, 520 = Cliente,
TipoEmissor Inteiro SIM Tipo do Emissor
521 = Outros
RazaoSocial String(50) NÃO Razão Social do Emissor -
Cnpj String(30) NÃO CNPJ ou CPF -
InscricaoEstadual String(30) NÃO Inscrição Estadual -
Endereco String(50) NÃO Endereço -
Complemento String(30) NÃO Complemento -
Municipio String(30) NÃO Município -
Unidade Federativa ou
UF String(4) SIM -
Estado da União
Cep String(10) NÃO CEP -
Telefone String(20) NÃO Telefone -
Email String(50) NÃO Endereço de E-mail -
0=Desativado, 1=Ativado(Valor
Estado Inteiro NÃO Estado do Emissor
Padrão)
Tipo do Documento para
TipoDocumento Inteiro SIM pessoa física (CPF) ou 303404 = Física, 303405 = Jurídica
jurídica (CNPJ)
Indica que os dados
Sem preenchido Falso (False) o
passados podem ser
IncluiAtualiza Booleano SIM sistema não vai incluir o Ticket se o
incluídos ou alterados no
emissor não estiver cadastrado
cadastro
VO ItemIntegracao
Codigo String(20) SIM Código do Item -
Descricao String(50) NÃO NÃO UTILIZADO -
Nome String(50) SIM Nome do Item -
22
Informações sobre o
Informacao String(400) NÃO -
item
Se não utilizado preencher
PesoUnitario Decimal SIM Peso Unitário
com 0
UnidadeMedida String(10) NÃO Unidade de Medida -
Se Verdadeiro (true),
habilita da conversão
PodeConverter Booleano SIM -
de peso para esse
item
Se não utilizado preencher
FatorConversao Decimal SIM Fator de Conversão
com 0
Unidade de Medida
UnidadeMedidaConversao String(10) NÃO -
após a Conversão
UtilizaContador Booleano NÃO NÃO UTILIZADO -
Valor Inicial do
InicioContador Inteiro NÃO -
Contador
Valor final do
contador, ao atingir
FinalContador Inteiro NÃO esse valor o contador -
volta para o valor
inicial
PrefixoContador Inteiro NÃO Prefixo do Contador 0 = Dia, 2 = Mês, 3 = Ano
Código do Fator de
CodigoFatorCorrecao String(20) NÃO -
Correção associado
Código do Fluxo
CodigoFluxo String(50) NÃO -
exclusivo do item
Se verdadeiro (true)
indica que os tickets
InicialObrigatoria Booleano SIM que utilizam esse -
item devem fazer
pesagem inicial
Quantidade máxima
QuantidadeViasRelatorioImpressas Inteiro SIM 0 = Indefinido
de vias do ticket
0=Desativado,
Estado Inteiro NÃO Estado do Item
1=Ativado(Valor Padrão)
Indica que os dados Sem preenchido Falso
passados podem ser (False) o sistema não vai
IncluiAtualiza Booleano SIM
incluídos ou alterados incluir o Ticket se o item
no cadastro não estiver cadastrado
1760=Matéria-Prima,
1761=Produto
Indica qual é o tipo Industrializado,
Tipo Inteiro NÃO
de item 1762=Produto
Manufaturado,
1763=Outro tipo de item
VO MotoristaIntegracao
Codigo String(20) SIM Código do Motorista -
Descricao String(50) NÃO NÃO UTILIZADO -
Nome String(50) SIM Nome do Item -
23
Deixar vazio caso o motorista seja
CPF String(20) NÃO CPF
estrangeiro
RG String(20) NÃO RG -
Cnh String(20) NÃO CNH -
0=Desativado, 1=Ativado(Valor
Estado Inteiro NÃO Estado do Motorista
Padrão)
Informação dos
InfoAcompanhantes String(255) NÃO -
Acompanhantes
Informe a descrição do País de origem,
se NÃO informado, Brasil é assumido
como padrão. O idioma no qual o País é
Nacionalidade String(50) NÃO Nacionalidade
informado deve ser a mesma
configurada no Guardian (português é
padrão).
DataNascimento Date NÃO Data de Nascimento -
Preencher este campo para que o
DocEstrangeiro String NÃO Documento Estrangeiro motorista seja identificado como
estrangeiro no cadastro de motoristas.
Indica que os dados
Sem preenchido Falso (False) o sistema
passados podem ser
IncluiAtualiza Booleano SIM não vai incluir o Ticket se o motorista
incluídos ou alterados
não estiver cadastrado
no cadastro
VO TransportadoraIntegracao
Codigo String(20) SIM Código da Transportadora -
Descrição ou Nome da
Descricao String(50) SIM -
Transportadora
Razão Social da
RazaoSocial String(50) SIM -
Transportadora
Cnpj String(30) NÃO CNPJ ou CPF -
InscricaoEstadual String(30) NÃO Inscrição Estadual -
Endereco String(50) NÃO Endereço -
Complemento String(30) NÃO Complemento -
Municipio String(30) NÃO Município -
Unidade Federativa ou Estado
UF String(4) NÃO -
da União
Cep String(10) NÃO CEP -
Telefone String(20) NÃO Telefone -
Email String(50) NÃO Endereço de E-mail -
0=Desativado, 1=Ativado (Valor
Estado Inteiro NÃO Estado da Transportadora
Padrão)
Tipo do Documento para
0 = Física( Valor Padrão), 1 =
TipoDocumento Inteiro NÃO pessoa física (CPF) ou
Jurídica
jurídica (CNPJ)
Indica que os dados passados
Sem preenchido Falso (False) o
IncluiAtualiza Booleano SIM podem ser incluídos ou
sistema não vai incluir o Ticket se a
alterados no cadastro
24
Transportadora não estiver
cadastrada
VO TICKET
Valores
Possíveis
Chave interna do
Fator de
CalculoFatorCorrecao Inteiro Sim -
Correção
Associado
Campos
Lista de VO adicionais de
CamposAdicionais Sim -
CampoAdicionalTicket preenchimento
livre do Ticket
Código ou
Codigo String(30) Sim -
Número do Ticket
Código do Fator
CodigoCalculoFatorCorrecao Inteiro Sim de Correção -
Associado
Código do
CodigoEmissor String(20) Sim Emissor -
Associado
Código do Fluxo
CodigoFluxoTicket String(50) Sim -
Associado
Código da
CodigoTransportadora String(20) Sim Transportadora -
Associada
Data de Abertura
DataPesagem Data e Hora Sim -
do Ticket
Documentos
Documentos Lista de VO Documento Sim -
associados
Lista de VO Embalagens
EmbalagensTicket Sim -
EmbalagensTicket associadas
Dados do
Emissor VO EEmissor Sim Emissor -
associado
CadastroVeiculo = 0,
PreCadastro = 1,
Pesagem Inicial = 2,
Encerrado = 3,
Aguardando Liberação
= 4, PesagemFinal =
5, Cancelado = 6,
Estado Inteiro Sim Estados do Ticket
Acesso Veiculo = 7,
Pesagem Avulsa = 8,
Verificação = 9,
Bloqueado = 10,
Pesagem Eixos = 11,
Pesagem Dosagem =
12
Próximo estado
do Ticket quando
Mesmo valores do
EstadoAguardando Inteiro Sim aguardando
campo estado
liberação da
Integração
25
Fatores de
Lista de VO
FatoresCorrecao Sim correção -
ListaFatoresCorrecaoTicket
associados
Chave do fluxo
FluxoTicket Inteiro Não do Ticket interna -
do Guardian
Lista de VO NÃO UTILIZAR!
FluxoTicketSequencia Sim -
FluxoTicketSequencia Em manutenção!
Item VO EItem Não NÃO UTILIZADO -
ItemTicket Lista de VO ItemTicket Sim Itens associados -
Observacao String(8000) Não Observação -
Lista de VO Operações
OperacaoTicket Sim -
OperacaoTicket realizadas
Caso Verdadeiro
(true) indica que
PesagemEmContingencia Booleano Sim -
houve pesagem
em contingência
Caso Verdadeiro
(true) indica que
PesagemManual Booleano Sim -
houve pesagem
manual
Placa da
PlacaCarreta String(20) Sim -
carreta/vagão
Registro de
Reimpressões do
Lista de VO
ReimpressaoTicket Sim Ticket (somente -
ReimpressoesTicket
reimpressões
sem vizualização)
Chave primária
interna de
Sequencial Inteiro de 64 bits Sim -
controle do
Guardian
Número
SequencialDiario Inteiro Sim sequencial diário -
do ticket
Identificação
associada
referente ao
TagAssociado String(250) Sim -
TAG,
Transponder ou
Código de Barras
NÃO
TipoFatorCorrecao Inteiro Sim -
IMPLEMENTADO
Tipo de operação
realizada,
Recebimento = 1,
TipoOperacao Inteiro Sim preenchido
Expedição = 2
somente após a
pesagem final
Dados da
Transportadora VO ETransportadora Sim Transportadora -
associada
Interações
Lista de VO
IntegracoesOCR Sim realizadas com o -
IntegracoesOCR
OCR
Sincronizado bool Sim Sincronizado -
26
Diferença de
DiferencaOrigem decimal Sim -
origem.
Informa se
BloqueiaBotoeira bool Sim bloqueia a -
botoeira.
Informa se é
PesagemFerroviaria bool Sim uma pesagem -
ferroviária.
VO CampoAdicionalTicket
Valores
Possíveis
Numero Inteiro SIM Número do Campo Adicional -
Valor String(50) SIM Valor do campo adicional -
Data Data e Hora SIM Data da criação do Registro -
Codigo Inteiro SIM Mesmo valor do campo Número -
VO Documento
Data e
Data SIM Data da criação do Registro -
Hora
Código sequencial do documento no
Codigo Inteiro NÃO -
Ticket
Descricão String(255) SIM Descrição ou número do documento -
0=Desativado,
Estado Inteiro SIM Estado do documento
1=Ativado
PesoOrigem Decimal SIM Peso do Documento -
PesagemRealizada Boolean SIM Pesagem Realizada -
Tolerancia Double Não Tolerância -
VO EmbalagensTicket
Valores
Possíveis
Sequencial Inteiro Não Chave interna de controle do Guardian -
Quantidade Decimal Sim Quantidade de Embalagens -
Peso Decimal Sim Peso total das embalagens -
Data e
Data Sim Data da criação do Registro -
Hora
Codigo String Sim Código sequencial da embalagem no Ticket -
CodigoItem String(20) Sim Código da embalagem -
Sequencial do Item. Não é preenchido na
SequencialItem Int Não -
importação.
SequencialTck Int Não Chave interna da embalagem do ticket -
Código do ticket. Não é preenchido na
CodigoTck Int Não -
importação.
VO EEmissor
27
Valores
Possíveis
Chave interna de controle do
Sequencial Inteiro Não -
Guardian
Codigo String(20) Não Código do Emissor -
Descricao String(50) Sim Descrição ou Nome do Emissor -
Tipo Inteiro Sim Chave interna do tipo do Emissor -
RazaoSocial String(50) Sim Razão Social do Emissor -
Cnpj String(30) Não CNPJ ou CPF -
InscricaoEstadual String(30) Não Inscrição Estadual -
Endereco String(50) Não Endereço -
Complemento String(30) Não Complemento -
Municipio String Não Município -
Chave internada da Unidade
UF Inteiro Não -
Federativa ou Estado da União
Cep String(10) Não CEP -
Telefone String(20) Não Telefone -
Data Data e Hora Não Data e Hora da criação do registro -
Email String(50) Não Endereço de E-mail -
Lista de VO Transportadoras associadas ao
Transportadoras Não -
ETransportadora Emissor
0=Desativado,
Estado String Não Estado do Emissor
1=Ativado
Tipo do Documento para pessoa 0 = Física, 1 =
TipoDocumento String Não
física (CPF) ou jurídica (CNPJ) Jurídica
VO ETransportadora
Valores
Possíveis
Sequencial Inteiro Não Chave interna de controle do Guardian -
Codigo String(20) Não Código da Transportadora -
Descricao String(50) Sim Descrição ou Nome da Transportadora -
RazaoSocial String(50) Sim Razão Social da Transportadora -
Cnpj String(30) Não CNPJ ou CPF -
InscricaoEstadual String(30) Não Inscrição Estadual -
Endereco String(50) Não Endereço -
Complemento String(30) Não Complemento -
Municipio String(30) Não Município -
Chave internada da Unidade Federativa ou
UF Inteiro Não -
Estado da União
Cep String(10) Não CEP -
Telefone String(20) Não Telefone -
Data e
Data Não Data e Hora da criação do registro -
Hora
Email String(50) Não Endereço de E-mail -
28
0=Desativado,
Estado String Não Estado do Emissor
1=Ativado
Tipo do Documento para pessoa física (CPF) 0 = Física, 1 =
TipoDocumento String Não
ou jurídica (CNPJ) Jurídica
VO ItemTicket
Chave interna de controle do
Guardian
Codigo String Não Código sequencial do Item no Ticket -
Inteiro de 64
SequencialTck Sim Chave interna do Ticket -
bits
CodigoTck String(30) Não Código ou número do Ticket -
SequencialItm Inteiro Não Chave interna do Item -
CodigoItm String(20) Não Código do Item -
Data Data e Hora Sim Data e Hora da criação do registro -
0=Desativado,
Estado String Não Estado do Item no Ticket
1=Ativado
Sequencial que representa o ID do
SequencialLot String(50) Sim -
lote
VO ListaFatoresCorrecaoTicket
Numero Inteiro Sim Numero da Lista de Fator de Correção -
Fator Decimal Sim Valor do Fator de Correção -
Descricao String(50) Sim Descrição do Fator de Correção -
Faixa máxima de Peso para Aplicação do
ValorMaximo Decimal Sim -
Fator
Faixa Mínima de Peso para Aplicação do
ValorMinimo Decimal Sim -
Fator
Data e
Data Sim Data da Criação do Registro -
Hora
0=Desativado,
Estado String Sim Estado do Fator
1=Ativado
Codigo String(20) Não Código da Lista de Fator de Correção -
CodigoItem String(20) Não Código do Item associado ao Fator -
VO OperacaoTicket
Código sequencial da
Codigo String(20) Sim operação executada no -
Ticket
TicketSequencial String(20) Sim Chave interna do Ticket -
PlacaVeiculo String(20) Sim Placa do Veículo -
VO
Motorista Sim Dados do Motorista -
EMotorista
Unidade de Medida Após
UnidadeAposConversao String(10) Sim -
Conversão do Peso
29
TipoVeiculo String(20) Sim Tipo do Veículo -
OBSOLETO - Não
Eixo Inteiro Sim -
utilizado
Número do
Compartimento referente
Compartimento Inteiro Sim -
a esse registro de
pesagem
Valor do fator correção
obtido a partir da lista de
FatorCorrecaoLista Decimal Sim -
fatores de correção da
lista
Valor do fator correção
FatorCorrecaoCalculo Decimal Sim obtido a partir da -
expressão calculada
Peso Decimal Sim Peso Capturado em kg -
Representa o peso total
TaraTotal Decimal Sim das embalagens vazias -
em kg (Tara do Veículo)
FatorConversao Decimal Sim Fator de Conversão -
Representa o peso líquido
PesoLiqObtido Decimal Sim obtido após a pesagem -
final em kg
PesoLiqCorrigido Decimal Sim corrigido após a pesagem -
final em kg
corrigido pela fórmula
PesoLiqCorrigidoCalculo Decimal Sim -
após a pesagem final em
kg
convertido, apresentado
PesoLiqConvertido Decimal Sim o fator e unidade após -
conversão após a
pesagem final em kg
Valor do peso bruto do
PesoBrutoVeiculo Decimal Sim veículo que registrou a -
pesagem
Login do Usuário que
UsuarioLogin String(20) Sim -
registrou a operação
Data de execução da
DataPesagem Data e Hora Sim -
Operação
Chave interna do
Periferico Inteiro Sim periférico que executou -
essa operação
Código do Periférico que
PerifericoCodigo String(20) Sim -
executou essa operação
Código do Ponto de
PontoDeControle String(20) Sim Controle que executou a -
operação
Código da Estação de
EstacaoControle String(20) Sim Controle que executou a -
operação
1 = Pré-Cadastro, 2 =
Tipo da Operação Pesagem Inicial, 3 = Pesagem
TipoOperacaoCodigo Inteiro Sim
executada Final, 4 = Hsitórico de
Passagem, 5 = Acesso, 8 =
30
Pesagem Avulsa, 10 =
Atualização de Tara, 11 =
Pesagem por Eixos, 12 =
Dosagem
Descrição do Tipo da
TipoOperacaoDescricao String(1024) Sim -
Operação
OperacaoCodigo String(20) Sim Código da Operação -
Estado Inteiro Sim 1 - Ativa / 0 - Inativa Estado da operação do ticket -
VO Motorista
Valores
Possíveis
Chave interna de controle
do Guardian
Codigo String(20) Não Código da Motorista -
CPF String(20) Sim CPF -
RG String(20) Não RG -
Nome String(50) Sim Nome -
Cnh String(20) Não CNH -
0=Desativado,
Estado String Não Estado do Motorista
1=Ativado
Data e Hora da criação do
Data Data e Hora Não -
registro
Informação dos
InfoAcompanhantes String(255) Não -
Acompanhantes
Array de Arquivo de Foto do
Foto Não -
Bytes(2.147.483.647 bytes) Motorista
Nacionalidade String(50) Não Nacionalidade -
DataNascimento Date Não Data de Nascimento -
Arquivos Lista de VO EArquivos Não NÃO UTILIZADO -
VO ReimpressoesTicket
Codigo String(10) Sim Código Sequencial da Reimpressão do Ticket -
Data Data e Hora Sim Data e Hora da Reimpressão -
Observacao String(255) Não Observação sobre o motivo da Reimpressão -
CodigoUsuario String(20) Sim Código do Usuário que reimprimiu o Ticket -
VO LogAplicacao
Valores
Possíveis
Categoria Inteiro Sim Categoria do Log -
Codigo String(20) Não NÃO UTILIZADO -
Data Data e Hora Não Data e Hora do registro do Log -
Função do Sistema que gerou do
Funcao String(240) Sim -
Log
31
Informacao String(2147483647) Sim Informações do Log -
Sequencial Inteiro 64 bits Não Sequencial do Log -
Sistema de Integração que
SistemaDeIntegracao String(50) Sim -
Gerou o Log
Tipo Inteiro Sim Tipo do Log -
VO IntegracaoOCR
Valores
Possíveis
Sequencial Inteiro de 64 bits Sim Cámpo chave sequencial -
Data e Hora de
Data Sim Data e Hora do registro do Log -
Captura do OCR
Ponto de Controle onde a
PontoDeControle String(20) Sim -
operação foi executada
Regra do OCR aplicada para
RegraDoOCR String(8000) Sim -
validação
PlacaOCR String(20) Sim Placa capturada pelo OCR -
Verifica se o OCR validou a 1 OCR OK, 0 OCR
PlacaConvergente Inteiro Sim
placa não validou
CodigoOperacao String(20) Sim Código da Operação Envolvida -
VO HistoricoPassagem
Valores
Possíveis
Ordem do
Codigo String Não -
HistoricoPassagem
Media Decimal Sim Média -
Minimo Decimal Sim Mínimo -
Maximo Decimal Sim Máximo -
Data e Hora do
Data DataTime Sim -
registro
Periferico Inteiro Sim Periférico -
EstacaoControle Inteiro Sim Estação de Controle -
Sequencial da
OperacaoTicket Inteiro Sim -
operação do ticket
Entidade Operacao
OperacaoTicketEntidade Negocio.Entidade.EOperacoesTicket Sim -
Ticket
Tag associada ao
TAG String Sim -
registro de pesagem
Estado da passagem:
304169 =
aguardando
Estado Inteiro Sim -
confirmação de
pesagem e 304170
pesagem confirmada
Código Estação de
EstacaoControleCodigo String Sim -
Controle
PerifericoCodigo String Sim Código Periférico -
Código do Ponto de
PontoDeControleCodigo String Sim -
Controle
32
Código do Ponto de
FlagPossivelIdentificacao Bool Sim -
Controle
VO CfgAlteracao
Valores
Possíveis
Indica que o ticket deverá ter sua
IgnoraTransportadora Bool Sim -
transportadora desassociada
Indica que o ticket deverá ter seu emissor
IgnoraEmissor Bool Sim -
desassociado
Indica que o ticket deverá ter seus itens
IgnoraItens Bool Sim -
desassociados
Indica que o ticket deverá ter seus
IgnoraDocumentos Bool Sim -
documentos desassociados
Indica que o ticket deverá ter seu motorista
IgnoraMotorista Bool Sim -
desassociado
Indica que o ticket deverá ter seus fatores de
IgnoraFatorCorrecao Bool Sim -
correção desassociados
Indica que o ticket deverá ter seus campos
IgnoraCamposAdicionais Bool Sim -
adicionais desassociados
4.1.3 WEB METODOS - DETALHAMENTO

 AcionaCancela
[INTERFACE]
Método responsável por solicitar acionamento de Cancela para o Guardian.
Esse método é síncrono para colocar pedido de execução na fila e assíncrono na execução do
comando.
Para saber o estado da execução do comando utilize o método ConsultaEstadoComando.
Para o correto funcionamento desse Web Método os Eventos Avulsos devem estar configurados
da seguinte forma:
- Evento avulso 01 – Abrir Cancela A
- Evento avulso 02 – Abrir Cancela B
- Evento avulso 03 – Fechar Cancela A
- Evento avulso 04 – Fechar Cancela B
- Evento avulso 05 – Abrir Cancela A e B
- Evento avulso 06 – Fechar Cancela A e B
Parâmetros de entrada:
- PontoControlePonto (String - Obrigatório) = Código do Ponto de Controle Associado a
Cancela.
- Lado (String - Obrigatório) = Lado automação onde a cancela que deseja-se acionar está
posicionada. Valores possíveis : 'A' = Lado A, 'B' = Lado B, 'E' = Lado de Entrada onde o
veículo foi identificado, 'S' = Lado de Saída oposta ao lado que o veículo foi identificado, 'T' =
Todas a cancelas associadas.
- Comando(String - Obrigatório) = Comando que se deseja que a cancela execute. Valores
possíveis : 'A' = Abrir, 'F' = Fechar.
Restrição:
- Não é permitido o envio de Lado=E e Comando=A - não há abertura de cancela de entrada
via web método.
Retornos:
- Retorno da Função (Inteiro) = ID do comando na Fila.
33
- Erro (Inteiro) = Código de Erro Caso Falhe. Valores possíveis: 0 = Não houve erro, Diferente
de 0 = Erros variados.
- ErroMSG (String) = Descrição do erro
 AcionaCancela_G4
[OBSOLETO]
MÉTODO DE COMPATIBILIZAÇÂO COM O GUARDIAN 4 - PREFERENCIALMENTE
UTILIZE O MÉTODO AcionaCancela!
Este método é responsável por:
Adicionar um comando de abertura ou fechamento de cancela na fila de execuções.
Deve-se indicar o lado da cancela cadastro do Guardian, sendo A para lado A
B para lado B, E para Entrada, S para Saída
E os comando possíveis são: A para Abrir e F para Fechar
Este método retorna dentro do parâmetro Erro, 0 (zero) se a execução foi correta
e diferente de 0 (zero) se houve qualquer problema da execução, nesse caso o parâmetro
mensagem estará preenchido com uma descrição do problema
 AlteraTicketGuardian
[INTERFACE]
Alterar dados de um Ticket em qualquer estado desde que seja diferente de cancelado.
Obs: Este método depende de configuração, para tal, nas configurações do Guardian:
1-) Botão Sistema (Configuração Geral do Guardian)
2-) Aba Aplicação
3-) Na combox Estação responsável pela integração de dados, selecionar uma estação de controle
que esteja configurada para permitir pré-cadastro.
- DadosTicket (VO PreCadastro - Obrigatório) = Dados do Ticket.
- Peso total de Origem - obrigatório o preenchimento para validar a tolerância por 'peso
mínimo' e 'peso máximo'.
- CfgAlteracao (VO CfgAlteracao - Obrigatório = Configuração da alteração.
Retornos:
- Retorno da Função (Ticket) = Retorna estrutura do ticket inserido no banco.
- Erro (Inteiro) = Código de Erro Caso Falhe. Valores possíveis:
303221 = Não houve erro
303224 = Falha ao alterar ticket
303040 = Registro inexistente
303776 = O WebService não está na mesma versão do banco de dados, favor fazer a
sincronização das versões
303776 = Erro de Validação!
303660 = Já existe um ticket aberto (Neste caso se aplica apenas para tag duplicada)
1 = Erro não esperado
 CadastraTicket
[INTERFACE]
Importar dados de um Ticket em estado de Pré-Cadastro ou Pesagem Inicial Executada.
Para se importar um ticket com pesagem inicial já executada, deve-se preencher todos os campos da
estrutura referentes a pesagem inicial.
34
- produto (String - Obrigatório) = Nome do Produto para Validação. Preencha com 'WS G'.
- código (String - Obrigatório) = Código do Produto para Validação. Preencha com '01'.
Retornos:
- Retorno da Função (Booleano) = Verdadeiro se o Ticket foi incluído com sucesso.
- Erro (Inteiro) = Código de Erro Caso Falhe. Valores possíveis: 303221 = Não houve erro,
Diferente de 303221 = Erros variados.
 CadastraTicketGuardian
[INTERFACE]
Para se importar um ticket com pesagem inicial já executada, deve-se preencher todos os
campos da estrutura referentes a pesagem inicial.
Retornos:
- Retorno da Função (Ticket) = Retorna estrutura do ticket inserido no banco.
 CapturaPeso
[INTERFACE]
Método é responsável por Adicionar um comando de captura de peso na fila de execuções.
Caso o Guardian capture um peso válido no informado Ponto de Controle dentro de um tempo
hábil informado no parametro TimeoutLeitura
esse peso é retonado dentro do parâmetro Peso.
Entende-se por peso válido, N pesos estáveis de acordo com configuração do Guardian,
com sensores desobstruídos, acima do peso mínimo
Deve-se chamar esse método até que o peso seja capturado.
O método considera válido também o último peso capturado nos últimos X segundos
informados no parâmetro TempoValidadePesoBom (preencha normalmente com 5 segundos).
O método pode aguarda um tempo informado no parâmetro TimeoutLeitura em segundos até
que o sistema consiga capturar esse peso (preencha normalmente com 5 segundos) .
Balança.
- TempoValidadePesoBom (Inteiro - Obrigatório) = Tempo de Validade de um Peso Bom
Capturado em Segundos. -Preferencialmente utilizar 5 segundos.
- TimeoutLeitura (String - Obrigatório) = Tempo máximo (em segundos) de retorno do método
enquanto o sistema tenta capturar um Peso Bom. - Preferencialmente utilizar 5 segundos.
- Comando (String - Obrigatório) = Comando que se deseja que a cancela execute. Valores
possíveis : 'A' = Abrir, 'F' = Fechar.
Retornos:
- Peso (Float) = Peso Bom Capturado.
- Erro (Inteiro) = Código de Erro Caso Falhe. Valores possíveis: 0 = Não houve erro, 1 = Não
foi possível capturar Peso Bom em tempo hábil, Diferente de 0 e 1 = Erros variados.

35
 CapturaPeso_G4
[OBSOLETO]
MÉTODO DE COMPATIBILIZAÇÂO COM O GUARDIAN 4 - PREFERENCIALMENTE UTILIZE O MÉTODO
CapturaPeso!
Adicionar um comando de captura de peso na fila de execuções.
Caso o Guardian capture um peso válido dentro de um tempo hábil definido na configuração
esse peso é retornado dentro do parâmetro Peso.
Entende-se por peso válido, N pesos estáveis de acordo com configuração do Guardian,
com sensores desobstruídos, acima do peso mínimo
Deve-se chamar esse método até que o peso seja capturado.
O método considera válido também o último peso capturado nos últimos X segundos configurados.
Este método retorna dentro do parâmetro Erro, o (zero) se a execução foi correta.
Retorna 1 (um) se não foi possível capturar o peso no período válido.
Retorna maior que 1 (um) se houve qualquer outro problema na execução, nesse caso o parâmetro
mensagem estará preenchido com uma descrição do problema.
 ConfirmaLeituraTicketsMarcados
[INTERFACE]
Método responsável por descartar os Tickets já lidos no ExportaTicketsMarcados.
Caso o Método ExportaTicketsMarcados seja chamado seguidamente sem chamar este método,
os tickets exportados serão acumulados e retornados junto com os novos tickets.
Retornos:
 ConfirmaTicketUnico
[INTERFACE]
Método responsável desmarcar para exportação um único ticket já exportado.
Deve ser chamado para utilizar o método ExportaTicketUnico
- SequencialTicket - Inteiro = Sequencial do ticket que foi exportado.
- nomeSistema - Código do do Sistema Integração para o qual o Ticket foi marcado.
Nomalmente utilize 'WS GUARDIAN'.
- Falhou - Boolean - Preencher Verdadeiro (true) caso senha havido algum problema com a
leitura desse Ticket.
- produto - Nome do Produto para Validação. Preencha com 'WS G'.
- código - Código do Produto para Validação. Preencha com '01'.
Retornos:
- Retorno da Função - Verdadeiro (True) caso o Ticket tenha sido desmarcado com Sucesso.
 ConfirmaVeiculosQuePossamTerPassadoSemPesarPelaBalanca
[INTERFACE]
Confirmar o recebimento dos dados do método:
RetornaVeiculosQuePossamTerPassadoSemPesarPelaBalanca
Retornos:
- True, se sucesso na operação, caso contrário, false
36
 ConsultaIntervencoesManuaisTicket
[INTERFACE]
EM DESENVOLVIMENTO - Não utilizar
Consultar intervenções manuais ocorridas em um Ticket.
É aplicado apenas em casos de Tickets abertos, ou seja, diferentes de Cancelados e
Encerrados.
O sistema tentará encontrar o Ticket na seguinte ordem de prioridade, de acordo com o
parâmetro que for preenchido:
- 1º Código do Ticket - 2º Último Ticket da Placa - 3º Último Ticket do TAG
- ticketCodigo (String - Opcional) = Código ou Número do Ticket.
- ticketPlaca (String - Opcional) = Placa da carreta/vagão.
- ticketTAG (String - Opcional) = TAG, Transponder ou Código de Barras de Identificação
Associada do Ticket.
- fluxoCodigo - Código do fluxo que o ticket irá assumir - produto (String - Obrigatório) =
Nome do Produto para Validação. Preencha com 'WS G'.
Retornos:
- DataSet com dados das intervenções manuais do Ticket
 ConsultaLogAplicacao
[INTERFACE]
Método responsavel por consultar os logs da aplicação de acordo com os parametros.
- dateInicial (Data e Hora - Obrigatório) = Data de Inicio da Pesquisa.
- dateFinal (Data e Hora - Obrigatório) = Data Final da Pesquisa.
- categoria (Inteiro - Obrigatório) = Categoria dos logs.
TODAS = -1;
Execução Aplicação = 1
Exception Serviço = 2
Exception Genérico = 3
Erro Tolerância = 4
Erro WebService = 5
Debug Carrega Dado = 6
Validação OCR = 7
Erro Pesagem = 8
Debug Pesagem Ferroviária = 9
Marcado Para Cancelar = 303775
Acionamento Manual = 303196
Auditoria Contingencia = 1589
Contingencia = 303155
Integração Padrão = 304592
Integração WebServices = 304644
- tipo (Inteiro - Obrigatório) = Tipo dos Logs. TODOS = -1.
- sistemaDeIntegracao (String - Opcional) = Sistema de integração que gerou o log.
Retornos:
- Retorna da Função (Lista de VO LogAplicacao) = Registros de Log.
37
 ConsultaLogPerifericos
[INTERFACE]
Método responsável por consultar logs dos periféricos gerados de acordo com os parâmetros
passados.
- OperadorLogin (String - Opcional) = Usuário responsável pela operação do periférico.
Normalmente o usuário utilizado para “Logar” no serviço.
- periferico (String - Opcional) = Código do periférico que gerou o log. Normalmente código do
MCA.
- categoria (Inteiro - Obrigatório) = Categoria dos logs.
TODAS = -1;
Execução Aplicação = 1
Exception Serviço = 2
Exception Genérico = 3
Erro Tolerância = 4
Erro WebService = 5
Debug Carrega Dado = 6
Validação OCR = 7
Erro Pesagem = 8
Debug Pesagem Ferroviária = 9
Marcado Para Cancelar = 303775
Acionamento Manual = 303196
Auditoria Contingencia = 1589
Contingencia = 303155
Integração Padrão = 304592
Integração WebServices = 304644
Retornos:
- Retorna da Função (Lista de VO LogPeriferico) = Registros de Log.
 ConsultaMovimentoOCR
[INTERFACE]
Método responsavel por consultar movimento de operacões executadas com OCR de acordo
com os parametros.
- ticketCodigo (String - Opcional desde que “ticketPlaca” ou “ticketTAG” esteja preenchidas) =
Número do Ticket'.
- ticketPlaca (String - Opcional desde que “ticketCodigo” ou “ticketTAG” esteja preenchidas) =
Placa da carreta/vagão Cadastrada no Ticket.
- ticketTAG (String - Opcional desde que “ticketCodigo” ou “ticketPlaca” esteja preenchidas) =
TAG Cadastrada no Ticket.
- placaOCR (String - Opcional) = Placa obtida pelo OCR.
- pontoControleDesc (String - Opcional) = Ponto de Controle que a operação foi executada.
- usuarioNome (String - Opcional) = Login do usuário que liberou a operação em caso de erro
de inconsistencia de OCR.
38
Retornos:
- Retorna da Função (Lista de VO Ticket) = Registros de ticket e operaçoes com OCR.
 ConsultaPedidoDeExecucao
[INTERFACE]
Método responsável por consultar o estado de um pedido de execução de tarefa.
Quando o retorno for igual a 303639 indica que a solicitação pesquisada já saiu da fila.
Se é uma solicitação recente ela foi executada corretamente.
Se é uma solicitação antiga ela pode já ter sido removida da fila por limpeza.
- ID (Inteiro - Obrigatório) = ID da solicitação na Fila.
Retornos:
- Retorno da Função (Inteiro) = Estados que podem ser : 303606 - Pendente, 303607 -
Aguardando termino da execução, 303608 - Erro na execução, 303639 - Já execudado ou não
encontrado.
 ConsultaTicketsPorPeriodo
[INTERFACE]
Exportação ou Consulta de Ticket por período de acordo com a data de abertura do ticket.
- dataInicial (Data e Hora - Obrigatório) = Data de Início da Pesquisa.
- dataFinal (Data e Hora - Obrigatório) = Data Final da Pesquisa.
Retornos:
- Retorno da Função (Objeto de VO Ticket) = Último Ticket disponível.
- Erro (Inteiro) = Código de Erro Caso Falhe. Valores possíveis: 0 = Não houve erro, Diferente de 0
= Erros variados.
 ConsultarLogAuditoria
[INTERFACE]
Consultar os logs de auditoria.
- Entidade ConsultaLogAuditoriaIN contendo 2 parametros obrigatórios (Datas) e o restante
opcional, utilizado no filtro da pesquisa. - produto (String - Obrigatório) = Nome do Produto
para Validação. Preencha com 'WS G'.
Retornos:
- Uma lista do tipo ConsultaLogAuditoriaOUT com mais parametros informativos.
Parametro Informativo>
- Verifique a propriedade MensagemRetornoWebService, pois ela contém a(s) mensagen(s) de
Erro(s) ou Sucesso
39
 DadosDoTicket_G4
[OBSOLETO]
MÉTODO DE COMPATIBILIZAÇÂO COM O GUARDIAN 4 - PREFERENCIALMENTE UTILIZE OUTROS
MÉTODOS!
- Incluir o Ticket;
- Iniciar pesagem;
- Consultar dados do ticket
As ações serão tomadas dependendo da sinalização que houver em cada um dos objetos.
Valores entram pelo ImportaTicketG4 e saem pelo ExportaTicketG4.
Os três objetos possuem um campo chamado “Flag”, que sinaliza que ação deve ser
executada. Os valores dos “Flags” para a execução da ação de cada objeto são:
Este método retorna dentro do parâmetro Erro, o (zero) se a execução foi correta
 EnviaMensagemDisplay
[INTERFACE]
Método responsável por enviar uma mensagem para um display.
Esse método é assíncrono, colocando um pedido de envio de mensagem para o display na fila
de execução.
Para saber o estado da execução do comando utilize o método ConsultaEstadoComando.
Cancela.
- Posicao (Inteiro - Obrigatório) = Posição no display na configuração do Guardian. Valores
possíveis :1 - Posição 1, 2 - Posição 2, 0 - Indiferente.
- Mensagem (String - Opcional) = Mensagem para o Display, se não preenchido ou em branco
limpa a mensagem.
- Tempo (Inteiro - Obrigatório) = Tempo de exibição em segundos, 0 indefinido.
Retornos:
 EnviaMensagem_G4
[OBSOLETO]
MÉTODO DE COMPATIBILIZAÇÂO COM O GUARDIAN 4 - PREFERENCIALMENTE UTILIZE OUTRO MÉTODO!
Adicionar uma mensagem a ser enviada para o display na fila de execuções.
O tempo deve ser indicado em segundos e se for igual a zero então a mensagem ficará sendo
exibida
até a próxima.
Este método retorna dentro do parâmetro Erro, o (zero) se a execução foi correta
 ExportaTicketParametro
[INTERFACE]
Exportação ou Consulta de Ticket por parâmetros.
- 1º Código do Ticket
40
- 2º Último Ticket da Placa
- 3º Último Ticket do TAG
Retornos:
 ExportaTicketPeriodo
[OBSOLETO]
PREFERENCIALMENTE UTILIZE O MÉTODO ConsultaTicketsPorPeriodo!
Exportação ou Consulta de Ticket por período de acordo com a data de abertura do ticket.
- dataInicial (Data e Hora - Obrigatório) = Data de Início da Pesquisa.
- dataFinal (Data e Hora - Obrigatório) = Data Final da Pesquisa.
Retornos:
 ExportaTicketUnico
[INTERFACE]
Fazer exportação diferenciar de ticket, selecionando e retornando apenas o primeiro ticket
disponível para exportação.
- completa (Booleano - Obrigatório) = NÃO UTILZIADO - Preenche sempre com Falso (False).
- nomeSistema (String - Obrigatório) = Nome do sistema para o qual o ticket está marcado
para exportação. Preencher normalmente com 'WS GUARDIAN'.
- Sincronizacao (Booleano - Obrigatório) = Preenche sempre com Falso (False)'.
- produto - Nome do Produto para Validação. Preencha com 'WS G'.
Retornos:
- Retorno da Função (VO Ticket) = Ticket disponível.
 ExportaTicketsMarcados
[INTERFACE]
Fazer exportação diferencial de tickets, selecionando e retornando todos os tickets disponíveis
para exportação para o sistema WS GUARDIAN.
Retornos:
41
- Retorno da Função (Lista de VO Ticket) = Lista de Tickets disponível.
 ExportaVeiculosQuePossamTerPassadoSemPesarPelaBalanca
[INTERFACE]
Retornar veículos que possam ter passado sem pesar pela balança
Retornos:
- Retorno da Função (Lista de VO HistoricoPassagem) = Lista do Historico de Passagens.
 IdentificaVagao
[OBSOLETO]
Método de compatibilização com o Guardian 4.
IMPORTANTE: Se exitir o arquivo BDG4.XML a conexão com o banco será feita utilizado os
dados desse arquivo e
serão utilizada as regras de negócio do Guardian 4. Caso contrário se feita a conexão com o
Guardian 6 normalmente.
Então para ser conectar com o Guardian 4 crier um arquivo BD.XML com a conexão para um
banco de Guardian 4 e renomei o arquivo para BDG4.XML.
Para se conectar ao Guardian 6 o arquivo BDG4.XML deve ser apagado. Este método é
responsável por:
Importar o pré-cadastramento do vagão.
- infoCarregamento (InformaCarregamento): Dados relacionados ao carregamento.
Retornos:
- Retorno da Função (Int) = 0 : erro desconhecido - 1 : sucesso 2 : vagao ja cadastrado.
 IdentificaVeiculoNoPonto
[INTERFACE]
Método responsavel por:
Identificar um veículo em um determinado ponto de controle
Com esse método é possível pesar um veículo posiciona na Balança associada ao ponto
informado.
O sistema vai tentar encontrar um Ticket Aberto através de um dos parâmetros (Ticket, Placa
ou ID) passados da seguinte ordem:
- PontoControle (String - Obrigatório) = Ponto de controle no qual o veículo vai ser
identificado.
- lado (String - Obrigatório) = Lado ao qual o veículo vai ser identificado. Valores possíveis A
ou B.
Retornos:
42
 ImportaTicketPreCadastro
[INTERFACE]
Retornos:
- Retorno da Função (Booleano) = Verdadeiro se o Ticket foi incluído com sucesso.
 ManutencaoTicket
[INTERFACE]
Alterar o Estado do Ticket.
A alteração do estado é aplicada apenas em casos de Tickets
abertos, ou seja, diferentes de Cancelados e Encerrados.
- numOperacao (Inteiro - Obrigatório) = Número que indica qual operação será realizada no
Ticket. Valores possíveis: 1 = Bloquear, 2 = Desbloquear, 3 = Encerrar, 4 = Cancelar.
Retornos:
- Retorno da Função (Booleano) = Retorna Verdadeiro (True) em caso de Sucesso de alteração
de Estado.
 ObtemVersaoWS
[INTERFACE]
Retorna a versão atual do Web Service, preferencialmente, essa deve ser a mesma versão do
Guardian utilizado. Parâmetros de entrada:
- DadosTicket (PreCadastro - Obrigatório) = Dados do Ticket.
Retornos:
- Retorno da Função (String) = Retorno Versão do programa ou Erro de Validação.
43
 RefazUltimaOperacao
[INTERFACE]
Permitir Refazer a última operação do Ticket.
É aplicado apenas em casos de Tickets diferentes de Cancelados.
Se houver apenas uma operação ativa no Ticket e este método for chamado, o ticket será
encerrado.
parametro que for preenchido:
- 1º Código do Ticket - 2º Último Ticket da Placa - 3º Último Ticket do TAG Parâmetros de
entrada:
Código ou Número do Ticket.
Placa da carreta/vagão.
TAG, Transponder ou Código de Barras de Identificação Associada do Ticket.
Retornos:
- Retorno da Função (Booleano) = Retorna Verdadeiro (True) em caso de Sucesso da
operação.
 RefazUltimaOperacaoII
[INTERFACE]
Permitir Refazer a última operação do Ticket.
É aplicado apenas em casos de Tickets diferentes de Cancelados.
Se houver apenas uma operação ativa no Ticket e este método for chamado, o ticket será
encerrado.
- 1º Código do Ticket - 2º Último Ticket da Placa - 3º Último Ticket do TAG Parâmetros de
entrada:
Código ou Número do Ticket.
Placa da carreta/vagão.
TAG, Transponder ou Código de Barras de Identificação Associada do Ticket.
Parâmetros de saída:
- SaiErro (Inteiro - Opcional) = Retorna o número do erro, em caso se sucesso retorna 0.
- SaiErroMSG(string - Opcional) = Retorna a descrição do erro, em caso se sucesso retorna
vazio.
Retornos:
operação.
 RemontaFluxo
[INTERFACE]
Remonta Fluxo Ticket.
44
- codigoFluxo (String - Obrigatório) = Código no novo fluxo do ticket.
Retornos:
operação.
 RetornaVeiculosQuePossamTerPassadoSemPesarPelaBalanca
[INTERFACE]
Retornar veículos que possam ter passado sem pesar pela balança
- dataInicio (Data e Hora - Obrigatório) = Data de Inicio da Pesquisa.
- dataFim (Data e Hora - Obrigatório) = Data Final da Pesquisa.
Retornos:
- Retorno da Função (Lista de VO HistoricoPassagem) = Lista do Historico de Passagens.
 SimulaPesagemAvulsaSemAutomacao
[INTERFACE]
WebMétodo responsavel por:
Simular uma 'PESAGEM AVULSA' de um veículo pré-cadastrado em um determinado ponto de
controle, em uma balança 'SEM AUTOMAÇÃO'
Este WebMétodo foi desenvolvido para funcionar com uma balança associada ao ponto de
controle. Ele NÃO FUNCIONA como uma operação do
GUARDIAN, ele apenas grava o peso capturado quando a balança está estavél (Posicionado)
como se fosse uma 'PESAGEM AVULSA'.
Nenhum evento é diparado, nenhuma configuração da operação é validada, ele apenas grava
as informações no banco.
Este WebMétodo utiliza 'Estação responsável pela integração de dados' e 'Usuário responsável
pela integração de dados' que estão
configurados no Config.exe na opção 'Sistema'.
Deverá ter apenas uma 'OPERAÇÃO AVULSA' Configurada. O sistema vai tentar encontrar um
Ticket aberto através de um dos parâmetros (Ticket, Placa ou ID) passados, na seguinte
ordem:
Funciona somente Parâmetros de entrada:
45
- PontoControle (String - Obrigatório) = Ponto de controle no qual o veículo vai ser
identificado.
- ticketPlaca (String - Opcional) = Placa da Carreta.
- lado (String - Obrigatório) = Lado ao qual o veículo vai ser identificado. Valores possíveis A
ou B.
- TempoValidadePesoBom (Inteiro - Obrigatório) = Tempo de Validade de um Peso Bom
Capturado em Segundos. -Preferencialmente utilizar 5 segundos.
- TimeoutLeitura (String - Obrigatório) = Tempo máximo (em segundos) de retorno do método
enquanto o sistema tenta capturar um Peso Bom. - Preferencialmente utilizar 5 segundos.
Retornos:
 SolicitaFotoAvulsa
[INTERFACE]
Solicitar o disparo assíncrono de uma fotografia em ponto específico de um ponto e controle
(posteriormente, utilize o WebMétodo SolicitaRetornoFotoAvulsa para verificar o resultado
desta operação).
- codigoPontoControle (String - Obrigatório) = Código do ponto de controle onde se encontra
câmera com a qual a foto será tirada.
- posicaoCamera (String - Obrigatório) = Posição de instalação da câmera no ponto de
controle (exemplo: P1, P2... P8).
- caminhoFoto (String - Opcional) = Caminho onde a foto será gravada. Se não for informado
será assumido o caminho padrão definido na configuração do Guardian.
- nomeFoto (String - Opcional) = Nome com o qual a foto será gravada. Se não for informado
será assumido a geração de nome padrão definida na configuração do Guardian.
Retornos:
- Retorno da Função (int) = Um código de identificação desta solicitação, poderá ser utilizado
para obter informação sobre o sucesso desta operação assíncrona.
- Erro (bool) = Código de Erro Caso Falhe. Valores possíveis: 0 = Não houve erro, Diferente de
0 = Erros variados.
- ErroMSG (String) = Descrição do erro retornado.
 SolicitaRetornoFotoAvulsa
[INTERFACE]
Obter informação sobre o sucesso ou não, IMEDIATAMENTE após o disparo de uma solicitação
assíncrona de fotografia avulsa (utilize o WebMétodo SolicitaFotoAvulsa para solicitar o disparo
de fotos).
- idSolicitacaoAvulsa (String - Inteiro) = Código de identificação da solicitação de foto avulsa.
Retornos:
- Retorno da Função (Objeto de VO RetornoFotoAvulsa) = Informações sobre o sucesso ou não
de uma operação anteriormente solicitada.
46
 TrocaFluxoTicket
[INTERFACE]
Alterar o Fluxo Ticket.
- codigoFluxo (String - Obrigatório) = Código no novo fluxo do ticket.
Retornos:
operação.
47
ARQUIVO TEXTO E BANCO TANQUE
Para a realização da integração padrão do Guardian utilizaremos o aplicativo “MIE - Módulo de Importação e
Exportação” desenvolvido pela Toledo do Brasil.
Com este aplicativo poderemos realizar dois tipos de integração: “Arquivo Texto” e “Banco a Banco”, ambos
devem ser MS SQL SERVER.
Pré-requisito
 HardKey Guardian TI ou PRO;
 Hardware mínimo especificado para o Guardian;
 Versão do MIE está inclusa na "pasta de instalação"* do Guardian
 Versão de configuração do MIE está inclusa na "pasta de instalação"* do Guardian
 Todas as versões devem usar no mínimo MS SQL SERVER 2005 Express;
* "pasta de instalação" - Pasta de exemplo: " C:\Program Files (x86)\Toledo\Guardian\MIE"
4.2.1 Instalação
Não há uma instalação propriamente dita da integração e sim a instalação do aplicativo MIE.
Para instalar o MIE vá à pasta onde foi instalado o Guardian e procure pela pasta “MIE” e execute o instalador
ME_STD.EXE e siga os passos que serão apresentados pelo Wizard de instalação. Este aplicativo deve ser
instalado no Servidor Windows.
Pasta de exemplo: " C:\Program Files (x86)\Toledo\Guardian\MIE"
Para utilização correta do aplicativo, sugerimos utilizar os backups de banco de dados que se encontram na pasta
acima citada, os arquivos são:
 GP_TANQUE_PADRAO.BAK - backup limpo para banco tanque, pode ser usado a qualquer momento.
 MIE_PADRAO_GUARDIAN.bak - backup que contém as configurações de MIE inclusa, mas não possui
as informações fora do padrão, como por exemplo agendamentos. Recomendamos que seja utilizado
apenas em novas instalações, para evitarmos que os dados editados fora do padrão se percam.
4.2.2 Configuração no MIE

Após a conclusão da instalação do MIE algumas configurações default deverão ser alteradas de acordo com o
ambiente em questão. Para alterar as configurações é necessário utilizar o wizard da própria aplicação, chamado
AMIE. Caso este aplicativo não seja executado automaticamente após a instalação procure por “C:\Program Files
(x86)\Toledo\MIE\AMIE.exe” e execute-o.
As configurações que devem ser alteradas são:
 Configuração do “Banco de Dados” do MIE:

o Preencha o Servidor de Banco de Dados SQL;
o Selecione o modo de autenticação;
o Informe Login e senha se necessário. Lembre-se caso seja escolhida autenticação do Windows os
Serviços do MIE são instalados por default com o Logon configurado para utilizar a conta do Serviço
Local (System, padrão Windows), que não tem permissão de acesso ao MS SQL Server por default,
devendo o administrador de TI dar as permissões necessárias para esta situação. A sugestão é que
seja criada uma conta no Serviço de Rede para executar estes serviços. Para alterar o Logon do
serviço consulte o Help do Windows em questão;
o No campo “Base de Dados que será utilizada:” utilize a base de dados de uma restauração à partir
do arquivo MIE_PADRAO_GUARDIAN.bak;
 Configuração do MIE via “Assistente de Importação e Exportação Toledo”;

o Siga as orientações do Wizard;
o Caso tenha utilizado o backup MIE_PADRAO_GUARDIAN.bak, não será necessário utilizar as
configurações.
48
o Se não foi utilizado o backup, na opção “Pacote das Configurações”, clique no botão “Selecionar” e
procure o arquivo “C:\Toledo\Guardian\MIE\INTEGRACAO_PADRAO_GUARDIAN_MIE.MIE”
selecione-o e aguarde os botões ficarem habilitados para continuar.
o Na opção “Agendamento” terá as configurações disponíveis para serem utilizadas. No caso da
integração ser executada automaticamente, deve-se clicar no Botão agendar e criar o agendamento
para a configuração desejada;
o Na opção “Determinação dos Servidores” deve-se clicar no Botão Configurar e substituir todos os
servidores que estão com os valores default pelos os da instalação em questão.
o Na opção “Configuração de Diretórios” (só alterar se estiver utilizando integração arquivo texto)
deve-se clicar no Botão Configurar e substituir o diretório raiz default pelo existente no ambiente em
questão. A estrutura de diretório deve ser mantida como exemplo abaixo:
o
o Na opção “Pronto”, marque “Iniciar Serviços” se desejar iniciar os serviços do MIE neste momento,
caso contrário deixe desmarcado e clique em terminar. Se a mensagem “Falha ao criar tabela
auxiliar confira as configurações e tente novamente!” for apresentada, significa que existe
alguma divergência na configuração dos servidores. Certifique-se que as configurações estão
corretas e execute o AMIE.exe novamente.
Lembre-se, quem irá fazer à escrita e leitura dos arquivos será um serviço, então os usuários de rede
destes serviços terão que ter permissão de escrita e leitura nas pastas utilizadas na integração.
4.2.3 Configuração no Guardian

Para o correto funcionamento da integração algumas configurações devem ser realizadas no “Toledo Guardian -
Configuração” ou Config.exe.
Execute o Config.exe:
 No menu principal clique na opção “Estação de Controle”, cadastre uma estação de controle que servirá como
referência para a integração nos casos onde é necessário informar a “Estação de Controle”. A sugestão é que
seja cadastrado com um nome que identifique que a Estação é utilizada única e exclusivamente para a
integração, assim o mesmo não será confundido com as outras estações.
 Em seguida no menu principal clique na opção “Usuários”, cadastre um usuário que servirá como referência
para a integração nos casos onde é necessário informar o usuário para realizar a integração. A sugestão é
que seja cadastrado com um nome que identifique que é um usuário utilizado única e exclusivamente para a
integração, para o mesmo não seja confundido com os outros.
 Em seguida no menu principal clique na opção “Sistema”.

o Na tela “Configuração Guardian” selecione a aba “Aplicação” e configure o campo “Estação
responsável pela integração de dados” com a estação que foi cadastrada anteriormente, em seguida
no campo “Usuário responsável pela integração” informe o Usuário que foi cadastrado
anteriormente para a integração.
o Ainda na tela “Configuração Guardian” selecione a aba “Operação”, na opção “Exportar Tickets com
estado”, selecione os estados que deseja que o ticket seja exportado. Se houver mais de uma opção
49
marcada, o ticket será exportado mais de uma vez durante o processo de pesagem com ou sem
alteração das informações do mesmo.
ARQUIVO TEXTO
EIXO TAG TI PRO
Arquivo texto  
Visão Geral
Será gerado ou lido um arquivo por ticket.
Todos os campos serão de tamanho variável com separador “;”.
O arquivo será composto de um indicador de grupo de dados em uma linha e na(s) linha(s) seguinte(s) os dados
desse grupo.
Será respeitada a ordem dos campos e tabelas filhas definidas no tópico “Dados dos arquivos”.
Campo com valores nulo no banco será exportado em branco.
Exportação Importação
Arquivo Arquivo MS SQL GUARD
GUARD MS SQL
texto IAN
DB MIE MIE DB
GUAR GUAR
DB DB
MIE MIE
Funcionamento Exportação
Com base nas configurações do MIE e do Guardian o arquivo texto será gerado com as informações de um único
ticket por vez.
O MIE irá exportar o conteúdo de cada tabela separadamente e irá uni-los no final da exportação de todos os
arquivos.
A ordem de exportação dos tickets será com base na data de criação do mesmo, sempre exportando o mais
antigo. O nome do arquivo que será composto da placa do ticket em questão entre colchetes mais a palavra
Ticket.TXT, como por exemplo, [IMP-2002]Ticket.TXT.
A responsabilidade de remover o arquivo da pasta será do aplicativo do cliente. Se o processo de pesagem

acontecer por completo e acontecer de ser gerado um novo ticket com a mesma placa de um arquivo que ainda
está na pasta de exportação, este arquivo será substituído pelo mais novo.
Arquivo de exportação
 Nome do arquivo [<Placa da Carreta>]Ticket.txt
 Todos os registros filhos devem ter o primeiro campo preenchido com a placa
 Arquivo único suprindo as seguintes estruturas de dados:
o Cabeçalho do Ticket
Indicador de Grupo: [Ticket]
o Operações executadas do Ticket

Indicador de Grupo: [Operacoes]
50
o Campos adicionais do Ticket
Indicador de Grupo: [CampoAdicional]
o Itens do Ticket
Indicador de Grupo: [Itens]
o Fatores de Correção do Ticket

Indicador de Grupo: [FatoresCorrecao]
o Documentos
Indicador de Grupo: [DocumentosTicket]
o Eixos capturados
Indicador de Grupo: [EixosDaOperacao]
Exemplo
[Ticket]
ABC-1234;0000001;false;false;;;;EMS0001;João da silva;;;…
[Operacoes]
83;DEF-4567;;;;;;;;;;;;;;;;;Paulo;10/01/12;;PT03;ES01;2;PreCadastro;true;1
101;DEF-4567;;;;;;;;;17598;;;;;;;;Nei;10/01/12;BAL1;PT01;ES01;2;PInicial;true;1
[CampoAdicional]
1;CARGA LIQUIDA
2;12%
[DocumentosTicket]
1;NF00001;1;15000
2;NF00002;1;10000
3;NF00003;1;
2000
[Itens]
1;ITM0001;Milho
2;ITM0002;Soja
Exportação
Dados que devem estar contidos no arquivo de exportação:
Dados do Ticket - [TICKET]

TCK_PLACA_CARRETA String(20) SIM Placa da Carreta -
TCK_CODIGO String(30) SIM Número/Código do Ticket
TCK_INDICA_PESAGEM_FERRO Quando Verdadeira Indica que o ticket

VIARIA Booleano SIM é de pesagem ferroviária
Quando Verdadeira Indica que o

TCK_VERIFICA_PESO_LIQUIDO resultado do Peso Líquido na Pesagem
_MAIOR_ZERO Booleano SIM Final pode ser 0 para esse veículo
TCK_PESO_ALVO Decimal NÃO Peso Alvo da Dosagem -
TCK_CORTE Decimal NÃO Peso para Corte da Dosagem -
TCK_DOSAGEM_LENTA Decimal NÃO Peso de início da dosagem lenta -
EMS_CODIGO String(20) NÃO Código do Emissor Associado -
51
EMS_RAZAO_SOCIAL String(50) NÃO Razão social do Emissor Associado
FLX_CODIGO String(50) NÃO Código do Fluxo Associado -
TCK_OBSERVACAO String(8000) NÃO Observação -

Peso de referência para checagem do
peso total na primeira pesagem do
TCK_PESO_BRUTO_ORIGEM Decimal NÃO veículo -
Identificação associada referente ao
TCK_IDT_ASSOCIADA String(250) NÃO TAG, Transponder ou Código de Barras -
TCK_TIPO_FATOR_CORRECAO Inteiro NÃO NÃO UTILIZAR - Em manutenção -
TVC_CODIGO String NÃO Tipo do Veículo -
TRP_CODIGO String(20) NÃO Código da Transportadora associada -

Razão Social da Transportadora
TRP_RAZAO_SOCIAL String(50) NÃO associada
Operações do ticket - [OPERACOES]

Inteiro SIM Sequencial da operação executada no

OTK_SEQUENCIAL Longo Ticket -
SIM
OTK_PLACA_VEICULO String Placa do Veículo -
MTR_CODIGO String(20) NÃO Código do Motorista associado -
MTR_CPF String(20) NÃO CPF do Motorista Associado
MTR_NOME String(50) NÃO Nome do Motorista Associado
OTK_UNIDADE_APOS_CONVER Unidade de Medida Após Conversão do

SAO String Peso -
NÃO Número do Compartimento referente a
OTK_COMPARTIMENTO Inteiro esse registro de pesagem -
NÃO
Valor do fator correção obtido a partir
OTK_FATOR_CORRECAO_LISTA Decimal da lista de fatores de correção da lista -
NÃO
OTK_FATOR_CORRECAO_CALC Valor do fator correção obtido a partir
ULO Decimal da expressão calculada -
NÃO
OTK_PESO Decimal Peso Capturado em kg -
NÃO Representa o peso total das
embalagens vazias em kg (Tara do
OTK_TARA_VEICULO Decimal Veículo) -
NÃO
OTK_FATOR_CONVERSAO Decimal Fator de Conversão -
NÃO Representa o peso líquido obtido após
OTK_PESO_LIQUIDO Decimal a pesagem final em kg -
OTK_PESO_LIQUIDO_CORRIGO NÃO Representa o peso líquido corrigido
_LISTA Decimal após a pesagem final em kg -
NÃO Representa o peso líquido corrigido
OTK_PESO_LIQUIDO_CORRIGO pela fórmula após a pesagem final em
_CALCULO Decimal kg -
NÃO Representa o peso líquido convertido,
OTK_PESO_LIQUIDO_CONVERT apresentado o fator e unidade após
IDO Decimal conversão após a pesagem final em kg -
NÃO Valor do peso bruto do veículo que
OTK_PESO_BRUTO_VEICULO Decimal registrou a pesagem -
SIM Login do Usuário que registrou a
USR_LOGIN EXP operação -
SIM
OTK_DATA Data e Hora Data de execução da Operação -
NÃO Código do Periférico que executou essa
PRF_CODIGO String(20) operação -
52
SIM Código do Ponto de Controle que
LCL_CODIGO String(20) executou a operação -
SIM Código da Estação de Controle que
PCL_CODIGO String(20) executou a operação -
SIM 1 = Pré-Cadastro, 2 =
Pesagem Inicial, 3 =
Pesagem Final, 4 =
Hsitórico de Passagem, 5
= Acesso, 8 = Pesagem
Avulsa, 10 = Atualização
de Tara, 11 = Pesagem
TOP_CODIGO Inteiro Tipo da Operação executada por Eixos, 12 = Dosagem
SIM
TOP_DESCRICAO String(50) Descrição do Tipo da Operação -

SIM
OPR_CODIGO String(20) Código da Operação -
SIM
OTK_ESTADO Booleano Indica estado da operação FALSO = CANCELADA
SIM Indica o Lado que a operação foi
OTK_LADO Inteiro realizada -
Campos adicionais do Ticket - [CAMPOS]

CAT_NUMERO Inteiro SIM Número do Campo Adicional -

CAT_VALOR String SIM Valor do campo adicional -
Documentos do Ticket - [DOCUMENTOS]


DCT_CODIGO String SIM Ticket -
DCT_DESCRICAO String SIM Descrição ou número do documento -

DCT_ESTADO Inteiro SIM Estado do documento 0=Desativado, 1=Ativado
DCT_PESO_ORIGEM Decimal SIM Peso do Documento -
Itens do Ticket - [ITENS]

ITK_CODIGO String(20) SIM Código sequencial do item no Ticket -
ITM_CODIGO String(20) SIM Código do Item -
ITM_NOME String(50) SIM Nome do Item -
Fatores de correção do Ticket - [FATORES]

Número sequencial correspondente a

LFC_NUMERO Inteiro SIM cada faixa -
LFC_FATOR Decimal SIM Percentual do Fator -
LFC_DESCRICAO String(50) SIM Descrição do Fator -
LFC_VALOR_MINIMO Decimal SIM Valor mínimo para aplicação do Fator -
LFC_VALOR_MAXIMO Decimal SIM Valor máximo para aplicação do Fator -

53
Eixos capturado na operação do Ticket - [EIXOS]
Inteiro Sequencial da operação executada no

OTK_SEQUENCIAL Longo SIM Ticket -
Número do eixo ou grupo de eixos
EIO_NUMERO_EIXO Inteiro SIM capturado -
Peso nominal do eixo ou grupo de
EIO_PESO_ORIGEM Decimal SIM eixos -
EIO_DATA Data e Hora SIM Data da captura -

Diferença entre o peso nominal e o
EIO_DIFERENCA Decimal NÃO capturado quando acima -
EIO_DIFERENCA_MAXIMA_PER
MITIDA Decimal SIM Diferença máxima permitida -
Funcionamento Importação
Com base nas configurações do MIE e do Guardian e nas definições abaixo o arquivo texto será importado um único
ticket por vez.
O MIE irá separar o conteúdo do arquivo em vários e irá importar o conteúdo de cada tabela separadamente.
A ordem de importação dos tickets será com base na data de criação do mesmo.
O conteúdo de cada arquivo terá como primeiro campo de cada linha a placa do veículo (já definido na estrutura do
arquivo único). Essa placa deve ser usada para encontrar e relacionar o dado com o devido ticket.
Os campos relacionados aos cadastros Item, Motorista, Emissor e Transportador, serão importados
automaticamente caso não existam no Guardian se já existirem o MIE irá atualizados sempre com a última
informação disponibilizada.
Caso ocorra erro na importação dos arquivos, os mesmos serão renomeados com erro e movidos para
uma pasta de cópia definida na configuração do MIE.
Funcionamento Alteração do Ticket

A alteração do ticket é semelhante à sua inserção, quando pensado nas opções de integração. A grande diferença
é que, junto à informação do próprio ticket, possui uma tabela de configuração do comportamento de como o ticket
será alterado. Dessa forma, a estrutura do ticket tanto para inserção como para alteração é a mesma.
Essa estrutura de configuração do comportamento do ticket é necessária pois partes das informações podem ser
preenchidas manualmente no próprio Guardian, e durante a alteração, como alguns campos viriam vazios, a
importações seriam apagadas.
Sendo assim o comportamento padrão é que campos não preenchidos não serão apagados.
E quando as tabelas filhas estiverem preenchidas, elas devem ser totalmente substituídas pelas novas informações,
apagando-as e reinserindo-as.
As informações só serão apagadas se definidas na estrutura de configuração, e somente para as informações

disponíveis nessa estrutura.
Os tickets podem ser alterados em quase todos os estados, a única exceção é o estado cancelado e encerrado.
54
N°
Significado
Configuração
1 Altera Ticket
2 Exclui Transportadora
3 Exclui Emissor
4 Exclui Itens
5 Exclui Documentos
6 Exclui Lista Fator de Correção
7 Exclui Campos Adicionais
8 Exclui Motorista
9 Exclui Tipo Veiculo
A alteração do ticket será realizada com base na tabela acima, onde cada configuração representa um tipo de dado
que se deseja alterar. No arquivo texto deverá ser incluído um novo grupo [ConfiguraçãoAlteração] e as
respectivas configurações. É com base na informação existente neste grupo que a integração irá saber que é uma
alteração de Ticket.
Cada configuração com exceção do ticket terá dois valores possíveis, 0 ("ZERO") E 1 ("UM").
Valor da configuração igual 0 "ZERO": a integração irá verificar se o dado que está vindo da integração é vazio ""
ou Nulo, sendo um desses valores a integração irá manter o valor já existente no ticket, se for diferente de vazio
("") e Nulo o dado será substituído.
Valor da configuração igual 1 "UM": a integração irá excluir o dado do ticket.
No caso da configuração do ticket o único valor possível é o 0 "ZERO".
Arquivo de Importação
 Nome do arquivo [<Placa da Carreta>]Ticket.txt
 Cada linha de dados deve ter como primeiro campo a placa da carreta.
 Arquivo único suprindo as seguintes estruturas de dados:
o Cabeçalho do Ticket
 Indicador de Grupo: [Ticket]
o Campos adicionais do Ticket
 Indicador de Grupo: [CampoAdicional]
o Documentos do Ticket
 Indicador de Grupo: [DocumentosTicket]
o Itens do Ticket
 Indicador de Grupo: [Itens]
o Fatos de correção do Ticket
55
 Indicador de Grupo: [FatoresCorreção]
o Configuração Alteração ( *** Somente na alteração do Ticket *** )
 Indicador de Grupo: [ConfiguraçãoAlteração]
Exemplo:
Arquivo : [ABC123]ImpTicket.txt
[Ticket]
ABC-1234;DEF-4567;false;false;;;;EMS0001;João da silva;;;…
[CampoAdicional]
ABC-1234;1;CARGA LIQUIDA
ABC-1234;2;12%
[DocumentosTicket]
ABC-1234;1;NF00001;15000
ABC-1234;2;NF00002;10000
ABC-1234;3;NF00003;2000
[Itens]
ABC-1234;1;ITM0001;Milho
ABC-1234;2;ITM0002;Soja
[ConfigAlteracao]( *** Somente na Alteração do Ticket *** )
ABC-1234;1;0 ( *** Altera o Ticket *** )
ABC-1234;2;1 ( *** Exclui a transportadora *** )
ABC-1234;3;1 ( *** Exclui o Emissor *** )
Dados Importação
Dados que devem estar contidos no arquivo de importação:
Dados do Ticket – [TICKET]

TCK_PLACA_CAR
RETA String(20) SIM Placa da Carreta -
OTK_PLACA_VEI Valor padrão:
CULO String(20) NÃO Placa do Veículo PlacaCarreta
TCK_INDICA_PE
SAGEM_FERROV Quando Verdadeira Indica que o ticket é
IARIA Booleano SIM de pesagem ferroviária Zero(0) ou Um (1)
TCK_VERIFICA_ Quando Verdadeira Indica que o resultado

PESO_LIQUIDO_ do Peso Líquido na Pesagem Final pode ser
MAIOR_ZERO Booleano SIM 0 para esse veículo Zero(0) ou Um (1)
TCK_PESO_ALV
O Decimal NÃO Peso Alvo da Dosagem -
TCK_DOSAGEM_
LENTA Decimal NÃO Peso de início da dosagem lenta -

EMS_RAZAO_SO
CIAL String(50) NÃO Razão social do Emissor Associado

56

TCK_OBSERVAC
AO String(8000) NÃO Observação -
TCK_PESO_BRU Peso de referência para checagem do peso
TO_ORIGEM Decimal NÃO total na primeira pesagem do veículo -
TCK_IDT_ASSOC Identificação associada referente ao TAG,
IADA String(250) NÃO Transponder ou Código de Barras -
FFC_CODIGO Inteiro NÃO Código do calculo de correção -
FFC_DESCRIÇÃO String(50) NÃO Descrição do calculo de correção -
FFC_FORMULA String(1024) NÃO Fórmula do calculo de correção -

Valores do cadastro de
veiculo do Guardian.
(Valores padrão do
TVC_CODIGO String NÃO Tipo do Veículo DENIT)

TRP_RAZAO_SO
CIAL String(50) NÃO Razão Social da Transportadora associada
OTK_UNIDADE_
APOS_CONVERS Unidade de Medida Após Conversão do
AO String(10) NÃO Peso -
OTK_FATOR_CO
NVERSAO Decimal NÃO Fator de Conversão
Código da Operação de “pré-cadastro”
OPR_CODIGO String(20) SIM Cadastrado no Guardian.
Campos adicionais do Ticket - [CAMPOS]


Documentos do Ticket - [DOCUMENTOS]

DCT_CODIGO String SIM Código sequencial do documento no Ticket -
Itens do Ticket - [ITENS]

ITK_CODIGO Inteiro SIM Código sequencial do item no Ticket -

57
Fatores de correção do Ticket - [FATORES]

Número sequencial correspondente a cada
LFC_NUMERO Inteiro SIM faixa -
Configuração Alteração - [ConfigAlteracao]

Inteiro Preenchimento
IMP_SEQUENCIAL Longo SIM Sequencial Automático automático
K
Numero da configuração que se deseja
CFA_CONFIG_NUMERO Inteiro SIM alterar 1,2,3,4,5,6,7,8 e 9
1(Verdadeiro) exclui dado do ticket
CFA_CONFIG_VALOR Inteiro SIM 0(Falso) mantém ou altera dado 0 ou 1
Data e hora que o dado foi incluído na
IMP_DATA Data e hora SIM tabela. -
I - Incluído
Controla leitura e escrita do dado na P - Pronto
IMP_FLAG Inteiro SIM tabela L - Lido
58
BANCO TANQUE
EIXO TAG TI PRO
Banco Tanque  
O Banco Tanque será utilizado para importar e exportar apenas dados operacionais relacionados ao Ticket.
Não estão previstos importação e exportação de dados de cadastros secundários (Itens, Transportadora, Emissores,
Motoristas, etc). Mesmo assim as tabelas de importação preveem dados de código e nome ou descrição para
eventual inclusão no cadastro.
Exportação Importação
GUARDIA MS SQL GUARDIAN MS SQL
DB DB
GUARDIAN
GUARDIAN
DB DB MIE
TANQUE MIE Tanque
DB DB
MIE
MIE
Tabelas de importação
 Sinalização
 Ticket
 Campos adicionais
 Itens do Ticket
 Fatores de Correção
 Documentos
Tabelas de exportação
 Sinalização
 Ticket
 Campos adicionais
 Itens do Ticket
 Fatores de Correção
 Documentos
 Operações executadas
 Eixos capturados
59
Funcionamento da Importação
Mecanismo Geral
 O programa do cliente verifica na tabela de sinalização de importação se o estado da sinalização é LIBERADO;
 O programa do cliente sinaliza na tabela de sinalização de importação que o estado é EXPORTANDO;
 O programa do cliente Insere os dados nas tabelas de importação.
 O programa do cliente sinaliza na tabela de sinalização de importação que o estado é LIBERADO;
 O MIE verifica se existem dados para importar
 O MIE le o estado LIBERADO e sinaliza na tabela de sinalização de importação que está IMPORTANDO;
 O MIE seleciona os registros nas devidas tabelas que estão marcados como INSERIDO;
 Após importar, o MIE marca todos os dados importados como LIDO;
 O MIE altera o estado da tabela de sinalização de importação como LIBERADO.
Especificidades
 Ao tentar importa um registro com uma placa ou tag existente num ticket em aberto o sistema deverá descartar
o registro que está sendo importado.
 Não haverá atualização de dados do ticket.
 Incluir e Atualizar Calculo de Correção, Motorista, Item, Emissor, Transportadora nos devidos cadastros,
utilizando como chave de referência o respectivo código e incluindo ou atualizando nome ou descrição (também
a fórmula no caso de cálculo).
 Não incluir o ticket caso seja informado um Fluxo ou Tipo de Veículo que não esteja cadastrado.
 No caso da importação do pré-cadastro o programa do cliente só deve sinalizar que está liberado quando todas
as tabelas filhas do ticket estiverem no banco. Os tickets só deverão ser incluídos no banco tanque com todas
as suas informações de uma única vez.
 Caso seja incluído um ticket errado no Banco Tanque não há a possibilidade de altera-lo via integração. O
procedimento para corrigi-la é ir à tela de “Manutenção de ticket” do Guardian e cancelar este ticket e envia-lo
novamente via integração.
 A integração não faz validação de placa, caso seja informado um valor diferente do esperado pelo Guardian a
integração irá importa-lo, mas irá ocasionar erro for executar a operação de pesagem.
 Para reenviar um ticket basta atualizar a tabela de ticket para que o MIE identifique que há algo para ser
importado, lembrando que não pode haver um ticket aberto com a mesma placa.
Funcionamento Alteração do Ticket
A alteração do ticket é semelhante à sua inserção, quando pensado nas opções de integração. A grande diferença
é que, junto à informação do próprio ticket, possui uma tabela de configuração do comportamento de como o ticket
será alterado. Dessa forma, a estrutura do ticket tanto para inserção como para alteração é a mesma.
Essa estrutura de configuração do comportamento do ticket é necessária, pois partes das informações podem ser
preenchidas manualmente no próprio Guardian, e durante a alteração, como alguns campos viriam vazios, a
importações seriam apagadas.
Sendo assim o comportamento padrão é que campos não preenchidos não serão apagados.
60
E quando as tabelas filhas estiverem preenchidas, elas devem ser totalmente substituídas pelas novas informações,
apagando-as e reinserindo-as.
As informações só serão apagadas se definidas na estrutura de configuração, e somente para as informações
disponíveis nessa estrutura.
Os tickets podem ser alterados em quase todos os estados, a única exceção é o estado cancelado e encerrado.
N°
Significado
Configuração
1 Altera Ticket
2 Exclui Transportadora
3 Exclui Emissor
4 Exclui Itens
5 Exclui Documentos
6 Exclui Lista Fator de Correção
7 Exclui Campos Adicionais
8 Exclui Motorista
9 Exclui Tipo Veiculo
A alteração do ticket será realizada com base na tabela acima, onde cada configuração representa um tipo de dado
que se deseja alterar. No Banco Tanque a tabela tbIntegracaoConfiguracaoAlteracao deverá ser alimentada com
base na tabela acima, com base na existência de registros nesta tabela é que a integração irá saber que é uma
alteração de Ticket.
Cada configuração com exceção do ticket terá dois valores possíveis, 0 ("ZERO") E 1 ("UM").
Valor da configuração igual 0 "ZERO": a integração irá verificar se o dado que está vindo da integração é vazio ""
ou Nulo, sendo um desses valores a integração irá manter o valor já existente no ticket, se for diferente de vazio
("") e Nulo o dado será substituído.
Valor da configuração igual 1 "UM": a integração irá excluir o dado do ticket.
No caso da configuração do ticket o único valor possível é o 0 "ZERO".
Atualização Código do Ticket no Banco Tanque (a partir da versão 6.6.78)

A atualização do "código do ticket" no banco tanque irá acontecer após a inclusão do pré-cadastro via Integração.
Para que isso aconteça, a integração ao incluir o pré-cadastro no Guardian grava no ticket a chave primaria da
tabela "tbImpTicket", que originou o pré-cadastro. Esta informação estará visível nas telas de pré-cadastro,
operação e manutenção com o nome de "Controle de Integração".
Quando a exportação de ticket no estado de pré-cadastro acontecer, ela irá atualizar o código do ticket no banco
tanque com base no valor do "Controle de Integração".
Para que isto aconteça o Guardian deverá estar configurado para exportar ticket.
Esta funcionalidade está disponível a partir da Versão 1.0.4 da "Integração Padrão" e 6.6.78 do
Guardian.
61
Estrutura das Tabelas
tbImpSinalizacao – Tabela de sinalização da importação

L – Liberado
I – Importando
IMP_SINALIZACAO String(1) SIM Sinalização da Importação E - Exportando
tbImpTicket – Tabela de dados do Ticket

Preenchimento
IMP_SEQUENCIAL Inteiro Longo NÃO Sequencial Automático automático
Código da operação
cadastrada no Guardian
OPR_CODIGO String(20) SIM Código da Operação de pré-cadastro. como pré-cadastro
K TCK_PLACA_CARRETA String(20) SIM Placa da Carreta -

Valor padrão:
OTK_PLACA_VEICULO String(20) NÃO Placa do Veículo PlacaCarreta
TCK_INDICA_PESAGEM Quando Verdadeira Indica que o ticket

_FERROVIARIA Booleano SIM é de pesagem ferroviária Zero (0) ou um (1)

TCK_VERIFICA_PESO_L resultado do Peso Líquido na Pesagem
IQUIDO_MAIOR_ZERO Booleano SIM Final pode ser 0 para esse veículo Zero (0) ou um (1)


TCK_PESO_BRUTO_ORI peso total na primeira pesagem do
GEM Decimal NÃO veículo -
TCK_TIPO_FATOR_COR
RECAO Inteiro NÃO NÃO UTILIZAR - Em manutenção -
FFC_CODIGO Inteiro NÃO Código do calculo de correção -
FFC_DESCRIÇÃO String(50) NÃO Descrição do calculo de correção -
FFC_FORMULA String(1024) NÃO Fórmula do calculo de correção -

Valores do cadastro de
veiculo do Guardian.
(Valores padrão do
TVC_CODIGO String NÃO Tipo do Veículo DENIT)

OTK_UNIDADE_APOS_C Unidade de Medida Após Conversão do
ONVERSAO String(10) NÃO Peso -
62
OTK_FATOR_CONVERS
AO Decimal NÃO Fator de Conversão
Indica a data e hora que o dado foi
IMP_DATA Data e Hora SIM incluído na tabela -
K Campo de Controle de Leitura e escrita I – Incluído
IMP_FLAG String(1) SIM do dado na tabela L - Lido
Este campo é atualizado na tarefa de
exportação do Ticket no estado de pre-
cadastro do MIE. Não deve ser
TCK_CODIGO String(30) NÃO preenchido.
tbImpCampAdicionalTicket – Tabela de campos adicionais do Ticket

Preenchimento
K TCK_PLACA_CARRETA String(20) SIM Placa da Carreta(chave de pesquisa) -

Número do Campo Adicional único por
K CAT_NUMERO Inteiro SIM ticket. -
tbImpDocumentoTicket – Tabela de documentos do Ticket

Preenchimento

Código sequencial único do documento
K DCT_CODIGO String SIM por Ticket -

tbImpItensTicket – Tabela de Itens do Ticket

Preenchimento

Código sequencial único dos itens do
K
ITK_CODIGO Inteiro SIM Ticket -

63
tbImpListaFatoresCorrecaoTicket – Tabela de importação da lista de fatores de correção do Ticket
Preenchimento

Número sequencial único
K
LFC_NUMERO Inteiro SIM correspondente a cada faixa por ticket. -

Configuração Alteração - [ConfigAlteracao]

Inteiro Preenchimento
IMP_SEQUENCIAL Longo SIM Sequencial Automático automático
K
Numero da configuração que se deseja
CFA_CONFIG_NUMERO Inteiro SIM alterar 1,2,3,4,5,6,7,8 e 9
1(Verdadeiro) exclui dado do ticket
CFA_CONFIG_VALOR Inteiro SIM 0(Falso) mantém ou altera dado 0 ou 1
Data e hora que o dado foi incluído na
IMP_DATA Data e hora SIM tabela. -
I - Incluído
Controla leitura e escrita do dado na P - Pronto
IMP_FLAG Inteiro SIM tabela. L - Lido
Observação: campos com a indicação K significa que servirão como critério de pesquisa na inclusão dos dados no
Guardian.
Os campos IMP_FLAG devem vir com valor default "I", e serão atualizados para "L"após a inclusão do dado no
Guardian e serão utilizados como chave de pesquisa.
Funcionamento da Exportação
Mecanismo Geral
 O Guardian irá marcar os registros para serem exportados;
 O MIE verifica se existem dados para exportar
 O MIE verifica na tabela de sinalização de exportação se o estado da sinalização é LIBERADO;
 O MIE sinaliza na tabela de sinalização de exportação que o estado é EXPORTANDO
 O MIE marca os dados escolhidos para exportar.
 O MIE pega os dados do ticket e Insere nas tabelas de exportação.
 O MIE sinaliza na tabela que o estado é LIBERADO.
 O Programa do cliente verifica se existem dados para importar
 O Programa do cliente Le o estado LIBERADO e sinaliza na tabela de sinalização de exportação que está
IMPORTANDO
64
 O Programa do cliente seleciona os registros nas devidas tabelas que estão marcadas como INSERIDO.
 Após importar, o programa do cliente marca todos os dados importados como LIDO.
 O Programa do cliente altera o estado da tabela de sinalização de exportação como LIBERADO.
Estrutura das Tabelas
tbExpSinalizacao – Tabela de sinalização da exportação

L – Liberado
I – Importando
EXP_SINALIZACAO String(1) SIM Sinalização da Exportação E - Exportando
tbExpTicket – Tabela de exportação do Ticket

Preenchimento
EXP_SEQUENCIAL Inteiro Longo SIM Sequencial Automático automático
TCK_INDICA_PESAGEM_FERRO Quando Verdadeira Indica que o ticket

VIARIA Booleano SIM é de pesagem ferroviária

TCK_VERIFICA_PESO_LIQUIDO resultado do Peso Líquido na Pesagem
_MAIOR_ZERO Booleano SIM Final pode ser 0 para esse veículo

peso total na primeira pesagem do
TCK_PESO_BRUTO_ORIGEM Decimal NÃO veículo -

TCK_TIPO_FATOR_CORRECAO Inteiro NÃO NÃO UTILIZAR - Em manutenção -

EXP_DATA Data e Hora SIM incluído na tabela -
Campo de Controle de Leitura e escrita I – Incluído
EXP _FLAG String(1) SIM do dado na tabela L - Lido
tbExpOperacoesTicket – Tabela de exportação das operações executada do ticket

65
Preenchimento
SIM Sequencial da operação executada no
OTK_SEQUENCIAL Inteiro Longo Ticket -
SIM
OTK_PLACA_VEICULO String Placa do Veículo -
OTK_UNIDADE_APOS_CONVER Unidade de Medida Após Conversão do

SAO String Peso -
NÃO Número do Compartimento referente a
OTK_COMPARTIMENTO Inteiro esse registro de pesagem -
NÃO
Valor do fator correção obtido a partir
OTK_FATOR_CORRECAO_LISTA Decimal da lista de fatores de correção da lista -
NÃO
OTK_FATOR_CORRECAO_CALC Valor do fator correção obtido a partir
ULO Decimal da expressão calculada -
NÃO
OTK_PESO Decimal Peso Capturado em kg -
NÃO Representa o peso total das
embalagens vazias em kg (Tara do
OTK_TARA_VEICULO Decimal Veículo) -
NÃO
OTK_FATOR_CONVERSAO Decimal Fator de Conversão -
NÃO Representa o peso líquido obtido após
OTK_PESO_LIQUIDO Decimal a pesagem final em kg -
OTK_PESO_LIQUIDO_CORRIGO NÃO Representa o peso líquido corrigido
_LISTA Decimal após a pesagem final em kg -
NÃO Representa o peso líquido corrigido
OTK_PESO_LIQUIDO_CORRIGO pela fórmula após a pesagem final em
_CALCULO Decimal kg -
NÃO Representa o peso líquido convertido,
OTK_PESO_LIQUIDO_CONVERT apresentado o fator e unidade após
IDO Decimal conversão após a pesagem final em kg -
NÃO Valor do peso bruto do veículo que
OTK_PESO_BRUTO_VEICULO Decimal registrou a pesagem -
SIM Login do Usuário que registrou a
USR_LOGIN EXP operação -
SIM
OTK_DATA Data e Hora Data de execução da Operação -
NÃO Código do Periférico que executou essa
PRF_CODIGO String(20) operação -
SIM Código do Ponto de Controle que
LCL_CODIGO String(20) executou a operação -
SIM Código da Estação de Controle que
PCL_CODIGO String(20) executou a operação -
SIM 1 = Pré-Cadastro, 2 =
Pesagem Inicial, 3 =
Pesagem Final, 4 =
Histórico de Passagem,
5 = Acesso, 8 =
Pesagem Avulsa, 10 =
Atualização de Tara, 11
= Pesagem por Eixos,
TOP_CODIGO Inteiro Tipo da Operação executada 12 = Dosagem
SIM
TOP_DESCRICAO String(50) Descrição do Tipo da Operação -

SIM
OPR_CODIGO String(20) Código da Operação -
66
SIM
OTK_ESTADO Booleano Indica estado da operação FALSO = CANCELADA
SIM Indica o Lado que a operação foi
OTK_LADO Inteiro realizada -
SIM Indica a data e hora que o dado foi
EXP_DATA Data e Hora incluído na tabela -
SIM Campo de Controle de Leitura e escrita I – Incluído
EXP _FLAG String(1) do dado na tabela L – Lido
tbExpCampAdicionalTicket – Tabela de exportação dos campos adicionais do Ticket

Preenchimento

EXP FLAG String(1) SIM do dado na tabela L - Lido
tbExpDocumentoTicket – Tabela de exportação dos documentos do Ticket

Preenchimento

DCT_CODIGO String SIM Ticket -

0=Desativado,
DCT_ESTADO Inteiro SIM Estado do documento 1=Ativado

EXP FLAG String(1) SIM do dado na tabela L - Lido
tbExpItensTicket – Tabela de exportação dos itens do Ticket

Preenchimento

EXP_FLAG String(1) SIM do dado na tabela L - Lido
67
tbExpListaFatoresCorrecaoTicket – Tabela de exportação da lista dos fatores de correção do Ticket
Preenchimento

Número sequencial correspondente a
LFC_NUMERO Inteiro SIM cada faixa -

tbExpEixosOperacao – Tabela de exportação dos eixos capturado na operação do Ticket
Preenchimento

Sequencial da operação executada no
OTK_SEQUENCIAL Inteiro Longo SIM Ticket -
Número do eixo ou grupo de eixos
EIO_NUMERO_EIXO Inteiro SIM capturado -
Peso nominal do eixo ou grupo de
EIO_PESO_ORIGEM Decimal SIM eixos -
EIO_DATA Data e Hora SIM Data da captura -

Diferença entre o peso nominal e o
EIO_DIFERENCA Decimal NÃO capturado quando acima -
EIO_DIFERENCA_MAXIMA_PER
MITIDA Decimal SIM Diferença máxima permitida -
Limpeza
 O MIE executa uma Stored Procedure do banco tanque parametrizando o tempo em dias que os dados devem
permanecer no banco.
 A Stored Procedure apaga todos os dados de todas as tabelas que o campo Data de Importação ou
Exportação seja mais velho que a data atual menos a quantidade de dias informados.
68
PARA SUAS ANOTAÇÕES
69
5. SERVIÇOS DE APOIO AO CLIENTE
A Toledo mantém centros de serviços regionais em todo o país, para assegurar instalação perfeita e desempenho
confiável a seus produtos. Além destes centros de serviços, aptos a prestar-lhes a assistência técnica desejada,
mediante chamado ou contrato de manutenção periódica, a Toledo mantém uma equipe de técnicos residentes em
pontos estratégicos, dispondo de peças de reposição originais, para atender com rapidez e eficiência aos chamados
mais urgentes.
Quando necessário, ou caso haja alguma dúvida quanto à correta utilização deste Manual, entre em contato com a
Toledo em seu endereço mais próximo.
Ela está sempre à sua disposição.
MANUTENÇÃO PREVENTIVA TOLEDO

ASSEGURA BOM DESEMPENHO E CONFIABILIDADE AO SEU EQUIPAMENTO
TOLEDO DO BRASIL INDÚSTRIA DE BALANÇAS LTDA.
ARAÇATUBA -SP MARINGÁ - PR

Av. José Ferreira Batista, 2941 - Jardim Ipanema Av. Colombo, 6580 - Jd. Universitário
CEP 16052-000 Fone: (18) 3303-7000 Fax: (18) 3303-7050 CEP 87020-000 Fone: (44) 3225-1991 Fax: (44) 3225-1991
BELÉM - PA PORTO ALEGRE (CANOAS) - RS

Rua Boa Ventura, 1701 - Bairro Fátima R. Augusto Severo, 36 - Nossa Senhora das Graças
BELO HORIZONTE - MG RECIFE - PE

Av. Portugal, 5011 - Bairro Itapoã R. D. Arcelina de Oliveira, 48 - B. Imbiribeira
CAMPINAS (VALINHOS) - SP RIBEIRÃO PRETO - SP

Av. Dr. Altino Gouveia, 827 - Jardim Pinheiros - Valinhos - SP R. Iguape, 210 - B. Jardim Paulista
CEP 13274-350 Fone: (19) 3829-5800 / Fax: (19) 3829-5810 CEP 14090-090 Fone: (16) 3968-4800 Fax: (16) 3968-4812
CAMPO GRANDE - MS RIO DE JANEIRO - RJ

Av. Eduardo Elias Zahran, 2473 - Jd. Alegre R. da Proclamação, 574 - Bonsucesso
CEP 79004-000 Fone: (67) 3303-9600 Fax: (67) 3303-9650 CEP 21040-282 Telefax: (21) 3867-1393/95/96/98/99/1444
CHAPECÓ - SC SALVADOR (LAURO DE FREITAS) - BA

R. Tiradentes, 80 - Bela Vista Loteamento Varandas Tropicais, S/N - Quadra 1 - Lote 20 - Pitangueira
CUIABÁ - MT SANTOS - SP
Av. Miguel Sutil, 4962 - Jardim Leblon R. Professor Leonardo Roitman, 27 - V. Matias
CURITIBA - PR SÃO JOSÉ CAMPOS - SP

R. 24 de Maio, 1666 - B. Rebouças R. Icatu, 702 - Parque Industrial
CEP 80220-060 Fone: (41) 3213-3350 Fax: (41) 3213-3350 CEP 12237-010 Fone: (12) 3934-9211 Fax: 3934-9278
FORTALEZA - CE SÃO PAULO (SÃO BERNARDO DO CAMPO) - SP

R. Padre Mororó, 915 - Centro R. Manoel Cremonesi, 1 - Jardim Belita
CEP 60015-220 Fone: (85) 3391-8100 Fax: (85) 3391-8150 CEP 09851-330 Fone: (11) 4356-9395/9404 (11) 4356-9462
GOIÂNIA - GO UBERLÂNDIA - MG
Av. Laurício Pedro Rasmussen, 357 - Vila Santa Isabel R. Ipiranga, 297 - Cazeca
CEP 74620-030 Fone: (62) 3202-0344 Fax: (62)3202-0344 CEP 38400-036 Fone: (34) 3215-0990 Fax: (34) 3215-0990
MANAUS - AM VITÓRIA - ES
R. Ajuricaba, 999 - B. Cachoeirinha R. Pedro Zangrandi, 395 - Jardim Limoeiro - Serra - ES
CEP 69065-110 Fone: (92) 3635-0441 Fax: (92) 3233 0787 CEP 29164-020 Fone: (27) 3182-9900 Fax: (27) 3182-9950


TOLEDO é uma marca registrada da Mettler-Toledo, Inc., de Columbus, Ohio, USA.
R: MANOEL CREMONESI, 01 - TEL. 55 (11) 4356-9000 - CEP 09851-330 - JARDIM BELITA - SÃO BERNARDO DO CAMPO - SP - BRASIL
site: www.toledobrasil.com.br e-mail: sis@toledobrasil.com.br
3474395 CONTEÚDO DESTE MANUAL SUJEITO A MUDANÇAS SEM PRÉVIO AVISO RE: 04-11-14
70

Manual Do Usuario Ti Instalacao e Interface de Dados Guardian Versao 6 7 PDF

Enviado por

Dados do documento

Título original

Direitos autorais

Formatos disponíveis

Compartilhar este documento

Compartilhar ou incorporar documento

Opções de compartilhamento

Você considera este documento útil?

Este conteúdo é inapropriado?

Direitos autorais:

Formatos disponíveis

Manual Do Usuario Ti Instalacao e Interface de Dados Guardian Versao 6 7 PDF

Enviado por

Direitos autorais:

Formatos disponíveis

guardianPRO

guardianEIXO Manual válido

2. COMPOSIÇÃO DO SISTEMA .......................................................................................... 16

3. REQUISITOS E CARACTERÍSTICAS ............................................................................. 17

Requisitos de Instalação do SQL ................................................................................................................................... 18

Crescimento do banco de dados do Guardian ............................................................................................................. 18

Crescimento de arquivos de Foto do Guardian ........................................................................................................... 18

Tamanho dos arquivos texto de Importação e exportação ......................................................................................... 18

Portas de comunicação necessárias para os serviços Guardian: ................................................................................ 18

4. INTEGRAÇÃO DE DADOS .............................................................................................. 19

ARQUIVO TEXTO E BANCO TANQUE ................................................................................................................... 48

ARQUIVO TEXTO ........................................................................................................................................................ 50

BANCO TANQUE ......................................................................................................................................................... 59

5. SERVIÇOS DE APOIO AO CLIENTE .............................................................................. 70

A tela do Assistente para Instalação do Guardian será aberta.

Selecione Português nesta tela e clique em OK.

Clique em Próximo nestas telas

Instalação do Servidor de hardkey

Selecione a pasta de instalação e Avançar nas próximas telas.

Clique em Avançar nas próximas telas.

Clique em Continuar e/ou Próximo nas próximas telas.

Será aberta a tela do Assistente de Inicialização do Guardian. Clicar em Próximo.

Na tela de Configuração do Banco de Dados Guardian, efetuar as configurações destacadas abaixo:

O instalador do Guardian cria uma

O ponto faz referência ao computador

Selecionar esta opção para criar o

Em seguida configure o servidor de hardkey.

Selecionar a opção Registrar nova Hardkey e clicar no botão Próximo.

Após concluir a instalação do servidor de Hardkey, clicar em Terminar.

Confirmar as informações abaixo e clique em em Próximo.

Em seguida, clicar em Concluir.

Clique em Close nesta tela.

Configurações relacionadas à Permissão, Usuários, Periféricos,

Operação do programa propriamente dito, com opções de cadastro de

Serviço responsável pelo controle das operações sem intervenção

Serviço responsável pelo controle das operações do banco de

Além destes aplicativos, outros aplicativos de suporte estão integrados à solução:

Importação e exportação de arquivos texto.

Aplicativo responsável por realizar a atualização do sistema.

Servidor exclusivo para banco de dados

Requisitos mínimos para o Microcomputador e o Servidor:

Requisitos de Instalação do SQL

Crescimento do banco de dados do Guardian

Crescimento de arquivos de Foto do Guardian

Tamanho dos arquivos texto de Importação e exportação

Portas de comunicação necessárias para os serviços Guardian:

WEB SERVICE GUARDIAN (WS)

Recurso/funcionalidade Guardian Guardian Guardian Guardian Guardian

4.1.1 WEB METODOS

4.1.2 ESTRUTURAS E TABELAS

4.1.3 WEB METODOS - DETALHAMENTO

* "pasta de instalação" - Pasta de exemplo: " C:\Program Files (x86)\Toledo\Guardian\MIE"

4.2.2 Configuração no MIE

As configurações que devem ser alteradas são:

 Configuração do “Banco de Dados” do MIE:

 Configuração do MIE via “Assistente de Importação e Exportação Toledo”;

4.2.3 Configuração no Guardian

 Em seguida no menu principal clique na opção “Sistema”.

A responsabilidade de remover o arquivo da pasta será do aplicativo do cliente. Se o processo de pesagem

o Operações executadas do Ticket

o Fatores de Correção do Ticket

Dados do Ticket - [TICKET]

TCK_PLACA_CARRETA String(20) SIM Placa da Carreta -