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 12 Current »

Objetivo

Esse método tem como objetivo realizar a declaração de uma Operação de Transporte na ANTT.


Observações Importantes

  1. Para realizar a Declaração da Operação de Transporte, a mesma deve estar com o Status - Em preenchimento (A Declarar).
    1. Obs. Para saber se o Status da Operação de Transporte está como Declarada, fazer o uso do método - BuscarOperacaoTransporte.
  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

DeclaracaoOperacaoTransporteRequest
CampoTipoObrigatórioDescriçãoObservação
1IdOperacaoTransporteintSimId da Operação de Transporte

Retornamos o Id da Operação de Transporte

no response do método - CadastrarAtualizarOperacaoTransporte.

Response

DeclaracaoOperacaoTransporteResponse
CampoTipoObrigatórioDescriçãoObservação
1ErroErroResponse - stringNãoRetorna o ErroNULO em caso de sucesso.
2IdOperacaoTransporteintSimID retornado da criação da Operação de Transportes.N/A
3DataHoraRegistroDatetime (YYYY-MM-DD)SimData do Registro realizado.Exemplo: (2018-08-20T10:05:33)
4NumeroCIOTstringNãoNúmero do CIOT emitido na ANTT.N/A
5ProtocoloCIOTstringNãoNúmero de protocolo do registro.N/A
6DispensadoPelaANTTbool (true || false)SimCaso a Operação de Transportes não necessite de CIOT.Quando for retornado true, a TARGET não gerará o número do CIOT, pois o mesmo não é obrigatório segundo a resolução da ANTT.
7ObservacoesANTTstringNãoObservações da ANTTN/A
8IdCompraValePedagiointNãoId da Compra de Vale Pedágio realizada dentro do CIOT.N/A
9ModoCompraValePedagiointSimModo Compra Vale Pedágio

1= Cartão

2= TAG 'Sem Parar'

10IdsParcelasOperacaoTransportelistSimIds das Parcelas da Operação de Transporte

Retornamos o Ids das Parcelas criadas na Operação de Transporte.

Esses Ids são usados nos seguintes métodos:

  1. PagarParcelaIndividual
  2. EncerrarOperacaoTransporte
  3. RetificarOperacaoTransporte

Método

Abaixo, segue método - 'DeclaracaoOperacaoTransporte'.

DeclararOperacaoTransporteRequest
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tms="http://tmsfrete.v2.targetmp.com.br">
   <soapenv:Header/>
   <soapenv:Body>
      <tms:DeclararOperacaoTransporte>
         <tms:auth>
            <tms:Usuario>?</tms:Usuario>
            <tms:Senha>?</tms:Senha>
            <tms:Token>?</tms:Token>
         </tms:auth>
         <tms:declaracao>
            <tms:IdOperacaoTransporte>?</tms:IdOperacaoTransporte>
         </tms:declaracao>
      </tms:DeclararOperacaoTransporte>
   </soapenv:Body>
</soapenv:Envelope>


Declarar Operação Transporte

Abaixo, segue exemplo do método Declarar Operação Transporte.

DeclararOperacaoTransporteRequest
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:DeclararOperacaoTransporte>
         <tms:auth>
            <tms:Usuario>tms.exemplo</tms:Usuario>
            <tms:Senha>v0hXPrwerKblaBs=</tms:Senha>
            <tms:Token i:nil="true" />
         </tms:auth>
         <tms:declaracao>
            <tms:IdOperacaoTransporte>136280</tms:IdOperacaoTransporte>
         </tms:declaracao>
      </tms:DeclararOperacaoTransporte>
   </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/DeclararOperacaoTransporteResponse</Action>
  </s:Header>
  <s:Body>
    <DeclararOperacaoTransporteResponse xmlns="http://tmsfrete.v2.targetmp.com.br">
      <DeclararOperacaoTransporteResult xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
        <Erro i:nil="true" />
        <IdOperacaoTransporte>136280</IdOperacaoTransporte>
        <DataHoraRegistro>2018-08-30T09:35:56</DataHoraRegistro>
        <NumeroCIOT>188000061610</NumeroCIOT>
        <ProtocoloCIOT>6019</ProtocoloCIOT>
        <DispensadoPelaANTT>false</DispensadoPelaANTT>
        <ObservacoesANTT />
        <IdCompraValePedagio i:nil="true" />
        <ModoCompraValePedagio>4</ModoCompraValePedagio>
        <IdsParcelasOperacaoTransporte xmlns:d5p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
          <d5p1:int>210272</d5p1:int>
          <d5p1:int>210273</d5p1:int>
        </IdsParcelasOperacaoTransporte>
      </DeclararOperacaoTransporteResult>
    </DeclararOperacaoTransporteResponse>
  </s:Body>
</s:Envelope>
  • No labels