Use this skill with your AI agent
Paste this skill into your AI agent's context, or save the file to your project. Works with any AI agent that reads markdown.
| 1 | --- |
| 2 | name: br-indirect-tax |
| 3 | description: > |
| 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. |
| 5 | version: 2.0 |
| 6 | jurisdiction: BR |
| 7 | tax_year: 2025 |
| 8 | category: international |
| 9 | depends_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 | |
| 173 | Municipal 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 | |
| 179 | State 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 | |
| 185 | Federal 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 | |
| 191 | ICMS 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 | |
| 195 | NF-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 | |
| 203 | Flag 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 | |
| 207 | DIFAL 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 | |
| 211 | ICMS 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 | |
| 215 | SaaS/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 | ``` |
| 222 | BRAZIL INDIRECT TAX -- Working Paper |
| 223 | Period: [Month / Quarter] |
| 224 | |
| 225 | A. 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 | |
| 232 | B. 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 | |
| 241 | C. 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 | |
| 246 | REVIEWER 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 | ``` |
| 282 | ONBOARDING QUESTIONS -- BRAZIL INDIRECT TAX |
| 283 | 1. What is your tax regime? (Simples Nacional / Lucro Presumido / Lucro Real) |
| 284 | 2. What are your CNAE codes? |
| 285 | 3. Activity type: services, goods, or manufacturing? |
| 286 | 4. State and municipality of registration? |
| 287 | 5. Do you sell interstate? To which states? |
| 288 | 6. Do you import goods? |
| 289 | 7. If on Simples: what is your RBT12 (last 12 months revenue)? |
| 290 | 8. Are any of your products subject to ICMS-ST? |
| 291 | 9. Do you issue NFS-e, NF-e, or both? |
| 292 | 10. 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 | |
| 314 | Brazil 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 | |
| 334 | This 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 | |
| 336 | The 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
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.
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.