Spain SII - Invoices Issued

Invoice

Changes to generic fields

recipient.contact.taxIdType is required.
customInfo.esp.description is required.
customInfo.esp.vatSchemeTypeCode is required.

type Invoice {
  // ...all generic invoice fields
  lines: [
    { 
      // ..other line item fields
      vat: {
        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;
      taxPayerCode?: string;
      registrationId?: string;
      warehouseAddress?: string;
      arrivalDate?: string;
      transactionType?: string;
    }
   };

Field information

Name	Type	Required	Description
`lines[].customInfo.itemType`	string	Yes	A value from an enumerated list of types: Product Service
`lines[].vat.exemptReasonCode`	string	Conditional	Mandatory if the `lines[].vat.code` is E for Exempt or NS for Not subject. For each there are different options from an enumerated list of types. If lines[].vat.code is "E": 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 If 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 is not subject to VAT under specific non-taxable legal categories (Articles 7 and 14 Note: When using this field, leave out `customInfo.esp.transactionType`
`recipient.address.country`	string	Yes	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	Yes	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
`customInfo.esp.taskType`	string	Optional	A value from an enumerated list of communication types: A0: Invoice/record entry A1: Modification of invoices/records (registry errors) A4: Modification of Travelers Invoice A5: Registration of VAT refunds for travelers A6: Modification of VAT refunds for travelers
`customInfo.esp.transactionType`	string	Conditional	Classification for transactions subject and not exempt from Spanish VAT. A value from an enumerated list of types: S1: Standard not exempt- Without reverse charge S2: Reverse Charge S3: 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