es-verifactu-v1
Sources
Correction Definitions
Auto-generation of corrective invoices or credit and debit notes is supported.Extension Keys
One or all of the following extensions may be required as part of the correction options. See the Extensions section for possible values.-
es-verifactu-doc-type
Extensions
Invoice Type Code
Code used to identify the type of invoice being sent. This will be determined automatically by GOBL during normalization according to the scenario definitions. The codesR2
, R3
, and R4
are not covered by GOBL’s scenarios
and will need to be set manually if needed.
Values correspond to L2 list.
es-verifactu-doc-type
es-verifactu-doc-type
Code | Name |
---|---|
F1 | Invoice (Article 6, 7.2 and 7.3 of RD 1619/2012) |
F2 | Simplified invoice (Article 6.1.d) of RD 1619/2012) |
F3 | Invoice issued as a replacement for simplified invoices that have been billed and declared. |
R1 | Rectified invoice: error based on law and Article 80 One, Two and Six LIVA |
R2 | Rectified invoice: error based on law and Article 80.3 |
R3 | Rectified invoice: error based on law and Article 80.4 |
R4 | Rectified invoice: Other |
R5 | Rectified invoice: simplified invoices |
Verifactu Correction Type Code
Correction type code used to identify the type of correction being made. Values map to L3 list. Code is determined automatically according to the invoice type:Invoice Type | Code |
---|---|
corrective | S |
credit-note | I |
debit-note | I |
es-verifactu-correction-type
es-verifactu-correction-type
Code | Name |
---|---|
S | Substitution |
I | Differences |
Verifactu Operation Classification/Exemption Code
Operation classification code used to identify if taxes should be applied to the line. VERI*FACTU makes a clear distinction between “subjected” and “exempt”, while GOBL only recognises “exempt”, implying that there is simply no percentage. Mapping between the two can thus become confusing. GOBL will try to automatically map tax rates to operation classes, but if your system requires needs to offer tighter control to users, it may be easier to ask them to choose which combination of operation class and exemption code applies to their use-case. The following tax rates will be mapped automatically to operation classes:Tax Rate | Operation Class |
---|---|
standard | S1 |
reduced | S1 |
super-reduced | S1 |
zero | S1 |
exempt | N1 |
exempt+reverse-charge | S2 |
exempt+export | N2 |
CalificacionOperacion
, and cannot be
provided alongside the es-verifactu-exempt
extension. Values correspond
to the L9 list.
For details on how best to use and apply these and other codes, see the
AEAT FAQ:
es-verifactu-op-class
es-verifactu-op-class
Code | Name |
---|---|
S1 | Subject and Not Exempt - Without reverse charge |
S2 | Subject and Not Exempt - With reverse charge |
N1 | Not Subject - Articles 7, 14, others |
N2 | Not Subject - Due to location rules |
Verifactu Exemption Code
Exemption code used to explain why the operation is exempt from taxes. This extension maps to the fieldOperacionExenta
, and cannot be provided
alongside the es-verifactu-op-class
extension. Values correspond to the
L10 list.
No attempt will be made by GOBL to automatically map tax rates to exemption
reason codes, they will need to be determined and applied on a case-by-case
basis.
es-verifactu-exempt
es-verifactu-exempt
Code | Name |
---|---|
E1 | Exempt: pursuant to Article 20. Exemptions in internal operations. |
E2 | Exempt: pursuant to Article 21. Exemptions in exports of goods. |
E3 | Exempt: pursuant to Article 22. Exemptions in operations asimilated to exports. |
E4 | Exempt: pursuant to Articles 23 and 24. Exemptions related to temporary deposit, customs and fiscal regimes, and other situations. |
E5 | Exempt: pursuant to Article 25. Exemptions in the delivery of goods destined to another Member State. |
E6 | Exempt: pursuant to other reasons |
VAT/IGIC Regime Code
Identify the type of VAT or IGIC regime applied to the operation. This list combines lists L8A which include values for VAT, and L8B for IGIC. Maps to the fieldClaveRegimen
, and is required for all VAT and IGIC operations.
Values correspond to L8A (VAT) and L8B (IGIC) lists.
The regime code must be assigned for each tax combo. If no regime code is provided,
GOBL will try to assign a code from the following tax combo contexts:
Combo Context | Regime Code |
---|---|
Rate standard | 01 |
Rate has export | 02 |
Has surcharge | 18 |
es-verifactu-regime
es-verifactu-regime
Code | Name |
---|---|
01 | General regime operation |
02 | Export |
03 | Special regime for used goods, art objects, antiques and collectibles |
04 | Special regime for investment gold |
05 | Special regime for travel agencies |
06 | Special regime for VAT/IGIC groups (Advanced Level) |
07 | Special cash accounting regime |
08 | Operations subject to a different regime |
09 | Billing of travel agency services acting as mediators in name and on behalf of others |
10 | Collection of professional fees or rights on behalf of third parties |
11 | Business premises rental operations |
14 | Invoice with pending VAT/IGIC accrual in work certifications for Public Administration |
15 | Invoice with pending VAT/IGIC accrual in successive tract operations |
17 | Operation under OSS and IOSS regimes (VAT) / Special regime for retail traders. (IGIC) |
18 | Equivalence surcharge (VAT) / Special regime for small traders or retailers (IGIC) |
19 | Operations included in the Special Regime for Agriculture, Livestock and Fisheries |
20 | Simplified regime (VAT only) |
Identity Type Code
Identity code used to identify the type of identity document used by the customer. Codes01
and 02
are not defined as they are explicitly inferred from the
tax Identity and the associated country. 01
implies a Spanish NIF, and 02
is applied
when the Tax ID is foreign VAT (or other tax) number.
Corresponds to the IDType
field and L7 list.
The following identity keys will be mapped automatically to an extension by the
addon for the following keys:
passport
:03
foreign
:04
resident
:05
other
:06
07
“not registered in census” code is not mapped automatically, but
can be provided directly if needed.
Here is an example of an identity:
es-verifactu-identity-type
es-verifactu-identity-type
Code | Name |
---|---|
03 | Passport |
04 | Foreign Identity Document |
05 | Residential Certificate |
06 | Other Identity Document |
07 | Not registered in census |
Simplified Invoice Art. 7.2 and 7.3, RD 1619/2012
This extensions covers a specific use-case when the customer specifically requests that the invoice includes their fiscal details, but they are not registered for tax. Maps to theFacturaSimplificadaArt7273
field in Verifactu documents.
Can only be true when the invoice type (TipoFactura
) is one of: F1
,
F3
, R1
, R2
, R3
, or R4
.
es-verifactu-simplified-art7273
es-verifactu-simplified-art7273
Code | Name |
---|---|
S | Yes |
N | No |
Issuer Type Code
Indicates whether the invoice is issued by a third party or by the customer themselves. Mapped to the fieldEmitidaPorTerceroODestinatario
in Verifactu documents,
with list L6.
The self-billed
tag will automatically be set this extension in the invoice
to D
.
If the issuer
field is set in the invoice’s ordering section, then this
extension will be set to T
.
es-verifactu-issuer-type
es-verifactu-issuer-type
Code | Name |
---|---|
T | Issued by Third Party |
D | Issued by Customer |