Objetivo
Esse método tem como objetivo associar um cartão a um determinado portador ou substituir um cartão já associado a um portador.
| Info |
|---|
| title | Observações Importantes |
|---|
|
- Não é possível associar um cartão que já está associado a um portador a outro portador.
- 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.
|
| Info |
|---|
| title | Modelos CartõesCartão VTG 900 |
|---|
|
- VTG 900 → Cartão exclusivo Vale Pedágio, esse cartão não é associado a um portador.
- Embarca a seguinte tecnologia:
- Valor Pedágio → Os valores referentes as compras de Vale Pedágio ficarão no cartão, quando o mesmo for carregado através do Sistema NUMMUS, o portador só conseguirá fazer uso nas Praças de Pedágio. Carregamento Offline.
|
| Info |
|---|
| title | Cartão TDV 100 e VTG 100 |
|---|
|
- TDV 100 e VTG 100 (Pessoa Física) → Cartão associado ao portador pessoa física.
- Embarca as seguintes tecnologias:
- Valore Valor Frete → Valor referente aos pagamentos das contratações de frete. Carregamento Online.
- Valor Pedágio → Os valores referentes as compras de Vale Pedágio ficarão no cartão, quando o mesmo for carregado através do Sistema NUMMUS, o portador só conseguirá fazer uso nas Praças de Pedágio. Carregamento Offline.
- Valor Combustível → Valor referente ao combustível. Carregamento Online.
|
| Info |
|---|
| title | Cartão TDV 200 e VTG 200 |
|---|
|
- TDV 200 e VTG 200 (Pessoa Jurídica) → Cartão associado ao portador pessoa física e vinculado a uma transportadora.
- Embarca as seguintes tecnologias:
- Valor Frete → Valor referente aos pagamentos das contratações de frete. Carregamento Online.
- Valor Pedágio → Os valores referentes as compras de Vale Pedágio ficarão no cartão, quando o mesmo for carregado através do Sistema NUMMUS, o portador só conseguirá fazer uso nas Praças de Pedágio. Carregamento Offline.
- Valor Combustível → Valor referente ao combustível. Carregamento Online.
|
...
| AssociacaoSubstituicaoCartaoRequest |
| Nº | Campo | Tipo | Obrigatório | Descrição | Observação |
|---|
| 1 | NumeroNovoCartao | string | Sim | Numero do novo cartão a ser associado ou substituído. | N/A |
| 2 | CpfPortadorCartao | string (11) | Sim | CPF a que o cartão será associado. | N/A |
| 3 | CnpjCartaoEmpresarial | string (14) | Não | CNPJ da Transportadora | Em caso de cartão empresarial VTG 200, informar a qual CNPJ este cartão será associado. O preenchimento desse campo
não remove a necessidade de preenchimento do campo 'CpfPortadorCartao'. Todo cartão deve possuir um CPF. |
| 4 | NumeroCartaoAnterior | string (25) | Não | Número do Cartão Anterior vinculado ao Motorista. | Utilizado somente para casos de substituição. |
| 5 | MotivoCancelamento | int | Não | Motivo do Cancelamento | Utilizado somente em de substituição do cartão.
1= PerdaSemSenha
2= PerdaComSenha
3= FurtoRoubo
4= Vencimento
5= UsoNovoCartao
|
Response
| AssociacaoSubstituicaoCartaoResponse |
| Nº | Campo | Tipo | Obrigatório | Descrição | Observação |
|---|
| 1 | Erro | ErroResponse - string | Não | Retorna o Erro | NULO em caso de sucesso. |
| 2 | MensagemRetorno | string | Sim | Mensagem indicando o tipo de retorno da função. | N/A |
...
| Code Block |
|---|
| language | xml |
|---|
| theme | RDark |
|---|
| firstline | 1 |
|---|
| title | Exemplo VTG 200 |
|---|
| linenumbers | true |
|---|
|
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:AssociarSubstituirCartao>
<tms:auth>
<tms:Usuario>tms.exemplo</tms:Usuario>
<tms:Senha>v0hXPrwerKblaBs=</tms:Senha>
<tms:Token i:nil="true" />
</tms:auth>
<tms:associar>
<tms:NumeroNovoCartao>4198071039667014</tms:NumeroNovoCartao>
<tms:CpfPortadorCartao>21470325810</tms:CpfPortadorCartao>
<tms:CnpjCartaoEmpresarial>21470325810<CnpjCartaoEmpresarial>21470325810548</tms:CnpjCartaoEmpresarial>
<tms:NumeroCartaoAnterior i:nil="true" />
<tms:MotivoCancelamento i:nil="true" />
</tms:associar>
</tms:AssociarSubstituirCartao>
</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/AssociarSubstituirCartaoResponse</Action>
</s:Header>
<s:Body>
<AssociarSubstituirCartaoResponse xmlns="http://tmsfrete.v2.targetmp.com.br">
<AssociarSubstituirCartaoResult xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<Erro i:nil="true" />
<Mensagem>Cartão Associado com Sucesso!</Mensagem>
</AssociarSubstituirCartaoResult>
</AssociarSubstituirCartaoResponse>
</s:Body>
</s:Envelope> |
...