GA | Gerador de CIOT - TruckPad
Este manual orienta o cliente sobre como configurar e utilizar a emissão de CIOT pela integração TruckPad dentro do Gerencie Aqui.
- CIOT - Truckpad GA| Requisitos e Configurações
- Acesso ao módulo CIOT | Como gerar ?
- Eventos do CIOT
- Inserir e liberar parcelas
CIOT - Truckpad GA| Requisitos e Configurações
1) Pré-requisitos para utilização da integração
A) Antes de iniciar a emissão de CIOT pela TruckPad dentro do Gerencie Aqui, é necessário que alguns requisitos estejam atendidos:
B) A empresa precisa possuir um plano ativo contratado junto à TruckPad.
C) A liberação da funcionalidade deve estar alinhada com o setor financeiro/comercial do Gerencie Aqui.
D) O usuário deve possuir as credenciais de acesso à TruckPad.(
E-mail TruckPad/Senha/Token)
O vínculo entre a empresa, o token de integração e o ID da empresa vinculada deve estar configurado corretamente.
O MDF-e deve estar configurado para utilizar a integração CIOT desejada.
2) Configuração TruckPad
A primeira etapa é realizar a configuração de acesso à TruckPad dentro do Gerencie Aqui.
Campos da tela
E-mail TruckPad
Informe o e-mail utilizado para acesso à conta TruckPad contratada pela empresa.
Senha
Informe a senha correspondente ao usuário TruckPad.
Token
O token é a chave de integração utilizada para autenticar a comunicação entre o Gerencie Aqui e a TruckPad.
Login
Após preencher e validar as credenciais, o botão de login permite autenticar a conta e carregar as empresas disponíveis para vínculo.
Resetar
Utilizado para limpar ou reiniciar as informações de autenticação, caso seja necessário refazer o vínculo.
3) Empresas vinculadas
Após o login, o sistema apresenta a lista de empresas disponíveis para vínculo.
Nessa etapa, deve ser selecionada a empresa que fará a geração do CIOT pelo Gerencie Aqui.
Campos apresentados na listagem:
-
Empresas Vinculadas: nome da empresa disponível para vínculo.
-
CNPJ: CNPJ da empresa vinculada.
-
Razão Social: razão social cadastrada na TruckPad.
-
ID Empresa: identificador da empresa na integração.
-
Selecionar Empresa: botão utilizado para definir qual empresa será vinculada à emissão de CIOT
4) Configuração dos documentos fiscais no MDF-e
Após configurar a TruckPad, é necessário ajustar a configuração do MDF-e para indicar qual integração será utilizada para emissão do CIOT.
Identificação do Ambiente
Define o ambiente de emissão utilizado pelo sistema:
-
Produção: ambiente oficial, utilizado para emissões reais.
-
Homologação: ambiente de testes, utilizado para validações sem efeito fiscal real.
Série
Série utilizada para emissão do MDF-e.
Número do Último MDF-e Emitido
Indica o último número emitido para controle sequencial do MDF-e.
Integração CIOT
Define qual integração será utilizada para geração do CIOT.
Opções disponíveis:
-
Nenhuma: o sistema não utilizará integração para emissão de CIOT.
-
TruckPad: habilita a integração com a TruckPad.
-
NDD: habilita a integração com a NDD, quando disponível e contratada.
Para emissão pela TruckPad, a opção TruckPad deve estar selecionada.
Acesso ao módulo CIOT | Como gerar ?
1) Depois que a configuração estiver concluída e a liberação do plano estiver ativa, o usuário passa a visualizar as opções relacionadas ao CIOT dentro do módulo de MDF-e.
2 ) O sistema
permite duas formas principais de trabalho:
A) Informar manualmente um CIOT já gerado por outro meio, quando a emissão não foi feita pela integração.
(Diretamente dentro do Mdfe apenas)
B) Gerar um novo CIOT dentro do Gerencie Aqui, utilizando a integração configurada.
Para iniciar uma nova emissão, acesse o módulo de MDF-e e clique em Emitir CIOT ou Novo CIOT, conforme a tela.
3) Seleção de documentos para geração do CIOT
Ao clicar em Novo CIOT, o sistema pode apresentar a tela de seleção de documentos. Essa etapa permite importar informações de documentos fiscais já existentes na plataforma, evitando preenchimento manual de todos os dados.
Tipos de documentos disponíveis
NF-e
Permite selecionar notas fiscais eletrônicas já emitidas ou registradas na plataforma. Ao selecionar uma NF-e, o sistema aproveita informações como chave do documento, destinatário, valores e dados de carga, conforme disponibilidade.
MDF-e
Permite aproveitar informações de MDF-e ainda sem autorização, utilizando dados operacionais e de carga para auxiliar no preenchimento do CIOT.
CT-e
Permite utilizar informações do Conhecimento de Transporte Eletrônico, quando aplicável à operação.
Importante
Caso o usuário não queira utilizar a importação de documentos, é possível seguir diretamente com a criação manual do CIOT, clicando em Criar CIOT sem selecionar documentos, quando permitido pela operação.
3) Dados principais do CIOT
Após a seleção dos documentos, ou criação direta do CIOT, o sistema exibe a tela de preenchimento dos dados principais da operação.
Tipo CIOT
Define a modalidade do CIOT que será gerado.
Principais opções:
Normal
Utilizado para operações vinculadas a documentos fiscais específicos, como NF-e, CT-e ou MDF-e. Nesse tipo, quando o CIOT é criado a partir da importação de documentos, o sistema já pode preencher automaticamente parte das informações, como destinatário, dados da chave do documento, valores e carga.
Também é possível realizar o preenchimento manual, caso a operação exija ajuste ou caso o documento não tenha sido importado.
TAC Agregado
Utilizado quando existe uma contratação por vínculo ou período específico com o transportador agregado.
Nesse caso, o transportador presta serviço dentro de uma relação contratual contínua, e não necessariamente em uma única operação isolada.
Por esse motivo, no TAC Agregado não há obrigatoriedade de vincular um documento fiscal na abertura do CIOT.
Informações como remetente, destinatário, tomador, dados de NCM e dados de quitação podem ser tratadas posteriormente, especialmente no evento de encerramento.
De forma simples, no TAC Agregado primeiro é registrado o vínculo da contratação. Os detalhes das operações realizadas dentro daquele vínculo são informados no encerramento.
Por esse motivo a tela de encerramento do agregado possui mais informações que o comum.
(página evento de encerramento)
Data Início
Data inicial da contratação/operação de transporte.
Data Retorno
Data prevista de retorno ou encerramento da operação, quando aplicável.
NCM Predominante
Código NCM predominante da carga transportada.
Seve ser informada conforme a carga principal da operação.
Distância percorrida (km)
Distância estimada da operação de transporte.
Indicadores operacionais
Os indicadores operacionais complementam as características da viagem.
Composição veicular
Indica se a operação envolve composição de veículos.
Alto desempenho
Utilizado quando a operação possui característica de alto desempenho, conforme regra aplicável à contratação.
Retorno vazio
Indica que o veículo realizará retorno sem carga.
4) Partes envolvidas na operação

Remetente
Pessoa ou empresa responsável pela origem fiscal da mercadoria.
Destinatário
Pessoa ou empresa que receberá a mercadoria.
Tomador
Pessoa ou empresa responsável pela contratação ou pagamento do serviço do CONTRATADO INFORMADO.
Consignatário (Opcional)
Quando houver, representa a parte indicada para recebimento ou destinação da carga em nome de outro envolvido.
Origem
Local inicial da operação de transporte.
Destino
Local final da operação de transporte.
Observação sobre importação de documentos
Quando o CIOT é gerado a partir de documentos selecionados, algumas dessas informações podem ser preenchidas automaticamente, conforme os dados disponíveis no documento fiscal.
PORÉM DEVEM SER CONFERIDOS, PRINCIPALMENTE O TOMADOR DO SERVIÇO.
Quando o preenchimento é manual, o usuário deve informar os dados conforme a operação real.
5) Veículos
Nesta etapa, devem ser preenchidas as informações do veículo, transportador contratado e motorista envolvidos na operação.
Placa
Placa do veículo utilizado na operação.
RNTRC
Registro Nacional de Transportadores Rodoviários de Cargas. É a identificação do transportador junto à ANTT.
Categoria Veicular
Categoria do veículo utilizado na operação.
Quantidade de Eixos
Número de eixos do veículo ou composição veicular.
5) Contratado
Nesta etapa, devem ser informados os dados do contratado responsável pela execução do transporte,
Esses dados são fundamentais para a geração do CIOT, pois identificam quem está sendo contratado para realizar o transporte e quem estará vinculado à viagem.
A tela é dividida em informações do proprietário/contratado, subcontratante, RNTRC e motorista.
Dados do proprietário / contratado
Proprietário
Informe o nome ou razão social do proprietário ou contratado responsável pelo transporte. Esse campo identifica o transportador que será vinculado ao CIOT.
Observação importante sobre a responsabilidade das informações
O preenchimento dos dados do contratado deve ser realizado de acordo com o cenário real da operação e com a documentação que o cliente(empresa emitente) possui.
EXISTE MILHARES DE CENÁRIOS POSSÍVEIS!
O sistema disponibiliza os campos necessários para informar o proprietário/contratado, CNPJ ou CPF, RNTRC, subcontratante e motorista.
Porém, a definição de quais dados devem ser utilizados em cada campo depende da análise do próprio cliente (empresa emitente), considerando quem está sendo contratado, quem é o responsável pelo veículo, quem executará o transporte e quais documentos comprovam essa relação.
Por esse motivo, o Gerencie Aqui e a Soften Sistemas como um todo, não determina quem deve ser informado como contratado, proprietário, subcontratante ou motorista.
A responsabilidade por avaliar a operação e preencher os dados corretos é do cliente(empresa emitente), pois é ele quem possui acesso à documentação da contratação, do veículo, do transportador e do motorista.
6) Detalhes da Carga
Na sequência, devem ser preenchidas as informações do veículo utilizado no transporte.
Tipo Doc.
Define o tipo de documento informado, como NF-e, CT-e ou MDF-e.
Chave
Chave de acesso do documento fiscal vinculado à operação.
Valor
Valor da carga ou valor informado para o documento.
KG
Peso da carga em quilogramas.
Volume
Volume transportado.
NCM
Código NCM relacionado à mercadoria transportada.
Inserir
Adiciona o documento e os dados da carga à listagem.
Peso Total (KG)
Campo calculado com base nos pesos informados nos documentos ou itens inseridos.
Observação
Quando o CIOT é criado a partir de documento fiscal importado, a chave e parte dos dados de carga podem ser preenchidos automaticamente.
Caso necessário, o usuário pode ajustar ou complementar as informações antes de salvar.
7)Parcelas e outros valores
A seção de parcelas permite informar os valores que serão pagos ao contratado durante a operação.
Tipos de parcela

Adiantamento
Valor pago antes ou no início da operação.
Intermediária
Valor pago durante o andamento da operação.
Saldo final
Valor pago ao final da operação.
Estadia
Valor referente à permanência, espera ou tempo adicional, quando aplicável.
Tributos
A seção de tributos permite informar valores de impostos ou retenções relacionados ao frete.
Entre as opções disponíveis, podem constar:
-
IR
-
SEST SENAT
-
INSS
-
ISSQN
-
Outros impostos
8)Tipo de pagamento
O sistema permite definir como o pagamento da operação será realizado.
1) Depósito em conta
Indica que o pagamento será realizado por dados bancários informados manualmente.
Campos para depósito em conta
Nº Agência
Número da agência bancária do recebedor.
Dígito
Dígito da agência, quando houver.
Nº Conta
Número da conta bancária.
Banco
Banco de destino do pagamento.
Tipo de conta
Tipo da conta bancária, como conta corrente ou poupança, conforme opções disponíveis.
2) Quando a opção TruckPad é selecionada, o pagamento é realizado pelo fluxo da integradora.
Quando a opção TruckPad for utilizada como forma de pagamento, é importante lembrar que a conta no banco digital da TruckPad e toda a autenticação necessária devem ser feitas antes, diretamente no próprio ambiente da TruckPad.
O Gerencie Aqui apenas utiliza a integração para enviar as informações do CIOT e da operação.
A abertura da conta, validação de acesso, liberação do banco digital, regras de pagamento e demais autorizações financeiras são tratadas pela TruckPad.
Por isso, antes de gerar o CIOT com pagamento pela TruckPad, o cliente (empresa emitente) deve confirmar se a conta está ativa, autenticada e liberada para uso.
Campos
Aceita Ressalva
Indica se o pagamento poderá ser liberado mesmo quando houver alguma divergência ou pendência na operação, conforme as regras aceitas pela TruckPad e pela contratação do cliente (empresa emitente).
Como essa liberação depende da configuração da conta, do banco digital e das regras comerciais da TruckPad, o cliente (empresa emitente) deve confirmar previamente no ambiente da TruckPad se a operação permite pagamento com ressalva.
O Gerencie Aqui apenas envia a opção marcada ou desmarcada conforme a escolha do usuário.
Resp. pela quitação
Informe quem será o responsável por finalizar ou confirmar a quitação do pagamento.
Tipo de desconto
Selecione o tipo de desconto que será aplicado, quando existir desconto na operação.
Perfil da carga
Selecione o perfil que melhor representa a carga transportada, conforme as opções disponíveis na integração.
Tolerância de perda
Informe o percentual de tolerância permitido para diferença, perda ou quebra da carga, quando esse controle fizer parte da operação.
9)Salvando e enviando o CIOT
Após preencher e revisar todas as informações necessárias, clique em Salvar.
Depois de importado, o CIOT poderá aparecer na listagem com status inicial, como NÃO ENVIADO, permitindo o envio posterior.
O Rascunho é salvo de forma automática se transformado um documento Nfe/Mdfe/Cte, e não preenchido todas as informações de imediato sendo possível correções e vlidações posteriores.
Para enviar, acesse o menu de ações do CIOT e clique em Enviar CIOT.
Eventos do CIOT
1) Após a geração do CIOT, podem ser executados eventos conforme a necessidade da operação.
Consultar CIOT
Permite consultar o CIOT e atualizar as informações retornadas pela integração.
Novo evento Ret/Can/Encer
Permite registrar eventos relacionados ao CIOT, como retificação, cancelamento ou encerramento.
1)Retificação
Utilizada para ajustar informações quando permitido pela regra da integração.
2) Cancelamento
Utilizado quando a operação precisa ser cancelada.
A) Encerramentos
Utilizado para finalizar a operação e informar os dados finais, quando exigidos.
CIOT Normal / Padrão
No encerramento do CIOT Normal/Padrão, o processo é mais simples do que no TAC Agregado.
Como os dados principais da operação já foram informados na criação do CIOT, o encerramento solicita basicamente a data de encerramento e o peso entregue.
B) Encerramento do TAC Agregado
No modo TAC Agregado, a tela para informar documentos não é aberta, pois essa modalidade não trabalha obrigatoriamente com a vinculação inicial de um documento fiscal específico.
O TAC Agregado representa uma contratação por vínculo ou por período.
Ou seja, o transportador agregado presta serviço dentro de uma relação contínua, e não necessariamente em uma única operação isolada.
Por esse motivo, informações como remetente, destinatário, tomador, NCM e quitação não ficam disponíveis para preenchimento na abertura do CIOT. Esses dados são informados posteriormente no evento de encerramento.
Campos do encerramento
Origem
Local de origem da operação realizada dentro do período ou vínculo contratado.
Destino
Local de destino da operação.
CEP de origem / CEP de destino
CEP correspondente aos locais informados.
NCM
NCM da mercadoria transportada.
Peso
Peso da carga transportada.
Qtd. viagens
Quantidade de viagens realizadas dentro daquela informação de encerramento.
Inserir
Adiciona a linha de informação do encerramento.
Pagamento no encerramento
TruckPad Pay
Opção de pagamento pelo ambiente da integradora.
Depósito em conta
Opção para pagamento via dados bancários.
Recebedor
Define quem receberá o pagamento, podendo ser proprietário ou motorista, conforme regra aplicável.
Tipo Tributo / Valor
Permite informar os tributos aplicáveis ao encerramento.
M. Combustível
Valor referente a combustível, quando aplicável.
M. Pedágio
Valor referente a pedágio, quando aplicável.
Enviar e autorizar
Envia o evento de encerramento para autorização
Inserir e liberar parcelas
Após o envio do CIOT, conforme o fluxo da integração e a forma de pagamento utilizada, podem ficar disponíveis opções relacionadas às parcelas.
Inserir Parcela
Permite adicionar uma nova parcela ao CIOT, quando a situação do registro e a regra da integração permitirem.
Liberar Parcela
Permite liberar uma parcela para pagamento, conforme o fluxo operacional e financeiro definido na contratação.
Observação
A disponibilidade dessas opções pode variar conforme o status do CIOT, a forma de pagamento selecionada e as regras retornadas pela integração TruckPad.