Guia de Configuração Passo a Passo do Addon NFCom (PayISP/MK-Auth)
1. Configurações Gerais
Esta aba contém informações cruciais sobre a licença, dados da empresa e regras de operação fiscal.
1.1. ⚠️ Modo de Operação (Homologação/Produção)
-
Verificação Inicial: Observe o alerta no topo: "Modo de Homologação Ativo!". Isso significa que as notas emitidas NÃO são válidas para fins fiscais.
-
Ação: Na seção Dados da Empresa e Operação, ajuste o campo Modo de Homologação (*):
-
Para testar a integração sem emitir documentos fiscais reais, selecione
Sim (Modo Teste). -
Quando estiver pronto para emitir notas fiscais oficiais, selecione
Não (Modo Produção).
-
1.2. Dados da Empresa e Operação
Preencha os campos abaixo com os dados cadastrais da sua empresa. Campos marcados com (*) são obrigatórios.
| Campo | Instrução de Preenchimento |
| Ativar Uso NFCom (*) | Selecione Sim (Ativo) para habilitar a emissão de notas. |
| Nome Social (Razão Social) (*) | Informe o nome social completo da empresa conforme o CNPJ. |
| CNPJ da Empresa (*) | Preencha o CNPJ completo da sua empresa. |
| Nome Fantasia (*) | Preencha o nome fantasia. |
| Inscrição Estadual (IE) (*) | Preencha o número da Inscrição Estadual. |
| Inscrição Municipal (IM) | Opcional, preencha se a empresa possuir. |
| Regime Tributário (*) | Selecione o regime de tributação (ex: Simples Nacional). |
| CNAE Principal (*) | Informe o código da CNAE principal da empresa. |
| Série da NFCom (*) | Defina a série que será utilizada para a NFCom (geralmente 1). |
| Número Inicial da NFCom (*) | Defina o primeiro número de NFCom a ser emitido. Atenção para não duplicar se já emite por outro sistema. |
| Alíquota FUST (%) (*) | Preencha o percentual da alíquota do FUST (ex: 0.00). |
| Alíquota FUNTTEL (%) (*) | Preencha o percentual da alíquota do FUNTTEL (ex: 0.00). |
| Endpoint de Serviços NFCom (*) | Selecione o ambiente de processamento de notas (geralmente SVRS). |
1.3. Configurações de Faturamento e Documento
| Campo | Opção Recomendada / Descrição |
| Data Base de Competência (*) | Escolha entre Data de Vencimento da Fatura ou Data de Pagamento da Fatura para definir o período fiscal da nota. |
| Base de Cálculo do Valor da NF-e (*) | Escolha entre Valor Total da Fatura ou Valor Apenas dos Serviços para a base de cálculo. |
| Exibir Barra/Pix na Danfe-COM (*) | Escolha Não (Ocultar) ou Sim (Exibir) para mostrar códigos de pagamento na impressão da nota. |
| Incluir Boleto no Faturamento NFCom (*) | Escolha Sim ou Não para incluir o custo/linha do boleto no rateamento da nota. |
| Incluir PIX no Faturamento NFCom (*) | Escolha Sim ou Não para incluir a linha de dados PIX no rateamento da nota. |
| Observações Adicionais | Campo livre para inserir textos ou observações que aparecerão nas notas. |
➡️ Ação: No final da aba, clique em Salvar Configurações.
2. Certificado Digital
O certificado digital A1 é obrigatório para assinar eletronicamente as NFCom.
2.1. Upload do Certificado
| Campo | Instrução |
| Arquivo do Certificado (.pfx ou .p12) | Clique e selecione o arquivo do seu Certificado Digital A1. O formato deve ser .pfx ou .p12. |
| Senha do Certificado | Insira a senha de proteção do arquivo do certificado. |
-
Verificação: Após o envio, o sistema confirmará o upload, exibindo o nome do arquivo (
CERT2025.pfx) e a validade em dias. -
Se o certificado precisar ser trocado ou removido, utilize o botão
Remover Certificado.
➡️ Ação: Clique em Enviar Certificado para finalizar o upload e ativação.
3. Serviços
Nesta aba, você mapeia cada plano do MK-Auth para as regras fiscais de emissão da NFCom.
3.1. Mapeamento de Planos e Regras Fiscais
-
Clique em
➕ Adicionar Novo Plano de Serviçopara configurar um plano que ainda não esteja na lista. -
Para os planos já listados (ex: "Plano Básico 100MB Editado"), verifique as configurações nas colunas:
-
Plano MK-Auth: Garanta que corresponde ao nome exato do plano no seu MK-Auth.
-
CFOP: Código Fiscal de Operações e Prestações.
-
CClass: Código de Classe de Serviço.
-
ICMS CST: Código de Situação Tributária (para ICMS).
-
ICMS Alíq. (%): Alíquota de ICMS aplicável ao plano.
-
-
Utilize o botão de
Editar(lápis) para modificar os códigos fiscais de um plano existente, caso necessário. -
O Status deve estar
Ativopara que o sistema possa emitir a NFCom para as faturas desse plano.
➡️ Ação: Repita a verificação ou adição de regras fiscais para todos os planos de serviço que você oferece.
Seus planos já configurados mostram os seguintes códigos, que servem como exemplo:
-
CFOP:
5307 -
CClass:
0400501 -
ICMS CST:
90 -
ICMS Alíq. (%):
0.00%