Documentation Index
Fetch the complete documentation index at: https://mintlify.com/mdiago/VeriFactu/llms.txt
Use this file to discover all available pages before exploring further.
TaxItem represents a single line in the invoice’s tax breakdown (Desglose). Each invoice can carry up to 12 TaxItem instances covering different tax rates, tax schemes (IVA / IGIC / IPSI), operation types, and exemption causes. The collection is assigned to Invoice.TaxItems.
Namespace
VeriFactu.Business
Propiedades
Indicates whether this line represents output tax (IVA, IGIC, IPSI — repercutido) or withheld tax (retención).
The
| Value | Description |
|---|---|
TaxClass.TaxOutput | Output / collected tax (default) |
TaxClass.TaxWithheld | Withheld / retained tax |
Invoice class uses this value to route amounts into TotalTaxOutput vs. TotalTaxWithheld when calculating totals.The applicable tax type. Defaults to IVA if not set.
| Value | Code | Description |
|---|---|---|
Impuesto.IVA | 01 | Impuesto sobre el Valor Añadido |
Impuesto.IPSI | 02 | IPSI (Ceuta y Melilla) |
Impuesto.IGIC | 03 | IGIC (Canarias) |
Impuesto.Otro | 05 | Other |
Tax regime key (lists L8A / L8B). Determines the special regime or the standard general regime. Defaults to
ClaveRegimen.RegimenGeneral.Common values: RegimenGeneral, RegimenEspecialRecargo, RegimenEspecialBienesUsados, CriterioCaja, etc.Operation qualification (list L9). Classifies the taxable nature of the line.
Defaults to
| Value | Meaning |
|---|---|
S1 | Subject and not exempt — no reverse charge |
S2 | Subject and not exempt — reverse charge |
N1 | Not subject — Article 7, 14, others |
N2 | Not subject — due to rules of localisation |
S1.Exemption cause (list L10). Set this when the line is exempt from tax. Defaults to
CausaExencion.NA (not exempt).Common values: E1 through E6. When set to anything other than NA, TaxRate, TaxAmount, TaxRateSurcharge, and TaxAmountSurcharge must all be zero — the library enforces this as a validation error.Taxable base amount (
BaseImponibleOimporteNoSujeto). For exempt or non-subject lines, this holds the exempt/non-subject amount.Tax rate as a percentage (e.g.
21 for 21 % IVA). Must be 0 when TaxException is set. Rounded to 2 decimal places when building the XML.Tax amount (
CuotaRepercutida). Must be 0 when TaxException is set. Rounded to 2 decimal places when building the XML.Equivalence surcharge rate (
TipoRecargoEquivalencia) as a percentage. Only applicable under RegimenEspecialRecargo. Must be 0 when TaxException is set.Equivalence surcharge amount (
CuotaRecargoEquivalencia). Only populated in the XML when non-zero. Must be 0 when TaxException is set.Reglas de negocio
Non-subject operations (N1 / N2) with IVA: When
TaxType is N1 or N2 and Tax is IVA, the XML serialization automatically nullifies TipoImpositivo and CuotaRepercutida (AEAT error 1237 prevention). Ensure TaxRate and TaxAmount are 0 for these lines.