MANUAL INTEGRAÇÃO SAT X OP. CARTÕES
(Criou página com '==MANUAL== === === O Objetivo deste documento é mostrar como irá funcionar a integração SAT x Repom. Existe atualmente no SAT integração via webservice com as seguin...') |
|||
Linha 8: | Linha 8: | ||
Existe atualmente no SAT integração via webservice com as seguintes operadoras de cartão: | Existe atualmente no SAT integração via webservice com as seguintes operadoras de cartão: | ||
− | :Efrete | + | :'''Efrete''' |
− | :DBTrans | + | :'''DBTrans''' |
− | :Pamcard | + | :'''Pamcard''' |
− | :Repom | + | :'''Repom''' |
Linha 17: | Linha 17: | ||
E estamos realizando o desenvolvimento das integrações abaixo: | E estamos realizando o desenvolvimento das integrações abaixo: | ||
− | :NDDCargo | + | :'''NDDCargo''' |
− | :Policard | + | :'''Policard''' |
Linha 29: | Linha 29: | ||
− | |||
− | |||
− | |||
+ | 1) Os dados são enviados a operadora; | ||
− | |||
− | |||
+ | 2) Operadora faz as consistências necessárias e ou devolve os erros para o SAT ou prossegue enviando os dados para validação no webservice da ANTT que retorna a validação dos dados para operadora e esta retorna para o SAT; | ||
− | |||
− | |||
− | |||
+ | 3) O Ciot é gerado em conjunto com a operadora de cartão e a ANTT e quando está tudo certo no envio de dados do frete é retornado para o sat esta (e outras informações) que é gravado na viagem em questão. | ||
− | |||
− | |||
− | |||
− | O SAT não está obrigado a realizar TODOS os procedimentos das integrações, ele será APENAS | + | ===Fluxo de funcionamento=== |
− | um facilitador, ou seja, apenas irá enviar os cadastros às operadoras, a liberação de pagamento de | + | |
− | frete e alterações deverá ser feito diretamente no sistema web das operadoras, pois isto não será | + | |
− | feito pelo SAT. | + | [[Arquivo:i2.png]] |
+ | |||
+ | |||
+ | |||
+ | ===CIOT=== | ||
+ | |||
+ | |||
+ | '''Código Identificador da Operação de Transporte – CIOT''' | ||
+ | |||
+ | |||
+ | O Código Identificador da Operação de Transporte – CIOT – é o código gerado pelas administradoras de meios de pagamento que identifica a operação de transporte. Este código é gerado seguindo as regras definidas pela ANTT – Agência Nacional de Transporte Terrestre. | ||
+ | |||
+ | |||
+ | |||
+ | '''Geração do CIOT''' | ||
+ | |||
+ | |||
+ | O CIOT é representado por uma sequência de 16 caracteres numéricos, 12 gerados pela administradora de meio de pagamento e 4 gerado pela ANTT após o envio e validação da declaração da Operação de Transporte informada pelo Contratante de Frete (Transportadora - SAT). Ele terá o seguinte formato:'''998000000126/1234.''' | ||
+ | |||
+ | |||
+ | Caso seja identificada alguma indisponibilidade aos serviços do pagamento eletrônico de frete da ANTT, as operações de transporte serão emitidas normalmente, com a utilização do código “XXXX” como código de verificação, substituindo o protocolo de autorização de quatro dígitos retornado pela agência ficando com o seguinte formato: '''998000000126/XXXX'''. A agência autoriza as administradoras e emitirem os CIOTs sem prejuízo ao atendimento da legislação. | ||
+ | |||
+ | Todas as operações de transporte geradas durante o período de inacessibilidade serão informadas a ANTT automaticamente, fora dos horários de pico de serviço. | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | ===Como configurar o Sat para integração=== | ||
+ | |||
+ | |||
+ | Algumas integrações tem usuário e senha nos webservices que é o caso da Repom e DBTrans, já a Pamcard e NddCargo é através de um Certificado digital modelo A1 ou A3. | ||
+ | |||
+ | 1- Verifique e/ou solicite junto ao cliente e com a operadora os dados acima. | ||
+ | |||
+ | 2- Em posse dos dados acima veja algumas configurações que devem ser feitas no SAT em '''“Parâmetros Empresa” e “Parâmetros Empresa Especiais”'''. | ||
+ | |||
+ | |||
+ | |||
+ | '''Parâmetro Especial''' | ||
+ | |||
+ | |||
+ | [[Arquivo:i3.png]] | ||
+ | |||
+ | |||
+ | |||
+ | [[Arquivo:i4.png]] | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | ===Mais Informações=== | ||
+ | |||
+ | Para dar continuidade ao processo de entendimento, veja os manuais de processo correspondente a cada Operadora. | ||
+ | |||
+ | |||
+ | '''Observações.''' | ||
+ | |||
+ | :Existem algumas validações de campos obrigatórios que podem ser feitos antes de enviar os dados, mas como é um processo enrolado de fazer, não foi feito e o não tem previsão definida. | ||
+ | |||
+ | |||
+ | '''Lembre-se:''' | ||
+ | |||
+ | :• A Intersite não tem parceria com nenhuma das operadoras, portando não será indicado pela mesma uma delas para uso, o cliente precisa verificar qual delas atenderá melhor em relação custo x beneficio. | ||
+ | :• O suporte a estes erros é de responsabilidade do SUPORTE DAS OPERADORAS, eles têm pessoal qualificado para o mesmo, não temos que ficar “tentando” ver o que pode ter ocorrido. | ||
+ | :• O SAT não está obrigado a realizar TODOS os procedimentos das integrações, ele será APENAS um facilitador, ou seja, apenas irá enviar os cadastros às operadoras, a liberação de pagamento de frete e alterações deverá ser feito diretamente no sistema web das operadoras, pois isto não será feito pelo SAT. | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | ===ERROS:=== | ||
+ | |||
+ | Caso ocorra algum erro que não pôde ser identificado na mensagem de erro retornada na operadora, devem-se enviar os xml’s de envio e de retorno do procedimento realizado para a operadora, pois eles que terão de indicar o que pode ter ocorrido para correção. | ||
+ | |||
+ | |||
+ | [[Arquivo:i5.png]] | ||
+ | |||
+ | |||
+ | |||
+ | [[Arquivo:i6.png]] | ||
+ | |||
+ | |||
+ | Se bem que com um pouco de inglês e ajuda de uma ferramenta de tradução livre como o google tradutor, talvez se consiga identificar o erro, por exemplo: | ||
+ | |||
+ | |||
+ | :'''Erro 1''' - ''Este erro acima diz: “The element ‘Endereco’ hás invalid child element”, traduzindo via google tradutor: “O elemento "Endereco" tem elemento filho inválido”. Ou seja, foi um ‘TipoLogradouro’ inválido.'' | ||
+ | |||
+ | :'''Erro 2''' - ''Este erro acima diz: “The element ‘Nome’ is invalid, is invalid according to its datatype – the actual length is greater than maxlength value”, traduzindo via google tradutor: “O elemento ‘Nome’ é inválido, é inválido de acordo com seu tipo de dados - o comprimento real é maior que o valor maxlength”.'' | ||
+ | |||
+ | |||
+ | |||
+ | '''* maxlength''' não foi traduzido por ser uma linguagem técnica abreviada o correto seria “maximum length” = “comprimento máximo”. | ||
+ | |||
+ | |||
+ | Segue alguns endereços de e-mails da equipe de TI das operadoras que podem auxiliar na verificação de erros. | ||
+ | |||
+ | |||
+ | |||
+ | [[Arquivo:i7.png]] |
Edição de 17h54min de 19 de junho de 2012
Tabela de conteúdo |
MANUAL
O Objetivo deste documento é mostrar como irá funcionar a integração SAT x Repom.
Existe atualmente no SAT integração via webservice com as seguintes operadoras de cartão:
- Efrete
- DBTrans
- Pamcard
- Repom
E estamos realizando o desenvolvimento das integrações abaixo:
- NDDCargo
- Policard
Observe na imagem abaixo como funciona a comunicação entre os sitemas e webservices das
operadoras de cartão.
1) Os dados são enviados a operadora;
2) Operadora faz as consistências necessárias e ou devolve os erros para o SAT ou prossegue enviando os dados para validação no webservice da ANTT que retorna a validação dos dados para operadora e esta retorna para o SAT;
3) O Ciot é gerado em conjunto com a operadora de cartão e a ANTT e quando está tudo certo no envio de dados do frete é retornado para o sat esta (e outras informações) que é gravado na viagem em questão.
Fluxo de funcionamento
CIOT
Código Identificador da Operação de Transporte – CIOT
O Código Identificador da Operação de Transporte – CIOT – é o código gerado pelas administradoras de meios de pagamento que identifica a operação de transporte. Este código é gerado seguindo as regras definidas pela ANTT – Agência Nacional de Transporte Terrestre.
Geração do CIOT
O CIOT é representado por uma sequência de 16 caracteres numéricos, 12 gerados pela administradora de meio de pagamento e 4 gerado pela ANTT após o envio e validação da declaração da Operação de Transporte informada pelo Contratante de Frete (Transportadora - SAT). Ele terá o seguinte formato:998000000126/1234.
Caso seja identificada alguma indisponibilidade aos serviços do pagamento eletrônico de frete da ANTT, as operações de transporte serão emitidas normalmente, com a utilização do código “XXXX” como código de verificação, substituindo o protocolo de autorização de quatro dígitos retornado pela agência ficando com o seguinte formato: 998000000126/XXXX. A agência autoriza as administradoras e emitirem os CIOTs sem prejuízo ao atendimento da legislação.
Todas as operações de transporte geradas durante o período de inacessibilidade serão informadas a ANTT automaticamente, fora dos horários de pico de serviço.
Como configurar o Sat para integração
Algumas integrações tem usuário e senha nos webservices que é o caso da Repom e DBTrans, já a Pamcard e NddCargo é através de um Certificado digital modelo A1 ou A3.
1- Verifique e/ou solicite junto ao cliente e com a operadora os dados acima.
2- Em posse dos dados acima veja algumas configurações que devem ser feitas no SAT em “Parâmetros Empresa” e “Parâmetros Empresa Especiais”.
Parâmetro Especial
Mais Informações
Para dar continuidade ao processo de entendimento, veja os manuais de processo correspondente a cada Operadora.
Observações.
- Existem algumas validações de campos obrigatórios que podem ser feitos antes de enviar os dados, mas como é um processo enrolado de fazer, não foi feito e o não tem previsão definida.
Lembre-se:
- • A Intersite não tem parceria com nenhuma das operadoras, portando não será indicado pela mesma uma delas para uso, o cliente precisa verificar qual delas atenderá melhor em relação custo x beneficio.
- • O suporte a estes erros é de responsabilidade do SUPORTE DAS OPERADORAS, eles têm pessoal qualificado para o mesmo, não temos que ficar “tentando” ver o que pode ter ocorrido.
- • O SAT não está obrigado a realizar TODOS os procedimentos das integrações, ele será APENAS um facilitador, ou seja, apenas irá enviar os cadastros às operadoras, a liberação de pagamento de frete e alterações deverá ser feito diretamente no sistema web das operadoras, pois isto não será feito pelo SAT.
ERROS:
Caso ocorra algum erro que não pôde ser identificado na mensagem de erro retornada na operadora, devem-se enviar os xml’s de envio e de retorno do procedimento realizado para a operadora, pois eles que terão de indicar o que pode ter ocorrido para correção.
Se bem que com um pouco de inglês e ajuda de uma ferramenta de tradução livre como o google tradutor, talvez se consiga identificar o erro, por exemplo:
- Erro 1 - Este erro acima diz: “The element ‘Endereco’ hás invalid child element”, traduzindo via google tradutor: “O elemento "Endereco" tem elemento filho inválido”. Ou seja, foi um ‘TipoLogradouro’ inválido.
- Erro 2 - Este erro acima diz: “The element ‘Nome’ is invalid, is invalid according to its datatype – the actual length is greater than maxlength value”, traduzindo via google tradutor: “O elemento ‘Nome’ é inválido, é inválido de acordo com seu tipo de dados - o comprimento real é maior que o valor maxlength”.
* maxlength não foi traduzido por ser uma linguagem técnica abreviada o correto seria “maximum length” = “comprimento máximo”.
Segue alguns endereços de e-mails da equipe de TI das operadoras que podem auxiliar na verificação de erros.