DOCUMENTAÇÃO CORPORATIVA

ComprarPedagioPorPracas

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.


Observaçõ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)

5= Veloe

6= ConectCar

7= Move Mais

8= Cartão Débito

9= Taggy

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

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
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 
19MotoristaNomeStringSimNome do motoristaN/A
20MotoristaCpfStringSimCPF do motoristaN/A
21MotoristaRNTRCStringApenas caso o motorista possua um RNTRCRNTRC 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'.

ComprarPedagioPorPracasRequest
<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:IdentificadorPracaPedagio>
                  <tms:IdTipoIdentificadorPraca>?</tms:IdTipoIdentificadorPraca>
                  <tms:IdPraca>?</tms:IdPraca>
                  <tms:CodigoCategoriaVeiculoAlterada>?</tms:CodigoCategoriaVeiculoAlterada>
               </tms:IdentificadorPracaPedagio>
            </tms:IdsPracasPedagio>
            <tms:InicioVigencia>?</tms:InicioVigencia>
            <tms:FimVigencia>?</tms:FimVigencia>
            <tms:CodigoCentroDeCusto>?</tms:CodigoCentroDeCusto>
            <tms:NumeroDocumentoEmbarque>?</tms:NumeroDocumentoEmbarque>
            <tms:ItemFinanceiro>?</tms:ItemFinanceiro>
            <tms:IdIntegrador>?</tms:IdIntegrador>
            <tms:ValorPrevioCalculado>?</tms:ValorPrevioCalculado>
            <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:DadosPagamentoCartao>
               <tms:NumeroCartao>?</tms:NumeroCartao>
               <tms:MotoristaNome>?</tms:MotoristaNome>
               <tms:MotoristaCPF>?</tms:MotoristaCPF>
               <tms:MotoristaRNTRC>?</tms:MotoristaRNTRC>
            </tms:DadosPagamentoCartao>
         </tms:compraPorPracaRequest>
      </tms:ComprarPedagioPorPracas>
   </soapenv:Body>
</soapenv:Envelope>


Comprar Pedágio Por Praças

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

Exemplo - ComprarPedagioPorPracaRequest
Request
<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 i:nil="true">
         </tms:auth>
         <tms:compraPorPracaRequest>
            <tms:IdModoCompraValePedagio>?</tms:IdModoCompraValePedagio>
            <tms:CodigoCategoriaVeiculo>?</tms:CodigoCategoriaVeiculo>
            <tms:Placa>?</tms:Placa>
            <tms:IdsPracasPedagio>
               <tms:IdentificadorPracaPedagio>
                  <tms:IdTipoIdentificadorPraca>?</tms:IdTipoIdentificadorPraca>
                  <tms:IdPraca>?</tms:IdPraca>
                  <tms:CodigoCategoriaVeiculoAlterada>?</tms:CodigoCategoriaVeiculoAlterada>
               </tms:IdentificadorPracaPedagio>
            </tms:IdsPracasPedagio>
            <tms:InicioVigencia>?</tms:InicioVigencia>
            <tms:FimVigencia>?</tms:FimVigencia>
            <tms:CodigoCentroDeCusto>?</tms:CodigoCentroDeCusto>
            <tms:NumeroDocumentoEmbarque>?</tms:NumeroDocumentoEmbarque>
            <tms:ItemFinanceiro>?</tms:ItemFinanceiro>
            <tms:IdIntegrador>?</tms:IdIntegrador>
            <tms:ValorPrevioCalculado>?</tms:ValorPrevioCalculado>
            <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:DadosPagamentoCartao>
               <tms:NumeroCartao>?</tms:NumeroCartao>
               <tms:MotoristaNome>?</tms:MotoristaNome>
               <tms:MotoristaCPF>?</tms:MotoristaCPF>
               <tms:MotoristaRNTRC>?</tms:MotoristaRNTRC>
            </tms:DadosPagamentoCartao>
         </tms:compraPorPracaRequest>
      </tms:ComprarPedagioPorPracas>
   </soapenv:Body>
</soapenv:Envelope>