Versions Compared

Version Old Version 1 New Version Current
Changes made by

Gabriel Nisã Brandão Casaes Monteiro (Unlicensed)

Raphael Santos (Unlicensed)

Saved on

Key

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

Objetivo

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


Info
titleObservaçõ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
Nº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
Nº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'

4= Nenhum

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

Code Block
languagexml
themeRDark
firstline1
titleDeclararOperacaoTransporteRequest
linenumberstrue
<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.

Code Block
languagexml
themeRDark
firstline1
titleDeclararOperacaoTransporteRequest
linenumberstrue
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>