📝 Resumo
Este artigo orienta a configuração e a geração do XML ABRASF 2.04 (Serviço Tomado) no TAF/Protheus (mód. 84) para envio ao GissOnline. Cobre pré-requisitos, principais cadastros, assistente de geração, regras de aglutinação por filial/CNPJ/IE, mapeamentos de tags e campos adicionais para Construção Civil.
🎯 Aplicabilidade
Solução: TAF (TOTVS Automação Fiscal)
Escopo: ISSQN — Serviços Tomados (NFSe recebidas/RPS)
Layout: GISS – ABRASF 2.04 (Serviço Tomado)
Esfera: Municipal
Ambiente: Produção/Homologação com TSI implementado
✅ Pré-requisitos
🔄 Disponibilidade: a partir da Expedição Contínua de janeiro/2025.
🔌 Integração: notas somente via TSI (TSI obrigatório).
📦 Extrator Fiscal: sem classificação para os novos campos (não aplicável).
🧾 Cadastros mínimos:
Participantes (CNPJ/CPF, endereço, IM/UF/município, e-mail/telefone, regime especial).
Natureza de Operação (Exigibilidade ISS configurada).
Itens/Serviços (código municipal, item da lista, discriminação).
País IBGE (quando exigido).
Construção Civil: Obra/ART (quando aplicável).
📃 Documentos elegíveis:
Entrada com espécie NFS/RPS que incidam ISS (Tributo 01 ou 16).
Documentos de ISS com cadastro de obra.
🧱 Principais Cadastros (checklist rápido)
👤 Participantes (C1H): CNPJ/CPF, Razão/Nome Fantasia, Endereço, Bairro, CEP, UF, Município (código), IM, C1H_REGTRI (Regime Especial), Simples Nacional.
🧭 Natureza (C1N): C1N_CODEXI / C1N_IDEXIG (Exigibilidade ISS) — necessário para
<ExigibilidadeISS>.🧩 Serviço/Item (C30/C35):
C30_CODSER,C30_CODIFICADOR(Item Lista),C30_SRVMUN(Tributação municipal),C30_DESCRI,C35_BASE/ALIQ/VALOR.🧱 Obras (T9C): T9C_CODART (ART) — ativa o grupo DadosConstrucaoCivil.
🌎 País IBGE (C08): C08_PAISIB quando requerido por município.
⚙️ Passo a passo
1) Configuração inicial
Abra o módulo 84 — TOTVS Automação Fiscal (TAF).
Acesse Complemento Cadastral.
Selecione o código
000021 — GISS Modelo ABRASF. ✅
2) Central de Obrigações
Menu ➜ Central de Obrigações.
Selecione Esfera Municipal.
Escolha
000021 — GISS Modelo ABRASFe clique em Avançar.
3) Parâmetros do Wizard
📂 Diretório do arquivo destino: caminho do XML.
🧾 Nome do arquivo destino: nome base do XML.
🗓️ Dados iniciais / finais: período de competência.
🏢 Seleciona Filiais: Sim/Não (multi filiais).
🧮 Aglutina:
Não aglutinar
Por CNPJ
Por CNPJ + IE
💡 Regra de lote: até 50 NF por arquivo; excedendo, o TAF abre novo lote automaticamente.
4) Regras de geração (Filiais × Aglutinação)
Seleciona Filiais = Não & Aglutina = Não → 1 XML para filial logada.
Seleciona Filiais = Sim & Aglutina = Não → 1 XML por filial selecionada.
Seleciona Filiais = Sim & Aglutina = Por CNPJ → 1 XML por CNPJ.
Seleciona Filiais = Sim & Aglutina = Por CNPJ + IE → 1 XML por CNPJ+IE.
🏷️ Preenchimento das Principais Tags (mapeamento-chave)
IdentificacaoDeclaracao
<Numero>/<NumeroDeclarado>→ C20_NUMDOC<Serie>/<SerieDeclarada>→ Série (C20)<Tipo>→ 1 (fixo)<Competencia>→ C20_DTCPIS
DadosPrestador (Participante)
<Cnpj/CPF>→ C1H_CNPJ / C1H_CPF<NomeFantasia>/<RazaoSocial>→ C1H_NOME<Endereco>→ C1H_TPLOGR •<Numero>→ C1H_NUM •<Bairro>→ C1H_BAIRRO<CodigoMunicipio>→ C1H_CODMUN •<Uf>→ C1H_UF •<Cep>→ C1H_CEP<Telefone>→ C1H_FONE •<Email>→ C1H_EMAIL<OptanteSimplesNacional>→ C1H_SIMPLS
DadosServicoComprado
<ValorServicos>→ C20_VLSERV<ValorDeducoes>→ C20_VLABMT + C20_VLABSU<ValorPis/Cofins/INSS/IR/CSLL/ISS>→ C35_VALOR (por tributo)<ValTotTributos>→ Σ tributos ≠ 000001 e ≠ 000016<Alíquota>→ C35_ALIQ<DescontoIncondicionado>→ C30_VLDESC<ItemListaServico>→ C30_CODIFICADOR<CodigoTributacaoMunicipio>→ C30_SRVMUN<Discriminacao>→ C30_DESCRI<CodigoMunicipio>→ C20_CODLOC<ExigibilidadeISS>→ C30_CODNAT (requerC1N_IDEXIG)
DadosConstrucaoCivil (quando houver)
<CodigoObra>→ C20_IDOBR<Arte>→ T9C_CODART
🧠 Coerência obrigatória:
C20_DTDOC(emissão) ×C20_DTCPIS(competência).
🆕 Novos Campos (layout 2.04)
Capa (C20):
C20_DTCPIS— Dt. Comp ISS (TAFA062)Obras (T9C):
T9C_CODART— Código ART (TAFA057)Participantes (C1H):
C1H_REGTRI— Regime Especial (TAFA053)País IBGE (C08):
C08_PAISIB— País IBGE (3 dígitos)Natureza (C1N):
C1N_CODEXI/C1N_IDEXIG— Exigibilidade ISS
🗃️ Dicionário (referência rápida)
T9C_CODART (T9C/10, C,15) — Código ART – Serv. Construção Civil
C20_DTCPIS (C20/94, D,8) — Dt. Comp ISS (Competência)
C1H_REGTRI (C1H/68, C,1) — Regime Especial (1 a 6)
C08_PAISIB (C08/12, C,3) — Código do País IBGE
C1N_CODEXI / C1N_IDEXIG — Exigibilidade/apoio a
<ExigibilidadeISS>
⚠️ Erros comuns (e como evitar)
Tag obrigatória ausente ➜ revise mapeamentos; verifique cadastros C1H/C1N/C30/C35/T9C.
Competência divergente (
C20_DTDOC×C20_DTCPIS) ➜ alinhe mês/ano.Exigibilidade não definida (
C1N_IDEXIG) ➜ preencha Natureza (C1N).Código do município inválido ➜ valide C1H_CODMUN / C20_CODLOC com a base municipal.
Construção Civil sem ART/Obra ➜ informe C20_IDOBR / T9C_CODART ou remova o grupo.
Mais de 50 NF no lote ➜ esperado: o TAF quebra em múltiplos arquivos.
Tributos somatórios incorretos ➜ confira C35_BASE/ALIQ/VALOR por item e ValTotTributos.
❓ FAQ
Posso gerar por várias filiais?
Sim. Use Seleciona Filiais = Sim e escolha Aglutina (Não / por CNPJ / por CNPJ+IE).Quantas notas vão em cada arquivo?
Até 50 NF por XML. O TAF abre novos lotes automaticamente.Como tratar Construção Civil?
Preencha C20_IDOBR e T9C_CODART — o grupo passa a ser obrigatório.De onde vem a
<Alíquota>?
DeC35_ALIQ(por item). Confira também Tributo 01/16.E se a competência não bater com a emissão?
O XML pode ser rejeitado. AjusteC20_DTCPISou reprocesse o período.O Extrator Fiscal precisa de algo?
Para os novos campos, não — não houve inclusão de classificação específica.
📚 Referências
Layout Único TAF — Integração GISS ABRASF 2.04 (Serviço Tomado)
Guia Rápido — Cadastro de Serviço de Terceiros (CST) v2.2
Documentação Municipal GissOnline (normas locais e códigos municipais)
🗂️ Categoria e Tags (sugeridas)
Categoria: Fiscal • ISSQN • TAF (Mód. 84)
Tags:
GISS,ABRASF 2.04,Serviço Tomado,TAF,XML,ISS,Construção Civil,Exigibilidade,Filiais,Lotes