Configurações de Emissão¶
Em uma frase. Define, por empresa, como o app emite NF-e (modelo 55) e NFC-e (modelo 65): ambiente da SEFAZ, tipo de emissão, autorização automática ou manual, séries de numeração, leiaute do DANFE/DANFCe, e-mail de envio e envio para a Escrituração Fiscal.
Quem usa: analista fiscal, implantação · Frequência: na implantação de cada empresa e ao trocar de ambiente, série ou leiaute · Pré-requisitos: empresa cadastrada no Central Hub, com certificado digital ativo e, para envio de e-mail, um provedor liberado para o app
Para que serve¶
Sem configuração de emissão, a empresa não emite: uma nota recebida por integração para ela fica com o status de emitente não cadastrado, com a mensagem "Emitente é empresa do tenant (…), mas está sem configuração de emissão. Configure o emitente (ambiente, série, certificado) e clique em Emitir na linha da nota."
Retomar a nota depois de configurar o emitente¶
Configurada a empresa nesta tela, volte a Documentos Emitidos e clique em Emitir na linha da nota (ou selecione várias e use Reprocessar nas ações em massa). O app refaz a recepção a partir do documento original, com as mesmas regras de uma nota recém-recebida: ambiente e tipo de emissão do modelo (só para o que o documento não informou), série configurada, autorização automática ou manual e certificado. A nota sai de emitente não cadastrado e segue para a SEFAZ, ou fica aguardando o Enviar, se a autorização do modelo for manual.
Se a configuração ainda estiver faltando, a nota não muda e o Emitir avisa o que falta. Uma nota cujo emitente não é empresa do tenant (CNPJ fora do Central Hub) não é retomada por este caminho: cadastre a empresa no Hub e reenvie a nota pela integração.
Esta tela não cadastra a empresa nem o certificado. Esses dados vêm do Central Hub e aparecem aqui só para conferência. O que se configura aqui é o comportamento da emissão, separado por modelo: NF-e e NFC-e têm cada um seu ambiente, seu tipo de emissão, suas séries e seu leiaute.
Como chegar¶
- No Hub, abra o app Invent Docs Flow NF-e.
- Em Configurações, selecione o tile Emissão.
O título da tela é Configurações de Emissão e o subtítulo, "Configuração de emissão por empresa".
A tela de listagem¶
Cada linha é uma empresa que já tem configuração de emissão. Empresas do Hub sem configuração não aparecem; elas são adicionadas pelo botão Novo Emitente.
| Coluna | Conteúdo |
|---|---|
| Empresa | Razão social e, abaixo, CNPJ formatado e UF |
| Certificado | Nome do certificado ativo da empresa no Hub e o selo de situação, ou "Sem certificado ativo" |
| Config. atualizada | Data e hora da última alteração da configuração |
| Ações | Lápis (Configurar emitente) e lixeira (Remover configuração) |
A lista abre ordenada pela Config. atualizada, mais recente primeiro. As três colunas são ordenáveis. O ícone de engrenagem liga e desliga colunas, e a escolha fica gravada no navegador.
Cards de certificado¶
Os cards contam as empresas por situação do certificado e, ao serem clicados, filtram a lista:
| Card | Regra |
|---|---|
| Todos | Todas as empresas configuradas |
| Válidos | Certificado ativo e com mais de 30 dias até vencer |
| Expirando | Certificado ativo que vence em 30 dias ou menos |
| Vencidos | Validade já passou |
| Sem certificado | A empresa não tem certificado ativo no Hub |
Busca¶
A busca procura ao mesmo tempo em razão social, nome fantasia, CNPJ (só os dígitos), UF e nome do certificado. Limpar filtros zera busca e card. Atualizar recarrega empresas e configurações do Hub. Busca, filtro e paginação são feitos na própria tela, sobre a lista já carregada.
Adicionar um emitente¶
- Clique em Novo Emitente. O botão fica desligado enquanto a lista carrega ou quando o Hub não devolve nenhuma empresa ("Nenhuma empresa disponível no Hub").
- Na janela Adicionar Emitente, busque por razão social, CNPJ ou UF. Só aparecem empresas ainda sem configuração. Com todas configuradas, a janela diz "Todas as empresas já estão configuradas."
- Escolha a empresa. A tela de configuração abre com os valores padrão.
- Ajuste as abas e clique em Salvar configurações.
Nada é gravado até o Salvar. Escolher a empresa e sair pelo Cancelar não cria configuração. As exceções são as ações que gravam na hora: criar, editar, ativar e desativar série, e enviar ou remover leiaute customizado (ver abaixo).
Configuração do emitente¶
A tela tem três abas e uma barra com Cancelar e Salvar configurações. O botão de salvar grava as três abas de uma vez. Ao terminar, aparece "Configurações salvas com sucesso."
Aba «Dados do Emitente»¶
Dados cadastrais (somente leitura). "Gerenciados pelo Central Hub. Para alterações, acesse o módulo de Cadastros no Hub."
| Campo | Obrigatório | Formato / domínio | Regra | Registro / campo fiscal |
|---|---|---|---|---|
| Razão Social | — | Texto | Vem do Hub | NF-e emit/xNome |
| Nome Fantasia | — | Texto | Vem do Hub | NF-e emit/xFant |
| CNPJ | — | 14 dígitos | Vem do Hub | NF-e emit/CNPJ |
| Inscrição Estadual | — | Texto | Vem do Hub | NF-e emit/IE |
| CRT | — | 1 Simples Nacional · 2 Simples Nacional — Excesso · 3 Regime Normal · 4 MEI | Vem do Hub | NF-e emit/CRT |
| UF / Município | — | Texto | Vem do Hub | NF-e enderEmit |
Certificado Digital (somente leitura). Mostra o certificado ativo da empresa no cadastro do Hub: nome, CNPJ, tipo (A1/A3), situação (Válido, Expirando, Vencido), validade, dias para vencer e impressão digital (thumbprint). "O certificado ativo é definido automaticamente pelo cadastro da empresa no Central Hub. Esta tela apenas exibe o certificado em uso na emissão." Sem certificado: "Cadastre e ative um certificado no módulo de Cadastros do Central Hub para habilitar a emissão."
Provedor de E-mail
| Campo | Obrigatório | Formato / domínio | Regra | Registro / campo fiscal |
|---|---|---|---|---|
| Provedor de e-mail | não | Lista dos provedores de notificação liberados para o app no Hub | "— Nenhum —" desliga o envio | — |
| Enviar e-mail automaticamente ao autorizar (XML + DANFE) | não | Sim/não | Só liga com um provedor escolhido; o servidor recusa envio automático sem provedor | — |
| E-mails em cópia | não | Endereços separados por ; ou , |
Além do destinatário da nota. Endereço fora do formato nome@dominio.ext recusa o salvamento |
— |
Sem provedor liberado, a seção mostra "Nenhum provedor de e-mail disponível para este aplicativo."
Escrituração Fiscal
| Campo | Obrigatório | Formato / domínio | Regra | Registro / campo fiscal |
|---|---|---|---|---|
| Usar Escrituração Fiscal | não | Sim/não, padrão desligado | Ligado, os documentos emitidos por esta empresa seguem para o app Escrituração Fiscal. Desligado, não seguem. O que já foi enviado não é afetado | Alimenta a escrituração que gera o C100 da EFD |
O lado dos documentos recebidos tem interruptor próprio, na tela Recebimento. Salvar esta tela não altera aquele.
Aba «NF-e» (modelo 55) e aba «NFC-e» (modelo 65)¶
As duas abas têm a mesma estrutura. A chave Emissão NF-e habilitada (ou NFC-e) fica sempre ativa; com ela desligada, o resto da aba fica esmaecido.
Parâmetros de emissão
| Campo | Obrigatório | Formato / domínio | Regra | Registro / campo fiscal |
|---|---|---|---|---|
| Emissão habilitada | — | Sim/não, padrão desligado | Desligada, a nota é recebida mas não segue para autorização; ao tentar enviar, é rejeitada com "A emissão de NF-e está desabilitada para esta empresa — habilite na configuração do emitente para enviar." | — |
| Autorizar automaticamente | — | Sim/não, padrão ligado | Ligado, a nota recebida ou importada já segue para autorização. Desligado, fica em Aguardando até alguém clicar em Enviar na listagem | — |
| Usar numeração da série configurada | — | Sim/não, padrão desligado | Ligado, série e número vêm da série ativa (ver RN-EMI-006). Desligado, vêm do arquivo/JSON recebido | NF-e ide/serie, ide/nNF |
| Ambiente SEFAZ | sim | Homologação · Produção, padrão Homologação | Homologação mostra "Ambiente de testes. Notas emitidas não têm validade fiscal real." Produção mostra o alerta "Atenção: ambiente de Produção. Notas emitidas terão validade fiscal real." | NF-e ide/tpAmb (1 produção, 2 homologação) |
| Tipo de Emissão | sim | NF-e: Normal (1), Contingência SCAN (6), SVC-AN (7), SVC-RS (8). NFC-e: Normal (1), Offline NFC-e (9) | Padrão Normal | NF-e ide/tpEmis |
| Token CSC | só NFC-e | Texto, até 100 caracteres | Obrigatório para gerar o QR-Code da NFC-e | QR-Code infNFeSupl |
| ID do CSC | só NFC-e | Texto, até 10 caracteres | Idem | QR-Code infNFeSupl |
Leiaute do DANFE (NF-e) ou Leiaute do DANFCe (NFC-e)
| Opção | NF-e | NFC-e |
|---|---|---|
| Retrato | sim | sim |
| Paisagem | sim | não — "O Cupom Fiscal (NFC-e) é sempre impresso em retrato." |
| Customizado | sim | sim |
Ao escolher Customizado sem arquivo, aparece a área para arrastar ou selecionar um arquivo
.frx (leiaute do FastReport), de até 5 MB. O envio grava na hora, independentemente do botão
Salvar, e já marca o leiaute como customizado. Com arquivo enviado, aparecem Exportar (baixa
layout-modelo-55.frx ou layout-modelo-65.frx) e Remover.
Séries de Numeração¶
"Cada série controla uma sequência independente de numeração." A tabela mostra Série, Próximo Nº, Descrição, Status (Ativa/Inativa), Criada em e Última Utilização.
As ações de série gravam na hora, sem passar pelo botão Salvar:
| Ação | O que faz |
|---|---|
| + Nova Série | Abre a janela Nova Série: Número da Série (1 a 999), Próximo Número (a partir de 1) e Descrição (até 100 caracteres). A série nasce inativa |
| Editar | Altera Próximo Número e Descrição. "O número da série não pode ser alterado após a criação." |
| Ativar | Torna a série a ativa do modelo e desativa a que estava ativa |
| Desativar | Desativa a série. Bloqueado para a série ativa enquanto o modelo usa a numeração da série |
Sem série cadastrada: "Nenhuma série cadastrada. Crie a primeira série para habilitar a emissão."
Sub-telas¶
- Adicionar Emitente — janela de escolha da empresa (ver acima).
- Nova Série / Editar Série — janela da série.
- Remover configuração — confirmação com razão social, CNPJ e UF e o aviso "Esta ação não pode ser desfeita."
Regras de negócio¶
- RN-EMI-001 — Uma configuração por empresa. Cada empresa do tenant tem no máximo uma configuração de emissão, e cada modelo (55 e 65) tem sua própria configuração dentro dela.
- RN-EMI-002 — Dados cadastrais e certificado vêm do Hub. A tela não edita razão social, IE, CRT nem certificado. O certificado usado na assinatura é sempre o ativo no cadastro da empresa.
- RN-EMI-003 — Emissão desabilitada bloqueia o envio, não o recebimento. A nota entra no app, mas não vai para a SEFAZ enquanto o modelo estiver desabilitado.
- RN-EMI-004 — Autorização manual deixa a nota aguardando. Com Autorizar automaticamente desligado, a nota fica aguardando o Enviar da listagem.
- RN-EMI-005 — Ambiente e tipo de emissão são por modelo. NF-e e NFC-e da mesma empresa podem estar em ambientes diferentes.
- RN-EMI-006 — Numeração pela série exige série ativa. Não se salva o modelo com Usar numeração da série configurada ligado sem série ativa ("Não é possível usar a numeração da série de 55 sem uma série ativa configurada."). Uma nota que chega nessa situação é recusada: "Recebimento rejeitado: nenhuma série ativa configurada para NF-e."
- RN-EMI-007 — Com numeração pela série, a série e o número do arquivo são descartados. Cada nota nova consome o próximo número da série ativa. Nesse modo, o reenvio do mesmo documento só é reconhecido pela referência externa do emissor; sem ela, um reenvio vira nota nova.
- RN-EMI-008 — Uma série ativa por modelo. Ativar uma série desativa a anterior. O número da série (1 a 999) é único por empresa e modelo e não muda depois de criado.
- RN-EMI-009 — A série ativa não pode ser desativada em uso. Para trocar, ative outra série (a antiga é desativada junto) ou desligue antes a numeração pela série.
- RN-EMI-010 — NFC-e exige CSC. Sem Token CSC e ID do CSC, a NFC-e é rejeitada ao assinar: "NFC-e exige Token CSC e ID do CSC preenchidos em Configurações de Emissão > empresa > NFC-e (obrigatórios para o QR-Code)." Há um só par de CSC por empresa: ao trocar de ambiente, troque o CSC junto.
- RN-EMI-011 — Leiaute customizado ausente. Na NF-e, leiaute Customizado sem arquivo faz a geração do DANFE falhar de forma visível. Na NFC-e, o DANFCe cai para o leiaute padrão.
- RN-EMI-012 — Envio automático de e-mail exige provedor. "Selecione um provedor de e-mail para habilitar o envio automático."
- RN-EMI-013 — Escrituração desligada por padrão. Só segue para a Escrituração Fiscal o documento emitido de empresa com Usar Escrituração Fiscal ligado, e só documento autorizado vira lançamento. A troca da chave vale para documentos novos.
- RN-EMI-014 — Empresa com notas emitidas não sai. A remoção é recusada quando há nota autorizada, cancelada ou denegada da empresa: "A configuração não pode ser removida: existem N nota(s) emitida(s) para esta empresa."
- RN-EMI-015 — Remover não apaga os modelos nem as séries. A remoção tira a empresa desta lista. As configurações de NF-e/NFC-e e as séries continuam gravadas e voltam se a empresa for adicionada de novo. Se a empresa também tem configuração de Recebimento, esta é preservada.
O que esta tela não faz¶
- Não cadastra empresa nem certificado. Os dois são mantidos no Central Hub.
- Não emite nota. A emissão acontece pela integração, pelo upload de arquivos ou pelo Enviar da listagem de emitidos.
- Não cadastra provedor de e-mail. Só escolhe um dos liberados no Hub para o app.
- Não inutiliza numeração. Faixas não usadas de uma série são inutilizadas no tile Inutilização.
- Não configura o recebimento de documentos de terceiros. Isso é o tile Recebimento.
- Não gera prévia do leiaute customizado. O arquivo
.frxé guardado e exportado como foi enviado.
Erros e mensagens¶
| Mensagem | Causa | O que fazer |
|---|---|---|
| A configuração não pode ser removida: existem N nota(s) emitida(s) para esta empresa. | Empresa já emitiu | Manter a configuração; desabilitar a emissão nos modelos, se for o caso |
| Não é possível usar a numeração da série de 55 sem uma série ativa configurada. | Numeração pela série ligada sem série ativa | Criar e ativar uma série, ou desligar a opção |
| Não é possível desativar a série ativa enquanto o modelo (…) | Série em uso pela numeração | Ativar outra série antes |
| A série N já existe para o modelo 55. | Número repetido | Escolher outro número |
| O número da série deve estar entre 1 e 999. | Número fora do intervalo | Corrigir |
| O próximo número deve ser maior que zero. | Próximo número 0 ou negativo | Corrigir |
| Leiaute 'paisagem' não é válido para NFC-e — só 'retrato' ou 'customizado'. | Paisagem na NFC-e | Usar retrato ou customizado |
| Leiaute customizado deve ser um arquivo .frx. / Arquivo .frx enviado está vazio. / Arquivo .frx maior que o limite permitido (5MB). | Arquivo inválido | Enviar um .frx válido de até 5 MB |
| Selecione um provedor de e-mail para habilitar o envio automático. | Envio automático sem provedor | Escolher o provedor |
| E-mail(s) de cópia inválido(s): … | Endereço mal formado | Corrigir a lista de cópias |
| NFC-e exige Token CSC e ID do CSC preenchidos (…) | CSC ausente | Preencher na aba NFC-e |
| A emissão de NF-e está desabilitada para esta empresa (…) | Modelo desabilitado | Ligar Emissão habilitada |
| Recebimento rejeitado: nenhuma série ativa configurada para NF-e. (…) | Numeração pela série sem série ativa | Ativar uma série |
| O emitente ainda está sem configuração de emissão. (…) | Emitir numa nota de emitente não cadastrado antes de configurar a empresa | Configurar a empresa nesta tela e clicar em Emitir de novo |
| O emitente (CNPJ …) não é uma empresa deste tenant. (…) | Emitir numa nota cujo emitente não está no Central Hub | Cadastrar a empresa no Hub e reenviar a nota pela integração |
| Já existe outra nota com a mesma identificação (…). Esta nota não pode ser retomada. | Outra nota já ocupa a mesma série e número (ou referência externa) | Conferir a numeração da nota original e reenviá-la corrigida |
Relação com a NF-e / SEFAZ / EFD¶
| Configuração | Onde aparece |
|---|---|
| Ambiente SEFAZ | ide/tpAmb do XML e o webservice chamado (produção ou homologação) |
| Tipo de Emissão | ide/tpEmis do XML |
| Série ativa e próximo número | ide/serie e ide/nNF quando a numeração vem da série |
| Token e ID do CSC | QR-Code da NFC-e (infNFeSupl) |
| Certificado ativo (Hub) | Assinatura do XML da nota e dos eventos |
| Leiaute | DANFE (NF-e) e DANFCe (NFC-e) |
| Usar Escrituração Fiscal | Envio do documento autorizado ao app Escrituração Fiscal, que o escritura como emissão própria (IND_EMIT = 0) no registro C100 da EFD-ICMS/IPI [Guia Prático EFD-ICMS/IPI 3.2.3, p. 65] |
Série e número, depois de usados, também vão para a EFD: são os campos SER e NUM_DOC do C100 [Guia Prático EFD-ICMS/IPI 3.2.3, p. 65]. Um salto de numeração deixa lacuna que precisa ser inutilizada.
Perguntas frequentes¶
Troquei o certificado no Hub. Preciso fazer algo aqui? Não. A emissão usa o certificado ativo da empresa no Hub. Clique em Atualizar para ver o novo na lista.
Posso emitir NF-e em produção e NFC-e em homologação? Sim. Ambiente e tipo de emissão são configurados por modelo.
Criei uma série e a emissão não usou. A série nasce inativa. Ative-a e confira se Usar numeração da série configurada está ligado.
Removi a empresa e adicionei de novo. As séries voltaram. É o esperado: a remoção não apaga modelos nem séries (RN-EMI-015).
Desliguei "Usar Escrituração Fiscal". O que já foi enviado sai da escrituração? Não. A chave vale para documentos novos.