Tax classes
Get tax class
Class with all rows and the current version.
/openapi/v2/empresas/{empresaId}/classes-imposto/{codigo}token, timestamp and sign signature headers, see Authentication.Path parameters
empresaId* | string | Company identifier |
codigo* | string | Class code |
* Required field
codigo | string | Class code |
tipo | string | Class type |
descricao | string | Class name |
situacao | string | Class status |
| array | Incompatibility reasons |
versao | int | Version |
icms | array | Rows of the group |
ipi | array | Rows of the group |
pis | array | Rows of the group |
cofins | array | Rows of the group |
issqn | array | Rows of the group |
ibsCbs | array | Rows of the group |
icmsPorEstado | array | ICMS per destination state |
dataCriacao | string | Creation time |
dataUltimaAlteracao | string | Last change |
tipoClass type
Required and fixed after creation (10005216). Issuance only accepts a class of its own type (10005215).
| Values | Meaning |
|---|---|
| NFe | For NF-e issuance. All scenarios; no issqn group (10005218) |
| NFCe | For NFC-e issuance. Only SaidaDentroEstado and Padrao (10005219); no ipi group (10005218); only fields NFC-e has (10005217) |
situacaoClass status
Only in the response and the list filter. The platform recalculates when the company CRT, PIS/COFINS regime or record percentualCreditoSimples changes; the marking does not change versao.
| Values | Meaning |
|---|---|
| Compativel | Passes validation under the current regime; can be referenced |
| IncompativelComRegime | No longer passes under the current regime; reasons in motivosIncompatibilidade, an issuance referencing it gets 10005220, a valid whole replacement brings it back to Compativel |
eventosClass webhook event
Only delivered to applications that list it in eventos in webhook registration; subscribing to all events does not include it. Payload in Webhooks.
| Values | Meaning |
|---|---|
| tax_class.incompatible | Class went from Compativel to IncompativelComRegime; not repeated while it stays incompatible |
cenarioRow scenario
Applies to every group. How an invoice falls into a scenario is in the overview. An NFCe class only uses SaidaDentroEstado and Padrao (10005219).
| Values | Meaning |
|---|---|
| SaidaDentroEstado | In-state outbound; NFC-e always uses this one |
| SaidaForaEstado | Interstate outbound |
| SaidaExterior | Export |
| EntradaDentroEstado | In-state inbound (return) |
| EntradaForaEstado | Interstate inbound (return) |
| EntradaExterior | Inbound from abroad (return) |
| Padrao | Any invoice, used when no row of the scenario fits; not allowed on icms[] rows |
tipoPessoaCustomer type
Optional. Not the issuance cliente.tipoPessoa (F / J).
| Values | Meaning |
|---|---|
| Fisica | Buyer with CPF |
| Juridica | Buyer with CNPJ |
| Estrangeiro | Buyer abroad |
| — | Omitted: any type |
naoContribuinteNon-taxpayer buyer
| Values | Meaning |
|---|---|
| true | Only a buyer that is not an ICMS taxpayer |
| false | Only a taxpayer buyer or one exempt from registration |
| — | Any buyer |
icms[].cfopFirst digit of the ICMS CFOP
4 digits; first digit not matching the scenario: 10005212. 5933 is not accepted on an ICMS row (10005214).
| Values | Meaning |
|---|---|
| 5xxx | Scenario SaidaDentroEstado |
| 6xxx | Scenario SaidaForaEstado |
| 7xxx | Scenario SaidaExterior |
| 1xxx | Scenario EntradaDentroEstado |
| 2xxx | Scenario EntradaForaEstado |
| 3xxx | Scenario EntradaExterior |
icms[].situacaoTributariaICMS CST (regular regime, CRT 2 / 3)
Company with CRT 2 / 3. Another code, or a CSOSN on this company: 10005203 / 10004046. Required fields missing: 10004043; fields the code does not accept: 10004044. A row with naoContribuinte = true or tipoPessoa = Fisica cannot use 10, 30 or 70 (10004047).
| Values | Meaning |
|---|---|
| 00 | Fully taxed. Send aliquota; CRT 3 without a rate uses the platform table. No extra field; does not accept ST, monofasico or percentualCreditoSimples |
| 02 | Own single-phase (fuels). Requires monofasico and the combustivel block. On save requires monofasico |
| 10 | Taxed with ST withholding. Requires aliquota and substituicaoTributaria; taxpayer buyer; partilha optional; motivoDesoneracaoSt optional. On save requires substituicaoTributaria.mva and substituicaoTributaria.aliquota; at issuance requires CEST |
| 15 | Own single-phase with withholding (fuels). Requires monofasico with own and withholding rates. On save requires monofasico |
| 20 | With base reduction. Requires aliquota, percentualReducaoBase and codigoBeneficioFiscal; motivoDesoneracao optional. On save requires percentualReducaoBase; at issuance requires codigoBeneficioFiscal |
| 30 | Exempt or not taxed, with ST withholding. Requires substituicaoTributaria and codigoBeneficioFiscal; taxpayer buyer; motivoDesoneracao optional. On save requires substituicaoTributaria.mva and .aliquota; at issuance requires codigoBeneficioFiscal and CEST |
| 40 | Exempt. Requires codigoBeneficioFiscal; motivoDesoneracao optional. At issuance requires codigoBeneficioFiscal |
| 41 | Not taxed. Requires codigoBeneficioFiscal; interstate ST pass-through sends substituicaoTributariaDestino with retencaoAnterior; motivoDesoneracao optional. At issuance requires codigoBeneficioFiscal |
| 50 | Suspended. Requires codigoBeneficioFiscal; motivoDesoneracao optional. At issuance requires codigoBeneficioFiscal |
| 51 | Deferral. Requires aliquota, percentualDiferimento and codigoBeneficioFiscal; with aliquotaFcp requires percentualDiferimentoFcp; with reduction, codigoBeneficioFiscalReducaoBase optional. On save requires percentualDiferimento; at issuance requires codigoBeneficioFiscal |
| 53 | Single-phase with deferral (fuels). Requires monofasico; the deferred share goes in percentualDiferimento. On save requires monofasico |
| 60 | ICMS already withheld upstream by ST. retencaoAnterior optional; tributacaoEfetiva and substituicaoTributariaDestino as the state requires. At issuance requires CEST |
| 61 | Single-phase already charged upstream (fuels). Requires monofasico with the rate already charged. On save requires monofasico |
| 70 | With base reduction and ST withholding. Requires aliquota, percentualReducaoBase, codigoBeneficioFiscal and substituicaoTributaria; taxpayer buyer; motivoDesoneracao and motivoDesoneracaoSt optional. On save requires percentualReducaoBase, substituicaoTributaria.mva and .aliquota; at issuance requires codigoBeneficioFiscal and CEST |
| 90 | Other. Requires codigoBeneficioFiscal; substituicaoTributaria and partilha optional; motivoDesoneracao and motivoDesoneracaoSt optional. ST optional; at issuance requires codigoBeneficioFiscal |
icms[].situacaoTributariaICMS CSOSN (Simples Nacional, CRT 1 / 4)
Company with CRT 1 / 4. percentualCreditoSimples only on CSOSN 101, 201 and 900; ST only on 201, 202, 203 and 900. A row with naoContribuinte = true or tipoPessoa = Fisica cannot use 101, 201, 202, 203 or percentualCreditoSimples (10004047).
| Values | Meaning |
|---|---|
| 101 | Taxed, buyer may take credit. Requires percentualCreditoSimples; taxpayer buyer. Requires percentualCreditoSimples on the row or in the company record |
| 102 | Taxed, no credit. Nothing else in ICMS; codigoBeneficioFiscal and creditosPresumidos as the state requires. No extra field |
| 103 | Exempt by gross-revenue band. Nothing else in ICMS; codigoBeneficioFiscal and creditosPresumidos as the state requires. No extra field |
| 201 | Taxed with credit and ST withholding. Requires percentualCreditoSimples and substituicaoTributaria; taxpayer buyer. On save requires substituicaoTributaria.mva and .aliquota and percentualCreditoSimples on the row or in the record; at issuance requires CEST |
| 202 | Taxed without credit, with ST withholding. Requires substituicaoTributaria; taxpayer buyer. On save requires substituicaoTributaria.mva and .aliquota; at issuance requires CEST |
| 203 | Exempt by revenue band, with ST withholding. Requires substituicaoTributaria; taxpayer buyer. On save requires substituicaoTributaria.mva and .aliquota; at issuance requires CEST |
| 300 | Constitutionally immune. Nothing else in ICMS; codigoBeneficioFiscal and creditosPresumidos as the state requires. No extra field |
| 400 | Not taxed. Nothing else in ICMS; codigoBeneficioFiscal and creditosPresumidos as the state requires. No extra field |
| 500 | ICMS already withheld upstream by ST. retencaoAnterior optional. At issuance requires CEST |
| 900 | Other. substituicaoTributaria optional. ST and percentualCreditoSimples optional |
icms[].difal.aliquotaInterestadualDIFAL interstate rate
Only these three values; any other is rejected.
| Values | Meaning |
|---|---|
| 4 | Imported product (origin 1, 2, 3 or 8) |
| 7 | From the South / Southeast, except ES, to the North, Northeast, Center-West or ES |
| 12 | Other interstate operations |
icms[].monofasico.motivoReducaoAdRemAd rem reduction reason
Only with percentualReducaoAdRem; the two go together.
| Values | Meaning |
|---|---|
| 1 | Public passenger transport |
| 9 | Other |
icms[].partilha.ufSubstituicaoTributariaST state in the sharing
2-letter uppercase code.
| Values | Meaning |
|---|---|
| AC | Acre |
| AL | Alagoas |
| AP | Amapá |
| AM | Amazonas |
| BA | Bahia |
| CE | Ceará |
| DF | Distrito Federal |
| ES | Espírito Santo |
| GO | Goiás |
| MA | Maranhão |
| MT | Mato Grosso |
| MS | Mato Grosso do Sul |
| MG | Minas Gerais |
| PA | Pará |
| PB | Paraíba |
| PR | Paraná |
| PE | Pernambuco |
| PI | Piauí |
| RJ | Rio de Janeiro |
| RN | Rio Grande do Norte |
| RS | Rio Grande do Sul |
| RO | Rondônia |
| RR | Roraima |
| SC | Santa Catarina |
| SP | São Paulo |
| SE | Sergipe |
| TO | Tocantins |
ipi[].situacaoTributariaIPI CST
IPI row without a code: 10004043. Inbound codes 00–49 only apply on a return invoice.
| Values | Meaning |
|---|---|
| 00 | Inbound with credit recovery |
| 01 | Inbound at zero rate |
| 02 | Inbound exempt |
| 03 | Inbound not taxed |
| 04 | Inbound immune |
| 05 | Inbound suspended |
| 49 | Other inbound |
| 50 | Outbound taxed |
| 51 | Outbound at zero rate |
| 52 | Outbound exempt |
| 53 | Outbound not taxed |
| 54 | Outbound immune |
| 55 | Outbound suspended |
| 99 | Other outbound |
ipi[].codigoEnquadramentoIPI legal framework code
3 digits; omitted means 999. Exemption, immunity and suspension CSTs need a code from the matching range; outside the official table, rejected. The official table is table 8-6 of the NF-e Taxpayer Guidance Manual.
| Values | Meaning |
|---|---|
| 001–007 | Immunity; required on CST 04 / 54 |
| 101–165 | Suspension; required on CST 05 / 55 |
| 301–351 | Exemption; required on CST 02 / 52 |
| 601–608 | Reduction |
| 999 | Normal taxation and other cases; default |
pis[].situacaoTributariaPIS CST
Inbound codes 50–98 only apply on a return invoice and require aliquota (0 when there is no tax).
| Values | Meaning |
|---|---|
| 01 | Taxable at the basic rate. With a PIS/COFINS regime set, a sent aliquota must be the statutory one, otherwise 10005008 on save; omitted, at issuance CRT 3 uses the statutory rate and, with no regime, rejects 10005007 |
| 02 | Taxable at a differentiated rate. Send aliquota; the platform does not fill it from the regime |
| 03 | Taxable by quantity. On save requires valorUnitarioTributo |
| 04 | Single-phase, resale at zero rate |
| 05 | Tax substitution |
| 06 | Zero rate |
| 07 | Exempt |
| 08 | Not levied (export) |
| 09 | Suspended |
| 49 | Other outbound operations. aliquota omitted means 0 |
| 50–56 | Inbound with credit right, by revenue type (returns only) |
| 60–66 | Inbound with presumed credit, by revenue type (returns only) |
| 67 | Presumed credit, other operations (returns only) |
| 70 | Inbound without credit right (returns only) |
| 71 | Inbound exempt (returns only) |
| 72 | Inbound suspended (returns only) |
| 73 | Inbound at zero rate (returns only) |
| 74 | Inbound not levied (returns only) |
| 75 | Inbound under tax substitution (returns only) |
| 98 | Other inbound operations (returns only) |
| 99 | Other operations. aliquota omitted means 0 |
cofins[].situacaoTributariaCOFINS CST
Same table and same direction rule as PIS.
| Values | Meaning |
|---|---|
| 01 | Taxable at the basic rate. With a PIS/COFINS regime set, a sent aliquota must be the statutory one, otherwise 10005008 on save; omitted, at issuance CRT 3 uses the statutory rate and, with no regime, rejects 10005007 |
| 02 | Taxable at a differentiated rate. Send aliquota; the platform does not fill it from the regime |
| 03 | Taxable by quantity. On save requires valorUnitarioTributo |
| 04 | Single-phase, resale at zero rate |
| 05 | Tax substitution |
| 06 | Zero rate |
| 07 | Exempt |
| 08 | Not levied (export) |
| 09 | Suspended |
| 49 | Other outbound operations. aliquota omitted means 0 |
| 50–56 | Inbound with credit right, by revenue type (returns only) |
| 60–66 | Inbound with presumed credit, by revenue type (returns only) |
| 67 | Presumed credit, other operations (returns only) |
| 70 | Inbound without credit right (returns only) |
| 71 | Inbound exempt (returns only) |
| 72 | Inbound suspended (returns only) |
| 73 | Inbound at zero rate (returns only) |
| 74 | Inbound not levied (returns only) |
| 75 | Inbound under tax substitution (returns only) |
| 98 | Other inbound operations (returns only) |
| 99 | Other operations. aliquota omitted means 0 |
pis[].substituicaoTributaria.somarAoTotalAdd PIS ST to the total
The same applies to cofins[].substituicaoTributaria.somarAoTotal.
| Values | Meaning |
|---|---|
| true | Added to the invoice total |
| false | Not added |
| — | Not added |
ibsCbs[].situacaoTributariaIBS/CBS CST
Omitted means 000. tributacaoRegular.situacaoTributaria uses the same table. Codes marked as not supported exist in the official table and return an error.
| Values | Meaning |
|---|---|
| 000 | Full taxation. Nothing beyond CST and classification |
| 200 | Reduced rate. The reduction comes from the classification; 200022 / 200024 require tributacaoRegular |
| 410 | Immunity or non-incidence. Only CST and classification |
| 510 | Deferral. Requires percentualDiferimento |
| 515 | Deferral with reduced rate. Requires percentualDiferimento |
| 550 | Suspension. Requires tributacaoRegular |
| 620 | Single-phase taxation (fuels). Requires monofasico and the combustivel block |
| 800 | Credit transfer. Requires transferenciaCredito |
| 810 | Manaus Free Zone presumed credit. Requires zonaFrancaManaus |
| 811 | Adjustment of earlier periods. Requires ajuste |
| 010 | Uniform rates (financial services). Not supported |
| 011 | Reduced uniform rates. Not supported |
| 220 | Fixed rate. Not supported |
| 221 | Proportional fixed rate. Not supported |
| 222 | Base reduction. Not supported |
| 400 | Exemption. No classification valid for NF-e; not supported |
| 820 | Taxation in a specific document. Not supported |
| 830 | Exclusion from the tax base. Not supported |
ibsCbs[].classificacaoTributariaIBS/CBS tax classification
Omitted means 000001. The first 3 digits are the CST and must match situacaoTributaria; only the codes valid for NF-e under the CSTs the platform issues are listed (official table of 2026-08-23).
| Values | Meaning |
|---|---|
| 000001 | Situations fully taxed by IBS and CBS |
| 000003 | Automotive regime, incentivised projects (art. 311); allows creditoPresumido |
| 000004 | Automotive regime, incentivised projects (art. 312); allows creditoPresumido |
| 000005 | Anhydrous ethanol meant for blending with gasoline A but sold for another use |
| 200002 | Supply or import for non-taxpayer rural producer or TAC; 100 % reduction |
| 200003 | Sale of products for human consumption (Annex I); 100 % reduction |
| 200004 | Supply of medical devices (Annex XII); 100 % reduction |
| 200005 | Medical devices for public bodies and immune health entities (Annex XII); 100 % reduction |
| 200006 | Public health emergency recognised by the government; 100 % reduction |
| 200007 | Accessibility devices for people with disabilities (Annex XIII); 100 % reduction |
| 200008 | Accessibility devices bought by public bodies; 100 % reduction |
| 200009 | Supply of medicines registered at Anvisa; 100 % reduction |
| 200010 | Anvisa-registered medicines bought by public bodies; 100 % reduction |
| 200011 | Enteral and parenteral nutrition bought by public bodies; 100 % reduction |
| 200012 | Public health emergency recognised by the government; 100 % reduction |
| 200013 | Supply of tampons and sanitary pads; 100 % reduction |
| 200014 | Vegetables, fruit and eggs (Annex XV); 100 % reduction |
| 200015 | Domestic passenger cars bought by professional drivers or people with disabilities; 100 % reduction |
| 200020 | Operation by cooperatives under the specific IBS/CBS regime; 100 % reduction |
| 200022 | Industrialised goods sent from outside the Manaus Free Zone to a taxpayer inside it; 100 % reduction, requires tributacaoRegular |
| 200023 | Intermediate goods between incentivised industries; 100 % reduction |
| 200024 | Goods sent from outside the Free Trade Areas to a taxpayer inside them; 100 % reduction, requires tributacaoRegular |
| 200030 | Sale of medical devices (Annex IV); 60 % reduction |
| 200031 | Accessibility devices for people with disabilities (Annex V); 60 % reduction |
| 200032 | Anvisa-registered or compounded medicines, except those in Annex XIV; 60 % reduction |
| 200033 | Enteral and parenteral nutrition (Annex VI); 60 % reduction |
| 200034 | Food for human consumption (Annex VII); 60 % reduction |
| 200035 | Personal hygiene and cleaning products (Annex VIII); 60 % reduction |
| 200036 | Unprocessed agricultural, aquaculture, fishing, forestry and plant-extraction products; 60 % reduction |
| 200038 | Agricultural and aquaculture inputs (Annex IX); 60 % reduction |
| 200039 | National artistic, cultural, event, journalistic and audiovisual productions; 60 % reduction |
| 200043 | Sovereignty and security goods and services for the public administration (Annex XI); 60 % reduction |
| 200047 | Bars and restaurants; 40 % reduction |
| 200053 | Anvisa-registered medicines classified as sera or vaccines; 100 % reduction |
| 200054 | Goods supplied by an agricultural cooperative to a member outside the regular regime; 100 % reduction |
| 410001 | Bonuses stated on the invoice that do not depend on a later event |
| 410002 | Transfers between establishments of the same taxpayer |
| 410003 | Donations without consideration benefiting the donor |
| 410004 | Export of goods and services |
| 410005 | Supplies by the Union, states, Federal District and municipalities |
| 410006 | Supplies by religious entities and temples |
| 410007 | Supplies by political parties, unions and non-profit education or welfare institutions |
| 410008 | Books, newspapers, periodicals and the paper to print them |
| 410009 | Music recordings and music videos produced in Brazil |
| 410012 | Supply by a condominium outside the regular regime |
| 410013 | Fuel exports |
| 410014 | Supply by a non-taxpayer rural producer; allows creditoPresumido |
| 410016 | Supply or purchase of solid waste; allows creditoPresumido |
| 410017 | Purchase of movable goods with presumed credit conditional on resale |
| 410019 | Tips excluded from the tax base of food supply |
| 410020 | Intermediation fee excluded from the tax base of food supply |
| 410026 | Donation with credit reversal |
| 410027 | Export of services or intangible goods |
| 410029 | Operations covered only by ICMS |
| 410030 | Credit reversal for perishing, deterioration, theft or loss |
| 410031 | Supply before IBS and CBS came into force |
| 410035 | Supply by a nano-entrepreneur |
| 410999 | Other non-onerous operations without taxation, not listed above |
| 510001 | Deferred operations with electricity: import, generation, sale, distribution and transmission |
| 515001 | Deferred operations with agricultural and aquaculture inputs (Annex IX); 60 % reduction |
| 550001 | Export of tangible goods; requires tributacaoRegular |
| 550002 | Transit regime; requires tributacaoRegular |
| 550003 | Warehouse regimes (art. 85); requires tributacaoRegular |
| 550004 | Warehouse regimes (art. 87); requires tributacaoRegular |
| 550005 | Warehouse regimes (art. 87, sole paragraph); requires tributacaoRegular |
| 550006 | Temporary admission regimes; requires tributacaoRegular |
| 550007 | Processing regimes; requires tributacaoRegular |
| 550008 | Import of goods under Repetro-Temporário; requires tributacaoRegular |
| 550009 | GNL-Temporário; requires tributacaoRegular |
| 550010 | Repetro-Permanente; requires tributacaoRegular |
| 550011 | Repetro-Industrialização; requires tributacaoRegular |
| 550012 | Repetro-Nacional; requires tributacaoRegular |
| 550013 | Repetro-Entreposto; requires tributacaoRegular |
| 550014 | Export Processing Zone; requires tributacaoRegular |
| 550015 | Tax regime for port modernisation and expansion (Reporto); requires tributacaoRegular |
| 550016 | Special regime of incentives for infrastructure development (Reidi); requires tributacaoRegular |
| 550017 | Tax regime for the naval industry (Renaval); requires tributacaoRegular |
| 550018 | Relief on the purchase of capital goods; requires tributacaoRegular |
| 550019 | Import of goods by an incentivised industry for use in the Manaus Free Zone; requires tributacaoRegular |
| 550020 | Free trade areas; requires tributacaoRegular |
| 550021 | Manufacturing destined for export; requires tributacaoRegular |
| 550022 | Special regime for low-carbon hydrogen production (Rehidro); requires tributacaoRegular |
| 550023 | Non-fuel liquid hydrocarbons from oil or natural gas, including naphtha; requires tributacaoRegular |
| 620001 | Single-phase taxation on fuels |
| 620002 | Single-phase taxation with withholding responsibility on fuels |
| 620003 | Single-phase taxation with withholding by third parties |
| 620004 | Single-phase taxation on ethanol-gasoline blend above the mandatory share |
| 620005 | Single-phase taxation on ethanol-gasoline blend below the mandatory share |
| 620006 | Single-phase taxation on fuels already charged upstream |
| 620007 | Perishing, deterioration, theft or loss under the single-phase regime |
| 800001 | Merger, spin-off or incorporation |
| 800002 | Credit transfer from a member, including single cooperatives |
| 810001 | Presumed credit on supplies from the Manaus Free Zone |
| 811001 | Credit reversal for immune or exempt outputs |
| 811002 | Debits of invoices not processed in the assessment |
| 811003 | Exit from Simples Nacional |
ibsCbs[].zonaFrancaManaus.tipoZFM presumed credit type
| Values | Meaning |
|---|---|
| 0 | No presumed credit |
| 1 | Final consumer goods |
| 2 | Capital goods |
| 3 | Intermediate goods |
| 4 | IT goods and others defined by law |
issqn[].cfopISSQN CFOP
Only on an NFCe class. Any other value gives 10005214.
| Values | Meaning |
|---|---|
| 5933 | Service taxed by ISSQN; also on the Padrao row |
issqn[].exigibilidadeISS enforceability
Omitted means 1.
| Values | Meaning |
|---|---|
| 1 | Enforceable |
| 2 | Non-incidence |
| 3 | Exemption |
| 4 | Export |
| 5 | Immunity |
| 6 | Suspended by court decision; send processo |
| 7 | Suspended by administrative proceeding; send processo |
issqn[].incentivoFiscalISS tax incentive
| Values | Meaning |
|---|---|
| true | With tax incentive |
| false | Without tax incentive |
| — | Means false |
| Code | HTTP | |
|---|---|---|
| 10003000 | 404 | Company not found: empresaId does not exist or does not belong to this integrator. |
| 10005200 | 404 | Tax class not found: the code does not exist on this company or was deleted. |
