DOCUMENTAÇÃO CORPORATIVA
ObterInformacoesCartao
Objetivo
Esse método tem como objetivo, obter as informações de um determinado cartão.
Observações Importantes
- 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.
- 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 = VTG 100
- Será necessário associar o cartão a um portador.
- PessoaJuridica = VTG 200
- Será necessário associar o cartão a um portador e vinculá-lo a uma transportadora.
- NaoDefinido = VTG 900
- 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º | 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. | N/A |
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. | N/A |
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 - 'ObterInformacoesCartao'.
ObterInformacoesCartaoRequest
<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'.
ObterInformacoesCartao
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>