Manual Do Usuario Ti Instalacao e Interface de Dados Guardian Versao 6.7

guardianPRO guardianTI

guardianTAG guardianEIXO guardian

Manual do Usuário - TI

INSTALAÇÃO E INTERFACE DE DADOS

www.toledobrasil.com.br

Manual válido para versão 6.7

do Guardian.

http://www.toledobrasil.com.br/

2

ÍNDICE GERAL

1. INSTALAÇÃO .................................................................................................................... 4

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

Controle de Licenças ...................................................................................................................................................... 16

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

Requisitos mínimos do sistema ...................................................................................................................................... 17

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

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

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

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

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

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

WEB SERVICE GUARDIAN (WS) ............................................................................................................................. 19 4.1.1 WEB METODOS ..................................................................................................................................................... 19 4.1.2 ESTRUTURAS E TABELAS .................................................................................................................................. 20 4.1.3 WEB METODOS - DETALHAMENTO ................................................................................................................. 33

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

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

BANCO TANQUE ......................................................................................................................................................... 59 Tabelas de importação .............................................................................................................................................................. 59 Tabelas de exportação .............................................................................................................................................................. 59 Funcionamento da Importação ................................................................................................................................................. 60 Funcionamento Alteração do Ticket ........................................................................................................................................ 60 Atualização Código do Ticket no Banco Tanque (a partir da versão 6.6.78) .......................................................................... 61 Estrutura das Tabelas................................................................................................................................................................ 62 Funcionamento da Exportação ................................................................................................................................................. 64 Estrutura das Tabelas................................................................................................................................................................ 65

3

Limpeza .................................................................................................................................................................................... 68

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

4

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

5

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.

6

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.

7

Instalação do SQL Server

8

Instalação do GTT Clique em Avançar nas próximas telas.

9

Instalação do MIE Clique em Continuar e/ou Próximo nas próximas telas.

10

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.

11

Clique em Configurar.

Na tela de Configuração do Banco de Dados Guardian, efetuar as configurações destacadas abaixo: Em seguida configure o servidor de hardkey.

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

Selecionar esta opção para criar o banco. Será sugerido o nome GUARDIAN.

O ponto faz referência ao computador local e pode ser substituído pelo nome do computador.

O instalador do Guardian cria uma instância SQL durante a instalação do programa, nomeada SQLEXPRESS.

12

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.

13

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.

14

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.

15

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

16

2. COMPOSIÇÃO DO SISTEMA A solução Guardian está distribuída em cinco aplicativos, com diferentes responsabilidades, que irão auxiliar na configuração e operação do ambiente:

APLICATIVO RESPONSABILIDADE

Assistente de Inicialização do Guardian

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.

Guardian Configuração

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.

Guardian Operação

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.

Guardian Service 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 de Contingência

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 RESPONSABILIDADE

Servidor de Hardkey

Controle de licença centralizado.

* MIE

Importação e exportação de arquivos texto. *Será ativado/configurado somente quando houver integração de dados TXT ou BT

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

GTT 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.

17

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:

18

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:

19

4. INTEGRAÇÃO DE DADOS

Recurso/funcionalidade Guardian Guardian EIXO

Guardian TAG

Guardian TI

Guardian PRO

INTEGRAÇÃO DE DADOS

WEB SERVICE GUARDIAN (WS)

(Versão 6.7.120)


Guardian TAG

Guardian TI

Guardian PRO

WEB SERVICE

Web Service responsável pela interface entre o Guardian e um Sistema de Retaguarda, Legado ou

ERP.

Por isso os Web Metodos que podem ser utilizados nas Integrações entre sistemas estarão indicados

nessa documentação com a Tag [INTERFACE].

Atenção!!!

Os Web Métodos indicados com a Tag [OBSOLETOS], preferencialmente, não deve ser utilizado

pois estão disponíveis apenas para compatibilização com versões anteriores do Guardian.

Todas as datas, com campos ou parâmetros no formato DATA E HORA estão sendo trafegadas no

seguinte formato: YYYY-MM-DDTHH:mm:SS que é padrão do .Net exemplo: 2012-01-

14T15:58:00.

Todas as datas, com campos ou parâmetros no formato STRING estão sendo trafegadas no

seguinte formato: DD/MM/YYYY HH:mm:SS.

Antes de executar as funções abaixo, configure a conexão com o banco de dados através do

programa CFG_WS_GUARDIAN.EXE, que se encontra na pasta bin do diretório virtual do

WS_GUARDIAN_PLUS

4.1.1 WEB METODOS

Método Status

AcionaCancela Disponível

AcionaCancela_G4 Obsoleto

AlteraTicketGuardian Disponível

CadastraTicket Obsoleto

CadastraTicketGuardian Disponível

CapturaPeso Disponível

CapturaPeso_G4 Obsoleto

ConfirmaLeituraTicketsMarcados Disponível

ConfirmaTicketUnico Disponível

ConfirmaVeiculosQuePossamTerPassadoSemPesarPelaBalanca Disponível

ConsultaIntervencoesManuaisTicket * Disponível

ConsultaLogAplicacao Disponível

ConsultaLogPerifericos Disponível

ConsultaMovimentoOCR Disponível

ConsultaPedidoDeExecucao Disponível

ConsultarLogAuditoria Disponível

ConsultaTicketsPorPeriodo Disponível

http://services.toledobrasil.com.br/WS_GUARDIAN_67/#wm_AcionaCancela

http://services.toledobrasil.com.br/WS_GUARDIAN_67/#wm_AcionaCancelaG4

http://services.toledobrasil.com.br/WS_GUARDIAN_67/#wm_AlteraTicketGuardian

http://services.toledobrasil.com.br/WS_GUARDIAN_67/#wm_CadastraTicket

http://services.toledobrasil.com.br/WS_GUARDIAN_67/#wm_CadastraTicketGuardian

http://services.toledobrasil.com.br/WS_GUARDIAN_67/#wm_CapturaPeso

http://services.toledobrasil.com.br/WS_GUARDIAN_67/#wm_CapturaPeso_G4

http://services.toledobrasil.com.br/WS_GUARDIAN_67/#wm_ConfirmaLeituraTicketsMarcados

http://services.toledobrasil.com.br/WS_GUARDIAN_67/#wm_ConfirmaTicketUnico

http://services.toledobrasil.com.br/WS_GUARDIAN_67/#wm_ConfirmaVeiculosQuePossamTerPassadoSemPesarPelaBalanca

http://services.toledobrasil.com.br/WS_GUARDIAN_67/#wm_ConsultaIntervencoesManuaisTicket

http://services.toledobrasil.com.br/WS_GUARDIAN_67/#wm_ConsultaLogAplicacao

http://services.toledobrasil.com.br/WS_GUARDIAN_67/#wm_ConsultaLogPerifericos

http://services.toledobrasil.com.br/WS_GUARDIAN_67/#wm_ConsultaMovimentoOCR

http://services.toledobrasil.com.br/WS_GUARDIAN_67/#wm_ConsultaPedidoDeExecucao

http://services.toledobrasil.com.br/WS_GUARDIAN_67/#wm_ConsultarLogAuditoria

http://services.toledobrasil.com.br/WS_GUARDIAN_67/#wm_ConsultaTicketsPorPeriodo

20

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 Descrição Valores

Possíveis

AceitaPesoLiquidoZero Booleano NÃO

Quando Verdadeira Indica que o resultado do Peso Líquido na Pesagem Final pode ser 0 para esse veículo

Valor padrão: Verdadeiro(True)

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 ListaFatoresCorrecaoTicket

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

-

Fluxo String(50) NÃO Código do Fluxo Associado

-

http://services.toledobrasil.com.br/WS_GUARDIAN_67/#wm_DadosDoTicket_G4

http://services.toledobrasil.com.br/WS_GUARDIAN_67/#wm_EnviaMensagemDisplay

http://services.toledobrasil.com.br/WS_GUARDIAN_67/#wm_EnviaMensagem_G4

http://services.toledobrasil.com.br/WS_GUARDIAN_67/#wm_ExportaTicketParametro

http://services.toledobrasil.com.br/WS_GUARDIAN_67/#wm_ExportaTicketPeriodo

http://services.toledobrasil.com.br/WS_GUARDIAN_67/#wm_ExportaTicketUnico

http://services.toledobrasil.com.br/WS_GUARDIAN_67/#wm_ExportaTicketsMarcados

http://services.toledobrasil.com.br/WS_GUARDIAN_67/#wm_ExportaVeiculosQuePossamTerPassadoSemPesarPelaBalanca

http://services.toledobrasil.com.br/WS_GUARDIAN_67/#wm_IdentificaVagao

http://services.toledobrasil.com.br/WS_GUARDIAN_67/#wm_IdentificaVeiculoNoPonto

http://services.toledobrasil.com.br/WS_GUARDIAN_67/#wm_ImportaTicketPreCadastro

http://services.toledobrasil.com.br/WS_GUARDIAN_67/#wm_ManutencaoTicket

http://services.toledobrasil.com.br/WS_GUARDIAN_67/#wm_ObtemVersaoWS

http://services.toledobrasil.com.br/WS_GUARDIAN_67/#wm_RefazUltimaOperacao

http://services.toledobrasil.com.br/WS_GUARDIAN_67/#wm_RetornaVeiculosQuePossamTerPassadoSemPesarPelaBalanca

http://services.toledobrasil.com.br/WS_GUARDIAN_67/#wm_SimulaPesagemAvulsaSemAutomacao

http://services.toledobrasil.com.br/WS_GUARDIAN_67/#wm_TrocaFluxoTicket

http://services.toledobrasil.com.br/WS_GUARDIAN_67/#wm_SolicitaFotoAvulsa

http://services.toledobrasil.com.br/WS_GUARDIAN_67/#wm_SolicitaRetornoFotoAvulsa

http://services.toledobrasil.com.br/WS_GUARDIAN_67/#vo_Documento

http://services.toledobrasil.com.br/WS_GUARDIAN_67/#vo_EmissorIntegracao

http://services.toledobrasil.com.br/WS_GUARDIAN_67/#vo_ListaFatoresCorrecaoTicket


21

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 -

PesoTotalOrigem Decimal NÃO

Peso de origem total - Soma de todos os documentos adicionados à lista de

documentos do ticket

-

PlacaCarreta String(20) SIM

Armazena a identificação da carreta e do vagão, quando aplicável

-

PlacaVeiculo String(20) NÃO

Armazena a identificação do veículo e do vagão, quando aplicável

Valor padrão: PlacaCarreta

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 -

OperacaoDaPesagemInicial String 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

-

PerifericoDaPesagemInicial String NÃO

Balança ou MCA (mesmo que inativos)

a ser registrado como utilizado na pesagem inicial. Obrigatório quando for informar

-

http://services.toledobrasil.com.br/WS_GUARDIAN_67/#vo_ItemIntegracao

http://services.toledobrasil.com.br/WS_GUARDIAN_67/#vo_ItemIntegracao

http://services.toledobrasil.com.br/WS_GUARDIAN_67/#vo_MotoristaIntegraca

http://services.toledobrasil.com.br/WS_GUARDIAN_67/#vo_TransportadoraIntegracao

http://services.toledobrasil.com.br/WS_GUARDIAN_67/#vo_TransportadoraIntegracao

http://services.toledobrasil.com.br/WS_GUARDIAN_67/#vo_CampoAdicionalTicket


22

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 Obrigatório Descrição Valores Possíveis

Sequencial Inteiro NÃO NÃO UTILIZADO -

Codigo String(20) SIM Código do Emissor -

Descricao String(50) SIM Descrição ou Nome do Emissor

-

TipoEmissor Inteiro SIM Tipo do Emissor 519 = Fornecedor, 520 = Cliente,

521 = Outros

RazaoSocial String(50) NÃO Razão Social do Emissor -

Cnpj String(30) NÃO CNPJ ou CPF -

InscricaoEstadual String(30) NÃO Inscrição Estadual -

Endereco String(50) NÃO Endereço -

Complemento String(30) NÃO Complemento -

Municipio String(30) NÃO Município -

UF String(4) SIM 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 -


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

IncluiAtualiza Booleano 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

VO ItemIntegracao



Codigo String(20) SIM Código do Item -

Descricao String(50) NÃO NÃO UTILIZADO -

Nome String(50) SIM Nome do Item -

http://services.toledobrasil.com.br/WS_GUARDIAN_67/#vo_EmbalagensTicket

23

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

-

InicialObrigatoria Booleano 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 Inteiro NÃO Estado do Item 0=Desativado, 1=Ativado(Valor Padrão)


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

Tipo Inteiro NÃO Indica qual é o tipo de item

1760=Matéria-Prima, 1761=Produto Industrializado, 1762=Produto Manufaturado, 1763=Outro tipo de item

VO MotoristaIntegracao



Codigo String(20) SIM Código do Motorista -

Descricao String(50) NÃO NÃO UTILIZADO -

Nome String(50) SIM Nome do Item -

24

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)


InfoAcompanhantes String(255) NÃO Informação dos Acompanhantes

-

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 Documento Estrangeiro Preencher este campo para que o motorista seja identificado como estrangeiro no cadastro de motoristas.


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 motorista

não estiver cadastrado

VO TransportadoraIntegracao



Codigo 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) NÃO 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 -


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


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 a

25

Transportadora não estiver cadastrada

VO TICKET


Possíveis

CalculoFatorCorrecao Inteiro 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

-

Estado Inteiro Sim Estados do Ticket

CadastroVeiculo = 0, PreCadastro = 1, Pesagem Inicial = 2, Encerrado = 3, Aguardando Liberação = 4, PesagemFinal = 5, Cancelado = 6, Acesso Veiculo = 7, Pesagem Avulsa = 8, Verificação = 9, Bloqueado = 10,

Pesagem Eixos = 11, Pesagem Dosagem = 12

EstadoAguardando Inteiro Sim

Próximo estado do Ticket quando aguardando

liberação da Integração

Mesmo valores do

campo estado



http://services.toledobrasil.com.br/WS_GUARDIAN_67/#vo_Documento



http://services.toledobrasil.com.br/WS_GUARDIAN_67/#vo_EEmissor

26

FatoresCorrecao Lista de VO ListaFatoresCorrecaoTicket

Sim 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

-

PesagemEmContingencia Booleano Sim

Caso Verdadeiro (true) indica que houve pesagem em contingência

-

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,

preenchido somente após a pesagem final

Recebimento = 1,

Expedição = 2

Transportadora VO ETransportadora Sim Dados da Transportadora associada

-

IntegracoesOCR Lista de VO IntegracoesOCR

Sim Interações realizadas com o OCR

-

Sincronizado bool Sim Sincronizado -



http://services.toledobrasil.com.br/WS_GUARDIAN_67/#vo_ItemTicket

http://services.toledobrasil.com.br/WS_GUARDIAN_67/#vo_OperacaoTicket

http://services.toledobrasil.com.br/WS_GUARDIAN_67/#vo_OperacaoTicket

http://services.toledobrasil.com.br/WS_GUARDIAN_67/#vo_ReimpressoesTicket

http://services.toledobrasil.com.br/WS_GUARDIAN_67/#vo_ReimpressoesTicket

http://services.toledobrasil.com.br/WS_GUARDIAN_67/#vo_ETransportadora

http://services.toledobrasil.com.br/WS_GUARDIAN_67/#vo_integracaoocr

http://services.toledobrasil.com.br/WS_GUARDIAN_67/#vo_integracaoocr

27

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


Possíveis

Numero Inteiro SIM Número do Campo Adicional -

Valor String(50) SIM Valor do campo adicional -

Data Data e Hora SIM Data da criação do Registro -

Codigo Inteiro SIM Mesmo valor do campo Número -

VO Documento


Data 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 Double Não Tolerância -

VO EmbalagensTicket


Possíveis

Sequencial Inteiro Não Chave interna de controle do Guardian -

Quantidade Decimal Sim Quantidade de Embalagens -

Peso Decimal Sim Peso total das embalagens -

Data 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

28


Possíveis

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 -


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)


VO ETransportadora


Possíveis

Sequencial Inteiro Não Chave interna de controle do Guardian -

Codigo String(20) Não Código da Transportadora -

Descricao String(50) Sim Descrição ou Nome da Transportadora -

RazaoSocial String(50) Sim Razão Social da Transportadora -

Cnpj String(30) Não CNPJ ou CPF -

InscricaoEstadual String(30) Não Inscrição Estadual -

Endereco String(50) Não Endereço -

Complemento String(30) Não Complemento -

Municipio String(30) Não Município -

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 -




29

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)


VO ItemTicket



-

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

SequencialLot String(50) Sim Sequencial que representa o ID do lote

-

VO ListaFatoresCorrecaoTicket


Numero Inteiro Sim Numero da Lista de Fator de Correção -

Fator Decimal Sim Valor do Fator de Correção -

Descricao String(50) Sim Descrição do Fator de Correção -

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


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

-

http://services.toledobrasil.com.br/WS_GUARDIAN_67/#vo_EMotorista

http://services.toledobrasil.com.br/WS_GUARDIAN_67/#vo_EMotorista

30

TipoVeiculo String(20) Sim Tipo do Veículo -

Eixo Inteiro Sim OBSOLETO - Não utilizado

-

Compartimento Inteiro Sim

Número do Compartimento referente

a esse registro de pesagem

-

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

-

PesoLiqCorrigidoCalculo Decimal Sim

Representa o peso líquido corrigido pela fórmula após a pesagem final em

kg

-

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 =

31

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


Possíveis


-

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


Data Data e Hora Não Data e Hora da criação do registro

-

InfoAcompanhantes String(255) Não Informação dos Acompanhantes

-

Foto Array de Bytes(2.147.483.647 bytes)

Não 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


Codigo String(10) Sim Código Sequencial da Reimpressão do Ticket -

Data Data e Hora Sim Data e Hora da Reimpressão -

Observacao String(255) Não Observação sobre o motivo da Reimpressão -

CodigoUsuario String(20) Sim Código do Usuário que reimprimiu o Ticket -

VO LogAplicacao


Possíveis

Categoria Inteiro Sim Categoria do Log -

Codigo String(20) Não NÃO UTILIZADO -

Data Data e Hora Não Data e Hora do registro do Log -

Funcao String(240) Sim Função do Sistema que gerou do

Log -

32

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 Inteiro Sim Tipo do Log -

VO IntegracaoOCR


Possíveis

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 String(20) Sim Código da Operação Envolvida -

VO HistoricoPassagem


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 String Sim Tag associada ao registro de pesagem

-

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

-

33

FlagPossivelIdentificacao Bool Sim Código do Ponto de Controle

-

VO CfgAlteracao


Possíveis

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.

http://services.toledobrasil.com.br/WS_GUARDIAN_67/WS_GUARDIAN_PLUS.asmx?op=AcionaCancela

34

- 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


CadastraTicket

[INTERFACE]


Importar dados de um Ticket em estado de Pré-Cadastro ou Pesagem Inicial Executada. Para se importar um ticket com pesagem inicial já executada, deve-se preencher todos os campos da

estrutura referentes a pesagem inicial.

Parâmetros de entrada: - DadosTicket (VO PreCadastro - Obrigatório) = Dados do Ticket.

http://services.toledobrasil.com.br/WS_GUARDIAN_67/WS_GUARDIAN_PLUS.asmx?op=AcionaCancela_G4

http://services.toledobrasil.com.br/WS_GUARDIAN_67/WS_GUARDIAN_PLUS.asmx?op=AlteraTicketGuardian

http://services.toledobrasil.com.br/WS_GUARDIAN_67/#vo_PreCadastro

http://services.toledobrasil.com.br/WS_GUARDIAN_67/#vo_CfgAlteracao

http://services.toledobrasil.com.br/WS_GUARDIAN_67/WS_GUARDIAN_PLUS.asmx?op=CadastraTicket


35

- produto (String - Obrigatório) = Nome do Produto para Validação. Preencha com 'WS G'.

- código (String - Obrigatório) = Código do Produto para Validação. Preencha com '01'.

Retornos: - Retorno da Função (Booleano) = Verdadeiro se o Ticket foi incluído com sucesso.

- Erro (Inteiro) = Código de Erro Caso Falhe. Valores possíveis: 303221 = Não houve erro,

Diferente de 303221 = Erros variados.


CadastraTicketGuardian

[INTERFACE]


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.



Retornos:

- Retorno da Função (Ticket) = Retorna estrutura do ticket inserido no banco.




CapturaPeso

[INTERFACE]

Método é responsável por Adicionar um comando de captura de peso na fila de execuções.

Caso o Guardian capture um peso válido no informado Ponto de Controle dentro de um tempo

hábil informado no parametro TimeoutLeitura

esse peso é retonado dentro do parâmetro Peso.

Entende-se por peso válido, N pesos estáveis de acordo com configuração do Guardian,

com sensores desobstruídos, acima do peso mínimo

Deve-se chamar esse método até que o peso seja capturado.

O método considera válido também o último peso capturado nos últimos X segundos

informados no parâmetro TempoValidadePesoBom (preencha normalmente com 5 segundos).

O método pode aguarda um tempo informado no parâmetro TimeoutLeitura em segundos até

que o sistema consiga capturar esse peso (preencha normalmente com 5 segundos) .



Balança.

- TempoValidadePesoBom (Inteiro - Obrigatório) = Tempo de Validade de um Peso Bom

Capturado em Segundos. -Preferencialmente utilizar 5 segundos.

- TimeoutLeitura (String - Obrigatório) = Tempo máximo (em segundos) de retorno do método

enquanto o sistema tenta capturar um Peso Bom. - Preferencialmente utilizar 5 segundos.

- Comando (String - Obrigatório) = Comando que se deseja que a cancela execute. Valores

possíveis : 'A' = Abrir, 'F' = Fechar.



Retornos:

- Peso (Float) = Peso Bom Capturado.

- Erro (Inteiro) = Código de Erro Caso Falhe. Valores possíveis: 0 = Não houve erro, 1 = Não

foi possível capturar Peso Bom em tempo hábil, Diferente de 0 e 1 = Erros variados.


http://services.toledobrasil.com.br/WS_GUARDIAN_67/WS_GUARDIAN_PLUS.asmx?op=CadastraTicketGuardian


http://services.toledobrasil.com.br/WS_GUARDIAN_67/WS_GUARDIAN_PLUS.asmx?op=CapturaPeso

36

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:




ConfirmaTicketUnico

[INTERFACE]

Método responsável desmarcar para exportação um único ticket já exportado.

Deve ser chamado para utilizar o método ExportaTicketUnico


- SequencialTicket - Inteiro = Sequencial do ticket que foi exportado.

- nomeSistema - Código do do Sistema Integração para o qual o Ticket foi marcado.

Nomalmente utilize 'WS GUARDIAN'.

- Falhou - Boolean - Preencher Verdadeiro (true) caso senha havido algum problema com a

leitura desse Ticket.

- produto - Nome do Produto para Validação. Preencha com 'WS G'.

- código - Código do Produto para Validação. Preencha com '01'.

Retornos:

- Retorno da Função - Verdadeiro (True) caso o Ticket tenha sido desmarcado com Sucesso.

ConfirmaVeiculosQuePossamTerPassadoSemPesarPelaBalanca

[INTERFACE]


Confirmar o recebimento dos dados do método:

RetornaVeiculosQuePossamTerPassadoSemPesarPelaBalanca

Retornos:

- True, se sucesso na operação, caso contrário, false




http://services.toledobrasil.com.br/WS_GUARDIAN_67/WS_GUARDIAN_PLUS.asmx?op=CapturaPeso_G4

http://services.toledobrasil.com.br/WS_GUARDIAN_67/WS_GUARDIAN_PLUS.asmx?op=ConfirmaLeituraTicketsMarcados

http://services.toledobrasil.com.br/WS_GUARDIAN_67/WS_GUARDIAN_PLUS.asmx?op=ConfirmaTicketUnico

http://services.toledobrasil.com.br/WS_GUARDIAN_67/WS_GUARDIAN_PLUS.asmx?op=ConfirmaVeiculosQuePossamTerPassadoSemPesarPelaBalanca

37

ConsultaIntervencoesManuaisTicket

[INTERFACE]

EM DESENVOLVIMENTO - Não utilizar


Consultar intervenções manuais ocorridas em um Ticket.

É aplicado apenas em casos de Tickets abertos, ou seja, diferentes de Cancelados e

Encerrados.

O sistema tentará encontrar o Ticket na seguinte ordem de prioridade, de acordo com o

parâmetro que for preenchido:

- 1º Código do Ticket - 2º Último Ticket da Placa - 3º Último Ticket do TAG


- ticketCodigo (String - Opcional) = Código ou Número do Ticket.

- ticketPlaca (String - Opcional) = Placa da carreta/vagão.

- ticketTAG (String - Opcional) = TAG, Transponder ou Código de Barras de Identificação

Associada do Ticket.

- fluxoCodigo - Código do fluxo que o ticket irá assumir - produto (String - Obrigatório) =

Nome do Produto para Validação. Preencha com 'WS G'.


Retornos:

- DataSet com dados das intervenções manuais do Ticket

ConsultaLogAplicacao

[INTERFACE]

Método responsavel por consultar os logs da aplicação de acordo com os parametros.


- dateInicial (Data e Hora - Obrigatório) = Data de Inicio da Pesquisa.

- dateFinal (Data e Hora - Obrigatório) = Data Final da Pesquisa.

- categoria (Inteiro - Obrigatório) = Categoria dos logs.

TODAS = -1;

Execução Aplicação = 1

Exception Serviço = 2

Exception Genérico = 3

Erro Tolerância = 4

Erro WebService = 5

Debug Carrega Dado = 6

Validação OCR = 7

Erro Pesagem = 8

Debug Pesagem Ferroviária = 9

Marcado Para Cancelar = 303775

Acionamento Manual = 303196

Auditoria Contingencia = 1589

Contingencia = 303155

Integração Padrão = 304592

Integração WebServices = 304644

- tipo (Inteiro - Obrigatório) = Tipo dos Logs. TODOS = -1.

- sistemaDeIntegracao (String - Opcional) = Sistema de integração que gerou o log.



Retornos:

- Retorna da Função (Lista de VO LogAplicacao) = Registros de Log.




http://services.toledobrasil.com.br/WS_GUARDIAN_67/WS_GUARDIAN_PLUS.asmx?op=ConsultaIntervencoesManuaisTicket

http://services.toledobrasil.com.br/WS_GUARDIAN_67/WS_GUARDIAN_PLUS.asmx?op=ConsultaLogAplicacao

http://services.toledobrasil.com.br/WS_GUARDIAN_67/#vo_logaplicacao

38

ConsultaLogPerifericos

[INTERFACE]

Método responsável por consultar logs dos periféricos gerados de acordo com os parâmetros

passados.


- OperadorLogin (String - Opcional) = Usuário responsável pela operação do periférico.

Normalmente o usuário utilizado para “Logar” no serviço.

- periferico (String - Opcional) = Código do periférico que gerou o log. Normalmente código do

MCA.



- categoria (Inteiro - Obrigatório) = Categoria dos logs.

TODAS = -1;

Execução Aplicação = 1

Exception Serviço = 2

Exception Genérico = 3

Erro Tolerância = 4

Erro WebService = 5

Debug Carrega Dado = 6

Validação OCR = 7

Erro Pesagem = 8

Debug Pesagem Ferroviária = 9

Marcado Para Cancelar = 303775

Acionamento Manual = 303196

Auditoria Contingencia = 1589

Contingencia = 303155

Integração Padrão = 304592

Integração WebServices = 304644



Retornos:

- Retorna da Função (Lista de VO LogPeriferico) = Registros de Log.




ConsultaMovimentoOCR

[INTERFACE]

Método responsavel por consultar movimento de operacões executadas com OCR de acordo

com os parametros.


- ticketCodigo (String - Opcional desde que “ticketPlaca” ou “ticketTAG” esteja preenchidas) =

Número do Ticket'.

- ticketPlaca (String - Opcional desde que “ticketCodigo” ou “ticketTAG” esteja preenchidas) =

Placa da carreta/vagão Cadastrada no Ticket.

- ticketTAG (String - Opcional desde que “ticketCodigo” ou “ticketPlaca” esteja preenchidas) =

TAG Cadastrada no Ticket.

- placaOCR (String - Opcional) = Placa obtida pelo OCR.



- pontoControleDesc (String - Opcional) = Ponto de Controle que a operação foi executada.

- usuarioNome (String - Opcional) = Login do usuário que liberou a operação em caso de erro

de inconsistencia de OCR.


http://services.toledobrasil.com.br/WS_GUARDIAN_67/WS_GUARDIAN_PLUS.asmx?op=ConsultaLogPerifericos

http://services.toledobrasil.com.br/WS_GUARDIAN_67/#vo_logaperiferico

http://services.toledobrasil.com.br/WS_GUARDIAN_67/WS_GUARDIAN_PLUS.asmx?op=ConsultaMovimentoOCR

39


Retornos:

- Retorna da Função (Lista de VO Ticket) = Registros de ticket e operaçoes com OCR.




ConsultaPedidoDeExecucao

[INTERFACE]

Método responsável por consultar o estado de um pedido de execução de tarefa.

Quando o retorno for igual a 303639 indica que a solicitação pesquisada já saiu da fila.

Se é uma solicitação recente ela foi executada corretamente.

Se é uma solicitação antiga ela pode já ter sido removida da fila por limpeza.


- ID (Inteiro - Obrigatório) = ID da solicitação na Fila.

Retornos:

- Retorno da Função (Inteiro) = Estados que podem ser : 303606 - Pendente, 303607 -

Aguardando termino da execução, 303608 - Erro na execução, 303639 - Já execudado ou não

encontrado.




ConsultaTicketsPorPeriodo

[INTERFACE] Exportação ou Consulta de Ticket por período de acordo com a data de abertura do ticket.

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.



Retornos: - Retorno da Função (Objeto de VO Ticket) = Último Ticket disponível.

- Erro (Inteiro) = Código de Erro Caso Falhe. Valores possíveis: 0 = Não houve erro, Diferente de 0

= Erros variados.


ConsultarLogAuditoria

[INTERFACE]


Consultar os logs de auditoria.


- Entidade ConsultaLogAuditoriaIN contendo 2 parametros obrigatórios (Datas) e o restante

opcional, utilizado no filtro da pesquisa. - produto (String - Obrigatório) = Nome do Produto

para Validação. Preencha com 'WS G'.


Retornos:

- Uma lista do tipo ConsultaLogAuditoriaOUT com mais parametros informativos.

Parametro Informativo>

- Verifique a propriedade MensagemRetornoWebService, pois ela contém a(s) mensagen(s) de

Erro(s) ou Sucesso

http://services.toledobrasil.com.br/WS_GUARDIAN_67/#vo_ticket

http://services.toledobrasil.com.br/WS_GUARDIAN_67/WS_GUARDIAN_PLUS.asmx?op=ConsultaPedidoDeExecucao

http://services.toledobrasil.com.br/WS_GUARDIAN_67/WS_GUARDIAN_PLUS.asmx?op=ConsultaTicketsPorPeriodo


http://services.toledobrasil.com.br/WS_GUARDIAN_67/WS_GUARDIAN_PLUS.asmx?op=ConsultarLogAuditoria

40

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


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.



Cancela.

- Posicao (Inteiro - Obrigatório) = Posição no display na configuração do Guardian. Valores

possíveis :1 - Posição 1, 2 - Posição 2, 0 - Indiferente.

- Mensagem (String - Opcional) = Mensagem para o Display, se não preenchido ou em branco

limpa a mensagem.

- Tempo (Inteiro - Obrigatório) = Tempo de exibição em segundos, 0 indefinido.

Retornos:





EnviaMensagem_G4

[OBSOLETO] MÉTODO DE COMPATIBILIZAÇÂO COM O GUARDIAN 4 - PREFERENCIALMENTE UTILIZE OUTRO MÉTODO! 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


mensagem estará preenchido com uma descrição do problema

ExportaTicketParametro

[INTERFACE]


Exportação ou Consulta de Ticket por parâmetros.



- 1º Código do Ticket

http://services.toledobrasil.com.br/WS_GUARDIAN_67/WS_GUARDIAN_PLUS.asmx?op=DadosDoTicket_G4

http://services.toledobrasil.com.br/WS_GUARDIAN_67/WS_GUARDIAN_PLUS.asmx?op=EnviaMensagemDisplay

http://services.toledobrasil.com.br/WS_GUARDIAN_67/WS_GUARDIAN_PLUS.asmx?op=EnviaMensagem_G4

http://services.toledobrasil.com.br/WS_GUARDIAN_67/WS_GUARDIAN_PLUS.asmx?op=ExportaTicketParametro

41

- 2º Último Ticket da Placa

- 3º Último Ticket do TAG








Retornos:

- Retorno da Função (Objeto de VO Ticket) = Último Ticket disponível.




ExportaTicketPeriodo

[OBSOLETO] PREFERENCIALMENTE UTILIZE O MÉTODO ConsultaTicketsPorPeriodo!

Exportação ou Consulta de Ticket por período de acordo com a data de abertura do ticket.


- dataInicial (Data e Hora - Obrigatório) = Data de Início da Pesquisa.

- dataFinal (Data e Hora - Obrigatório) = Data Final da Pesquisa.



Retornos:

- Retorno da Função (Objeto de VO Ticket) = Último Ticket disponível.




ExportaTicketUnico

[INTERFACE]


Fazer exportação diferenciar de ticket, selecionando e retornando apenas o primeiro ticket

disponível para exportação.


- completa (Booleano - Obrigatório) = NÃO UTILZIADO - Preenche sempre com Falso (False).

- nomeSistema (String - Obrigatório) = Nome do sistema para o qual o ticket está marcado

para exportação. Preencher normalmente com 'WS GUARDIAN'.

- Sincronizacao (Booleano - Obrigatório) = Preenche sempre com Falso (False)'.

- produto - Nome do Produto para Validação. Preencha com 'WS G'.


Retornos:

- Retorno da Função (VO Ticket) = Ticket disponível.




ExportaTicketsMarcados

[INTERFACE]


Fazer exportação diferencial de tickets, selecionando e retornando todos os tickets disponíveis

para exportação para o sistema WS GUARDIAN.

Retornos:


http://services.toledobrasil.com.br/WS_GUARDIAN_67/WS_GUARDIAN_PLUS.asmx?op=ExportaTicketPeriodo


http://services.toledobrasil.com.br/WS_GUARDIAN_67/WS_GUARDIAN_PLUS.asmx?op=ExportaTicketUnico


http://services.toledobrasil.com.br/WS_GUARDIAN_67/WS_GUARDIAN_PLUS.asmx?op=ExportaTicketsMarcados

42

- Retorno da Função (Lista de VO Ticket) = Lista de Tickets disponível.




ExportaVeiculosQuePossamTerPassadoSemPesarPelaBalanca

[INTERFACE]


Retornar veículos que possam ter passado sem pesar pela balança

Retornos:

- Retorno da Função (Lista de VO HistoricoPassagem) = Lista do Historico de Passagens.




IdentificaVagao

[OBSOLETO]

Método de compatibilização com o Guardian 4.

IMPORTANTE: Se exitir o arquivo BDG4.XML a conexão com o banco será feita utilizado os

dados desse arquivo e

serão utilizada as regras de negócio do Guardian 4. Caso contrário se feita a conexão com o

Guardian 6 normalmente.

Então para ser conectar com o Guardian 4 crier um arquivo BD.XML com a conexão para um

banco de Guardian 4 e renomei o arquivo para BDG4.XML.

Para se conectar ao Guardian 6 o arquivo BDG4.XML deve ser apagado. Este método é

responsável por:

Importar o pré-cadastramento do vagão.


- infoCarregamento (InformaCarregamento): Dados relacionados ao carregamento.

Retornos:

- Retorno da Função (Int) = 0 : erro desconhecido - 1 : sucesso 2 : vagao ja cadastrado.

IdentificaVeiculoNoPonto

[INTERFACE]

Método responsavel por:

Identificar um veículo em um determinado ponto de controle

Com esse método é possível pesar um veículo posiciona na Balança associada ao ponto

informado.

O sistema vai tentar encontrar um Ticket Aberto através de um dos parâmetros (Ticket, Placa

ou ID) passados da seguinte ordem:





- PontoControle (String - Obrigatório) = Ponto de controle no qual o veículo vai ser

identificado.





- lado (String - Obrigatório) = Lado ao qual o veículo vai ser identificado. Valores possíveis A

ou B.

Retornos:




http://services.toledobrasil.com.br/WS_GUARDIAN_67/WS_GUARDIAN_PLUS.asmx?op=ExportaVeiculosQuePossamTerPassadoSemPesarPelaBalanca

http://services.toledobrasil.com.br/WS_GUARDIAN_67/#vo_historicopassagem

http://services.toledobrasil.com.br/WS_GUARDIAN_67/WS_GUARDIAN_PLUS.asmx?op=IdentificaVagao

http://services.toledobrasil.com.br/WS_GUARDIAN_67/WS_GUARDIAN_PLUS.asmx?op=IdentificaVeiculoNoPonto

43



ImportaTicketPreCadastro

[INTERFACE]


Importar dados de um Ticket em estado de Pré-Cadastro ou Pesagem Inicial Executada.





Retornos:

- Retorno da Função (Booleano) = Verdadeiro se o Ticket foi incluído com sucesso.




ManutencaoTicket

[INTERFACE]


Alterar o Estado do Ticket.

A alteração do estado é aplicada apenas em casos de Tickets

abertos, ou seja, diferentes de Cancelados e Encerrados.











- numOperacao (Inteiro - Obrigatório) = Número que indica qual operação será realizada no

Ticket. Valores possíveis: 1 = Bloquear, 2 = Desbloquear, 3 = Encerrar, 4 = Cancelar.



Retornos:

- Retorno da Função (Booleano) = Retorna Verdadeiro (True) em caso de Sucesso de alteração

de Estado.

ObtemVersaoWS

[INTERFACE]


Retorna a versão atual do Web Service, preferencialmente, essa deve ser a mesma versão do

Guardian utilizado. Parâmetros de entrada:

- DadosTicket (PreCadastro - Obrigatório) = Dados do Ticket.



Retornos:

- Retorno da Função (String) = Retorno Versão do programa ou Erro de Validação.

http://services.toledobrasil.com.br/WS_GUARDIAN_67/WS_GUARDIAN_PLUS.asmx?op=ImportaTicketPreCadastro


http://services.toledobrasil.com.br/WS_GUARDIAN_67/WS_GUARDIAN_PLUS.asmx?op=ManutencaoTicket

http://services.toledobrasil.com.br/WS_GUARDIAN_67/WS_GUARDIAN_PLUS.asmx?op=ObtemVersaoWS

44

RefazUltimaOperacao

[INTERFACE]


Permitir Refazer a última operação do Ticket.

É aplicado apenas em casos de Tickets diferentes de Cancelados.

Se houver apenas uma operação ativa no Ticket e este método for chamado, o ticket será

encerrado.


parametro que for preenchido:

- 1º Código do Ticket - 2º Último Ticket da Placa - 3º Último Ticket do TAG Parâmetros de

entrada:


Código ou Número do Ticket.


Placa da carreta/vagão.


TAG, Transponder ou Código de Barras de Identificação Associada do Ticket.



Retornos:

- Retorno da Função (Booleano) = Retorna Verdadeiro (True) em caso de Sucesso da

operação.

RefazUltimaOperacaoII

[INTERFACE]


Permitir Refazer a última operação do Ticket.

É aplicado apenas em casos de Tickets diferentes de Cancelados.

Se houver apenas uma operação ativa no Ticket e este método for chamado, o ticket será

encerrado.



- 1º Código do Ticket - 2º Último Ticket da Placa - 3º Último Ticket do TAG Parâmetros de

entrada:


Código ou Número do Ticket.


Placa da carreta/vagão.


TAG, Transponder ou Código de Barras de Identificação Associada do Ticket.



Parâmetros de saída:

- SaiErro (Inteiro - Opcional) = Retorna o número do erro, em caso se sucesso retorna 0.

- SaiErroMSG(string - Opcional) = Retorna a descrição do erro, em caso se sucesso retorna

vazio.

Retornos:


operação.

RemontaFluxo

[INTERFACE]


Remonta Fluxo Ticket.


http://services.toledobrasil.com.br/WS_GUARDIAN_67/WS_GUARDIAN_PLUS.asmx?op=RefazUltimaOperacao

http://services.toledobrasil.com.br/WS_GUARDIAN_67/WS_GUARDIAN_PLUS.asmx?op=RefazUltimaOperacaoII

http://services.toledobrasil.com.br/WS_GUARDIAN_67/WS_GUARDIAN_PLUS.asmx?op=RemontaFluxo

45












- codigoFluxo (String - Obrigatório) = Código no novo fluxo do ticket.

Retornos:


operação.




RetornaVeiculosQuePossamTerPassadoSemPesarPelaBalanca

[INTERFACE]


Retornar veículos que possam ter passado sem pesar pela balança


- dataInicio (Data e Hora - Obrigatório) = Data de Inicio da Pesquisa.

- dataFim (Data e Hora - Obrigatório) = Data Final da Pesquisa.

Retornos:

- Retorno da Função (Lista de VO HistoricoPassagem) = Lista do Historico de Passagens.




SimulaPesagemAvulsaSemAutomacao

[INTERFACE]

WebMétodo responsavel por:

Simular uma 'PESAGEM AVULSA' de um veículo pré-cadastrado em um determinado ponto de

controle, em uma balança 'SEM AUTOMAÇÃO'

Este WebMétodo foi desenvolvido para funcionar com uma balança associada ao ponto de

controle. Ele NÃO FUNCIONA como uma operação do

GUARDIAN, ele apenas grava o peso capturado quando a balança está estavél (Posicionado)

como se fosse uma 'PESAGEM AVULSA'.

Nenhum evento é diparado, nenhuma configuração da operação é validada, ele apenas grava

as informações no banco.

Este WebMétodo utiliza 'Estação responsável pela integração de dados' e 'Usuário responsável

pela integração de dados' que estão

configurados no Config.exe na opção 'Sistema'.

Deverá ter apenas uma 'OPERAÇÃO AVULSA' Configurada. O sistema vai tentar encontrar um

Ticket aberto através de um dos parâmetros (Ticket, Placa ou ID) passados, na seguinte

ordem:




Funciona somente Parâmetros de entrada:

http://services.toledobrasil.com.br/WS_GUARDIAN_67/WS_GUARDIAN_PLUS.asmx?op=RetornaVeiculosQuePossamTerPassadoSemPesarPelaBalanca

http://services.toledobrasil.com.br/WS_GUARDIAN_67/#vo_historicopassagem

http://services.toledobrasil.com.br/WS_GUARDIAN_67/WS_GUARDIAN_PLUS.asmx?op=SimulaPesagemAvulsaSemAutomacao

46

- PontoControle (String - Obrigatório) = Ponto de controle no qual o veículo vai ser

identificado.


- ticketPlaca (String - Opcional) = Placa da Carreta.



- lado (String - Obrigatório) = Lado ao qual o veículo vai ser identificado. Valores possíveis A

ou B.

- TempoValidadePesoBom (Inteiro - Obrigatório) = Tempo de Validade de um Peso Bom

Capturado em Segundos. -Preferencialmente utilizar 5 segundos.

- TimeoutLeitura (String - Obrigatório) = Tempo máximo (em segundos) de retorno do método

enquanto o sistema tenta capturar um Peso Bom. - Preferencialmente utilizar 5 segundos.

Retornos:




SolicitaFotoAvulsa

[INTERFACE]


Solicitar o disparo assíncrono de uma fotografia em ponto específico de um ponto e controle

(posteriormente, utilize o WebMétodo SolicitaRetornoFotoAvulsa para verificar o resultado

desta operação).


- codigoPontoControle (String - Obrigatório) = Código do ponto de controle onde se encontra

câmera com a qual a foto será tirada.

- posicaoCamera (String - Obrigatório) = Posição de instalação da câmera no ponto de

controle (exemplo: P1, P2... P8).

- caminhoFoto (String - Opcional) = Caminho onde a foto será gravada. Se não for informado

será assumido o caminho padrão definido na configuração do Guardian.

- nomeFoto (String - Opcional) = Nome com o qual a foto será gravada. Se não for informado

será assumido a geração de nome padrão definida na configuração do Guardian.



Retornos:

- Retorno da Função (int) = Um código de identificação desta solicitação, poderá ser utilizado

para obter informação sobre o sucesso desta operação assíncrona.

- Erro (bool) = Código de Erro Caso Falhe. Valores possíveis: 0 = Não houve erro, Diferente de

0 = Erros variados.

- ErroMSG (String) = Descrição do erro retornado.

SolicitaRetornoFotoAvulsa

[INTERFACE]


Obter informação sobre o sucesso ou não, IMEDIATAMENTE após o disparo de uma solicitação

assíncrona de fotografia avulsa (utilize o WebMétodo SolicitaFotoAvulsa para solicitar o disparo

de fotos).


- idSolicitacaoAvulsa (String - Inteiro) = Código de identificação da solicitação de foto avulsa.



Retornos:

- Retorno da Função (Objeto de VO RetornoFotoAvulsa) = Informações sobre o sucesso ou não

de uma operação anteriormente solicitada.

http://services.toledobrasil.com.br/WS_GUARDIAN_67/WS_GUARDIAN_PLUS.asmx?op=SolicitaFotoAvulsa

http://services.toledobrasil.com.br/WS_GUARDIAN_67/#wm_SolicitaRetornoFotoAvulsa

http://services.toledobrasil.com.br/WS_GUARDIAN_67/WS_GUARDIAN_PLUS.asmx?op=SolicitaRetornoFotoAvulsa

http://services.toledobrasil.com.br/WS_GUARDIAN_67/#wm_SolicitaFotoAvulsa

http://services.toledobrasil.com.br/WS_GUARDIAN_67/#vo_RetornoFotoAvulsa

47

TrocaFluxoTicket

[INTERFACE]


Alterar o Fluxo Ticket.













- codigoFluxo (String - Obrigatório) = Código no novo fluxo do ticket.

Retornos:


operação.




http://services.toledobrasil.com.br/WS_GUARDIAN_67/WS_GUARDIAN_PLUS.asmx?op=TrocaFluxoTicket

48

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.

49

o Se não foi utilizado o backup, na opção “Pacote das Configurações”, clique no botão “Selecionar” e procure o arquivo “C:\Toledo\Guardian\MIE\INTEGRACAO_PADRAO_GUARDIAN_MIE.MIE” selecione-o e aguarde os botões ficarem habilitados para continuar.

o Na opção “Agendamento” terá as configurações disponíveis para serem utilizadas. No caso da integração ser executada automaticamente, deve-se clicar no Botão agendar e criar o agendamento para a configuração desejada;

o Na opção “Determinação dos Servidores” deve-se clicar no Botão Configurar e substituir todos os servidores que estão com os valores default pelos os da instalação em questão.

o Na opção “Configuração de Diretórios” (só alterar se estiver utilizando integração arquivo texto) deve-se clicar no Botão Configurar e substituir o diretório raiz default pelo existente no ambiente em questão. A estrutura de diretório deve ser mantida como exemplo abaixo:

o

o Na opção “Pronto”, marque “Iniciar Serviços” se desejar iniciar os serviços do MIE neste momento, caso contrário deixe desmarcado e clique em terminar. Se a mensagem “Falha ao criar tabela auxiliar confira as configurações e tente novamente!” for apresentada, significa que existe alguma divergência na configuração dos servidores. Certifique-se que as configurações estão corretas e execute o AMIE.exe novamente.

Lembre-se, quem irá fazer à escrita e leitura dos arquivos será um serviço, então os usuários de rede destes serviços terão que ter permissão de escrita e leitura nas pastas utilizadas na integração.

4.2.3 Configuração no Guardian

Para o correto funcionamento da integração algumas configurações devem ser realizadas no “Toledo Guardian - Configuração” ou Config.exe. Execute o Config.exe:

No menu principal clique na opção “Estação de Controle”, cadastre uma estação de controle que servirá como referência para a integração nos casos onde é necessário informar a “Estação de Controle”. A sugestão é que seja cadastrado com um nome que identifique que a Estação é utilizada única e exclusivamente para a integração, assim o mesmo não será confundido com as outras estações.

Em seguida no menu principal clique na opção “Usuários”, cadastre um usuário que servirá como referência para a integração nos casos onde é necessário informar o usuário para realizar a integração. A sugestão é que seja cadastrado com um nome que identifique que é um usuário utilizado única e exclusivamente para a integração, para o mesmo não seja confundido com os outros.

Em seguida no menu principal clique na opção “Sistema”. o Na tela “Configuração Guardian” selecione a aba “Aplicação” e configure o campo “Estação

responsável pela integração de dados” com a estação que foi cadastrada anteriormente, em seguida no campo “Usuário responsável pela integração” informe o Usuário que foi cadastrado anteriormente para a integração.

o Ainda na tela “Configuração Guardian” selecione a aba “Operação”, na opção “Exportar Tickets com estado”, selecione os estados que deseja que o ticket seja exportado. Se houver mais de uma opção

50

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


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.

Funcionamento Exportação

Com base nas configurações do MIE e do Guardian o arquivo texto será gerado com as informações de um único ticket por vez. O MIE irá exportar o conteúdo de cada tabela separadamente e irá uni-los no final da exportação de todos os arquivos. A ordem de exportação dos tickets será com base na data de criação do mesmo, sempre exportando o mais antigo. O nome do arquivo que será composto da placa do ticket em questão entre colchetes mais a palavra Ticket.TXT, como por exemplo, [IMP-2002]Ticket.TXT. A responsabilidade de remover o arquivo da pasta será do aplicativo do cliente. Se o processo de pesagem acontecer por completo e acontecer de ser gerado um novo ticket com a mesma placa de um arquivo que ainda está na pasta de exportação, este arquivo será substituído pelo mais novo.

Arquivo de exportação

Nome do arquivo [<Placa da Carreta>]Ticket.txt

Todos os registros filhos devem ter o primeiro campo preenchido com a placa

Arquivo único suprindo as seguintes estruturas de dados:

o Cabeçalho do Ticket

Indicador de Grupo: [Ticket]

o Operações executadas do Ticket

Indicador de Grupo: [Operacoes]

GUARD

DB GUAR

MIE

DB MIE

MS SQL

Arquivo

Exportação

GUARD

IAN

DB GUAR

MIE

DB MIE

MS SQL

Arquivo

texto

Importação

51

o Campos adicionais do Ticket

Indicador de Grupo: [CampoAdicional]

o Itens do Ticket

Indicador de Grupo: [Itens]

o Fatores de Correção do Ticket

Indicador de Grupo: [FatoresCorrecao]

o Documentos

Indicador de Grupo: [DocumentosTicket]

o Eixos capturados

Indicador de Grupo: [EixosDaOperacao]

Exemplo

[Ticket]

ABC-1234;0000001;false;false;;;;EMS0001;João da silva;;;…

[Operacoes]

83;DEF-4567;;;;;;;;;;;;;;;;;Paulo;10/01/12;;PT03;ES01;2;PreCadastro;true;1

101;DEF-4567;;;;;;;;;17598;;;;;;;;Nei;10/01/12;BAL1;PT01;ES01;2;PInicial;true;1

[CampoAdicional]

1;CARGA LIQUIDA

2;12%

[DocumentosTicket]

1;NF00001;1;15000

2;NF00002;1;10000

3;NF00003;1;

2000

[Itens]

1;ITM0001;Milho

2;ITM0002;Soja

Exportação

Dados que devem estar contidos no arquivo de exportação: Dados do Ticket - [TICKET]


TCK_PLACA_CARRETA String(20) SIM Placa da Carreta -

TCK_CODIGO String(30) SIM Número/Código do Ticket

TCK_INDICA_PESAGEM_FERROVIARIA Booleano SIM

Quando Verdadeira Indica que o ticket é de pesagem ferroviária

TCK_VERIFICA_PESO_LIQUIDO_MAIOR_ZERO Booleano SIM


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 -

52

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

FLX_CODIGO String(50) NÃO Código do Fluxo Associado -

TCK_OBSERVACAO String(8000) NÃO Observação -

TCK_PESO_BRUTO_ORIGEM Decimal NÃO

Peso de referência para checagem do peso total na primeira pesagem do veículo -

TCK_IDT_ASSOCIADA String(250) NÃO 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 Código da Transportadora associada -

TRP_RAZAO_SOCIAL String(50) NÃO Razão Social da Transportadora associada

Operações do ticket - [OPERACOES]


OTK_SEQUENCIAL Inteiro Longo

SIM Sequencial da operação executada no Ticket -

OTK_PLACA_VEICULO String SIM

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_CONVERSAO String

Unidade de Medida Após Conversão do Peso -


OTK_COMPARTIMENTO Inteiro

NÃO Número do Compartimento referente a esse registro de pesagem -

OTK_FATOR_CORRECAO_LISTA Decimal

NÃO

Valor do fator correção obtido a partir da lista de fatores de correção da lista -

OTK_FATOR_CORRECAO_CALCULO Decimal

NÃO Valor do fator correção obtido a partir da expressão calculada -

OTK_PESO Decimal NÃO

Peso Capturado em kg -

OTK_TARA_VEICULO Decimal

NÃO Representa o peso total das embalagens vazias em kg (Tara do Veículo) -

OTK_FATOR_CONVERSAO Decimal

NÃO

Fator de Conversão -

OTK_PESO_LIQUIDO Decimal

NÃO Representa o peso líquido obtido após a pesagem final em kg -

OTK_PESO_LIQUIDO_CORRIGO_LISTA Decimal

NÃO Representa o peso líquido corrigido após a pesagem final em kg -

OTK_PESO_LIQUIDO_CORRIGO_CALCULO Decimal

NÃO Representa o peso líquido corrigido pela fórmula após a pesagem final em kg -

OTK_PESO_LIQUIDO_CONVERTIDO Decimal

NÃO Representa o peso líquido convertido, apresentado o fator e unidade após conversão após a pesagem final em kg -

OTK_PESO_BRUTO_VEICULO Decimal

NÃO Valor do peso bruto do veículo que registrou a pesagem -

USR_LOGIN EXP

SIM Login do Usuário que registrou a operação -

OTK_DATA Data e Hora

SIM

Data de execução da Operação -

PRF_CODIGO String(20)

NÃO Código do Periférico que executou essa operação -

53

LCL_CODIGO String(20)

SIM Código do Ponto de Controle que executou a operação -

PCL_CODIGO String(20)

SIM Código da Estação de Controle que executou a operação -

TOP_CODIGO Inteiro

SIM

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

TOP_DESCRICAO String(50)

SIM

Descrição do Tipo da Operação -

OPR_CODIGO String(20)

SIM

Código da Operação -

OTK_ESTADO Booleano

SIM

Indica estado da operação FALSO = CANCELADA

OTK_LADO Inteiro

SIM Indica o Lado que a operação foi realizada -

Campos adicionais do Ticket - [CAMPOS]


CAT_NUMERO Inteiro SIM Número do Campo Adicional -

CAT_VALOR String SIM Valor do campo adicional -

Documentos do Ticket - [DOCUMENTOS]


DCT_CODIGO String SIM 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]


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]


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 -

54

Eixos capturado na operação do Ticket - [EIXOS]


OTK_SEQUENCIAL Inteiro Longo SIM

Sequencial da operação executada no Ticket -

EIO_NUMERO_EIXO Inteiro 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_PERMITIDA 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.

55

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 [<Placa da Carreta>]Ticket.txt

Cada linha de dados deve ter como primeiro campo a placa da carreta.

Arquivo único suprindo as seguintes estruturas de dados:

o Cabeçalho do Ticket

Indicador de Grupo: [Ticket]

o Campos adicionais do Ticket

Indicador de Grupo: [CampoAdicional]

o Documentos do Ticket

Indicador de Grupo: [DocumentosTicket]

o Itens do Ticket

Indicador de Grupo: [Itens]

o Fatos de correção do Ticket

56

Indicador de Grupo: [FatoresCorreção]

o Configuração Alteração ( *** Somente na alteração do Ticket *** )

Indicador de Grupo: [ConfiguraçãoAlteração]

Exemplo:

Arquivo : [ABC123]ImpTicket.txt

[Ticket]

ABC-1234;DEF-4567;false;false;;;;EMS0001;João da silva;;;…

[CampoAdicional]

ABC-1234;1;CARGA LIQUIDA

ABC-1234;2;12%

[DocumentosTicket]

ABC-1234;1;NF00001;15000

ABC-1234;2;NF00002;10000

ABC-1234;3;NF00003;2000

[Itens]

ABC-1234;1;ITM0001;Milho

ABC-1234;2;ITM0002;Soja

[ConfigAlteracao]( *** Somente na Alteração do Ticket *** )

ABC-1234;1;0 ( *** Altera o Ticket *** )

ABC-1234;2;1 ( *** Exclui a transportadora *** )

ABC-1234;3;1 ( *** Exclui o Emissor *** )

Dados Importação

Dados que devem estar contidos no arquivo de importação: Dados do Ticket – [TICKET]



OTK_PLACA_VEICULO String(20) NÃO Placa do Veículo



Quando Verdadeira Indica que o ticket é de pesagem ferroviária Zero(0) ou Um (1)


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)








57






TCK_IDT_ASSOCIADA String(250) NÃO

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)



OTK_UNIDADE_APOS_CONVERSAO String(10) NÃO


OTK_FATOR_CONVERSAO Decimal NÃO Fator de Conversão

OPR_CODIGO String(20) SIM Código da Operação de “pré-cadastro” Cadastrado no Guardian.

Campos adicionais do Ticket - [CAMPOS]





Documentos do Ticket - [DOCUMENTOS]






Itens do Ticket - [ITENS]



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



58

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








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


IMP_SEQUENCIAL

Inteiro Longo SIM Sequencial Automático

Preenchimento automático

K TCK_PLACA_CARRETA String(20) SIM Placa da Carreta -

CFA_CONFIG_NUMERO Inteiro SIM

Numero da configuração que se deseja alterar 1,2,3,4,5,6,7,8 e 9

CFA_CONFIG_VALOR Inteiro SIM

1(Verdadeiro) exclui dado do ticket 0(Falso) mantém ou altera dado 0 ou 1

IMP_DATA Data e hora SIM

Data e hora que o dado foi incluído na tabela. -

IMP_FLAG Inteiro SIM Controla leitura e escrita do dado na tabela

I - Incluído P - Pronto L - Lido

59

BANCO TANQUE


Guardian TAG

Guardian TI

Guardian PRO

Banco Tanque

O Banco Tanque será utilizado para importar e exportar apenas dados operacionais relacionados ao Ticket. Não estão previstos importação e exportação de dados de cadastros secundários (Itens, Transportadora, Emissores, Motoristas, etc). Mesmo assim as tabelas de importação preveem dados de código e nome ou descrição para eventual inclusão no cadastro.

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

GUARDIA

DB GUARDIAN

MIE DB

TANQUE

MS SQL

Exportação

DB MIE

GUARDIAN

DB GUARDIAN

MIE DB Tanque

MS SQL

Importação

DB MIE

60

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.

61

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.

62

Estrutura das Tabelas

tbImpSinalizacao – Tabela de sinalização da importação


IMP_SINALIZACAO String(1) SIM Sinalização da Importação

L – Liberado I – Importando E - Exportando

tbImpTicket – Tabela de dados do Ticket


IMP_SEQUENCIAL Inteiro Longo NÃO Sequencial Automático Preenchimento automático

OPR_CODIGO String(20) SIM Código da Operação de pré-cadastro.

Código da operação cadastrada no Guardian como pré-cadastro


OTK_PLACA_VEICULO String(20) NÃO Placa do Veículo



Quando Verdadeira Indica que o ticket é de pesagem ferroviária Zero (0) ou um (1)


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)















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)



OTK_UNIDADE_APOS_CONVERSAO String(10) NÃO


63

OTK_FATOR_CONVERSAO Decimal NÃO Fator de Conversão

IMP_DATA Data e Hora SIM

Indica a data e hora que o dado foi incluído na tabela -

K IMP_FLAG String(1) SIM

Campo de Controle de Leitura e escrita do dado na tabela

I – Incluído L - Lido

TCK_CODIGO String(30) NÃO

Este campo é atualizado na tarefa de exportação do Ticket no estado de pre-cadastro do MIE. Não deve ser preenchido.

tbImpCampAdicionalTicket – Tabela de campos adicionais do Ticket



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

K CAT_NUMERO Inteiro SIM

Número do Campo Adicional único por ticket. -


IMP_DATA Data e Hora SIM

Indica a data e hora que o dado foi incluído na tabela -

K IMP_FLAG String(1) SIM

Campo de Controle de Leitura e escrita do dado na tabela


tbImpDocumentoTicket – Tabela de documentos do Ticket




K

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



IMP_DATA Data e Hora SIM Indica a data e hora que o dado foi incluído na tabela -

K

IMP_FLAG String(1) SIM Campo de Controle de Leitura e escrita do dado na tabela


tbImpItensTicket – Tabela de Itens do Ticket




K

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




K



64

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




K

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






K



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


IMP_SEQUENCIAL

Inteiro Longo SIM Sequencial Automático

Preenchimento automático


CFA_CONFIG_NUMERO Inteiro SIM

Numero da configuração que se deseja alterar 1,2,3,4,5,6,7,8 e 9

CFA_CONFIG_VALOR Inteiro SIM

1(Verdadeiro) exclui dado do ticket 0(Falso) mantém ou altera dado 0 ou 1

IMP_DATA Data e hora SIM

Data e hora que o dado foi incluído na tabela. -

IMP_FLAG Inteiro SIM Controla leitura e escrita do dado na tabela.

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

65

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


EXP_SINALIZACAO String(1) SIM Sinalização da Exportação

L – Liberado I – Importando E - Exportando

tbExpTicket – Tabela de exportação do Ticket


EXP_SEQUENCIAL Inteiro Longo SIM Sequencial Automático Preenchimento automático



Quando Verdadeira Indica que o ticket é de pesagem ferroviária

















EXP_DATA Data e Hora SIM Indica a data e hora que o dado foi incluído na tabela -

EXP _FLAG String(1) SIM Campo de Controle de Leitura e escrita do dado na tabela


tbExpOperacoesTicket – Tabela de exportação das operações executada do ticket


66




OTK_SEQUENCIAL Inteiro Longo

SIM Sequencial da operação executada no Ticket -

OTK_PLACA_VEICULO String SIM

Placa do Veículo -




OTK_UNIDADE_APOS_CONVERSAO String



OTK_COMPARTIMENTO Inteiro

NÃO Número do Compartimento referente a esse registro de pesagem -

OTK_FATOR_CORRECAO_LISTA Decimal

NÃO

Valor do fator correção obtido a partir da lista de fatores de correção da lista -

OTK_FATOR_CORRECAO_CALCULO Decimal

NÃO Valor do fator correção obtido a partir da expressão calculada -

OTK_PESO Decimal NÃO

Peso Capturado em kg -

OTK_TARA_VEICULO Decimal

NÃO Representa o peso total das embalagens vazias em kg (Tara do Veículo) -

OTK_FATOR_CONVERSAO Decimal

NÃO

Fator de Conversão -

OTK_PESO_LIQUIDO Decimal

NÃO Representa o peso líquido obtido após a pesagem final em kg -

OTK_PESO_LIQUIDO_CORRIGO_LISTA Decimal

NÃO Representa o peso líquido corrigido após a pesagem final em kg -

OTK_PESO_LIQUIDO_CORRIGO_CALCULO Decimal

NÃO Representa o peso líquido corrigido pela fórmula após a pesagem final em kg -

OTK_PESO_LIQUIDO_CONVERTIDO Decimal

NÃO Representa o peso líquido convertido, apresentado o fator e unidade após conversão após a pesagem final em kg -

OTK_PESO_BRUTO_VEICULO Decimal

NÃO Valor do peso bruto do veículo que registrou a pesagem -

USR_LOGIN EXP

SIM Login do Usuário que registrou a operação -

OTK_DATA Data e Hora

SIM

Data de execução da Operação -

PRF_CODIGO String(20)

NÃO Código do Periférico que executou essa operação -

LCL_CODIGO String(20)

SIM Código do Ponto de Controle que executou a operação -

PCL_CODIGO String(20)

SIM Código da Estação de Controle que executou a operação -

TOP_CODIGO Inteiro

SIM

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

TOP_DESCRICAO String(50)

SIM

Descrição do Tipo da Operação -

OPR_CODIGO String(20)

SIM

Código da Operação -

67

OTK_ESTADO Booleano

SIM

Indica estado da operação FALSO = CANCELADA

OTK_LADO Inteiro

SIM Indica o Lado que a operação foi realizada -

EXP_DATA Data e Hora

SIM Indica a data e hora que o dado foi incluído na tabela -

EXP _FLAG String(1)

SIM Campo de Controle de Leitura e escrita do dado na tabela

I – Incluído L – Lido

tbExpCampAdicionalTicket – Tabela de exportação dos campos adicionais do Ticket








EXP FLAG String(1) SIM Campo de Controle de Leitura e escrita do dado na tabela


tbExpDocumentoTicket – Tabela de exportação dos documentos do Ticket







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



EXP FLAG String(1) SIM Campo de Controle de Leitura e escrita do dado na tabela


tbExpItensTicket – Tabela de exportação dos itens do Ticket








EXP_FLAG String(1) SIM Campo de Controle de Leitura e escrita do dado na tabela


68

tbExpListaFatoresCorrecaoTicket – Tabela de exportação da lista dos fatores de correção do Ticket













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





OTK_SEQUENCIAL Inteiro Longo SIM Sequencial da operação executada no Ticket -

EIO_NUMERO_EIXO Inteiro 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_PERMITIDA Decimal SIM Diferença máxima permitida -




Limpeza

O MIE executa uma Stored Procedure do banco tanque parametrizando o tempo em dias que os dados devem

permanecer no banco.

A Stored Procedure apaga todos os dados de todas as tabelas que o campo Data de Importação ou

Exportação seja mais velho que a data atual menos a quantidade de dias informados.

69

PARA SUAS ANOTAÇÕES

70

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 BELÉM - PA Rua Boa Ventura, 1701 - Bairro Fátima CEP 66070-060 Fone: (91) 3182-8900 Fax: (91) 3182-8950 BELO HORIZONTE - MG Av. Portugal, 5011 - Bairro Itapoã CEP 31710-400 Fone: (31) 3448-5500 Fax: (31) 3491-5776 CAMPINAS (VALINHOS) - SP Av. Dr. Altino Gouveia, 827 - Jardim Pinheiros - Valinhos - SP CEP 13274-350 Fone: (19) 3829-5800 / Fax: (19) 3829-5810 CAMPO GRANDE - MS Av. Eduardo Elias Zahran, 2473 - Jd. Alegre CEP 79004-000 Fone: (67) 3303-9600 Fax: (67) 3303-9650 CHAPECÓ - SC R. Tiradentes, 80 - Bela Vista CEP 89804-060 Fone: (49) 3324-0331 Fax: (49) 3324-0331 CUIABÁ - MT Av. Miguel Sutil, 4962 - Jardim Leblon CEP 78060-000 Fone: (65) 3928-9400 Fax: (65) 3928-9450 CURITIBA - PR R. 24 de Maio, 1666 - B. Rebouças CEP 80220-060 Fone: (41) 3213-3350 Fax: (41) 3213-3350 FORTALEZA - CE R. Padre Mororó, 915 - Centro CEP 60015-220 Fone: (85) 3391-8100 Fax: (85) 3391-8150 GOIÂNIA - GO Av. Laurício Pedro Rasmussen, 357 - Vila Santa Isabel CEP 74620-030 Fone: (62) 3202-0344 Fax: (62)3202-0344 MANAUS - AM R. Ajuricaba, 999 - B. Cachoeirinha CEP 69065-110 Fone: (92) 3635-0441 Fax: (92) 3233 0787

MARINGÁ - PR Av. Colombo, 6580 - Jd. Universitário CEP 87020-000 Fone: (44) 3225-1991 Fax: (44) 3225-1991 PORTO ALEGRE (CANOAS) - RS R. Augusto Severo, 36 - Nossa Senhora das Graças CEP 92110-390 Fone: (51) 3427-4822 Fax: (51) 3427-4818 RECIFE - PE R. D. Arcelina de Oliveira, 48 - B. Imbiribeira CEP 51200-200 Fone: (81) 3339-4774 Fax: (81) 3339-6200 RIBEIRÃO PRETO - SP R. Iguape, 210 - B. Jardim Paulista CEP 14090-090 Fone: (16) 3968-4800 Fax: (16) 3968-4812 RIO DE JANEIRO - RJ R. da Proclamação, 574 - Bonsucesso CEP 21040-282 Telefax: (21) 3867-1393/95/96/98/99/1444 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 SANTOS - SP R. Professor Leonardo Roitman, 27 - V. Matias CEP 11015-550 Fone: (13) 2202-7900 Fax: (13) 2202-7950 SÃO JOSÉ CAMPOS - SP R. Icatu, 702 - Parque Industrial CEP 12237-010 Fone: (12) 3934-9211 Fax: 3934-9278 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 UBERLÂNDIA - MG R. Ipiranga, 297 - Cazeca CEP 38400-036 Fone: (34) 3215-0990 Fax: (34) 3215-0990 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

mailto:[email protected]

Documents

Manual Do Usuario Ti Instalacao e Interface de Dados Guardian Versao 6.7