Você está na página 1de 51

Sistema Pamcard - Contrato de Frete

Especificao de Integrao
Verso 1.0

























Confidencial Pg. 2 de 51


Histrico das Revises

Data Verso Descrio Autor
09/09/2011 1.0 Verso Inicial Miriam Alborghetti
09/09/2011 1.1 Ajustes Tabelas e descries Miriam Alborghetti


Confidencial Pg. 3 de 51



1 Introduo 5
2 Definies e Abreviaes 5
3 Requisitos 5
3.1 Requisitos Tcnicos 5
3.2 Requisitos de Segurana / Confiabilidade 5
3.3 Requisitos de Comunicao 6
4 Arquitetura 6
5 Opes de Integrao 7
5.1 WebService 7
5.2 Adaptador 7
5.3 Arquivo de Retorno para Download 8
6 Funcionalidades 8
6.1 Incluir Contrato Frete 8
6.2 Consultar Viagem 12
6.3 Consultar Status da Parcela 17
6.4 Alterar Status da Parcela 18
6.5 Consultar Status do Pedgio 19
6.6 Alterar Status do Pedgio 20
6.7 Roteirizar 21
6.8 Consultar Carto 23
6.9 Inserir Parcela 24
6.10 Incluir Carto Portador Frete 25
6.11 Incluir Favorecido 26
6.12 Consultar Favorecido 27
6.13 Incluir Conta 28
6.14 Consultar Conta 29
7 Apndices 30
7.1 WSDL 30
7.2 Adaptador 32
7.2.1 Instalao 32
7.2.2 Estrutura de Diretrios (verso windows) 32
7.2.3 Gerao do Arquivo 34
7.2.4 Configurao 34
7.2.5 Adaptador Exemplos 38
3 - Incluso Contrato de Frete: 38
6 - Consultar viagem 41
8 - Consuta Status da Parcela 42
9 - Consultar Status do Pedgio 43
10 - Roteirizao de Viagem 43
11 - Consulta Carto 44
13 - Atualizar Status do Pedgio 44
14 - Alterao de Status de Parcela 45
16- Incluso de Carto Portador Frete 45
7.3 Tabelas 46
Tipo de Documento da Viagem 46
Tipo do Carto 46
Tipo de Documento 46
Tipo da Parcela 47
Tipo de Efetivao 47
Tipo de Origem 47
Tipos Documento Complementar 47

Confidencial Pg. 4 de 51


Status da Parcela 48
Status do Pedgio 48
Status da Viagem 48
Tipo de Transacao 48
Status do Carto Pamcard 48
Status da Transao 48
Status da Conta do Favorecido 48
Categorias do Veculo 48
Cdigos e Mensagens de Retorno 49
7.4 Referncias 50
7.5 Lay-Out Arquivo de Transaes (Download) 51

Confidencial Pg. 5 de 51



1 Introduo

Este documento destinado a profissionais da rea de TI e tem como objetivo detalhar as formas para
realizar a integrao com o Sistema Pamcard Contrato de Frete.

O Sistema Pamcard tem como objetivo agilizar o processo de pagamentos de pedgios, fretes, dirias e
combustveis aos caminhoneiros fornecendo de forma eficaz um meio eletrnico e seguro para as
empresas que realizam transportes rodovirio de cargas.

2 Definies e Abreviaes


HTTPS: Hipertext Transfer Protocol Secure

IDE: Integrated Development Environment

RPC: Remote Procedure Call

SOAP: Simple Object Access Protocol

SSL: Secure Socket Layer

WSDL: Web Service Definition Language

XML: Extend Markup Language

BIN: Bank Identification Number (So os 6 primeiros nmeros do Carto VISA)
BBBB BB99 9999 9999

3 Requisitos

3.1 Requisitos Tcnicos

Para a utilizao do mdulo de integrao do sistema Pamcard o computador a ser utilizado dever
possuir:
o Windows acima de 2000
o Acesso liberado para a internet
o Java Virtual Machine instalado (qualquer verso acima de jre-1_5)

Caso necessrio o Java Virtual Machine poder ser baixado atravs do site www.java.com, sem custo de
licenciamento.

3.2 Requisitos de Segurana / Confiabilidade

O acesso s funcionalidades disponibilizadas pelo Web Service Pamcard deve ser feito atravs de um
certificado digital, que garante segurana na autenticao de usurios do sistema. O certificado contm a
identificao da empresa (CNPJ) e gerado para o cliente pela Pamcary. O Web Service Pamcard validar
o certificado enviado pelo cliente.





Confidencial Pg. 6 de 51


3.3 Requisitos de Comunicao

A comunicao entre clientes e servidores ser feita atravs do SOAP (Simple Object Access Protocol).
Esse protocolo definido em XML, sendo assim, as chamadas a procedimentos remotos (RPC) so
codificadas em XML. Para transporte das mensagens ser usado o HTTPS.

O acesso ao servidor que hospeda Web Service Pamcard se dar por acesso internet. O cliente dever
possuir um certificado de autenticao no servidor e um usurio no Sistema Pamcard com perfil
especfico para realizar as transaes. Este usurio somente poder ser utilizado nestas transaes, no
sendo permitido a este usurio acessar o sistema na Web.


4 Arquitetura




Confidencial Pg. 7 de 51


5 Opes de Integrao


5.1 WebService

Este modelo de integrao foi desenvolvido especialmente para se integrar aos sistemas dos nossos
clientes, visando a disponibilizao da informao em tempo real, eliminando retrabalho e permitindo um
processo de uso fcil pelos operadores.





Todo web services descrito atravs de um documento WSDL (Web Service Definition Language) que
descreve todos os servios, seus parmetros de entrada e sada, e at mesmo a estrutura de dados
destes parmetros, caso esta seja complexa. O documento WSDL deve ser utilizado pelos
desenvolvedores das aplicaes que consomem os web services para a gerao do cliente de
comunicao atravs de uma IDE apropriada. Uma IDE ir produzir cdigo que implemente a
comunicao de rede para invocao dos servios.

A estrutura do WSPamcard.wsdl est disponvel no apndice deste documento

5.2 Adaptador

A comunicao entre o Sistema do Cliente e o Web Service Pamcard se dar atravs de um componente
Adaptador, por meio de arquivos, ou seja, para cada funcionalidade disponvel no Web Service Pamcard
haver um arquivo texto parametrizado correspondente com os dados de entrada e, aps o
processamento, ser retornado um arquivo texto parametrizado de mesmo nome do arquivo de entrada
com o contedo de resposta solicitao.




Para mais detalhes da instalao, configurao e utilizao deste mdulo, veja as instrues do Adaptador no
apndice deste documento.



Confidencial Pg. 8 de 51


5.3 Arquivo de Retorno para Download

Este arquivo gerado diariamente contendo as transaes efetivadas do dia anterior e disponibilizado
para download atravs do Site do Sistema Pamcard.

O layout deste arquivo est detalhado no apndice deste documento.

6 Funcionalidades

O Sistema Pamcard permite realizar as seguintes transaes via integrao:


Operao Funo Cdigo
Consulta de Viagem FindTrip 5
Consulta Status de Parcela FindParcelStatus 7
Atualizar Status de Parcela UpdateParcelStatus 8
Consultar Status do Pedgio FindTollStatus 9
Atualizar Status do Pedgio UpdateTollStatus 10
Roteirizao Router 11
Consulta de Carto FindCard 12
Incluir Carto Portador Frete InsertCardFreight 21
Consultar Favorecido FindFavored 22
Inserir Favorecido InsertFavored 23
Consultar Conta Favorecido FindFavoredAccount 24
Inserir Conta Favorecido InsertFavoredAccount 25
Inserir Contrato Frete Insert 26

A tabela acima especifica as operaes, as funes disponibilizadas no Web Service e respectivos cdigos
de operaes do Adaptador.

6.1 Incluir Contrato Frete

Operao que permite a incluso de uma viagem no Sistema Pamcard. Abaixo segue a definio dos
parmetros de entrada e os campos de entrada e sada:

Campos de Entrada

VIAGEM
Descrio Tipo Tam Observao
1 viagem.contratante.documento.numero alfanumrico 20 Obrigatrio
2 viagem.unidade.documento.tipo numrico 2 Fixo=1-CNPJ
3 viagem.unidade.documento.numero alfanumrico 20
4 viagem.id.cliente numrico Obs.1
5 viagem.contrato.numero alfanumrico Obrigatrio
6 Viagem.favorecidoN.tipo Numrico 1 1-Contratado
2-subContratante
7 Viagem. favorecidoN.documento.tipo numrico 2 obrigatorio
1-CNPJ ou 2-
CPF
8 Viagem. favorecidoN.documento.numero alfanumrico 30 Obrigatrio
Obs.3

Confidencial Pg. 9 de 51


9 Viagem. favorecidoN.meio.pagamento numrico 1 1=carto;
2=conta
depsito
10 Viagem. favorecidoN.conta.banco Numrico 4 Obs. 2
11 Viagem. favorecidoN.conta.agencia alfanumrico 10 Obs. 2
12 Viagem. favorecidoN.conta.numero Alfanumrico 10 Obs. 2
13 Viagem. favorecidoN.conta.tipo Numrico 1 Obs. 2
14 viagem. favorecidoN.cartao.numero numrico 16 Obs.4
15 Viagem.veiculo.placa.qtde Numrico 1 Max. 5
ocorrncias
16 viagem.veiculo.placaN Alfanumrico 7 Obrigatrio
Obs 5
17 viagem.veiculo.rntrcN alfanumrico 7
18 viagem.veiculo.categoria Alfanumrico Obrigatrio se
viagem.pedagio
.roteirizar=S
19 viagem.data.partida Data 10 dd/mm/yyyy
20 viagem.data.termino Data 10 dd/mm/yyyy
Obs 6
21 viagem.rota.id numrico 10 Obs 7
22 viagem.rota.nome alfanumrico 50 Obs 9
23 viagem.origem.pais.nome alfanumrico 50 Obs 10
24 viagem.origem.estado.nome alfanumrico 50 Obs 10
25 viagem.origem.cidade.nome alfanumrico 50 Obs 10
26 viagem.origem.cidade.ibge numrico 7 Obs 10
27 viagem.destino.cidade.ibge numerico 7 Obs 10
28 viagem.destino.pais.nome alfanumrico 50 Obs 10
29 viagem.destino.estado.nome alfanumrico 50 Obs 10
30 viagem.destino.cidade.nome alfanumrico 50 Obs 10
31 viagem.ponto.qtde numrico 10 Obs 11
31.1 viagem.pontoN.pais.nome alfanumrico 50
31.2 viagem.pontoN.estado.nome alfanumrico 50
31.3 viagem.pontoN.cidade.nome alfanumrico 50
31.4 viagem.pontoN.cidade.ibge numrico 7
32 viagem.pedagio.valor decimal 9,2 Obs 12
33 viagem.pedagio.status.id numrico 2 Ver Tabela
34 viagem.pedagio.roteirizar booleano 1 (S ou N)
Obs 13
35 viagem.pedagio.obter.praca Alfa 1 (S ou N)
Obs 14
36 viagem.pedagio.utiliza.saldo Alfa 1 (S ou N)
obs 15
37 Viagem.carga.tipo Numrico 1 1-Lotao
2-Fracionada
38 viagem.documento.qtde numrico 10 Obrigatrio
Obs. 16
39 viagem.documentoN.tipo numrico 2 Obrigatrio
Ver Tabela
40 viagem.documentoN.numero alfanumrico 30 Obrigatrio
41 viagem.documentoN.serie Alfa 5 Obrigatrio se
informado
documento.num
ero
42 viagem.documentoN.natureza Alfa 60 Obrigatrio se
informado
documento.num
ero
43 Viagem.documentoN.quantidade decimal 7,2 Obrigatrio se
informado

Confidencial Pg. 10 de 51


documento.num
ero
44 viagem.documentoN.especie Alfa 15 Obrigatrio se
informado
documento.num
ero
45 viagem.documentoN.peso decimal 8,3 Obrigatrio se
informado
documento.num
ero
46 viagem.documentoN.cubagem decimal 8,3
47 viagem.documentoN.mercadoria.valor decimal 17,2
48 viagem.documentoN.pessoafiscal.qtde numrico 2 Obrigatorio
49 viagem.documentoN.pessoafiscalN.tipo Numrico 1 Obrigatrio
1=Remetente
2=Destinatrio
3=Consignatri
o
50 viagem.documentoN.pessoafiscalN.codigo Numrico 10 Obs. 17
51 viagem.documentoN.pessoafiscalN.documento Alfanumrico 20 Obs. 18
52 viagem.documentoN.pessoafiscalN.nome Alfanumrico 40 Obs. 18
53 viagem.documentoN.pessoafiscalN.logradouro Alfanumrico 40 Obs. 18
54 viagem.documentoN.pessoafiscalN.numero Numrico 5 Obs. 18
55 viagem.documentoN.pessoafiscalN.complemento Alfanumrico 15 Obs. 18
56 viagem.documentoN.pessoafiscalN.bairro Alfanumrico 30 Obs.18
57 viagem.documentoN.pessoafiscalN.pais.nome Alfanumrico 30 Obs. 18
58 viagem.documentoN.pessoafiscalN.estado.nome Alfanumrico 2 Obs. 18
59 viagem.documentoN.pessoafiscalN.cidade.nome Alfanumrico 30 Obs. 18
60 viagem.documentoN.pessoafiscalN.cidade.ibge numrico 7 Obs. 18
Obs. 19
61 viagem.documentoN.pessoafiscalN.cep Numrico 8 Obs. 18
62 viagem.documento.complementar.qtde Numrico 2 Obs. 20
63 viagem.documento.complementarN.tipo Numrico 2 Ver Tabela
64 viagem.parcela.qtde numrico 10 Obrigatrio
65 viagem.parcelaN.efetivacao.tipo numrico 2 Ver Tabela
66 viagem.parcelaN.valor decimal 9,2 Obs 12
67 viagem.parcelaN.subtipo numrico 2 Ver Tabela
68 viagem.parcelaN.base booleano 1 (S ou N)
Obs. 25
69 viagem.parcelaN.status.id numrico 2 Ver Tabela
70 viagem.parcelaN.data data (dd/mm/aaaa)
71 viagem.parcelaN.favorecido numrico 1 Obrigatrio
1=contratado
2=sub
contratado
72 Viagem.quitacao.prazo Numrico 2 Obs 20
73 viagem.quitacao.indicador Booleano 1 (S ou N) Obs
22
74 viagem.quitacao.entrega.ressalva Booleano 1 (S ou N) obs 23
75 viagem.indicador.provedor.certificacao Numrico 2 =01 pamcert
Obs. 22
76 viagem.comprovacao.observacao alfa 4000 Obs. 22
77 viagem.frete.valor.bruto decimal 9,2 obrigatrio
Obs 24
78 viagem.frete.valor.liquido decimal 9,2 Obrigatrio
Obs 24
79 viagem.frete.item.qtde Numrico 2 Obrigatrio
80 viagem.frete.itemN.tipo Numrico 3 Ver Tabela
81 viagem.frete.itemN.valor decimal 17,2 Obs. 26

Confidencial Pg. 11 de 51




Observaes:

1. O parmentro viagem.id.cliente deve ser utilizado para garantir que no haja registro de viagem
duplicado para a empresa. A empresa dever enviar um cdigo de controle que garanta que a viagem
nica seu sistema.
2. Contedo do parmetro contratado no pode ser nulo desde que o campo viagem.contratado.qtde foi
informado.
a. Todos os campos referente ao contratado devem ser preenchidos conforme o meio de
pagamento.
b. Meio de pagamento Carto deve ser informado o campo viagem.contratadoN.cartao.numero.
c. Meio de pagamento Conta Depsito deve ser informado viagem.contratadoN.conta.banco,
viagem.contratadoN.conta.agencia, viagem.contratadoN.conta.numero,
viagem.contratadoN.conta.tipo.

3. O preenchimento do campo viagem.contratadoN.documento.numero deve ser de acordo com o campo
viagem.contratadoN.documento.numero.

4. Caso seja informado at 10 dgitos se refere ao nmero Pamcard, de 11 16 dgitos nmero Visa.
O carto tipo Portador Frete novo, que ainda no tem viagem cadastrada anteriormente requer o
cadastramento do portador.

5. As placas devem ser preenchidas no formato AAA9999 e no podem ser duplicadas entre elas.

6. Data de Trmino deve ser maior ou igual data da partida.

7. Opo 1 - Se for informado o ID da Rota (parmetro 22), cdigo gerado no cadastramento de rotas do
Sistema Pamcard, os parmetros de 23 a 32.4 sero desconsiderados;
8. Opo 2 - Se for informado o nome da Rota (parmetro 23), nome informado no cadastramento de
rotas do Sistema Pamcard, os parmetros de 22 e 24 a 32.4 sero desconsiderados;
9. Opo 3 Se for informada a rota atravs dos cdigos IBGE das cidades (parmetros 27 e 28), os
parmetros 22 ao 26, e 29 ao 32.3 sero desconsiderados;
10. Opo 4 Se no houver Rota previamente cadastrada no Sistema Pamcard, os parmetros 24 ao 26 e
29 ao 31 sero de preenchimento obrigatrio e os paramtros 22 e 23, 27 e 28 sero desconsiderados;
Os Nomes de Cidade, Estados e Pases devero ser preenchidos Padro Correios.(caracteres
especiais sero suprimidos no cadastramento, com exceo do hfen)
11. Preencher com a quantidade de pontos intermedirios a serem informados (passando por). Se no
houver pontos intermedirios informar quantidade = 0 (Zero);
12. Os campos de valor devem ter a representao decimal indicada por ponto. Exemplo: 999999999.99 ;
13. Se for informado viagem.pedagio.roteirizar = S ser calculado o valor do pedgio, quantidade de
praas de pedgio e quilometragem.
Seno ser considerado o valor informado como o valor do pedgio.
14. Se for solicitado a apresentao das praas de pedgio (viagem.pedagio.obter.praca = S), o parmetro
viagem.pedgio.roteirizar deve ser = S .
Ser apresentado nmero de praas, o nome e valor por praa de pedgio, alm do total.
15. Se a empresa est configurada para utilizar Saldo do Carto ter opo para utilizar ou no o saldo.
Caso contrrio no deve ser informado este parmetro.
16. O campo viagem.documento.qtde deve corresponder qtde de documentos a serem informados na
lista.
17. Campo obrigatrio se demais campos do remetente no forem informados.
Se informado este campo demais campos de pessoa fiscal sero desconsiderados.
18. Campo obrigatrio se no informado atravs do cdigo.
19. Obrigatrio se no informado Viagem.documentoN.pessoafiscalN.pais.nome,
viagem.documentoN.pessoafiscalN.estado.nome, Viagem.documentoN.pessoafiscalN.cidade.nome
20. Obrigatrio conforme quantidade de documentos complementares informado.
21. Nmero de dias para disparar o pagamento do Saldo Final.
22. Flag para indicar se a empresa permite quitao das parcelas.
23. Flag para indicar se a empresa permite ressalva na entrega.
24. Campo deve ser igual ao resultado do valor bruto (+) Crditos (-) Dbitos (-) Compensaes
Campo deve ser igual Somatria das Parcelas de Frete

Confidencial Pg. 12 de 51


25. O Campo viagem.parcelaN.base deve ser utilizado quando for Tipo de parcela Abastecimento e, neste
caso o valor default ser S.
26. Se o Tipo do Item de Frete for informado, o valor passa a ser obrigatrio.


ATENO:

Para garantir que no haja envio de informaes incompletas para processamento, seguir as
instrues de gerao de arquivo nas instrues do Adaptador no apndice deste documento.



Campos de Retorno

RETORNO
Descrio Tipo Tam Observao
1 mensagem.codigo numrico 2 Ver Tabela
2 mensagem.descricao alfanumrico 100
3 viagem.id alfanumrico 100
5 viagem.pedagio.qtde numrico 2 Obs 31
6 Viagem.pedagio.praaN.seq Numrico 2 Obs 31
7 Viagem.pedagio.pracaN.nome Alfanumrico 110 Obs 31
8 Viagem.pedagio.pracaN.valor decimal 9,2 Obs 31
9 Viagem.pedagio.km Decimal 19,4
10 Viagem.rota.nome alfa 50 Obs31
11 Viagem.origem.pais.nome alfa 50 Obs 31
12 Viagem.origem.estado.nome Alfa 50 Obs 31
13 viagem.origem.cidade.nome Alfa 50 Obs 31
14 viagem.destino.pais.nome Alfa 50 Obs 31
15 viagem.destino.estado.nome Alfa 50 Obs 31
16 viagem.destino.cidade.nome Alfa 50 Obs 31
17 viagem.pontoN.pais.nome Alfa 50 Obs 31
18 viagem.pontoN.estado.nome Alfa 50 Obs 31
19 viagem.pontoN.cidade.nome Alfa 50 Obs 31

1. Quando for solicitada viagem.pedagio.roteirizar = S, o sistema apresenta as informaes da
roteirizao.
2. Se for informado viagem.pedagio.obter.rota = S, o sistema busca os Nomes do Pas, Cidades e
Estado da Rota Cadastrada caso a opo informada seja Id da Rota, Id da Rota Cliente ou Nome da
Rota, caso contrario estes nomes sero obtidos do Cod.IBGE informado ou Nomes das
Cidades/Estados/Pais informados
Os pontos sero apresentados na sequencia de cadastramento.


6.2 Consultar Viagem

Operao que permite a consulta de uma viagem no Sistema Pamcard. Abaixo segue a definio dos
parmetros de entrada e os campos de entrada e retorno:
A consulta de viagem pode ser realizada pelo viagem.id ou viagem.id.cliente ou informaes do
documento da viagem, mas o resultado deve ser somente 1 viagem.

Parmetros de Entrada

Parmetro Tipo Valor
certificate object Obs1
context alfanumrico Fixo=FindTrip
fields array <Campos de Entrada>
token alfanumrico

Confidencial Pg. 13 de 51


Observaes:
1. O parmetro Certificate dever ser inserido como array de bytes para seu correto
funcionamento.

Campos de Entrada

VIAGEM
Descrio Tipo Tam Observao
1 viagem.id numrico 10
2 viagem.id.cliente numrico 10
3 viagem.contratante.documento.numero alfanumrico 20 Obrigatrio
4 viagem.unidade.documento.tipo numrico 2 Fixo=1-CNPJ
Obs 3
5 viagem.unidade.documento.numero alfanumrico 20
6 viagem.documento.qtde Obs.6
7 viagem.documento.tipo numrico 2 Ver Tabela
8 viagem.documento.numero alfanumrico 30
9 viagem.cartao.numero numrico 16 Obs. 7
10 viagem.pedagio.obter.praca Alfa 1 (S ou N) Obs 4
11 Viagem.pedagio.obter.rota Booleano 1 S ou N Obs 5

Observaes:
1. O cliente dever sempre informar o CNPJ da Contratante;
2. As chaves viagem.unidade.documento.tipo e viagem.unidade.documento.numero, sero
obrigatrias apenas quando a autenticao for realizada por uma filial. Se a empresa que
estar realizando a autenticao for uma contratante, ser obrigatrio apenas a chave
viagem.contratante.documento.numero .
3. O Tipo do Documento da Unidade, caso no seja informado, ter valor default 1 (CNPJ);
4. Se for solicitado a apresentao das praas de pedgio (viagem.pedgio.obter.praca = S),
o parmetro viagem.pedgio.roteirizar deve ser = S .
Ser apresentado nmero de praas, o nome e valor por praa de pedgio, alm do total.

viagem.pedagioN.praca.seq
viagem.pedagioN.praca.nome
viagem.pedagioN.praca.valor
viagem.pedagio.praca.qtde
viagem.pedagio.valor

5. Se for solicitado viagem.pedagio.obter.rota = S o sistema retorna a kilometragem gerado
na Roteirizao, pelo campo viagem.pedagio.km
6. Se a consulta da viagem for solicitada pelo documento da viagem, este nmero deve ser
nico, para que a pesquisa somente 1 viagem.
A pesquisa por documento de viagem deve ser preenchido os campos:
Viagem.documento.qtde, viagem.documento.tipo e viagem.documento.numero.
7. A pesquisa de viagem por carto tambm s ser possvel se o retorno da pesquisa
retornar somente 1 viagem.
8. Se a viagem for tipo contrato frete estes campos podem ser consultados.
9. Se for solicitado a pesquisa por tipo e nmero do documento da viagem, necessrio
informar o parmetro viagem.documento.qtde, alm do tipo e nmero do documento.


ATENO:

Para garantir que no haja envio de informaes incompletas para processamento, seguir as
instrues de gerao de arquivo nas instrues do Adaptador no apndice deste documento.



Campos de Retorno


Confidencial Pg. 14 de 51


RETORNO
Descrio Tipo Tam Observao
1 mensagem.codigo numrico 2 Ver Tabela
2 mensagem.descricao alfanumrico 100
3 viagem.id numrico 10
4 viagem.id.cliente numrico 10
5 viagem.documento.qtde numrico 10
5.1 viagem.documentoN.tipo numrico 2
5.2 viagem.documentoN.numero alfanumrico 30
6 viagem.contrato.numero alfanumrico 30
7 viagem.cartao.tipo numrico 2
8 viagem.cartao.numero numrico 16
9 viagem.cartao.portador.nome alfanumrico 60
10 Viagem.cartao.portador.rntrc Numrico 14
11 Viagem.cartao.portador.documento.numero Alfa 9
12 Viagem.cartao.portador.documento.tipo numerico 2
13 viagem.data.partida data
14 viagem.data.termino Data Data da
finalizao da
viagem
15 Viagem.data.fim.viagem data Data final
prevista
Obs. 9
16 viagem.veiculo.placa alfanumrico 8
16.1 viagem.veiculo.placa.carreta1 Alfa 7 Formato
AAA1111
Obs. 9
16.2 viagem.veiculo.placa.carreta2 Alfa 7 Formato
AAA1111
Obs. 9
16.3 viagem.veiculo.placa.carreta3 Alfa 7 Formato
AAA1111
Obs. 9
17 viagem.rota.id numrico 10
18 viagem.rota.nome alfanumrico 50
19 viagem.origem.pais.nome alfanumrico 50
20 viagem.origem.estado.nome alfanumrico 50
20 viagem.origem.cidade.nome alfanumrico 50
21 viagem.ponto.qtde numrico 10
21.1 viagem.pontoN.pais.nome alfanumrico 50
21.2 viagem.pontoN.estado.nome alfanumrico 50
21.3 viagem.pontoN.cidade.nome alfanumrico 50
22 viagem.destino.pais.nome alfanumrico 50
23 viagem.destino.estado.nome alfanumrico 50
24 viagem.destino.cidade.nome alfanumrico 50
25 viagem.pedagio.origem numrico 2 Uso restrito
Fixo=1
26 viagem.pedagio.valor decimal 9,2
27 viagem.pedagio.status numrico 2
28 viagem.pedagio.roteirizar booleano 1 (S ou N)
29 Viagem.pedagio.km Decimal 19,4
30 viagem.parcela.qtde numrico 10
31 viagem.parcelaN.valor decimal 9,2
32 viagem.parcelaN.tipo numrico 2
33 viagem.parcelaN.origem numrico 2 Uso restrito
Fixo=1
34 viagem.parcelaN.base booleano 1 (S ou N)
35 viagem.parcelaN.data data (dd/mm/aaaa)
36 viagem.valor decimal 9,2

Confidencial Pg. 15 de 51


37 Viagem.quitacao.prazo Numrico 2 Obs 7 e 9
38 viagem.quitacao.indicador Booleano 1 Obs 7 e 9
39 viagem.quitacao.entrega.ressalva Booleano 1 Obs 7 e 9
40 viagem.indicador.provedor.certificacao Numrico 2 =01 pamcert
Obs. 9
41 Viagem.comprovacao.observacao alfa 4000 Obs 7 e 9
42 viagem.frete.valor.bruto decimal 9,2 Obs 7 e 9
43 viagem.frete.valor.liquido decimal 9,2 Obs 7 e 9
44 viagem.frete.item.qtde Numrico 2 Obs 7 e 9
45 viagem.frete.itemN.tipo Numrico 3 Obs 7 e 9
46 viagem.frete.itemN.valor decimal 17,2 Obs 7 e 9


Confidencial Pg. 16 de 51




Confidencial Pg. 17 de 51



6.3 Consultar Status da Parcela

Operao que permite a consulta do status de uma parcela de frete no Sistema Pamcard. Abaixo segue a
definio dos parmetros de entrada e os campos de entrada e retorno:

Parmetros de Entrada

Parmetro Tipo Valor
certificate object Obs1
context alfanumrico Fixo=FindParcelStatus
fields array <Campos de Entrada>
token alfanumrico
Observaes:
1. O parmetro Certificate dever ser inserido como array de bytes para seu correto
funcionamento.

Campos de Entrada

VIAGEM
Descrio Tipo Tam Observao
1 viagem.id numrico 10
2 viagem.id.cliente numrico 10
3 viagem.contratante.documento.numero alfanumrico 20 Obrigatrio
4 viagem.unidade.documento.tipo numrico 2 Fixo=1-CNPJ
Obs 3
5 viagem.unidade.documento.numero alfanumrico 20
6 viagem.documento.tipo numrico 2 Ver Tabela
7 viagem.documento.numero alfanumrico 30
8 viagem.cartao.tipo numrico 2 opcional
9 viagem.cartao.numero numrico 16 Obs. 5
10 viagem.parcela.numero numrico 2 Obrigatrio

Observaes:
1. O cliente dever sempre informar o CNPJ da Contratante;
2. As chaves viagem.unidade.documento.tipo e viagem.unidade.documento.numero, sero
obrigatrias apenas quando a autenticao for realizada por uma filial. Se a empresa que
estar realizando a autenticao for uma contratante, ser obrigatrio apenas a chave
viagem.contratante.documento.numero .
3. O Tipo do Documento da Unidade, caso no seja informado, ter valor default 1 (CNPJ);
4. Para a localizao da viagem, dever ser usado o parmetro 1 ou o 2.
5. Se for informado 10 posies ser validado como carto Pamcard e acima de 10 posies
ser validado como nmero Visa.

ATENO:

Para garantir que no haja envio de informaes incompletas para processamento, seguir as
instrues de gerao de arquivo nas instrues do Adaptador no apndice deste documento.


Campos de Retorno

RETORNO
Descrio Tipo Tam Observao
1 mensagem.codigo numrico 2 Ver Tabela
2 mensagem.descricao alfanumrico 100
3 viagem.parcela.status.id numrico 2
4 viagem.parcela.status.descrio alfanumrico 50

Confidencial Pg. 18 de 51



6.4 Alterar Status da Parcela

Operao que permite a alterao do status de uma parcela de frete no Sistema Pamcard. Abaixo segue
a definio dos parmetros de entrada e os campos de entrada e retorno:

Parmetros de Entrada

Parmetro Tipo Valor
certificate object Obs1
context alfanumrico Fixo=UpdateParcelStatus
fields array <Campos de Entrada>
token alfanumrico
Observaes:
1. O parmetro Certificate dever ser inserido como array de bytes para seu correto
funcionamento.


Campos de Entrada

VIAGEM
Descrio Tipo Tam Observao
1 viagem.id numrico 10
2 viagem.id.cliente numrico 10
3 viagem.contratante.documento.numero alfanumrico 20 Obrigatrio
4 viagem.unidade.documento.tipo numrico 2 Fixo=1-CNPJ
Obs 3
5 viagem.unidade.documento.numero alfanumrico 20
6 viagem.documento.tipo numrico 2 Ver Tabela
7 viagem.documento.numero alfanumrico 30
8 viagem.cartao.tipo numrico 2 opcional
9 viagem.cartao.numero numrico 16 Obs.9
10 viagem.parcela.qtde numrico 10 Obs 8
Obrigatrio
10.1 viagem.parcelaN.numero numrico 2 Obrigatrio
10.2 viagem.parcelaN.status.id numrico 2 Obrigatrio
Ver Tabela

Observaes:
1. O cliente dever sempre informar o CNPJ da Contratante;
2. As chaves viagem.unidade.documento.tipo e viagem.unidade.documento.numero, sero
obrigatrias apenas quando a autenticao for realizada por uma filial. Se a empresa que
estar realizando a autenticao for uma contratante, ser obrigatrio apenas a chave
viagem.contratante.documento.numero .
3. O Tipo do Documento da Unidade, caso no seja informado, ter valor default 1 (CNPJ);
4. Para a localizao da viagem, dever ser usado o parmetro 1 ou o 2.
5. No ser permitida a alterao para o status 5-EFETIVADA atravs desse WebService.
Efetivao deve ser realizada atravs do WebService PayParcel.
6. Parcelas com status 4-EXCLUIDA, no podem ter seu status alterado.
7. As operaes permitidas nesse WebService so de LIBERAO e BLOQUEIO para o status
da parcela.
8. Neste campo dever ser informada a quantidade de parcelas de frete e combustvel que
sero informadas nesta funcionalidade. Caso seja somente pagamento de pedgio informar
0 (Zero) e no relacionar os paramentos seguintes.
9. Se for informado 10 posies ser validado como carto Pamcard e acima de 10 posies
ser validado como nmero Visa.




Confidencial Pg. 19 de 51



ATENO:

Para garantir que no haja envio de informaes incompletas para processamento, seguir as
instrues de gerao de arquivo nas instrues do Adaptador no apndice deste documento.



Campos de Retorno

RETORNO
Descrio Tipo Tam Observao
1 mensagem.codigo numrico 2 Ver Tabela
2 mensagem.descricao alfanumrico 100


6.5 Consultar Status do Pedgio

Operao que permite a consulta do status de um pedgio no Sistema Pamcard. Abaixo segue a definio
dos parmetros de entrada e os campos de entrada e retorno:

Parmetros de Entrada

Parmetro Tipo Valor
certificate object Obs1
context alfanumrico Fixo=FindTollStatus
fields array <Campos de Entrada>
token alfanumrico

Observaes:
1. O parmetro Certificate dever ser inserido como array de bytes para seu correto
funcionamento.

Campos de Entrada

VIAGEM
Descrio Tipo Tam Observao
1 viagem.id numrico 10
2 viagem.id.cliente numrico 10
3 viagem.contratante.documento.numero alfanumrico 20 Obrigatrio
4 viagem.unidade.documento.tipo numrico 2 Fixo=1-CNPJ
5 viagem.unidade.documento.numero alfanumrico 20
6 viagem.documento.tipo numrico 2 Ver Tabela
7 viagem.documento.numero alfanumrico 30
8 viagem.cartao.tipo numrico 2 opcional
9 viagem.cartao.numero numrico 16 Obs 4

Observaes:
1. O cliente dever sempre informar o CNPJ da Contratante;
2. As chaves viagem.unidade.documento.tipo e viagem.unidade.documento.numero, sero
obrigatrias apenas quando a autenticao for realizada por uma filial. Se a empresa que
estar realizando a autenticao for uma contratante, ser obrigatrio apenas a chave
viagem.contratante.documento.numero .
3. Para a localizao da viagem, dever ser usado o parmetro 1 ou o 2.
4. Se for informado 10 posies ser validado como carto Pamcard e acima de 10 posies
ser validado como nmero Visa.



Confidencial Pg. 20 de 51


ATENO:

Para garantir que no haja envio de informaes incompletas para processamento, seguir as
instrues de gerao de arquivo nas instrues do Adaptador no apndice deste documento.



Campos de Retorno

RETORNO
Descrio Tipo Tam Observao
1 mensagem.codigo numrico 2 Ver Tabela
2 mensagem.descricao alfanumrico 100
3 viagem.pedagio.status.id numrico 2 Ver Tabela
4 viagem.pedagio.status.descrio alfanumrico 50


6.6 Alterar Status do Pedgio

Operao que permite a alterao do status de um pedgio no Sistema Pamcard. Abaixo segue a
definio dos parmetros de entrada e os campos de entrada e retorno:

Parmetros de Entrada

Parmetro Tipo Valor
certificate object Obs1
context alfanumrico Fixo=UpdateTollStatus
fields array <Campos de Entrada>
token alfanumrico
Observaes:
1. O parmetro Certificate dever ser inserido como array de bytes para seu correto
funcionamento.

Campos de Entrada

VIAGEM
Descrio Tipo Tam Observao
1 viagem.id numrico 10
2 viagem.id.cliente numrico 10
3 viagem.contratante.documento.numero alfanumrico 20
4 viagem.unidade.documento.tipo numrico 2 Fixo=1-CNPJ
5 viagem.unidade.documento.numero alfanumrico 20
6 viagem.pedagio.status.id numrico 2 Obrigatrio
Ver tabela
7 viagem.documento.tipo numrico 2 Ver Tabela
8 viagem.documento.numero alfanumrico 30
9 viagem.cartao.numero numrico 16 Obs. 5

Observaes:
1. O cliente dever sempre informar o CNPJ da Contratante;
2. As chaves viagem.unidade.documento.tipo e viagem.unidade.documento.numero, sero
obrigatrias apenas quando a autenticao for realizada por uma filial. Se a empresa que
estar realizando a autenticao for uma contratante, ser obrigatrio apenas a chave
viagem.contratante.documento.numero .
3. Para a localizao da viagem, dever ser usado o parmetro 1 ou o 2.
4. Se o status do pedgio for 2-LIBERADO ou 5-CARREGADO, no ser permitido alterar o
mesmo.
5.

Confidencial Pg. 21 de 51


ATENO:

Para garantir que no haja envio de informaes incompletas para processamento, seguir as
instrues de gerao de arquivo nas instrues do Adaptador no apndice deste documento.


Campos de Retorno

RETORNO
Descrio Tipo Tam Observao
1 mensagem.codigo numrico 2 Ver Tabela
2 mensagem.descricao alfanumrico 100


6.7 Roteirizar

Operao que permite a roteirizao de uma determinada viagem no Sistema Pamcard. Abaixo segue a
definio dos parmetros de entrada e os campos de entrada e retorno:

Parmetros de Entrada

Parmetro Tipo Valor
certificate object Obs1
context alfanumrico Fixo=Router
0fields array <Campos de Entrada>
token alfanumrico
Observaes:
1. O parmetro Certificate dever ser inserido como array de bytes para seu correto
funcionamento.

Campos de Entrada

VIAGEM
Descrio Tipo Tam Observao
1 viagem.contratante.documento.numero alfanumrico 20 Obrigatrio
2 viagem.unidade.documento.tipo numrico 2 Fixo=1-CNPJ
3 viagem.unidade.documento.numero alfanumrico 20
4 viagem.veiculo.categoria alfanumrico 3 Ver Tabela
5 viagem.rota.id numrico 10 Obs 3
6 viagem.rota.nome alfanumrico 50 Obs 4
7 viagem.origem.pais.nome alfanumrico 50 Obs 6
8 viagem.origem.estado.nome alfanumrico 50 Obs 6
9 viagem.origem.cidade.nome alfanumrico 50 Obs 6
10 viagem.origem.cidade.ibge numrico 7 Obs 5
11 viagem.destino.cidade.ibge numrico 7 Obs 5
12 viagem.destino.pais.nome alfanumrico 50 Obs 6
13 viagem.destino.estado.nome alfanumrico 50 Obs 6
14 viagem.destino.cidade.nome alfanumrico 50 Obs 6
15 viagem.ponto.qtde numrico 10 Obs 8
15.1 viagem.pontoN.pais.nome alfanumrico 50
15.2 viagem.pontoN.estado.nome alfanumrico 50
15.3 viagem.pontoN.cidade.nome alfanumrico 50
16 viagem.pedagio.obter.praca Alfa 1 (S ou N) Obs 9
17 Viagem.pedagio.obter.rota Booleano 1 S ou N Obs 10

Observaes:
1. O cliente dever sempre informar o CNPJ da Contratante;
2. As chaves viagem.unidade.documento.tipo e viagem.unidade.documento.numero, sero

Confidencial Pg. 22 de 51


obrigatrias apenas quando a autenticao for realizada por uma filial. Se a empresa que
estar realizando a autenticao for uma contratante, ser obrigatrio apenas a chave
viagem.contratante.documento.numero .
3. Opo 1 - Se for informado o ID da Rota (parmetro 5), cdigo gerado no cadastramento
de rotas do Sistema Pamcard, os parmetros de 6 a 14 sero desconsiderados;
4. Opo 2 - Se for informado o nome da Rota (parmetro 6), nome informado no
cadastramento de rotas do Sistema Pamcard, os parmetros de 5 e 7 a 14 sero
desconsiderados;
5. Opo 3 Se for informada a rota atravs dos cdigos IBGE das cidades (parmetros 10 e
11), os parmetros 5 ao 9, e 12 ao 14 sero desconsiderados;
6. Opo 4 Se no houver Rota previamente cadastrada no Sistema Pamcard, os parmetros
7 a 9 e 12 a 14 sero de preenchimento obrigatrio e os paramtros 5 e 6, 10 e 11 sero
desconsiderados;
7. Os Nomes de Cidade, Estados e Pases devero ser preenchidos em Maisculo, Sem
Acentuao, Sem caracteres especiais (Padro Correios)
8. Preencher com a quantidade de pontos intermedirios a serem informados (passando por).
Se no houver pontos intermedirios informar quantidade = 0 (Zero).
9. Se for solicitado a apresentao das praas de pedgio (viagem.pedgio.obter.praca = S),
o parmetro viagem.pedgio.roteirizar deve ser = S .
Ser apresentado nmero de praas, o nome e valor por praa de pedgio, alm do total.

viagem.pedagioN.praca.seq
viagem.pedagioN.praca.nome
viagem.pedagioN.praca.valor
viagem.pedagio.praca.qtde
viagem.pedagio.valor

10. Parmetro viagem.pedagio.obter.rota = S retorna Origem/Destino de rota cadastrada.

ATENO:

Para garantir que no haja envio de informaes incompletas para processamento, seguir as
instrues de gerao de arquivo nas instrues do Adaptador no apndice deste documento.



Campos de Retorno

RETORNO
Descrio Tipo Tam Observao
1 mensagem.codigo numrico 2 Ver Tabela
2 mensagem.descricao alfanumrico 100
3 viagem.pedagio.valor decimal 9,2
4 viagem.pedagio.pracas.quantidade numrico 2
5 Viagem.pedagio.km Decimal 19,4 Obs 10.


Confidencial Pg. 23 de 51



6.8 Consultar Carto

Operao que permite a consulta do status de um carto no Sistema Pamcard. Abaixo segue a definio
dos parmetros de entrada e os campos de entrada e retorno:

Parmetros de Entrada

Parmetro Tipo Valor
certificate object Obs1
context alfanumrico Fixo=FindCard
fields array <Campos de Entrada>
token alfanumrico
Observaes:
1. O parmetro Certificate dever ser inserido como array de bytes para seu correto
funcionamento.

Campos de Entrada

VIAGEM
Descrio Tipo Tam Observao
1 viagem.contratante.documento.numero alfanumrico 20 Obrigatrio
2 viagem.unidade.documento.tipo numrico 2 Fixo=1-CNPJ
3 viagem.unidade.documento.numero alfanumrico 20
4 viagem.cartao.numero Numrico 16 obrigatrio
Observaes:
1. O cliente dever sempre informar o CNPJ da Contratante;
2. As chaves viagem.unidade.documento.tipo e viagem.unidade.documento.numero, sero
obrigatrias apenas quando a autenticao for realizada por uma filial. Se a empresa que
estiver realizando a autenticao for uma contratante, ser obrigatrio apenas a chave
viagem.contratante.documento.numero .
3. Se for informado um carto do tipo VALE-PEDGIO no existente no banco de dados, o
WebService ir incluir o mesmo no banco de dados.

ATENO:

Para garantir que no haja envio de informaes incompletas para processamento, seguir as
instrues de gerao de arquivo nas instrues do Adaptador no apndice deste documento.



Campos de Retorno

RETORNO
Descrio Tipo Tam Observao
1 mensagem.codigo numrico 2 Ver Tabela
2 mensagem.descricao alfanumrico 100
3 viagem.cartao.portador.documento.numero alfanumrico 11
4 viagem.cartao.portador.documento.tipo numrico 2 Ver Tabela
5 viagem.cartao.portador.nome Alfanumrico 20
6 viagem.cartao.status.descricao Alfanumrico 20
7 viagem.cartao.status.id Numrico 2 Ver Tabela


Confidencial Pg. 24 de 51



6.9 Inserir Parcela

Operao que permite a incluso de parcelas em uma viagem no Sistema Pamcard. Abaixo segue a
definio dos parmetros de entrada e os campos de entrada e retorno:

Parmetros de Entrada

Parmetro Tipo Valor
certificate object Obs1
context alfanumrico Fixo=InsertParcel
fields array <Campos de Entrada>
token alfanumrico
Observaes:
1. O parmetro Certificate dever ser inserido como array de bytes para seu correto
funcionamento.

Campos de Entrada

VIAGEM
Descrio Tipo Tam Observao
1 viagem.contratante.documento.numero alfanumrico 20 Obrigatrio
2 viagem.unidade.documento.tipo numrico 2 Fixo=1-CNPJ
3 viagem.unidade.documento.numero alfanumrico 20
4 viagem.id numrico 2
5 viagem.id.cliente numrico 10
6 viagem.documento.tipo numrico 2 Ver Tabela
7 viagem.documento.numero alfanumrico 30
8 viagem.cartao.numero numrico 16 Obs. 7
9 viagem.parcela.qtde numrico 10 Obs 5
Obrigatrio
9.1 viagem.parcelaN.tipo numrico 2 Ver Tabela
9.2 viagem.parcelaN.origem numrico 2 Uso restrito
Fixo=1
9.3 viagem.parcelaN.data data Obs 4
(dd/mm/yyyy)
9.4 viagem.parcelaN.valor decimal 9,2
9.5 viagem.parcelaN.base booleano 1 (S ou N)
Obs.6
9.6 viagem.parcelaN.status.id numrico 2 Ver Tabela
9.7 viagem.parcelaN.efetivacao.tipo numrico 2 Ver Tabela

Observaes:
1. O cliente dever sempre informar o CNPJ da Contratante;
2. As chaves viagem.unidade.documento.tipo e viagem.unidade.documento.numero, sero
obrigatrias apenas quando a autenticao for realizada por uma filial. Se a empresa que
estar realizando a autenticao for uma contratante, ser obrigatrio apenas a chave
viagem.contratante.documento.numero .
3. O parmetro 4 ou 5 deve ser informado para identificao da viagem para a qual a parcela
ser includa.
4. A data da parcela deve ser sempre maior ou igual a data corrente.
5. Neste campo dever ser informada a quantidade de parcelas de frete e combustvel que
sero informadas nesta funcionalidade. Caso seja somente pagamento de pedgio informar
0 (Zero) e no relacionar os paramentos seguintes.
6. Informar viagem,parcelaN.base quando for Parcela tipo Abastecimento.





Confidencial Pg. 25 de 51


ATENO:

Para garantir que no haja envio de informaes incompletas para processamento, seguir as
instrues de gerao de arquivo nas instrues do Adaptador no apndice deste documento.



Campos de Retorno

RETORNO
Descrio Tipo Tam Observao
1 mensagem.codigo numrico 2 Ver Tabela
2 mensagem.descricao alfanumrico 100



6.10 Incluir Carto Portador Frete
Operao que permite cadastrar Carto Portador Frete no Sistema Pamcard. Abaixo segue a definio
dos parmetros de entrada e os campos de entrada e retorno:

Parmetros de Entrada

Parmetro Tipo Valor
certificate object Obs1
context alfanumrico Fixo=FindDoc
fields array <Campos de Entrada>
token alfanumrico
Observaes:

1. O parmetro Certificate dever ser inserido como array de bytes para seu correto
funcionamento.
2. Os caracteres especiais como acentuao, apstrofre espaos em branco aps ltimo caracter
sero desconsisderados na incluso, nos campos Nome, Logradouro, Bairro.
3. Se o documento do Portador possuir +de 1 carto ativo, o sistema no permite o cadastramento e
envia mensagem de erro Cancelar Vias anteriores.

Campos de Entrada

VIAGEM
Descrio Tipo Tam Observao
1 viagem.contratante.documento.numero alfanumrico 20 Obrigatrio
2 viagem.unidade.documento.tipo numrico 2 Fixo=1-CNPJ
3 viagem.unidade.documento.numero alfanumrico 20
4 viagem.cartao.numero Numrico 16 obrigatrio
5 viagem.cartao.portador.documento.tipo Numrico 2 Obrigatrio
CPF =2 default
Ver tabela Tipo
Documento
6 viagem.cartao.portador.documento.numero alfanumrico 20 obrigatrio
7 viagem.cartao.portador.rg Alfanumrico 17 Obrigatrio
8 viagem.cartao.portador.uf.rg Alfanumrico 2 Obrigatrio
9 viagem.cartao.portador.nome Alfanumrico 40 Obrigatrio
(nome +
sobrenome)
10 viagem.cartao.portador.data.nascimento DD/MM/AAAA Idade entre 18
e 100 anos
11 viagem.cartao.portador.endereco.logradouro Alfanumrico 40 Obrigatrio
12 viagem.cartao.portador.endereco.numero Numrico 5 Obrigatrio

Confidencial Pg. 26 de 51


13 viagem.cartao.portador.endereco.complemento Alfanumrico 15
14 viagem.cartao.portador.endereco.bairro Alfanumrico 30 Obrigatrio
15 viagem.cartao.portador.endereco.cidade Alfanumrico 30 Obrigatrio
padro correio
16 viagem.cartao.portador.endereco.uf Alfanumrico 2 Obrigatrio
17 viagem.cartao.portador.endereco.pais Alfanumrico 30 obrigatorio
18 viagem.cartao.portador.endereco.cep Numrico 8 obrigatorio
19 viagem.cartao.portador.telefone.ddd Numrico 3 Obrigatrio
20 viagem.cartao.portador.telefone.numero Numrico 8 obrigatorio
21 viagem.cartao.portador.celular.ddd Numrico 3 Formato 099
22 viagem.cartao.portador.celular.numero Numrico 8
23 viagem.cartao.portador.email Alfanumrico 40


Campos de Retorno

RETORNO
Descrio Tipo Tam Observao
1 mensagem.codigo numrico 2 Ver Tabela
2 mensagem.descricao alfanumrico 100

6.11 Incluir Favorecido
Operao que permite cadastrar Favorecido no Sistema Pamcard. Abaixo segue a definio dos
parmetros de entrada e os campos de entrada e retorno:

Parmetros de Entrada

Parmetro Tipo Valor
certificate object Obs1
context alfanumrico Fixo=FindDoc
fields array <Campos de Entrada>
token alfanumrico
Observaes:

1. O parmetro Certificate dever ser inserido como array de bytes para seu correto
funcionamento.
2. Caracteres especiais, acentuaes sero suprimidos na gravao dos campos nome, logradouro,
complemento, bairro

Campos de Entrada

VIAGEM
Descrio Tipo Tam Observao
1 viagem.contratante.documento.numero alfanumrico 20 Obrigatrio
2 viagem.unidade.documento.tipo numrico 2 Fixo=1-CNPJ
3 viagem.unidade.documento.numero alfanumrico 20
4 viagem.favorecido.documento.qtde Numrico 1 obrigatrio
5 viagem.favorecido.documentoN.tipo Numrico 2 Obrigatrio
Obs. 1
6 viagem.favorecido.documentoN.numero Alfanumrico 20 obrigatrio
7 viagem.favorecido.documentoN.uf Alfanumrico 2 Obs. 2
8 viagem.favorecido.nome Alfanumrico 40 Obrigatrio
Obs. 3
9 viagem.favorecido.data.nascimento Data dd/mm/yyyy
Obs. 4
10 viagem.favorecido.endereco.logradouro

Alfanumrico 40 obrigatrio

Confidencial Pg. 27 de 51


11 viagem.favorecido.endereco.numero numrico 5 Obrigatrio
12 viagem.favorecido.endereco.complemento Alfanumrico 15
13 viagem.favorecido.endereco.bairro Alfanumrico 30 Obrigatrio
14 viagem.favorecido.endereco.cidade.ibge Numrico Obs. 5
15 viagem.favorecido.endereco.cidade Alfanumrico 30 Obs. 6
16 viagem.favorecido.endereco.uf Alfanumrico 2 Obs. 6
17 viagem.favorecido.endereco.pais Alfanumrico 30 Obs. 6
18 viagem.favorecido.endereco.cep Numrico 8 Obs. 6
19 viagem.favorecido.telefone.ddd Numrico 3 obrigatrio
Formato 999
20 viagem. favorecido.telefone.numero Numrico 8 obrigatrio
21 viagem.favorecido.celular.ddd Numrico 3 Obs. 7
22 viagem.favorecido.celular.numero Numrico 8
23 viagem.favorecido.email Alfanumrico 40




Observaes:
1. Devero ser informados os tipos 1(CNPJ) e 6 (RNTRC) para Pessoa Jurdica ou 2(CPF), 3(RG) e
5(RNTRC) para Pessoa Fsica.
2. Este campo obrigatrio caso seja Tipo de documento 3-RG.
3. No deve conter nmeros; deve ser composto mnimo de 2 palavras separadas por um branco.
4. Campo obrigatrio se informado cadastro de pessoa fsica e o portador deve ter a idade mnima de 18
e mxima de 100.
5. Se este campo for informado, os campos viagem.favorecido.endereco.cidade,
viagem.favorecido.endereco.uf e viagem.favorecido.endereco.pais no devero ser informados.
6. Campo obrigatrio se viagem.favorecido.endereco.cidade.ibge no informado.
7. DDD do celular se torna obrigatrio se informar o nmero do celular e vice-versa.

Campos de Retorno

RETORNO
Descrio Tipo Tam Observao
1 mensagem.codigo numrico 2 Ver Tabela
2 mensagem.descricao alfanumrico 100

6.12 Consultar Favorecido
Operao que permite Consultar Favorecido no Sistema Pamcard. Abaixo segue a definio dos
parmetros de entrada e os campos de entrada e retorno:

Parmetros de Entrada

Parmetro Tipo Valor
certificate object Obs1
context alfanumrico Fixo=FindDoc
fields array <Campos de Entrada>
token alfanumrico
Observaes:

1. O parmetro Certificate dever ser inserido como array de bytes para seu correto
funcionamento.

Campos de Entrada

VIAGEM
Descrio Tipo Tam Observao
1 viagem.contratante.documento.numero alfanumrico 20 Obrigatrio

Confidencial Pg. 28 de 51


2 viagem.unidade.documento.tipo numrico 2 Fixo=1-CNPJ
3 viagem.unidade.documento.numero alfanumrico 20
4 viagem.favorecido.documento.tipo Numrico 2 Obrigatrio
5 viagem.favorecido.documento.numero Alfanumrico 20 Obrigatrio

Campos de Retorno

RETORNO
Descrio Tipo Tam Observao
1 mensagem.codigo numrico 2 Ver Tabela
2 mensagem.descricao alfanumrico 100
3 viagem.favorecido.nome Alfanumrico 40
4 viagem.favorecido.qtde.cartao Numrico 2
5 viagem.favorecido.cartaoN.numero Numrico 16
6 viagem.favorecido.cartaoN.tipo Alfanumrico 2 Ver Tabela
7 viagem.favorecido.cartaoN.status Alfanumrico 20
8 viagem.favorecido.conta.qtde Numrico 2
9
viagem.favorecido.contaN.banco

Numrico 4
10
viagem.favorecido.contaN.agencia
Alfanumrico 10
11
viagem.favorecido.contaN.numero
Alfanumrico 10
12
viagem.favorecido.contaN.tipo
Numrico 2
13
viagem.favorecido.contaN.status
Alfanumrico 20

6.13 Incluir Conta
Operao que permite Incluir Conta no Sistema Pamcard. Abaixo segue a definio dos parmetros de
entrada e os campos de entrada e retorno:

Parmetros de Entrada

Parmetro Tipo Valor
certificate object Obs1
context alfanumrico Fixo=FindDoc
fields array <Campos de Entrada>
token alfanumrico
Observaes:

1. O parmetro Certificate dever ser inserido como array de bytes para seu correto
funcionamento.

Campos de Entrada

VIAGEM
Descrio Tipo Tam Observao
1 viagem.contratante.documento.numero alfanumrico 20 Obrigatrio
2 viagem.unidade.documento.tipo numrico 2 Fixo=1-CNPJ
3 viagem.unidade.documento.numero alfanumrico 20
4 viagem.favorecido.documento.tipo Numrico 2 Obrigatrio
5 viagem.favorecido.documento.numero Alfanumrico 20 Obrigatrio
6
viagem.favorecido.conta.banco

Numrico 4 obrigatorio
7
viagem.favorecido.conta.agencia
Alfanumrico 10 obrigatorio
8
viagem.favorecido.conta.numero
Alfanumrico 10 obrigatorio
9
viagem.favorecido.conta.tipo
Numrico 2 Obrigatrio
1= Conta
correnmte
2=Poupana


Confidencial Pg. 29 de 51


Campos de Retorno

RETORNO
Descrio Tipo Tam Observao
1 mensagem.codigo numrico 2 Ver Tabela
2 mensagem.descricao alfanumrico 100




6.14 Consultar Conta
Operao que permite Consultar Conta no Sistema Pamcard. Abaixo segue a definio dos parmetros de
entrada e os campos de entrada e retorno:

Parmetros de Entrada

Parmetro Tipo Valor
certificate object Obs1
context alfanumrico Fixo=FindDoc
fields array <Campos de Entrada>
token alfanumrico
Observaes:
1. O parmetro Certificate dever ser inserido como array de bytes para seu correto
funcionamento.

Campos de Entrada

VIAGEM
Descrio Tipo Tam Observao
1 viagem.contratante.documento.numero alfanumrico 20 Obrigatrio
2 viagem.unidade.documento.tipo numrico 2 Fixo=1-CNPJ
3 viagem.unidade.documento.numero alfanumrico 20
4 viagem.favorecido.documento.tipo Numrico 2 Obrigatrio
5 viagem.favorecido.documento.numero Alfanumrico 20 Obrigatrio
6
viagem.favorecido.conta.banco

Numrico 4 obrigatorio
7
viagem.favorecido.conta.agencia
Alfanumrico 10 obrigatorio
8
viagem.favorecido.conta.numero
Alfanumrico 10 obrigatorio
9
viagem.favorecido.conta.tipo
Numrico 2 Obrigatrio
1= Conta
correnmte
2=Poupana

Campos de Retorno

RETORNO
Descrio Tipo Tam Observao
1 mensagem.codigo numrico 2 Ver Tabela
2 mensagem.descricao alfanumrico 100
3 viagem.favorecido.documento.tipo Numrico 2 Obrigatrio
4 viagem.favorecido.documento.numero Alfanumrico 20 Obrigatrio
5
viagem.favorecido.conta.banco

Numrico 4 obrigatorio
6
viagem.favorecido.conta.agencia
Alfanumrico 10 obrigatorio
7
viagem.favorecido.conta.numero
Alfanumrico 10 obrigatorio
8
viagem.favorecido.conta.tipo
Numrico 2 Obrigatrio
1= Conta
correnmte

Confidencial Pg. 30 de 51


2=Poupana
9
viagem.favorecido.conta.status

Alfanumrico 20


7 Apndices

7.1 WSDL
Segue abaixo o arquivo contendo o WSPamcard.wsdl:

<?xml version="1.0" encoding="UTF-8"?>
<wsdl:definitions targetNamespace="http://webservice.pamcard.jee.pamcary.com.br"
xmlns:apachesoap="http://xml.apache.org/xml-soap"
xmlns:impl="http://webservice.pamcard.jee.pamcary.com.br"
xmlns:intf="http://webservice.pamcard.jee.pamcary.com.br"
xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:tns1="http://webservice.to.core.jee.hst.com.br" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
xmlns:wsdlsoap="http://schemas.xmlsoap.org/wsdl/soap/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<!--WSDL created by Apache Axis version: 1.3
Built on Oct 05, 2005 (05:23:37 EDT)-->
<wsdl:types>
<schema targetNamespace="http://webservice.to.core.jee.hst.com.br"
xmlns="http://www.w3.org/2001/XMLSchema">
<import namespace="http://webservice.pamcard.jee.pamcary.com.br"/>
<import namespace="http://schemas.xmlsoap.org/soap/encoding/"/>
<complexType name="FieldTO">
<sequence>
<element name="key" nillable="true" type="xsd:string"/>

<element name="value" nillable="true" type="xsd:anyType"/>
</sequence>
</complexType>
<complexType name="BaseTO">
<sequence>
<element name="certificate" nillable="true" type="xsd:anyType"/>
<element name="context" nillable="true" type="xsd:string"/>
<element name="fields" nillable="true" type="impl:ArrayOf_tns1_FieldTO"/>
<element name="token" nillable="true" type="xsd:string"/>

</sequence>
</complexType>
<complexType name="RequestTO">
<complexContent>
<extension base="tns1:BaseTO">
<sequence/>
</extension>
</complexContent>
</complexType>

<complexType name="ResponseTO">
<complexContent>
<extension base="tns1:BaseTO">
<sequence/>
</extension>
</complexContent>
</complexType>
</schema>
<schema targetNamespace="http://webservice.pamcard.jee.pamcary.com.br"

Confidencial Pg. 31 de 51


xmlns="http://www.w3.org/2001/XMLSchema">

<import namespace="http://webservice.to.core.jee.hst.com.br"/>
<import namespace="http://schemas.xmlsoap.org/soap/encoding/"/>
<complexType name="ArrayOf_tns1_FieldTO">
<complexContent>
<restriction base="soapenc:Array">
<attribute ref="soapenc:arrayType" wsdl:arrayType="tns1:FieldTO[]"/>
</restriction>
</complexContent>
</complexType>

</schema>
</wsdl:types>

<wsdl:message name="executeRequest">

<wsdl:part name="requestTO" type="tns1:RequestTO"/>

</wsdl:message>

<wsdl:message name="executeResponse">

<wsdl:part name="executeReturn" type="tns1:ResponseTO"/>

</wsdl:message>

<wsdl:portType name="WSPamcard">

<wsdl:operation name="execute" parameterOrder="requestTO">

<wsdl:input message="impl:executeRequest" name="executeRequest"/>

<wsdl:output message="impl:executeResponse" name="executeResponse"/>

</wsdl:operation>

</wsdl:portType>

<wsdl:binding name="WSPamcardSoapBinding" type="impl:WSPamcard">

<wsdlsoap:binding style="rpc" transport="http://schemas.xmlsoap.org/soap/http"/>

<wsdl:operation name="execute">

<wsdlsoap:operation soapAction=""/>

<wsdl:input name="executeRequest">

<wsdlsoap:body encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"
namespace="http://webservice.pamcard.jee.pamcary.com.br" use="encoded"/>

</wsdl:input>

<wsdl:output name="executeResponse">

<wsdlsoap:body encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"
namespace="http://webservice.pamcard.jee.pamcary.com.br" use="encoded"/>

</wsdl:output>


Confidencial Pg. 32 de 51


</wsdl:operation>

</wsdl:binding>

<wsdl:service name="WSPamcardService">

<wsdl:port binding="impl:WSPamcardSoapBinding" name="WSPamcard">

<wsdlsoap:address location=" https://qualidade.gps-
pamcary.com.br/pamcardbrvisa/services/WSPamcard"/>

</wsdl:port>

</wsdl:service>

</wsdl:definitions>



7.2 Adaptador

Este adaptador destinado para a integrao com o Sistema Pamcard atravs de um sistema de arquivos
texto parametrizado.
Para a utilizao deste pacote ser fornecido em CD a estrutura de arquivos, juntamente com os arquivos
necessrios a execuo do mesmo.

Para a utilizao da integrao, o sistema de origem dever gerar arquivos de entrada (um arquivo para
cada transao), e dever deposit-lo na pasta correspondente, conforme detalhado abaixo.

Cada arquivo de entrada gerado ser correspondente a uma nica operao e, aps o processamento,
ser gerado um arquivo de sada com o mesmo nome do arquivo de entrada na pasta correspondente.

Este adaptador est homologado para o ambiente Windows.

7.2.1 Instalao

Ser fornecido um CD recebido, copiar a pasta Adaptador_Pamcard no diretrio destinado ao
processamento desta integrao.

Ateno: Os arquivos vm configurados para utilizao do diretrio c:/, caso utilize um diretrio
diferente, esta informao dever ser atualizada nos seguintes arquivos:

\Adaptador_Pamcard\conf\wspamcard-client.properties
\Adaptador_Pamcard\keystore\clientkeystore.properties
\Adaptador_Pamcard\wspamcard-client.bat


7.2.2 Estrutura de Diretrios (verso windows)

O software Client deve utilizar a seguinte estrutura de diretrios:


Confidencial Pg. 33 de 51




Pasta Adaptador_Pamcard

Este diretrio contm os arquivos de inicializao do Adaptador:
wspamcard-client.bat script para inicializao do processo

Pasta /conf

Este diretrio contm os arquivos de configurao do Adaptador:
log4j.properties: Arquivo de configurao para a API log4j.
wspamcard-client.properties: Arquivo de configurao do Adaptador. Os seguintes parmetros
devero ser ajustados:
o URL de conexo com o Web Service Transacional: transacional.url=
https://qualidade.gps-pamcary.com.br/pamcardbrvisa/services/WSPamcard
o Nome do Certificado no keystore: security.certificate.name=[Nome apresentado no edit
do arquivo keystore]
o Intervalo em segundos para leitura de um lote de arquivos: file.read.interval=10
o Parmetro para configurar tempo de resposta do Roteirizador: request.timeout=180

Pasta /files/error

Diretrio onde sero colocados os arquivos de entrada para os quais houve algum erro de validao nos
parmetros informados.

Pasta files/in

Diretrio onde devem ser colocados os arquivos de entrada.

Obs.: A ordem dos campos no ser considerada para a leitura dos campos, podendo estes estar
dispostos de forma aleatria.

Pasta files/out

Diretrio onde sero colocados os arquivos de sada processados pelo adaptador. Este arquivo ter a
informao da mensagem do retorno enviado pelo servidor de integrao Pamcard e demais campos de
sada, conforme a operao realizada.

A mensagem de retorno indicar se o processo ocorreu com sucesso ou no.

Pasta /keystore

Este diretrio contm os arquivos de configurao do Adaptador para o certificado digital:
[nome_do_certificado].ks: Arquivo do certificado digital, nomeado conforme a identificao do
cliente.
clientkeystore.properties: Arquivo de propriedades do certificado digital. Os seguintes parmetros
devero ser ajustados:

Confidencial Pg. 34 de 51


o identificao do caminho do certificado: keyStorePath=keystore/[nome_do_certificado].ks
o identificao do certificado: keyStore=keystore/[nome_do_certificado].ks
o identificao da senha do certificado (Para sua segurana no ser informada por e-
mail, somente por telefone): keyStorePassword=[senha do certificado]
o identificao da pasta de certificados do java virtual machine: trustStore=C:\"Arquivos de
programas"\Java\jre1.5.0_07\lib\security\cacerts


Pasta /lib

Bibliotecas utilizadas pelo adaptador.

Pasta /log

Diretrio do arquivo de log gerado pelo adaptador, a saber:
o wspamcard-client.log: Arquivo gerado pelo adaptador, contendo o log de todas as transaes
realizadas.


7.2.3 Gerao do Arquivo

Segue abaixo a sequncia ideal para o correto processamento dos arquivos:

1. O sistema legado do cliente gera o arquivo de acordo com as parametrizaes necessrias
para a operao a ser realizada. Este arquivo dever ter a extenso .TMP, ou seja, [nome do
arquivo escolhido pelo cliente].tmp;
2. Caso o arquivo tenha sido gerado em outra pasta, dever ser copiado para a pasta IN do
pacote Adaptador;
3. Aps finalizada a gerao e/ou cpia do arquivo com sucesso, renomear a extenso do arquivo
com uma extenso diferente de .TMP.
4. O arquivo ser processado no prximo ciclo de processamento

Obs.: Caso a instalao do Adaptador seja anterior a Janeiro/2010, entrar em contato com a
equipe de suporte integrao atravs do e-mail pamcardbrvisa@gps-pamcary.com.br para
que seja encaminhada a atualizao do aplicativo.


7.2.4 Configurao

Para o correto funcionamento do sistema as configuraes abaixo devero ser verificadas:

Configurao 01:

Na pasta C:\Adaptador_Pamcard\ editar o arquivo wspamcard-client.bat

Configurar os seguintes itens:

Definir o caminho do JAVA
Definir o diretrio onde ficar o Adaptador (Client)


@echo off
rem -------------------------------------------------------------------------
rem WS PAMCARD CLIENT
rem -------------------------------------------------------------------------
IMPORTANTE: a indicao da pasta Arquivo de Programas poder sofrer alteraes conforme a
instalao do Windows: Arquiv~1 (para sistema de arquivos com 8 bits) ou Program Files
(para verses em ingls).

Confidencial Pg. 35 de 51



set JRE_HOME=C:\Arquivos de programas\Java\jre1.5.0_06\

set WSCLIENT_HOME=C:\Adaptador_Pamcard

cd %WSCLIENT_HOME%

set WSCLIENT_PATH=lib\axis-1.3.jar;
set WSCLIENT_PATH=%WSCLIENT_PATH%;lib\commons-discovery-0.2.jar;
set WSCLIENT_PATH=%WSCLIENT_PATH%;lib\commons-logging-1.1.jar;
set WSCLIENT_PATH=%WSCLIENT_PATH%;lib\hst-core-exception.jar;
set WSCLIENT_PATH=%WSCLIENT_PATH%;lib\hst-core-helper.jar;
set WSCLIENT_PATH=%WSCLIENT_PATH%;lib\hst-core-to.jar;
set WSCLIENT_PATH=%WSCLIENT_PATH%;lib\hst-core-util.jar;
set WSCLIENT_PATH=%WSCLIENT_PATH%;lib\hst-security-certif.jar;
set WSCLIENT_PATH=%WSCLIENT_PATH%;lib\hst-util-validate.jar;
set WSCLIENT_PATH=%WSCLIENT_PATH%;lib\hst-util.jar;
set WSCLIENT_PATH=%WSCLIENT_PATH%;lib\jaxrpc-1.1.jar;
set WSCLIENT_PATH=%WSCLIENT_PATH%;lib\lista.txt;
set WSCLIENT_PATH=%WSCLIENT_PATH%;lib\log4j-1.2.9.jar;
set WSCLIENT_PATH=%WSCLIENT_PATH%;lib\pamcard-ws-client.jar;
set WSCLIENT_PATH=%WSCLIENT_PATH%;lib\saaj.jar;
set WSCLIENT_PATH=%WSCLIENT_PATH%;lib\servlet-api.jar;
set WSCLIENT_PATH=%WSCLIENT_PATH%;lib\wsdl4j.jar;

echo -------------------------------------------------------------------------
echo .
echo WS PAMCARD CLIENT
echo .
echo JRE_HOME: %JRE_HOME%
echo .
echo WSCLIENT_HOME: %WSCLIENT_HOME%
echo .
echo WSCLIENT_PATH: %WSCLIENT_PATH%
echo .
echo -------------------------------------------------------------------------
echo .

"%JRE_HOME%/bin/java" -cp %WSCLIENT_PATH%
br.com.pamcary.jee.pamcard.webservice.client.pamcard.service.WSPamcardClientService

pause


Configurao 02:

Na pasta C:\Adaptador_Pamcard\keystore editar o arquivo clientkeystore.properties,

Configurar os seguintes itens:

Registrar o nome do certificado
Definir o diretrio onde ficar o Certificado
Registrar a senha do certificado
Definir o caminho do JAVA

keyStorePath=keystore/[nome do certificado]
keyStore=keystore/[nome do certificado]
keyStorePassword=[senha do certificado]
keyStoreType=JKS
pamcard.prop.keystore.client.keystore.path=C:/Adaptador_Pamcard/keystore/[nome do certificado]
pamcard.prop.keystore.client.keystore.pass=[senha do certificado]

Confidencial Pg. 36 de 51



trustStore=C:\"Arquivos de programas"\Java\jre1.5.0\lib\security\cacerts

trustStorePassword=[senha do certificado]
trustStoreType=JKS

Configurao 03:

Na pasta C:\Adaptador_Pamcard\conf editar o arquivo wspamcard-client.properties,

Configurar os seguintes itens:

Definir a URL de conexao com o Sistema Pamcard
Endereo do Ambiente de Homologao:
https://qualidade.gps-pamcary.com.br/pamcardbrvisa/services/WSPamcard
Endereo do Ambiente de Produo:
https://www.gps-pamcary.com.br/pamcardbrvisa/services/WSPamcard
Definir o caminho completo do certificado
Definir o CNPJ do Contratante Sem Edio



#diretorio de entrada de arquivos
file.input.dir=files/in/

#diretorio de saida de arquivos
file.output.dir=files/out/

#diretorio de arquivos com erro
file.error.dir=files/error/

#intervalo (em segundos) para leitura de um lote de arquivos
file.read.interval=10
request.timeout=12000 configura timeout para respota do roteirizador

#URL de conexao com o Sistema Pamcard
wspamcard.url= https://qualidade.gps-
pamcary.com.br/pamcardbrvisa/services/WSPamcard
#caminho completo para o keystore
keystore.path=c:/Adaptador_Pamcard/keystore/clientkeystore.properties

#nome do certificado no keystore
keystore.alias=[CNPJ do Contratante, sem edio]
security.certificate.name=[CNPJ do Contratante, sem edio]


Configurao 04:

Configurao para clientes que utilizam PROXY para acesso a Internet:

Editar o arquivo "wspamcard-client.bat".

Na linha onde contm o comando:
"%JRE_HOME%/bin/java" -cp
%WSCLIENT_PATH%br.com.pamcary.jee.pamcard.webservice.client.pamcard.service.WSPamcardClientS
ervice

Adicionar as seguintes variveis ( em negrito ), entre os colchetes coloque as informaes do seu
servidor proxy, e do usurio que ir realizar a autenticao:

"%JRE_HOME%/bin/java" -Dhttp.proxyHost=[servidor proxy] -Dhttp.proxyPort=[porta do proxy]

Confidencial Pg. 37 de 51


-Dhttp.proxyUserName=[usuario] -Dhttp.proxyPassword=[senha] -cp %WSCLIENT_PATH%
br.com.pamcary.jee.pamcard.webservice.client.pamcard.service.WSPamcardClientService

Se o proxy no possuir usurio e senha eliminar do comando os parmetros:
-Dhttp.proxyUserName=[usuario]
-Dhttp.proxyPassword=[senha]

Inicializao do sistema

Executar o arquivo wspamcard-client.bat
Ir abrir uma tela do MS-DOS e ficar somente um ponto no rodap da tela. Isto indicar que o Client esta
funcionando normalmente. Caso aparea qualquer mensagem no rodap da tela do MS-DOS, indica que
houve alguma falha na configurao do Client.




Confidencial Pg. 38 de 51



7.2.5 Adaptador Exemplos

Operao Funo Cdigo
Consultar viagem FindTrip 5
Consuta Status da Parcela FindParcelStatus 7
Alterao de Status de Parcela UpdateParcelStatus 8
Consultar Status do Pedgio FindTollStatus 9
Atualizar Status do Pedgio UpdateTollStatus 10
Roteirizao de Viagem Router 11
Consulta Carto FindCard 12
Insero de Parcela InsertParcel 13



3 - Incluso Contrato de Frete:

Exemplo Arquivo Envio (IN):
transacional.operacao=2

#viagem.id.cliente=558801
viagem.contratante.documento.numero=00001001000312
#viagem.unidade.documento.tipo=4
#viagem.unidade.documento.numero=5454545

viagem.contrato.numero= 280911

viagem.veiculo.placa= AAA4401
viagem.veiculo.placa.carreta2=VVV4444
viagem.veiculo.placa.carreta3=
viagem.veiculo.placa.carreta3
viagem.veiculo.categoria= 1
viagem.data.partida=19/01/2011
viagem.data.termino=19/01/2011
viagem.cartao.portador.rntrc=12344444

viagem.documento.qtde=2
viagem.documento1.numero=2569
viagem.documento1.tipo=1
viagem.documento2.numero=23453
viagem.documento2.tipo=1

viagem.documento1.serie=12345
viagem.documento1.natureza=x
viagem.documento1.quantidade=1
viagem.documento1.especie=x
viagem.documento1.peso=111

Confidencial Pg. 39 de 51


viagem.documento1.cubagem=
viagem.documento1.mercadoria.valor=1000
viagem.documento.complementar.qtde=2
viagem.documento.complementar1.tipo=1
viagem.documento.complementar2.tipo=3

viagem.documento2.serie=12345
viagem.documento2.natureza=x
Viagem.documento2.quantidade=1
viagem.documento2.especie=x
viagem.documento2.peso=111
viagem.documento2.cubagem=
viagem.documento2.mercadoria.valor=1000
# portador frete
viagem.cartao.numero= 4417810094137016

viagem.origem.pais.nome = BRASIL
viagem.origem.estado.nome = SP
viagem.origem.cidade.nome = CAMPINAS
viagem.pontos= 0
viagem.destino.pais.nome= BRASIL
viagem.destino.estado.nome = SP
viagem.destino.cidade.nome= SO SEBASTIO
viagem.pedagio.origem=1
viagem.pedagio.status=1
viagem.pedagio.obter.praca = S
viagem.pedagio.roteirizar=S

#viagem.pedagio.obter.rota=S

#Passado como array 4 parcelas
viagem.parcela.qtde = 4

viagem.contrato.frete=1
viagem.parcela1.numero=1
viagem.parcela1.valor=1.00
viagem.parcela1.tipo=1
viagem.parcela1.efetivacao.tipo=1
viagem.parcela1.data=19/01/2011
viagem.parcela1.origem=1
viagem.parcela1.status=1

viagem.parcela2.numero=2
viagem.parcela2.valor=1.50
viagem.parcela2.tipo=2
viagem.parcela2.efetivacao.tipo=2
viagem.parcela2.data= 19/01/2011
viagem.parcela2.origem=1
viagem.parcela2.status=2

Confidencial Pg. 40 de 51



viagem.parcela3.numero=3
viagem.parcela3.valor=3.20
viagem.parcela3.tipo=3
viagem.parcela3.efetivacao.tipo=4
#viagem.parcela3.data= 19/01/2011
viagem.parcela3.origem=1
viagem.parcela3.status=2
viagem.parcela3.base=N

viagem.parcela4.numero=4
viagem.parcela4.valor=1.50
viagem.parcela4.tipo=5
viagem.parcela4.efetivacao.tipo=1
viagem.parcela4.data= 19/01/2011
viagem.parcela4.origem=1
viagem.parcela4.status=2
viagem.parcela4.base=S

viagem.quitacao.prazo=5
viagem.quitacao.indicador=S
viagem.quitacao.entrega.ressalva=N
viagem.indicador.provedor.certificacao=1
viagem.comprovacao.observacao=TST123
viagem.frete.valor.bruto=1.00
viagem.frete.valor.liquido=1.00
viagem.frete.item.qtde=2
viagem.frete.item1.tipo=1
viagem.frete.item1.valor=1000.00
viagem.frete.item2.tipo=2
viagem.frete.item2.valor=130.00

Exemplo Arquivo Retorno (OUT):
mensagem.codigo=0
mensagem.descricao=Insero de viagem realizada com sucesso
viagem.id=1019161
viagem.pedagio.km=253.63
viagem.pedagio.praca1.nome=PED.ITATIBA;ITATIBA-SP;SP 065;DOM PEDRO
I;KM:110;ROTA DAS BANDEIRAS
viagem.pedagio.praca1.seq=1
viagem.pedagio.praca1.valor=5.85
viagem.pedagio.praca2.nome=PED.ATIBAIA;ATIBAIA-SP;SP 065;DOM PEDRO
I;KM:79,9;ROTA DAS BANDEIRAS
viagem.pedagio.praca2.seq=2
viagem.pedagio.praca2.valor=4.80
viagem.pedagio.praca3.nome=PED.IGARATA;IGARATA-SP;SP 065;DOM PEDRO
I;KM:26,5;ROTA DAS BANDEIRAS
viagem.pedagio.praca3.seq=3
viagem.pedagio.praca3.valor=6.10
viagem.pedagio.praca4.nome=PED.S.J.DOS CAMPOS;SAO JOSE DOS CAMPOS-SP;SP
070;GOV.CARVALHO PINTO;KM:92;ECOPISTAS
viagem.pedagio.praca4.seq=4
viagem.pedagio.praca4.valor=2.30

Confidencial Pg. 41 de 51


viagem.pedagio.qte=4
viagem.pedagio.valor=19.05


6 - Consultar viagem

Viagem tipo Normal:

Exemplo Arquivo Envio (IN):
transacional.operacao=5

viagem.id=65310

viagem.contratante.documento.numero=00001001000312
viagem.unidade.documento.tipo=1
#viagem.unidade.documento.numero=00001001000312

Exemplo Arquivo Retorno (OUT):
#Fri Aug 17 09:54:56 GMT-03:00 2007
viagem.cartao.portador.documento.numero=06499345806
viagem.id.cliente=8841
viagem.unidade.documento.numero=00001001000312
viagem.parcela3.origem=3
viagem.unidade.documento.tipo=1
viagem.contrato.numero=20079
viagem.parcela1.numero=1
viagem.parcela2.valor=400.0
viagem.parcela2.tipo=3
viagem.parcela1.valor=600.0
viagem.cartao.tipo=4
viagem.data.partida=25/12/2007
viagem.parcela3.valor=330.0
viagem.parcela2.numero=2
viagem.id=65310
viagem.parcela3.numero=3
viagem.veiculo.placa=IIM0959
mensagem.descricao=Busca de viagem realizada com sucesso
viagem.origem.pais.id=8
viagem.parcela.qtde=3
viagem.cartao.numero=0023043017
viagem.origem.estado.nome=SP
mensagem.codigo=0
viagem.cartao.portador.documento.tipo=2
viagem.destino.estado.nome=SP
viagem.origem.cidade.nome=SAO PAULO
viagem.origem.pais.nome=BRASIL
viagem.parcela1.tipo=1
viagem.parcela3.tipo=5
viagem.destino.cidade.nome=SAO PAULO
viagem.destino.pais.nome=BRASIL
viagem.cartao.portador.nome=Yvo Prado
viagem.origem.cidade.id=844

Confidencial Pg. 42 de 51


viagem.veiculo.categoria=1
viagem.parcela1.origem=3
viagem.valor=330.0
viagem.parcela2.origem=3

Viagem tipo Contrato Frete:

Exemplo Arquivo Envio (IN):
transacional.operacao=5

viagem.contratante.documento.numero=00001001000312
viagem.id=1021820

Exemplo Arquivo Retorno (OUT):
mensagem.codigo=0
mensagem.descricao=Busca de viagem realizada com sucesso
viagem.cartao.numero=0410691051
viagem.cartao.portador.documento.numero=00011122285
viagem.cartao.portador.documento.tipo=2
viagem.cartao.portador.nome=yrdyreyer
viagem.cartao.tipo=4
viagem.comprovacao.observacao=Texto de observacao da quitacao
viagem.contrato.numero=241110
viagem.data.partida=25/11/2010
viagem.data.termino=30/11/2010
viagem.destino.cidade.nome=CAMPINAS
viagem.destino.estado.nome=SP
viagem.destino.pais.nome=BRASIL
viagem.documento.complementar.qtde=1
viagem.documento.complementar1.tipo=1
viagem.documento.qtde=3
viagem.documento1.cubagem=25.0
viagem.documento1.especie=liquida
viagem.documento1.natureza=liquida
viagem.documento1.numero=5
viagem.documento1.quantidade=5.0
viagem.documento1.serie=2


8 - Consuta Status da Parcela

Exemplo Arquivo Envio (IN):
transacional.operacao=7

viagem.id=50118
viagem.id.cliente=201
viagem.contratante.documento.numero=00001001000312
viagem.unidade.documento.tipo=1
#viagem.unidade.documento.numero=53045272000174
viagem.parcela.numero=1

Exemplo Arquivo Retorno (OUT):

Confidencial Pg. 43 de 51


#Fri Aug 17 09:53:41 GMT-03:00 2007
viagem.parcela.status.descrio=EXCLUIDA
viagem.parcela.status.id=4
mensagem.descricao=Busca de status de parcela realizada com sucesso
mensagem.codigo=0

9 - Consultar Status do Pedgio

Exemplo Arquivo Envio (IN):
transacional.operacao=9

viagem.id=65194
#viagem.id.cliente=4945
viagem.contratante.documento.numero=00001001000312
viagem.unidade.documento.tipo=1
#viagem.unidade.documento.numero=00001001000312

Exemplo Arquivo Retorno (OUT):
#Fri Aug 17 09:53:57 GMT-03:00 2007
viagem.parcela.status.descrio=LIBERADO
viagem.parcela.status.id=2
mensagem.descricao=Busca de status de pedgio realizada com sucesso
mensagem.codigo=0

10 - Roteirizao de Viagem

Exemplo Arquivo Envio (IN):
transacional.operacao=11

viagem.contratante.documento.numero=00001001000312
#viagem.unidade.documento.tipo=1
#viagem.unidade.documento.numero=00001001000312
viagem.veiculo.categoria=6

viagem.rota.id=3478
viagem.pedagio.obter.rota=S

Exemplo Arquivo Retorno (OUT):
mensagem.codigo=0
mensagem.descricao=Roteirizao realizada com sucesso
viagem.destino.cidade.nome=PORTO ALEGRE
viagem.destino.estado.nome=RS
viagem.destino.pais.nome=BRASIL
viagem.origem.cidade.nome=PORTO ALEGRE
viagem.origem.estado.nome=RS
viagem.origem.pais.nome=BRASIL
viagem.pedagio.km=260.2
viagem.pedagio.pracas.quantidade=3
viagem.pedagio.valor=40.90
viagem.ponto.qtde=5
viagem.ponto1.cidade.nome=CAXIAS DO SUL

Confidencial Pg. 44 de 51


viagem.ponto1.estado.nome=RS
viagem.ponto1.pais.nome=BRASIL
viagem.ponto2.cidade.nome=FARROUPILHA
viagem.ponto2.estado.nome=RS
viagem.ponto2.pais.nome=BRASIL
viagem.ponto3.cidade.nome=FARROUPILHA
viagem.ponto3.estado.nome=RS
viagem.ponto3.pais.nome=BRASIL
viagem.ponto4.cidade.nome=PORTAO
viagem.ponto4.estado.nome=RS
viagem.ponto4.pais.nome=BRASIL
viagem.ponto5.cidade.nome=PORTAO
viagem.ponto5.estado.nome=RS
viagem.ponto5.pais.nome=BRASIL
viagem.rota.nome= BENTO GONCALVES


11 - Consulta Carto

Exemplo Arquivo Envio (IN):
transacional.operacao=12

viagem.contratante.documento.numero=00001001000312
viagem.unidade.documento.tipo=1
viagem.unidade.documento.numero=53045272000174
viagem.cartao.numero=4417810094160018

Exemplo Arquivo Retorno (OUT):
#Tue Jul 17 11:13:29 GMT-03:00 2007
viagem.cartao.status.descrio=CARTAO ATIVO
viagem.cartao.status.id=22
mensagem.descricao=Busca de carto realizada com sucesso
viagem.cartao.portador.nome=JOSE DA SILVA
mensagem.codigo=0

13 - Atualizar Status do Pedgio

Exemplo Arquivo Envio (IN):
transacional.operacao=10

viagem.contratante.documento.numero= 00001001000312
viagem.unidade.documento.tipo= 1
viagem.unidade.documento.numero= 00001001000312

viagem.id=65337
#viagem.id.cliente=
viagem.pedagio.status.id=2

Exemplo Arquivo Retorno (OUT):
mensagem.codigo=0
mensagem.descricao=Atualizao de status de pedgio realizada com sucesso

Confidencial Pg. 45 de 51




14 - Alterao de Status de Parcela

Exemplo Arquivo Envio (IN):
transacional.operacao=8

viagem.contratante.documento.numero= 00001001000312
viagem.unidade.documento.tipo= 1
viagem.unidade.documento.numero= 00001001000312

viagem.id=65337
#viagem.id.cliente=
viagem.parcela.qtde=2

viagem.parcela1.numero=1
viagem.parcela1.status.id=4

viagem.parcela1.numero=2
viagem.parcela1.status.id=4

Exemplo Arquivo Retorno (OUT):
mensagem.codigo=0
mensagem.descricao=Atualizao de status de parcela realizada com sucesso
mensagem.parcela.qtde=1
mensagem.parcela1.descricao=Atualizao de status de parcela realizada com sucesso

16- Incluso de Carto Portador Frete

Exemplo Arquivo Envio (IN):

transacional.operacao=21
viagem.contratante.documento.numero=00001001000312
viagem.unidade.documento.tipo=4
viagem.unidade.documento.numero=5454545
viagem.cartao.numero=4417810094123014
viagem.cartao.portador.documento.numero=11146935889
viagem.cartao.portador.documento.tipo=1
viagem.cartao.portador.rg=12323423455X
viagem.cartao.portador.uf.rg=SP
viagem.cartao.portador.nome=Cndido D' Per Sntista Jnior..
viagem.cartao.portador.nome=Cndido Per Sntista Jnior..
viagem.cartao.portador.data.nascimento=07/07/1970
viagem.cartao.portador.endereco.logradouro=R. Pssego Lils nt.:
viagem.cartao.portador.endereco.numero=843
viagem.cartao.portador.endereco.complemento=So Timteo
viagem.cartao.portador.endereco.bairro= V. S
viagem.cartao.portador.endereco.cidade=SAO PAULO
viagem.cartao.portador.endereco.uf=SP
viagem.cartao.portador.endereco.pais=BRASIL

Confidencial Pg. 46 de 51


viagem.cartao.portador.endereco.cep=04152130
viagem.cartao.portador.telefone.ddd=011
viagem.cartao.portador.telefone.numero=38891105
viagem.cartao.portador.celular.ddd=213
viagem.cartao.portador.celular.numero=99995555
viagem.cartao.portador.email=lidia.kawasoko@gps-pamcary.com.br

Exemplo Arquivo Retorno (OUT):

mensagem.codigo=0
mensagem.descricao=Insercao de Cartao Portador Frete efetuado com sucesso


7.3 Tabelas
Tipo de Documento da Viagem
(viagem.documentoN.tipo)

Id Descrio
1 MANIFESTO
2 ROMANEIO
3 PLANO DE VIAGEM
4 AWB
5 CONHECIMENTO
6 NOTA FISCAL
7 DOCUMENTO PROPRIO DO
CLIENTE
8 NUMERO PEDIDO
9 ORDEM DE VENDA
10 NUMERO LOAD
11 ORDEM DE COLETA
12 AUTORIZACAO DE
CARREGAMENTO
13 AUTORIZACAO DE SAIDA
Tipo do Carto
(viagem.cartao.tipo)

Id Descrio BIN
4 PAMCARD 441781
5 BRADESCO 441781
6 APISUL 441781
7 VALE-PEDGIO 419807
9 PORTADOR FRETE 441781
Tipo de Documento
(viagem.cartao.portador.documento.tipo
Viagem.unidade.documento.tipo)

Id Descrio
1 CNPJ Pessoal Juridica
2 CPF Pessoal Fisica
3 RG Pessoal Fisica
4 Id cliente Id_cliente
88
Id unidade
cliente
Id_unidade_cliente
5 RNTRC Pessoa Fsica
6 RNTRC Pessoa Jurdica

Confidencial Pg. 47 de 51


Sub-Tipo da Parcela
(viagem.parcelaN.subtipo)

Id Descrio
1 ADIANTAMENTO
2 INTERMEDIARIA
3 SALDO FINAL
6 COMBUSTVEL
8 DIRIA
9 DESPESA
Tipo de Efetivao
(viagem.parcelaN.efetivacao.tipo)

Id Descrio
1 MANUAL
2 AUTOMATICA
3 INFOLOG
4 QUITAO

Tipo de Origem
(viagem.parcelaN.origem)
(viagem.pedagio.origem)

Id Descrio
1 PAMCARD
2 INFOLOG
3 CTF
Tipos Documento Complementar
(viagem.documento.complmentarN.tipo)

Id Descrio


A relao de documentos complementares e criada de acordo com
a necessidade da empresa. Para cadastra-las entre em contato com
a Central de Atendimento Pamcard.



Confidencial Pg. 48 de 51


Status da Parcela
(viagem.parcelaN.status.id)

Id Descrio Observao
1 PENDENTE Entrada
2 LIBERADA Entrada
3 BLOQUEADA Entrada
4 EXCLUIDA Sada
5 EFETIVADA Sada
6 SEM FUNDO Sada
7 ERRO Sada
8 EM EFETIVAAO Sada
Status do Pedgio
(viagem.pedagio.status.id)

Id Descrio Observao
1 PENDENTE Entrada
2 LIBERADO Entrada
3 BLOQUEADO Entrada
4 EXCLUIDO Sada
5 CARREGADO Sada
6 SEM FUNDO Sada
7 ERRO Sada
8 AUTORIZADO Sada
Status da Viagem

Id Descrio
1 PENDENTE
2 EM ABERTO
3 FINALIZADA
4 CANCELADA
Tipo de Transacao

Id Descrio
1 PEDGIO
2 PARCELA
3 COMBUSTVEL
Status do Carto Pamcard

Id Status Descrio
1 LIBERADO permite todas as funes
2 BLOQUEADO
no permite operaes
financeiras
3 CANCELADO
no permite nenhuma
funo
Status da Transao

Id Descrio
1 AUTORIZADA
2 INDETERMINADA
3 ERRO AUTORIZAO
4 OK
5 ERRO CARGA
Status da Conta do Favorecido

Id Status Descrio
1 PENDENTE Conta inativa no sistema
2 INVLIDA Conta inconsistente
3 ATIVA
Conta com transao
cadastrada
4 BLOQUEADA Conta que j foi ativa
5 EXCLUIDA Conta removida do cadastro
Tipo Item de Frete

Id Descrio
1 IRRPF (-)
2 INSS (-)
3 SEST/SENAT (-)

A lista de tipos de Dbitos/Crdito/Compensaes criada de
acordo com a necessidade da empresa. Para cadastr-las entre em
contato com a Central de Atendimento Pamcard.

Categorias do Veculo
(viagem.veiculo.categoria)
Id Descrio
1 AUTOMOVEL, CAMINHONETE, CAMIONETA, FURGAO ( 2 EIXOS - ROD. SIMPLES )
2 CAMINHAO LEVE, CAMINHAO-TRATOR, FURGAO ( 2 EIXOS - ROD. DUPLA )
2A ONIBUS ( 2 EIXOS - ROD. DUPLA )
3 AUTOMOVEL, CAMIONETA OU CAMINHONETE COM SEMI-REBOQUE ( 3 EIXOS - ROD. SIMPLES )
4 CAMINHAO, CAMINHAO-TRATOR, CAMINHAO-TRATOR C/ SEMI-REBOQUE ( 3 EIXOS - ROD. DUPLA )
4A ONIBUS ( 3 EIXOS - ROD. DUPLA )
5 AUTOMOVEL, CAMIONETA OU CAMINHONETE COM REBOQUE ( 4 EIXOS ROD. SIMPLES)
6 CAMINHAO E/OU CAMINHAO-TRATOR, C/ SEMI-REBOQUE ( 4 EIXOS ROD. DUPLA)
7 CAMINHAO C/ REBOQUE, CAMINHAO-TRATOR ( 5 EIXOS - ROD. DUPLA )

Confidencial Pg. 49 de 51


8 CAMINHAO C/ REBOQUE, CAMINHAO-TRATOR C/ SEMI-REBOQUE ( 6 EIXOS ROD. DUPLA )
9 MOTOCICLETA, MOTONETA, BICICLETAS A MOTOR ( 2 EIXOS ROD. SIMPLES)
10 CAMINHAO C/ REBOQUE, CAMINHAO-TRATOR C/ SEMI-REBOQUE ( 7 EIXOS - ROD. DUPLA )
11 CAMINHAO C/ REBOQUE, CAMINHAO-TRATOR C/ SEMI-REBOQUE ( 8 EIXOS - ROD. DUPLA )
12 CAMINHAO C/ REBOQUE, CAMINHAO-TRATOR C/ SEMI-REBOQUE ( 9 EIXOS - ROD. DUPLA )
13 CAMINHAO C/ REBOQUE, CAMINHAO-TRATOR C/ SEMI-REBOQUE ( 10 EIXOS - ROD. DUPLA )
Cdigos e Mensagens de Retorno

As mensagens sero retornadas juntamente com os cdigos de retorno. Tais mensagens descrevero os motivos dos
erros, ou seja, caso seja enviado um CNPJ invlido ser retornado o cdigo de erro 501 com uma mensagem
detalhando tal erro, no caso, CNPJ invlido.

(mensagem.codigo)
RETORNO
Cdigo Descrio Mensagem
0 OK Operao realizada com sucesso.
1 ERRO_VALIDACAO_TOKEN Token de autenticao invlido: <detalhes>
2 ERRO_VALIDACAO_CERTIFICADO Certificado invlido: <detalhes>
3 ERRO_VALIDACAO_CAMPOS_ENTRADA
Campo <campo> obrigatrio
Campo <campo> invlido
4 ERRO_PROCESSAMENTO <mensagem detalhada>



Confidencial Pg. 50 de 51



7.4 Referncias

Chamada de Web Services fora da plataforma .NET (Microsoft e Delphi)
http://www.msdn.com.br/docs/net/web_services_9.doc

Web Services na plataforma .NET
http://msdn2.microsoft.com/pt-br/webservices/

X509Certificate
http://msdn2.microsoft.com/en-
us/library/system.security.cryptography.x509certificates.x509certificate.getcerthash.aspx

Confidencial Pg. 51 de 51


7.5 Lay-Out Arquivo de Transaes (Download)
Registro Header
Seq Tipo De Ate Tam Descrio
1 TIPO_REGISTRO N 1 1 1 Tipo de Registro = 0
2 DT_MOVIMENTO N 2 9 8 Data do movimento AAAAMMDD
3 FILLER 10 447 438 Espao em branco
4 HEADER SEQUENCIAL N 448 453 6 Nmero Sequencial
5 Brancos A 454 500 47 Espao em branco
TOTAL 600

Registro Detalhe
Seq Tipo De Ate Tam Descrio
1 TIPO REGISTRO N 1 1 1 Tipo de Registro = 1
2 CNPJ CONTRATANTE N 2 15 14 CNPJ do Contratante
3 CNPJ PONTO DE EMBARQUE N 16 29 14 CNPJ do Ponto de Embarque
4 INDICADOR DE CONTRATANTE A 30 30 1 C=contratante, E=ponto de embarque
5 ID VIAGEM N 31 40 10 Identificador da Viagem (nmero sequencial nico)
6 TIPO DOCUMENTO A 41 42 2 Tipo de Documento
7 NUMERO DOCUMENTO A 43 72 30 Nmero do documento
8 NUMERO CONTRATO A 73 102 30 Nmero do contrato
9 NUMERO PAMCARD N 103 112 10 Nm.Pamcard do carto (via e dgito)
10 DATA CADASTRO VIAGEM N 113 120 8 Data do Cadastro da Viagem AAAAMMDD
11 STATUS VIAGEM N 121 121 1 Status da Viagem
12 PLACA VEICULO A 122 129 8 Placa do Caminho
13 CATEGORIA VEICULO A 130 131 2 Cdigo da Categoria do Veculo
14 PAIS ORIGEM A 132 181 50 Nome do pais de origem
15 UF CIDADE ORIGEM A 182 183 2 Sigla do estado de origem
16 CIDADE ORIGEM A 184 233 50 Nome da cidade de origem
17 PAIS DESTINO A 234 283 50 Nome do pas de destino
18 UF CIDADE DESTINO A 284 285 2 Sigla do estado de destino
19 CIDADE DESTINO A 286 335 50 Nome da cidade de destino
20 DATA EMBARQUE VIAGEM N 336 343 8 Data de Embarque da Viagem AAAAMMDD
21 TIPO TRANSACAO N 344 344 1 Tipo da Transao
22 STATUS TRANSACAO N 345 345 1 Status da Transao
23 VALOR TRANSACAO N 346 354 9 Valor da transao(Valor carregado no carto)
24 VALOR TAXA TRANSACAO N 355 363 9 Valor da taxa da transao
25 USUARIO A 364 413 50 Nome do usurio que fez a transao
26 NUM AUTORIZACAO A 414 423 10 Nmero da autorizao gerado pelo banco
27 DATA TRANSACAO N 424 431 8 Data da Transao (AAAAMMDD)
28 HORA TRANSACAO N 432 437 6 Hora da Transao (hhmmss)
29 BANCO AUTORIZADOR N 438 440 3 Banco Autorizador - Bradesco 237
30 DOCUMENTO EXTRATO N 441 447 7 Num. do docto: 7 ltimos dgitos do nmero VISA
31 TRANSACAO SEQUENCIAL N 448 453 6 Nmero Sequencial
32 Valor do pedgio solicitado N 454 462 9
Valor do Pedgio solicitado ou roteirizado para a
Viagem
33 Saldo do Pedgio no carto N 463 471 9 Valor do Saldo existente no carto antes da carga
34 Tipo de Carto N 472 473 2 Tipo de Carto
35 CPF do Motorista N 474 484 11 CPF do Motorista da viagem
36 Nome do Motorista A 485 544 60 Nome do Motorista da viagem
34 Brancos A 545 600 56 Espaos em branco
TOTAL 600

Registro Trailer
Seq Tipo De Ate Tam Descrio
1 TIPO REGISTRO N 1 1 1 Tipo de Registro = 9
2 QTDE REGISTROS TIPO 1 N 2 7 6 Quantidade de registros do tipo 1
3 SOMA TRANSACAO N 8 16 9 Soma dos valores de transao do registro 1
4 SOMA TRANSACAO TAXA N 17 25 9 Soma dos valores de taxa de transao do reg. 1
5 FILLER N 26 447 422 Espaos em branco
6 TRAILER SEQUENCIAL N 448 453 6 Nmero Sequencial
7 Brancos A 454 500 47 Espaos em branco
TOTAL 600