MANUAL

SANNF-E
SANKHYA GESTO DE NEGCIOS

SANKHYA Business Partners

Copyright 2006 SANKHYA Tecnologia em Sistemas Ltda.
Todos os direitos reservados.
Proibida a reproduo parcial ou total por qualquer meio, seja este eletrnico, mecnico, de fotocpia, de gravao, ou outros, sem prvia autorizao, por
escrito da SANKHYA Gesto de Negcios.

Barras Laterais

INSTALAO DO SANNFE
ndice
Introduo................................................................................................................................................... 4
Possveis cenrios de instalao do SanNFe: ............................................................................................... 4
Empresas onde se emitem apenas NFe .........................................................................................................4
Empresas onde se emitem apenas NFSe .......................................................................................................4
Empresas onde se emitem tanto NFe quanto NFSe ........................................................................................4
Instalao do SanNFe - Linux ...................................................................................................................... 5
Como Inicializar o Servio no Linux ............................................................................................................... 11
Instalao SanNFe Windows .................................................................................................................. 12
Como Inicializar o Servio no Windows .......................................................................................................... 12
Importao do Certificado da Empresa ...................................................................................................... 16
Console NFe ............................................................................................................................................... 19
Aba Registro de Certificados...................................................................................................................... 19
Aba Status do Servio .............................................................................................................................. 27
Instalao para Nota Fiscal Eletrnica de Servios .................................................................................... 28
1. Instalao do aplicativo (Nota Fiscal Eletrnica de Servio) na pasta do Usurio ............................................ 28
2. Instalao do SankhyaW para utilizao do console NFSe ........................................................................... 29
2.1 O Cliente NO possui o SankhyaW em contrato ..................................................................................... 29
Configuraes ............................................................................................................................................ 29
Conexo com Internet ............................................................................................................................... 30
Configuraes de Proxy ............................................................................................................................... 31
Caractersticas do painel de testes ................................................................................................................ 33
Schemas no SanNFe .................................................................................................................................. 36
Envio de Eventos ........................................................................................................................................ 38

-3-

INTRODUO
O SanNFe a aplicao responsvel pela comunicao com os servios disponibilizados pela
Receita Estadual e Federal para emisso de Nota Fiscal Eletrnica (NFe) e da Nota
Fiscal de Servios Eletrnica (NFS-e).
Todo servio que consumido pela aplicao deve antes passar por uma validao, essa
validao executado pelo SanNFe antes da execuo do servio.
NFe
Entende-se por Nota Fiscal Eletrnica um documento de existncia exclusivamente
digital, emitido e armazenado eletronicamente, com intuito de documentar uma operao de
circulao de mercadoria, ocorrida entre as partes, cuja validade jurdica garantida pela
assinatura digital do emitente e recepo, pelo fisco, antes da ocorrncia do fato gerador.
NFSe
A Nota Fiscal de Servios Eletrnica (NFS-e) um documento de existncia digital, gerado
e armazenado eletronicamente em Ambiente Nacional pela RFB, pela prefeitura ou por
outra entidade conveniada, para documentar as operaes de prestao de servios.
O projeto de Nota Fiscal de Servios Eletrnica (NFS-e) desenvolvido de forma
integrada, pela Receita Federal do Brasil (RFB) e Associao Brasileira das Secretarias de
Finanas das Capitais (Abrasf), atendendo o Protocolo de Cooperao ENAT n 02, de 7 de
dezembro de 2007, que atribuiu a coordenao e a responsabilidade pelo desenvolvimento e
implantao do Projeto da NFS-e.
A Nota Fiscal de Servios Eletrnica (NFS-e) habilitada pelo opcional: Nota Fiscal de
Servio Eletrnica (NFS-e).

POSSVEIS CENRIOS DE INSTALAO DO SANNFE:

Quando o sistema precisa emitir NF-e ou NFS-e, ele precisa obrigatoriamente que o SanNFe
seja instalado.
EMPRESAS ONDE SE EMITEM APENAS NFE
- Somente pela linha grfica (Mitra/G1, etc)
- Somente pela linha /W
- Misto (pode-se usar linha /W ou grfica)
EMPRESAS ONDE SE EMITEM APENAS NFSE
- Somente pela linha /W
- Misto (pode-se usar linha /W ou grfica)
EMPRESAS ONDE SE EMITEM TANTO NFE QUANTO NFSE
- Somente pela linha grfica (Mitra/G1, etc)
- Somente pela linha /W
- Misto (pode-se usar linha /W ou grfica)
O SanNFe deve estar instalado no servidor de aplicaes que roda o SankhyaW, na pasta de
usurio do sistema operacional que executa a aplicao. Essa pasta ir variar
dependendo da verso do sistema operacional. No Linux a pasta home/mgeweb, no
Windows sugerimos utilizar a pasta X:\SanNFe, onde X ser o drive a ser utilizado.

INSTALAO DO SANNFE

INSTALAO DO SANNFE - LINUX

O arquivo de Instalao do SanNFe deve ser transferido para o servidor por algum aplicativo
como, Winscp,FTP, SCP ou qualquer outro aplicativo de transferncia de arquivo.

-5-

INSTALAO DO SANNFE

-6-

INSTALAO DO SANNFE

Para atualizar/instalar o SanNFe ser preciso ter acesso ao servidor Linux, pelo console ou
por algum cliente de SSH, como o Putty.
Caso o servidor no tenha o servio SSH em execuo, a atualizao/instalao deve ser
realizada na prpria mquina.
No exemplo anterior o programa utilizado para acessar o servidor foi o Putty, e a
instalao/atualizao do SanNFe foi transferido, para o servidor serverjava.
Veja:

O comando ls listar os arquivos (pastas) do diretrio corrente, veja imagens a seguir:

-7-

INSTALAO DO SANNFE

Backup de uma instalao

anterior do SanNFe

Arquivo de
Instalao/Atualizao do
SanNFe que foi transferido.

No caso de uma atualizao, antes de fazer o backup da instalao atual, o SanNFe deve
ser finalizado, para isto o usurio dever acessar a pasta do SanNFe ([daniel@serverjava
~]$ cd SanNFe) e executar o comando comando ./sannfe-service stop, como mostra a
imagem a seguir:

-8-

INSTALAO DO SANNFE

O Backup da verso atual, neste exemplo de atualizao, ser o "SanNFe-ant3", pois

pode-se visualizar as pastas "SanNFe-ant" e "SanNFe-ant2" de verses anteriores.

Backup da Verso Atual

-9-

INSTALAO DO SANNFE

O comando "tar -xzvf SanNFe_unix_2_0b38.tar.gz" ser utilizado pra descompactar a

Instalao/Atualizao.
Esse comando criar a pasta "SanNFe" com a nova verso.

Na atualizao, depois de descompactada a instalao, os arquivos de Configuraes e

Certificados da verso anterior devero ser copiados para a nova verso.

- 10 -

INSTALAO DO SANNFE

COMO INICIALIZAR O SERVIO NO LINUX

Aps a instalao do SanNFe-Linux, dentro do diretrio do SanNFe, o servio ser
inicializado pelo comando: ./sannfe-service start
Como mostra a imagem abaixo:

- 11 -

INSTALAO DO SANNFE

INSTALAO SANNFE WINDOWS

Essa instalao deve ser feita no diretrio onde foi instalado o SankhyaW (JBoss).
O SanNFe disponibilizado em arquivo compactado, ento, bastar descompact-lo. No
Windows sugerimos utilizar a pasta X:\Users\Nome do Usurio\SanNFe, onde X ser
o drive a ser utilizado.
Exemplo: C:\Users\Joao\SanNFe.

COMO INICIALIZAR O SERVIO NO WINDOWS

Aps a instalao do SanNFe Windows, o servio poder ser inicializado de trs formas:

- 12 -

INSTALAO DO SANNFE

1) Sannfe-console.exe = esta opo mais utilizada para teste e abrir uma janela de
console no DOS, onde o usurio poder verificar possveis erros. O cone do SanNFe
ser exibido na Barra de Ferramentas.
2) SanNFe-Win.exe = esta opo de inicializao semelhante a anterior, contudo,
nenhum console apresentado ao usurio e o cone do SanNFe ser exibido
diretamente na Barra de Ferramentas.
3) SanNFe-service.exe = esta forma de inicializao do servio poder ser utilizada
quando o cliente fizer a instalao do SanNFe, ao invs de utilizar o arquivo de
instalao compactado. a forma de inicializao mais utilizada pelos usurios. Atravs
desta opo o SanNFe ser inicializado como um servio do Windows, e poder ser
inicializado automaticamente junto com o Windows, se devidamente configurado como
mostram as imagens abaixo:

- 13 -

INSTALAO DO SANNFE

- 14 -

INSTALAO DO SANNFE

- 15 -

INSTALAO DO SANNFE
IMPORTAO DO CERTIFICADO DA EMPRESA
Ateno: Para a Instalao tanto no Linux quanto no Windows, o usurio dever importar
o Certificado da Empresa. Isto ser feito pelo menu Comercial\Configurao\Console
NFe. Para acessar o Console o usurio dever digitar na barra de endereos do browser o
endereo contendo o IP da mquina (servidor SanNFe) e a Porta seguidos de NFE.htm,
conforme exemplo: http://IPdoServidorSannfe:porta/NFE.htm

Importante:
Com a finalidade de aumentar a segurana e evitar a utilizao de certificados digitais em
ambientes de produo, existe no exportador de registro de certificados do SanNFe a opo
para definir em qual ambiente (1-Produo; 2-Homologao e 3-Ambos) os certificados
exportados podero ser utilizados.
Tambm h uma opo para definir uma data de validade para o registro do certificado
exportado. A configurao de ambiente e data de validade nica para todos os registros
exportados. importante comentar que essa data de validade do registro de certificados
exportados no tem relao e no a mesma da data de expirao do certificado digital,
somente a data de validade de utilizao do certificado digital no SanNFe.

- 16 -

INSTALAO DO SANNFE
Exemplo: Cliente X no dia 15/03/2012 exporta o certificado para realizao de testes no
SankhyaW. O cliente ento configura na Exportao, que o certificado poder ser usado
apenas em ambiente de homologao e no mximo at o dia 18/03/2012.
Na Exportao:
Na Exportao superior a Maior Data de Validade calculada para o certificado(s)
selecionado(s). O clculo da Maior Data de Validade efetuado da seguinte forma:
1-Certificados com somente data de expirao: Ser utilizada a maior data de expirao do(s)
certificado(s) selecionado(s). Exemplo de certificados que podem ser encontrados nesta
situao: Certificados que foram adicionados no SanNFe e que no passaram pelo processo de
importao/exportao.

2-Certificados com data de expirao e data de validade: Ser utilizada a maior data de
validade do(s) certificado(s) selecionado(s), ignorando a data de expirao.
No caso em que os certificados escolhidos j passaram pelo processo de exportao e
importao utilizando uma data de validade e ambiente, a data a ser verificada no processo
de exportao ser a data de validade e no a data de expirao do(s) certificado(s). A
finalidade para esse comportamento de evitar que certificados sejam repassados
aumentando os direitos recebidos (importados). O mesmo valido para ambiente que
- 17 -

INSTALAO DO SANNFE
somente poder ser alterado
Homologao;3-Ambos).

para

certificado(s)

com

ambiente

(1-Produo;2-

Validaes:
1) Consta no SanNFe um certificado com data de expirao 01/01/2014, data de validade
20/08/2013 e ambiente = Homologao. Neste caso, quando o usurio for export-lo
novamente, o sistema levar em considerao para validao a data de validade existente,
ignorando assim, a data de expirao. OBS: No permitido informar uma data de
validade superior a j existente.
2) Consta no SanNFe 5 certificados com data de expiraes diversas e as seguintes datas
de validade: 01/05/2012, 25/05/2012, 22/06/2012, 15/09/2012 e 10/12/2012.
Quando o usurio selecionar os certificados e solicitar a exportao, a data a ser informada
no poder ser superior a maior data de validade dentre os certificados
selecionados, que no caso ser 10/12/2012. Se o usurio informar, por exemplo, uma
data de validade superior a esta, ser alertado com a seguinte mensagem: A data de
validade xx/xx/xxxx 00:00 no pode ser superior a maior data de
expirao/validade do(s) certificado(s) selecionados 10/12/2012.
OBS: Na prpria tela j apresentada a maior data limite seguindo as validaes dos
exemplos 1 e 2.
3) Caso o usurio tente exportar como PRODUO (por exemplo, pois a mesma validao
tambm vlida para Homologao) um certificado que j tenha sido importado para
uso somente em ambiente de Homologao, o mesmo conseguir export-lo e importlo normalmente, mas ao tentar utiliz-lo como PRODUO, o sistema no permitir e
emitir a seguinte mensagem: O certificado digital referente ao CNPJ: xxxxxxxxxxx
no pode ser utilizado nesse ambiente: 1-Produo.
3.1: A finalidade para esse comportamento de evitar que certificados sejam repassados
aumentando os direitos recebidos (importados), ou seja, se o usurio recebeu um certificado
o qual pode utiliz-lo somente em ambiente de Homologao, no faz sentido ele conseguir
exportar e utilizar este mesmo certificado em ambiente de produo, por isso ele consegue
export-lo, mas no consegue utiliz-lo.
3.2: Se o usurio possui um certificado o qual havia sido exportado como AMBOS, isso
significa que o mesmo conseguir utiliz-lo em ambiente de homologao e em ambiente de
produo. Caso seja necessrio exportar este certificado novamente, o usurio ter a opo
de export-lo em PRODUO, HOMOLOGAO E AMBOS, mas se exportar somente em
produo, ou somente em homologao, conseguir utiliz-lo somente no ambiente
exportado.
4) Caso o usurio tente exportar um certificado (independente do ambiente) com uma data
de validade para uso no SanNFe inferior a data atual, ser alertado com a seguinte
mensagem: A data de validade no pode ser inferior a data atual.
Na Importao:
- O sistema no ir permitir a importao de certificados que j estejam com a sua data de
validade expirada. Exemplo: O usurio exportou um certificado com data de validade at
20/03/2012 e tentou import-lo no dia 25/03/2012. Ao tentar realizar esta operao o
sistema emitir uma mensagem de erro.

- 18 -

INSTALAO DO SANNFE
- Na utilizao do certificado importado ser feito validao em relao data de
validade de utilizao do certificado no SanNFe.

CONSOLE NFE
Na tela Console NFe o usurio dever informar:

ABA REGISTRO DE CERTIFICADOS

Certificado: o SanNFe suporta apenas certificado tipo A1 (PKCS n 12, *.pfx). O do tipo
A3 no suportado.
O Certificado do tipo A1 gerado e armazenado em um computador pessoal atravs do
navegador de Internet, dispensando o uso de cartes inteligentes ou tokens. Para maior
segurana, no momento da emisso do certificado, deve-se optar por proteg-lo com uma
senha de acesso. Adicionalmente, recomenda-se que um nico computador armazene seu
Certificado Digital e que seja criada apenas uma cpia de segurana. Este certificado
digital, geralmente, possui validade de um ano. Essa cpia de segurana do certificado
que ser usada pelo usurio para inseri-lo no SanNFe.
- 19 -

INSTALAO DO SANNFE
Para realizar essa Exportao do Certificado, o usurio dever seguir os passos abaixo,
usando, por exemplo, o navegador Internet Explorer:
1 Abrir o Microsoft Internet Explorer;
2 Clicar no menu Ferramentas (Tools), localizado na parte superior da janela do Internet
Explorer. Em seguida clicar no item Opes da Internet (Internet Options);
3 Na janela Opes da Internet (Internet Options) clicar na guia Contedo (Content).
Esta guia fica localizada na parte superior da janela.

4 Na guia Contedo (Content) clicar no boto Certificados (Certificates). Este boto

fica localizado no meio da janela.

- 20 -

INSTALAO DO SANNFE

5 Ser exibido o Gerenciador de certificados (Manager Certificates) do Internet

Explorer. O usurio dever verificar se o seu certificado exibido na guia Pessoal
(Personal).

- 21 -

INSTALAO DO SANNFE
6 Ao clicar no boto Exportar (Export) ser exibido um assistente conforme a imagem
abaixo. Clique no boto Avanar (Next).

7 Na etapa seguinte selecionar a opo Sim, exportar a chave particular (Yes, export
the private key) e clicar no boto Avanar (Next).

- 22 -

INSTALAO DO SANNFE

8 Na etapa abaixo, aconselhvel que o usurio exporte todos os certificados pertencentes

cadeia de certificao. Para isto, selecionar a opo Incluir todos os certificados no
caminho de certificao. Clicar no boto Avanar.

9 Na janela Senha de proteo para chaves particulares digitar uma senha para a
cpia de segurana. Aps digitar as senhas, confirm-las no campo Confirmar senha
(Confirm Password).
- 23 -

INSTALAO DO SANNFE

10 Na janela Nome do arquivo de exportao clicar no boto Procurar (Browser).

Desta forma, ser possvel escolher o local onde a cpia de segurana ser salva assim como
digitar um nome para o arquivo.

- 24 -

INSTALAO DO SANNFE
11 Na janela Salvar como (Save as) escolher o local onde ser salva a cpia de
segurana e tambm o nome para o arquivo. Aps definir ambos, clicar no boto Salvar
(Save).

12 A ltima etapa do Assistente para exportao de certificados exibe as

configuraes selecionadas pelo usurio. Clicar no boto Concluir (Finish).

- 25 -

INSTALAO DO SANNFE

13 Ser exibido o alerta Um aplicativo est solicitando o acesso a um item

protegido. Clicar no boto Ok.

14 Por fim, clicar no boto Ok conforme a imagem abaixo.

Voltando tela Console Nota Fiscal Eletrnica\aba Registro de Certificados, informar:

CNPJ/e-CPF: Informa-se o CNPJ da empresa, o e-CPF utilizado em algumas situaes para
envio de Nota Fiscal de Servio Eletrnica, NFS-e.
Exemplo: A prefeitura da cidade de Aparecida exige e-CPF (CPF digital). J as demais
prefeituras homologadas para emitir NFS-e exigem o e-CNPJ (CNPJ digital).
Obs: O e-CPF no pode ser utilizado para a NF-e; j o e-CNPJ pode, no entanto, no o
mais indicado. O ideal utilizar um e-CNPJ, a ser emitido especificamente para o processo
de assinatura de NF-e.
Estado: UF da empresa
- 26 -

INSTALAO DO SANNFE
Senha: Fornecida pela certificadora.
Informaes do Certificado
Aps preencher os campos obrigatrios clicar em Salvar o Registro.

ABA STATUS DO SERVIO

Para testar se o servio esta OK para o CNPJ/Certificado cadastrado, deve-se acessar esta
aba, selecionar o CNPJ da Empresa previamente cadastrada conforme as instrues anteriores
e clicar no boto Executar, o sistema efetuar uma consulta sobre a disponibilidade do
servio junto a SEFAZ, apresentando o seguinte retorno destacado em vermelho na imagem
abaixo, caso a operao esteja Ok junto a SEFAZ.

Obs.: Vale ressaltar que esta mensagem apenas do Servidor de NF-e onde sero
cadastradas as Empresas/CNPJ e seus certificados, sendo que para o perfeito funcionamento
da integrao entre o Sistema e a SEFAZ, todas as configuraes dos campos citados no
manual da Nota Fiscal Eletrnica referente ao Sistema, devero estar devidamente
configurados/cadastrados.
A partir da verso 2.3b30, alm da validao sobre a execuo do servio, ao acionar o boto
Testar nesta tela ser apresentado o status e descrio do status retornado pela SEFAZ,
como mostra imagem a seguir:

- 27 -

INSTALAO DO SANNFE

Para teste de Status do Servio para o SCAN tambm ser apresentado se este est ou
no habilitado para a UF selecionada:

INSTALAO PARA NOTA FISCAL ELETRNICA DE SERVIOS

A Nota Fiscal Eletrnica de Servio, est disponvel a partir da verso 2.3.0 do
SankhyaW, a instalao do aplicativo responsvel pela comunicao com os servios
disponibilizados para emisso de Nota Fiscal Eletrnica de Servios (NFSe) consiste,
resumidamente, em apenas dois passos:

1. INSTALAO DO APLICATIVO (NOTA FISCAL ELETRNICA DE SERVIO) NA PASTA DO USURIO

Instalao do SanNFe
Instalao do Console para NFSe.
A incluso do SanNFe deve ser feita no diretrio do usurio que manipula o SankhyaW.
O SanNFe disponibilizado em arquivo compactado, ento, bastar descompactar no diretrio
do usurio.
No Linux utiliza-se o usurio padro mgeweb, portanto, o diretrio no qual seria
descompactada a aplicao, seria o /home/mgeweb.
J no Windows seria c:\Documents and Settings\UsuarioQueAdministraOSankhyaW.
O arquivo compactado da verso Linux, distribudo no formato tar.gz e para a
descompactao, aps ter copiado o arquivo para a pasta /home/mgeweb, bastar utilizar
o comando tar, com os devidos parmetros para descompactao: x = extrair; z = gzip; v
= exibe informaes, f = arquivo (prximo parmetro).
Exemplo:

A verso para Windows disponibilizada em formato zip. Bastar ao usurio utilizar o

descompactador de sua preferncia, e executar a extrao diretamente para a pasta onde foi
instalado o SankhyaW.
- 28 -

INSTALAO DO SANNFE
2. INSTALAO DO SANKHYAW PARA UTILIZAO DO CONSOLE NFSE
O console da NFSe est contido dentro do SankhyaW, portanto, bastar solicitar a atualizao
do SankhyaW para a verso 2.3.0 ou superior.
Vale ressaltar que o pacote de atualizao gerado conforme o contrato(s) do cliente e os
produtos contidos no(s) contrato(s).
2.1 O CLIENTE NO POSSUI O SANKHYAW EM CONTRATO
Quando o cliente adquire o console NFSe, mas no o SankhyaW, feita ento uma
instalao personalizada do SankhyaW, para atender a NFSe.
Essa atualizao usa um pacote de bibliotecas e recursos minimizados, contendo apenas
o necessrio para o Console NFSe, visando otimizar a performance no servidor de aplicaes
JBoss.
Importante:
O Jboss utilizado nessa instalao mnima um JBoss verso 4.0.5, customizado pela
Sankhya.
NO DEVE SER UTILIZADO OUTRO PARA ESTE TIPO DE INSTALAO.
Apesar do pacote (arquivo.pkg) e o JBoss serem especficos para essa instalao, o
processo o mesmo contido no manual de Instalao/Atualizao do SankhyaW, que est
disponvel na rea restrita do site da Sankhya.

CONFIGURAES
Existem algumas configuraes para melhorar o desempenho de envio de Notas Fiscais Eletrnicas.
Abaixo, algumas dessas configuraes que devem ser realizadas no arquivo san-nfe.conf localizado na
pasta conf do diretrio onde foi instalado o SanNFe:
Em um primeiro cenrio:
tempo.max.execucoes.webservice=30000 (30 segundos)
numero.tentativas.execucoes.webservice=2
tempo.espera.execucoes.webservice=500 (no pode ser menor que 500) 1/2 segundo

As configuraes so:
tempo.max.execucoes.webservice
tempo mximo para execuo do webservice
padro = 30000 (30 segundos)
numero.tentativas.execucoes.webservice
nmero mximo de tentativas de execues do webservices
valor padro = 2
- 29 -

INSTALAO DO SANNFE

tempo.espera.execucoes.webservice
tempo de espera entre execues do webservice
padro = 500 (metade de um segundo)

Essas 3 parametrizaes podero ser utilizadas em conjunto:

Como exemplo, considere os seguintes valores:
tempo.max.execucoes.webservice=30000
numero.tentativas.execucoes.webservice=2
tempo.espera.execucoes.webservice=500
No caso acima se a execuo de algum servio falhar, o SanNFe tentar executar o mesmo servio 2
vezes, considerando o tempo mximo de 30 segundos. Entre cada tentativa aguardar 1/2
segundo.
Exemplo de caso considerando os valores configurados anteriormente:
O SanNFe executou o servio de envio de lote de uma NFe, e ao executar esse servio ocorreu um erro
qualquer. O tempo que foi gasto at ocorrer o erro foi de 10 segundos.
Nesse caso, ele vai entrar em espera por aproximadamente 1/2 segundo. Total de espera, 10 + 1/2.
Como 10,5 segundos so menores que 30 segundos e esta a primeira execuo, o servio foi
executado novamente.
Na segunda execuo ocorreu o erro novamente em menos de 5 segundos, totalizando 16
segundos (somando com a execuo anterior), esse valor ainda esta abaixo dos 30 segundos que
o mximo. Contudo, j se chegou ao mximo de tentativas que de 2 (duas). Dessa forma no ser
mais executado nenhum servio

Segundo cenrio:
tempo.max.execucoes.webservice=40000
numero.tentativas.execucoes.webservice=5
tempo.espera.execucoes.webservice=500
Levando em considerao que cada execuo leva 10 segundos at ocorrer o erro. O SanNFe vai tentar
executar o servio aproximadamente 3 vezes.

CONEXO COM INTERNET

O SanNFe necessita de conexo com a internet para consumir os servios da Receita
Estadual ou Federal. Por esse motivo devem-se realizar testes de conectividade para
evitar problemas na execuo dos servios.
A lista de URLs informada no Console tem por objetivo validar se a mquina a qual o
SanNFe est instalado tem conexo com a Internet.
Na instalao do SanNFe essa lista de URLs vem vazia, nesse caso, o SanNFe no executa a
validao da conexo, antes de executar algum servio. Por isso, quando a mquina no tem
conexo com a Internet, ir ocorrer falha ao executar o servio, ou seja, na emisso da Nota
pelo MGE, Mitra, Jiva ou Sankhyaw.

- 30 -

INSTALAO DO SANNFE
Quando no configurado o teste, se ocorrer o erro na execuo, o SanNFe far o teste de
conectividade, a fim de facilitar a deteco de problemas, utilizando para isto a URL:
http://www.receita.fazenda.gov.br.
Quando no h conexo, ser incluso na mensagem de erro, que a possvel causa pode ser a
falta de conexo.
Quando informada alguma URL da lista, o SanNFe passa a validar a conexo por meio
dessa URL. O teste de conexo consiste num acesso bem sucedido ao site endereado pela
URL. Em caso de falha, no ser permitido execuo de nenhum servio.
Caso exista mais de uma URL na lista, a aplicao considera o teste bem sucedido para
primeira URL acessada.

CONFIGURAES DE PROXY
O SanNFe apresenta suporte a utilizao do Proxy (SankhyaW verso 2.3.0b30 MGE\Jiva verso 3.11)
Para utiliz-lo necessrio efetuar a configurao do Proxy no SanNFe: Comercial>Configurao->Console NFe->Aba Administrao

Habilitar uso do Proxy: Se marcado, indicar que o parceiro utiliza Proxy no acesso a
Internet.
Endereo: Deve-se informar o IP ou endereo do Servidor Proxy.
Porta: A porta utilizada no Servidor Proxy.
No utilizar Proxy para os endereos: informar os endereos que no sero considerados
na utilizao do Proxy.
Os campos da configurao do Proxy somente sero salvos quando acionado o boto Salvar.
As informaes de configurao de Proxy so salvas no arquivo de configurao do SanNFe
por meio das seguintes propriedades (seguindo a mesma ordem dos campos apresentados na
imagem acima):
proxy.habilitado
proxy.endereco
proxy.porta
sem.proxy.para
A configurao de Proxy tem impacto em toda a parte de comunicao externa do SanNFe,
por isso, uma configurao incorreta do Proxy, como porta ou endereo, far com que o
SanNFe pare de funcionar, no sendo possvel executar nenhum servio da SEFAZ/Prefeitura
- 31 -

INSTALAO DO SANNFE
bem como qualquer teste de 'Conexo com a Internet' configurado na aba 'Status do
Servio'.
Para saber se as configuraes esto corretas, deve-se ir Aba Status do Servio, na opo
de Configurao e teste de conectividade com a Internet e informar endereos para
anlise.
Veja a seguir algumas configuraes e anlises que so tcnicas e devem ser analisadas pelo
pessoal da rea de TI da empresa:
Detalhes de Configurao do Proxy
1. Proxy sem autenticao - com liberao para acesso por rede; essa configurao
permite que qualquer mquina que esteja na mesma rede do servidor Proxy, tenha acesso ao
mesmo.
Junto com a instalao do squid vem um arquivo padro de configurao
/etc/squid/squid.conf. As configuraes devem ser realizadas tendo por base esse arquivo.
Para incluir a configurao de rede inclui-se a ACL: acl localnet src 192.168.56.0/24 essa
acl permite acesso a qualquer mquina que pertena a rede 192.168.56.x
Em seguida necessrio atribuir acesso a acl localnet com a seguinte linha: http_access
allow localnet
*OBS.: Para que sejam permitidas conexes HTTPS pelo Proxy necessrio existir a linha:
http_access deny CONNECT !SSL_ports. Essa linha vem por padro no arquivo de
instalao do Squid.
2. Proxy com autenticao quando o Proxy configurado para solicitar a autenticao
de usurios necessrio liberar as URLs utilizadas pelo SanNFe, para que no sejam
solicitadas autenticaes para as mesmas. Para isso, necessrio criar uma ACL e atribuir
acesso a essa ACL antes da instruo de autenticao do usurio no arquivo de configurao.
Com o Proxy configurado para solicitar a autenticao do usurio, incluir a ACL: acl govBr
dstdomain .gov.br no arquivo de configurao. Antes da linha que libera o acesso para
usurios autenticados deve ser includa a linha: http_access allow govBr.
Essa configurao permite que seja acessado qualquer URL que tenha como final no seu
domnio gov.br . Essa regra far com que todos os servios de NFe sejam executados.
Essa mesma regra deve ser considerada para as URLs de NFSe que no tem o mesmo padro
das URLs de NFe.
Para obter a lista completa de URLs que devem ser liberadas para o SanNFe basta editar os
arquivos: conf/url-webservices.xml e conf/provedores-nfse.xml.

- 32 -

INSTALAO DO SANNFE

CARACTERSTICAS DO PAINEL DE TESTES

Para adicionar uma URL na lista, basta informar o endereo vlido, exemplo:
http://www.sankhya.com.br

Em seguida, selecionar o boto com cone de Adicionar (+) para inclu-la na lista;

- 33 -

INSTALAO DO SANNFE

Depois de adicionado as URLs necessrio acionar o boto Salvar Lista, esse boto salvar
a lista de URLs no arquivo de configurao do SanNFe (conf/san-nfe.conf);
O boto Testar efetua o teste de conexo para todas as URLs includas na lista, um teste
bem sucedido marca a URL com o cone na cor verde, caso contrrio, um cone na cor
vermelha apresentado.

- 34 -

INSTALAO DO SANNFE

A lista de URL armazenada no arquivo de configurao do SanNFe por meio da propriedade:

internet.test.urls=<lista de URLs>, onde cada URL separada por vrgula.
Por exemplo:
internet.test.urls=http://www.sankhya.com.br,http://www.jiva.com.br
As URLs para execuo de servios Web (webServices) executados pelo SanNFe diferem de
estado para estado. Para que o usurio no tenha que liberar acesso completo da mquina,
basta liberar por meio de NAT (Network Address Translation), os endereos referentes ao
estado (UF) que ser emitido a NFe para a porta 443(HTTPS).
Como exemplo as URLs dos webservices para o estado de MG so:
- 35 -

INSTALAO DO SANNFE

https://nfe.fazenda.mg.gov.br/nfe/services/NfeRecepcao
https://nfe.fazenda.mg.gov.br/nfe/services/NfeRetRecepcao
https://nfe.fazenda.mg.gov.br/nfe/services/NfeCancelamento
https://nfe.fazenda.mg.gov.br/nfe/services/NfeInutilizacao
https://nfe.fazenda.mg.gov.br/nfe/services/NfeConsulta
https://nfe.fazenda.mg.gov.br/nfe/services/NfeStatusServico
O endereo a liberar deve ser: nfe.fazenda.mg.gov.br para a porta 443.
A lista dos endereos para os outros estados podem ser encontradas no arquivo de urls
conf/url-webservices.xml ou no site da Receita Federal
http://www.nfe.fazenda.gov.br/portal/Default.aspx

SCHEMAS NO SANNFE
A troca de mensagens entre o SanNFe e SEFAZ e realizada por meio de arquivos XMLs,
portanto a validao aplicada a esses arquivos, por meio de definies contidas em arquivos
do tipo XSD, denominados de schemas. Os shemas so disponibilizados e versionados pela
Receita Federal.
O SanNFe permite que os schemas disponibilizados pela SEFAZ possam ser configurados
sem que haja alteraes na aplicao, sendo assim, a tarefa de manter a aplicao com os
schemas atualizados fica sob responsabilidade da empresa ou monitores.
A seguir so apresentados os passos para atualizar os schemas para o SanNFe:
1 fazer download do arquivo compactado referente verso que se deseja atualizar no site
da Receita Federal: http://www.nfe.fazenda.gov.br/portal/Default.aspx
Selecionar a opo do menu: Legislao e Documentos -> Schemas XML
Sero apresentadas vrias verses. Baixar a verso desejada;
2 descompactar o arquivo baixado no passo 1, no diretrio schemas do SanNFe ([diretrio
de instalao do SanNFe]\schemas);
3 alterar o arquivo de configurao para que seja utilizado o novo schema; o arquivo de
configurao esta localizado na pasta conf ([diretrio de instalao do SanNFe]\conf); alterar a
propriedade: versao.schemas= para o nome do diretrio do novo schema;
4 reinicializar o SanNFe;
4.1 SankhyaW
4.1.1 selecionar a opo de menu Comercial->Configurao->Console NFe;
4.1.2 selecionar a opo Forar reinicializao
4.2 MGE/Mitra/Jiva
4.2.1 necessrio parar o SanNFe e inici-lo novamente;
Como exemplo, a seguir, ser seguidos os passos apresentados acima, com exemplos de
atualizao do schema PL_005f:
1 acessado o site foi baixado o arquivo: PL_005f.zip
2 depois de descompactado foi criado a pasta PL_005f; essa pasta foi copiada para dentro
da pasta schemas do sannfe;
3 a propriedade no arquivo de configurao ficou da seguinte forma:
verso.schemas=PL_005f
- 36 -

INSTALAO DO SANNFE

4 depois disto, reiniciar o SanNFe, ao acessar o console de gerenciamento aba

Administrao ser apresentado a verso do schema utilizada pelo sannfe.
A imagem abaixo ilustra a aba descrita acima, com o novo schema carregado:

Observao Importante: O usurio deve estar atendo ao baixar e configurar uma nova
verso dos schemas no SanNFe. Ao baixar uma nova verso o usurio deve observar se esta
no se trata apenas de um release do schema, pois a SEFAZ no inclui todos os arquivos,
em um release, mas somente os que tiveram correes. Arquivos de schemas apenas
de release fazem com que ocorram erros no SanNFe, pois o mesmo os considera
incompletos.
Os schemas relacionados a NFS-e (Nota Fiscal Eletrnica de Servio) so definidos por
outra forma, por isso, ao atualizar os schemas da NFe descritos neste documento, no as
funcionalidades da NFS-e no sero afetadas.

- 37 -

INSTALAO DO SANNFE

ENVIO DE EVENTOS
O SanNFe foi alterado na verso 2.6 para permitir o envio de eventos, como por exemplo,
a Carta de Correo Eletrnica.
A implementao desse envio segue o mesmo padro dos servios j disponibilizado pela
SEFAZ, sendo necessrio um novo diretrio de schemas, e a incluso de uma nova entrada
no arquivo de configurao de urls-webservices.xml.
A verso de desenvolvimento do SanNFe que dever ser disponibilizada, junto com a verso
2.9.0 do SankhyaW a 2.6. O SanNFe 2.6 j possui em sua instalao o diretrio
Cce_v1.00a, que a verso vigente do schemas.
A verso do schemas de Carta de Correo Eletrnica pode ser configurado no arquivo
san-nfe.conf no diretrio conf na instalao do SanNFe. A propriedade :

diretorio.schemas.carta.correcao=<diretrio>
Quando no informado a opo acima, o valor padro ser setado na inicializao
do SanNFe.
O arquivo de configurao de URLs dos webservices tambm foi alterado para incluir o
endereo do servio de recepo de eventos.
As seguintes linhas foram includas para os servios do estado de Santa Catarina:
<url webService="NfeRecepcaoEvento"
producao=""
homologacao="https://homologacao.nfe.sefazvirtual.rs.gov.br/ws/recepcaoevento/recepca
oevento.asmx" />
Ateno Consultores e Monitores: Por ser um servio que ainda no entrou em
produo at a data dessa implementao (17/08/2011), no foi disponibilizado o endereo
de produo, por isso, fica na responsabilidade do cliente/monitor/consultor incluir esse
endereo de produo quando divulgado pela Receita Estadual.
O envio de Carta de Correo foi implementado seguindo os mesmos critrios pela Sefaz
para a NFe, por isso, a mesma implementao efetuada e testada para o ambiente virtual,
tambm pode ser utilizado para os outros estados.
Os endereos para os outros estados tambm devem ser includos pelo
cliente/monitor/consultor.
(Veja detalhes da Carta de Correo Eletrnica no manual da NFe SankhyaW)

- 38 -