Page Comparison

...

Info

title	Observações Importantes

Os valores das Operações de Transporte do Tipo Padrão não poderão ser modificados de acordo com a nova legislação da ANTT.
É obrigatório Encerrar a Operação de Transporte ao final da viagem (Padrão ou TAC-Agregado).
Deve-se respeitar os valores da Operação de Transporte ao encerrar, o cálculo deve estar correto, caso contrário a Operação não será encerrada.
Caso esteja Encerrando uma Operação de Transporte do Tipo TAC-Agregado, todas as viagens realizadas dentro desse CIOT devem ser declaradas no encerramento, e se parcelas adicionais foram criadas no período em que o CIOT estava aberto, as mesmas também devem ser declaradas no encerramento.
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.

...

Nº	Campo	Tipo	Obrigatório	Descrição	Observação
EncerramentoOperacaoTransporteRequest
1	CodigoOperacao	int	Sim	ID retornado da criação da Operação de Transportes.	Método que retorna o IdOperacaoTransporte - CadastrarAtualizarOperacaoTransporte
2	ObservacaoAvariaContratante	string	Sim	Descrição do desconto de Avaria.	Utilizado quando a TAG - 'ValorAjusteOutros' é preenchida.
3	Viagens	List<Operação Transporte Viagem Request>	Sim	Lista de Viagens realizadas em caso de operação de TAC-Agregado.	N/A CIOT Padrão: Informar o Objeto viagens apenas 1 vez - 1 unica viagem um único destino. CIOT TAC Agregado: Poderá informar até 5 Objetos viagens diferentes - Poderá haver N viagens, porém apenas 5 destinos diferentes.
4	Retificacao	Object<Retificação Encerramento Operação Transporte Request>	Sim	Objeto da viagem.	N/A

...

RetificacaoEncerramentoOperacaoTransporteRequestNºCampoTipo

Nº	Campo	Tipo	Obrigatório	Descrição	Observação
OperacaoTransporteViagemRequest
1	MunicipioOrigemCodigoIBGE	int	Sim	Código IBGE de origem da viagem.	N/A
2	MunicipioDestinoCodigoIBGE	int	Sim	Código IBGE de destino da viagem.	N/A
3	NCM	string	Sim	Código de 4 caracteres que identifica a Natureza carga posição previsto pelo SH (Sistema Harmonizado) exigido pela ANTT.	Ministério da Fazenda - NCM
4	PesoCarga	decimal	Sim	Peso total de todas as viagens realizadas com essa origem e destino.	N/A
5	QuantidadeViagens	int	Sim	Número total de viagens realizadas com essa origem e destino.	N/A
6	CEPOrigem	string	Não	Obrigatório	CEP Origem	N/A
7	CEPDestino	string	Não	CEP Destino	N/A

Nº	Campo	Tipo	Obrigatório	Descrição	Observação
RetificacaoEncerramentoOperacaoTransporteRequest
1	PesoCarga	decimal	Não	Peso da Carga	N/A
2	Valores	Object<Retificação Valores Request>	Sim	Valores	N/A

...

RetificacaoValoresRequest

Nº

Campo

Tipo

Obrigatório

Descrição

Observação

1

ValorFrete

decimal

Sim

Valor do Frete

N/A

2

ValorCombustivel

decimal

Sim

Valor do Combustível

N/A

3

ValorPedagio

decimal

Sim

Valor do 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 de 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

Utilizado para desconto de avaria na carga, por exemplo.

Esse valor é subtraído automaticamente da Parcela de Saldo que ainda será paga.

14

DeduzirImpostos

bool(true || false)

Sim

Deduzir Impostos

Aconselhamos informar True.

Os valores dos Impostos devem ser informados, a TARGET apenas subtrai tais valores do valor total contratado.

Cálculo:

ValorFrete - (A soma de todos os Impostos)

O Resultado, deverá ser pago através das Parcelas de Pagamento.

Objeto Parcelas - List< Operação Transporte Parcela Request>

Impostos:

ValorImpostoSestSenat
ValorImpostoIRRF
ValorImpostoINSS
ValorImpostoIcmsIssqn

15

TarifasBancarias

decimal

Sim

Tarifas Bancárias

O valor total das tarifas bancárias será subtraído do valor total do frete.

16

QuantidadeTarifasBancarias

int

Não

Quantidade Tarifas Bancárias

Deve ser informado 8 como dizem as regras da ANTT conforme resolução abaixo na página 14.

View file

name	resolução_3.658_compilada_em_10.3.16.pdf
height	150

17

Parcelas

List<OperacaoTransporteParcelaRequest>

Sim

Lista de parcelas (consulte especificação de lista de parcelas).

CIOT Padrão ou TAC-Agregado: Só poderá haver uma Parcela de Adiantamento (Tipo: 1), uma Parcela de Saldo (Tipo: 3) e N Parcelas Intermediárias (Tipo: 2) ou Adicionais (Tipo: 4).

18

ValorImpostoISS

decimal

Não

Valor Imposto ISS

N/A

Nº	Campo	Tipo	Obrigatório	Descrição	Observação
OperacaoTransporteParcelaRequest
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	O campo foi descontinuado. Favor informar zero.
4	DataVencimento	Datetime(YYYY-MM-DD)	Sim	Data 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 escolhida para a Parcela de Operação de Transporte.	1= Cartão Target Conta Digital ou Bradesco 2= Depósito Conta 3= Pix
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)	Não	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	Sim	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

...

Code Block

language	xml
theme	RDark
firstline	1
title	EncerramentoOperacaoTransporteRequest
linenumbers	true

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tms="http://tmsfrete.v2.targetmp.com.br">
   <soapenv:Header/>
   <soapenv:Body>
      <tms:EncerrarOperacaoTransporte>
         <tms:auth>
            <tms:Usuario>?</tms:Usuario>
            <tms:Senha>?</tms:Senha>
            <tms:Token>?</tms:Token>
         </tms:auth>
         <tms:encerramentoRequest>
            <tms:CodigoOperacao>?</tms:CodigoOperacao>
            <tms:ObservacaoAvariaContratante>?</tms:ObservacaoAvariaContratante>
            <tms:Viagens>
               <tms:OperacaoTransporteViagemRequest>
                  <tms:MunicipioOrigemCodigoIBGE>?</tms:MunicipioOrigemCodigoIBGE>
                  <tms:MunicipioDestinoCodigoIBGE>?</tms:MunicipioDestinoCodigoIBGE>
                  <tms:NCM>?</tms:NCM>
                  <tms:PesoCarga>?</tms:PesoCarga>
                  <tms:QuantidadeViagens>?</tms:QuantidadeViagens>
				  <tms:CEPOrigem>?</tms:CEPOrigem>
              <    <tms:CEPDestino>?</tms:CEPDestino>
               </tms:OperacaoTransporteViagemRequest>
            </tms:Viagens>
            <tms:Retificacao>
               <tms:PesoCarga>?</tms:PesoCarga>
               <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:Retificacao>
         </tms:encerramentoRequest>
      </tms:EncerrarOperacaoTransporte>
   </soapenv:Body>
</soapenv:Envelope>

...

Abaixo, segue exemplo 1 do método de Encerramento.

Request <soapenv:Envelope xmlns:soapenv="

Code Block

language	xml
theme	RDark
firstline	1
title	EncerramentoOperacaoTransporteRequest
linenumbers	true

Info

Para uma Operação de Transporte do Tipo: Padrão, caso não tenha sido alterado nenhum dado desde o cadastro e declaração da mesma, a Operação de Transporte poderá ser encerrada como o exemplo abaixo, apenas informando o Id da Operação de Transporte.

Code Block

language	xml
theme	RDark
firstline	1
title	EncerramentoOperacaoTransporteRequest
linenumbers	true

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:EncerrarOperacaoTransporte>
         <tms:auth>
            <tms:Usuario>tms.exemplo</tms:Usuario>
            <tms:Senha>v0hXPrwerKblaBs=</tms:Senha>
            <tms:Token i:nil="true" />
         </tms:auth>
         <tms:encerramentoRequest>
            <tms:CodigoOperacao>136138</tms:CodigoOperacao>
         </tms:encerramentoRequest>
      </tms:EncerrarOperacaoTransporte>
   </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/EncerrarOperacaoTransporteResponse</Action>
  </s:Header>
  <s:Body>
    <EncerrarOperacaoTransporteResponse xmlns="http://tmsfrete.v2.targetmp.com.br">
      <EncerrarOperacaoTransporteResult xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
        <Erro i:nil="true" />
        <IdEncerramentoOperacaoTransporte>114334</IdEncerramentoOperacaoTransporte>
        <DataEncerramento>2018-08-30T13:53:10.0288164</DataEncerramento>
        <ProtocoloEncerramento>T18000000090025</ProtocoloEncerramento>
        <TipoOperacao i:nil="true" />
      </EncerrarOperacaoTransporteResult>
    </EncerrarOperacaoTransporteResponse>
  </s:Body>
</s:Envelope>

Encerrar Operação de Transporte - Exemplo 2

Abaixo, segue exemplo 2 do método de Encerramento.

Info

Operação de Transporte Tipo: Padrão:
1. Caso tenha ocorrido alguma alteração na Operação de Transporte, deverá ser enviado TODO o Request, informando: As Alterações, Parcelas Criadas (As parcelas criadas no cadastro da Operação de Transporte), Desconto de Avaria de Carga (Caso tenha).
2. Parcelas: Só poderá haver uma Parcela de Adiantamento (Tipo: 1), uma Parcela de Saldo (Tipo: 3) e N Parcelas Intermediárias (Tipo: 2) ou Adicionais (Tipo: 4).
3. Viagens: Apenas 1 viagem (1 destino).
Operação de Transporte Tipo: TAC-Agregado:
1. Sempre deverá ser informado TODO o Request.
2. Parcelas: Só poderá haver uma Parcela de Adiantamento (Tipo: 1), uma Parcela de Saldo (Tipo: 3) e N Parcelas Intermediárias (Tipo: 2) ou Adicionais (Tipo: 4).
3. Viagens: Poderá ter N viagens ,porém com apenas 5 destinos diferentes.

Code Block

language	xml
theme	RDark
firstline	1
title	EncerramentoOperacaoTransporteRequest
linenumbers	true

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:EncerrarOperacaoTransporte>
         <tms:auth>
            <tms:Usuario>tms.exemplo</tms:Usuario>
            <tms:Senha>v0hXPrwerKblaBs=</tms:Senha>
            <tms:Token i:nil="true" />
         </tms:auth>
         <tms:encerramentoRequest>
            <tms:CodigoOperacao>125398</tms:CodigoOperacao>
            <tms:ObservacaoAvariaContratante i:nil="true" />
            <tms:Viagens>
               <tms:OperacaoTransporteViagemRequest>
                  <tms:MunicipioOrigemCodigoIBGE>3518800</tms:MunicipioOrigemCodigoIBGE>
                  <tms:MunicipioDestinoCodigoIBGE>3518800</tms:MunicipioDestinoCodigoIBGE>
                  <tms:NCM>0001</tms:NCM>
                  <tms:PesoCarga>480.29</tms:PesoCarga>
                  <tms:QuantidadeViagens>4</tms:QuantidadeViagens>
               </tms:OperacaoTransporteViagemRequest>
            </tms:Viagens>
            <tms:Retificacao>
               <tms:PesoCarga>599.04</tms:PesoCarga>
               <tms:Valores>
                  <tms:ValorFrete>1831.58</tms:ValorFrete>
                  <tms:ValorCombustivel>0.00</tms:ValorCombustivel>
                  <tms:ValorPedagio>0.00</tms:ValorPedagio>
                  <tms:ValorDespesas>0.00</tms:ValorDespesas>
                  <tms:ValorImpostoSestSenat>8.48</tms:ValorImpostoSestSenat>
                  <tms:ValorImpostoIRRF>0.00</tms:ValorImpostoIRRF>
                  <tms:ValorImpostoINSS>37.29</tms:ValorImpostoINSS>
                  <tms:ValorImpostoIcmsIssqn>0.00</tms:ValorImpostoIcmsIssqn>
                  <tms:ValorDescontoAntecipado>0.00</tms:ValorDescontoAntecipado>
                  <tms:ValorAjusteCombustivel>0.00</tms:ValorAjusteCombustivel>
                  <tms:ValorAjusteServicos>0.00</tms:ValorAjusteServicos>
                  <tms:ValorAjusteManutencao>0.00</tms:ValorAjusteManutencao>
                  <tms:ValorAjusteOutros>0.00</tms:ValorAjusteOutros>
                  <tms:DeduzirImpostos>true</tms:DeduzirImpostos>
                  <tms:TarifasBancarias>0.00</tms:TarifasBancarias>
                  <tms:QuantidadeTarifasBancarias>4</tms:QuantidadeTarifasBancarias>
                  <tms:Parcelas>
                     <tms:OperacaoTransporteParcelaRequest>
                        <tms:DescricaoParcela>Saldo do Frete</tms:DescricaoParcela>
                        <tms:Valor>1785.81</tms:Valor>
                        <tms:NumeroParcela>0</tms:NumeroParcela>
                        <tms:DataVencimento>2018-09-05T00:00:00</tms:DataVencimento>
                        <tms:TipoDaParcela>3</tms:TipoDaParcela>
                        <tms:FormaPagamento>1</tms:FormaPagamento>
                        <tms:CartaoPagamento>4417811608348024</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>193680</tms:IdOperacaoTransporteParcela>
                        <tms:FlagContaPoupanca>false</tms:FlagContaPoupanca>
                        <tms:VariacaoContaPoupanca i:nil="true" />
                        <tms:ItemFinanceiroParcela>63</tms:ItemFinanceiroParcela>
                     </tms:OperacaoTransporteParcelaRequest>
                  </tms:Parcelas>
               </tms:Valores>
            </tms:Retificacao>
         </tms:encerramentoRequest>
      </tms:EncerrarOperacaoTransporte>
   </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/EncerrarOperacaoTransporteResponse</Action>
  </s:Header>
  <s:Body>
    <EncerrarOperacaoTransporteResponse xmlns="http://tmsfrete.v2.targetmp.com.br">
      <EncerrarOperacaoTransporteResult xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
        <Erro i:nil="true" />
        <IdEncerramentoOperacaoTransporte>114306</IdEncerramentoOperacaoTransporte>
        <DataEncerramento>2018-08-30T12:24:09.5949869-03:00</DataEncerramento>
        <ProtocoloEncerramento>T18000000090026</ProtocoloEncerramento>
        <TipoOperacao i:nil="true" />
      </EncerrarOperacaoTransporteResult>
    </EncerrarOperacaoTransporteResponse>
  </s:Body>
</s:Envelope>

Version	Old Version 14	New Version Current
Changes made by	Gabriel Nisã Brandão Casaes Monteiro (Unlicensed)	vitor.costa (Unlicensed)
Saved on	Nov 13, 2018	Jul 10, 2024

Versions Compared

Key

Os valores dos Impostos devem ser informados, a TARGET apenas subtrai tais valores do valor total contratado.

Cálculo:

ValorFrete - (A soma de todos os Impostos)

Impostos:

Encerrar Operação de Transporte - Exemplo 2

Page Comparison

Versions Compared

Key

Os valores dos Impostos devem ser informados, a TARGET apenas subtrai tais valores do valor total contratado.Cálculo:ValorFrete - (A soma de todos os Impostos)

Impostos:

Encerrar Operação de Transporte - Exemplo 2

Os valores dos Impostos devem ser informados, a TARGET apenas subtrai tais valores do valor total contratado.

Cálculo:

ValorFrete - (A soma de todos os Impostos)