DOCUMENTAÇÃO CORPORATIVA

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 13 Next »

Objetivo

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


Observações Importantes

Não é possível associar um cartão que já está associado a um portador a outro portador.


Modelos 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

AssociacaoSubstituicaoCartaoRequest
Nº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.

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
Nº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

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>
  • No labels