Spain SII - Invoices Issued

Invoice

Changes to generic fields

ref has a 60-character limit.
recipient.taxId is required. For intra-community transactions (EU) remove the country prefix.
recipient.customInfo.taxIdType is required.
customInfo.esp.description is required.
customInfo.esp.vatSchemeTypeCode is required.
customInfo.esp.invoiceType is required.
lines[].customInfo.itemType is required

type Invoice {
  // ...all generic invoice fields
  lines: [
    { 
      // ..other line item fields
      vat: {
      // ...other line item vat fields
        code: string;
        exemptReasonCode?: string;
      }
      customInfo: {
        itemType: string;
      }
    }
  ];
  recipient: {
    // ...everything from invoice.recipient,
    // invoice.recipient.taxId can not have a ES country prefix for domestic transactions but it can for intra-EU or export transactions
    contact: {
      email?: string;
    }
    customInfo:{
      taxIdType: string
    }
   };
customInfo: {
    esp: {
      fiscalYear?: string;
      settlementPeriod?: string;
      description: string;
      invoiceType: string;
      taskType?: string;
      vatSchemeTypeCode: string;
      transactionType?: string;
    }
   };
};

Field information

Name	Type	Required	Description
`lines[].customInfo.itemType`	string	Required	A value from an enumerated list of types: Product Service
`lines[].vat.code`	string	Required	Standard VAT codes. A value from an enumerated list as outlined on VAT code classification
`lines[].vat.exemptReason`	string	Conditional	If the line VAT amount is 0, a value is required.
`lines[].vat.exemptReasonCode`	string	Conditional	Required if the VAT Amount is 0, for transactions subject and exempt from Spanish VAT: E1: Exempt on account of Article 20 E2: Exempt on account of Article 21 E3: Exempt on account of Article 22 E4: Exempt under Articles 23 and 24 E5: Exempt on account of Article 25 E6: Exempt on other grounds Transactions not subject to Spanish VAT (lines[].vat.code is NS): ESP-IMRL: Sales not subject to VAT due to location rules (outside TAI or in special territories such as the Canary Islands) ESP-IM714: Sales not subject to VAT under specific non-taxable legal categories (Articles 7 and 14)
`recipient.address.country`	string	Required	Three-letter country code (ISO 3166).
`recipient.contact.email`	string	Conditional	Email address of recipient. Required for invoices submitted to non-registered entities
`recipient.customInfo.taxIdType`	string	Required	Identification types in the country of residence. A value from an enumerated list of types: 02: NIF-VAT 03: PASSPORT 04: OFFICIAL IDENTIFICATION DOCUMENT ISSUED BY THE COUNTRY OR REGION OF RESIDENCE 05: RESIDENCE CERTIFICATE 06: OTHER SUPPORTING DOCUMENT 07: NOT REGISTERED
`customInfo.esp.fiscalYear`	string	Optional	Fiscal year (YYYY format)
`customInfo.esp.settlementPeriod`	string	Optional	Settlement period (MM format, 01-12)
`customInfo.esp.description`	string	Required	Operation description of the invoice
`customInfo.esp.invoiceType`	string	Optional	F1: Regular Invoice F2: Simplified Invoice (Gross amount less than 400 Euro)
`customInfo.esp.taskType`	string	Optional	A value from an enumerated list of communication types: A0: Invoice/record entry A1: (Correction of records): Used for corrections, modifications, or updates to previously submitted invoice data. A4: Amendment of Invoice for Travellers. A5: Registration of VAT refunds for travelers. A6: Changes in VAT refunds for travellers. Note: If not stated it defaults too A0.
`customInfo.esp.transactionType`	string	Conditional	Required for transactions subject and not exempt from Spanish VAT. A value from an enumerated list of types: S1: Subject and not exempt- Without reverse charge S2: Subject and not exempt - With reverse charge S3: Subject and not exempt - Without reverse charge and with reverse charge. Note: Do not use when `lines[].vat.code` is E or NS
`customInfo.esp.vatSchemeTypeCode`	string	Required	A value from an enumerated list of codes as outlined on Spain SII VAT regime codes

Example CSV file

Invoice Issued - SII.csv