Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Objetivo

Esse método tem como objetivo realizar compras de Vale-Pedágio Cartão ou TAG Sem Parar, informando uma lista de Praças de Pedágio.

Info
titleObservações Importantes
  1. Compra de Vale-Pedágio TAG Sem Parar: 
    1. Não é possível realizar uma compra de Vale-Pedágio informando a 'Categoria Veículo' por Praça, essa função pode ser feita apenas para Vale-Pedágio Cartão.

Request

...

ID do meio de pagamento que sera utilizado na compra

...

1= Cartão Transportes Bradesco TARGET
2= Via Fácil (Sem Parar)

...

View file
nameCategoriaDeVeículos.xlsx
height250

...

1 = Maplink
2 = MaplinkDirecao
3 = SemParar
4 = Antt

//Cusotmizados
10 = NomePraca

...

Esses Ids da Praças são da TARGET.

Obs. Importante: Para mais informações sobre esses Ids,

favor entrar em contato com o Time de Integração.

...

CodigoCategoriaVeiuculoAlterada

...

View file
nameCategoriaDeVeículos.xlsx
height250

...

IdIntegrador

...

Id do Integrador

...

Id de controle do Integrador

...

Response

...

Retorna o Erro.

...

Método

Abaixo, segue o método - 'ComprarPedagioPorPracas'.

...

languagexml
themeRDark
firstline1
titleComprarPedagioPorPracasRequest
linenumberstrue

...

Objetivo

Esse método tem como objetivo realizar compras de Vale-Pedágio Cartão ou TAG Sem Parar, informando uma lista de Praças de Pedágio.


Info
titleObservações Importantes
  1. Compra de Vale-Pedágio TAG Sem Parar: 
    1. Não é possível realizar uma compra de Vale-Pedágio informando a 'Categoria Veículo' por Praça, essa função pode ser feita apenas para Vale-Pedágio Cartão.


Request

ComprarPedagioPorPracas
CampoTipoObrigatórioDescriçãoObservação
1IdModoCompraValePedagiointSim

ID do meio de pagamento que sera utilizado na compra

1= Cartão Transportes Bradesco TARGET
2= Via Fácil (Sem Parar)

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

View file
nameCategoriaDeVeículos.xlsx
height250

3PlacaStringSimPlaca do Veículo que será feita a compra.N/A
4IdTipoIdentificadorPracaIntSimId Tipo Identificador Praça

1 = Maplink
2 = MaplinkDirecao
3 = SemParar
4 = Antt


//Cusotmizados
10 = NomePraca

5IdPracaStringSimID das Praças

Esses Ids da Praças são da TARGET.


Obs. Importante: Para mais informações sobre esses Ids,

favor entrar em contato com o Time de Integração.

6

CodigoCategoriaVeiuculoAlterada

IntSimCódigo de Categoria do Veículo para qual a compra será alterada
View file
nameCategoriaDeVeículos.xlsx
height250
7InicioVigencia Datetime (YYYY-MM-DD)SimInicio da VigênciaExemplo: (2018-08-20T10:05:33)
8FimVigenciaDatetime (YYYY-MM-DD)SimFim da VigênciaExemplo: (2018-08-20T10:05:33)
9CodigoCentroDeCustoIntSImCódigo do centro de custoN/A
10NumeroDocumentoEmbarqueStringNãoNúmero do Documento de EmbarqueDeve ser informado pelo integrador/cliente.
11ItemFinanceiroStringSimItem FinanceiroN/A
12

IdIntegrador

StringSim

Id do Integrador

Id de controle do Integrador

13ValorPrevioCalculadoDecimalNãoValor Prévio CalculadoN/A
14NomeUsuarioOperadorString
Nome de Usuário do OperadorN/A
15CpfUsuarioOperadorString
CPF do Usuário do OperadorN/A
16NomeFilialOperadorString
Nome da Filial do OperadorN/A
17CnpjFilialOperadorString
CNPJ da Filial do OperadorN/A
18NumeroCartaoString
Número do CartãoN/A 
19MotoristaNomeString
Nome do motoristaN/A
20MotoristaCpfString
CPF do motoristaN/A
21MotoristaRNTRCString
RNTRC do motorista da operação de transporte.N/A


Response

ComprarPedagioPorPracasrResponse
CampoTipoObrigatórioDescriçãoObservação
1ErroErroResponse - stringNão

Retorna o Erro.

NULO em casa de sucesso.
2MensagemRetornostringSimMensagem indicando o tipo de retorno da função.N/A
3IdCompraValePedagiointSimId da Compra de Vale PedágioN/A
4ValorCompradecimalsimValor da Compra de Vale PedágioN/A
5CodigoRegistrovalePedagiointsimN/AN/A


Método

Abaixo, segue o método - 'ComprarPedagioPorPracas'.

Code Block
languagexml
themeRDark
firstline1
titleComprarPedagioPorPracasRequest
linenumberstrue
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tms="http://tmsfrete.v2.targetmp.com.br">
   <soapenv:Header/>
   <soapenv:Body>
      <tms:ComprarPedagioPorPracas>
         <tms:auth>
            <tms:Usuario>?</tms:Usuario>
            <tms:Senha>?</tms:Senha>
            <tms:Token>?</tms:Token>
         </tms:auth>
         <tms:compraPorPracaRequest>
            <tms:IdModoCompraValePedagio>?</tms:IdModoCompraValePedagio>
            <tms:CodigoCategoriaVeiculo>?</tms:CodigoCategoriaVeiculo>
            <tms:Placa>?</tms:Placa>
            <tms:IdsPracasPedagio>
                <tms:auth>IdentificadorPracaPedagio>
                  <tms:Usuario>IdTipoIdentificadorPraca>?</tms:Usuario>IdTipoIdentificadorPraca>
                  <tms:Senha>IdPraca>?</tms:Senha>IdPraca>
                  <tms:Token>CodigoCategoriaVeiculoAlterada>?</tms:Token>CodigoCategoriaVeiculoAlterada>
               </tms:auth>IdentificadorPracaPedagio>
            <tms</tms:compraPorPracaRequest>IdsPracasPedagio>
            <tms:IdModoCompraValePedagio>InicioVigencia>?</tms:IdModoCompraValePedagio>InicioVigencia>
            <tms:CodigoCategoriaVeiculo>FimVigencia>?</tms:CodigoCategoriaVeiculo>FimVigencia>
            <tms:Placa>CodigoCentroDeCusto>?</tms:Placa>CodigoCentroDeCusto>
            <tms:IdsPracasPedagio>NumeroDocumentoEmbarque>?</tms:NumeroDocumentoEmbarque>
            <tms:ItemFinanceiro>?</tms:ItemFinanceiro>
      <tms:IdentificadorPracaPedagio>      <tms:IdIntegrador>?</tms:IdIntegrador>
            <tms:IdTipoIdentificadorPraca>ValorPrevioCalculado>?</tms:IdTipoIdentificadorPraca>
  ValorPrevioCalculado>
               <tms:IdPraca>?</tms:IdPraca>DadosComplementares>
                  <tms:CodigoCategoriaVeiculoAlterada>NomeUsuarioOperador>?</tms:CodigoCategoriaVeiculoAlterada>NomeUsuarioOperador>
               <tms:CpfUsuarioOperador>?</tms:IdentificadorPracaPedagio>CpfUsuarioOperador>
               <tms:NomeFilialOperador>?</tms:IdsPracasPedagio>NomeFilialOperador>
               <tms:InicioVigencia>CnpjFilialOperador>?</tms:InicioVigencia>CnpjFilialOperador>
               <tms:FimVigencia>LoginUsuarioOperador>?</tms:FimVigencia>LoginUsuarioOperador>
            <tms:CodigoCentroDeCusto>?</tms:CodigoCentroDeCusto>DadosComplementares>
            <tms:NumeroDocumentoEmbarque>?</tms:NumeroDocumentoEmbarque>DadosPagamentoCartao>
               <tms:ItemFinanceiro>NumeroCartao>?</tms:ItemFinanceiro>NumeroCartao>
               <tms:IdIntegrador>MotoristaNome>?</tms:IdIntegrador>MotoristaNome>
               <tms:ValorPrevioCalculado>MotoristaCPF>?</tms:ValorPrevioCalculado>MotoristaCPF>
            <tms:DadosComplementares>   <tms:MotoristaRNTRC>?</tms:MotoristaRNTRC>
            <tms:NomeUsuarioOperador>?</tms:NomeUsuarioOperador>DadosPagamentoCartao>
          </tms:compraPorPracaRequest>
      <tms:CpfUsuarioOperador>?</tms:CpfUsuarioOperador>ComprarPedagioPorPracas>
               <tms:NomeFilialOperador>?</tms:NomeFilialOperador>
               <tms:CnpjFilialOperador>?</tms:CnpjFilialOperador>
               <tms:LoginUsuarioOperador>?</tms:LoginUsuarioOperador>
   </soapenv:Body>
</soapenv:Envelope>


Comprar Pedágio Por Praças

Abaixo, segue exemplo do método - 'ComprarPedagioPorPracas'.

Code Block
languagexml
themeRDark
firstline1
titleExemplo - ComprarPedagioPorPracaRequest
linenumberstrue
Request
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tms="http://tmsfrete.v2.targetmp.com.br">
   <soapenv:Header/>
   <soapenv:Body>
        </tms:DadosComplementares>
  <tms:ComprarPedagioPorPracas>
         <tms:DadosPagamentoCartao>
  auth>
            <tms:NumeroCartao>Usuario>?</tms:NumeroCartao>
 Usuario>
             <tms:MotoristaNome>Senha>?</tms:MotoristaNome>
 Senha>
             <tms:MotoristaCPF>Token>?</tms:MotoristaCPF>Token>
         </tms:auth>
         <tms:MotoristaRNTRC>?</tms:MotoristaRNTRC>compraPorPracaRequest>
            <tms:IdModoCompraValePedagio>?</tms:DadosPagamentoCartao>IdModoCompraValePedagio>
            <tms:CodigoCategoriaVeiculo>?</tms:compraPorPracaRequest>
  CodigoCategoriaVeiculo>
   </tms:ComprarPedagioPorPracas>    </soapenv:Body>
</soapenv:Envelope>

Comprar Pedágio Por Praças

Abaixo, segue exemplo do método - 'ComprarPedagioPorPracas'.

Code Block
languagexml
themeRDark
firstline1
titleExemplo - ComprarPedagioPorPracaRequest
linenumberstrue
Request
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tms="http://tmsfrete.v2.targetmp.com.br">
   <soapenv:Header/>
   <soapenv:Body>     <tms:Placa>?</tms:Placa>
            <tms:IdsPracasPedagio>
      <tms:ComprarPedagioPorPracas>
         <tms:auth>IdentificadorPracaPedagio>
                  <tms:Usuario>IdTipoIdentificadorPraca>?</tms:Usuario>IdTipoIdentificadorPraca>
                  <tms:Senha>IdPraca>?</tms:Senha>IdPraca>
                  <tms:Token>CodigoCategoriaVeiculoAlterada>?</tms:Token>CodigoCategoriaVeiculoAlterada>
               </tms:auth>IdentificadorPracaPedagio>
            <tms</tms:compraPorPracaRequest>IdsPracasPedagio>
            <tms:IdModoCompraValePedagio>InicioVigencia>?</tms:IdModoCompraValePedagio>InicioVigencia>
            <tms:CodigoCategoriaVeiculo>FimVigencia>?</tms:CodigoCategoriaVeiculo>FimVigencia>
            <tms:Placa>CodigoCentroDeCusto>?</tms:Placa>CodigoCentroDeCusto>
            <tms:IdsPracasPedagio>
  NumeroDocumentoEmbarque>?</tms:NumeroDocumentoEmbarque>
            <tms:IdentificadorPracaPedagio>
     ItemFinanceiro>?</tms:ItemFinanceiro>
            <tms:IdTipoIdentificadorPraca>IdIntegrador>?</tms:IdTipoIdentificadorPraca>
  IdIntegrador>
               <tms:IdPraca>ValorPrevioCalculado>?</tms:IdPraca>
     ValorPrevioCalculado>
            <tms:CodigoCategoriaVeiculoAlterada>?</tms:CodigoCategoriaVeiculoAlterada>DadosComplementares>
               <tms:NomeUsuarioOperador>?</tms:IdentificadorPracaPedagio>NomeUsuarioOperador>
               <tms:CpfUsuarioOperador>?</tms:IdsPracasPedagio>CpfUsuarioOperador>
               <tms:InicioVigencia>NomeFilialOperador>?</tms:InicioVigencia>NomeFilialOperador>
               <tms:FimVigencia>CnpjFilialOperador>?</tms:FimVigencia>CnpjFilialOperador>
               <tms:CodigoCentroDeCusto>LoginUsuarioOperador>?</tms:CodigoCentroDeCusto>LoginUsuarioOperador>
            <tms:NumeroDocumentoEmbarque>?</tms:NumeroDocumentoEmbarque>DadosComplementares>
            <tms:ItemFinanceiro>?</tms:ItemFinanceiro><tms:DadosPagamentoCartao>
               <tms:IdIntegrador>NumeroCartao>?</tms:IdIntegrador>NumeroCartao>
               <tms:ValorPrevioCalculado>MotoristaNome>?</tms:ValorPrevioCalculado>MotoristaNome>
               <tms:DadosComplementares>MotoristaCPF>?</tms:MotoristaCPF>
               <tms:NomeUsuarioOperador>MotoristaRNTRC>?</tms:NomeUsuarioOperador>
  MotoristaRNTRC>
            <tms:CpfUsuarioOperador>?</tms:CpfUsuarioOperador>DadosPagamentoCartao>
         </tms:compraPorPracaRequest>
      <tms:NomeFilialOperador>?</tms:NomeFilialOperador>
 :ComprarPedagioPorPracas>
   </soapenv:Body>
</soapenv:Envelope>
        <tms:CnpjFilialOperador>?</tms:CnpjFilialOperador>        

      <tms:LoginUsuarioOperador>?</tms:LoginUsuarioOperador>      

Response

   </tms:DadosComplementares><s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Body>
        <tms:DadosPagamentoCartao><ComprarPedagioPorPracasResponse xmlns="http://tmsfrete.v2.targetmp.com.br">
               <tms:NumeroCartao>?</tms:NumeroCartao><ComprarPedagioPorPracasResult xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
            <Erro   <tms:MotoristaNome>?</tms:MotoristaNome>i:nil="true"/>
            <Mensagem>Compra Vale  <tms:MotoristaCPF>?</tms:MotoristaCPF>
               <tms:MotoristaRNTRC>?</tms:MotoristaRNTRC>Pedágio Via Fácil efetuada com sucesso!</Mensagem>
            <<IdCompraValePedagio>2994</tms:DadosPagamentoCartao>IdCompraValePedagio>
         </tms:compraPorPracaRequest>       </tms:ComprarPedagioPorPracas><ValorCompra>24.9</ValorCompra>
   </soapenv:Body> </soapenv:Envelope>        <CodigoRegistroValePedagio>27296588</CodigoRegistroValePedagio>
         </ComprarPedagioPorPracasResult>
      </ComprarPedagioPorPracasResponse>
     

Response</s:Body>
</s:Envelope>