Webservices Pontual

Manual de utilizao
Verso 1.1
15 de outubro de 2015
Contedo
Apresentao ...................................................................................................................... 3
Introduo............................................................................................................................ 4
Consideraes preliminares ................................................................................................ 5
Padres tcnicos ............................................................................................................. 5
pontualcargas/servicos/ws/nd.............................................................................................. 6
pontualcargas/servicos/ws/nd/get .................................................................................... 7
pontualcargas/servicos/ws/nd/getByNF ......................................................................... 11
pontualcargas/servicos/ws/nd/trackingByND ................................................................. 15
pontualcargas/servicos/ws/nd/trackingByNF.................................................................. 18
Tabelas de Cdigos internos ............................................................................................. 21
 Apresentao - 3

Apresentao
O Web Service pontualcargas.com/servicos/ws foi desenvolvido no intuito de
disponibilizar para os Clientes da empresa, servios que possam facilitar a integrao
entre os sistemas proprietrios dos clientes e o banco de dados da empresa Encomendas
e Transporte de Cargas Pontual Ltda., fornecendo a estes clientes, um servio
diferenciado de informaes relativos ao manifesto e acompanhamento de suas cargas.

Esperamos que fiquem satisfeitos. Quaisquer dvidas ou esclarecimentos, basta entrar

em contato com a equipe do CPD da Pontual em Braslia.

Gerente: Wendell Cndido de Almeida

Desenvolvimento: Edilson de Oliveira Bassul
sistemas@pontualcargas.com.br

Telefones: (61) 2192-1200

(61) 8154-6640
Fax: (61) 3365-1778

Equipe CPD Pontual-BSB

 Introduo - 4

Introduo
Este manual tem por objetivo a definio de especificaes e critrios tcnicos para a
integrao entre o portal da Pontual e os sistemas de informaes de seus clientes.

Disponibilizando estes servios de Web Service, a empresa Pontual estar facilitando,

para os seus Clientes, o acesso s informaes do banco de dados da empresa atravs
da Internet.

Tendo sido desenvolvido para funcionar na Internet, para acessar este servio, o Cliente
ir precisar de um servio de acesso Internet (contratado por conta prpria), alm de
recursos prprios de programao para utilizar os servios e tratar a informao
retornada.

Com este servio, o cliente poder consultar os dados das cargas e do rastreamento.
 Consideraes preliminares - 5

Consideraes preliminares
Por se tratar de um acesso diretamente ao banco de dados da empresa, o cliente dever
utilizar o seu Cdigo de Conta Corrente na Pontual e da senha de acesso aos Servios
on-line do site da Pontual para que a execuo da solicitao seja autenticada e
registrada no servidor.

Para que o cliente saiba qual o nmero de sua conta corrente na Pontual basta entrar
em contato com o Departamento Comercial na matriz da empresa pelo nmero
(61) 2192-1200. Aproveite para confirmar se o seu endereo eletrnico (e-mail) est
atualizado nos cadastros da empresa, pois por meio dele que o cliente receber sua
senha de acesso.

Padres tcnicos
Este servio de Web Service foi desenvolvido utilizando o padro SOAP 1.2. Para
documentao consultar http://www.w3.org/TR/soap/.
 pontualcargas/ws/nd - 6

pontualcargas/servicos/ws/nd
Este Web Service disponibiliza servios de consulta e acompanhamento de Notas de
Despacho Eletrnicas. Com ele possvel consultar cargas no sistema, assim como
consultar os eventos de rastreamento das cargas, conforme os mtodos detalhados a
seguir.

O envio da solicitao atravs e a obteno do retorno sero realizados na mesma

conexo atravs de um nico mtodo.

Os detalhes do Web Service (WSDL Web Services Description Language) podem ser
obtidos atravs do endereo abaixo:

http://www.pontualcargas.com.br/servicos/ws/nd?wsdl
 pontualcargas/ws/nd/get - 7

pontualcargas/servicos/ws/nd/get
Consultar os dados de uma Nota de Despacho no banco de dados da empresa atravs do
nmero da mesma.

1. Endereo
http://www.pontualcargas.com.br/servicos/ws/nd/get

2. Leiaute da mensagem de Entrada

# Campo Ele Pai Tipo Descrio
AP01 get Raiz - - TAG raiz
AP02 login E AP01 login Dados para autenticao
AP03 username E AP02 string Cdigo da Conta corrente do Cliente na empresa
Pontual
Deve conter apenas nmeros
AP04 password E AP02 string Senha de acesso rea de Servios on-line do site da
empresa Pontual
AP05 nd E AP01 long Nmero da ND a ser consultada
Deve conter apenas nmeros

Exemplo:
<?xml version="1.0"?>
<soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:q0="http://www.pontualcargas.com/servicos/ws/nd">
<soapenv:Header/>
<soapenv:Body>
<q0:get>
<login>
<password>********</password>
<username>100</username>
</login>
<nd>5773882</nd>
</q0:get>
</soapenv:Body>
</soapenv:Envelope>

3. Leiaute da mensagem de Retorno

3.1. XML no seguinte formato, caso a Nota de Despacho no seja encontrada ou
ocorrer algum erro:
<?xml version="1.0"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<soap:Fault>
<faultcode>soap:Server</faultcode>
<faultstring>Usurio ou senha incorreta!</faultstring>
</soap:Fault>
</soapenv:Body>
</soapenv:Envelope>

Onde:
faultcode faultstring
soap:Server Usurio ou senha incorreta!
Verifique os dados de login (usurio e senha).
soap:Server Nota de Despacho (nd) no encontrada!
A ND no foi encontrada, atravs do nmero da Nota de Despacho, para a Conta
Corrente informada.
 pontualcargas/ws/nd/get - 8

3.2. XML no seguinte formato, caso a Nota de Despacho seja encontrada:

<?xml version="1.0"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ns1:getResponse xmlns:ns1="http://www.pontualcargas.com.br/servicos/ws/nd">
<nd>
<codcliente>100</codcliente>
<coleta>false</coleta>
<coletadatahora>2015-04-07T13:30:32.160-03:00</coletadatahora>
<coletador>MILTON</coletador>
<confirmacaodatahora>2015-04-08T10:30:00-03:00</confirmacaodatahora>
<confirmacaonome>Rosaria Oliveira</confirmacaonome>
<confirmacaorg>.</confirmacaorg>
<conteudo>TONER</conteudo>
<datahora>2015-04-07T13:30:32.160-03:00</datahora>
<destinatario>
<bairro>Lago Sul</bairro>
<cep>71608900</cep>
<fax></fax>
<fone>2192-1200</fone>
<logradouro>Aeroporto Internacional de Brasilia - TECA</logradouro>
<nome>Encomendas e Transportes de Cargas Pontual Ltda.</nome>
</destinatario>
<destino>
<estado>Distrito Federal</estado>
<id>96</id>
<name>Braslia</name>
<siglalocalidade>BSB</siglalocalidade>
<uf>DF</uf>
</destino>
<dimensoes>
01) Vol=2; Kg=3,000; Cm=49x19x22; KgCubado=6,828;
</dimensoes>
<emergencia>false</emergencia>
<entrega>false</entrega>
<especie>CX DE PAP</especie>
<id>5773882</id>
<nomecliente>Encomendas e Transportes de Cargas Pontual Ltda.</nomecliente>
<notafiscal>9310</notafiscal>
<obs>
AC SRA ROSARIA&#xD;
ENVIO DE TONNER&#xD;
SOLICITAO POR E-MAIL
</obs>
<origem>
<estado>So Paulo</estado>
<id>13940</id>
<name>So Paulo</name>
<siglaLocalidade>SAO</siglaLocalidade>
<uf>SP</uf>
</origem>
<pesocubado>7.0</pesocubado>
<pesoreal>6.0</pesoreal>
<plus>false</plus>
<previsaodatahora>2015-04-09T18:00:00-03:00</previsaodatahora>
<remetente>
<bairro>NOVO OSASCO</bairro>
<cep>6045390</cep>
<cnpj>05360453000142</cnpj>
<fone>11 36085394</fone>
<logradouro>AV DR KENKITI SHIMOMOTO 852</logradouro>
<nome>MARROLIVER SUPRIMENTOS DE INFORMATICA</nome>
</remetente>
<responsavel>ROSARIA</responsavel>
<segproprio>N</segproprio>
<status>9</status>
<valorDeclarado>2117.1</valorDeclarado>
<volumes>2</volumes>
</nd>
</ns1:getResponse>
</soap:Body>
</soap:Envelope>
 pontualcargas/ws/nd/get - 9

Onde:
# Campo Ele Pai Tipo Descrio
AR01 getResponse Raiz - - TAG raiz
AR02 nd E AR01 nd Estrutura de dados da Nota de Despacho
AR03 apolicesegproprio E AR02 string Se o Cliente possui aplice de seguro
prpria ou no:
S ou N
AR04 codcliente E AR02 long Cdigo do Cliente junto Pontual (Conta
Corrente)
AR05 coleta E AR02 boolean Se foi utilizado servio de Coleta:
S ou N
AR06 coletadatahora E AR02 dateTime Data e hora em que a carga foi coletada:
DD-MM-YYYYTHH:MM:SS[TIME_ZONE]
AR07 coletador E AR02 string Nome do funcionrio da Pontual que efetuou
a coleta da carga
AR08 confirmacaodatahora E AR02 dateTime Data e hora em que a carga foi entregue ao
destinatrio:
DD-MM-YYYYTHH:MM:SS[TIME_ZONE]
AR09 confirmacaonome E AR02 string Nome de quem recebeu a carga no destino
AR10 confirmacaorg E AR02 string Nmero do documento de quem recebeu a
carga no destino
AR11 conteudo E AR02 string Descrio do contedo dos volumes da
carga
AR12 datahora E AR02 dateTime Data e hora que a ND foi emitida:
DD-MM-YYYYTHH:MM:SS[TIME_ZONE]
AR13 destinatario E AR02 endereco Detalhes do Destinatrio
AR14 bairro E AR13 string Bairro do endereo
AR15 cep E AR13 int CEP do endereo
AR16 cnpj E AR13 string CNPJ, se Pessoa Jurdica
AR17 cpf E AR13 string CPF, se Pessoa Fsica
AR18 fax E AR13 string Nmero do FAX
AR19 fone E AR13 string Nmero do Telefone
AR20 ie E AR13 string Nmero de Inscrio Estadual, se
Pessoa Jurdica
AR21 logradouro E AR13 string Endereo
AR22 nome E AR13 string Nome
AR23 destino E AR02 localidade Detalhes da cidade de Destino
AR24 estado E AR23 string Nome da Unidade Federativa
AR25 id E AR23 long Nmero da Cidade (cdigo interno da
Pontual)
AR26 name E AR23 string Nome da Cidade
AR27 siglaLocalidade E AR23 string Sigla da Localidade
AR28 uf E AR23 string Sigla da Unidade Federativa
AR29 dimensoes E AR02 string Detalhes das dimenses dos volumes da
carga
AR30 emergencia E AR02 boolean Se foi utilizado servio de Emergncia:
S ou N
AR31 entrega E AR02 boolean Se foi utilizado servio de Entrega:
S ou N
AR32 especie E AR02 string Descrio da espcie da carga
AR33 id E AR02 long Nmero da Nota de Despacho
AR34 nomecliente E AR02 string Nome do Cliente (Conta Corrente)
AR35 notafiscal E AR02 string Detalhes de documentos fiscais relativos
carga
AR36 obs E AR02 string Observaes diversas sobre a ND
AR37 origem E AR02 localidade Detalhes da cidade de Origem
AR38 estado E AR37 string Nome da Unidade Federativa
AR39 id E AR37 long Nmero da Cidade (cdigo interno da
Pontual)
AR40 name E AR37 string Nome da Cidade
AR41 siglaLocalidade E AR37 string Sigla da Localidade
 pontualcargas/ws/nd/get - 10

AR42 uf E AR37 string Sigla da Unidade Federativa

AR43 pesocubado E AR02 float Peso Cubado total da carga
AR44 pesoreal E AR02 float Peso Real total da carga
AR45 plus E AR02 Boolean Se foi utilizado servio Pontual-Plus:
S ou N
AR46 previsaodatahora E AR02 dateTime Data e Hora de previso de entrega da
carga, baseado em contrato e na data e
hora de coleta da carga:
DD-MM-YYYYTHH:MM:SS[TIME_ZONE]
AR47 remetente E AR02 endereco Detalhes do Remetente
AR48 bairro E AR47 string Bairro do endereo
AR49 cep E AR47 int CEP do endereo
AR50 cnpj E AR47 string CNPJ, se Pessoa Jurdica
AR51 cpf E AR47 string CPF, se Pessoa Fsica
AR52 fax E AR47 string Nmero do FAX
AR53 fone E AR47 string Nmero do Telefone
AR54 ie E AR47 string Nmero de Inscrio Estadual, se
Pessoa Jurdica
AR55 logradouro E AR47 string Endereo
AR56 nome E AR47 string Nome
AR57 responsavel E AR02 string Nome do Responsvel pela entrega da
carga para a Pontual
AR58 segproprio E AR02 string Se esta ND est utilizando seguro prprio
do Cliente ou no:
S ou N
AR59 status E AR02 int Situao atual da carga (cdigo interno da
Pontual)
Veja Tabela 1
AR60 valorDeclarado E AR02 float Valor Total declarado da carga, para fins de
seguro
AR61 via E AR02 localidade Detalhes da cidade de Conexo
AR62 estado E AR61 string Nome da Unidade Federativa
AR63 id E AR61 long Nmero da Cidade (cdigo interno da
Pontual)
AR64 name E AR61 string Nome da Cidade
AR65 siglaLocalidade E AR61 string Sigla da Localidade
AR66 uf E AR61 string Sigla da Unidade Federativa
AR67 volumes E AR02 int Quantidade total de volumes da carga
 pontualcargas/ws/nd/getByNF - 11

pontualcargas/servicos/ws/nd/getByNF
Consultar os dados de uma Nota de Despacho no banco de dados da empresa atravs do
nmero de Documento Fiscal informado.

1. Endereo
http://www.pontualcargas.com.br/servicos/ws/nd/getByNF

2. Leiaute da mensagem de Entrada

# Campo Ele Pai Tipo Descrio
AP01 getByNF Raiz - - TAG raiz
AP02 login E AP01 login Dados para autenticao
AP03 username E AP02 string Cdigo da Conta corrente do Cliente na empresa
Pontual
Deve conter apenas nmeros
AP04 password E AP02 string Senha de acesso rea de Servios on-line do site da
empresa Pontual
AP05 nf E AP01 long Nmero do Documento Fiscal a ser consultado
Deve conter apenas nmeros

Exemplo:
<?xml version="1.0"?>
<soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:q0="http://www.pontualcargas.com/servicos/ws/nd">
<soapenv:Header/>
<soapenv:Body>
<q0:getByNF>
<login>
<password>********</password>
<username>100</username>
</login>
<nf>9310</nf>
</q0:getByNF>
</soapenv:Body>
</soapenv:Envelope>

3. Leiaute da mensagem de Retorno

3.1. XML no seguinte formato, caso a Nota de Despacho no seja encontrada ou
ocorrer algum erro:
<?xml version="1.0"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<soap:Fault>
<faultcode>soap:Server</faultcode>
<faultstring>Usurio ou senha incorreta!</faultstring>
</soap:Fault>
</soapenv:Body>
</soapenv:Envelope>

Onde:
faultcode faultstring
soap:Server Usurio ou senha incorreta!
Verifique os dados de login (usurio e senha).
soap:Server Nota de Despacho (nf) no encontrada!
A ND no foi encontrada, atravs do nmero do Documento Fiscal, para a Conta
Corrente informada.
 pontualcargas/ws/nd/getByNF - 12

3.2. XML no seguinte formato, caso a Nota de Despacho seja encontrada:

<?xml version="1.0"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ns1:getResponse xmlns:ns1="http://www.pontualcargas.com.br/servicos/ws/nd">
<nd>
<codcliente>100</codcliente>
<coleta>false</coleta>
<coletadatahora>2015-04-07T13:30:32.160-03:00</coletadatahora>
<coletador>MILTON</coletador>
<confirmacaodatahora>2015-04-08T10:30:00-03:00</confirmacaodatahora>
<confirmacaonome>Rosaria Oliveira</confirmacaonome>
<confirmacaorg>.</confirmacaorg>
<conteudo>TONER</conteudo>
<datahora>2015-04-07T13:30:32.160-03:00</datahora>
<destinatario>
<bairro>Lago Sul</bairro>
<cep>71608900</cep>
<fax></fax>
<fone>2192-1200</fone>
<logradouro>Aeroporto Internacional de Brasilia - TECA</logradouro>
<nome>Encomendas e Transportes de Cargas Pontual Ltda.</nome>
</destinatario>
<destino>
<estado>Distrito Federal</estado>
<id>96</id>
<name>Braslia</name>
<siglalocalidade>BSB</siglalocalidade>
<uf>DF</uf>
</destino>
<dimensoes>
01) Vol=2; Kg=3,000; Cm=49x19x22; KgCubado=6,828;
</dimensoes>
<emergencia>false</emergencia>
<entrega>false</entrega>
<especie>CX DE PAP</especie>
<id>5773882</id>
<nomecliente>Encomendas e Transportes de Cargas Pontual Ltda.</nomecliente>
<notafiscal>9310</notafiscal>
<obs>
AC SRA ROSARIA&#xD;
ENVIO DE TONNER&#xD;
SOLICITAO POR E-MAIL
</obs>
<origem>
<estado>So Paulo</estado>
<id>13940</id>
<name>So Paulo</name>
<siglaLocalidade>SAO</siglaLocalidade>
<uf>SP</uf>
</origem>
<pesocubado>7.0</pesocubado>
<pesoreal>6.0</pesoreal>
<plus>false</plus>
<previsaodatahora>2015-04-09T18:00:00-03:00</previsaodatahora>
<remetente>
<bairro>NOVO OSASCO</bairro>
<cep>6045390</cep>
<cnpj>05360453000142</cnpj>
<fone>11 36085394</fone>
<logradouro>AV DR KENKITI SHIMOMOTO 852</logradouro>
<nome>MARROLIVER SUPRIMENTOS DE INFORMATICA</nome>
</remetente>
<responsavel>ROSARIA</responsavel>
<segproprio>N</segproprio>
<status>9</status>
<valorDeclarado>2117.1</valorDeclarado>
<volumes>2</volumes>
</nd>
</ns1:getResponse>
</soap:Body>
</soap:Envelope>
 pontualcargas/ws/nd/getByNF - 13

Onde:
# Campo Ele Pai Tipo Descrio
AR01 getResponse Raiz - - TAG raiz
AR02 nd E AR01 nd Estrutura de dados da Nota de Despacho
AR03 apolicesegproprio E AR02 string Se o Cliente possui aplice de seguro
prpria ou no:
S ou N
AR04 codcliente E AR02 long Cdigo do Cliente junto Pontual (Conta
Corrente)
AR05 coleta E AR02 boolean Se foi utilizado servio de Coleta:
S ou N
AR06 coletadatahora E AR02 dateTime Data e hora em que a carga foi coletada:
DD-MM-YYYYTHH:MM:SS[TIME_ZONE]
AR07 coletador E AR02 string Nome do funcionrio da Pontual que efetuou
a coleta da carga
AR08 confirmacaodatahora E AR02 dateTime Data e hora em que a carga foi entregue ao
destinatrio:
DD-MM-YYYYTHH:MM:SS[TIME_ZONE]
AR09 confirmacaonome E AR02 string Nome de quem recebeu a carga no destino
AR10 confirmacaorg E AR02 string Nmero do documento de quem recebeu a
carga no destino
AR11 conteudo E AR02 string Descrio do contedo dos volumes da
carga
AR12 datahora E AR02 dateTime Data e hora que a ND foi emitida:
DD-MM-YYYYTHH:MM:SS[TIME_ZONE]
AR13 destinatario E AR02 endereco Detalhes do Destinatrio
AR14 bairro E AR13 string Bairro do endereo
AR15 cep E AR13 int CEP do endereo
AR16 cnpj E AR13 string CNPJ, se Pessoa Jurdica
AR17 cpf E AR13 string CPF, se Pessoa Fsica
AR18 fax E AR13 string Nmero do FAX
AR19 fone E AR13 string Nmero do Telefone
AR20 ie E AR13 string Nmero de Inscrio Estadual, se
Pessoa Jurdica
AR21 logradouro E AR13 string Endereo
AR22 nome E AR13 string Nome
AR23 destino E AR02 localidade Detalhes da cidade de Destino
AR24 estado E AR23 string Nome da Unidade Federativa
AR25 id E AR23 long Nmero da Cidade (cdigo interno da
Pontual)
AR26 name E AR23 string Nome da Cidade
AR27 siglaLocalidade E AR23 string Sigla da Localidade
AR28 uf E AR23 string Sigla da Unidade Federativa
AR29 dimensoes E AR02 string Detalhes das dimenses dos volumes da
carga
AR30 emergencia E AR02 boolean Se foi utilizado servio de Emergncia:
S ou N
AR31 entrega E AR02 boolean Se foi utilizado servio de Entrega:
S ou N
AR32 especie E AR02 string Descrio da espcie da carga
AR33 id E AR02 long Nmero da Nota de Despacho
AR34 nomecliente E AR02 string Nome do Cliente (Conta Corrente)
AR35 notafiscal E AR02 string Detalhes de documentos fiscais relativos
carga
AR36 obs E AR02 string Observaes diversas sobre a ND
AR37 origem E AR02 localidade Detalhes da cidade de Origem
AR38 estado E AR37 string Nome da Unidade Federativa
AR39 id E AR37 long Nmero da Cidade (cdigo interno da
Pontual)
AR40 name E AR37 string Nome da Cidade
AR41 siglaLocalidade E AR37 string Sigla da Localidade
 pontualcargas/ws/nd/getByNF - 14

AR42 uf E AR37 string Sigla da Unidade Federativa

AR43 pesocubado E AR02 float Peso Cubado total da carga
AR44 pesoreal E AR02 float Peso Real total da carga
AR45 plus E AR02 Boolean Se foi utilizado servio Pontual-Plus:
S ou N
AR46 previsaodatahora E AR02 dateTime Data e Hora de previso de entrega da
carga, baseado em contrato e na data e
hora de coleta da carga:
DD-MM-YYYYTHH:MM:SS[TIME_ZONE]
AR47 remetente E AR02 endereco Detalhes do Remetente
AR48 bairro E AR47 string Bairro do endereo
AR49 cep E AR47 int CEP do endereo
AR50 cnpj E AR47 string CNPJ, se Pessoa Jurdica
AR51 cpf E AR47 string CPF, se Pessoa Fsica
AR52 fax E AR47 string Nmero do FAX
AR53 fone E AR47 string Nmero do Telefone
AR54 ie E AR47 string Nmero de Inscrio Estadual, se
Pessoa Jurdica
AR55 logradouro E AR47 string Endereo
AR56 nome E AR47 string Nome
AR57 responsavel E AR02 string Nome do Responsvel pela entrega da
carga para a Pontual
AR58 segproprio E AR02 string Se esta ND est utilizando seguro prprio
do Cliente ou no:
S ou N
AR59 status E AR02 int Situao atual da carga (cdigo interno da
Pontual)
Veja Tabela 1
AR60 valorDeclarado E AR02 float Valor Total declarado da carga, para fins de
seguro
AR61 via E AR02 localidade Detalhes da cidade de Conexo
AR62 estado E AR61 string Nome da Unidade Federativa
AR63 id E AR61 long Nmero da Cidade (cdigo interno da
Pontual)
AR64 name E AR61 string Nome da Cidade
AR65 siglaLocalidade E AR61 string Sigla da Localidade
AR66 uf E AR61 string Sigla da Unidade Federativa
AR67 volumes E AR02 int Quantidade total de volumes da carga
 pontualcargas/ws/nd/trackingByND - 15

pontualcargas/servicos/ws/nd/trackingByND
Consultar os detalhes de Rastreamento de uma Nota de Despacho no banco de dados
da empresa atravs do nmero da mesma.

1. Endereo
http://www.pontualcargas.com.br/servicos/ws/nd/trackingByND

2. Leiaute da mensagem de Entrada

# Campo Ele Pai Tipo Descrio
AP01 trackingByND Raiz - - TAG raiz
AP02 login E AP01 login Dados para autenticao
AP03 username E AP02 string Cdigo da Conta corrente do Cliente na empresa
Pontual
Deve conter apenas nmeros
AP04 password E AP02 string Senha de acesso rea de Servios on-line do site da
empresa Pontual
AP05 nd E AP01 long Nmero da ND a ser consultada
Deve conter apenas nmeros

Exemplo:
<?xml version="1.0"?>
<soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:q0="http://www.pontualcargas.com/servicos/ws/nd">
<soapenv:Header/>
<soapenv:Body>
<q0:trackingByND>
<login>
<password>********</password>
<username>100</username>
</login>
<nd>5773882</nd>
</q0:trackingByND>
</soapenv:Body>
</soapenv:Envelope>

3. Leiaute da mensagem de Retorno

3.1. XML no seguinte formato, caso a Nota de Despacho no seja encontrada ou
ocorrer algum erro:
<?xml version="1.0"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<soap:Fault>
<faultcode>soap:Server</faultcode>
</soapenv:Body>
</soapenv:Envelope>

Onde:
faultcode faultstring
soap:Server Usurio ou senha incorreta!
Verifique os dados de login (usurio e senha).
soap:Server Nota de Despacho (nd) no encontrada!
A ND no foi encontrada, atravs do nmero do Documento Fiscal, para a Conta
Corrente informada.
 pontualcargas/ws/nd/trackingByND - 16

3.2. XML no seguinte formato, caso a Nota de Despacho seja encontrada:

<?xml version="1.0"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ns1:trackingByNDResponse
xmlns:ns1="http://www.pontualcargas.com.br/servicos/ws/nd">
<rastreamento>
<confirmacaodatahora>2015-04-08T10:30:00-03:00</confirmacaodatahora>
<confirmacaonome>Rosaria Oliveira</confirmacaonome>
<confirmacaorg>.</confirmacaorg>
<detalhes>
<datahora>2015-04-07T13:30:32.160-03:00</datahora>
<evento>10</evento>
<ocorrencia>Manifesto em: So Paulo/SP</ocorrencia>
</detalhes>
<detalhes>
<datahora>2015-04-08T06:00:00-03:00</datahora>
<evento>20</evento>
<ocorrencia>Embarque na Cia para: Braslia/DF</ocorrencia>
</detalhes>
<detalhes>
<datahora>2015-04-08T09:00:00-03:00</datahora>
<evento>30</evento>
<ocorrencia>Retirada da Cia em: Braslia/DF</ocorrencia>
</detalhes>
<detalhes>
<datahora>2015-04-08T09:10:00-03:00</datahora>
<evento>60</evento>
<ocorrencia>Sada para Entrega</ocorrencia>
</detalhes>
<detalhes>
<datahora>2015-04-08T10:30:00-03:00</datahora>
<evento>70</evento>
<ocorrencia>Entregue ao Destinatrio Rosaria Oliveira - Doc:
.</ocorrencia>
</detalhes>
<notafiscal>9310</notafiscal>
<nrnd>5773882</nrnd>
<previsaodatahora>2015-04-09T18:00:00-03:00</previsaodatahora>
<status>9</status>
</rastreamento>
</ns1:trackingByNDResponse>
</soap:Body>
</soap:Envelope>
 pontualcargas/ws/nd/trackingByND - 17

Onde:
# Campo Ele Pai Tipo Descrio
AR01 trackingByND Raiz - - TAG raiz
AR02 rastreamento E AR01 rastramento Estrutura de dados de detalhes do
Rastreamento de uma Nota de
Despacho
AR03 confirmacaodatahora E AR02 dateTime Data e hora em que a carga foi
entregue ao destinatrio:
DD-MM-
YYYYTHH:MM:SS[TIME_ZONE]
AR04 confirmacaonome E AR02 string Nome de quem recebeu a carga
no destino
AR05 confirmacaorg E AR02 string Nmero do documento de quem
recebeu a carga no destino
AR06 notafiscal E AR02 string Detalhes de documentos fiscais
relativos carga
AR07 nrnd E AR02 long Nmero da Nota de Despacho
AR08 detalhes E AR02 rastreamentoDetalhe Detalhes de cada passo do
Rastreamento.
Esta chave se repete para cada
passo de rastreamento da carga.
AR09 datahora E AR08 dateTime Data e hora de ocorrncia
YYYYTHH:MM:SS[TIME_ZONE]
AR10 evento E AR08 int Cdigo do Evento (cdigo
interno da Pontual)
Veja Tabela 2
AR11 obs E AR08 string Observaes diversas sobre
este passo
AR12 ocorrncia E AR08 string Descrio deste passo
AR13 previsaodatahora E AR02 dateTime Data e Hora de previso de
entrega da carga, baseado em
contrato e na data e hora de coleta
da carga:
DD-MM-
YYYYTHH:MM:SS[TIME_ZONE]
AR14 status E AR02 int Situao atual da carga (cdigo
interno da Pontual)
Veja Tabela 1
 pontualcargas/ws/nd/trackingByNF - 18

pontualcargas/servicos/ws/nd/trackingByNF
Consultar os detalhes de Rastreamento de uma Nota de Despacho no banco de dados
da empresa atravs do nmero do Documento Fiscal da mesma.

1. Endereo
http://www.pontualcargas.com.br/servicos/ws/nd/trackingByNF

2. Leiaute da mensagem de Entrada

# Campo Ele Pai Tipo Descrio
AP01 trackingByNF Raiz - - TAG raiz
AP02 login E AP01 login Dados para autenticao
AP03 username E AP02 string Cdigo da Conta corrente do Cliente na empresa
Pontual
Deve conter apenas nmeros
AP04 password E AP02 string Senha de acesso rea de Servios on-line do site da
empresa Pontual
AP05 nf E AP01 long Nmero do Documento Fiscal a ser consultado
Deve conter apenas nmeros

Exemplo:
<?xml version="1.0"?>
<soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:q0="http://www.pontualcargas.com/servicos/ws/nd">
<soapenv:Header/>
<soapenv:Body>
<q0:trackingByNF>
<login>
<password>********</password>
<username>100</username>
</login>
<nf>9310</nf>
</q0:trackingByNF>
</soapenv:Body>
</soapenv:Envelope>

3. Leiaute da mensagem de Retorno

3.1. XML no seguinte formato, caso a Nota de Despacho no seja encontrada ou
ocorrer algum erro:
<?xml version="1.0"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<soap:Fault>
<faultcode>soap:Server</faultcode>
</soapenv:Body>
</soapenv:Envelope>

Onde:
faultcode faultstring
soap:Server Usurio ou senha incorreta!
Verifique os dados de login (usurio e senha).
soap:Server Nota de Despacho (nf) no encontrada!
A ND no foi encontrada, atravs do nmero do Documento Fiscal, para a Conta
Corrente informada.
 pontualcargas/ws/nd/trackingByNF - 19

3.2. XML no seguinte formato, caso a Nota de Despacho seja encontrada:

<?xml version="1.0"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ns1:trackingByNFResponse
xmlns:ns1="http://www.pontualcargas.com.br/servicos/ws/nd">
<rastreamento>
<confirmacaodatahora>2015-04-08T10:30:00-03:00</confirmacaodatahora>
<confirmacaonome>Rosaria Oliveira</confirmacaonome>
<confirmacaorg>.</confirmacaorg>
<detalhes>
<datahora>2015-04-07T13:30:32.160-03:00</datahora>
<evento>10</evento>
<ocorrencia>Manifesto em: So Paulo/SP</ocorrencia>
</detalhes>
<detalhes>
<datahora>2015-04-08T06:00:00-03:00</datahora>
<evento>20</evento>
<ocorrencia>Embarque na Cia para: Braslia/DF</ocorrencia>
</detalhes>
<detalhes>
<datahora>2015-04-08T09:00:00-03:00</datahora>
<evento>30</evento>
<ocorrencia>Retirada da Cia em: Braslia/DF</ocorrencia>
</detalhes>
<detalhes>
<datahora>2015-04-08T09:10:00-03:00</datahora>
<evento>60</evento>
<ocorrencia>Sada para Entrega</ocorrencia>
</detalhes>
<detalhes>
<datahora>2015-04-08T10:30:00-03:00</datahora>
<evento>70</evento>
<ocorrencia>Entregue ao Destinatrio Rosaria Oliveira - Doc:
.</ocorrencia>
</detalhes>
<notafiscal>9310</notafiscal>
<nrnd>5773882</nrnd>
<previsaodatahora>2015-04-09T18:00:00-03:00</previsaodatahora>
<status>9</status>
</rastreamento>
</ns1:trackingByNFResponse>
</soap:Body>
</soap:Envelope>
 pontualcargas/ws/nd/trackingByNF - 20

Onde:
# Campo Ele Pai Tipo Descrio
AR01 trackingByNF Raiz - - TAG raiz
AR02 rastreamento E AR01 rastramento Estrutura de dados de detalhes do
Rastreamento de uma Nota de
Despacho
AR03 confirmacaodatahora E AR02 dateTime Data e hora em que a carga foi
entregue ao destinatrio:
DD-MM-
YYYYTHH:MM:SS[TIME_ZONE]
AR04 confirmacaonome E AR02 string Nome de quem recebeu a carga
no destino
AR05 confirmacaorg E AR02 string Nmero do documento de quem
recebeu a carga no destino
AR06 notafiscal E AR02 string Detalhes de documentos fiscais
relativos carga
AR07 nrnd E AR02 long Nmero da Nota de Despacho
AR08 detalhes E AR02 rastreamentoDetalhe Detalhes de cada passo do
Rastreamento.
Esta chave se repete para cada
passo de rastreamento da carga.
AR09 datahora E AR08 dateTime Data e hora de ocorrncia
YYYYTHH:MM:SS[TIME_ZONE]
AR10 evento E AR08 int Cdigo do Evento (cdigo
interno da Pontual)
Veja Tabela 2
AR11 obs E AR08 string Observaes diversas sobre
este passo
AR12 ocorrncia E AR08 string Descrio deste passo
AR13 previsaodatahora E AR02 dateTime Data e Hora de previso de
entrega da carga, baseado em
contrato e na data e hora de coleta
da carga:
DD-MM-
YYYYTHH:MM:SS[TIME_ZONE]
AR14 status E AR02 int Situao atual da carga (cdigo
interno da Pontual)
Veja Tabela 1
 Exemplos de utilizao - 21

Tabelas de Cdigos internos

1. Cdigo de Status da Nota de Despacho

Cdigo Descrio
1 Includa
2 Emitida
3 Coletada
4 Despachada
5 Retirada
6 Despachada (Trecho 2)
7 Retirada (Trecho 2)
8 Sada p/Entrega
9 Entregue
98 Cancelada
99 Outros

2. Cdigo do Evento do Rastreamento

Cdigo Descrio
10 Manifestado em: <origem>/<uf>
20 Embarque na Cia para: <destino>/<uf>
30 Retirada da Cia em: <destino>/<uf>
40 Embarque na Cia para: <destino>/<uf> (Trecho 2)
50 Retirada da Cia em: <destino>/<uf> (Trecho 2)
60 Sada para Entrega
70 Entregue ao Destinatrio <nome> - Doc: <documento>
... Outros

Obs: Qualquer outro Cdigo de Evento diferentes destes acima referente a

informaes extras durante o transporte da carga.