...

Info
titleModelos Cartões
  • VTG 900 → 
    • Embarca a seguinte tecnologia:
      • Valor Pedágio → 
  • VTG 100 (Pessoa Física) →
    • Embarca as seguintes tecnologias:
      • Valore Frete → 
      • Valor Pedágio → 
      • Valor Combustível → 
  • VTG 200 (Pessoa Jurídica) → 
    •  Embarca as seguintes tecnologias:
      • Valor Frete →  
      • Valor Pedágio → 
      • Valor Combustível → 


Request

Request
Response
AssociacaoSubstituicaoCartaoRequest
CampoTipoObrigatórioDescriçãoObservação
1NumeroNovoCartaostringSimNumero do novo cartão a ser associado ou substituído.N/A
2CpfPortadorCartaostring (11)SimCPF a que o cartão será associado.N/A
3CnpjCartaoEmpresarialstring (14)NãoCNPJ da Transportadora

Em caso de cartão empresarial VTG 200, informar a qual CNPJ este cartão será associado.

Response

O preenchimento desse campo
não remove a necessidade de preenchimento do campo 'CpfPortadorCartao'. Todo cartão deve possuir um CPF.

4NumeroCartaoAnteriorstring (25)NãoNúmero do Cartão Anterior vinculado ao Motorista.Utilizado somente para casos de substituição. 
5MotivoCancelamentointNãoMotivo do Cancelamento

Utilizado somente em de substituição do cartão.


1= PerdaSemSenha
2= PerdaComSenha
3= FurtoRoubo
4= Vencimento
5= UsoNovoCartao


Response

AssociacaoSubstituicaoCartaoResponse
CampoTipoObrigatórioDescriçãoObservação
1ErroErroResponse - stringNãoRetorna o ErroNULO em caso de sucesso.
2MensagemRetornostringSimMensagem indicando o tipo de retorno da função.N/A



Método

Code Block
languagexml
themeRDark
firstline1
titleAssociarSubstituirCartaoRequest
linenumberstrue
<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).

Code Block
languagexml
themeRDark
firstline1
titleExemplo VTG 100 - AssociacaoSubstituicaoCartaoRequest
linenumberstrue
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).

Code Block
languagexml
themeRDark
firstline1
titleExemplo VTG 200
linenumberstrue
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.

Code Block
languagexml
themeMidnight
firstline1
titleSubstituir VTG 100 - AssociacaoSubstituicaoCartaoRequest
linenumberstrue
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.

Code Block
languagexml
themeRDark
firstline1
titleSubstituir VTG 200 - AssociacaoSubstituicaoCartaoRequest
linenumberstrue
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>2147032581011</tms:CnpjCartaoEmpresarial>
            <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>