Objetivo

Realizar compras de Vale Pedágio Cartão ou TAG - 'Sem Parar'.

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

5= PedagioTagVeloe

6= PedagioTagConectCar

7= PedagioTagMoveMais

8= Cartão Débito

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.

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

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.

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

Response

Nº	Campo	Tipo	Obrigatório	Descrição	Observação
CompraValePedagioResponse
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
3	IdCompraValePedagio	int	sim	Id da Compra de Vale Pedágio	Esse ID deve ser armazenado. Pode ser utilizado depois para obter o valor da compra do Vale Pedágio no método ComprarPedagioAvulso e no ConfirmarPedagioTAG.
4	ValorCompra	decimal	sim		N/A

Método

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 23	New Version 24
Changes made by	thiago.morais	thiago.morais
Saved on	Aug 13, 2024	Aug 13, 2024

Versions Compared

Key

Objetivo

Fluxo Compra Vale Pedágio

Request

Request

Response

Método

Comprar Pedágio Avulso - Cartão

Comprar Pedágio Avulso - TAG

Comprar Pedágio Simples Avulso - Cartão

Page Comparison

Versions Compared

Key

Objetivo

Fluxo Compra Vale Pedágio

Request

Request

Response

Método

Comprar Pedágio Avulso - Cartão

Comprar Pedágio Avulso - TAG

Comprar Pedágio Simples Avulso - Cartão