DOCUMENTAÇÃO CORPORATIVA
CadastrarOperacaoDescritiva
Objetivo
Principal método da Emissão do CIOT, é nele que você irá passar todas as informações referentes ao CIOT. O usuário irá informar se é um CIOT Padrão ou de TAC-Agregado entre outras informações.
Observações Importantes
- Este método não registra a operação na ANTT, o mesmo somente cadastra as informações no sistema TARGET Frete.
- 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 | CodigoCentroDeCusto | string | Não | Código do Centro de Custo do Cliente no sistema 'Target Frete'. | 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. | Ministério da Fazenda - NCM | |
3 | ProprietarioCarga | string | Sim | Indica quem é o Consignatário/Proprietário da Carga. | 1= Remetente 2= Destinatário | |
4 | PesoCarga | decimal | Sim | Indica o peso da carga que está sendo transportada entre a origem e destino. | N/A | |
5 | TipoOperacao | string | Sim | Tipo da operação de transporte que está sendo contratada. | 1= Padrão 3= TAC-Agregado | |
6 | MunicipioOrigemCodigoIBGE | int | Não | Código do IBGE referente ao município de origem. | N/A | |
7 | MunicipioDestinoCodigoIBGE | int | Não | Código do IBGE referente ao município de destino. | N/A | |
8 | DataHoraInicio | Datetime (YYYY-MM-DD) | Sim | Data e hora do início previsto para a realização efetiva da operação de transporte. | N/A | |
9 | DataHoraTermino | Datetime (YYYY-MM-DD) | Sim | Data e hora do término previsto para a realização efetiva da operação de transporte. | N/A | |
10 | DataHoraInicioCadastro | Datetime (YYYY-MM-DD) | Sim | Data e hora do início do cadastro da operação de transporte. | N/A | |
11 | DataHoraFimCadastro | Datetime (YYYY-MM-DD) | Sim | Data e hora do fim do cadastro da operação de transporte. | N/A | |
12 | CPFCNPJContratado | string | Sim | CPF ou CNPJ do Contratado para realizar o efetivo transporte. | N/A | |
13 | ValorFrete | decimal | Sim | Valor referente ao frete contratado. | N/A | |
14 | ValorCombustivel | decimal | Sim | Valor referente ao combustível calculado. | N/A | |
15 | ValorPedagio | decimal | Sim | Valor referente ao pedágio calculado. | N/A | |
16 | ValorDespesas | decimal | Sim | Valor referente às despesas de viagem. | N/A | |
17 | ValorImpostoSestSenat | decimal | Sim | Valor referente ao imposto SEST SENAT. | Quando houver. | |
18 | ValorImpostoIRRF | decimal | Sim | Valor referente ao imposto IRRF. | Quando houver. | |
19 | ValorImpostoINSS | decimal | Sim | Valor referente ao imposto INSS. | Quando houver. | |
20 | ValorImpostoIcmsIsqn | decimal | Sim | Valor referente ao imposto ICMS ISSQN. | Quando houver. | |
21 | ParcelaUnica | bool (0 || 1) | 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 5= Veloe | |
23 | CategoriaVeiculo | int | Sim | Identificador da categoria do veículo. | ||
24 | NomeMotorista | string | Sim | Nome do motorista da operação de transporte. | N/A | |
25 | CPFMotorista | long | Sim | CPF do motorista da operação de transporte. | N/A | |
26 | RNTRCMotorista | string | Sim | RNTRC do motorista da operação de transporte. | N/A | |
27 | Quitacao | bool (true || false) | Sim | Indica se a operação de transporte em questão participará do processo de Triagem de Documentos e Quitação. | N/A | |
28 | ItemFinanceiro | string | Sim | Número do documento da Operação de Transporte. | N/A | |
29 | Parcelas | List< Operação Transporte Parcela Request> | Sim | Lista de Parcelas. | N/A | |
30 | Veiculos | List< Operação Transporte Veiculo Request> | Sim | Lista de Veículos. | N/A | |
31 | Participantes | List< Operação Transporte Participante Request> | Sim | Lista de Parcelas. | N/A | |
32 | Triagens | List< Operação Transporte Triagem Request> | Sim | Lista de Triagens. | N/A | |
33 | 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. | N/A | |
34 | DeduzirImpostos | bool (true || false) | Não | Deduzir Impostos |
| |
35 | TarifasBancarias | decimal (12,2) | Sim | Valor referente a Tarifas Bancárias (quando houver). | O valor total das tarifas bancárias será subtraído do valor total do frete. | |
36 | QuantidadeTarifasBancarias | int | Sim | Quantidade de Tarifas Bancárias. | Deve ser informado 8 como dizem as regras da ANTT conforme resolução abaixo na página 14. | |
37 | IdIntegrador | string | Sim | Gerenciado pelo Integrador. | N/A | |
38 | ValorDescontoAntecipado | decimal (12,2) | Não | Valor a ser aplicado no CIOT no valor bruto, não influenciando nas parcelas do CIOT. | N/A | |
39 | NumeroLacreTransporteCombustivel | string | Não | Número Lacre Transportes Combustível | N/A | |
39 | NumeroLacreTransporteCombustivel | string | Não | Número Lacre Transportes Combustível | N/A | |
40 | 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). | |
41 | DocumentoValePedagio | string | Não | Observações da compra de Vale-Pedágio Cartão ou TAG | N/A | |
42 | ValorImpostoISS | decimal | Não | Valor do Imposto ISS | N/A | |
43 | TipoFormaPagamento | enum | Não | Tipo de pagamento do Frete | BaseadoNasParcelas = 1 OutraIPEF = 2 Outro = 3 | |
44 | CepOrigem | string | Não | Cep de Origem da viagem | N/A | |
45 | CepDestino | string | Não | Cep de destino da viagem | N/A | |
46 | TipoCargaANTT | int | Não | Tipo Carga ANTT | GranelSolido = 1 PerigosaCargaPressurizada = 12 | |
47 | DistanciaPercorrida | int | Não | Distancia total a ser percorrida na viagem | N/A | |
48 | AltoDesempenho | bool(true || false) | Não | Indica se sera uma viagem de alto desempenho. | N/A | |
49 | DestinacaoComercial | bool(true || false) | Não | Indica se sera uma viagem com destinação comercial. | N/A | |
50 | FreteRetorno | List<DadosFrete RetornoRequest> | Não | Distancia (em km) percorrida entre o CEP destino e o CEP retorno informado. | N/A | |
51 | CnpjPagamentoOutraIPEF | string | Não | CNPJ da IPEF na qual sera realizado o pagamento | 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 | O campo foi descontinuado. Favor informar zero. | |
4 | DataVencimento | Datetime (YYYY-MM-DD) | Sim | Data de Vencimento da Parcela | N/A | |
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 2= Depósito Conta | |
7 | CartaoPagamento | string | Não | Cartão Pagamento da Parcela | Obrigatório se FormaPagamento = 1 | |
8 | CodigoBanco | string | Não | Código do Banco | Obrigatório Se FormaPagamento = 2 (Vide Capítulo deAnexos). | |
9 | AgenciaDeposito | string | Não | Agência Depósito | Obrigatório Se FormaPagamento = 2 (Vide Capítulo deAnexos). | |
10 | ContaDeposito | string | Não | Conta Depósito | Obrigatório Se FormaPagamento = 2 (Vide Capítulo deAnexos). | |
11 | DigitoContaDeposito | string | Sim | Dígito Conta Depósito | Obrigatório Se FormaPagamento = 2 (Vide Capítulo deAnexos). | |
12 | ProcessarAutomaticamente | bool (true || false) | Não | Processar Automaticamente | Se a parcela será paga automaticamente de acordo com a data de vencimento ou se a mesma será paga manualmente através da Plataforma Web ou através do método - 'ProcessarParcelaManual'. | |
13 | IdOperacaoTransporteParcela | int | Não | Descrição da Parcela | N/A | |
14 | FlagContaPoupanca | bool (true || false) | Sim | Descrição da Parcela | N/A | |
15 | VariacaoContaPoupanca | string | Não | Variação Conta Poupança | N/A | |
16 | ItemFinanceiroParcela | string | Sim | Item Financeiro Parcela | N/A | |
17 | Observacao | string(255) | Não | Observação | N/A | |
18 | FlagContaPagamento | bool (true || false) | Não | Descrição da 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 vinculado ao veículo | N/A | |
OperacaoTransporteParticipanteRequest | ||||||
Nº | Campo | Tipo | Obrigatório | Descrição | Observação | |
1 | CPFCNPJParticipante | string | Sim | CPF ou CNPJ do participante da viagem. | N/A | |
2 | TipoParticipante | int | Sim | Identificador do Tipo de Participante. | N/A | |
3 | DestinatarioFinal | bool (true || false) | Não | Destinatário Final | N/A | |
OperacaoTransporteTriagemRequest | ||||||
Nº | Campo | Tipo | Obrigatório | Descrição | Observação | |
1 | IdTriagemDocumentoObjeto | int | Sim | Identificador Triagem Documento Objeto. | O Objeto - OperacaoTransporteTriagemRequest não está mais em uso. | |
2 | NomeDocumentoObjeto | string | Sim | Nome Documento Objeto. | O Objeto - OperacaoTransporteTriagemRequest não está mais em uso. | |
3 | ExigeUpload | string | Sim | Exige Upload. | O Objeto - OperacaoTransporteTriagemRequest não está mais em uso. | |
4 | ExigeDocumentoObjetoFisico | string | Sim | Exige Documento Objeto Físico. | O Objeto - OperacaoTransporteTriagemRequest não está mais em uso. | |
5 | DocumentoObjeto | string | Sim | Documento Objeto. | O Objeto - OperacaoTransporteTriagemRequest não está mais em uso. | |
6 | Relacionados | List< Operação Transporte Triagem Relacionado Request> | Sim | Triagem Relacionadas | O Objeto - OperacaoTransporteTriagemRequest não está mais em uso. | |
OperacaoTransporteResponse | ||||||
Nº | Campo | Tipo | Obrigatório | Descrição | Observação | |
1 | CodigoErro | int | Sim | Retorna o código de Erro. | Se o participante tiver sido cadastrado com sucesso, o código será 0. | |
2 | MensagemRetorno | string | Não | Mensagem indicando o tipo de retorno da função. | N/A | |
3 | Sucesso | bool (true || false) | Não | Confirmação se o cadastro foi efetivado com sucesso. | N/A | |
4 | DataHoraCadastro | Datetime (YYYY-MM-DD) | Sim | Data e Hora de Cadastro do novo autônomo (Cliente) no sistema Target Frete. | N/A | |
5 | IdOperacaoTransporte | int | Sim | Identificador do CIOT cadastrado no sistema TARGET frete. | N/A |
Método
Abaixo, segue o método - 'CadastrarOperacaoDescritiva'.
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:tar="http://schemas.datacontract.org/2004/07/TARGET.VectioFrete.Application.WCF.Contracts.External"> <soapenv:Header/> <soapenv:Body> <tem:CadastrarOperacaoDescritiva> <tem:operacaoRequest> <tar:CodigoCentroDeCusto>?</tar:CodigoCentroDeCusto> <tar:NCM>?</tar:NCM> <tar:ProprietarioCarga>?</tar:ProprietarioCarga> <tar:PesoCarga>?</tar:PesoCarga> <tar:TipoOperacao>?</tar:TipoOperacao> <tar:MunicipioOrigemCodigoIBGE>?</tar:MunicipioOrigemCodigoIBGE> <tar:MunicipioDestinoCodigoIBGE>?</tar:MunicipioDestinoCodigoIBGE> <tar:DataHoraInicio>?</tar:DataHoraInicio> <tar:DataHoraTermino>?</tar:DataHoraTermino> <tar:DataHoraInicioCadastro>?</tar:DataHoraInicioCadastro> <tar:DataHoraFimCadastro>?</tar:DataHoraFimCadastro> <tar:CPFCNPJContratado>?</tar:CPFCNPJContratado> <tar:ValorFrete>?</tar:ValorFrete> <tar:ValorCombustivel>?</tar:ValorCombustivel> <tar:ValorPedagio>?</tar:ValorPedagio> <tar:ValorDespesas>?</tar:ValorDespesas> <tar:ValorImpostoSestSenat>?</tar:ValorImpostoSestSenat> <tar:ValorImpostoIRRF>?</tar:ValorImpostoIRRF> <tar:ValorImpostoINSS>?</tar:ValorImpostoINSS> <tar:ValorImpostoIcmsIssqn>?</tar:ValorImpostoIcmsIssqn> <tar:ParcelaUnica>?</tar:ParcelaUnica> <tar:ModoCompraValePedagio>?</tar:ModoCompraValePedagio> <tar:CategoriaVeiculo>?</tar:CategoriaVeiculo> <tar:NomeMotorista>?</tar:NomeMotorista> <tar:CPFMotorista>?</tar:CPFMotorista> <tar:RNTRCMotorista>?</tar:RNTRCMotorista> <tar:Quitacao>?</tar:Quitacao> <tar:ItemFinanceiro>?</tar:ItemFinanceiro> <tar:Parcelas> <tar:OperacaoTransporteParcelaRequest> <tar:DescricaoParcela>?</tar:DescricaoParcela> <tar:Valor>?</tar:Valor> <tar:NumeroParcela>?</tar:NumeroParcela> <tar:DataVencimento>?</tar:DataVencimento> <tar:TipoDaParcela>?</tar:TipoDaParcela> <tar:FormaPagamento>?</tar:FormaPagamento> <tar:CartaoPagamento>?</tar:CartaoPagamento> <tar:CodigoBanco>?</tar:CodigoBanco> <tar:AgenciaDeposito>?</tar:AgenciaDeposito> <tar:ContaDeposito>?</tar:ContaDeposito> <tar:DigitoContaDeposito>?</tar:DigitoContaDeposito> <tar:ProcessarAutomaticamente>?</tar:ProcessarAutomaticamente> <tar:IdOperacaoTransporteParcela>?</tar:IdOperacaoTransporteParcela> <tar:FlagContaPoupanca>?</tar:FlagContaPoupanca> <tar:VariacaoPoupanca>?</tar:VariacaoPoupanca> <tar:ItemFinanceiroParcela>?</tar:ItemFinanceiroParcela> <tar:Observacao>?</tar:Observacao> </tar:OperacaoTransporteParcelaRequest> </tar:Parcelas> <tar:Veiculos> <tar:OperacaoTransporteVeiculoRequest> <tar:Placa>?</tar:Placa> <tar:RNTRC>?</tar:RNTRC> </tar:OperacaoTransporteVeiculoRequest> </tar:Veiculos> <tar:Participantes> <tar:OperacaoTransporteParticipanteRequest> <tar:CPFCNPJParticipante>?</tar:CPFCNPJParticipante> <tar:TipoParticipante>?</tar:TipoParticipante> <tar:DestinatarioFinal>?</tar:DestinatarioFinal> </tar:OperacaoTransporteParticipanteRequest> </tar:Participantes> <tar:Triagem> <tar:OperacaoTransporteTriagemRequest> <tar:IdTriagemDocumentoObjeto>?</tar:IdTriagemDocumentoObjeto> <tar:NomeDocumentoObjeto>?</tar:NomeDocumentoObjeto> <tar:ExigeUpload>?</tar:ExigeUpload> <tar:ExigeDocumentoObjetoFisico>?</tar:ExigeDocumentoObjetoFisico> <tar:DocumentoObjeto>?</tar:DocumentoObjeto> <tar:Relacionados> <tar:OperacaoTransporteTriagemRelacionadoRequest> <tar:CaminhoArquivo>?</tar:CaminhoArquivo> <tar:DataHoraRegistro>?</tar:DataHoraRegistro> <tar:IdOperacaoTransporteTriagem>?</tar:IdOperacaoTransporteTriagem> <tar:IdOperacaoTransporteTriagemRelacionado>?</tar:IdOperacaoTransporteTriagemRelacionado> <tar:Numero>?</tar:Numero> <tar:Origem>?</tar:Origem> </tar:OperacaoTransporteTriagemRelacionadoRequest> </tar:Relacionados> </tar:OperacaoTransporteTriagemRequest> </tar:Triagem> <tar:IdRotaModelo>?</tar:IdRotaModelo> <tar:DeduzirImpostos>?</tar:DeduzirImpostos> <tar:TarifasBancarias>?</tar:TarifasBancarias> <tar:QuantidadeTarifasBancarias>?</tar:QuantidadeTarifasBancarias> <tar:IdIntegrador>?</tar:IdIntegrador> <tar:ValorDescontoAntecipado>?</tar:ValorDescontoAntecipado> <tar:NumeroLacreTransporteCombustivel>?</tar:NumeroLacreTransporteCombustivel> <tar:NumeroCartaoValePedagio>?</tar:NumeroCartaoValePedagio> <tar:DocumentoValePedagio>?</tar:DocumentoValePedagio> <tar:CEPOrigem>?</tar:CEPOrigem> <tar:CEPDestino>?</tar:CEPDestino> <tar:TipoCargaANTT>?</tar:TipoCargaANTT> <tar:DistanciaPercorrida >?</tar:DistanciaPercorrida> </tms:operacao> </tem:operacaoRequest> </tem:CadastrarOperacaoDescritiva> </soapenv:Body> </soapenv:Envelope>