Tax classes
Update tax class
Replaces the whole class; the version goes up on every change.
/openapi/v2/empresas/{empresaId}/classes-imposto/{codigo}token, timestamp and sign signature headers, see Authentication.Send the whole class, with the same tipo: any group or row not sent stops existing. Any change, including only descricao, adds 1 to the version; content identical to the current one writes nothing. An IncompativelComRegime class that passes validation under the current regime goes back to Compativel. Invoices already accepted do not change; they stored the expanded taxes and the version used.
Path parameters
empresaId* | string | Company identifier |
codigo* | string | Class code |
* Required field
Request body
tipo*required; equal to the current one | string | Class type |
descricao | string | Class name |
*icms and issqn add up to at least 1 row | array | ICMS rows |
| array | IPI rows |
*at least 1 row | array | PIS rows |
*at least 1 row | array | COFINS rows |
*icms and issqn add up to at least 1 row | array | ISSQN rows |
| array | IBS and CBS rows |
| array | ICMS per destination state |
* 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 |
Each row is validated with the rules of the matching issuance group, plus the class rules:
| Validation | Error |
|---|---|
codigo in the body: the code is generated by the platform | 10005208 |
Unknown field at any level; the message names the path, such as icms[0].aliquotaX | 10005210 |
Number or boolean sent as text, such as "aliquota": "18" | 10005213 |
Required fields, format, range, Padrao on ICMS, pis / cofins with at least 1 row, icms and issqn adding up to at least 1 row, at most 50 rows per group | 10001001 |
Same combination of cenario, tipoPessoa and naoContribuinte repeated in the group | 10005211 |
First digit of cfop not matching the scenario; the ISSQN Padrao row is not checked | 10005212 |
ISSQN row with cfop other than 5933, including Padrao; ICMS row with 5933 | 10005214 |
tipo different from the current one on update | 10005216 |
Group the type does not allow: issqn on NFe, ipi on NFCe | 10005218 |
NFCe class with a scenario outside SaidaDentroEstado / Padrao | 10005219 |
NFCe class with a field NFC-e issuance does not have, such as icms[0].difal | 10005217 |
ICMS row with naoContribuinte = true or tipoPessoa = Fisica using CST / CSOSN 10, 30, 70, 101, 201, 202, 203 or percentualCreditoSimples | 10004047 |
PIS / COFINS 01 with an aliquota other than the statutory rate of the PIS/COFINS regime set on the company | 10005008 |
| CST or CSOSN according to the company CRT: CRT 1 / 4 CSOSN only, CRT 2 / 3 CST only | 10004046 |
| Existing tax code (ICMS, PIS, COFINS, IPI, IBS/CBS) | 10005203 |
| IBS/CBS classification belonging to the CST | 10005204 |
Fields the code requires; percentualCreditoSimples on CSOSN 101 / 201 may come from the company record | 10004043 |
| Fields that do not apply to the code | 10004044 |
Left for issuance: CEST on codes with ST and every calculation of the tax engine. Numbers are stored and returned as sent: 18.00 comes back 18.00.
Fields without a closed list of values but with a checked format. Percentages go from 0 to 100; amounts and quantities cannot be negative.
| Field | Format |
|---|---|
icms[].cfop, issqn[].cfop | 4 digits; first digit in the enum table below |
icms[].codigoBeneficioFiscal | State tax benefit code, up to 10 characters; at issuance it is required on CST 20, 30, 40, 41, 50, 51, 70 and 90 and SEFAZ checks the value |
ibsCbs[].classificacaoTributaria, ibsCbs[].tributacaoRegular.classificacaoTributaria | 6 digits; the first 3 are the CST of the same group, otherwise 10005204 |
ibsCbs[].tributacaoRegular.situacaoTributaria | 3 digits, from the IBS/CBS CST table |
ibsCbs[].creditoPresumido.codigo | 2 digits from the official presumed credit table; only when the classification allows it |
ibsCbs[].zonaFrancaManaus.periodoApuracao, ibsCbs[].ajuste.periodoApuracao | YYYY-MM |
issqn[].itemListaServico | NN.NN, item of the LC 116 service list |
issqn[].municipioFatoGerador, issqn[].municipioIncidencia | 7-digit IBGE code |
issqn[].codigoServicoMunicipio | Up to 20 characters |
issqn[].processo | Up to 30 characters; required with enforceability 6 or 7 |
The ICMS and ST base calculation modality and the relief reason are fields of neither the class nor the issuance.
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 | |
|---|---|---|
| 10001001 | 400 | Field validation failed: required field blank, invalid format, range or length, value outside the enum (such as Padrao on ICMS), group without the minimum row or with more than 50 rows; one entry per field. |
| 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. |
| 10005208 | 400 | codigo in the body: the code is generated by the platform and is not sent on creation or whole replacement. |
| 10005216 | 400 | tipo differs from the current one: the type cannot be changed. |
| 10005206 | 409 | The class was changed by another call at the same time. Read it again and resend. |
| 10005210 | 400 | Unknown field in the body; the message names the path, such as icms[0].aliquotaX. |
| 10005213 | 400 | Wrong value type: number or boolean sent as text. Numbers go as JSON numbers and booleans as true / false; the message names the path. |
| 10005211 | 400 | Two rows of the same group with the same combination of cenario, tipoPessoa and naoContribuinte; the message names the group and the rows. |
| 10005212 | 400 | The first digit of the row cfop does not match the scenario; the message gives the expected digit. |
| 10005214 | 400 | CFOP outside its group: an ISSQN row only uses 5933, an ICMS row cannot use 5933. |
| 10005218 | 400 | Group the type does not allow: issqn on an NFe class or ipi on an NFCe class. |
| 10005219 | 400 | NFCe class with a row outside SaidaDentroEstado / Padrao. |
| 10005217 | 400 | NFCe class with a field NFC-e issuance does not have, such as icms[0].difal; the message names the path. |
| 10004046 | 400 | ICMS code incompatible with the company regime: CRT 1 / 4 use a 3-digit CSOSN, CRT 2 / 3 use a 2-digit CST; the message names the row. |
| 10004047 | 400 | ICMS row with naoContribuinte = true or tipoPessoa = Fisica using a taxpayer-only code (CST / CSOSN 10, 30, 70, 101, 201, 202, 203) or with percentualCreditoSimples. |
| 10005203 | 400 | Unsupported tax code (ICMS, PIS, COFINS, IPI or IBS/CBS); the message names the field and the code. |
| 10005204 | 400 | The tax classification does not belong to the given CST: the first three digits of the classification are the CST. |
| 10004043 | 400 | A row lacks a field required by the tax code: base reduction on CST 20, ST on CST 10, monofasico group on CST 61, unit amount on PIS 03, percentualCreditoSimples on CSOSN 101 / 201 when neither the row nor the company record has it; the message names the field. |
| 10004044 | 400 | Field that does not apply to the row code (ST on a CST without ST, percentualCreditoSimples on a CSOSN without credit); the message names the field. |
| 10005008 | 400 | PIS / COFINS 01 row whose aliquota differs from the statutory rate of the PIS/COFINS regime set on the company (cumulative 0.65 / 3.00, non-cumulative 1.65 / 7.60). |
| 10005230 | 400 | Relief reason outside the values of the CST; the message lists the allowed ones. |
| 10005231 | 400 | Per-invoice amount in the class, such as icms[0].valorDesonerado or creditosPresumidos[].valor; send it on issuance. |
| 10005232 | 400 | icmsPorEstado with a value no icms row uses, such as ST without an ST CST row. |
| 10005233 | 400 | State repeated in icmsPorEstado or beneficiosFiscaisPorEstado. |
| 10005234 | 400 | More than 4 presumed credits for the same state. |
| 10005235 | 400 | Relief amount that cannot be computed, such as CST 90 without base reduction; the message names the field to send. |
