...

Info

title	Observações Importantes

Antes de realizar uma compra de vale pedágio, será necessário realizar o cadastro de uma rota em nossa Plataforma Web ou através do método - CadastrarRoteiro.
Caso o usuário queira efetuar a compra de um Vale Pedágio Cartão, e o cartão for do tipo VTG 100 ou VTG 200, será necessário associar o mesmo a um portador através do método - AssociarSubstituirCartao.
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	Sistema TARGET NUMMUS - Apena Vale Pedágio Cartão

As compras realizadas por este método precisam ser posteriormente carregadas no CARTÃO DO TRANSPORTADOR. A Transportadora não precisa utilizar seu navegador e acessar nosso sistema, basta efetuar a instalação do TARGET NUMMUS nas máquinas da empresa. O TARGET NUMMUS é um carregador de Vale-Pedágio, que identifica automaticamente as cargas pendentes dos cartões inseridos na LEITORA. O usuário tem seu trabalho facilitado, pois o NUMMUS pode ser configurado para toda vez que carregar o cartão, imprimir o comprovante de Vale-Pedágio conforme exigência de lei. Para baixar o TARGET NUMMUS, basta o cliente acessar nosso sistema, no MENU DOWNLOADS e clicar em baixar.

...

Fluxo Compra Vale Pedágio

Request

CompraValePedagioRequest

Nº

Campo

Tipo

Obrigatório

Descrição

Observação

1

IdModoCompraValePedagio

int

Sim

Id de em que meio de pagamento será feita a carga.

1= Cartão Target Conta Digital ou Bradesco

2=

TAG

PedagioTagViaFacil

5= PedagioTagVeloe

6= PedagioTagConectCar

7= PedagioTagMoveMais

8= Cartão Débito

9= PedagioTagTaggy

2

IdRotaModelo

int

Sim

ID da Rota cadastrada no Sistema TARGET Frete através da Plataforma Web ou do método - CadastrarRoteiro.

N/A

3

CodigoCategoriaVeiculo

int

Sim

Código de Categoria do Veículo para qual a compra será feita.

View file

name	CategoriaDeVeículos.xlsx
height	150

4

MunicipioOrigemCodigoIBGE

int

Não

Código IBGE de Origem da Viagem.

Não é necessário informar o Código de Origem quando o Id da Rota for informado.

5

MunicipioDestinoCodigoIBGE

int

Não

Código IBGE de Destino da Viagem.

Não é necessário informar o Código de Destino quando o Id da Rota for informado.

6

Placa

string

Sim

Placa do Veículo que será feita a compra.

N/A

7

NumeroCartao

string

Não

Número do Cartão

Obrigatório somente quando o IdModoCompraValePedagio for igual a 1 ou 8.

8

MotoristaNome

string

Sim

Nome do Motorista que será feita a compra.

N/A

9

MotoristaCPF

string

Sim

CPF do Motorista que será feita a compra.

N/A

10

MotoristaRNTRC

string

Sim

Não	RNTRC do Motorista que será feita a compra.	N/A
11	IdIntegrador	string	Sim	Id do Integrador	ID único do sistema de TMS da transportadora. Campo validador, não aceitamos código iguais em compras diferentes.
12	CodigoCentroDeCusto	int	Não	Código do Centro de Custo no Sistema TARGET Frete caso utilizado.	N/A
13	NumeroDocumentoEmbarque	string	Não	Número do CT-e ou conhecimento caso deseje ser informado.	N/A
14	ItemFinanceiro	string	Não	Campo livre para registro de documentos que desejem ser associado à compra do VP.	N/A
15	InicioVigencia	DateTime(YYYY-MM-DD)	Sim	Início da Vigência	Obrigatório somente quando o IdModoCompraValePedagio for igual a 2 ou 5. Exemplo: (2018-08-20T10:05:33)
16	FimVigencia	DateTime(YYYY-MM-DD)	Sim	Fim da Vigência	Obrigatório somente quando o IdModoCompraValePedagio for igual a 2 ou 5. Exemplo: (2018-08-20T10:05:33)
17	ValorPrevioCalculado	int	Não	Caso tenha utilizado o método - ObterCustoRota, pode ser informado o valor aqui. Será feita uma validação, se os valores divergirem, a compra será feita de qualquer forma, mas no Objeto de retorno, será informado na mensagem que os valores diferem.	N/A
18	Simples	bool(true \|\| false)	Sim	Serve para definir se a compra a ser registrada é a completa, com mais campos obrigatórios para cadastro, ou simples, com uma quantidade menor de campos a serem informados obrigatoriamente.	Se a TAG for enviada como NULL, será considerado como se a mesma fosse false.

19IdOperacaoTransporte

Será considerada apenas para modo de compra pedágio = 1(Cartão) e quando não tiver IdRotaModelo.
19	IdOperacaoTransporte	int	Não	Caso deseja associar a Operação de Trasporte TAC-Agregado com a compra do Vale Pedágio avulso, basta inserir o id da Operação de Transporte.	Apenas para Cadastros de Operações de Transporte do tipo TAC-Agregado.
20	DadosComplementares	List< Dados Complementares>	Não	DadosComplementares - Request	N/A

Request

Nº	Campo	Tipo	Obrigatório	Descrição	Observação
DadosComplementaresRequest
1	NomeUsuarioOperador	string	Não	Nome do Usuário - Operador	N/A
2	CpfUsuarioOperador	string	Não	CPF do usuário - Operador	N/A
3	NomeFilialOperador	string	Não	Nome da filial do Operador	N/A
4	CnpjFilialOperador	string	Não	CNPJ da Filial do Operador	N/A
5	LoginUsuarioOperador	string	Não	Login do Usuário Operador	N/A

...

Code Block

language	xml
theme	RDark
firstline	1
title	CompraValePedagioRequest
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:ComprarPedagioAvulso>
         <tms:auth>
            <tms:Usuario>?</tms:Usuario>
            <tms:Senha>?</tms:Senha>
            <tms:Token>?</tms:Token>
         </tms:auth>
         <tms:compraRequest>
            <tms:IdModoCompraValePedagio>?</tms:IdModoCompraValePedagio>
            <tms:IdRotaModelo>?</tms:IdRotaModelo>
            <tms:CodigoCategoriaVeiculo>?</tms:CodigoCategoriaVeiculo>
            <tms:MunicipioOrigemCodigoIBGE>?</tms:MunicipioOrigemCodigoIBGE>
            <tms:MunicipioDestinoCodigoIBGE>?</tms:MunicipioDestinoCodigoIBGE>
            <tms:Placa>?</tms:Placa>
            <tms:NumeroCartao>?</tms:NumeroCartao>
            <tms:MotoristaNome>?</tms:MotoristaNome>
            <tms:MotoristaCPF>?</tms:MotoristaCPF>
            <tms:MotoristaRNTRC>?</tms:MotoristaRNTRC>
            <tms:IdIntegrador>?</tms:IdIntegrador>
            <tms:CodigoCentroDeCusto>?</tms:CodigoCentroDeCusto>
            <tms:NumeroDocumentoEmbarque>?</tms:NumeroDocumentoEmbarque>
            <tms:ItemFinanceiro>?</tms:ItemFinanceiro>
            <tms:InicioVigencia>?</tms:InicioVigencia>
            <tms:FimVigencia>?</tms:FimVigencia>
            <tms:ValorPrevioCalculado>?</tms:ValorPrevioCalculado>
            <tms:CompraSimples>?</tms:CompraSimples>
            <tms:IdOperacaoTransporte>?</tms:IdOperacaoTransporte>
            <tms:DadosComplementares>
               <tms:NomeUsuarioOperador>?</tms:NomeUsuarioOperador>
               <tms:CpfUsuarioOperador>?</tms:CpfUsuarioOperador>
               <tms:NomeFilialOperador>?</tms:NomeFilialOperador>
               <tms:CnpjFilialOperador>?</tms:CnpjFilialOperador>
               <tms:LoginUsuarioOperador>?</tms:LoginUsuarioOperador>
            </tms:DadosComplementares>
            <tms:CargaDiferencial>?</tms:CargaDiferencial>
         </tms:compraRequest>
      </tms:ComprarPedagioAvulso>
   </soapenv:Body>
</soapenv:Envelope>

Comprar Pedágio Avulso - Cartão

Abaixo, segue exemplo para realizar a compra de um Vale Pedágio Avulso - Cartão.

Code Block

language	xml
theme	RDark
firstline	1
title	Exemplo Pedágio Cartão - CompraValePedagioRequest
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:ComprarPedagioAvulso>
         <tms:auth>
            <tms:Usuario>tms.exemplo</tms:Usuario>
            <tms:Senha>v0hXPrwerKblaBs=</tms:Senha>
            <tms:Token i:nil="true" />
         </tms:auth>
         <tms:compraRequest>
            <tms:IdModoCompraValePedagio>1</tms:IdModoCompraValePedagio>
            <tms:IdRotaModelo>54132</tms:IdRotaModelo>
            <tms:CodigoCategoriaVeiculo>11</tms:CodigoCategoriaVeiculo>
            <tms:MunicipioOrigemCodigoIBGE i:nil="true" />
            <tms:MunicipioDestinoCodigoIBGE i:nil="true" />
            <tms:Placa>QIK7253</tms:Placa>
            <tms:NumeroCartao>4198071037614018</tms:NumeroCartao>
            <tms:MotoristaNome>CARLOS ALBERTO VIEIRA BUENO</tms:MotoristaNome>
            <tms:MotoristaCPF>44678908072</tms:MotoristaCPF>
            <tms:MotoristaRNTRC i:nil="true" />
            <tms:IdIntegrador>0001473635</tms:IdIntegrador>
            <tms:CodigoCentroDeCusto i:nil="true" />
            <tms:NumeroDocumentoEmbarque>0113103731</tms:NumeroDocumentoEmbarque>
            <tms:ItemFinanceiro i:nil="true" />
            <tms:InicioVigencia>2018-08-28</tms:InicioVigencia>
            <tms:FimVigencia>2018-09-17</tms:FimVigencia>
            <tms:ValorPrevioCalculado i:nil="true" />
            <tms:CompraSimples>false</tms:CompraSimples>
            <tms:IdOperacaoTransporte i:nil="true" />
            <tms:DadosComplementares>
               <tms:NomeUsuarioOperador>Marcia Frigo</tms:NomeUsuarioOperador>
               <tms:CpfUsuarioOperador i:nil="true" />
               <tms:NomeFilialOperador>343</tms:NomeFilialOperador>
               <tms:CnpjFilialOperador>01838723033807</tms:CnpjFilialOperador>
               <tms:LoginUsuarioOperador>313322</tms:LoginUsuarioOperador>
            </tms:DadosComplementares>
            <tms:CargaDiferencial i:nil="true" />
         </tms:compraRequest>
      </tms:ComprarPedagioAvulso>
   </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/ComprarPedagioAvulsoResponse</Action>
  </s:Header>
  <s:Body>
    <ComprarPedagioAvulsoResponse xmlns="http://tmsfrete.v2.targetmp.com.br">
      <ComprarPedagioAvulsoResult xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
        <Erro i:nil="true" />
        <Mensagem>Compra Vale Pedágio Cartão efetuada com sucesso!</Mensagem>
        <IdCompraValePedagio>177796</IdCompraValePedagio>
        <ValorCompra>250.2</ValorCompra>
        <CodigoRegistroValePedagio>24220570</CodigoRegistroValePedagio>
      </ComprarPedagioAvulsoResult>
    </ComprarPedagioAvulsoResponse>
  </s:Body>
</s:Envelope>

Comprar Pedágio Avulso - TAG

Abaixo, segue exemplo para realizar a compra de um Vale Pedágio Avulso - TAG 'Sem Parar'.

Code Block

language	xml
theme	RDark
firstline	1
title	Exemplo Pedágio TAG - CompraValePedagioRequest
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:ComprarPedagioAvulso>
         <tms:auth>
            <tms:Usuario>tms.exemplo</tms:Usuario>
            <tms:Senha>v0hXPrwerKblaBs=</tms:Senha>
            <tms:Token i:nil="true" />
         </tms:auth>
         <tms:compraRequest>
            <tms:IdModoCompraValePedagio>2</tms:IdModoCompraValePedagio>
            <tms:IdRotaModelo>54132</tms:IdRotaModelo>
            <tms:CodigoCategoriaVeiculo>11</tms:CodigoCategoriaVeiculo>
            <tms:MunicipioOrigemCodigoIBGE i:nil="true" />
            <tms:MunicipioDestinoCodigoIBGE i:nil="true" />
            <tms:Placa>QIK7253</tms:Placa>
            <tms:NumeroCartao i:nil="true" />
            <tms:MotoristaNome>CARLOS ALBERTO VIEIRA BUENO</tms:MotoristaNome>
            <tms:MotoristaCPF>44678908072</tms:MotoristaCPF>
            <tms:MotoristaRNTRC i:nil="true" />
            <tms:IdIntegrador>0001473635</tms:IdIntegrador>
            <tms:CodigoCentroDeCusto i:nil="true" />
            <tms:NumeroDocumentoEmbarque>0113103731</tms:NumeroDocumentoEmbarque>
            <tms:ItemFinanceiro i:nil="true" />
            <tms:InicioVigencia>2018-08-28</tms:InicioVigencia>
            <tms:FimVigencia>2018-09-17</tms:FimVigencia>
            <tms:ValorPrevioCalculado i:nil="true" />
            <tms:CompraSimples>false</tms:CompraSimples>
            <tms:IdOperacaoTransporte i:nil="true" />
            <tms:DadosComplementares>
               <tms:NomeUsuarioOperador>Marcia Frigo</tms:NomeUsuarioOperador>
               <tms:CpfUsuarioOperador i:nil="true" />
               <tms:NomeFilialOperador>343</tms:NomeFilialOperador>
               <tms:CnpjFilialOperador>01838723033807</tms:CnpjFilialOperador>
               <tms:LoginUsuarioOperador>313322</tms:LoginUsuarioOperador>
            </tms:DadosComplementares>
            <tms:CargaDiferencial i:nil="true" />
         </tms:compraRequest>
      </tms:ComprarPedagioAvulso>
   </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/ComprarPedagioAvulsoResponse</Action>
  </s:Header>
  <s:Body>
    <ComprarPedagioAvulsoResponse xmlns="http://tmsfrete.v2.targetmp.com.br">
      <ComprarPedagioAvulsoResult xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
        <Erro i:nil="true" />
        <Mensagem>Compra Vale Pedágio Via Fácil efetuada com sucesso!</Mensagem>
        <IdCompraValePedagio>177796</IdCompraValePedagio>
        <ValorCompra>250.2</ValorCompra>
        <CodigoRegistroValePedagio>24220570</CodigoRegistroValePedagio>
      </ComprarPedagioAvulsoResult>
    </ComprarPedagioAvulsoResponse>
  </s:Body>
</s:Envelope>

Comprar Pedágio Simples Avulso - Cartão

Abaixo, segue exemplo para realizar a compra de um Pedágio Simples Avulso (Apenas para frota própria).

Code Block

language	xml
theme	RDark
firstline	1
title	Exemplo Pedágio Simples Cartão - CompraValePedagioRequest
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:ComprarPedagioAvulso>
         <tms:auth>
            <tms:Usuario>tms.exemplo</tms:Usuario>
            <tms:Senha>v0hXPrwerKblaBs=</tms:Senha>
            <tms:Token i:nil="true" />
         </tms:auth>
         <tms:compraRequest>
            <tms:IdModoCompraValePedagio>1</tms:IdModoCompraValePedagio>
            <tms:IdRotaModelo i:nil="true" />
            <tms:CodigoCategoriaVeiculo>11</tms:CodigoCategoriaVeiculo>
            <tms:MunicipioOrigemCodigoIBGE i:nil="true" />
            <tms:MunicipioDestinoCodigoIBGE i:nil="true" />
            <tms:Placa>QIK7253</tms:Placa>
            <tms:NumeroCartao>4198071037614018</tms:NumeroCartao>
            <tms:MotoristaNome>CARLOS ALBERTO VIEIRA BUENO</tms:MotoristaNome>
            <tms:MotoristaCPF>44678908072</tms:MotoristaCPF>
            <tms:MotoristaRNTRC i:nil="true" />
            <tms:IdIntegrador>0001473635</tms:IdIntegrador>
            <tms:CodigoCentroDeCusto i:nil="true" />
            <tms:NumeroDocumentoEmbarque i:nil="true" />
            <tms:ItemFinanceiro i:nil="true" />
            <tms:InicioVigencia>2018-08-28</tms:InicioVigencia>
            <tms:FimVigencia>2018-09-17</tms:FimVigencia>
            <ValorPrevioCalculado>250.2</ValorPrevioCalculado>
            <tms:CompraSimples>false</tms:CompraSimples>
            <tms:IdOperacaoTransporte i:nil="true" />
            <tms:DadosComplementares>
               <tms:NomeUsuarioOperador i:nil="true" />
               <tms:CpfUsuarioOperador i:nil="true" />
               <tms:NomeFilialOperador i:nil="true" />
               <tms:CnpjFilialOperador i:nil="true" />
               <tms:LoginUsuarioOperador i:nil="true" />
            </tms:DadosComplementares>
            <tms:CargaDiferencial i:nil="true" />
         </tms:compraRequest>
      </tms:ComprarPedagioAvulso>
   </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/ComprarPedagioAvulsoResponse</Action>
  </s:Header>
  <s:Body>
    <ComprarPedagioAvulsoResponse xmlns="http://tmsfrete.v2.targetmp.com.br">
      <ComprarPedagioAvulsoResult xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
        <Erro i:nil="true" />
        <Mensagem>Compra Vale Pedágio Cartão efetuada com sucesso!</Mensagem>
        <IdCompraValePedagio>177796</IdCompraValePedagio>
        <ValorCompra>250.2</ValorCompra>
        <CodigoRegistroValePedagio>24220570</CodigoRegistroValePedagio>
      </ComprarPedagioAvulsoResult>
    </ComprarPedagioAvulsoResponse>
  </s:Body>
</s:Envelope>

Version	Old Version 7	New Version Current
Changes made by	Gabriel Nisã Brandão Casaes Monteiro	thiago.morais
Saved on	Aug 28, 2018	Jan 14, 2025

Versions Compared

Key

Fluxo Compra Vale Pedágio

Request

Request

Comprar Pedágio Avulso - Cartão

Comprar Pedágio Avulso - TAG

Comprar Pedágio Simples Avulso - Cartão

Page Comparison

Versions Compared

Key

Fluxo Compra Vale Pedágio

Request

Request

Comprar Pedágio Avulso - Cartão

Comprar Pedágio Avulso - TAG

Comprar Pedágio Simples Avulso - Cartão