Tutorial completo: Setup e emissão de NFCom (Modelo 62) no MK-AUTH
Este guia mostra o passo a passo para configurar e começar a emitir NFCOM/NFCom no seu ERP para provedores (MK-AUTH) hospedado em infraestrutura cloud no Brasil.
Antes de começar (checklist rápido)
  • 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).
PASSO 1 — Atualizar e configurar Certificado Digital
Importante: faça backup antes de qualquer atualização e antes de alterar dados fiscais.
  1. Atualize o sistema para a versão recomendada (25.08 ou superior).
    Dica: versões mais novas incluem correções relacionadas à NFCom.
  2. Acesse o painel administrativo do MK-AUTH.
  3. 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.
  4. Clique na aba Fiscal.
  5. Localize o campo para enviar o Certificado Digital A1 (.pfx) e informe a senha.
  6. Salve as alterações.
    Observação importante: a Razão Social cadastrada deve corresponder ao nome exibido no certificado.
Exemplo visual
Exemplo: Razão Social deve bater com o certificado
Se a imagem não carregar no seu editor, copie o link acima e abra no navegador para referência.
PASSO 1B — Verificar se o CNPJ está habilitado para NFCom

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).

Como validar:
  1. Acesse o portal de consulta de contribuinte NFCom da SVRS.
  2. Selecione o estado (UF) e informe o CNPJ.
  3. Confirme se aparece NFCom em “DFe habilitados”.
Exemplo: CNPJ habilitado vs não habilitado para NFCom
Exemplo de tela mostrando quando NFCom aparece como habilitado.
Se não estiver habilitado: peça ao seu contador para habilitar a emissão de NFCom (Modelo 62) para o seu CNPJ junto à SEFAZ/UF e aguarde a confirmação.
PASSO 2 — Cadastro / Configurações da NFCom
  1. Acesse o menu Financeiro.
  2. Vá até a aba NFCom Geradas.
  3. No canto inferior, clique na engrenagem (⚙️) para abrir as configurações.
  4. 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
  5. Clique em Salvar.
PASSO 3 — Ajustes fiscais e conferências (planos e cadastros)

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).

Exemplo: Tela de cadastro fiscal no MK-AUTH
Exemplo de tela para conferência de itens fiscais.
Pontos de atenção (cadastro do cliente):
  • 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).
Clientes PJ sem IE (IE ISENTO):
Para casos como igrejas, escolas e outras entidades sem IE, o tutorial sugere ajustar o cadastro do cliente PJ e, se necessário, testar o “Tipo cliente” e/ou preencher RG/IE com dígitos conforme orientação contábil.
PASSO 4 — Emitindo NFCom na prática
  1. Vá em Financeiro → Títulos.
  2. Selecione os títulos já pagos/baixados que deseja emitir NFCom.
  3. Role até o final da página.
  4. Clique no ícone “Processar NFCom”.
Botão/ícone para Processar NFCom
Dica: o ícone “Processar NFCom” aparece ao final da tela de Títulos.
  1. O sistema listará os clientes/recebimentos marcados — confira as informações.
  2. Após confirmar, clique em Gerar (botão azul, no canto inferior esquerdo).
  3. Acompanhe o resultado em Financeiro → NFCom Geradas.
Observação: após gerar a NFCom, o nome exibido na listagem pode aparecer como “nome resumido” (não necessariamente o nome completo do cliente).
Exportar XML em ZIP (vários documentos de uma vez)

Para baixar os XML gerados em lote:

  1. Acesse Financeiro → NFCom Geradas.
  2. Selecione as notas com status Concluído (e que já tenham XML).
  3. Clique em Exportar NFCom e depois em Arquivos XML em ZIP.
Ícone de exportação NFCom/XML
Ícones de ações: procure a opção de exportação/ZIP.
Personalizar Layout (Modelos 01–04) e variáveis
Atenção: personalize layouts apenas se você souber exatamente o que está fazendo. Em ambiente cloud, recomenda-se abrir chamado para aplicarmos com segurança.

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.

Variáveis principais disponíveis (resumo completo)
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)
      
Erros comuns e soluções rápidas
1) Falha ao importar certificado / senha do A1
  • Recomendação do tutorial oficial: redefina a senha do certificado com 8 caracteres, usando apenas letras e números (evite caracteres especiais).
2) NFCom não gera porque falta dado no cadastro
  • Confirme: IBGE, endereço completo, número (“S/N” se não houver), celular e e-mail.
3) CNPJ não habilitado para NFCom
  • Valide no portal da SVRS e solicite ao contador a habilitação da NFCom (Modelo 62) na sua UF.
4) “Erro de comunicação” / indisponibilidade momentânea
  • 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.
Dica de segurança (sobre “preencher dados faltantes”):
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.
Exemplos (somente referência)
# 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) = '';
      
Suporte

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.

Esta resposta lhe foi útil? 0 Usuários acharam útil (0 Votos)