MK-AUTH + NFCOM - Como utilizar e configurar? imprimir

• Subir o certificado A1 (.pfx) e validar os dados fiscais.
• Configurar ambiente, layout, séries e numeração da NFCom.
• Emitir NFCom a partir de títulos e exportar XML em lote.
• Evitar os erros mais comuns (cadastro, habilitação e certificado).

Navegação rápida

Pré-requisitos Dados do provedor + Certificado Habilitação NFCom (UF) Configuração NFCom Emitir Exportar XML Layouts e variáveis Erros comuns

1) Pré-requisitos (antes de configurar)

Boas práticas GLA/RoxyLabs: não envie certificado por WhatsApp. Use canal seguro (ticket/portal) e mantenha backup do .pfx em local protegido.

2) Dados do Provedor + Certificado A1 (ponto crítico)

Regra de ouro: a Razão Social no cadastro deve ser a mesma que aparece no certificado (nome do certificado).

3) Confirmar habilitação NFCom na sua UF (SVRS)

1. Acesse o portal de consulta de contribuinte NFCom (SVRS).
2. Faça login com gov.br (pode ser um CPF não vinculado à empresa).
3. Selecione a UF e informe o CNPJ para confirmar se NFCom está habilitado.

Se não estiver habilitado: solicite ao contador a habilitação da emissão de NFCom (Modelo 62) para o seu CNPJ junto à SEFAZ/UF e aguarde a confirmação.

4) Configuração da NFCom (ambiente, layout, séries e numeração)

• Ambiente: Produção
• Layout: modelo01 a modelo04 (conforme sua necessidade)
• Séries:
  • Série 1 → clientes residenciais (PF)
  • Série 2 → clientes corporativos (PJ)
• Número inicial: 1

5) Conferências obrigatórias (para não travar na emissão)

• O cliente precisa ter código IBGE preenchido (geralmente vem via CEP).
• Endereço completo, número (ou “S/N”), celular e e-mail não podem ficar vazios.
• Revise Provedor → Controle de Planos (regras fiscais do plano/serviço).

Nota (casos PJ sem IE / “IE ISENTO”):
Para clientes PJ que não possuem IE (ex.: igreja, escola etc.), ajuste o cadastro do cliente e, se necessário, altere o “Tipo cliente” (ex.: 99 – outros) e o tipo de serviço (ex.: 06 – prestador de serviço internet).

6) Emitir NFCom (do título para a nota)

1. Abra Financeiro → Títulos.
2. Selecione os títulos que deseja emitir (ex.: títulos já baixados/pagos).
3. Role até o final da página.
4. Clique em Processar NFCom.
5. Confirme a lista e clique em Gerar.
6. Acompanhe em Financeiro → NFCom Geradas.

Observação: após gerar, a listagem pode mostrar nome resumido (e não necessariamente o nome completo do cliente).

Se o sistema reclamar de vencimento “muito distante”:
Em alguns cenários, pode ser necessário ajustar o processo (ex.: estornar/alterar data de baixa e reemitir, conforme orientação operacional).

7) Exportar XML em lote (ZIP)

8) Layout (Modelos 01–04) e variáveis

Onde ficam os modelos:
/opt/mk-auth/print_pdf/nfcom/modelo01 (…/modelo02, …/modelo03, …/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}

Blocos Condicionais
{BLOCK_DADOSITENS} ... {/BLOCK_DADOSITENS}
{BLOCK_ITENS} ... {/BLOCK_ITENS}
{BLOCK_CONCLUIDA} ... {/BLOCK_CONCLUIDA}
{BLOCK_UNCONCLUIDA} ... {/BLOCK_UNCONCLUIDA}
      

9) Erros comuns (e como resolver rápido)

• Refaça a senha (8 caracteres, apenas letras e números) e reenvie o .pfx.
• Existe orientação em vídeo para correção de senha do certificado.

• Complete cadastro do cliente: IBGE, endereço, número (ou S/N), celular e e-mail.
• Revise o “Site” do provedor (precisa http/https) e IE somente números.

• Verifique validade do A1, e se os dados fiscais conferem (CNPJ/IM/UF).
• Tente novamente caso haja instabilidade momentânea do serviço.

Aviso importante (SQL / comandos):
Existem comandos para preencher automaticamente e-mail/celular/número quando estiverem vazios, porém em ambiente cloud não recomendamos execução direta no banco sem backup e validação. Se precisar, solicite ao suporte da GLA/RoxyLabs para aplicar com segurança.

Precisa de ajuda?

Abra um chamado com: prints do cadastro fiscal do provedor, print da consulta SVRS (habilitação NFCom), e a mensagem de erro completa.
GLA Solutions Ltda (RoxyLabs) — Suporte Cloud Brasil.