guardianPRO guardianTI guardianTAG guardianEIXO guardian
Manual válido para versão 6.7 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. 4.1.1 4.1.2 4.1.3
INTEGRAÇÃO DE DADOS .............................................................................................. 19 WEB SERVICE GUARDIAN (WS) ............................................................................................................................. 19 WEB METODOS ..................................................................................................................................................... 19 ESTRUTURAS E TABELAS .................................................................................................................................. 20 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 Assistente de Inicialização do Guardian
Guardian Configuração
Guardian Operação
Guardian Service
Serviço de Contingência
RESPONSABILIDADE Assistente que irá auxiliar na inicialização da aplicação, permitindo a instalação e configuração do Banco de Dados SQL, Módulo de 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, 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 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 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 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 Servidor de Hardkey
RESPONSABILIDADE Controle de licença centralizado. Importação e exportação de arquivos texto.
* MIE MAT GTT
*Será ativado/configurado somente quando houver integração de dados TXT ou BT
Aplicativo responsável por realizar a atualização do sistema. Gerenciador de tarefas de backup e outros.
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 EIXO
Guardian TAG
INTEGRAÇÃO DE DADOS
Guardian TI
Guardian PRO
Guardian TI
Guardian PRO
WEB SERVICE GUARDIAN (WS) (Versão 6.7.120) Recurso/funcionalidade
Guardian
Guardian EIXO
WEB SERVICE
Guardian TAG
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-0114T15: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 Campo
Tipo
Obrigatório
Valores Possíveis
Descrição
AceitaPesoLiquidoZero
Booleano
NÃO
Quando Verdadeira Indica que o resultado do Peso Líquido na Valor padrão: Pesagem Final pode Verdadeiro(True) ser 0 para esse veículo
PesoAlvo
Decimal
NÃO
Peso Alvo da Dosagem -
Corte
Decimal
NÃO
Peso para Corte da Dosagem
-
DosagemLenta
Decimal
NÃO
Peso de início da dosagem lenta
-
DataPesagem
Data e Hora
SIM
NÃO UTILIZADO
Preencher sempre com uma Data e Hora qualquer
Documentos
Lista de VO Documento
NÃO
Documentos associados
-
Emissor
VO EmissorIntegracao
NÃO
Dados do Emissor associado
-
FatoresCorrecao
Lista de VO NÃO ListaFatoresCorrecaoTicket
NÃO UTILIZAR - Em manutenção
-
Fluxo
String(50)
Código do Fluxo Associado
-
NÃO
20
Item
Lista de VO ItemIntegracao
NÃO
Itens associados
-
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.
-
PesoBrutoOrigem
Decimal
NÃO
Peso de referência para checagem do peso total na primeira pesagem do veículo
PesoMinimoOrigem
Decimal
NÃO
Peso mínimo origem
-
PesoMaximoOrigem
Decimal
NÃO
Peso máximo origem
-
NÃO
Peso de origem total Soma de todos os documentos adicionados à lista de documentos do ticket
SIM
Armazena a identificação da carreta e do vagão, quando aplicável
-
NÃO
Armazena a identificação do veículo e do vagão, quando aplicável
Valor padrão: PlacaCarreta
PesoTotalOrigem
PlacaCarreta
PlacaVeiculo
Decimal
String(20)
String(20)
TagAssociado
String(250)
NÃO
Identificação associada referente ao TAG, Transponder ou Código de Barras
TipoDoFatorDeCorrecao
Inteiro
NÃO
NÃO UTILIZAR - Em manutenção
-
TipoVeiculo
String(20)
NÃO
Tipo do Veículo
-
Transportadora
VO TransportadoraIntegracao
NÃO
Dados da Transportadora associada
UnidadeAposConversao
String(10)
NÃO
Unidade de Medida Após Conversão do Peso
-
CamposAdicionais
Lista de VO CampoAdicionalTicket
NÃO
Campos adicionais do Ticket
-
NÃO
Operação a ser registrada como pesagem inicial. Obrigatório quando for informar peso da pesagem inicial. Equivale ao campo código da tela de operação
NÃO
Balança ou MCA (mesmo que inativos) a ser registrado como utilizado na pesagem inicial. Obrigatório quando for informar
OperacaoDaPesagemInicial String
PerifericoDaPesagemInicial String
21
-
peso da pesagem inicial. Equivale ao campo código da tela de periféricos
PesoDaPesagemInicial
Decimal
NÃO
Peso da Pesagem Inicial. Quando informado o peso obrigatoriamente deve ser maior que 0 (zero)
DataDaPesagemInicial
Data e Hora
NÃO
Data e Hora da Pesagem Inicial
-
EmbalagensTicket
Lista de EmbalagensTicket NÃO
Embalagens do ticket
-
VO EmissorIntegracao Campo
Tipo
Sequencial
Inteiro
Codigo
Obrigatório NÃO
Descrição
Valores Possíveis
NÃO UTILIZADO
-
String(20) SIM
Código do Emissor
-
Descricao
String(50) SIM
Descrição ou Nome do Emissor
-
TipoEmissor
Inteiro
Tipo do Emissor
519 = Fornecedor, 520 = Cliente, 521 = Outros
RazaoSocial
String(50) NÃO
Razão Social do Emissor
-
Cnpj
String(30) NÃO
SIM
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
-
UF
String(4)
Unidade Federativa ou 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
-
Observacao
String(50) NÃO
Observação
-
Estado
Inteiro
NÃO
Estado do Emissor
0=Desativado, 1=Ativado(Valor Padrão)
TipoDocumento
Inteiro
SIM
Tipo do Documento para pessoa física (CPF) ou jurídica (CNPJ)
303404 = Física, 303405 = Jurídica
SIM
Indica que os dados passados podem ser incluídos ou alterados no cadastro
Sem preenchido Falso (False) o sistema não vai incluir o Ticket se o emissor não estiver cadastrado
IncluiAtualiza
Booleano
SIM
VO ItemIntegracao Campo
Tipo
Obrigatório
Descrição
Valores Possíveis
Sequencial
Inteiro
NÃO
NÃO UTILIZADO
-
Codigo
String(20)
SIM
Código do Item
-
Descricao
String(50)
NÃO
NÃO UTILIZADO
-
Nome
String(50)
SIM
Nome do Item
-
22
Informacao
String(400) NÃO
Informações sobre o item
-
PesoUnitario
Decimal
SIM
Peso Unitário
Se não utilizado preencher com 0
UnidadeMedida
String(10)
NÃO
Unidade de Medida
-
PodeConverter
Booleano
SIM
Se Verdadeiro (true), habilita da conversão de peso para esse item
FatorConversao
Decimal
SIM
Fator de Conversão
Se não utilizado preencher com 0
UnidadeMedidaConversao
String(10)
NÃO
Unidade de Medida após a Conversão
-
UtilizaContador
Booleano
NÃO
NÃO UTILIZADO
-
InicioContador
Inteiro
NÃO
Valor Inicial do Contador
-
FinalContador
Inteiro
NÃO
Valor final do contador, ao atingir esse valor o contador volta para o valor inicial
PrefixoContador
Inteiro
NÃO
Prefixo do Contador
0 = Dia, 2 = Mês, 3 = Ano
CodigoFatorCorrecao
String(20)
NÃO
Código do Fator de Correção associado
-
CodigoFluxo
String(50)
NÃO
Código do Fluxo exclusivo do item
-
SIM
Se verdadeiro (true) indica que os tickets que utilizam esse item devem fazer pesagem inicial
-
QuantidadeViasRelatorioImpressas Inteiro
SIM
Quantidade máxima de vias do ticket
0 = Indefinido
Estado
NÃO
Estado do Item
0=Desativado, 1=Ativado(Valor Padrão)
SIM
Indica que os dados passados podem ser incluídos ou alterados no cadastro
Sem preenchido Falso (False) o sistema não vai incluir o Ticket se o item não estiver cadastrado
Indica qual é o tipo de item
1760=Matéria-Prima, 1761=Produto Industrializado, 1762=Produto Manufaturado, 1763=Outro tipo de item
InicialObrigatoria
Booleano
Inteiro
IncluiAtualiza
Booleano
Tipo
Inteiro
NÃO
VO MotoristaIntegracao Campo
Tipo
Obrigatório
Descrição
Valores Possíveis
Sequencial
Inteiro
NÃO
NÃO UTILIZADO
-
Codigo
String(20)
SIM
Código do Motorista
-
Descricao
String(50)
NÃO
NÃO UTILIZADO
-
Nome
String(50)
SIM
Nome do Item
-
23
CPF
String(20)
NÃO
CPF
Deixar vazio caso o motorista seja estrangeiro
RG
String(20)
NÃO
RG
-
Cnh
String(20)
NÃO
CNH
-
Estado
Inteiro
NÃO
Estado do Motorista
0=Desativado, 1=Ativado(Valor Padrão)
Observacao
String(50)
NÃO
Observação
-
Informação dos Acompanhantes
-
InfoAcompanhantes String(255) NÃO
Nacionalidade
String(50)
NÃO
Nacionalidade
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 é informado deve ser a mesma configurada no Guardian (português é padrão).
DataNascimento
Date
NÃO
Data de Nascimento
-
DocEstrangeiro
String
NÃO
Preencher este campo para que o Documento Estrangeiro motorista seja identificado como estrangeiro no cadastro de motoristas.
SIM
Indica que os dados passados podem ser incluídos ou alterados no cadastro
IncluiAtualiza
Booleano
Sem preenchido Falso (False) o sistema não vai incluir o Ticket se o motorista não estiver cadastrado
VO TransportadoraIntegracao Campo
Tipo
Sequencial
Inteiro
Codigo
Obrigatório NÃO
Descrição
Valores Possíveis
NÃO UTILIZADO
-
String(20) SIM
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
-
UF
String(4)
Unidade Federativa ou 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
-
Observacao
String(50) NÃO
Observação
-
Estado
Inteiro
NÃO
Estado da Transportadora
0=Desativado, 1=Ativado (Valor Padrão)
TipoDocumento
Inteiro
NÃO
Tipo do Documento para pessoa física (CPF) ou jurídica (CNPJ)
0 = Física( Valor Padrão), 1 = Jurídica
IncluiAtualiza
Booleano
SIM
Indica que os dados passados Sem preenchido Falso (False) o podem ser incluídos ou sistema não vai incluir o Ticket se a alterados no cadastro
NÃO
24
Transportadora não estiver cadastrada
VO TICKET Campo
Tipo
Obrigatório
Valores Possíveis
Descrição
Sim
Chave interna do Fator de Correção Associado
CamposAdicionais
Lista de VO CampoAdicionalTicket
Sim
Campos adicionais de preenchimento livre do Ticket
Codigo
String(30)
Sim
Código ou Número do Ticket
CodigoCalculoFatorCorrecao Inteiro
Sim
Código do Fator de Correção Associado
-
CodigoEmissor
String(20)
Sim
Código do Emissor Associado
-
CodigoFluxoTicket
String(50)
Sim
Código do Fluxo Associado
-
CodigoTransportadora
String(20)
Sim
Código da Transportadora Associada
-
DataPesagem
Data e Hora
Sim
Data de Abertura do Ticket
Documentos
Lista de VO Documento
Sim
Documentos associados
-
EmbalagensTicket
Lista de VO EmbalagensTicket
Sim
Embalagens associadas
-
Emissor
VO EEmissor
Sim
Dados do Emissor associado
-
Sim
CadastroVeiculo = 0, PreCadastro = 1, Pesagem Inicial = 2, Encerrado = 3, Aguardando Liberação = 4, PesagemFinal = 5, Cancelado = 6, Estados do Ticket Acesso Veiculo = 7, Pesagem Avulsa = 8, Verificação = 9, Bloqueado = 10, Pesagem Eixos = 11, Pesagem Dosagem = 12
Sim
Próximo estado do Ticket quando Mesmo valores do aguardando campo estado liberação da Integração
CalculoFatorCorrecao
Inteiro
Estado
Inteiro
EstadoAguardando
25
Inteiro
-
FatoresCorrecao
Lista de VO Sim ListaFatoresCorrecaoTicket
Fatores de correção associados
FluxoTicket
Inteiro
Não
Chave do fluxo do Ticket interna do Guardian
FluxoTicketSequencia
Lista de VO FluxoTicketSequencia
Sim
NÃO UTILIZAR! 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
-
OperacaoTicket
Lista de VO OperacaoTicket
Sim
Operações realizadas
-
Sim
Caso Verdadeiro (true) indica que houve pesagem em contingência
-
-
-
PesagemEmContingencia
Booleano
-
PesagemManual
Booleano
Sim
Caso Verdadeiro (true) indica que houve pesagem manual
PlacaCarreta
String(20)
Sim
Placa da carreta/vagão
ReimpressaoTicket
Lista de VO ReimpressoesTicket
Sim
Registro de Reimpressões do Ticket (somente reimpressões sem vizualização)
Sequencial
Inteiro de 64 bits
Sim
Chave primária interna de controle do Guardian
-
SequencialDiario
Inteiro
Sim
Número sequencial diário do ticket
-
TagAssociado
String(250)
Sim
Identificação associada referente ao TAG, Transponder ou Código de Barras
TipoFatorCorrecao
Inteiro
Sim
NÃO IMPLEMENTADO
-
TipoOperacao
Inteiro
Sim
Tipo de operação realizada, Recebimento = 1, preenchido Expedição = 2 somente após a pesagem final
Transportadora
VO ETransportadora
Sim
Dados da Transportadora associada
-
IntegracoesOCR
Lista de VO IntegracoesOCR
Sim
Interações realizadas com o OCR
-
Sincronizado
bool
Sim
Sincronizado
-
26
DiferencaOrigem
decimal
Sim
Diferença de origem.
-
BloqueiaBotoeira
bool
Sim
Informa se bloqueia a botoeira.
-
PesagemFerroviaria
bool
Sim
Informa se é uma pesagem ferroviária.
-
VO CampoAdicionalTicket Campo
Tipo
Obrigatório
Valores Possíveis
Descrição
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 Campo
Tipo
Obrigatório
Descrição
Valores Possíveis
Data
Data e Hora
SIM
Data da criação do Registro
-
Codigo
Inteiro
NÃO
Código sequencial do documento no Ticket
-
Descricão
String(255) SIM
Descrição ou número do documento
-
Estado
Inteiro
SIM
Estado do documento
0=Desativado, 1=Ativado
PesoOrigem
Decimal
SIM
Peso do Documento
-
PesagemRealizada Boolean
SIM
Pesagem Realizada
-
Tolerancia
Não
Tolerância
-
Double
VO EmbalagensTicket Campo
Tipo
Obrigatório
Valores Possíveis
Descrição
Sequencial
Inteiro
Não
Chave interna de controle do Guardian
-
Quantidade
Decimal
Sim
Quantidade de Embalagens
-
Peso
Decimal
Sim
Peso total das embalagens
-
Data
Data e Hora
Sim
Data da criação do Registro
-
Codigo
String
Sim
Código sequencial da embalagem no Ticket
-
CodigoItem
String(20)
Sim
Código da embalagem
-
SequencialItem Int
Não
Sequencial do Item. Não é preenchido na importação.
-
SequencialTck
Int
Não
Chave interna da embalagem do ticket
-
CodigoTck
Int
Não
Código do ticket. Não é preenchido na importação.
-
VO EEmissor
27
Campo
Tipo
Obrigatório
Valores Possíveis
Descrição
Sequencial
Inteiro
Não
Chave interna de controle do 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
-
UF
Inteiro
Não
Chave internada da Unidade 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
-
Observacao
String(50)
Não
Observação
-
Transportadoras
Lista de VO ETransportadora
Não
Transportadoras associadas ao Emissor
-
Estado
String
Não
Estado do Emissor
0=Desativado, 1=Ativado
TipoDocumento
String
Não
Tipo do Documento para pessoa física (CPF) ou jurídica (CNPJ)
0 = Física, 1 = Jurídica
VO ETransportadora Campo
Tipo
Obrigatório
Valores Possíveis
Descrição
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
-
UF
Inteiro
Não
Chave internada da Unidade 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
-
Observacao
String(50)
Não
Observação
-
28
0=Desativado, 1=Ativado
Estado
String
Não
Estado do Emissor
TipoDocumento
String
Não
Tipo do Documento para pessoa física (CPF) 0 = Física, 1 = ou jurídica (CNPJ) Jurídica
VO ItemTicket Campo
Tipo
Obrigatório
Descrição
Valores Possíveis
Sequencial
Inteiro
Não
Chave interna de controle do Guardian
-
Codigo
String
Não
Código sequencial do Item no Ticket
-
SequencialTck
Inteiro de 64 bits
Sim
Chave interna do Ticket
-
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
-
Estado
String
Não
Estado do Item no Ticket
0=Desativado, 1=Ativado
Sim
Sequencial que representa o ID do lote
-
SequencialLot String(50)
VO ListaFatoresCorrecaoTicket Campo
Tipo
Obrigatório
Descrição
Valores Possíveis
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
-
ValorMaximo Decimal
Sim
Faixa máxima de Peso para Aplicação do Fator
-
ValorMinimo Decimal
Sim
Faixa Mínima de Peso para Aplicação do Fator
-
Data
Data e Hora
Sim
Data da Criação do Registro
-
Estado
String
Sim
Estado do Fator
0=Desativado, 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 Campo
Tipo
Obrigatório
Descrição
Valores Possíveis
Codigo
String(20)
Sim
Código sequencial da operação executada no Ticket
-
TicketSequencial
String(20)
Sim
Chave interna do Ticket
-
PlacaVeiculo
String(20)
Sim
Placa do Veículo
-
Motorista
VO EMotorista
Sim
Dados do Motorista
-
UnidadeAposConversao String(10)
Sim
Unidade de Medida Após Conversão do Peso
-
29
TipoVeiculo
String(20)
Sim
Tipo do Veículo
-
Eixo
Inteiro
Sim
OBSOLETO - Não utilizado
-
Sim
Número do Compartimento referente a esse registro de pesagem
Compartimento
Inteiro
FatorCorrecaoLista
Decimal
Sim
Valor do fator correção obtido a partir da lista de fatores de correção da lista
FatorCorrecaoCalculo
Decimal
Sim
Valor do fator correção obtido a partir da expressão calculada
-
Peso
Decimal
Sim
Peso Capturado em kg
-
TaraTotal
Decimal
Sim
Representa o peso total das embalagens vazias em kg (Tara do Veículo)
FatorConversao
Decimal
Sim
Fator de Conversão
PesoLiqObtido
Decimal
Sim
Representa o peso líquido obtido após a pesagem final em kg
PesoLiqCorrigido
Decimal
Sim
Representa o peso líquido corrigido após a pesagem final em kg
Sim
Representa o peso líquido corrigido pela fórmula após a pesagem final em kg
PesoLiqCorrigidoCalculo Decimal
PesoLiqConvertido
Decimal
Sim
Representa o peso líquido convertido, apresentado o fator e unidade após conversão após a pesagem final em kg
PesoBrutoVeiculo
Decimal
Sim
Valor do peso bruto do veículo que registrou a pesagem
-
UsuarioLogin
String(20)
Sim
Login do Usuário que registrou a operação
-
DataPesagem
Data e Hora
Sim
Data de execução da Operação
-
Periferico
Inteiro
Sim
Chave interna do periférico que executou essa operação
-
PerifericoCodigo
String(20)
Sim
Código do Periférico que executou essa operação
-
PontoDeControle
String(20)
Sim
Código do Ponto de Controle que executou a operação
-
EstacaoControle
String(20)
Sim
Código da Estação de Controle que executou a operação
-
TipoOperacaoCodigo
Inteiro
Sim
Tipo da Operação executada
1 = Pré-Cadastro, 2 = Pesagem Inicial, 3 = Pesagem Final, 4 = Hsitórico de Passagem, 5 = Acesso, 8 =
30
Pesagem Avulsa, 10 = Atualização de Tara, 11 = Pesagem por Eixos, 12 = Dosagem TipoOperacaoDescricao String(1024) Sim
Descrição do Tipo da 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 Campo
Tipo
Obrigatório
Valores Possíveis
Descrição
Sequencial
Inteiro
Não
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
-
Estado
String
Não
Estado do Motorista
0=Desativado, 1=Ativado
Observacao
String(50)
Não
Observação
-
Data e Hora
Não
Data e Hora da criação do registro
InfoAcompanhantes String(255)
Não
Informação dos Acompanhantes
-
Data
Foto
Array de Não Bytes(2.147.483.647 bytes)
Arquivo de Foto do 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 Campo
Tipo
Obrigatório
Valores Possíveis
Codigo
String(10)
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
Descrição
Sim
Código Sequencial da Reimpressão do Ticket -
Código do Usuário que reimprimiu o Ticket
-
VO LogAplicacao Campo
Tipo
Obrigatório
Valores Possíveis
Descrição
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
-
Funcao
String(240)
Sim
Função do Sistema que gerou do Log
31
Informacao
String(2147483647) Sim
Informações do Log
-
Sequencial
Inteiro 64 bits
Não
Sequencial do Log
-
SistemaDeIntegracao String(50)
Sim
Sistema de Integração que Gerou o Log
-
Tipo
Sim
Tipo do Log
-
Inteiro
VO IntegracaoOCR Campo
Tipo
Obrigatório
Valores Possíveis
Descrição
Sequencial
Inteiro de 64 bits
Sim
Cámpo chave sequencial
-
Data
Data e Hora de Captura do OCR
Sim
Data e Hora do registro do Log
-
PontoDeControle
String(20)
Sim
Ponto de Controle onde a operação foi executada
-
RegraDoOCR
String(8000)
Sim
Regra do OCR aplicada para validação
-
PlacaOCR
String(20)
Sim
Placa capturada pelo OCR
-
PlacaConvergente Inteiro
Sim
Verifica se o OCR validou a placa
1 OCR OK, 0 OCR não validou
CodigoOperacao
Sim
Código da Operação Envolvida
-
String(20)
VO HistoricoPassagem Campo
Tipo
Obrigatório
Descrição
Valores Possíveis
Codigo
String
Não
Ordem do HistoricoPassagem
-
Media
Decimal
Sim
Média
-
Minimo
Decimal
Sim
Mínimo
-
Maximo
Decimal
Sim
Máximo
-
Data
DataTime
Sim
Data e Hora do registro
-
Periferico
Inteiro
Sim
Periférico
-
EstacaoControle
Inteiro
Sim
Estação de Controle
-
OperacaoTicket
Inteiro
Sim
Sequencial da operação do ticket
-
OperacaoTicketEntidade Negocio.Entidade.EOperacoesTicket Sim
Entidade Operacao Ticket
-
TAG
Sim
Tag associada ao registro de pesagem
-
String
Estado
Inteiro
Sim
Estado da passagem: 304169 = aguardando confirmação de pesagem e 304170 pesagem confirmada
EstacaoControleCodigo
String
Sim
Código Estação de Controle
-
PerifericoCodigo
String
Sim
Código Periférico
-
PontoDeControleCodigo
String
Sim
Código do Ponto de Controle
-
32
FlagPossivelIdentificacao Bool
Sim
Código do Ponto de Controle
-
VO CfgAlteracao Campo
Tipo Obrigatório
Valores Possíveis
Descrição
IgnoraTransportadora
Bool
Sim
Indica que o ticket deverá ter sua transportadora desassociada
-
IgnoraEmissor
Bool
Sim
Indica que o ticket deverá ter seu emissor desassociado
-
IgnoraItens
Bool
Sim
Indica que o ticket deverá ter seus itens desassociados
-
IgnoraDocumentos
Bool
Sim
Indica que o ticket deverá ter seus documentos desassociados
-
IgnoraMotorista
Bool
Sim
Indica que o ticket deverá ter seu motorista desassociado
-
IgnoraFatorCorrecao
Bool
Sim
Indica que o ticket deverá ter seus fatores de correção desassociados
-
IgnoraCamposAdicionais Bool
Sim
Indica que o ticket deverá ter seus campos 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] Este método é responsável por:
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. Parâmetros de entrada: - 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 - ErroMSG (String) = Descrição do erro
CadastraTicket [INTERFACE] Este método é responsável por:
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. Parâmetros de entrada: - DadosTicket (VO PreCadastro - Obrigatório) = Dados do Ticket. 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. - ErroMSG (String) = Descrição do erro
CadastraTicketGuardian [INTERFACE] Este método é responsável por: 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. Parâmetros de entrada: - DadosTicket (VO PreCadastro - Obrigatório) = Dados do Ticket. 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, Diferente de 303221 = Erros variados. - ErroMSG (String) = Descrição do erro
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) . Parâmetros de entrada: - PontoControlePonto (String - Obrigatório) = Código do Ponto de Controle Associado a 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. - 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: - 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. - ErroMSG (String) = Descrição do erro
35
CapturaPeso_G4 [OBSOLETO] MÉTODO DE COMPATIBILIZAÇÂO COM O GUARDIAN 4 - PREFERENCIALMENTE UTILIZE O MÉTODO
CapturaPeso! Este 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 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: - 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
ConfirmaTicketUnico [INTERFACE] Método responsável desmarcar para exportação um único ticket já exportado. Deve ser chamado para utilizar o método ExportaTicketUnico Parâmetros de entrada: - 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] Este método é responsável por: Confirmar o recebimento dos dados do método: RetornaVeiculosQuePossamTerPassadoSemPesarPelaBalanca Retornos: - True, se sucesso na operação, caso contrário, false - 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
36
ConsultaIntervencoesManuaisTicket [INTERFACE] EM DESENVOLVIMENTO - Não utilizar Este método é responsável por: 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 Parâmetros de entrada: - 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'. - código (String - Obrigatório) = Código do Produto para Validação. Preencha com '01'. 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. Parâmetros de entrada: - 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. - 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: - Retorna da Função (Lista de VO LogAplicacao) = Registros de Log. - 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 37
ConsultaLogPerifericos [INTERFACE] Método responsável por consultar logs dos periféricos gerados de acordo com os parâmetros passados. Parâmetros de entrada: - 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. - 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 - 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: - Retorna da Função (Lista de VO LogPeriferico) = Registros de Log. - 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
ConsultaMovimentoOCR [INTERFACE] Método responsavel por consultar movimento de operacões executadas com OCR de acordo com os parametros. Parâmetros de entrada: - 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. - dateInicial (Data e Hora - Obrigatório) = Data de Inicio da Pesquisa. - dateFinal (Data e Hora - Obrigatório) = Data Final da Pesquisa. - 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. - produto (String - Obrigatório) = Nome do Produto para Validação. Preencha com 'WS G'. 38
- código (String - Obrigatório) = Código do Produto para Validação. Preencha com '01'. Retornos: - Retorna da Função (Lista de VO Ticket) = Registros de ticket e operaçoes com OCR. - 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
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. Parâmetros de entrada: - 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. - 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
ConsultaTicketsPorPeriodo
[INTERFACE] Exportação ou Consulta de Ticket por período de acordo com a data de abertura do ticket. Parâmetros de entrada: - dataInicial (Data e Hora - Obrigatório) = Data de Início da Pesquisa. - dataFinal (Data e Hora - Obrigatório) = Data Final da Pesquisa. - 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 (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. - ErroMSG (String) = Descrição do erro
ConsultarLogAuditoria [INTERFACE] Este método é responsável por: Consultar os logs de auditoria. Parâmetros de entrada: - 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'. - código (String - Obrigatório) = Código do Produto para Validação. Preencha com '01'. 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!
Este método é responsável por: - 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 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
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. Parâmetros de entrada: - PontoControlePonto (String - Obrigatório) = Código do Ponto de Controle Associado a 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: - Retorno da Função (Inteiro) = ID do comando na Fila. - 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
EnviaMensagem_G4 [OBSOLETO] MÉTODO DE COMPATIBILIZAÇÂO COM O GUARDIAN 4 - PREFERENCIALMENTE UTILIZE OUTRO MÉTODO!
Este método é responsável por: 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 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
ExportaTicketParametro [INTERFACE] Este método é responsável por: Exportação ou Consulta de Ticket por parâmetros. 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 40
- 2º Último Ticket da Placa - 3º Último Ticket do TAG Parâmetros de entrada: - 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. - 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 (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. - ErroMSG (String) = Descrição do erro
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. Parâmetros de entrada: - dataInicial (Data e Hora - Obrigatório) = Data de Início da Pesquisa. - dataFinal (Data e Hora - Obrigatório) = Data Final da Pesquisa. - 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 (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. - ErroMSG (String) = Descrição do erro
ExportaTicketUnico [INTERFACE] Este método é responsável por: Fazer exportação diferenciar de ticket, selecionando e retornando apenas o primeiro ticket disponível para exportação. Parâmetros de entrada: - 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'. - código (String - Obrigatório) = Código do Produto para Validação. Preencha com '01'. Retornos: - Retorno da Função (VO Ticket) = Ticket disponível. - 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
ExportaTicketsMarcados [INTERFACE] Este método é responsável por: 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. - 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
ExportaVeiculosQuePossamTerPassadoSemPesarPelaBalanca [INTERFACE] Este método é responsável por: 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. - 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
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. Parâmetros de entrada: - 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: - 1º Código do Ticket - 2º Último Ticket da Placa - 3º Último Ticket do TAG Parâmetros de entrada: - PontoControle (String - Obrigatório) = Ponto de controle no qual o veículo vai ser identificado. - 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. - lado (String - Obrigatório) = Lado ao qual o veículo vai ser identificado. Valores possíveis A ou B. Retornos: - Retorno da Função (Inteiro) = ID do comando na Fila. - Erro (Inteiro) = Código de Erro Caso Falhe. Valores possíveis: 0 = Não houve erro, Diferente 42
de 0 = Erros variados. - ErroMSG (String) = Descrição do erro
ImportaTicketPreCadastro [INTERFACE] Este método é responsável por: Importar dados de um Ticket em estado de Pré-Cadastro ou Pesagem Inicial Executada. Parâmetros de entrada: - DadosTicket (VO PreCadastro - Obrigatório) = Dados do Ticket. - 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. - ErroMSG (String) = Descrição do erro
ManutencaoTicket [INTERFACE] Este método é responsável por: Alterar o Estado do Ticket. A alteração do estado é aplicada 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 Parâmetros de entrada: - 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. - 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. - 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) = Retorna Verdadeiro (True) em caso de Sucesso de alteração de Estado.
ObtemVersaoWS [INTERFACE] Este método é responsável por: 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. - 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 (String) = Retorno Versão do programa ou Erro de Validação.
43
RefazUltimaOperacao [INTERFACE] Este método é responsável por: 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. O sistema tentará encontrar o Ticket na seguinte ordem de prioridade, de acordo com o parametro que for preenchido: - 1º Código do Ticket - 2º Último Ticket da Placa - 3º Último Ticket do TAG Parâmetros de entrada: - ticketCodigo (String - Opcional desde que “ticketPlaca” ou “ticketTAG” esteja preenchidas) = Código ou Número do Ticket. - ticketPlaca (String - Opcional desde que “ticketCodigo” ou “ticketTAG” esteja preenchidas) = Placa da carreta/vagão. - ticketTAG (String - Opcional desde que “ticketCodigo” ou “ticketPlaca” esteja preenchidas) = TAG, Transponder ou Código de Barras de Identificação Associada do Ticket. - 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) = Retorna Verdadeiro (True) em caso de Sucesso da operação.
RefazUltimaOperacaoII [INTERFACE] Este método é responsável por: 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. O sistema tentará encontrar o Ticket na seguinte ordem de prioridade, de acordo com o parametro que for preenchido: - 1º Código do Ticket - 2º Último Ticket da Placa - 3º Último Ticket do TAG Parâmetros de entrada: - ticketCodigo (String - Opcional desde que “ticketPlaca” ou “ticketTAG” esteja preenchidas) = Código ou Número do Ticket. - ticketPlaca (String - Opcional desde que “ticketCodigo” ou “ticketTAG” esteja preenchidas) = Placa da carreta/vagão. - ticketTAG (String - Opcional desde que “ticketCodigo” ou “ticketPlaca” esteja preenchidas) = TAG, Transponder ou Código de Barras de Identificação Associada do Ticket. - 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'. 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: - Retorno da Função (Booleano) = Retorna Verdadeiro (True) em caso de Sucesso da operação.
RemontaFluxo [INTERFACE] Este método é responsável por: Remonta Fluxo Ticket. A alteração do estado é aplicada apenas em casos de Tickets 44
abertos, ou seja, diferentes de Cancelados e Encerrados. O sistema tentará encontrar o Ticket na seguinte ordem de prioridade, de acordo com o parametro que for preenchido: - 1º Código do Ticket - 2º Último Ticket da Placa - 3º Último Ticket do TAG Parâmetros de entrada: - 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. - codigoFluxo (String - Obrigatório) = Código no novo fluxo do ticket. Retornos: - Retorno da Função (Booleano) = Retorna Verdadeiro (True) em caso de Sucesso da operação. - Erro (Inteiro) = Código de Erro Caso Falhe. Valores possíveis: 0 = Não houve erro, Diferente de 303221 = Erros variados. - ErroMSG (String) = Descrição do erro
RetornaVeiculosQuePossamTerPassadoSemPesarPelaBalanca [INTERFACE] Este método é responsável por: Retornar veículos que possam ter passado sem pesar pela balança Parâmetros de entrada: - 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. - 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
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: - 1º Código do Ticket - 2º Último Ticket da Placa - 3º Último Ticket do TAG Funciona somente Parâmetros de entrada:
45
- PontoControle (String - Obrigatório) = Ponto de controle no qual o veículo vai ser identificado. - ticketCodigo (String - Opcional) = Código ou Número do Ticket. - ticketPlaca (String - Opcional) = Placa da Carreta. - ticketTAG (String - Opcional) = TAG, Transponder ou Código de Barras de Identificação Associada do Ticket. - 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: - 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
SolicitaFotoAvulsa [INTERFACE] Este método é responsável por: 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). Parâmetros de entrada: - 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. - 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 (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] Este método é responsável por: 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). Parâmetros de entrada: - idSolicitacaoAvulsa (String - Inteiro) = Código de identificação da solicitação de foto avulsa. - 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 (Objeto de VO RetornoFotoAvulsa) = Informações sobre o sucesso ou não de uma operação anteriormente solicitada.
46
TrocaFluxoTicket [INTERFACE] Este método é responsável por: Alterar o Fluxo Ticket. A alteração do estado é aplicada 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 parametro que for preenchido: - 1º Código do Ticket - 2º Último Ticket da Placa - 3º Último Ticket do TAG Parâmetros de entrada: - 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. - codigoFluxo (String - Obrigatório) = Código no novo fluxo do ticket. Retornos: - Retorno da Função (Booleano) = Retorna Verdadeiro (True) em caso de Sucesso da operação. - Erro (Inteiro) = Código de Erro Caso Falhe. Valores possíveis: 0 = Não houve erro, Diferente de 303221 = Erros variados. - ErroMSG (String) = Descrição do erro
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 o o 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. 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; 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. 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 Recurso/funcionalidade
Guardian
Guardian EIXO
Guardian TAG
Guardian TI
Guardian 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.
Importação
Exportação GUARD
MS SQL
Arquivo
Arquivo texto
MS SQL
DB GUAR
MIE
MIE
DB GUAR
DB MIE
GUARD IAN
DB 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 [
]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] Campo
Tipo
Obrigatório
Descrição
TCK_PLACA_CARRETA
String(20)
SIM
Placa da Carreta
TCK_CODIGO
String(30)
SIM
Número/Código do Ticket
TCK_INDICA_PESAGEM_FERRO VIARIA
Booleano
SIM
Quando Verdadeira Indica que o ticket é de pesagem ferroviária
Valores Possíveis -
TCK_VERIFICA_PESO_LIQUIDO _MAIOR_ZERO
Booleano
SIM
Quando Verdadeira Indica que o resultado do Peso Líquido na Pesagem 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
-
TCK_PESO_BRUTO_ORIGEM
Decimal
NÃO
TCK_IDT_ASSOCIADA
String(250)
NÃO
Observação Peso de referência para checagem do peso total na primeira pesagem do veículo Identificação associada referente ao 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
-
TRP_RAZAO_SOCIAL
String(50)
NÃO
Código da Transportadora associada Razão Social da Transportadora associada
-
Operações do ticket - [OPERACOES] Campo OTK_SEQUENCIAL
Tipo Inteiro Longo
Obrigatório SIM SIM
Descrição Sequencial da operação executada no Ticket
-
Placa do Veículo
-
OTK_PLACA_VEICULO
String
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 SAO
String
TVC_CODIGO
String
OTK_COMPARTIMENTO
NÃO NÃO
Inteiro
Valores Possíveis
Unidade de Medida Após Conversão do Peso
-
Tipo do Veículo
-
Número do Compartimento referente a esse registro de pesagem
-
Valor do fator correção obtido a partir da lista de fatores de correção da lista
-
Valor do fator correção obtido a partir da expressão calculada
-
NÃO OTK_FATOR_CORRECAO_LISTA OTK_FATOR_CORRECAO_CALC ULO OTK_PESO
Decimal NÃO Decimal Decimal
NÃO NÃO
OTK_TARA_VEICULO
Decimal
Peso Capturado em kg Representa o peso total das embalagens vazias em kg (Tara do Veículo)
-
-
NÃO OTK_FATOR_CONVERSAO OTK_PESO_LIQUIDO OTK_PESO_LIQUIDO_CORRIGO _LISTA OTK_PESO_LIQUIDO_CORRIGO _CALCULO
Decimal
Fator de Conversão
-
NÃO
Representa o peso líquido obtido após a pesagem final em kg
-
NÃO
Representa o peso líquido corrigido após a pesagem final em kg Representa o peso líquido corrigido pela fórmula após a pesagem final em kg Representa o peso líquido convertido, apresentado o fator e unidade após conversão após a pesagem final em kg
Decimal Decimal NÃO Decimal NÃO
OTK_PESO_LIQUIDO_CONVERT IDO OTK_PESO_BRUTO_VEICULO USR_LOGIN
Decimal
-
-
NÃO
Valor do peso bruto do veículo que registrou a pesagem
-
SIM
Login do Usuário que registrou a operação
-
Data de execução da Operação
-
Código do Periférico que executou essa operação
-
Decimal EXP SIM
OTK_DATA
Data e Hora NÃO
PRF_CODIGO
String(20)
52
LCL_CODIGO PCL_CODIGO
SIM
Código do Ponto de Controle que executou a operação
SIM
Código da Estação de Controle que executou a operação
String(20) String(20)
Tipo da Operação executada
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 por Eixos, 12 = Dosagem
Descrição do Tipo da Operação
-
Código da Operação
-
Indica estado da operação
FALSO = CANCELADA
Indica o Lado que a operação foi realizada
-
SIM
TOP_CODIGO
Inteiro
-
SIM TOP_DESCRICAO
String(50) SIM
OPR_CODIGO
String(20) SIM
OTK_ESTADO
Booleano SIM
OTK_LADO
Inteiro
Campos adicionais do Ticket - [CAMPOS] Campo
Tipo
Obrigatório
Descrição
Valores Possíveis
CAT_NUMERO
Inteiro
SIM
Número do Campo Adicional
-
CAT_VALOR
String
SIM
Valor do campo adicional
-
Documentos do Ticket - [DOCUMENTOS] Campo
Tipo
Obrigatório
Descrição
Valores Possíveis
DCT_CODIGO
String
SIM
Código sequencial do documento no 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] Campo
Tipo
Obrigatório
Descrição
Valores Possíveis
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] Campo
Tipo
Obrigatório
Descrição
Valores Possíveis
LFC_NUMERO
Inteiro
SIM
Número sequencial correspondente a 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] Campo OTK_SEQUENCIAL EIO_NUMERO_EIXO
Tipo Inteiro Longo Inteiro
Obrigatório
Descrição
Valores Possíveis
SIM
Sequencial da operação executada no Ticket
-
SIM
Número do eixo ou grupo de eixos capturado
-
EIO_PESO_ORIGEM
Decimal
SIM
Peso nominal do eixo ou grupo de eixos
EIO_DATA
Data e Hora
SIM
Data da captura
-
EIO_DIFERENCA
Decimal
NÃO
Diferença entre o peso nominal e 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° Configuração
Significado
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 []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
o
Campos adicionais do Ticket
o
55
Indicador de Grupo: [DocumentosTicket]
Itens do Ticket
o
Indicador de Grupo: [CampoAdicional]
Documentos do Ticket
o
Indicador de Grupo: [Ticket]
Indicador de Grupo: [Itens]
Fatos de correção do Ticket
o
Indicador de Grupo: [FatoresCorreçã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] Campo
Tipo
TCK_PLACA_CAR RETA String(20) OTK_PLACA_VEI CULO String(20) TCK_INDICA_PE SAGEM_FERROV IARIA Booleano
Obrigatório
Descrição
Valores Possíveis
SIM
Placa da Carreta
NÃO
Placa do Veículo
Valor padrão: PlacaCarreta
SIM
Quando Verdadeira Indica que o ticket é de pesagem ferroviária
Zero(0) ou Um (1)
TCK_VERIFICA_ PESO_LIQUIDO_ MAIOR_ZERO TCK_PESO_ALV O
Booleano
SIM
Quando Verdadeira Indica que o resultado do Peso Líquido na Pesagem Final pode ser 0 para esse veículo Zero(0) ou Um (1)
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
-
EMS_RAZAO_SO CIAL
String(50)
NÃO
Razão social do Emissor Associado
FLX_CODIGO
String(50)
NÃO
Código do Fluxo Associado
-
MTR_CODIGO
String(20)
NÃO
Código do Motorista associado
-
56
MTR_CPF
String(20)
NÃO
CPF do Motorista Associado
MTR_NOME TCK_OBSERVAC AO TCK_PESO_BRU TO_ORIGEM TCK_IDT_ASSOC IADA
String(50)
NÃO
Nome do Motorista Associado
String(8000)
NÃO
-
Decimal
NÃO
String(250)
NÃO
Observação Peso de referência para checagem do peso total na primeira pesagem do veículo Identificação associada referente ao TAG, 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
TVC_CODIGO
String
NÃO
Tipo do Veículo
Valores do cadastro de veiculo do Guardian. (Valores padrão do DENIT)
TRP_CODIGO TRP_RAZAO_SO CIAL OTK_UNIDADE_ APOS_CONVERS AO OTK_FATOR_CO NVERSAO
String(20)
NÃO
Código da Transportadora associada
-
String(50)
NÃO
Razão Social da Transportadora associada
String(10)
NÃO
Unidade de Medida Após Conversão do Peso
Decimal
NÃO
OPR_CODIGO
String(20)
SIM
-
-
Fator de Conversão Código da Operação de “pré-cadastro” Cadastrado no Guardian.
Campos adicionais do Ticket - [CAMPOS] Campo
Tipo
Obrigatório
Descrição
Valores Possíveis
TCK_PLACA_CARRETA
String(20)
SIM
Placa da Carreta
-
CAT_NUMERO
Inteiro
SIM
Número do Campo Adicional
-
CAT_VALOR
String
SIM
Valor do campo adicional
-
Documentos do Ticket - [DOCUMENTOS] Campo
Tipo
Obrigatório
Descrição
Valores Possíveis
TCK_PLACA_CARRETA
String(20)
SIM
Placa da Carreta
-
DCT_CODIGO
String
SIM
Código sequencial do documento no Ticket
-
DCT_DESCRICAO
String
SIM
Descrição ou número do documento
-
DCT_PESO_ORIGEM
Decimal
SIM
Peso do Documento
-
Itens do Ticket - [ITENS] Campo
Tipo
Obrigatório
Descrição
Valores Possíveis
TCK_PLACA_CARRETA
String(20)
SIM
Placa da Carreta
-
ITK_CODIGO
Inteiro
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
-
57
Fatores de correção do Ticket - [FATORES] Campo TCK_PLACA_CARRETA
Tipo String(20)
Obrigatório
Descrição
Valores Possíveis
SIM
Placa da Carreta
-
LFC_NUMERO
Inteiro
SIM
Número sequencial correspondente a 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
-
Configuração Alteração - [ConfigAlteracao] Campo
K
Tipo
Obrigatório
Descrição
IMP_SEQUENCIAL
Inteiro Longo
SIM
Sequencial Automático
TCK_PLACA_CARRETA
String(20)
SIM
CFA_CONFIG_NUMERO
Inteiro
SIM
CFA_CONFIG_VALOR
Inteiro
SIM
IMP_DATA
Data e hora
SIM
Placa da Carreta Numero da configuração que se deseja alterar 1(Verdadeiro) exclui dado do ticket 0(Falso) mantém ou altera dado Data e hora que o dado foi incluído na tabela.
IMP_FLAG
Inteiro
SIM
Controla leitura e escrita do dado na tabela
Valores Possíveis Preenchimento automático 1,2,3,4,5,6,7,8 e 9 0 ou 1 I - Incluído P - Pronto L - Lido
58
BANCO TANQUE Recurso/funcionalidade
Guardian
Guardian EIXO
Guardian TAG
Banco Tanque
Guardian TI
Guardian PRO
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 GUARDIA
Importação
MS SQL
GUARDIAN
DB
DB
GUARDIAN
DB TANQUE
DB 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
MS SQL
GUARDIAN
MIE
DB Tanque
DB MIE
MIE
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° Configuração
Significado
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 Campo
IMP_SINALIZACAO
Tipo
String(1)
Obrigatório
SIM
Descrição
Sinalização da Importação
Valores Possíveis L – Liberado I – Importando E - Exportando
tbImpTicket – Tabela de dados do Ticket Campo
K
Tipo
Obrigatório
Descrição
Valores Possíveis Preenchimento automático Código da operação cadastrada no Guardian como pré-cadastro
IMP_SEQUENCIAL
Inteiro Longo
NÃO
Sequencial Automático
OPR_CODIGO
String(20)
SIM
Código da Operação de pré-cadastro.
TCK_PLACA_CARRETA
String(20)
SIM
Placa da Carreta
OTK_PLACA_VEICULO
String(20)
NÃO
Placa do Veículo
Valor padrão: PlacaCarreta
TCK_INDICA_PESAGEM _FERROVIARIA
Booleano
SIM
Quando Verdadeira Indica que o ticket é de pesagem ferroviária
Zero (0) ou um (1)
Zero (0) ou um (1)
TCK_VERIFICA_PESO_L IQUIDO_MAIOR_ZERO
Booleano
SIM
Quando Verdadeira Indica que o resultado do Peso Líquido na Pesagem 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
-
EMS_RAZAO_SOCIAL
String(50)
NÃO
Razão social do Emissor Associado
FLX_CODIGO
String(50)
NÃO
Código do Fluxo Associado
-
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
TCK_OBSERVACAO
String(8000)
NÃO
-
TCK_PESO_BRUTO_ORI GEM
Decimal
NÃO
TCK_IDT_ASSOCIADA TCK_TIPO_FATOR_COR RECAO
String(250)
NÃO
Observação Peso de referência para checagem do peso total na primeira pesagem do veículo Identificação associada referente ao TAG, Transponder ou Código de Barras
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
TVC_CODIGO
String
NÃO
Tipo do Veículo
Valores do cadastro de veiculo do Guardian. (Valores padrão do DENIT)
TRP_CODIGO
String(20)
NÃO
TRP_RAZAO_SOCIAL String(50) OTK_UNIDADE_APOS_C ONVERSAO String(10)
NÃO
Código da Transportadora associada Razão Social da Transportadora associada Unidade de Medida Após Conversão do Peso
NÃO
-
-
-
62
K
OTK_FATOR_CONVERS AO
Decimal
NÃO
IMP_DATA
Data e Hora
SIM
IMP_FLAG
String(1)
SIM
TCK_CODIGO
String(30)
NÃO
Fator de Conversão Indica a data e hora que o dado foi incluído na tabela Campo de Controle de Leitura e escrita do dado na tabela Este campo é atualizado na tarefa de exportação do Ticket no estado de precadastro do MIE. Não deve ser preenchido.
I – Incluído L - Lido
tbImpCampAdicionalTicket – Tabela de campos adicionais do Ticket Campo
Tipo
Obrigatório
Descrição
Valores Possíveis Preenchimento automático
IMP_SEQUENCIAL
Inteiro Longo
NÃO
Sequencial Automático
K
TCK_PLACA_CARRETA
String(20)
SIM
-
K
CAT_NUMERO
Inteiro
SIM
Placa da Carreta(chave de pesquisa) Número do Campo Adicional único por ticket.
CAT_VALOR
String
SIM
-
IMP_DATA
Data e Hora
SIM
IMP_FLAG
String(1)
SIM
Valor do campo adicional Indica a data e hora que o dado foi incluído na tabela Campo de Controle de Leitura e escrita do dado na tabela
K
-
I – Incluído L - Lido
tbImpDocumentoTicket – Tabela de documentos do Ticket Campo
K K
Tipo
Obrigatório
Descrição
Valores Possíveis
IMP_SEQUENCIAL
Inteiro Longo
NÃO
Sequencial Automático
Preenchimento automático
TCK_PLACA_CARRETA
String(20)
SIM
Placa da Carreta
-
DCT_CODIGO
String
SIM
Código sequencial único do documento por Ticket
DCT_DESCRICAO
String
SIM
Descrição ou número do documento
-
DCT_PESO_ORIGEM
Decimal
SIM
Peso do Documento
-
IMP_DATA
Data e Hora
SIM
Indica a data e hora que o dado foi incluído na tabela
-
SIM
Campo de Controle de Leitura e escrita do dado na tabela
I – Incluído L - Lido
K IMP_FLAG
String(1)
tbImpItensTicket – Tabela de Itens do Ticket Campo
K K
Tipo
Obrigatório
Descrição
Valores Possíveis
IMP_SEQUENCIAL
Inteiro Longo
NÃO
Sequencial Automático
Preenchimento automático
TCK_PLACA_CARRETA
String(20)
SIM
Placa da Carreta
-
ITK_CODIGO
Inteiro
SIM
Código sequencial único dos itens do Ticket
ITM_CODIGO
String(20)
SIM
Código do Item
-
ITM_NOME
String(50)
SIM
Nome do Item
-
IMP_DATA
Data e Hora
SIM
Indica a data e hora que o dado foi incluído na tabela
-
SIM
Campo de Controle de Leitura e escrita do dado na tabela
I – Incluído L - Lido
K IMP_FLAG
63
String(1)
tbImpListaFatoresCorrecaoTicket – Tabela de importação da lista de fatores de correção do Ticket Campo
K K
Tipo
Obrigatório
Descrição
Valores Possíveis
IMP_SEQUENCIAL
Inteiro Longo
NÃO
Sequencial Automático
Preenchimento automático
TCK_PLACA_CARRETA
String(20)
SIM
Placa da Carreta
-
LFC_NUMERO
Inteiro
SIM
Número sequencial único correspondente a cada faixa por ticket.
-
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
-
SIM
Indica a data e hora que o dado foi incluído na tabela
-
SIM
Campo de Controle de Leitura e escrita do dado na tabela
I – Incluído L - Lido
IMP_DATA
Data e Hora
K IMP_FLAG
String(1)
Configuração Alteração - [ConfigAlteracao] Campo
K
Tipo
Obrigatório
Descrição
IMP_SEQUENCIAL
Inteiro Longo
SIM
Sequencial Automático
TCK_PLACA_CARRETA
String(20)
SIM
CFA_CONFIG_NUMERO
Inteiro
SIM
CFA_CONFIG_VALOR
Inteiro
SIM
IMP_DATA
Data e hora
SIM
Placa da Carreta Numero da configuração que se deseja alterar 1(Verdadeiro) exclui dado do ticket 0(Falso) mantém ou altera dado Data e hora que o dado foi incluído na tabela.
IMP_FLAG
Inteiro
SIM
Controla leitura e escrita do dado na tabela.
Valores Possíveis Preenchimento automático 1,2,3,4,5,6,7,8 e 9 0 ou 1 I - Incluído P - Pronto 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 Campo
EXP_SINALIZACAO
Tipo
String(1)
Obrigatório
SIM
Descrição
Sinalização da Exportação
Valores Possíveis L – Liberado I – Importando E - Exportando
tbExpTicket – Tabela de exportação do Ticket Campo
Tipo
Obrigatório
Descrição
EXP_SEQUENCIAL
Inteiro Longo
SIM
Sequencial Automático
TCK_CODIGO
String(30)
SIM
Número/Código do Ticket
TCK_INDICA_PESAGEM_FERRO VIARIA
Booleano
SIM
Quando Verdadeira Indica que o ticket é de pesagem ferroviária
Valores Possíveis Preenchimento automático
TCK_VERIFICA_PESO_LIQUIDO _MAIOR_ZERO
Booleano
SIM
Quando Verdadeira Indica que o resultado do Peso Líquido na Pesagem 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
-
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
-
TCK_PESO_BRUTO_ORIGEM
Decimal
NÃO
Observação Peso de referência para checagem do peso total na primeira pesagem do veículo
TCK_PLACA_CARRETA
String(20)
SIM
-
TCK_IDT_ASSOCIADA
String(250)
NÃO
Placa da Carreta Identificação associada referente ao TAG, Transponder ou Código de Barras
TCK_TIPO_FATOR_CORRECAO
Inteiro
NÃO
NÃO UTILIZAR - Em manutenção
-
TRP_CODIGO
String(20)
NÃO
-
TRP_RAZAO_SOCIAL
String(50)
NÃO
EXP_DATA
Data e Hora
SIM
EXP _FLAG
String(1)
SIM
Código da Transportadora associada Razão Social da Transportadora associada Indica a data e hora que o dado foi incluído na tabela Campo de Controle de Leitura e escrita do dado na tabela
-
-
I – Incluído L - Lido
tbExpOperacoesTicket – Tabela de exportação das operações executada do ticket Campo
65
Tipo
Obrigatório
Descrição
Valores Possíveis
Preenchimento automático
EXP_SEQUENCIAL
Inteiro Longo
SIM
Sequencial Automático
TCK_CODIGO
String(30)
SIM
Número/Código do Ticket
TCK_PLACA_CARRETA
String(20)
SIM SIM
Placa da Carreta
-
Sequencial da operação executada no Ticket
-
OTK_SEQUENCIAL
Inteiro Longo 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 SAO
String
TVC_CODIGO
String
OTK_COMPARTIMENTO
NÃO NÃO
Inteiro
Unidade de Medida Após Conversão do Peso
-
Tipo do Veículo
-
Número do Compartimento referente a esse registro de pesagem
-
Valor do fator correção obtido a partir da lista de fatores de correção da lista
-
Valor do fator correção obtido a partir da expressão calculada
-
NÃO OTK_FATOR_CORRECAO_LISTA
Decimal NÃO
OTK_FATOR_CORRECAO_CALC ULO
Decimal
OTK_PESO
Decimal
NÃO NÃO
OTK_TARA_VEICULO
Decimal
Peso Capturado em kg Representa o peso total das embalagens vazias em kg (Tara do Veículo)
-
-
NÃO OTK_FATOR_CONVERSAO OTK_PESO_LIQUIDO OTK_PESO_LIQUIDO_CORRIGO _LISTA OTK_PESO_LIQUIDO_CORRIGO _CALCULO
Decimal
Fator de Conversão
-
NÃO
Representa o peso líquido obtido após a pesagem final em kg
-
NÃO
Representa o peso líquido corrigido após a pesagem final em kg Representa o peso líquido corrigido pela fórmula após a pesagem final em kg Representa o peso líquido convertido, apresentado o fator e unidade após conversão após a pesagem final em kg
Decimal Decimal NÃO Decimal NÃO
OTK_PESO_LIQUIDO_CONVERT IDO OTK_PESO_BRUTO_VEICULO USR_LOGIN
Decimal
-
-
NÃO
Valor do peso bruto do veículo que registrou a pesagem
-
SIM
Login do Usuário que registrou a operação
-
Decimal EXP SIM
OTK_DATA PRF_CODIGO LCL_CODIGO PCL_CODIGO
Data e Hora
Data de execução da Operação
-
NÃO
Código do Periférico que executou essa operação
-
SIM
Código do Ponto de Controle que executou a operação
-
SIM
Código da Estação de Controle que executou a operação
String(20) String(20) String(20)
Tipo da Operação executada
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, 12 = Dosagem
Descrição do Tipo da Operação
-
Código da Operação
-
SIM
TOP_CODIGO
Inteiro SIM
TOP_DESCRICAO
String(50) SIM
OPR_CODIGO
String(20)
66
SIM OTK_ESTADO
Booleano
Indica estado da operação
FALSO = CANCELADA
Indica o Lado que a operação foi realizada
-
SIM
Indica a data e hora que o dado foi incluído na tabela
-
SIM
Campo de Controle de Leitura e escrita do dado na tabela
I – Incluído L – Lido
SIM OTK_LADO
Inteiro
EXP_DATA
Data e Hora
EXP _FLAG
String(1)
tbExpCampAdicionalTicket – Tabela de exportação dos campos adicionais do Ticket Campo
Tipo
Obrigatório
Descrição
Valores Possíveis Preenchimento automático
EXP_SEQUENCIAL
Inteiro Longo
SIM
Sequencial Automático
TCK_CODIGO
String(30)
SIM
Número/Código do Ticket
TCK_PLACA_CARRETA
String(20)
SIM
Placa da Carreta
-
CAT_NUMERO
Inteiro
SIM
Número do Campo Adicional
-
CAT_VALOR
String
SIM
-
EXP_DATA
Data e Hora
SIM
EXP FLAG
String(1)
SIM
Valor do campo adicional Indica a data e hora que o dado foi incluído na tabela Campo de Controle de Leitura e escrita do dado na tabela
I – Incluído L - Lido
tbExpDocumentoTicket – Tabela de exportação dos documentos do Ticket Campo
Tipo
Obrigatório
Descrição
Valores Possíveis Preenchimento automático
EXP_SEQUENCIAL
Inteiro Longo
SIM
Sequencial Automático
TCK_CODIGO
String(30)
SIM
Número/Código do Ticket
TCK_PLACA_CARRETA
String(20)
SIM
Placa da Carreta
-
DCT_CODIGO
String
SIM
Código sequencial do documento no 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
-
SIM
Indica a data e hora que o dado foi incluído na tabela
-
SIM
Campo de Controle de Leitura e escrita do dado na tabela
I – Incluído L - Lido
EXP_DATA
Data e Hora
EXP FLAG
String(1)
tbExpItensTicket – Tabela de exportação dos itens do Ticket Campo
Tipo
Obrigatório
Descrição
Valores Possíveis Preenchimento automático
EXP_SEQUENCIAL
Inteiro Longo
SIM
Sequencial Automático
TCK_CODIGO
String(30)
SIM
Número/Código do Ticket
TCK_PLACA_CARRETA
String(20)
SIM
Placa da Carreta
-
ITM_CODIGO
String(20)
SIM
Código do Item
-
ITM_NOME
String(50)
SIM
Nome do Item
-
SIM
Indica a data e hora que o dado foi incluído na tabela
-
SIM
Campo de Controle de Leitura e escrita do dado na tabela
I – Incluído L - Lido
EXP_DATA EXP_FLAG
67
Data e Hora String(1)
tbExpListaFatoresCorrecaoTicket – Tabela de exportação da lista dos fatores de correção do Ticket Campo
Tipo
Obrigatório
Descrição
Valores Possíveis Preenchimento automático
EXP_SEQUENCIAL
Inteiro Longo
SIM
Sequencial Automático
TCK_CODIGO
String(30)
SIM
Número/Código do Ticket
TCK_PLACA_CARRETA
String(20)
SIM
Placa da Carreta
-
LFC_NUMERO
Inteiro
SIM
Número sequencial correspondente a 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
-
SIM
Indica a data e hora que o dado foi incluído na tabela
-
SIM
Campo de Controle de Leitura e escrita do dado na tabela
I – Incluído L - Lido
EXP_DATA
Data e Hora
EXP_FLAG
String(1)
tbExpEixosOperacao – Tabela de exportação dos eixos capturado na operação do Ticket Campo
Tipo
Obrigatório
Descrição
Valores Possíveis Preenchimento automático
EXP_SEQUENCIAL
Inteiro Longo
SIM
Sequencial Automático
TCK_CODIGO
String(30)
SIM
Número/Código do Ticket
TCK_PLACA_CARRETA
String(20)
SIM
Placa da Carreta
-
SIM
Sequencial da operação executada no Ticket
-
SIM
Número do eixo ou grupo de eixos capturado
-
OTK_SEQUENCIAL EIO_NUMERO_EIXO
Inteiro Longo Inteiro
EIO_PESO_ORIGEM
Decimal
SIM
Peso nominal do eixo ou grupo de eixos
EIO_DATA
Data e Hora
SIM
Data da captura
-
EIO_DIFERENCA
Decimal
NÃO
Diferença entre o peso nominal e o capturado quando acima
EIO_DIFERENCA_MAXIMA_PER MITIDA
Decimal
SIM
Diferença máxima permitida
-
SIM
Indica a data e hora que o dado foi incluído na tabela
-
SIM
Campo de Controle de Leitura e escrita do dado na tabela
I – Incluído L - Lido
EXP_DATA EXP_FLAG
Data e Hora String(1)
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 Av. José Ferreira Batista, 2941 - Jardim Ipanema CEP 16052-000 Fone: (18) 3303-7000 Fax: (18) 3303-7050
MARINGÁ - PR Av. Colombo, 6580 - Jd. Universitário CEP 87020-000 Fone: (44) 3225-1991 Fax: (44) 3225-1991
BELÉM - PA Rua Boa Ventura, 1701 - Bairro Fátima CEP 66070-060 Fone: (91) 3182-8900 Fax: (91) 3182-8950
PORTO ALEGRE (CANOAS) - RS R. Augusto Severo, 36 - Nossa Senhora das Graças CEP 92110-390 Fone: (51) 3427-4822 Fax: (51) 3427-4818
BELO HORIZONTE - MG Av. Portugal, 5011 - Bairro Itapoã CEP 31710-400 Fone: (31) 3448-5500 Fax: (31) 3491-5776
RECIFE - PE R. D. Arcelina de Oliveira, 48 - B. Imbiribeira CEP 51200-200 Fone: (81) 3339-4774 Fax: (81) 3339-6200
CAMPINAS (VALINHOS) - SP Av. Dr. Altino Gouveia, 827 - Jardim Pinheiros - Valinhos - SP CEP 13274-350 Fone: (19) 3829-5800 / Fax: (19) 3829-5810
RIBEIRÃO PRETO - SP R. Iguape, 210 - B. Jardim Paulista CEP 14090-090 Fone: (16) 3968-4800 Fax: (16) 3968-4812
CAMPO GRANDE - MS Av. Eduardo Elias Zahran, 2473 - Jd. Alegre CEP 79004-000 Fone: (67) 3303-9600 Fax: (67) 3303-9650
RIO DE JANEIRO - RJ R. da Proclamação, 574 - Bonsucesso CEP 21040-282 Telefax: (21) 3867-1393/95/96/98/99/1444
CHAPECÓ - SC R. Tiradentes, 80 - Bela Vista CEP 89804-060 Fone: (49) 3324-0331 Fax: (49) 3324-0331
SALVADOR (LAURO DE FREITAS) - BA Loteamento Varandas Tropicais, S/N - Quadra 1 - Lote 20 - Pitangueira CEP 42700-000 Fone: (71) 3289-9000 Fax: (71) 3289-9000
CUIABÁ - MT Av. Miguel Sutil, 4962 - Jardim Leblon CEP 78060-000 Fone: (65) 3928-9400 Fax: (65) 3928-9450
SANTOS - SP R. Professor Leonardo Roitman, 27 - V. Matias CEP 11015-550 Fone: (13) 2202-7900 Fax: (13) 2202-7950
CURITIBA - PR R. 24 de Maio, 1666 - B. Rebouças CEP 80220-060 Fone: (41) 3213-3350 Fax: (41) 3213-3350
SÃO JOSÉ CAMPOS - SP R. Icatu, 702 - Parque Industrial CEP 12237-010 Fone: (12) 3934-9211 Fax: 3934-9278
FORTALEZA - CE R. Padre Mororó, 915 - Centro CEP 60015-220 Fone: (85) 3391-8100 Fax: (85) 3391-8150
SÃO PAULO (SÃO BERNARDO DO CAMPO) - SP R. Manoel Cremonesi, 1 - Jardim Belita CEP 09851-330 Fone: (11) 4356-9395/9404 (11) 4356-9462
GOIÂNIA - GO Av. Laurício Pedro Rasmussen, 357 - Vila Santa Isabel CEP 74620-030 Fone: (62) 3202-0344 Fax: (62)3202-0344
UBERLÂNDIA - MG R. Ipiranga, 297 - Cazeca CEP 38400-036 Fone: (34) 3215-0990 Fax: (34) 3215-0990
MANAUS - AM R. Ajuricaba, 999 - B. Cachoeirinha CEP 69065-110 Fone: (92) 3635-0441 Fax: (92) 3233 0787
VITÓRIA - ES R. Pedro Zangrandi, 395 - Jardim Limoeiro - Serra - ES 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: [email protected]
3474395
CONTEÚDO DESTE MANUAL SUJEITO A MUDANÇAS SEM PRÉVIO AVISO
RE: 04-11-14
70
