Agente Dynamicca - Download de CT-e Emitidos

Download de CT-e Emitidos através do Agente Dynamicca 

Conceito 

A função de Download de CT-e Emitidos do Agente Dynamicca permite a gravação de protocolos XML de CT-e armazenados no repositório do Gestão DF-e, limitado a um único download por documento. 

Nesta função, podemos: 

• Definir uma pasta raiz por CNPJ ou para vários CNPJ’s onde serão gravados os documentos. 

• Definir o período em que o ciclo de Download será realizado, com um tempo mínimo de 0,1 hora (6 minutos). 

Abaixo fluxograma exemplificando a comunicação: 

Pré-requisitos e Configuração 

 Os pré-requisitos para a correta execução desta função são os seguintes: 

As configurações são realizadas na aba de [DF-e Recebido] em [Download DF-e] do Agente Configurador, conforme demonstra a imagem abaixo: 

Procure pela aba [CT-e Emitido] e depois clique em [Editar] para alterar uma configuração existente: 

Obs.: Caso não seja apresentada uma linha com informações sobre a configuração, clique em [Novo], para adicionar uma nova configuração. Caso deseje excluir alguma configuração, selecione a linha que deseja eliminar e clique em [Excluir]. 
 

Ao clicar em [Editar], a seguinte tela será apresentada: 

CNPJ (Emitente): CNPJ que será utilizado no filtro para realizar o download dos documentos. É possível configurar CNPJ's de modo individual ou utilizar coringas (%) para indicar um conjunto de CNPJ's (iniciado por ou terminado por), facilitando a configuração por raiz ou até mesmo para todos os CNPJ’s do ambiente. 

Exemplos: 

URL: Endereço do WebService onde será baixado os documentos eletrônicos, conforme exemplo. O endereço sempre terminará por webservice1.asmx. 

Exemplo: http://hom.dynamicca.com.br/html/Webservice1.asmx 

Usuário: Usuário previamente cadastrado no Gestão DF-e utilizado para acessar o webservice. Esse usuário deve estar no grupo de administração do Gestão DF-e e possuir acesso as empresas desejadas. Para cadastro e configuração na ferramenta, consulte o artigo Cadastro de Usuário no Gestão DF-e. 

Senha: Senha do Usuário cadastrado. 

O botão [Teste] permite que o Agente realize um teste de comunicação com o webservice configurado. Esse teste não considera as credenciais de inicialização do serviço, utilizando os dados do usuário ativo. 

Caminho: Pasta principal onde os protocolos XML devem ser disponibilizados. 

 Obs.: Atenção as credenciais de inicialização do serviço. Recomenda-se a utilização do caminho no formato UNC, ex.: \\computador\pastax\subpastay. 

Separar por data: Faz com que o Agente Dynamicca grave os documentos XML em subpastas, usando a data em que os documentos foram efetivamente gravados, na formação do seu nome. Não há relação com a data de emissão ou de registro do documento: 

No exemplo acima, foram criadas subpastas para documentos armazenados entre os dias 1 e 5 de Outubro de 2021. 

O botão [Teste] permite que seja realizada uma avaliação da existência do caminho de gravação. Caso a mesma não exista, ela será criada nesse processo. 

Copiar Arquivo: Realiza uma cópia adicional dos documentos gravados em um [Caminho] alternativo configurado. O botão [Teste] permite avaliar a existência do caminho de gravação, criando-o caso não exista. 

Tipo DFE: Permite selecionar quais os tipos de documentos devem ser obtidos pelo Agente. 

Gerar PDF: Permite que o DynamiccaAgent realize a geração das DACTE's dos documentos gravados. Caso essa opção seja ativada, os documentos (tipo PDF), serão gerados na mesma pasta de destino dos protocolos XML. 

Exemplo: CTe35150511440691000160550010000012901310052890.pdf 

Baixar Inut.: Selecionando essa opção, o Agente fará o download de inutilizações dos documentos emitidos. 

Retornar os Eventos: Essa opção permite que o Agente retorne os protocolos de eventos dos documentos. Deve-se preencher com o código referente ao evento. 

Obs.: Caso preencha mais de um código, é necessário usar o delimitador virgula [,]. Exemplo: 110110,210200. 

 Período de Atualização (Horas): Determina a periodicidade em horas que o Agente deve avaliar a existência de novos protocolos para obtenção. O limite mínimo é de 0,1 hora (6 minutos). 

Data Processamento: Data/hora em que ocorreu a última avaliação de existência de documentos. Sempre que uma nova avaliação for realizada, esse campo será atualizado automaticamente pelo agente. 

No exemplo da imagem acima, usando um Período de Atualização de 1 hora, depois do primeiro processamento, o campo possuirá o valor abaixo: 

Nessa situação, uma nova avaliação será realizada na nova Data de Processamento. 

É importante considerar que, por razões de performance, essa função possui uma limitação de registros processados por ciclo. 

Gerar Log Detalhado: Possibilita a criação dentro da pasta de instalação do DynamiccaAgent (ex.: C:\Program Files (x86)\Dynamicca\DynamiccaAgent) uma subpasta com o nome “DownloadNFeLogs”, onde são armazenados registros dos processamentos. Arquivos do tipo texto (extensão .TXT), usando um padrão de nomenclatura baseado na data e hora de processamento, com um padrão DownLog_AnoMesDia_Hora.txt. A imagem abaixo demonstra o conteúdo processado em 11/04/2019 as 13h, listando os arquivos processados. 

Após realizar as configurações, acione o botão [Alterar] para armazenar suas modificações. 

Certifique-se que a opção [Ativar] está na cor verde no canto superior direito da tela Download DF-e, conforme imagem abaixo. 

Voltando tela principal do Agente Configurador, o ícone indicativo na opção [Download DF-e] ficará verde, conforme a imagem abaixo, informando que há função está ativa. 

Acione a opção [Aplicar Alterações] para armazenar as modificações realizadas no arquivo de configuração do Agente. 

Para que as alterações sejam consideradas pelo Agente, é necessário iniciar (ou reiniciar) o serviço (painel de gerenciamento de serviços do Windows).