Tag <tribFed> na NFS-e (Retenções de IRRF, PIS, COFINS, CSLL e INSS na NT-007) e Serviços para o Exterior (NIF / ISO2)

💡 Guias de Referência do Cluster: Para a visão geral da integração de serviços, acesse o guia pilar API NFS-e Nacional 2026: Guia de Integração em 4.782 Cidades. Se você busca exportação de mercadorias (NF-e Modelo 55 com CFOP 7.xxx e idEstrangeiro), consulte nosso artigo dedicado à NF-e de Exportação de Produtos. Abaixo, tratamos exclusivamente do grupo <tribFed> (NT-007) e de prestação de serviços para o exterior na NFS-e.

Quando um SaaS B2B, clínica médica, consultoria de TI ou escritório de contabilidade sai do Simples Nacional — ou começa a faturar contratos corporativos para empresas de médio e grande porte —, a emissão da Nota Fiscal de Serviço Eletrônica (NFS-e) deixa de ser apenas informar o valor bruto e a alíquota do ISS.

Entram em cena dois cenários de alto valor agregado que separam um emissor amador de uma infraestrutura fiscal pronta para o mercado corporativo:

1. O destaque das Retenções Federais na Fonte (<tribFed> na NT-007 do SNNFSE): Onde o tomador pessoa jurídica retém IRRF (1,5% ou 1,0%), CSRF de 4,65% (PIS 0,65% + COFINS 3,00% + CSLL 1,00%) e/ou INSS (11% ou 3,5% na cessão de mão de obra), abatendo esses valores diretamente do Valor Líquido da NFS-e (<vLiq>) e da cobrança bancária/PIX.
2. A Exportação de Serviços para o Exterior: Onde desenvolvedores, consultorias e software houses brasileiras faturam em dólar ou euro para clientes nos Estados Unidos, Europa (incluindo países como Bulgária, Irlanda, Reino Unido e Alemanha) ou América Latina com imunidade/não incidência de ISSQN, exigindo codificação correta de país (cPais ISO2 / BACEN) e NIF do tomador estrangeiro.

Entre as releases v0.56.102 e v0.56.120 da plataforma Notaas (incluindo o @notaas/mcp v0.2.3), aprimoramos o motor de retenções federais (<tribFed>), expandimos a tabela internacional ISO2 para exportação de serviços e ativamos homologações e melhorias profundas em polos econômicos como Uberlândia/MG, Caxias do Sul/RS (Infisc + SNNFSE), Fortaleza/CE (GINFES), Paranaguá/PR (Elotech) e municípios E&L.

Como funciona o grupo <tribFed> (NT-007) na NFS-e Nacional e nos Provedores Municipais

No padrão nacional da NFS-e (SNNFSE / Sefin Nacional), o grupo de tributos federais fica localizado dentro de <valores><trib><tribFed> na Declaração de Prestação de Serviços (DPS).

Um erro muito comum que víamos em integrações próprias antes da Nota Técnica SEFIN/ADN nº 007 (NT-007) era confundir a tributação própria de PIS/COFINS do prestador com a retenção na fonte pelo tomador, o que fazia o Ambiente de Dados Nacional (ADN) calcular um Valor Líquido (vLiq) divergente do esperado pelo financeiro do cliente.

Veja como a engenharia do bloco <tribFed> é estruturada no XML oficial do SNNFSE e como ela impacta o valor líquido da nota:

O segredo da tag <tpRetPisCofins> na NT-007 (v0.56.102)

Na NFS-e Nacional, preencher apenas <vPIS> e <vCOFINS> não basta para que o SNNFSE desconte esses valores do líquido da nota. É obrigatório configurar a tag <tpRetPisCofins> conforme a NT-007:

• 1 (PIS/COFINS Retido): Indica que o tomador PJ está retendo o PIS (0,65%) e a COFINS (3,00%) na fonte (Lei nº 10.833/2003, art. 30). Nesse caso, o SNNFSE deduz vPIS + vCOFINS do <vLiq> da NFS-e e destaca a retenção no PDF do DANFSe v2.0.
• 2 (PIS/COFINS Não Retido): Indica apuração própria sem retenção pelo tomador.

Na release v0.56.102, o dps-builder da Notaas passou a montar automaticamente o grupo <tribFed> com <tpRetPisCofins>1</tpRetPisCofins>, <CST>01</CST>, <vBCPisCofins> e as alíquotas percentuais proporcionais sempre que o desenvolvedor informa valorPis, valorCofins, valorCsll, valorIr ou valorInss no payload JSON (ou via tool nfse_emit no Notaas MCP Server v0.2.3).

Exemplo Prático em JSON: Emitindo NFS-e B2B de R$ 10.000,00 com Retenção de IRRF (1,5%) e CSRF (4,65%)

Imagine uma consultoria de tecnologia no Lucro Presumido emitindo uma nota de R$ 10.000,00 para um banco ou grande corporação. Com IRRF de R$ 150,00 (1,5%), PIS de R$ 65,00 (0,65%), COFINS de R$ 300,00 (3,00%) e CSLL de R$ 100,00 (1,00%), o total retido é de R$ 615,00 (6,15%), resultando num valor líquido a receber de R$ 9.385,00:

{
  "tipo": "nfse",
  "ambiente": "producao",
  "externalId": "FAT-CORP-2026-8812",
  "prestador": {
    "cnpj": "12345678000199"
  },
  "tomador": {
    "cpfCnpj": "60701190000104",
    "razaoSocial": "HOLDING FINANCEIRA BRASIL S.A.",
    "email": "contasapagar@holdingfinanceira.com.br",
    "endereco": {
      "logradouro": "Avenida Engenheiro Luís Carlos Berrini",
      "numero": "105",
      "bairro": "Cidade Monções",
      "cidade": "São Paulo - SP",
      "cep": "04571010"
    }
  },
  "servico": {
    "codigo": "010601",
    "codigoNbs": "115011000",
    "descricao": "Consultoria especializada em arquitetura de segurança em nuvem e auditoria de código — Outubro/2026.",
    "aliquota": 2.0,
    "valor": 10000.00,
    "issRetido": false,
    "valorIr": 150.00,
    "valorPis": 65.00,
    "valorCofins": 300.00,
    "valorCsll": 100.00,
    "valorInss": 0.00
  }
}

Exportação de Serviços para o Exterior (v0.56.119): Faturando para os EUA e Europa sem Erro de País

Se a sua empresa ou os clientes do seu ERP prestam serviços de desenvolvimento de software, design ou consultoria para empresas no exterior, a emissão da NFS-e de exportação exige atenção redobrada à tabela de países (cPais).

Enquanto a NF-e (Modelo 55) utiliza a tabela de 4 dígitos do BACEN (ex.: 2496 para Estados Unidos), o SNNFSE Nacional e diversos provedores municipais modernos (como o motor TBW) utilizam o padrão ISO 3166-1 alpha-2 (2 letras, como US, DE, GB, PT, IE, BG) combinado com o bloco <endExt> (Endereço no Exterior) e o <NIF> (Número de Identificação Fiscal estrangeiro).

Na release v0.56.119, expandimos nossa tabela de conversão internacional ISO2 <-> BACEN para cobrir todos os polos europeus, norte-americanos e asiáticos (incluindo hubs emergentes de tecnologia do Leste Europeu como a Bulgária BG, Estônia EE, Polônia PL e Irlanda IE), garantindo que um único payload JSON funcione tanto em prefeituras do Padrão Nacional quanto em motores municipais:

{
  "tipo": "nfse",
  "ambiente": "producao",
  "externalId": "EXPORT-SaaS-2026-309",
  "prestador": {
    "cnpj": "12345678000199"
  },
  "tomador": {
    "estrangeiro": true,
    "nif": "US-98-7654321",
    "razaoSocial": "ACME CLOUD TECHNOLOGIES INC.",
    "email": "ap@acmecloud.io",
    "endereco": {
      "paisCodigo": "US",
      "logradouro": "548 Market St, Suite 400",
      "cidade": "San Francisco",
      "estadoExterior": "CA",
      "cep": "94104"
    }
  },
  "servico": {
    "codigo": "010101",
    "codigoNbs": "115021000",
    "descricao": "Custom software engineering services rendered to foreign client (Export of Services - Complementary Law 116/2003 Art. 2 I).",
    "valor": 28500.00,
    "exportacao": true
  }
}

Expansão de Cobertura Municipal (v0.56.102 a v0.56.120): Uberlândia, Caxias do Sul (Infisc), Fortaleza (GINFES), Paranaguá e E&L

Junto com as melhorias fiscais B2B, nossa engenharia de integrações municipais entregou nas últimas semanas atualizações importantes para quem utiliza nossa API de NFS-e em mais de 4.780 municípios:

⚡ Destaques de Cobertura e Motores Municipais (v0.56.102 – v0.56.120):

• 1. Uberlândia/MG (3170206 — v0.56.102): Homologação completa e resolução automática por nome de cidade no endpoint REST e no @notaas/mcp v0.2.3.
• 2. Caxias do Sul/RS (4305108 — Infisc & SNNFSE v0.56.105, v0.56.112, v0.56.113): População completa da tabela de desdobros municipais (cTribMun), tratamento de retorno HTTP 200 com extração de nNFSe, geração de DANFSe local e suporte completo a cancelamento de notas na engine Infisc (cancelarNFSe).
• 3. Fortaleza/CE (2304400 — GINFES v0.56.103): Resolução automática de NaturezaOperacao para operações sem incidência, isenção e imunidade tributária no GINFES de Fortaleza sem exigir configuração manual por RPS.
• 4. Paranaguá/PR (4118204 — Elotech Oxy ISS v0.56.109): Ativação do motor Elotech com alinhamento do contrato WSDL v2.03 para o principal porto do Paraná.
• 5. Municípios E&L no ES, BA e MG (el_nacional — v0.56.118 e v0.56.120): Descoberta automática de token via Certificado Digital A1 (mTLS) sem exigir que o cliente configure usuário/senha de Basic Auth no painel, além de auto-migração quando a prefeitura retorna EL137 ou E999.

Automatize o Faturamento B2B da sua Empresa ou Software House

Chega de perder horas calculando retenções de CSRF na mão, corrigindo tags <tpRetPisCofins> no XML ou mantendo dezenas de integrações SOAP municipais.

• Comece Grátis em Produção: Emita até 20 notas fiscais gratuitas por mês em produção real (1 CNPJ) e homologue até 5 CNPJs simultâneos grátis na Org API em platform.notaas.com.br/sign-up.
• Planos Sob Medida para Escalar: Contrate o Plano Dev (R$ 99/mês para até 3 CNPJs) ou o Plano SaaS Pro (R$ 249/mês com CNPJs ilimitados via Org API) e consulte nossa Documentação Oficial.