Sistema Pamcard - Contrato de Frete - Especificacao Integra - o - v1 - 1

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


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


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


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.


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


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.


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


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


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


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


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


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

Campos de Entrada

VIAGEM
1 viagem.id numrico 10
2 viagem.id.cliente numrico 10
Obs 3
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 .

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:


Campos de Retorno


RETORNO
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
AAA1111
Obs. 9
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
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


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



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:


Parmetro Tipo Valor
context alfanumrico Fixo=FindParcelStatus
token alfanumrico
Observaes:
funcionamento.

Campos de Entrada

VIAGEM
Obs 3
8 viagem.cartao.tipo numrico 2 opcional
10 viagem.parcela.numero numrico 2 Obrigatrio

Observaes:
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:


Campos de Retorno

RETORNO
3 viagem.parcela.status.id numrico 2
4 viagem.parcela.status.descrio alfanumrico 50


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:


Parmetro Tipo Valor
context alfanumrico Fixo=UpdateParcelStatus
token alfanumrico
Observaes:
funcionamento.

Campos de Entrada

VIAGEM
Obs 3
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:
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.


ATENO:


Campos de Retorno

RETORNO

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:


Parmetro Tipo Valor
context alfanumrico Fixo=FindTollStatus
token alfanumrico

Observaes:
funcionamento.

Campos de Entrada

VIAGEM
9 viagem.cartao.numero numrico 16 Obs 4

Observaes:


ATENO:


Campos de Retorno

RETORNO
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


Parmetro Tipo Valor
context alfanumrico Fixo=UpdateTollStatus
token alfanumrico
Observaes:
funcionamento.

Campos de Entrada

VIAGEM
3 viagem.contratante.documento.numero alfanumrico 20
6 viagem.pedagio.status.id numrico 2 Obrigatrio
Ver tabela

Observaes:
4. Se o status do pedgio for 2-LIBERADO ou 5-CARREGADO, no ser permitido alterar o
mesmo.
5.


ATENO:


Campos de Retorno

RETORNO

6.7 Roteirizar

Operao que permite a roteirizao de uma determinada viagem no Sistema Pamcard. Abaixo segue a


Parmetro Tipo Valor
context alfanumrico Fixo=Router
0fields array <Campos de Entrada>
token alfanumrico
Observaes:
funcionamento.

Campos de Entrada

VIAGEM
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
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:


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 .

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:


Campos de Retorno

RETORNO
3 viagem.pedagio.valor decimal 9,2
4 viagem.pedagio.pracas.quantidade numrico 2
5 Viagem.pedagio.km Decimal 19,4 Obs 10.


6.8 Consultar Carto

Operao que permite a consulta do status de um carto no Sistema Pamcard. Abaixo segue a definio


Parmetro Tipo Valor
context alfanumrico Fixo=FindCard
token alfanumrico
Observaes:
funcionamento.

Campos de Entrada

VIAGEM
4 viagem.cartao.numero Numrico 16 obrigatrio
Observaes:
estiver realizando a autenticao for uma contratante, ser obrigatrio apenas a chave
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:


Campos de Retorno

RETORNO
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


6.9 Inserir Parcela

Operao que permite a incluso de parcelas em uma viagem no Sistema Pamcard. Abaixo segue a


Parmetro Tipo Valor
context alfanumrico Fixo=InsertParcel
token alfanumrico
Observaes:
funcionamento.

Campos de Entrada

VIAGEM
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:
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.


ATENO:


Campos de Retorno

RETORNO

6.10 Incluir Carto Portador Frete
Operao que permite cadastrar Carto Portador Frete no Sistema Pamcard. Abaixo segue a definio


Parmetro Tipo Valor
context alfanumrico Fixo=FindDoc
token alfanumrico
Observaes:

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


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

6.11 Incluir Favorecido
Operao que permite cadastrar Favorecido no Sistema Pamcard. Abaixo segue a definio dos


Parmetro Tipo Valor
token alfanumrico
Observaes:

funcionamento.
2. Caracteres especiais, acentuaes sero suprimidos na gravao dos campos nome, logradouro,
complemento, bairro

Campos de Entrada

VIAGEM
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


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

6.12 Consultar Favorecido
Operao que permite Consultar Favorecido no Sistema Pamcard. Abaixo segue a definio dos


Parmetro Tipo Valor
token alfanumrico
Observaes:

funcionamento.

Campos de Entrada

VIAGEM


4 viagem.favorecido.documento.tipo Numrico 2 Obrigatrio
5 viagem.favorecido.documento.numero Alfanumrico 20 Obrigatrio

Campos de Retorno

RETORNO
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:


Parmetro Tipo Valor
token alfanumrico
Observaes:

funcionamento.

Campos de Entrada

VIAGEM
6
viagem.favorecido.conta.banco

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


Campos de Retorno

RETORNO

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:


Parmetro Tipo Valor
token alfanumrico
Observaes:
funcionamento.

Campos de Entrada

VIAGEM
6

7
8
9
1= Conta
correnmte
2=Poupana

Campos de Retorno

RETORNO
5

6
7
8
1= Conta
correnmte


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: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"


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>


</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:


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:


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


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,


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]


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,


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]


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


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.tipo=1

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


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

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.data= 19/01/2011


#viagem.parcela3.data= 19/01/2011
viagem.parcela3.base=N

viagem.parcela4.data= 19/01/2011
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.praca3.nome=PED.IGARATA;IGARATA-SP;SP 065;DOM PEDRO
I;KM:26,5;ROTA DAS BANDEIRAS
viagem.pedagio.praca4.nome=PED.S.J.DOS CAMPOS;SAO JOSE DOS CAMPOS-SP;SP
070;GOV.CARVALHO PINTO;KM:92;ECOPISTAS


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

6 - Consultar viagem

Viagem tipo Normal:


viagem.id=65310

viagem.unidade.documento.tipo=1

#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.contrato.numero=20079
viagem.cartao.tipo=4
viagem.id=65310
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.destino.cidade.nome=SAO PAULO
viagem.destino.pais.nome=BRASIL
viagem.cartao.portador.nome=Yvo Prado
viagem.origem.cidade.id=844


viagem.veiculo.categoria=1
viagem.valor=330.0

Viagem tipo Contrato Frete:


viagem.id=1021820

mensagem.codigo=0
mensagem.descricao=Busca de viagem realizada com sucesso
viagem.cartao.portador.nome=yrdyreyer
viagem.cartao.tipo=4
viagem.comprovacao.observacao=Texto de observacao da quitacao
viagem.contrato.numero=241110
viagem.data.termino=30/11/2010
viagem.destino.cidade.nome=CAMPINAS
viagem.destino.estado.nome=SP
viagem.documento.complementar.qtde=1
viagem.documento.qtde=3
viagem.documento1.cubagem=25.0
viagem.documento1.especie=liquida
viagem.documento1.natureza=liquida
viagem.documento1.quantidade=5.0

8 - Consuta Status da Parcela


viagem.id=50118
viagem.id.cliente=201
viagem.parcela.numero=1



#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


viagem.id=65194
#viagem.id.cliente=4945

#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


#viagem.unidade.documento.tipo=1
viagem.veiculo.categoria=6

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

mensagem.codigo=0
mensagem.descricao=Roteirizao realizada com sucesso
viagem.destino.cidade.nome=PORTO ALEGRE
viagem.destino.estado.nome=RS
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


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

11 - Consulta Carto



#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


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

mensagem.codigo=0
mensagem.descricao=Atualizao de status de pedgio realizada com sucesso


14 - Alterao de Status de Parcela


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.status.id=4

viagem.parcela1.status.id=4

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


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


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


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


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.


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 )


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 )
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>


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


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

Sistema Pamcard - Contrato de Frete - Especificacao Integra - o - v1 - 1

Diunggah oleh

Informasi Dokumen

Deskripsi Asli:

Judul Asli

Hak Cipta

Format Tersedia

Bagikan dokumen Ini

Bagikan atau Tanam Dokumen

Opsi Berbagi

Apakah menurut Anda dokumen ini bermanfaat?

Apakah konten ini tidak pantas?

Hak Cipta:

Format Tersedia

Sistema Pamcard - Contrato de Frete - Especificacao Integra - o - v1 - 1

Diunggah oleh

Hak Cipta:

Format Tersedia

Sistema Pamcard - Contrato de Frete

Anda mungkin juga menyukai