Page Comparison

...

Info

title	Observações Importantes

As Operações de Transporte do tipo viagem padrão poderão ser declaradas com até trinta dias de antecedência da data de início da viagem e não poderão ter duração maior que noventa dias.
As Operações de Transporte do tipo viagem TAC-agregado deverão ser declaradas na data de início da operação e não poderão ter duração maior que trinta dias.
Nos casos de Operação de Transporte de Alto Desempenho deve-se informar que se trata desse tipo de operação e declarar como viagem do tipo padrão.
Este método não registra a operação na ANTT, o mesmo somente cadastra as informações no sistema TARGET Frete.

Info

title	CIOT- Frota Própria

Para fazer uso do CIOT-Frota Própria , o Cliente deverá estar parametrizado para tal (O Cliente deverá entrar em contato com o Time Comercial da TARGET).
A Quitação O CIOT-Frota Própria só poderá ser realizada dentro de Operações de Transportes do Tipo Padrão.
Considerações sobre Parcela de Pagamento:
1. A Quitação sempre será deduzida na Parcela de Pagamento do Tipo: Saldo.
2. Não tem como fazer uso da Quitação se a Operação de Transporte não conter uma Parcela de Pagamento do Tipo: Saldo.
3. A Parcela de Pagamento do Tipo: Saldo, não pode ser automática, ela deverá ser cadastrada como manual - Método - 'CadastrarAtualizarOperacaoTransporte', TAG - 'ProcessarAutomaticamente'.
Observações sobre o Pagamento mínimo da Parcela de Saldo (O Bradesco permite apenas o pagamento mínimo nos cartões no valor de R$5,00.):Se o valor for 0 ou negativo:A Parcela de Pagamento do Tipo: Saldo, será dada como paga (Obs: O controle financeiro ficará com o cliente).
Se o valor for de R$0,01 até R$4,99:
1. A Parcela será paga no valor mínimo de R$5,00(Obs: O controle financeiro ficará com o cliente).

Info

title	Quitação - Observações Importantes

Para fazer uso do Módulo de Quitação, o Cliente deverá estar parametrizado para tal (O Cliente deverá entrar em contato com o Time Comercial da TARGET).
A Quitação só poderá ser realizada dentro de Operações de Transportes do Tipo Padrão.
Considerações sobre Parcela de Pagamento:
1. A Quitação sempre será deduzida na Parcela de Pagamento do Tipo: Saldo.
2. Não tem como fazer uso da Quitação se a Operação de Transporte não conter uma Parcela de Pagamento do Tipo: Saldo.
3. A Parcela de Pagamento do Tipo: Saldo, não pode ser automática, ela deverá ser cadastrada como manual - Método - 'CadastrarAtualizarOperacaoTransporte', TAG - 'ProcessarAutomaticamente'.
Observações sobre o Pagamento mínimo da Parcela de Saldo (O Bradesco permite apenas o pagamento mínimo nos cartões no valor de R$5,00.):
1. Se o valor for 0 ou negativo:
  1. A Parcela de Pagamento do Tipo: Saldo, será dada como paga (Obs: O controle financeiro ficará com o cliente).
2. Se o valor for de R$0,01 até R$4,99:
  1. A Parcela será paga no valor mínimo de R$5,00(Obs: O controle financeiro ficará com o cliente).

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.

...

OperacaoTransporteRequest

Nº

Campo

Tipo

Obrigatório

Descrição

Observação

1

Instrucao

int

Sim

Instrucao para criação de uma nova Operacao.

1= Inserir ou Atualizar

2= Inserir se não existe

4= Desativar/Anular Operação de Transporte

2

IdOperacaoTransporte

int

Não

Id da Operação de Transporte

Obrigatório apenas para Atualizar (1= Inserir ou Atualizar) ou Anular (4=Desativar/Anular Operação de Transporte) o cadastro da Operação de Transporte.

3

CodigoCentroDeCusto

string

Não

Có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

4

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

5

ProprietarioCarga

int

Sim

Indica quem é o Consignatário/Proprietário da Carga.

1= Remetente

2= Destinatário

6

PesoCarga

decimal (12.2)

Sim

Indica 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.

7

TipoOperacao

string

Sim

Tipo da operação de transporte que está sendo contratada.

1= Padrão
3= TAC-Agregado

8

MunicipioOrigemCodigoIBGE

int

Não

Có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.

9

MunicipioDestinoCodigoIBGE

int

Não

Có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.

10

DataHoraInicio

Datetime (YYYY-MM-DD)

Sim

Data 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:

A data e hora que for informada, não pode ser DateTime Now, caso contrário, iremos dar um retorno de negócio.
A data e hora deve ter no mínimo 1h de intervalo (DataHoraInicio - DataHoraTermino).

11

DataHoraTermino

Datetime (YYYY-MM-DD)

Sim

Data 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:

A data e hora que for informada, não pode ser DateTime Now, caso contrário, iremos dar um retorno de negócio.
A data e hora deve ter no mínimo 1h de intervalo (DataHoraInicio - DataHoraTermino).

12

CPFCNPJContratado

string (14)

Sim

CPF 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

13

ValorFrete

decimal (12.2)

Sim

Valor referente ao frete contratado.

N/A

14

ValorCombustivel

decimal (12.2)

Sim

Valor 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.

15

ValorPedagio

decimal (12.2)

Sim

Valor referente ao pedágio calculado.

Campo meramente informativo, não fazemos nada com ele.

16

ValorDespesas

decimal (12.2)

Sim

Valor referente às despesas de viagem.

O pagamento desse valor será somado ao ValorFrete.

17

ValorImpostoSestSenat

decimal (12.2)

Sim

Valor referente ao imposto SEST SENAT (quando houver).

N/A

18

ValorImpostoIRRF

decimal (12.2)

Sim

Valor referente ao imposto IRRF (quando houver).

N/A

19

ValorImpostoINSS

decimal (12.2)

Sim

Valor referente ao imposto INSS (quando houver).

N/A

20

ValorImpostoIcmsIssqn

decimal (12.2)

Sim

Valor referente ao imposto ICMS ISSQN (quando houver).

N/A

21

ParcelaUnica

bool (true || false)

Sim

Flag que define se a operação será paga em parcela única.

N/A

22

ModoCompraValePedagio

int

Sim

Identificador do modo de compra do vale pedágio.

1= Cartão Transporte Bradesco TARGET

2= Via Fácil (Sem Parar)

4= Nenhum

23

CategoriaVeiculo

int

Sim

Identificador da categoria do veículo.

View file

name	CategoriaDeVeículos.xlsx
height	150

24

NomeMotorista

string (100)

Sim

Nome do motorista da operação de transporte.

Para realizar o cadastro de um Motorista, será necessário invocar o Método - CadastrarAtualizarMotorista

25

CPFMotorista

string (11)

Sim

CPF do motorista da operação de transporte.

Para realizar o cadastro de um Motorista, será necessário invocar o Método - CadastrarAtualizarMotorista

26

RNTRCMotorista

string (8)

Não

RNTRC do motorista da operação de transporte.

Para realizar o cadastro de um Motorista, será necessário invocar o Método - CadastrarAtualizarMotorista

27

ItemFinanceiro

string (255)

Não

Número do documento da Operação de Transporte.

N/A

28

Parcelas

List< Operação Transporte Parcela Request>

Sim

Lista 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).

29

Veiculos

List< Operação Transporte Veiculo Request>

Sim

Lista de Veículos

N/A

30

IdRotaModelo

int

Não

Id 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, não é necessário informar os Códigos IBGEs de Origem e Destino.

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

31

DeduzirImpostos

bool (true || false)

Não

Deduzir 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:

ValorFrete - (Valor bruto do frete)
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

32

TarifasBancarias

decimal (12.2)

Sim

Tarifas Bancárias

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

33

QuantidadeTarifasBancarias

int

Sim

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

34

IdIntegrador

string

Sim

Id Integrador

ID único do sistema de TMS da transportadora.

Campo validador, não aceitamos código iguais em compras diferentes.

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

35

ValorDescontoAntecipado

decimal (12.2)

Não

Valor a ser aplicado no CIOT no valor bruto, não influenciando nas parcelas do CIOT.

Favor, passar esse campo o valor 0 ou NULL.

36

CPFCNPJParticipanteDestinatario

string

Não

CNPJ do destinatário caso deseje ser informado.

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

É Obrigatório informar ao menos um dos tipos de participantes:

CPFCNPJParticipanteDestinatario
CPFCNPJParticipanteContratante
CPFCNPJParticipanteSubcontratante
CPFCNPJParticipanteConsignatario

37

CPFCNPJParticipanteContratante

string

Não

CNPJ do Contratante caso deseje ser informado.

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

É Obrigatório informar ao menos um dos tipos de participantes:

CPFCNPJParticipanteDestinatario
CPFCNPJParticipanteContratante
CPFCNPJParticipanteSubcontratante
CPFCNPJParticipanteConsignatario

38

CPFCNPJParticipanteSubcontratante

string

Não

CNPJ do Subcontratante caso deseje ser informado.

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

É Obrigatório informar ao menos um dos tipos de participantes:

CPFCNPJParticipanteDestinatario
CPFCNPJParticipanteContratante
CPFCNPJParticipanteSubcontratante
CPFCNPJParticipanteConsignatario

39

CPFCNPJParticipanteConsignatario

string

Não

CNPJ do Consignatário caso deseje ser informado.

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

É Obrigatório informar ao menos um dos tipos de participantes:

CPFCNPJParticipanteDestinatario
CPFCNPJParticipanteContratante
CPFCNPJParticipanteSubcontratante
CPFCNPJParticipanteConsignatario

40

NumeroLacreTransporteCombustivel

string

Não

Número Lacre Transportes Combustível

N/A

41

ListaDestinatariosAdicionais

List< Participante Destinatário Adicional Request>

Não

Lista de Destinatários ()

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

Mas usado em CIOT TAC-Agregado.

TipoOperacao = 3

42

NumeroCartaoValePedagio

string

Não

Número Cartão Vale Pedágio

Poderá 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).

43

Quitacao

bool (true || false)

Não

Quitação

N/A

44

DadosQuitacao

List< Dados Quitação Frete Request>

Sim

Dados para Quitação de Frete

N/A

45

DocumentoValePedagio

string

Não

Observações da compra de Vale-Pedágio Cartão ou TAG

N/A

46

CEPOrigem

string

Não

CEP Origem

N/A

47

CEPDestino

string

Não

CEP Destino

N/A

48

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

PerigosaCargaPressurizada = 12

49

DistanciaPercorrida

int

Não

Distância Percorrida

N/A

50

AltoDesempenho

bool(true || false)

Não

Indica se o veículo é de alto desempenho ou não.

N/A

51

DestinaçãoComercial

bool(true || false)

Não

Indica se o transporte da carga tem destinação comercial.

N/A

52

FreteRetorno

bool(true || false)

Não

Indica se existe frete de retorno.

N/A

53

CepRetorno

string

Não

CEP de retorno da carga

N/A

54

DistanciaRetorno

string

Não

Distancia (em km) percorrida entre o CEP destino e o CEP retorno informado.

N/A

55

ValorImpostoISS

decimal

Não

Valor do Imposto ISS

N/A

56

CIOTSemPagamento

bool(true || false)

Não

Indica se será um CIOT para Frota Própria

N/A

Nº	Campo	Tipo	Obrigatório	Descrição	Observação
OperacaoTransporteParcelaRequest
1	DescricaoParcela	string (50)	Sim	Descrição da parcela	Adiantamento Saldo Intermediária Adicional
2	Valor	decimal (12.2)	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 do 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 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 FormaPagamento = 1
8	CodigoBanco	string	Sim	Código do banco de compensação	Obrigatório Se FormaPagamento = 2 (Vide Capítulo deAnexos).
9	AgenciaDeposito	string (15)	Sim	Agência da rede bancária onde será realizado o pagamento.	Obrigatório se FormaPagamento = 2
10	ContaDeposito	string (15)	Sim	Conta da agência onde será realizado o pagamento.	Obrigatório se FormaPagamento = 2
11	DigitoContaDeposito	string (15)	Sim	Digito verificador da conta que será realizado o pagamento.	Obrigatório se FormaPagamento = 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 ou através da integração.	Caso o Pagamento da mesma seja Manual, deverá ser invocado o método - 'PagarParcelaIndividual'.
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 (10)	Sim	Variação da Conta Poupança (caso seja uma).	N/A
16	ItemFinanceiroParcela	string	N/A	Item Financeiro Parcela	N/A

...

Version	Old Version 95	New Version 96
Changes made by	Raphael Santos	Raphael Santos
Saved on	Mar 10, 2020	Mar 11, 2020

Versions Compared

Key

Impostos: