DOCUMENTAÇÃO CORPORATIVA

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 21 Next »

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

  1. Este método não registra a operação na ANTT, o mesmo somente cadastra as informações no sistema TARGET Frete.
  2. 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

Campo

Tipo

Obrigatório

Descrição

Observação

1CodigoCentroDeCustostringNãoCódigo do Centro de Custo do Cliente no sistema 'Target Frete'.N/A
2NCMstringSimCódigo de 4 caracteres que identifica a Natureza carga posição previsto pelo SH (Sistema Harmonizado) exigido pela
ANTT.

Ministério da Fazenda - NCM
3ProprietarioCargastringSimIndica quem é o Consignatário/Proprietário da Carga.1= Remetente
2= Destinatário
4PesoCargadecimalSimIndica o peso da carga que está sendo transportada entre a origem e destino.N/A
5TipoOperacaostringSimTipo da operação de transporte que está sendo contratada.1= Padrão
3= TAC-Agregado
6MunicipioOrigemCodigoIBGEintNãoCódigo do IBGE referente ao município de origem.N/A
7MunicipioDestinoCodigoIBGEintNãoCódigo do IBGE referente ao município de destino.N/A
8DataHoraInicioDatetime (YYYY-MM-DD)SimData e hora do início previsto para a realização efetiva da operação de transporte.N/A
9DataHoraTerminoDatetime (YYYY-MM-DD)SimData e hora do término previsto para a realização efetiva da operação de transporte.N/A
10DataHoraInicioCadastroDatetime (YYYY-MM-DD)SimData e hora do início do cadastro da operação de transporte.N/A
11DataHoraFimCadastroDatetime (YYYY-MM-DD)SimData e hora do fim do cadastro da operação de transporte.N/A
12CPFCNPJContratadostringSimCPF ou CNPJ do Contratado para realizar o efetivo transporte.N/A
13ValorFretedecimalSimValor referente ao frete contratado.N/A
14ValorCombustiveldecimalSimValor referente ao combustível calculado.N/A
15ValorPedagiodecimalSimValor referente ao pedágio calculado.N/A
16ValorDespesasdecimalSimValor referente às despesas de viagem.N/A
17ValorImpostoSestSenatdecimalSimValor referente ao imposto SEST SENAT.Quando houver.
18ValorImpostoIRRFdecimalSimValor referente ao imposto IRRF.Quando houver.
19ValorImpostoINSSdecimalSimValor referente ao imposto INSS.Quando houver.
20ValorImpostoIcmsIsqndecimalSimValor referente ao imposto ICMS ISSQN.Quando houver.
21ParcelaUnicabool (0 || 1)SimFlag que define se a operação será paga em parcela únicaN/A
22ModoCompraValePedagiointSimIdentificador do modo de compra do vale pedágio1= Cartão Transporte Bradesco Target
2= Via Fácil (Sem Parar)
4= Nenhum
23CategoriaVeiculointSimIdentificador da categoria do veículo.
24NomeMotoristastringSimNome do motorista da operação de transporte.N/A
25CPFMotoristalongSimCPF do motorista da operação de transporte.N/A
26RNTRCMotoristastringSimRNTRC do motorista da operação de transporte.N/A
27Quitacaobool (true || false)SimIndica se a operação de transporte em questão participará do processo de Triagem de Documentos e Quitação.N/A
28ItemFinanceirostringSimNúmero do documento da Operação de Transporte.N/A
29ParcelasList<
Operação Transporte Parcela Request>
SimLista de Parcelas.N/A
30VeiculosList<
Operação Transporte Veiculo Request>
SimLista de Veículos.N/A
31ParticipantesList<
Operação Transporte Participante Request>
SimLista de Parcelas.N/A
32TriagensList<
Operação Transporte Triagem Request>
SimLista de Triagens.N/A
33IdRotaModelointNã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.
N/A
34DeduzirImpostosbool (true || false)NãoDeduzir 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:

  1. ValorImpostoSestSenat
  2. ValorImpostoIRRF
  3. ValorImpostoINSS
  4. ValorImpostoIcmsIssqn
35TarifasBancariasdecimal (12,2)SimValor referente a Tarifas Bancárias (quando houver).O valor total das tarifas bancárias será subtraído do valor total do frete.
36QuantidadeTarifasBancariasintSimQuantidade de Tarifas Bancárias.

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

37IdIntegradorstringSimGerenciado pelo Integrador.N/A
38ValorDescontoAntecipadodecimal (12,2)NãoValor a ser aplicado no CIOT no valor bruto, não influenciando nas parcelas do CIOT.N/A
39NumeroLacreTransporteCombustivelstringNãoNúmero Lacre Transportes CombustívelN/A
39NumeroLacreTransporteCombustivelstringNãoNúmero Lacre Transportes CombustívelN/A
40NumeroCartaoValePedagiostringNã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).
41DocumentoValePedagiostringNãoObservações da compra de Vale-Pedágio Cartão ou TAGN/A
42CEPOrigemstringNãoCEP OrigemN/A
43CEPDestinostringNãoCEP DestinoN/A
44TipoCargaANTTintNãoTipo Carga ANTTGranelSolido = 1
GranelLiquido = 2
Frigorificada = 3
Conteinerizada = 4
CargaGeral = 5
Neogranel = 6
PerigosaGranelSolido = 7
PerigosaGranelLiquido = 8
PerigosaCargaFrigorificada = 9
PerigosaConteinerizada = 10
PerigosaCargaGeral = 11
45DistanciaPercorridaintNãoDistância PercorridaN/A
46AltoDesempenhobool(true || false)NãoIndica se o veículo é de alto desempenho ou não.N/A
47DestinaçãoComercialbool(true || false)NãoIndica se o transporte da carga tem destinação comercial.N/A
48FreteRetornobool(true || false)NãoIndica se existe frete de retorno.Indica se existe frete de retorno.N/A
49CepRetornostringNãoCEP de retorno da cargaN/A
50DistanciaRetornostringNãoDistancia (em km) percorrida entre o CEP destino e o CEP retorno informado.N/A

OperacaoTransporteParcelaRequest

Campo

Tipo

Obrigatório

Descrição

Observação

1DescricaoParcelastringSimDescrição da ParcelaN/A
2ValordecimalSimValor da ParcelaN/A
3NumeroParcelaintSimNúmero da ParcelaO campo foi descontinuado. Favor informar zero.
4DataVencimentoDatetime (YYYY-MM-DD)SimData de Vencimento da ParcelaN/A
5TipoDaParcelaintSimTipo da Parcela

1= Adiantamento

2= Intermediária

3= Saldo

4= Adicional

6FormaPagamentointSimForma de Pagamento da Parcela

1= Cartão

2= Depósito Conta

7CartaoPagamentostringNãoCartão Pagamento da ParcelaObrigatório se FormaPagamento = 1
8CodigoBancostringNãoCódigo do BancoObrigatório Se FormaPagamento = 2 (Vide Capítulo deAnexos).
9AgenciaDepositostringNãoAgência DepósitoObrigatório Se FormaPagamento = 2 (Vide Capítulo deAnexos).
10ContaDepositostringNãoConta DepósitoObrigatório Se FormaPagamento = 2 (Vide Capítulo deAnexos).
11DigitoContaDepositostringSimDígito Conta DepósitoObrigatório Se FormaPagamento = 2 (Vide Capítulo deAnexos).
12ProcessarAutomaticamentebool (true || false)NãoProcessar AutomaticamenteSe 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'.  
13IdOperacaoTransporteParcelaintNãoDescrição da ParcelaN/A
14FlagContaPoupancabool (true || false)SimDescrição da ParcelaN/A
15VariacaoContaPoupancastringNãoVariação Conta PoupançaN/A
16ItemFinanceiroParcelastringSimItem Financeiro ParcelaN/A
17Observacaostring(255)NãoObservaçãoN/A

OperacaoTransporteVeiculoRequest

Campo

Tipo

Obrigatório

Descrição

Observação

1PlacastringSimPlaca do veículoN/A
2RNTRCstringSimRNTRC vinculado ao veículoN/A

OperacaoTransporteParticipanteRequest

Campo

Tipo

Obrigatório

Descrição

Observação

1CPFCNPJParticipantestringSimCPF ou CNPJ do participante da viagem.N/A
2TipoParticipanteintSimIdentificador do Tipo de Participante.N/A
3DestinatarioFinalbool (true || false)NãoDestinatário FinalN/A

OperacaoTransporteTriagemRequest

Campo

Tipo

Obrigatório

Descrição

Observação

1IdTriagemDocumentoObjetointSimIdentificador Triagem Documento Objeto.O Objeto - OperacaoTransporteTriagemRequest não está mais em uso.
2NomeDocumentoObjetostringSimNome Documento Objeto.O Objeto - OperacaoTransporteTriagemRequest não está mais em uso.
3ExigeUploadstringSimExige Upload.O Objeto - OperacaoTransporteTriagemRequest não está mais em uso.
4ExigeDocumentoObjetoFisicostringSimExige Documento Objeto Físico.O Objeto - OperacaoTransporteTriagemRequest não está mais em uso.
5DocumentoObjetostringSimDocumento Objeto.O Objeto - OperacaoTransporteTriagemRequest não está mais em uso.
6RelacionadosList<
Operação Transporte Triagem Relacionado Request>
SimTriagem RelacionadasO Objeto - OperacaoTransporteTriagemRequest não está mais em uso.

OperacaoTransporteResponse

Campo

Tipo

Obrigatório

Descrição

Observação

1CodigoErrointSimRetorna o código de Erro.Se o participante tiver sido cadastrado com sucesso, o código será 0.
2MensagemRetornostringNãoMensagem indicando o tipo de retorno da função.N/A
3Sucessobool (true || false)NãoConfirmação se o cadastro foi efetivado com sucesso.N/A
4DataHoraCadastroDatetime (YYYY-MM-DD)SimData e Hora de Cadastro do novo autônomo (Cliente) no sistema Target Frete.N/A
5IdOperacaoTransporteintSimIdentificador do CIOT cadastrado no sistema TARGET frete.N/A



Método

Abaixo, segue o método - 'CadastrarOperacaoDescritiva'.

OperacaoTransporteRequest
<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>
  • No labels