Raw schema
{
"type": "object",
"properties": {
"id": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "string",
"pattern": "^[1-9]\\d{0,15}$"
}
],
"description": "Voucher id (from papierkram_list_vouchers)."
},
"name": {
"description": "New voucher title.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"provenance": {
"description": "Where the supplier is: domestic (Germany), eu or foreign.",
"type": "string",
"enum": [
"domestic",
"eu",
"foreign"
]
},
"document_date": {
"description": "New receipt date yyyy-mm-dd (Belegdatum).",
"type": "string"
},
"due_date": {
"description": "New due date yyyy-mm-dd; null removes the due date.",
"type": [
"string",
"null"
]
},
"creditor_id": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "string",
"pattern": "^[1-9]\\d{0,15}$"
}
],
"description": "New supplier company id (from papierkram_list_companies; it must be a supplier)."
},
"description": {
"description": "New notes.",
"type": "string",
"maxLength": 2000
},
"flagged": {
"description": "Mark (true) or unmark (false) the voucher for a later check.",
"type": "boolean"
},
"entertainment_reason": {
"description": "Reason of a business meal (Bewirtungskosten only).",
"type": "string",
"maxLength": 500
},
"entertainment_persons": {
"description": "Guests of a business meal (Bewirtungskosten only).",
"maxItems": 30,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 200
}
},
"line_items": {
"description": "The complete new list of voucher lines. It replaces ALL current lines.",
"minItems": 1,
"maxItems": 100,
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 300,
"description": "Line text, e.g. Druckerpapier."
},
"amount": {
"type": "number",
"minimum": -1000000000000,
"maximum": 1000000000000,
"description": "Amount of the line. The API reference does not say gross or net: check the preview and the first created voucher in Papierkram."
},
"vat_rate": {
"type": "number",
"minimum": 0,
"maximum": 1,
"description": "VAT rate as a fraction, e.g. 0.19, 0.07 or 0."
},
"category": {
"description": "Papierkram expense category (Kategorie), e.g. Bürobedarf, Bewirtungskosten, Telefon.",
"type": "string",
"enum": [
"Andere Anlagen",
"Betriebsausstattung (Anlage)",
"Büroeinrichtung",
"Fahrzeuge (PKW)",
"Geschäftsausstattung",
"Grundstücke",
"GWG ab 2018: 250 bis 1000 EUR (Sammelposten)",
"GWG ab 2018: bis 800 EUR (Geringwertiges Wirtschaftsgut)",
"GWG vor 2018: 150 bis 1000 EUR (Sammelposten)",
"GWG vor 2018: bis 410 EUR (Geringwertiges Wirtschaftsgut)",
"Sofortabschreibung ab 2021: PC, Laptop und andere Computer-Hardware",
"Software (Anlage)",
"Technische Anlagen und Maschinen",
"Aufwendungen für ein häusliches Arbeitszimmer",
"Ausgangsfrachten",
"Betriebsbedarf",
"Bewirtungskosten",
"Bezugsnebenkosten",
"Buchführungskosten",
"Büroartikel",
"Bürobedarf",
"Fahrten zwischen Wohnung und Betriebsstätte und Familienheimfahrten (abziehbarer Anteil)",
"Fahrten zwischen Wohnung und Betriebsstätte und Familienheimfahrten (nicht abziehbarer Anteil)",
"Fahrtkostenerstatt. Whg./Arbeitsstätte",
"Fortbildung",
"Fremdleistung (Dienstleistung)",
"Garagenmieten",
"Gas, Strom, Wasser",
"Gehälter",
"Geschäftsessen",
"Gesetzliche Sozialaufwendungen",
"Gewerbesteuer",
"Gewerbesteuer Nachzahlung oder Erstattung",
"Grundsteuer",
"Heizung",
"Kfz-Reparaturen",
"Kfz-Steuern",
"Kfz-Versicherungen",
"Körperschaftsteuer",
"Laufende Kfz-Betriebskosten",
"Leasing",
"Leergut",
"Löhne",
"Miete",
"Mietleasing bewegliche Wirtschaftsgüter für technische Anlagen und Maschinen",
"Nebenkosten des Geldverkehrs",
"Nicht abzugsfähige Bewirtungskosten",
"Porto",
"Rechts- und Beratungskosten",
"Reinigung",
"Reisekosten Arbeitnehmer",
"Reisekosten Arbeitnehmer Fahrtkosten",
"Reisekosten Arbeitnehmer Verpflegungsmehraufwand",
"Reisekosten Arbeitnehmer Übernachtungsaufwand",
"Reisekosten UN Verpfleg.mehraufwand",
"Reisekosten UN Übernachtungsaufwand",
"Reisekosten Unternehmer",
"Reisekosten Unternehmer Fahrtkosten",
"Reparatur/Instandh. Betriebs- u. Gesch.",
"Repräsentationskosten",
"Roh-, Hilfs- und Betriebsstoffe",
"Software/EDV (Büroartikel)",
"Sonstige betriebliche Aufwendungen",
"Sonstige Kfz-Kosten",
"Spesen (Reisekosten Unternehmer)",
"Telefon",
"Verkaufsprovisionen",
"Versicherungen",
"Wareneingang",
"Werbekosten",
"Zeitschriften, Bücher",
"Zinsabschlagsteuer",
"Zinsen und ähnliche Aufwendungen",
"Zuwendungen,Spenden steuerl. n. abziehb.",
"Erlöse Leergut",
"Private KFZ Nutzung (1% Regel)",
"Private Verwendung von Gegenständen",
"Privatentnahme Waren/Gegenstände",
"Provisionserlöse",
"Sonstige Einnahme (Erlöse)",
"Zinsen und ähnliche Erträge",
"Zuschüsse",
"Geldtransit (Einzahlung)",
"Privateinlagen",
"Geldtransit (Auszahlung)",
"Privatentnahmen allgemein",
"Umsatzsteuer Erstattung (nur EÜR)",
"Umsatzsteuer frühere Jahre",
"Umsatzsteuer Vorjahr",
"Umsatzsteuervorauszahlungen",
"Umsatzsteuervorauszahlungen 1/11",
"Umsatzsteuer Erstattung",
"Umsatzsteuer Erstattung frühere Jahre",
"Umsatzsteuervorauszahlung Guthaben"
]
}
},
"required": [
"name",
"amount",
"vat_rate"
]
}
},
"confirm": {
"description": "False or missing: preview only, nothing is changed. True: change the voucher now.",
"type": "boolean"
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}