schema.json

{
  "$id": "https://github.com/inbridgeio/open-invoice-format/releases/download/2025.01/schema.json",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "title": "Open Invoice Format",
  "description": "This schema defines the Open Invoice Format as an much easier to use and more reliable alternative to ZugFERD and XRechnung.",
  "definitions": {
    "SCHEMA_VERSION": {
      "description": "The version of the schema.",
      "const": "2025.01"
    },
    "IBAN": {
      "type": "string",
      "description": "The International Bank Account Number (IBAN) is an international standard for identifying bank accounts.",
      "pattern": "^[A-Z]{2}[0-9]{2}[A-Z0-9]{1,30}$"
    },
    "BIC": {
      "type": "string",
      "description": "The Business Identifier Code (BIC) is an international standard for identifying business entities.",
      "pattern": "^[A-Z]{6}[A-Z0-9]{2}([A-Z0-9]{3})?$"
    },
    "DUNS": {
      "type": "string",
      "description": "The D-U-N-S Number is a unique nine-digit identifier for businesses.",
      "pattern": "^[0-9]{9}$"
    },
    "InvoiceId": {
      "type": "string",
      "description": "The unique identifier of the invoice."
    },
    "InvoiceServicePeriod": {
      "description": "The service period of the invoice.",
      "type": "object",
      "properties": {
        "start": {
          "oneOf": [
            { "type": "string", "format": "date" },
            { "type": "string", "format": "date-time" }
          ]
        },
        "end": {
          "oneOf": [
            { "type": "string", "format": "date" },
            { "type": "string", "format": "date-time" }
          ]
        }
      },
      "required": [
        "start",
        "end"
      ],
      "additionalProperties": false
    },
    "DiscountType": {
      "type": "string",
      "enum": [
        "fixed",
        "percentage"
      ]
    },
    "InvoiceItemWithDiscount": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "description": {
          "type": "string"
        },
        "quantity": {
          "type": "number"
        },
        "unit": {
          "$ref": "#/definitions/InvoiceItemUnit"
        },
        "price": {
          "type": "number"
        },
        "currency": {
          "$ref": "#/definitions/Currency"
        },
        "taxRate": {
          "type": "number"
        },
        "discount": {
          "type": "number"
        },
        "discountType": {
          "$ref": "#/definitions/DiscountType"
        },
        "discountReason": {
          "type": "string"
        } 
      },
      "required": [
        "currency",
        "description",
        "discount",
        "discountType",
        "id",
        "price",
        "quantity",
        "taxRate",
        "unit"
      ],
      "additionalProperties": false
    },
    "InvoiceItemWithoutDiscount": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "description": {
          "type": "string"
        },
        "quantity": {
          "type": "number"
        },
        "unit": {
          "$ref": "#/definitions/InvoiceItemUnit"
        },
        "price": {
          "type": "number"
        },
        "currency": {
          "$ref": "#/definitions/Currency"
        },
        "taxRate": {
          "type": "number"
        }
      },
      "required": [
        "currency",
        "description",
        "id",
        "price",
        "quantity",
        "taxRate",
        "unit"
      ],
      "additionalProperties": false
    },
    "Address": {
      "type": "object",
      "properties": {
        "street": {
          "type": "string",
          "description": "The street name or address line, such as \"123 Elm Street\" or \"Main St\"."
        },
        "city": {
          "type": "string",
          "description": "The city or town associated with the address, like \"New York\" or \"Berlin\"."
        },
        "zip": {
          "type": "string",
          "description": "The postal or ZIP code, such as \"10001\" or \"10115\"."
        },
        "country": {
          "$ref": "#/definitions/CountryCode",
          "description": "The country code in ISO 3166-1 alpha-2 format, like \"US\" or \"DE\"."
        }
      },
      "required": [
        "city",
        "country",
        "street",
        "zip"
      ],
      "additionalProperties": false
    },
    "BusinessContact": {
      "type": "object",
      "properties": {
        "firstname": {
          "type": "string"
        },
        "lastname": {
          "type": "string"
        },
        "phoneNumber": {
          "type": "string"
        },
        "email": {
          "type": "string"
        }
      },
      "required": [
        "email"
      ],
      "additionalProperties": false
    },
    "BusinessPostalAddress": {
      "type": "object",
      "properties": {
        "street": {
          "type": "string",
          "description": "The street name or address line, such as \"123 Elm Street\" or \"Main St\"."
        },
        "city": {
          "type": "string",
          "description": "The city or town associated with the address, like \"New York\" or \"Berlin\"."
        },
        "zip": {
          "type": "string",
          "description": "The postal or ZIP code, such as \"10001\" or \"10115\"."
        },
        "country": {
          "$ref": "#/definitions/CountryCode"
        },
        "companyName": {
          "type": "string"
        },
        "duns": {
          "$ref": "#/definitions/DUNS"
        },
        "vatId": {
          "type": "string"
        },
        "taxId": {
          "type": "string"
        },
        "contact": {
          "$ref": "#/definitions/BusinessContact"
        }
      },
      "required": [
        "city",
        "companyName",
        "contact",
        "country",
        "street",
        "vatId",
        "zip"
      ],
      "additionalProperties": false
    },
    "PrivateContact": {
      "type": "object",
      "properties": {
        "firstname": {
          "type": "string"
        },
        "lastname": {
          "type": "string"
        },
        "phoneNumber": {
          "type": "string"
        },
        "email": {
          "type": "string"
        }
      },
      "required": [
        "email",
        "firstname",
        "lastname"
      ],
      "additionalProperties": false
    },
    "PrivatePostalAddress": {
      "type": "object",
      "properties": {
        "street": {
          "type": "string",
          "description": "The street name or address line, such as \"123 Elm Street\" or \"Main St\"."
        },
        "city": {
          "type": "string",
          "description": "The city or town associated with the address, like \"New York\" or \"Berlin\"."
        },
        "zip": {
          "type": "string",
          "description": "The postal or ZIP code, such as \"10001\" or \"10115\"."
        },
        "country": {
          "$ref": "#/definitions/CountryCode",
          "description": "The country code in ISO 3166-1 alpha-2 format, like \"US\" or \"DE\"."
        },
        "companyName": {
          "type": "string"
        },
        "duns": {
          "$ref": "#/definitions/DUNS"
        },
        "vatId": {
          "type": "string"
        },
        "taxId": {
          "type": "string"
        },
        "contact": {
          "$ref": "#/definitions/PrivateContact"
        }
      },
      "required": [
        "city",
        "contact",
        "country",
        "street",
        "zip"
      ],
      "additionalProperties": false
    },
    "InvoiceType": {
      "type": "string",
      "enum": [
        "invoice",
        "partial_invoice",
        "recurring_invoice",
        "cancellation_invoice"
      ],
      "description": "Enum representing the different types of invoices.\n\n- 'invoice': A standard invoice issued after the completion of a transaction or project.              It summarizes all charges and confirms the total amount due.              Example: An invoice sent after delivering a product or service.\n\n- 'partial_invoice': A partial invoice issued for a portion of the total amount due.                      Typically used in cases where payments are split into installments or milestones.                      Example: An invoice for the first phase of a project.\n\n- 'recurring_invoice': A recurring invoice issued at regular intervals for ongoing services or subscriptions.\n\n- 'cancellation_invoice': An invoice issued to cancel a previous invoice."
    },
    "CorrectingInvoiceData": {
      "type": "object",
      "properties": {
        "previousId": {
          "type": "string",
          "description": "The id of the invoice that this invoice is correcting"
        }
      },
      "required": [
        "previousId"
      ],
      "additionalProperties": false
    },
    "InvoiceItem": {
      "oneOf": [
        {
          "$ref": "#/definitions/InvoiceItemWithoutDiscount"
        },
        {
          "$ref": "#/definitions/InvoiceItemWithDiscount"
        }
      ]
    },
    "SEPAMandateType": {
      "type": "string",
      "enum": [
        "one_off",
        "recurring",
        "b2b"
      ],
      "description": "Enum representing the different types of SEPA mandates.\n\n- 'one_off': A one-time mandate for a single payment.               The mandate becomes invalid after the payment is processed.              Example: One-time online purchases.\n\n- 'recurring': A recurring mandate for regular payments.                 The mandate remains valid until explicitly revoked.                Example: Subscriptions, rent payments.\n\n- 'b2b': A business-to-business (B2B) mandate for corporate transactions.           Requires the payer's bank to validate the mandate before processing.           Payments cannot be reversed after processing.          Example: Payments between companies."
    },
    "SignatureInformation": {
      "type": "object",
      "description": "A signature can be provided to confirm.",
      "properties": {
        "date": {
          "type": "string",
          "format": "date-time",
          "description": "Date of the signature."
        },
        "signature": {
          "type": "string",
          "description": "Can be an url to a provided signature document or a base64 encoded signature.",
          "pattern": "^(https?:\\/\\/[^\\s]+|[A-Za-z0-9+/]{2,}={0,2})$"
        }
      },
      "required": [
        "date",
        "signature"
      ],
      "additionalProperties": false
    },
    "SEPAMandatePaymentInformation": {
      "type": "object",
      "properties": {
        "paymentType": {
          "const": "sepa_mandate"
        },
        "type": {
          "$ref": "#/definitions/SEPAMandateType"
        },
        "mandateId": {
          "type": "string",
          "description": "The reference id of the mandate."
        },
        "dueDate": {
          "type": "string",
          "format": "date-time",
          "description": "The date when the money will be withdrawn."
        },
        "signature": {
          "$ref": "#/definitions/SignatureInformation",
          "description": "A signature can be provided to confirm the mandate."
        },
        "debitor": {
          "oneOf": [
            {
              "type": "object",
              "additionalProperties": false,
              "properties": {
                "street": {
                  "type": "string",
                  "description": "The street name or address line, such as \"123 Elm Street\" or \"Main St\"."
                },
                "city": {
                  "type": "string",
                  "description": "The city or town associated with the address, like \"New York\" or \"Berlin\"."
                },
                "zip": {
                  "type": "string",
                  "description": "The postal or ZIP code, such as \"10001\" or \"10115\"."
                },
                "country": {
                  "$ref": "#/definitions/CountryCode"
                },
                "companyName": {
                  "type": "string"
                },
                "duns": {
                  "$ref": "#/definitions/DUNS"
                },
                "vatId": {
                  "type": "string"
                },
                "taxId": {
                  "type": "string"
                },
                "contact": {
                  "$ref": "#/definitions/BusinessContact"
                },
                "iban": {
                  "$ref": "#/definitions/IBAN"
                },
                "bic": {
                  "$ref": "#/definitions/BIC"
                }
              },
              "required": [
                "bic",
                "city",
                "companyName",
                "contact",
                "country",
                "iban",
                "street",
                "vatId",
                "zip"
              ]
            },
            {
              "type": "object",
              "additionalProperties": false,
              "properties": {
                "street": {
                  "type": "string",
                  "description": "The street name or address line, such as \"123 Elm Street\" or \"Main St\"."
                },
                "city": {
                  "type": "string",
                  "description": "The city or town associated with the address, like \"New York\" or \"Berlin\"."
                },
                "zip": {
                  "type": "string",
                  "description": "The postal or ZIP code, such as \"10001\" or \"10115\"."
                },
                "country": {
                  "$ref": "#/definitions/CountryCode",
                  "description": "The country code in ISO 3166-1 alpha-2 format, like \"US\" or \"DE\"."
                },
                "companyName": {
                  "type": "string"
                },
                "duns": {
                  "$ref": "#/definitions/DUNS"
                },
                "vatId": {
                  "type": "string"
                },
                "taxId": {
                  "type": "string"
                },
                "contact": {
                  "$ref": "#/definitions/PrivateContact"
                },
                "iban": {
                  "$ref": "#/definitions/IBAN"
                },
                "bic": {
                  "$ref": "#/definitions/BIC"
                }
              },
              "required": [
                "bic",
                "city",
                "contact",
                "country",
                "iban",
                "street",
                "zip"
              ]
            }
          ]
        },
        "creditor": {
          "oneOf": [
            {
              "type": "object",
              "additionalProperties": false,
              "properties": {
                "street": {
                  "type": "string",
                  "description": "The street name or address line, such as \"123 Elm Street\" or \"Main St\"."
                },
                "city": {
                  "type": "string",
                  "description": "The city or town associated with the address, like \"New York\" or \"Berlin\"."
                },
                "zip": {
                  "type": "string",
                  "description": "The postal or ZIP code, such as \"10001\" or \"10115\"."
                },
                "country": {
                  "$ref": "#/definitions/CountryCode",
                  "description": "The country code in ISO 3166-1 alpha-2 format, like \"US\" or \"DE\"."
                },
                "companyName": {
                  "type": "string"
                },
                "duns": {
                  "$ref": "#/definitions/DUNS"
                },
                "vatId": {
                  "type": "string"
                },
                "taxId": {
                  "type": "string"
                },
                "contact": {
                  "$ref": "#/definitions/BusinessContact"
                },
                "mandateReference": {
                  "type": "string"
                }
              },
              "required": [
                "city",
                "companyName",
                "contact",
                "country",
                "mandateReference",
                "street",
                "vatId",
                "zip"
              ]
            },
            {
              "type": "object",
              "additionalProperties": false,
              "properties": {
                "street": {
                  "type": "string",
                  "description": "The street name or address line, such as \"123 Elm Street\" or \"Main St\"."
                },
                "city": {
                  "type": "string",
                  "description": "The city or town associated with the address, like \"New York\" or \"Berlin\"."
                },
                "zip": {
                  "type": "string",
                  "description": "The postal or ZIP code, such as \"10001\" or \"10115\"."
                },
                "country": {
                  "$ref": "#/definitions/CountryCode",
                  "description": "The country code in ISO 3166-1 alpha-2 format, like \"US\" or \"DE\"."
                },
                "companyName": {
                  "type": "string"
                },
                "duns": {
                  "$ref": "#/definitions/DUNS"
                },
                "vatId": {
                  "type": "string"
                },
                "taxId": {
                  "type": "string"
                },
                "contact": {
                  "$ref": "#/definitions/PrivateContact"
                },
                "mandateReference": {
                  "type": "string"
                }
              },
              "required": [
                "city",
                "contact",
                "country",
                "mandateReference",
                "street",
                "zip"
              ]
            }
          ]
        }
      },
      "required": [
        "creditor",
        "debitor",
        "dueDate",
        "mandateId",
        "type"
      ],
      "additionalProperties": false
    },
    "SEPAPaymentInformation": {
      "type": "object",
      "properties": {
        "paymentType": {
          "enum": ["sepa", "swift"]
        },
        "debitor": {
          "oneOf": [
            {
              "$ref": "#/definitions/BusinessPostalAddress"
            },
            {
              "$ref": "#/definitions/PrivatePostalAddress"
            }
          ]
        },
        "creditor": {
          "oneOf": [
            {
              "type": "object",
              "additionalProperties": false,
              "properties": {
                "street": {
                  "type": "string",
                  "description": "The street name or address line, such as \"123 Elm Street\" or \"Main St\"."
                },
                "city": {
                  "type": "string",
                  "description": "The city or town associated with the address, like \"New York\" or \"Berlin\"."
                },
                "zip": {
                  "type": "string",
                  "description": "The postal or ZIP code, such as \"10001\" or \"10115\"."
                },
                "country": {
                  "$ref": "#/definitions/CountryCode"
                },
                "companyName": {
                  "type": "string"
                },
                "duns": {
                  "$ref": "#/definitions/DUNS"
                },
                "vatId": {
                  "type": "string"
                },
                "taxId": {
                  "type": "string"
                },
                "contact": {
                  "$ref": "#/definitions/BusinessContact"
                },
                "iban": {
                  "$ref": "#/definitions/IBAN"
                },
                "bic": {
                  "$ref": "#/definitions/BIC"
                }
              },
              "required": [
                "bic",
                "city",
                "companyName",
                "contact",
                "country",
                "iban",
                "street",
                "vatId",
                "zip"
              ]
            },
            {
              "type": "object",
              "additionalProperties": false,
              "properties": {
                "street": {
                  "type": "string",
                  "description": "The street name or address line, such as \"123 Elm Street\" or \"Main St\"."
                },
                "city": {
                  "type": "string",
                  "description": "The city or town associated with the address, like \"New York\" or \"Berlin\"."
                },
                "zip": {
                  "type": "string",
                  "description": "The postal or ZIP code, such as \"10001\" or \"10115\"."
                },
                "country": {
                  "$ref": "#/definitions/CountryCode",
                  "description": "The country code in ISO 3166-1 alpha-2 format, like \"US\" or \"DE\"."
                },
                "companyName": {
                  "type": "string"
                },
                "duns": {
                  "$ref": "#/definitions/DUNS"
                },
                "vatId": {
                  "type": "string"
                },
                "taxId": {
                  "type": "string"
                },
                "contact": {
                  "$ref": "#/definitions/PrivateContact"
                },
                "iban": {
                  "$ref": "#/definitions/IBAN"
                },
                "bic": {
                  "$ref": "#/definitions/BIC"
                }
              },
              "required": [
                "bic",
                "city",
                "contact",
                "country",
                "iban",
                "street",
                "zip"
              ]
            }
          ]
        }
      },
      "required": [
        "creditor",
        "debitor"
      ],
      "additionalProperties": false
    },
    "CreditCardPaymentInformation": {
      "type": "object",
      "properties": {
        "paymentType": {
          "const": "credit_card"
        },
        "debitor": {
          "oneOf": [
            {
              "type": "object",
              "additionalProperties": false,
              "properties": {
                "street": {
                  "type": "string",
                  "description": "The street name or address line, such as \"123 Elm Street\" or \"Main St\"."
                },
                "city": {
                  "type": "string",
                  "description": "The city or town associated with the address, like \"New York\" or \"Berlin\"."
                },
                "zip": {
                  "type": "string",
                  "description": "The postal or ZIP code, such as \"10001\" or \"10115\"."
                },
                "country": {
                  "$ref": "#/definitions/CountryCode"
                },
                "companyName": {
                  "type": "string"
                },
                "duns": {
                  "$ref": "#/definitions/DUNS"
                },
                "vatId": {
                  "type": "string"
                },
                "taxId": {
                  "type": "string"
                },
                "contact": {
                  "$ref": "#/definitions/BusinessContact"
                },
                "lastFourDigits": {
                  "type": "string",
                  "description": "The last four digits of the credit card number.",
                  "pattern": "^[0-9]{4}$"
                },
                "expirationDate": {
                  "type": "string",
                  "description": "The expiration date of the credit card in the format 'MM/YY'.",
                  "pattern": "^(0[1-9]|1[0-2])\/[0-9]{2,4}$"
                },
                "cardholderName": {
                  "type": "string",
                  "description": "The name of the cardholder."
                }
              },
              "required": [
                "city",
                "companyName",
                "contact",
                "country",
                "street",
                "vatId",
                "zip",
                "lastFourDigits",
                "expirationDate",
                "cardholderName"
              ]
            },
            
            {
              "type": "object",
              "additionalProperties": false,
              "properties": {
                "street": {
                  "type": "string",
                  "description": "The street name or address line, such as \"123 Elm Street\" or \"Main St\"."
                },
                "city": {
                  "type": "string",
                  "description": "The city or town associated with the address, like \"New York\" or \"Berlin\"."
                },
                "zip": {
                  "type": "string",
                  "description": "The postal or ZIP code, such as \"10001\" or \"10115\"."
                },
                "country": {
                  "$ref": "#/definitions/CountryCode"
                },
                "contact": {
                  "$ref": "#/definitions/PrivateContact"
                },
                "lastFourDigits": {
                  "type": "string",
                  "description": "The last four digits of the credit card number.",
                  "pattern": "^[0-9]{4}$"
                },
                "expirationDate": {
                  "type": "string",
                  "description": "The expiration date of the credit card in the format 'MM/YY'.",
                  "pattern": "^(0[1-9]|1[0-2])\/[0-9]{2,4}$"
                },
                "cardholderName": {
                  "type": "string",
                  "description": "The name of the cardholder."
                }
              },
              "required": [
                "city",
                "contact",
                "country",
                "street",
                "zip",
                "lastFourDigits",
                "expirationDate",
                "cardholderName"
              ]
            }
          ]
        },
        "creditor": {
          "oneOf": [
            {
              "$ref": "#/definitions/BusinessPostalAddress"
            },
            {
              "$ref": "#/definitions/PrivatePostalAddress"
            }
          ]
        }
      },
      "required": [
        "creditor",
        "debitor"
      ],
      "additionalProperties": false
    },
    "CashPaymentInformation": {
      "type": "object",
      "properties": {
        "paymentType": {
          "const": "cash"
        },
        "debitor": {
          "oneOf": [
            {
              "type": "object",
              "additionalProperties": false,
              "properties": {
                "street": {
                  "type": "string",
                  "description": "The street name or address line, such as \"123 Elm Street\" or \"Main St\"."
                },
                "city": {
                  "type": "string",
                  "description": "The city or town associated with the address, like \"New York\" or \"Berlin\"."
                },
                "zip": {
                  "type": "string",
                  "description": "The postal or ZIP code, such as \"10001\" or \"10115\"."
                },
                "country": {
                  "$ref": "#/definitions/CountryCode"
                },
                "companyName": {
                  "type": "string"
                },
                "duns": {
                  "$ref": "#/definitions/DUNS"
                },
                "vatId": {
                  "type": "string"
                },
                "taxId": {
                  "type": "string"
                },
                "contact": {
                  "$ref": "#/definitions/BusinessContact"
                }
              },
              "required": [
                "city",
                "companyName",
                "contact",
                "country",
                "street",
                "vatId",
                "zip"
              ]
            },
            {
              "type": "object",
              "additionalProperties": false,
              "properties": {
                "street": {
                  "type": "string",
                  "description": "The street name or address line, such as \"123 Elm Street\" or \"Main St\"."
                },
                "city": {
                  "type": "string",
                  "description": "The city or town associated with the address, like \"New York\" or \"Berlin\"."
                },
                "zip": {
                  "type": "string",
                  "description": "The postal or ZIP code, such as \"10001\" or \"10115\"."
                },
                "country": {
                  "$ref": "#/definitions/CountryCode"
                },
                "companyName": {
                  "type": "string"
                },
                "duns": {
                  "$ref": "#/definitions/DUNS"
                },
                "vatId": {
                  "type": "string"
                },
                "taxId": {
                  "type": "string"
                },
                "contact": {
                  "$ref": "#/definitions/PrivateContact"
                }
              },
              "required": [
                "city",
                "contact",
                "country",
                "street",
                "zip"
              ]
            }
          ]
        },
        "creditor": {
          "oneOf": [
            {
              "$ref": "#/definitions/PrivatePostalAddress"
            },
            {
              "$ref": "#/definitions/BusinessPostalAddress"
            }
          ]
        }
      },
      "required": [
        "creditor",
        "debitor"
      ],
      "additionalProperties": false
    },
    "DefaultInvoice": {
      "type": "object",
      "properties": {
        "servicePeriod": {
          "$ref": "#/definitions/InvoiceServicePeriod"
        },
        "version": {
          "$ref": "#/definitions/SCHEMA_VERSION"
        },
        "type": {
          "type": "string",
          "const": "invoice"
        },
        "id": {
          "$ref": "#/definitions/InvoiceId"
        },
        "createdAt": {
          "type": "string",
          "format": "date-time"
        },
        "correction": {
          "$ref": "#/definitions/CorrectingInvoiceData"
        },
        "paymentInformation": {
          "oneOf": [
            { "$ref": "#/definitions/SEPAMandatePaymentInformation" },
            { "$ref": "#/definitions/SEPAPaymentInformation" },
            { "$ref": "#/definitions/CreditCardPaymentInformation" },
            { "$ref": "#/definitions/CashPaymentInformation" }
          ]
        },
        "items": {
          "type": "array",
          "items": {
            "$ref": "#/definitions/InvoiceItem"
          }
        }
      },
      "required": [
        "createdAt",
        "id",
        "items",
        "paymentInformation",
        "servicePeriod",
        "type",
        "version"
      ],
      "additionalProperties": false
    },
    "PartialInvoice": {
      "type": "object",
      "properties": {
        "servicePeriod": {
          "$ref": "#/definitions/InvoiceServicePeriod"
        },
        "version": {
          "$ref": "#/definitions/SCHEMA_VERSION"
        },
        "type": {
          "type": "string",
          "const": "partial_invoice"
        },
        "id": {
          "$ref": "#/definitions/InvoiceId"
        },
        "createdAt": {
          "type": "string",
          "format": "date-time"
        },
        "correction": {
          "$ref": "#/definitions/CorrectingInvoiceData"
        },
        "paymentInformation": {
          "oneOf": [
            { "$ref": "#/definitions/SEPAMandatePaymentInformation" },
            { "$ref": "#/definitions/SEPAPaymentInformation" },
            { "$ref": "#/definitions/CreditCardPaymentInformation" },
            { "$ref": "#/definitions/CashPaymentInformation" }
          ]
        },
        "items": {
          "type": "array",
          "items": {
            "$ref": "#/definitions/InvoiceItem"
          }
        },
        "previousInvoiceId": {
          "type": "string",
          "description": "This field contains the id of the previous invoice that it is extending, to be left empty if its the first of a series."
        }
      },
      "required": [
        "createdAt",
        "id",
        "items",
        "paymentInformation",
        "previousInvoiceId",
        "servicePeriod",
        "type",
        "version"
      ],
      "additionalProperties": false
    },
    "RecurringInvoice": {
      "type": "object",
      "properties": {
        "servicePeriod": {
          "$ref": "#/definitions/InvoiceServicePeriod"
        },
        "version": {
          "$ref": "#/definitions/SCHEMA_VERSION"
        },
        "type": {
          "type": "string",
          "const": "recurring_invoice"
        },
        "id": {
          "$ref": "#/definitions/InvoiceId"
        },
        "createdAt": {
          "type": "string",
          "format": "date-time"
        },
        "correction": {
          "$ref": "#/definitions/CorrectingInvoiceData"
        },
        "paymentInformation": {
          "oneOf": [
            { "$ref": "#/definitions/SEPAMandatePaymentInformation" },
            { "$ref": "#/definitions/SEPAPaymentInformation" },
            { "$ref": "#/definitions/CreditCardPaymentInformation" }
          ]
        },
        "items": {
          "type": "array",
          "items": {
            "$ref": "#/definitions/InvoiceItem"
          }
        },
        "subscriptionId": {
          "type": "string"
        }
      },
      "required": [
        "createdAt",
        "id",
        "items",
        "paymentInformation",
        "servicePeriod",
        "type",
        "version"
      ],
      "additionalProperties": false
    },
    "CancellationInvoice": {
      "type": "object",
      "properties": {
        "version": {
          "$ref": "#/definitions/SCHEMA_VERSION"
        },
        "type": {
          "type": "string",
          "const": "cancellation_invoice"
        },
        "id": {
          "$ref": "#/definitions/InvoiceId"
        },
        "createdAt": {
          "type": "string",
          "format": "date-time"
        },
        "correction": {
          "$ref": "#/definitions/CorrectingInvoiceData"
        },
        "cancellingId": {
          "type": "string"
        }
      },
      "required": [
        "cancellingId",
        "createdAt",
        "id",
        "type",
        "version"
      ],
      "additionalProperties": false
    },
    "Invoice": {
      "oneOf": [
        { "$ref": "#/definitions/PartialInvoice"},
        { "$ref": "#/definitions/DefaultInvoice"},
        { "$ref": "#/definitions/RecurringInvoice"},
        { "$ref": "#/definitions/CancellationInvoice"}
      ]
    },
    "CountryCode": {
      "type": "string",
      "description": "The country code in ISO 3166-1 alpha-2 format, like \"US\" or \"DE\".",
      "enum": [
        "AF",
        "AL",
        "DZ",
        "AS",
        "AD",
        "AO",
        "AI",
        "AQ",
        "AG",
        "AR",
        "AM",
        "AW",
        "AU",
        "AT",
        "AZ",
        "BS",
        "BH",
        "BD",
        "BB",
        "BY",
        "BE",
        "BZ",
        "BJ",
        "BM",
        "BT",
        "BO",
        "BQ",
        "BA",
        "BW",
        "BV",
        "BR",
        "IO",
        "BN",
        "BG",
        "BF",
        "BI",
        "CV",
        "KH",
        "CM",
        "CA",
        "KY",
        "CF",
        "TD",
        "CL",
        "CN",
        "CX",
        "CC",
        "CO",
        "KM",
        "CD",
        "CG",
        "CK",
        "CR",
        "HR",
        "CU",
        "CW",
        "CY",
        "CZ",
        "CI",
        "DK",
        "DJ",
        "DM",
        "DO",
        "EC",
        "EG",
        "SV",
        "GQ",
        "ER",
        "EE",
        "SZ",
        "ET",
        "FK",
        "FO",
        "FJ",
        "FI",
        "FR",
        "GF",
        "PF",
        "TF",
        "GA",
        "GM",
        "GE",
        "DE",
        "GH",
        "GI",
        "GR",
        "GL",
        "GD",
        "GP",
        "GU",
        "GT",
        "GG",
        "GN",
        "GW",
        "GY",
        "HT",
        "HM",
        "VA",
        "HN",
        "HK",
        "HU",
        "IS",
        "IN",
        "ID",
        "IR",
        "IQ",
        "IE",
        "IM",
        "IL",
        "IT",
        "JM",
        "JP",
        "JE",
        "JO",
        "KZ",
        "KE",
        "KI",
        "KP",
        "KR",
        "KW",
        "KG",
        "LA",
        "LV",
        "LB",
        "LS",
        "LR",
        "LY",
        "LI",
        "LT",
        "LU",
        "MO",
        "MG",
        "MW",
        "MY",
        "MV",
        "ML",
        "MT",
        "MH",
        "MQ",
        "MR",
        "MU",
        "YT",
        "MX",
        "FM",
        "MD",
        "MC",
        "MN",
        "ME",
        "MS",
        "MA",
        "MZ",
        "MM",
        "NA",
        "NR",
        "NP",
        "NL",
        "NC",
        "NZ",
        "NI",
        "NE",
        "NG",
        "NU",
        "NF",
        "MP",
        "NO",
        "OM",
        "PK",
        "PW",
        "PS",
        "PA",
        "PG",
        "PY",
        "PE",
        "PH",
        "PN",
        "PL",
        "PT",
        "PR",
        "QA",
        "MK",
        "RO",
        "RU",
        "RW",
        "RE",
        "BL",
        "SH",
        "KN",
        "LC",
        "MF",
        "PM",
        "VC",
        "WS",
        "SM",
        "ST",
        "SA",
        "SN",
        "RS",
        "SC",
        "SL",
        "SG",
        "SX",
        "SK",
        "SI",
        "SB",
        "SO",
        "ZA",
        "GS",
        "SS",
        "ES",
        "LK",
        "SD",
        "SR",
        "SJ",
        "SE",
        "CH",
        "SY",
        "TW",
        "TJ",
        "TZ",
        "TH",
        "TL",
        "TG",
        "TK",
        "TO",
        "TT",
        "TN",
        "TR",
        "TM",
        "TC",
        "TV",
        "UG",
        "UA",
        "AE",
        "GB",
        "UM",
        "US",
        "UY",
        "UZ",
        "VU",
        "VE",
        "VN",
        "VG",
        "VI",
        "WF",
        "EH",
        "YE",
        "ZM",
        "ZW",
        "AX"
      ]
    },
    "Currency": {
      "type": "string",
      "enum": [
        "USD",
        "EUR",
        "GBP",
        "JPY",
        "CHF",
        "AUD",
        "CAD",
        "NZD",
        "CNY",
        "INR",
        "RUB",
        "BRL",
        "MXN",
        "ZAR",
        "SEK",
        "NOK",
        "DKK",
        "PLN",
        "TRY",
        "AED",
        "SAR",
        "HKD",
        "KRW",
        "SGD",
        "MYR",
        "THB",
        "IDR",
        "ARS",
        
        "BTC",
        "ETH",
        "SOL",
        "DOGE",
        "LTC",
        "BCH",
        "XRP",
        "ADA",
        "DOT",
        "MATIC",
        "UNI",
        "LINK",
        "AVAX"
      ]
    },
    "InvoiceItemUnit": {
      "type": "string",
      "enum": [
        "piece",
        "flat_rate",
        "time_unit",
        "project_day",
        "m",
        "cm",
        "mm",
        "km",
        "in",
        "ft",
        "yd",
        "mi",
        "kg",
        "g",
        "mg",
        "t",
        "lb",
        "oz",
        "L",
        "ml",
        "gal",
        "qt",
        "pt",
        "cup",
        "fl oz",
        "ms",
        "s",
        "h",
        "d",
        "w",
        "M",
        "y",
        "m²",
        "cm²",
        "km²",
        "in²",
        "ft²",
        "yd²",
        "mi²",
        "m³",
        "cm³",
        "km³",
        "in³",
        "ft³",
        "yd³",
        "mi³",
        "km/h",
        "mi/h",
        "m/s",
        "ft/s"
      ]
    }
  },
  "$ref": "#/definitions/Invoice"
}