DOCUMENTAÇÃO CORPORATIVA
ObterInformacaoCartao
Objetivo
Esse método tem como objetivo detalhar as informações do cartão pesquisado.
Observações Importantes
- 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.
- 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:
- NaoDefinido = VTG 900
- Não será necessário realizar uma associação para o portador do cartão.
- PessoaFisica = TDV 100, VTG 100
- Será necessário associar o cartão a um portador.
- PessoaJuridica = TDV 200, VTG 200
- Será necessário associar o cartão a um portador e vinculá-lo a uma transportadora.
- NaoDefinido = VTG 900
Request
InformacaoCartaoRequest | |||||
Nº | Campo | Tipo | Obrigatório | Descrição | Observação |
---|---|---|---|---|---|
1 | NumeroCartao | string | Sim | Número do Cartão a ser buscado. | N/A |
Response
InformacaoCartaoResponse | |||||
Nº | Campo | Tipo | Obrigatório | Descrição | Observação |
---|---|---|---|---|---|
1 | Erro | ErroResponse - string | Não | Retorna o Erro | NULO em caso de sucesso. |
2 | Ativo | bool (true || false) | Sim | Informa se o cartão se encontra ativo. | N/A |
3 | Bloqueado | bool (true || false) | Sim | Informa se o cartão se encontra bloqueado. | N/A |
4 | CnpjEmpresarial | string | Não | Retorna o CNPJ em caso de cartão PJ, caso exista. | N/A |
5 | Vinculado | bool (true || false) | Sim | Informa se o cartão já possui vínculo. | N/A |
6 | InfoPortador | List<InfoPortadorResponse> | Sim | Informações do Portador do Cartão encontrado. | N/A |
7 | LiberacaoCarga | string | Sim | Status para liberação da carga. | 1= Liberado 2= ImpedidoNaoVinculado 3= ImpedidoStatus 4= ImpedidoAdministradora 5= ImpedidoInexistente 6= ImpedidoVencimento 7= ImpedidoAdministradoraExcetoPedagio 8= ImpedidoWhiteListOut |
8 | AdministradoraCartao | string | Sim | Administradora do Cartão utilizado. | N/A |
9 | TipoPessoaCartao | string | Sim | Tipo de Pessoa a qual o cartão está associado | 0= NaoDefinido 1= Fisica 2= Juridica |
10 | InfoProdutoCartao | string | Sim | Informações do Produto Cartão | N/A |
11 | NumeroCartao | string | Sim | Numero do cartão buscado. | N/A |
12 | StatusCartao | string | Sim | Status atual do cartão. | 1= Ativo 2= RouboFurto 3= PerdaRoubo 4= Remessa 5= Bloqueado 6= Cancelado 7= BloqueadoPreventivo 8= ImpedidoBanco |
13 | Validade | DateTime(YYYY-MM-DD) | Não | Data de Validade do Cartao. | Exemplo: (2018-08-20T10:05:33) |
InfoPortadorResponse | |||||
Nº | Campo | Tipo | Obrigatório | Descrição | Observação |
---|---|---|---|---|---|
1 | Cpf | string | Não | CPF do Portador | N/A |
2 | DataNascimento | DateTime(YYYY-MM-DD) | Não | Data de Nascimento do Portador. | Exemplo: (2018-08-20T10:05:33) |
3 | NomeCompleto | string | Não | Nome Completo do Portador. | N/A |
4 | Rntrc | string | Não | RNTRC do Portador. | N/A |
5 | Telefone | string | Não | Telefone do Portador. | N/A |
6 | Uf | string | Não | UF do Portador | N/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>