DOCUMENTAÇÃO CORPORATIVA

ObterInformacaoCartao

Objetivo

Esse método tem como objetivo detalhar as informações do cartão pesquisado.


Observações Importantes

  1. Não é possível realizar rajadas para esse método, a TARGET limita 50 requisições por minuto, aconselhamos requisições por demanda, caso o limite de 50 requisições seja ultrapassado, iremos bloquear as requisições apenas para o método que ultrapassou o limite durante 5 minutos.
  2. Caso o Cliente Trabalhe com os 3 tipos de cartões disponibilizados pela TARGET, sugerimos que antes de ser realizada uma associação através do método - AssociarSubstituirCartao, invoquem o método - 'ObterInformacaoCartao' e trabalhem a associação em cima da informação vinda na TAG - 'TipoPessoaCartao', onde:
    1. NaoDefinido = VTG 900
      1. Não será necessário realizar uma associação para o portador do cartão.
    2. PessoaFisica = TDV 100, VTG 100
      1. Será necessário associar o cartão a um portador.
    3. PessoaJuridica = TDV 200, VTG 200
      1. Será necessário associar o cartão a um portador e vinculá-lo a uma transportadora.


Request

InformacaoCartaoRequest
CampoTipoObrigatórioDescriçãoObservação
1NumeroCartaostringSimNúmero do Cartão a ser buscado.N/A

Response

InformacaoCartaoResponse
CampoTipoObrigatórioDescriçãoObservação
1ErroErroResponse - stringNãoRetorna o ErroNULO em caso de sucesso.
2Ativobool (true || false)SimInforma se o cartão se encontra ativo.N/A
3Bloqueadobool (true || false)SimInforma se o cartão se encontra bloqueado.N/A
4CnpjEmpresarialstringNãoRetorna o CNPJ em caso de cartão PJ, caso exista.N/A
5Vinculadobool (true || false)SimInforma se o cartão já possui vínculo.N/A
6InfoPortadorList<InfoPortadorResponse>SimInformações do Portador do Cartão encontrado.N/A
7LiberacaoCargastringSimStatus para liberação da carga.1= Liberado
2= ImpedidoNaoVinculado
3= ImpedidoStatus
4= ImpedidoAdministradora
5= ImpedidoInexistente
6= ImpedidoVencimento
7= ImpedidoAdministradoraExcetoPedagio
8= ImpedidoWhiteListOut
8AdministradoraCartaostringSimAdministradora do Cartão utilizado.N/A
9TipoPessoaCartaostringSimTipo de Pessoa a qual o cartão está associado0= NaoDefinido
1= Fisica
2= Juridica
10InfoProdutoCartaostringSimInformações do Produto CartãoN/A
11NumeroCartaostringSimNumero do cartão buscado.N/A
12StatusCartaostringSimStatus atual do cartão.1= Ativo
2= RouboFurto
3= PerdaRoubo
4= Remessa
5= Bloqueado
6= Cancelado
7= BloqueadoPreventivo
8= ImpedidoBanco
13ValidadeDateTime(YYYY-MM-DD)NãoData de Validade do Cartao.Exemplo: (2018-08-20T10:05:33)
InfoPortadorResponse
CampoTipoObrigatórioDescriçãoObservação
1CpfstringNãoCPF do PortadorN/A
2DataNascimentoDateTime(YYYY-MM-DD)NãoData de Nascimento do Portador.Exemplo: (2018-08-20T10:05:33)
3NomeCompletostringNãoNome Completo do Portador.N/A
4RntrcstringNãoRNTRC do Portador.N/A
5TelefonestringNãoTelefone do Portador.N/A
6UfstringNãoUF do PortadorN/A

Método

Abaixo, segue o método - 'ObterInformacaoCartao'.

InformacaoCartaoRequest
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tms="http://tmsfrete.v2.targetmp.com.br">
   <soapenv:Header/>
   <soapenv:Body>
      <tms:ObterInformacaoCartao>
         <tms:auth>
            <tms:Usuario>?</tms:Usuario>
            <tms:Senha>?</tms:Senha>
            <tms:Token>?</tms:Token>
         </tms:auth>
         <tms:info>
            <tms:NumeroCartao>?</tms:NumeroCartao>
         </tms:info>
      </tms:ObterInformacaoCartao>
   </soapenv:Body>
</soapenv:Envelope>


Obter Informação Cartão

Abaixo, segue exemplo do método - 'ObterInformacaoCartao'.

Exemplo - InformacaoCartaoRequest
Request
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tms="http://tmsfrete.v2.targetmp.com.br" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
   <soapenv:Header/>
   <soapenv:Body>
      <tms:ObterInformacaoCartao>
         <tms:auth>
            <tms:Usuario>tms.exemplo</tms:Usuario>
            <tms:Senha>v0hXPrwerKblaBs=</tms:Senha>
            <tms:Token i:nil="true" />
         </tms:auth>
         <tms:info>
            <tms:NumeroCartao>4198071034898010</tms:NumeroCartao>
         </tms:info>
      </tms:ObterInformacaoCartao>
   </soapenv:Body>
</soapenv:Envelope>

Response
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header>
    <Action s:mustUnderstand="1" xmlns="http://schemas.microsoft.com/ws/2005/05/addressing/none">http://tmsfrete.v2.targetmp.com.br/FreteTMSService/ObterInformacaoCartaoResponse</Action>
  </s:Header>
  <s:Body>
    <ObterInformacaoCartaoResponse xmlns="http://tmsfrete.v2.targetmp.com.br">
      <ObterInformacaoCartaoResult xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
        <Erro i:nil="true" />
        <Ativo>true</Ativo>
        <Bloqueado>false</Bloqueado>
        <CnpjEmpresarial i:nil="true" />
        <Vinculado>true</Vinculado>
        <InfoPortador>
          <Cpf>33333333333</Cpf>
          <DataNascimento>1950-01-01T00:00:00</DataNascimento>
          <NomeCompleto>AO PORTADOR</NomeCompleto>
          <Rntrc i:nil="true" />
          <Telefone i:nil="true" />
          <Uf i:nil="true" />
        </InfoPortador>
        <LiberacaoCarga>Liberado</LiberacaoCarga>
        <AdministradoraCartao>TARGET</AdministradoraCartao>
        <TipoPessoaCartao>NaoDefinido</TipoPessoaCartao>
        <InfoProdutoCartao>Cartão Transportes Bradesco Target Vale Pedágio</InfoProdutoCartao>
        <NumeroCartao>4198071034898010</NumeroCartao>
        <StatusCartao>Ativo</StatusCartao>
        <Validade i:nil="true" />
      </ObterInformacaoCartaoResult>
    </ObterInformacaoCartaoResponse>
  </s:Body>
</s:Envelope>