Raw schema
{
"type": "object",
"properties": {
"items": {
"minItems": 1,
"maxItems": 200,
"type": "array",
"items": {
"type": "object",
"properties": {
"text": {
"type": "string",
"minLength": 1,
"maxLength": 255,
"description": "Item text (max 255 characters)."
},
"unit_price": {
"type": "number",
"minimum": -1000000000,
"maximum": 1000000000,
"description": "Price per unit, in the invoice currency. Net or gross depending on calculate_vat."
},
"quantity": {
"description": "Quantity (default 1).",
"type": "number",
"minimum": -1000000000,
"maximum": 1000000000
},
"unit": {
"description": "Unit, e.g. ks, kg, hod (max 10 characters).",
"type": "string",
"maxLength": 10
},
"vat_rate": {
"description": "VAT rate in percent, e.g. 21, 12 or 0.",
"type": "number",
"minimum": 0,
"maximum": 100
}
},
"required": [
"text",
"unit_price"
]
},
"description": "Document items (1-200)."
},
"type": {
"description": "Document type: 1 faktura (default), 2 zalohova faktura, 4 proforma faktura, 8 vyzva k platbe, 512 objednavka.",
"anyOf": [
{
"type": "number",
"const": 1
},
{
"type": "number",
"const": 2
},
{
"type": "number",
"const": 4
},
{
"type": "number",
"const": 8
},
{
"type": "number",
"const": 512
}
]
},
"id_customer": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "string",
"pattern": "^[1-9][0-9]{0,14}$"
}
],
"description": "Address-book contact id (from vyfakturuj_list_contacts); fills the customer block."
},
"customer_name": {
"description": "Customer company name (when no id_customer).",
"type": "string",
"maxLength": 100
},
"customer_firstname": {
"description": "Customer first name.",
"type": "string",
"maxLength": 100
},
"customer_lastname": {
"description": "Customer last name.",
"type": "string",
"maxLength": 100
},
"customer_IC": {
"description": "Customer ICO (company id).",
"type": "string",
"maxLength": 20
},
"customer_DIC": {
"description": "Customer DIC (VAT id).",
"type": "string",
"maxLength": 20
},
"customer_street": {
"description": "Customer street.",
"type": "string",
"maxLength": 50
},
"customer_city": {
"description": "Customer city.",
"type": "string",
"maxLength": 50
},
"customer_zip": {
"description": "Customer postal code (PSC).",
"type": "string",
"maxLength": 10
},
"customer_country_code": {
"type": "string",
"pattern": "^[A-Za-z]{2}$",
"description": "ISO 3166 country code, e.g. CZ, SK, DE."
},
"id_number_series": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "string",
"pattern": "^[1-9][0-9]{0,14}$"
}
],
"description": "Number series id (from vyfakturuj_list_number_series); must match the document type."
},
"id_payment_method": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "string",
"pattern": "^[1-9][0-9]{0,14}$"
}
],
"description": "Payment method id (from vyfakturuj_list_payment_methods)."
},
"date_created": {
"description": "Issue date yyyy-mm-dd (default today).",
"type": "string"
},
"date_taxable_supply": {
"description": "Date of taxable supply (DUZP) yyyy-mm-dd.",
"type": "string"
},
"days_due": {
"description": "Days until due (splatnost).",
"type": "integer",
"minimum": 0,
"maximum": 3650
},
"currency": {
"description": "Currency, ISO 4217 (default: the account's).",
"type": "string",
"pattern": "^[A-Za-z]{3}$"
},
"calculate_vat": {
"description": "1 items are net (VAT added), 2 items are gross, 3 special VAT regime, 4 domestic reverse charge, 5 not a VAT payer, 6 foreign reverse charge.",
"anyOf": [
{
"type": "number",
"const": 1
},
{
"type": "number",
"const": 2
},
{
"type": "number",
"const": 3
},
{
"type": "number",
"const": 4
},
{
"type": "number",
"const": 5
},
{
"type": "number",
"const": 6
}
]
},
"language": {
"description": "Language of the document.",
"type": "string",
"enum": [
"cs",
"sk",
"en",
"de",
"it",
"pl"
]
},
"VS": {
"description": "Variable symbol (default: derived from the number).",
"type": "integer",
"minimum": 0,
"maximum": 9999999999
},
"order_number": {
"description": "Order id / reference.",
"type": "string",
"maxLength": 255
},
"text_before_items": {
"description": "Text before the items.",
"type": "string",
"maxLength": 255
},
"text_invoice_footer": {
"description": "Text in the footer.",
"type": "string",
"maxLength": 255
},
"note_internal": {
"description": "Internal note (not on the document).",
"type": "string",
"maxLength": 2000
}
},
"required": [
"items"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}