← Manual

Configurar a empresa para emitir nota

Antes da primeira NF-e a empresa precisa de cadastro fiscal completo, de uma conta no provider que fala com a SEFAZ e dos grupos de tributação dos produtos.

Como fazer

1. Em Admin → Empresas, abra a empresa e confira CNPJ, Inscrição estadual, Regime tributário e o Endereço — é esse cadastro que vai no emitente da nota. Marque em Atividades o que ela faz: Vende produtos, Presta serviços, Presta frete.
2. Em Faturamento → Config fiscal (empresas), clique em Configurar na linha da empresa.
3. Em Provider e ambiente, escolha o Provider fiscal, o Ambiente e a Série padrão, e clique em Salvar configuração.
4. Em API key do provider, clique em Definir API key, cole a chave do provider e confirme em Salvar no Vault.
5. Em Faturamento → Grupos de tributação, clique em Novo grupo. Preencha Código, Nome e a tributação — CFOP, NCM, CST ou CSOSN e alíquotas — e clique em Salvar.

O que o sistema faz sozinho

O certificado A1 não entra no Matoscore. Ele sobe uma vez no provider, que assina e transmite à SEFAZ; aqui fica só a chave de acesso, cifrada no cofre e nunca mais exibida.

O Próximo número é alocado sozinho na emissão e a tela só o exibe. Ajustar à mão é ação de superadministrador, por Ajustar numeração (cutover).

Homologação e produção são ambientes diferentes na SEFAZ. Nota em Homologação (sem valor fiscal) é teste e não vale como documento; só Produção (SEFAZ real) tem valor fiscal — e a tela passa a exibir o aviso "Ambiente de PRODUÇÃO". Trocar de ambiente não reseta a numeração: o contador é um só.

Na emissão os tributos saem do grupo apontado no produto, e de nenhum outro lugar. Sem grupo, a nota sai com o NCM, o CEST, a origem e o CFOP do próprio produto e sem o bloco de ICMS.

⚠️ Criar o grupo não basta: hoje nenhuma tela o liga ao produto. O cadastro do produto grava NCM, CEST e Origem fiscal e não tem campo de grupo; nenhuma outra tela grava esse vínculo. O interruptor Padrão não cobre a falta — ele marca um grupo por empresa e não é aplicado sozinho: nenhuma função de emissão o consulta. Até o vínculo ser feito no banco, por quem administra o sistema, a nota sai sem ICMS mesmo com os grupos criados.

Quando não funciona

• Marcar Padrão num segundo grupo devolve erro cru de banco — só pode haver um grupo padrão por empresa, e a tela não desmarca o anterior. A mensagem aparece como "Falha ao atualizar: …" com o texto de violação de chave única. Desmarque Padrão no grupo antigo primeiro.
• "Empresa ainda sem configuração fiscal" — a config é criada ao salvar o formulário. A API key é um passo à parte, no botão Definir API key.
• Status "pendente" na lista de config fiscal — falta a API key, ou o provider está em Stub (dev/demo, sem SEFAZ), que gera nota sem ir à SEFAZ e é inválida fiscalmente.
• "Produto de revenda não pode usar o grupo "…" (tipo …). Use um grupo de revenda." — o tipo do produto e o tipo do grupo têm que casar. Há a recíproca para produto de produção própria.
• "Preencha apenas Regime Normal (CST) OU Simples (CSOSN), não os dois." — no grupo, o ICMS é preenchido por um regime só.
• "Selecione uma empresa ativa" — grupo de tributação é por empresa. Troque a empresa no seletor do topo antes de criar.
• "Você não tem permissão para criar grupos de tributação." — falta fiscal.update no papel.