DOCUMENTAÇÃO CORPORATIVA
DeclararOperacaoTransporte
- Gabriel Nisã Brandão Casaes Monteiro (Unlicensed)
- Raphael Santos (Unlicensed)
Objetivo
Esse método tem como objetivo realizar a declaração de uma Operação de Transporte na ANTT.
Observações Importantes
- Para realizar a Declaração da Operação de Transporte, a mesma deve estar com o Status - Em preenchimento (A Declarar).
- Obs. Para saber se o Status da Operação de Transporte está como Declarada, fazer o uso do método - BuscarOperacaoTransporte.
- 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º | Campo | Tipo | Obrigatório | Descrição | Observação |
|---|---|---|---|---|---|
| 1 | IdOperacaoTransporte | int | Sim | Id da Operação de Transporte | Retornamos o Id da Operação de Transporte no response do método - CadastrarAtualizarOperacaoTransporte. |
Response
| DeclaracaoOperacaoTransporteResponse | |||||
| Nº | Campo | Tipo | Obrigatório | Descrição | Observação |
|---|---|---|---|---|---|
| 1 | Erro | ErroResponse - string | Não | Retorna o Erro | NULO em caso de sucesso. |
| 2 | IdOperacaoTransporte | int | Sim | ID retornado da criação da Operação de Transportes. | N/A |
| 3 | DataHoraRegistro | Datetime (YYYY-MM-DD) | Sim | Data do Registro realizado. | Exemplo: (2018-08-20T10:05:33) |
| 4 | NumeroCIOT | string | Não | Número do CIOT emitido na ANTT. | N/A |
| 5 | ProtocoloCIOT | string | Não | Número de protocolo do registro. | N/A |
| 6 | DispensadoPelaANTT | bool (true || false) | Sim | Caso 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. |
| 7 | ObservacoesANTT | string | Não | Observações da ANTT | N/A |
| 8 | IdCompraValePedagio | int | Não | Id da Compra de Vale Pedágio realizada dentro do CIOT. | N/A |
| 9 | ModoCompraValePedagio | int | Sim | Modo Compra Vale Pedágio | 1= Cartão 2= TAG 'Sem Parar' 4= Nenhum |
| 10 | IdsParcelasOperacaoTransporte | list | Sim | Ids 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: |
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>