Manual Megasul
Instalação NF-e
Copyright © 2002 MEGASUL Informática Ltda.
Todos os direitos reservados
Este Manual não pode ser copiado, transcrito, reproduzido, transferido para nenhuma
linguagem humana ou de computador, armazenado em sistema de recuperação ou reduzido, por
meios eletrônicos, mecânicos ou tipográficos, ou de qualquer outro meio, nem transmitido ao
público de nenhuma maneira, sem expressa autorização da Megasul Informática Ltda.
Os Programas e Sistemas (Software) MEGASUL ® , dos quais este manual é parte
integrante, são protegidos pela legislação de direitos autorais e pela Lei nº 7646 de 18 de
dezembro de 1987.
A Megasul Informática Ltda. se reserva ao direito de revisar esta publicação e efetuar
alterações em seu conteúdo.
MEGASUL INFORMÁTICA LTDA. Rua Itaiópolis, 06 - Cx.Postal 1034 Fone/Fax: 47 2111 6600 Blumenau – SC CEP 89012-084 [email protected] http://www.megasul.com.br
Atualizado até a versão 2.3.8.335
11/2011
SUMÁRIO
SUMÁRIO ....................................................................................................................... III
1 NOTA FISCAL ELETRÔNICA – NF-E ............................................................................. 5
1.1 PRÉ-REQUISITOS ............................................................................................................ 5
1.1.1 Procedimentos para o cliente realizar: ......................................................................................... 5
1.2 ROTEIRO DE IMPLANTAÇÃO .............................................................................................. 7
1.3 CONFIGURAÇÕES NO SISTEMA MEGASUL ........................................................................... 8
1.4 INFRA-ESTRUTURA DO HARDWARE .................................................................................. 10
2 PREPARAÇÃO DO SISTEMA OPERACIONAL ............................................................. 11
2.1 INSTALAÇÃO DO SERVIDOR WEB (IIS) ............................................................................. 11
2.2 INSTALAÇÃO DO DOTNET FRAMEWORK 2.0 – WINDOWS XP .............................................. 13
2.3 INSTALAÇÃO DO ASP.NET NO IIS ................................................................................... 14
3 GERENCIADOR DE BANCO DE DADOS ..................................................................... 14
3.1 ORACLE ..................................................................................................................... 14
3.2 FIREBIRD .................................................................................................................... 14
4 CRIAÇÃO DA ESTRUTURA DE DADOS ...................................................................... 15
4.1 ORACLE ..................................................................................................................... 15
4.2 FIREBIRD .................................................................................................................... 15
5 CERTIFICADO DIGITAL (SOMENTE CERTIFICADO A1 PARA NFE) ............................... 16
5.1 LIBERAÇÃO DE ACESSO AO SISTEMA LOCAL ........................................................................ 17
6 APLICATIVOS NFEPACK .......................................................................................... 25
6.1 INSTALAÇÃO MÓDULO NFEPACKSERVICE ........................................................................ 25
6.2 INSTALAÇÃO MÓDULO NFEPACKPRINTSERVICE ................................................................ 25
6.3 INSTALAÇÃO MÓDULO NFEPACKWEBMONITOR ................................................................ 26
7 CONFIGURAÇÕES DO SISTEMA ............................................................................... 27
7.1 CONFIGURAÇÃO FIREWALL DO WINDOWS ........................................................................ 27
7.2 CONFIGURAÇÃO DO NFEPACK SERVICE - ACESSO A DADOS ................................................. 29
7.3 CONFIGURAÇÃO DO NFEPACK WEB MONITOR – ACESSO A DADOS..................................... 32
7.4 CONFIGURAÇÃO DO NFEPACK – LICENÇA DE USO ............................................................. 32
7.5 AJUSTE DA EMPRESA .................................................................................................... 33
7.6 CONFIGURAÇÃO DO NFEPACK – CERTIFICADO DIGITAL / FILIAIS .......................................... 34
7.7 REINICIALIZAÇÃO DOS SERVIÇOS ..................................................................................... 37
7.8 ADEQUAÇÃO DO DANFE ................................................................................................ 40
8 PROBLEMAS/SOLUÇÕES ........................................................................................ 41
8.1 SOLICITAÇÃO DE SENHA AO INSTALAR O IIS ....................................................................... 42
8.2 ERRO NA INSTALAÇÃO DO SERVICE PACK 1 NO .NET FRAMEWORK 2.0 .................................. 42
8.3 ERROS NA INSTALAÇÃO DO NFEPACK ............................................................................... 44
8.4 ERROS AO INICIAR SERVIÇO NFEPACKSERVICE ................................................................... 46
8.5 ATRASAR CARREGAMENTO DOS SERVIÇOS DO WINDOWS ..................................................... 46
8.6 GRANTS DE ACESSO PARA CERTIFICADOS (WINDOWS DIFERENTE DE XP) ................................. 47
8.7 INSTALAÇÃO MÓDULO NFEPACKPRINTSERVICE (ESTAÇÃO REMOTA) ..................................... 49
GLOSSÁRIO ................................................................................................................... 54
5
1 NOTA FISCAL ELETRÔNICA – NF-E
A Nota Fiscal Eletrônica tem como objetivo a implantação de um modelo nacional de
documento fiscal eletrônico substituindo o atual modelo de emissão do documento fiscal em
papel.
Terá validade jurídica garantida pela assinatura digital do remetente, simplificando as
obrigações acessórias dos contribuintes e possibilitando o acompanhamento em tempo real das
operações comerciais por parte do Fisco.
Visa facilitar a vida do contribuinte e as atividades de fiscalização sobre ICMS e IPI.
1.1 PRÉ-REQUISITOS
1.1.1 PROCEDIMENTOS PARA O CLIENTE REALIZAR:
• Link internet 512 Kb disponível para a solução NFe (Pode ser ADSL)
• Impressora Laser Impressora com velocidade de impressão adequada à demanda
de emissão de DANFe (levar em conta os horários de pico para definição do melhor
modelo).
• Com Suporte post-script e Verificar número de bandejas para documentos
auxiliares (caso necessário)
• Sistema Operacional Windows XP Professional, Service Pack 2 (ou superior) ou
Windows 2003 server (ou superior). Para o Windows Seven, as versões não podem
ser o Home ou o Starter, podem ser o Business, Professional ou o Ultimate.
6
• Servidor Web Internet Information Services (IIS) 4.0 ou superior.
• A porta 80 do servidor WEB deve estar liberada para comunicação
• Certificado Digital Certificados digitais ICP-Brasil NF-E PJ A1
(http://loja.certificadodigital.com.br/Serasa/SaibaMais/386/A1)
• Credenciamento na SEFAZ de cada estado para emissão de NF-E
(http://www.nfe.fazenda.gov.br/ - Link do lado direito “Link para os portais
estaduais da NF-e”.)
• Servidor de Banco de Dados: Oracle 9/10g ou Express ou Firebird
• Adquirir licença de uso para a NF-e junto ao departamento Comercial da Megasul
Informática Ltda.
7
1.2 ROTEIRO DE IMPLANTAÇÃO
a) CÓPIA DO BANCO DE DADOS (procedimento padrão para qualquer alteração na
base do cliente);
b) Verificar a última versão homologada do sistema Megasul para NF-e;
c) CONFIGURAÇÃO DA CONTA DO USUÁRIO DO WINDOWS
Criação de uma conta administradora com senha;
d) Instalação da solução NFePack (a partir do tópico 2 até o tópico 8 deste
documento).
Instalação do IIS
Instalação do DOTNET FrameWork 2.0 – Windows XP
Instalação do ASP.Net no IIS
Instalação do Client Banco de Dados (verificar qual o banco de dados
utilizado, podendo ser Oracle ou Firebird 2.0 1)
Criar tabelas referente ao NFePack
Instalar certificados digitais. Antes de prosseguir, averiguar se há alguma
observação adicional para os certificados. Exemplo:
AF_FENACOM_CERTISIGN_RFB_G2.
NFePackservice
NFePackPrintservice
NFePackWebMonitor
Configuração do NFePack
1 A instalação do sistema em Firebird segue o seu padrão, ou seja, a versão do Server e do Client utilizados
para o sistema continuam sendo a versão distribuída no CD de instalação, ou seja, 1.5. A versão do Client 2.0 para
acesso aos dados NF-e, deve ser instalada em conjunto com a versão do sistema.
8
1.3 CONFIGURAÇÕES NO SISTEMA MEGASUL
a. Incluir no menu o Nota Fiscal Eletrônica (TFormNfeEletronica) destinado a efetuar a
manutenção das notas fiscais eletrônicas.
b. Criar série de nota com o tipo ‘L – Eletrônica’, Código Fiscal/modelo igual a 55 e
configurar o tipo da série em questão como padrão, se necessário. Ver módulo de
Configurações\Parâmetros\Parametrizações\Grupo Filial o parâmetro "Serie padrao").
Quando o cliente for optante pelo regime Simples, deverá ser preenchido o campo Obs.
Padrão com o código “Obs. Super Simples” que contém a fórmula descrita no tópico c
abaixo.
c. Alíquota super simples
Criado campo [Alíquota Super Simples] no Cadastro de Filial onde visa calcular o valor
sobre os produtos tributados.
Parâmetros Obrigatórios para a listagem/gravação nas observações da nota
(NF_OBSNAOFISCAL):
• Filial com tipo de Apuração = Simples;
• Cliente = Pessoa Juridica;
• Cliente não simples;
• No Cadastro de Filial, informar a alíquota (alíquota esta informada pelo cliente)
no campo Aliquota Super Simples;
• Itens tributados na nota;
• E cálculo ((Base Itens Tributados X Alíquota) / 100) for maior que 0 (zero);
9
Fórmula a ser cadastrada no cadastro de observações (Acesso pelo ALT+F12,
formulário "Observações") e setada no Cadastro de Série de Notas:"
IF(NOTA.FILIALSIMPLES = 'True',IF(SQLEXEC('SELECT EF_ALIQSUPERSIMPLES FROM
FILIAL WHERE EF_CODIGO = ' + STR(FILIAL.CODIGO)) > 0,IF(Nota.ClienteSimples =
'False', IF(SQLEXEC('SELECT EN_CODIGO FROM ENDERECO WHERE EN_JURIDICA = 'S'
AND EN_CODIGO = ' + STR(NOTA.VE_ENCODIGO)) > 0, IF((((SQLEXEC('SELECT
SUM(MO_VALOR + MO_RATACRESCIMO - MO_RATDESCONTO) FROM MOVIMENTO,
SITUACAOTRIBUTARIA WHERE MO_STCODIGO = ST_CODIGO AND ST_TIPO = 'T' AND
MO_EFCODIGO = ' + STR(FILIAL.CODIGO) + ' AND MO_SICODIGO = ' +
STR(SISTEMA.CODIGO) + ' AND MO_TRCODIGO = ' + STR(TRANSACAO.CODIGO))) *
(SQLEXEC('SELECT EF_ALIQSUPERSIMPLES FROM FILIAL WHERE EF_CODIGO = ' +
STR(FILIAL.CODIGO)))) / 100) > 0,'Permite o aproveitamento de R$: ' +
FORMATNUMERIC('#,##0.00',(((SQLEXEC('SELECT SUM(MO_VALOR +
MO_RATACRESCIMO - MO_RATDESCONTO) FROM MOVIMENTO,
SITUACAOTRIBUTARIA WHERE MO_STCODIGO = ST_CODIGO AND ST_TIPO = 'T' AND
MO_EFCODIGO = ' + STR(FILIAL.CODIGO) + ' AND MO_SICODIGO = ' +
STR(SISTEMA.CODIGO) + ' AND MO_TRCODIGO = ' + STR(TRANSACAO.CODIGO))) *
(SQLEXEC('SELECT EF_ALIQSUPERSIMPLES FROM FILIAL WHERE EF_CODIGO = ' +
STR(FILIAL.CODIGO))))) / 100) + ' referente a alíquota de : ' + STR(SQLEXEC('SELECT
EF_ALIQSUPERSIMPLES FROM FILIAL WHERE EF_CODIGO = ' + STR(FILIAL.CODIGO))) +
'% nos termos do art. 23 da LC 123',''),''),''),''),'')
d. Observação FUNRURAL
Fórmula a ser cadastrada no cadastro de observações (Acesso pelo ALT+F12,
formulário "Observações") e setada no Cadastro de Série de Notas:"
Ao identificar que o fornecedor da nota fiscal emitida se trata de "Fornecedor Rural"
através do campo [Fornecedor Rural] do Cadastro de Fornecedor e não é pessoa
10
jurídica, imprimirá a observação Funrural: 'Valor do INSS : R$ XXX' onde XXX é o valor
do INSS gravado na nota.
IF(SQLEXEC('SELECT FO_RURAL FROM FORNECEDOR, ENDERECO WHERE
FO_ENCODIGO = EN_CODIGO AND EN_JURIDICA <> 'S' AND FO_CODIGO = '
+STR(NOTA.CLFOCODIGO)) = 'S',(IF(SQLEXEC('SELECT NF_INSS FROM NOTAFISCAL
WHERE NF_EFCODIGO =' + STR(FILIAL.CODIGO) + ' AND NF_SICODIGO = ' +
STR(SISTEMA.CODIGO) + ' AND NF_TRCODIGO = ' + STR(TRANSACAO.CODIGO)) <>
0,'Valor do FUNRURAL : R$ ' + FORMATNUMERIC('#,##0.00',SQLEXEC('SELECT
ABS(NF_INSS) FROM NOTAFISCAL WHERE NF_EFCODIGO =' + STR(FILIAL.CODIGO) + '
AND NF_SICODIGO = ' + STR(SISTEMA.CODIGO) + ' AND NF_TRCODIGO = ' +
STR(TRANSACAO.CODIGO))),'')),'')
1.4 INFRA-ESTRUTURA DO HARDWARE
A infra-estrutura de hardware é composta por servidores de aplicação (tanto a nível de
SEFAZ, quanto a nível do cliente), servidor(es) de impressão e servidor de banco de dados. A Figura abaixo representa estes componentes:
11
2 PREPARAÇÃO DO SISTEMA OPERACIONAL
Este tópico trata dos procedimentos necessários para deixar o sistema operacional
Windows apto para executar os serviços e o portal do NFePACK. Cada versão do Windows possui características específicas para instalação do IIS (Internet Information Service).
Este guia detalha a configuração Windows XP. Caso seu sistema operacional seja diferente do Windows XP (Windows Vista, Windows 2003 Server ou Windows 2008 Server), consulte o suporte técnico da Megasul.
2.1 INSTALAÇÃO DO SERVIDOR WEB (IIS)
Antes de iniciar a instalação do IIS (Internet Information Service), verifique se o mesmo já
está instalado no servidor. Caso já esteja instalado, pule para o DotNet Framework 2.0 – Windows XP.
Para verificar se o IIS já está instalado, verifique no aplicativo “Gerenciamento do
12
computador” (clique com o botão direito no “Meu computador” e depois na opção “Gerenciar”) se há a opção “Internet Information Service” na categoria “Serviços e aplicativos” conforme ilustrado na figura abaixo.
Para instalar do ISS no Windows, siga os seguintes passos:
• Acionar a opção Adicionar/remover componentes do Windows Painel de controle -> Adicionar ou remover programas -> Adicionar/remover componentes do Windows
• Selecione a opção Internet Information Services (ISS) da lista apresentada conforme abaixo.
13
INSTALAÇÃO DO SERVIDOR WEB (IIS) (Caso o cliente não tenha o CD Instalação do
Windows, instalar o IIS usando este repositório [C:\Megasul\CD_NFE\1.CD_IIS_Windows_XP]
quando solicitar o cd de instalação do Windows.
Para conferir se o ISS foi instalado com sucesso, acesse pelo navegador web o endereço
http://localhost/. Deverá ser apresentada a página inicial do ISS, conforme apresentado na página
inicial do IIS.
2.2 INSTALAÇÃO DO DOTNET FRAMEWORK 2.0 – WINDOWS XP
O DotNet Framework 2.0 é o conjunto de programas que suporta o portal WEB do NFePACK. Para instalá-lo, localize e execute o arquivo de instalação do Dot Net Framework 2.0 e siga os passos padrão da instalação.
Obs.: Antes instalar o DotNet, executar o pacote de atualização do Windows
C:\Megasul\CD_NFE\2.DotNet\WindowsInstaller-KB893803-v2-x86.exe dotnetfx.exe (Microsoft Framework dotNet 2.0)
C:\Megasul\CD_NFE\2.DotNet\dotnetfx.exe NetFx20SP1_x86.exe (Service Pack do Microsoft Framework dotNet 2.0)
C:\Megasul\CD_NFE\2.DotNet\NetFx20SP1_x86.exe Caso o Framework já esteja instalado, ou tiver uma versão diferente da recomendada,
lembrar que o NFePack está homologado para a versão 2.0, dúvidas entrar em contato com o suporte técnico Megasul.
14
2.3 INSTALAÇÃO DO ASP.NET NO IIS
O procedimento padrão contempla a instalação do IIS apenas depois do .NET framework, sendo necessário instalar o ASP.NET manualmente, solicitando a instalação via prompt(cmd). Para isso devemos utilizar um utilitário que o Framework instala na máquina:
C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727\aspnet_regiis.exe -i Entre no diretório e execute a linha de comando: aspnet_regiis –i Observe que o parâmetro –i deve ser informado.
3 GERENCIADOR DE BANCO DE DADOS
Este tópico trata da instalação do gerenciador de banco de dados que suportará a
aplicação NFePACK. Deve-se preferencialmente utilizar um banco de dados já existente na infra-estrutura do
cliente. Neste caso, basta incluir os objetos de banco de dados do NFePACK na estrutura de banco de dados existente (o tópico Criação da Estrutura de Dados detalha esta situação).
Abaixo listamos os procedimentos para os bancos de dados Oracle e Firebird.
3.1 ORACLE
Para o acesso do NfePack ao banco de dados Oracle, o Client instalado deve ser o da versão
10G. Nos casos onde a versão do Client Oracle é 11, tem que ser copiado o arquivo
Oracle.DataAccess da pasta app do Oracle e colar na pasta bin do web monitor e onde está instalado os programas(NfePackService), juntamente com o arquivo “OraOps10.dll” do Client Oracle versão 10G.
3.2 FIREBIRD
Executar o arquivo de instalação “C:\Megasul\CD_NFE\2.DotNet\FirebirdClient-2.1.0.msi”,
15
que se encontra no pacote distribuído para a NF-e. Para rodar os SQLs necessários para a configuração do banco de dados e a inclusão das
tabelas NF-e e demais elementos, instalar o IBExpert. Para Instalar o Ibexpert: C:\Megasul\CD238\Ferramentas\Interbase\IBExpert.exe
4 CRIAÇÃO DA ESTRUTURA DE DADOS
Este tópico trata da criação da estrutura de dados que o NFePACK necessita para controlar o processo de emissão de NFes. De acordo com o banco de dados disponibilizado para a aplicação, deve ser disponibilizada a estrutura de dados.
Como cada banco de dados possui características específicas para a criação de objetos, a disponibilização da estrutura de dados do NFePACK deverá respeitá-las. Portanto, para cada banco de dados há um conjunto de scripts específico.
4.1 ORACLE
Executar o sql que se encontra no diretório abaixo (via SQL Plus): C:\Megasul\CD_NFE\3.Instalação\1.ScriptsNfePack\Oracle\
Executar o sql abaixo via Scripter.exe:
Modify AC NFe - Oracle.SQL. Este comando está disponibilizado a partir do http://download.megasul.com.br link Atualização Scripts NF-e Megasul (324)
4.2 FIREBIRD
Executar o sql que se encontra no diretório abaixo (via IBExpert.exe):
C:\Megasul\CD_NFE\3.Instalação\1.ScriptsNfePack\Firebird\
Executar o sql abaixo via Scripter.exe:
Modify AC NFe - Interbase.SQL. Este comando está disponibilizado a partir do http://download.megasul.com.br link Atualização Scripts NF-e Megasul (324)
16
5 CERTIFICADO DIGITAL (SOMENTE CERTIFICADO A1 PARA NFE)
Importante: Os certificados “A1 e_CNPJ” (conectividade social) e “A3” NÃO servem, tem que ser
obrigatoriamente o certificado “A1 exclusivo para NFE”.
Cada cliente deve adquirir um certificado digital (Obs.: Pode ser utilizado o mesmo Certificado
Digital para todas as filiais desde que o CNPJ seja de mesma Raiz), para realizar a comunicação entre o
NfePack e os web services da Secretaria da Fazenda (SEFAZ).
Para a instalação deste certificado, siga os passos abaixo:
Localize o arquivo do Certificado Digital A1 com extensão de arquivo .pfx.
• Acione o Assistente para importação de certificados com um duplo clique no
arquivo .pfx.
• Siga a instalação padrão do assistente e quando solicitada, informe a senha
disponibilizada com o certificado.
17
O parâmetro do módulo de Configurações/Parâmetros/Parametrizações/Grupo Filial
chamado Vencimento do Certificado Digital verifica a validade do certificado digital. Para mais
informações consulte o manual de Configurações.
5.1 LIBERAÇÃO DE ACESSO AO SISTEMA LOCAL
Para que o NFePack acesse corretamente as informações do certificado digital importado
no tópico anterior, o sistema deve ter também acesso local para o certificado, abaixo segue os
passos para a liberação do acesso.
1. Digite no programa “Executar” (Tecla Win + R) o comando mmc.
2. Será exibido o console do sistema operacional. No menu Arquivo, selecione a opção
“Adicionar/Remover Snap-in” (CTRL+M)
3. Selecione na tela a opção adicionar
18
4. Clique em “adicionar”. Será exibida a lista de “Snap-ins”. Selecione “certificados” e
em seguida selecione “adicionar” novamente.
Na próxima tela, selecione a opção “conta de computador” e, em seguida, clique no botão
Avançar.
Este procedimento é muito importante, pois ao selecionar outra opção o certificado não
será "visualizado" pelo NFePACK.
19
Na tela seguinte (Selecionar Computador não altere nada e clique no botão Concluir.
Na tela Adicionar snap-in autônomo clique no botão Fechar.
20
Na tela Adicionar/Remover snap-in clique no botão OK.
21
5. Se tudo foi feito corretamente, o resultado será semelhante a figura abaixo:
22
6. Na pasta Pessoal clique com o botão direito do mouse, após no item Todas as
tarefas e no item Importar.
7. Aparecerá a tela Assistente para importação de Certificados clique no botão
Avançar.
8. No botão Procurar selecione o certificado (*.pfx)e clique no botão Avançar.
9. Mantenha as opções padrão da próxima tela e clique em avançar.
23
Selecione a opção Concluir na próxima tela.
10. O resultado deverá ser semelhante ao do Certificado disponível na pasta pessoal
11. Repita o procedimento para o certificado da cadeia do Sefaz, disponível em
C:\Megasul\CD_NFE\4.Certificados e Cadeias, importar o arquivo
“AC_FENACON_CERTISIGN_RFB_G2.p7c” e o certificado da unidade federativa em
questão.
12. Após instalados todos os certificados, clique no menu Arquivo depois em Salvar.
Salve o arquivo com qualquer nome de sua preferência na pasta sugerida
24
OBS.; A imagem acima indica a importação do certificado do cliente APENAS. É necessário a
importação dos certificados estaduais existentes e certificados e cadeias.
ATENÇÃO:
• Ao adquirir um novo certificado digital, deverá apagar o antigo certificado, pois caso
não seja feito, poderá ocorrer de o sistema mesmo parametrizado corretamente,
efetuar a busca dos dados do antigo certificado e, portanto, não autorizar a nota.
Para isto, entre no MMC, clique em Arquivo-> Abrir e selecione o arquivo de
Console, salvo outrora conforme instrução 5.1.12. Na tela do console, na pasta
Pessoal, localize o certificado do cliente(Coluna Finalidades está como
“Autenticação de cliente, Email seguro”), clique nele com o lado direito do mouse e
selecione a opção Excluir.
• Ao incluir um novo certificado digital do cliente, deverá ingressar no
CertificateInspector e clicar em "Give ASP.NET read access", procedimento
detalhado no tópico 7.6.
25
6 APLICATIVOS NFEPACK
Este tópico trata da instalação e configuração dos aplicativos que compõem a solução
NFePACK: NFePackService, NfePackWebMonitor e NFePACKPrintService.
Os arquivos para esta instalação, encontram-se no diretório “3.Instalação”, junto ao
conjunto de diretórios de instalação do NFePACK.
6.1 INSTALAÇÃO MÓDULO NFEPACKSERVICE
Deve-se executar o arquivo de instalação “NFePackServiceSetup.msi” que está no diretório
“C:\Megasul\CD_NFE\3.Instalação\2.NfePackService\”.
Mantenha as opções padrão da instalação. Ao finalizar o instalador o módulo estará
disponível.
6.2 INSTALAÇÃO MÓDULO NFEPACKPRINTSERVICE
O módulo NFePACKPrintService gerencia a impressão do DANFe. Sua configuração é
essencial para que o volume de dados que trafegam na rede seja a mínima possível.
Para instalá-lo, execute o arquivo de instalação “NFePackPrintServiceSetup.msi” que está
no diretório “C:\Megasul\CD_NFE\3.Instalação\4.NfePackPrintService\”.
Siga as opções padrão. Ao concluir o NFePACKPrintService estará instalado.
Para configurar as opções de impressão, acesse no menu do Windows “Iniciar” ->
“programas” -> “Inventti” -> “NFePACKPrint”
Configuração de impressão (informar a impressora local ou caminho, caso esteja em rede).
26
No NFePACKPrint, acesse a opção “Serviço” -> “Configurações” e defina a impressora local
padrão e a impressora local para contingência.
6.3 INSTALAÇÃO MÓDULO NFEPACKWEBMONITOR
A instalação do NfePackWebMonitor deve ser executada pelo pacote de instalação:
arquivo “NfePackWebMonitor.msi”, que está no diretório
“C:\Megasul\CD_NFE\3.Instalação\5.NfePackWebMonitor\”.
Antes da instalação, deve-se verificar se o Internet Information Service (IIS) 4.0 ou superior
está instalado no computador com suporte ao ASP.NET. Será apresentada uma mensagem de erro
na instalação, caso estes requisitos de software não forem atendidos.
Execute a instalação com as opções padrão. Se a versão for 7 para o IIS, atente para a opção Application Pool:
27
Senão, siga as opções padrão:
Após instalação, entre no endereço http://localhost/nfepackmonitor para verificar o funcionamento do sistema (não é necessário entrar com login e senha, pois neste momento é somente validação da instalação do NfePackMonitor).
Eventualmente, pode ser necessário reiniciar os serviços do NFePack para o correto funcionamento do Monitor Web.
7 CONFIGURAÇÕES DO SISTEMA
7.1 CONFIGURAÇÃO FIREWALL DO WINDOWS
Eventualmente será necessário configurar o Firewall do Windows para permitir o acesso
remoto ao servidor web (IIS) de outros computadores. Normalmente o servidor web é configurado
na porta 80. Esta deverá ser liberada no Firewall.
28
Acesse no painel de controle do Windows a opção “Firewall do Windows” e em seguida
selecione a guia “Exceções”:
Escolha a opção “Adicionar Porta” e inclua as informações conforme a figura abaixo:
29
7.2 CONFIGURAÇÃO DO NFEPACK SERVICE - ACESSO A DADOS
Por padrão o NFePACK instala seus aplicativos no diretório “C:\Arquivos de
programas\Inventti”.
O procedimento que vamos detalhar, deverá ser executado para o aplicativo NfePackService.
Dentro da pasta do aplicativo há um arquivo com a nomenclatura
NfePackService.exe.config.
Edite o arquivo com o bloco de notas.
Evite utilizar outros editores de texto, pois alguns (como o caso do wordpad) gravam
caracteres especiais que comprometem o funcionamento do sistema.
No pacote disponibilizado para NF-e existem os arquivos de configuração já modificados
para uma instalação padrão com o banco de dados Firebird “C:\Megasul\Base”, caso seja
30
diferente favor verificar o caminho no BDE. Estes arquivos estão localizados em
“C:\Megasul\CD_NFE\6.Configuracao\”. Salve estes arquivos no seguinte repositório:
C:\Arquivos de programas\Inventti\NfePackService
Conforme o banco de dados, usuário e senha, deve-se definir a string de conexão neste
arquivo de configuração. No arquivo há uma TAG denominada “hibernate-configuration”,
conforme destacado abaixo:
<?xml version="1.0" encoding="utf-8" ?> <configuration> <configSections> <section name="hibernate-configuration" type="NHibernate.Cfg.ConfigurationSectionHandler, NHibernate" /> <section name="log4net" type="System.Configuration.IgnoreSectionHandler" /> </configSections>
<hibernate-configuration xmlns="urn:nhibernate-configuration-2.2"> <session-factory> <property name="connection.provider">NHibernate.Connection.DriverConnectionProvider</property> <property name="dialect">NHibernate.Dialect.Oracle9Dialect</property> <property name="connection.driver_class">NHibernate.Driver.OracleDataClientDriver</property> <property name="connection.connection_string">Data source=localhost/XE;User Id=nfepack;Password=nfepack;Min Pool Size=2; Connection
Lifetime=120; Connection Timeout=60; Incr Pool Size=1; Decr Pool Size=1;</property> <property name="connection.isolation">ReadCommitted</property> <property name="query.substitutions">true 1, false 0, yes 'Y', no 'N'</property> <property name="show_sql">false</property> <property name="max_fetch_depth">1</property>
<mapping assembly="NfePackDataAccess" /> </session-factory> </hibernate-configuration> <log4net>
A área destacada deverá ser substituída por um dos textos abaixo, conforme o banco de
dados utilizado. Atentar para alterar as informações em destaque para a configuração da base
instalada.
Oracle
O exemplo abaixo trata da configuração padrão (já demonstrada na área destacada do
exemplo acima)
<hibernate-configuration xmlns="urn:nhibernate-configuration-2.2">
<!-- http://michaelhanney.com/blog/category/nhibernate/ -->
<session-factory>
<property name="connection.provider">NHibernate.Connection.DriverConnectionProvider</property>
<property name="dialect">NHibernate.Dialect.Oracle9iDialect</property>
<property name="connection.driver_class">NHibernate.Driver.OracleDataClientDriver</property>
31
<property name="connection.connection_string">Data source=localhost/XE;User Id=automa;Password=automa;Min Pool
Size=2; Connection Lifetime=120; Connection Timeout=60; Incr Pool Size=1; Decr Pool Size=1;</property>
<property name="connection.isolation">ReadCommitted</property>
<property name="query.substitutions">true 1, false 0, yes 'Y', no 'N'</property>
<property name="show_sql">false</property>
<property name="max_fetch_depth">1</property>
<property name="proxyfactory.factory_class">NHibernate.ByteCode.Castle.ProxyFactoryFactory,
NHibernate.ByteCode.Castle</property>
<property name="hbm2ddl.keywords">none</property>
<mapping assembly="NfePackDataAccess"/>
</session-factory>
</hibernate-configuration>
Firebird
Atentar para que a instrução de runtime (abaixo) também seja disponibilizada no arquivo,
antes da sessão “hibernate-configuration”.
Atentar para que a versão correta do Firebird deve estar configurada neste ponto
<hibernate-configuration xmlns="urn:nhibernate-configuration-2.2">
<session-factory>
<property name="connection.provider">NHibernate.Connection.DriverConnectionProvider</property>
<property name="connection.driver_class">NHibernate.Driver.FirebirdClientDriver</property>
<property name="connection.isolation">ReadCommitted</property>
<property name="connection.connection_string">
Server=localhost;
Database=C:\Megasul\Base\Megasul.fdb;
User=SYSDBA;Password=masterkey;
SQLDialect=1
</property>
<property name="show_sql">false</property>
<property name="dialect">NHibernate.Dialect.FirebirdDialect</property>
<property name="use_outer_join">true</property>
<property name="command_timeout">444</property>
<property name="query.substitutions">true 1, false 0, yes 1, no 0</property>
<property name="proxyfactory.factory_class">NHibernate.ByteCode.Castle.ProxyFactoryFactory,
NHibernate.ByteCode.Castle</property>
<property name="hbm2ddl.keywords">none</property>
<mapping assembly="NfePackDataAccess" />
32
</session-factory>
</hibernate-configuration>
SQL Server (não recomendado versões inferiores a 2005)
<hibernate-configuration xmlns="urn:nhibernate-configuration-2.2" >
<session-factory>
<property name="connection.provider">NHibernate.Connection.DriverConnectionProvider</property>
<property name="dialect">NHibernate.Dialect.MsSql2005Dialect</property>
<property name="connection.driver_class">NHibernate.Driver.SqlClientDriver</property>
<property name="connection.connection_string">Server=localhost\megasul;Initial Catalog=Megasul;User
Id=sa;Password=abc123++</property>
<property name="proxyfactory.factory_class">NHibernate.ByteCode.Castle.ProxyFactoryFactory,
NHibernate.ByteCode.Castle</property>
<property name="hbm2ddl.keywords">none</property>
<mapping assembly="NfePackDataAccess"/>
</session-factory>
</hibernate-configuration>
7.3 CONFIGURAÇÃO DO NFEPACK WEB MONITOR – ACESSO A DADOS
Para este ajuste, deve-se acessar o arquivo “Web.config”, localizado na pasta
“C:\Inetpub\wwwroot\NFePackMonitor”.
Para ajustar o acesso a dados, utilize o mesmo padrão adotado para os serviços do sistema,
de acordo com o banco de dados em questão: ajustar a tag “hibernate-configuration”, conforme
banco de dados que está sendo utilizado.
Esta configuração, segue os mesmos padrões da configuração dos aplicativos NFePACK
Service, conforme item 7.2 deste manual.
7.4 CONFIGURAÇÃO DO NFEPACK – LICENÇA DE USO
33
Para o correto funcionamento do NFePACK, deve-se disponibilizar a licença de uso nos
diretórios do NFePACKService.
O arquivo com o nome “NFePACKLicence.dat”, que corresponde à licença de uso do
software e deverá ser disponibilizado nos diretórios “C:\Arquivos de
programas\Inventti\NFePackService”.
7.5 AJUSTE DA EMPRESA
Executar no banco de dados alteração do registro da tabela EMP substituindo conteúdo do
registro existente pelo CNPJ e Razão Social da empresa usuária:
SELECT * FROM EMP
Verificar e inserir os dados cadastrados na tabela FILIAL. Verificar se estes estão em
conformidade com o que está no certificado digital.
Linha de comando para inserção dos dados da filial:
insert into emp (num_cnpj_emp, nom_emp) select ef_cgccpf, ef_nome from filial;
34
7.6 CONFIGURAÇÃO DO NFEPACK – CERTIFICADO DIGITAL / FILIAIS
Uma vez instalado o certificado digital, deve-se pegar a chave de acesso, para que o NFePack
assine os arquivos XML e disponibilizar acesso para o certificado. Para tal instale no servidor o
aplicativo “Certificate Inspector”, que está disponível no diretório do pacote de instalação de
aplicativos (copie no servidor e execute o arquivo “C:\Megasul\CD_NFE\5.Configuração
Certificado Digital\EMICCertUtil.exe”).
Abaixo temos a tela do utilitário. Deve-se localizar os certificados da empresa “Digite a razão
social da empresa no campo RegEX search” e em seguida o botão “GO”. Após localizar o
certificado, selecione a linha “local machine” e em seguida pressione o botão “Give ASP.NET read
Access”. Caso o windows seja diferente do XP, verificar tópico 8.6.
Copie o valor disponível no campo “Subject”. Este valor será utilizado posteriormente nas
configurações do NFePACK.
35
Acesse o NFePACKWebMonitor via internet Explorer (http://localhost/NfePackMonitor) e
informe o usuário “nfepackadm” senha “nfepackadm”
Após entrar no sistema, selecione a opção “configurações”:
36
Na pasta “configurações”, guia “Filiais” informe o CNPJ, Razão social da empresa e vá até os
campos de identificação de certificados (“Certificado ass. Digital” e “certificado HTTPS”).
Cole o valor copiado do aplicativo de identificação de certificados nestes 2 campos,
conforme a figura abaixo: Associação de certificado:
37
Após seguir instruções disponíveis nos arquivos em pdf exemplificando o preenchimento dos
campos de configuração do Web Monitor, disponíveis em
C:\CD_NFE\Configuracao\NFePACKWebMonitor.
7.7 REINICIALIZAÇÃO DOS SERVIÇOS
Os módulos do NFePACK operam como serviços no Windows. Para garantir que toda configuração
realizada seja interpretada pelos serviços envolvidos, deve-se parar e reiniciar os serviços,
atentando que todos devem ser iniciados com a conta de um usuário Administrador, para isto vá
no menu iniciar, Executar e digite “services.msc”. Localize os serviços NfePackService e
NfePackPrintService, clique com o lado direito do mouse e vá em Propriedades, conforme imagem
abaixo:
38
Na tela que abrir, vá na guia Logon, selecione a opção “Esta Conta” e informe a conta do
administrador que será utilizada, conforme imagem abaixo:
39
Para parar os serviços acesse no menu do Windows a opção Inventti de acordo com a figura
abaixo e, em seguida, selecione “InterromperServiços”.
Após a parada dos serviços, selecione “IniciarServiços”.
40
7.8 ADEQUAÇÃO DO DANFE
Normalmente, o DANFe padrão já é disponibilizado no processo de implantação. Porém
devido a características específicas do cliente pode ser necessário definir alguma(s) características
específicas (principalmente relativo ao logotipo da empresa).
Caso seja necessária esta alteração, deve-se prever os procedimentos detalhados no guia
de configuração do DANFe (disponível juntamente com a documentação do sistema).
Geralmente o processo de customização do DANFe gera um arquivo “.XML” e outro “.PDF”
específicos. Deve-se salvar estes arquivos no diretório de templates de cada ponto de impressão
(onde estará instalado o NFePACKPrintService).
O próximo passo é informar o nome do template do DANFe nas configurações do NFePACK.
Para isso, acesse a opção configuração e defina o DANFe para cada filial (se for o caso de
várias filiais com DANFes diferentes, deverá existir um conjunto de arquivos “.pdf” e “.xml” para
cadafilial). No exemplo da abaixo para a configuração do template para DANFe, o template chama-
se “DanfePadrao”, logo, deverão existir os arquivos “DanfePadrao.xml” e “DanfePadrao.pdf” no
diretório de templates do NFePACKPrintService.
No pacote de instalação da NFe está o Danfe padrão da Megasul
C:\Megasul\CD_NFE\7.DanfePadraoMegasul\ copiar e colar na pasta C:\Program
Files\Inventti\NfePackPrintService\Templates\, lembrando que o nome do arquivo tem que estar
idêntico ao informado no NfePackMonitor na guia “Impressão” no campo “Template DANFE:”
conforme imagem abaixo:
41
Recomenda-se que o template utilize um nome diferente de DanfePadrao, pois em novas
instalações os arquivos DanfePadrao.xml e DanfePadrao.PDF são substituídos.
O logotipo do cliente deverá ser colocado no diretório “c:\arquivos de
programas\Inventti\NFePackPrintService\Templates” com o nome “Logo.jpg”.
Formato e tamanho para logotipo padrão para DANFe: jpg 83x83.
8 PROBLEMAS/SOLUÇÕES
Este capítulo lista os erros mais comuns identificados durante a implantação do
sistema, escrevendo as possíveis soluções para estes erros.
Inclui-se como responsabilidade da equipe de implantação, a constante atualização
deste capítulo do manual, incluindo novas experiências ocorridas durante o processo de
implantação.
42
8.1 SOLICITAÇÃO DE SENHA AO INSTALAR O IIS
Caso seja solicitada senha ao instalar o IIS, deve-se proceder com os passos abaixo:
• Permitir Acesso anônimo ao IIS e colocar no nome de usuário, o usuário que fez
login na máquina conforme abaixo.
• Permitir Autenticação do “Windows integrada”;
• Reiniciar o IIS com o comando no prompt do DOS: iisreset –restart;
8.2 ERRO NA INSTALAÇÃO DO SERVICE PACK 1 NO .NET FRAMEWORK 2.0
Ao tentar instalar o SP1 do .NET Framework 2.0 (arquivo NetFx20SP1_x86.exe), pode
ocorrer em raras situações o erro abaixo sobre a instalação Service Pack 1 - .NET Framework 2.0.
43
Para solucionar este problema, siga os procedimentos abaixo:
• Obter a atualização do Windows Installer no computador
(http://www.microsoft.com/downloads/details.aspx?displaylang=pt-br&FamilyID=889482fc-5f56-
4a38-b838-de776fd4138c)
• Executá-la e depois executar a atualização do .NET (NetFx20SP1_x86.exe), que já
consta na pasta de instalação do sistema.
Esta atualização encontra-se no pacote NF-e.
44
8.3 ERROS NA INSTALAÇÃO DO NFEPACK
Caso os requisitos de software não são satisfeitos, o sistema não irá executar a instalação
do NfePackService. Por exemplo, caso não está instalada a versão 2.0 do Dot Net Framework, o
sistema apresentará a mensagem ilustrada a seguir.
45
Na instalação do NfePackWebMonitor, será apresentada mensagem de erro, caso não for
detectado o Internet Information Service 4.0 ou superior no servidor (ilustrado a seguir).
Ainda durante a instalação NfePackWebMonitor, poderá ser apresentada a mensagem de
erro ilustrada a seguir, caso o IIS está instalado mas não está habilitado o suporte ao ASP.NET.
Veja a seção sobre a instalação do Internet Information Service.
46
8.4 ERROS AO INICIAR SERVIÇO NFEPACKSERVICE
O serviço é finalizado pelo gerenciador de serviços do Windows.
Após ocorrência deste erro, deve ser verificado o log NfePackService.log (geralmente
localizado na pasta C:\Arquivos de programas\Inventti\NfePackService\log.
8.5 ATRASAR CARREGAMENTO DOS SERVIÇOS DO WINDOWS
Em alguns computadores, especialmente sistemas mais antigos e com periféricos mais
lentos, talvez seja necessário atrasar o carregamento de um serviço específico do Windows para
que os serviços do NFePACK sejam inicializados corretamente, ou é possível que você
queira assegurar a inicialização de um serviço e sua disponibilidade para uso antes de outro, para
fins de solução de problemas. Isso pode afetar dispositivos como um controlador de domínio que
não consegue acessar a rede, em que a tentativa de carregamento de um protocolo ou serviço,
como DHCP, acontece ANTES da placa de rede ter uma chance de ser ligada (por exemplo,
Compaq Netflex).
As subchaves do Registro dos serviços estão localizadas no seguinte caminho e são capazes
de controlar a forma com que os serviços são carregados.
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\<Nome_do_serviço>.
Para criar uma nova dependência, selecione a subchave que representa o serviço a
ser atrasado, clique em Editar e em Modificar. Crie um novo valor com o nome
"DependOnService" (sem as aspas) com um tipo de dados REG_MULTI_SZ e clique em OK.
47
Quando a caixa de diálogo Dados do valor for exibida, digite o(s) nome(s) dos serviços a
serem iniciados antes do serviço com uma entrada para cada linha e clique em OK.
O nome do serviço a ser inserido na caixa de diálogo Dados é o seu nome exato,
como ele aparece na chave Services do Registro.
Quando iniciado, o computador usa essa entrada para verificar se o(s) serviço(s)
relacionado(s) no valor é(são) iniciado(s) antes da tentativa de inicialização do serviço
dependente.
8.6 GRANTS DE ACESSO PARA CERTIFICADOS (WINDOWS DIFERENTE DE XP)
Caso o Windows seja diferente do Windows XP, é necessário instalar o programa
(winhttpcertcfg.msi) que encontra-se no diretório de aplicativos (pasta 3.CertificadoDigital)
Depois de instalado o aplicativo, siga os seguintes passos:
1. Identifique o usuário gerenciador do IIS;
a. No Windows Vista, opção executar, informe o comando control
userpasswords2, conforme a Controle avançado de contas de usuário
48
b. Selecione a pasta “avançado” e em seguida o botão “avançado” conforme a figura abaixo:
c. Localize o nome do usuário ou grupo do IIS (Descrição ”Grupo interno usado pelos Serviços de Informações da Internet). No exemplo da figura abaixo, Identificação do usuário do IIS, o grupo a ser identificado é IIS_IUSRS:
49
2. Vá no prompt de comando e localize o executável da aplicação que foi instalada
(geralmente fica em “C:\Arquivos de programas\Windows Resource Kits\Tools”).
Execute o winhttpcertcfg com os seguintes parâmetros:
winhttpcertcfg -g -c LOCAL_MACHINE\My -s CERTIFICADO -a USUÁRIO
Onde,
• CERTIFICADO = Nome do certificado do cliente, não precisa ser o nome completo,
por exemplo, pode ser somente “XPTO” no caso do certificado da empresa XPTO,
• USUÁRIO = Usuário gerenciador do IIS.
8.7 INSTALAÇÃO MÓDULO NFEPACKPRINTSERVICE (ESTAÇÃO REMOTA)
Em situações em que utiliza-se impressão remota em um outro servidor (que não o da
instalação do NFePACKPrintService), deve-se ajustar as informações de logon.
As figuras abaixo representam as situações possíveis para configuração de impressão:
50
51
No caso de tratamento de impressão especial (figura abaixo: Impressão remota sem
módulos do NFePACK no servidor de impressão / impressora de rede), entre no Gerenciador de
Serviços do Windows (Iniciar -> Executar: services.msc).
• Localize o serviço NfePackPrintService, clique com o botão direito e depois em
propriedades;
• Na guia Logon, altere a opção “Fazer logon como” para “Esta conta”. Deve ser
configurada uma conta de usuário que tenha acesso aos recursos do computador (neste caso,
impressoras). Para localizar o usuário utilize a opção Procurar... (informe os campos Esta conta,
Senha e Confirmar senha).
52
Importante: sempre que houver mudança de senha do usuário informado, a senha deverá
ser atualizada no serviço também.
53
Caso necessário, pode-se definir uma conta no Windows exclusiva para esta operação.
54
GLOSSÁRIO
Alias Nome interno do sistema que indica a localização do banco de dados.
Banco de
dados ou Base
de Dados
Local onde são guardadas todas as informações inerentes ao sistema.
BDE
Administrator
Programa da BORLAND® que indica a localização física e demais
configurações do banco de dados, bem como seu tipo.
Combo box Campo encontrado em várias funções do sistema que possibilita a
seleção de itens dentro dele mesmo, através da seta que se encontra a
sua direita.
Driver Nome dado a um programa auxiliar que executa determinadas funções.
No caso deste manual, driver, refere-se as bibliotecas (dll) construídas
para auxiliar a execução de tarefas, tais como controlar ECF’s e demais
plugins. Pode também ter referência ao HD (Driver C:), CD ROM ou
disquete.
ECF Emissor de cupom fiscal.
Estação Numeração interna do sistema que indica o número do computador
conectado.
Finalizadora Forma de pagamento de uma compra ou venda. Ex. Dinheiro, cheque,
cartão.
Grid Tela apresentada com dados ordenados, grade de apresentação.
Hyperlink No sistema existirão campos onde, clicando-se em seu nome, aparecerá
uma função específica.
ODBC 32 bits Programa da MICROSOFT® que indica a localização física e demais
configurações do banco de dados, bem como seu tipo.
Parâmetros Configurações do sistema.
Sintegra Consiste num conjunto de procedimentos administrativos e de sistemas
computacionais de apoio que está sendo adotado simultaneamente
pelas Administrações Tributárias das diversas Unidades da Federação.
55
Saiba mais em http://www.sintegra.gov.br/.
Transação Número seqüencial interno que indica ao sistema todas as operações
realizadas, o número da estação e o funcionário que a realizou.