DOCUMENTAÇÃO CORPORATIVA

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 15 Current »

Objetivo

Esse método realiza o cancelamento das Compras de Vale Pedágio Cartão e TAG.


Vale Pedágio - Cartão

  1. Compra do Vale Pedágio Avulso Cartão realizada, porém o Cartão não foi carregado através do Sistemas NUMMUS.
    1. Resposta: Não haverá validações para esse cenário, o usuário conseguirá cancelar o mesmo com sucesso. O dinheiro da compra se manterá na conta do cliente.
  2. Compra do Vale Pedágio Avulso Cartão realizada, porém o Cartão foi carregado através do Sistema NUMMUS.
    1. Resposta: O cancelamento da compra será realizado com sucesso, porém caso o cliente deseje efetuar o estorno da carga realizada, favor respeitar o processo da pergunta abaixo.
  3. Como conseguir o estorno do valor que foi carregado no Cartão quando a compra do Vale Pedágio foi cancelada?
    1. Resposta: Entrar em contato com a TARGET para realizarmos o processo de estorno junto ao Bradesco.

Vale Pedágio - TAG

  1. Compra do Vale Pedágio Avulso TAG realizada, porém a confirmação de carregamento da TAG não foi feita através do método - ConfirmarPedagioTAG.
    1. Resposta: Não haverá validações para esse cenário, o usuário conseguirá cancelar o mesmo com sucesso. O dinheiro da compra se manterá na conta do cliente.
  2. Compra do Vale Pedágio Avulso TAG realizada, porém a confirmação de carregamento da TAG foi realizada através do método - ConfirmarPedagioTAG.
    1. Resposta: O cancelamento da compra só poderá ser realizado se o mesmo for feito até no máximo 3h após da compra, caso o motorista passe por uma praça de pedágio no período das 3h, o usuário não conseguirá realizar o cancelamento da compra.
    2. Resposta: Se o cancelamento for realizado em até 3h, o estorno será feito para a conta do cliente.

Observação

  1. Caso uma Operação de Transporte haja uma compra de Vale Pedágio Cartão (que o mesmo não foi carregado através do Sistema NUMMUS) ou caso haja uma compra de Vale Pedágio TAG 'Sem Parar' (que não tenha sido confirmado através do método - ConfirmarPedagioTAG), o método - CancelarOperacaoTransporte irá cancelar essas compras de Vale Pedágio automaticamente. Se as compras de Vale Pedágio Cartão ou TAG estiverem sido confirmadas, o método - CancelarOperacaoTransporte não irá cancelar as compras de Vale Pedágio automaticamente, será necessário invocar o método - CancelarCompraValePedagio.
  2. 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.


Request

CancelaCompraValePedagioRequest
CampoTipoObrigatórioDescriçãoObservação
1IdCompraValePedagiointSimID de vale pedágio obtido no momento da compra.N/A
2ViaFacilbool(true || false)NãoFiltro - Via Fácil ou Cartão TargetN/A

Response

CancelaCompraValePedagioResponse
CampoTipoObrigatórioDescriçãoObservação
1ErroErroResponse - stringNãoMensagem de Erro.NULO em caso de sucesso.
2MensagemstringSimMensagem de retorno da operação.N/A

Método

CancelarCompraValePedagioRequest
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tms="http://tmsfrete.v2.targetmp.com.br">
   <soapenv:Header/>
   <soapenv:Body>
      <tms:CancelarCompraValePedagio>
         <tms:auth>
            <tms:Usuario>?</tms:Usuario>
            <tms:Senha>?</tms:Senha>
            <tms:Token>?</tms:Token>
         </tms:auth>
         <tms:cancelaVPRequest>
            <tms:IdCompraValePedagio>?</tms:IdCompraValePedagio>
            <tms:ViaFacil>?</tms:ViaFacil>
         </tms:cancelaVPRequest>
      </tms:CancelarCompraValePedagio>
   </soapenv:Body>
</soapenv:Envelope>

Cancelar Compra Vale Pedágio

Abaixo, segue exemplo para cancelar a compra de um Vale Pedágio.

CancelaCompraValePedagioRequest
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:CancelarCompraValePedagio>
         <tms:auth>
            <tms:Usuario>tms.exemplo</tms:Usuario>
            <tms:Senha>v0hXPrwerKblaBs=</tms:Senha>
            <tms:Token i:nil="true" />
         </tms:auth>
         <tms:cancelaVPRequest>
            <tms:IdCompraValePedagio>173561</tms:IdCompraValePedagio>
            <tms:ViaFacil>false</tms:ViaFacil>
         </tms:cancelaVPRequest>
      </tms:CancelarCompraValePedagio>
   </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/CancelarCompraValePedagioResponse</Action>
  </s:Header>
  <s:Body>
    <CancelarCompraValePedagioResponse xmlns="http://tmsfrete.v2.targetmp.com.br">
      <CancelarCompraValePedagioResult xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
        <Erro i:nil="true" />
        <Mensagem>Cancelamento realizado com sucesso!</Mensagem>
      </CancelarCompraValePedagioResult>
    </CancelarCompraValePedagioResponse>
  </s:Body>
</s:Envelope>
  • No labels