DOCUMENTAÇÃO CORPORATIVA
BuscarCartoesPortador
- Gabriel Nisã Brandão Casaes Monteiro (Unlicensed)
- vitor.costa (Unlicensed)
- Raphael Santos (Unlicensed)
Objetivo
Esse método tem como objetivo realizar a busca de cartões por portador.
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.
Request
| Request | |||||
| Nº | Campo | Tipo | Obrigatório | Descrição | Observação |
|---|---|---|---|---|---|
| 1 | CPFCNPJ | string | Sim | CPF ou CNPJ do portador | CPF - Do portador do Cartão TDV 100 ou VTG 100 CNPJ - Da Transportador vinculada ao Cartão TDV 200 ou VTG 200 |
Response
| BuscarCartoesResponse | |||||
| Nº | Campo | Tipo | Obrigatório | Descrição | Observação |
|---|---|---|---|---|---|
| 1 | Erro | ErroResponse - string | Não | Retorna o Erro | NULO em caso de sucesso |
| 2 | ListaCartoesAtivos | List<ItemBuscarCartoesResponse> | Sim | Lista de Cartões Ativos por CPF/CNPJ | N/A |
| ItemBuscarCartoesResponse | |||||
| Nº | Campo | Tipo | Obrigatório | Descrição | Observação |
|---|---|---|---|---|---|
| 1 | NumeroCartao | string | Sim | Número do Cartão | N/A |
| 2 | Vinculado | bool (true || false) | Sim | Se o cartão está vinculado a um portador. | N/A |
| 3 | CnpjEmpresarial | string | Sim | CNPJ que o cartão está vinculado | Caso o Cartão seja um VTG 200 |
| 4 | CpfPortador | string | Sim | CPJ do portador do cartão | Caso o Cartão seja um VTG 100 ou VTG 200 |
| 5 | NomePortador | string | Sim | Nome do Portador do Cartão | N/A |
| 6 | Ativo | bool (true || false) | Sim | Se o Cartão está Ativo | N/A |
| 7 | StatusCartao | enum | Sim | Status do Cartão | 1= Ativo |
| 8 | Validade | DateTime(YYYY-MM-DD) | Não | Data de Validade do Cartão | Exemplo: (2018-08-20T10:05:33) |
| 9 | DescricaoProdutoCartao | string | Sim | Descrição do Produto Cartão | N/A |
| 10 | LiberacaoCarga | enum | Sim | Liberação Carga | 1= Liberado |
Método
Abaixo, segue o método - 'BuscarCartoesPortador'.
BuscaCartoesRequest
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tms="http://tmsfrete.v2.targetmp.com.br">
<soapenv:Header/>
<soapenv:Body>
<tms:BuscarCartoesPortador>
<tms:auth>
<tms:Usuario>target.tms</tms:Usuario>
<tms:Senha>*****</tms:Senha>
<tms:Token i:nil="true" />
</tms:auth>
<tms:buscaRequest>
<tms:CPFCNPJ>12345678952</tms:CPFCNPJ>
</tms:buscaRequest>
</tms:BuscarCartoesPortador>
</soapenv:Body>
</soapenv:Envelope>