Not tax advice. Computation tools only. Have a professional check your work before filing.
openaccountants/skills/br-indirect-tax.md

Use this skill with your AI agent

View on GitHub

Paste this skill into your AI agent's context, or save the file to your project. Works with any AI agent that reads markdown.

br-indirect-tax.md337 lines13.3 KB
v20Brazil
Not yet verified by an accountantContact accountant
1---
2name: br-indirect-tax
3description: >
4 Use this skill whenever asked about Brazilian indirect tax obligations (ICMS, ISS, IPI) for self-employed individuals or small businesses. Trigger on phrases like "ICMS", "ISS", "IPI", "Brazil VAT", "Brazilian indirect tax", "nota fiscal", "imposto sobre servicos", "imposto sobre circulacao de mercadorias", or any question about indirect tax computation or compliance in Brazil. Covers ISS (municipal, 2-5%), ICMS (state, variable), IPI (federal), interaction with Simples Nacional, and the upcoming IBS/CBS tax reform. ALWAYS read this skill before touching any Brazilian indirect tax work.
5version: 2.0
6jurisdiction: BR
7tax_year: 2025
8category: international
9depends_on:
10 - income-tax-workflow-base
11---
12 
13# Brazil Indirect Tax (ICMS/ISS/IPI) -- Self-Employed Skill v2.0
14 
15---
16 
17## Section 1 -- Quick Reference
18 
19| Field | Value |
20|---|---|
21| Country | Brazil (Republica Federativa do Brasil) |
22| Tax | ISS (municipal, 2-5%), ICMS (state, 7-25%), IPI (federal, varies by product) |
23| Currency | BRL only |
24| Tax year | Calendar year |
25| Primary legislation | LC 87/1996 (Lei Kandir -- ICMS); LC 116/2003 (ISS); Decreto 7.212/2010 (RIPI -- IPI) |
26| Supporting legislation | CF/88 Art. 155-156; LC 123/2006 (Simples Nacional); EC 132/2023 (Tax Reform) |
27| Tax authority | State SEFAZ (ICMS); Municipal prefeitura (ISS); Receita Federal (IPI) |
28| Filing portal | State SEFAZ portals; municipal NFS-e portals; Receita Federal (e-CAC) |
29| Filing deadline | Varies by state, municipality, and regime |
30| Contributor | Open Accountants Community |
31| Validated by | Pending -- requires sign-off by a Brazilian contador (CRC-registered) |
32| Skill version | 2.0 |
33 
34### ISS Rate Range
35 
36| Municipality | Common ISS Rate |
37|---|---|
38| Sao Paulo | 2% to 5% (IT services typically 2-3%) |
39| Rio de Janeiro | 2% to 5% |
40| Most municipalities | Default 5% unless reduced by specific municipal law |
41 
42### ICMS Internal Rates (Intrastate)
43 
44| State | Standard Rate |
45|---|---|
46| Sao Paulo | 18% |
47| Rio de Janeiro | 20% (18% + FECP 2%) |
48| Minas Gerais | 18% |
49| Most states | 17-20% |
50 
51### Interstate ICMS Rates
52 
53| Route | Rate |
54|---|---|
55| South/Southeast to South/Southeast | 12% |
56| South/Southeast to North/Northeast/Center-West/ES | 7% |
57| North/Northeast/Center-West/ES to any state | 12% |
58| Imported goods (any interstate) | 4% |
59 
60### Conservative Defaults
61 
62| Ambiguity | Default |
63|---|---|
64| Unknown tax regime | Outside Simples Nacional (apply normal rates) |
65| Unknown ICMS rate | Highest applicable intrastate rate |
66| Unknown ISS rate | 5% (municipal maximum) |
67| Unknown CNAE classification | Services (ISS) |
68| Unknown interstate route | 7% (most conservative for credit purposes) |
69 
70---
71 
72## Section 2 -- Required Inputs and Refusal Catalogue
73 
74### Required Inputs
75 
76**Minimum viable** -- tax regime (Simples/Lucro Presumido/Lucro Real), activity type (services/goods/manufacturing), CNAE code(s), state and municipality of registration.
77 
78**Recommended** -- revenue breakdown by type, interstate sales detail, Simples Nacional DAS history, nota fiscal register.
79 
80**Ideal** -- complete accounting records, ICMS credit ledger, ISS retention records, NF-e/NFS-e XML files.
81 
82### Refusal Catalogue
83 
84**R-BR-1 -- Tax reform transition (IBS/CBS).** "The IBS/CBS tax reform is still being finalized. Transition rules are not yet complete. Escalate all tax reform questions."
85 
86**R-BR-2 -- ICMS-ST detailed computation.** "ICMS Substituicao Tributaria requires product-specific MVA lookup and state-specific protocols. Escalate to contador."
87 
88**R-BR-3 -- Guerra fiscal disputes.** "Interstate tax incentive disputes (guerra fiscal) require specialist analysis. Escalate."
89 
90**R-BR-4 -- IPI complex chains.** "IPI credit chains for multi-step manufacturing require specialist analysis. Escalate."
91 
92---
93 
94## Section 3 -- Transaction Pattern Library
95 
96### 3.1 Revenue Patterns
97 
98| Pattern | Tax Treatment | Notes |
99|---|---|---|
100| VENDA MERCADORIA, NF-E | ICMS on goods sale | Intrastate rate applies |
101| PRESTACAO SERVICO, NFS-E | ISS on service | Municipal rate applies |
102| VENDA INTERESTADUAL | ICMS at interstate rate | 7% or 12% depending on route |
103| EXPORTACAO | Exempt/zero ICMS and ISS | Immune under CF/88 |
104| VENDA CONSUMIDOR FINAL (interstate) | DIFAL applies | Seller collects differential |
105| PLATAFORMA DIGITAL, MARKETPLACE | ISS or ICMS | Depends on goods vs services |
106 
107### 3.2 Expense / Input Patterns
108 
109| Pattern | Tax Treatment | Notes |
110|---|---|---|
111| COMPRA MERCADORIA, NF-E ENTRADA | ICMS credit (if outside Simples) | Non-cumulative credit |
112| MATERIA PRIMA, INSUMO | ICMS + IPI credit | Manufacturing inputs |
113| SERVICO TOMADO, NFS-E | ISS may be retained at source | Check retention rules |
114| ENERGIA ELETRICA | ICMS credit (partial) | Only for industrial use in some states |
115| TELECOMUNICACOES | ICMS credit (partial) | Varies by state |
116| ALUGUEL COMERCIAL | No ICMS/ISS credit | Rent is not subject to indirect tax |
117 
118### 3.3 Simples Nacional Patterns
119 
120| Pattern | Tax Treatment | Notes |
121|---|---|---|
122| DAS SIMPLES NACIONAL | Unified payment includes ICMS/ISS | Unless above sublimit |
123| ICMS-ST SEPARADO | Paid outside Simples even in Simples | Substitute tributario products |
124| ICMS IMPORTACAO | Paid separately at customs | Even in Simples |
125 
126---
127 
128## Section 4 -- Worked Examples
129 
130### Example 1 -- ISS Computation (Outside Simples)
131 
132**Input:** Consulting firm in Sao Paulo. Monthly service revenue R$ 50,000. ISS rate 5%.
133 
134**Computation:**
135- ISS = R$ 50,000 x 5% = R$ 2,500
136 
137### Example 2 -- ICMS Computation (Outside Simples, Intrastate SP)
138 
139**Input:** Retailer in SP selling goods worth R$ 100,000. Internal rate 18%. Purchases R$ 60,000 with 18% ICMS.
140 
141**Computation:**
142- ICMS on sales: R$ 100,000 x 18% = R$ 18,000
143- ICMS credits on purchases: R$ 60,000 x 18% = R$ 10,800
144- ICMS payable: R$ 18,000 - R$ 10,800 = R$ 7,200
145 
146### Example 3 -- Interstate Sale (SP to BA)
147 
148**Input:** SP company sells R$ 10,000 goods to BA company. Interstate rate 7%. BA internal rate 19%.
149 
150**Computation:**
151- ICMS charged: R$ 10,000 x 7% = R$ 700 (seller pays to SP SEFAZ)
152- If B2B (buyer is taxpayer): buyer pays DIFAL of 12% (19% - 7%) to BA
153- If B2C: seller collects DIFAL of 12% and remits to BA
154 
155### Example 4 -- ISS Retention at Source
156 
157**Input:** Consulting invoice R$ 20,000 to large corporate client. ISS rate 5%. Subject to retention.
158 
159**Computation:**
160- ISS = R$ 20,000 x 5% = R$ 1,000
161- Client retains R$ 1,000 and remits to municipality
162- Provider receives R$ 19,000
163- Provider does not pay ISS separately on this invoice
164 
165---
166 
167## Section 5 -- Tier 1 Rules (When Data Is Clear)
168 
169### 5.1 ISS Structure
170 
171**Legislation:** LC 116/2003
172 
173Municipal tax on services. Rate range 2% to 5%. Base: gross price of the service. General rule: taxed where the service provider is established. Exceptions under Art. 3 for services taxed where performed.
174 
175### 5.2 ICMS Structure
176 
177**Legislation:** LC 87/1996
178 
179State tax on sale of goods, interstate/inter-municipal transport, telecommunications. Non-cumulative (credit for ICMS paid on inputs outside Simples). Rate varies by state and product.
180 
181### 5.3 IPI Structure
182 
183**Legislation:** Decreto 7.212/2010
184 
185Federal tax on industrialized products. Applies to manufacturers and importers. Rate varies by product per TIPI table (NCM code). Non-cumulative. Most self-employed service providers do NOT pay IPI.
186 
187### 5.4 Simples Nacional Interaction
188 
189**Legislation:** LC 123/2006, Art. 13, 18
190 
191ICMS and ISS are included in the DAS for Simples Nacional businesses below the R$ 3,600,000 sublimit. Above the sublimit, ICMS and ISS are paid outside Simples at normal rates.
192 
193### 5.5 Nota Fiscal Types
194 
195NF-e (goods/ICMS), NFS-e (services/ISS), NFC-e (retail consumer), CT-e (transport). NFS-e issued via municipal portal with provider CNPJ, client CNPJ/CPF, service code, value, ISS rate, ISS amount.
196 
197---
198 
199## Section 6 -- Tier 2 Catalogue (Reviewer Judgement Required)
200 
201### 6.1 ISS Location of Taxation
202 
203Flag for reviewer when services are performed in a municipality different from the provider's registration. Certain services are taxed where performed under LC 116/2003, Art. 3.
204 
205### 6.2 DIFAL Computation
206 
207DIFAL applies when selling to a non-taxpayer consumer in another state. DIFAL = internal rate of destination state minus interstate rate. Flag for reviewer on all DIFAL calculations.
208 
209### 6.3 ICMS-ST (Substituicao Tributaria)
210 
211ICMS collected upfront by manufacturer/importer for the entire chain. Applies to specific product categories. Computation requires MVA (Margem de Valor Agregado). Always flag for reviewer.
212 
213### 6.4 Software Classification
214 
215SaaS/cloud services are generally ISS. Packaged software was historically ICMS but increasingly ISS. Flag for reviewer -- must check state and municipal legislation.
216 
217---
218 
219## Section 7 -- Excel Working Paper Template
220 
221```
222BRAZIL INDIRECT TAX -- Working Paper
223Period: [Month / Quarter]
224 
225A. ISS
226 A1. Total service revenue ___________
227 A2. ISS rate ___________
228 A3. ISS due ___________
229 A4. ISS retained at source ___________
230 A5. ISS payable (A3 - A4) ___________
231 
232B. ICMS
233 B1. Total goods revenue (intrastate) ___________
234 B2. ICMS rate (intrastate) ___________
235 B3. Output ICMS ___________
236 B4. Input ICMS credits ___________
237 B5. ICMS payable (B3 - B4) ___________
238 B6. Interstate sales ___________
239 B7. DIFAL (if B2C interstate) ___________
240 
241C. SIMPLES NACIONAL CHECK
242 C1. Revenue in last 12 months (RBT12) ___________
243 C2. Above R$ 3,600,000 sublimit? (Y/N) ___________
244 C3. If yes: ICMS/ISS paid outside Simples ___________
245 
246REVIEWER FLAGS:
247 [ ] Tax regime confirmed?
248 [ ] CNAE codes verified?
249 [ ] Interstate operations flagged?
250 [ ] ICMS-ST products identified?
251 [ ] Sublimit check performed?
252```
253 
254---
255 
256## Section 8 -- Bank Statement Reading Guide
257 
258### Brazilian Bank Statement Formats
259 
260| Bank | Format | Key Fields |
261|---|---|---|
262| Banco do Brasil, Caixa, Itau | CSV, PDF, OFX | Data, Historico, Valor, Saldo |
263| Bradesco, Santander | CSV, PDF | Data, Descricao, Debito, Credito |
264| Nubank, Inter, C6 | CSV | Data, Descricao, Valor |
265 
266### Key Brazilian Banking Terms
267 
268| Term | Classification Hint |
269|---|---|
270| TED, DOC, PIX | Transfer -- check direction |
271| BOLETO | Bill payment -- likely expense |
272| DAS, SIMPLES | Simples Nacional tax payment |
273| SEFAZ, ICMS | State tax payment |
274| PREFEITURA, ISS | Municipal tax payment |
275| NF-E, NOTA FISCAL | Invoice-related |
276 
277---
278 
279## Section 9 -- Onboarding Fallback
280 
281```
282ONBOARDING QUESTIONS -- BRAZIL INDIRECT TAX
2831. What is your tax regime? (Simples Nacional / Lucro Presumido / Lucro Real)
2842. What are your CNAE codes?
2853. Activity type: services, goods, or manufacturing?
2864. State and municipality of registration?
2875. Do you sell interstate? To which states?
2886. Do you import goods?
2897. If on Simples: what is your RBT12 (last 12 months revenue)?
2908. Are any of your products subject to ICMS-ST?
2919. Do you issue NFS-e, NF-e, or both?
29210. Any ISS retention at source situations?
293```
294 
295---
296 
297## Section 10 -- Reference Material
298 
299### Key Legislation
300 
301| Topic | Reference |
302|---|---|
303| ISS rates and rules | LC 116/2003 |
304| ISS minimum rate | LC 157/2016 |
305| ICMS (Lei Kandir) | LC 87/1996 |
306| Interstate rates | Resolucao SF 13/2012 (imported goods 4%) |
307| IPI | Decreto 7.212/2010 |
308| Simples Nacional | LC 123/2006 |
309| Tax reform | EC 132/2023 |
310| Nota fiscal | CONFAZ agreements |
311 
312### Tax Reform (IBS/CBS) -- Status
313 
314Brazil is replacing ICMS, ISS, IPI, PIS, and COFINS with IBS (state/municipal) and CBS (federal). Transition period 2026-2032; full implementation by 2033. Combined rate expected ~26.5%. Implementation laws being debated/enacted through 2025-2026. ESCALATE all tax reform transition questions.
315 
316---
317 
318## PROHIBITIONS
319 
320- NEVER apply ICMS to pure services -- services are subject to ISS (except telecom and interstate transport)
321- NEVER apply ISS to sale of physical goods -- goods are subject to ICMS
322- NEVER ignore the R$ 3,600,000 sublimit for Simples Nacional ICMS/ISS
323- NEVER assume ICMS rates are uniform across states -- they vary from 7% to 25%+
324- NEVER assume ISS rates are the same in all municipalities -- they range from 2% to 5%
325- NEVER compute IPI for pure service providers -- IPI applies only to industrialized products
326- NEVER ignore ICMS-ST obligations -- they apply even to Simples Nacional companies
327- NEVER advise on the IBS/CBS tax reform as if it is fully enacted
328- NEVER present calculations as definitive -- always label as estimated and direct client to a CRC-registered contador
329 
330---
331 
332## Disclaimer
333 
334This skill and its outputs are provided for informational and computational purposes only and do not constitute tax, legal, or financial advice. Open Accountants and its contributors accept no liability for any errors, omissions, or outcomes arising from the use of this skill. All outputs must be reviewed and signed off by a qualified professional (such as a CRC-registered contador or equivalent licensed practitioner in Brazil) before filing or acting upon.
335 
336The most up-to-date, verified version of this skill is maintained at [openaccountants.com](https://openaccountants.com). Log in to access the latest version, request a professional review from a licensed accountant, and track updates as tax law changes.
337 

Run this skill, then get an accountant to check it

After running the full skill pack in your AI agent, sign up and upload your worksheet. We'll connect you with a trusted accountant in our network who can review your numbers before you file.

Quality

Q3: AI-drafted

AI-generated with structure and citations. Not independently verified.

Needs deep research against tax authority websites to reach Q2.

Accountant Review

Not yet reviewed
0/33

About

Use this skill whenever asked about Brazilian indirect tax obligations (ICMS, ISS, IPI) for self-employed individuals or small businesses. Trigger on phrases like "ICMS", "ISS", "IPI", "Brazil VAT", "Brazilian indirect tax", "nota fiscal", "imposto sobre servicos", "imposto sobre circulacao de mercadorias", or any question about indirect tax computation or compliance in Brazil. Covers ISS (municipal, 2-5%), ICMS (state, variable), IPI (federal), interaction with Simples Nacional, and the upcoming IBS/CBS tax reform. ALWAYS read this skill before touching any Brazilian indirect tax work.

BRty-2025

Use this skill

This skill is open source and free to use in any AI agent. Copy it, download it, or clone the repo. If you find an error, flag it — a licensed accountant will review.

3 of 6 in the BR workflow: