Zum Inhalt springen
Developer

AccountingType

Buchhaltung4 EndpunkteBilling / AccountingType

Liefert eine Liste aller AccountingType-Objekte.

GET/api/invoice/accountingtypes

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 AccountingType-Objekte.array<AccountingType>

Felder anzeigen (6)
  • idinteger

    Primärschlüssel des Buchungstyps. Interne ID.

  • namestringPflicht

    Name der Buchungsart, zum Beispiel Kursgebühr.

  • cancelled_namestring

    Name, der verwendet wird, wenn eine Rechnung dieses Typs storniert wird.

  • typestringPflicht

    Art des Buchungstyps, zum Beispiel Rechnung oder Gutschrift.

  • deletedboolean

    Die Buchungsart wird gelöscht.

  • default_expense_categoryExpenseCategory10

    Standard-EÜR-Kategorie für diesen Rechnungstyp (für Einnahmen-Mapping)

    Felder anzeigen (19)
    • 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)

    • 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.

Anfrage
curl --request GET \
  --url https://eure-instanz.iw-erp.de/api/invoice/accountingtypes \
  --header 'x-iw-jwt-token: <TOKEN>'
Antwort 200 application/json
[
  {
    "name": "Beispiel",
    "type": "string",
    "id": 42,
    "cancelled_name": "Beispiel",
    "deleted": true,
    "default_expense_category": {
      "id": 42,
      "eur_line_name": "Beispiel",
      "color": "#3f5efb",
      "name": "Beispiel",
      "code": "string",
      "eur_line_number": 1,
      "category_type": "string",
      "is_vat_deductible": true,
      "is_immediate_deduction": true,
      "depreciation_years": 1
    }
  }
]

AccountingType neu anlegen

POST/api/invoice/accountingtypes

Request-Body application/json

  • dataAccountingType
    Felder anzeigen (6)
    • idinteger

      Primärschlüssel des Buchungstyps. Interne ID.

    • namestringPflicht

      Name der Buchungsart, zum Beispiel Kursgebühr.

    • cancelled_namestring

      Name, der verwendet wird, wenn eine Rechnung dieses Typs storniert wird.

    • typestringPflicht

      Art des Buchungstyps, zum Beispiel Rechnung oder Gutschrift.

    • deletedboolean

      Die Buchungsart wird gelöscht.

    • default_expense_categoryExpenseCategory10

      Standard-EÜR-Kategorie für diesen Rechnungstyp (für Einnahmen-Mapping)

Antworten

200AccountingType neu anlegenAccountingType

Felder anzeigen (6)
  • idinteger

    Primärschlüssel des Buchungstyps. Interne ID.

  • namestringPflicht

    Name der Buchungsart, zum Beispiel Kursgebühr.

  • cancelled_namestring

    Name, der verwendet wird, wenn eine Rechnung dieses Typs storniert wird.

  • typestringPflicht

    Art des Buchungstyps, zum Beispiel Rechnung oder Gutschrift.

  • deletedboolean

    Die Buchungsart wird gelöscht.

  • default_expense_categoryExpenseCategory10

    Standard-EÜR-Kategorie für diesen Rechnungstyp (für Einnahmen-Mapping)

    Felder anzeigen (19)
    • 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)

    • 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.

Anfrage
curl --request POST \
  --url https://eure-instanz.iw-erp.de/api/invoice/accountingtypes \
  --header 'content-type: application/json' \
  --header 'x-iw-jwt-token: <TOKEN>' \
  --data '
{
  "data": {
    "name": "Beispiel",
    "type": "string",
    "id": 42,
    "cancelled_name": "Beispiel",
    "deleted": true,
    "default_expense_category": {
      "id": 42,
      "eur_line_name": "Beispiel",
      "color": "#3f5efb",
      "name": "Beispiel",
      "code": "string",
      "eur_line_number": 1
    }
  }
}
'
Antwort 200 application/json
{
  "name": "Beispiel",
  "type": "string",
  "id": 42,
  "cancelled_name": "Beispiel",
  "deleted": true,
  "default_expense_category": {
    "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
  }
}

Einzelnen AccountingType abrufen

GET/api/invoice/accountingtypes/{identifier}

Pfad-Parameter

identifierPflichtstring

Antworten

200Einzelnen AccountingType abrufenAccountingType

Felder anzeigen (6)
  • idinteger

    Primärschlüssel des Buchungstyps. Interne ID.

  • namestringPflicht

    Name der Buchungsart, zum Beispiel Kursgebühr.

  • cancelled_namestring

    Name, der verwendet wird, wenn eine Rechnung dieses Typs storniert wird.

  • typestringPflicht

    Art des Buchungstyps, zum Beispiel Rechnung oder Gutschrift.

  • deletedboolean

    Die Buchungsart wird gelöscht.

  • default_expense_categoryExpenseCategory10

    Standard-EÜR-Kategorie für diesen Rechnungstyp (für Einnahmen-Mapping)

    Felder anzeigen (19)
    • 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)

    • 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.

Anfrage
curl --request GET \
  --url https://eure-instanz.iw-erp.de/api/invoice/accountingtypes/42 \
  --header 'x-iw-jwt-token: <TOKEN>'
Antwort 200 application/json
{
  "name": "Beispiel",
  "type": "string",
  "id": 42,
  "cancelled_name": "Beispiel",
  "deleted": true,
  "default_expense_category": {
    "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
  }
}

AccountingType aktualisieren

PUT/api/invoice/accountingtypes/{identifier}

Pfad-Parameter

identifierPflichtstring

Request-Body application/json

  • dataAccountingType
    Felder anzeigen (6)
    • idinteger

      Primärschlüssel des Buchungstyps. Interne ID.

    • namestringPflicht

      Name der Buchungsart, zum Beispiel Kursgebühr.

    • cancelled_namestring

      Name, der verwendet wird, wenn eine Rechnung dieses Typs storniert wird.

    • typestringPflicht

      Art des Buchungstyps, zum Beispiel Rechnung oder Gutschrift.

    • deletedboolean

      Die Buchungsart wird gelöscht.

    • default_expense_categoryExpenseCategory10

      Standard-EÜR-Kategorie für diesen Rechnungstyp (für Einnahmen-Mapping)

Antworten

200AccountingType aktualisierenAccountingType

Felder anzeigen (6)
  • idinteger

    Primärschlüssel des Buchungstyps. Interne ID.

  • namestringPflicht

    Name der Buchungsart, zum Beispiel Kursgebühr.

  • cancelled_namestring

    Name, der verwendet wird, wenn eine Rechnung dieses Typs storniert wird.

  • typestringPflicht

    Art des Buchungstyps, zum Beispiel Rechnung oder Gutschrift.

  • deletedboolean

    Die Buchungsart wird gelöscht.

  • default_expense_categoryExpenseCategory10

    Standard-EÜR-Kategorie für diesen Rechnungstyp (für Einnahmen-Mapping)

    Felder anzeigen (19)
    • 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)

    • 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.

Anfrage
curl --request PUT \
  --url https://eure-instanz.iw-erp.de/api/invoice/accountingtypes/42 \
  --header 'content-type: application/json' \
  --header 'x-iw-jwt-token: <TOKEN>' \
  --data '
{
  "data": {
    "name": "Beispiel",
    "type": "string",
    "id": 42,
    "cancelled_name": "Beispiel",
    "deleted": true,
    "default_expense_category": {
      "id": 42,
      "eur_line_name": "Beispiel",
      "color": "#3f5efb",
      "name": "Beispiel",
      "code": "string",
      "eur_line_number": 1
    }
  }
}
'
Antwort 200 application/json
{
  "name": "Beispiel",
  "type": "string",
  "id": 42,
  "cancelled_name": "Beispiel",
  "deleted": true,
  "default_expense_category": {
    "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
  }
}