Objetivo

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

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.

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

Nº	Campo	Tipo	Obrigatório	Descrição	Observação
CompraValePedagioRequest
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
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.
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. 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. 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

CompraValePedagioRequest

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

Exemplo Pedágio Cartão - CompraValePedagioRequest

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

Exemplo Pedágio TAG - CompraValePedagioRequest

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

Exemplo Pedágio Simples Cartão - CompraValePedagioRequest

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>