Versions Compared

Version Old Version 1 New Version Current
Changes made by

Gabriel Nisã Brandão Casaes Monteiro (Unlicensed)

Gabriel Nisã Brandão Casaes Monteiro (Unlicensed)

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Objetivo

Esse método tem como objetivo, obter as informações de um determinado cartão.


Info
titleObservações Importantes
  1. Não é possível realizar rajadas para esse método, a TARGET limita uma quantidade X de requisições por minuto, aconselhamos requisições por demanda.
  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 = VTG 100
      1. Será necessário associar o cartão a um portador.
    3. PessoaJuridica = VTG 200
      1. Será necessário associar o cartão a um portador e vinculá-lo a uma transportadora.
  3. 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.



Request

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


Response

InformacaoCartaoResponse
Nº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.N/A


InfoPortadorResponse
NºCampoTipoObrigatórioDescriçãoObservação
1CpfstringNãoCPF do PortadorN/A
2DataNascimentoDateTime(YYYY-MM-DD)NãoData de Nascimento do Portador.N/A
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 - 'ObterInformacoesCartao'.

Code Block
languagexml
themeRDark
firstline1
titleObterInformacoesCartaoRequest
linenumberstrue
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/">
   <soapenv:Header/>
   <soapenv:Body>
      <tem:ObterInformacoesCartao>
         <tem:numeroCartao>?</tem:numeroCartao>
      </tem:ObterInformacoesCartao>
   </soapenv:Body>
</soapenv:Envelope>


Obter Informação Cartão

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

Code Block
languagexml
themeRDark
firstline1
titleObterInformacoesCartao
linenumberstrue
Request
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/">
   <soapenv:Header>
   	<Identification>exemplo</Identification>
   	<Token>v0testeBs=</Token>
</soapenv:Header>
   <soapenv:Body>
      <tem:ObterInformacoesCartao>
         <tem:numeroCartao>1117911714528140</tem:numeroCartao>
      </tem:ObterInformacoesCartao>
   </soapenv:Body>
</soapenv:Envelope>

Response
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Body>
      <ObterInformacoesCartaoResponse xmlns="http://tempuri.org/">
         <ObterInformacoesCartaoResult xmlns:a="http://schemas.datacontract.org/2004/07/TARGET.VectioFrete.Application.WCF.Contracts.External" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
            <a:CodigoErro>0</a:CodigoErro>
            <a:MensagemRetorno>Cartão localizado.</a:MensagemRetorno>
            <a:Sucesso>true</a:Sucesso>
            <a:Vinculado>false</a:Vinculado>
            <a:ResumoVinculacao>Cartão Sem Portador (Novo)</a:ResumoVinculacao>
            <a:NomePortador>Não Informado</a:NomePortador>
            <a:StatusCartao>Remessa</a:StatusCartao>
            <a:CartaoBloqueado>true</a:CartaoBloqueado>
         </ObterInformacoesCartaoResult>
      </ObterInformacoesCartaoResponse>
   </s:Body>
</s:Envelope>