Agente Dynamicca - Download de DF-e Recebidos

Download de DF-e Recebidos através do Agente Dynamicca

Conceito

A função de Download de DF-e Recebidos do Agente Dynamicca permite a gravação de protocolos XML de documentos emitidos contra o CNPJ da empresa 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).

• Parametrizar os nomes dos arquivos, configurando em Prefixo NF-e como o arquivo será iniciado, o ideal é colocar neste campo o tipo do documento (Ex: NFe, CTe, etc).

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:

• Ter cadastrado no Gestão DF-e o Agente para download (veja como cadastrar e gerar o identificador para a configuração no Agente Dynamicca no artigo Configurando a Identificação do Agente Dynamicca);
• Credenciais de acesso à internet (especificamente ao endereço do Gestão DFe através dos protocolos HTTP/HTTPS respectivamente nas portas 80/443);
• Acesso às pastas destino (inclusive de criação de subpastas) dos documentos fiscais eletrônicos. Se alguma pasta destino for uma unidade de rede, deve-se considerar as credenciais usadas no serviço, visto que o serviço não utilizará os mapeamentos de rede de um usuário diferente. Nessa situação, prefira usar o caminho no formato UNC (Convenção de Nomenclatura Universal em inglês), que normalmente é iniciado com \\;

Caso tenha Proxy, este deve ser configurado em Proxy conforme imagem abaixo:

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 [DF-e Recebido] 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 (Destinatário): 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:

• 1 CNPJ: 11440691000160

• Raiz CNPJ: 11440691%

• Todos: %

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 Janeiro de 2020.

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.

Prefixo NF-e e Prefixo CT-e: Indica se um prefixo deve ser utilizado no nome do arquivo gravado. Por padrão o nome do documento é a chave do mesmo.

Exemplo: NFe35150511440691000160550010000012901310052890-procNFe.xml

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

Cancelamento: Selecionando essa opção, o Agente fará o download do cancelamento dos documentos.

Gerar PDF: Permite que o DynamiccaAgent realize a geração das DANFE’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: NFe35150511440691000160550010000012901310052890.pdf

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).