AsixNFe - Instruções Básicas de Uso

Rafael Ibraim
Omega Consultoria - Asix ERP

Versão 1.10, Abril de 2009

 Resumo

Este documento apresenta uma visão geral da utilização do plugin AsixNFe para a inte-
gração com o projeto NF-e, que em sua primeira fase compreende as notas fiscais modelos
01 e 1A. O foco deste manual é o uso do plugin no sistema e como o usuário deve proceder
para realizar as tarefas mais comuns relativas à NF-e - este manual não é um guia detal-
hado do porquê do projeto ou seu fundamento legal. Caso tenha dúvidas neste sentido, o
aconselhável é consultar o portal da NF-e, disponı́vel em http://www.nfe.fazenda.gov.br,
para obter as últimas informações sobre o assunto.
ii
Sumário

Sumário iii

Lista de Figuras v

Lista de Tabelas vii

Lista de Listagens ix

1 Requisitos Básicos para Utilização 1

1.1 Introdução . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
1.2 CAPICOM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
1.3 Certificado Tipo A1 ou A3 . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
1.4 Instalação do Plugin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
1.5 Dados Básicos da Empresa . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
1.6 Dados Básicos do Cliente . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
1.7 Dados Básicos do Produto . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
1.8 Municı́pio, Estado e Paı́s . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
1.9 Teste de Conectividade . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

2 Gerenciando NF-e 7
2.1 Introdução . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
2.2 Geração de uma NF-e . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
2.3 Criação do Lote de NF-e . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
2.4 Envio e recepção do lote . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
2.5 Notas Fiscais Aceitas e Rejeitadas . . . . . . . . . . . . . . . . . . . . . . . 13
2.6 Notas Fiscais Canceladas . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
2.7 Possı́veis Status de NF-e e Lote de NF-e . . . . . . . . . . . . . . . . . . . 16
2.8 Consultando e exportando NF-e . . . . . . . . . . . . . . . . . . . . . . . . 16
2.8.1 Exportando NF-e . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
2.8.2 Consultando Status da NF-e . . . . . . . . . . . . . . . . . . . . . . 18

3 DANFE em Contingência 19
3.1 Introdução . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
3.2 Utilizando o SCAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

iii
 3.3 Gerando o DANFE em Contingêcia . . . . . . . . . . . . . . . . . . . . . . 20
3.4 Inutilizando as Notas Fiscais . . . . . . . . . . . . . . . . . . . . . . . . . . 21
3.5 Exemplo: Falha durante consulta de um lote transmitido . . . . . . . . . . 21

4 Dúvidas Frequentes 25
4.1 Dúvidas Gerais . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
4.1.1 Porque o diálogo de seleção de formulário aparece mais de uma vez
em alguns processos ? . . . . . . . . . . . . . . . . . . . . . . . . . 25
4.1.2 Existe alguma maneira de evitar que o sistema mostre a janela de
seleção de certificado a toda hora ? . . . . . . . . . . . . . . . . . . 25
4.1.3 Porque tenho que informar a senha do meu certificado a todo mo-
mento ? É possı́vel mudar este comportamento ? . . . . . . . . . . 25
4.2 Sobre o DANFE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
4.2.1 Em que tipo de formulário devo imprimir o DANFE ? . . . . . . . . 26
4.2.2 O modelo de DANFE impresso não contém todas as informações da
nota. Como resolvo isso ? . . . . . . . . . . . . . . . . . . . . . . . 26
4.2.3 Mas está faltando o campo “X” no DANFE ! Sem isso, não consigo
trabalhar ! . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
4.3 SCAN e Regime de Contingência . . . . . . . . . . . . . . . . . . . . . . . 26
4.3.1 O AsixNFe dá suporte à contingência pelo ambiente SCAN ? . . . . 26
4.3.2 Posso entrar em regime de contingência a qualquer momento ? . . . 26
4.4 Envio de NF-e por email . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
4.4.1 Alguns de meus clientes querem que eu envie a NF-e (XML) para
eles por e-mail. É possı́vel fazer isso pelo sistema ? . . . . . . . . . 27
4.4.2 O conteúdo da NF-e que vai para o cliente por email é diferente do
conteúdo gerado caso eu salve a NF-e em disco manualmente. Qual
é o problema ? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
4.4.3 Algumas das notas enviadas através do workflow não contém as in-
formações adicionais sobre o protocolo da NF-e. Como corrigir isso
? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

A Configurando NF-e e Workflow 29

A.1 Configurações Básicas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
A.2 Configurando a criação do e-mail . . . . . . . . . . . . . . . . . . . . . . . 31
A.3 Enviando o e-mail para o Cliente . . . . . . . . . . . . . . . . . . . . . . . 33

iv
Lista de Figuras

1.1 Registro do servidor COM+ da CAPICOM . . . . . . . . . . . . . . . . . . 2

1.2 Confirmação do registro de servidor COM+ . . . . . . . . . . . . . . . . . 3
1.3 Cadastro de Municı́pios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
1.4 Resultado positivo da consulta de Status do Serviço . . . . . . . . . . . . . 6

2.1 Menu de Faturamento . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

2.2 Janela de seleção de Certificado . . . . . . . . . . . . . . . . . . . . . . . . 9
2.3 Menu de Gerenciamento de Notas Fiscais Eletrônicas . . . . . . . . . . . . 9
2.4 Gerenciamento de NF-e . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
2.5 Menu de opções da NF-e . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
2.6 Gerando um novo Lote de NF-e . . . . . . . . . . . . . . . . . . . . . . . . 11
2.7 Menu de opções do Lote de NF-e . . . . . . . . . . . . . . . . . . . . . . . 11
2.8 Confirmação de Envio de Lote . . . . . . . . . . . . . . . . . . . . . . . . . 12
2.9 Resultado do Processamento de Lote . . . . . . . . . . . . . . . . . . . . . 13
2.10 Menu de Impressão (Gerenciamento de NF-e) . . . . . . . . . . . . . . . . 14
2.11 Confirmação de Cancelamento de NF-e . . . . . . . . . . . . . . . . . . . . 15
2.12 Interface de detalhes da NF-e . . . . . . . . . . . . . . . . . . . . . . . . . 17

3.1 Confirmação de Inutilização de NF-e . . . . . . . . . . . . . . . . . . . . . 22

3.2 Confirmação de Cópia de Nota Fiscal . . . . . . . . . . . . . . . . . . . . . 23

A.1 Configuração do Cadastro de Empresas (Workflow) . . . . . . . . . . . . . 30

A.2 Permissão de envio de NF-e por e-mail (Workflow) . . . . . . . . . . . . . . 30
A.3 Configuração de SMTP (Workflow) . . . . . . . . . . . . . . . . . . . . . . 31
A.4 Configuração de Email (Workflow) . . . . . . . . . . . . . . . . . . . . . . 34

v
vi
Lista de Tabelas

2.1 Possı́veis Status da NF-e . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

2.2 Possı́veis Status do lote de NF-e . . . . . . . . . . . . . . . . . . . . . . . . 17

vii
viii
Lista de Listagens

A.1 Exemplo de SQL Principal . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

A.2 Modelo HTML de Email . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
A.3 Exemplo de SQL do campo “Para” . . . . . . . . . . . . . . . . . . . . . . 32
A.4 SQL necessário para o anexo . . . . . . . . . . . . . . . . . . . . . . . . . . 33

ix
x
Capı́tulo 1

Requisitos Básicos para Utilização

1.1 Introdução
Antes mesmo de gerar a primeira NF-e1 , é necessário tomar alguns cuidados para garan-
tir que a base de dados contém informações completas e verdadeiras, pois sem elas a nota
será sempre rejeitada pela SEFAZ e não será possı́vel emitir notas fiscais. Os principais
tópicos que devem ser checados para o correto funcionamento da Nota Fiscal Eletrônica
são:

CAPICOM Antes de mais nada, é necessária a instalação da biblioteca CAPICOM, para

gerenciamento dos certificados digitais usados na assinatura e transmissão da NF-e.
Certificado Tipo A1 ou A3 Por trabalhar em um ambiente seguro, é obrigatório o uso
de um certificado digital do tipo A1 ou A3 para emissão de NF-e.
Instalação do Plugin É necessário conferir se o plugin está corretamente instalado no
Asix antes de poder utilizar a NF-e.
Dados Básicos da Empresa Existem alguns dados da empresa que devem ser conferidos
antes da geração da NF-e, pois caso estes dados não estejam presentes ou sejam
inválidos, a nota será rejeitada pela SEFAZ.
Dados Básicos do Cliente Assim como o emitente, o cliente também deve ter algumas
informações básicas cadastradas corretamente ou a nota fiscal não será aceita.
Dados Básicos do Produto Alguns dados do cadastro de estoque também devem ser
verificados antes da emissão da NF-e.
Municı́pio, Estado e Paı́s A SEFAZ exige que os dados sobre municı́pio, estado e paı́s
sejam informados de acordo com o código padrão do IBGE. Como este é um cadastro
novo no sistema, será necessária uma conferência básica nestes cadastros antes de
emitir a NF-e.
1
Nota Fiscal Eletrônica. Não confunda com Nota Fiscal Paulista.

1
Teste de Conectividade Antes da utilização da NF-e, é recomendável testar a conec-
tividade e disponibilidade do serviço e corrigir quaisquer erros de conexão relativos
ao firewall ou a rede interna da empresa.

1.2 CAPICOM
Para que seja possı́vel instalar e gerenciar corretamente os certificados para o uso
com a NF-e, é necessário instalar a última versão da CAPICOM2 . Após a instalação,
é necessário se certificar que o servidor COM+ da CAPICOM foi devidamente registrado
durante a instalação. Para isso, abra um prompt de comando MS-DOS e localize o diretório
C:\Arquivos de programas\Microsoft CAPICOM 2.1.0.2\Lib\X86 3 . Neste diretório, exe-
cute o comando regsvr32 capicom.dll, como mostrado na Figura 1.1.

Figura 1.1: Registro do servidor COM+ da CAPICOM

Se tudo estiver correto, uma mensagem como a da Figura 1.2 será exibida após alguns
segundos, confirmando que o registro do servidor COM+ foi realizado com sucesso.

1.3 Certificado Tipo A1 ou A3

Para a assinatura e transmissão das Notas Fiscais eletrônicas, é usado um certificado
digital, que nada mais é do que um arquivo eletrônico que identifica uma pessoa fı́sica ou
jurı́dica através de um dispositivo de criptografica assegurando confiabilidade e autenti-
cidade das transações realizadas via Internet. O certificado digital tem validade jurı́dica
2
Disponı́vel em http://www.microsoft.com/downloads/details.aspx?FamilyID=860EE43A-A843-462F-
ABB5-FF88EA5896F6&displaylang=en
3
Este diretório poderá ser diferente de acordo com a localização da sua instalação da CAPICOM.

2
 Figura 1.2: Confirmação do registro de servidor COM+

como uma assinatura de próprio punho, comprovando que seu proprietário concorda com
as informações do documento assinado. Os modelos suportados para emissão de NF-e são:

Certificados tipo A1 São gerados e armazenados no computador pessoal do usuário,

não sendo necessário o uso de cartões inteligentes ou qualquer outro dispositivo. Os
dados podem ser protegidos por uma senha de acesso, criada pelo usuário e somente
com esta senha é possı́vel acessar, mover e copiar sua chave privada. Por medida de
segurança, recomenda-se que um único computador armazene o par de chaves tipo
A1 e apenas uma cópia de segurança seja criada. A validade deste tipo de certificado
é de um ano, contado a partir de sua data de emissão.

Certificados tipo A3 Oferecem maior segurança, já que seu certificado é gerado, ar-
mazenado e processado em cartão inteligente (SmartCard) ou token (espécie de hard-
lock para conexão na porta USB), que permanece assim inviolável e único. Apenas o
detentor da senha de acesso, criada no momento da validação, pode utilizar a chave
privada. O certificado digital tipo A3 possui validade de 3 anos.

Vale lembrar que a decisão sobre qual tipo de certificado utilizar fica totalmente a cargo
da empresa, já que o AsixNFe suporta os dois tipos de certificado.

1.4 Instalação do Plugin

A forma mais simples de determinar se o plugin para NF-e foi instalado corretamente é
executar o múdulo de faturamento (Fat 32.exe) e acessar o menu Processos > Nota Fiscal >
Processos. Se estiver tudo em ordem, haverá uma opção chamada Notas Fiscais Eletrônicas
(NF-e) no último item de menu4 . Caso esta opção não esteja presente, o plugin não está
corretamente instalado na máquina. Verifique a existência do arquivo AsixNFe.plugin 5 .
Caso ele exista, verifique também se o arquivo de licença de uso6 . Se algum destes arquivos
não existir, significa que a NF-e não foi instalada - neste caso você deve procurar seu
4
Esta posicção poderá ser diferente de acordo com os plugins já instalados em sua versão do Asix.
5
Dependendo do caso, o arquivo pode se chamar AsixNFe.dll.plugin.
6
Qualquer arquivo com a extensão “.license”. Note que só é possı́vel ter uma licença em um único
diretório.

3
consultor ou entrar em contato com a Omega Consultoria para a aquisição da NF-e. Caso
você tenha os arquivos e a NF-e não esteja disponı́vel mesmo assim, entre em contato com
o suporte informando o nome dos seus arquivos, o tamanho deles e os dados da sua empresa
(CNPJ, Serial, etc.).

1.5 Dados Básicos da Empresa

É importante garantir que alguns dados da empresa estejam corretos antes da utilização
da NF-e. Confira o seu CNPJ e Inscrição Estadual e garanta que eles são válidos7 . Também
é essencial garantir que o municı́pio, estado e paı́s em que a empresa opera estão cadastrados
corretamente, pois caso exista alguma divergência em relação aos cadastros da SEFAZ, as
notas fiscais não serão aceitas. Lembre-se que o sistema considera apenas os dados da
empresa cujo flag “Ativa” esteja verdadeiro no cadastro de empresas.

1.6 Dados Básicos do Cliente

Assim como a empresa, o cliente também deve ter as informações básicas para que seja
possı́vel emitir uma NF-e. As informações são as mesmas discutidas na seção anterior, ou
seja, você deve certificar-se que o CNPJ ou CPF do cliente esteja correto assim como seu
IE (que, caso não seja aplicável deverá ser informado como ISENTO), municı́pio e estado.

1.7 Dados Básicos do Produto

Antes de começar a utilizar a NF-e, certifique-se que os dados do seu cadastro de
estoque estão o mais completos e coerentes o possı́vel checando, por exemplo, se as unidades
comerciais estão preenchidas assim como o código EAN (se aplicável).

1.8 Municı́pio, Estado e Paı́s

Graças às exigências na geração de NF-e, foram adicionados nos cadastros de Municı́pio,
Estado e Paı́s o campo de Código do IBGE8 que deve ser preenchido corretamente para
evitar rejeição na nota. Como mostrado na Figura 1.3, o campo pode ser preenchido com
o auxı́lio do botão de Consulta.
7
Importante: Caso sua empresa esteja isenta de Inscrição Estadual, informe o valor ISENTO neste
campo.
8
No caso do paı́s, o campo se chama “Código BACEN”.

4
 Figura 1.3: Cadastro de Municı́pios

1.9 Teste de Conectividade

O últimp passo é testar a conectividade e disponibilidade do sistema. Para isso, dentro

do Cadastro de Notas Fiscais utilize a opção Processos > Notas Fiscais Eletrônicas (NFe) >
Consulta de Status do Serviço. Selecione o certificado desejado na janela seguinte e dentro
de alguns segundos será dada a resposta. Caso o serviço esteja operante, uma mensagem
semelhante a da Figura 1.4 será exibida. Qualquer mensagem diferente poderá indicar um
problema interno (cheque se a rede interna e a conexão com a internet estão funcionando
normalmente) ou que o serviço está indisponı́vel temporariamente, sendo necessário entrar
em regime de contingência, uma modalidade que será discutida em maiores detalhes no
capı́tulo 3.

5
Figura 1.4: Resultado positivo da consulta de Status do Serviço

6
Capı́tulo 2

Gerenciando NF-e

2.1 Introdução
A obrigatoriedade do uso da NF-e em substituição dos modelos 01 e 1A adicionou novas
interfaces e novos processos para a emissão de Nota Fiscal dentro do sistema. Além da
rotina habitual de faturamento, agora é necessário também gerar e transmitir a nota fiscal à
SEFAZ antes de poder imprimir o DANFE - Documento Auxiliar de NotaFiscal Eletrônica,
que deve acompanhar a mercadoria. Com exceção do processo de contingência1 , o processo
de Gerenciamento de NF-e pode ser dividido nos seguintes tópicos:

• Geração de uma NF-e

• Criação do Lote de NF-e

• Envio e recepção do lote

• Notas Fiscais Aceitas e Rejeitadas

• Notas Fiscais Canceladas

• Consultando e exportando NF-e

No decorrer deste capı́tulo, estaremos fazendo uma breve análise de cada um destes
tópicos, explicando quais são as opções disponı́veis e quais os passos a seguir durante cada
etapa. Para uma consulta rápida, no final deste capı́tulo serão mostrados os possı́veis
status tanto do lote quanto da NF-e em si, assim como um pequeno resumo de cada status
possı́vel. Lembre-se que antes de realizar qualquer um destes procedimentos é necessário
garantir que a sua instalação da NF-e foi concluı́da corretamente e existe conectividade
com o sistema de recebimento da SEFAZ. Para maiores informações, consulte o capı́tulo 1.
1
Que será tratado no capı́tulo 3.

7
2.2 Geração de uma NF-e
A geração de uma NF-e pelo sistema é um processo relativamente simples. Inclua a
Nota Fiscal normalmente através do cadastro de Notas Fiscais em Fat 32 > Processos >
Nota Fiscal. Feito isso, use a opção Faturar N.F., mostrada na Figura 2.1. Note que
algumas das opções antigas deste menu foram removidas porque não se enquadram mais
no processo de geração de NF-e2 . O menu deverá estar semelhante ao mostrado na Figura
2.1.

Figura 2.1: Menu de Faturamento

Após o faturamento, será exibida a janela de seleção de certificados (Como mostrada na

Figura 2.2), onde você deve selecionar o certificado A1 ou A3 para prosseguir. Dependendo
do seu certificado, será necessário informar a sennha também. Após alguns segundos, o
controle retornará para a interface de Cadastro de Notas e a nota fiscal eletrônica terá sido
gerada. Para conferir a geração da NF-e, podemos acessar a interface de Gerenciamento de
NF-e, localizada no menu Processos > Notas Fiscais Eletrônicas (NFe) > Gerenciamento
de NFe, como mostrada na Figura 2.3.
Esta opção irá exibir a interface mostrada na Figura 2.4, que permite o gerenciamento nas
Notas Fiscais Eletrônicas emitidas. Para verificar a nota recém-criada, certifique-se que o
filtro está apontando para notas fiscais com o status Gerada e que a data de emissão da
nota fiscal esta dentro do filtro especificado.
2
A mais notável é que não existe mais a opção Faturar e Imprimir, pois a partir do momento em que
a NF-e é emitida, não deve ser impressa a nota fiscal em papel - apenas o DANFE.

8
 Figura 2.2: Janela de seleção de Certificado

Figura 2.3: Menu de Gerenciamento de Notas Fiscais Eletrônicas

9
 Figura 2.4: Gerenciamento de NF-e

2.3 Criação do Lote de NF-e

A simples geração da NF-e não garante sua validade jurı́dica e não permite a emissão
do DANFE, necesário para acobertar o transporte da mercadoria. Para poder emitir o
DANFE, a nota fiscal deverá ser aceita e autorizada pela SEFAZ. É nesse momento que
entra o Lote de NF-e, pois a sefaz nunca faz a análise da NF-e em si e sim de um lote
contendo uma ou mais notas fiscais. Dentro da interface de Gerenciamento de NF-e, a
geração de um lote resume-se a selecionar as notas que farão parte do lote e, com o botão
direito do mouse, utilizar a opção Gerar Lote de NFe, exibida na Figura 2.5.

Figura 2.5: Menu de opções da NF-e

10
 Note que só é possı́vel gerar o lote de notas fiscais com o status Gerada, e que a seleção
das notas fiscais é feita através do checkbox, como mostrado na Figura 2.6

Figura 2.6: Gerando um novo Lote de NF-e

2.4 Envio e recepção do lote

Depois de gerado, o lote ainda precisa ser enviado e processado pela SEFAZ para que
(caso não existam quaisquer problemas nos dados) a autorização de uso seja dada. O
primeiro passo é transmitir o lote já existente e para isso devemos novamente recorrer à
interface de Gerenciamento de NF-e, usando desta vez a aba Lotes de NFe. Nesta aba,
localize o lote que será transmitido e clique com o botão direito para abrir um menu de
opções como mostrado na Figura 2.7.

Figura 2.7: Menu de opções do Lote de NF-e

11
 Como o lote ainda não foi transmitido, usaremos a opção Enviar Lote, que irá transmitir
o lote de notas fiscais para a SEFAZ e recuperar um número de protocolo como resposta.
Se não houve nenhum problema no envio, será exibida uma mensagem como a mostrada na
Figura 2.8 e o número de protocolo será exibido no grid de dados dos lotes. Essa mensagem
indica apenas que o lote foi enviado com sucesso à SEFAZ e não que as notas do lote
estão com uso autorizado.

Figura 2.8: Confirmação de Envio de Lote

Quando o lote é recebido pela SEFAZ, ele entra em uma fila de espera, aguardando
sua vez para que o sistema da SEFAZ consiga abrir o lote, inspecionar cada uma das
notas contidas, checando a validade da assinatura assim como a consistência dos dados
da nota e armazenar o resultado do processamento e autorização de cada uma das notas
individualmente. Algum tempo após o envio3 , o contribuinte deverá consultar o resultado
3
A recomendação segundo o manual de integração da nota fiscal eletrônica é uma espera de, no mı́nimo,

12
do processamento de lote usando como referência o número do protoclo obtido no momento
do envio. Na interface de Gerenciamento de NF-e, esta tarefa é feita através da opção
Consultar Recibo (ver Figura 2.7), que irá verificar o resultado deste processamento e exibir
uma mensagem indicando o resultado do lote (como um todo) e cada nota individualmente,
por chave de acesso4 , como mostrado na Figura 2.9, que mostra um lote com uma única
NF-e cuja autorização de uso foi permitida.

Figura 2.9: Resultado do Processamento de Lote

2.5 Notas Fiscais Aceitas e Rejeitadas

Após o resultado do processamento do lote, poderão acontecer duas coisas: a nota fiscal
será aceita 5 ou rejeitada. Caso a nota seja aceita, ela já tem validade jurı́dica assegurada
15 segundos antes de consultar o resultado do processamento de um lote.
4
De um modo geral, a chave de acesso é um identificador único para a nota fiscal eletrônica e que pode
ser usado para que, por exemplo, o destinatário verifique a autenticidade de uma NF-e. Para maiores
detalhes, consulte a documentação disponı́vel no Portal da Nota Fiscal Eletrônica, através do endereço
http://www.nfe.fazenda.gov.br/portal/
5
Também referida como autorizada.

13
e é possı́vel imprimir o DANFE através do menu Impressão > DANFE (Normal), como
mostrado na Figura 2.10. O DANFE segue um modelo próprio, criado pelo governo e
contém apenas algumas das informações referentes à nota fiscal. É importante ressaltar
que o DANFE não é uma nota fiscal e por isso haverão algumas divergências em
relação ao layout e conteúdo das antigas notas fiscais modelos 01 e 1A.

Figura 2.10: Menu de Impressão (Gerenciamento de NF-e)

Caso ocorra algum problema, a nota fiscal será marcada como rejeitada e o lote associ-
ado a esta nota passará para o status Erro, mesmo que apenas uma das notas do lote seja
rejeitada. Vale lembrar que uma única rejeição não invalida o lote todo, ou seja, as notas
cujo status for de aceitação poderão ter o DANFE impresso normalmente e apenas a nota
rejeitada deverá ser corrigida e reenviada em um lote distinto.
Mas como proceder para corrigir uma NF-e rejeitada ? O método é simples: primeira-
mente, você deverá localizar a nota fiscal rejeitada e estorná-la para poder corrigir os erros
que resultaram em sua rejeição. Após a correção, é necessário faturar a nota novamente,
processo que irá gerar uma nova NF-e, com uma nova chave de acesso. A partir daı́,
você obtém uma nova NF-e e pode proceder normalmente, gerando um lote, enviando e
consultando seu retorno.

2.6 Notas Fiscais Canceladas

Mesmo após ser aceita, pode ser que algum dado da nota fiscal tenha sido informado de
maneira incorreta e precise ser corrigido. Infelizmente, ainda não existe uma maneira de
corrigir algum eventual erro na nota fiscal eletrônica6 - a única solução disponı́vel é cancelar
a NF-e e emitir outra nota fiscal, com os dados corretos. Para cancelar a NF-e, é necessário
primeiro usar o filtro para a exibir apenas as notas aceitas7 . Localize a nota a ser cancelada
e clique com o botão direito do mouse para exibir o menu de opções mostrado na Figura
2.5 e selecione a opção Cancelar NFe. Será necessário informar uma justificativa para o
cancelamento e selecionar o certificado. Dentro de alguns segundos haverá um retorno e
caso o cancelamento seja bem sucedido, será mostrada uma mensagem semelhante à Figura
2.11.
6
O governo prevê o uso da carta de correção eletrônica, porém seu layout ainda não foi definido,
portanto não é possı́vel utilizá-la.
7
Por razões óbvias, só é possı́vel cancelar notas aceitas.

14
 Figura 2.11: Confirmação de Cancelamento de NF-e

Este processo só é válido se a nota fiscal do sistema estiver com o status Cancelada (ou
seja, você deve primeiro cancelar a nota no Asix para depois cancelar a NF-e). Para facilitar
o processo, sempre que uma nota do Asix for cancelada o sistema iré verificar a existência de
uma NF-e associada a nota e irá confirmar a execução automática do cancelamento da NF-
e. Caso você confirme, será enviada a mensagem de cancelamento de NF-e para a SEFAZ
automaticamente, sem a necessidade de realizar o processo através do Gerenciamento de
NFe. É importante lembrar que caso a NF-e seja cancelada, será necessário gerar uma
outra nota fiscal no sistema, com um número distinto. Caso esta regra não seja seguida, a
SEFAZ irá rejeitar a NF-e dizendo que sua numeração foi cancelada.

15
2.7 Possı́veis Status de NF-e e Lote de NF-e
Veja abaixo as tabelas com os possı́veis status da NF-e e do lote de NF-e, assim como
uma breve explicação de seu significado. Você pode utilizar esta tabela como uma referência
rápida para saber quais ações são aplicáveis em uma NF-e de acordo com seu status.

Status Descrição
Gerada A nota fiscal foi faturada e uma NF-e foi criada e assinada. Caso esta nova
seja estornada e faturada novamente, o conteúdo da NF-e será reescrito
mas a chave de acesso continuará a mesma.
Em Lote Significa que a nota está associada a um lote. Caso seja estornada e
faturada novamente, uma nova NF-e será criada.
Aceita A nota foi aceita e o DANFE pode ser impresso. Caso a nota seja estor-
nada ela deverá ser cancelada.
Rejeitada Por algum motivo, a NF-e não foi aceita. Caso a nota seja estornada e
faturada novamente, uma nova NF-e será gerada.
Cancelada A NF-e foi aceita, mas por algum motivo qualquer foi necessário optar
por seu cancelamento.
Inutilizada Indica que a numeração desta nota será ”pulada”. Para maiores detalhes,
consulte o Capı́tulo 3

Tabela 2.1: Possı́veis Status da NF-e

2.8 Consultando e exportando NF-e

Além das tarefas mais habituais de transmissão, consulta e impressão do DANFE, a
interface de Gerenciamento de NF-e tem outras duas funções extras que são úteis em alguns
casos: a Exportação de NFe e a Consulta de Status da NF-e.

2.8.1 Exportando NF-e

Em qualquer momento é possı́vel visualizar o conteúdo de uma NF-e e, opcionalmente,
salvá-lo para um arquivo. Para utilizar esta função, localize a NF-e na interface de geren-
ciamento de NF-e, clique com o botão direito na NF-e desejada e use a opção Detalhes.
Será exibida uma interface semelhante a Figura 2.12, que mostra o conteúdo da NF-e
formatado de uma maneira mais amigável. Cada seção da NF-e pode ser expandida ou
retraı́da clicando nos sinais de [+] e [-]8 .

8
Na Figura 2.12, a lista de itens da nota foi expandida, assim como seu primeiro item.

16
 Status Descrição
Não Enviado O lote foi criado, mais ainda não foi transmitido à SEFAZ.
Transmitido O lote foi enviado com sucesso à SEFAZ, mas o resultado de seu proces-
samento ainda não é conhecido.
Aceito O lote foi processado com sucesso e todas as suas notas fiscais foram
aceitas.
Erro O lote não foi processado ou ao menos uma de suas notas foi rejeitada.
Apesar de mostrar o lote como erro, caso alguma NF-e tenha sido aceita,
ela continuará sendo válida e o DANFE poderá ser impresso normal-
mente.

Tabela 2.2: Possı́veis Status do lote de NF-e

17
Figura 2.12: Interface de detalhes da NF-e
 Além de visualizar a NF-e, esta janela permite visualizar outras mensagens relativas a
esta NF-e9 e permite salvar o conteúdo original da NF-e10 para a Área de Transferência11
ou para um arquivo em disco.

2.8.2 Consultando Status da NF-e

Em algumas situações (normalmente, problemas técnicos ou de conexão com a SEFAZ),
é possı́vel que uma NF-e do sistema esteja “fora de sincronia” em relação aos dados da
SEFAZ. Em casos como este, existe a opção de fazer uma consulta à SEFAZ pelo sistema
e, se necessário, atualizar o status da NF-e dentro do sistema. Para isso, selecione a NF-e
que deseja fazer a consulta, clique com o botão direito e utilize a opção Consultar Status
da NFe. Esta opção envia uma mensagem de consulta à SEFAZ, que retorna o status atual
da nota. Caso o status esteja diferente do indicado no sistema, você pode utilizar a opção
Atualizar Status para atualizar o sistema com o status da NF-e retornado pela SEFAZ12 .

9
Usando as abas “Retorno Inutilização” e “Retorno Cancelamento”.
10
O XML e sua assinatura, sem formatação.
11
Sinônimo de “Clipboard”.
12
Importante: Não é possı́vel desfazer esta atualização.

18
Capı́tulo 3

DANFE em Contingência

3.1 Introdução
Em algumas circunstâncias o processo de envio e recebimento de resultado dos lotes de
NF-e não pode ser seguido. Se, por exemplo, houver algum tipo de problema com a conexão
da internet ou até mesmo com a comunicação com a SEFAZ, é necessário entrar em modo
de contingência, gerando assim o DANFE de contingência, em formulário de segurança e
enviar a NF-e gerada em contingência para a SEFAZ quando o problema for sanado. Neste
capı́tulo, discutiremos os principais tópicos da geração do DANFE em Contingência:

• Utilizando o SCAN

• Gerando o DANFE em Contingência

• Inutilizando as Notas Fiscais

• Exemplo: Falha durante consulta de um lote transmitido

3.2 Utilizando o SCAN

Quando ocorrerm problemas técnicos ou algum tipo de manutenção programada, a
SEFAZ irá ativar o ambiente SCAN1 para receber as notas fiscais em seu lugar. O SCAN
está preparado para receber todas as notas (e emitir a autorização de uso) enquanto durar
a contingência e depois repassá-las à SEFAZ, quando o problema for sanado. Existem
apenas dois requisitos para utilizar o SCAN: o primeiro é que a SEFAZ tenha ativado
o serviço (não é possı́vel enviar ao SCAN a qualquer momento e sim apenas quando a
SEFAZ autorizar a ativação do SCAN) e que a nota fiscal tenha o número de série 999.
Este número de série é especialmente reservado para recebimento de NF-e pelo ambiente
SCAN. Utilizando o SCAN, o processo de geração envio e recebimento é idêntico ao que
foi discutido no capı́tulo 2, a única diferença é a série da nota fiscal.
1
Sistema de Contingência do Ambiente Nacional.

19
3.3 Gerando o DANFE em Contingêcia
Antes mesmo de gerar o DANFE em modo de contingência, verifique se o problema de
conectividade não é um problema interno da sua empresa e se o ambiente SCAN não foi
disponibilizado pela SEFAZ. Constatada a necessidade de entrar em modo de contingência,
localize a nota fiscal e acesse o menu Processos > Nota Fiscal Eletrônica (NFe) > Imprimir
DANFE (Contingência), localizado na interface de cadastro de Notas Fiscais. Dependendo
do status da nota um diferente processo será realizado:

Notas Fiscal ainda não faturada O processo não será executado, porque neste caso
não existe uma NF-e associada à nota fiscal para entrar em contingência. Neste caso,
deve-se faturar a nota antes de entrar em contingência.

NF-e Aceita ou Cancelada O processo não será executado porque não faz sentido gerar
o DANFE nem de uma NF-e cancelada e nem de uma NF-e aceita2 .

NF-e ainda não transmitida A NF-e será gerada e marcada como tipo contingência.
Em seguida, será feita a impressão do DANFE em contingência.

NF-e transmitida, mas sem retorno Este é o pior caso. Em um cenário como esse,
é necessário criar uma NF-e em contingência sem que isso ponha em cheque a in-
tegridade dos dados já enviados à SEFAZ mas cuja resposta não foi possı́vel obter.
Neste cenário, uma nova nota fiscal será criada3 , idêntica a que queremos que seja
emitida em contingência. Esta nova nota fiscal deverá ser faturada e a opção Im-
primir DANFE (Contingência) deverá ser usada com a nova nota fiscal. Quando a
contingência for sanada, a nota “antiga” deverá ser tratada de acordo com o descrito
na seção 3.4.

NF-e já está em contingência Neste caso, será exibido apenas o preview da impressão
de NF-e em Contingência.

Quando o problema que originou a contingência for sanado, as notas geradas durante
a contingência deverão ser transmitidas para a SEFAZ da mesma maneira que as notas
normais: você deve gerar um lote, transmitı́-lo e esperar um retorno4 . É muito importante
lembrar que, em hipótese nenhuma, deve ser feita a impressão de uma nota fiscal nos
modelos 01 e 1A, pois se isso ocorrer a empresa será tributada duas vezes, já que esta
atitude será considerada uma nova emissão de nota fiscal.
2
Lembre-se: a única coisa que pode ser feita com uma NF-e aceita (além da impressão do DANFE) é
cancelá-la
3
O sistema pede uma confirmação antes de realizar esta ação, veja a Figura 3.2, a seguir.
4
Atente-se para o prazo de até 30 dias para realizar este envio. Passado este tempo, a demora deverá
ser informada e justificada junto ao Posto Fiscal.

20
3.4 Inutilizando as Notas Fiscais
Após resolvido o problema, as notas em contingência deverão ser transmitidas para
a SEFAZ utilizando o processo padrão, descrito no Capı́tulo 2. Mas o que fazer com as
notas transmitidas cujo retorno ainda é desconhecido ? Neste caso, o primeiro passo é
consultar processamento do lote para saber qual atitude será tomada. Caso a NF-e tenha
sido aceita, ela deverá ser cancelada, porque ela já transitou como NF-e de contingência.
Se a NF-e foi rejeitada, ela deverá ser inutilizada. Isso tem que ocorrer porque o DANFE
de contingência foi feito em uma nota fiscal com um número diferente da nota rejeitada,
ou seja, a numeração foi “pulada” e teve sua sequência quebrada. Para evitar problemas
com o fisco, será necessário inutilizar a NF-e rejeitada (afinal, foi o número dela que foi
“pulado”).
O processo de inutilização é bem simples: primeiramente, você deve acessar a interface de
Gerenciamento de NFe e localizar a NF-e a ser inutilizada. Feito isso, clique com o botão
direito do mouse para exibir o menu mostrado na figura 2.5 e selecione a opção Inutilizar
NFe. Após informar a justificativa, selecionar o certificado e esperar por alguns segundos,
o sistema irá exibir o resultado da inutilização, que caso seja bem sucedida irá apresentar
uma mensagem semelhante à mostrada na figura 3.1.
Fique sempre atento à necessidade de cancelar ou inutilizar as notas necessárias quando
a contingência for sanada porque no caso de notas aceitas, o não cancelamento irá fazer
com que a empresa seja tributada duas vezes (contando a nota aceita mais a nota criada
durante a contingência) e a não inutilização nos casos adequados irá gerar uma quebra de
numeração, que deverá ser justificada ao Posto Fiscal.

3.5 Exemplo: Falha durante consulta de um lote trans-

mitido
Para resumir o que vimos neste capı́tulo, vamos assumir a geração de duas notas fiscais,
que chamaremos respectivamente de NotaA e NotaB, para fins didáticos. Como devemos
utilizar a NF-e em substituição aos modelos 01 e 1A, devemos faturar as duas notas que irão
gerar duas notas fiscais eletrônicas, que chamaremos de NFeA e NFeB. Depois da geração
das notas eletrônicas, devemos transmitı́-las dentro de um lote, que chamaremos de LoteA.
Conforme o esperado, recebemos a confirmação de que o lote foi enviado e seu respectivo
número de protocolo, mas quando vamos consultar o status deste lote para imprimir o
DANFE nos deparamos com um problema: a conexão com o provedor de internet foi
perdida e o serviço só voltará a funcionar dentro de algumas horas5 . O que fazer neste caso
?
Devemos então, entrar em modo de contingência. Primeiramente , iremos localizar a
NotaA e utilizar a opção Imprimir DANFE (Contingência), mas como a NF-e associada
5
Este é um exemplo de situação que o SCAN não poderá ser usado (se não há conexão com a internet,
não é possı́vel acessar o SCAN)

21
 Figura 3.1: Confirmação de Inutilização de NF-e

(ou seja, a NFeA) já foi transmitida não podemos entrar em contingência com esta nota e
o sistema sugere a geração de um cópia da nota fiscal, como na Figura 3.2.
Após confirmar a cópia, uma nova nota fiscal, NotaC terá sido criada, com conteúdo
idêntico ao da nota fiscal original. Repetimos o processo com a NotaB para gerar uma cópia
que chamaremos de NotaD e em seguida faturamos tanto NotaC quanto NotaD, gerando
as notas fiscais eletrônicas NFeC e NFeD, respectivamente. Após o faturamento, usaremos
a opção Imprimir DANFE (Contingência) em NotaC e NotaD para marcá-las como notas
de contingência e imprimir o DANFE de contingência que acompanhará a mercadoria.
Se fosse necessário incluir uma NotaX, deverı́amos apenas inserı́-la no sistema, faturar e
utilizar a opção de contingência diretamente (não é necessário criar uma cópia da nota
porque ela ainda não foi transmitida, conforme explicado na seção 3.3).
Horas depois, o motivo da contingência já foi sanado e as notas fiscais eletrônicas
deverão ser transmitidas para a SEFAZ. O primeiro passo é gerar um LoteB contendo

22
 Figura 3.2: Confirmação de Cópia de Nota Fiscal

NFeC e NFeD, transmitı́-lo e consultar seu retorno6 . Isso nos deixa apenas uma última
tarefa: resolver os status de NFeA e NFeB. Para isso, devemos consultar o resultado do
processamento de LoteA7 , que nos indicou que NFeA foi aceita e NFeB foi rejeitada.
Por um lado temos NFeA, que apesar de ter sido aceita, a mercadoria a que se refere
já foi enviada através da NotaC, que foi gerada em contingência. O correto neste caso, é
cancelar a NFeA porque a nota “de verdade” é a NFeC. Do outro lado temos a NFeB que
foi rejeitada e acabou sendo substituı́da pela NFeD, gerada em contingência. Como NFeB
não foi aceita, seu numeração foi “pulada”, então devemos inutilizá-la.

6
Caso o retorno não seja positivo, proceda normalmente como mostrado no Capı́tulo 2.
7
Lembre-se que entramos em contingência imediatamente antes de poder obter este retorno.

23
24
Capı́tulo 4

Dúvidas Frequentes

4.1 Dúvidas Gerais

4.1.1 Porque o diálogo de seleção de formulário aparece mais de

uma vez em alguns processos ?

Porque alguns dos processos exigem a assinatura digital de sua mensagem, além do
envio. Estes dois processos precisam de um certificado para funcionar, o que faz com que
alguns casos, como do cancelamento, apresentem o diálogo de seleção mais de uma vez
seguidamente.

4.1.2 Existe alguma maneira de evitar que o sistema mostre a

janela de seleção de certificado a toda hora ?

Sim, marcando o checkbox com o tı́tulo Usar este certificado como padrão e não per-
guntar novamente. Note que, caso o certificado torne-se inválido ou indisponı́vel, você
deverá excluir manualmente o arquivo DefCertificado.res para que a janela de seleção de
certificados seja exibida novamente.

4.1.3 Porque tenho que informar a senha do meu certificado a

todo momento ? É possı́vel mudar este comportamento ?

Infelizmente, não é possı́vel alterar este comportamento através do sistema, pois o

controle de quando e como a senha é pedida é feita através do próprio software que controla
o certificado. Normalmente a senha é pedida de tempos em tempo no certificado tipo A3.

25
4.2 Sobre o DANFE
4.2.1 Em que tipo de formulário devo imprimir o DANFE ?
Só é preciso se preocupar com o DANFE em modo de contingência, que deve ser im-
presso em um formulário especial. Para adquirir este formulário, entre em contato com a
SEFAZ para saber quais fornecedores estão autorizados a vender um formulário de con-
tingência.

4.2.2 O modelo de DANFE impresso não contém todas as infor-

mações da nota. Como resolvo isso ?
Isso não é um problema. O modelo do DANFE foi denifido pela própria SEFAZ e, em
comparação com uma impressão de nota fiscal, algumas informações estão faltando mesmo.
Lembre-se que o DANFE não é uma nota fiscal. Ele serve apenas para acobertar o trânsito
da mercadoria e não tem validade jurı́dica.

4.2.3 Mas está faltando o campo “X” no DANFE ! Sem isso, não
consigo trabalhar !
Como explicado na questão acima, o modelo é definido pela prórpia SEFAZ e o DANFE
não tem validade jurı́dica. Ao invés de basear-se no DANFE, o correto é basear-se no
conteúdo do arquivo XML transmitido à SEFAZ - ele sim contém todas as informações
detalhadas e é válido juridicamente. Pode parecer estranho no começo, mas o hábito de
basear-se apenas em um pedaço de papel não é mais válido no contexto da NF-e (exceção:
DANFE impresso em formulário de contingência).

4.3 SCAN e Regime de Contingência

4.3.1 O AsixNFe dá suporte à contingência pelo ambiente SCAN
?
Sim. Para maiores informações sobre a configuração do SCAN, consulte o capı́tulo 3,
item 3.2.

4.3.2 Posso entrar em regime de contingência a qualquer mo-

mento ?
Não, pois a recomendação é utilizar o regime de contingência apenas nos casos es-
tritamente necessários. Caso a SEFAZ detecte uma emissões constantes em regime de
contingência aparentemente sem necessidade, é possı́vel que a empresa tenha que apre-
sentar uma justificativa. Note que sempre que houver algum problema técnico, a SEFAZ

26
deverá primeiramente ativar o ambiente SCAN e é recomendado que o contribuinte utilize
este ambiente ao invés de gerar o DANFE de contingência.

4.4 Envio de NF-e por email

4.4.1 Alguns de meus clientes querem que eu envie a NF-e (XML)
para eles por e-mail. É possı́vel fazer isso pelo sistema ?
Existem duas maneiras de fazer isso: manualmente, salvando a NF-e em disco como
mostrado na seção 2.8.1 e enviando por email ou utilizando o Workflow, cuja configuração
é explciada em detalhes no Apêndice A.

4.4.2 O conteúdo da NF-e que vai para o cliente por email é

diferente do conteúdo gerado caso eu salve a NF-e em disco
manualmente. Qual é o problema ?
Nenhum. A diferença é que no envio através do Workflow são adicionadas informações
sobre o protocolo da NF-e autorizada pela SEFAZ. O conteúdo em si da NF-e é o mesmo.

4.4.3 Algumas das notas enviadas através do workflow não con-

tém as informações adicionais sobre o protocolo da NF-e.
Como corrigir isso ?
Isso acontece porque, por alguma razão qualquer, o sistema não conseguiu recuperar e
adicionar estas informações extras da nota fiscal. Quando isso ocorre, uma cópia da nota
“original”1 é enviada em seu lugar. Infelizmente não é possı́vel determinar a causa desta
ocorrência sem maiores informações sobre o seu ambiente de trabalho.

1
Isto é, sem os dados extras.

27
28
Apêndice A

Configurando NF-e e Workflow

É possı́vel configurar o sistema para que ele envie a NF-e já aprovada automaticamente
por e-mail para o cliente, usando a função de Workflow do sistema. Utilizando esta fun-
cionalidade, o envio de NF-e por e-mail é reduzido a um clique, o que torna o processo
muito mais simples e prático.

A.1 Configurações Básicas

Antes mesmo de iniciar a configuração da mensagem de e-mail, é necessário checar
algumas configurações e permissões do usuário para integração com Workflow. As seguintes
configurações devem ser feitas (todas elas através do módulo Inı́cio (Inicio.exe):

1. Certifique-se que a empresa está configurada para usar o Workflow (veja Figura A.1).

2. Certifique-se que o usuário tem permissão de uso da transação SNDNFE, como

mostrado na Figura A.2.

3. Verifique se os dados da conta SMTP do usuário estão configurados corretamente

através do menu Processos > E-mail, localizado na interface principal do módulo Inı́-
cio (ver Figura A.3). Caso tenha dúvidas sobre como preencher estes campos, contate
o administrador da sua rede ou o seu provedor de e-mail para maiores informações.

4. Verifique se o cliente tem um e-mail em seu cadastro. Você pode usar o campo E-Mail
ou o campo E-Mail Workflow 1 para isso.

1
A justificativa para a existência destes dois campos é que algumas empresas criaram um e-mail especı́-
fico apenas para recebimento de NF-e.

29
Figura A.1: Configuração do Cadastro de Empresas (Workflow)

Figura A.2: Permissão de envio de NF-e por e-mail (Workflow)

30
 Figura A.3: Configuração de SMTP (Workflow)

A.2 Configurando a criação do e-mail

Agora, é necessário configurar como o e-mail será criado pelo sistema, usando para isso a
interface de configuração disponı́vel em Processos > Config. E-Mail (Workflow) disponı́vel
na interface inicial do módulo Inı́cio. Dentro do cadastro que será exibido (ver Figura A.4,
no fim da listagem), adicione um novo item e configure-o conforme as instruções a seguir:

1. A transação configurada deve ser SNDNFE.

2. A opção SQL Principal deverá ser configurada para que retorne os campos que serão
necessários para os outros comandos SQL e para a elaboração da mensagem. Um
exemplo mı́nimo de SQL para este caso pode ser visto na Listagem A.1.

Listagem A.1: Exemplo de SQL Principal

1 SELECT
2 Notas . Nota ,
3 Notas . NumFat ,
4 Notas . ChaveAcesso ,
5 Cliente . Razao
6 FROM
7 Notas
8 INNER JOIN Cliente ON ( Notas . Clientes = Cliente . Clientes )
9 WHERE

31
10 Notas . Nota = : Nota
11 AND
12 Notas . NumFat = : NumFat
13 AND
14 Notas . ChaveAcesso = : ChaveAcesso

3. No botão Corpo da Mensagem é necessário definir qual será o conteúdo da mensagem

que será enviada. A definição da mensagem aceita qualquer tag HTML, além de
permitir o uso de algumas marcações especiais para referenciar os campos definidos
no SQL Principal. Veja abaixo (Listagem A.2) um exemplo de corpo da mensagem,
que irá exibir a chave de acesso e a razão social que foi definida no SQL principal
(ver Listagem A.1).
Listagem A.2: Modelo HTML de Email
1 < html >
2 < body style = " font - family : Verdana ; size :8 px ; " >
3 <! --
4 As * marcaç~
o es * abaixo s~ a o obrigatórias e devem estar na
5 primeira coluna da linha , sen~ a o o * parser * n~ a o consegue
6 identificar os comandos
7 -- >
8 [000 >]
9 Envio de NF - e [000# ChaveAcesso ] < br / >
10 Para : [000# Razao ] < br / >
11 [ < 000]
12 </ body >
13 </ html >

Lembre-se que as marcações das linhas 8 e 11 na Listagem A.2 são obrigatórias

e devem estar na primeia coluna da linha, ou seja, não deve haver espaços nem
qualquer outro caractere antes delas.

4. Defina o assunto. Na imagem de exemplo, o assunto é fixo como ”Enviando NF-e:

”seguido pelo valor da Chave de Acesso que é retornada na query principal. Customize
este campo de acordo com a sua necessidade.

5. O campo “Para” pode ser definido com um valor fixo como demonstrado acima ou
por um script customizado. Neste exemplo, o script da Listagem A.3 retorna o e-mail
do cliente da nota fiscal em questão.
Listagem A.3: Exemplo de SQL do campo “Para”
1 SELECT
2 COALESCE ( c . EmailWorkflow , c . End_Elet ) as EmailWorkflow
3 FROM
4 Notas

32
 5 INNER JOIN Cliente c ON ( Notas . Clientes = c . Clientes )
6 WHERE
7 Notas . Nota = : Nota
8 AND
9 Notas . NumFat = : NumFat
10 AND
11 Notas . ChaveAcesso = : ChaveAcesso

Se quiser, customize os campos“Cópia”e“Cópia Oculta”conforme necessário. Lembre-

se que ao invés de usar um script, é possı́vel digitar um valor fixo para cada um destes
campos.

6. Defina um script que retorne o nome de um ou mais arquivos que serão anexados à
mensagem. O plugin gera um arquivo cujo nome é “nfe-” seguido do valor da chave
de acesso da NF-e. Sabendo disso, o script da Listagem A.4 recupera o arquivo
temporário correto gerado pelo plugin e o anexa à mensagem.
Listagem A.4: SQL necessário para o anexo
1 SELECT
2 ’nfe - ’ + NFe . ChaveAcesso + ’. xml ’
3 FROM
4 NFe
5 WHERE
6 NFe . Nota = : Nota
7 AND
8 NFe . NumFat = : NumFat
9 AND
10 NFe . ChaveAcesso = : ChaveAcesso

7. Identifique o formulário de onde os dados serão retirados. Para isso, clique na lupa
e abra o módulo de Faturamento (Fat 32.exe). Localize o formulário de notas fiscais
(TFmNFV ) e selecione o componente QryPrimario.

8. Informe os campos do componente QryPrimario que serão usados como parâmetro

pela query principal definida na configuração. Os campos devem ser informados na
ordem em que forem usado e separados por “;”. No exemplo dado, o valor correto
seria Nota;NumFat;ChaveAcesso.

A.3 Enviando o e-mail para o Cliente

Após todas as configurações, o envio de e-mail é feito através da opção Enviar NF-e
para o cliente, disponı́vel no menu Processos > Notas Fiscais Eletrônicas (NFe), como
mostrado na Figura 2.3. É importante lembrar que o envio só será feito caso a NF-e

33
 Figura A.4: Configuração de Email (Workflow)

tenha sido aprovada - é possı́vel verificar esta informação na aba Nota Fiscal Eletrônica,
no cadastro de notas fiscais.

34