Pular para o conteúdo principal

CTe

A tela CTe é a caixa de entrada dos Conhecimentos de Transporte Eletrônicos (CT-e) emitidos contra o CNPJ da empresa — documentos fiscais que as transportadoras geram para cobrar o frete pelos pedidos enviados. O idworks consulta a SEFAZ automaticamente, traz o XML e a DANFE, e a partir desta tela o time fiscal/financeiro consulta o CT-e, vincula o pedido correspondente, compara peso e valores cobrados versus o que foi vendido, cria a conta a pagar da transportadora com os dados do CT-e e baixa o XML/DANFE individualmente ou em lote.

Cada linha mostra: data e número do CT-e, tipo (Normal, Complementar, Anulação, Substituição, Fatura), situação SEFAZ, número e chave de acesso da nota fiscal de produto vinculada, transportadora emissora, tomador do frete (Remetente, Expedidor, Recebedor, Destinatário ou Outros), serviço prestado, peso cobrado vs. peso do pedido, valores (frete, GRIS, ICMS, ISS, frete total) e — quando há simulação de frete cadastrada — também o valor simulado e a diferença. A coluna R$ net frete destaca em verde, vermelho ou cinza a sobra/déficit entre o frete cobrado pelo cliente e o frete pago à transportadora.

As configurações que mudam o comportamento ficam em outras telas (cadastro de transportadora com integração, regras de simulação de frete) — esta tela é majoritariamente somente consulta, com uma única ação criadora: Criar Contas a Pagar a partir do CT-e.

Índice​

Conceito

Busca e visualização

Análise de frete

Ações em linha

Regras de negócio

Referência rápida

O que é a tela CTe?​

É a caixa de entrada dos Conhecimentos de Transporte Eletrônicos (CT-e) emitidos contra o CNPJ da empresa. Cada linha é um CT-e que uma transportadora emitiu para cobrar o frete de um (ou mais) pedido. A partir daqui o time fiscal/financeiro consulta o CT-e, vincula o pedido correspondente, cria a conta a pagar da transportadora e baixa o XML/DANFE.

📍 Onde: menu lateral → Notas Fiscais → CTe.

Qual a diferença entre CTe e Feed Nota Fiscal?​

CTe (esta tela)Feed Nota Fiscal
DocumentoCT-e — Conhecimento de Transporte Eletrônico (cobrança do frete pela transportadora).NF-e — Nota Fiscal Eletrônica de produto (compra de mercadoria).
Quem emiteA transportadora, contra o CNPJ da empresa.O fornecedor, contra o CNPJ da empresa.
Para que serveAcompanhar a cobrança de frete, conferir peso e valores, criar a conta a pagar da transportadora.Acompanhar a chegada de mercadoria, criar o recebimento dos itens (estoque) e a conta a pagar.
Tem Criar Recebimento?Não — CT-e não movimenta estoque.Sim.
Tem Criar Contas a Pagar?Sim — sempre obrigatório (não há "criar recebimento" associado).Sim, alternativa ao recebimento.
Manifestação SEFAZ?Não.Sim (Confirmação, Ciência, Desconhecimento, Operação não Realizada).
OndeNotas Fiscais → CTe.Notas Fiscais → Feed Nota Fiscal.

Os dois compartilham o mesmo padrão visual (lista, painel de filtros, ícones de DANFE/XML) e a fonte comum (SEFAZ), mas tratam de documentos fiscais diferentes.

O que é um CT-e e por que ele aparece aqui?​

O CT-e (Conhecimento de Transporte Eletrônico) é o documento fiscal que a transportadora emite para cobrar o frete de uma entrega. Sempre que um pedido seu é enviado por uma transportadora, em algum momento ela vai emitir o CT-e correspondente e enviá-lo para a SEFAZ. Como o documento tem o CNPJ da sua empresa como tomador (ou destinatário, dependendo do tipo de contratação do frete), o idworks consegue puxar essas notas direto da SEFAZ — e elas aparecem nesta tela.

Quando o CT-e cita uma chave de NF-e de saída sua, o idworks faz o vínculo automaticamente: a coluna Pedido já vem preenchida com o pedido original e dá para abrir o detalhe do pedido pelo ícone de olho.

O que significa cada Tipo de CT-e (Normal, Complementar, Anulação, Substituição, Fatura)?​

A coluna Tipo identifica a natureza do documento de transporte:

TipoSignificado
CT-e NormalCT-e padrão — cobrança do frete da entrega. É o tipo mais comum.
CT-e ComplementarCT-e adicional ao Normal, usado para complementar valores ou impostos não informados originalmente (sem refazer o documento).
AnulaçãoCT-e que anula um CT-e anterior (geralmente porque foi emitido incorretamente).
SubstituiçãoCT-e que substitui um CT-e anterior por outro (após a anulação do primeiro).
FaturaCT-e do tipo Fatura — modelo específico usado pelo transportador para agrupar vários conhecimentos em uma fatura única.

O valor vem do XML emitido pela transportadora; o idworks não altera.

O que significa a coluna Situação?​

A coluna Situação mostra o status fiscal do CT-e perante a SEFAZ:

SituaçãoSignificado
Uso autorizadoCT-e emitido e autorizado normalmente — pode ser usado para criar a conta a pagar.
CT-e CanceladaA transportadora cancelou o CT-e na SEFAZ. Não deve gerar conta a pagar.

A situação é informada pela SEFAZ e atualizada automaticamente quando a transportadora faz alguma mudança no documento.

O que é o Tomador do frete?​

O Tomador identifica quem está pagando o frete segundo o XML do CT-e — é informação fiscal obrigatória. A coluna mostra um destes cinco valores:

TomadorSignificado
RemetenteQuem está enviando a mercadoria paga (CIF — frete por conta do vendedor).
ExpedidorEmpresa de logística contratada paga o frete e repassa.
RecebedorOperador logístico do destino paga.
DestinatárioQuem recebe a mercadoria paga (FOB — frete por conta do comprador).
OutrosTerceiro paga (situações específicas de contratos de transporte).

Quando o seu pedido foi vendido com frete CIF, o Tomador é a sua empresa (Remetente) — e o CT-e gera conta a pagar à transportadora. Em vendas FOB, o cliente é o Tomador (Destinatário) — neste caso o CT-e aparece para conferência mas a cobrança não é da sua empresa.

Como chegam os CT-e a este feed?​

A integração com a SEFAZ é automática: o idworks consulta periodicamente os CT-e que citam o CNPJ da empresa (como tomador, remetente ou destinatário) e baixa o XML e a DANFE assim que disponíveis. Não é preciso lançar nada manualmente — basta ter o CNPJ ativo e o certificado digital configurado.

Quando o CT-e referencia uma NF-e de saída sua, o idworks faz o vínculo automaticamente — a coluna Pedido vem preenchida. Quando não há vínculo automático (CT-e que cita uma chave que não está no sistema), a coluna Pedido vem vazia — o CT-e ainda aparece, mas sem o "pulo" para o detalhe do pedido.

Como filtrar os CT-e?​

Clique em Filtros para abrir o painel lateral com os filtros disponíveis:

  • Conta — separa por conta (subdomínio) quando a empresa opera várias.
  • Empresa — empresa faturadora destinatária do CT-e.
  • Data CTE — intervalo de datas de emissão do CT-e.
  • Pedido — número do pedido vinculado (Orders.Order).
  • Nota fiscal — número da NF-e de produto vinculada (extraído da chave de acesso da NF citada no CT-e).
  • Transportadora CTE — nome/razão social como vem no XML (busca textual).
  • Transportadora idworks — seletor de transportadora cadastrada com integração ativa (TypeCarrier).
  • Situação — Uso autorizado ou CT-e Cancelada.
  • Tipo — Normal, Complementar, Anulação, Substituição ou Fatura.
  • Tipo tomador — Remetente, Expedidor, Recebedor, Destinatário ou Outros.

Os filtros são cumulativos. Clique em Aplicar para atualizar a lista.

Como visualizar a DANFE do CT-e?​

Clique no ícone PDF (Visualizar DANFe) na coluna de ações da linha. Uma janela abre exibindo a DANFE em PDF, gerada a partir do XML. Você pode imprimir ou salvar a partir do próprio visualizador do navegador.

Como baixar o XML de um CT-e?​

Clique no ícone CloudDownloadOutlined (Realizar Download do arquivo XML) na coluna de ações da linha. O sistema dispara o download direto do arquivo XML do CT-e.

Pré-requisito: privilégio Baixar XML CTe.

Como baixar XML de vários CT-e de uma vez?​

Selecione os CT-e na lista (caixa de seleção do lado esquerdo) e clique em Mais Ações → Baixar XML. O sistema agrupa os XMLs selecionados em um único arquivo compactado e envia o link para download — você pode copiar o link e clicar para baixar imediatamente.

Pré-requisito: privilégio Baixar XML CTe.

Como abrir o pedido vinculado ao CT-e?​

Quando a coluna Pedido está preenchida, há um pequeno ícone de olho ao lado do número. Clique nele para abrir o detalhe do pedido em uma nova aba — útil para conferir os itens, transportadora, valor de frete cobrado do cliente, etc.

Quando o CT-e não casou com nenhum pedido (chave de NF não localizada no sistema), a coluna Pedido vem vazia. Nesses casos, abra o CT-e (DANFE) para identificar manualmente.

O que é o Peso diferença?​

O Peso diferença é a conta Peso CTE - Peso pedido, em quilos:

  • Positivo — a transportadora cobrou mais peso do que os itens do pedido somam. Isso pode indicar cobrança por cubagem (volume considerado mais alto que o peso real) ou divergência que merece contestação.
  • Zero — peso cobrado bate com o peso do pedido.
  • Negativo — a transportadora cobrou menos peso do que o pedido tem (raríssimo, mas possível em ajustes).

A coluna Peso pedido é calculada como a soma de SkuWeight * Quantidade dos itens do pedido. A coluna Peso CTE é o WeightCharged informado pela transportadora no XML.

O que é o R$ net frete?​

O R$ net frete é o resultado financeiro do frete para a sua empresa:

R$ net frete = R$ frete pedido (cobrado do cliente) - R$ frete total (pago à transportadora)

A coluna usa cores condicionais para sinalização rápida:

  • Verde — R$ net frete > 0 (você cobrou mais frete do cliente do que pagou à transportadora — sobra para a empresa).
  • Vermelho — R$ net frete < 0 (você cobrou menos do que pagou — prejuízo no frete).
  • Cinza — R$ net frete = 0 (empatou) ou não foi possível calcular.

Útil para identificar pedidos onde a tabela cobrada do cliente está defasada da tabela real da transportadora.

O que são o R$ frete simulado e o R$ frete diferença?​

Quando a empresa usa a tela Simulação Frete para cotar transportadoras antes do envio, o idworks guarda a cotação feita no momento do pedido. As colunas:

  • R$ frete simulado — valor que o sistema simulou para a transportadora escolhida no momento do envio.
  • R$ frete diferença — R$ frete simulado - R$ frete total cobrado pela transportadora. Indica se o CT-e veio dentro do que foi simulado ou se houve estouro de valor.

Servem para auditoria do leilão de frete — se a diferença está grande, talvez a tabela da transportadora tenha mudado ou as regras de simulação precisem ser revisadas.

Por que algumas colunas de simulação vêm vazias?​

As colunas R$ frete simulado, R$ frete diferença e Valor tabela dependem da empresa ter leilão de frete ativo para a transportadora (cadastro de transportadora em Fornecedores com Leilão de frete = Sim) e do pedido ter passado pela Simulação Frete no momento da venda.

Quando o pedido foi enviado por uma transportadora sem leilão de frete ou quando a simulação não foi rodada, essas colunas ficam vazias — o CT-e ainda aparece normalmente, mas sem comparação com cotação prévia.

Como criar Contas a Pagar a partir de um CT-e?​

Clique no ícone FileAddOutlined (Criar Contas a Pagar) na linha. A janela abre pré-preenchida com os dados do CT-e:

  • Conta e Empresa vêm do CT-e.
  • Transportadora (fornecedor) é localizada automaticamente pelo CNPJ da emissora do CT-e — exige que ela esteja cadastrada em Fornecedores com tipo Transportadora.
  • R$ valor vem do R$ frete total do CT-e.
  • Nº documento vem do número do CT-e.
  • Data documento e Data competência vêm da data do CT-e.

Você precisa preencher manualmente:

  • Data vencimento — a data em que o título vence (obrigatório).
  • Tipo documento — Boleto, Duplicata, Nota Fiscal, etc. (obrigatório).
  • Plano de contas — onde a despesa será categorizada (obrigatório).

Clique em Salvar. O sistema cria a conta a pagar normalmente — você pode acompanhar em Financeiro → Contas a Pagar. A coluna Cód. CTE continua mostrando o CT-e original, e a partir desse momento o ícone Criar Contas a Pagar da linha fica desabilitado (para evitar duplicidade).

Quais cadastros preciso ter antes para criar a conta a pagar do CT-e?​

A criação da conta a pagar a partir do CT-e depende de outros cadastros do idworks:

  • Transportadora cadastrada como Fornecedor — em Fornecedores com Tipo = Transportadora e Situação = Ativa, com o CNPJ exatamente igual ao da emissora do CT-e. Sem esse cadastro, o sistema mostra "Não foi localizado transportadora no sistema." e fecha o modal.
  • Tipo de Documento — em Financeiro → Tipo Documento (Boleto, CT-e, Duplicata, etc.).
  • Plano de Contas apropriado para frete — em Financeiro → Plano de Contas (geralmente um plano "Frete" ou "Despesa com transporte").
  • Empresa faturadora — empresa do grupo que receberá a despesa (já vem do próprio CT-e, mas precisa estar ativa).

Por que o ícone Criar Contas a Pagar está desabilitado em uma linha?​

O ícone fica desabilitado quando a linha já tem uma conta a pagar vinculada. O sistema identifica o vínculo automaticamente cruzando o CNPJ da transportadora com o número do CT-e — se já existe uma conta a pagar lançada com essa combinação, o ícone trava para evitar duplicidade.

Se você precisa lançar uma segunda conta para o mesmo CT-e (situação atípica), faça-o direto em Financeiro → Contas a Pagar preenchendo manualmente.

Por que aparece "Não foi localizado transportadora no sistema" ao abrir o modal de criar conta a pagar?​

A mensagem aparece quando o idworks não encontra um fornecedor ativo cadastrado como Transportadora com o CNPJ que está no CT-e. O modal fecha automaticamente em seguida.

Como resolver: vá em Fornecedores, clique em Novo Fornecedor, preencha:

  • CNPJ — o mesmo que aparece no CT-e (coluna Doc.transportadora).
  • Razão Social — geralmente como vem na coluna Transportadora do CT-e.
  • Tipo — Transportadora.
  • Situação — Ativa.

Salve e volte à tela CTe — agora o modal abrirá corretamente.

Posso editar ou cancelar um CT-e por aqui?​

Não. O CT-e é um documento fiscal da transportadora — não é da sua empresa. Edição ou cancelamento só podem ser feitos pela própria transportadora (que pode emitir um CT-e de Anulação seguido de Substituição quando precisar corrigir). Quando isso acontece, o idworks reflete a mudança automaticamente nesta tela na próxima consulta à SEFAZ.

Esta tela permite apenas: visualizar, filtrar, baixar XML/DANFE individualmente ou em lote, e criar a conta a pagar correspondente.

Privilégios da tela​

Esta tela tem privilégios próprios que controlam o que cada usuário pode fazer. Configure os perfis de acesso em Configurações → Perfis de Acesso vinculando os privilégios abaixo aos grupos desejados. Quando o usuário não tem o privilégio, a ação correspondente fica desabilitada na tela.

PrivilégioLibera
Visualizar CTeAcesso à tela e à lista de CT-e do feed.
Baixar XML CTeÍcone Baixar XML na linha + opção Baixar XML em Mais Ações (download em lote). Sem este privilégio, apenas a DANFE em PDF está acessível.