Manuais:UniDANFE/Utilizando o UniDANFE
Utilizando o UniDANFE
O UniDANFE é apresentado em forma de um arquivo executável (UniDANFE.exe) que pode ser executado diretamente pelo sistema ERP do usuário passando alguns parâmetros através da linha de comando (mais eficiente), ou manualmente pelo ícone do aplicativo.
Em cada uma das formas o comportamento do sistema é diferente dependendo dos parâmetros recebidos - ou da ausência deles.
Eis algumas das nomenclaturas da linha de comando:
- Sem parâmetros, ou acessado manualmente pelo ícone do aplivativo:
- UniDANFE.exe
- Com passagem de parâmetros, acessado pelo sistema ERP do usuário:
- UniDANFE.exe configurar=1
- UniDANFE.exe licenciar=1
- UniDANFE.exe versao=1
- UniDANFE.exe emails=1
- UniDANFE.exe enviaemail=1
- UniDANFE.exe upload=1
- UniDANFE.exe Arquivo=<caminho e nome do XML principal> [lista de parâmetros ..]
a) Carregando o UniDANFE sem passar parâmetros
Ao carregar o UniDANFE sem passar parâmetros na linha de comando, o painel de controle é exibido.
Através do painel de controle pode-se acessar todas as funções do UniDANFE, como sua documentação, configuração, gerenciador de licenças Plus, gerenciador dos e-mails gerados pelo UniDANFE e gerenciador dos uploads gerados pelo UniDANFE e que aguardam para serem enviados ao servidor FTP. Além disso, pode-se também gerar o DANFE, a CC-e ou o DACTE a partir da seleção de um arquivo XML, clicando no botão “Emitir”, conforme mostra a figura abaixo.
Tela do Painel de Controle do UniDANFE
b) Acessando a interface de configurações do UniDANFE
Ao carregar o UniDANFE com o parâmetro “configurar=1” a interface administrativa de configuração é apresentada.
Ex: UniDANFE.exe configurar=1
Acrescentando o parâmetro “import=<nome do xml de configuração>”, uma configuração do UniDANFE, previamente exportada, será importada automaticamente. Nesse caso, a interface administrativa não será mostrada. Caso a configuração recebida por parâmetro já exista na base de dados, a base de dados será sobreposta por ela.
Ex: UniDANFE.exe configurar=1 import=”c:\uninfe\unidanfe\tmp\unidanfe_minha_config1.xml”
c) Acessando o Gerenciador de Licenças do UniDANFE
Ao carregar o UniDANFE com o parâmetro “licenciar=1” o gerenciador de licenças do UniDANFE Plus é apresentado.
d) Consultando a versão/release do UniDANFE
Ao carregar o UniDANFE com o parâmetro “versao=1” o UniDANFE cria um arquivo com o nome “versao.xml” na mesma pasta onde estiver instalado, contendo a versão, release e compilação atual do UniDANFE.
e) Consultando e-mails a enviar, enviados ou com erros Ao acessar a interface administrativa de e-mails, é possível ver os e-mails nas pastas “A Enviar”, “Enviados” e “Com Erro”. e.1) A Enviar
Ao gerar um e-mail para ser enviado ao destinatário, o UniDANFE o coloca na pasta “A enviar”. Concluída a operação do DANFE/CC-e/DACTE (impressão, geração do e-mail, cópia do PDF ou XML para uma pasta local ou da rede, etc), o UniDANFE é fechado de modo a liberar o sistema ERP que porventura estivesse preso por tê-lo chamado. No mesmo momento, uma outra instância do UniDANFE é iniciada para disparar todos os e-mails da pasta “A Enviar”. Em caso de erro durante a tentativa de envio, a mensagem gerada é gravada junto ao e-mail, e pode ser consultada pressionando-se o botão “Erros”. O UniDANFE faz até 50 tentativas de envio dos e-mails. Após isso, ele move automaticamente a mensagem para a pasta “Com Erro”.
- O botão “Anexos” permite ver os anexos da mensagem selecionada; - O botão “Editar” permite editar a mensagem selecionada. Esse botão funciona apenas para mensagens nas pastas “A enviar” e “Com erro”. - O botão “Excluir” permite excluir a mensagem selecionada. - O botão “Erros” permite consultar os erros gerados nas tentativas de envio da mensagem selecionada; - O botão “Enviar” dispara o processo de envio das mensagens da pasta “A enviar”. - O botão “Remetentes” acessa a tela de configuração de contas de remetentes de e-mails. e.2) Enviados
Após o envio com sucesso da mensagem de e-mail, a mesma é movida para a pasta “Enviados”, onde pode ser consultada posteriormente. As mensagens desta pasta ficam cronologicamente separadas pelo mês e ano da emissão do documento para facilitar sua consulta e localização. - Os botões “Anexos”, “Editar”, “Excluir”, “Erros” e “Remetentes” possuem as mesmas funções descritas no item e.1; - O botão “Reenviar” permite reenviar a mensagem selecionada. Ao ser pressionado, a mensagem é movida para a pasta “A enviar”, de onde pode ser enviada pressionando-se o botão “Enviar” daquela pasta.
e.3) Com Erro
Após 50 tentativas de envio sem sucesso, a mensagem de e-mail é movida para a pasta “Com Erro”. Uma vez nessa pasta, o administrador do sistema pode ainda consultar os erros ocasionados durante as tentativas de envio e solucioná-los. Para mover as mensagens dessa pasta para a pasta “A enviar” para nova tentativa de envio, basta pressionar o botão “Reenviar”. f) Forçando o envio dos e-mails presos na caixa “a enviar”
Para forçar o UniDANFE a enviar os e-mails presos na pasta “A Enviar”, basta pressionar o botão “Enviar”. Se uma instância do UniDANFE já estiver enviando e-mails, outra não será aberta, para evitar consumo de recursos da máquina.
Também é possível executar esse procedimento via parâmetros da linha de comando, conforme segue:
Ex: UniDANFE.exe envia_email=1 g) Gerando um relatório dos e-mails da pasta “Enviados” O UniDANFE pode gerar um arquivo XML com as informações básicas dos e-mails contidos na pasta “Enviados”, para fins de relatório e conferências em geral. Também é possível imprimir o relatório através do UniDANFE. Ex: UniDANFE.exe rel_email=1 A tela abaixo é exibida, solicitando o período da data de emissão dos documentos que se deseja listar, além da pasta de onde devem ser lidos os e-mails, bem como se o relatório deve ser impresso ou não.
Para informar diretamente o período através da linha de comando, utilize o exemplo abaixo. Se o período for passado por parâmetro, a tela de seleção não será exibida ao operador. Nesse caso, se não informados, os outros parâmetros serão assumidos por padrão, sendo Pasta=“Enviados” e Imprimir=“Não”: UniDANFE.exe rel_email=1 datai=“01/09/2010” dataf=“16/09/2010” ou UniDANFE.exe rel_email=1 datai=“2010-09-01” dataf=“2010-09-16” Além do período, é possível passar os outros campos por parâmetro. Exemplo: UniDANFE.exe rel_email=1 datai=“01/09/2010” dataf=“16/09/2010” imprimir=1 pasta=“Enviados” Ao utilizar esse recurso, será criado um arquivo do tipo XML na pasta do UniDANFE com as informações dos e-mails, de acordo com o período informado, com a seguinte nomenclatura: Rel_email_nnnnnnn.xml, onde nnnnnn = “enviados”, “enviar” ou “erros”, conforme o caso. Se o parâmetro “imprimir” contiver o valor “1”, ao invés de gerar o arquivo XML com as informações dos e-mails, será gerado um relatório com as respectivas informações e enviado para a impressora padrão. h) Carregando a tela de configuração de contas de e-mail (remetentes) É possível executar o UniDANFE para acessar diretamente a tela de cadastro de remetentes de e-mail. Para isso, basta passar o parâmetro configurar_remetente=1 ao UniDANFE, na linha de comando. Ex: UniDANFE.exe configurar_remetente=1 i) Consultando uploads pendentes
Através dessa tela é possível consultar os arquivos que aguardam para serem enviados ao servidor FTP. AO clicar em cada registro da grid as informações do arquivo são exibidas logo abaixo, bem como a última mensagem de erro gerada durante a última tentativa de envio. Essas informações serão úteis para a configuração do sistema.
j) Gerando um arquivo XML com a lista das licenças instaladas Para gerenciamento das licenças via software externo (ERP), é possível solicitar ao UniDANFE gerar um arquivo XML (licencas.xml) com as principais informações das licenças Plus instaladas. Exemplo: UniDANFE.exe listar_licencas=1 k) Atualizando o sistema automaticamente O UniDANFE possui o recurso de Autoupdate quando funciona integrado ao DANFE Mon. Para isso, basta instalar o UniDANFE e o DANFE Mon na mesma pasta e configurar a periodicidade com que deseja que o sistema procure por atualização na internet. Para quem não instalou o DANFE Mon, há a possibilidade de solicitar ao UniDANFE que procure pelas atualizações sempre que desejar. Para isso basta acessar a opção “Atualizar” do painel de controle ou passando o parâmetro seguinte na linha de comando: Exemplo: UniDANFE.exe autoupdate=1 display=0 pc=“c:\pasta da configuração do UniDANFE” Onde: Autoupdate=1 é o comando que indica ao UniDANFE que este deve procurar pela atualização; Display (0/1) – indica ao UniDANFE se deve mostrar a tela com o status da atualização (abaixo); PC = pasta onde se localiza a configuração do UniDANFE (opcional).
l) Buferizando as impressões do UniDANFE.
O UniDANFE pode trabalhar de modo a buferizar todas as impressões de documentos em papel A4, para imprimi-las apenas quando o usuário desejar. Pode-se, por exemplo, trabalhar um período inteiro emitindo os documentos, gerando e-mails, etc, e efetuar as impressões dos DANFEs apenas no final da tarde. Para isso basta executar o UniDANFE passando o parâmetro “buffer=n”, podendo “n” ser: Buffer=1 - Inicia a buferização. A partir dele, nenhum documento gerado em A4 é impresso mais. Suas “imagens” são armazenadas na pasta "buffer" para posterior impressão. Buffer=2 - Finaliza a buferização, enviando todos os documentos em buffer para a impressora. i=<impressora> = quando buffer=2, o usuário pode enviar o parâmetro para definir em qual impressora deseja que os documentos sejam impressos. Se for omitido, serão impressos nas impressoras definidas no momento da geração dos documentos. Buffer=3 - finaliza a buferização, sem imprimir. Todos os documentos em buffer são apagados. Buffer=4 - pausa a buferização. A partir desse comando o sistema não buferiza mais os documentos até receber outro buffer=1. Os documentos buferizados não são apagados e ficam aguardando outro buffer=1 para reiniciar, ou buffer=2 ou 3 para finalizar a buferização.
