English
Español
Recebimento de CT-e via download automático da SEFAZ
A funcionalidade realiza a integração automática de Conhecimentos de Transporte Eletrônico (CT-e) de entrada com o ERP, por meio do serviço de Distribuição DF-e.
O processo permite identificar, importar e processar os documentos fiscais de transporte de forma automatizada, garantindo segurança, rastreabilidade e disponibilidade das informações no ERP.
O que é o Web Service de Distribuição DF-e?
O web service de Distribuição DF-e é um serviço disponibilizado pelo Ambiente Nacional da SEFAZ que permite aos contribuintes, por meio de seus sistemas, consultar os documentos fiscais de transporte emitidos contra o CNPJ da empresa.
Os documentos disponibilizados por meio desse serviço correspondem às movimentações realizadas nos últimos 90 dias.
Para realizar o download do CT-e por meio do web service da SEFAZ, é necessário atender à seguinte premissa:
- O documento deve estar sincronizado entre a SEFAZ estadual, onde foi emitido, e o Ambiente Nacional.
Importante
Diferentemente da NF-e, o CT-e não exige a manifestação do destinatário para disponibilizar o XML completo para download.
Dessa forma, o contribuinte pode obter o documento completo diretamente pelo serviço, sem a necessidade de registrar previamente um evento junto à SEFAZ.
Tipos de documentos disponibilizados
Na consulta ao web service, a SEFAZ pode retornar diferentes tipos de documentos e informações relacionadas ao CT-e:
-
CT-e completo: XML integral do Conhecimento de Transporte Eletrônico, incluindo o protocolo de autorização de uso. Corresponde ao documento principal da operação de transporte.
-
CT-e OS (Outros Serviços): documento utilizado para prestações de serviço de transporte que não se enquadram nas situações atendidas pelo CT-e tradicional.
-
CT-e Simplificado: versão do CT-e destinada às operações que atendem aos critérios de simplificação estabelecidos pela SEFAZ.
-
Resumo do CT-e: conjunto de informações básicas para identificação do documento e reconhecimento da operação.
-
Evento de CT-e: registro vinculado ao CT-e, como cancelamento, Carta de Correção ou Prestação do Serviço em Desacordo.
O papel do e-Docs X
No contexto da Distribuição DF-e, o e-Docs atua como intermediário entre o ERP e a SEFAZ, realizando a captura automática dos XMLs de CT-e disponibilizados pela SEFAZ. Dessa forma, os documentos fiscais de transporte de entrada são obtidos e centralizados no e-Docs X, sem a necessidade de intervenção manual.
Os XMLs capturados, protocolos e retornos da SEFAZ são armazenados de forma estruturada, permitindo o acompanhamento do processamento e garantindo a rastreabilidade e a disponibilidade das informações para consultas posteriores.
Esse processo automatizado reduz a necessidade de operações manuais e proporciona maior controle sobre os documentos fiscais de transporte recebidos
Fluxo do processo
FAQ - Perguntas Frequentes
O que é necessário para que o recebimento automático de CT-e seja realizado corretamente?
-
Para que o processo funcione adequadamente, alguns requisitos devem ser atendidos:
-
A filial deve possuir um certificado digital válido.
-
O cadastro da filial deve estar preenchido corretamente, especialmente o estado (UF).
-
O parâmetro Ativar consulta no webservice de Distribuição de DF-e precisa estar ativo.
-
Quando a consulta de DF-e é realizada, qual a quantidade de registros disponibilizados?
- A consulta no web service retorna, no máximo, 50 registros por requisição.
Qual a periodicidade de execução do processo de recebimento de CT-e?
-
O processo é executado a cada 5 minutos, porém o comportamento pode variar conforme o resultado da consulta:
-
Se a lista possuir 50 registros, o sistema avança a numeração e realiza nova consulta imediatamente, até que não haja mais registros pendentes.
-
Se a lista possuir menos de 50 registros, o sistema entende que chegou ao fim dos documentos disponíveis e aguarda a próxima execução.
-
Em caso de indisponibilidade da SEFAZ ou de um aviso de que o contribuinte deve aguardar, a filial fica temporariamente suspensa para novas consultas. O sistema calcula automaticamente quando pode retomar e, passado o período, a consulta é restabelecida sem necessidade de intervenção manual.
-
É necessário registrar algum evento (manifestação) para obter o CT-e completo?
- Não. Diferente da NF-e, o CT-e não exige nenhum tipo de manifestação do destinatário para que o XML completo esteja disponível. O evento de Prestação do Serviço em Desacordo existe como mecanismo de contestação da operação, mas é opcional e não interfere no processo de download automático.
O sistema recupera documentos que eventualmente não foram obtidos?
- Sim. O e-Docs X possui um mecanismo de consulta retroativa que identifica automaticamente documentos que ficaram pendentes de obtenção. Quando isso ocorre, o sistema realiza consultas individuais para recuperá-los, respeitando o limite de 20 consultas por hora estabelecido pela SEFAZ.
Quais tipos de CT-e são importados automaticamente?
-
O sistema importa automaticamente:
-
CT-e completo;
-
CT-e OS (Outros Serviços);
-
CT-e Simplificado;
-
Resumo de CT-e;
-
Eventos vinculados ao CT-e (cancelamento, carta de correção, prestação em desacordo, etc.).
-
O que acontece se a SEFAZ estiver indisponível?
- Se a SEFAZ não estiver acessível no momento da consulta, o sistema registra a ocorrência e suspende temporariamente as tentativas para aquela filial. A consulta é retomada automaticamente assim que o período de espera se encerra, sem necessidade de ação do usuário.
English
Español
