Guia Informativo Sistema Documentos Eletrnicos

Senior Sistemas S.A.

Reviso 1.0 janeiro/2014

2

Sumrio

1 Introduo ........................................................................................... 4
2 Premissas ............................................................................................. 4
2.1 Confirmando o usurio utilizado para instanciar os servios do Documentos
Eletrnicos...5
3 Configurando IIS Windows 2008 Server ou superior ............................................ 6
3.1 Verificaes do Pool de Aplicativos do IIS ............................................... 6
3.2 Alterando parametrizaes do Pool de Aplicativos .................................... 7
3.3 Alterando parametrizaes do aplicativo Monitor do Documentos Eletrnicos no IIS 10
3.4 Reiniciando o servio do IIS para efetivar as alteraes ............................. 12
3.5 Como identificar qual Pool de Aplicativos do IIS o Monitor do Documentos Eletrnicos
est utilizando e como alter-lo, se necessrio. ............................................... 13
3.6 Informaes adicionais sobre parametrizaes do IIS e parametrizaes do servidor
que podem ter impacto nas funcionalidades do Monitor do Documentos Eletrnicos ..... 14
3.7 Problemas comuns no Documentos Eletrnicos causados pela no parametrizao
correta do IIS......................................................................................... 15
4 Instalao do Certificado Digital para filiais no Documentos Eletrnicos ................. 16
4.1 Parametrizar um certificado digital para filial no Documentos Eletrnicos ...... 16
4.2 Confirmar a instalao correta do certificado digital para a filial ................. 17
4.3 Problemas comuns no Documentos Eletrnicos causados por problemas no certificado
digital 19
5 Logs do Documentos Eletrnicos Conceito e captura dos Logs ............................ 19
5.1 Procedimento para coleta dos Logs do Documentos Eletrnicos ................... 20
5.2 Alterao do nvel de gerao de Logs do Documentos Eletrnicos ................ 22
5.3 Dica como saber qual o diretrio onde o Documentos Eletrnicos est instalado? 23
5.4 Dica disponibilizao dos Logs do Documentos Eletrnicos para usurios ....... 24
6 Gerando LOGs XML de NFS-e ..................................................................... 25
7 Como trocar a proprietria do Documentos Eletrnicos ..................................... 27
8 Informaes sobre status eletrnicos de documentos fiscais ............................... 29
8.1 Diferena entre status do documento e status do documento eletrnico no ERP 30
8.2 Consulta de status e histrico de documentos eletrnicos no ERP ................. 31
9 Efetuando retorno manual de documento eletrnico atravs do DepuraSID ou MCDebug33
9.1 Testes de retorno via DepuraSID ........................................................ 34
9.1.1 Encontrando a URL para efetuar o teste no DepuraSID. .................................... 37
9.1.2 Exemplos de AesSID que podem ser utilizadas ............................................ 38
3
9.1.3 Problemas comuns na utilizao do SeniorSID pelo Documentos Eletrnicos........... 40
9.2 Testes de retorno de status ou envio de documentos eletrnicos para ERP via MCDebug
41
9.2.1 Testes de retorno de status documentos eletrnicos via MCDebug ...................... 43
9.2.2 Testes de envio de documentos eletrnicos via MCDebug ................................. 45
9.2.3 Como obter informaes sobre os parmetros de cada WebService ..................... 47
9.2.4 Problemas comuns na utilizao de Web Services do ERP pelo Documentos Eletrnicos48
10 Utilizando o validador de XML da SEFAZ ........................................................ 49
11 Verificaes adicionais a serem efetuadas para recebimento de documentos eletrnicos no
Documentos Eletrnicos .......................................................................... 50
11.1.1 Dicas sobre verificaes a serem efetuadas quando a rotina de recebimento de e-mail no
estiver sendo executada corretamente ........................................................... 54
12 Verificando o diretrio onde o ERP gerar os arquivos XML dos documentos eletrnicos56
13 Verificando o ambiente utilizado por cada filial e se h contingncia ativada ........... 57
13.1 Verificando o ambiente utilizado pelo Documentos Eletrnicos .................... 57
13.2 Verificando se uma filial possui contingncia ativada no Documentos Eletrnicos57
13.3 Verificando qual o tipo de emisso utilizado pelo Documentos Eletrnicos para envio
de uma NF-e ......................................................................................... 58
14 Verificando os WebServices da SEFAZ e os WebServices utilizados pelo Documentos
Eletrnicos .......................................................................................... 59
14.1 Verificando os WebServices da SEFAZ .................................................. 59
14.2 Verificando os WebServices/URLs utilizados pelo Documentos Eletrnicos ....... 60
15 Quadro de revises ................................................................................ 61

4
1 Introduo
O objetivo deste guia servir de referncia para a obteno de informaes tcnicas sobre a
utilizao do Sistema Documentos Eletrnicos.
Neste guia ser possvel encontrar informaes tcnicas que iro auxiliar na utilizao do Sistema
Documentos Eletrnicos, principalmente na busca de informaes que ajudaro na resoluo de dvidas e
problemas frequentes encontrados pelos usurios.
Vrias informaes presentes neste manual envolvem outros aplicativos e sistemas da Senior, como,
por exemplo, o ERP Senior, o aplicativo DepuraSID e o aplicativo MCDebug, alm de configuraes de
ambiente Microsoft Windows, que so de responsabilidade da TI do cliente.

2 Premissas
pr-requisito para que o sistema Documentos Eletrnicos funcione corretamente que as seguintes
parametrizaes estejam efetuadas corretamente:
1) Servios do Documentos Eletrnicos devem estar parametrizados com usurio administrador da
rede/domnio/servidor que possua acesso irrestrito aos Web Services da SEFAZ/Prefeitura para onde os
documentos eletrnicos so enviados. Este mesmo usurio dever ter acesso irrestrito ao servidor onde
est instalado o Senior Middleware, para que no ocorram problemas no retorno dos status dos documentos
eletrnicos para o ERP;
2) Todas as configuraes o IIS onde o Monitor do Documentos Eletrnicos est instalado devem
estar de acordo com as informaes presentes no tpico 3 deste guia;
3) Senior Middleware deve estar instalado e acessvel para que o retorno de status dos documentos
eletrnicos ocorra normalmente do Documentos Eletrnicos para o ERP
4) Os horrios das estaes de trabalho, servidores e banco de dados devem estar sincronizados
com o horrio das Secretarias da Fazenda Estaduais (SEFAZ) para onde os documentos eletrnicos so
enviados. Caso haja necessidade de controle de Fuso Horrio e Horrio de Vero por usurio no ERP,
deve-se verificar a soluo de nmero 10492 do banco de solues do Suporte na ferramenta 0800Net.
Esta parametrizao de Fuso Horrio/Horrio de Vero por usurio necessria quando so emitidos
documentos fiscais no ERP para diferentes Secretarias da Fazenda Estaduais (SEFAZ) que, por sua vez,
possuem horrios diferentes.
5) imprescindvel que sejam utilizadas bases de dados diferentes para ambiente de produo e
para ambiente de homologao no Documentos Eletrnicos. A base de dados do ambiente de produo no
pode conter nenhum registro de documentos eletrnicos do ambiente de homologao, pois isso poder
trazer problemas futuros no processamento de documentos no ambiente de produo.

5
2.1 Confirmando o usurio utilizado para instanciar os servios do Documentos Eletrnicos
Caso haja necessidade de verificao se os Servios do Documentos Eletrnicos esto sendo
executados com usurio administrador da rede/domnio/servidor, poder ser acessado o Console de
Servios do Windows (services.msc) onde os servios esto instalados.


Figura 1 Visualizao dos servios do Documentos Eletrnicos no console de servios do Windows
Se houver necessidade da alterao das credenciais do usurio que ser utilizado para instanciar os
servios do Documentos Eletrnicos, poder ser efetuada a alterao da parametrizao pelo prprio
console de servios do Windows, ou atravs do Configurador do Documentos Eletrnicos, conforme
indicado na figura 2.


Figura 2 Parametrizao do usurio dos servios do Documentos Eletrnicos pelo Configurador
Observaes:
- sempre indicado que a parametrizao das credenciais do usurio seja efetuada no Configurador
do Documentos Eletrnicos, pois assim, as credenciais ficaro sempre atualizadas no Configurador, que o
aplicativo que serve para alterar outras parametrizaes.
- O Configurador apenas definir as credenciais para o servio Senior Documentos Eletrnicos, no
entanto, em alguns ambientes necessrio definir as credenciais do usurio administrador da
rede/domnio/servidor no servio Senior Documentos Eletrnicos PrintService tambm. Para estes casos,
esta parametrizao deve ser efetuada manualmente atravs do console de servios do Windows.
6
- Em alguns ambientes o servio PrintService pode estar instalado em um servidor diferente da onde
o servio Senior Documentos Eletrnicos est instalado, por este motivo, no servidor onde o servio Senior
Documentos Eletrnicos, ao ser acessado o console de servios do Windows, o PrintService pode no ser
mostrado.

3 Configurando IIS Windows 2008 Server ou superior
Para que todas as funcionalidades do Documentos Eletrnicos (Monitor) sejam executadas
corretamente, existem parametrizaes especficas a serem efetuadas no IIS do Servidor onde est
instalado o Monitor do Documentos Eletrnicos. Seguem abaixo as parametrizaes necessrias.
Observao: as informaes e prints presentes abaixo tiveram como base a utilizao de Windows
7 em Portugus. Algumas telas e/ou mensagens podem ser diferentes do indicado abaixo dependendo do
sistema operacional utilizado.
Dica: o aplicativo para gerenciamento do IIS est disponvel em Painel de Controle > Todos os
Itens do Painel de Controle > Ferramentas Administrativas > Gerenciador do Servios de
Informaes da Internet (IIS)

3.1 Verificaes do Pool de Aplicativos do IIS
Antes de serem efetuadas alteraes no Pool de aplicativos, devem ser verificadas as
parametrizaes do mesmo. Abaixo seguem as imagens que auxiliaro neste processo:


Figura 3 Visualizao de informaes de um Pool de Aplicativos do IIS
(1) Pool de aplicativos: opo que deve ser acionada para que sejam verificadas as
parametrizaes de Pool de Aplicativos. O Monitor do Documentos Eletrnicos sempre executado, por
padro, no Pool de Aplicativos Classic .NET AppPool. Observao: caso seja efetuada parametrizao
personalizada do IIS, o Monitor do Documentos Eletrnicos poder estar utilizando outro Pool de
Aplicativos, neste caso, deve-se adotar o Pool de Aplicativos personalizado utilizado para as
parametrizaes indicadas.
7

(2) Iniciado: o indicativo Iniciado na coluna Status indica que o Pool de Aplicativos Classic
.NET AppPool est iniciado. O Pool de Aplicativos onde o Monitor do Documentos Eletrnicos est
instalado sempre deve estar com status de Iniciado. Caso ele no esteja com status de Parado, deve ser
acionado o boto Iniciar (indicado no nmero 6 da figura 3) para que o Pool seja iniciado.

(3) Verso do .NET Framework: a coluna Verso do .NET Framework indica qual a verso do
.NET utilizada para um Pool de Aplicativos. Para o Pool de Aplicativos que o Monitor do Documentos
Eletrnicos utiliza deve sempre ser utilizada a verso v2.0 do .NET.

(4) Modo Pipeline Gerenciado: o Modo Pipeline Gerenciado do Pool de Aplicativos utilizado pelo
Monitor do Documentos Eletrnicos deve ser sempre Clssico.

(5) Identidade: o usurio utilizado para instanciar o Pool de Aplicativos utilizado pelo Monitor do
Documentos Eletrnicos. O Pool de Aplicativos utilizado pelo Monitor do Documentos Eletrnicos deve ser
sempre parametrizado para utilizar a conta de um usurio administrador da rede/domnio com acesso
irrestrito Internet.

(6) Boto Iniciar do painel Tarefas do Pool de Aplicativos: boto utilizado para parar ou
inicializar um Pool de Aplicativos. Caso o Pool de Aplicativos utilizado pelo Documentos Eletrnicos esteja
parado, ao tentar acessar o Monitor do Documentos Eletrnicos ser exibida a mensagem de Service
Unavailable.

3.2 Alterando parametrizaes do Pool de Aplicativos
Para efetuar alteraes em parametrizaes de um Pool de Aplicativos no IIS, deve-se acessar a
opo Pool de Aplicativos no Gerenciador do IIS. Aps isso, deve-se clicar com o boto direito em cima do
Pool de Aplicativos que se deseja alterar as parametrizaes, e em seguida selecionar a opo
Configuraes Avanadas.

8

Figura 4 Como acessar as configuraes avanadas do Pool de Aplicativos Classic .NET AppPool
Acessando a opo Configuraes Avanadas, a tela abaixo ser exibida.


Figura 5 Configuraes avanadas de um Pool de Aplicativos do IIS
(1) Iniciar automaticamente: indicativo de o Pool de Aplicativos deve ser iniciado automaticamente
quando o IIS est em execuo. Por padro e para evitar problemas futuros, indicado que este parmetro
seja mantido como True

9
(2) Modo de Pipeline Gerenciado: local onde pode ser alterado o Modo de Pipeline Gerenciado
utilizado pelo Pool de Aplicativos. Deve sempre estar parametrizado como Clssico

(3) Verso do .NET Framework: local onde pode ser alterado a verso do .NET utilizado pelo Pool
de Aplicativos. Deve sempre estar parametrizado como v2.0

(4) Identidade: local onde pode ser definido o usurio utilizado para instanciar o Pool de Aplicativos
utilizado pelo Monitor do Documentos Eletrnicos. Para alterar as credenciais do usurio utilizado deve ser
clicado no boto [...] presente ao final da linha Identidade. Ao clicar neste boto, a imagem abaixo
mostrada.


Figura 6 Configuraes da conta do usurio de um Pool de Aplicativos
Na imagem indicada acima, deve ser selecionada a opo Conta Personalizada e clicar no boto
Definir. A tela abaixo ser exibida para que seja parametrizado o usurio a ser utilizado para instanciar o
Pool de Aplicativos:

Figura 7 Definir um usurio para o Pool de Aplicativos
Na tela Definir Credenciais (figura 7), dever ser definido um usurio que tenha permisso
irrestrita Internet. Deve ser sempre definido o usurio com seu devido domnio frente no padro:
DOMNIO\usurio. Importante: o domnio sempre dever ser digitado em letra maiscula.
Observao importante: caso no seja utilizado domnio no ambiente onde est instalado o
Documentos Eletrnicos, deve-se definir as credenciais substituindo o DOMNIO por . (ponto). Exemplo:
.\administrador.
10
Aps o trmino destas parametrizaes, deve ser confirmada a parametrizao em cada tela que foi
exibida, clicando em OK em cada tela. Por fim, ser exibida novamente a tela indicada na figura 3.

3.3 Alterando parametrizaes do aplicativo Monitor do Documentos Eletrnicos no IIS
Alm das parametrizaes necessrias a serem efetuadas no Pool de Aplicativos do IIS, so
necessrias alteraes no aplicativo Monitor do Documentos Eletrnicos no IIS. Seguem abaixo as
parametrizaes necessrias.


Figura 8 Tela de parametrizao do aplicativo Monitor do Documentos Eletrnicos no IIS
(1) Monitor: para visualizar informaes e alterar parametrizaes do aplicativo Monitor do
Documentos Eletrnicos no IIS, necessrio que seja acessado o aplicativo Monitor, que fica abaixo do
Default Web Site no IIS. Clicando em Monitor as opes sero mostradas na tela

(2) Configuraes bsicas: para que possam ser alteradas as credenciais do usurio que instancia
o aplicativo Monitor do Documentos Eletrnicos no IIS deve-se acessar a opo Configuraes Bsicas
(lado direito da tela) aps ter sido clicado em Monitor (lado esquerdo da tela)

Deve-se, ento, clicar em Configuraes Bsicas. A tela abaixo ser mostrada:


Figura 9 Tela de Configuraes Bsicas do aplicativo Monitor do Documentos Eletrnicos no IIS
11
Na tela indicada na figura 9 dever ser clicado no boto Conectar Como. A tela abaixo ser
exibida:


Figura 10 Tela de definio do usurio utilizado para instanciar o aplicativo Monitor do Documentos Eletrnicos
Na tela indicada na figura 10, dever ser clicado na opo Usurio especfico e clicado no boto
Definir. A tela abaixo ser exibida


Figura 11 Definir um usurio para o aplicativo Monitor do Documentos Eletrnicos
Na tela Definir Credenciais (figura 11), dever ser definido um usurio que tenha permisso
irrestrita Internet e que deve ser o mesmo usurio parametrizado no Pool de Aplicativos utilizado pelo
Documentos Eletrnicos (tpico 2.2). Deve ser sempre definido o usurio com seu devido domnio frente
no padro: DOMNIO\usurio. Importante: o domnio sempre dever ser digitado em letra maiscula.
Observao importante: caso no seja utilizado domnio no ambiente onde est instalado o
Documentos Eletrnicos, deve-se definir as credenciais substituindo o DOMNIO por . (ponto). Exemplo:
.\administrador.
Aps o trmino destas parametrizaes, deve ser confirmada a parametrizao na tela Definir
Credenciais (figura 9) e tela Conectar como (figura 9) que foram exibidas, clicando em OK em cada
tela. Ser, ento, exibida novamente a tela indicada na figura 8, onde se deve clicar no boto Testar
Configuraes. Aos ser clicado em Testar Configuraes, a tela abaixo ser exibida:

12

Figura 12 Teste de conexo com credenciais definidas para o aplicativo Monitor do Documentos Eletrnicos
Na tela indicada na figura 12 so mostrados os testes efetuados pelo IIS para conexo ao aplicativo
Monitor do Documentos Eletrnicos com as credenciais inseridas na parametrizao do Pool de Aplicativos
e na parametrizao do aplicativo Monitor do Documentos Eletrnicos. Caso algum dos itens indicados
nesta tela no fique com indicativo Verde indicando que as credenciais foram consideradas vlidas e o
acesso ao caminho fsico do Monitor est disponvel, as parametrizaes indicadas em todo o tpico 2 deste
guia devem ser efetuados novamente com as credenciais de um usurio que seja realmente administrador
da rede/domnio/servidor.
Ao final da execuo dos testes de conexo, tendo sido eles realizados com sucesso, basta clicar
em Fechar na tela Testar Conexo (figura 12) e em OK na tela Editar aplicativo (figura 9) para
voltar tela inicial do Gerenciador do IIS.

3.4 Reiniciando o servio do IIS para efetivar as alteraes
Aps todas as alteraes efetuadas, necessrio que o servio do IIS no servidor seja parado e
iniciado novamente para que todas as configuraes tenham efeito. Para isso, basta acessar a pgina inicial
do IIS novamente, clicar primeiramente no boto Parar e posteriormente no boto Iniciar.


13
Figura 13 Pgina inicial do Gerenciador do IIS indicando os botes Iniciar e Parar
Na tela indicada na figura 13, deve-se selecionar o Servidor do IIS que est sendo configurado (lado
esquerdo da tela), para depois clicar no boto Parar e em seguida em Iniciar (botes que ficam no lado
direito da tela)

3.5 Como identificar qual Pool de Aplicativos do IIS o Monitor do Documentos Eletrnicos est
utilizando e como alter-lo, se necessrio.
Em alguns casos, no se tem certeza qual o Pool de Aplicativos que est sendo utilizado pelo
Monitor do Documentos Eletrnicos no IIS. Tambm, em outros casos, necessrio efetuar a alterao do
Pool de Aplicativos utilizado pelo Monitor para que o mesmo seja executado em um Pool de Aplicativos que
tenha todas as parametrizaes adequadas para a execuo de todos os processos do Monitor
corretamente.


Figura 14 Indicativo de como visualizar o Pool de Aplicativos utilizado pelo Monitor do Documentos Eletrnicos e
alter-lo.
Na figura 14 est sendo exibido o caminho a ser acessado para acessar as Configuraes
Avanadas do aplicativo Monitor do Documentos Eletrnicos. Acessado estas configuraes possvel
identificar qual o Pool de Aplicativos que est sendo utilizado pelo Monitor do Documentos Eletrnicos (1) e
se necessrio, ao clicar no boto [...] da linha Pool de Aplicativos, ser exibida uma tela onde possvel
alterar o Pool de Aplicativos utilizado pelo Monitor do Documentos Eletrnicos (2).
Observao: se for efetuada alguma alterao referente a qual Pool de Aplicativos o Monitor ir
utilizar, aps ter sido efetuada tal alterao, o servio do IIS dever ser reiniciado (procedimentos
informados no tpico 3.4 deste guia).
14


3.6 Informaes adicionais sobre parametrizaes do IIS e parametrizaes do servidor que podem
ter impacto nas funcionalidades do Monitor do Documentos Eletrnicos
Em alguns casos, quando utilizado Windows Server 2008 ou Windows Server 2012 no servidor
onde est instalado o Monitor do Documentos Eletrnicos necessrio efetuar configuraes especficas
referentes ao navegador Internet Explorer. No console de gerenciamento do servidor ("Server manager),
deve ser acessada a opo Configure IE ESC", e manter as opes desabilitadas para usurios e
administradores, conforme imagem abaixo:


Figura 15 Pgina inicial do Gerenciador do Servidor (Server manager)

15

Figura 16 Configuraes do IE ESC que devem ser desativadas

3.7 Problemas comuns no Documentos Eletrnicos causados pela no parametrizao correta do IIS
A no parametrizao correta do IIS do servidor onde est instalado o Monitor do Documentos
Eletrnicos poder acarretar em diversos problemas na utilizao de funcionalidades do Monitor. Seguem
exemplos:
- Apresentao dos erros "Senha incorreta ou arquivo invlido, verifique os dados informados",
Cadeia do certificado invlido. Verifique a cadeia de certificados", "No foi possvel salvar os dados
do certificado A1: An internal error occurred", "No foi possvel salvar os dados do certificado A1:
Erro Interno" e "Problemas ao salvar informaes do certificado A1" no momento da parametrizao do
certificado digital da filial no Monitor do Documentos Eletrnicos;
- Ao atualizar a situao de documentos eletrnicos no Monitor do Documentos Eletrnicos
(Atualizar NF-e, Atualizar CT-e, Atualizar CC-e, Consultar NF-e, Consultar CT-e, Atualizar MDF-e,
Atualizar NFS-e, boto Cdigo de Verificao da rotina de NFS-e), as seguintes mensagens ocorrem no
Monitor do Documentos Eletrnicos: Ocorreu um erro ao atualizar o Status da Nota: Solicitao foi
anulada: No foi possvel criar um canal seguro para SSL/TLS, No foi possvel atualizar a situao
do documento. A solicitao foi anulada: No foi possvel criar um canal seguro para SSL/TLS.; e no
Log do Monitor/Documentos Eletrnicos a seguinte mensagem apresentada "Object reference not set to
an instance of an object.".
- No momento da parametrizao de campos no Monitor do Documentos Eletrnicos, como, por
exemplo, parmetros por municpio para NFS-e, o Documentos Eletrnicos no efetua o salvamento das
informaes. Quando clicado em Salvar na tela, a mensagem de que a configurao foi salva exibida,
mas se sair da tela do Monitor e entrar novamente, a configurao no teve xito.


16
4 Instalao do Certificado Digital para filiais no Documentos
Eletrnicos
A partir da verso 5.7.4.1 do Documentos Eletrnicos a instalao e atualizao do certificado digital
de cada filial no mais efetuada atravs do console MMC do Windows ou atravs do Configurador do
Documentos Eletrnicos. A instalao ou atualizao do certificado digital efetuada diretamente atravs do
Monitor do Documentos Eletrnicos.
Seguem abaixo os passos para que seja efetuada a parametrizao do certificado digital para uma
filial no Documentos Eletrnicos.
4.1 Parametrizar um certificado digital para filial no Documentos Eletrnicos
Para parametrizar o certificado digital da filial, deve ser acessada a tela Configurao > Filial > aba
Filial > Opo Configurar certificado do Monitor do Documentos Eletrnicos.


Figura 17 Tela de parametrizao da filial no Documentos Eletrnicos
Em seguida, ao clicar na opo Configurar certificado, ser exibida a tela abaixo.
17

Figura 18 Tela de parametrizao do certificado digital da filial no Documentos Eletrnicos
Esta tela possui os seguintes campos:
- Certificado digital: neste campo ser mostrado o Subject do certificado digital da filial que teve o
certificado digital instalado da forma antiga, ou seja, quando o certificado digital foi instalado atravs do
console MMC do Windows ou pelo Configurador do Documentos Eletrnicos. Caso este campo esteja
preenchido, isto indica que o certificado digital que est sendo utilizado pela filial ainda o certificado digital
instalado no Servidor, e no no banco de dados do Documentos Eletrnicos. Se este campo no estiver
preenchido, isto indica que o certificado digital da filial no est instalado, ou o Documentos Eletrnicos j
est utilizando o certificado digital instalado no banco de dados (verses superiores verso 5.7.4.1).
- Arquivo do certificado (.pfx): campo onde deve ser indicado o caminho que est armazenado o
arquivo do certificado digital a ser utilizado para a filial que est sendo parametrizada
- Senha do certificado: campo onde deve ser digitada a senha do certificado digital

No caso de instalao/atualizao do certificado digital, aps ter sido definido o certificado digital a
ser utilizado e digitada a senha do mesmo, deve-se clicar no boto Salvar. Ao clicar neste boto, a tela de
parametrizao do certificado digital ser imediatamente fechada, retornando a tela de parametrizao da
filial.

IMPORTANTE: aps efetuar a parametrizao do certificado digital da filial, necessrio clicar no
boto Salvar da tela de cadastramento da Filial no Documentos Eletrnicos (Monitor Documentos
Eletrnicos > Configurao > Filial > aba Filial > Boto Salvar)
4.2 Confirmar a instalao correta do certificado digital para a filial
Aps efetuar a parametrizao do certificado digital da filial, necessrio verificar se o certificado foi
instalado corretamente no Documentos Eletrnicos. Para isso, deve ser acessada a tela indicada no tpico
18
4.1 figura 18, e clicar no boto Detalhes do certificado. Ao clicar neste boto, a seguinte tela ser
exibida:


Figura 19 Tela informaes sobre o certificado digital da filial Parte 1


Figura 20 Tela informaes sobre o certificado digital da filial Parte 2
Na tela indicadas nas figuras 19 e 20 possvel verificar todas as informaes sobre o certificado
digital instalado para a filial. Conforme destacado na figura 20, existe um campo que indica se o
Documentos Eletrnicos conseguiu validar o certificado digital (campo Vlido). Conforme informao
presente no Ajuda do Documentos Eletrnicos: Ao cadastrar um certificado digital o sistema verifica se este
certificado vlido. Para isso, o usurio configurado no pool de aplicativo do IIS deve ter acesso internet.
Caso no seja possvel realizar a validao do certificado, ser exibida uma mensagem informando ao
usurio. Esse comportamento no impede o uso do certificado, porm no garantido que o certificado
esteja vlido e que ir funcionar corretamente.

19

Figura 21 Informativo que o certificado digital foi considerado invlido pelo Documentos Eletrnicos

4.3 Problemas comuns no Documentos Eletrnicos causados por problemas no certificado digital
A utilizao de um certificado digital invlido (vencido, por exemplo) ou a no parametrizao
correta de um certificado digital far com que os documentos eletrnicos no sejam encaminhados
SEFAZ/Prefeitura, ficando com situao de Validado(a) ou Recebido ERP no Monitor do Documentos
Eletrnicos.
No Log do Documentos Eletrnicos podero ser observados erros como os informados abaixo:
- System.Security.Cryptography.CryptographicException: Keyset does not exist
- System.Security.Cryptography.CryptographicException: O Conjunto de chaves no existe
- System.Security.Cryptography.CryptographicException: A chave de assinatura no est carregada.
- Erro ao enviar lote do estabelecimento: <CNPJ_FILIAL>. System.Net.WebException: Falha na
solicitao com status HTTP 403: Forbidden.
- Erro ao enviar lote do estabelecimento: <CNPJ_FILIAL>. System.Net.WebException: The request
filed with HTTP status 403: Forbidden

Observao: as situaes indicadas acima tambm esto registradas em nosso banco de solues.
A utilizao do banco de solues disponibilizado pela Senior agiliza a resolues de questes frequentes
encontradas em diversos clientes, possibilitando a resoluo rpida da situao atravs do Autoatendimento
do solicitante.

5 Logs do Documentos Eletrnicos Conceito e captura dos Logs
O Documentos Eletrnicos possui cinco logs diferentes onde so registradas informaes sobre os
processos efetuados pelas rotinas do Documentos Eletrnicos. Os logs so:

- Documentos Eletrnicos.log: o principal log do Documentos Eletrnicos. o log do servio
Senior Documentos Eletrnicos que instalado no Servidor do Documentos Eletrnicos. Este log
armazena informaes como, por exemplo, erros no envio de documentos eletrnicos para
20
SEFAZ/Prefeitura, erros de retorno de documentos eletrnicos para o ERP, erros de recebimento de
documentos eletrnicos, etc. Este Log deve ser sempre anexado nos chamados registrados para a
Senior em caso de necessidade de avaliao de alguma situao no Documentos Eletrnicos.

- Monitor.log: o log do aplicativo Monitor do Documentos Eletrnicos. Neste log so registrados
os erros e excees ocorridas nas rotinas do Monitor do Documentos Eletrnicos. Exemplo: ao tentar
visualizar um documento eletrnico no Monitor do Documentos Eletrnicos exibida uma mensagem de
erro na tela este erro ser registrado no log Monitor.log. Se um chamado for registrado para a Senior
referente problemas no Monitor, este Log deve ser encaminhado junto ao chamado.

- Configurador.log: o Log do aplicativo Configurador do Documentos Eletrnicos. Neste Log so
registradas informaes sobre a realizao dos processos presentes no Configurador e tambm
informaes sobre todo o processo de Instalao/Atualizao do Documentos Eletrnicos. Caso seja
necessrio ser avaliada alguma questo referente algum erro de instalao/atualizao do
Documentos Eletrnicos, deve ser encaminhado este Log para a Senior atravs de um chamado.

- PrintService.Log: o Log do servio Senior Documentos Eletrnicos PrintService. Neste log so
registradas informaes referente a execuo das rotinas do servio de impresso distribuda do
Documentos Eletrnicos, o PrintService. Se um chamado for registrado para a Senior referente
problemas de impresso automtica/distribuda onde utilizado o servio PrintService, este log
deve ser encaminhado junto ao chamado

- Importador.Log: o Log do aplicativo Importador do Documentos Eletrnicos. Neste log so
registradas informaes referente a execuo das rotinas de importao de documentos eletrnicos no
Documentos Eletrnicos. Se um chamado for registrado para a Senior referente problemas de
importao de documentos eletrnicos pelo aplicativo Importador, este log deve ser encaminhado
junto ao chamado


5.1 Procedimento para coleta dos Logs do Documentos Eletrnicos
Os logs do Documentos Eletrnicos so armazenados no diretrio de instalao do Documentos
Eletrnicos no servidor do Documentos Eletrnicos, na pasta Comum\Log. Exemplo: se o Documentos
Eletrnicos est instalado no diretrio C:\Senior\Documentos Eletrnicos (que o diretrio padro da
instalao), a pasta onde os Logs esto armazenados : C:\Senior\Sde\Comum\Log.

21

Figura 22 Visualizao da pasta onde so armazenados os Logs do Documentos Eletrnicos e os Logs do
Documentos Eletrnicos no Windows Explorer
Na figura 22 possvel verificar a pasta onde esto armazenados os Logs do Documentos
Eletrnicos e todos os Logs do Documentos Eletrnicos. Destacado em vermelho na figura 22 est a
coluna Data de modificao. Esta coluna est em destaque, pois, clicando no nome da coluna possvel
ordenar os Logs armazenados por sua data de modificao, facilitando a definio de quais os Logs so os
Logs mais atuais.
possvel observar na figura 22 que existem Logs que possuem informaes adicionais em seu
nome. Exemplo: Documentos Eletrnicos.log_2014_01_03_04. Isso ocorre porque o Documentos
Eletrnicos altera o arquivo de Log a ser utilizado para armazenar as informaes quando este arquivo
atinge determinado tamanho. Esta troca ocorre de hora em hora, dependendo do tamanho do arquivo de
Log j existente.
Ao efetuar a troca do arquivo de Log, o Documentos Eletrnicos renomeia o arquivo de Log anterior,
definindo o ano, o ms, e o dia de quando o Log foi criado, adicionado um nmero sequencial (no exemplo
em questo o nmero 04) ao final do nome do arquivo, indicando que o 4 log do dia 03/01/2014 do log
Documentos Eletrnicos.Log.
Neste caso, quando for solicitado o envio para a Senior dos Logs atuais do Documentos Eletrnicos,
deve ser efetuada a ordenao dos Logs pela Data de Modificao, enviando para a Senior cada um dos
Logs atuais. Dica: os Logs que esto sendo registrados atualmente pelo Documentos Eletrnicos nunca
tero o indicativo de data ao final do nome. Eles sempre possuiro somente seus nomes originais
(Documentos Eletrnicos.Log, Monitor.Log, PrintService.Log, Configurador.Log).
Se for solicitado Log de uma determinada data/hora, os Logs devero ser ordenados pela Data de
Modificao, procurando o Log utilizado pelo Documentos Eletrnicos na data/hora solicitada.

22
Dica: quando um Log est sendo utilizado pelo Documentos Eletrnicos no possvel mov-lo e
nem compacta-lo. Neste caso, o Log deve ser copiado para outro local para ento ser compactado e
anexado ao chamado no 0800net.

5.2 Alterao do nvel de gerao de Logs do Documentos Eletrnicos
Por padro, os nveis de Log do Documentos Eletrnicos so definidos como WARN, que indica
que o Documentos Eletrnicos ir registrar nos Logs informaes sobre os erros ocorridos nas rotinas e
avisos padres do sistema.
Em alguns momentos, para verificaes especficas, necessria a alterao do nvel de Log de
algum aplicativo/servio do Documentos Eletrnicos. Para efetuar esta alterao, deve ser acessado o
Configurador do Documentos Eletrnicos, alterando a opo Nvel de log para cada um dos
servios/aplicativos do Documentos Eletrnicos.


Figura 23 Alterao de nvel de log dos servios/aplicaes do Documentos Eletrnicos no Configurador
Aps a alterao do nvel de Log de um servio/aplicao do Documentos Eletrnicos, necessrio
efetuar a reinicializao do mesmo para que as parametrizaes novas tenham efeito.

O nvel de log mais utilizado para busca de informaes mais detalhadas de processos executados
pelo Documentos Eletrnicos o nvel DEBUG. No entanto, a utilizao do Log neste nvel acarretar na
criao de um arquivo de Log extremamente grande. Neste caso, expressamente recomendvel que
este nvel de Log seja utilizado apenas quando h necessidade de ser efetuada alguma verificao
especfica, sendo retornado ao nvel de log WARN quando a verificao estiver terminada.

23
5.3 Dica como saber qual o diretrio onde o Documentos Eletrnicos est instalado?
Em algumas situaes, quando no se tem certeza em qual diretrio o Documentos Eletrnicos est
instalado, necessrio efetuar algumas verificaes para descobrir onde o mesmo est instalado. Abaixo
seguem duas dicas para descobrir em qual diretrio o Documentos Eletrnicos est instalado no Servidor.
IMPORTANTE: pr-requisito que, no mnimo, tenha-se conhecimento em qual servidor o
Documentos Eletrnicos est instalado.

- Primeira dica: verificar para qual diretrio o atalho do Configurador do Documentos Eletrnicos no
Menu Iniciar do Windows do Servidor est apontando.


Figura 24 Propriedades do atalho do Configurador do Documentos Eletrnicos
Na figura 24 possvel identificar no campo Destino da tela Propriedades de Configurador o
caminho onde o Documentos Eletrnicos est instalado no Servidor.

- Segunda dica: verificar em qual diretrio os servio Senior Documentos Eletrnicos est
instalado no servidor. Para isso, deve-se acessar o console de administrao de servios do servidor
(services.msc). (Menu Iniciar > Executar > digitar services.msc).

24

Figura 25 Propriedades do servio Senior Documentos Eletrnicos no console de Servios do Windows
Na figura 25 possvel identificar no campo Caminho do Executvel da tela Propriedades de
Senior Documentos Eletrnicos o caminho onde o Documentos Eletrnicos est instalado no Servidor.

5.4 Dica disponibilizao dos Logs do Documentos Eletrnicos para usurios e possibilidade de
reinicio de servios remotamente
Em diversos casos, necessrio que o usurio que utiliza o sistema Documentos Eletrnicos tenha
acesso aos Logs do sistema Documentos Eletrnicos (que so armazenados no servidor) para anlise de
alguma questo, ou para que sejam encaminhados atravs de um chamado para o Suporte da Senior. Da
mesma forma, em vrias situaes necessrio que seja verificado se os servios esto ativos, ou ento,
at mesmo, reinici-los.
Como, na maioria das situaes, os usurios no possuem acesso ao servidor onde o Documentos
Eletrnicos est instalado, seguem duas dicas que podem ser seguidas para solucionar esta questo no
ambiente de cada cliente:
- Verificao de estado e reinicializao de servios: Criar um atalho na mquina do usurio
(geralmente o faturista) para acesso ao Configurador do Documentos Eletrnicos, pois dessa forma, sempre
que for solicitado para que ele reinicie os servios do Documentos Eletrnicos ou verifique o status dos
mesmos (se esto iniciados ou parados), ele no precisar entrar em contato com um terceiro, por exemplo,
para solicitar o acesso ao servidor do Documentos Eletrnicos para verificar estas informaes. O
executvel do Configurador do Documentos Eletrnicos possui o nome de
Senior.SapiensNfe.Configurador.exe e est armazenado na pasta Configurador no diretrio de instalao
do Documentos Eletrnicos no servidor. Exemplo:
C:\Senior\Sde\Configurador\Senior.SapiensNfe.Configurador.exe.
- Compartilhamento da pasta de Logs do Documentos Eletrnicos: Compartilhar a pasta de
logs do Documentos Eletrnicos, e tambm criar um atalho na mquina dos usurios que utilizam o sistema
25
Documentos Eletrnicos. Com isso os usurios que precisam verificar os Logs ou encaminh-los para
Senior para anlise, podem efetuar estes procedimentos sem necessidade de interveno de uma terceira
pessoa. Para informaes sobre o diretrio onde o Documentos Eletrnicos armazena os Logs, verifique o
tpico 5 deste guia.
Observao: as parametrizaes necessrias para compartilhamento de pastas/diretrios na rede,
bem como criao de atalhos nos computadores dos usurios do sistema so de responsabilidade dos
responsveis pela infraestrutura do cliente.

6 Gerando LOGs XML de NFS-e
Todos os arquivos XML de NFS-e (Nota Fiscal Eletrnica de Servios) gerados pelo ERP Senior e
integrados no Documentos Eletrnicos esto no padro ABRASF 1.0. No entanto, as prefeituras com as
quais o sistema Documentos Eletrnicos se comunica para enviar as NFS-e nem sempre seguem este
padro. Nestes casos, o Documentos Eletrnicos o responsvel por efetuar uma converso das
informaes encaminhadas pelo ERP atravs do arquivo XML para o padro de XML encaminhado para a
Prefeitura.
Em diversas ocasies necessrio identificar exatamente as informaes que o Documentos
Eletrnicos est encaminhando em cada TAG do arquivo XML enviado para a Prefeitura, para identificar
eventuais problemas. Para isso o Documentos Eletrnicos possui a funcionalidade de gerao de Log XML
de NFS-e.
Esta funcionalidade permite que o Documentos Eletrnicos grave em seu prprio banco de dados
todos os arquivos XML oriundos da comunicao com a Prefeitura para cada NFS-e, tanto os arquivos
XMLs encaminhados pelo Documentos Eletrnicos para a Prefeitura, quanto os arquivos XMLs retornados
pela Prefeitura para o Documentos Eletrnicos.
Para que sejam gerados os Logs XML de NFS-e, no Configurador do Documentos Eletrnicos deve
ser ativada a opo de gravao de Logs XML. Para ativar esta opo basta clicar no boto "Play" na cor
verde que existe ao lado do Listbox do Nvel de Log do Servio "Senior Documentos Eletrnicos". Quando o
Log XML est ativo, este boto fica como um "Stop" na cor azul. A figura 26 mostra o comparativo de
quando a funcionalidade est ativa e quando ela est inativa.

26

Figura 26 Indicativo referente ativao da funcionalidade de Log XML do Documentos Eletrnicos para NFS-e
Aps ser ativado o Log XML e ter havido algum envio/retorno de informao para/de alguma
Prefeitura, o Log XML desta informao ficar disponvel na tela "NFS-e > Emisso > Boto Eventos". Na
tela de eventos de cada NFS-e haver um boto "Log XML". Na tela que ser aberta ao clicar neste boto
sero mostrados os Logs XML da comunicao entre o Documentos Eletrnicos e a Prefeitura.


Figura 27 Tela de Eventos de NFS-e onde, no canto superior direito, possvel identificar a boto Log Xml.
Aps ser clicado no boto Log XML, ser mostrada ao usurio uma nova tela com todos os Logs
XML registrados pelo Documentos Eletrnicos para a NFS-e selecionada. Nesta tela o usurio poder
visualizar cada um dos Logs XML (selecionando cada registro na grid), ou efetuar o Download de cada Log
XML, selecionando o boto Download ao lado de cada registro. Caso nenhum Log XML seja registrado
para uma NFS-e, a mensagem Nenhum registro encontrado ser exibida.
27

Observaes:
- O Documentos Eletrnicos s gravar Logs XML a partir do momento que esta funcionalidade foi
ativada no Configurador. Se uma NFS-e foi enviada para a Prefeitura antes da ativao dos Logs XMLs, no
ser possvel verificar o Log XML desta NFS-e. Se uma NFS-e for rejeitada pela Prefeitura, os Logz XML
forem ativados, e a NFS-e for reenviada, o Documentos Eletrnicos gravar os Logs XML do reenvio da
NFS-e normalmente.
- O Documentos Eletrnicos armazena vrios Logs XML (envio da NFS-e, consulta do lote, retorno
da consulta do lote, consulta da NFS-e, ...). Se a necessidade for enviar para o Suporte da Prefeitura o XML
enviado pelo Documentos Eletrnicos para a Prefeitura e que foi rejeitado (para descobrir o motivo pelo qual
houve a rejeio), dever ser encaminhado o XML correspondente ao envio da NFS-e para a Prefeitura.
Lembrando que o XML gerado pelo ERP no o XML enviado pelo Documentos Eletrnicos para a
Prefeitura (o XML gerado pelo ERP convertido pelo Documentos Eletrnicos para um XML no
padro da Prefeitura).

Importante: a funcionalidade de gerao de Log XML existe apenas para NFS-e, no entanto, caso
haja necessidade de verificar exatamente o arquivo XML enviado pelo Documentos Eletrnicos para a
SEFAZ para outros documentos eletrnicos (NF-e, CT-e, MDF-e, CC-e, Manifestao de Destinatrio, ...),
dever ser parametrizado o nvel de Log do servio Senior Documentos Eletrnicos do Documentos
Eletrnicos, atravs do Configurador, para DEBUG. Aps o nvel de Log ter sido alterado, quando um
documento eletrnico for enviado pelo Documentos Eletrnicos para a SEFAZ, no Log ser possvel
capturar o exato XML enviado pelo Documentos Eletrnicos, bem como capturar o arquivo XML retornado
pela SEFAZ para cada consulta/retorno realizado. Para maiores informaes de como parametrizar o nvel
de Log no Documentos Eletrnicos, verifique o tpico 5.2 deste guia.

7 Como trocar a proprietria do Documentos Eletrnicos
O arquivo da proprietria do Documentos Eletrnicos pode ser distribudo pela Senior com dois
nomes: SapiensNfe.prop ou Senior.prop. O Documentos Eletrnicos est apto a realizar a leitura da
proprietria apenas com estes dois nomes, no entanto, no diretrio onde fica armazenada a proprietria no
pode haver um arquivo com nome SapiensNfe.prop e outro arquivo de nome Senior.prop. Deve haver s
um arquivo de proprietria neste diretrio, independente se o nome SapiensNfe.prop ou Senior.prop.
Para efetuar a troca da proprietria do Documentos Eletrnicos, ou at mesmo efetuar a instalao
da primeira proprietria do sistema Documentos Eletrnicos, dever ser efetuada a cpia do arquivo
SapiensNfe.prop ou do arquivo Senior.prop para a pasta "Comum", localizado no diretrio Raiz da
Instalao do Documentos Eletrnicos, no servidor do Documentos Eletrnicos. Exemplo:
C:\Senior\Documentos Eletrnicos\Comum.

28

Figura 28 Indicativo de onde a proprietria do Documentos Eletrnicos fica armazenada no diretrio padro da
instalao
Ao copiar o arquivo da nova proprietria para a pasta Comum, se j houver um arquivo de
proprietria nesta pasta, ser solicitada confirmao se o mesmo dever ser substitudo. Indicamos que seja
sempre efetuado backup da proprietria antiga, caso haja uma.
Aps ter sido efetuada a cpia do arquivo da proprietria para a pasta Comum, dever ser
acessado o Monitor do Documentos Eletrnicos no seguinte caminho: Configurao > Proprietria.


Figura 29 Tela de informaes da Proprietria do Documentos Eletrnicos
Na tela indicada na figura 29, dever ser clicado no boto presente no canto superior direito da
tela. Pressionando este boto ser efetuada a leitura da proprietria do Documentos Eletrnicos pelo
Monitor do Documentos Eletrnicos, habilitando as funcionalidades do Documentos Eletrnicos liberadas na
proprietria. No entanto, para que os servios do Documentos Eletrnicos reconheam a nova proprietria
tambm, todos eles devem ser obrigatoriamente reiniciados.

29

Figura 30 Indicao das funcionalidades que foram liberadas na proprietria para a filial Senior Sistemas.
IMPORTANTE: proprietrias geradas pela Senior para verses 5.8.3.15 ou anteriores so
compatveis com Documentos Eletrnicos verso 5.8.4.1 ou superiores. No entanto, proprietrias geradas
pela Senior para verses 5.8.4.1 ou superiores so incompatveis com verses 5.8.3.15 ou anteriores.

8 Informaes sobre status eletrnicos de documentos fiscais
(tarefa 346394)
Um dos problemas mais comuns que ocorrem na integrao ERP Senior x Documentos Eletrnicos
a impossibilidade de o Documentos Eletrnicos encaminhar ao ERP um retorno referente ao status do
documento eletrnico devido ao status de documento eletrnico no ERP no permitir retorno.
Abaixo se apresenta uma planilha com todos os status de documentos eletrnicos presentes no
ERP Senior. Nesta planilha possvel identificar quais documentos eletrnicos utilizam cada status, se o
status um status final ou no e quais os status que podem ou no receber um retorno.
Exemplo: o status 3-Autorizado um status utilizado por todos os documentos eletrnicos; ele
um status final (onde o documento eletrnico no deve mais ser alterado); ele um status que no aceita
retorno (ou seja, documentos com status de 3-Autorizado no podem mais receber retorno via SeniorSID
ou WebServices).

Cd.
Status
Descrio Status Aceita Retorno
Status
Final
Tipo de documento eletrnico
NF-e CC-e MF-e NFS-e CT-e MDF-e
1 No Enviada No No X X X X X X
2 Enviada 3, 4, 5 ou 10 No X X X X X X
3 Autorizada No Sim X X X X X X
4 Rejeitada S para NF-e: 3 No X X X X X X
5 Denegada No Sim X X X
6 Solicitado Inutilizao 8 ou 12 No X X
7 Solicitado Cancelamento 9 ou 11 No X X X X
30
8 Inutilizada No Sim X X
9 Cancelada No Sim X X X X
10 Erro Gerao No No X X X X X
11 Erro Solicitao Cancelamento No No X X X X
12 Erro Solicitao Inutilizao No No X X
13 Pendente de cancelamento Situao interna no utilizada para aes que envolvem o usurio
14 Solicitado Encerramento (MDF-e) Sim No X
15 Encerrado (MDF-e) No Sim X
Tabela 1 Situaes de documentos eletrnicos
Importante: em caso de necessidade, para algum procedimento solicitado pelo Suporte, de
alterao manual do status de algum documento eletrnico no ERP, o mesmo deve ser efetuado atravs de
utilizao de AesSID (via SeniorSID DepuraSID) ou atravs de chamado de WebService (via
MCDebug). Alteraes em status eletrnicos de documentos eletrnicos diretamente na base de dados do
ERP podero causar inconsistncias em informaes do documento eletrnico, e devem ser efetuadas
somente com acompanhamento da Senior.

8.1 Diferena entre status do documento e status do documento eletrnico no ERP
Primeiramente precisamos pontuar que status significa situao, sendo assim, quando falamos em
status de um documento no ERP estamos falando sobre a situao na qual ele se encontra no ERP.
O ERP Senior possui indicao de dois status para um documento eletrnico: o status do
documento em si (que um status interno do ERP) e o status do documento eletrnico (que o status do
documento eletrnico emitido pelo ERP).
O ERP Senior sempre controlar os dois status de um documento eletrnico, sendo que os mesmos
podem variar de acordo com as operaes que esto sendo realizadas pelo sistema.
Abaixo segue uma tabela que indica a relao entre os status do documento no ERP e os status do
documento eletrnico.

Cd.
Status
Descrio Status Eletrnico
Status do documento no ERP
1 -Digitada 2 Fechada 3 -Cancelada
1 No Enviada X X
2 Enviada X
3 Autorizada X
4 Rejeitada X
5 Denegada X
6 Solicitado Inutilizao X
7 Solicitado Cancelamento X
8 Inutilizada X
9 Cancelada X
10 Erro Gerao X
11 Erro Solicitao Cancelamento X
12 Erro Solicitao Inutilizao X
13 Pendente de cancelamento
14 Solicitado Encerramento (MDF-e) X
31
Tabela 2 Relao entre status de documento no ERP e status eletrnico
Atravs da verificao da tabela 2 possvel concluir, por exemplo, que um documento eletrnico que
possui status de 1-Digitada no poder ter um status eletrnico diferente de 1-No Enviada. Da mesma
forma, um documento eletrnico que possui status de 3-Cancelada no poder ter status eletrnico
diferente de 5-Denegada, 6-Solicitado Inutilizao, 7-Solicitado Cancelamento, 8-Inutilizada, 9-
Cancelada, 11-Erro Solicitao Cancelamento e 12-Erro Solicitao Inutilizao.

Observao: os status de documentos em si 4 - Documento fiscal emitido (sada) e 5 -
Aguardando fechamento (ps-venda) no esto sendo mostrados na tabela 2 pois no possuem relao
com rotinas de documentos eletrnicos (so status internos do ERP para controle de entrada e sada via
balana).

8.2 Consulta de status e histrico de documentos eletrnicos no ERP
O ERP Senior disponibiliza duas telas que so muito utilizadas para consulta de status de
documentos eletrnicos e tambm o histrico de documentos eletrnicos.

F141CNE_RFNF - Mercado / Gesto de Faturamento e Outras Sadas / Notas Fiscais de Sada
/ Consultas / Documentos eletrnicos


Figura 31 Tela F141CNE Consulta de Documentos Eletrnicos
15 Encerrado (MDF-e) X
32
A tela F141CNE do ERP fornecer informaes sobre o status atual de um documento eletrnico
(NF-e, NFS-e e CT-e), no momento que o mesmo for consultado. A tela fornece diversos filtros para que
seja possvel filtrar documentos especficos. Nesta, por padro, so mostrados os campos que indicam o
status do documento internamente no ERP e o status do documento eletrnico em questo.
Na figura 31 podemos observar 4 campos grifados:
- Sit.: campo que informa o cdigo da situao do documento no ERP (situao interna do
documento)
- Descrio (Sit.): campo que informa a descrio do cdigo da situao do documento no ERP
(situao interna do documento)
- Situao NF-e: campo que informa o cdigo da situao eletrnica do documento no ERP. Aps
todo o processo de emisso de um documento ter sido finalizado, o status eletrnico do documento no ERP
deve ficar igual ao status eletrnico armazenado na SEFAZ para este mesmo documento.
- Desc. Situao NF-e: campo que informa a descrio do cdigo da situao eletrnica do
documento no ERP.

F141HDE_RFNF - Mercado / Gesto de Faturamento e Outras Sadas / Notas Fiscais de Sada
/ Consultas / Histrico de Documentos Eletrnicos


Figura 32 Tela F141HDE Histrico de Documentos Eletrnicos
A tela F141HDE do ERP fornecer informaes sobre o histrico de um documento eletrnico (NF-
e, NFS-e e CT-e). A tela fornece diversos filtros para que seja possvel filtrar documentos especficos.
A consulta dos documentos eletrnicos nesta tela de extrema importncia para avaliar todos os
status que o documento eletrnico assumiu, sendo informada a data e hora que o status do documento
eletrnico foi alterado, como tambm o usurio responsvel pela alterao.
A cada registro informado na tela possvel identificar o status eletrnico anterior do documento e o
status eletrnico para o qual o documento foi alterado.
33
No rodap desta tela tambm possvel verificar a chave eletrnica atual do documento eletrnico.
Observao: possvel selecionar a chave eletrnica e copi-la, caso haja necessidade de consulta da
chave na SEFAZ, por exemplo.

9 Efetuando retorno manual de documento eletrnico atravs do
DepuraSID ou MCDebug
Em algumas determinadas situaes, necessria a execuo de testes de retorno de status de
documentos eletrnicos manualmente para o ERP para verificar se, manualmente, os status so retornados.
Estes testes geralmente so necessrios para avaliar se o problema do no retorno de status de documento
eletrnico para o ERP ocasionado por um problema no Documentos Eletrnicos ou por um problema no
ERP.
Observao: em caso de testes de envio de arquivo XML de documentos recebidos (NF-e e CT-e)
manualmente para o ERP, obrigatrio o uso do MCDebug, pois este tipo de integrao efetuada
somente via WebServices.
Dica: a seguir sero mostrados procedimentos bsicos de testes via MCDebug e DepuraSID para
testes especficos de retorno de documentos eletrnicos para o ERP manualmente. Caso haja necessidade
de maiores informaes sobre como funciona o SeniorSID ou os WebServices disponibilizados pelo ERP,
bem como as ferramentas disponveis para utilizao destas formas de integrao, a Universidade
Corporativa Senior possui treinamentos especficos para cada tecnologia de integrao.
Importante: todas as informaes enviadas abaixo levam em considerao a utilizao do Novo
Middleware Senior, onde as informaes de parametrizao esto reunidas no SeniorConfigCenter e a
utilizao do SeniorSID e WebServices depende da instalao e execuo correta do SeniorMiddleware.
Observao: SeniorSID e SapiensSID so a mesma forma de integrao, no entanto, atualmente, a
Senior vem padronizando o nome da tecnologia como SeniorSID.
Lembrando que, se o Documentos Eletrnicos utilizar SeniorSID para retorno de status de
documentos eletrnicos para o ERP, o teste a ser efetuado via DepuraSID. Se o Documentos Eletrnicos
utilizar WebServices para retorno de status de documentos eletrnicos para o ERP, o teste a ser efetuado
via MCDebug.
Para verificar como o Documentos Eletrnicos efetua o retorno dos status para o ERP, deve ser
acessada a tela Configurao > Filial > aba Filial > campo Forma integrao (Sada) do Monitor do
Documentos Eletrnicos. Esta parametrizao efetuada por filial, conforme figura 33.

34

Figura 33 Tela de parametrizao da forma de retornos de status utilizada pelo Documentos Eletrnicos para
cada filial

9.1 Testes de retorno via DepuraSID
O primeiro passo para comear o processo de testes de retorno manual via DepuraSID localizar o
arquivo executvel do DepuraSID. Este arquivo possui o nome de depurasid.exe, possui como cone a
imagem e fica armazenado na pasta de instalao do ERP Senior no servidor. Exemplo:
C:\Senior\Sapiens. Aps localizar o arquivo, o mesmo deve ser executado. Observao: a verso do
DepuraSID compatvel com o Novo Middleware Senior a verso 4.0 DepuraSID em verses anteriores
no so compatveis, sendo assim, observe na barra de ttulo do DepuraSID a verso do mesmo antes de
proceder com os testes.

35

Figura 34 Aplicativo DepuraSID aberto com exemplo de execuo de uma AoSID

(1) URL conector Web 5.0: deve ser definida a URL de conexo com o SeniorSID. Em caso de
dvidas de como encontrar esta URL, verifique o tpico 9.1.1 deste guia.

(2) Usurio sistema/senha sistema: devem ser digitadas as credenciais do usurio utilizado para
retorno do status de documentos eletrnicos do Documentos Eletrnicos para o ERP. Para que os testes
sejam efetuados com sucesso, deve ser utilizado o mesmo usurio parametrizado no Documentos
Eletrnicos em Configurao > Geral > aba Integrao > campo Usurio integrao ERP e campo Senha
integrao ERP no Monitor do Documentos Eletrnicos.

(3) Parmetros SID: neste campo devem ser digitadas as informaes da AoSID que deve ser
utilizada para teste. No caso de NF-e/CC-e a AoSID SID.NFV.ATUALIZARNFE, no caso de NFS-e a
AoSID SID.NFV.ATUALIZARNFSE e no caso de CT-e a AoSID SID.NFV.ATUALIZARCTE. Caso
existam dvidas sobre as AesSID e seus parmetros, o manual do SeniorSID deve ser consultado.

(4) Sada: neste campo so mostrados os dados de sada da conexo efetuada com o SeniorSID e
das AesSID digitadas no campo Parmetros SID e executadas. Toda AoSID que for executada
corretamente e no houver nenhum erro de comunicao ou qualquer outra consistncia do sistema trar
como retorno OK, tanto na resposta do servidor como na execuo da AoSID em si.

(5) Identificador de conexo: sempre que for clicado no boto Conectar, se todas as
informaes de conexo com o SeniorSID estiverem corretas (URL de conexo e credenciais de usurio), o
SeniorSID retornar um Identificador de conexo, que um nmero de 24 posies. Se por um acaso no
36
for retornado este ID de conexo e for exibida alguma mensagem de erro, isso indica que ou as informaes
de conexo esto incorretas, ou que o SeniorSID est inacessvel. Neste caso, as configuraes do
ambiente devero ser revistas, pois o Documentos Eletrnicos no conseguir retornar status de
documentos eletrnicos se o SeniorSID estiver inoperante (caso o Documentos Eletrnicos esteja
parametrizado para retorno via SeniorSID).

(6) Boto Conectar: boto que deve ser acionado assim que as informaes de conexo (URL e
credenciais de usurio) forem digitadas. Com isso, o DepuraSID efetuar a solicitao de conexo ao
SeniorSID. O boto Conectar deve ser acionado caso a sesso aberta pelo DepuraSID no SeniorSID
tenha expirado por inatividade.

(7) Boto Enviar: boto que deve ser acionado para enviar uma AoSID e seus parmetros
para o SeniorSID. A AoSID e os parmetros so definidos no campo Parmetros SID (3).

(8) Retorno da Execuo da AoSID: resultado da execuo da AoSID encaminhada ao
SeniorSID. O retorno OK aps a informao HTTP/1.1 200 indica que o servidor respondeu a requisio,
e o retorno OK na linha abaixo indica que a AoSID foi executada com sucesso. Caso haja algum erro na
execuo da AoSID por consistncias do prprio sistema (por exemplo, est sendo encaminhado um
retorno de 4-Rejeitada quando um documento eletrnico est com status de 3-Autorizada no ERP), o
segundo OK ir retornar um erro (usando o exemplo repassado anteriormente, o erro retornado seria
ERRO: No foi solicitado um retorno para esse documento eletrnico.).

(9) Configuraes de Proxy: parametrizao opcional para utilizao de Proxy para acesso ao
SeniorSID. O SeniorSID funciona baseado em protocolo HTTP, sendo assim, em alguns ambientes,
dependendo da parametrizao, necessrio utilizao de autenticao proxy para conexo ao SeniroSID.
Caso no ambiente a ser utilizado o DepuraSID esta autenticao necessria, estes parmetros devem ser
preenchidos (na maioria dos casos, no h necessidade de preenchimento).

Com todas as informaes em mos, para execuo de um retorno manual via DepuraSID, devero
ser seguidos os seguintes passos:
1) Abrir o aplicativo DepuraSID
2) Preencher a URL de conexo com SeniorSID e as credenciais do usurio a ser utilizado
3) Preencher dados de autenticao de proxy, se necessrios
4) Clicar no boto Conectar para efetuar a conexo
5) Dever se retornado no campo Sada o identificador de conexo
6) Digitar a AoSID e seus devidos parmetros no campo Parmetros SID
7) Clicar no boto Enviar para enviar a AoSID
8) Verificar o retorno enviado pelo SeniorSID para a AoSID utilizada

37
Dica: Para confirmar se o retorno foi enviado corretamente para o ERP, poder ser consultado o
status eletrnico do documento eletrnico nas telas F141CNE e F141HDE. Para maiores informaes, vide
tpico 8.2 deste guia.

Observao: juntamente com o DepuraSID, no mesmo diretrio de instalao do ERP Senior,
existe um arquivo de nome SapiensSID.doc que um manual com informaes sobre o SeniorSID e
todas as AesSID disponibilizadas pelo ERP para utilizao.

9.1.1 Encontrando a URL para efetuar o teste no DepuraSID.
Para que o teste via DepuraSID seja efetuado corretamente, preciso definir corretamente o campo
URL conector Web 5.0 do aplicativo DepuraSID com a URL utilizada no ambiente para a conexo com o
SeniorSID. Para encontrar esta URL, deve ser acessado o SeniorConfigCenter do ambiente ao qual deseja-
se testar o retorno manualmente. O SeniorConfigCenter fica armazenado no diretrio raiz da instalao dos
produtos da Senior no servidor. Exemplo: C:\Senior.


Figura 35 Caminho onde encontrar a URL do conector do SeniorSID no SeniorConfigCenter
Ao abrir o SeniorConfigCenter, deve-se acessar o caminho Middleware > Web 5.0 > Aplicativos.
Nesta tela, deve-se selecionar o aplicativo sapiensweb para que as informaes deste aplicativo sejam
mostradas (conforme figura 35). No campo URL de acesso ao conector ser mostrada a URL de acesso
ao SeniorSID.
A URL definida no campo URL de acesso ao conector no possui a palavra conector, no entanto,
ao utilizar o DepuraSID, deve ser definido a URL com a palavra conector ao final da URL.
38
Exemplo: se no campo URL de acesso ao conector est definida a URL
http://PCBNU00006:9090/sapiensweb/, a URL que deve ser informada no DepuraSID
http://PCBNU00006:9090/sapiensweb/conector.

Importante: no caso do Documentos Eletrnicos utilizar retorno via SeniorSID, a URL
parametrizada no SeniorConfigCenter e utilizada para testes no DepuraSID a mesma URL que deve ser
utilizada na tela Configurao > Geral > aba Integrao > campo URL Sapiens Web integrao ERP (SID)

Observao: juntamente com o DepuraSID, no mesmo diretrio de instalao do ERP Senior,
existe um arquivo de nome SapiensSID.doc que um manual com informaes sobre o SeniorSID e
todas as AesSID disponibilizadas pelo ERP para utilizao.

9.1.2 Exemplos de AesSID que podem ser utilizadas
Seguem abaixo exemplos de AesSID a serem utilizadas para retorno de NF-e, NFS-e e CT-e para
o ERP manualmente:

Retorno de Rejeio de NF-e para o ERP:
ACAO=SID.NFV.ATUALIZARNFE
ChvNel=<chave_NFe>
SitNel=4

Retorno de Autorizao de NF-e para o ERP
ACAO=SID.NFV.ATUALIZARNFE
ChvNel=<chave_NFe>
SitNel=3
NumPrt=<numero_protocolo_autorizao_NFe_sefaz>
DatHor=<data/hora_autorizao_NFe_Sefaz> Observao: deve estar no padro AAAA-MM-DDTHH:MM
Exemplo: 2013-01-14T11:13

Retorno de Erro Solicitao cancelamento de NF-e para o ERP
ACAO=SID.NFV.ATUALIZARNFE
ChvNel=<chave_NFe>
SitNel=11

Retorno de confirmao de cancelamento de NF-e para o ERP
ACAO=SID.NFV.ATUALIZARNFE
ChvNel=<chave_NFe>
SitNel=9
NumPrt=<numero_protocolo_cancelamento_NFe_sefaz>
DatHor=<data/hora_cancelamento_NFe_Sefaz> Observao: deve estar no padro AAAA-MM-DDTHH:MM
Exemplo: 2013-01-14T11:13
39

Retorno de Rejeio de NFS-e para o ERP:
ACAO=SID.NFV.ATUALIZARNFSE
ChvNel=<chave_NFSe>
SitNel=4

Retorno de Autorizao de NFS-e para o ERP
ACAO=SID.NFV.ATUALIZARNFSE
ChvNel=<chave_RPS>
SitNel=3
NumNfs=<numero_NFSe_Prefeitura>
CodVrf=<cdigo_verificao_NFSe_Prefeitura>
IndSuc=1
DatHor=<data/hora_autorizao_NFe_Sefaz> Observao: deve estar no padro AAAA-MM-DDTHH:MM
Exemplo: 2013-01-14T11:13

Retorno de Erro Solicitao cancelamento de NFS-e para o ERP
ACAO=SID.NFV.ATUALIZARNFSE
ChvNel=<chave_RPS>
SitNel=11

Retorno de confirmao de cancelamento de NFS-e para o ERP
ACAO=SID.NFV.ATUALIZARNFE
ChvNel=<chave_NFe>
SitNel=9
NumPrt=<numero_protocolo_cancelamento_NFe_Prefeitura>
DatHor=<data/hora_cancelamento_NFSe > Observao: deve estar no padro AAAA-MM-DDTHH:MM
Exemplo: 2013-01-14T11:13

Retorno de Rejeio de CT-e para o ERP:
ACAO=SID.NFV.ATUALIZARCTE
ChvNel=<chave_CTe>
SitNel=4

Retorno de Autorizao de CT-e para o ERP
ACAO=SID.NFV.ATUALIZARCTE
ChvNel=<chave_CTe>
SitNel=3
NumPrt=<numero_protocolo_autorizao_CTe_sefaz>
DatHor=<data/hora_autorizao_NFe_Sefaz> Observao: deve estar no padro AAAA-MM-DDTHH:MM
Exemplo: 2013-01-14T11:13
40

Retorno de Erro Solicitao cancelamento de CT-e para o ERP
ACAO=SID.NFV.ATUALIZARCTE
ChvNel=<chave_CTe>
SitNel=11

Retorno de confirmao de cancelamento de CT-e para o ERP
ACAO=SID.NFV.ATUALIZARCTE
ChvNel=<chave_CTe>
SitNel=3
TipDoe=5
NumPrt=<numero_protocolo_cancelamento_CTe_sefaz>
DatHor=<data/hora_cancelamento_CTe_Sefaz> Observao: deve estar no padro AAAA-MM-DDTHH:MM
Exemplo: 2013-01-14T11:13

9.1.3 Problemas comuns na utilizao do SeniorSID pelo Documentos Eletrnicos
Abaixo seguem erros comuns encontrados na comunicao do Documentos Eletrnicos com o ERP
via SeniorSID e os provveis motivos pelo qual o problema ocorre.

- Quando o GlassFish do ambiente est inativo:
* Log do Sde.log: ERROR Senior.SapiensNfe.Processos.Service.Nfe.RetornoNfeErp - Erro ao
retornar situao da nota ao ERP. System.Net.WebException: Impossvel conectar-se ao servidor
remoto ---> System.Net.Sockets.SocketException: Nenhuma conexo pde ser feita porque a
mquina de destino as recusou ativamente <Servidor>:<porta>

* Conexo via DepuraSID: ERROR: Socket Error # 10061 - Connection refused.

- Quando o servio SeniorMiddleware, Servio de Informao da Instalao ou Gerenciador
do Middleware esto parados ou inacessveis:
* Log do Sde.log e conexo via DepuraSID: ERROR Senior.SapiensNfe.Processos.Service
.Nfe.RetornoNfeErp - Crtica ao enviar retorno para o ERP: <html><body><script
language="JavaScript"> alert("No foi possvel conectar-se ao Middleware pela porta <porta> do
servidor <nome_servidor>. \n"+
"Para solucionar o problema, pode-se verificar o seguinte: \n"+
"1) O Middleware est em execuo no servidor <nome_servidor>.\n"+
"2) As configuraes do conector (servidor e porta) esto corretas.\n"+
"3) O servidor <ip_servidor> tem acesso ao servidor <nome_servidor>.\n"+
"4) As configuraes do firewall esto corretas (caso haja firewall ativo).\n"+"\n"+
"Detalhes tcnicos: \n"+
"Connection refused: connect"); history.back(); </script></body></html>

41
* Log do Sde.log e conexo via DepuraSID: ERROR Senior.SapiensNfe.Processos.Service.
Nfe.RetornoNfeErp - Crtica ao enviar retorno para o ERP: <html><body><script
language="JavaScript"> alert("Erro enviando tipo de cliente para o Middleware: Erro de comunicao
com servidor.\n"+"\n"+"Detalhes tcnicos: \n"+ "Erro de comunicao com servidor."); history.back();
</script></body></html>.

9.2 Testes de retorno de status ou envio de documentos eletrnicos para ERP via MCDebug
O primeiro passo para comear o processo de testes de retorno manual via modo MCDebug
localizar o arquivo executvel do ERP Senior. Este arquivo possui o nome de sapiens.exe e fica
armazenado na pasta de instalao do ERP Senior no servidor. Exemplo: C:\Senior\Sapiens.
Aps localizar o arquivo, deve-se criar um atalho para o mesmo. Aps a criao do atalho deve-se
entrar nas propriedades do mesmo e definir o parmetro -mcdebug ao final do caminho definido no campo
Destino.


Figura 36 Parmetro mcdebug que deve ser adicionado ao final das informaes do campo Destino.
Aps ser efetuada a alterao no campo Destino, conforme mostrado na figura 36, as
propriedades do atalho devem ser salvas, clicando no boto OK. Aps isso, o atalho dever ser
executado.
Ser aberta a tela inicial do ERP solicitando as credencias de um usurio do ERP (figura 36).
Devem ser digitadas as credenciais do usurio utilizado para retorno do status de documentos eletrnicos
do Documentos Eletrnicos para o ERP. Para que os testes sejam efetuados com sucesso, deve ser
utilizado o mesmo usurio parametrizado no Documentos Eletrnicos em Configurao > Geral > aba
42
Integrao > campo Usurio integrao ERP e campo Senha integrao ERP no Monitor do Documentos
Eletrnicos.


Figura 37 Tela de Autorizao de usurio do ERP Senior
Aps a digitao das credenciais do usurio na tela de autorizao do usurio, ser aberta uma
instncia do ERP no modo MCDebug (Modo depurao de Web Services). Para confirmar se o acesso foi
realizado corretamente neste modo, verifique na barra de ttulos do ERP que foi aberto se esta informao
est sendo mostrada (verificar a parte grifada em amarelo na figura 38).


Figura 38 Parmetro mcdebug que deve ser adicionado ao final das informaes do campo Destino.
No ERP em modo MCDebug, dever ser selecionada a opo Diversos > Multicamada do Menu
disponvel (destacado em vermelho na figura 38). Com isso, aps alguns segundos ser exibida a tela para
escolha do servio a ser utilizado para testes. Na lista devero ser procurados os servios que iniciam com
Integraes - Eletrnicos Documentos (destacado em verde na figura 38).
Na lista existem quatro servios que iniciam com Integraes - Eletrnicos Documentos. Cada
servio equivale uma porta do WebService de integrao entre o Documentos Eletrnicos e o ERP (o
nome do WebService com.senior.g5.co.int.eletronicos.documentos).

43
- Integraes - Eletrnicos - Documentos - Importar Retornos: equivale a opo ERP Senior
Web Service 1 da parametrizao de retorno de status de documentos eletrnicos da filial no Documentos
Eletrnicos. Se no Documentos Eletrnicos a filial utiliza a opo ERP Senior Web Service 1, nos testes
via MCDebug o servio a ser utilizado Integraes - Eletrnicos - Documentos - Importar Retornos

- Integraes - Eletrnicos - Documentos - Importar Retornos (verso 2): equivale a opo
ERP Senior Web Service 2 da parametrizao de retorno de status de documentos eletrnicos da filial no
Documentos Eletrnicos. Se no Documentos Eletrnicos a filial utiliza a opo ERP Senior Web Service 2,
nos testes via MCDebug o servio a ser utilizado Integraes - Eletrnicos - Documentos - Importar
Retornos (verso 2)

- Integraes - Eletrnicos - Documentos - Importar Retornos (verso 3): equivale a opo
ERP Senior Web Service 3 da parametrizao de retorno de status de documentos eletrnicos da filial no
Documentos Eletrnicos. Se no Documentos Eletrnicos a filial utiliza a opo ERP Senior Web Service 3,
nos testes via MCDebug o servio a ser utilizado Integraes - Eletrnicos - Documentos - Importar
Retornos (verso 3)

- Integraes - Eletrnicos - Documentos Receber: porta do WebService utilizada
exclusivamente para que o Documentos Eletrnicos envie para o ERP os XMLs dos documentos eletrnicos
recebidos (de entrada). Caso tenha que ser efetuado um teste de envio de um documento eletrnico para o
ERP manualmente, esta porta do WebService a ser utilizada.

9.2.1 Testes de retorno de status documentos eletrnicos via MCDebug
Para exibio dos procedimentos a serem adotados para efetuar um teste de retorno manual de
status de documento, utilizaremos como base a execuo de um retorno de situao 4-Rejeitada para uma
NF-e, utilizando o WebService 3.
Neste caso, para dar continuidade no teste, tendo como base a tela Escolha o servio mostrada na
figura 36, deve ser selecionado o servio Integraes - Eletrnicos - Documentos - Importar Retornos
(verso 3) e clicado no boto OK. A imagem da figura 39 ser exibida na tela.

44

Figura 39 Tela para solicitao de processamento via WebService em Modo MCDebug WebService Retorno
verso 3
(1) Boto Carregar XML: opo que possibilita carregar um arquivo XML com os parmetros a
serem utilizados para a execuo da requisio ao WebService. Esta opo deve ser acionada quando for
necessrio carregar um arquivo XML salvo atravs da opo Salvar entrada / XML (3).

(2) Parmetros XML: opo que possibilita visualizar todos os parmetros digitados na grid da aba
Entrada de Dados da Nota Fiscal no formato de arquivo XML

(3) Salvar entrada / XML: opo que possibilita salvar um arquivo XML com todas as informaes
digitadas na grid da aba Entrada de Dados da Nota Fiscal. Esta opo til para, por exemplo, com
necessita-se efetuar vrios testes com os mesmos parmetros.

(4) Salvar resposta / XML: opo que possibilita salvar um arquivo XML com todas as informaes
retornadas pelo WebService da requisio solicitada. Basicamente, o resultado da solicitao efetuada ao
WebService (registrado na aba Sada de dados da nota fiscal).

(5) Modo de execuo: para que os testes sejam efetuados levando em conta a utilizao do
Middleware Senior (que o que o Documentos Eletrnicos utiliza para efetuar conexo com o ERP), deve
ser sempre selecionada a opo Sncrono para o modo de execuo. A execuo me modo Local no
utilizar o Middleware, sendo assim, para efeito de testes, no deve ser utilizada.

(6) Boto Executar: para enviar a requisio ao WebService com os parmetros digitados na grid
da aba Entrada de Dados da Nota Fiscal, deve ser clicado em Executar.

45
(7) Grid da aba Entrada de Dados da Nota Fiscal: a grid onde devem ser digitados os
parmetros que sero utilizados para enviar a requisio para o WebService. Para saber o que esperado
em cada parmetro da Grid, consulte o tpico 9.2.3 deste guia.

Aps a execuo da requisio o campo Tipo Retorno deve ser preenchido pelo sistema como 1
(que indica processado com sucesso), e o campo Mensagem Retorno deve ser preenchido pelo sistema
como Processamento efetuado com sucesso.. Isso indicar que a requisio foi recebida e processada
pelo Middleware Senior com sucesso (vide parte grifada em verde na figura 40).


Figura 40 Tela do resultado da requisio encaminhada atravs do modo MCDebug
Na figura 40 possvel verificar os dados retornados pelo WebService da requisio enviada ao
Middleware Senior (vide parte grifada em vermelho). Estas informaes so exibidas na aba Sada de
Dados da Nota Fiscal, sendo assim, depois de ser clicado no boto Executar para encaminhar uma
requisio, de o sistema ter retornado a mensagem Processamento efetuado com sucesso, deve ser
acessada a aba Sada de Dados da Nota Fiscal para verificar o retorno.
No exemplo utilizado (de retorno de 4-Rejeitada para uma NF-e), o WebService retornou como
resultado OK (campo Result da grid), evidenciando que o sistema aceitou a solicitao encaminhada e
efetuou a alterao do status da NF-e para 4-Rejeitada no ERP (para efetuar conferncia da alterao do
status, verifique as informaes presentes no tpico 8.2 deste manual).
Importante: o campo Result sempre indicar o resultado da requisio enviada. Se for retornado
OK, indica que a requisio foi atendida com sucesso. Se ela no for atendida com sucesso, neste campo
ser retornada a mensagem de erro pelo qual a requisio no foi atendida.

9.2.2 Testes de envio de documentos eletrnicos via MCDebug
Para exibio dos procedimentos a serem adotados para efetuar um teste de envio manual de
documento eletrnico, utilizaremos como base a execuo de um retorno de uma NF-e autorizada
previamente pela SEFAZ.
Neste caso, para dar continuidade no teste, tendo como base a tela Escolha o servio mostrada na
figura 38, deve ser selecionado o servio Integraes - Eletrnicos - Documentos - Receber e clicado
no boto OK. A imagem da figura 41 ser exibida na tela.

46

Figura 41 Tela para solicitao de processamento via WebService em Modo MCDebug WebService recebimento
documentos eletrnicos
Os botes e opes presentes na tela indicada na figura 41 so basicamente os mesmos presentes
na tela indicada na figura 39. Caso haja necessidade de verificar informaes sobre os botes e opes da
tela, verifique o tpico 9.2.1 deste manual.
Na figura 41 est destacado em vermelho a grid onde devem ser inseridos os parmetros a serem
utilizados para a requisio do WebService.
No caso do WebService de integrao de documentos eletrnicos, o parmetro SeqItn pode ser
preenchido com qualquer valor inteiro, e no parmetro XmlItn deve ser colado o contedo completo do
arquivo XML do documento eletrnico.
IMPORTANTE: para copiar o contedo do arquivo XML, o mesmo deve ser aberto em um Bloco de
Notas; a opo Quebra automtica de linhas do menu Formatar do Bloco de Notas deve estar
desativada; deve ser copiado todo o contedo do arquivo.
Aps preencher o campo SeqItn e colar o contedo do arquivo XML no campo XmlItn, deve ser
clicado no boto Executar. Com isso, a requisio ser encaminhada para o sistema.
Observao: pode ser encaminhada uma requisio para o WebService com vrios XMLs, apenas
definindo SeqItn diferentes. O retorno ser encaminhado pelo WebService para cada SeqItn.


Figura 42 Tela do resultado da requisio encaminhada atravs do modo MCDebug
47
Na figura 42 est destacado em vermelho o retorno enviado pelo sistema para a requisio
enviada. O retorno informar o resultado para cada SeqItn. No exemplo utilizado, o retorno foi de OK,
indicando que o ERP aceitou a integrao do documento de entrada. Caso haja algum problema na
integrao do documento, a mensagem de erro ser informada no campo Retorno para cada SeqItn.
Para os documentos que tiveram como retorno do WebService OK, a consulta do documento de
entrada pode ser realizada, neste momento, na tela F000INE_SRNF - Suprimentos / Gesto de
Recebimento / Notas Fiscais de Entrada / Via Recebimento de Documento Eletrnico do ERP, pois o
mesmo j estar registrado nesta tela. Lembrando que, nesta tela, por padro o ERP efetua filtro pelo CNPJ
do destinatrio do documento eletrnico (em caso de NF-e) ou do responsvel pelo pagamento do frete (no
caso de CT-e).

9.2.3 Como obter informaes sobre os parmetros de cada WebService
Em casos onde se necessita saber que tipo de informao deve ser informado em cada parmetro
do Webservice e quais so os parmetros obrigatrios para, por exemplo, efetuar um retorno de status de
documento eletrnico manualmente, possvel acessar o Editor de web services do ERP.
O Editor acessado atravs do Menu Recursos > Implementaes > Web Services > Editar do
ERP.


Figura 43 Editor de web services do ERP selecionado WebService 3 de integrao do Documentos Eletrnicos
com o ERP
Aps acessar o Editor de web services do ERP, ser exibida a tela indicada na figura 41. Para
acessar as informaes dos WebServices de integrao entre o Documentos Eletrnicos e o ERP, deve ser
acessado o caminho Interno > com.senior.g5.co.int.eletronicos.documentos (destacado em vermelho
na figura 43). Neste caminho estaro presentes as quatro portas deste WebService (mencionadas no tpico
9.2 deste guia). Na imagem 43, como exemplo, foi selecionada a porta 3 (de nome ImportarRetornos_3)
48
(destacada em verde), e em seguida selecionado o Parmetro EntradaDoRetornoNFEletronica (destacado
em laranja). Com isso, no canto direito inferior (destacado em azul) sero mostradas as informaes das
variveis do parmetro do WebService, que so efetivamente os campos que so apresentados no
MCDebug para serem preenchidos. possvel identificar, ento, os campos que so obrigatrios, quais
informaes devem ser inseridas em cada campo e o formato de preenchimento de cada campo.
Observao: na figura 43 foi utilizado a porta ImportarRetornos_3 do WebService
com.senior.g5.co.int.eletronicos.documentos para exemplificar a visualizao das informaes, no entanto,
o Editor de web services pode ser utilizado para verificar as informaes de qualquer WebService do ERP.

9.2.4 Problemas comuns na utilizao de Web Services do ERP pelo Documentos Eletrnicos
- Quando o GlassFish do ambiente est inativo:
* Log do Sde.log: ERROR Senior.SapiensNfe.Processos.Service.Nfe.RetornoNfeErp - Erro ao
retornar situao da nota ao ERP. System.Net.WebException: Impossvel conectar-se ao servidor
remoto ---> System.Net.Sockets.SocketException: Nenhuma conexo pde ser feita porque a
mquina de destino as recusou ativamente <Servidor>:<porta>

* Conexo via MCDebug: Erro ao chamar servio: -<cdigo_interno>. URL:
http://<servidor>:<porta>/g5-mc-services/SyncService. Possvel causa: Servidor inativo ou inacessvel
ou URL invlida.

- Quando o servio SeniorMiddleware, Servio de Informao da Instalao ou Gerenciador
do Middleware esto parados ou inacessveis:
* Log do Sde.log e MCDebug: ERROR Senior.SapiensNfe.Processos.Service.Sistema.
IntegradorSaida - Erro ao enviar retorno para o ERP, CNPJ: <CNPJ_Filial>, mensagem retorno: No
foi possvel executar o servio solicitado.
Detalhes:Ao: InternalSyncService -> Process request
Sistema: sapiens
Usurio: <usurio_integrao>
Chave: com_senior_g5_co_int_eletronicos_documentos@<porta_webservice>
Agrupador: null
Lote: 0
Possui parmetros de entrada
Erro: com.senior.mdw.exception.ConnectException: No foi possvel conectar ao servidor
<nome_servidor> na porta <porta>: erro ao alocar aplicao. Causa: Erro de comunicao com
servidor.

* Log do Sde.log e MCDebug: ERROR Senior.SapiensNfe.Processos.Service.Sistema.
IntegradorSaida - Erro ao enviar retorno para o ERP, CNPJ: <CNPJ_filial>, mensagem retorno: No
foi possvel executar o servio solicitado.
Detalhes:Ao: InternalSyncService -> Process request
Sistema: sapiens
49
Usurio: <usurio_integrao>
Chave: com_senior_g5_co_int_eletronicos_documentos@<porta_webservice>
Agrupador: null
Lote: 0
Possui parmetros de entrada
Erro: com.senior.mdw.exception.ConnectException: No foi possvel conectar ao servidor
pcbnu00006 na porta 1299: erro ao conectar socket.
Causa: No foi possvel conectar ao servidor <nome_servidor> na porta <porta>: conexo
recusada na porta informada.
Causa: Connection refused: connect
10 Utilizando o validador de XML da SEFAZ
Em diversas situaes, necessrio efetuar a validao do arquivo XML gerado pelo ERP para
cada documento eletrnico, a fim de verificar se realmente o mesmo possui alguma inconsistncia, de
acordo com as validaes efetuadas pela SEFAZ. Para isso, a SEFAZ-RS disponibiliza um validador on-line
para os documentos eletrnicos NF-e, CT-e e MDF-e (as validaes de arquivos XML de eventos de cada
documento eletrnico tambm so efetuadas).
Observaes:
- Em algumas situaes, o validador no consegue identificar o ponto correto onde h uma
inconsistncia no arquivo. Neste caso, deve-se analisar o arquivo, efetuar alguma modificao (no ponto
onde acredita-se que o problema esteja) e efetuar nova solicitao de validao.
- Os validadores de MDF-e e CT-e tambm no trazem tantas informaes de validao quanto o
de NF-e (principalmente na questo de regras de negcio).
- possvel que o validador de XML indique que o arquivo XML esteja correto, mesmo que ele
possua alguma informao incorreta, que ser validada somente pelo WebService da SEFAZ, no momento
do envio do arquivo XML pelo ERP.
- Os validadores disponibilizados pela SEFAZ (principalmente o de NF-e) so bem instveis,
apresentando constantes erros de processamento da requisio. Sendo assim, muitas vezes, necessrio
efetuar a requisio de validao diversas vezes para conseguir uma resposta que no seja de Erro de
processamento do validador.
Os validadores esto disponveis nos seguintes links:
NF-e: https://www.sefaz.rs.gov.br/NFE/NFE-VAL.aspx
CT-e: https://www.sefaz.rs.gov.br/cte/cte-val.aspx
MDF-e: https://mdfe-portal.sefaz.rs.gov.br/Site/ValidadorXml

Para exemplificar a utilizao de um validador, utilizaremos o validador de uma NF-e juntamente
com um arquivo XML gerado pelo ERP Senior. A figura 44 mostra a validao de uma NF-e no validador.
50

Figura 44 Validador de NF-e da SEFAZ-RS
(1) Contedo da Mensagem a ser validada: campo onde deve ser colado o contedo do arquivo
XML a ser validado. O arquivo XML deve ser aberto no aplicativo Bloco de Notas do Windows, e seu
contedo deve ser copiado (sem quebra de linhas) neste campo.

(2) Validar: boto que deve ser acionado para solicitar a validao do arquivo

(3) Instrues: opo que pode ser acionada para que seja exibido o manual do validador
disponibilizado pela prpria SEFAZ-RS

(4) Quadro Resultado da Validao: quadro onde informado o resultado da validao do arquivo
(segundo verificaes de Schema e regras de negcio passveis de validao pelo validador).

Observao: o validador de MDF-e est efetuando validaes corretamente apenas de arquivos
assinados digitalmente. Neste caso, caso haja necessidade de efetuar alguma validao em um arquivo de
MDF-e, ou usa-se o processo de assinatura digital do documento eletrnico no ERP (desabilitando o
identificador de regras VEN-140NECER01), ou coleta-se o Log do Documentos Eletrnicos em modo
DEBUG no momento do envio do arquivo XML do MDF-e para a SEFAZ.

11 Verificaes adicionais a serem efetuadas para recebimento de
documentos eletrnicos no Documentos Eletrnicos
Este tpico tem por objetivo trazer informaes adicionais sobre a rotina de recebimento de
documentos eletrnicos, focado no processo de recebimento do e-mail com o arquivo XML da NF-e/CT-e
pelo Documentos Eletrnicos.
51
Os parmetros que devem estar definidos como Sim obrigatoriamente para que a rotina de
recebimento de documentos eletrnicos esteja ativada so:
- Para NF-e: Monitor Documentos Eletrnicos > Configurao > aba NF-e > aba Geral > parmetro
Ativar recebimento
- Para CT-e: Monitor Documentos Eletrnicos > Configurao > aba CT-e > aba Geral > parmetro
Ativar recebimento
Alm dos parmetros indicados acima, o campo Diretrio e-mails da tela Configurao > Geral >
aba Recebimento tambm deve estar preenchido com um diretrio acessvel atravs do servidor do
Documentos Eletrnicos com as credenciais do usurio parametrizado para instanciar os servios do
Documentos Eletrnicos. Importante: conforme definido no Ajuda do Documentos Eletrnicos, este diretrio
no pode conter mais de 248 caracteres, ou seja, o total de caracteres definido no campo Diretrio e-mails
no poder ser maior que 248 caracteres. Se isso ocorrer, vrios problemas podero acontecer durante a
execuo do processo, ou a mesma pode, inclusive, no ser executada.


Figura 45 Parametrizao do diretrio onde os arquivos de e-mails sero armazenados
Muitos usurios possuem dvidas quanto finalidade do campo Diretrio e-mails. Este campo
utilizado para armazenar os arquivos dos e-mails lidos pelo Documentos Eletrnicos das caixas de entrada
dos endereos de e-mails parametrizados na tela Configurao > Geral > aba Recebimento. Estes
arquivos de e-mails so arquivos com extenso .EML. Neste diretrio no sero armazenados os arquivos
XML recebidos pelo Documentos Eletrnicos, no entanto, dentro de cada arquivo .EML possvel encontrar
os arquivos que o Documentos Eletrnicos integrou ou tentou integrar.
52

Figura 46 Estrutura do diretrio de e-mails utilizado pelo Documentos Eletrnicos
Na figura 45 mostrado o diretrio C:\teste_email como diretrio definido para armazenamento
dos arquivos de e-mails. Na figura 46 mostrado o acesso ao diretrio C:\teste_email. Na figura 46
possvel identificar:

(1) Estrutura de pastas: o Documentos Eletrnicos cria uma estrutura de pastas padro para
armazenamento dos arquivos .EML, seguinte a seguinte estrutura: Diretrio definido no Monitor >
Servidor Pop/Imap > Domnio endereo e-mail > Usurio e-mail > Ano > Ms > Dia.

(2) Arquivos .EML: acessando a pasta referente ao dia que o arquivo XML foi lido pelo
Documentos Eletrnicos, possvel acessar todos os arquivos .EML baixados da caixa de entrada do
endereo de e-mail em questo. O arquivo .EML salvo com nome indicando Ano/Ms/Dia/Hora da leitura
do e-mail pelo Documentos Eletrnicos, concatenado com um nmero inteiro equivalente aos
segundos/milissegundos, concatenado com o ttulo do e-mail. Desta forma, fcil encontrar o arquivo .EML
de um e-mail, quando h necessidade de efetuar a procura pelo mesmo.

(3) Arquivo .EML aberto: exibio de um arquivo .EML aberto atravs do aplicativo Microsoft
Outlook 2010.

(4) Anexos do arquivo .EML: aps abrir o arquivo .EML em um aplicativo que efetue a abertura
deste tipo de arquivo, possvel visualizar os anexos encaminhados junto ao e-mail lido pelo Documentos
Eletrnicos. O Documentos Eletrnicos apenas tentar integrar arquivos com extenso .XML. Arquivos com
outras extenses sero ignorados.

53
O parmetro Diretrio e-mails define o diretrio onde os arquivos .EML dos e-mails recebidos pelo
Documentos Eletrnicos sero armazenados, no entanto existe um diretrio onde o Documentos Eletrnicos
armazena os arquivos XML j extrados dos arquivos .EML. Porm, para que o Documentos Eletrnicos
efetue o armazenamento destes arquivos necessrio que o parmetro Armazenar XML processado em
disco da tela Configurao > Geral do Monitor do Documentos Eletrnicos esteja parametrizado como
Sim.


Figura 47 Parmetro que indica o armazenamento de arquivos XML processados em disco
Se o parmetro indicado na figura 47 estiver ativado, o Documentos Eletrnicos armazenar os
arquivos XML processados (autorizados pela SEFAZ) tanto de emisso quanto de recebimento dentro da
estrutura de diretrios de integrao de cada filial no Documentos Eletrnicos. Importante: o
armazenamento dos arquivos XML em diretrios opcional, pois o Documentos Eletrnicos (deDocumentos
Eletrnicos a verso 5.7.2.1) efetua o armazenamento de todos os arquivos XML autorizados em seu banco
de dados.


Figura 48 Pasta onde so armazenados os arquivos XML de recebimento
A figura 48 indica a pasta dentro do diretrio de integrao da filial onde o Documentos Eletrnicos
armazena os arquivos XML de NF-e recebidos e autorizados pela SEFAZ (quando o parmetro Armazenar
XML processado em disco estiver ativado). Sendo assim, podemos definir que o Documentos Eletrnicos
armazenar os arquivos XML de recebimento no seguinte caminho:
- Para NF-e: <Diretrio_integrao_filial>\Xml\<CNPJ_filial>\Nfe Recebimento
- Para CT-e: <Diretrio_integrao_filial>\Xml\<CNPJ_filial>\Cte Recebimento
54
Na pasta dos arquivos de NF-e tambm sero armazenados os arquivos XML referente as
manifestaes de destinatrio geradas pela filial para uma NF-e de um fornecedor da mesma.


11.1.1 Dicas sobre verificaes a serem efetuadas quando a rotina de recebimento de e-mail no
estiver sendo executada corretamente
Em algumas situaes a rotina de recebimento de documentos eletrnicos por e-mail pode parar de
ser executada no Documentos Eletrnicos. Abaixo seguem algumas dicas de verificaes a serem
efetuadas e procedimentos a serem adotados para garantir o correto funcionamento da rotina.

- Utilizao de endereos de e-mail especficos: conforme j informado no arquivo de ajuda do
Documentos Eletrnicos, recomenda-se que as contas de e-mail utilizadas para recebimento de
documentos eletrnicos sejam de uso exclusivo para o recebimento dos documentos. A utilizao de contas
no exclusivas pode acarretar problemas com a execuo da rotina.

- Verificaes frequentes nas caixas de entrada dos e-mails: deve ser efetuada verificao
frequente na caixa de entrada dos endereos de e-mail parametrizados no Documentos Eletrnicos para
recebimento de documentos. Qualquer e-mail que no possua anexos ou que possua anexos que no
sejam arquivos .XML e que, por ventura, o Documentos Eletrnicos no estiver conseguindo efetuar a
leitura, devem ser eliminados da caixa de entrada. Lembrando que o Documentos Eletrnicos s efetua
leitura da caixa de entrada do e-mail.

- Tempo de intervalo da execuo do processo Recebimento Documentos: recomendvel
que o tempo de intervalo do processo Recebimento Documentos disponvel em Configurao > Geral >
aba Intervalo de Execuo seja de no mnimo 60 segundos. Caso o volume de documentos a serem
recebidos seja muito alto, este tempo deve ser ajustado para mais que 60 segundos.


Figura 49 Parmetro Recebimento Documentos da tela de Intervalos de Execuo
- Tempo de intervalo da execuo do processo Recebimento Documentos: recomendvel
que o tempo de intervalo do processo Recebimento Documentos disponvel em Configurao > Geral >
55
aba Intervalo de Execuo seja de no mnimo 60 segundos. Caso o volume de documentos a serem
recebidos seja muito alto, este tempo deve ser ajustado para mais que 60 segundos.

- Utilizao de conta de e-mail alternativa: caso seja constatado que a rotina de recebimento no
estiver sendo executada corretamente, por medida de testes (para descartar problemas com a rotina do
Documentos Eletrnicos), recomenda-se a parametrizao de uma conta alternativa de e-mail no
Documentos Eletrnicos (eliminando temporariamente a parametrizao das demais contas de e-mails).
Aps ter sido efetuada esta parametrizao e os servios do Documentos Eletrnicos terem sido
reiniciados, para efeito de teste, encaminhar os arquivos XML que eventualmente no estariam sendo
integrados pelo Documentos Eletrnicos para o endereo de e-mail da conta alternativa parametrizada, de
forma que seja possvel verificar se os mesmos seriam integrados normalmente. Dica: o Documentos
Eletrnicos segue os padres internacionais referentes ao formato dos e-mails. Alguns servidores de e-mail
no seguem as normas internacionais, portanto, o Documentos Eletrnicos poder no conseguir ler e-mails
que foram gerados atravs destes servidores. Neste caso, pode ser avaliado pelo desenvolvimento a
possibilidade de implementao para que o Documentos Eletrnicos leia um formato no padronizado de e-
mail, ou solicitado que o fornecedor que envia o e-mail utilize outro servidor de e-mail.

- Verificao de Log Documentos Eletrnicos.log: quando o Documentos Eletrnicos no
consegue efetuar a leitura do e-mail para tentar integrar um arquivo XML, no ser gerada uma Crtica de
Integrao na tela NF-e > Recebimento > aba Crticas de Integrao. A crtica de integrao s gerada
se o Documentos Eletrnicos conseguir ler o e-mail e houver algum problema com o arquivo XML a ser
integrado. Se o Documentos Eletrnicos no conseguir ler o e-mail, ser registrado um erro no Log
Documentos Eletrnicos.log e no haver registro de crticas de integrao. Dica: indicado, no caso do
Documentos Eletrnicos ser utilizado para vrios processos, que, para verificar a mensagem exata gerada
na integrao de algum arquivo XML, seja parametrizada uma base de testes para integrao do arquivo
XML atravs de uma conta de e-mail especfica, assim possvel identificar com exatido uma eventual
mensagem de erro.

- Assinatura digital invlida: em muitos casos um arquivo XML que deveria ser integrado no
Documentos Eletrnicos registrado em Crticas de Integrao com a mensagem A assinatura do
documento no valida. Isso ocorre porque o arquivo XML recebido por e-mail pelo Documentos
Eletrnicos realmente possui a assinatura digital invlida. Em vrios casos a prpria SEFAZ distribui um
arquivo XML com assinatura digital invlida conforme definio de regras pr-estabelecidas pela mesma
SEFAZ no manual do contribuinte. Para maiores informaes, indicamos a verificao da soluo de
nmero 4456 do banco de solues do Suporte na ferramenta 0800net.

56
12 Verificando o diretrio onde o ERP gerar os arquivos XML dos
documentos eletrnicos
Em alguns casos, verificado que um documento eletrnico foi gerado pelo ERP, mas no existe
registro do mesmo no Documentos Eletrnicos, em nenhuma tela. O primeiro passo verificar onde o
arquivo XML foi gerado (em qual pasta) e se o arquivo XML encontra-se ainda nesta pasta, ou se ele j foi
consumido pelo Documentos Eletrnicos. No entanto, no h conhecimento em que pasta/diretrio este
arquivo XML foi gerado pelo ERP. Abaixo seguem informaes de como saber em qual diretrio o arquivo
XML foi gerado.
O ERP utiliza a seguinte lgica para gerao de um arquivo XML:

- Para NF-e/CC-e/MDF-e: verifica se existe algum diretrio definido no campo Diretrio NF-e da
tela F099UVE - Cadastros / Usurios / Parmetros por Gesto / Vendas e Faturamento para o usurio
que est solicitando a gerao do arquivo XML. Se no existir nenhuma informao neste campo, o ERP
utiliza o diretrio definido no campo Dir.Arq Doc. Eletrnicos na tela F020SNF - Cadastros / Mercado e
Suprimentos / Parmetros Fiscais / Sries Notas Fiscais / Cadastro da srie da NF-e que est sendo
emitida.

- Para NFS-e: verifica se existe algum diretrio definido no campo Diretrio NFS-e da tela
F099UVE - Cadastros / Usurios / Parmetros por Gesto / Vendas e Faturamento para o usurio que
est solicitando a gerao do arquivo XML. Se no existir nenhuma informao neste campo, o ERP utiliza
o diretrio definido no campo Dir.Arq Doc. Eletrnicos na tela F020SNF - Cadastros / Mercado e
Suprimentos / Parmetros Fiscais / Sries Notas Fiscais / Cadastro da srie da NF-e que est sendo
emitida

- Para CT-e: verifica se existe algum diretrio definido no campo Diretrio Arquivo CT-e da tela
F099FTR - Cadastros / Usurios / Parmetros por Gesto / Transporte para o usurio que est
solicitando a gerao do arquivo XML. Se no existir nenhuma informao neste campo, o ERP utiliza o
diretrio definido no campo Dir.Arq Doc. Eletrnicos na tela F020SNF - Cadastros / Mercado e
Suprimentos / Parmetros Fiscais / Sries Notas Fiscais / Cadastro da srie da NF-e que est sendo
emitida

Dica: Se houver dvida de qual foi o usurio que efetuou a gerao do arquivo XML, poder ser
verificado na consulta do documento eletrnico na tela F141HDE_RFNF - Mercado / Gesto de
Faturamento e Outras Sadas / Notas Fiscais de Sada / Consultas / Histrico de Documentos Eletrnicos o
usurio que alterou o status de 1-No Enviada para 2-Enviada. (Observao: esta consulta ainda no
est disponvel para MDF-e).

57
13 Verificando o ambiente utilizado por cada filial e se h contingncia
ativada
importante, sempre que for aberta uma solicitao ao Suporte da Senior, que seja informado o
ambiente configurado no Documentos Eletrnicos para emisso de documentos eletrnicos e se estaria
sendo utilizado algum tipo de contingncia no Documentos Eletrnicos no momento da emisso de um
documento que, por exemplo, teve algum problema durante seu processo de emisso. Por isso, abaixo
seguem as telas do Monitor do Documentos Eletrnicos que podem ser utilizadas para coletar estas
informaes.

13.1 Verificando o ambiente utilizado pelo Documentos Eletrnicos
Para verificar se o Documentos Eletrnicos est parametrizado para utilizar o ambiente de
homologao ou ambiente de produo, basta acessar a tela Configurao > Geral > aba Geral e
verificar o campo Ambiente, conforme indicado na figura 50.


Figura 50 Parametrizao do ambiente utilizado pelo Documentos Eletrnicos
IMPORTANTE: conforme j informado no tpico 2 deste guia, devem existir bases do Documentos
Eletrnicos separadas para ambiente de produo e de homologao. Por este motivo, a parametrizao do
ambiente utilizado pelo Documentos Eletrnicos vlida para todas as filiais cadastradas no sistema.

13.2 Verificando se uma filial possui contingncia ativada no Documentos Eletrnicos
Sempre que houver uma contingncia ativada para alguma filial do Documentos Eletrnicos, ao ser
acessado o Monitor do Documentos Eletrnicos, no lado esquerdo do vdeo ser mostrada a informao
Filiais em Contingncia (conforme indicado na figura 51).

58

Figura 51 Indicativo de filiais em contingncia no Documentos Eletrnicos
Para verificar as filiais que esto com contingncia ativada, e qual o documento eletrnico que est
em contingncia para cada filial, basta clicar no cone do Ponto de Exclamao em vermelho, presente na
figura 51. A tela indicada na figura 52 ser mostrada:


Figura 52 Exibio das filiais em contingncia no Documentos Eletrnicos
(1) Tipo de Documento: informa o tipo de documento da filial que est em contingncia

(2) Tipo de Contingncia: informa o tipo de contingncia que est habilitado para o documento
eletrnico (SCAN, SVC, FS, FS-DA, DPEC Manual/Automtico) da filial que est em contingncia.

(3) Data e hora de entrada em contingncia: indica a data e a hora que o usurio solicitou a
entrada em contingncia para cada documento eletrnico / filial

13.3 Verificando qual o tipo de emisso utilizado pelo Documentos Eletrnicos para envio de uma NF-
e
Para NF-e, o Documentos Eletrnicos disponibiliza atualmente um campo na visualizao da NF-e
no Monitor que indica qual o Tipo de Emisso utilizado para a NF-e que est sendo visualizada. O Tipo de
Emisso seria se ela foi emitida em ambiente normal ou se foi utilizada alguma forma de contingncia para
emisso da NF-e.
59
Para visualizar este campo, basta localizar a NF-e na tela NF-e > Emisso > Aba Notas Fiscais
e, aps selecionar a NF-e, clicar no boto Visualizar. Levando a barra de rolagem at o final da pgina, a
tela da figura 53 ser mostrada (na figura est destacado o campo Tipo de Emisso).


Figura 53 Indicativo do tipo de emisso de uma NF-e no Documentos Eletrnicos

14 Verificando os WebServices da SEFAZ e os WebServices utilizados pelo
Documentos Eletrnicos
Em alguns casos h necessidade de saber quais so os WebServices disponibilizados por cada
SEFAZ para comunicao de cada documento eletrnico, e quais so os WebServices que o Documentos
Eletrnicos utiliza para comunicao com cada SEFAZ.

14.1 Verificando os WebServices da SEFAZ
Para verificar os WebServices disponibilizados por cada SEFAZ para os documentos eletrnicos,
acesse os links abaixo:
- Para NFe: http://www.nfe.fazenda.gov.br/portal/webServices.aspx?tipoConteudo=Wak0FwB7dKs=
- Para CT-e: http://www.cte.fazenda.gov.br/webServices.aspx?tipoConteudo=wpdBtfbTMrw=
- Para MDF-e: https://mdfe-portal.sefaz.rs.gov.br/Site/Servicos

Observao: para verificar os WebServices que cada Prefeitura disponibiliza para comunicao,
necessrio verificar o manual de integrao de cada Prefeitura, ou informaes no site da Prefeitura. No
caso da Prefeitura no disponibilizar estas informaes em algum site, o Suporte da prefeitura dever ser
contatado para obter tais informaes.
60

14.2 Verificando os WebServices/URLs utilizados pelo Documentos Eletrnicos
Caso haja necessidade de verificar qual o WebService que o Documentos Eletrnicos est
utilizando para comunicao com uma SEFAZ ou Prefeitura, necessrio ter acesso ao banco de dados do
Documentos Eletrnicos para efetuar um comando de consulta.
A tabela que armazena a relao dos WebServices utilizados pelo Documentos Eletrnicos a
tabela N100WEB. Para isso, necessrio efetuar comandos selects na base de dados do Documentos
Eletrnicos para verificar os WebServices utilizados:

- Comando para buscar WebService de uma SEFAZ
select * from n100web where seqest=<cdigo_estado> and verdoc='<verso>' and
tipamb=<ambiente>

Onde:
<cdigo_estado> o cdigo do estado da SEFAZ que o Documentos Eletrnicos est efetuando
conexo. Este cdigo definido pelo IBGE e pode ser consultado em
http://www.ibge.gov.br/home/geociencias/areaterritorial/principal.shtm
<verso> a verso do documento a ser consultado. Preencher com 2.00 para documentos 2.0 e
1.00 para documentos 1.0.
<ambiente> o ambiente que se deseja verificar. Preencher com 1 para produo e 2 para
homologao.

Exemplo de comando para buscar os WebServices da SEFAZ de SC de documentos 2.0 do
ambiente de produo: select * from n100web where seqest=42 and verdoc='2.00' and tipamb=1


- Comando para buscar WebService/URL de uma Prefeitura
select * from n100web where seqmun=<cdigo_rais> and tipamb=<ambiente>

Onde:
<cdigo_rais> o cdigo do Municpio que o Documentos Eletrnicos est efetuando conexo.
Este cdigo definido pelo Ministrio do Trabalho e pode ser consultado em
http://www.rais.gov.br/mun_sc.asp. No comando, o cdigo deve ser digitado sem nenhum caractere,
somente nmeros.
<ambiente> o ambiente que se deseja verificar. Preencher com 1 para produo e 2 para
homologao.

Exemplo de comando para buscar os WebServices da Prefeitura de Blumenau/SC do ambiente de
produo: select * from n100web where seqmun=4202404 and tipamb=1

61
Observao: j est sendo avaliado pelo desenvolvimento do produto Documentos Eletrnicos a
criao de uma tela no Monitor do Documentos Eletrnicos para visualizao das informaes dos
WebServices/URLs utilizados pelo Documentos Eletrnicos sem a necessidade de consulta em banco de
dados. Esta tela estar disponvel em verses futuras do Documentos Eletrnicos.

15 Quadro de revises
Data Verso Autor Descrio
27/01/2014 V1.0 Felipe Nascimento Definio inicial do guia