EMISSÃO 01/02/2011 VERSÃO 002

Transcrição

1 HISTÓRICO DE VERSÕES INFORMAÇÕES GERAIS Propósito Público Alvo Definições, Acrônimos e Abreviações Referências PADRÕES TÉCNICOS Visão Conceitual Padrão de Documento XML Padrão de Comunicação Padrão de Certificado Digital Padrão de Assinatura Digital Validação da Estrutura XML das Mensagens do Web Service WEB SERVICE Serviço de Declaração de Operação de Transporte WebService Serviço de Declaração de Operação de Transporte Leiaute Mensagem de Entrada Leiaute Mensagem de Retorno Serviço de Retificação da Operação de Transporte WebService Serviço de Retificação da Operação de Transporte Leiaute Mensagem de Entrada Leiaute Mensagem de Retorno Serviço de Encerramento da Operação de Transporte WebService Serviço de Encerramento da Operação de Transporte Leiaute Mensagem de Entrada Leiaute Mensagem de Retorno Serviço de Consulta do Extrato da Conta WebService Serviço de Consulta do Extrato da Conta Leiaute Mensagem de Entrada... 30

2 Leiaute Mensagem de Retorno Serviço de Consulta do Código Verificador ANTT WebService Serviço de Consulta do Código Verificador ANTT Leiaute Mensagem de Entrada Leiaute Mensagem de Retorno Serviço de Cálculo da Quitação WebService Serviço de Cálculo da Quitação Leiaute Mensagem de Entrada Leiaute Mensagem de Retorno Serviço de Quitação da Operação de Transporte WebService Serviço de Quitação da Operação de Transporte Leiaute Mensagem de Entrada Leiaute Mensagem de Retorno Serviço de Adicionar Adiantamento WebService Serviço de Adicionar Adiantamento Leiaute Mensagem de Entrada Leiaute Mensagem de Retorno Serviço de Cancelamento da Operação de Transporte WebService Serviço de Cancelamento da Operação de Transpote Leiaute Mensagem de Entrada Leiaute Leiaute Mensagem de Retorno ACESSOS AO AMBIENTE POLICARD INSTALAÇÃO CERTIFICADO RAIZ GUIA DE INSTALAÇÃO Procedimentos para Instalação Certificado ENDEREÇOS DOS WEBSERVICES EQUIPE POLICARD - SUPORTE... 48

3 Histórico de Versões Histórico de Versões Versão Data Descrição Autor Revisor/Aprovador /02/2012 Criação do documento. Jackson Ramos José Júnior /05/2012 Atualização documento com versão de integração ANTT /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; 2. Informações Gerais 2.1. Propósito Jackson Ramos Jackson Ramos José Júnior Carlos Eduardo José Júnior Hélio Júnior Carlos Eduardo 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 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.

4 Definições, Acrônimos e Abreviações. Termo ANTT TAC RNTRC ETC CTRC CTC Descrição 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. Referências N/A. 3. Padrões Técnicos 3.1. Visão Conceitual Clientes Policard (Contratante) Serviços Policard Estação do Cliente Solicitação DeclararOperTransp RetificarOperTransp CancelarOperTransp EncerrarOperTransp ConsultarExtratoConta AdicionarAdiantamento ConsultarCodigoVerifica dor CalcularQuitacao QuitarOperTransp WebService Serviços Pagamento Eletrônico de Frete Solicitação DeclararOperacaoTransporte RetificarOperacaoTransporte CancelarOperacaoTransporte EncerrarOperacaoTransporte ConsultarFrotaTransportador ConsultarSituacaoTransporta dor Retorno WebService Retorno Aplicação Aplicação Aplicação SOAP

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 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=" A declaração namespace da assinatura digital deverá ser realizada na própria tag <Signature>, conforme exemplo abaixo. <OperacaoTransporte versao="2.00" xmlns=" <InfFrete Id="1"> <Signature xmlns=" </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

6 6 48 de Transporte e as demais mensagens XML para validação pelo Schema do XML (XSD XML Schema Definition), disponibilizado pela Policard 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: Content-Type: application/soap+xml; charset=utf-8 Content-Length: length <?xml version="1.0" encoding="utf-8"?> <soap12:envelope xmlns:xsi=" xmlns:xsd=" xmlns:soap12=" <soap12:header> <Header xmlns="

7 7 48 <EntCodigo>int</EntCodigo> <ChaveAutenticacao>string</ChaveAutenticacao> </Header> </soap12:header> <soap12:body> <DeclararOperTransp xmlns=" 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= 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.

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 que tem o seguinte leiaute: Schema XML: xmldsig-core-schema_v1.01.xsd # Campo Elem Pai Tipo Ocor Tam Dec Observação XS01 Signature Raiz XS02 SignedInfo G XS XS03 CanonicalizationMethod G XS Grupo da Informação da assinatura Grupo do Método de Canonicalização

9 9 48 XS04 Algorithm A XS03 S XS05 SignatureMethod G XS Atributo Algorithm de CanonicalizationMethod: EC-xml-c14n Grupo do Método de Assinatura XS06 Algorithm A XS05 S Atributo Algorithm de SignatureMethod: mldsig#rsa-sha1 XS07 Reference G XS Grupo Reference XS08 URI A XS07 S Atributo URI da tag Reference XS09 Transforms G XS Grupo do algorithm de Transform XS10 Transform G XS Grupo de Transform XS11 Algorithm A XS10 S XS12 XPath E XS10 S 0-N - - XPath Atributos válidos Algorithm do Transform: EC-xml-c14n mldsig#enveloped-signature XS13 DigestMethod G XS XS14 Algorithm A XS13 S Grupo do Método de DigestMethod Atributo Algorithm de DigestMethod: mldsig#sha1 XS15 DigestValue E XS07 S Digest Value (Hash SHA-1 Base64) XS16 SignatureValue G XS Grupo do Signature Value XS17 KeyInfo G XS Grupo do KeyInfo XS18 X509Data G XS Grupo X509 XS19 X509Certificate E XS18 S Certificado Digital x509 em Base64

10 10 48 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=" <InfFrete Id="1"> <Numero>1</Numero> </InfFrete> <Signature> <SignedInfo> <CanonicalizationMethod Algorithm=" <SignatureMethod Algorithm=" /> <Reference URI="#1"> <Transforms> <Transform Algorithm=" <Transform Algorithm=" </Transforms> <DigestMethod Algorithm=" <DigestValue>vFL68WETQ+mvj1aJAMDx+oVi928=</DigestValue> </Reference> </SignedInfo> <SignatureValue>IhXNhbdL1F9UGb2ydVc5v/gTB/y6r0KIFaf5evUi1i...</SignatureValue> <KeyInfo> <X509Data> <X509Certificate>MIIFazCCBFOgAwIBAgIQaHEfNaxSeOEvZGlVDANB... </X509Certificate> </X509Data> </KeyInfo> </Signature> </OperacaoTransporte>

11 11 48 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 ( b) Certificado digital: Emitido por AC credenciada no ICP-Brasil ( 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 ( g) Função de message digest : SHA-1 ( h) Codificação: 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 (

12 12 48 (2) C14N ( 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/ Ativo 1.00 RetDeclararOperTransp_v1.00.xsd 27/08/ Ativo

13 tiposbasicos_v1.00.xsd 27/08/ Ativo 1.01 xmldsig-core-schema_v1.01.xsd 27/08/ Ativo 1.00 ConsultarCodigoVerificador_v1.00.xsd 27/08/ Ativo 1.00 RetConsultarCodigoVerificador_v1.00.xsd 27/08/ Ativo 1.00 ConsultarExtratoConta_v1.00.xsd 27/08/ Ativo 1.00 RetConsultarExtratoConta_v1.00.xsd 27/08/ Ativo 2.00 EncerrarOperTransp_v2.00.xsd 27/08/ Ativo 2.00 RetEncerrarOperTransp_v2.00.xsd 27/08/ Ativo 2.00 RetificarOperTransp_v2.00.xsd 27/08/ Ativo 2.00 RetRetificarOperTransp_v2.00.xsd 27/08/ Ativo 1.00 AdicionarAdiantamento_v1.00.xsd 27/08/ Ativo 1.00 CalcularQuitacao_v1.00.xsd 27/08/ Ativo 1.01 CancelarOperTransp_v1.01.xsd 27/08/ Ativo 1.00 QuitarOperTransp_v1.00.xsd 27/08/ Ativo 1.00 RetAdicionarAdiantamento_v1.00.xsd 27/08/ Ativo 1.00 RetCalcularQuitacao_v1.00.xsd 27/08/ Ativo 1.01 RetCancelarOperTransp_v1.01.xsd 27/08/ Ativo 1.00 RetQuitarOperTransp_v1.00.xsd 27/08/ 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:

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

15 15 48 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 /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.

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

17 17 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 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 Observação A01 OperacaoTransporte Tag Raiz da Operação de Transporte Raiz Tag Raiz A02 versao versão do leiaute A A01 N versão do leiaute (mesma versão do arquivo de schema xsd) A03 InfFrete Grupo das informações do Frete G A A04 Id A A03 N informações do Frete Informar o número de controle do frete

18 18 48 informado no campo A05 A05 Numero Número de controle da transportadora E A03 S A06 NumeroNotaFiscal Número da Nota Fiscal E A03 S A07 EspecieMercadoria Espécie da Mercadoria E A03 S A08 PesoVolume Peso ou Volume E A03 S A09 QuantidadeSaida Quantidade em Quilos ou em Volume E A03 N A10 CalculaPerda Tipo do cálculo da perda E A03 S A11 ValorTonelada Valor da Tonelada E A03 N A12 PerTolerancia Percentual de Tolerância da perda E A03 N A13 DescTotalPerda Desconta Total da Perda E A03 S 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 Tipo do cálculo da perda (S = Saída, C = Chegada) 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 A14 DataInicioViagem Data de Início da Viagem E A03 D Formato: AAAA-MM-DD A15 DataFimViagem Data de Previsão de Término da Viagem E A03 D Formato: AAAA-MM-DD A16 TipoViagem Tipo de Viagem E A03 N A17 A18 CodMunicipioOrigem CodMunicipioDestino Código do Município de Origem E A03 N Código do Município de Destino E A03 N A19 CodNatureza Código da Natureza E A03 N A20 KMFrete Quantidade de quilômetros do Frete E A03 N = Viagem Padrão, 3 = Viagem TAC-Agregado 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 Informar a distância em KM do frete A21 ContataSeguro Contrata Seguro Policard E A03 S S = Sim, N = Não A22 PermiteTransQuitar Permite somente a Transportadora Quitar E A03 S S = Sim, N = Não

19 19 48 A23 PermiteDestQuitar Permite Destinatário Quitar E A03 S S = Sim, N = Não A24 CpfRespQuitacao CPF do Responsável pela Quitação E A03 S A25 SenhaQuitacao Senha de Quitação E A03 S A26 Contratado Grupo das informações do Contratado G A A27 NumeroCartao Número do Cartão PoliFrete E A26 N A28 RNTRC Número do RNTRC E A26 N A29 CpfCnpj CPF ou Cnpj do Contratado E A26 N A30 A31 Nome Endereco Nome ou Razão Social do Contratado E A26 S Grupo das informações do endereço do Contratado G A A32 Logradouro Logradouro do endereço E A31 S A33 Numero Número E A31 S A34 Complemento Complemento E A31 S A35 Bairro Nome do Bairro E A31 S A36 Cep Número do CEP E A31 N A37 CodMunicipio Código do Município E A31 N A38 Telefone Telefone Residencial E A26 S A39 TelefoneCelular Telefone Celular E A26 S A40 TelefoneComercial Telefone Comercial E A26 S A41 VeiculoTransporte Grupo das informações do Veiculo de Transporte G A A42 Placa Placa do veículo E A41 S 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 informações do contratado Informar o número do cartão polifrete do contratado Informar o RNTRC do contratado Informar o CPF ou CNPJ do Contratado Informar o Nome ou Razão Social do Contratado informações do endereço do Contratado Informar o logradouro do endereço do contratado Informar o número do logradouro 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 informações do veículo de transporte Informar a placa do veículo

20 20 48 A43 RNTRC Número do RNTRC E A41 N A44 A45 A46 A47 Destinatario CpfCnpj Nome Endereco Grupo das informações do Destinatário G A CPF ou Cnpj do Destinatário E A44 N Nome ou Razão Social do Destinatário E A44 S Grupo das informações do endereço do Destinatário G A A48 Logradouro Logradouro do endereço E A47 S A49 Numero Número E A47 S A50 Complemento Complemento E A47 S A51 Bairro Nome do Bairro E A47 S A52 Cep Número do CEP E A47 N A53 CodMunicipio Código do Município E A47 N A54 A55 A56 A57 Consignatario CpfCnpj Nome Endereco Grupo das informações do Consignatário G A CPF ou CNPJ do Consignatário E A54 N Nome ou Razão Social do Consignatário E A54 S Grupo das informações do endereço do Consignatário G A A58 Logradouro Logradouro do endereço E A57 S A59 Numero Número E A57 S A60 Complemento Complemento E A57 S A61 Bairro Nome do Bairro E A57 S A62 Cep Número do CEP E A57 N Informar o número do RNTRC do Transportador que possui o veículo em sua frota informações do Destinatário Informar o CPF ou CNPJ do Destinatário Informar o Nome ou Razão Social do Destinatário informações do endereço do Destinatário Informar o logradouro do endereço do destinatário Informar o número do logradouro do destinatário 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 informações do Consignatário Informar o CPF ou CNPJ do Consignatário Informar o Nome ou Razão Social do Consignatário 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

21 21 48 A63 CodMunicipio Código do Município E A57 N A64 A65 A66 A67 SubContratante CpfCnpj Nome Endereco Grupo das informações do Consignatário G A CPF ou CNPJ do Consignatário E A64 N Nome ou Razão Social do Consignatário E A64 S Grupo das informações do endereço do Subcontratante G A A68 Logradouro Logradouro do endereço E A67 S A69 Numero Número E A67 S A70 Complemento Complemento E A67 S A71 Bairro Nome do Bairro E A67 S A72 Cep Número do CEP E A67 N A73 CodMunicipio Código do Município E A67 N A74 A75 Valores Rendimentos Grupo das informações dos Valores do Frete G A Valor do rendimento a ser pago para o contratado E A74 N A76 Pedagio Valor do Pedágio E A74 N A77 OutrosCreditos Outros Créditos E A74 N Informar o código IBGE do município do consignatário informações do Subcontratante Informar o CPF ou CNPJ do Subcontratante Informar o Nome ou Razão Social do Subcontratante 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 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

22 22 48 A78 Adiantamento Valor de Adiantamento E A74 N A79 INSS Valor do INSS E A74 N A80 SestSenat Valor Sest/Senat E A74 N A81 IR Valor do Imposto de Renda E A74 N A82 Seguro Valor do Seguro da Carga E A74 N A83 OutrosDebitos Outros Débitos E A74 N A84 ValorMercadoria Valor da Mercadoria E A74 N A85 ValorCombustivel Valor de Combustível E A74 N A86 ValorCTRC Valor do CTRC E A74 N A87 ISSQN Valor do ISSQN E A74 N A88 ICMS Valor do ICMS E A74 N 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

23 23 48 A89 Signature XML G A Assinatura Digital do documento XML, a assinatura deverá ser aplicada no elemento InfFrete 4.4. Leiaute Mensagem de Retorno Retorno: Estrutura XML com a mensagem do resultado da transmissão. # Campo Descrição Elem Pai Tipo Ocor Tam Dec Observação B01 RetDeclararOperTra nsp Tag Raiz do Retorno da Declaração da Operação de Transporte Raiz Tag Raiz B02 DataDeclaracao Data e Hora que foi registrada a declaração de transporte na ANTT E B01 DT 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 B04 CodigoVerificador Código Verificador E B01 N B05 AvisoTransportador Aviso ao Transportador E B01 S B06 Contingencia Modo Contingencia E B01 B B07 Sucesso Indicativo de sucesso E B01 B B08 Excecao Grupo das informações da falha na solicitação do serviço G B 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 informações da falha ocorrida na solicitação do serviço B09 Codigo Código do Erro E B08 S Código do erro B10 Mensagem Mensagem do Erro E B08 S N - Mensagem do erro

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

25 Leiaute Mensagem de Entrada Entrada: Estrutura XML com os dados da retificação da operação de transporte # Campo Descrição Elem Pai Tipo Ocor Tam Dec Observação Tag Raiz da Retificação da Operação de C01 RetificarOperTransp Transporte Raiz Tag Raiz C02 versao versão do leiaute A C01 N versão do leiaute (mesma versão do arquivo de schema xsd) C03 InfRet Grupo das informações da Retificação G C informações da Retificação da Operação de Transporte Informar o Código Identificador da Operação de Transporte informado C04 Id A C03 N C05 C06 CodigoIdentificacaoO peracao VeiculoTransporte Código Identificador da Operação de Transporte E C03 S Grupo das informações do Veiculo de Transporte G C C07 Placa Placa do Veículo E C06 S C08 RNTRC Número do RNTRC E C06 N C09 CodigoNaturezaCarg a Código da Natureza da Carga E C03 N no campo C05 Código Identificador da operação de transporte mais o código verificador 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 Formato: AAAA-MM-DD C11 C12 C13 DataFimViagem CodigoMunicipioOrige m CodigoMunicipioDesti no Data de Previsão de Término da Viagem E C03 D Formato: AAAA-MM-DD Código do Município de Origem E C03 N Código do Município de Destino E C03 N C14 Signature XML G C 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

26 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 Observação D01 D02 D03 D04 RetRetificarOperTra nsp DadosRetificacaoOp ertransp CodigoIdentificacaoO peracao DataRetificação Tag Raiz do Retorno da Retificação da Operação de Transporte Raiz Tag Raiz Grupo das informações dos dados do retorna da retificação G D Código Identificador da Operação de Transporte E D02 N Data e Hora da Retificação da Operação de Transporte E D02 DT D05 Sucesso Identificador de Sucesso E D01 B D06 Excecao Grupo das informações da falha na solicitação do serviço G D informações do Retorno da retificação de Transporte 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 informações da falha ocorrida na solicitação do serviço D07 Codigo Código do Erro E D06 S Código do erro D08 Mensagem Mensagem do Erro E D06 S N - Mensagem do erro 4.9. 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.

27 27 48 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: (código IBGE do município do Rio de Janeiro / RJ) Município de Destino: (código IBGE do município de São Paulo / SP) Natureza da Carga: 1201 (código do SH para Soja) Peso da Carga: (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.

28 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 Leiaute Mensagem de Entrada # Campo Descrição Elem Pai Tipo Ocor Tam Dec Observação Tag Raiz do Encerramento da Operação de E01 EncerrarOperTransp Transporte Raiz Tag Raiz E02 versao versão do leiaute A E01 N versão do leiaute (mesma versão do arquivo de schema xsd) Grupo das informações do informações do Encerramento da E03 InfEnc Encerramento G E Operação de Transporte E04 Id A E03 N Informar o Código Identificador da Operação de Transporte informado no campo E05 E05 CodigoIdentificacaoO peracao Código Identificador da Operação de Transporte E E03 S Código Identificador da operação de transporte mais o código verificador informações das viagens Grupo das realizadas na operação informaçoes das de transporte TAC- E06 ViagemOperTransp viagens G E03-0-N - - Agregado E07 E08 E09 CodigoMunicipioOrige m CodigoMunicipioDesti no CodigoNaturezaCarg a Código do município de origem E E06 N Código do município de destino E E06 N Código da Natureza da Carga E E06 N 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

29 29 48 E10 PesoCarga Peso da Carga E E06 N ,2 E11 QuantidadeViagens Quantidade de Viagens E E06 N E12 Signature XML G E 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 Leiaute Mensagem de Retorno Retorno: Estrutura XML com a mensagem do resultado da transmissão. # Campo Descrição Elem Pai Tipo Ocor Tam Dec Observação F01 F02 F03 RetEncerrarOperTra nsp DadosEncerramento OperacaoTransporte CodigoIdentificacaoO peracao Tag Raiz do Retorno do Encerramento da Operação de Transporte Raiz Tag Raiz Grupo das informaçoes do retorno do encerramento G F Código Identificador da Operação de Transporte E F02 N F04 DataEncerramento Data do Encerramento E F02 DT F05 ProtocoloEncerramen to Protocolo de Encerramento E F02 N F06 Sucesso Identificador de Sucesso E F01 B F07 Excecao Grupo das informações da falha na solicitação do serviço G F 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 Protocolo de Encerramento da Operação de Transporte True = Sucesso na solicitação, False = Falha na solicitação informações da falha ocorrida na solicitação do serviço F08 Codigo Código do Erro E F07 S Código do erro F09 Mensagem Mensagem do Erro E F07 S N - Mensagem do erro

30 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 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 Leiaute Mensagem de Entrada # Campo Descrição Elem Pai Tipo Ocor Tam Dec Observação G01 ConsultarExtratoCo nta Tag Raiz da Consulta do Extrato da Conta Raiz Tag Raiz G02 versao versão do leiaute A G01 N versão do leiaute (mesma versão do arquivo de schema xsd) Grupo das informações informações da da solicitação da solicitação da G03 InfExtrato Consulta do Extrato da Conta G G Conslulta do Extrato da Conta G04 DataInicio Data de Inicial do Período E G03 D Formato: AAAA-MM-DD G05 DataFim Data Final do Período E G03 D Formato: AAAA-MM-DD Leiaute Mensagem de Retorno Retorno: Estrutura XML com a mensagem do resultado da transmissão. # Campo Descrição Elem Pai Tipo Ocor Tam Dec Observação H01 H02 H03 RetConsultarExtrat oconta Extrato Lancamento Tag Raiz do Retorno da Consulta do Extrato da Conta Raiz Tag Raiz Grupo das informações do Extrato G H Grupo das informações do lançamento G H02-1-N - - informações do extrato da conta informações do lançamento

31 31 48 H04 Data Data do Lançamento E H03 D Data do lançamento da movimentação H05 Descricao Descrição do Lançamento E H03 S Descrição do Lançamento H06 Credito Valor de Crédito E H03 N ,2 H07 Debito Valor de Débito E H03 N ,2 Valor de Crédito referente ao lançamento Valor de Débito referente ao lançamento H08 Saldo Valor de Saldo E H03 N ,2 Valor do Saldo H09 Sucesso Identificador de Sucesso E H01 B Grupo das informações da falha na solicitação do H10 Excecao serviço G H H11 Codigo Código do Erro E H10 S Código do erro True = Sucesso na solicitação, False = Falha na solicitação informações da falha ocorrida na solicitação do serviço H12 Mensagem Mensagem do Erro E H10 S N - Mensagem do erro 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 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 Leiaute Mensagem de Entrada # Campo Descrição Elem Pai Tipo Ocor Tam Dec Observação I01 ConsultarCodigoVe rificador Tag Raiz da Consulta do Extrato da Conta Raiz Tag Raiz I02 versao versão do leiaute A I01 N versão do leiaute (mesma versão do arquivo de schema xsd) I03 CIOT Código Identificador da Operacao de Transporte E I01 N Código Identificador da Operação de Transporte.

32 Leiaute Mensagem de Retorno Retorno: Estrutura XML com a mensagem do resultado da transmissão. J01 J02 # Campo Descrição Elem Pai Tipo Ocor Tam Dec Observação RetConsultarCodig overificador CIOT Tag Raiz do Retorno da Consulta do Extrato da Conta Raiz Tag Raiz Código Identificador da Operacao de Transporte E J01 N J03 CodigoVerificador Código Verificador J J04 Sucesso Identificador de Sucesso E J01 B J05 Excecao Grupo das informações da falha na solicitação do serviço G J 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 informações da falha ocorrida na solicitação do serviço J06 Codigo Código do Erro E J05 S Código do erro J07 Mensagem Mensagem do Erro E J05 S N - Mensagem do erro 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 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 Leiaute Mensagem de Entrada L01 # Campo Descrição Elem Pai Tipo Ocor Tam Dec Observação CalcularQuitacao Tag Raiz do Calculo da Quitacao Raiz Tag Raiz

33 33 48 L02 versao versão do leiaute A L01 N L03 CodigoIdentificacao Operacao Código Identificador da Operacao de Transporte E L01 N L04 PesoChegada Peso de Chegada E L01 N L05 Creditos Grupo de Informações dos Valores de Créditos G L L06 OutrosCreditos Outros Créditos E L05 N L07 Debitos Grupo de Informações dos Valores de Débitos G L L08 OutrosCreditos Outros Débitos E L07 N L09 ImpostoRenda Valor Imposto de Renda E L07 N L10 SestSenat Valor Sest / Senat E L07 N L11 INSS Valor INSS E L07 N 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 TAC- Agregado, 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 TAC- Agregado, 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 TAC- Agregado, Viagem Padrão será considerado o valor informado na declaração da Operação de Transporte

34 34 48 L12 Seguro Valor Seguro E L07 N Informar o valor do Seguro a ser descontado do Transportador. Este valor será utilizado para cálculo da Viagem TAC- Agregado, Viagem Padrão será considerado o valor informado na declaração da Operação de Transporte Leiaute Mensagem de Retorno Retorno: Estrutura XML com a mensagem do resultado da transmissão. # Campo Descrição Elem Pai Tipo Ocor Tam Dec Observação M01 RetCalcularQuitaca o Tag Raiz do Retorno do Calculo da Quitacao Raiz Tag Raiz M02 versao versão do leiaute A M01 N versão do leiaute (mesma versão do arquivo de schema xsd) M03 Calculo Grupo das Informações do Resulto do Cálculo da Quitação G M M04 PesoSaida Peso de Saída E M03 N M05 PesoChegada Peso de Chegada E M03 N M06 M07 Creditos Rendimentos Grupo de Informações dos valores de Créditos G M Valor de Rendimento do Frete E M06 N M08 OutrosCreditos Valor de Outros Créditos E M06 N M09 Debitos Grupo de Informações dos valores de Débitos G M M10 Adiantamento Valor Adiantamentos E M09 N 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 Soma dos valores de adiantamentos registrados para a Operação de Transporte M11 Seguro Valor Seguro E M09 N Valor do Seguro M12 INSS Valor INSS E M09 N Valor do INSS M13 SestSenat Valor Sest / Senat E M09 N Valor do Sest / Senat Valor do Imposto de M14 ImpostoRenda Valor Imposto de Renda E M09 N Renda M15 OutrosDebitos Valor Outros Débitos E M09 N Valor de Outros Débitos Valor calculado de M16 QuebraAvaria Valor Quebra / Avaria E M09 N Quebra / Avaria

35 35 48 M17 OutrosDescontos Valor Outros Descontos E M09 N M18 OutrosValores Grupo de Informações de Outros Valores E M03 N Valor calculado de Outros Descontos M19 ICMS Valor ICMS E M09 N Valor do ICMS M20 ISSQN Valor ISSQN E M09 N Valor do ISSQN M21 Pedagio Valor Pedagio E M09 N Valor do Pedágio M22 TotalReceber Total a Receber E M03 N Total a Receber M23 Sucesso Identificador de Sucesso E M01 B True = Sucesso na solicitação, False = Falha na solicitação M24 Excecao Grupo das informações da falha na solicitação do serviço G M informações da falha ocorrida na solicitação do serviço M25 Codigo Código do Erro E M24 S Código do erro M26 Mensagem Mensagem do Erro E M24 S N - Mensagem do erro 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 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 Leiaute Mensagem de Entrada N01 # Campo Descrição Elem Pai Tipo Ocor Tam Dec Observação QuitarOperTransp Tag Raiz da Quitação da Operação de Transporte Raiz Tag Raiz

36 36 48 N02 versao versão do leiaute A N01 N Grupo de Informações dos Valores para N03 InfQuitacao Quitação G N N04 Id A N03 N N05 CodigoIdentificacao Operacao Código Identificador da Operação de Transporte E N03 S N06 PesoChegada Peso de Chegada E N03 N N07 Creditos Grupo de Informações dos Valores de Créditos G N N08 OutrosCreditos Valor Outros Créditos E N07 N N09 Debitos Grupo de Informações dos Valores de Débitos G N N10 OutrosDebitos Valor Outros Débitos E N09 N N11 ImpostoRenda Valor Imposto de Renda E N09 N N12 SestSenat Valor Sest / Senat E N09 N N13 INSS Valor INSS E N09 N 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

37 37 48 N14 Seguro Valor Seguro E N09 N N15 OutrosValores Grupo de Informações de Outros Valores G N N16 ICMS Valor ICMS E N15 N N17 ISSQN Valor ISSQN E N15 N N18 Signature XML G N 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 Leiaute Mensagem de Retorno Retorno: Estrutura XML com a mensagem do resultado da transmissão. O01 # Campo Descrição Elem Pai Tipo Ocor Tam Dec Observação RetQuitarOperTran sp Tag Raiz do Retorno da Quitação da Operação de Transporte Raiz Tag Raiz O02 versao versão do leiaute A O01 N Grupo das Informações dos Valores da O03 DadosQuitacao Quitação G O O04 PesoSaida Peso de Saída E O03 N versão do leiaute (mesma versão do arquivo de schema xsd) Peso de Saída que foi registrado a Operação

38 38 48 de Transporte O05 PesoChegada Peso de Chegada E O03 N O06 O07 Creditos Rendimentos Grupo de Informações dos valores de Créditos G O Valor de Rendimento do Frete E O06 N O08 OutrosCreditos Valor de Outros Créditos E O06 N O09 Debitos Grupo de Informações dos valores de Débitos G O O10 Adiantamento Valor Adiantamentos E O09 N Peso de Chegada que foi informado para quitação Valor de Rendimento do Frete Valor de Outros Créditos Soma dos valores de adiantamentos registrados para a Operação de Transporte O11 Seguro Valor Seguro E O09 N Valor do Seguro O12 INSS Valor INSS E O09 N Valor do INSS O13 SestSenat Valor Sest / Senat E O09 N Valor do Sest / Senat Valor do Imposto de O14 ImpostoRenda Valor Imposto de Renda E O09 N Renda O15 OutrosDebitos Valor Outros Débitos E O09 N Valor de Outros Débitos Valor calculado de O16 QuebraAvaria Valor Quebra / Avaria E O09 N Quebra / Avaria O17 OutrosDescontos Valor Outros Descontos E O09 N O18 OutrosValores Grupo de Informações de Outros Valores E O03 N Valor calculado de Outros Descontos O19 ICMS Valor ICMS E O09 N Valor do ICMS O20 ISSQN Valor ISSQN E O09 N Valor do ISSQN O21 Pedagio Valor Pedagio E O09 N Valor do Pedágio O22 TotalReceber Total a Receber E O03 N Total creditado para o Transportador referente a quitação O23 Sucesso Identificador de Sucesso E O01 B True = Sucesso na solicitação, False = Falha na solicitação O24 Excecao Grupo das informações da falha na solicitação do serviço G O informações da falha ocorrida na solicitação do serviço O25 Codigo Código do Erro E O24 S Código do erro O26 Mensagem Mensagem do Erro E O24 S N - Mensagem do erro Serviço de Adicionar Adiantamento

39 39 48 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 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 Leiaute Mensagem de Entrada # Campo Descrição Elem Pai Tipo Ocor Tam Dec Observação P01 AdicionarAdiantam ento Tag Raiz do Adiantamento Raiz Tag Raiz P02 versao versão do leiaute A P01 N versão do leiaute (mesma versão do arquivo de schema xsd) P03 InfAdiantamento Grupo de Informações do Adiantamento G P P04 Id A P03 N P05 CodigoIdentificacao Operacao Código Identificador da Operação de Transporte E P03 N P06 Valor Valor do Adiantamento E P03 N P07 Observacao Observação E P03 S P08 Signature XML G P 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 Leiaute Mensagem de Retorno

40 40 48 Retorno: Estrutura XML com a mensagem do resultado da transmissão. # Campo Descrição Elem Pai Tipo Ocor Tam Dec Observação Q01 AdicionarAdiantam ento Tag Raiz do Adiantamento Raiz Tag Raiz Q02 versao versão do leiaute A Q01 N versão do leiaute (mesma versão do arquivo de schema xsd) Q03 Sucesso Identificador de Sucesso E Q01 B True = Sucesso na solicitação, False = Falha na solicitação Q04 Excecao Grupo das informações da falha na solicitação do serviço G Q informações da falha ocorrida na solicitação do serviço Q05 Codigo Código do Erro E Q04 S Código do erro Q06 Mensagem Mensagem do Erro E Q04 S N - Mensagem do erro 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 (saldo) contratados para a realização do FRETE.

41 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 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 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 Leiaute Mensagem de Entrada R01 # Campo Descrição Elem Pai Tipo Ocor Tam Dec Observação CancelarOperTransp Tag Raiz do Cancelamento Raiz Tag Raiz R02 versao versão do leiaute A R01 N Grupo de informações do cancelamento da operação de R03 InfCanc transporte G R R04 Id A R03 N R05 R06 CodigoIdentificacaoOper acao MotivoCancelamento Código Identificador da Operação de Transporte E R03 N Motivo do 1- Cancelamento E R03 S 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

42 42 48 R07 Signature XML G R Assinatura Digital do documento XML, a assinatura deverá ser aplicada no elemento InfCanc 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 Observação S01 RetCancelarOperTrans p Tag Raiz do Retorno do Cancelamento Raiz Tag Raiz S02 versao versão do leiaute A S01 N versão do leiaute (mesma versão do arquivo de schema xsd) S03 S04 DadosCancelamentoO peracaotransporte CodigoIdentificacaoOper acao Grupo de Informações do Retorno do Cancelamento G S Código Identificador da Operação de Transporte E S03 N S05 DataCancelamento Data do Cancelamento E S03 DT S06 S07 S08 ProtocoloCancelamento TotalEstornado DiferencaTAC Protocolo do Cancelamento E S03 S Total dos Lancamentos Estornados S03 N Valor da Diferença que o TAC ficou devendo S03 N S09 MensagemAviso Mensagem de Aviso E S03 S S10 Sucesso Identificador de Sucesso E S01 B Grupo das informações da falha na solicitação do S11 Excecao serviço G S Código Identificador da operação de transporte mais o código verificador Data do Cancelamento retornada pela ANTT 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 informações da falha ocorrida na solicitação do serviço S12 Codigo Código do Erro E S11 S Código do erro S13 Mensagem Mensagem do Erro E S11 S N - Mensagem do erro

43 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: (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: 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.

44 44 48 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 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;

45 45 48 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;

46 46 48 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;

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