Versions Compared

Key

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

...

OperacaoTransporteRequest
CampoTipoObrigatórioDescriçãoObservação
1InstrucaointSimInstrucao para criação de uma nova Operacao.

1= Inserir ou Atualizar

2= Inserir se não existe

4= Desativar/Anular Operação de Transporte

2IdOperacaoTransporteintNãoId da Operação de TransporteObrigatório apenas para Atualizar (1= Inserir ou Atualizar) ou Anular (4=Desativar/Anular Operação de Transporte) o cadastro da Operação de Transporte.
3CodigoCentroDeCustostringNãoCódigo do Centro de Custo do Cliente no Sistema TARGET Frete.Para realizar o Cadastro de um Centro de Custo, será necessário invocar o Método - CadastrarAtualizarCentroDeCusto
4NCMstringSimCódigo de 4 caracteres que identifica a Natureza carga posição previsto pelo SH (Sistema Harmonizado) exigido
pela ANTT.
Ministério da Fazenda - NCM
5ProprietarioCargaintSimIndica quem é o Consignatário/Proprietário da Carga.

1= Remetente

2= Destinatário

6PesoCargadecimal (12.2)SimIndica o peso da carga que está sendo transportada entre a origem e destino.É obrigatório informar o peso da carga, a ANTT solicita essa informação para a emissão do CIOT.
7TipoOperacaostringSimTipo da operação de transporte que está sendo contratada.1= Padrão
3= TAC-Agregado
8MunicipioOrigemCodigoIBGEintNãoCódigo do IBGE referente ao município de origem.Obrigatório informar, quando não existe compra de Vale-Pedágio (Cartão ou TAG) dentro do CIOT.
9MunicipioDestinoCodigoIBGEintNãoCódigo do IBGE referente ao município de destino.Obrigatório informar, quando não existe compra de Vale-Pedágio (Cartão ou TAG) dentro do CIOT.
10DataHoraInicioDatetime (YYYY-MM-DD)SimData e hora do início previsto para a realização efetiva da operação de transporte.

Exemplo: (2018-08-20T10:05:33)


O usuário que deve informar a Data e Hora do início da viagem.

Existem duas validações importantes para essas TAGs:

  1. A data e hora que for informada, não pode ser DateTime Now, caso contrário, iremos dar um retorno de negócio.
  2. A data e hora deve ter no mínimo 1h de intervalo (DataHoraInicio - DataHoraTermino).
11DataHoraTerminoDatetime (YYYY-MM-DD)SimData e hora do término previsto para a realização efetiva da operação de transporte.

Exemplo: (2018-08-20T10:05:33)


O usuário que deve informar a Data e Hora do fim da viagem.

Existem duas validações importantes para essas TAGs:

  1. A data e hora que for informada, não pode ser DateTime Now, caso contrário, iremos dar um retorno de negócio.
  2. A data e hora deve ter no mínimo 1h de intervalo (DataHoraInicio - DataHoraTermino).
12CPFCNPJContratadostring (14)SimCPF ou CNPJ do Contratado para realizar a Operação de Transporte.Para realizar o cadastro de um transportador, será necessário invocar o Método - CadastrarAtualizarTransportador
13ValorFretedecimal (12.2)SimValor referente ao frete contratado.N/A
14ValorCombustiveldecimal (12.2)SimValor referente ao combustível calculado.Ao inserir um valor nesse campo, iremos somar o valor informado com o valor do frete.

O pagamento desse valor será somado ao ValorFrete.
15ValorPedagiodecimal (12.2)SimValor referente ao pedágio calculado.Campo meramente informativo, não fazemos nada com ele.
16ValorDespesasdecimal (12.2)SimValor referente às despesas de viagem.O pagamento desse valor será somado ao ValorFrete.
17ValorImpostoSestSenatdecimal (12.2)SimValor referente ao imposto SEST SENAT (quando houver).N/A
18ValorImpostoIRRFdecimal (12.2)SimValor referente ao imposto IRRF (quando houver).N/A
19ValorImpostoINSSdecimal (12.2)SimValor referente ao imposto INSS (quando houver).N/A
20ValorImpostoIcmsIssqndecimal (12.2)SimValor referente ao imposto ICMS ISSQN (quando houver).N/A
21ParcelaUnicabool (true || false)SimFlag que define se a operação será paga em parcela única.

N/A

22ModoCompraValePedagiointSimIdentificador do modo de compra do vale pedágio.

1= Cartão Target Conta Digital ou Bradesco

2= Via Fácil (Sem Parar)

4= Nenhum

5= Veloe

6= ConectCar

7= MoveMais

8= Cartão Débito

23CategoriaVeiculointSimIdentificador da categoria do veículo.
View file
nameCategoriaDeVeículos.xlsx
height150
24NomeMotoristastring (100)SimNome do motorista da operação de transporte.Para realizar o cadastro de um Motorista, será necessário invocar o Método - CadastrarAtualizarMotorista
25CPFMotoristastring (11)SimCPF do motorista da operação de transporte.Para realizar o cadastro de um Motorista, será necessário invocar o Método - CadastrarAtualizarMotorista
26RNTRCMotoristastring (8)NãoRNTRC do motorista da operação de transporte.Para realizar o cadastro de um Motorista, será necessário invocar o Método - CadastrarAtualizarMotorista
27ItemFinanceirostring (255)NãoNúmero do documento da Operação de Transporte.N/A
28ParcelasList< Operação Transporte Parcela Request>SimLista de parcelas (consulte especificação de lista de 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).
29VeiculosList< Operação Transporte Veiculo Request>SimLista de VeículosN/A
30IdRotaModelointNãoId da rota modelo, caso queira associar uma rota à operação. Ao colocar a rota, o valor do vale pedágio é automaticamente
recalculado e ajustado na operação de transporte.

Pode ser utilizado mesmo se não houver pedágio na Operação de Transporte, caso o mesmo seja informado.


As Rotas são cadastradas previamente através da Plataforma Web TARGET Frete.

31DeduzirImpostosbool (true || false)NãoDeduzir Impostos do valor total contratado.

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


Cálculo:

  1. ValorFrete - (Valor bruto do frete)
  2. Soma de todos os Impostos
  3. O Resultado, deverá ser pago através das Parcelas de Pagamento.

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

Impostos:

  1. ValorImpostoSestSenat
  2. ValorImpostoIRRF
  3. ValorImpostoINSS
  4. ValorImpostoIcmsIssqn
32TarifasBancariasdecimal (12.2)SimTarifas BancáriasO valor total das tarifas bancárias será Adcionado ao valor total do frete.
33QuantidadeTarifasBancariasintSimQuantidade Tarifas Bancárias

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

View file
nameresolução_3.658_compilada_em_10.3.16.pdf
height150

34IdIntegradorstringSimId Integrador

ID único do sistema de TMS da transportadora.

Campo validador, não aceitamos código iguais em compras diferentes mesmo se a compra não acontecer o IdIntegrador já não poderá ser mais utilizado.

Prezado integrador, esse Id é você quem gera e informa para a TARGET, é para o seu controle.

35ValorDescontoAntecipadodecimal (12.2)NãoValor a ser aplicado no CIOT no valor bruto, não influenciando nas parcelas do CIOT.Favor, passar esse campo o valor 0 ou NULL.
36CPFCNPJParticipanteDestinatariostringSimCNPJ do destinatário.

Para realizar o cadastro de um Participante, e será necessário invocar o Método - CadastrarAtualizarParticipante


É Obrigatório informar ao menos o CPFCNPJParticipanteDestinatario para operação tipo padrão.

37CPFCNPJParticipanteContratantestringNãoCNPJ do Contratante caso deseje ser informado.N/A
38CPFCNPJParticipanteSubcontratantestringNãoCNPJ do Subcontratante caso deseje ser informado.

N/A

39CPFCNPJParticipanteConsignatariostringNãoCNPJ do Consignatário caso deseje ser informado.

N/A

40NumeroLacreTransporteCombustivelstringNãoNúmero Lacre Transportes CombustívelN/A
41ListaDestinatariosAdicionaisList< Participante Destinatário Adicional Request>NãoLista de Destinatários ()

O Usuário poderá informar uma lista de Destinatário Adicionais.



42NumeroCartaoValePedagiostringNãoNúmero Cartão Vale PedágioPoderá fazer uso da mesma quando for informado 1 na TAG - 'ModoCompraValePedagio'. Só poderá ser utilizado cartões
do Tipo VTG 900 (Cartões exclusivos Vale Pedágio).
43Quitacaobool (true || false)NãoQuitaçãoN/A
44DadosQuitacaoList< Dados Quitação Frete Request>SimDados para Quitação de Frete

N/A


45DocumentoValePedagiostringNãoObservações da compra de Vale-Pedágio Cartão ou TAGN/A
46ValorImpostoISSdecimalNãoValor do Imposto ISSN/A
47
TipoFormaPagamento
enumNãoTipo de pagamento do Frete

BaseadoNasParcelas = 1

OutraIPEF = 2

Outro = 3

48CepOrigemstringSimCep de Origem da viagem

N/A

49CepDestinostringSimCep de destino da viagemN/A
50TipoCargaANTTintNãoTipo Carga ANTT

GranelSolido = 1
GranelLiquido = 2
Frigorificada = 3
Conteinerizada = 4
CargaGeral = 5
Neogranel = 6
PerigosaGranelSolido = 7
PerigosaGranelLiquido = 8
PerigosaCargaFrigorificada = 9
PerigosaConteinerizada = 10
PerigosaCargaGeral = 11

PerigosaCargaPressurizada = 12

51DistanciaPercorridaintNãoDistancia total a ser percorrida na viagemN/A
52AltoDesempenhobool(true || false)NãoIndica se sera uma viagem de alto desempenho.N/A
53DestinacaoComercialbool(true || false)Não Indica se sera uma viagem com destinação comercial.N/A
54FreteRetorno

List<DadosFrete

RetornoRequest>

NãoDistancia (em km) percorrida entre o CEP destino e o CEP retorno informado.N/A
55CnpjPagamentoOutraIPEFstringNãoCNPJ da IPEF na qual sera realizada o pagamentoN/A

...