Explicação do método

Modelos Cartão:

Objetivo

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

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

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:

...

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

...

Request

...

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

Response

Nº	Campo	Tipo	Obrigatório	Descrição	Observação
AssociacaoSubstituicaoCartaoRequest
1	NumeroNovoCartao	string	Sim

Response

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

Code Block

language	xml
theme	RDark
firstline	1
title	AssociarSubstituirCartaoRequest
linenumbers	true

<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

language	xml
theme	RDark
firstline	1
title	Exemplo VTG 100 - AssociacaoSubstituicaoCartaoRequest
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 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

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

Substituir Cartão VTG 100

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

Code Block

language	xml
theme	RDark
firstline	1
title	Substituir VTG 100 - AssociacaoSubstituicaoCartaoRequest
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>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

language	xml
theme	RDark
firstline	1
title	Substituir VTG 200 - AssociacaoSubstituicaoCartaoRequest
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>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>

Version	Old Version 3	New Version Current
Changes made by	Gabriel Nisã Brandão Casaes Monteiro (Unlicensed)	vitor.costa (Unlicensed)
Saved on	Aug 22, 2018	Feb 08, 2022

Versions Compared

Key

Objetivo

Request

Request

Response

Response

Método

Associar Cartão VTG 100

Associar Cartão VTG 200

Substituir Cartão VTG 100

Substituir Cartão VTG 200

Page Comparison

Versions Compared

Key

Objetivo

Request

Request

Response

Response

Método

Associar Cartão VTG 100

Associar Cartão VTG 200

Substituir Cartão VTG 100

Substituir Cartão VTG 200