Zum Inhalt springen
Developer

Anlagegüter

Buchhaltung10 EndpunkteBilling / Anlagegüter

Die Anlagegüter.

GET/api/invoice/fixed_asset

Query-Parameter

idinteger
deletedbooleanDiese Eigenschaft markiert eine Entität als gelöscht / archiviert | Benötigtes Zugriffsrecht: SCOPE | Standardwert: false
namestring
inventoryNumberstringInventarnummer - frei vergeben, aber für die Inventur unverzichtbar. | Benötigt Zugriffs-Tag: SCOPE
acquisitionDatestringTag der Anschaffung oder Herstellung. Bestimmt den Beginn der Abschreibung und den Zeitanteil im ersten Jahr: abgeschrieben wird ab dem Anschaffungsmonat, angefangene Monate zählen voll (§ 7 Abs. 1 Satz 4 EStG).
acquisitionCostnumberAnschaffungs- oder Herstellungskosten. Netto, soweit die Vorsteuer abziehbar ist. Ist sie das nicht – im ideellen Bereich eines Vereins etwa –, gehört sie zu den Anschaffungskosten und erhöht damit die Bemessungsgrundlage.
usefulLifeMonthsstringBetriebsgewöhnliche Nutzungsdauer in Monaten. In Monaten statt in Jahren, weil die Abschreibung monatsgenau läuft und es Nutzungsdauern unter einem Jahr gibt.
depreciationMethodstring
ledgerAccountstringAktivkonto, auf dem das Gut steht – z. B. SKR04 0630.
depreciationAccountstringAufwandskonto der Abschreibung – z. B. SKR04 6220.
costCenterstringDie steuerliche Sphäre, der das Gut dient. | Erfordert Zugriffs-Tag: SCOPE
expenseCategorystringDie EÜR-Kategorie der Abschreibung. Dieselbe Brücke wie am Sachkonto: wer die EÜR führt, bekommt seine Zeile in der Anlage EÜR, ohne dass es einen Kontenrahmen bräuchte. | Erfordert Zugriffs-Tag: SCOPE
incomingInvoicestringDer Beleg, aus dem das Gut entstanden ist. | Erfordert Zugriffs-Tag: SCOPE
disposalDatestringTag des Abgangs - Verkauf, Verschrottung, Entnahme. | Benötigtes Zugriffsrecht: SCOPE
disposalTaxRatestringUmsatzsteuersatz auf den Verkaufserlös, in Prozent. Der Verkauf eines Anlageguts ist ein steuerpflichtiger Umsatz wie jeder andere - vorher wurde der Erlös netto ohne Steuer gebucht, und die Umsatzsteuer fehlte in Bilanz und Voranmeldung. Bewusst ohne Vorgabewert: ob Steuer anfällt, hängt am Vorgang. Eine Verschrottung, eine Entnahme und der Verkauf aus dem ideellen Bereich eines Vereins sind steuerfrei; der gewerbliche Verkauf ist es nicht. Ein geratener Satz wäre in der Hälfte der Fälle falsch. | Benötigt Zugriffsrecht: SCOPE
isMovablebooleanBewegliches Wirtschaftsgut? Die degressive AfA des § 7 Abs. 2 EStG gilt nur für bewegliche Wirtschaftsgüter des Anlagevermögens – ein Gebäude oder eine Software degressiv abzuschreiben ist unzulässig, und ohne dieses Merkmal konnte es niemand verhindern. Standardwert true: Betriebs- und Geschäftsausstattung ist in diesem System der Regelfall.
createdstring
updatedstring
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

200Anlagegüterarray<FixedAsset>

Felder anzeigen (20)
  • idinteger

    Primärschlüssel des Anlageguts. Interne ID.

  • inventory_numberstring

    Inventarnummer - frei vergeben, aber für die Inventur unverzichtbar.

  • acquisition_datestring (date-time)

    Tag der Anschaffung oder Herstellung. Bestimmt den Beginn der Abschreibung und den Zeitanteil im ersten Jahr: abgeschrieben wird ab dem Anschaffungsmonat, angefangene Monate zählen voll (§ 7 Abs. 1 Satz 4 EStG).

  • acquisition_costnumber (float)

    Anschaffungs- oder Herstellungskosten. Netto, soweit die Vorsteuer abziehbar ist. Ist sie das nicht - im ideellen Bereich eines Vereins etwa -, gehört sie zu den Anschaffungskosten und erhöht damit die Bemessungsgrundlage.

  • useful_life_monthsinteger

    Betriebsgewöhnliche Nutzungsdauer in Monaten. In Monaten statt in Jahren, weil die Abschreibung monatsgenau läuft und es Nutzungsdauern unter einem Jahr gibt.

  • depreciation_methodstring

    Abschreibungsmethode, zum Beispiel linear.

  • ledger_accountLedgerAccount

    Aktivkonto, auf dem das Gut steht – z. B. SKR04 0630.

    Felder anzeigen (15)
    • display_namestring
    • idinteger

      Primärschlüssel des Hauptbuchkontos. Interne ID.

    • numberstring

      Kontonummer im Kontenrahmen, z.B. "1200" (SKR03 Bank) oder "40000" (SKR42). Als String geführt, weil SKR42 fünfstellig ist und führende Nullen bedeutungstragend sein können.

    • chart_of_accountsstring

      Kontenrahmen, zu dem das Konto gehört, zum Beispiel SKR03.

    • account_typestring

      Art des Kontos, zum Beispiel Aktiv oder Erlös.

    • default_taxTax

      Steuersatz, der beim Buchen auf dieses Konto vorgeschlagen wird. Bei Erlös- und Aufwandskonten ist der Satz durch die Kontonummer vorgegeben (etwa „Erlöse 19% USt“), deshalb hängt er am Konto und nicht an der einzelnen Buchung.

    • tax_accountLedgerAccount

      Gegenkonto für die Steuer, die beim Buchen auf dieses Konto entsteht. Bei Erlöskonten das Umsatzsteuerkonto, bei Aufwandskonten das Vorsteuerkonto. Damit lässt sich aus einem Bruttobetrag automatisch der dreizeilige Buchungssatz erzeugen.

    • expense_categoryExpenseCategory10

      Brücke zur EÜR: auf welcher Zeile der Anlage EÜR dieses Konto zählt. Erlaubt es, beide Gewinnermittlungsarten aus denselben Belegen zu bedienen - etwa im Wechseljahr oder wenn ein Verein den wirtschaftlichen Geschäftsbetrieb per EÜR und den Rest bilanziell führt.

    • cost_center_requiredboolean

      Ob auf diesem Konto eine Kostenstelle angegeben werden muss. Der SKR42 bildet die vier steuerlichen Sphären eines gemeinnützigen Vereins über Kostenstellen ab, nicht über getrennte Konten. Für die Erfolgskonten ist die Angabe dort deshalb Pflicht.

    • is_systemboolean

      Vom Kontenrahmen-Initialisierer angelegt. Nummer und Art sind dann durch den Rahmen vorgegeben und sollten nicht geändert werden.

    • is_activeboolean

      Konten lassen sich stilllegen, statt sie zu löschen - bebuchte Konten dürfen nicht verschwinden.

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

  • depreciation_accountLedgerAccount

    Aufwandskonto der Abschreibung – z. B. SKR04 6220.

    Felder anzeigen (15)
    • display_namestring
    • idinteger

      Primärschlüssel des Hauptbuchkontos. Interne ID.

    • numberstring

      Kontonummer im Kontenrahmen, z.B. "1200" (SKR03 Bank) oder "40000" (SKR42). Als String geführt, weil SKR42 fünfstellig ist und führende Nullen bedeutungstragend sein können.

    • chart_of_accountsstring

      Kontenrahmen, zu dem das Konto gehört, zum Beispiel SKR03.

    • account_typestring

      Art des Kontos, zum Beispiel Aktiv oder Erlös.

    • default_taxTax

      Steuersatz, der beim Buchen auf dieses Konto vorgeschlagen wird. Bei Erlös- und Aufwandskonten ist der Satz durch die Kontonummer vorgegeben (etwa „Erlöse 19% USt“), deshalb hängt er am Konto und nicht an der einzelnen Buchung.

    • tax_accountLedgerAccount

      Gegenkonto für die Steuer, die beim Buchen auf dieses Konto entsteht. Bei Erlöskonten das Umsatzsteuerkonto, bei Aufwandskonten das Vorsteuerkonto. Damit lässt sich aus einem Bruttobetrag automatisch der dreizeilige Buchungssatz erzeugen.

    • expense_categoryExpenseCategory10

      Brücke zur EÜR: auf welcher Zeile der Anlage EÜR dieses Konto zählt. Erlaubt es, beide Gewinnermittlungsarten aus denselben Belegen zu bedienen - etwa im Wechseljahr oder wenn ein Verein den wirtschaftlichen Geschäftsbetrieb per EÜR und den Rest bilanziell führt.

    • cost_center_requiredboolean

      Ob auf diesem Konto eine Kostenstelle angegeben werden muss. Der SKR42 bildet die vier steuerlichen Sphären eines gemeinnützigen Vereins über Kostenstellen ab, nicht über getrennte Konten. Für die Erfolgskonten ist die Angabe dort deshalb Pflicht.

    • is_systemboolean

      Vom Kontenrahmen-Initialisierer angelegt. Nummer und Art sind dann durch den Rahmen vorgegeben und sollten nicht geändert werden.

    • is_activeboolean

      Konten lassen sich stilllegen, statt sie zu löschen - bebuchte Konten dürfen nicht verschwinden.

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

  • cost_centerCostCenter

    Die steuerliche Sphäre, der das Gut dient.

    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.

  • expense_categoryExpenseCategory10

    Die EÜR-Kategorie der Abschreibung. Dieselbe Brücke wie am Sachkonto: wer die EÜR führt, bekommt seine Zeile in der Anlage EÜR, ohne dass es einen Kontenrahmen bräuchte.

    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.

  • incoming_invoiceIncomingInvoice3

    Der Beleg, aus dem das Gut entstanden ist.

    Felder anzeigen (43)
    • idinteger

      Primärschlüssel des Rechnungsdokuments. Interne ID.

    • tokenstring

      Token, das das Dokument für den öffentlichen Zugriff identifiziert.

    • numberinteger

      Laufende Belegnummer.

    • manual_number_prefixstring

      Präfix einer manuell eingegebenen Dokumentnummer.

    • manual_numberinteger

      Manuell eingegebene Dokumentnummer.

    • number_stringstring

      Belegnummer, wie sie den Benutzern angezeigt wird.

    • generation_datestring (date-time)

      Datum, an dem das Dokument erstellt wurde.

    • number_datestring (date-time)

      Datum, das für die Belegnummer verwendet wird.

    • messagestring

      Auf dem Dokument gedruckte Nachricht.

    • currencystring

      Währung des Dokuments.

    • namestring

      Name des Dokuments.

    • due_datestring (date-time)

      Fälligkeitsdatum des Dokuments.

    • netto_valuenumber (float)

      Nettosumme des Dokuments.

    • brutto_valuenumber (float)

      Bruttogesamtbetrag des Dokuments.

    • tax_valuenumber (float)

      Gesamter Steuerbetrag des Dokuments.

    • taxTaxPflicht

      Auf das Dokument angewendeter Steuersatz.

    • linked_number_titlestring

      Titel der verknüpften Dokumentnummer.

    • linked_numberstring

      Nummer des verknüpften Belegs.

    • statusstring

      Status des Dokuments.

    • previous_statusstring

      Status vor der letzten Änderung.

    • status_updatedstring (date-time)

      Zeitpunkt, zu dem der Status zuletzt geändert wurde.

    • archivedboolean

      Ob das Dokument archiviert ist.

    • last_pdf_exportstring (date-time)

      Zeitpunkt, zu dem das PDF zuletzt exportiert wurde.

    • last_status_exportstring

      Status beim letzten Export.

    • search_stringstring

      Text, unter dem die Entität gesucht werden kann.

    • external_invoice_numberstring

      Externe Rechnungsnummer des Lieferanten

    • received_datestring (date-time)

      Eingangsdatum (wann wurde die Rechnung empfangen)

    • payment_datestring (date-time)

      Zahlungsdatum

    • service_date_startstring (date-time)

      Leistungszeitraum Start

    • service_date_endstring (date-time)

      Leistungszeitraum Ende

    • vat_categorystring

      Der umsatzsteuerliche Sachverhalt. Auf der Eingangsseite entscheidet er darüber, ob die Vorsteuer unter Kennzahl 66 steht (Rechnung eines anderen Unternehmers), unter 61 (innergemeinschaftlicher Erwerb), unter 62 (Einfuhrumsatzsteuer) oder unter 67 (§ 13b UStG). Beim Erwerb und bei § 13b kommt eine zweite Zeile hinzu: Die Steuer schulden wir selbst, obwohl sie uns niemand berechnet hat, und sie steht deshalb zugleich als Umsatzsteuer im Vordruck. Wer nur eine der beiden bucht, zahlt zu viel oder zu wenig. Ohne Angabe gilt der Regelfall.

    • vat_self_assessed_ratenumber (float)

      Der Steuersatz, mit dem die selbst geschuldete Steuer zu rechnen ist. Beim innergemeinschaftlichen Erwerb und bei § 13b UStG berechnet der Lieferant keine Steuer – die Rechnung ist netto, und die Steuer schulden wir. Womit sie zu rechnen ist, steht deshalb auf keinem Beleg: es ist der Satz, der im Inland auf diese Leistung anzuwenden wäre. Ohne Angabe rechnet die Voranmeldung mit dem Regelsatz und sagt in den Hinweisen, bei wie vielen Belegen sie das getan hat. Stillschweigend zu raten wäre in einer Steueranmeldung das Falsche.

    • import_vat_amountstring

      Die Einfuhrumsatzsteuer aus dem Zollbescheid. Sie steht NICHT auf der Rechnung des Lieferanten - die ist bei einer Einfuhr ohne deutsche Steuer. Entrichtet wird sie an den Zoll, und nur der entrichtete Betrag ist als Vorsteuer abziehbar (§ 15 Abs. 1 Satz 1 Nr. 2 UStG, Kennzahl 62 der Voranmeldung). Den Steuerbetrag der Lieferantenrechnung dafür zu nehmen war schlicht der falsche Beleg.

    • paid_valuenumber (float)

      Bereits bezahlter Betrag (für Teilzahlungen)

    • sellerIncomingInvoiceSeller

      Verkäufer/Lieferant Informationen (Snapshot)

    • expense_categoryExpenseCategory10

      Hauptkategorie für EÜR

    • document_pathstring

      Pfad zur gespeicherten Rechnungsdatei (PDF/Bild)

    • document_filenamestring

      Original Dateiname

    • document_mime_typestring

      MIME-Typ des Dokuments

    • notesstring

      Notizen/Bemerkungen

    • is_deductibleboolean

      Ist die Rechnung für den Vorsteuerabzug relevant?

    • is_approvedboolean

      Wurde die Rechnung geprüft/freigegeben?

    • approved_atstring (date-time)

      Zeitpunkt, zu dem die Eingangsrechnung genehmigt wurde.

  • disposal_datestring (date-time)

    Tag des Abgangs - Verkauf, Verschrottung, Entnahme.

  • disposal_proceedsnumber (float)

    Verkaufserlös beim Abgang, netto.

  • disposal_tax_ratenumber (float)

    Umsatzsteuersatz auf den Verkaufserlös, in Prozent. Der Verkauf eines Anlageguts ist ein steuerpflichtiger Umsatz wie jeder andere - vorher wurde der Erlös netto ohne Steuer gebucht, und die Umsatzsteuer fehlte in Bilanz und Voranmeldung. Bewusst ohne Vorgabewert: ob Steuer anfällt, hängt am Vorgang. Eine Verschrottung, eine Entnahme und der Verkauf aus dem ideellen Bereich eines Vereins sind steuerfrei; der gewerbliche Verkauf ist es nicht. Ein geratener Satz wäre in der Hälfte der Fälle falsch.

  • is_movableboolean

    Bewegliches Wirtschaftsgut? Die degressive AfA des § 7 Abs. 2 EStG gilt nur für bewegliche Wirtschaftsgüter des Anlagevermögens - ein Gebäude oder eine Software degressiv abzuschreiben ist unzulässig, und ohne dieses Merkmal konnte es niemand verhindern. Vorgabe true: Betriebs- und Geschäftsausstattung ist in diesem System der Regelfall.

  • disposal_reasonstring

    Grund für die Ausbuchung des Anlageguts.

  • 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/fixed_asset \
  --header 'x-iw-jwt-token: <TOKEN>'
Antwort 200 application/json
[
  {
    "id": 42,
    "name": "Beispiel",
    "inventory_number": "string",
    "acquisition_date": "2026-10-15T09:30:00+02:00",
    "acquisition_cost": 1.5,
    "useful_life_months": 1,
    "depreciation_method": "string",
    "ledger_account": {
      "display_name": "Beispiel",
      "id": 42,
      "name": "Beispiel",
      "number": "string",
      "chart_of_accounts": "string",
      "account_type": "string",
      "cost_center_required": true,
      "is_system": true,
      "is_active": true,
      "deleted": true
    },
    "depreciation_account": {
      "display_name": "Beispiel",
      "id": 42,
      "name": "Beispiel",
      "number": "string",
      "chart_of_accounts": "string",
      "account_type": "string",
      "cost_center_required": true,
      "is_system": true,
      "is_active": true,
      "deleted": true
    },
    "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"
    }
  }
]

Legt ein Anlagegut ohne Beleg an.

POST/api/invoice/fixed_asset

Bisher entstand ein Anlagegut nur aus einer Eingangsrechnung. Das deckt den Regelfall ab und lässt zwei Fälle offen, die es häufig gibt: den Altbestand beim Umstieg auf diese Anwendung, und die Einlage aus dem Privatvermögen. Beide haben keine Eingangsrechnung im System und waren damit nicht erfassbar – in der Bilanz fehlten sie dann vollständig.

Gebucht wird dabei nichts: beim Altbestand ist der Zugang längst in der Eröffnungsbilanz enthalten, und ihn ein zweites Mal zu buchen zeigte das Anlagevermögen doppelt. Der Abschreibungsplan entsteht trotzdem sofort – er ist der Grund, warum das Gut erfasst wird.

Request-Body application/json

  • namestring
  • acquisition_datestring (date)
  • acquisition_costnumber
  • useful_life_monthsinteger
  • depreciation_methodstring
  • inventory_numberstring
  • expense_categoryinteger
  • cost_centerinteger
  • ledger_accountinteger
  • depreciation_accountinteger

Antworten

201Das angelegte Anlagegut samt Abschreibungsplan

Anfrage
curl --request POST \
  --url https://eure-instanz.iw-erp.de/api/invoice/fixed_asset \
  --header 'content-type: application/json' \
  --header 'x-iw-jwt-token: <TOKEN>' \
  --data '
{
  "name": "Notebook",
  "acquisition_date": "2026-03-01",
  "acquisition_cost": 1200,
  "useful_life_months": 36,
  "depreciation_method": "linear",
  "inventory_number": "AV-2026-004"
}
'

Nutzungsdauern und Wertgrenzen als Vorschlag für die Oberfläche.

GET/api/invoice/fixed_asset/suggestions

Antworten

200Nutzungsdauern aus den AfA-Tabellen und die Wertgrenzen des § 6 EStG

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

Der Anlagenspiegel eines Jahres.

GET/api/invoice/fixed_asset/schedule

Query-Parameter

yearstringJahr, Vorgabe das laufende

Antworten

200Anlagenspiegel mit Zu- und Abgängen, Abschreibung und Restbuchwert

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

Legt ein Anlagegut aus einer Eingangsrechnung an.

POST/api/invoice/fixed_asset/from_invoice

Der Weg, den die Verbuchen-Liste anbietet: statt die Rechnung als Aufwand zu buchen, wird sie aktiviert.

Request-Body application/json

  • incoming_invoice_idinteger
  • namestring
  • acquisition_costnumber
  • useful_life_monthsinteger
  • depreciation_methodstring
  • cost_centerinteger

    Ohne Angabe die Kostenstelle der Rechnungskategorie

Antworten

200Das angelegte Anlagegut samt Abschreibungsplan

Anfrage
curl --request POST \
  --url https://eure-instanz.iw-erp.de/api/invoice/fixed_asset/from_invoice \
  --header 'content-type: application/json' \
  --header 'x-iw-jwt-token: <TOKEN>' \
  --data '
{
  "name": "Beispiel",
  "incoming_invoice_id": 42,
  "acquisition_cost": 1.5,
  "useful_life_months": 1,
  "depreciation_method": "string",
  "cost_center": 1
}
'

Bucht die geplanten Abschreibungen eines Jahres.

POST/api/invoice/fixed_asset/depreciation_run

Request-Body application/json

  • yearinteger

Antworten

200Wie viele Abschreibungen gebucht wurden und was fehlschlug

Anfrage
curl --request POST \
  --url https://eure-instanz.iw-erp.de/api/invoice/fixed_asset/depreciation_run \
  --header 'content-type: application/json' \
  --header 'x-iw-jwt-token: <TOKEN>' \
  --data '{"year":2026}'

Berechnet den Abschreibungsplan neu.

POST/api/invoice/fixed_asset/{identifier}/rebuild_schedule

Nach einer Korrektur der Nutzungsdauer oder der Anschaffungskosten. Gebuchte Jahre stehen dem im Weg - die müssten erst storniert werden.

Pfad-Parameter

identifierPflichtstring

Antworten

200Das Anlagegut mit neu berechnetem Plan

Anfrage
curl --request POST \
  --url https://eure-instanz.iw-erp.de/api/invoice/fixed_asset/42/rebuild_schedule \
  --header 'x-iw-jwt-token: <TOKEN>'

Bucht den Zugang.

POST/api/invoice/fixed_asset/{identifier}/post_acquisition

Pfad-Parameter

identifierPflichtstring

Antworten

200Der erzeugte Buchungssatz, oder null bei ausgeschalteter Automatik

Anfrage
curl --request POST \
  --url https://eure-instanz.iw-erp.de/api/invoice/fixed_asset/42/post_acquisition \
  --header 'x-iw-jwt-token: <TOKEN>'

Ändert ein Anlagegut.

PUT/api/invoice/fixed_asset/{identifier}

Anschaffungskosten, Nutzungsdauer, Methode und Datum bestimmen den Abschreibungsplan; wird eines davon geändert, wird er neu berechnet. Bereits gebuchte Jahre stehen dem im Weg und müssten zuerst storniert werden.

Pfad-Parameter

identifierPflichtstring

Request-Body application/json

  • idinteger

    Primärschlüssel des Anlageguts. Interne ID.

  • inventory_numberstring

    Inventarnummer - frei vergeben, aber für die Inventur unverzichtbar.

  • acquisition_datestring (date-time)

    Tag der Anschaffung oder Herstellung. Bestimmt den Beginn der Abschreibung und den Zeitanteil im ersten Jahr: abgeschrieben wird ab dem Anschaffungsmonat, angefangene Monate zählen voll (§ 7 Abs. 1 Satz 4 EStG).

  • acquisition_costnumber (float)

    Anschaffungs- oder Herstellungskosten. Netto, soweit die Vorsteuer abziehbar ist. Ist sie das nicht - im ideellen Bereich eines Vereins etwa -, gehört sie zu den Anschaffungskosten und erhöht damit die Bemessungsgrundlage.

  • useful_life_monthsinteger

    Betriebsgewöhnliche Nutzungsdauer in Monaten. In Monaten statt in Jahren, weil die Abschreibung monatsgenau läuft und es Nutzungsdauern unter einem Jahr gibt.

  • depreciation_methodstring

    Abschreibungsmethode, zum Beispiel linear.

  • ledger_accountLedgerAccount

    Aktivkonto, auf dem das Gut steht – z. B. SKR04 0630.

    Felder anzeigen (15)
    • display_namestring
    • idinteger

      Primärschlüssel des Hauptbuchkontos. Interne ID.

    • numberstring

      Kontonummer im Kontenrahmen, z.B. "1200" (SKR03 Bank) oder "40000" (SKR42). Als String geführt, weil SKR42 fünfstellig ist und führende Nullen bedeutungstragend sein können.

    • chart_of_accountsstring

      Kontenrahmen, zu dem das Konto gehört, zum Beispiel SKR03.

    • account_typestring

      Art des Kontos, zum Beispiel Aktiv oder Erlös.

    • default_taxTax

      Steuersatz, der beim Buchen auf dieses Konto vorgeschlagen wird. Bei Erlös- und Aufwandskonten ist der Satz durch die Kontonummer vorgegeben (etwa „Erlöse 19% USt“), deshalb hängt er am Konto und nicht an der einzelnen Buchung.

    • tax_accountLedgerAccount

      Gegenkonto für die Steuer, die beim Buchen auf dieses Konto entsteht. Bei Erlöskonten das Umsatzsteuerkonto, bei Aufwandskonten das Vorsteuerkonto. Damit lässt sich aus einem Bruttobetrag automatisch der dreizeilige Buchungssatz erzeugen.

    • expense_categoryExpenseCategory10

      Brücke zur EÜR: auf welcher Zeile der Anlage EÜR dieses Konto zählt. Erlaubt es, beide Gewinnermittlungsarten aus denselben Belegen zu bedienen - etwa im Wechseljahr oder wenn ein Verein den wirtschaftlichen Geschäftsbetrieb per EÜR und den Rest bilanziell führt.

    • cost_center_requiredboolean

      Ob auf diesem Konto eine Kostenstelle angegeben werden muss. Der SKR42 bildet die vier steuerlichen Sphären eines gemeinnützigen Vereins über Kostenstellen ab, nicht über getrennte Konten. Für die Erfolgskonten ist die Angabe dort deshalb Pflicht.

    • is_systemboolean

      Vom Kontenrahmen-Initialisierer angelegt. Nummer und Art sind dann durch den Rahmen vorgegeben und sollten nicht geändert werden.

    • is_activeboolean

      Konten lassen sich stilllegen, statt sie zu löschen - bebuchte Konten dürfen nicht verschwinden.

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

  • depreciation_accountLedgerAccount

    Aufwandskonto der Abschreibung – z. B. SKR04 6220.

    Felder anzeigen (15)
    • display_namestring
    • idinteger

      Primärschlüssel des Hauptbuchkontos. Interne ID.

    • numberstring

      Kontonummer im Kontenrahmen, z.B. "1200" (SKR03 Bank) oder "40000" (SKR42). Als String geführt, weil SKR42 fünfstellig ist und führende Nullen bedeutungstragend sein können.

    • chart_of_accountsstring

      Kontenrahmen, zu dem das Konto gehört, zum Beispiel SKR03.

    • account_typestring

      Art des Kontos, zum Beispiel Aktiv oder Erlös.

    • default_taxTax

      Steuersatz, der beim Buchen auf dieses Konto vorgeschlagen wird. Bei Erlös- und Aufwandskonten ist der Satz durch die Kontonummer vorgegeben (etwa „Erlöse 19% USt“), deshalb hängt er am Konto und nicht an der einzelnen Buchung.

    • tax_accountLedgerAccount

      Gegenkonto für die Steuer, die beim Buchen auf dieses Konto entsteht. Bei Erlöskonten das Umsatzsteuerkonto, bei Aufwandskonten das Vorsteuerkonto. Damit lässt sich aus einem Bruttobetrag automatisch der dreizeilige Buchungssatz erzeugen.

    • expense_categoryExpenseCategory10

      Brücke zur EÜR: auf welcher Zeile der Anlage EÜR dieses Konto zählt. Erlaubt es, beide Gewinnermittlungsarten aus denselben Belegen zu bedienen - etwa im Wechseljahr oder wenn ein Verein den wirtschaftlichen Geschäftsbetrieb per EÜR und den Rest bilanziell führt.

    • cost_center_requiredboolean

      Ob auf diesem Konto eine Kostenstelle angegeben werden muss. Der SKR42 bildet die vier steuerlichen Sphären eines gemeinnützigen Vereins über Kostenstellen ab, nicht über getrennte Konten. Für die Erfolgskonten ist die Angabe dort deshalb Pflicht.

    • is_systemboolean

      Vom Kontenrahmen-Initialisierer angelegt. Nummer und Art sind dann durch den Rahmen vorgegeben und sollten nicht geändert werden.

    • is_activeboolean

      Konten lassen sich stilllegen, statt sie zu löschen - bebuchte Konten dürfen nicht verschwinden.

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

  • cost_centerCostCenter

    Die steuerliche Sphäre, der das Gut dient.

    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.

  • expense_categoryExpenseCategory10

    Die EÜR-Kategorie der Abschreibung. Dieselbe Brücke wie am Sachkonto: wer die EÜR führt, bekommt seine Zeile in der Anlage EÜR, ohne dass es einen Kontenrahmen bräuchte.

    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.

  • incoming_invoiceIncomingInvoice3

    Der Beleg, aus dem das Gut entstanden ist.

    Felder anzeigen (43)
    • idinteger

      Primärschlüssel des Rechnungsdokuments. Interne ID.

    • tokenstring

      Token, das das Dokument für den öffentlichen Zugriff identifiziert.

    • numberinteger

      Laufende Belegnummer.

    • manual_number_prefixstring

      Präfix einer manuell eingegebenen Dokumentnummer.

    • manual_numberinteger

      Manuell eingegebene Dokumentnummer.

    • number_stringstring

      Belegnummer, wie sie den Benutzern angezeigt wird.

    • generation_datestring (date-time)

      Datum, an dem das Dokument erstellt wurde.

    • number_datestring (date-time)

      Datum, das für die Belegnummer verwendet wird.

    • messagestring

      Auf dem Dokument gedruckte Nachricht.

    • currencystring

      Währung des Dokuments.

    • namestring

      Name des Dokuments.

    • due_datestring (date-time)

      Fälligkeitsdatum des Dokuments.

    • netto_valuenumber (float)

      Nettosumme des Dokuments.

    • brutto_valuenumber (float)

      Bruttogesamtbetrag des Dokuments.

    • tax_valuenumber (float)

      Gesamter Steuerbetrag des Dokuments.

    • taxTaxPflicht

      Auf das Dokument angewendeter Steuersatz.

    • linked_number_titlestring

      Titel der verknüpften Dokumentnummer.

    • linked_numberstring

      Nummer des verknüpften Belegs.

    • statusstring

      Status des Dokuments.

    • previous_statusstring

      Status vor der letzten Änderung.

    • status_updatedstring (date-time)

      Zeitpunkt, zu dem der Status zuletzt geändert wurde.

    • archivedboolean

      Ob das Dokument archiviert ist.

    • last_pdf_exportstring (date-time)

      Zeitpunkt, zu dem das PDF zuletzt exportiert wurde.

    • last_status_exportstring

      Status beim letzten Export.

    • search_stringstring

      Text, unter dem die Entität gesucht werden kann.

    • external_invoice_numberstring

      Externe Rechnungsnummer des Lieferanten

    • received_datestring (date-time)

      Eingangsdatum (wann wurde die Rechnung empfangen)

    • payment_datestring (date-time)

      Zahlungsdatum

    • service_date_startstring (date-time)

      Leistungszeitraum Start

    • service_date_endstring (date-time)

      Leistungszeitraum Ende

    • vat_categorystring

      Der umsatzsteuerliche Sachverhalt. Auf der Eingangsseite entscheidet er darüber, ob die Vorsteuer unter Kennzahl 66 steht (Rechnung eines anderen Unternehmers), unter 61 (innergemeinschaftlicher Erwerb), unter 62 (Einfuhrumsatzsteuer) oder unter 67 (§ 13b UStG). Beim Erwerb und bei § 13b kommt eine zweite Zeile hinzu: Die Steuer schulden wir selbst, obwohl sie uns niemand berechnet hat, und sie steht deshalb zugleich als Umsatzsteuer im Vordruck. Wer nur eine der beiden bucht, zahlt zu viel oder zu wenig. Ohne Angabe gilt der Regelfall.

    • vat_self_assessed_ratenumber (float)

      Der Steuersatz, mit dem die selbst geschuldete Steuer zu rechnen ist. Beim innergemeinschaftlichen Erwerb und bei § 13b UStG berechnet der Lieferant keine Steuer – die Rechnung ist netto, und die Steuer schulden wir. Womit sie zu rechnen ist, steht deshalb auf keinem Beleg: es ist der Satz, der im Inland auf diese Leistung anzuwenden wäre. Ohne Angabe rechnet die Voranmeldung mit dem Regelsatz und sagt in den Hinweisen, bei wie vielen Belegen sie das getan hat. Stillschweigend zu raten wäre in einer Steueranmeldung das Falsche.

    • import_vat_amountstring

      Die Einfuhrumsatzsteuer aus dem Zollbescheid. Sie steht NICHT auf der Rechnung des Lieferanten - die ist bei einer Einfuhr ohne deutsche Steuer. Entrichtet wird sie an den Zoll, und nur der entrichtete Betrag ist als Vorsteuer abziehbar (§ 15 Abs. 1 Satz 1 Nr. 2 UStG, Kennzahl 62 der Voranmeldung). Den Steuerbetrag der Lieferantenrechnung dafür zu nehmen war schlicht der falsche Beleg.

    • paid_valuenumber (float)

      Bereits bezahlter Betrag (für Teilzahlungen)

    • sellerIncomingInvoiceSeller

      Verkäufer/Lieferant Informationen (Snapshot)

    • expense_categoryExpenseCategory10

      Hauptkategorie für EÜR

    • document_pathstring

      Pfad zur gespeicherten Rechnungsdatei (PDF/Bild)

    • document_filenamestring

      Original Dateiname

    • document_mime_typestring

      MIME-Typ des Dokuments

    • notesstring

      Notizen/Bemerkungen

    • is_deductibleboolean

      Ist die Rechnung für den Vorsteuerabzug relevant?

    • is_approvedboolean

      Wurde die Rechnung geprüft/freigegeben?

    • approved_atstring (date-time)

      Zeitpunkt, zu dem die Eingangsrechnung genehmigt wurde.

  • disposal_datestring (date-time)

    Tag des Abgangs - Verkauf, Verschrottung, Entnahme.

  • disposal_proceedsnumber (float)

    Verkaufserlös beim Abgang, netto.

  • disposal_tax_ratenumber (float)

    Umsatzsteuersatz auf den Verkaufserlös, in Prozent. Der Verkauf eines Anlageguts ist ein steuerpflichtiger Umsatz wie jeder andere - vorher wurde der Erlös netto ohne Steuer gebucht, und die Umsatzsteuer fehlte in Bilanz und Voranmeldung. Bewusst ohne Vorgabewert: ob Steuer anfällt, hängt am Vorgang. Eine Verschrottung, eine Entnahme und der Verkauf aus dem ideellen Bereich eines Vereins sind steuerfrei; der gewerbliche Verkauf ist es nicht. Ein geratener Satz wäre in der Hälfte der Fälle falsch.

  • is_movableboolean

    Bewegliches Wirtschaftsgut? Die degressive AfA des § 7 Abs. 2 EStG gilt nur für bewegliche Wirtschaftsgüter des Anlagevermögens - ein Gebäude oder eine Software degressiv abzuschreiben ist unzulässig, und ohne dieses Merkmal konnte es niemand verhindern. Vorgabe true: Betriebs- und Geschäftsausstattung ist in diesem System der Regelfall.

  • disposal_reasonstring

    Grund für die Ausbuchung des Anlageguts.

  • 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

200Das geaenderte Anlagegut

409Der Plan wäre neu zu rechnen, ist aber schon gebucht

Anfrage
curl --request PUT \
  --url https://eure-instanz.iw-erp.de/api/invoice/fixed_asset/42 \
  --header 'content-type: application/json' \
  --header 'x-iw-jwt-token: <TOKEN>' \
  --data '
{
  "id": 42,
  "name": "Beispiel",
  "inventory_number": "string",
  "acquisition_date": "2026-10-15T09:30:00+02:00",
  "acquisition_cost": 1.5,
  "useful_life_months": 1
}
'

Trägt den Abgang ein und bucht ihn.

POST/api/invoice/fixed_asset/{identifier}/disposal

Pfad-Parameter

identifierPflichtstring

Request-Body application/json

  • disposal_datestring
  • disposal_proceedsnumber

    Verkaufserlös netto

  • disposal_tax_ratenumber

    Umsatzsteuersatz auf den Erloes in Prozent; leer bei steuerfreiem Abgang

  • disposal_reasonstring

Antworten

200Das Anlagegut mit Abgang und der Buchungssatz

Anfrage
curl --request POST \
  --url https://eure-instanz.iw-erp.de/api/invoice/fixed_asset/42/disposal \
  --header 'content-type: application/json' \
  --header 'x-iw-jwt-token: <TOKEN>' \
  --data '
{
  "disposal_date": "2028-06-30",
  "disposal_proceeds": 1.5,
  "disposal_tax_rate": 19,
  "disposal_reason": "string"
}
'