Como Emitir NFS-e Nacional por Procuração Eletrônica da Receita Federal (Cód. 00233): 1 Certificado A1 para Múltiplos CNPJs via API

Se você constrói um ERP, um SaaS vertical para prestadores de serviço ou lidera a operação tecnológica de um escritório de contabilidade digital, você já conhece de cor qual é o maior gargalo de ativação de clientes no Brasil: cobrar o arquivo .pfx do Certificado Digital A1 e a senha de cada empresa.

Ao longo dos últimos meses, acompanhando centenas de implantações na nossa arquitetura Multi-CNPJ da Org API, vimos a mesma cena se repetir dezenas de vezes. O desenvolvedor cria o tenant via API em menos de dois segundos, configura série, CNAE e regime tributário, mas o go-live trava durante dias porque o dono da clínica ou da agência não sabe onde guardou o arquivo .pfx, mandou a senha errada três vezes ou simplesmente ainda não emitiu um e-CNPJ próprio.

Em 1º de novembro de 2026, essa história ganhou uma virada estrutural no Ambiente Nacional da NFS-e. Conforme o comunicado oficial publicado pelo Portal Nacional da NFS-e em 31/10/2026 e detalhado no Tópico 11 do Guia do Emissor Público Nacional Web v1.3, a Receita Federal e a Sefin Nacional liberaram oficialmente a atuação por representação (Procuração Eletrônica RFB e vínculos da base CNPJ/CPF) tanto no portal web quanto nas APIs de Emissão (SefinNacional) e Distribuição (ADN).

Neste artigo, vou explicar exatamente como essa validação funciona por baixo do capô na camada criptográfica (mTLS + XMLDSig), qual é a pegadinha arquitetural de roteamento municipal que quebra ERPs desavisados e como você já pode usar a Notaas para emitir NFS-e no Ambiente Nacional com 1 único certificado de procurador ou sem precisar pedir nenhum .pfx ao seu cliente usando o certificado institucional da We Digi.

A liberação da Procuração Eletrônica na API da Sefin Nacional elimina a maior fricção do onboarding fiscal B2B no Ambiente Nacional: um único Certificado A1 de procurador agora autentica e assina a DPS para múltiplos CNPJs outorgantes.

1. O que a Receita Federal e a Sefin Nacional liberaram na API (POST /SefinNacional/nfse)

Até outubro de 2026, quando seu sistema abria uma conexão mTLS com sefin.nfse.gov.br e enviava uma Declaração de Prestação de Serviço (DPS) para a API da NFS-e Nacional, o servidor governamental exigia que o CNPJ raiz (8 dígitos) ou CPF contido no certificado X.509 coincidisse estritamente com o documento do prestador informado na tag <prest>.

Com a atualização liberada em 01/11/2026, os servidores da Sefin Nacional e do ADN (Ambiente de Dados Nacional) passaram a consultar em tempo real a base de autorizações da Receita Federal sempre que o titular do Certificado Digital A1 difere do contribuinte prestador da nota:

⚡ Fluxo de Validação mTLS + XMLDSig por Procuração na Sefin Nacional:

• 1. Identidade Fiscal Intacta no XML da DPS: O layout XML da DPS v1.01 não muda. O atributo Id de 45 posições (DPS...) e a tag <prest><CNPJ> (ou <CPF>) continuam trazendo o documento real do prestador do serviço (outorgante). Da mesma forma, no pedido de registro de evento de cancelamento (e101101), a tag <CNPJAutor> / <CPFAutor> e o Id do <infPedReg> continuam preenchidos com o documento do prestador.
• 2. Assinatura Digital (<Signature> XMLDSig) pelo Procurador: O elemento <infDPS> (ou <infPedReg> no cancelamento) é assinado com a chave privada RSA-SHA256 do Certificado A1 ICP-Brasil do procurador (outorgado), embutindo seu <X509Certificate> no <KeyInfo>.
• 3. Handshake mTLS + Conferência na Base da RFB: Na transmissão HTTPS para sefin.nfse.gov.br/SefinNacional/nfse, o mesmo certificado do procurador realiza o handshake mTLS. A Sefin Nacional detecta que o documento ICP-Brasil do certificado difere do <prest> e valida se existe vínculo de representação ativo na Receita Federal antes de autorizar a NFS-e.

De acordo com a documentação oficial do Portal Nacional da NFS-e e as regras de representação perante a Receita Federal, essa autorização é reconhecida em três cenários:

1. Procuração Eletrônica na Receita Federal (Serviço 00233 - NFS-e): O cliente (outorgante, PF ou PJ) acessa o Portal de Serviços da Receita Federal (servicos.receitafederal.gov.br → Minhas Autorizações de Acesso → + Nova Autorização), informa o CPF ou CNPJ do procurador (a contabilidade, a Software House ou o representante), define a vigência e habilita o serviço específico 00233 - NFS-e - Nota Fiscal de Serviços Eletrônica.
2. Responsável Legal perante o CNPJ (QSA da RFB): O certificado e-CPF do sócio administrador / responsável legal cadastrado na base CNPJ da Receita Federal pode assinar e transmitir pela pessoa jurídica.
3. Mesma Raiz de CNPJ (Matriz e Filiais — 8 dígitos): O certificado A1 da matriz pode operar pelas filiais de mesma raiz de 8 dígitos no Ambiente Nacional.

2. A Pegadinha Arquitetural que Quebra ERPs: Elegibilidade Exclusiva do Motor snnfse

Aqui entra o alerta de engenharia mais importante deste guia — e o motivo pelo qual uma implementação ingênua de "certificado único" derruba a emissão de um ERP em produção.

Na Notaas, nossa infraestrutura atende hoje 4.782 municípios brasileiros através de um motor de roteamento multissistema. Porém, esses 4.782 municípios abrangem todos os motores fiscais do país — combinando tanto as prefeituras que operam diretamente na Sefin Nacional (sistemaNfse === 'snnfse') quanto centenas de municípios que utilizam webservices municipais próprios ou híbridos (como sp_prefeitura na capital paulista, gissonline, issnet, issnet_nacional, el, el_nacional, tiplan, infisc, betha, pronim_snnfse, equiplano, simpliss, entre outros).

A Procuração Eletrônica da Receita Federal (serviço 00233) é validada exclusivamente pelos servidores federais da Sefin Nacional / ADN (sistemaNfse === 'snnfse').

Veja o que acontece em cada escopo quando você tenta usar um certificado de terceiro (procurador):

Como o CertificateResolver da Notaas protege o seu SaaS

Além do código IBGE da cidade, o motor final de uma nota na Notaas pode mudar dinamicamente conforme o regime tributário do prestador (por exemplo, um MEI com regime_tributario = '2' na NFS-e é roteado obrigatoriamente para o 'snnfse' mesmo em São Paulo/SP) ou conforme o item da lista de serviço (cTribNac) em municípios com roteamento híbrido.

Por isso, na Notaas a elegibilidade do certificado por procuração nunca é decidida por um booleano estático no cadastro da empresa: nosso CertificateResolver avalia o motor final resolvido da operação (resolvedSistemaNfse):

• Se resolvedSistemaNfse === 'snnfse', o resolver permite toda a cadeia de precedência: 1º project_own (Certificado próprio da empresa) ➔ 2º project_proxy (Procurador específico do projeto) ➔ 3º org_proxy (Certificado de procurador da Organização) ➔ 4º wedigi_proxy (Certificado institucional da We Digi).
• Se a nota for roteada para qualquer motor diferente de 'snnfse', o resolver exige estritamente project_own. Caso a empresa só possua certificado por procuração configurado, a API bloqueia preventivamente no pré-voo com HTTP 422 Unprocessable Entity (code: "PROXY_CERTIFICATE_UNSUPPORTED_ENGINE"), informando exatamente qual motor municipal foi acionado.
• Além disso, cada NFS-e emitida grava no banco o snapshot imutável do motor utilizado (sistema_nfse_emissao) e do certificado que a assinou (certificate_id e certificate_source), garantindo que cancelamentos (e101101), reconciliações de DANFSe e consultas no ADN funcionem com precisão cirúrgica mesmo que o município mude de provedor meses depois.

Para facilitar a vida do seu frontend, o endpoint GET /api/v1/org/projects já retorna em cada projeto os campos calculados:

• hasOwnCertificate: true se o CNPJ possui seu próprio .pfx ativo;
• hasCertificate: true se possui certificado próprio ou se está coberto por procuração válida quando defaultSistemaNfse === 'snnfse';
• certificateSource: 'project_own' | 'project_proxy' | 'org_proxy' | 'wedigi_proxy' | null;
• defaultSistemaNfse: motor base resolvido do projeto (ex.: 'snnfse', 'sp_prefeitura');
• proxyScopeRestriction: 'snnfse_only' quando coberto por procuração.

3. Tutorial Prático: As 2 Modalidades de Procuração na Org API e no Dashboard

Para atender desde o fundador que usa homologação gratuita Multi-CNPJ na Org API até grandes plataformas de BPO Contábil e ERPs que operam com o Notaas MCP Server para agentes de IA, liberamos duas modalidades de operação em nível de Organização (POST /api/v1/org/certificate), além do upload individual por projeto com flag allowProxy=true.

Modalidade 1: Zero .pfx usando o Certificado Institucional da We Digi (wedigi_proxy)

Esta é a modalidade de menor atrito possível para um SaaS ou ERP: nem o seu cliente final precisa enviar arquivo .pfx, nem a sua Software House precisa gerenciar o arquivo .pfx de um certificado próprio.

1. Na tela de onboarding do seu ERP (ou no painel da Notaas em /certificates), você exibe ao seu cliente os dados do procurador institucional da plataforma:
   • CNPJ Outorgado (Procurador): 03.167.121/0001-10 — We Digi Tecnologia Ltda
   • Serviço na Receita Federal: 00233 - NFS-e (Nota Fiscal de Serviços Eletrônica)
2. O cliente acessa servicos.receitafederal.gov.br (Minhas Autorizações de Acesso → + Nova Autorização) e autoriza o CNPJ acima no serviço 00233.
3. Seu backend ativa o modo institucional na sua organização com uma única chamada JSON (HTTP 200 OK):

const ORG_TOKEN = process.env.NOTAAS_ORG_TOKEN!; // ntaas_org_...
const BASE_URL = "https://platform.notaas.com.br/api/v1";

export async function enableWedigiProxyForOrganization() {
  const response = await fetch(`${BASE_URL}/org/certificate`, {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${ORG_TOKEN}`,
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      useWedigiProxy: true
    })
  });

  if (!response.ok) {
    throw new Error(`Falha ao ativar procuração We Digi: ${await response.text()}`);
  }

  return await response.json();
  // Retorna HTTP 200:
  // {
  //   mode: "wedigi_proxy",
  //   useWedigiProxy: true,
  //   wedigiProxyInfo: {
  //     cnpj: "03167121000110",
  //     cnpjFormatted: "03.167.121/0001-10",
  //     razaoSocial: "We Digi Tecnologia Ltda",
  //     rfbServiceCode: "00233",
  //     scopeRestriction: "snnfse_only"
  //   }
  // }
}

Modalidade 2: 1 Único .pfx da Contabilidade ou Software House para Todos os Clientes (org_proxy)

Se você é um escritório de contabilidade (que já recebe a procuração eletrônica dos seus clientes na Receita Federal para o CNPJ do escritório ou CPF do contador) ou uma Software House que prefere ser a própria outorgada na RFB, basta fazer o upload do seu único arquivo .pfx no nível da Organização (HTTP 201 Created):

export async function uploadOrganizationProxyCertificate(
  pfxBuffer: Buffer,
  pfxPassword: string
) {
  const formData = new FormData();
  formData.append(
    "file",
    new Blob([pfxBuffer], { type: "application/x-pkcs12" }),
    "procurador-escritorio.pfx"
  );
  formData.append("password", pfxPassword);

  const response = await fetch(`${BASE_URL}/org/certificate`, {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${ORG_TOKEN}`
    },
    body: formData
  });

  if (!response.ok) {
    throw new Error(`Erro ao enviar certificado de procurador: ${await response.text()}`);
  }

  return await response.json();
  // Retorna HTTP 201:
  // {
  //   mode: "org_proxy",
  //   useWedigiProxy: false,
  //   orgCertificate: {
  //     id: "cert_...",
  //     commonName: "CONTABILIDADE EXEMPLO LTDA:...",
  //     holderDocument: "11222333000181",
  //     holderDocumentType: "cnpj",
  //     validUntil: "2027-11-09T...",
  //     scopeRestriction: "snnfse_only"
  //   }
  // }
}

A partir desse momento, todas as empresas da sua organização que não tiverem certificado próprio cadastrado herdarão automaticamente esse certificado de procurador em todas as emissões, cancelamentos e sincronizações cujo motor final seja 'snnfse'. E se uma empresa específica estiver num município de motor próprio (como São Paulo capital para não-MEI) ou emitir NF-e de produto, você simplesmente sobe o .pfx próprio naquele projeto (POST /api/v1/org/projects/{id}/certificate), que terá prioridade máxima (project_own) sem conflitar com o restante da carteira!

4. Comparativo de Planos: Como Escalar com Previsibilidade

Na Notaas, estruturamos o acesso à emissão por Procuração Eletrônica de forma transparente dentro da nossa escada de planos pagos:

Com o Plano Dev (R$ 99/mês), grupos empresariais, holdings, MEIs de alto volume e startups já conseguem operar até 3 CNPJs em produção usando um único certificado digital ou a procuração We Digi. Já para Software Houses, ERPs, plataformas de clínicas/salões e escritórios contábeis, o Plano SaaS Pro (R$ 249/mês) destrava CNPJs ilimitados via Org API com suporte completo a Procuração Eletrônica RFB nas emissões do Ambiente Nacional (snnfse).

5. Caso de Uso Matador: Como Emitir NFS-e para MEI via API Sem Certificado Digital (e Passo a Passo no gov.br)

Uma das maiores dores históricas de quem desenvolve ERPs para prestadores de serviço, sistemas de agendamento, plataformas sob a Lei do Salão Parceiro ou aplicativos contábeis sempre foi o paradoxo do MEI na API da NFS-e Nacional:

• Para emitir manualmente pelo Portal Nacional da NFS-e (nfse.gov.br), o Microempreendedor Individual usa apenas login e senha do gov.br (nível Prata ou Ouro), sem precisar comprar certificado digital.
• Porém, para automatizar a emissão via API (POST /SefinNacional/nfse), o servidor federal exige obrigatoriamente handshake mTLS e assinatura XMLDSig com Certificado Digital ICP-Brasil. Como 95% dos MEIs não compram um e-CNPJ A1 (que custa entre R$ 150 e R$ 250 por ano), o SaaS travava na ativação desses clientes.

Com a Procuração Eletrônica RFB (00233) integrada à Notaas, esse bloqueio deixou de existir para 100% dos MEIs do Brasil:

1. Todo MEI do Brasil opera no motor 'snnfse': Pela Resolução CGSN nº 169/2022, todo MEI prestador de serviços emite obrigatoriamente pelo Ambiente Nacional da NFS-e — inclusive em capitais com sistema próprio como São Paulo/SP, Curitiba ou Belo Horizonte. Na Notaas, sempre que o projeto está configurado com regime_tributario = "2" (MEI), nosso roteador resolve automaticamente sistemaNfse === 'snnfse'.
2. O MEI outorga a procuração de graça usando apenas a conta gov.br: O microempreendedor não precisa comprar e-CNPJ nem e-CPF para cadastrar a procuração eletrônica. Basta ter conta gov.br nível Prata ou Ouro.

⚡ Passo a Passo: Como o Cliente (MEI ou PJ) Cadastra a Procuração Eletrônica 00233 na Receita Federal:

• 1. Acesso ao Portal de Serviços da RFB: O titular do MEI (ou responsável legal da empresa) acessa servicos.receitafederal.gov.br e entra com sua conta gov.br (Prata ou Ouro).
• 2. Menu de Autorizações: No menu lateral ou na busca rápida, acessa Procurações → Minhas Autorizações de Acesso (ou Cadastrar Procuração Eletrônica) e clica em + Nova Autorização.
• 3. Dados do Procurador (Outorgado):
  • Para usar o Certificado Institucional da Notaas (wedigi_proxy — Zero .pfx): seleciona Pessoa Jurídica e informa o CNPJ 03.167.121/0001-10 (We Digi Tecnologia Ltda).
  • Para usar o Certificado da Contabilidade ou Software House (org_proxy): informa o CNPJ ou CPF titular do certificado .pfx que você subiu na sua Organização.
• 4. Seleção do Serviço 00233 e Vigência: Define a data de vigência, marca o serviço 00233 - NFS-e - Nota Fiscal de Serviços Eletrônica (ou Todos os serviços existentes) e assina digitalmente pelo próprio autenticador gov.br. Em segundos, a autorização já está ativa na Sefin Nacional!

Perguntas Frequentes (FAQ) sobre Procuração Eletrônica na NFS-e Nacional

O MEI consegue emitir NFS-e via API sem ter Certificado Digital A1?

Sim. Como todo MEI prestador de serviços emite obrigatoriamente no Ambiente Nacional (sistemaNfse === 'snnfse'), ele pode acessar gratuitamente o portal servicos.receitafederal.gov.br com sua conta gov.br (Prata ou Ouro) e conceder Procuração Eletrônica no serviço 00233 - NFS-e para o CNPJ da sua Software House/Contabilidade (org_proxy) ou para o CNPJ institucional da Notaas/We Digi (03.167.121/0001-10, modalidade wedigi_proxy). A partir dos planos Dev (R$ 99/mês) e SaaS Pro (R$ 249/mês), a Notaas assina e transmite a DPS via API sem que o MEI precise adquirir arquivo .pfx.

Qual é o código do serviço de Procuração Eletrônica na Receita Federal para emitir NFS-e Nacional?

O código oficial na tabela de serviços do Portal de Serviços da Receita Federal / e-CAC é o 00233 - NFS-e - Nota Fiscal de Serviços Eletrônica. Ao habilitar esse serviço (ou a opção "Todos os serviços existentes"), a Sefin Nacional e o ADN passam a autorizar a emissão, o cancelamento e a consulta de NFS-e via API utilizando o Certificado Digital A1 do procurador.

Posso usar 1 único Certificado Digital A1 para emitir notas de múltiplos CNPJs?

Sim, para todas as emissões de NFS-e cujo motor final seja o Ambiente Nacional (snnfse). Na Notaas, você faz o upload do certificado A1 do procurador uma única vez via POST /api/v1/org/certificate (ou ativa o procurador institucional We Digi) e todos os CNPJs da sua organização que outorgaram a procuração 00233 na Receita Federal passam a emitir e cancelar NFS-e automaticamente com esse único certificado. Para municípios com webservice próprio sem convênio SNNFSE ou para NF-e/NFC-e na SEFAZ estadual, continua sendo necessário o certificado próprio de cada CNPJ (project_own).

📚 Referências Oficiais & Guias Relacionados:

• 🏛️ Comunicado Oficial do Portal Nacional NFS-e (31/10/2026): Liberação oficial da representação e alternância de perfis no Portal e nas APIs da Sefin Nacional e ADN.
• 📘 Guia do Emissor Público Nacional Web v1.3 — Tópico 11 (Representação): Especificação oficial da atuação em nome de terceiros perante a Receita Federal.
• 🛡️ Erro E0718, E0714, E0715 e E0716 na NFS-e Nacional: e-CPF do Sócio (QSA) e Matriz/Filial: Diagnóstico completo quando o certificado não pertence ao prestador e regras de mesma raiz de CNPJ.
• 💳 Como Automatizar NFS-e de MEI no Stripe, Asaas, Kiwify, Hotmart e WooCommerce via Webhook (Sem Certificado A1): Exemplo prático em TypeScript de emissão automática pós-pagamento usando a Procuração 00233.
• 🏢 API Fiscal Multi-Tenant e Multi-CNPJ (Org API): Arquitetura completa para provisionar dezenas ou centenas de CNPJs via código.
• ⚡ API NFS-e Nacional — Guia Técnico de Integração: Payload JSON, DPS v1.01 e geração local de DANFSe v2.0.
• 🧪 Como Homologar Múltiplos CNPJs Grátis na Org API e Migrar para Produção: Ciclo de vida completo do sandbox (ambiente: 2) à promoção via PATCH.
• 🤖 Notaas MCP Server para Agentes de IA (@notaas/mcp): Como automatizar o onboarding fiscal e a emissão usando Claude Code, Cursor e Windsurf.
• 🗺️ Cobertura Nacional de NFS-e (4.782 Municípios e Roteamento Multissistema): Como distinguir municípios que operam no motor snnfse das prefeituras com motores próprios.

🚀 Ative a Emissão por Procuração Eletrônica na Notaas

Pare de perder semanas cobrando arquivo .pfx e senha no onboarding dos seus clientes do Ambiente Nacional:

• Zero .pfx com Certificado We Digi: Seu cliente autoriza o CNPJ 03.167.121/0001-10 no serviço 00233 da Receita Federal e começa a emitir no motor snnfse em minutos
• 1 Certificado para Toda a Carteira (org_proxy): Suba o .pfx da sua contabilidade ou Software House uma única vez via Dashboard ou POST /api/v1/org/certificate
• A partir do Plano Dev (R$ 99/mês para até 3 CNPJs) e SaaS Pro (R$ 249/mês para CNPJs ilimitados)

👉 Criar Conta na Notaas Platform e Testar Agora
👉 Consultar a Documentação Oficial da Org API