Zum Inhalt springen
Developer

ExpenseCategory

Buchhaltung7 EndpunkteBilling / ExpenseCategory

Liefert eine Liste aller ExpenseCategory-Objekte.

GET/api/invoice/expense_category

Query-Parameter

searchStringstringText, nach dem in der Liste gesucht wird
orderFieldNamestringName des Bestellfelds
orderFieldSortstringSortiermodusErlaubt: DESCASC
pageintegerSeite der Liste
pageSizeintegerAnzahl der Einträge je Seite
withMaxPageNumberstringgibt die Anzahl verfügbarer Seiten als Header zurück, wenn dies gesetzt ist

Antworten

200Liefert eine Liste aller ExpenseCategory-Objekte.array<ExpenseCategory>

Felder anzeigen (21)
  • idinteger

    Primärschlüssel der Ausgabenkategorie. Interne ID.

  • codestring

    Kurzbezeichnung/Code (z.B. "WAREN", "PERSONAL", "MIETE")

  • eur_line_numberinteger

    Zeile in der Anlage EÜR (z. B. 23 für Wareneinkauf)

  • eur_line_namestring

    Bezeichnung der EÜR-Zeile (z. B. „Waren, Rohstoffe und Hilfsstoffe“)

  • category_typestring

    Typ der Kategorie (expense, income, neutral, asset, private)

  • parentExpenseCategory

    Übergeordnete Kategorie (für Hierarchie)

  • childrenarray<ExpenseCategory>

    Untergeordnete Kategorien

  • default_taxTax

    Standard-Steuersatz für diese Kategorie

    Felder anzeigen (6)
    • idinteger

      Primärschlüssel des Steuersatzes. Interne ID.

    • namestringPflicht

      Name des Steuersatzes, zum Beispiel 19 Prozent.

    • valuenumber (float)

      Steuersatz in Prozent.

    • deletedboolean

      Der Steuersatz wird gelöscht.

    • global_defaultboolean

      Standard-Steuersatz für neue Artikel.

    • datev_tax_keyinteger

      DATEV Steuerschlüssel für Umsatzsteuer (Ausgangsrechnungen). Wird von BuchhaltungsButler und DATEV-Export genutzt. Standardwerte: 0 = Kein Steuerausweis (0%) 2 = Umsatzsteuer 7% (ermäßigt) 3 = Umsatzsteuer 19% (Regelsteuersatz) Für Vorsteuer (Eingangsrechnungen) gibt es eine spiegelbildliche Zuordnung: 0 = Keine Vorsteuer (0%) 5 = Vorsteuer 7% 8 = Vorsteuer 19%

  • cost_centerCostCenter

    Kostenstelle der Kategorie - bei Vereinen die steuerliche Sphäre. Ein Beleg trägt keine eigene Sphäre; über seine Kategorie bekommt er eine. Die EÜR des wirtschaftlichen Geschäftsbetriebs liest sie (billing_euer_commercial_sphere_only), die automatische Buchung setzt sie auf die Buchungszeilen (billing_accounting_cost_center_from_category).

    Felder anzeigen (10)
    • display_namestring
    • idinteger

      Primärschlüssel der Kostenstelle. Interne ID.

    • numberstring

      Nummer der Kostenstelle.

    • spherestring

      Steuerliche Sphäre, null bei rein betriebswirtschaftlicher Gliederung.

    • is_systemboolean

      Die Kostenstelle wird vom System angelegt und kann nicht gelöscht werden.

    • is_activeboolean

      Die Kostenstelle ist aktiv.

    • deletedboolean

      Diese Eigenschaft markiert eine Entität als gelöscht / archiviert

    • namestring

      Name der Einheit.

    • createdstring (date-time)

      Zeitpunkt, zu dem der Datensatz angelegt wurde.

    • updatedstring (date-time)

      Zeitpunkt, zu dem der Datensatz zuletzt aktualisiert wurde.

  • is_vat_deductibleboolean

    Ist Vorsteuerabzug möglich?

  • is_immediate_deductionboolean

    Ist die Kategorie sofort abzugsfähig? (vs. Abschreibung über mehrere Jahre)

  • depreciation_yearsinteger

    Abschreibungsdauer in Jahren (für Anlagevermögen)

  • sort_orderinteger

    Sortierreihenfolge

  • is_activeboolean

    Ist die Kategorie aktiv/sichtbar?

  • colorstring

    Farbe für UI-Darstellung (Hex-Code)

  • iconstring

    Icon-Name für UI-Darstellung

  • is_systemboolean

    Ist dies eine System-Kategorie? (nicht löschbar)

  • deletedboolean

    Diese Eigenschaft markiert eine Entität als gelöscht / archiviert

  • namestring

    Name der Einheit.

  • createdstring (date-time)

    Zeitpunkt, zu dem der Datensatz angelegt wurde.

  • updatedstring (date-time)

    Zeitpunkt, zu dem der Datensatz zuletzt aktualisiert wurde.

Anfrage
curl --request GET \
  --url https://eure-instanz.iw-erp.de/api/invoice/expense_category \
  --header 'x-iw-jwt-token: <TOKEN>'
Antwort 200 application/json
[
  {
    "id": 42,
    "eur_line_name": "Beispiel",
    "color": "#3f5efb",
    "name": "Beispiel",
    "code": "string",
    "eur_line_number": 1,
    "category_type": "string",
    "default_tax": {
      "name": "Beispiel",
      "id": 42,
      "value": 1.5,
      "deleted": true,
      "global_default": true,
      "datev_tax_key": 1
    },
    "cost_center": {
      "display_name": "Beispiel",
      "id": 42,
      "name": "Beispiel",
      "number": "string",
      "sphere": "string",
      "is_system": true,
      "is_active": true,
      "deleted": true,
      "created": "2026-10-15T09:30:00+02:00",
      "updated": "2026-10-15T09:30:00+02:00"
    },
    "is_vat_deductible": true
  }
]

ExpenseCategory neu anlegen

POST/api/invoice/expense_category

Request-Body application/json

  • dataExpenseCategory
    Felder anzeigen (21)
    • idinteger

      Primärschlüssel der Ausgabenkategorie. Interne ID.

    • codestring

      Kurzbezeichnung/Code (z.B. "WAREN", "PERSONAL", "MIETE")

    • eur_line_numberinteger

      Zeile in der Anlage EÜR (z. B. 23 für Wareneinkauf)

    • eur_line_namestring

      Bezeichnung der EÜR-Zeile (z. B. „Waren, Rohstoffe und Hilfsstoffe“)

    • category_typestring

      Typ der Kategorie (expense, income, neutral, asset, private)

    • parentExpenseCategory

      Übergeordnete Kategorie (für Hierarchie)

    • childrenarray<ExpenseCategory>

      Untergeordnete Kategorien

    • default_taxTax

      Standard-Steuersatz für diese Kategorie

    • cost_centerCostCenter

      Kostenstelle der Kategorie - bei Vereinen die steuerliche Sphäre. Ein Beleg trägt keine eigene Sphäre; über seine Kategorie bekommt er eine. Die EÜR des wirtschaftlichen Geschäftsbetriebs liest sie (billing_euer_commercial_sphere_only), die automatische Buchung setzt sie auf die Buchungszeilen (billing_accounting_cost_center_from_category).

    • is_vat_deductibleboolean

      Ist Vorsteuerabzug möglich?

    • is_immediate_deductionboolean

      Ist die Kategorie sofort abzugsfähig? (vs. Abschreibung über mehrere Jahre)

    • depreciation_yearsinteger

      Abschreibungsdauer in Jahren (für Anlagevermögen)

    • sort_orderinteger

      Sortierreihenfolge

    • is_activeboolean

      Ist die Kategorie aktiv/sichtbar?

    • colorstring

      Farbe für UI-Darstellung (Hex-Code)

    • iconstring

      Icon-Name für UI-Darstellung

    • is_systemboolean

      Ist dies eine System-Kategorie? (nicht löschbar)

    • deletedboolean

      Diese Eigenschaft markiert eine Entität als gelöscht / archiviert

    • namestring

      Name der Einheit.

    • createdstring (date-time)

      Zeitpunkt, zu dem der Datensatz angelegt wurde.

    • updatedstring (date-time)

      Zeitpunkt, zu dem der Datensatz zuletzt aktualisiert wurde.

Antworten

200ExpenseCategory neu anlegenExpenseCategory

Felder anzeigen (21)
  • idinteger

    Primärschlüssel der Ausgabenkategorie. Interne ID.

  • codestring

    Kurzbezeichnung/Code (z.B. "WAREN", "PERSONAL", "MIETE")

  • eur_line_numberinteger

    Zeile in der Anlage EÜR (z. B. 23 für Wareneinkauf)

  • eur_line_namestring

    Bezeichnung der EÜR-Zeile (z. B. „Waren, Rohstoffe und Hilfsstoffe“)

  • category_typestring

    Typ der Kategorie (expense, income, neutral, asset, private)

  • parentExpenseCategory

    Übergeordnete Kategorie (für Hierarchie)

  • childrenarray<ExpenseCategory>

    Untergeordnete Kategorien

  • default_taxTax

    Standard-Steuersatz für diese Kategorie

    Felder anzeigen (6)
    • idinteger

      Primärschlüssel des Steuersatzes. Interne ID.

    • namestringPflicht

      Name des Steuersatzes, zum Beispiel 19 Prozent.

    • valuenumber (float)

      Steuersatz in Prozent.

    • deletedboolean

      Der Steuersatz wird gelöscht.

    • global_defaultboolean

      Standard-Steuersatz für neue Artikel.

    • datev_tax_keyinteger

      DATEV Steuerschlüssel für Umsatzsteuer (Ausgangsrechnungen). Wird von BuchhaltungsButler und DATEV-Export genutzt. Standardwerte: 0 = Kein Steuerausweis (0%) 2 = Umsatzsteuer 7% (ermäßigt) 3 = Umsatzsteuer 19% (Regelsteuersatz) Für Vorsteuer (Eingangsrechnungen) gibt es eine spiegelbildliche Zuordnung: 0 = Keine Vorsteuer (0%) 5 = Vorsteuer 7% 8 = Vorsteuer 19%

  • cost_centerCostCenter

    Kostenstelle der Kategorie - bei Vereinen die steuerliche Sphäre. Ein Beleg trägt keine eigene Sphäre; über seine Kategorie bekommt er eine. Die EÜR des wirtschaftlichen Geschäftsbetriebs liest sie (billing_euer_commercial_sphere_only), die automatische Buchung setzt sie auf die Buchungszeilen (billing_accounting_cost_center_from_category).

    Felder anzeigen (10)
    • display_namestring
    • idinteger

      Primärschlüssel der Kostenstelle. Interne ID.

    • numberstring

      Nummer der Kostenstelle.

    • spherestring

      Steuerliche Sphäre, null bei rein betriebswirtschaftlicher Gliederung.

    • is_systemboolean

      Die Kostenstelle wird vom System angelegt und kann nicht gelöscht werden.

    • is_activeboolean

      Die Kostenstelle ist aktiv.

    • deletedboolean

      Diese Eigenschaft markiert eine Entität als gelöscht / archiviert

    • namestring

      Name der Einheit.

    • createdstring (date-time)

      Zeitpunkt, zu dem der Datensatz angelegt wurde.

    • updatedstring (date-time)

      Zeitpunkt, zu dem der Datensatz zuletzt aktualisiert wurde.

  • is_vat_deductibleboolean

    Ist Vorsteuerabzug möglich?

  • is_immediate_deductionboolean

    Ist die Kategorie sofort abzugsfähig? (vs. Abschreibung über mehrere Jahre)

  • depreciation_yearsinteger

    Abschreibungsdauer in Jahren (für Anlagevermögen)

  • sort_orderinteger

    Sortierreihenfolge

  • is_activeboolean

    Ist die Kategorie aktiv/sichtbar?

  • colorstring

    Farbe für UI-Darstellung (Hex-Code)

  • iconstring

    Icon-Name für UI-Darstellung

  • is_systemboolean

    Ist dies eine System-Kategorie? (nicht löschbar)

  • deletedboolean

    Diese Eigenschaft markiert eine Entität als gelöscht / archiviert

  • namestring

    Name der Einheit.

  • createdstring (date-time)

    Zeitpunkt, zu dem der Datensatz angelegt wurde.

  • updatedstring (date-time)

    Zeitpunkt, zu dem der Datensatz zuletzt aktualisiert wurde.

Anfrage
curl --request POST \
  --url https://eure-instanz.iw-erp.de/api/invoice/expense_category \
  --header 'content-type: application/json' \
  --header 'x-iw-jwt-token: <TOKEN>' \
  --data '
{
  "data": {
    "id": 42,
    "eur_line_name": "Beispiel",
    "color": "#3f5efb",
    "name": "Beispiel",
    "code": "string",
    "eur_line_number": 1
  }
}
'
Antwort 200 application/json
{
  "id": 42,
  "eur_line_name": "Beispiel",
  "color": "#3f5efb",
  "name": "Beispiel",
  "code": "string",
  "eur_line_number": 1,
  "category_type": "string",
  "default_tax": {
    "name": "Beispiel",
    "id": 42,
    "value": 1.5,
    "deleted": true,
    "global_default": true,
    "datev_tax_key": 1
  },
  "cost_center": {
    "display_name": "Beispiel",
    "id": 42,
    "name": "Beispiel",
    "number": "string",
    "sphere": "string",
    "is_system": true,
    "is_active": true,
    "deleted": true,
    "created": "2026-10-15T09:30:00+02:00",
    "updated": "2026-10-15T09:30:00+02:00"
  },
  "is_vat_deductible": true
}

Kategoriebaumstruktur abrufen

GET/api/invoice/expense_category/tree

Antworten

default

Anfrage
curl --request GET \
  --url https://eure-instanz.iw-erp.de/api/invoice/expense_category/tree \
  --header 'x-iw-jwt-token: <TOKEN>'

Einzelne ExpenseCategory abrufen

GET/api/invoice/expense_category/{identifier}

Pfad-Parameter

identifierPflichtstring

Antworten

200Einzelne ExpenseCategory abrufenExpenseCategory

Felder anzeigen (21)
  • idinteger

    Primärschlüssel der Ausgabenkategorie. Interne ID.

  • codestring

    Kurzbezeichnung/Code (z.B. "WAREN", "PERSONAL", "MIETE")

  • eur_line_numberinteger

    Zeile in der Anlage EÜR (z. B. 23 für Wareneinkauf)

  • eur_line_namestring

    Bezeichnung der EÜR-Zeile (z. B. „Waren, Rohstoffe und Hilfsstoffe“)

  • category_typestring

    Typ der Kategorie (expense, income, neutral, asset, private)

  • parentExpenseCategory

    Übergeordnete Kategorie (für Hierarchie)

  • childrenarray<ExpenseCategory>

    Untergeordnete Kategorien

  • default_taxTax

    Standard-Steuersatz für diese Kategorie

    Felder anzeigen (6)
    • idinteger

      Primärschlüssel des Steuersatzes. Interne ID.

    • namestringPflicht

      Name des Steuersatzes, zum Beispiel 19 Prozent.

    • valuenumber (float)

      Steuersatz in Prozent.

    • deletedboolean

      Der Steuersatz wird gelöscht.

    • global_defaultboolean

      Standard-Steuersatz für neue Artikel.

    • datev_tax_keyinteger

      DATEV Steuerschlüssel für Umsatzsteuer (Ausgangsrechnungen). Wird von BuchhaltungsButler und DATEV-Export genutzt. Standardwerte: 0 = Kein Steuerausweis (0%) 2 = Umsatzsteuer 7% (ermäßigt) 3 = Umsatzsteuer 19% (Regelsteuersatz) Für Vorsteuer (Eingangsrechnungen) gibt es eine spiegelbildliche Zuordnung: 0 = Keine Vorsteuer (0%) 5 = Vorsteuer 7% 8 = Vorsteuer 19%

  • cost_centerCostCenter

    Kostenstelle der Kategorie - bei Vereinen die steuerliche Sphäre. Ein Beleg trägt keine eigene Sphäre; über seine Kategorie bekommt er eine. Die EÜR des wirtschaftlichen Geschäftsbetriebs liest sie (billing_euer_commercial_sphere_only), die automatische Buchung setzt sie auf die Buchungszeilen (billing_accounting_cost_center_from_category).

    Felder anzeigen (10)
    • display_namestring
    • idinteger

      Primärschlüssel der Kostenstelle. Interne ID.

    • numberstring

      Nummer der Kostenstelle.

    • spherestring

      Steuerliche Sphäre, null bei rein betriebswirtschaftlicher Gliederung.

    • is_systemboolean

      Die Kostenstelle wird vom System angelegt und kann nicht gelöscht werden.

    • is_activeboolean

      Die Kostenstelle ist aktiv.

    • deletedboolean

      Diese Eigenschaft markiert eine Entität als gelöscht / archiviert

    • namestring

      Name der Einheit.

    • createdstring (date-time)

      Zeitpunkt, zu dem der Datensatz angelegt wurde.

    • updatedstring (date-time)

      Zeitpunkt, zu dem der Datensatz zuletzt aktualisiert wurde.

  • is_vat_deductibleboolean

    Ist Vorsteuerabzug möglich?

  • is_immediate_deductionboolean

    Ist die Kategorie sofort abzugsfähig? (vs. Abschreibung über mehrere Jahre)

  • depreciation_yearsinteger

    Abschreibungsdauer in Jahren (für Anlagevermögen)

  • sort_orderinteger

    Sortierreihenfolge

  • is_activeboolean

    Ist die Kategorie aktiv/sichtbar?

  • colorstring

    Farbe für UI-Darstellung (Hex-Code)

  • iconstring

    Icon-Name für UI-Darstellung

  • is_systemboolean

    Ist dies eine System-Kategorie? (nicht löschbar)

  • deletedboolean

    Diese Eigenschaft markiert eine Entität als gelöscht / archiviert

  • namestring

    Name der Einheit.

  • createdstring (date-time)

    Zeitpunkt, zu dem der Datensatz angelegt wurde.

  • updatedstring (date-time)

    Zeitpunkt, zu dem der Datensatz zuletzt aktualisiert wurde.

Anfrage
curl --request GET \
  --url https://eure-instanz.iw-erp.de/api/invoice/expense_category/42 \
  --header 'x-iw-jwt-token: <TOKEN>'
Antwort 200 application/json
{
  "id": 42,
  "eur_line_name": "Beispiel",
  "color": "#3f5efb",
  "name": "Beispiel",
  "code": "string",
  "eur_line_number": 1,
  "category_type": "string",
  "default_tax": {
    "name": "Beispiel",
    "id": 42,
    "value": 1.5,
    "deleted": true,
    "global_default": true,
    "datev_tax_key": 1
  },
  "cost_center": {
    "display_name": "Beispiel",
    "id": 42,
    "name": "Beispiel",
    "number": "string",
    "sphere": "string",
    "is_system": true,
    "is_active": true,
    "deleted": true,
    "created": "2026-10-15T09:30:00+02:00",
    "updated": "2026-10-15T09:30:00+02:00"
  },
  "is_vat_deductible": true
}

ExpenseCategory aktualisieren

PUT/api/invoice/expense_category/{identifier}

Pfad-Parameter

identifierPflichtstring

Request-Body application/json

  • dataExpenseCategory
    Felder anzeigen (21)
    • idinteger

      Primärschlüssel der Ausgabenkategorie. Interne ID.

    • codestring

      Kurzbezeichnung/Code (z.B. "WAREN", "PERSONAL", "MIETE")

    • eur_line_numberinteger

      Zeile in der Anlage EÜR (z. B. 23 für Wareneinkauf)

    • eur_line_namestring

      Bezeichnung der EÜR-Zeile (z. B. „Waren, Rohstoffe und Hilfsstoffe“)

    • category_typestring

      Typ der Kategorie (expense, income, neutral, asset, private)

    • parentExpenseCategory

      Übergeordnete Kategorie (für Hierarchie)

    • childrenarray<ExpenseCategory>

      Untergeordnete Kategorien

    • default_taxTax

      Standard-Steuersatz für diese Kategorie

    • cost_centerCostCenter

      Kostenstelle der Kategorie - bei Vereinen die steuerliche Sphäre. Ein Beleg trägt keine eigene Sphäre; über seine Kategorie bekommt er eine. Die EÜR des wirtschaftlichen Geschäftsbetriebs liest sie (billing_euer_commercial_sphere_only), die automatische Buchung setzt sie auf die Buchungszeilen (billing_accounting_cost_center_from_category).

    • is_vat_deductibleboolean

      Ist Vorsteuerabzug möglich?

    • is_immediate_deductionboolean

      Ist die Kategorie sofort abzugsfähig? (vs. Abschreibung über mehrere Jahre)

    • depreciation_yearsinteger

      Abschreibungsdauer in Jahren (für Anlagevermögen)

    • sort_orderinteger

      Sortierreihenfolge

    • is_activeboolean

      Ist die Kategorie aktiv/sichtbar?

    • colorstring

      Farbe für UI-Darstellung (Hex-Code)

    • iconstring

      Icon-Name für UI-Darstellung

    • is_systemboolean

      Ist dies eine System-Kategorie? (nicht löschbar)

    • deletedboolean

      Diese Eigenschaft markiert eine Entität als gelöscht / archiviert

    • namestring

      Name der Einheit.

    • createdstring (date-time)

      Zeitpunkt, zu dem der Datensatz angelegt wurde.

    • updatedstring (date-time)

      Zeitpunkt, zu dem der Datensatz zuletzt aktualisiert wurde.

Antworten

200ExpenseCategory aktualisierenExpenseCategory

Felder anzeigen (21)
  • idinteger

    Primärschlüssel der Ausgabenkategorie. Interne ID.

  • codestring

    Kurzbezeichnung/Code (z.B. "WAREN", "PERSONAL", "MIETE")

  • eur_line_numberinteger

    Zeile in der Anlage EÜR (z. B. 23 für Wareneinkauf)

  • eur_line_namestring

    Bezeichnung der EÜR-Zeile (z. B. „Waren, Rohstoffe und Hilfsstoffe“)

  • category_typestring

    Typ der Kategorie (expense, income, neutral, asset, private)

  • parentExpenseCategory

    Übergeordnete Kategorie (für Hierarchie)

  • childrenarray<ExpenseCategory>

    Untergeordnete Kategorien

  • default_taxTax

    Standard-Steuersatz für diese Kategorie

    Felder anzeigen (6)
    • idinteger

      Primärschlüssel des Steuersatzes. Interne ID.

    • namestringPflicht

      Name des Steuersatzes, zum Beispiel 19 Prozent.

    • valuenumber (float)

      Steuersatz in Prozent.

    • deletedboolean

      Der Steuersatz wird gelöscht.

    • global_defaultboolean

      Standard-Steuersatz für neue Artikel.

    • datev_tax_keyinteger

      DATEV Steuerschlüssel für Umsatzsteuer (Ausgangsrechnungen). Wird von BuchhaltungsButler und DATEV-Export genutzt. Standardwerte: 0 = Kein Steuerausweis (0%) 2 = Umsatzsteuer 7% (ermäßigt) 3 = Umsatzsteuer 19% (Regelsteuersatz) Für Vorsteuer (Eingangsrechnungen) gibt es eine spiegelbildliche Zuordnung: 0 = Keine Vorsteuer (0%) 5 = Vorsteuer 7% 8 = Vorsteuer 19%

  • cost_centerCostCenter

    Kostenstelle der Kategorie - bei Vereinen die steuerliche Sphäre. Ein Beleg trägt keine eigene Sphäre; über seine Kategorie bekommt er eine. Die EÜR des wirtschaftlichen Geschäftsbetriebs liest sie (billing_euer_commercial_sphere_only), die automatische Buchung setzt sie auf die Buchungszeilen (billing_accounting_cost_center_from_category).

    Felder anzeigen (10)
    • display_namestring
    • idinteger

      Primärschlüssel der Kostenstelle. Interne ID.

    • numberstring

      Nummer der Kostenstelle.

    • spherestring

      Steuerliche Sphäre, null bei rein betriebswirtschaftlicher Gliederung.

    • is_systemboolean

      Die Kostenstelle wird vom System angelegt und kann nicht gelöscht werden.

    • is_activeboolean

      Die Kostenstelle ist aktiv.

    • deletedboolean

      Diese Eigenschaft markiert eine Entität als gelöscht / archiviert

    • namestring

      Name der Einheit.

    • createdstring (date-time)

      Zeitpunkt, zu dem der Datensatz angelegt wurde.

    • updatedstring (date-time)

      Zeitpunkt, zu dem der Datensatz zuletzt aktualisiert wurde.

  • is_vat_deductibleboolean

    Ist Vorsteuerabzug möglich?

  • is_immediate_deductionboolean

    Ist die Kategorie sofort abzugsfähig? (vs. Abschreibung über mehrere Jahre)

  • depreciation_yearsinteger

    Abschreibungsdauer in Jahren (für Anlagevermögen)

  • sort_orderinteger

    Sortierreihenfolge

  • is_activeboolean

    Ist die Kategorie aktiv/sichtbar?

  • colorstring

    Farbe für UI-Darstellung (Hex-Code)

  • iconstring

    Icon-Name für UI-Darstellung

  • is_systemboolean

    Ist dies eine System-Kategorie? (nicht löschbar)

  • deletedboolean

    Diese Eigenschaft markiert eine Entität als gelöscht / archiviert

  • namestring

    Name der Einheit.

  • createdstring (date-time)

    Zeitpunkt, zu dem der Datensatz angelegt wurde.

  • updatedstring (date-time)

    Zeitpunkt, zu dem der Datensatz zuletzt aktualisiert wurde.

Anfrage
curl --request PUT \
  --url https://eure-instanz.iw-erp.de/api/invoice/expense_category/42 \
  --header 'content-type: application/json' \
  --header 'x-iw-jwt-token: <TOKEN>' \
  --data '
{
  "data": {
    "id": 42,
    "eur_line_name": "Beispiel",
    "color": "#3f5efb",
    "name": "Beispiel",
    "code": "string",
    "eur_line_number": 1
  }
}
'
Antwort 200 application/json
{
  "id": 42,
  "eur_line_name": "Beispiel",
  "color": "#3f5efb",
  "name": "Beispiel",
  "code": "string",
  "eur_line_number": 1,
  "category_type": "string",
  "default_tax": {
    "name": "Beispiel",
    "id": 42,
    "value": 1.5,
    "deleted": true,
    "global_default": true,
    "datev_tax_key": 1
  },
  "cost_center": {
    "display_name": "Beispiel",
    "id": 42,
    "name": "Beispiel",
    "number": "string",
    "sphere": "string",
    "is_system": true,
    "is_active": true,
    "deleted": true,
    "created": "2026-10-15T09:30:00+02:00",
    "updated": "2026-10-15T09:30:00+02:00"
  },
  "is_vat_deductible": true
}

ExpenseCategory aktualisieren

PATCH/api/invoice/expense_category/{identifier}

Pfad-Parameter

identifierPflichtstring

Request-Body application/json

  • dataExpenseCategory
    Felder anzeigen (21)
    • idinteger

      Primärschlüssel der Ausgabenkategorie. Interne ID.

    • codestring

      Kurzbezeichnung/Code (z.B. "WAREN", "PERSONAL", "MIETE")

    • eur_line_numberinteger

      Zeile in der Anlage EÜR (z. B. 23 für Wareneinkauf)

    • eur_line_namestring

      Bezeichnung der EÜR-Zeile (z. B. „Waren, Rohstoffe und Hilfsstoffe“)

    • category_typestring

      Typ der Kategorie (expense, income, neutral, asset, private)

    • parentExpenseCategory

      Übergeordnete Kategorie (für Hierarchie)

    • childrenarray<ExpenseCategory>

      Untergeordnete Kategorien

    • default_taxTax

      Standard-Steuersatz für diese Kategorie

    • cost_centerCostCenter

      Kostenstelle der Kategorie - bei Vereinen die steuerliche Sphäre. Ein Beleg trägt keine eigene Sphäre; über seine Kategorie bekommt er eine. Die EÜR des wirtschaftlichen Geschäftsbetriebs liest sie (billing_euer_commercial_sphere_only), die automatische Buchung setzt sie auf die Buchungszeilen (billing_accounting_cost_center_from_category).

    • is_vat_deductibleboolean

      Ist Vorsteuerabzug möglich?

    • is_immediate_deductionboolean

      Ist die Kategorie sofort abzugsfähig? (vs. Abschreibung über mehrere Jahre)

    • depreciation_yearsinteger

      Abschreibungsdauer in Jahren (für Anlagevermögen)

    • sort_orderinteger

      Sortierreihenfolge

    • is_activeboolean

      Ist die Kategorie aktiv/sichtbar?

    • colorstring

      Farbe für UI-Darstellung (Hex-Code)

    • iconstring

      Icon-Name für UI-Darstellung

    • is_systemboolean

      Ist dies eine System-Kategorie? (nicht löschbar)

    • deletedboolean

      Diese Eigenschaft markiert eine Entität als gelöscht / archiviert

    • namestring

      Name der Einheit.

    • createdstring (date-time)

      Zeitpunkt, zu dem der Datensatz angelegt wurde.

    • updatedstring (date-time)

      Zeitpunkt, zu dem der Datensatz zuletzt aktualisiert wurde.

Antworten

200ExpenseCategory aktualisierenExpenseCategory

Felder anzeigen (21)
  • idinteger

    Primärschlüssel der Ausgabenkategorie. Interne ID.

  • codestring

    Kurzbezeichnung/Code (z.B. "WAREN", "PERSONAL", "MIETE")

  • eur_line_numberinteger

    Zeile in der Anlage EÜR (z. B. 23 für Wareneinkauf)

  • eur_line_namestring

    Bezeichnung der EÜR-Zeile (z. B. „Waren, Rohstoffe und Hilfsstoffe“)

  • category_typestring

    Typ der Kategorie (expense, income, neutral, asset, private)

  • parentExpenseCategory

    Übergeordnete Kategorie (für Hierarchie)

  • childrenarray<ExpenseCategory>

    Untergeordnete Kategorien

  • default_taxTax

    Standard-Steuersatz für diese Kategorie

    Felder anzeigen (6)
    • idinteger

      Primärschlüssel des Steuersatzes. Interne ID.

    • namestringPflicht

      Name des Steuersatzes, zum Beispiel 19 Prozent.

    • valuenumber (float)

      Steuersatz in Prozent.

    • deletedboolean

      Der Steuersatz wird gelöscht.

    • global_defaultboolean

      Standard-Steuersatz für neue Artikel.

    • datev_tax_keyinteger

      DATEV Steuerschlüssel für Umsatzsteuer (Ausgangsrechnungen). Wird von BuchhaltungsButler und DATEV-Export genutzt. Standardwerte: 0 = Kein Steuerausweis (0%) 2 = Umsatzsteuer 7% (ermäßigt) 3 = Umsatzsteuer 19% (Regelsteuersatz) Für Vorsteuer (Eingangsrechnungen) gibt es eine spiegelbildliche Zuordnung: 0 = Keine Vorsteuer (0%) 5 = Vorsteuer 7% 8 = Vorsteuer 19%

  • cost_centerCostCenter

    Kostenstelle der Kategorie - bei Vereinen die steuerliche Sphäre. Ein Beleg trägt keine eigene Sphäre; über seine Kategorie bekommt er eine. Die EÜR des wirtschaftlichen Geschäftsbetriebs liest sie (billing_euer_commercial_sphere_only), die automatische Buchung setzt sie auf die Buchungszeilen (billing_accounting_cost_center_from_category).

    Felder anzeigen (10)
    • display_namestring
    • idinteger

      Primärschlüssel der Kostenstelle. Interne ID.

    • numberstring

      Nummer der Kostenstelle.

    • spherestring

      Steuerliche Sphäre, null bei rein betriebswirtschaftlicher Gliederung.

    • is_systemboolean

      Die Kostenstelle wird vom System angelegt und kann nicht gelöscht werden.

    • is_activeboolean

      Die Kostenstelle ist aktiv.

    • deletedboolean

      Diese Eigenschaft markiert eine Entität als gelöscht / archiviert

    • namestring

      Name der Einheit.

    • createdstring (date-time)

      Zeitpunkt, zu dem der Datensatz angelegt wurde.

    • updatedstring (date-time)

      Zeitpunkt, zu dem der Datensatz zuletzt aktualisiert wurde.

  • is_vat_deductibleboolean

    Ist Vorsteuerabzug möglich?

  • is_immediate_deductionboolean

    Ist die Kategorie sofort abzugsfähig? (vs. Abschreibung über mehrere Jahre)

  • depreciation_yearsinteger

    Abschreibungsdauer in Jahren (für Anlagevermögen)

  • sort_orderinteger

    Sortierreihenfolge

  • is_activeboolean

    Ist die Kategorie aktiv/sichtbar?

  • colorstring

    Farbe für UI-Darstellung (Hex-Code)

  • iconstring

    Icon-Name für UI-Darstellung

  • is_systemboolean

    Ist dies eine System-Kategorie? (nicht löschbar)

  • deletedboolean

    Diese Eigenschaft markiert eine Entität als gelöscht / archiviert

  • namestring

    Name der Einheit.

  • createdstring (date-time)

    Zeitpunkt, zu dem der Datensatz angelegt wurde.

  • updatedstring (date-time)

    Zeitpunkt, zu dem der Datensatz zuletzt aktualisiert wurde.

Anfrage
curl --request PATCH \
  --url https://eure-instanz.iw-erp.de/api/invoice/expense_category/42 \
  --header 'content-type: application/json' \
  --header 'x-iw-jwt-token: <TOKEN>' \
  --data '
{
  "data": {
    "id": 42,
    "eur_line_name": "Beispiel",
    "color": "#3f5efb",
    "name": "Beispiel",
    "code": "string",
    "eur_line_number": 1
  }
}
'
Antwort 200 application/json
{
  "id": 42,
  "eur_line_name": "Beispiel",
  "color": "#3f5efb",
  "name": "Beispiel",
  "code": "string",
  "eur_line_number": 1,
  "category_type": "string",
  "default_tax": {
    "name": "Beispiel",
    "id": 42,
    "value": 1.5,
    "deleted": true,
    "global_default": true,
    "datev_tax_key": 1
  },
  "cost_center": {
    "display_name": "Beispiel",
    "id": 42,
    "name": "Beispiel",
    "number": "string",
    "sphere": "string",
    "is_system": true,
    "is_active": true,
    "deleted": true,
    "created": "2026-10-15T09:30:00+02:00",
    "updated": "2026-10-15T09:30:00+02:00"
  },
  "is_vat_deductible": true
}

Eine ExpenseCategory löschen (Soft Delete)

DELETE/api/invoice/expense_category/{identifier}

Pfad-Parameter

identifierPflichtstring

Antworten

200Eine ExpenseCategory löschenExpenseCategory

Felder anzeigen (21)
  • idinteger

    Primärschlüssel der Ausgabenkategorie. Interne ID.

  • codestring

    Kurzbezeichnung/Code (z.B. "WAREN", "PERSONAL", "MIETE")

  • eur_line_numberinteger

    Zeile in der Anlage EÜR (z. B. 23 für Wareneinkauf)

  • eur_line_namestring

    Bezeichnung der EÜR-Zeile (z. B. „Waren, Rohstoffe und Hilfsstoffe“)

  • category_typestring

    Typ der Kategorie (expense, income, neutral, asset, private)

  • parentExpenseCategory

    Übergeordnete Kategorie (für Hierarchie)

  • childrenarray<ExpenseCategory>

    Untergeordnete Kategorien

  • default_taxTax

    Standard-Steuersatz für diese Kategorie

    Felder anzeigen (6)
    • idinteger

      Primärschlüssel des Steuersatzes. Interne ID.

    • namestringPflicht

      Name des Steuersatzes, zum Beispiel 19 Prozent.

    • valuenumber (float)

      Steuersatz in Prozent.

    • deletedboolean

      Der Steuersatz wird gelöscht.

    • global_defaultboolean

      Standard-Steuersatz für neue Artikel.

    • datev_tax_keyinteger

      DATEV Steuerschlüssel für Umsatzsteuer (Ausgangsrechnungen). Wird von BuchhaltungsButler und DATEV-Export genutzt. Standardwerte: 0 = Kein Steuerausweis (0%) 2 = Umsatzsteuer 7% (ermäßigt) 3 = Umsatzsteuer 19% (Regelsteuersatz) Für Vorsteuer (Eingangsrechnungen) gibt es eine spiegelbildliche Zuordnung: 0 = Keine Vorsteuer (0%) 5 = Vorsteuer 7% 8 = Vorsteuer 19%

  • cost_centerCostCenter

    Kostenstelle der Kategorie - bei Vereinen die steuerliche Sphäre. Ein Beleg trägt keine eigene Sphäre; über seine Kategorie bekommt er eine. Die EÜR des wirtschaftlichen Geschäftsbetriebs liest sie (billing_euer_commercial_sphere_only), die automatische Buchung setzt sie auf die Buchungszeilen (billing_accounting_cost_center_from_category).

    Felder anzeigen (10)
    • display_namestring
    • idinteger

      Primärschlüssel der Kostenstelle. Interne ID.

    • numberstring

      Nummer der Kostenstelle.

    • spherestring

      Steuerliche Sphäre, null bei rein betriebswirtschaftlicher Gliederung.

    • is_systemboolean

      Die Kostenstelle wird vom System angelegt und kann nicht gelöscht werden.

    • is_activeboolean

      Die Kostenstelle ist aktiv.

    • deletedboolean

      Diese Eigenschaft markiert eine Entität als gelöscht / archiviert

    • namestring

      Name der Einheit.

    • createdstring (date-time)

      Zeitpunkt, zu dem der Datensatz angelegt wurde.

    • updatedstring (date-time)

      Zeitpunkt, zu dem der Datensatz zuletzt aktualisiert wurde.

  • is_vat_deductibleboolean

    Ist Vorsteuerabzug möglich?

  • is_immediate_deductionboolean

    Ist die Kategorie sofort abzugsfähig? (vs. Abschreibung über mehrere Jahre)

  • depreciation_yearsinteger

    Abschreibungsdauer in Jahren (für Anlagevermögen)

  • sort_orderinteger

    Sortierreihenfolge

  • is_activeboolean

    Ist die Kategorie aktiv/sichtbar?

  • colorstring

    Farbe für UI-Darstellung (Hex-Code)

  • iconstring

    Icon-Name für UI-Darstellung

  • is_systemboolean

    Ist dies eine System-Kategorie? (nicht löschbar)

  • deletedboolean

    Diese Eigenschaft markiert eine Entität als gelöscht / archiviert

  • namestring

    Name der Einheit.

  • createdstring (date-time)

    Zeitpunkt, zu dem der Datensatz angelegt wurde.

  • updatedstring (date-time)

    Zeitpunkt, zu dem der Datensatz zuletzt aktualisiert wurde.

Anfrage
curl --request DELETE \
  --url https://eure-instanz.iw-erp.de/api/invoice/expense_category/42 \
  --header 'x-iw-jwt-token: <TOKEN>'
Antwort 200 application/json
{
  "id": 42,
  "eur_line_name": "Beispiel",
  "color": "#3f5efb",
  "name": "Beispiel",
  "code": "string",
  "eur_line_number": 1,
  "category_type": "string",
  "default_tax": {
    "name": "Beispiel",
    "id": 42,
    "value": 1.5,
    "deleted": true,
    "global_default": true,
    "datev_tax_key": 1
  },
  "cost_center": {
    "display_name": "Beispiel",
    "id": 42,
    "name": "Beispiel",
    "number": "string",
    "sphere": "string",
    "is_system": true,
    "is_active": true,
    "deleted": true,
    "created": "2026-10-15T09:30:00+02:00",
    "updated": "2026-10-15T09:30:00+02:00"
  },
  "is_vat_deductible": true
}