Objetivo

Esse método tem como objetivo associar um cartão a um determinado portador ou substituir um cartão já associado.

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.

Cartã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.

Cartão VTG 100

VTG 100 (Pessoa Física) → Cartão associado ao portador pessoa física.
- 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.

Cartão VTG 200

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.

Request

Nº	Campo	Tipo	Obrigatório	Descrição	Observação
AssociacaoSubstituicaoCartaoRequest
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

Nº	Campo	Tipo	Obrigatório	Descrição	Observação
AssociacaoSubstituicaoCartaoResponse
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

Método

AssociarSubstituirCartaoRequest

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tms="http://tmsfrete.v2.targetmp.com.br">
   <soapenv:Header/>
   <soapenv:Body>
      <tms:AssociarSubstituirCartao>
         <tms:auth>
            <tms:Usuario>?</tms:Usuario>
            <tms:Senha>?</tms:Senha>
            <tms:Token>?</tms:Token>
         </tms:auth>
         <tms:associar>
            <tms:NumeroNovoCartao>?</tms:NumeroNovoCartao>
            <tms:CpfPortadorCartao>?</tms:CpfPortadorCartao>
            <tms:CnpjCartaoEmpresarial>?</tms:CnpjCartaoEmpresarial>
            <tms:NumeroCartaoAnterior>?</tms:NumeroCartaoAnterior>
            <tms:MotivoCancelamento>?</tms:MotivoCancelamento>
         </tms:associar>
      </tms:AssociarSubstituirCartao>
   </soapenv:Body>
</soapenv:Envelope>

Associar Cartão VTG 100

Abaixo, segue exemplo de como associar um Cartão VTG 100 (Pessoa Física).

Exemplo VTG 100 - AssociacaoSubstituicaoCartaoRequest

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 i:nil="true" />
            <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>

Associar Cartão VTG 200

Abaixo, segue exemplo de como associar um cartão VTG 200 (Pessoa Jurídica).

Exemplo VTG 200

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</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>

Substituir Cartão VTG 100

Abaixo, segue exemplo para substituir o cartão de um portador.

Substituir VTG 100 - AssociacaoSubstituicaoCartaoRequest

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>4198071039667015</tms:NumeroNovoCartao>
            <tms:CpfPortadorCartao>21470325810</tms:CpfPortadorCartao>
            <tms:CnpjCartaoEmpresarial i:nil="true" />
            <tms:NumeroCartaoAnterior>4198071039667014</tms:NumeroCartaoAnterior>
            <tms:MotivoCancelamento>3</tms:MotivoCancelamento>
         </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 Substituído com Sucesso!</Mensagem>
      </AssociarSubstituirCartaoResult>
    </AssociarSubstituirCartaoResponse>
  </s:Body>
</s:Envelope>

Substituir Cartão VTG 200

Abaixo, segue exemplo para substituir o cartão de um portador.

Substituir VTG 200 - AssociacaoSubstituicaoCartaoRequest

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>4198071039667015</tms:NumeroNovoCartao>
            <tms:CpfPortadorCartao>21470325810</tms:CpfPortadorCartao>
            <tms:CnpjCartaoEmpresarial i:nil="true" />
            <tms:NumeroCartaoAnterior>4198071039667014</tms:NumeroCartaoAnterior>
            <tms:MotivoCancelamento>3</tms:MotivoCancelamento>
         </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 Substituído com Sucesso!</Mensagem>
      </AssociarSubstituirCartaoResult>
    </AssociarSubstituirCartaoResponse>
  </s:Body>
</s:Envelope>