DOCUMENTAÇÃO CORPORATIVA

RetificarOperacaoTransporte

Objetivo

Esse método tem como objetivo retificar uma Operação de Transporte.


Observações Importantes

  1. APENAS OPERAÇÕES DO TIPO TAC-AGREGADO PODERÃO SER RETIFICADAS, OPERAÇÕES TIPO PADRÃO NÃO PODERÃO MAIS SER RETIFICADAS, DE ACORDO COM NOVA LEGISLAÇÃO DA ANTT.
  2. Uma Operação só pode ser retificada em até 24h depois da Data e Hora de Início da Viagem.
  3. 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

RetificacaoOperacaoTransporteRequest
CampoTipoObrigatórioDescriçãoObservação
1IdOperacaoTransporteintSimId Operação de TransporteN/A
2NCMstringSimCódigo de 4 caracteres que identifica a Natureza carga posição previsto pelo SH (Sistema Harmonizado) exigido
pela ANTT.
3PesoCargadecimalSimPeso da Carga transportadaN/A
4MunicipioOrigemCodigoIBGEintSimCódigo do IBGE referente ao município de origem.N/A
5MunicipioDestinoCodigoIBGEintSimCódigo do IBGE referente ao município de destino.N/A
6DataHoraInicioDateTime(YYYY-MM-DD)SimData Hora Início da OperaçãoExemplo: (2018-08-20T10:05:33)
7DataHoraTerminoDateTime(YYYY-MM-DD)SimData Hora Fim da OperaçãoExemplo: (2018-08-20T10:05:33)
8ValoresList<RetificacaoValoresRequest>SimValoresN/A
9VeículosList<OperacaoTransporteVeiculoRequest>SimVeículos da Operação de TransporteN/A
10CEPOrigemstringNãoCEP OrigemN/A
11CEPDestinostringNãoCEP DestinoN/A
12TipoCargaANTTintNãoTipo Carga ANTTGranelSolido = 1
GranelLiquido = 2
Frigorificada = 3
Conteinerizada = 4
CargaGeral = 5
Neogranel = 6
PerigosaGranelSolido = 7
PerigosaGranelLiquido = 8
PerigosaCargaFrigorificada = 9
PerigosaConteinerizada = 10
PerigosaCargaGeral = 11
13DistanciaPercorridaintNãoDistância PercorridaN/A
RetificacaoValoresRequest
CampoTipoObrigatórioDescriçãoObservação
1ValorFretedecimalSimValor do Frete contratadoN/A
2ValorCombustiveldecimalSimValor do CombustívelN/A
3ValorPedagiodecimalSimValor PedágioN/A
4ValorDespesasdecimalSimValor das DespesasN/A
5ValorImpostoSestSenatdecimalSimValor Imposto Sest SenatN/A
6ValorImpostoIRRFdecimalSimValor Imposto IRRFN/A
7ValorImpostoINSSdecimalSimValor Imposto INSSN/A
8ValorImpostoIcmsIssqndecimalSimValor Imposto Icms IssqnN/A
9ValorDescontoAntecipadodecimalSimValor Desconto AntecipadoN/A
10ValorAjusteCombustiveldecimalSimValor Ajuste CombustívelN/A
11ValorAjusteServicosdecimalSimValor Ajuste ServiçosN/A
12ValorAjusteManutencaodecimalSimValor Ajuste ManutençãoN/A
13ValorAjusteOutrosdecimalSimValor Ajuste OutrosN/A
14DeduzirImpostosbool (true || false)SimDeduzir ImpostosN/A
15TarifasBancariasdecimalSimTarifas BancáriasN/A
16QuantidadeTarifasBancariasintNãoQuantidade Tarifas BancáriasN/A
17ParcelasList<OperacaoTransporteParcelaRequest>SimParcelasN/A
18ValorImpostoISSdecimalNãoValor do Imposto ISSN/A
OperacaoTransporteParcelaRequest
CampoTipoObrigatórioDescriçãoObservação
1DescricaoParcelastringSimDescrição da ParcelaN/A
2ValordecimalSimValor da ParcelaN/A
3NumeroParcelaintSimNúmero da ParcelaN/A
4DataVencimentoDatetime (YYYY-MM-DD)SimData de Vencimento da ParcelaExemplo: (2018-08-20T10:05:33)
5TipoDaParcelaintSim

           Tipo da Parcela

1= Adiantamento

2= Intermediária

3= Saldo

4= Adicional

6FormaPagamentointSimForma de Pagamento da Parcela

1= Cartão Target Conta Digital ou Bradesco

2= Depósito Conta

7CartaoPagamentostringNãoNúmero do Cartão para destino do pagamento da Operação de Transporte.Obrigatório se Forma Pagamento = 1
8CodigoBancostringNãoCódigo do banco de compensaçãoObrigatório Se Forma Pagamento = 2
9AgenciaDepositostringNãoAgência da rede bancária onde será realizado o pagamento.Obrigatório Se Forma Pagamento = 2
10ContaDepositostringNãoConta da agência onde será realizado o pagamento.Obrigatório Se Forma Pagamento = 2
11DigitoContaDepositostringNãoDigito verificador da conta que será realizado o pagamento.Obrigatório Se Forma Pagamento = 2
12ProcessarAutomaticamentebool (true || false)SimIndica se a parcela em questão será processada automaticamente na data de vencimento informada ou será paga manualmente
no Sistema TARGET Frete.
N/A
13IdOperacaoTransporteParcelaintNãoIdentificador de Parcela de Operação de Transporte no Sistema TARGET Frete.N/A
14FlagContaPoupancabool (true || false)SimFlag que indica se é uma conta Poupança ou não.Caso a forma de pagamento seja através do Cartão TARGET Bradesco, deverá ser informado false nesta TAG.
15VariacaoContaPoupancastringNãoVariação da Conta Poupança (caso seja uma).N/A
16ItemFinanceiroParcelastringNãoItem Financeiro ParcelaN/A
OperacaoTransporteVeiculoRequest
CampoTipoObrigatórioDescriçãoObservação
1PlacastringSimPlaca do VeículoN/A
2RNTRCstringSimRNTRC no qual o Veículo está associado.N/A

Response

RetificacaoOperacaoTransporteResponse
CampoTipoObrigatórioDescriçãoObservação
1ErroErroResponse - stringNãoRetorna o ErroNULO em caso de sucesso.
2IdOperacaoTransporteintSimId da Operação de TransporteN/A
3IdRetificacaoOperacaoTransporteintSimId Retificação da Operação de TransporteN/A
4DataHoraRetificacaoDateTime(YYYY-MM-DD)SimData e Hora da RetificaçãoExemplo: (2018-08-20T10:05:33)

Método

Abaixo, segue método - 'RetificarOperacaoTransporte'.

RetificacaoOperacaoTransporteRequest
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tms="http://tmsfrete.v2.targetmp.com.br">
   <soapenv:Header/>
   <soapenv:Body>
      <tms:RetificarOperacaoTransporte>
         <tms:auth>
            <tms:Usuario>?</tms:Usuario>
            <tms:Senha>?</tms:Senha>
            <tms:Token>?</tms:Token>
         </tms:auth>
         <tms:retificacao>
            <tms:IdOperacaoTransporte>?</tms:IdOperacaoTransporte>
            <tms:NCM>?</tms:NCM>
            <tms:PesoCarga>?</tms:PesoCarga>
            <tms:MunicipioOrigemCodigoIBGE>?</tms:MunicipioOrigemCodigoIBGE>
            <tms:MunicipioDestinoCodigoIBGE>?</tms:MunicipioDestinoCodigoIBGE>
            <tms:DataHoraInicio>?</tms:DataHoraInicio>
            <tms:DataHoraTermino>?</tms:DataHoraTermino>
            <tms:Valores>
               <tms:ValorFrete>?</tms:ValorFrete>
               <tms:ValorCombustivel>?</tms:ValorCombustivel>
               <tms:ValorPedagio>?</tms:ValorPedagio>
               <tms:ValorDespesas>?</tms:ValorDespesas>
               <tms:ValorImpostoSestSenat>?</tms:ValorImpostoSestSenat>
               <tms:ValorImpostoIRRF>?</tms:ValorImpostoIRRF>
               <tms:ValorImpostoINSS>?</tms:ValorImpostoINSS>
               <tms:ValorImpostoIcmsIssqn>?</tms:ValorImpostoIcmsIssqn>
               <tms:ValorDescontoAntecipado>?</tms:ValorDescontoAntecipado>
               <tms:ValorAjusteCombustivel>?</tms:ValorAjusteCombustivel>
               <tms:ValorAjusteServicos>?</tms:ValorAjusteServicos>
               <tms:ValorAjusteManutencao>?</tms:ValorAjusteManutencao>
               <tms:ValorAjusteOutros>?</tms:ValorAjusteOutros>
               <tms:DeduzirImpostos>?</tms:DeduzirImpostos>
               <tms:TarifasBancarias>?</tms:TarifasBancarias>
               <tms:QuantidadeTarifasBancarias>?</tms:QuantidadeTarifasBancarias>
               <tms:Parcelas>
                  <tms:OperacaoTransporteParcelaRequest>
                     <tms:DescricaoParcela>?</tms:DescricaoParcela>
                     <tms:Valor>?</tms:Valor>
                     <tms:NumeroParcela>?</tms:NumeroParcela>
                     <tms:DataVencimento>?</tms:DataVencimento>
                     <tms:TipoDaParcela>?</tms:TipoDaParcela>
                     <tms:FormaPagamento>?</tms:FormaPagamento>
                     <tms:CartaoPagamento>?</tms:CartaoPagamento>
                     <tms:CodigoBanco>?</tms:CodigoBanco>
                     <tms:AgenciaDeposito>?</tms:AgenciaDeposito>
                     <tms:ContaDeposito>?</tms:ContaDeposito>
                     <tms:DigitoContaDeposito>?</tms:DigitoContaDeposito>
                     <tms:ProcessarAutomaticamente>?</tms:ProcessarAutomaticamente>
                     <tms:IdOperacaoTransporteParcela>?</tms:IdOperacaoTransporteParcela>
                     <tms:FlagContaPoupanca>?</tms:FlagContaPoupanca>
                     <tms:VariacaoContaPoupanca>?</tms:VariacaoContaPoupanca>
                     <tms:ItemFinanceiroParcela>?</tms:ItemFinanceiroParcela>
                  </tms:OperacaoTransporteParcelaRequest>
               </tms:Parcelas>
            </tms:Valores>
            <tms:Veiculos>
               <tms:OperacaoTransporteVeiculoRequest>
                  <tms:Placa>?</tms:Placa>
                  <tms:RNTRC>?</tms:RNTRC>
               </tms:OperacaoTransporteVeiculoRequest>
            </tms:Veiculos>
			<tms:CEPOrigem>?</tms:CEPOrigem>
            <tms:CEPDestino>?</tms:CEPDestino>
            <tms:TipoCargaANTT>?</tms:TipoCargaANTT>
            <tms:DistanciaPercorrida >?</tms:DistanciaPercorrida>
         </tms:retificacao>
      </tms:RetificarOperacaoTransporte>
   </soapenv:Body>
</soapenv:Envelope>


Retificar Operação Transporte

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

Exemplo - RetificacaoOperacaoTransporteRequest
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:RetificarOperacaoTransporte>
         <tms:auth>
            <tms:Usuario>tms.exemplo</tms:Usuario>
            <tms:Senha>v0hXPrwerKblaBs=</tms:Senha>
            <tms:Token i:nil="true" />
         </tms:auth>
         <tms:retificacao>
            <tms:IdOperacaoTransporte>135630</tms:IdOperacaoTransporte>
            <tms:NCM>1201.90.00</tms:NCM>
            <tms:PesoCarga>31990</tms:PesoCarga>
            <tms:MunicipioOrigemCodigoIBGE>4314308</tms:MunicipioOrigemCodigoIBGE>
            <tms:MunicipioDestinoCodigoIBGE>4306106</tms:MunicipioDestinoCodigoIBGE>
            <tms:DataHoraInicio>2018-08-28T18:04:08</tms:DataHoraInicio>
            <tms:DataHoraTermino>2018-09-07T17:59:08</tms:DataHoraTermino>
            <tms:Valores>
               <tms:ValorFrete>332.11</tms:ValorFrete>
               <tms:ValorCombustivel>0</tms:ValorCombustivel>
               <tms:ValorPedagio>0</tms:ValorPedagio>
               <tms:ValorDespesas>0</tms:ValorDespesas>
               <tms:ValorImpostoSestSenat>0</tms:ValorImpostoSestSenat>
               <tms:ValorImpostoIRRF>0</tms:ValorImpostoIRRF>
               <tms:ValorImpostoINSS>0</tms:ValorImpostoINSS>
               <tms:ValorImpostoIcmsIssqn>0</tms:ValorImpostoIcmsIssqn>
               <tms:ValorDescontoAntecipado>0</tms:ValorDescontoAntecipado>
               <tms:ValorAjusteCombustivel>0</tms:ValorAjusteCombustivel>
               <tms:ValorAjusteServicos>0</tms:ValorAjusteServicos>
               <tms:ValorAjusteManutencao>0</tms:ValorAjusteManutencao>
               <tms:ValorAjusteOutros>0</tms:ValorAjusteOutros>
               <tms:DeduzirImpostos>true</tms:DeduzirImpostos>
               <tms:TarifasBancarias>0</tms:TarifasBancarias>
               <tms:QuantidadeTarifasBancarias>0</tms:QuantidadeTarifasBancarias>
               <tms:Parcelas>
                  <tms:OperacaoTransporteParcelaRequest>
                     <tms:DescricaoParcela>Saldo</tms:DescricaoParcela>
                     <tms:Valor>332.11</tms:Valor>
                     <tms:NumeroParcela>1</tms:NumeroParcela>
                     <tms:DataVencimento>2018-08-28T18:04:08</tms:DataVencimento>
                     <tms:TipoDaParcela>3</tms:TipoDaParcela>
                     <tms:FormaPagamento>1</tms:FormaPagamento>
                     <tms:CartaoPagamento>4417811608776018</tms:CartaoPagamento>
                     <tms:CodigoBanco i:nil="true" />
                     <tms:AgenciaDeposito i:nil="true" />
                     <tms:ContaDeposito i:nil="true" />
                     <tms:DigitoContaDeposito i:nil="true" />
                     <tms:ProcessarAutomaticamente>false</tms:ProcessarAutomaticamente>
                     <tms:IdOperacaoTransporteParcela>209312</tms:IdOperacaoTransporteParcela>
                     <tms:FlagContaPoupanca>false</tms:FlagContaPoupanca>
                     <tms:VariacaoContaPoupanca i:nil="true" />
                     <tms:ItemFinanceiroParcela>3924</tms:ItemFinanceiroParcela>
                  </tms:OperacaoTransporteParcelaRequest>
               </tms:Parcelas>
            </tms:Valores>
            <tms:Veiculos>
               <tms:OperacaoTransporteVeiculoRequest>
                  <tms:Placa>IIA0048</tms:Placa>
                  <tms:RNTRC>10678468</tms:RNTRC>
               </tms:OperacaoTransporteVeiculoRequest>
               <tms:OperacaoTransporteVeiculoRequest>
                  <tms:Placa>IHH5225</tms:Placa>
                  <tms:RNTRC>10678468</tms:RNTRC>
               </tms:OperacaoTransporteVeiculoRequest>
            </tms:Veiculos>
         </tms:retificacao>
      </tms:RetificarOperacaoTransporte>
   </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/RetificarOperacaoTransporteResponse</Action>
  </s:Header>
  <s:Body>
    <RetificarOperacaoTransporteResponse xmlns="http://tmsfrete.v2.targetmp.com.br">
      <RetificarOperacaoTransporteResult xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
        <Erro i:nil="true" />
        <IdOperacaoTransporte>135630</IdOperacaoTransporte>
        <IdRetificacaoOperacaoTransporte>54194</IdRetificacaoOperacaoTransporte>
        <DataHoraRetificacao>2018-08-29T12:13:29.0338239</DataHoraRetificacao>
      </RetificarOperacaoTransporteResult>
    </RetificarOperacaoTransporteResponse>
  </s:Body>
</s:Envelope>