Raw schema
{
"type": "object",
"properties": {
"contact_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The contact (customer)'s numeric id."
},
"contact_person_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Id of the sevdesk user (SevUser) acting as contact person — e.g. contactPerson.id of an existing invoice."
},
"invoice_date": {
"type": "string",
"pattern": "^\\d{2}\\.\\d{2}\\.\\d{4}$",
"description": "Invoice date as dd.mm.yyyy."
},
"positions": {
"minItems": 1,
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"description": "Line item name."
},
"quantity": {
"type": "number",
"exclusiveMinimum": 0,
"description": "Quantity."
},
"price": {
"type": "number",
"description": "Unit price — net if show_net is true (default), otherwise gross."
},
"tax_rate": {
"type": "number",
"minimum": 0,
"description": "VAT rate in percent, e.g. 19, 7 or 0."
},
"unity_id": {
"default": 1,
"description": "Unit id (1 = Stück/piece). Default 1.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"text": {
"description": "Longer description shown under the name.",
"type": "string"
},
"part_id": {
"description": "Link the line to this inventory part id.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"required": [
"name",
"quantity",
"price",
"tax_rate"
]
},
"description": "Line items (at least one)."
},
"tax_rule_id": {
"default": "1",
"description": "Bookkeeping 2.0 VAT rule id. 1 taxable sales (Umsatzsteuerpflichtige Umsätze), 2 exports, 3 intra-EU supplies, 4 tax-free §4 UStG, 5 reverse charge §13b, 11 small business §19 (Kleinunternehmer), 17 not taxable in Germany, 18-20 One Stop Shop, 21 reverse charge §18b. Default 1.",
"type": "string",
"enum": [
"1",
"2",
"3",
"4",
"5",
"11",
"17",
"18",
"19",
"20",
"21"
]
},
"tax_type": {
"description": "Bookkeeping 1.0 only — leave unset on 2.0 accounts.",
"type": "string",
"enum": [
"default",
"eu",
"noteu",
"custom",
"ss"
]
},
"tax_text": {
"default": "Umsatzsteuer 19%",
"description": "VAT text printed on the invoice. Default 'Umsatzsteuer 19%'.",
"type": "string"
},
"currency": {
"default": "EUR",
"description": "ISO-4217 currency code. Default EUR.",
"type": "string",
"minLength": 3,
"maxLength": 3
},
"address_country_id": {
"default": 1,
"description": "sevdesk StaticCountry id of the billing address (1 = Germany). Default 1.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"address": {
"description": "Complete recipient address with line breaks. Omit to leave it empty.",
"type": "string"
},
"header": {
"description": "Invoice header/title line.",
"type": "string"
},
"head_text": {
"description": "Text above the line items (some HTML allowed).",
"type": "string"
},
"foot_text": {
"description": "Text below the line items (some HTML allowed).",
"type": "string"
},
"time_to_pay": {
"description": "Payment term in days.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"delivery_date": {
"description": "Delivery / service date as dd.mm.yyyy (must not be after invoice_date for a normal invoice).",
"type": "string",
"pattern": "^\\d{2}\\.\\d{2}\\.\\d{4}$"
},
"show_net": {
"default": true,
"description": "If true (default), position prices are net.",
"type": "boolean"
},
"small_settlement": {
"description": "True if the account uses the small-business scheme (no VAT).",
"type": "boolean"
},
"customer_internal_note": {
"description": "Reference / order number field.",
"type": "string"
}
},
"required": [
"contact_id",
"contact_person_id",
"invoice_date",
"positions"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}