DOCUMENTAÇÃO CORPORATIVA
RetificarOperacaoTransporte
Objetivo
Esse método tem como objetivo retificar uma Operação de Transporte.
Observações Importantes
- 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.
- Uma Operação só pode ser retificada em até 24h depois da Data e Hora de Início da Viagem.
- 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 | |||||
Nº | Campo | Tipo | Obrigatório | Descrição | Observação |
---|---|---|---|---|---|
1 | IdOperacaoTransporte | int | Sim | Id Operação de Transporte | N/A |
2 | NCM | string | Sim | Código de 4 caracteres que identifica a Natureza carga posição previsto pelo SH (Sistema Harmonizado) exigido pela ANTT. | |
3 | PesoCarga | decimal | Sim | Peso da Carga transportada | N/A |
4 | MunicipioOrigemCodigoIBGE | int | Sim | Código do IBGE referente ao município de origem. | N/A |
5 | MunicipioDestinoCodigoIBGE | int | Sim | Código do IBGE referente ao município de destino. | N/A |
6 | DataHoraInicio | DateTime(YYYY-MM-DD) | Sim | Data Hora Início da Operação | Exemplo: (2018-08-20T10:05:33) |
7 | DataHoraTermino | DateTime(YYYY-MM-DD) | Sim | Data Hora Fim da Operação | Exemplo: (2018-08-20T10:05:33) |
8 | Valores | List<RetificacaoValoresRequest> | Sim | Valores | N/A |
9 | Veículos | List<OperacaoTransporteVeiculoRequest> | Sim | Veículos da Operação de Transporte | N/A |
10 | CEPOrigem | string | Não | CEP Origem | N/A |
11 | CEPDestino | string | Não | CEP Destino | N/A |
12 | TipoCargaANTT | int | Não | Tipo Carga ANTT | GranelSolido = 1 GranelLiquido = 2 Frigorificada = 3 Conteinerizada = 4 CargaGeral = 5 Neogranel = 6 PerigosaGranelSolido = 7 PerigosaGranelLiquido = 8 PerigosaCargaFrigorificada = 9 PerigosaConteinerizada = 10 PerigosaCargaGeral = 11 |
13 | DistanciaPercorrida | int | Não | Distância Percorrida | N/A |
RetificacaoValoresRequest | |||||
Nº | Campo | Tipo | Obrigatório | Descrição | Observação |
---|---|---|---|---|---|
1 | ValorFrete | decimal | Sim | Valor do Frete contratado | N/A |
2 | ValorCombustivel | decimal | Sim | Valor do Combustível | N/A |
3 | ValorPedagio | decimal | Sim | Valor Pedágio | N/A |
4 | ValorDespesas | decimal | Sim | Valor das Despesas | N/A |
5 | ValorImpostoSestSenat | decimal | Sim | Valor Imposto Sest Senat | N/A |
6 | ValorImpostoIRRF | decimal | Sim | Valor Imposto IRRF | N/A |
7 | ValorImpostoINSS | decimal | Sim | Valor Imposto INSS | N/A |
8 | ValorImpostoIcmsIssqn | decimal | Sim | Valor Imposto Icms Issqn | N/A |
9 | ValorDescontoAntecipado | decimal | Sim | Valor Desconto Antecipado | N/A |
10 | ValorAjusteCombustivel | decimal | Sim | Valor Ajuste Combustível | N/A |
11 | ValorAjusteServicos | decimal | Sim | Valor Ajuste Serviços | N/A |
12 | ValorAjusteManutencao | decimal | Sim | Valor Ajuste Manutenção | N/A |
13 | ValorAjusteOutros | decimal | Sim | Valor Ajuste Outros | N/A |
14 | DeduzirImpostos | bool (true || false) | Sim | Deduzir Impostos | N/A |
15 | TarifasBancarias | decimal | Sim | Tarifas Bancárias | N/A |
16 | QuantidadeTarifasBancarias | int | Não | Quantidade Tarifas Bancárias | N/A |
17 | Parcelas | List<OperacaoTransporteParcelaRequest> | Sim | Parcelas | N/A |
18 | ValorImpostoISS | decimal | Não | Valor do Imposto ISS | N/A |
OperacaoTransporteParcelaRequest | |||||
Nº | Campo | Tipo | Obrigatório | Descrição | Observação |
---|---|---|---|---|---|
1 | DescricaoParcela | string | Sim | Descrição da Parcela | N/A |
2 | Valor | decimal | Sim | Valor da Parcela | N/A |
3 | NumeroParcela | int | Sim | Número da Parcela | N/A |
4 | DataVencimento | Datetime (YYYY-MM-DD) | Sim | Data de Vencimento da Parcela | Exemplo: (2018-08-20T10:05:33) |
5 | TipoDaParcela | int | Sim | Tipo da Parcela | 1= Adiantamento 2= Intermediária 3= Saldo 4= Adicional |
6 | FormaPagamento | int | Sim | Forma de Pagamento da Parcela | 1= Cartão Target Conta Digital ou Bradesco 2= Depósito Conta |
7 | CartaoPagamento | string | Não | Número do Cartão para destino do pagamento da Operação de Transporte. | Obrigatório se Forma Pagamento = 1 |
8 | CodigoBanco | string | Não | Código do banco de compensação | Obrigatório Se Forma Pagamento = 2 |
9 | AgenciaDeposito | string | Não | Agência da rede bancária onde será realizado o pagamento. | Obrigatório Se Forma Pagamento = 2 |
10 | ContaDeposito | string | Não | Conta da agência onde será realizado o pagamento. | Obrigatório Se Forma Pagamento = 2 |
11 | DigitoContaDeposito | string | Não | Digito verificador da conta que será realizado o pagamento. | Obrigatório Se Forma Pagamento = 2 |
12 | ProcessarAutomaticamente | bool (true || false) | Sim | Indica se a parcela em questão será processada automaticamente na data de vencimento informada ou será paga manualmente no Sistema TARGET Frete. | N/A |
13 | IdOperacaoTransporteParcela | int | Não | Identificador de Parcela de Operação de Transporte no Sistema TARGET Frete. | N/A |
14 | FlagContaPoupanca | bool (true || false) | Sim | Flag 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. |
15 | VariacaoContaPoupanca | string | Não | Variação da Conta Poupança (caso seja uma). | N/A |
16 | ItemFinanceiroParcela | string | Não | Item Financeiro Parcela | N/A |
OperacaoTransporteVeiculoRequest | |||||
Nº | Campo | Tipo | Obrigatório | Descrição | Observação |
---|---|---|---|---|---|
1 | Placa | string | Sim | Placa do Veículo | N/A |
2 | RNTRC | string | Sim | RNTRC no qual o Veículo está associado. | N/A |
Response
RetificacaoOperacaoTransporteResponse | |||||
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 da Operação de Transporte | N/A |
3 | IdRetificacaoOperacaoTransporte | int | Sim | Id Retificação da Operação de Transporte | N/A |
4 | DataHoraRetificacao | DateTime(YYYY-MM-DD) | Sim | Data e Hora da Retificação | Exemplo: (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>