- Você tem um Certificado Digital A1 do CNPJ (.pfx) e a senha.
- Seu cadastro do provedor está completo: Razão Social, CNPJ, Inscrição Estadual (IE), IBGE, Telefone/Celular e Site com http:// ou https://.
- Seu contador confirmou a habilitação da NFCom (Modelo 62) para o seu CNPJ na SEFAZ/UF (ou você já verificou no portal).
- O sistema está atualizado para versão compatível (recomendado: 25.08 ou superior).
- Atualizar sistema e configurar Certificado Digital
- Verificar se o CNPJ está habilitado para NFCom
- Configuração inicial da NFCom (Ambiente, Layout e Séries)
- Ajustes fiscais e conferências (planos e cadastro)
- Emitindo NFCom na prática (gerar e acompanhar)
- Exportar XML em ZIP
- Personalizar Layout (Modelos 01–04) e variáveis
- Erros comuns e soluções rápidas
- Suporte
- Atualize o sistema para a versão recomendada (25.08 ou superior).
Dica: versões mais novas incluem correções relacionadas à NFCom.
- Acesse o painel administrativo do MK-AUTH.
- No menu lateral, vá em Provedor → Dados do Provedor.
Conferências obrigatórias:
- Site: deve conter http:// ou https:// (não pode ficar apenas “www”).
- Não deixe Telefone, Celular e IBGE vazios.
- Inscrição Estadual (IE): somente números (sem pontos, traços ou espaços), exatamente como na SEFAZ.
- Clique na aba Fiscal.
- Localize o campo para enviar o Certificado Digital A1 (.pfx) e informe a senha.
- Salve as alterações.
Observação importante: a Razão Social cadastrada deve corresponder ao nome exibido no certificado.
Antes de emitir, verifique se o seu CNPJ está habilitado para a NFCom na sua UF (SEFAZ). O tutorial oficial orienta a verificação via portal da SVRS (o acesso pede login gov.br e pode ser um CPF não vinculado à empresa).
- Acesse o portal de consulta de contribuinte NFCom da SVRS.
- Selecione o estado (UF) e informe o CNPJ.
- Confirme se aparece NFCom em “DFe habilitados”.
- Acesse o menu Financeiro.
- Vá até a aba NFCom Geradas.
- No canto inferior, clique na engrenagem (⚙️) para abrir as configurações.
- Configure os campos principais:
- Ambiente: Produção (ou Homologação, se você estiver em fase de testes e sua UF exigir).
- Layout: modelo01 a modelo04 (conforme sua necessidade).
- Séries de emissão:
- Série 1: emissão para clientes residenciais (pessoa física).
- Série 2: emissão para clientes corporativos (pessoa jurídica).
- Número inicial: 1
- Clique em Salvar.
Para evitar falhas na geração, confirme os cadastros fiscais e regras dos planos. O tutorial oficial reforça que nenhum campo obrigatório pode ficar em branco (especialmente IBGE, endereço completo, celular e e-mail).
- O código IBGE precisa existir (normalmente é preenchido automaticamente pelo CEP).
- Endereço completo, número (ou “S/N”), bairro e CEP devem estar preenchidos.
- Celular e e-mail não podem estar vazios (mesmo que seja um e-mail “de contingência” para emissão).
- Vá em Financeiro → Títulos.
- Selecione os títulos já pagos/baixados que deseja emitir NFCom.
- Role até o final da página.
- Clique no ícone “Processar NFCom”.
- O sistema listará os clientes/recebimentos marcados — confira as informações.
- Após confirmar, clique em Gerar (botão azul, no canto inferior esquerdo).
- Acompanhe o resultado em Financeiro → NFCom Geradas.
Para baixar os XML gerados em lote:
- Acesse Financeiro → NFCom Geradas.
- Selecione as notas com status Concluído (e que já tenham XML).
- Clique em Exportar NFCom e depois em Arquivos XML em ZIP.
Os layouts HTML da NFCom ficam nos diretórios de modelo (01 a 04). O tutorial oficial menciona o caminho: /opt/mk-auth/print_pdf/nfcom/modelo01, modelo02, modelo03 e modelo04.
Imagens e Logotipos
{PROVEDORLOGO}
{LOGOSVA}
Dados do Provedor
{PROVEDORNOME}
{PROVEDORRAZAO}
{PROVEDORENDERECO}
{PROVEDORBAIRRO}
{PROVEDORCEP}
{PROVEDORCIDADE}
{PROVEDORESTADO}
{PROVEDORFONE}
{PROVEDOREMAIL}
{PROVEDORCNPJ}
{PROVEDORIE}
Dados do Cliente
{CLIENTE_NOME}
{CLIENTE_ENDERECO}
{CLIENTE_BAIRRO}
{CLIENTE_COMPLEMENTO}
{CLIENTE_CIDADE}
{CLIENTE_ESTADO}
{CLIENTE_CEP}
{CLIENTE_CPF}
{CLIENTE_RG}
{CLIENTE_EMAIL}
{CLIENTE_TELEFONE}
Dados da NFCOM
{NFCOM_SERIE}
{NFCOM_NUMERO}
{NFCOM_CHAVE}
{NFCOM_PROTOCOLO}
{NFCOM_EMISSAO}
{NFCOM_REF}
{NFCOM_TITULO}
{NFCOM_VTOTAL}
{NFCOM_OBS}
{NFCOM_CONSULTALINK}
{NFCOM_CONSULTAQRCODE}
Itens da Nota (usadas dentro do bloco de repetição)
{ITEM_DESC}
{ITEM_PERC_ICMS}
{ITEM_VALOR_ICMS}
{ITEM_PERC_PIS}
{ITEM_VALOR_PIS}
{ITEM_PERC_COFINS}
{ITEM_VALOR_COFINS}
{ITEM_PERC_FUST}
{ITEM_VALOR_FUST}
{ITEM_PERC_FUNTTEL}
{ITEM_VALOR_FUNTTEL}
{ITEM_PERC_CSLL}
{ITEM_VALOR_CSLL}
{ITEM_PERC_IRRF}
{ITEM_VALOR_IRRF}
{ITEM_PERC_IBSCBS}
{ITEM_VALOR_IBSCBS}
{ITEM_VALOR}
Totais dos Tributos
{NFCOM_BASE_ICMS}
{NFCOM_ALIQ_ICMS}
{NFCOM_VALOR_ICMS}
{NFCOM_BASE_PIS}
{NFCOM_ALIQ_PIS}
{NFCOM_VALOR_PIS}
{NFCOM_BASE_COFINS}
{NFCOM_ALIQ_COFINS}
{NFCOM_VALOR_COFINS}
{NFCOM_BASE_FUST}
{NFCOM_ALIQ_FUST}
{NFCOM_VALOR_FUST}
{NFCOM_BASE_FUNTTEL}
{NFCOM_ALIQ_FUNTTEL}
{NFCOM_VALOR_FUNTTEL}
{NFCOM_BASE_CSLL}
{NFCOM_ALIQ_CSLL}
{NFCOM_VALOR_CSLL}
{NFCOM_BASE_IRRF}
{NFCOM_ALIQ_IRRF}
{NFCOM_VALOR_IRRF}
{NFCOM_BASE_IBSCBS}
{NFCOM_ALIQ_IBSCBS}
{NFCOM_VALOR_IBSCBS}
IBPT (Aprox. Tributos)
{NFCOM_PERC_IBPT}
{NFCOM_VALOR_IBPT}
{NFCOM_PERC_IBPT_M}
{NFCOM_VALOR_IBPT_M}
{NFCOM_PERC_IBPT_E}
{NFCOM_VALOR_IBPT_E}
{NFCOM_PERC_IBPT_F}
{NFCOM_VALOR_IBPT_F}
Blocos Condicionais
{BLOCK_DADOSITENS} ... {/BLOCK_DADOSITENS} (repetido para cada item)
{BLOCK_ITENS} ... {/BLOCK_ITENS} (exibido se houver itens)
{BLOCK_CONCLUIDA} ... {/BLOCK_CONCLUIDA} (exibido se status = CONCLUIDO)
{BLOCK_UNCONCLUIDA} ... {/BLOCK_UNCONCLUIDA} (exibido se status ≠ CONCLUIDO)
- Recomendação do tutorial oficial: redefina a senha do certificado com 8 caracteres, usando apenas letras e números (evite caracteres especiais).
- Confirme: IBGE, endereço completo, número (“S/N” se não houver), celular e e-mail.
- Valide no portal da SVRS e solicite ao contador a habilitação da NFCom (Modelo 62) na sua UF.
- Verifique se o certificado está válido, se os dados fiscais batem com a SEFAZ e tente novamente mais tarde caso haja instabilidade do serviço.
O tutorial oficial cita comandos SQL para completar e-mail/celular/número quando estiverem vazios. Em ambiente cloud, não execute comandos no banco sem backup e sem validação. Se precisar, abra chamado para aplicarmos com segurança.
# ATENÇÃO: exemplos. Ajuste usuário, base e forma de autenticação do MySQL.
# Faça backup antes.
# Preencher e-mail (somente quem estiver vazio)
UPDATE sis_cliente SET email = 'provedornet@gmail.com'
WHERE email IS NULL OR email = '' OR TRIM(email) = '';
# Preencher celular (somente quem estiver vazio)
UPDATE sis_cliente SET celular = '(00)00000000'
WHERE celular IS NULL OR TRIM(celular) = '';
# Preencher número do endereço com 'S/N' (somente quem estiver vazio)
UPDATE sis_cliente SET numero = 'S/N', numero_res = 'S/N'
WHERE numero IS NULL OR TRIM(numero) = ''
OR numero_res IS NULL OR TRIM(numero_res) = '';
Se você seguiu todos os passos e ainda não consegue emitir, envie para o suporte: prints da tela de configuração fiscal, print da verificação de habilitação do CNPJ (SVRS), e a mensagem de erro completa apresentada na geração/consulta da NFCom.
