ÍNDICE| Índice |
|---|
| maxLevel | 5 |
|---|
| exclude | Produto|Menu|Data|Autor|Uso Interno|Área |
|---|
|
Cadastrar as Referências para Integração de CT-e (De/Para)Quando um Conhecimento de Transporte (CT-e) é recebido, ele está vinculado a uma ou mais Notas Fiscais de origem (as notas das mercadorias transportadas). Para que o sistema consiga gerar a Nota Fiscal de Entrada de Despesa de Frete de forma 100% automática, ele precisa identificar os parâmetros corretos para o novo lançamento. A tela Configuração da Escrituração Automática de CT-e funciona como uma regra de De/Para. Quando o CT-e é localizado, o sistema consulta a Nota Fiscal de origem relacionada ao frete. Com base nas informações dessa nota, procura uma regra correspondente e aplica os dados configurados para gerar a nota de despesa: - Localização: O serviço lê o CT-e e identifica a Nota Fiscal de origem da carga já cadastrada no sistema.
- Consulta: Consulta a tabela de Referências para CT-e procurando uma regra que coincida com a Empresa, Revenda, Transação, Origem e Departamento, Cliente e Categoria Cliente daquela nota de origem.
- Aplicação: Ao encontrar a correspondência, o sistema aplica a transação, origem, departamento e tributações configuradas para escriturar a Nota Fiscal de Despesa.
Atenção: Se o serviço tentar processar um CT-e e não encontrar uma regra correspondente na tabela de Referências, o lançamento automático não será concluído e uma mensagem de alerta será enviada ao usuário responsável para as devidas correções. Se a referência de CT-e for cadastrada preenchendo apenas as informações do lado esquerdo (Parâmetros da NF de Origem do Frete) e o lado direito (Parâmetros de Escrituração do CT-e) for deixado em branco, a nota não será processada e também não gerará mensagem de erro.
Mapeamento de Campos da TelaAo acessar a tela de Configuração (Faturamento → Cadastros → Referências CT-e), a parametrização é dividida em dois blocos principais: - Parâmetros da NF de Origem do Frete (Critérios de Busca - Lado Esquerdo): Define os filtros que o sistema usará para identificar a Nota Fiscal da mercadoria:
- Departamento (Obrigatório): Informe o departamento da Nota Fiscal de origem;
- Tipo Transação (Obrigatório): Informe a transação utilizada na Nota Fiscal de origem;
- Origem: Informe o código da origem da nota de origem (opcional);
- Cliente: Código do cliente vinculado (opcional);
- Categoria Cliente: Categoria do cliente vinculado (opcional).
- Parâmetros de Escrituração do CT-e (Dados para Geração da Despesa - Lado Direito): Define os dados que serão gravados na Nota Fiscal de Despesa de Frete gerada:
- Descrição Nota fiscal de despesa: Descrição padrão que identificará a nota gerada;
- Tipo Transação Nota fiscal de despesa: Código da transação para o lançamento da despesa;
- Departamento Nota fiscal de despesa: Departamento para lançamento do frete;
- Origem Nota fiscal de despesa: Código da origem para o lançamento do frete;
- Código Pagamento: Forma de pagamento atribuída à despesa;
- Código Tributação Dentro do Estado: Regra tributária para fretes estaduais;
- Código Tributação Fora do Estado: Regra tributária para fretes interestaduais.
Atenção: Se qualquer campo do lado direito "Parâmetros de Escrituração do CT-e" for preenchido, todos os demais campos desse bloco tornam-se obrigatoriamente exigidos para validar a regra.
| Dica |
|---|
Exemplo Prático de Aplicação:Dados da Nota Fiscal de Origem (Mercadoria): Tipo de Transação: P23 Departamento: 10 Regra de Referência do CT-e Cadastrada: Tipo Transação Nota fiscal de despesa: P02 Departamento Nota fiscal de despesa: 20 Código Pagamento: 30 Código Tributação Dentro do Estado: 110 Resultado do Processamento Automático: A Nota Fiscal de Despesa de Frete será escriturada automaticamente com a transação P02, alocada no departamento 20, utilizando a forma de pagamento 30 e a tributação 110. |
Ativação da Automação nos Parâmetros do Faturamento Após concluir o cadastro de referências (de/para), é necessário habilitar a funcionalidade, definir a data inicial de corte para o processamento e configurar os usuários que acompanharão o processo. - Caminho de Acesso:Faturamento > Parâmetros > Aba Geral(menu 58900)
Mapeamento dos Campos da Seção "Integração Automática CT-e"- Utiliza integração Automática CT-e : Marque este campo para habilitar a execução automática da escrituração dos Conhecimentos de Transporte Eletrônicos (CT-es).
- Processar CT-e a partir de: (Opcional): Informe a data de corte inicial para o processamento automático. O serviço considerará apenas os CT-es emitidos ou recebidos a partir desta data. Exemplo:
01/08/2026.
Observação: Caso este campo permaneça em branco, o sistema processará automaticamente todos os CT-es pendentes na base de dados que ainda não foram escriturados.
- Usuários Notificação Erro Integração CT-e: Defina o(s) usuário(s) responsável(is) por acompanhar a integração e receber os alertas do sistema.
Notificações e Acompanhamento do ProcessoOs usuários configurados no campo "Usuários Notificação Erro Integração CT-e" receberão mensagens de acompanhamento nas seguintes situações: - Início e Término da Execução: Notificações informando quando o serviço automático iniciar ou finalizar seu ciclo de processamento.
- Inconsistências ou Falhas: Alertas detalhados sempre que for identificada alguma pendência que impeça a escrituração automática (como ausência de referência de/para cadastrada ou erro de importação do XML).
As notificações poderão ser acompanhadas diretamente no ícone de Sino (Notificações), localizado no canto superior direito da tela. Ao clicar no ícone, o usuário visualizará no painel as mensagens geradas sob o título "Importação Automática CTE", exibindo a quantidade de documentos processados, o resumo da integração por Empresa/Revenda e os eventuais alertas de erro para tratativa. Atenção: Mantenha a opção "Utiliza integração Automática CT-e" desmarcada até que todas as regras da tela de Referências para CT-e estejam devidamente cadastradas, garantindo que o serviço processe os documentos corretamente sem gerar alertas desnecessários.
 Image Modified
 Image Modified
Funcionamento da Automação Após a parametrização dos cadastros e a habilitação do parâmetro no sistema, o serviço passa a rodar de forma automática em segundo plano a cada 1 hora, sem necessidade de interação manual do usuário. O ciclo de integração executa automaticamente as seguintes etapas: - Localização dos CT-es: Identifica na base os Conhecimentos de Transporte Eletrônicos (CT-es) destinados à empresa que ainda não foram escriturados.
- Identificação das Notas Fiscais de Origem: Consulta no documento de frete quais são as Notas Fiscais da mercadoria vinculadas ao transporte.
- Validação da Escrita da Origem: Verifica se a Nota Fiscal de origem correspondente já está gravada/escriturada no sistema.
- Busca da Referência de CT-e: Consulta a tabela de Referências para CT-e para localizar uma regra de De/Para compatível com a transação, origem e departamento da nota de origem.
- Geração Automática da Despesa: Executa a importação e gera automaticamente a Nota Fiscal de Entrada de Despesa de Frete com base nos parâmetros configurados.
Nota de Reprocessamento: Caso algum CT-e não seja integrado por inconsistência (como ausência de referência ou nota de origem pendente), o sistema efetuará uma nova tentativa de reprocessamento automático após o intervalo de 24 horas a partir do último envio.
Monitoramento e Acompanhamento dos CT-esMesmo com o processo de escrituração ocorrendo de forma 100% automatizada, todos os Conhecimentos de Transporte (CT-es) e as respectivas Notas Fiscais de Despesa geradas podem ser consultados e auditados normalmente no sistema. - Caminho de Acesso: Faturamento > Consultas / Relatórios > Notas Fiscais
Nesta tela, o operador poderá: - Consultar Documentos Emitidos e Recebidos: Pesquisar as Notas Fiscais de Despesa de frete geradas pela automação.
- Verificar o Histórico: Checar os detalhes de emissão, valores, transações aplicadas e vínculo com as Notas Fiscais de origem.
- Acompanhar Status Fiscal: Confirmar se o CT-e foi escriturado com sucesso ou se necessita de alguma tratativa manual no sistema.
|