POLICARD SYSTEMS E SERVIÇOS S/A
UBERLÂNDIA – MG
EMISSÃO
Manual Integração Serviços
POLIFRETE
01/02/2011
VERSÃO
002
CÓDIGO
NORMA
( x ) Nova
( ) Alteração
DTI - 001
RESPONSÁVEL
Alisson Freitas
PAG
1
1.
HISTÓRICO DE VERSÕES................................................................................................3
2.
INFORMAÇÕES GERAIS .................................................................................................3
3.
4.
2.1.
Propósito ....................................................................................................................... 3
2.2.
Público Alvo ................................................................................................................... 3
2.3.
Definições, Acrônimos e Abreviações. .......................................................................... 4
2.4.
Referências .................................................................................................................... 4
PADRÕES TÉCNICOS .....................................................................................................4
3.1.
Visão Conceitual ............................................................................................................ 4
3.2.
Padrão de Documento XML .......................................................................................... 5
3.3.
Padrão de Comunicação................................................................................................ 6
3.4.
Padrão de Certificado Digital......................................................................................... 7
3.5.
Padrão de Assinatura Digital ......................................................................................... 8
3.6.
Validação da Estrutura XML das Mensagens do Web Service .................................... 12
WEB SERVICE ............................................................................................................. 13
4.1.
Serviço de Declaração de Operação de Transporte .................................................... 13
4.2.
WebService – Serviço de Declaração de Operação de Transporte ............................. 17
4.3.
Leiaute Mensagem de Entrada ................................................................................... 17
4.4.
Leiaute Mensagem de Retorno ................................................................................... 23
4.5.
Serviço de Retificação da Operação de Transporte .................................................... 24
4.6.
WebService – Serviço de Retificação da Operação de Transporte ............................. 24
4.7.
Leiaute Mensagem de Entrada ................................................................................... 25
4.8.
Leiaute Mensagem de Retorno ................................................................................... 26
4.9.
Serviço de Encerramento da Operação de Transporte ............................................... 26
4.10.
WebService – Serviço de Encerramento da Operação de Transporte .................... 28
4.11.
Leiaute Mensagem de Entrada ............................................................................... 28
4.12.
Leiaute Mensagem de Retorno ............................................................................... 29
4.13.
Serviço de Consulta do Extrato da Conta ................................................................ 30
4.14.
WebService – Serviço de Consulta do Extrato da Conta ......................................... 30
4.15.
Leiaute Mensagem de Entrada ............................................................................... 30
Classificação da Informação: Normal, Monitorada, Restrita.
DE
48
POLICARD SYSTEMS E SERVIÇOS S/A
UBERLÂNDIA – MG
EMISSÃO
Manual Integração Serviços
POLIFRETE
01/02/2011
VERSÃO
002
CÓDIGO
NORMA
( x ) Nova
( ) Alteração
DTI - 001
RESPONSÁVEL
Alisson Freitas
PAG
2
4.16.
Leiaute Mensagem de Retorno ............................................................................... 30
4.17.
Serviço de Consulta do Código Verificador ANTT ................................................... 31
4.18.
WebService – Serviço de Consulta do Código Verificador ANTT ............................ 31
4.19.
Leiaute Mensagem de Entrada ............................................................................... 31
4.20.
Leiaute Mensagem de Retorno ............................................................................... 32
4.21.
Serviço de Cálculo da Quitação ............................................................................... 32
4.22.
WebService – Serviço de Cálculo da Quitação ........................................................ 32
4.23.
Leiaute Mensagem de Entrada ............................................................................... 32
4.24.
Leiaute Mensagem de Retorno ............................................................................... 34
4.25.
Serviço de Quitação da Operação de Transporte ................................................... 35
4.26.
WebService – Serviço de Quitação da Operação de Transporte ............................ 35
4.27.
Leiaute Mensagem de Entrada ............................................................................... 35
4.28.
Leiaute Mensagem de Retorno ............................................................................... 37
4.29.
Serviço de Adicionar Adiantamento........................................................................ 38
4.30.
WebService – Serviço de Adicionar Adiantamento ................................................. 39
4.31.
Leiaute Mensagem de Entrada ............................................................................... 39
4.32.
Leiaute Mensagem de Retorno ............................................................................... 39
4.33.
Serviço de Cancelamento da Operação de Transporte ........................................... 40
4.34.
WebService – Serviço de Cancelamento da Operação de Transpote ..................... 41
4.35.
Leiaute Mensagem de Entrada ............................................................................... 41
4.36.
Leiaute Leiaute Mensagem de Retorno .................................................................. 42
5.
ACESSOS AO AMBIENTE POLICARD ............................................................................. 43
6.
INSTALAÇÃO CERTIFICADO RAIZ – GUIA DE INSTALAÇÃO ............................................. 43
6.1.
Procedimentos para Instalação Certificado ................................................................ 44
7.
ENDEREÇOS DOS WEBSERVICES POLIFRETE ................................................................. 48
8.
EQUIPE POLICARD - SUPORTE ..................................................................................... 48
Classificação da Informação: Normal, Monitorada, Restrita.
DE
48
POLICARD SYSTEMS E SERVIÇOS S/A
UBERLÂNDIA – MG
EMISSÃO
01/02/2011
Manual Integração Serviços
POLIFRETE
VERSÃO
002
CÓDIGO
NORMA
( x ) Nova
( ) Alteração
DTI - 001
RESPONSÁVEL
Alisson Freitas
PAG
3
DE
48
1. Histórico de Versões
Histórico de Versões
Versão
1.0
Data
01/02/2012
Descrição
Criação do documento.
Autor
Jackson Ramos
2.0
23/05/2012
Atualização documento com versão de
integração ANTT 2.0
Jackson Ramos
2.01
20/09/2012
Inclusão/Ajustes dos serviços:
Declaração da Operação de
Transporte;
Retificação da Operação de
Transporte;
Cálculo da Quitação;
Quitação da Operação de Transporte;
Adicionar Adiantamento de Frete;
Encerramento da Operação de
Transporte;
Consulta do Código Verificador da
ANTT;
Cancelamento da Operação de
Transporte;
Consulta do Extrato da Conta;
Jackson Ramos
Revisor/Aprovador
José Júnior
Alisson Freitas
José Júnior
Carlos Eduardo
Alisson Freitas
José Júnior
Hélio Júnior
Carlos Eduardo
Alisson Freitas
2. Informações Gerais
2.1.
Propósito
Este documento contempla as informações e regras referente à implementação da
integração de sistemas entre a Policard Systems e as Transportadoras
(Contratantes). O objetivo da documentação é auxiliar as empresas que deverão
alterar o sistema de emissão de frete, visando automatizar a utilização do sistema
PoliFrete, através de seu sistema legado.
2.2.
Público Alvo
O documento se estende a todos os envolvidos na implementação e implantação
da integração de sistemas entre Transportadoras e Policard.
Classificação da Informação: Normal, Monitorada, Restrita.
POLICARD SYSTEMS E SERVIÇOS S/A
UBERLÂNDIA – MG
CÓDIGO
EMISSÃO
01/02/2011
Manual Integração Serviços
POLIFRETE
VERSÃO
002
2.3.
RESPONSÁVEL
Alisson Freitas
( x ) Nova
( ) Alteração
PAG
4
Definições, Acrônimos e Abreviações.
Termo
Descrição
ANTT
TAC
RNTRC
ETC
CTRC
CTC
Agencia Nacional de Transportes Terrestres
Transportador Autônomo de Cargas
Registro Nacional de Transportadores de Cargas
Empresa de Transporte Rodoviário de Cargas
Conhecimento de Transporte Rodoviário de Cargas
Cooperativa de Transporte Rodoviário de Cargas
2.4.
NORMA
DTI - 001
Referências
N/A.
3. Padrões Técnicos
3.1.
Visão Conceitual
Clientes
Policard
(Contratante)
Serviços Policard
Serviços Pagamento
Eletrônico de Frete
Solicitação
Estação do Cliente
DeclararOperTransp
RetificarOperTransp
CancelarOperTransp
EncerrarOperTransp
ConsultarExtratoConta
AdicionarAdiantamento
ConsultarCodigoVerifica
dor
CalcularQuitacao
QuitarOperTransp
Solicitação
WebService
DeclararOperacaoTransporte
RetificarOperacaoTransporte
CancelarOperacaoTransporte
EncerrarOperacaoTransporte
ConsultarFrotaTransportador
ConsultarSituacaoTransporta
dor
WebService
Retorno
Retorno
Aplicação
Aplicação
SOAP
Classificação da Informação: Normal, Monitorada, Restrita.
Aplicação
DE
48
POLICARD SYSTEMS E SERVIÇOS S/A
UBERLÂNDIA – MG
EMISSÃO
Manual Integração Serviços
POLIFRETE
01/02/2011
VERSÃO
002
3.2.
CÓDIGO
NORMA
( x ) Nova
( ) Alteração
DTI - 001
RESPONSÁVEL
Alisson Freitas
PAG
5
Padrão de Documento XML
a) Padrão de Codificação
A especificação do documento XML adotada é a recomendação W3C para
XML 1.0, disponível em www.w3.org/TR/REC-xml e a codificação dos
caracteres será em UTF-8, assim todos os documentos serão iniciados com a
seguinte declaração:
<?xml version=”1.0” encoding=”UTF-8”?>
b) Declaração Namespace
A declaração namespace da Operação de Transporte deverá ser realizada no
elemento raiz de cada documento XML como segue:
<OperacaoTransporte versao="1.00" xmlns="http://www.polifrete.com.br/Polifrete">
A declaração namespace da assinatura digital deverá ser realizada na própria
tag <Signature>, conforme exemplo abaixo.
<OperacaoTransporte versao="2.00"
xmlns="http://www.polifrete.com.br/Polifrete">
<InfFrete Id="1">
…
<Signature xmlns="http://www.w3.org/2000/09/xmldsig#">
...
</OperacaoTransporte>
c) Validação de Schema
Para garantir a integridade das informações prestadas e a correta formação
dos arquivos XML, a transportadora deverá submeter o arquivo da Operação
Classificação da Informação: Normal, Monitorada, Restrita.
DE
48
POLICARD SYSTEMS E SERVIÇOS S/A
UBERLÂNDIA – MG
EMISSÃO
Manual Integração Serviços
POLIFRETE
CÓDIGO
VERSÃO
002
NORMA
( x ) Nova
( ) Alteração
DTI - 001
01/02/2011
RESPONSÁVEL
Alisson Freitas
PAG
6
de Transporte e as demais mensagens XML para validação pelo Schema do
XML (XSD – XML Schema Definition), disponibilizado pela Policard.
3.3.
Padrão de Comunicação
O meio físico de comunicação utilizado será a internet, com o uso do protocolo SSL
versão 3.0, com autenticação mútua, que alem de garantir um duto de comunicação
seguro na internet, permite a identificação do servidor do cliente através de
certificados digitais.
O modelo de comunicação segue o padrão de Web Services definido pelo WS-I
Basic Profile.
A troca de mensagens entre o Web Service do ambiente da Policard e e o aplicativo
da empresa será realizada no padrão SOAP versão 1.1 ou 1.2, com troca de
mensagens XML no padrão Style /Encoding: Document/Literal.
A autenticação da Transportadora nos serviços disponibilizados no Web Service
será feita através dos elementos EntCodigo e ChaveAutenticacao no grupo Header
do SOAP Header junto com o certificado digital utilizado para a assinatura do
documento.
Exemplo de uma mensagem de requisição padrão SOAP 1.2:
POST /WSPef/ServicosTransportadora.asmx HTTP/1.1Host: 201.48.243.66
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchemainstance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
<soap12:Header>
<Header xmlns="http://www.polifrete.com.br/Polifrete">
Classificação da Informação: Normal, Monitorada, Restrita.
DE
48
POLICARD SYSTEMS E SERVIÇOS S/A
UBERLÂNDIA – MG
EMISSÃO
Manual Integração Serviços
POLIFRETE
01/02/2011
VERSÃO
002
CÓDIGO
NORMA
( x ) Nova
( ) Alteração
DTI - 001
RESPONSÁVEL
Alisson Freitas
PAG
7
<EntCodigo>int</EntCodigo>
<ChaveAutenticacao>string</ChaveAutenticacao>
</Header>
</soap12:Header>
<soap12:Body>
<DeclararOperTransp
xmlns="http://www.polifrete.com.br/Polifrete" https??>
<dadosMsg>xml</dadosMsg>
</DeclararOperTransp>
</soap12:Body>
</soap12:Envelope>
3.4.
Padrão de Certificado Digital
O certificado digital utilizado deverá ser emitido por uma Autoridade Certificadora
credenciada pela infraestrutura de chaves Públicas Brasileira – ICP-Brasil, tipo A1
ou A3, devendo conter o CNPJ da pessoa jurídica titular do certificado digital no
campo otherName OID=2.16.76.1.3.3.
Os certificados digitais serão exigidos em 2 (dois) momentos distintos:
a) Assinatura de Mensagens: O certificado digital utilizado para essa função
deverá conter o CNPJ de um dos estabelecimentos da transportadora.
O certificado digital deverá ter o “uso da chave” previsto para a função assinatura
digital, respeitando a Politica do Certificado.
b) Transmissão: (durante a transmissão das mensagens entre o servidor da
transportadora e o Web Service da Policard): O certificado digital utilizado para
identificação do aplicativo da transportadora deverá conter o CNPJ do responsável
pela transmissão das mensagens, devendo ter a extensão Extended Key Usage
com permissão de “Autenticação Cliente”.
Classificação da Informação: Normal, Monitorada, Restrita.
DE
48
POLICARD SYSTEMS E SERVIÇOS S/A
UBERLÂNDIA – MG
RESPONSÁVEL
Alisson Freitas
VERSÃO
002
3.5.
( x ) Nova
( ) Alteração
DTI - 001
01/02/2011
Manual Integração Serviços
POLIFRETE
NORMA
CÓDIGO
EMISSÃO
PAG
8
Padrão de Assinatura Digital
As mensagens enviadas para o Web Service são documentos elaborados no
padrão XML e devem ser assinados digitalmente com um certificado digital que
contenha o CNPJ de um dos estabelecimentos da transportadora.
Os elementos abaixo estão presentes dentro do Certificado da transportadora
tornando desnecessária sua representação individualizada no arquivo XML.
Portanto, o arquivo XML não deve conter os elementos:
<X509SubjectName>
<X509IssuerSerial>
<X509IssuerName>
<X509SerialNumber>
<X509SKI>
Deve-se evitar o uso das TAG abaixo, pois as informações serão obtidas a partir do
Certificado da transportadora.
<KeyValue>
<RSAKeyValue>
<Modulus>
<Exponent>
O Web Service utiliza um subconjunto do padrão de assinatura XML definido pelo
http://www.w3.org/TR/xmldsig-core/, que tem o seguinte leiaute:
Schema XML: xmldsig-core-schema_v1.01.xsd
#
Campo
Elem
Pai
Tipo
Ocor
Tam
Dec
XS01 Signature
Raiz
-
-
1-1
-
-
XS02 SignedInfo
G
XS01
-
1-1
-
-
Grupo da Informação da
assinatura
XS03 CanonicalizationMethod
G
XS02
-
1-1
-
-
Grupo do Método de
Canonicalização
Classificação da Informação: Normal, Monitorada, Restrita.
Observação
DE
48
POLICARD SYSTEMS E SERVIÇOS S/A
UBERLÂNDIA – MG
( x ) Nova
( ) Alteração
DTI - 001
01/02/2011
Manual Integração Serviços
POLIFRETE
NORMA
CÓDIGO
EMISSÃO
RESPONSÁVEL
Alisson Freitas
VERSÃO
002
PAG
9
DE
48
XS04 Algorithm
A
XS03
S
1-1
-
-
Atributo Algorithm de
CanonicalizationMethod:
http://www.w3.org/TR/2001/R
EC-xml-c14n-20010315
XS05 SignatureMethod
G
XS02
-
1-1
-
-
Grupo do Método de
Assinatura
XS06 Algorithm
A
XS05
S
1-1
-
-
Atributo Algorithm de
SignatureMethod:
http://www.w3.org/2000/09/x
mldsig#rsa-sha1
XS07 Reference
G
XS02
-
1-1
-
-
Grupo Reference
XS08 URI
A
XS07
S
1-1
-
-
Atributo URI da tag Reference
XS09 Transforms
G
XS07
-
1-1
-
-
Grupo do algorithm de
Transform
XS10 Transform
G
XS09
-
2-2
-
-
Grupo de Transform
XS11 Algorithm
A
XS10
S
1-1
-
-
Atributos válidos Algorithm
do Transform:
http://www.w3.org/TR/2001/R
EC-xml-c14n-20010315
http://www.w3.org/2000/09/x
mldsig#enveloped-signature
XS12 XPath
E
XS10
S
0-N
-
-
XPath
XS13 DigestMethod
G
XS07
-
1-1
-
-
Grupo do Método de
DigestMethod
XS14 Algorithm
A
XS13
S
1-1
-
-
Atributo Algorithm de
DigestMethod:
http://www.w3.org/2000/09/x
mldsig#sha1
XS15 DigestValue
E
XS07
S
1-1
-
-
Digest Value (Hash SHA-1 –
Base64)
XS16 SignatureValue
G
XS01
-
1-1
-
-
Grupo do Signature Value
XS17 KeyInfo
G
XS01
-
1-1
-
-
Grupo do KeyInfo
XS18 X509Data
G
XS17
-
1-1
-
-
Grupo X509
XS19 X509Certificate
E
XS18
S
1-1
-
-
Certificado Digital x509 em
Base64
Classificação da Informação: Normal, Monitorada, Restrita.
POLICARD SYSTEMS E SERVIÇOS S/A
UBERLÂNDIA – MG
EMISSÃO
Manual Integração Serviços
POLIFRETE
01/02/2011
VERSÃO
002
CÓDIGO
NORMA
( x ) Nova
( ) Alteração
DTI - 001
RESPONSÁVEL
Alisson Freitas
PAG
10
A assinatura da Transportadora na Operação de Transporte será feita na TAG
<InfFrete> identificada pelo atributo Id, cujo conteúdo deverá ser um identificador
único (mesmo valor da TAG <Numero> contida no grupo <InfFrete>) para cada
operação de transporte conforme leiaute da mensagem da Operação de Transporte. O
identificador único deverá ser informado no atributo URI da TAG <Reference>. Segue
exemplo abaixo:
<OperacaoTransporte versao="2.00"
xmlns="http://www.polifrete.com.br/Polifrete">
<InfFrete Id="1">
<Numero>1</Numero>
…
</InfFrete>
<Signature>
<SignedInfo>
<CanonicalizationMethod
Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315"/>
<SignatureMethod
Algorithm="http://www.w3.org/2000/09/xmldsig#rsa-sha1" />
<Reference URI="#1">
<Transforms>
<Transform
Algorithm="http://www.w3.org/2000/09/xmldsig#enveloped-signature"/>
<Transform Algorithm="http://www.w3.org/TR/2001/REC-xmlc14n-20010315"/>
</Transforms>
<DigestMethod
Algorithm="http://www.w3.org/2000/09/xmldsig#sha1"/>
<DigestValue>vFL68WETQ+mvj1aJAMDx+oVi928=</DigestValue>
</Reference>
</SignedInfo>
<SignatureValue>IhXNhbdL1F9UGb2ydVc5v/gTB/y6r0KIFaf5evUi1i
...</SignatureValue>
<KeyInfo>
<X509Data>
<X509Certificate>MIIFazCCBFOgAwIBAgIQaHEfNaxSeOEvZGlVDANB ...
</X509Certificate>
</X509Data>
</KeyInfo>
</Signature>
</OperacaoTransporte>
Classificação da Informação: Normal, Monitorada, Restrita.
DE
48
POLICARD SYSTEMS E SERVIÇOS S/A
UBERLÂNDIA – MG
01/02/2011
Manual Integração Serviços
POLIFRETE
NORMA
CÓDIGO
EMISSÃO
( x ) Nova
( ) Alteração
DTI - 001
RESPONSÁVEL
Alisson Freitas
VERSÃO
002
PAG
11
A assinatura digital do documento eletrônico deverá atender aos seguintes
padrões adotados:
a) Padrão de Assinatura: “XML Digital Signature”, utilizando o formato
“Enveloped” (http://www.w3.org/TR/xmldsig-core/);
b)
Certificado
digital:
Emitido
por
AC
credenciada
no
ICP-Brasil
(http://www.w3.org/2000/09/xmldsig#X509Data);
c) Cadeia de Certificação: EndCertOnly (Incluir na assinatura apenas o
certificado do usuário final);
d) Tipo do certificado: A1 ou A3;
e) Tamanho da Chave Criptográfica: Compatível com os certificados A1 e
A3 (1024 bits);
f)
Função
criptográfica
assimétrica:
RSA
digest”:
SHA-1
(http://www.w3.org/2000/09/xmldsig#rsa-sha1);
g)
Função
de
“message
(http://www.w3.org/2000/09/xmldsig#sha1);
h) Codificação: Base64 (http://www.w3.org/2000/09/xmldsig#base64);
i) Transformações exigidas: Útil para realizar a canonicalização do XML
enviado para realizar a validação correta da Assinatura Digital. São elas:
(1)
Enveloped
(http://www.w3.org/2000/09/xmldsig#enveloped-
signature)
Classificação da Informação: Normal, Monitorada, Restrita.
DE
48
POLICARD SYSTEMS E SERVIÇOS S/A
UBERLÂNDIA – MG
EMISSÃO
Manual Integração Serviços
POLIFRETE
VERSÃO
002
NORMA
CÓDIGO
( x ) Nova
( ) Alteração
DTI - 001
01/02/2011
RESPONSÁVEL
Alisson Freitas
PAG
12
(2) C14N (http://www.w3.org/TR/2001/REC-xml-c14n-20010315)
3.6.
Validação da Estrutura XML das Mensagens do Web Service
As informações são enviadas ou recebidas do Web Service através de
mensagens no padrão XML definido na documentação de cada serviço.
Um Schema XML é uma linguagem que define o conteúdo do documento
XML, descrevendo os seus elementos e a sua organização, além de estabelecer
regras de preenchimento de conteúdo e de obrigatoriedade de cada elemento ou
grupo de informação.
A validação da estrutura XML da mensagem é realizada por um analisador
sintático (parser) que verifica se a mensagem atende as definições e regras de seu
Schema XML.
Qualquer divergência da estrutura XML da mensagem em relação ao seu
Schema XML provoca um erro de validação do Schema XML.
A primeira condição para que a mensagem seja validada com sucesso é que
ela seja submetida ao Schema XML correto.
Assim o aplicativo da Transportadora deve estar preparado para gerar as
mensagens no leiaute em vigor.
Versões dos Arquivos XSD
Versão
Arquivo XSD
Data Liberação
Data Vigência
Situação
1.00
OperacaoTransporte_v2.00.xsd
27/08/2012
-
Ativo
1.00
RetDeclararOperTransp_v1.00.xsd
27/08/2012
-
Ativo
Classificação da Informação: Normal, Monitorada, Restrita.
DE
48
POLICARD SYSTEMS E SERVIÇOS S/A
UBERLÂNDIA – MG
EMISSÃO
Manual Integração Serviços
POLIFRETE
CÓDIGO
VERSÃO
002
NORMA
( x ) Nova
( ) Alteração
DTI - 001
01/02/2011
RESPONSÁVEL
Alisson Freitas
PAG
13
1.00
tiposBasicos_v1.00.xsd
27/08/2012
-
Ativo
1.01
xmldsig-core-schema_v1.01.xsd
27/08/2012
-
Ativo
1.00
ConsultarCodigoVerificador_v1.00.xsd
27/08/2012
-
Ativo
1.00
RetConsultarCodigoVerificador_v1.00.xsd
27/08/2012
-
Ativo
1.00
ConsultarExtratoConta_v1.00.xsd
27/08/2012
-
Ativo
1.00
RetConsultarExtratoConta_v1.00.xsd
27/08/2012
-
Ativo
2.00
EncerrarOperTransp_v2.00.xsd
27/08/2012
-
Ativo
2.00
RetEncerrarOperTransp_v2.00.xsd
27/08/2012
-
Ativo
2.00
RetificarOperTransp_v2.00.xsd
27/08/2012
-
Ativo
2.00
RetRetificarOperTransp_v2.00.xsd
27/08/2012
-
Ativo
1.00
AdicionarAdiantamento_v1.00.xsd
27/08/2012
-
Ativo
1.00
CalcularQuitacao_v1.00.xsd
27/08/2012
-
Ativo
1.01
CancelarOperTransp_v1.01.xsd
27/08/2012
-
Ativo
1.00
QuitarOperTransp_v1.00.xsd
27/08/2012
-
Ativo
1.00
RetAdicionarAdiantamento_v1.00.xsd
27/08/2012
-
Ativo
1.00
RetCalcularQuitacao_v1.00.xsd
27/08/2012
-
Ativo
1.01
RetCancelarOperTransp_v1.01.xsd
27/08/2012
-
Ativo
1.00
RetQuitarOperTransp_v1.00.xsd
27/08/2012
-
Ativo
4.
Web Service
4.1.
Serviço de Declaração de Operação de Transporte
O Serviço de Declaração de Operação de Transporte é o serviço oferecido pela
Policard para recepcionar os dados das Operações de Transporte e retransmitilos para a ANTT retornando o CIOT e o protocolo de autorização que será um
código verificador desta operação.
A Declaração da Operação de Transporte pode ser feita para dois tipos
distintos de operação de transporte, cada uma obedecendo a algumas regras
específicas, a saber:
Classificação da Informação: Normal, Monitorada, Restrita.
DE
48
POLICARD SYSTEMS E SERVIÇOS S/A
UBERLÂNDIA – MG
EMISSÃO
Manual Integração Serviços
POLIFRETE
CÓDIGO
VERSÃO
002
NORMA
( x ) Nova
( ) Alteração
DTI - 001
01/02/2011
RESPONSÁVEL
Alisson Freitas
PAG
14
a) Operação de Transporte Padrão (tipo da operação de transporte = 1)
utilizada nos casos de uma única origem e contratante para um único destino e
destinatário. Este tipo de Operação de Transporte é identificado no sistema
pelo código “1”.
Para a validação, guarda e consequente geração do protocolo de autorização
pela ANTT para a Operação de Transporte Padrão, serão conferidos os
seguintes campos:
CPF/CNPJ e RNTRC do transportador contratado, conforme cadastrado no
Sistema RN3 e com a situação “ATIVO”;
validação do CPF/CNPJ do contratante e do destinatário;
código do município de origem e de destino1;
código da natureza da carga2;
peso da carga maior do que zero;
data de início3 da operação de transporte maior ou igual a data da
declaração e menor ou igual a 30 dias;
data de término da operação de transporte maior ou igual a data de início e
menor ou igual a 90 dias.
Para as operações de transporte padrão, todos os campos são de
preenchimento obrigatório. Caso o código da natureza da carga não possa ser
especificado, deve ser utilizado o código genérico “0001”.
No momento da declaração, a conferência dos veículos junto ao Sistema RN3
será da seguinte forma: ao menos um dos veículos deve pertencer ao
transportador contratado.
Para os demais veículos da frota que não pertencerem ao transportador
contratado, a verificação será feita comparando os dados informados (RNTRC
Classificação da Informação: Normal, Monitorada, Restrita.
DE
48
POLICARD SYSTEMS E SERVIÇOS S/A
UBERLÂNDIA – MG
EMISSÃO
Manual Integração Serviços
POLIFRETE
01/02/2011
VERSÃO
002
CÓDIGO
NORMA
( x ) Nova
( ) Alteração
DTI - 001
RESPONSÁVEL
Alisson Freitas
PAG
15
e placa do veículo) com os dados registrados no Sistema do RNTRC. Para
cada placa será verificado se o veículo está ou não cadastrado no RNTRC
informado, e se o mesmo encontra-se na situação “ATIVO”.
b) Operação de Transporte com TAC-Agregado (tipo da viagem = 3)
aplicado aos casos de existir contrato entre o TAC (ou ETC equiparada) e a
ETC ou CTC contratante conforme prescrito no Artigo 24, inciso I da Lei
11.442/07. Pode ser utilizado nas viagens de coleta ou entrega de mercadorias
com múltiplos destinos, e nas viagens de transferência entre estabelecimentos
de uma empresa. Este tipo de Operação de Transporte é identificado no
sistema pelo código “3” (três).
Para a validação, guarda e consequente geração do protocolo de autorização
pela ANTT para a Operação de Transporte com TAC-Agregado, serão
conferidos os seguintes campos:
CPF/CNPJ e RNTRC do transportador contratado, conforme cadastrado no
Sistema do RNTRC e com a situação “ATIVO”;
CPF/CNPJ e RNTRC do transportador contratante, conforme cadastrado no
Sistema do RNTRC e com a situação ATIVO;
data de término da operação de transporte menor ou igual a 30 dias da data da
declaração.
Para as operações de transporte com TAC-agregado, não devem ser
informados os seguintes campos: CPF/CNPJ do destinatário, Código dos
municípios de origem e destino, código da natureza da carga, peso da carga e
data de início da operação de transporte. Todos os demais campos são de
preenchimento e envio obrigatórios.
Classificação da Informação: Normal, Monitorada, Restrita.
DE
48
POLICARD SYSTEMS E SERVIÇOS S/A
UBERLÂNDIA – MG
EMISSÃO
Manual Integração Serviços
POLIFRETE
01/02/2011
VERSÃO
002
CÓDIGO
NORMA
( x ) Nova
( ) Alteração
DTI - 001
RESPONSÁVEL
Alisson Freitas
PAG
16
A data de início da operação de transporte para operações com TAC-agregado
será sempre a própria data da declaração. A data de término da operação de
transporte poderá ter um prazo máximo de 30 dias a partir da data de início.
Durante este período, o TAC ou equiparado contratado fica vinculado COM
EXCLUSIVIDADE à empresa contratante, não sendo possível a emissão de
CIOT de nenhum tipo por qualquer embarcador para o contratado, nem a
utilização de nenhum de seus veículos em qualquer outra declaração de
operação de transporte.
O fim do vínculo de exclusividade para o TAC contratado na operação de
transporte com TAC-agregado acontece em dois momentos: no dia seguinte ao
indicado como data de término da operação de transporte; e no momento do
encerramento da operação de transporte. Após o término desta vinculação, o
TAC fica novamente disponível para ter CIOTs gerados para ele.
Após a data indicada como data de término da operação de transporte, o CIOT
desta operação passa a ser considerado como um CIOT em aberto. Só é
possível existir no máximo “2” (dois) CIOTs em aberto para a relação ETC
contratante/TAC contratado. Para a geração de um novo CIOT entre as partes,
se faz necessário o encerramento de ao menos uma das operações de
transporte com TAC-agregado cujo CIOT encontra-se em aberto.
No momento da declaração, a conferência dos veículos junto ao Sistema RN3
será da seguinte forma: todos os veículos devem pertencer a frota do
transportador contratado.
Este tipo de operação de transporte não poderá ser utilizado por contratantes
que não sejam as ETC’s ou CTC’s ativas cadastradas no RNTRC.
Classificação da Informação: Normal, Monitorada, Restrita.
DE
48
POLICARD SYSTEMS E SERVIÇOS S/A
UBERLÂNDIA – MG
( x ) Nova
( ) Alteração
DTI - 001
01/02/2011
Manual Integração Serviços
POLIFRETE
NORMA
CÓDIGO
EMISSÃO
RESPONSÁVEL
Alisson Freitas
VERSÃO
002
PAG
17
DE
48
Caso haja indisponibilidade nos Servidores da ANTT no momento da
solicitação do Serviço de Declaração da Operação de Transporte, a mesma
será registrada e liberada na Policard em modo de Contingência, retornando o
Código Identificador da Operação de Transporte (CIOT) sem o Código
Verificador da ANTT, sendo necessário a consulta posteriormente através do
Serviço de Consulta do Código Verificador da ANTT.
1
A informação do município obedecerá à Tabela de Códigos de Municípios, elaborada
pelo Instituto Brasileiro de Geografia e Estatística – IBGE.
2
A informação da natureza da carga será constituída pelos quatro primeiros dígitos do
código do Sistema Harmonizado de Designação e de Codificação de Mercadorias,
divulgado pela Receita Federal do Brasil.
3
Todas as datas devem ser declaradas no horário oficial de Brasília.
4.2.
WebService – Serviço de Declaração de Operação de Transporte
Função: Serviço destinado a recepcionar e armazenar os dados das
operações de transporte e retornar o CIOT e o protocolo de autorização
Processo: Síncrono
Método: DeclararOperTransp
4.3.
Leiaute Mensagem de Entrada
Entrada: Estrutura XML com os dados da operação de transporte.
Campo
Descrição
Elem
Pai
Tipo
Ocor
Tam
Dec
A01
OperacaoTransporte
Tag Raiz da Operação de
Transporte
Raiz
-
-
1-1
-
-
A02
versao
versão do leiaute
A
A01
N
1-1
1-4
2
Tag Raiz
versão do leiaute (mesma
versão do arquivo de
schema xsd)
A03
InfFrete
Grupo das informações
do Frete
G
A01
-
1-1
-
-
Grupo que contém as
informações do Frete
A04
Id
A
A03
N
1-1
1-20
-
Informar o número de
controle do frete
#
Classificação da Informação: Normal, Monitorada, Restrita.
Observação
POLICARD SYSTEMS E SERVIÇOS S/A
UBERLÂNDIA – MG
EMISSÃO
Manual Integração Serviços
POLIFRETE
NORMA
CÓDIGO
( x ) Nova
( ) Alteração
DTI - 001
01/02/2011
RESPONSÁVEL
Alisson Freitas
VERSÃO
002
PAG
18
DE
48
informado no campo A05
A05
Numero
Número de controle da
transportadora
E
A03
S
1-1
1-20
-
A06
NumeroNotaFiscal
Número da Nota Fiscal
E
A03
S
0-1
1-10
-
A07
EspecieMercadoria
Espécie da Mercadoria
E
A03
S
1-1
1-20
-
A08
PesoVolume
Peso ou Volume
E
A03
S
1-1
1
-
A09
QuantidadeSaida
Quantidade em Quilos ou
em Volume
E
A03
N
1-1
7
2
Número de controle do
Frete (não poderá repetir
para outras operações de
transporte)
Número da nota fiscal que
acompanha o
conhecimento de
transporte CTRC
Informar a espécie da
Mercadoria
Identifica se o frete é
controlado por peso ou
volume (P = Peso, V =
Volume)
Peso de saída em quilos
ou a quantidade de
volume
A10
CalculaPerda
Tipo do cálculo da perda
E
A03
S
1-1
1
-
Tipo do cálculo da perda
(S = Saída, C = Chegada)
A11
ValorTonelada
Valor da Tonelada
E
A03
N
1-1
10
2
A12
PerTolerancia
Percentual de Tolerância da
perda
E
A03
N
1-1
5
2
A13
A14
DescTotalPerda
DataInicioViagem
Desconta Total da Perda
Data de Início da Viagem
E
E
A03
A03
S
D
1-1
0-1
1
-
-
Valor da tonelada paga
para o contratado
Percentual de tolerância
utilizado para cálculo do
valor da perda a descontar
na quitação do frete
S = Desconta o valor total
da perda, N = Desconta o
somente o valor acima do
percentual estipulado
Formato: AAAA-MM-DD
A15
DataFimViagem
Data de Previsão de
Término da Viagem
E
A03
D
1-1
-
-
Formato: AAAA-MM-DD
A16
TipoViagem
Tipo de Viagem
E
A03
N
1-1
1
-
1 = Viagem Padrão, 3 =
Viagem TAC-Agregado
A17
CodMunicipioOrigem
Código do Município de
Origem
E
A03
N
0-1
7
-
Informar o código IBGE do
município de origem
A18
CodMunicipioDestino
Código do Município de
Destino
E
A03
N
0-1
7
-
A19
CodNatureza
Código da Natureza
E
A03
N
1-1
4
-
Informar o código IBGE do
município de destino
Informar os quatro
primeiros dígitos do
código do Sistema
Harmonizado de
Designação e de
Codificação de
Mercadorias, divulgado
pela Receita Federal do
Brasil
A20
A21
KMFrete
ContataSeguro
Quantidade de quilômetros
do Frete
Contrata Seguro Policard
E
E
A03
A03
N
S
0-1
1-1
1-9
1
-
Informar a distância em
KM do frete
S = Sim, N = Não
A22
PermiteTransQuitar
Permite somente a
Transportadora Quitar
E
A03
S
1-1
1
-
S = Sim, N = Não
Classificação da Informação: Normal, Monitorada, Restrita.
POLICARD SYSTEMS E SERVIÇOS S/A
UBERLÂNDIA – MG
( x ) Nova
( ) Alteração
DTI - 001
01/02/2011
Manual Integração Serviços
POLIFRETE
NORMA
CÓDIGO
EMISSÃO
RESPONSÁVEL
Alisson Freitas
VERSÃO
002
PAG
19
DE
48
A23
PermiteDestQuitar
Permite Destinatário Quitar
E
A03
S
1-1
1
-
A24
CpfRespQuitacao
CPF do Responsável pela
Quitação
E
A03
S
0-1
11
-
A25
SenhaQuitacao
Senha de Quitação
E
A03
S
0-1
1-100
-
A26
Contratado
Grupo das informações
do Contratado
G
A03
-
1-1
-
-
A27
NumeroCartao
Número do Cartão PoliFrete
E
A26
N
1-1
16
-
A28
RNTRC
Número do RNTRC
E
A26
N
1-1
8
-
A29
CpfCnpj
CPF ou Cnpj do Contratado
E
A26
N
1-1
11-14
-
A30
Nome
Nome ou Razão Social do
Contratado
E
A26
S
1-1
1-60
-
Informar o CPF ou CNPJ
do Contratado
Informar o Nome ou
Razão Social do
Contratado
A31
Endereco
Grupo das informações
do endereço do
Contratado
G
A26
-
1-1
-
-
Grupo que contém as
informações do
endereço do Contratado
A32
Logradouro
Logradouro do endereço
E
A31
S
1-1
1-100
-
Informar o logradouro do
endereço do contratado
A33
Numero
Número
E
A31
S
1-1
1-10
-
Informar o número do
logradouro do contratado
A34
Complemento
Complemento
E
A31
S
0-1
1-30
-
A35
Bairro
Nome do Bairro
E
A31
S
1-1
1-30
-
A36
Cep
Número do CEP
E
A31
N
1-1
8
-
A37
CodMunicipio
Código do Município
E
A31
N
1-1
7
-
A38
Telefone
Telefone Residencial
E
A26
S
1-1
1-18
-
A39
TelefoneCelular
Telefone Celular
E
A26
S
0-1
1-18
-
A40
TelefoneComercial
Telefone Comercial
E
A26
S
0-1
1-18
-
A41
VeiculoTransporte
Grupo das informações
do Veiculo de Transporte
G
A03
-
1-5
-
-
A42
Placa
Placa do veículo
E
A41
S
1-1
7
-
Classificação da Informação: Normal, Monitorada, Restrita.
S = Sim, N = Não
Informar o CPF do
Responsável pela
quitação do frete quando
permitir o destinatário
quitar.
Informar a senha para a
quitação quando permitir o
destinatário quitar
Grupo que contém as
informações do
contratado
Informar o número do
cartão polifrete do
contratado
Informar o RNTRC do
contratado
Informar o complemento
do endereço contratado
Informar o nome do bairro
do endereço do
contratado
Informar o número do CEP
do endereço do
contratado
Informar o código IBGE do
município do contratado
Informar o número do
telefone residencial do
contratado
Informar o número do
telefone celular do
contratado
Informar o número do
telefone comercial do
contratado
Grupo que contém as
informações do veículo
de transporte
Informar a placa do
veículo
POLICARD SYSTEMS E SERVIÇOS S/A
UBERLÂNDIA – MG
( x ) Nova
( ) Alteração
DTI - 001
01/02/2011
Manual Integração Serviços
POLIFRETE
NORMA
CÓDIGO
EMISSÃO
RESPONSÁVEL
Alisson Freitas
VERSÃO
002
PAG
20
DE
48
Informar o número do
RNTRC do Transportador
que possui o veículo em
sua frota
Grupo que contém as
informações do
Destinatário
A43
RNTRC
Número do RNTRC
E
A41
N
1-1
8
-
A44
Destinatario
Grupo das informações
do Destinatário
G
A03
-
0-1
-
-
A45
CpfCnpj
CPF ou Cnpj do
Destinatário
E
A44
N
1-1
11-14
-
A46
Nome
Nome ou Razão Social do
Destinatário
E
A44
S
1-1
1-60
-
A47
Endereco
Grupo das informações
do endereço do
Destinatário
G
A44
-
1-1
-
-
Informar o CPF ou CNPJ
do Destinatário
Informar o Nome ou
Razão Social do
Destinatário
Grupo que contém as
informações do
endereço do
Destinatário
A48
Logradouro
Logradouro do endereço
E
A47
S
1-1
1-100
-
Informar o logradouro do
endereço do destinatário
A49
Numero
Número
E
A47
S
1-1
1-10
-
Informar o número do
logradouro do destinatário
A50
Complemento
Complemento
E
A47
S
0-1
1-30
-
A51
Bairro
Nome do Bairro
E
A47
S
1-1
1-30
-
A52
Cep
Número do CEP
E
A47
N
1-1
8
-
A53
CodMunicipio
Código do Município
E
A47
N
1-1
7
-
A54
Consignatario
Grupo das informações
do Consignatário
G
A03
-
0-1
-
-
A55
CpfCnpj
CPF ou CNPJ do
Consignatário
E
A54
N
1-1
11-14
-
A56
Nome
Nome ou Razão Social do
Consignatário
E
A54
S
1-1
1-60
-
A57
Endereco
Grupo das informações
do endereço do
Consignatário
G
A54
-
1-1
-
-
A58
Logradouro
Logradouro do endereço
E
A57
S
1-1
1-100
-
A59
Numero
Número
E
A57
S
1-1
1-10
-
A60
Complemento
Complemento
E
A57
S
0-1
1-30
-
A61
Bairro
Nome do Bairro
E
A57
S
1-1
1-30
-
A62
Cep
Número do CEP
E
A57
N
1-1
8
-
Classificação da Informação: Normal, Monitorada, Restrita.
Informar o complemento
do endereço destinatário
Informar o nome do bairro
do endereço do
destinatário
Informar o número do CEP
do endereço do
destinatário.
Informar o código IBGE do
município do destinatário
Grupo que contém as
informações do
Consignatário
Informar o CPF ou CNPJ
do Consignatário
Informar o Nome ou
Razão Social do
Consignatário
Grupo que contém as
informações do
endereço do
Consignatário
Informar o logradouro do
endereço do consignatário
Informar o número do
logradouro do
consignatário
Informar o complemento
do endereço consignatário
Informar o nome do bairro
do endereço do
consignatário
Informar o número do CEP
do endereço do
consignatário
POLICARD SYSTEMS E SERVIÇOS S/A
UBERLÂNDIA – MG
RESPONSÁVEL
Alisson Freitas
VERSÃO
002
A63
CodMunicipio
Código do Município
E
A57
N
1-1
7
-
A64
SubContratante
Grupo das informações
do Consignatário
G
A03
-
0-1
-
-
A65
CpfCnpj
CPF ou CNPJ do
Consignatário
E
A64
N
1-1
11-14
-
A66
Nome
Nome ou Razão Social do
Consignatário
E
A64
S
1-1
1-60
-
A67
Endereco
Grupo das informações
do endereço do
Subcontratante
G
A64
-
1-1
-
-
A68
Logradouro
Logradouro do endereço
E
A67
S
1-1
1-100
-
A69
Numero
Número
E
A67
S
1-1
1-10
-
A70
Complemento
Complemento
E
A67
S
0-1
1-30
-
A71
Bairro
Nome do Bairro
E
A67
S
1-1
1-30
-
A72
Cep
Número do CEP
E
A67
N
1-1
8
-
A73
CodMunicipio
Código do Município
E
A67
N
1-1
7
-
A74
Valores
Grupo das informações
dos Valores do Frete
G
A03
-
1-1
-
-
A75
Rendimentos
Valor do rendimento a ser
pago para o contratado
E
A74
N
1-1
8
2
A76
Pedagio
Valor do Pedágio
E
A74
N
1-1
8
2
A77
OutrosCreditos
Outros Créditos
E
A74
N
1-1
8
2
Classificação da Informação: Normal, Monitorada, Restrita.
( x ) Nova
( ) Alteração
DTI - 001
01/02/2011
Manual Integração Serviços
POLIFRETE
NORMA
CÓDIGO
EMISSÃO
PAG
21
DE
48
Informar o código IBGE do
município do consignatário
Grupo que contém as
informações do
Subcontratante
Informar o CPF ou CNPJ
do Subcontratante
Informar o Nome ou
Razão Social do
Subcontratante
Grupo que contém as
informações do
endereço do
Subcontratante
Informar o logradouro do
endereço do
Subcontratante
Informar o número do
logradouro do
Subcontratante
Informar o complemento
do endereço
Subcontratante
Informar o nome do bairro
do endereço do
Subcontratante
Informar o número do CEP
do endereço do
Subcontratante
Informar o código IBGE do
município do
Subcontratante
Grupo que contém as
informações dos valores
do frete
Informar o valor do
rendimento a ser pago
para o contratado sem os
descontos e acréscimos.
Caso tenha informado o
valor da tonelada este
campo deverá conter o
resultado da operação
“Valor da Tonelada” x
“Quantidade em
Tonelada”.
Informar o valor referente
a pedágio a ser adiantado
no cartão do contratado.
Este valor é creditado no
cartão no momento da
liberação do frete
Informar o valor referente
a outros créditos a ser
pago para o contratado no
momento da quitação
POLICARD SYSTEMS E SERVIÇOS S/A
UBERLÂNDIA – MG
EMISSÃO
Manual Integração Serviços
POLIFRETE
NORMA
CÓDIGO
RESPONSÁVEL
Alisson Freitas
VERSÃO
002
A78
Adiantamento
Valor de Adiantamento
E
A74
N
1-1
8
2
A79
INSS
Valor do INSS
E
A74
N
1-1
8
2
A80
SestSenat
Valor Sest/Senat
E
A74
N
1-1
8
2
A81
IR
Valor do Imposto de Renda
E
A74
N
1-1
8
2
A82
Seguro
Valor do Seguro da Carga
E
A74
N
1-1
8
2
A83
OutrosDebitos
Outros Débitos
E
A74
N
1-1
8
2
A84
ValorMercadoria
Valor da Mercadoria
E
A74
N
1-1
8
2
A85
ValorCombustivel
Valor de Combustível
E
A74
N
1-1
8
2
A86
ValorCTRC
Valor do CTRC
E
A74
N
1-1
8
2
A87
ISSQN
Valor do ISSQN
E
A74
N
1-1
8
2
A88
ICMS
Valor do ICMS
E
A74
N
1-1
8
2
Classificação da Informação: Normal, Monitorada, Restrita.
( x ) Nova
( ) Alteração
DTI - 001
01/02/2011
PAG
22
DE
48
Informar o valor referente
a adiantamento de frete a
ser adiantado no cartão do
contratado. Este valor é
creditado no cartão no
momento da liberação do
frete e descontado na
quitação
Informar o valor referente
ao desconto do INSS a
ser descontado do
contratado no momento
da quitação
Informar o valor referente
ao desconto do
Sest/Senat a ser
descontado do contratado
no momento da quitação
Informar o valor referente
ao desconto do imposto
de renda a ser descontado
do contratado no
momento da quitação
Informar o valor do seguro
a ser descontado do
contratado no momento
da quitação
Informar o valor de outros
débitos a ser descontado
do contratado no
momento da quitação
Informar o valor da
mercadoria carregada.
Este valor é utilizado para
cálculo da perda
Informar o valor pago ao
contratado referente a
pagamento de
combustível. Este valor é
apenas informativo e não
compõe nenhum cálculo
Informar o valor do CTRC
referente ao frete. Este
valor é apenas informativo
e não compõe nenhum
cálculo
Informar o valor do ISSQN
pago referente ao CTRC.
Este valor é apenas
informativo e não compõe
nenhum cálculo
Informar o valor do ICMS
pago referente ao CTRC.
Este valor é apenas
informativo e não compõe
nenhum cálculo
POLICARD SYSTEMS E SERVIÇOS S/A
UBERLÂNDIA – MG
RESPONSÁVEL
Alisson Freitas
VERSÃO
002
A89
Signature
4.4.
XML
G
A01
( x ) Nova
( ) Alteração
DTI - 001
01/02/2011
Manual Integração Serviços
POLIFRETE
NORMA
CÓDIGO
EMISSÃO
-
1-1
-
PAG
23
DE
48
Assinatura Digital do
documento XML, a
assinatura deverá ser
aplicada no elemento
InfFrete
-
Leiaute Mensagem de Retorno
Retorno: Estrutura XML com a mensagem do resultado da transmissão.
Campo
Descrição
Elem
Pai
Tipo
Ocor
Tam
Dec
RetDeclararOperTra
nsp
Tag Raiz do Retorno da
Declaração da Operação
de Transporte
Raiz
-
-
1-1
-
-
Tag Raiz
B02
DataDeclaracao
Data e Hora que foi
registrada a declaração de
transporte na ANTT
E
B01
DT
0-1
-
-
Data e Hora do registro
da declaração de
transporte na ANTT
B03
CIOT
Código de Identificação da
Operação de Transporte
E
B01
N
0-1
12
-
B04
CodigoVerificador
Código Verificador
E
B01
N
0-1
4
-
B05
AvisoTransportador
Aviso ao Transportador
E
B01
S
0-1
0-300
-
B06
Contingencia
Modo Contingencia
E
B01
B
1-1
-
-
#
B01
B07
B08
B09
B10
Sucesso
Indicativo de sucesso
E
B01
B
1-1
-
-
Excecao
Codigo
Mensagem
Grupo das informações da
falha na solicitação do
serviço
Código do Erro
Mensagem do Erro
G
E
E
B01
B08
B08
S
S
0-1
1-1
1-1
6
1-N
-
Classificação da Informação: Normal, Monitorada, Restrita.
Observação
Código de Identificação
da Operação
Código Verificador do
CIOT retornado pela
ANTT. Quando a
operação de transporte
for registrada em modo
de contingência este
campo não será
retornado, sendo
necessária a consulta do
código verificador
posteriormente.
Aviso ao Transportador
retornado pela ANTT
true = Operação de
Transporte registrada
em modo de
Contingência. false =
Operação de Transporte
Declarada na ANTT
True = Sucesso na
solicitação, False =
Falha na solicitação
Grupo que contém as
informações da falha
ocorrida na solicitação
do serviço
Código do erro
Mensagem do erro
POLICARD SYSTEMS E SERVIÇOS S/A
UBERLÂNDIA – MG
EMISSÃO
Manual Integração Serviços
POLIFRETE
01/02/2011
VERSÃO
002
4.5.
CÓDIGO
NORMA
( x ) Nova
( ) Alteração
DTI - 001
RESPONSÁVEL
Alisson Freitas
PAG
24
Serviço de Retificação da Operação de Transporte
O Serviço de Retificação da Operação de Transporte é o serviço oferecido pela
Policard para retificar uma operação de transporte na ANTT, caso a mesma
tenha sido declarada com algum tipo de erro ou haja mudança nos dados até a
data limite para retificação.
Nem todos os dados são passíveis de retificação, sendo possível apenas a
alteração dos dados que não descaracterizem a operação de transporte. Para
as operações de transporte padrão, os dados passíveis de retificação são:
placas dos veículos, data de início da viagem, data prevista de término da
viagem, código da natureza da carga, código do município de origem e código
do município de destino. Para as operações de transporte TAC-Agregado,
apenas as placas dos veículos são passíveis de retificação, uma vez que os
demais dados não são informados no momento da declaração. Caso seja
necessário alterar algum dos dados que não é passível de retificação, deve-se
cancelar a operação de transporte e declarar uma nova.
O prazo limite para retificação dos dados para a operação de transporte padrão
são 24 horas após a data de início da viagem. Após este prazo, só será
permitida a alteração das placas dos veículos. Caso algum outro dado diferente
das placas seja enviado após o prazo de 24 horas, ou caso a operação de
transporte tenha sido consultada pela fiscalização da ANTT, o mesmo não
sofrerá nenhuma modificação.
Para operações de transporte com TAC-Agregado, o prazo limite para
retificação dos dados é de no máximo 72 horas após o fim da viagem. Após
este prazo ainda é possível retificar os dados da operação de transporte,
porem apenas no encerramento da operação de transporte.
Em qualquer um dos casos, a alteração das placas é permitida desde que
pertença ao mesmo transportador.
4.6.
WebService – Serviço de Retificação da Operação de Transporte
Função: Retificar uma determinada operação de transporte, caso a mesma
tenha sido declarada com algum tipo de erro ou haja alguma mudança nos
dados até a data da viagem.
Processo: Síncrono
Método: RetificarOperTransp
Classificação da Informação: Normal, Monitorada, Restrita.
DE
48
POLICARD SYSTEMS E SERVIÇOS S/A
UBERLÂNDIA – MG
01/02/2011
Manual Integração Serviços
POLIFRETE
( x ) Nova
( ) Alteração
DTI - 001
RESPONSÁVEL
Alisson Freitas
VERSÃO
002
4.7.
NORMA
CÓDIGO
EMISSÃO
PAG
DE
25
48
Leiaute Mensagem de Entrada
Entrada: Estrutura XML com os dados da retificação da operação de
transporte
C01
RetificarOperTransp
Descrição
Tag Raiz da Retificação
da
Operação
de
Transporte
C02
versao
versão do leiaute
A
C01
N
1-1
1-4
2
C03
InfRet
Grupo das informações
da Retificação
G
C01
-
1-1
-
-
C04
Id
A
C03
N
1-1
1-16
-
C05
CodigoIdentificacaoO
peracao
Código Identificador da
Operação de Transporte
E
C03
S
1-1
16
-
C06
VeiculoTransporte
Grupo das informações
do
Veiculo
de
Transporte
G
C03
-
0-5
-
-
C07
Placa
Placa do Veículo
E
C06
S
1-1
7
-
C08
RNTRC
Número do RNTRC
E
C06
N
1-1
8
-
C09
CodigoNaturezaCarg
a
Código da Natureza da
Carga
E
C03
N
0-1
4
-
Grupo que contém as
informações do veículo
de transporte
Informar a placa do
veículo
Informar o número do
RNTRC do Transportador
que possui o veículo em
sua frota
Informar os quatro
primeiros dígitos do
código do Sistema
Harmonizado de
Designação e de
Codificação de
Mercadorias, divulgado
pela Receita Federal do
Brasil
C10
DataInicioViagem
Data de Início da Viagem
E
C03
D
0-1
-
-
Formato: AAAA-MM-DD
C11
DataFimViagem
Data de Previsão
Término da Viagem
E
C03
D
0-1
-
-
Formato: AAAA-MM-DD
C12
CodigoMunicipioOrige
m
Código do Município de
Origem
E
C03
N
0-1
7
C13
CodigoMunicipioDesti
no
Código do Município de
Destino
E
C03
N
0-1
7
-
C14
Signature
XML
G
C01
-
1-1
-
-
#
Campo
Elem
Pai
Tipo
Ocor
Tam
Dec
Raiz
-
-
1-1
-
-
Observação
Tag Raiz
versão do leiaute (mesma
versão do arquivo de
schema xsd)
Grupo que contém as
informações da
Retificação da Operação
de Transporte
Informar o Código
Identificador da Operação
de Transporte informado
no campo C05
Código Identificador da
operação de transporte
mais o código verificador
de
Classificação da Informação: Normal, Monitorada, Restrita.
Informar o código IBGE do
município de origem
Informar o código IBGE do
município de destino
Assinatura Digital do
documento XML, a
assinatura deverá ser
aplicada no elemento
POLICARD SYSTEMS E SERVIÇOS S/A
UBERLÂNDIA – MG
RESPONSÁVEL
Alisson Freitas
VERSÃO
002
( x ) Nova
( ) Alteração
DTI - 001
01/02/2011
Manual Integração Serviços
POLIFRETE
NORMA
CÓDIGO
EMISSÃO
PAG
DE
26
48
InfRet
4.8.
Leiaute Mensagem de Retorno
Retorno: Estrutura XML com a mensagem do resultado da transmissão.
Campo
Descrição
Elem
Pai
Tipo
Ocor
Tam
Dec
D01
RetRetificarOperTra
nsp
Tag Raiz do Retorno da
Retificação
da
Operação de Transporte
Raiz
-
-
1-1
-
-
D02
DadosRetificacaoOp
erTransp
Grupo das informações
dos dados do retorna
da retificação
G
D01
-
0-1
-
-
D03
CodigoIdentificacaoO
peracao
Código Identificador da
Operação de Transporte
E
D02
N
1-1
16
-
D04
DataRetificação
Data
e
Hora
da
Retificação da Operação
de Transporte
E
D02
DT
1-1
-
-
D05
Sucesso
Identificador de Sucesso
E
D01
B
1-1
-
-
D06
Excecao
Grupo das informações
da falha na solicitação
do serviço
G
D01
-
0-1
-
-
Código Identificador da
Operação de Transporte
Data e Hora da Retificação
da Operação de
Transporte registrada na
ANTT
True = Sucesso na
solicitação, False = Falha
na solicitação
Grupo que contém as
informações da falha
ocorrida na solicitação
do serviço
D07
Codigo
Código do Erro
E
D06
S
1-1
6
-
Código do erro
D08
Mensagem
Mensagem do Erro
E
D06
S
1-1
1-N
-
Mensagem do erro
#
4.9.
Observação
Tag Raiz
Grupo que contém as
informações do Retorno
da retificação de
Transporte
Serviço de Encerramento da Operação de Transporte
O Serviço de Encerramento de Operação de Transporte é oferecido pela
Policard para encerrar uma operação de transporte na ANTT, declarando que a
mesma foi executada com sucesso e chegou ao seu fim.
O prazo máximo para o encerramento da Operação de Transporte é de 30 dias
corridos a partir da data informada com previsão de término da operação de
transporte.
Para as operações de transporte padrão, é possível no momento do
encerramento retificar o campo peso da carga, ajustando o seu valor ao peso
correto aferido no término da operação de transporte, este valor é o mesmo
informado no campo peso de chegada no momento da quitação do frete.
Classificação da Informação: Normal, Monitorada, Restrita.
POLICARD SYSTEMS E SERVIÇOS S/A
UBERLÂNDIA – MG
EMISSÃO
Manual Integração Serviços
POLIFRETE
01/02/2011
VERSÃO
002
CÓDIGO
NORMA
( x ) Nova
( ) Alteração
DTI - 001
RESPONSÁVEL
Alisson Freitas
PAG
27
Para as operações de transporte com TAC-Agregado, no momento do
encerramento, devem ser informadas todas as viagens que aconteceram
durante a vigência da operação de transporte, discriminando o código do
município de origem, o código do município de destino, o código da natureza
da carga, o peso e a quantidade de viagens. Para os dois últimos campos,
deve-se considerar sempre o somatório das viagens de mesma origem/destino
e a mesma carga.
Para exemplificar a regra acima, caso o transportador contatado tenha
realizado, durante a vigência da operação de transporte, cinco viagens para o
Rio de Janeiro e São Paulo, levando em cada uma delas dez toneladas de
soja, deve se declarar, no momento do encerramento, as seguintes
informações:
Município de Origem: 3304557 (código IBGE do município do Rio de
Janeiro / RJ)
Município de Destino: 3550380 (código IBGE do município de São
Paulo / SP)
Natureza da Carga: 1201 (código do SH para Soja)
Peso da Carga: 50.000 (peso total das cinco viagens em quilos)
Quantidade de Viagens: 5
Caso a operação de transporte com TAC-Agregado não seja encerrada até a
sua data limite, o sistema da ANTT irá marcar automaticamente esta operação
de transporte como “Pendente”. Uma vez a operação de transporte marcada
como “Pendente”, o contratante fica impedido de gerar uma nova operação de
transporte com TAC-Agregado para o transportador contratado até que a
mesma seja encerrada. O impedimento de uma nova declaração no caso de
pendência acontece exclusivamente na relação contratante/contratado,
podendo o contratante agregar outros transportadores que não possuem
pendência com ele, bem como o transportador se agregado por outro
contratante qualquer.
É permitido encerrar a operação de transporte antes da data prevista para
término da mesma. Ao fazer isso, o sistema considerará como data fim da
operação de transporte a própria data do encerramento, retificando a operação
de transporte e, no caso de operações com TAC-Agregado, retirando a
exclusividade do transportador.
Classificação da Informação: Normal, Monitorada, Restrita.
DE
48
POLICARD SYSTEMS E SERVIÇOS S/A
UBERLÂNDIA – MG
RESPONSÁVEL
Alisson Freitas
VERSÃO
002
( x ) Nova
( ) Alteração
DTI - 001
01/02/2011
Manual Integração Serviços
POLIFRETE
NORMA
CÓDIGO
EMISSÃO
PAG
DE
28
48
4.10. WebService – Serviço de Encerramento da Operação de
Transporte
Função: Encerrar uma operação de transporte, indicando que a mesma foi
finalizada com sucesso, ajustando os dados informados previamente que por
ventura tenham sido alterados no decorrer da operação de transporte.
Processo: Síncrono
Método: EncerrarOperTransp
4.11. Leiaute Mensagem de Entrada
E01
EncerrarOperTransp
Descrição
Tag
Raiz
Encerramento
Operação
Transporte
E02
versao
versão do leiaute
E03
InfEnc
Grupo
informações
Encerramento
E04
Id
E05
CodigoIdentificacaoO
peracao
Código Identificador da
Operação de Transporte
E
E03
S
1-1
16
-
E06
ViagemOperTransp
Grupo
informaçoes
viagens
G
E03
-
0-N
-
-
E07
CodigoMunicipioOrige
m
Código do município de
origem
E
E06
N
1-1
7
E08
CodigoMunicipioDesti
no
Código do município de
destino
E
E06
N
1-1
7
E09
CodigoNaturezaCarg
a
Código da Natureza da
Carga
E
E06
N
1-1
4
#
Campo
Elem
Pai
Tipo
Ocor
Tam
Dec
Raiz
-
-
1-1
-
-
A
E01
N
1-1
1-4
2
G
E01
-
1-1
-
-
A
E03
N
1-1
1-16
-
Observação
do
da
de
das
do
das
das
Classificação da Informação: Normal, Monitorada, Restrita.
Tag Raiz
versão do leiaute (mesma
versão do arquivo de
schema xsd)
Grupo que contém as
informações do
Encerramento da
Operação de Transporte
Informar o Código
Identificador da Operação
de Transporte informado
no campo E05
Código Identificador da
operação de transporte
mais o código verificador
Grupo que contém as
informações das viagens
realizadas na operação
de transporte TACAgregado
Informar o código IBGE do
município de origem
Informar o código IBGE do
município de destino
Informar os quatro
primeiros dígitos do código
do Sistema Harmonizado
de Designação e de
Codificação de
Mercadorias, divulgado
pela Receita Federal do
Brasil
POLICARD SYSTEMS E SERVIÇOS S/A
UBERLÂNDIA – MG
RESPONSÁVEL
Alisson Freitas
VERSÃO
002
( x ) Nova
( ) Alteração
DTI - 001
01/02/2011
Manual Integração Serviços
POLIFRETE
NORMA
CÓDIGO
EMISSÃO
E10
PesoCarga
Peso da Carga
E
E06
N
1-1
10
8,2
E11
QuantidadeViagens
Quantidade de Viagens
E
E06
N
1-1
-
-
E12
Signature
XML
G
E01
-
1-1
-
-
PAG
29
DE
48
Somatório do peso em
quilos das cargas
transportadas durante a
vigência da operação de
transporte para a mesma
combinação de município
de origem, municípop de
destino e código da
natureza da carga.
Quantidade de viagens
realizadas durante a
vigência da operação de
transporte para a mesma
combinação de município
de origem, municípop de
destino e código da
natureza da carga.
Assinatura Digital do
documento XML, a
assinatura deverá ser
aplicada no elemento
InfEnc
4.12. Leiaute Mensagem de Retorno
Retorno: Estrutura XML com a mensagem do resultado da transmissão.
Campo
Descrição
Elem
Pai
Tipo
Ocor
Tam
Dec
F01
RetEncerrarOperTra
nsp
Tag Raiz do Retorno do
Encerramento da
Operação de Transporte
Raiz
-
-
1-1
-
-
F02
DadosEncerramento
OperacaoTransporte
Grupo das informaçoes
do retorno do
encerramento
G
F01
-
0-1
-
-
F03
CodigoIdentificacaoO
peracao
Código Identificador da
Operação de Transporte
E
F02
N
1-1
16
-
F04
DataEncerramento
Data do Encerramento
E
F02
DT
1-1
-
-
F05
ProtocoloEncerramen
to
Protocolo de
Encerramento
E
F02
N
1-1
15
-
F06
Sucesso
Identificador de Sucesso
E
F01
B
1-1
-
-
F07
Excecao
Grupo das informações
da falha na solicitação
do serviço
G
F01
-
0-1
-
-
Protocolo de Encerramento
da Operação de Transporte
True = Sucesso na
solicitação, False = Falha
na solicitação
Grupo que contém as
informações da falha
ocorrida na solicitação do
serviço
F08
Codigo
Código do Erro
E
F07
S
1-1
6
-
Código do erro
F09
Mensagem
Mensagem do Erro
E
F07
S
1-1
1-N
-
Mensagem do erro
#
Classificação da Informação: Normal, Monitorada, Restrita.
Observação
Tag Raiz
Grupo que contém os
dados do retorno do
encerramento da
operação de transporte
Código Identificador da
Operação de Transporte
mais o Código Verificador
Data do Encerramento da
Operação de transporte
registrada na ANTT
POLICARD SYSTEMS E SERVIÇOS S/A
UBERLÂNDIA – MG
( x ) Nova
( ) Alteração
DTI - 001
01/02/2011
Manual Integração Serviços
POLIFRETE
NORMA
CÓDIGO
EMISSÃO
RESPONSÁVEL
Alisson Freitas
VERSÃO
002
PAG
DE
30
48
4.13. Serviço de Consulta do Extrato da Conta
O Serviço de consulta do Extrato da Conta é oferecido para consultar os
lançamentos registrados na conta corrente da transportadora na Policard. O
período máximo para consulta é de 60 dias.
4.14. WebService – Serviço de Consulta do Extrato da Conta
Função: Consultar os lançamentos registrados na conta corrente da
transportadora na Policard.
Processo: Síncrono
Método: ConsultarExtratoConta
4.15. Leiaute Mensagem de Entrada
Campo
Descrição
Elem
Pai
Tipo
Ocor
Tam
Dec
G01
ConsultarExtratoCo
nta
Tag Raiz da Consulta
do Extrato da Conta
Raiz
-
-
1-1
-
-
G02
versao
versão do leiaute
A
G01
N
1-1
1-4
2
G03
InfExtrato
Grupo das informações
da
solicitação
da
Consulta do Extrato da
Conta
G
G01
-
1-1
-
-
Tag Raiz
versão do leiaute
(mesma versão do
arquivo de schema xsd)
Grupo que contém as
informações da
solicitação da
Conslulta do Extrato
da Conta
G04
DataInicio
Data de Inicial do Período
E
G03
D
1-1
-
-
Formato: AAAA-MM-DD
G05
DataFim
Data Final do Período
E
G03
D
1-1
-
-
Formato: AAAA-MM-DD
#
Observação
4.16. Leiaute Mensagem de Retorno
Retorno: Estrutura XML com a mensagem do resultado da transmissão.
#
Campo
H01
RetConsultarExtrat
oConta
H02
Extrato
H03
Lancamento
Descrição
Tag Raiz do Retorno
da Consulta do Extrato
da Conta
Grupo das
informações do
Extrato
Grupo das
informações do
lançamento
Elem
Pai
Tipo
Ocor
Tam
Dec
Raiz
-
-
1-1
-
-
G
H01
-
0-1
-
-
Tag Raiz
Grupo que contém as
informações do extrato da
conta
G
H02
-
1-N
-
-
Grupo que contém as
informações do lançamento
Classificação da Informação: Normal, Monitorada, Restrita.
Observação
POLICARD SYSTEMS E SERVIÇOS S/A
UBERLÂNDIA – MG
RESPONSÁVEL
Alisson Freitas
VERSÃO
002
H04
Data
H05
( x ) Nova
( ) Alteração
DTI - 001
01/02/2011
Manual Integração Serviços
POLIFRETE
NORMA
CÓDIGO
EMISSÃO
PAG
48
-
Data do lançamento da
movimentação
1-1
1255
-
Descrição do Lançamento
N
1-1
11
9,2
Valor de Crédito referente ao
lançamento
H03
N
1-1
11
9,2
Valor de Débito referente ao
lançamento
E
H03
N
1-1
11
9,2
Valor do Saldo
E
H01
B
1-1
-
-
True = Sucesso na solicitação,
False = Falha na solicitação
-
-
Grupo que contém as
informações da falha ocorrida
na solicitação do serviço
E
H03
D
1-1
Descricao
Data do Lançamento
Descrição do
Lançamento
E
H03
S
H06
Credito
Valor de Crédito
E
H03
H07
Debito
Valor de Débito
E
H08
Saldo
Valor de Saldo
H09
Sucesso
G
H01
-
0-1
H10
Excecao
Identificador de Sucesso
Grupo
das
informações da falha
na
solicitação
do
serviço
H11
Codigo
Código do Erro
E
H10
S
1-1
6
-
Código do erro
H12
Mensagem
Mensagem do Erro
E
H10
S
1-1
1-N
-
Mensagem do erro
4.17. Serviço de Consulta do Código Verificador ANTT
O Serviço de Consulta do Código Verificador da ANTT é oferecido para
retornar o código verificador de uma Declaração de Operação de Transporte
que foi registrada em modo de Contingência.
4.18. WebService – Serviço de Consulta do Código Verificador ANTT
Função: Consultar o Código Verificador retornado pela ANTT da Declaração
da Operação de Transporte que foi registrada em modo de Contingência.
Processo: Síncrono
Método: ConsultarCodigoVerificador
4.19. Leiaute Mensagem de Entrada
Campo
Descrição
Elem
Pai
Tipo
Ocor
Tam
Dec
I01
ConsultarCodigoVe
rificador
Tag Raiz da Consulta
do Extrato da Conta
Raiz
-
-
1-1
-
-
I02
versao
versão do leiaute
A
I01
N
1-1
1-4
2
Tag Raiz
versão do leiaute
(mesma versão do
arquivo de schema xsd)
I03
CIOT
Código Identificador da
Operacao de Transporte
E
I01
N
1-1
12
-
Código Identificador da
Operação de Transporte.
#
DE
31
Classificação da Informação: Normal, Monitorada, Restrita.
Observação
POLICARD SYSTEMS E SERVIÇOS S/A
UBERLÂNDIA – MG
RESPONSÁVEL
Alisson Freitas
VERSÃO
002
( x ) Nova
( ) Alteração
DTI - 001
01/02/2011
Manual Integração Serviços
POLIFRETE
NORMA
CÓDIGO
EMISSÃO
PAG
32
4.20. Leiaute Mensagem de Retorno
Retorno: Estrutura XML com a mensagem do resultado da transmissão.
Campo
Descrição
Elem
Pai
Tipo
Ocor
Tam
Dec
J01
RetConsultarCodig
oVerificador
Tag Raiz do Retorno da
Consulta do Extrato da
Conta
Raiz
-
-
1-1
-
-
J02
CIOT
Código Identificador da
Operacao de Transporte
E
J01
N
1-1
12
-
J03
CodigoVerificador
Código Verificador
1-1
4
-
J04
Sucesso
Identificador de Sucesso
E
J01
B
1-1
-
-
J05
Excecao
Grupo das informações
da falha na solicitação
do serviço
G
J01
-
0-1
-
-
Código Identificador da
Operação de Transporte.
Código Verificador do
CIOT retornado pela
ANTT.
True = Sucesso na
solicitação, False = Falha
na solicitação
Grupo que contém as
informações da falha
ocorrida na solicitação
do serviço
J06
Codigo
Código do Erro
E
J05
S
1-1
6
-
Código do erro
J07
Mensagem
Mensagem do Erro
E
J05
S
1-1
1-N
-
Mensagem do erro
#
J01
Observação
Tag Raiz
4.21. Serviço de Cálculo da Quitação
O Serviço de Cálculo da Quitação é oferecido para simular a quitação de uma
operação de transporte retornando os valores que serão descontados e
creditados para o transportador.
4.22. WebService – Serviço de Cálculo da Quitação
Função: Calcular e Simular a Quitação da Operação de Transporte retornando
os valores que serão descontados e creditados para o transportado.
Processo: Síncrono
Método: CalcularQuitacao
4.23. Leiaute Mensagem de Entrada
#
L01
Campo
Descrição
Elem
Pai
Tipo
Ocor
Tam
Dec
CalcularQuitacao
Tag Raiz do Calculo da
Quitacao
Raiz
-
-
1-1
-
-
Classificação da Informação: Normal, Monitorada, Restrita.
Observação
Tag Raiz
DE
48
POLICARD SYSTEMS E SERVIÇOS S/A
UBERLÂNDIA – MG
01/02/2011
Manual Integração Serviços
POLIFRETE
L02
versao
versão do leiaute
A
L01
N
1-1
1-4
2
L03
CodigoIdentificacao
Operacao
Código Identificador da
Operacao de Transporte
E
L01
N
1-1
16
-
L04
PesoChegada
Peso de Chegada
E
L01
N
0-1
7
2
L05
Creditos
Grupo de Informações
dos Valores de Créditos
G
L01
-
1-1
-
-
L07
OutrosCreditos
Outros Créditos
E
L05
N
1-1
8
2
Debitos
Grupo de Informações
dos Valores de Débitos
G
L01
-
1-1
-
-
L08
OutrosCreditos
Outros Débitos
E
L07
N
1-1
8
2
L09
ImpostoRenda
Valor Imposto de Renda
E
L07
N
0-1
8
2
L10
SestSenat
Valor Sest / Senat
E
L07
N
0-1
8
2
L11
INSS
Valor INSS
E
L07
N
0-1
8
2
Classificação da Informação: Normal, Monitorada, Restrita.
( x ) Nova
( ) Alteração
DTI - 001
RESPONSÁVEL
Alisson Freitas
VERSÃO
002
L06
NORMA
CÓDIGO
EMISSÃO
PAG
DE
33
versão do leiaute
(mesma versão do
arquivo de schema xsd)
Código Identificador da
operação de transporte
mais o código verificador
Informar o Peso de
Chegada. Este campo
não é obrigatório para
Viagens TAC-Agregado
Informar o valor de
outros créditos que será
adicionado ao cálculo da
quitação
Informar o valor de
outros débitos que será
adicionado ao cálculo da
quitação
Informar o valor do
Imposto de Renda a ser
descontado do
Transportador. Este
valor será utilizado para
cálculo da Viagem TACAgregado, Viagem
Padrão será considerado
o valor informado na
declaração da Operação
de Transporte
Informar o valor do Sest /
Senat a ser descontado
do Transportador. Este
valor será utilizado para
cálculo da Viagem TACAgregado, Viagem
Padrão será considerado
o valor informado na
declaração da Operação
de Transporte
Informar o valor do INSS
a ser descontado do
Transportador. Este
valor será utilizado para
cálculo da Viagem TACAgregado, Viagem
Padrão será considerado
o valor informado na
declaração da Operação
de Transporte
48
POLICARD SYSTEMS E SERVIÇOS S/A
UBERLÂNDIA – MG
01/02/2011
Manual Integração Serviços
POLIFRETE
Seguro
Valor Seguro
E
L07
N
0-1
( x ) Nova
( ) Alteração
DTI - 001
RESPONSÁVEL
Alisson Freitas
VERSÃO
002
L12
NORMA
CÓDIGO
EMISSÃO
8
2
PAG
34
Informar o valor do
Seguro a ser descontado
do Transportador. Este
valor será utilizado para
cálculo da Viagem TACAgregado, Viagem
Padrão será considerado
o valor informado na
declaração da Operação
de Transporte
4.24. Leiaute Mensagem de Retorno
Retorno: Estrutura XML com a mensagem do resultado da transmissão.
Campo
Descrição
Elem
Pai
Tipo
Ocor
Tam
Dec
M01
RetCalcularQuitaca
o
Tag Raiz do Retorno do
Calculo da Quitacao
Raiz
-
-
1-1
-
-
M02
versao
versão do leiaute
A
M01
N
1-1
1-4
2
Calculo
Grupo das Informações
do Resulto do Cálculo
da Quitação
G
M01
-
0-1
-
-
#
M03
M04
PesoSaida
Peso de Saída
E
M03
N
0-1
7
2
M05
PesoChegada
Peso de Chegada
E
M03
N
0-1
7
2
M06
Creditos
G
M03
-
1-1
-
-
M07
Rendimentos
Grupo de Informações
dos valores de Créditos
Valor de Rendimento do
Frete
E
M06
N
1-1
8
2
M08
OutrosCreditos
Valor de Outros Créditos
E
M06
N
1-1
8
2
Debitos
Grupo de Informações
dos valores de Débitos
G
M03
-
1-1
-
-
M09
Observação
Tag Raiz
versão do leiaute
(mesma versão do
arquivo de schema xsd)
Peso de Saída que foi
registrado a Operação
de Transporte
Peso de Chegada que
foi informado para
cálculo da quitação
Valor de Rendimento do
Frete
Valor de Outros
Créditos
M10
Adiantamento
Valor Adiantamentos
E
M09
N
1-1
8
2
Soma dos valores de
adiantamentos
registrados para a
Operação de
Transporte
M11
Seguro
Valor Seguro
E
M09
N
1-1
8
2
Valor do Seguro
M12
INSS
Valor INSS
E
M09
N
1-1
8
2
Valor do INSS
M13
SestSenat
Valor Sest / Senat
E
M09
N
1-1
8
2
M14
ImpostoRenda
Valor Imposto de Renda
E
M09
N
1-1
8
2
Valor do Sest / Senat
Valor do Imposto de
Renda
M15
OutrosDebitos
Valor Outros Débitos
E
M09
N
1-1
8
2
M16
QuebraAvaria
Valor Quebra / Avaria
E
M09
N
1-1
8
2
Classificação da Informação: Normal, Monitorada, Restrita.
Valor de Outros Débitos
Valor calculado de
Quebra / Avaria
DE
48
POLICARD SYSTEMS E SERVIÇOS S/A
UBERLÂNDIA – MG
01/02/2011
Manual Integração Serviços
POLIFRETE
NORMA
CÓDIGO
EMISSÃO
RESPONSÁVEL
Alisson Freitas
VERSÃO
002
( x ) Nova
( ) Alteração
DTI - 001
8
2
PAG
35
Valor calculado de
Outros Descontos
M17
OutrosDescontos
Valor Outros Descontos
E
M09
N
1-1
M18
OutrosValores
Grupo de Informações
de Outros Valores
E
M03
N
1-1
-
-
M19
ICMS
Valor ICMS
E
M09
N
1-1
8
2
Valor do ICMS
M20
ISSQN
Valor ISSQN
E
M09
N
1-1
8
2
Valor do ISSQN
M21
Pedagio
Valor Pedagio
E
M09
N
1-1
8
2
Valor do Pedágio
M22
TotalReceber
Total a Receber
E
M03
N
1-1
8
2
M23
Sucesso
Identificador de Sucesso
E
M01
B
1-1
-
-
M24
Excecao
Grupo das informações
da falha na solicitação
do serviço
G
M01
-
0-1
-
-
Total a Receber
True = Sucesso na
solicitação, False =
Falha na solicitação
Grupo que contém as
informações da falha
ocorrida na
solicitação do serviço
M25
Codigo
Código do Erro
E
M24
S
1-1
6
-
Código do erro
M26
Mensagem
Mensagem do Erro
E
M24
S
1-1
1-N
-
Mensagem do erro
4.25. Serviço de Quitação da Operação de Transporte
O Serviço de Quitação da Operação de Transporte é oferecido para Quitar a
operação de transporte e liberar o pagamento ao transportador.
A quitação da operação de transporte liberará o pagamento do saldo a receber
de acordo com os valores informados para o cálculo da quitação.
Para a realização deste serviço é necessário que a transportadora possua o
valor do saldo que será liberado ao transportador em sua conta.
4.26. WebService – Serviço de Quitação da Operação de Transporte
Função: Quitar a Operação de Transporte e liberar o pagamento ao
transportador.
Processo: Síncrono
Método: QuitarOperTransp
4.27. Leiaute Mensagem de Entrada
#
N01
Campo
Descrição
Elem
Pai
Tipo
Ocor
Tam
Dec
QuitarOperTransp
Tag Raiz da Quitação da
Operação de Transporte
Raiz
-
-
1-1
-
-
Classificação da Informação: Normal, Monitorada, Restrita.
Observação
Tag Raiz
DE
48
POLICARD SYSTEMS E SERVIÇOS S/A
UBERLÂNDIA – MG
01/02/2011
Manual Integração Serviços
POLIFRETE
versao
N03
InfQuitacao
N04
Id
N05
CodigoIdentificacao
Operacao
N06
N07
versão do leiaute
Grupo de Informações
dos Valores para
Quitação
A
N01
N
1-1
1-4
2
G
N01
-
1-1
-
-
A
N03
N
1-1
16
-
Código Identificador da
Operação de Transporte
E
N03
S
1-1
16
-
PesoChegada
Peso de Chegada
E
N03
N
0-1
7
2
Creditos
Grupo de Informações
dos Valores de Créditos
G
N03
-
1-1
-
-
N08
OutrosCreditos
Valor Outros Créditos
E
N07
N
1-1
8
2
N09
Debitos
Grupo de Informações
dos Valores de Débitos
G
N03
-
1-1
-
-
N10
OutrosDebitos
Valor Outros Débitos
E
N09
N
1-1
8
2
N11
ImpostoRenda
Valor Imposto de Renda
E
N09
N
0-1
8
2
N12
SestSenat
Valor Sest / Senat
E
N09
N
0-1
8
2
N13
INSS
Valor INSS
E
N09
N
0-1
8
2
Classificação da Informação: Normal, Monitorada, Restrita.
( x ) Nova
( ) Alteração
DTI - 001
RESPONSÁVEL
Alisson Freitas
VERSÃO
002
N02
NORMA
CÓDIGO
EMISSÃO
PAG
36
versão do leiaute
(mesma versão do
arquivo de schema xsd)
Informar o Código
Identificador da
Operação de Transporte
Código Identificador da
operação de transporte
mais o código verificador
Se a Operação de
Transporte for Viagem
Padrão, informar o peso
de chegada
Informar o valor de
outros créditos a ser
adicionado na quitação
Informar o valor de
Outros Débitos a ser
adicionado na quitação
Se a Operação de
Transporte for Viagem
TAC-Agregado, informar
o valor do Imposto de
Renda. Caso esta TAG
não for informada será
considerado o valor
informado na
Declaração da
Operação de Transporte
Se a Operação de
Transporte for Viagem
TAC-Agregado, informar
o valor do Sest / Senat.
Caso esta TAG não for
informada será
considerado o valor
informado na
Declaração da
Operação de Transporte
Se a Operação de
Transporte for Viagem
TAC-Agregado, informar
o valor do INSS. Caso
esta TAG não for
informada será
considerado o valor
informado na
Declaração da
Operação de Transporte
DE
48
POLICARD SYSTEMS E SERVIÇOS S/A
UBERLÂNDIA – MG
01/02/2011
Manual Integração Serviços
POLIFRETE
NORMA
CÓDIGO
EMISSÃO
RESPONSÁVEL
Alisson Freitas
VERSÃO
002
N14
Seguro
Valor Seguro
E
N09
N
0-1
N15
OutrosValores
Grupo de Informações
de Outros Valores
G
N03
-
0-1
( x ) Nova
( ) Alteração
DTI - 001
8
2
N16
ICMS
Valor ICMS
E
N15
N
1-1
8
2
N17
ISSQN
Valor ISSQN
E
N15
N
1-1
8
2
N18
Signature
XML
G
N01
-
1-1
-
-
PAG
37
Se a Operação de
Transporte for Viagem
TAC-Agregado, informar
o valor do Seguro. Caso
esta TAG não for
informada será
considerado o valor
informado na
Declaração da
Operação de Transporte
Se a Operação de
Transporte for Viagem
TAC-Agregado, informar
o valor do ICMS. Caso
esta TAG não for
informada será
considerado o valor
informado na
Declaração da
Operação de Transporte
Se a Operação de
Transporte for Viagem
TAC-Agregado, informar
o valor do ISSQN. Caso
esta TAG não for
informada será
considerado o valor
informado na
Declaração da
Operação de Transporte
Assinatura Digital do
documento XML, a
assinatura deverá ser
aplicada no elemento
InfQuitacao
4.28. Leiaute Mensagem de Retorno
Retorno: Estrutura XML com a mensagem do resultado da transmissão.
Campo
Descrição
Elem
Pai
Tipo
Ocor
Tam
Dec
O01
RetQuitarOperTran
sp
Tag Raiz do Retorno da
Quitação da Operação
de Transporte
Raiz
-
-
1-1
-
-
O02
versao
O03
O04
#
A
O01
N
1-1
1-4
2
DadosQuitacao
versão do leiaute
Grupo das Informações
dos Valores da
Quitação
G
O01
-
0-1
-
-
PesoSaida
Peso de Saída
E
O03
N
0-1
7
2
Classificação da Informação: Normal, Monitorada, Restrita.
Observação
Tag Raiz
versão do leiaute
(mesma versão do
arquivo de schema xsd)
Peso de Saída que foi
registrado a Operação
DE
48
POLICARD SYSTEMS E SERVIÇOS S/A
UBERLÂNDIA – MG
01/02/2011
Manual Integração Serviços
POLIFRETE
NORMA
CÓDIGO
EMISSÃO
RESPONSÁVEL
Alisson Freitas
VERSÃO
002
( x ) Nova
( ) Alteração
DTI - 001
PAG
38
de Transporte
O05
PesoChegada
Peso de Chegada
E
O03
N
0-1
7
2
G
O03
-
1-1
-
-
E
O06
N
1-1
8
2
O06
Creditos
O07
Rendimentos
Grupo de Informações
dos valores de Créditos
Valor de Rendimento do
Frete
O08
OutrosCreditos
Valor de Outros Créditos
E
O06
N
1-1
8
2
O09
Debitos
Grupo de Informações
dos valores de Débitos
G
O03
-
1-1
-
-
Peso de Chegada que
foi informado para
quitação
Valor de Rendimento do
Frete
Valor de Outros
Créditos
O10
Adiantamento
Valor Adiantamentos
E
O09
N
1-1
8
2
Soma dos valores de
adiantamentos
registrados para a
Operação de Transporte
O11
Seguro
Valor Seguro
E
O09
N
1-1
8
2
Valor do Seguro
O12
INSS
Valor INSS
E
O09
N
1-1
8
2
Valor do INSS
O13
SestSenat
Valor Sest / Senat
E
O09
N
1-1
8
2
O14
ImpostoRenda
Valor Imposto de Renda
E
O09
N
1-1
8
2
Valor do Sest / Senat
Valor do Imposto de
Renda
O15
OutrosDebitos
Valor Outros Débitos
E
O09
N
1-1
8
2
O16
QuebraAvaria
Valor Quebra / Avaria
E
O09
N
1-1
8
2
Valor de Outros Débitos
Valor calculado de
Quebra / Avaria
O17
OutrosDescontos
Valor Outros Descontos
E
O09
N
1-1
8
2
Valor calculado de
Outros Descontos
O18
OutrosValores
Grupo de Informações
de Outros Valores
E
O03
N
1-1
-
-
O19
ICMS
Valor ICMS
E
O09
N
1-1
8
2
Valor do ICMS
O20
ISSQN
Valor ISSQN
E
O09
N
1-1
8
2
Valor do ISSQN
O21
Pedagio
Valor Pedagio
E
O09
N
1-1
8
2
O22
TotalReceber
Total a Receber
E
O03
N
1-1
8
2
O23
Sucesso
Identificador de Sucesso
E
O01
B
1-1
-
-
O24
Excecao
Grupo das informações
da falha na solicitação
do serviço
G
O01
-
0-1
-
-
Valor do Pedágio
Total creditado para o
Transportador referente
a quitação
True = Sucesso na
solicitação, False =
Falha na solicitação
Grupo que contém as
informações da falha
ocorrida na solicitação
do serviço
O25
Codigo
Código do Erro
E
O24
S
1-1
6
-
Código do erro
O26
Mensagem
Mensagem do Erro
E
O24
S
1-1
1-N
-
Mensagem do erro
4.29. Serviço de Adicionar Adiantamento
Classificação da Informação: Normal, Monitorada, Restrita.
DE
48
POLICARD SYSTEMS E SERVIÇOS S/A
UBERLÂNDIA – MG
RESPONSÁVEL
Alisson Freitas
VERSÃO
002
( x ) Nova
( ) Alteração
DTI - 001
01/02/2011
Manual Integração Serviços
POLIFRETE
NORMA
CÓDIGO
EMISSÃO
PAG
39
O Serviço de Adicionar Adiantamento é oferecido para a realização de créditos
de adiantamento de frete para o transportador referente a uma operação de
transporte que ainda não foi quitada.
O valor do adiantamento será liberado no mesmo momento para o cartão do
Transportador vinculado a operação de transporte, sendo necessário que a
transportadora possua o valor do crédito do adiantamento em sua conta.
4.30. WebService – Serviço de Adicionar Adiantamento
Função: Adicionar Adiantamento de Frete e creditar o valor para o
Transportador.
Processo: Síncrono
Método: AdicionarAdiantamento
4.31. Leiaute Mensagem de Entrada
Campo
Descrição
Elem
Pai
Tipo
Ocor
Tam
Dec
P01
AdicionarAdiantam
ento
Tag Raiz do
Adiantamento
Raiz
-
-
1-1
-
-
P02
versao
versão do leiaute
A
P01
N
1-1
1-4
2
InfAdiantamento
Grupo de Informações
do Adiantamento
G
P01
-
1-1
-
-
#
P03
P04
Id
P05
CodigoIdentificacao
Operacao
P06
Valor
A
P03
N
1-1
16
-
Código Identificador da
Operação de Transporte
E
P03
N
1-1
16
-
Valor do Adiantamento
E
P03
N
1-1
8
2
-
-
P07
Observacao
Observação
E
P03
S
1-1
1255
P08
Signature
XML
G
P01
-
1-1
-
4.32. Leiaute Mensagem de Retorno
Classificação da Informação: Normal, Monitorada, Restrita.
Observação
Tag Raiz
versão do leiaute
(mesma versão do
arquivo de schema xsd)
Informar o Código
Identificador da
Operação de Transporte
Código Identificador da
operação de transporte
mais o código verificador
Informar o valor do
adiantamento
Informar a observação
para o adiantamento
Assinatura Digital do
documento XML, a
assinatura deverá ser
aplicada no elemento
InfAdiantamento
DE
48
POLICARD SYSTEMS E SERVIÇOS S/A
UBERLÂNDIA – MG
01/02/2011
Manual Integração Serviços
POLIFRETE
NORMA
CÓDIGO
EMISSÃO
RESPONSÁVEL
Alisson Freitas
VERSÃO
002
( x ) Nova
( ) Alteração
DTI - 001
PAG
40
Retorno: Estrutura XML com a mensagem do resultado da transmissão.
Campo
Descrição
Elem
Pai
Tipo
Ocor
Tam
Dec
Q01
AdicionarAdiantam
ento
Tag Raiz do
Adiantamento
Raiz
-
-
1-1
-
-
Q02
versao
versão do leiaute
A
Q01
N
1-1
1-4
2
Q03
Sucesso
Identificador de Sucesso
E
Q01
B
1-1
-
-
Q04
Excecao
Grupo das informações
da falha na solicitação
do serviço
G
Q01
-
0-1
-
-
Tag Raiz
versão do leiaute
(mesma versão do
arquivo de schema xsd)
True = Sucesso na
solicitação, False =
Falha na solicitação
Grupo que contém as
informações da falha
ocorrida na solicitação
do serviço
Q05
Codigo
Código do Erro
E
Q04
S
1-1
6
-
Código do erro
Q06
Mensagem
Mensagem do Erro
E
Q04
S
1-1
1-N
-
Mensagem do erro
#
Observação
4.33. Serviço de Cancelamento da Operação de Transporte
O Serviço de Cancelamento da Operação de Transporte é oferecido pela
Policard para Cancelar uma determinada operação de transporte na ANTT,
desde que ela ainda não tenha sido realizada.
Só será permitido o cancelamento das operações de transporte que não
tenham sido consultadas pela fiscalização da ANTT (supõe-se que a operação
de transporte consultada, o serviço de transporte tenha sido realizado conforme
contratado ou em parte) e que estejam dentro do prazo de cancelamento.
Para as operações de transporte padrão, o cancelamento pode ser feito no
prazo informado como limite para realização da operação de transporte(data
prevista para término) mais uma folga de 20%. As frações de dias serão
sempre arredondadas para cima.
Para as operações de transporte TAC-Agregado, o cancelamento pode ser
feito em até 5 dias corridos a partir da data de emissão da declaração,
contando esta data como o primeiro dia.
Informamos que esta operação de cancelamento de CIOT é de Inteira
responsabilidade da TRANSPORTADORA contratante.
Assim, cientificamos que ao efetivar o cancelamento do CIOT ocorrerá o
debito/estorno dos valores ainda remanescentes no Cartão POLIFRETE (saldo)
contratados para a realização do FRETE.
Classificação da Informação: Normal, Monitorada, Restrita.
DE
48
POLICARD SYSTEMS E SERVIÇOS S/A
UBERLÂNDIA – MG
( x ) Nova
( ) Alteração
DTI - 001
01/02/2011
Manual Integração Serviços
POLIFRETE
NORMA
CÓDIGO
EMISSÃO
RESPONSÁVEL
Alisson Freitas
VERSÃO
002
PAG
DE
41
48
Esclarecemos que a operação de cancelamento do CIOT é de inteira
responsabilidade da TRANSPORTADORA e, somente será acatada após a
leitura e aceitação do presente Termo de Cancelamento.
Lembramos ainda que caso seja insuficiente o saldo do POLIFRETE do TAC
para realizar o débito/estorno do frete contrato (CIOT) junto o TAC, inexistirá
qualquer responsabilidade ou obrigação da POLICARD quanto ao pagamento
do saldo devedor ou diferença de valores.
Neste caso, caberá a TRASPORTADORA cobrar diretamente do TAC qualquer
valor contratado, inexistindo qualquer espécie de obrigação por parte da
POLICARD.
4.34. WebService – Serviço de Cancelamento da Operação de
Transpote
Função: Cancelar uma determinada operação de transporte, desde que a
mesma não tenha sido realizada.
Processo: Síncrono
Método: CancelarOperTransp
4.35. Leiaute Mensagem de Entrada
Campo
Descrição
Elem
Pai
Tipo
Ocor
Tam
Dec
R01
CancelarOperTransp
Tag Raiz do
Cancelamento
Raiz
-
-
1-1
-
-
R02
versao
A
R01
N
1-1
1-4
2
R03
InfCanc
G
R01
-
1-1
-
-
#
R04
Id
R05
CodigoIdentificacaoOper
acao
R06
MotivoCancelamento
versão do leiaute
Grupo de informações
do cancelamento da
operação de
transporte
Código Identificador da
Operação de Transporte
Motivo do
Cancelamento
A
R03
N
1-1
16
-
E
R03
N
1-1
-
E
R03
S
1-1
16
1255
Classificação da Informação: Normal, Monitorada, Restrita.
-
Observação
Tag Raiz
versão do leiaute
(mesma versão do
arquivo de schema xsd)
Informar o Código
Identificador da
Operação de
Transporte
Código Identificador da
operação de transporte
mais o código
verificador
Informar o motivo do
cancelamento
POLICARD SYSTEMS E SERVIÇOS S/A
UBERLÂNDIA – MG
RESPONSÁVEL
Alisson Freitas
VERSÃO
002
R07
Signature
XML
G
R01
-
( x ) Nova
( ) Alteração
DTI - 001
01/02/2011
Manual Integração Serviços
POLIFRETE
NORMA
CÓDIGO
EMISSÃO
1-1
-
-
PAG
DE
42
48
Assinatura Digital do
documento XML, a
assinatura deverá ser
aplicada no elemento
InfCanc
4.36. Leiaute Leiaute Mensagem de Retorno
Retorno: Estrutura XML com a mensagem do resultado da transmissão.
Campo
Descrição
Elem
Pai
Tipo
Ocor
Tam
Dec
S01
RetCancelarOperTrans
p
Tag Raiz do Retorno
do Cancelamento
Raiz
-
-
1-1
-
-
S02
versao
versão do leiaute
A
S01
N
1-1
1-4
2
S03
DadosCancelamentoO
peracaoTransporte
Grupo de Informações
do Retorno do
Cancelamento
G
S01
-
0-1
-
-
S04
CodigoIdentificacaoOper
acao
Código Identificador da
Operação de Transporte
E
S03
N
1-1
16
-
Código Identificador da
operação de transporte
mais o código verificador
S05
DataCancelamento
Data do Cancelamento
E
S03
DT
1-1
-
-
Data do Cancelamento
retornada pela ANTT
S06
ProtocoloCancelamento
Protocolo do
Cancelamento
E
S03
S
1-1
15
-
S07
TotalEstornado
Total dos Lancamentos
Estornados
S03
N
1-1
8
2
S08
DiferencaTAC
Valor da Diferença que
o TAC ficou devendo
S03
N
1-1
8
2
S09
MensagemAviso
Mensagem de Aviso
E
S03
S
0-1
15000
-
S10
Sucesso
E
S01
B
1-1
-
-
S11
Excecao
Identificador de Sucesso
Grupo
das
informações da falha
na
solicitação
do
serviço
G
S01
-
0-1
-
-
Protocolo do Cancelamento
retornado pela ANTT
Total dos lançamentos
estornados para a
Transportadora
Valor da diferença que o
TAC ficou devendo no
estorno
Mensagem de Aviso da
Policard para a
Transportara
True = Sucesso na
solicitação, False = Falha
na solicitação
Grupo que contém as
informações da falha
ocorrida na solicitação do
serviço
S12
Codigo
Código do Erro
E
S11
S
1-1
6
-
Código do erro
S13
Mensagem
Mensagem do Erro
E
S11
S
1-1
1-N
-
Mensagem do erro
#
Classificação da Informação: Normal, Monitorada, Restrita.
Observação
Tag Raiz
versão do leiaute (mesma
versão do arquivo de
schema xsd)
POLICARD SYSTEMS E SERVIÇOS S/A
UBERLÂNDIA – MG
EMISSÃO
Manual Integração Serviços
POLIFRETE
01/02/2011
VERSÃO
002
CÓDIGO
NORMA
( x ) Nova
( ) Alteração
DTI - 001
RESPONSÁVEL
Alisson Freitas
PAG
43
5. Acessos ao Ambiente Policard
Para a utilização do sistema PoliFrete, no ambiente de homologação da Policard, com
o objetivo de conceder acesso restrito e controlado a Transportadora/Empresa
Software, para a realização do desenvolvimento e homologação da integração de
sistemas, serão utilizados os seguintes dados de acesso:
EntCodigo: 99999
(Será criado após cadastro da transportadora ou empresa de Software)
ChaveAutenticacao:TG99999 Será criado após cadastro da transportadora ou
empresa de Software).
URL: https://hml.policard.com.br/wspef/ServicosTransportadora.asmx
Obs: O certificado digital (ICP-Brasil, tipo A1 ou A3) utilizado para assinatura e
transmissão durante o processo de homologação deverá estar alinhado com um CNPJ
cadastrado na base de homologação da Policard. A empresa de software, responsável
pelo desenvolvimento, poderá utilizar seu próprio certificado, caso possua. Neste caso
deverá ser cadastrado no ambiente de homologação da Policard o CNPJ
correspondente. Caso não possua, deverá utilizar o certificado da própria
transportadora.
6. Instalação Certificado Raiz – Guia de Instalação
O guia de instalação tem por objetivo auxiliar nos procedimentos/passos necessários
para a correta instalação do certificado da Policard, nos servidores da Transportadora
(máquina que acessará o Web Service Policard), estabelecendo assim uma relação de
confiança entre as partes, garantindo que toda a comunicação aconteça criptografada
e dentro dos padrões de segurança exigidos para aplicações web.
Classificação da Informação: Normal, Monitorada, Restrita.
DE
48
POLICARD SYSTEMS E SERVIÇOS S/A
UBERLÂNDIA – MG
EMISSÃO
Manual Integração Serviços
POLIFRETE
01/02/2011
VERSÃO
002
CÓDIGO
NORMA
( x ) Nova
( ) Alteração
DTI - 001
RESPONSÁVEL
Alisson Freitas
PAG
44
O certificado será enviado para as Transportadoras em um arquivo compactado com o
nome Certificado_Policard.zip. O arquivo de certificado está dentro deste arquivo
compactado, e possui o nome de Certificado_servidor.
As imagens contidas neste guia que ilustram o passo a passo para a instalação do
certificado foram retiradas da instalação do certificado em um servidor web com o
sistema operacional em inglês.
6.1.
Procedimentos para Instalação Certificado
Utilizando qualquer programa para descompactação de arquivos, extraia o arquivo
Certificado_Policard.zip de dentro do arquivo compactado, salvando este em um
diretório qualquer no servidor onde ele será instalado. Após isso realizar os passos
abaixo:
a) Abra o diretório onde o arquivo do certificado foi salvo. Clique com o botão direito do
mouse sobre o arquivo e escolha a opção Install Certificate;
Classificação da Informação: Normal, Monitorada, Restrita.
DE
48
POLICARD SYSTEMS E SERVIÇOS S/A
UBERLÂNDIA – MG
EMISSÃO
Manual Integração Serviços
POLIFRETE
01/02/2011
VERSÃO
002
CÓDIGO
NORMA
( x ) Nova
( ) Alteração
DTI - 001
RESPONSÁVEL
Alisson Freitas
PAG
45
b) Será aberta a tela de início do processo de instalação, clique sobre o botão Next;
c) Na tela de Certificate Import Wizard, escolha a opção Place all certificates in the
following store;
Classificação da Informação: Normal, Monitorada, Restrita.
DE
48
POLICARD SYSTEMS E SERVIÇOS S/A
UBERLÂNDIA – MG
EMISSÃO
Manual Integração Serviços
POLIFRETE
01/02/2011
VERSÃO
002
CÓDIGO
NORMA
( x ) Nova
( ) Alteração
DTI - 001
RESPONSÁVEL
Alisson Freitas
PAG
46
d) Na tela Select Certificate Store, escolha a opção Trusted Root Certification
Authorities e clique no botão OK.
e) Na tela Certificate Import Wizard, escolha a opção Place all certificates in the
following store; em seguida clique no botão Next;
f) Será exibida uma tela de aviso, Security Warning, clique sobre o botão Yes;
Classificação da Informação: Normal, Monitorada, Restrita.
DE
48
POLICARD SYSTEMS E SERVIÇOS S/A
UBERLÂNDIA – MG
EMISSÃO
Manual Integração Serviços
POLIFRETE
01/02/2011
VERSÃO
002
CÓDIGO
NORMA
( x ) Nova
( ) Alteração
DTI - 001
RESPONSÁVEL
Alisson Freitas
PAG
47
g) Será exibido um novo aviso, clique sobre o botão Yes;
h) Será exibido o aviso The import was successful, clique no botão OK, o processo
será concluído.
Classificação da Informação: Normal, Monitorada, Restrita.
DE
48
POLICARD SYSTEMS E SERVIÇOS S/A
UBERLÂNDIA – MG
EMISSÃO
Manual Integração Serviços
POLIFRETE
01/02/2011
VERSÃO
002
7.
NORMA
CÓDIGO
( x ) Nova
( ) Alteração
DTI - 001
RESPONSÁVEL
Alisson Freitas
PAG
48
Endereços dos WebServices PoliFrete
Ambiente
Produção
Homologação
Endereço
https://wss.policard.com.br/wspef/ServicosTransportadora.asmx
https://hml.policard.com.br/wspef/ServicosTransportadora.asmx
Status
Ativo
Ativo
8. Equipe Policard - Suporte
Nome
Policard - Peter Silva – Gerente TI
Policard - Alisson Freitas – Coordenador TI
Policard - Carlos Eduardo – Analista Sistemas
Policard - Hélio Júnior – Analista Sistemas
Email
[email protected]
[email protected]
[email protected]
[email protected]
Classificação da Informação: Normal, Monitorada, Restrita.
Fone
34-3233-3479
34-3233-3451
34-3233-3452
34-3233-3452
DE
48