Invoice

Abrechnung23 EndpunkteBilling / Invoice

Diese Methode liefert alle Rechnungsobjekte

GET/api/invoice/invoices

Query-Parameter

`searchString`string	Text, nach dem in der Liste gesucht wird
`orderFieldName`string	Name des Bestellfelds
`orderFieldSort`string	SortiermodusErlaubt: `DESCASC`
`page`integer	Seite der Liste
`pageSize`integer	Anzahl der Einträge je Seite
`withMaxPageNumber`string	gibt die Anzahl verfügbarer Seiten als Header zurück, wenn dies gesetzt ist

Antworten

200Liefert eine Liste der Invoice-Objekte.array<Invoice>

Felder anzeigen (38)

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.
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%
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.
accounting_typeAccountingTypePflicht
Buchungsart der Rechnung.
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)
payment_typePaymentType
Zahlungsart der Rechnung.
Felder anzeigen (10)
- idinteger
  Primärschlüssel des Zahlungstyps. Interne ID.
- namestring
  Name der Zahlungsart, zum Beispiel Überweisung oder Barzahlung.
- autoboolean
  Zahlungen dieses Typs werden automatisch zugeordnet.
- conditionsstring
  Bedingungen für die Zuordnung von Zahlungen zu diesem Typ.
- linked_keywordsstring
  Schlüsselwörter in Banktransaktionen, die mit dieser Zahlungsart verknüpft werden.
- global_defaultboolean
  Standard-Zahlungsart für neue Rechnungen.
- bank_import_defaultboolean
  Standard-Zahlungsart für Bankimporte.
- is_direct_debitboolean
  Die Zahlungsart ist ein Lastschriftverfahren.
- is_externalboolean
  Die Zahlung wird über einen externen Dienst abgewickelt.
- deletedboolean
  Diese Eigenschaft markiert eine Entität als gelöscht / archiviert
payment_goalPaymentGoal
Zahlungsbedingung der Rechnung.
Felder anzeigen (5)
- idinteger
  Primärschlüssel des Zahlungsziels. Interne ID.
- namestring
  Name der Zahlungsbedingung, zum Beispiel 14 Tage.
- date_stringstring
  Datumsmuster der Zahlungsfrist als Text.
- deletedboolean
  Die Zahlungsfrist wird gelöscht.
- global_defaultboolean
  Standard-Zahlungsziel für neue Rechnungen.
expense_categoryExpenseCategory10
EÜR-Kategorie für diese Rechnung (Einnahmen-Zuordnung) Wenn nicht gesetzt, wird die Default-Kategorie des AccountingTypes verwendet
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.
buyerInvoiceBuyer
Käufer der Rechnung.
Felder anzeigen (22)
- idinteger
  Primärschlüssel des Clients. Interne ID.
- namestring
  Name des Kunden auf der Rechnung.
- vat_idstring
  USt-IdNr. des Kunden.
- taxnumberstring
  Steuernummer des Kunden.
- buyer_reference_idstring
  Leitweg-ID oder vom Kunden definierte individuelle Referenz-ID
- secondary_namestring
  Zweite Namenszeile des Kunden auf der Rechnung.
- addressstring
  Adresse als Text.
- address_streetstring
  Straße der Adresse.
- address_house_numberstring
  Hausnummer der Adresse.
- address_street_levelstring
  Straße und Hausnummer der Adresse.
- address_costring
  Care-of-Zeile der Adresse.
- address_citystring
  Ort der Adresse.
- address_zipstring
  Postleitzahl der Adresse.
- address_admin_level1string
  Erste Verwaltungsebene der Adresse, z. B. das Bundesland.
- address_countrystring
  Ländercode der Adresse.
- address_full_countrystring
  Vollständiger Name des Landes der Adresse.
- address_geo_latstring
  Breitengrad der Adresse.
- address_geo_lngstring
  Längengrad der Adresse.
- address_external_provider_idstring
  Feld zur Speicherung der externen Anbieter-ID der Adresse, z. B. Google-Maps-PlaceID wie google:ChIJVcKw5r90sEcRhdjNq6NItqE
- numberstring
  Kundennummer des Käufers.
- search_stringstring
  Text, unter dem die Entität gesucht werden kann.
- invoiceInvoice
  Rechnung, zu der der Käufer gehört.
payment_datestring (date-time)
Datum, an dem die Rechnung bezahlt wurde.
vat_categorystring
Der umsatzsteuerliche Sachverhalt. Der Steuersatz sagt nicht, in welche Zeile der Voranmeldung ein Umsatz gehört. Null Prozent stehen an einer innergemeinschaftlichen Lieferung (Kennzahl 41), an einer Ausfuhr (43), an einer Leistung nach § 13b UStG (60) und an einem steuerfreien Umsatz nach § 4 UStG (48) - vier verschiedene Zeilen, derselbe Steuersatz. Hier ist die einzige Stelle, an der jemand das weiß: beim Schreiben der Rechnung ist bekannt, ob der Kunde eine USt-IdNr. hat und wohin die Ware geht. Später ist es nicht mehr rekonstruierbar. Ohne Angabe der Regelfall - alles andere war bisher nicht erfassbar.
is_payment_date_from_ext_serviceboolean
Das Zahlungsdatum stammt von einem externen Dienst.
direct_debit_exportedboolean
Die Rechnung wurde für das Lastschriftverfahren exportiert.
cancel_datestring (date-time)
Datum, an dem die Rechnung storniert wurde.
cancel_textstring
Text der Stornierung.
start_datestring (date-time)
Beginn des abgerechneten Zeitraums.
end_datestring (date-time)
Ende des abgerechneten Zeitraums.

Anfrage

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

const options = {method: 'GET', headers: {'x-iw-jwt-token': '<TOKEN>'}};

fetch('https://eure-instanz.iw-erp.de/api/invoice/invoices', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://eure-instanz.iw-erp.de/api/invoice/invoices"

headers = {"x-iw-jwt-token": "<TOKEN>"}

response = requests.get(url, headers=headers)

print(response.text)

<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://eure-instanz.iw-erp.de/api/invoice/invoices', [
  'headers' => [
    'x-iw-jwt-token' => '<TOKEN>',
  ],
]);

echo $response->getBody();

using System.Net.Http.Headers;
var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://eure-instanz.iw-erp.de/api/invoice/invoices"),
  Headers =
  {
    { "x-iw-jwt-token", "<TOKEN>" },
  },
};
using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://eure-instanz.iw-erp.de/api/invoice/invoices")
  .get()
  .addHeader("x-iw-jwt-token", "<TOKEN>")
  .build();

Response response = client.newCall(request).execute();

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://eure-instanz.iw-erp.de/api/invoice/invoices"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-iw-jwt-token", "<TOKEN>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

Dart mit dem Package iw_erp_api

import 'package:iw_erp_api/clients/billing_invoice_controller.dart';
import 'package:iw_erp_api/logic/iw_api_state.dart';

IwApiState().host = 'eure-instanz.iw-erp.de';
IwApiState().currentJwtApiToken = '<TOKEN>';

final result = await BillingInvoiceController.getAll();
if (result.success) {
  print(result.data);
}

Antwort 200 application/json

[
  {
    "tax": {
      "name": "Beispiel",
      "id": 42,
      "value": 1.5,
      "deleted": true,
      "global_default": true,
      "datev_tax_key": 1
    },
    "accounting_type": {
      "name": "Beispiel",
      "type": "string",
      "id": 42,
      "cancelled_name": "Beispiel",
      "deleted": true
    },
    "id": 42,
    "currency": "EUR",
    "name": "Beispiel",
    "linked_number_title": "Beispiel",
    "cancel_text": "Text",
    "token": "string",
    "number": 1,
    "manual_number_prefix": "string"
  }
]

Erstellt eine einzelne Invoice

POST/api/invoice/invoices

Request-Body application/json

invoiceInvoice2
Felder anzeigen (9)
- accounting_typeAccountingTypePflicht
  Buchungsart der Rechnung.
- payment_typePaymentType6
  Zahlungsart der Rechnung.
- payment_goalPaymentGoal
  Zahlungsbedingung der Rechnung.
- itemsarray<InvoiceItem2>
  Positionen der Rechnung.
- buyerInvoiceBuyer2
  Käufer der Rechnung.
- vat_categorystring
  Der umsatzsteuerliche Sachverhalt. Der Steuersatz sagt nicht, in welche Zeile der Voranmeldung ein Umsatz gehört. Null Prozent stehen an einer innergemeinschaftlichen Lieferung (Kennzahl 41), an einer Ausfuhr (43), an einer Leistung nach § 13b UStG (60) und an einem steuerfreien Umsatz nach § 4 UStG (48) - vier verschiedene Zeilen, derselbe Steuersatz. Hier ist die einzige Stelle, an der jemand das weiß: beim Schreiben der Rechnung ist bekannt, ob der Kunde eine USt-IdNr. hat und wohin die Ware geht. Später ist es nicht mehr rekonstruierbar. Ohne Angabe der Regelfall - alles andere war bisher nicht erfassbar.
- start_datestring (date-time)
  Beginn des abgerechneten Zeitraums.
- end_datestring (date-time)
  Ende des abgerechneten Zeitraums.
- billing_payment_profileBillingPaymentProfile9

Antworten

200Erstellt eine einzelne InvoiceInvoice3

Felder anzeigen (45)

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.
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%
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.
base_booking_groupBaseBookingGroup10
Buchungsgruppe, auf der das Dokument basiert.
Felder anzeigen (16)
- idinteger
  Primärschlüssel der Buchungsgruppe. Interne ID.
- start_timestring (date-time)
  Beginn der Buchungsgruppe.
- end_timestring (date-time)
  Ende der Buchungsgruppe.
- booking_typestring
  Art der Buchungen in der Gruppe.
- booking_statusstring
  Status der Buchungen in der Gruppe.
- externalboolean
  Die Gruppe wurde von einer externen Stelle erstellt.
- billing_typestring
  Abrechnungsart der Gruppe, zum Beispiel je Buchung oder je Gruppe.
- people_countinteger
  Anzahl der Personen in der Gruppe.
- createdstring (date-time)
  Zeitpunkt, zu dem der Datensatz angelegt wurde.
- updatedstring (date-time)
  Zeitpunkt, zu dem der Datensatz zuletzt aktualisiert wurde.
- namestring
  Name der Einheit.
- deletedboolean
  Diese Eigenschaft markiert eine Entität als gelöscht / archiviert
- deletion_reasonstring
  Grund der Löschung.
- deletion_datestring (date-time)
  Zeitpunkt der Löschung.
- colorstring
  Hintergrundfarbe als Hexwert.
- fg_colorstring
  Vordergrundfarbe als Hex-Wert.
search_stringstring
Text, unter dem die Entität gesucht werden kann.
accounting_typeAccountingTypePflicht
Buchungsart der Rechnung.
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)
payment_typePaymentType
Zahlungsart der Rechnung.
Felder anzeigen (10)
- idinteger
  Primärschlüssel des Zahlungstyps. Interne ID.
- namestring
  Name der Zahlungsart, zum Beispiel Überweisung oder Barzahlung.
- autoboolean
  Zahlungen dieses Typs werden automatisch zugeordnet.
- conditionsstring
  Bedingungen für die Zuordnung von Zahlungen zu diesem Typ.
- linked_keywordsstring
  Schlüsselwörter in Banktransaktionen, die mit dieser Zahlungsart verknüpft werden.
- global_defaultboolean
  Standard-Zahlungsart für neue Rechnungen.
- bank_import_defaultboolean
  Standard-Zahlungsart für Bankimporte.
- is_direct_debitboolean
  Die Zahlungsart ist ein Lastschriftverfahren.
- is_externalboolean
  Die Zahlung wird über einen externen Dienst abgewickelt.
- deletedboolean
  Diese Eigenschaft markiert eine Entität als gelöscht / archiviert
payment_goalPaymentGoal
Zahlungsbedingung der Rechnung.
Felder anzeigen (5)
- idinteger
  Primärschlüssel des Zahlungsziels. Interne ID.
- namestring
  Name der Zahlungsbedingung, zum Beispiel 14 Tage.
- date_stringstring
  Datumsmuster der Zahlungsfrist als Text.
- deletedboolean
  Die Zahlungsfrist wird gelöscht.
- global_defaultboolean
  Standard-Zahlungsziel für neue Rechnungen.
expense_categoryExpenseCategory10
EÜR-Kategorie für diese Rechnung (Einnahmen-Zuordnung) Wenn nicht gesetzt, wird die Default-Kategorie des AccountingTypes verwendet
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.
itemsarray<InvoiceItem3>
Positionen der Rechnung.
Felder anzeigen (18)
- idinteger
  Primärschlüssel der Rechnungsposition. Interne ID.
- descriptionstring
  Beschreibung der Rechnungsposition.
- price_is_bruttoboolean
  Ob der Preis ein Bruttopreis inklusive Steuer ist.
- skustring
  Artikelnummer (Stock Keeping Unit)
- barcodestring
  Barcode (ISBN, UPC, GTIN usw.)
- item_typestring
  Typ (Item, Shipping)
- netto_valuenumber (float)
  Nettowert der Rechnungsposition.
- brutto_valuenumber (float)
  Bruttowert der Rechnungsposition.
- tax_valuenumber (float)
  Steuerbetrag der Rechnungsposition.
- quantitynumber (float)Pflicht
  Menge der Rechnungsposition.
- pricenumber (float)Pflicht
  Einzelpreis der Rechnungsposition.
- namestringPflicht
  Name der Rechnungsposition.
- unitstringPflicht
  Einheit der Rechnungsposition.
- taxTax
  Auf die Rechnungsposition angewendeter Steuersatz.
- invoiceInvoice3
  Rechnung, zu der der Eintrag gehört.
- project_itemCRMProjectItem8
  Projektposition, aus der die Rechnungsposition erstellt wurde.
- base_event_sign_upBaseEventSignUp11
  Anmeldung, für die die Position angelegt wurde.
- productPredefinedBillingItem15
  Produkt der Position.
buyerInvoiceBuyer3
Käufer der Rechnung.
Felder anzeigen (29)
- idinteger
  Primärschlüssel des Clients. Interne ID.
- namestring
  Name des Kunden auf der Rechnung.
- vat_idstring
  USt-IdNr. des Kunden.
- taxnumberstring
  Steuernummer des Kunden.
- buyer_reference_idstring
  Leitweg-ID oder vom Kunden definierte individuelle Referenz-ID
- secondary_namestring
  Zweite Namenszeile des Kunden auf der Rechnung.
- addressstring
  Adresse als Text.
- address_streetstring
  Straße der Adresse.
- address_house_numberstring
  Hausnummer der Adresse.
- address_street_levelstring
  Straße und Hausnummer der Adresse.
- address_costring
  Care-of-Zeile der Adresse.
- address_citystring
  Ort der Adresse.
- address_zipstring
  Postleitzahl der Adresse.
- address_admin_level1string
  Erste Verwaltungsebene der Adresse, z. B. das Bundesland.
- address_countrystring
  Ländercode der Adresse.
- address_full_countrystring
  Vollständiger Name des Landes der Adresse.
- address_geo_latstring
  Breitengrad der Adresse.
- address_geo_lngstring
  Längengrad der Adresse.
- address_external_provider_idstring
  Feld zur Speicherung der externen Anbieter-ID der Adresse, z. B. Google-Maps-PlaceID wie google:ChIJVcKw5r90sEcRhdjNq6NItqE
- numberstring
  Kundennummer des Käufers.
- search_stringstring
  Text, unter dem die Entität gesucht werden kann.
- payment_ownerstring
  Kontoinhaber der Lastschrift.
- payment_institutionstring
  Name der Bank des Lastschrifteinzugs.
- payment_bicstring
  BIC des Bankkontos.
- payment_ibanstring
  IBAN des Bankkontos.
- payment_mandatestring
  Referenz des SEPA-Mandats.
- payment_mandate_sign_datestring (date-time)
  Datum, an dem das SEPA-Mandat unterschrieben wurde.
- payment_mandate_valid_until_datestring (date-time)
  Datum, bis zu dem das SEPA-Mandat gültig ist.
- invoiceInvoice3
  Rechnung, zu der der Käufer gehört.
payment_datestring (date-time)
Datum, an dem die Rechnung bezahlt wurde.
vat_categorystring
Der umsatzsteuerliche Sachverhalt. Der Steuersatz sagt nicht, in welche Zeile der Voranmeldung ein Umsatz gehört. Null Prozent stehen an einer innergemeinschaftlichen Lieferung (Kennzahl 41), an einer Ausfuhr (43), an einer Leistung nach § 13b UStG (60) und an einem steuerfreien Umsatz nach § 4 UStG (48) - vier verschiedene Zeilen, derselbe Steuersatz. Hier ist die einzige Stelle, an der jemand das weiß: beim Schreiben der Rechnung ist bekannt, ob der Kunde eine USt-IdNr. hat und wohin die Ware geht. Später ist es nicht mehr rekonstruierbar. Ohne Angabe der Regelfall - alles andere war bisher nicht erfassbar.
is_payment_date_from_ext_serviceboolean
Das Zahlungsdatum stammt von einem externen Dienst.
direct_debit_exportedboolean
Die Rechnung wurde für das Lastschriftverfahren exportiert.
offerOffer9
Angebot, aus dem die Rechnung erstellt wurde.
Felder anzeigen (36)
- 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.
- base_booking_groupBaseBookingGroup10
  Buchungsgruppe, auf der das Dokument basiert.
- search_stringstring
  Text, unter dem die Entität gesucht werden kann.
- offer_accounting_typeOfferAccountingTypePflicht
  Buchungsart des Angebots.
- itemsarray<OfferItem8>
  Positionen des Angebots.
- buyerOfferBuyer8
  Käufer des Angebots.
- accepted_datestring (date-time)
  Datum, an dem das Angebot angenommen wurde.
- is_accepted_date_from_ext_serviceboolean
  Das Annahmedatum stammt von einem externen Dienst.
- projectCRMProject17
  Projekt, zu dem das Angebot gehört.
- invoicesarray<Invoice3>
  Aus dem Angebot erstellte Rechnungen.
- base_event_sign_upBaseEventSignUp11
  Anmeldung, für die das Angebot angelegt wurde.
- base_bookingBaseBooking12
  Buchung, für die das Angebot erstellt wurde.
- base_event_sign_up_groupBaseEventSignUpGroup2
  Anmeldegruppe, für die das Angebot angelegt wurde.
time_reportsarray<ProjectTimeReport4>
Auf der Rechnung abgerechnete Zeitberichte.
Felder anzeigen (8)
- idinteger
  Primärschlüssel des Projektzeitberichts. Interne ID.
- projectCRMProject17
  Projekt, zu dem der Zeitbericht gehört.
- invoiceInvoice3
  Rechnung, auf der der Zeitbericht abgerechnet wurde.
- time_billed_on_ticket_closeboolean
  Die Zeit wird abgerechnet, wenn das Ticket geschlossen wird.
- startstring (date-time)
  Beginn des gemeldeten Zeitraums.
- endstring (date-time)
  Ende des gemeldeten Zeitraums.
- time_string_billablestring
  Abrechnungsfähige Zeit als Text.
- time_string_not_billablestring
  Nicht abrechenbare Zeit als Text.
payment_provider_statusstring
Status beim Zahlungsanbieter.
payment_provider_referencestring
Referenz beim Zahlungsanbieter.
payment_provider_transaction_referencestring
Transaktionsreferenz beim Zahlungsanbieter.
cancel_datestring (date-time)
Datum, an dem die Rechnung storniert wurde.
cancel_textstring
Text der Stornierung.
base_event_sign_upBaseEventSignUp11
Anmeldung, für die die Rechnung angelegt wurde.
Felder anzeigen (4)
- bib_range_idinteger
- age_classstring
  Altersklasse nach DLV, z. B. M40 – berechnet aus Geburtstag, Geschlecht und Veranstaltungsdatum.
- idinteger
  Primärschlüssel der Anmeldung. Interne ID.
- … 58 weitere Felder
… 8 weitere Felder

Anfrage

curl --request POST \
  --url https://eure-instanz.iw-erp.de/api/invoice/invoices \
  --header 'content-type: application/json' \
  --header 'x-iw-jwt-token: <TOKEN>' \
  --data '
{
  "invoice": {
    "accounting_type": {
      "name": "Beispiel",
      "type": "string",
      "id": 42,
      "cancelled_name": "Beispiel",
      "deleted": true
    },
    "payment_type": {
      "deleted": true
    },
    "payment_goal": {
      "id": 42,
      "name": "Beispiel",
      "date_string": "string",
      "deleted": true,
      "global_default": true
    },
    "buyer": {
      "address_street": "Jakobistr. 39",
      "address_city": "Hannover",
      "address_zip": "30163",
      "address_country": "DE",
      "address_full_country": "DE",
      "payment_bic": "BYLADEM1001"
    },
    "vat_category": "string",
    "start_date": "2026-10-15T09:30:00+02:00"
  }
}
'

const options = {
  method: 'POST',
  headers: {'x-iw-jwt-token': '<TOKEN>', 'content-type': 'application/json'},
  body: JSON.stringify({
    invoice: {
      accounting_type: {
        name: 'Beispiel',
        type: 'string',
        id: 42,
        cancelled_name: 'Beispiel',
        deleted: true
      },
      payment_type: {deleted: true},
      payment_goal: {
        id: 42,
        name: 'Beispiel',
        date_string: 'string',
        deleted: true,
        global_default: true
      },
      buyer: {
        address_street: 'Jakobistr. 39',
        address_city: 'Hannover',
        address_zip: '30163',
        address_country: 'DE',
        address_full_country: 'DE',
        payment_bic: 'BYLADEM1001'
      },
      vat_category: 'string',
      start_date: '2026-10-15T09:30:00+02:00'
    }
  })
};

fetch('https://eure-instanz.iw-erp.de/api/invoice/invoices', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://eure-instanz.iw-erp.de/api/invoice/invoices"

payload = { "invoice": {
    "accounting_type": {
      "name": "Beispiel",
      "type": "string",
      "id": 42,
      "cancelled_name": "Beispiel",
      "deleted": True
    },
    "payment_type": { "deleted": True },
    "payment_goal": {
      "id": 42,
      "name": "Beispiel",
      "date_string": "string",
      "deleted": True,
      "global_default": True
    },
    "buyer": {
      "address_street": "Jakobistr. 39",
      "address_city": "Hannover",
      "address_zip": "30163",
      "address_country": "DE",
      "address_full_country": "DE",
      "payment_bic": "BYLADEM1001"
    },
    "vat_category": "string",
    "start_date": "2026-10-15T09:30:00+02:00"
  } }
headers = {
  "x-iw-jwt-token": "<TOKEN>",
  "content-type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://eure-instanz.iw-erp.de/api/invoice/invoices', [
  'body' => '{"invoice":{"accounting_type":{"name":"Beispiel","type":"string","id":42,"cancelled_name":"Beispiel","deleted":true},"payment_type":{"deleted":true},"payment_goal":{"id":42,"name":"Beispiel","date_string":"string","deleted":true,"global_default":true},"buyer":{"address_street":"Jakobistr. 39","address_city":"Hannover","address_zip":"30163","address_country":"DE","address_full_country":"DE","payment_bic":"BYLADEM1001"},"vat_category":"string","start_date":"2026-10-15T09:30:00+02:00"}}',
  'headers' => [
    'content-type' => 'application/json',
    'x-iw-jwt-token' => '<TOKEN>',
  ],
]);

echo $response->getBody();

using System.Net.Http.Headers;
var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Post,
  RequestUri = new Uri("https://eure-instanz.iw-erp.de/api/invoice/invoices"),
  Headers =
  {
    { "x-iw-jwt-token", "<TOKEN>" },
  },
  Content = new StringContent("{\"invoice\":{\"accounting_type\":{\"name\":\"Beispiel\",\"type\":\"string\",\"id\":42,\"cancelled_name\":\"Beispiel\",\"deleted\":true},\"payment_type\":{\"deleted\":true},\"payment_goal\":{\"id\":42,\"name\":\"Beispiel\",\"date_string\":\"string\",\"deleted\":true,\"global_default\":true},\"buyer\":{\"address_street\":\"Jakobistr. 39\",\"address_city\":\"Hannover\",\"address_zip\":\"30163\",\"address_country\":\"DE\",\"address_full_country\":\"DE\",\"payment_bic\":\"BYLADEM1001\"},\"vat_category\":\"string\",\"start_date\":\"2026-10-15T09:30:00+02:00\"}}")
  {
    Headers =
    {
      ContentType = new MediaTypeHeaderValue("application/json")
    }
  }
};
using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}

OkHttpClient client = new OkHttpClient();

MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\"invoice\":{\"accounting_type\":{\"name\":\"Beispiel\",\"type\":\"string\",\"id\":42,\"cancelled_name\":\"Beispiel\",\"deleted\":true},\"payment_type\":{\"deleted\":true},\"payment_goal\":{\"id\":42,\"name\":\"Beispiel\",\"date_string\":\"string\",\"deleted\":true,\"global_default\":true},\"buyer\":{\"address_street\":\"Jakobistr. 39\",\"address_city\":\"Hannover\",\"address_zip\":\"30163\",\"address_country\":\"DE\",\"address_full_country\":\"DE\",\"payment_bic\":\"BYLADEM1001\"},\"vat_category\":\"string\",\"start_date\":\"2026-10-15T09:30:00+02:00\"}}");
Request request = new Request.Builder()
  .url("https://eure-instanz.iw-erp.de/api/invoice/invoices")
  .post(body)
  .addHeader("x-iw-jwt-token", "<TOKEN>")
  .addHeader("content-type", "application/json")
  .build();

Response response = client.newCall(request).execute();

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://eure-instanz.iw-erp.de/api/invoice/invoices"

	payload := strings.NewReader("{\"invoice\":{\"accounting_type\":{\"name\":\"Beispiel\",\"type\":\"string\",\"id\":42,\"cancelled_name\":\"Beispiel\",\"deleted\":true},\"payment_type\":{\"deleted\":true},\"payment_goal\":{\"id\":42,\"name\":\"Beispiel\",\"date_string\":\"string\",\"deleted\":true,\"global_default\":true},\"buyer\":{\"address_street\":\"Jakobistr. 39\",\"address_city\":\"Hannover\",\"address_zip\":\"30163\",\"address_country\":\"DE\",\"address_full_country\":\"DE\",\"payment_bic\":\"BYLADEM1001\"},\"vat_category\":\"string\",\"start_date\":\"2026-10-15T09:30:00+02:00\"}}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-iw-jwt-token", "<TOKEN>")
	req.Header.Add("content-type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

Dart mit dem Package iw_erp_api

import 'package:iw_erp_api/clients/billing_invoice_controller.dart';
import 'package:iw_erp_api/logic/iw_api_state.dart';
import 'package:iw_erp_api/model/invoice.dart';

IwApiState().host = 'eure-instanz.iw-erp.de';
IwApiState().currentJwtApiToken = '<TOKEN>';

final result = await BillingInvoiceController.post(Invoice.fromJson({
  "accounting_type": {
    "name": "Beispiel",
    "type": "string",
    "id": 42,
    "cancelled_name": "Beispiel",
    "deleted": true
  },
  "payment_type": {
    "deleted": true
  },
  "payment_goal": {
    "id": 42,
    "name": "Beispiel",
    "date_string": "string",
    "deleted": true,
    "global_default": true
  },
  "buyer": {
    "address_street": "Jakobistr. 39",
    "address_city": "Hannover",
    "address_zip": "30163",
    "address_country": "DE",
    "address_full_country": "DE",
    "payment_bic": "BYLADEM1001"
  },
  "vat_category": "string",
  "start_date": "2026-10-15T09:30:00+02:00"
}));
if (result.success) {
  print(result.data);
}

Antwort 200 application/json

{
  "tax": {
    "name": "Beispiel",
    "id": 42,
    "value": 1.5,
    "deleted": true,
    "global_default": true,
    "datev_tax_key": 1
  },
  "accounting_type": {
    "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
    }
  },
  "id": 42,
  "currency": "EUR",
  "name": "Beispiel",
  "linked_number_title": "Beispiel",
  "cancel_text": "Text",
  "token": "string",
  "number": 1,
  "manual_number_prefix": "string"
}

Liefert die Standardwerte für das Anlegen freier Rechnungen.

GET/api/invoice/invoices/creation_defaults

Alle Felder sind optional und werden nur befüllt, wenn sie über Einstellungen konfiguriert sind.

Antworten

200Liefert die Standardwerte für das Anlegen von Rechnungenobject

Felder anzeigen (5)

default_accounting_typestring
Typ-Zeichenkette des Standard-AccountingType (z. B. 'general'). Null, wenn nicht konfiguriert.
default_multiple_tax_ratesboolean
Ob „mehrere Steuersätze anwenden“ standardmäßig aktiviert sein soll.
default_unitstring
Standardeinheit für freie Positionen (z. B. 'pauschal'). Null, wenn nicht konfiguriert.
default_quantitynumber (float)
Standardmenge für freie Positionen. Null, wenn nicht konfiguriert.
default_price_is_bruttoboolean
Ob der Preis standardmäßig brutto statt netto angegeben werden soll.

Anfrage

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

const options = {method: 'GET', headers: {'x-iw-jwt-token': '<TOKEN>'}};

fetch('https://eure-instanz.iw-erp.de/api/invoice/invoices/creation_defaults', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://eure-instanz.iw-erp.de/api/invoice/invoices/creation_defaults"

headers = {"x-iw-jwt-token": "<TOKEN>"}

response = requests.get(url, headers=headers)

print(response.text)

<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://eure-instanz.iw-erp.de/api/invoice/invoices/creation_defaults', [
  'headers' => [
    'x-iw-jwt-token' => '<TOKEN>',
  ],
]);

echo $response->getBody();

using System.Net.Http.Headers;
var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://eure-instanz.iw-erp.de/api/invoice/invoices/creation_defaults"),
  Headers =
  {
    { "x-iw-jwt-token", "<TOKEN>" },
  },
};
using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://eure-instanz.iw-erp.de/api/invoice/invoices/creation_defaults")
  .get()
  .addHeader("x-iw-jwt-token", "<TOKEN>")
  .build();

Response response = client.newCall(request).execute();

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://eure-instanz.iw-erp.de/api/invoice/invoices/creation_defaults"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-iw-jwt-token", "<TOKEN>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

Dart mit dem Package iw_erp_api

import 'package:iw_erp_api/clients/billing_invoice_controller.dart';
import 'package:iw_erp_api/logic/iw_api_state.dart';

IwApiState().host = 'eure-instanz.iw-erp.de';
IwApiState().currentJwtApiToken = '<TOKEN>';

final result = await BillingInvoiceController.getCreationDefaults();
if (result.success) {
  print(result.data);
}

Antwort 200 application/json

{
  "default_accounting_type": "string",
  "default_multiple_tax_rates": true,
  "default_unit": "string",
  "default_quantity": 1.5,
  "default_price_is_brutto": true
}

Diese Methode druckt eine Rechnung als PDF (optional mit ZUGFeRD-XML)

GET/api/invoice/invoices/{id}/pdf

Pfad-Parameter

idPflichtstring

Antworten

200Liefert die Rechnung als PDF-Datei

Anfrage

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

const options = {method: 'GET', headers: {'x-iw-jwt-token': '<TOKEN>'}};

fetch('https://eure-instanz.iw-erp.de/api/invoice/invoices/42/pdf', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://eure-instanz.iw-erp.de/api/invoice/invoices/42/pdf"

headers = {"x-iw-jwt-token": "<TOKEN>"}

response = requests.get(url, headers=headers)

print(response.text)

<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://eure-instanz.iw-erp.de/api/invoice/invoices/42/pdf', [
  'headers' => [
    'x-iw-jwt-token' => '<TOKEN>',
  ],
]);

echo $response->getBody();

using System.Net.Http.Headers;
var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://eure-instanz.iw-erp.de/api/invoice/invoices/42/pdf"),
  Headers =
  {
    { "x-iw-jwt-token", "<TOKEN>" },
  },
};
using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://eure-instanz.iw-erp.de/api/invoice/invoices/42/pdf")
  .get()
  .addHeader("x-iw-jwt-token", "<TOKEN>")
  .build();

Response response = client.newCall(request).execute();

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://eure-instanz.iw-erp.de/api/invoice/invoices/42/pdf"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-iw-jwt-token", "<TOKEN>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

Dart mit dem Package iw_erp_api

import 'package:iw_erp_api/clients/billing_invoice_controller.dart';
import 'package:iw_erp_api/logic/iw_api_state.dart';

IwApiState().host = 'eure-instanz.iw-erp.de';
IwApiState().currentJwtApiToken = '<TOKEN>';

final result = await BillingInvoiceController.getDownloadLinkPdf('42');
print(result);

Diese Methode gibt den GiroCode (EPC-QR-Code) einer offenen Rechnung für eine Überweisung zurück

GET/api/invoice/invoices/{id}/girocode

Erfordert die Einstellung inwendo_invoice_girocode_enabled. Schlägt mit 400 fehl, wenn die Rechnung keinen Code erhält (storniert, bezahlt, nichts zu zahlen, Lastschrift oder keine gültige IBAN in den Firmendaten).

Pfad-Parameter

idPflichtstring

Antworten

200Liefert Payload, SVG, Betrag und Verwendungszweck des GiroCodes

Anfrage

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

const options = {method: 'GET', headers: {'x-iw-jwt-token': '<TOKEN>'}};

fetch('https://eure-instanz.iw-erp.de/api/invoice/invoices/42/girocode', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://eure-instanz.iw-erp.de/api/invoice/invoices/42/girocode"

headers = {"x-iw-jwt-token": "<TOKEN>"}

response = requests.get(url, headers=headers)

print(response.text)

<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://eure-instanz.iw-erp.de/api/invoice/invoices/42/girocode', [
  'headers' => [
    'x-iw-jwt-token' => '<TOKEN>',
  ],
]);

echo $response->getBody();

using System.Net.Http.Headers;
var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://eure-instanz.iw-erp.de/api/invoice/invoices/42/girocode"),
  Headers =
  {
    { "x-iw-jwt-token", "<TOKEN>" },
  },
};
using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://eure-instanz.iw-erp.de/api/invoice/invoices/42/girocode")
  .get()
  .addHeader("x-iw-jwt-token", "<TOKEN>")
  .build();

Response response = client.newCall(request).execute();

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://eure-instanz.iw-erp.de/api/invoice/invoices/42/girocode"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-iw-jwt-token", "<TOKEN>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

Dart mit package:http (kein Controller im Package iw_erp_api)

import 'package:http/http.dart' as http;

final response = await http.get(
  Uri.parse('https://eure-instanz.iw-erp.de/api/invoice/invoices/42/girocode'),
  headers: {'x-iw-jwt-token': '<TOKEN>'},
);
print(response.body);

Diese Methode druckt ein ZUGFeRD-XML

GET/api/invoice/invoices/{id}/zugferd

Pfad-Parameter

idPflichtstring

Antworten

200Liefert die Rechnung als ZUGFeRD-XML

Anfrage

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

const options = {method: 'GET', headers: {'x-iw-jwt-token': '<TOKEN>'}};

fetch('https://eure-instanz.iw-erp.de/api/invoice/invoices/42/zugferd', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://eure-instanz.iw-erp.de/api/invoice/invoices/42/zugferd"

headers = {"x-iw-jwt-token": "<TOKEN>"}

response = requests.get(url, headers=headers)

print(response.text)

<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://eure-instanz.iw-erp.de/api/invoice/invoices/42/zugferd', [
  'headers' => [
    'x-iw-jwt-token' => '<TOKEN>',
  ],
]);

echo $response->getBody();

using System.Net.Http.Headers;
var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://eure-instanz.iw-erp.de/api/invoice/invoices/42/zugferd"),
  Headers =
  {
    { "x-iw-jwt-token", "<TOKEN>" },
  },
};
using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://eure-instanz.iw-erp.de/api/invoice/invoices/42/zugferd")
  .get()
  .addHeader("x-iw-jwt-token", "<TOKEN>")
  .build();

Response response = client.newCall(request).execute();

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://eure-instanz.iw-erp.de/api/invoice/invoices/42/zugferd"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-iw-jwt-token", "<TOKEN>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

Dart mit dem Package iw_erp_api

import 'package:iw_erp_api/clients/billing_invoice_controller.dart';
import 'package:iw_erp_api/logic/iw_api_state.dart';

IwApiState().host = 'eure-instanz.iw-erp.de';
IwApiState().currentJwtApiToken = '<TOKEN>';

final result = await BillingInvoiceController.getDownloadLinkZUGFeRD('42');
print(result);

Diese Methode liefert ein einzelnes Rechnungsobjekt mit der angegebenen ID

GET/api/invoice/invoices/{identifier}

Pfad-Parameter

identifierPflichtstring

Antworten

200Liefert ein einzelnes Invoice-Objekt.Invoice4

Felder anzeigen (50)

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.
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%
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.
base_booking_groupBaseBookingGroup10
Buchungsgruppe, auf der das Dokument basiert.
Felder anzeigen (16)
- idinteger
  Primärschlüssel der Buchungsgruppe. Interne ID.
- start_timestring (date-time)
  Beginn der Buchungsgruppe.
- end_timestring (date-time)
  Ende der Buchungsgruppe.
- booking_typestring
  Art der Buchungen in der Gruppe.
- booking_statusstring
  Status der Buchungen in der Gruppe.
- externalboolean
  Die Gruppe wurde von einer externen Stelle erstellt.
- billing_typestring
  Abrechnungsart der Gruppe, zum Beispiel je Buchung oder je Gruppe.
- people_countinteger
  Anzahl der Personen in der Gruppe.
- createdstring (date-time)
  Zeitpunkt, zu dem der Datensatz angelegt wurde.
- updatedstring (date-time)
  Zeitpunkt, zu dem der Datensatz zuletzt aktualisiert wurde.
- namestring
  Name der Einheit.
- deletedboolean
  Diese Eigenschaft markiert eine Entität als gelöscht / archiviert
- deletion_reasonstring
  Grund der Löschung.
- deletion_datestring (date-time)
  Zeitpunkt der Löschung.
- colorstring
  Hintergrundfarbe als Hexwert.
- fg_colorstring
  Vordergrundfarbe als Hex-Wert.
mit_last_send_emailstring (date-time)
Zeitpunkt, zu dem die letzte E-Mail gesendet wurde.
mit_to_emailstring
E-Mail-Adresse, für die die E-Mail bestimmt ist.
mit_should_send_emailboolean
Ob eine E-Mail gesendet werden soll.
mit_last_send_postalstring (date-time)
Zeitpunkt, zu dem das letzte Schreiben versendet wurde.
mit_to_address_namestring
Name des Postempfängers.
mit_to_address_street_levelstring
Straße und Hausnummer des Postempfängers.
mit_to_address_citystring
Ort des Postempfängers.
mit_to_address_zipstring
Postleitzahl des Postempfängers.
mit_to_address_countrystring
Land des Postempfängers.
mit_should_send_postalboolean
Ob ein Brief gesendet werden soll.
import_origin_idstring
ID des Datensatzes im Quellsystem des Imports.
import_origin_id_altstring
Alternative ID des Datensatzes im Quellsystem des Imports.
search_stringstring
Text, unter dem die Entität gesucht werden kann.
accounting_typeAccountingTypePflicht
Buchungsart der Rechnung.
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)
payment_typePaymentType
Zahlungsart der Rechnung.
Felder anzeigen (10)
- idinteger
  Primärschlüssel des Zahlungstyps. Interne ID.
- namestring
  Name der Zahlungsart, zum Beispiel Überweisung oder Barzahlung.
- autoboolean
  Zahlungen dieses Typs werden automatisch zugeordnet.
- conditionsstring
  Bedingungen für die Zuordnung von Zahlungen zu diesem Typ.
- linked_keywordsstring
  Schlüsselwörter in Banktransaktionen, die mit dieser Zahlungsart verknüpft werden.
- global_defaultboolean
  Standard-Zahlungsart für neue Rechnungen.
- bank_import_defaultboolean
  Standard-Zahlungsart für Bankimporte.
- is_direct_debitboolean
  Die Zahlungsart ist ein Lastschriftverfahren.
- is_externalboolean
  Die Zahlung wird über einen externen Dienst abgewickelt.
- deletedboolean
  Diese Eigenschaft markiert eine Entität als gelöscht / archiviert
payment_goalPaymentGoal
Zahlungsbedingung der Rechnung.
Felder anzeigen (5)
- idinteger
  Primärschlüssel des Zahlungsziels. Interne ID.
- namestring
  Name der Zahlungsbedingung, zum Beispiel 14 Tage.
- date_stringstring
  Datumsmuster der Zahlungsfrist als Text.
- deletedboolean
  Die Zahlungsfrist wird gelöscht.
- global_defaultboolean
  Standard-Zahlungsziel für neue Rechnungen.
expense_categoryExpenseCategory10
EÜR-Kategorie für diese Rechnung (Einnahmen-Zuordnung) Wenn nicht gesetzt, wird die Default-Kategorie des AccountingTypes verwendet
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.
itemsarray<InvoiceItem4>
Positionen der Rechnung.
Felder anzeigen (18)
- idinteger
  Primärschlüssel der Rechnungsposition. Interne ID.
- descriptionstring
  Beschreibung der Rechnungsposition.
- price_is_bruttoboolean
  Ob der Preis ein Bruttopreis inklusive Steuer ist.
- skustring
  Artikelnummer (Stock Keeping Unit)
- barcodestring
  Barcode (ISBN, UPC, GTIN usw.)
- item_typestring
  Typ (Item, Shipping)
- netto_valuenumber (float)
  Nettowert der Rechnungsposition.
- brutto_valuenumber (float)
  Bruttowert der Rechnungsposition.
- tax_valuenumber (float)
  Steuerbetrag der Rechnungsposition.
- quantitynumber (float)Pflicht
  Menge der Rechnungsposition.
- pricenumber (float)Pflicht
  Einzelpreis der Rechnungsposition.
- namestringPflicht
  Name der Rechnungsposition.
- unitstringPflicht
  Einheit der Rechnungsposition.
- taxTax
  Auf die Rechnungsposition angewendeter Steuersatz.
- invoiceInvoice4
  Rechnung, zu der der Eintrag gehört.
- project_itemCRMProjectItem10
  Projektposition, aus der die Rechnungsposition erstellt wurde.
- base_event_sign_upBaseEventSignUp11
  Anmeldung, für die die Position angelegt wurde.
- productPredefinedBillingItem17
  Produkt der Position.
buyerInvoiceBuyer4
Käufer der Rechnung.
Felder anzeigen (29)
- idinteger
  Primärschlüssel des Clients. Interne ID.
- namestring
  Name des Kunden auf der Rechnung.
- vat_idstring
  USt-IdNr. des Kunden.
- taxnumberstring
  Steuernummer des Kunden.
- buyer_reference_idstring
  Leitweg-ID oder vom Kunden definierte individuelle Referenz-ID
- secondary_namestring
  Zweite Namenszeile des Kunden auf der Rechnung.
- addressstring
  Adresse als Text.
- address_streetstring
  Straße der Adresse.
- address_house_numberstring
  Hausnummer der Adresse.
- address_street_levelstring
  Straße und Hausnummer der Adresse.
- address_costring
  Care-of-Zeile der Adresse.
- address_citystring
  Ort der Adresse.
- address_zipstring
  Postleitzahl der Adresse.
- address_admin_level1string
  Erste Verwaltungsebene der Adresse, z. B. das Bundesland.
- address_countrystring
  Ländercode der Adresse.
- address_full_countrystring
  Vollständiger Name des Landes der Adresse.
- address_geo_latstring
  Breitengrad der Adresse.
- address_geo_lngstring
  Längengrad der Adresse.
- address_external_provider_idstring
  Feld zur Speicherung der externen Anbieter-ID der Adresse, z. B. Google-Maps-PlaceID wie google:ChIJVcKw5r90sEcRhdjNq6NItqE
- numberstring
  Kundennummer des Käufers.
- search_stringstring
  Text, unter dem die Entität gesucht werden kann.
- payment_ownerstring
  Kontoinhaber der Lastschrift.
- payment_institutionstring
  Name der Bank des Lastschrifteinzugs.
- payment_bicstring
  BIC des Bankkontos.
- payment_ibanstring
  IBAN des Bankkontos.
- payment_mandatestring
  Referenz des SEPA-Mandats.
- payment_mandate_sign_datestring (date-time)
  Datum, an dem das SEPA-Mandat unterschrieben wurde.
- payment_mandate_valid_until_datestring (date-time)
  Datum, bis zu dem das SEPA-Mandat gültig ist.
- invoiceInvoice4
  Rechnung, zu der der Käufer gehört.
payment_datestring (date-time)
Datum, an dem die Rechnung bezahlt wurde.
vat_categorystring
Der umsatzsteuerliche Sachverhalt. Der Steuersatz sagt nicht, in welche Zeile der Voranmeldung ein Umsatz gehört. Null Prozent stehen an einer innergemeinschaftlichen Lieferung (Kennzahl 41), an einer Ausfuhr (43), an einer Leistung nach § 13b UStG (60) und an einem steuerfreien Umsatz nach § 4 UStG (48) - vier verschiedene Zeilen, derselbe Steuersatz. Hier ist die einzige Stelle, an der jemand das weiß: beim Schreiben der Rechnung ist bekannt, ob der Kunde eine USt-IdNr. hat und wohin die Ware geht. Später ist es nicht mehr rekonstruierbar. Ohne Angabe der Regelfall - alles andere war bisher nicht erfassbar.
is_payment_date_from_ext_serviceboolean
Das Zahlungsdatum stammt von einem externen Dienst.
direct_debit_exportedboolean
Die Rechnung wurde für das Lastschriftverfahren exportiert.
offerOffer10
Angebot, aus dem die Rechnung erstellt wurde.
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.
- base_booking_groupBaseBookingGroup10
  Buchungsgruppe, auf der das Dokument basiert.
- mit_last_send_emailstring (date-time)
  Zeitpunkt, zu dem die letzte E-Mail gesendet wurde.
- mit_to_emailstring
  E-Mail-Adresse, für die die E-Mail bestimmt ist.
- mit_should_send_emailboolean
  Ob eine E-Mail gesendet werden soll.
- mit_last_send_postalstring (date-time)
  Zeitpunkt, zu dem das letzte Schreiben versendet wurde.
- mit_to_address_namestring
  Name des Postempfängers.
- mit_to_address_street_levelstring
  Straße und Hausnummer des Postempfängers.
- mit_to_address_citystring
  Ort des Postempfängers.
- mit_to_address_zipstring
  Postleitzahl des Postempfängers.
- mit_to_address_countrystring
  Land des Postempfängers.
- mit_should_send_postalboolean
  Ob ein Brief gesendet werden soll.
- import_origin_idstring
  ID des Datensatzes im Quellsystem des Imports.
- import_origin_id_altstring
  Alternative ID des Datensatzes im Quellsystem des Imports.
- search_stringstring
  Text, unter dem die Entität gesucht werden kann.
- offer_accounting_typeOfferAccountingTypePflicht
  Buchungsart des Angebots.
- itemsarray<OfferItem9>
  Positionen des Angebots.
- buyerOfferBuyer9
  Käufer des Angebots.
- accepted_datestring (date-time)
  Datum, an dem das Angebot angenommen wurde.
- … 6 weitere Felder
… 15 weitere Felder

Anfrage

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

const options = {method: 'GET', headers: {'x-iw-jwt-token': '<TOKEN>'}};

fetch('https://eure-instanz.iw-erp.de/api/invoice/invoices/42', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://eure-instanz.iw-erp.de/api/invoice/invoices/42"

headers = {"x-iw-jwt-token": "<TOKEN>"}

response = requests.get(url, headers=headers)

print(response.text)

<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://eure-instanz.iw-erp.de/api/invoice/invoices/42', [
  'headers' => [
    'x-iw-jwt-token' => '<TOKEN>',
  ],
]);

echo $response->getBody();

using System.Net.Http.Headers;
var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://eure-instanz.iw-erp.de/api/invoice/invoices/42"),
  Headers =
  {
    { "x-iw-jwt-token", "<TOKEN>" },
  },
};
using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://eure-instanz.iw-erp.de/api/invoice/invoices/42")
  .get()
  .addHeader("x-iw-jwt-token", "<TOKEN>")
  .build();

Response response = client.newCall(request).execute();

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://eure-instanz.iw-erp.de/api/invoice/invoices/42"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-iw-jwt-token", "<TOKEN>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

Dart mit dem Package iw_erp_api

import 'package:iw_erp_api/clients/billing_invoice_controller.dart';
import 'package:iw_erp_api/logic/iw_api_state.dart';

IwApiState().host = 'eure-instanz.iw-erp.de';
IwApiState().currentJwtApiToken = '<TOKEN>';

final result = await BillingInvoiceController.get('42');
if (result.success) {
  print(result.data);
}

Antwort 200 application/json

{
  "tax": {
    "name": "Beispiel",
    "id": 42,
    "value": 1.5,
    "deleted": true,
    "global_default": true,
    "datev_tax_key": 1
  },
  "accounting_type": {
    "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
    }
  },
  "id": 42,
  "currency": "EUR",
  "name": "Beispiel",
  "linked_number_title": "Beispiel",
  "mit_last_send_email": "2026-10-15T09:30:00+02:00",
  "mit_to_email": "lena.hartmann@example.org",
  "mit_should_send_email": true,
  "mit_to_address_name": "Beispiel"
}

Diese Methode liefert ein neues Rechnungsobjekt für das angegebene Angebot

GET/api/invoice/invoices/{offerIdentifier}/offers/{percentage}

Pfad-Parameter

`offerIdentifier`Pflichtstring
`percentage`Pflichtstring

Antworten

200Liefert eine neue Rechnung für das angegebene Angebot.Invoice5

Felder anzeigen (45)

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.
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%
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.
base_booking_groupBaseBookingGroup10
Buchungsgruppe, auf der das Dokument basiert.
Felder anzeigen (16)
- idinteger
  Primärschlüssel der Buchungsgruppe. Interne ID.
- start_timestring (date-time)
  Beginn der Buchungsgruppe.
- end_timestring (date-time)
  Ende der Buchungsgruppe.
- booking_typestring
  Art der Buchungen in der Gruppe.
- booking_statusstring
  Status der Buchungen in der Gruppe.
- externalboolean
  Die Gruppe wurde von einer externen Stelle erstellt.
- billing_typestring
  Abrechnungsart der Gruppe, zum Beispiel je Buchung oder je Gruppe.
- people_countinteger
  Anzahl der Personen in der Gruppe.
- createdstring (date-time)
  Zeitpunkt, zu dem der Datensatz angelegt wurde.
- updatedstring (date-time)
  Zeitpunkt, zu dem der Datensatz zuletzt aktualisiert wurde.
- namestring
  Name der Einheit.
- deletedboolean
  Diese Eigenschaft markiert eine Entität als gelöscht / archiviert
- deletion_reasonstring
  Grund der Löschung.
- deletion_datestring (date-time)
  Zeitpunkt der Löschung.
- colorstring
  Hintergrundfarbe als Hexwert.
- fg_colorstring
  Vordergrundfarbe als Hex-Wert.
search_stringstring
Text, unter dem die Entität gesucht werden kann.
accounting_typeAccountingTypePflicht
Buchungsart der Rechnung.
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)
payment_typePaymentType
Zahlungsart der Rechnung.
Felder anzeigen (10)
- idinteger
  Primärschlüssel des Zahlungstyps. Interne ID.
- namestring
  Name der Zahlungsart, zum Beispiel Überweisung oder Barzahlung.
- autoboolean
  Zahlungen dieses Typs werden automatisch zugeordnet.
- conditionsstring
  Bedingungen für die Zuordnung von Zahlungen zu diesem Typ.
- linked_keywordsstring
  Schlüsselwörter in Banktransaktionen, die mit dieser Zahlungsart verknüpft werden.
- global_defaultboolean
  Standard-Zahlungsart für neue Rechnungen.
- bank_import_defaultboolean
  Standard-Zahlungsart für Bankimporte.
- is_direct_debitboolean
  Die Zahlungsart ist ein Lastschriftverfahren.
- is_externalboolean
  Die Zahlung wird über einen externen Dienst abgewickelt.
- deletedboolean
  Diese Eigenschaft markiert eine Entität als gelöscht / archiviert
payment_goalPaymentGoal
Zahlungsbedingung der Rechnung.
Felder anzeigen (5)
- idinteger
  Primärschlüssel des Zahlungsziels. Interne ID.
- namestring
  Name der Zahlungsbedingung, zum Beispiel 14 Tage.
- date_stringstring
  Datumsmuster der Zahlungsfrist als Text.
- deletedboolean
  Die Zahlungsfrist wird gelöscht.
- global_defaultboolean
  Standard-Zahlungsziel für neue Rechnungen.
expense_categoryExpenseCategory10
EÜR-Kategorie für diese Rechnung (Einnahmen-Zuordnung) Wenn nicht gesetzt, wird die Default-Kategorie des AccountingTypes verwendet
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.
itemsarray<InvoiceItem5>
Positionen der Rechnung.
Felder anzeigen (18)
- idinteger
  Primärschlüssel der Rechnungsposition. Interne ID.
- descriptionstring
  Beschreibung der Rechnungsposition.
- price_is_bruttoboolean
  Ob der Preis ein Bruttopreis inklusive Steuer ist.
- skustring
  Artikelnummer (Stock Keeping Unit)
- barcodestring
  Barcode (ISBN, UPC, GTIN usw.)
- item_typestring
  Typ (Item, Shipping)
- netto_valuenumber (float)
  Nettowert der Rechnungsposition.
- brutto_valuenumber (float)
  Bruttowert der Rechnungsposition.
- tax_valuenumber (float)
  Steuerbetrag der Rechnungsposition.
- quantitynumber (float)Pflicht
  Menge der Rechnungsposition.
- pricenumber (float)Pflicht
  Einzelpreis der Rechnungsposition.
- namestringPflicht
  Name der Rechnungsposition.
- unitstringPflicht
  Einheit der Rechnungsposition.
- taxTax
  Auf die Rechnungsposition angewendeter Steuersatz.
- invoiceInvoice5
  Rechnung, zu der der Eintrag gehört.
- project_itemCRMProjectItem11
  Projektposition, aus der die Rechnungsposition erstellt wurde.
- base_event_sign_upBaseEventSignUp11
  Anmeldung, für die die Position angelegt wurde.
- productPredefinedBillingItem18
  Produkt der Position.
buyerInvoiceBuyer5
Käufer der Rechnung.
Felder anzeigen (29)
- idinteger
  Primärschlüssel des Clients. Interne ID.
- namestring
  Name des Kunden auf der Rechnung.
- vat_idstring
  USt-IdNr. des Kunden.
- taxnumberstring
  Steuernummer des Kunden.
- buyer_reference_idstring
  Leitweg-ID oder vom Kunden definierte individuelle Referenz-ID
- secondary_namestring
  Zweite Namenszeile des Kunden auf der Rechnung.
- addressstring
  Adresse als Text.
- address_streetstring
  Straße der Adresse.
- address_house_numberstring
  Hausnummer der Adresse.
- address_street_levelstring
  Straße und Hausnummer der Adresse.
- address_costring
  Care-of-Zeile der Adresse.
- address_citystring
  Ort der Adresse.
- address_zipstring
  Postleitzahl der Adresse.
- address_admin_level1string
  Erste Verwaltungsebene der Adresse, z. B. das Bundesland.
- address_countrystring
  Ländercode der Adresse.
- address_full_countrystring
  Vollständiger Name des Landes der Adresse.
- address_geo_latstring
  Breitengrad der Adresse.
- address_geo_lngstring
  Längengrad der Adresse.
- address_external_provider_idstring
  Feld zur Speicherung der externen Anbieter-ID der Adresse, z. B. Google-Maps-PlaceID wie google:ChIJVcKw5r90sEcRhdjNq6NItqE
- numberstring
  Kundennummer des Käufers.
- search_stringstring
  Text, unter dem die Entität gesucht werden kann.
- payment_ownerstring
  Kontoinhaber der Lastschrift.
- payment_institutionstring
  Name der Bank des Lastschrifteinzugs.
- payment_bicstring
  BIC des Bankkontos.
- payment_ibanstring
  IBAN des Bankkontos.
- payment_mandatestring
  Referenz des SEPA-Mandats.
- payment_mandate_sign_datestring (date-time)
  Datum, an dem das SEPA-Mandat unterschrieben wurde.
- payment_mandate_valid_until_datestring (date-time)
  Datum, bis zu dem das SEPA-Mandat gültig ist.
- invoiceInvoice5
  Rechnung, zu der der Käufer gehört.
payment_datestring (date-time)
Datum, an dem die Rechnung bezahlt wurde.
vat_categorystring
Der umsatzsteuerliche Sachverhalt. Der Steuersatz sagt nicht, in welche Zeile der Voranmeldung ein Umsatz gehört. Null Prozent stehen an einer innergemeinschaftlichen Lieferung (Kennzahl 41), an einer Ausfuhr (43), an einer Leistung nach § 13b UStG (60) und an einem steuerfreien Umsatz nach § 4 UStG (48) - vier verschiedene Zeilen, derselbe Steuersatz. Hier ist die einzige Stelle, an der jemand das weiß: beim Schreiben der Rechnung ist bekannt, ob der Kunde eine USt-IdNr. hat und wohin die Ware geht. Später ist es nicht mehr rekonstruierbar. Ohne Angabe der Regelfall - alles andere war bisher nicht erfassbar.
is_payment_date_from_ext_serviceboolean
Das Zahlungsdatum stammt von einem externen Dienst.
direct_debit_exportedboolean
Die Rechnung wurde für das Lastschriftverfahren exportiert.
offerOffer11
Angebot, aus dem die Rechnung erstellt wurde.
Felder anzeigen (36)
- 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.
- base_booking_groupBaseBookingGroup10
  Buchungsgruppe, auf der das Dokument basiert.
- search_stringstring
  Text, unter dem die Entität gesucht werden kann.
- offer_accounting_typeOfferAccountingTypePflicht
  Buchungsart des Angebots.
- itemsarray<OfferItem10>
  Positionen des Angebots.
- buyerOfferBuyer10
  Käufer des Angebots.
- accepted_datestring (date-time)
  Datum, an dem das Angebot angenommen wurde.
- is_accepted_date_from_ext_serviceboolean
  Das Annahmedatum stammt von einem externen Dienst.
- projectCRMProject19
  Projekt, zu dem das Angebot gehört.
- invoicesarray<Invoice5>
  Aus dem Angebot erstellte Rechnungen.
- base_event_sign_upBaseEventSignUp11
  Anmeldung, für die das Angebot angelegt wurde.
- base_bookingBaseBooking12
  Buchung, für die das Angebot erstellt wurde.
- base_event_sign_up_groupBaseEventSignUpGroup2
  Anmeldegruppe, für die das Angebot angelegt wurde.
time_reportsarray<ProjectTimeReport6>
Auf der Rechnung abgerechnete Zeitberichte.
Felder anzeigen (8)
- idinteger
  Primärschlüssel des Projektzeitberichts. Interne ID.
- projectCRMProject19
  Projekt, zu dem der Zeitbericht gehört.
- invoiceInvoice5
  Rechnung, auf der der Zeitbericht abgerechnet wurde.
- time_billed_on_ticket_closeboolean
  Die Zeit wird abgerechnet, wenn das Ticket geschlossen wird.
- startstring (date-time)
  Beginn des gemeldeten Zeitraums.
- endstring (date-time)
  Ende des gemeldeten Zeitraums.
- time_string_billablestring
  Abrechnungsfähige Zeit als Text.
- time_string_not_billablestring
  Nicht abrechenbare Zeit als Text.
payment_provider_statusstring
Status beim Zahlungsanbieter.
payment_provider_referencestring
Referenz beim Zahlungsanbieter.
payment_provider_transaction_referencestring
Transaktionsreferenz beim Zahlungsanbieter.
cancel_datestring (date-time)
Datum, an dem die Rechnung storniert wurde.
cancel_textstring
Text der Stornierung.
base_event_sign_upBaseEventSignUp11
Anmeldung, für die die Rechnung angelegt wurde.
Felder anzeigen (4)
- bib_range_idinteger
- age_classstring
  Altersklasse nach DLV, z. B. M40 – berechnet aus Geburtstag, Geschlecht und Veranstaltungsdatum.
- idinteger
  Primärschlüssel der Anmeldung. Interne ID.
- … 58 weitere Felder
… 7 weitere Felder

Anfrage

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

const options = {method: 'GET', headers: {'x-iw-jwt-token': '<TOKEN>'}};

fetch('https://eure-instanz.iw-erp.de/api/invoice/invoices/42/offers/42', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://eure-instanz.iw-erp.de/api/invoice/invoices/42/offers/42"

headers = {"x-iw-jwt-token": "<TOKEN>"}

response = requests.get(url, headers=headers)

print(response.text)

<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://eure-instanz.iw-erp.de/api/invoice/invoices/42/offers/42', [
  'headers' => [
    'x-iw-jwt-token' => '<TOKEN>',
  ],
]);

echo $response->getBody();

using System.Net.Http.Headers;
var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://eure-instanz.iw-erp.de/api/invoice/invoices/42/offers/42"),
  Headers =
  {
    { "x-iw-jwt-token", "<TOKEN>" },
  },
};
using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://eure-instanz.iw-erp.de/api/invoice/invoices/42/offers/42")
  .get()
  .addHeader("x-iw-jwt-token", "<TOKEN>")
  .build();

Response response = client.newCall(request).execute();

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://eure-instanz.iw-erp.de/api/invoice/invoices/42/offers/42"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-iw-jwt-token", "<TOKEN>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

Dart mit dem Package iw_erp_api

import 'package:iw_erp_api/clients/billing_invoice_controller.dart';
import 'package:iw_erp_api/logic/iw_api_state.dart';

IwApiState().host = 'eure-instanz.iw-erp.de';
IwApiState().currentJwtApiToken = '<TOKEN>';

final result = await BillingInvoiceController.getForOffer('42', 42);
if (result.success) {
  print(result.data);
}

Antwort 200 application/json

{
  "tax": {
    "name": "Beispiel",
    "id": 42,
    "value": 1.5,
    "deleted": true,
    "global_default": true,
    "datev_tax_key": 1
  },
  "accounting_type": {
    "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
    }
  },
  "id": 42,
  "currency": "EUR",
  "name": "Beispiel",
  "linked_number_title": "Beispiel",
  "cancel_text": "Text",
  "token": "string",
  "number": 1,
  "manual_number_prefix": "string"
}

Diese Methode liefert ein neues Rechnungsobjekt für eine einzelne Projektposition

GET/api/invoice/invoices/{projectItemIdentifier}/projectitem

Pfad-Parameter

projectItemIdentifierPflichtstring

Antworten

200Liefert eine neue Rechnung für ein einzelnes ProjectItem.Invoice5

Felder anzeigen (45)

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.
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%
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.
base_booking_groupBaseBookingGroup10
Buchungsgruppe, auf der das Dokument basiert.
Felder anzeigen (16)
- idinteger
  Primärschlüssel der Buchungsgruppe. Interne ID.
- start_timestring (date-time)
  Beginn der Buchungsgruppe.
- end_timestring (date-time)
  Ende der Buchungsgruppe.
- booking_typestring
  Art der Buchungen in der Gruppe.
- booking_statusstring
  Status der Buchungen in der Gruppe.
- externalboolean
  Die Gruppe wurde von einer externen Stelle erstellt.
- billing_typestring
  Abrechnungsart der Gruppe, zum Beispiel je Buchung oder je Gruppe.
- people_countinteger
  Anzahl der Personen in der Gruppe.
- createdstring (date-time)
  Zeitpunkt, zu dem der Datensatz angelegt wurde.
- updatedstring (date-time)
  Zeitpunkt, zu dem der Datensatz zuletzt aktualisiert wurde.
- namestring
  Name der Einheit.
- deletedboolean
  Diese Eigenschaft markiert eine Entität als gelöscht / archiviert
- deletion_reasonstring
  Grund der Löschung.
- deletion_datestring (date-time)
  Zeitpunkt der Löschung.
- colorstring
  Hintergrundfarbe als Hexwert.
- fg_colorstring
  Vordergrundfarbe als Hex-Wert.
search_stringstring
Text, unter dem die Entität gesucht werden kann.
accounting_typeAccountingTypePflicht
Buchungsart der Rechnung.
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)
payment_typePaymentType
Zahlungsart der Rechnung.
Felder anzeigen (10)
- idinteger
  Primärschlüssel des Zahlungstyps. Interne ID.
- namestring
  Name der Zahlungsart, zum Beispiel Überweisung oder Barzahlung.
- autoboolean
  Zahlungen dieses Typs werden automatisch zugeordnet.
- conditionsstring
  Bedingungen für die Zuordnung von Zahlungen zu diesem Typ.
- linked_keywordsstring
  Schlüsselwörter in Banktransaktionen, die mit dieser Zahlungsart verknüpft werden.
- global_defaultboolean
  Standard-Zahlungsart für neue Rechnungen.
- bank_import_defaultboolean
  Standard-Zahlungsart für Bankimporte.
- is_direct_debitboolean
  Die Zahlungsart ist ein Lastschriftverfahren.
- is_externalboolean
  Die Zahlung wird über einen externen Dienst abgewickelt.
- deletedboolean
  Diese Eigenschaft markiert eine Entität als gelöscht / archiviert
payment_goalPaymentGoal
Zahlungsbedingung der Rechnung.
Felder anzeigen (5)
- idinteger
  Primärschlüssel des Zahlungsziels. Interne ID.
- namestring
  Name der Zahlungsbedingung, zum Beispiel 14 Tage.
- date_stringstring
  Datumsmuster der Zahlungsfrist als Text.
- deletedboolean
  Die Zahlungsfrist wird gelöscht.
- global_defaultboolean
  Standard-Zahlungsziel für neue Rechnungen.
expense_categoryExpenseCategory10
EÜR-Kategorie für diese Rechnung (Einnahmen-Zuordnung) Wenn nicht gesetzt, wird die Default-Kategorie des AccountingTypes verwendet
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.
itemsarray<InvoiceItem5>
Positionen der Rechnung.
Felder anzeigen (18)
- idinteger
  Primärschlüssel der Rechnungsposition. Interne ID.
- descriptionstring
  Beschreibung der Rechnungsposition.
- price_is_bruttoboolean
  Ob der Preis ein Bruttopreis inklusive Steuer ist.
- skustring
  Artikelnummer (Stock Keeping Unit)
- barcodestring
  Barcode (ISBN, UPC, GTIN usw.)
- item_typestring
  Typ (Item, Shipping)
- netto_valuenumber (float)
  Nettowert der Rechnungsposition.
- brutto_valuenumber (float)
  Bruttowert der Rechnungsposition.
- tax_valuenumber (float)
  Steuerbetrag der Rechnungsposition.
- quantitynumber (float)Pflicht
  Menge der Rechnungsposition.
- pricenumber (float)Pflicht
  Einzelpreis der Rechnungsposition.
- namestringPflicht
  Name der Rechnungsposition.
- unitstringPflicht
  Einheit der Rechnungsposition.
- taxTax
  Auf die Rechnungsposition angewendeter Steuersatz.
- invoiceInvoice5
  Rechnung, zu der der Eintrag gehört.
- project_itemCRMProjectItem11
  Projektposition, aus der die Rechnungsposition erstellt wurde.
- base_event_sign_upBaseEventSignUp11
  Anmeldung, für die die Position angelegt wurde.
- productPredefinedBillingItem18
  Produkt der Position.
buyerInvoiceBuyer5
Käufer der Rechnung.
Felder anzeigen (29)
- idinteger
  Primärschlüssel des Clients. Interne ID.
- namestring
  Name des Kunden auf der Rechnung.
- vat_idstring
  USt-IdNr. des Kunden.
- taxnumberstring
  Steuernummer des Kunden.
- buyer_reference_idstring
  Leitweg-ID oder vom Kunden definierte individuelle Referenz-ID
- secondary_namestring
  Zweite Namenszeile des Kunden auf der Rechnung.
- addressstring
  Adresse als Text.
- address_streetstring
  Straße der Adresse.
- address_house_numberstring
  Hausnummer der Adresse.
- address_street_levelstring
  Straße und Hausnummer der Adresse.
- address_costring
  Care-of-Zeile der Adresse.
- address_citystring
  Ort der Adresse.
- address_zipstring
  Postleitzahl der Adresse.
- address_admin_level1string
  Erste Verwaltungsebene der Adresse, z. B. das Bundesland.
- address_countrystring
  Ländercode der Adresse.
- address_full_countrystring
  Vollständiger Name des Landes der Adresse.
- address_geo_latstring
  Breitengrad der Adresse.
- address_geo_lngstring
  Längengrad der Adresse.
- address_external_provider_idstring
  Feld zur Speicherung der externen Anbieter-ID der Adresse, z. B. Google-Maps-PlaceID wie google:ChIJVcKw5r90sEcRhdjNq6NItqE
- numberstring
  Kundennummer des Käufers.
- search_stringstring
  Text, unter dem die Entität gesucht werden kann.
- payment_ownerstring
  Kontoinhaber der Lastschrift.
- payment_institutionstring
  Name der Bank des Lastschrifteinzugs.
- payment_bicstring
  BIC des Bankkontos.
- payment_ibanstring
  IBAN des Bankkontos.
- payment_mandatestring
  Referenz des SEPA-Mandats.
- payment_mandate_sign_datestring (date-time)
  Datum, an dem das SEPA-Mandat unterschrieben wurde.
- payment_mandate_valid_until_datestring (date-time)
  Datum, bis zu dem das SEPA-Mandat gültig ist.
- invoiceInvoice5
  Rechnung, zu der der Käufer gehört.
payment_datestring (date-time)
Datum, an dem die Rechnung bezahlt wurde.
vat_categorystring
Der umsatzsteuerliche Sachverhalt. Der Steuersatz sagt nicht, in welche Zeile der Voranmeldung ein Umsatz gehört. Null Prozent stehen an einer innergemeinschaftlichen Lieferung (Kennzahl 41), an einer Ausfuhr (43), an einer Leistung nach § 13b UStG (60) und an einem steuerfreien Umsatz nach § 4 UStG (48) - vier verschiedene Zeilen, derselbe Steuersatz. Hier ist die einzige Stelle, an der jemand das weiß: beim Schreiben der Rechnung ist bekannt, ob der Kunde eine USt-IdNr. hat und wohin die Ware geht. Später ist es nicht mehr rekonstruierbar. Ohne Angabe der Regelfall - alles andere war bisher nicht erfassbar.
is_payment_date_from_ext_serviceboolean
Das Zahlungsdatum stammt von einem externen Dienst.
direct_debit_exportedboolean
Die Rechnung wurde für das Lastschriftverfahren exportiert.
offerOffer11
Angebot, aus dem die Rechnung erstellt wurde.
Felder anzeigen (36)
- 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.
- base_booking_groupBaseBookingGroup10
  Buchungsgruppe, auf der das Dokument basiert.
- search_stringstring
  Text, unter dem die Entität gesucht werden kann.
- offer_accounting_typeOfferAccountingTypePflicht
  Buchungsart des Angebots.
- itemsarray<OfferItem10>
  Positionen des Angebots.
- buyerOfferBuyer10
  Käufer des Angebots.
- accepted_datestring (date-time)
  Datum, an dem das Angebot angenommen wurde.
- is_accepted_date_from_ext_serviceboolean
  Das Annahmedatum stammt von einem externen Dienst.
- projectCRMProject19
  Projekt, zu dem das Angebot gehört.
- invoicesarray<Invoice5>
  Aus dem Angebot erstellte Rechnungen.
- base_event_sign_upBaseEventSignUp11
  Anmeldung, für die das Angebot angelegt wurde.
- base_bookingBaseBooking12
  Buchung, für die das Angebot erstellt wurde.
- base_event_sign_up_groupBaseEventSignUpGroup2
  Anmeldegruppe, für die das Angebot angelegt wurde.
time_reportsarray<ProjectTimeReport6>
Auf der Rechnung abgerechnete Zeitberichte.
Felder anzeigen (8)
- idinteger
  Primärschlüssel des Projektzeitberichts. Interne ID.
- projectCRMProject19
  Projekt, zu dem der Zeitbericht gehört.
- invoiceInvoice5
  Rechnung, auf der der Zeitbericht abgerechnet wurde.
- time_billed_on_ticket_closeboolean
  Die Zeit wird abgerechnet, wenn das Ticket geschlossen wird.
- startstring (date-time)
  Beginn des gemeldeten Zeitraums.
- endstring (date-time)
  Ende des gemeldeten Zeitraums.
- time_string_billablestring
  Abrechnungsfähige Zeit als Text.
- time_string_not_billablestring
  Nicht abrechenbare Zeit als Text.
payment_provider_statusstring
Status beim Zahlungsanbieter.
payment_provider_referencestring
Referenz beim Zahlungsanbieter.
payment_provider_transaction_referencestring
Transaktionsreferenz beim Zahlungsanbieter.
cancel_datestring (date-time)
Datum, an dem die Rechnung storniert wurde.
cancel_textstring
Text der Stornierung.
base_event_sign_upBaseEventSignUp11
Anmeldung, für die die Rechnung angelegt wurde.
Felder anzeigen (4)
- bib_range_idinteger
- age_classstring
  Altersklasse nach DLV, z. B. M40 – berechnet aus Geburtstag, Geschlecht und Veranstaltungsdatum.
- idinteger
  Primärschlüssel der Anmeldung. Interne ID.
- … 58 weitere Felder
… 7 weitere Felder

Anfrage

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

const options = {method: 'GET', headers: {'x-iw-jwt-token': '<TOKEN>'}};

fetch('https://eure-instanz.iw-erp.de/api/invoice/invoices/42/projectitem', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://eure-instanz.iw-erp.de/api/invoice/invoices/42/projectitem"

headers = {"x-iw-jwt-token": "<TOKEN>"}

response = requests.get(url, headers=headers)

print(response.text)

<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://eure-instanz.iw-erp.de/api/invoice/invoices/42/projectitem', [
  'headers' => [
    'x-iw-jwt-token' => '<TOKEN>',
  ],
]);

echo $response->getBody();

using System.Net.Http.Headers;
var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://eure-instanz.iw-erp.de/api/invoice/invoices/42/projectitem"),
  Headers =
  {
    { "x-iw-jwt-token", "<TOKEN>" },
  },
};
using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://eure-instanz.iw-erp.de/api/invoice/invoices/42/projectitem")
  .get()
  .addHeader("x-iw-jwt-token", "<TOKEN>")
  .build();

Response response = client.newCall(request).execute();

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://eure-instanz.iw-erp.de/api/invoice/invoices/42/projectitem"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-iw-jwt-token", "<TOKEN>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

Dart mit dem Package iw_erp_api

import 'package:iw_erp_api/clients/billing_invoice_controller.dart';
import 'package:iw_erp_api/logic/iw_api_state.dart';

IwApiState().host = 'eure-instanz.iw-erp.de';
IwApiState().currentJwtApiToken = '<TOKEN>';

final result = await BillingInvoiceController.getForProjectItem('42');
if (result.success) {
  print(result.data);
}

Antwort 200 application/json

{
  "tax": {
    "name": "Beispiel",
    "id": 42,
    "value": 1.5,
    "deleted": true,
    "global_default": true,
    "datev_tax_key": 1
  },
  "accounting_type": {
    "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
    }
  },
  "id": 42,
  "currency": "EUR",
  "name": "Beispiel",
  "linked_number_title": "Beispiel",
  "cancel_text": "Text",
  "token": "string",
  "number": 1,
  "manual_number_prefix": "string"
}

Diese Methode liefert ein neues Rechnungsobjekt für das Projekt

GET/api/invoice/invoices/{projectIdentifier}/project

Pfad-Parameter

projectIdentifierPflichtstring

Antworten

200Liefert eine neue Rechnung für ein Projekt.Invoice5

Felder anzeigen (45)

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.
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%
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.
base_booking_groupBaseBookingGroup10
Buchungsgruppe, auf der das Dokument basiert.
Felder anzeigen (16)
- idinteger
  Primärschlüssel der Buchungsgruppe. Interne ID.
- start_timestring (date-time)
  Beginn der Buchungsgruppe.
- end_timestring (date-time)
  Ende der Buchungsgruppe.
- booking_typestring
  Art der Buchungen in der Gruppe.
- booking_statusstring
  Status der Buchungen in der Gruppe.
- externalboolean
  Die Gruppe wurde von einer externen Stelle erstellt.
- billing_typestring
  Abrechnungsart der Gruppe, zum Beispiel je Buchung oder je Gruppe.
- people_countinteger
  Anzahl der Personen in der Gruppe.
- createdstring (date-time)
  Zeitpunkt, zu dem der Datensatz angelegt wurde.
- updatedstring (date-time)
  Zeitpunkt, zu dem der Datensatz zuletzt aktualisiert wurde.
- namestring
  Name der Einheit.
- deletedboolean
  Diese Eigenschaft markiert eine Entität als gelöscht / archiviert
- deletion_reasonstring
  Grund der Löschung.
- deletion_datestring (date-time)
  Zeitpunkt der Löschung.
- colorstring
  Hintergrundfarbe als Hexwert.
- fg_colorstring
  Vordergrundfarbe als Hex-Wert.
search_stringstring
Text, unter dem die Entität gesucht werden kann.
accounting_typeAccountingTypePflicht
Buchungsart der Rechnung.
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)
payment_typePaymentType
Zahlungsart der Rechnung.
Felder anzeigen (10)
- idinteger
  Primärschlüssel des Zahlungstyps. Interne ID.
- namestring
  Name der Zahlungsart, zum Beispiel Überweisung oder Barzahlung.
- autoboolean
  Zahlungen dieses Typs werden automatisch zugeordnet.
- conditionsstring
  Bedingungen für die Zuordnung von Zahlungen zu diesem Typ.
- linked_keywordsstring
  Schlüsselwörter in Banktransaktionen, die mit dieser Zahlungsart verknüpft werden.
- global_defaultboolean
  Standard-Zahlungsart für neue Rechnungen.
- bank_import_defaultboolean
  Standard-Zahlungsart für Bankimporte.
- is_direct_debitboolean
  Die Zahlungsart ist ein Lastschriftverfahren.
- is_externalboolean
  Die Zahlung wird über einen externen Dienst abgewickelt.
- deletedboolean
  Diese Eigenschaft markiert eine Entität als gelöscht / archiviert
payment_goalPaymentGoal
Zahlungsbedingung der Rechnung.
Felder anzeigen (5)
- idinteger
  Primärschlüssel des Zahlungsziels. Interne ID.
- namestring
  Name der Zahlungsbedingung, zum Beispiel 14 Tage.
- date_stringstring
  Datumsmuster der Zahlungsfrist als Text.
- deletedboolean
  Die Zahlungsfrist wird gelöscht.
- global_defaultboolean
  Standard-Zahlungsziel für neue Rechnungen.
expense_categoryExpenseCategory10
EÜR-Kategorie für diese Rechnung (Einnahmen-Zuordnung) Wenn nicht gesetzt, wird die Default-Kategorie des AccountingTypes verwendet
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.
itemsarray<InvoiceItem5>
Positionen der Rechnung.
Felder anzeigen (18)
- idinteger
  Primärschlüssel der Rechnungsposition. Interne ID.
- descriptionstring
  Beschreibung der Rechnungsposition.
- price_is_bruttoboolean
  Ob der Preis ein Bruttopreis inklusive Steuer ist.
- skustring
  Artikelnummer (Stock Keeping Unit)
- barcodestring
  Barcode (ISBN, UPC, GTIN usw.)
- item_typestring
  Typ (Item, Shipping)
- netto_valuenumber (float)
  Nettowert der Rechnungsposition.
- brutto_valuenumber (float)
  Bruttowert der Rechnungsposition.
- tax_valuenumber (float)
  Steuerbetrag der Rechnungsposition.
- quantitynumber (float)Pflicht
  Menge der Rechnungsposition.
- pricenumber (float)Pflicht
  Einzelpreis der Rechnungsposition.
- namestringPflicht
  Name der Rechnungsposition.
- unitstringPflicht
  Einheit der Rechnungsposition.
- taxTax
  Auf die Rechnungsposition angewendeter Steuersatz.
- invoiceInvoice5
  Rechnung, zu der der Eintrag gehört.
- project_itemCRMProjectItem11
  Projektposition, aus der die Rechnungsposition erstellt wurde.
- base_event_sign_upBaseEventSignUp11
  Anmeldung, für die die Position angelegt wurde.
- productPredefinedBillingItem18
  Produkt der Position.
buyerInvoiceBuyer5
Käufer der Rechnung.
Felder anzeigen (29)
- idinteger
  Primärschlüssel des Clients. Interne ID.
- namestring
  Name des Kunden auf der Rechnung.
- vat_idstring
  USt-IdNr. des Kunden.
- taxnumberstring
  Steuernummer des Kunden.
- buyer_reference_idstring
  Leitweg-ID oder vom Kunden definierte individuelle Referenz-ID
- secondary_namestring
  Zweite Namenszeile des Kunden auf der Rechnung.
- addressstring
  Adresse als Text.
- address_streetstring
  Straße der Adresse.
- address_house_numberstring
  Hausnummer der Adresse.
- address_street_levelstring
  Straße und Hausnummer der Adresse.
- address_costring
  Care-of-Zeile der Adresse.
- address_citystring
  Ort der Adresse.
- address_zipstring
  Postleitzahl der Adresse.
- address_admin_level1string
  Erste Verwaltungsebene der Adresse, z. B. das Bundesland.
- address_countrystring
  Ländercode der Adresse.
- address_full_countrystring
  Vollständiger Name des Landes der Adresse.
- address_geo_latstring
  Breitengrad der Adresse.
- address_geo_lngstring
  Längengrad der Adresse.
- address_external_provider_idstring
  Feld zur Speicherung der externen Anbieter-ID der Adresse, z. B. Google-Maps-PlaceID wie google:ChIJVcKw5r90sEcRhdjNq6NItqE
- numberstring
  Kundennummer des Käufers.
- search_stringstring
  Text, unter dem die Entität gesucht werden kann.
- payment_ownerstring
  Kontoinhaber der Lastschrift.
- payment_institutionstring
  Name der Bank des Lastschrifteinzugs.
- payment_bicstring
  BIC des Bankkontos.
- payment_ibanstring
  IBAN des Bankkontos.
- payment_mandatestring
  Referenz des SEPA-Mandats.
- payment_mandate_sign_datestring (date-time)
  Datum, an dem das SEPA-Mandat unterschrieben wurde.
- payment_mandate_valid_until_datestring (date-time)
  Datum, bis zu dem das SEPA-Mandat gültig ist.
- invoiceInvoice5
  Rechnung, zu der der Käufer gehört.
payment_datestring (date-time)
Datum, an dem die Rechnung bezahlt wurde.
vat_categorystring
Der umsatzsteuerliche Sachverhalt. Der Steuersatz sagt nicht, in welche Zeile der Voranmeldung ein Umsatz gehört. Null Prozent stehen an einer innergemeinschaftlichen Lieferung (Kennzahl 41), an einer Ausfuhr (43), an einer Leistung nach § 13b UStG (60) und an einem steuerfreien Umsatz nach § 4 UStG (48) - vier verschiedene Zeilen, derselbe Steuersatz. Hier ist die einzige Stelle, an der jemand das weiß: beim Schreiben der Rechnung ist bekannt, ob der Kunde eine USt-IdNr. hat und wohin die Ware geht. Später ist es nicht mehr rekonstruierbar. Ohne Angabe der Regelfall - alles andere war bisher nicht erfassbar.
is_payment_date_from_ext_serviceboolean
Das Zahlungsdatum stammt von einem externen Dienst.
direct_debit_exportedboolean
Die Rechnung wurde für das Lastschriftverfahren exportiert.
offerOffer11
Angebot, aus dem die Rechnung erstellt wurde.
Felder anzeigen (36)
- 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.
- base_booking_groupBaseBookingGroup10
  Buchungsgruppe, auf der das Dokument basiert.
- search_stringstring
  Text, unter dem die Entität gesucht werden kann.
- offer_accounting_typeOfferAccountingTypePflicht
  Buchungsart des Angebots.
- itemsarray<OfferItem10>
  Positionen des Angebots.
- buyerOfferBuyer10
  Käufer des Angebots.
- accepted_datestring (date-time)
  Datum, an dem das Angebot angenommen wurde.
- is_accepted_date_from_ext_serviceboolean
  Das Annahmedatum stammt von einem externen Dienst.
- projectCRMProject19
  Projekt, zu dem das Angebot gehört.
- invoicesarray<Invoice5>
  Aus dem Angebot erstellte Rechnungen.
- base_event_sign_upBaseEventSignUp11
  Anmeldung, für die das Angebot angelegt wurde.
- base_bookingBaseBooking12
  Buchung, für die das Angebot erstellt wurde.
- base_event_sign_up_groupBaseEventSignUpGroup2
  Anmeldegruppe, für die das Angebot angelegt wurde.
time_reportsarray<ProjectTimeReport6>
Auf der Rechnung abgerechnete Zeitberichte.
Felder anzeigen (8)
- idinteger
  Primärschlüssel des Projektzeitberichts. Interne ID.
- projectCRMProject19
  Projekt, zu dem der Zeitbericht gehört.
- invoiceInvoice5
  Rechnung, auf der der Zeitbericht abgerechnet wurde.
- time_billed_on_ticket_closeboolean
  Die Zeit wird abgerechnet, wenn das Ticket geschlossen wird.
- startstring (date-time)
  Beginn des gemeldeten Zeitraums.
- endstring (date-time)
  Ende des gemeldeten Zeitraums.
- time_string_billablestring
  Abrechnungsfähige Zeit als Text.
- time_string_not_billablestring
  Nicht abrechenbare Zeit als Text.
payment_provider_statusstring
Status beim Zahlungsanbieter.
payment_provider_referencestring
Referenz beim Zahlungsanbieter.
payment_provider_transaction_referencestring
Transaktionsreferenz beim Zahlungsanbieter.
cancel_datestring (date-time)
Datum, an dem die Rechnung storniert wurde.
cancel_textstring
Text der Stornierung.
base_event_sign_upBaseEventSignUp11
Anmeldung, für die die Rechnung angelegt wurde.
Felder anzeigen (4)
- bib_range_idinteger
- age_classstring
  Altersklasse nach DLV, z. B. M40 – berechnet aus Geburtstag, Geschlecht und Veranstaltungsdatum.
- idinteger
  Primärschlüssel der Anmeldung. Interne ID.
- … 58 weitere Felder
… 7 weitere Felder

Anfrage

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

const options = {method: 'GET', headers: {'x-iw-jwt-token': '<TOKEN>'}};

fetch('https://eure-instanz.iw-erp.de/api/invoice/invoices/42/project', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://eure-instanz.iw-erp.de/api/invoice/invoices/42/project"

headers = {"x-iw-jwt-token": "<TOKEN>"}

response = requests.get(url, headers=headers)

print(response.text)

<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://eure-instanz.iw-erp.de/api/invoice/invoices/42/project', [
  'headers' => [
    'x-iw-jwt-token' => '<TOKEN>',
  ],
]);

echo $response->getBody();

using System.Net.Http.Headers;
var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://eure-instanz.iw-erp.de/api/invoice/invoices/42/project"),
  Headers =
  {
    { "x-iw-jwt-token", "<TOKEN>" },
  },
};
using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://eure-instanz.iw-erp.de/api/invoice/invoices/42/project")
  .get()
  .addHeader("x-iw-jwt-token", "<TOKEN>")
  .build();

Response response = client.newCall(request).execute();

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://eure-instanz.iw-erp.de/api/invoice/invoices/42/project"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-iw-jwt-token", "<TOKEN>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

Dart mit dem Package iw_erp_api

import 'package:iw_erp_api/clients/billing_invoice_controller.dart';
import 'package:iw_erp_api/logic/iw_api_state.dart';

IwApiState().host = 'eure-instanz.iw-erp.de';
IwApiState().currentJwtApiToken = '<TOKEN>';

final result = await BillingInvoiceController.getForProject('42');
if (result.success) {
  print(result.data);
}

Antwort 200 application/json

{
  "tax": {
    "name": "Beispiel",
    "id": 42,
    "value": 1.5,
    "deleted": true,
    "global_default": true,
    "datev_tax_key": 1
  },
  "accounting_type": {
    "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
    }
  },
  "id": 42,
  "currency": "EUR",
  "name": "Beispiel",
  "linked_number_title": "Beispiel",
  "cancel_text": "Text",
  "token": "string",
  "number": 1,
  "manual_number_prefix": "string"
}

Diese Methode liefert ein neues Rechnungsobjekt für die angegebene Veranstaltungsanmeldung

GET/api/invoice/invoices/{eventSignUpIdentifier}/eventsignup

Pfad-Parameter

eventSignUpIdentifierPflichtstring

Antworten

200Liefert eine neue Rechnung für eine EventSignUp.Invoice5

Felder anzeigen (45)

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.
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%
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.
base_booking_groupBaseBookingGroup10
Buchungsgruppe, auf der das Dokument basiert.
Felder anzeigen (16)
- idinteger
  Primärschlüssel der Buchungsgruppe. Interne ID.
- start_timestring (date-time)
  Beginn der Buchungsgruppe.
- end_timestring (date-time)
  Ende der Buchungsgruppe.
- booking_typestring
  Art der Buchungen in der Gruppe.
- booking_statusstring
  Status der Buchungen in der Gruppe.
- externalboolean
  Die Gruppe wurde von einer externen Stelle erstellt.
- billing_typestring
  Abrechnungsart der Gruppe, zum Beispiel je Buchung oder je Gruppe.
- people_countinteger
  Anzahl der Personen in der Gruppe.
- createdstring (date-time)
  Zeitpunkt, zu dem der Datensatz angelegt wurde.
- updatedstring (date-time)
  Zeitpunkt, zu dem der Datensatz zuletzt aktualisiert wurde.
- namestring
  Name der Einheit.
- deletedboolean
  Diese Eigenschaft markiert eine Entität als gelöscht / archiviert
- deletion_reasonstring
  Grund der Löschung.
- deletion_datestring (date-time)
  Zeitpunkt der Löschung.
- colorstring
  Hintergrundfarbe als Hexwert.
- fg_colorstring
  Vordergrundfarbe als Hex-Wert.
search_stringstring
Text, unter dem die Entität gesucht werden kann.
accounting_typeAccountingTypePflicht
Buchungsart der Rechnung.
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)
payment_typePaymentType
Zahlungsart der Rechnung.
Felder anzeigen (10)
- idinteger
  Primärschlüssel des Zahlungstyps. Interne ID.
- namestring
  Name der Zahlungsart, zum Beispiel Überweisung oder Barzahlung.
- autoboolean
  Zahlungen dieses Typs werden automatisch zugeordnet.
- conditionsstring
  Bedingungen für die Zuordnung von Zahlungen zu diesem Typ.
- linked_keywordsstring
  Schlüsselwörter in Banktransaktionen, die mit dieser Zahlungsart verknüpft werden.
- global_defaultboolean
  Standard-Zahlungsart für neue Rechnungen.
- bank_import_defaultboolean
  Standard-Zahlungsart für Bankimporte.
- is_direct_debitboolean
  Die Zahlungsart ist ein Lastschriftverfahren.
- is_externalboolean
  Die Zahlung wird über einen externen Dienst abgewickelt.
- deletedboolean
  Diese Eigenschaft markiert eine Entität als gelöscht / archiviert
payment_goalPaymentGoal
Zahlungsbedingung der Rechnung.
Felder anzeigen (5)
- idinteger
  Primärschlüssel des Zahlungsziels. Interne ID.
- namestring
  Name der Zahlungsbedingung, zum Beispiel 14 Tage.
- date_stringstring
  Datumsmuster der Zahlungsfrist als Text.
- deletedboolean
  Die Zahlungsfrist wird gelöscht.
- global_defaultboolean
  Standard-Zahlungsziel für neue Rechnungen.
expense_categoryExpenseCategory10
EÜR-Kategorie für diese Rechnung (Einnahmen-Zuordnung) Wenn nicht gesetzt, wird die Default-Kategorie des AccountingTypes verwendet
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.
itemsarray<InvoiceItem5>
Positionen der Rechnung.
Felder anzeigen (18)
- idinteger
  Primärschlüssel der Rechnungsposition. Interne ID.
- descriptionstring
  Beschreibung der Rechnungsposition.
- price_is_bruttoboolean
  Ob der Preis ein Bruttopreis inklusive Steuer ist.
- skustring
  Artikelnummer (Stock Keeping Unit)
- barcodestring
  Barcode (ISBN, UPC, GTIN usw.)
- item_typestring
  Typ (Item, Shipping)
- netto_valuenumber (float)
  Nettowert der Rechnungsposition.
- brutto_valuenumber (float)
  Bruttowert der Rechnungsposition.
- tax_valuenumber (float)
  Steuerbetrag der Rechnungsposition.
- quantitynumber (float)Pflicht
  Menge der Rechnungsposition.
- pricenumber (float)Pflicht
  Einzelpreis der Rechnungsposition.
- namestringPflicht
  Name der Rechnungsposition.
- unitstringPflicht
  Einheit der Rechnungsposition.
- taxTax
  Auf die Rechnungsposition angewendeter Steuersatz.
- invoiceInvoice5
  Rechnung, zu der der Eintrag gehört.
- project_itemCRMProjectItem11
  Projektposition, aus der die Rechnungsposition erstellt wurde.
- base_event_sign_upBaseEventSignUp11
  Anmeldung, für die die Position angelegt wurde.
- productPredefinedBillingItem18
  Produkt der Position.
buyerInvoiceBuyer5
Käufer der Rechnung.
Felder anzeigen (29)
- idinteger
  Primärschlüssel des Clients. Interne ID.
- namestring
  Name des Kunden auf der Rechnung.
- vat_idstring
  USt-IdNr. des Kunden.
- taxnumberstring
  Steuernummer des Kunden.
- buyer_reference_idstring
  Leitweg-ID oder vom Kunden definierte individuelle Referenz-ID
- secondary_namestring
  Zweite Namenszeile des Kunden auf der Rechnung.
- addressstring
  Adresse als Text.
- address_streetstring
  Straße der Adresse.
- address_house_numberstring
  Hausnummer der Adresse.
- address_street_levelstring
  Straße und Hausnummer der Adresse.
- address_costring
  Care-of-Zeile der Adresse.
- address_citystring
  Ort der Adresse.
- address_zipstring
  Postleitzahl der Adresse.
- address_admin_level1string
  Erste Verwaltungsebene der Adresse, z. B. das Bundesland.
- address_countrystring
  Ländercode der Adresse.
- address_full_countrystring
  Vollständiger Name des Landes der Adresse.
- address_geo_latstring
  Breitengrad der Adresse.
- address_geo_lngstring
  Längengrad der Adresse.
- address_external_provider_idstring
  Feld zur Speicherung der externen Anbieter-ID der Adresse, z. B. Google-Maps-PlaceID wie google:ChIJVcKw5r90sEcRhdjNq6NItqE
- numberstring
  Kundennummer des Käufers.
- search_stringstring
  Text, unter dem die Entität gesucht werden kann.
- payment_ownerstring
  Kontoinhaber der Lastschrift.
- payment_institutionstring
  Name der Bank des Lastschrifteinzugs.
- payment_bicstring
  BIC des Bankkontos.
- payment_ibanstring
  IBAN des Bankkontos.
- payment_mandatestring
  Referenz des SEPA-Mandats.
- payment_mandate_sign_datestring (date-time)
  Datum, an dem das SEPA-Mandat unterschrieben wurde.
- payment_mandate_valid_until_datestring (date-time)
  Datum, bis zu dem das SEPA-Mandat gültig ist.
- invoiceInvoice5
  Rechnung, zu der der Käufer gehört.
payment_datestring (date-time)
Datum, an dem die Rechnung bezahlt wurde.
vat_categorystring
Der umsatzsteuerliche Sachverhalt. Der Steuersatz sagt nicht, in welche Zeile der Voranmeldung ein Umsatz gehört. Null Prozent stehen an einer innergemeinschaftlichen Lieferung (Kennzahl 41), an einer Ausfuhr (43), an einer Leistung nach § 13b UStG (60) und an einem steuerfreien Umsatz nach § 4 UStG (48) - vier verschiedene Zeilen, derselbe Steuersatz. Hier ist die einzige Stelle, an der jemand das weiß: beim Schreiben der Rechnung ist bekannt, ob der Kunde eine USt-IdNr. hat und wohin die Ware geht. Später ist es nicht mehr rekonstruierbar. Ohne Angabe der Regelfall - alles andere war bisher nicht erfassbar.
is_payment_date_from_ext_serviceboolean
Das Zahlungsdatum stammt von einem externen Dienst.
direct_debit_exportedboolean
Die Rechnung wurde für das Lastschriftverfahren exportiert.
offerOffer11
Angebot, aus dem die Rechnung erstellt wurde.
Felder anzeigen (36)
- 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.
- base_booking_groupBaseBookingGroup10
  Buchungsgruppe, auf der das Dokument basiert.
- search_stringstring
  Text, unter dem die Entität gesucht werden kann.
- offer_accounting_typeOfferAccountingTypePflicht
  Buchungsart des Angebots.
- itemsarray<OfferItem10>
  Positionen des Angebots.
- buyerOfferBuyer10
  Käufer des Angebots.
- accepted_datestring (date-time)
  Datum, an dem das Angebot angenommen wurde.
- is_accepted_date_from_ext_serviceboolean
  Das Annahmedatum stammt von einem externen Dienst.
- projectCRMProject19
  Projekt, zu dem das Angebot gehört.
- invoicesarray<Invoice5>
  Aus dem Angebot erstellte Rechnungen.
- base_event_sign_upBaseEventSignUp11
  Anmeldung, für die das Angebot angelegt wurde.
- base_bookingBaseBooking12
  Buchung, für die das Angebot erstellt wurde.
- base_event_sign_up_groupBaseEventSignUpGroup2
  Anmeldegruppe, für die das Angebot angelegt wurde.
time_reportsarray<ProjectTimeReport6>
Auf der Rechnung abgerechnete Zeitberichte.
Felder anzeigen (8)
- idinteger
  Primärschlüssel des Projektzeitberichts. Interne ID.
- projectCRMProject19
  Projekt, zu dem der Zeitbericht gehört.
- invoiceInvoice5
  Rechnung, auf der der Zeitbericht abgerechnet wurde.
- time_billed_on_ticket_closeboolean
  Die Zeit wird abgerechnet, wenn das Ticket geschlossen wird.
- startstring (date-time)
  Beginn des gemeldeten Zeitraums.
- endstring (date-time)
  Ende des gemeldeten Zeitraums.
- time_string_billablestring
  Abrechnungsfähige Zeit als Text.
- time_string_not_billablestring
  Nicht abrechenbare Zeit als Text.
payment_provider_statusstring
Status beim Zahlungsanbieter.
payment_provider_referencestring
Referenz beim Zahlungsanbieter.
payment_provider_transaction_referencestring
Transaktionsreferenz beim Zahlungsanbieter.
cancel_datestring (date-time)
Datum, an dem die Rechnung storniert wurde.
cancel_textstring
Text der Stornierung.
base_event_sign_upBaseEventSignUp11
Anmeldung, für die die Rechnung angelegt wurde.
Felder anzeigen (4)
- bib_range_idinteger
- age_classstring
  Altersklasse nach DLV, z. B. M40 – berechnet aus Geburtstag, Geschlecht und Veranstaltungsdatum.
- idinteger
  Primärschlüssel der Anmeldung. Interne ID.
- … 58 weitere Felder
… 7 weitere Felder

Anfrage

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

const options = {method: 'GET', headers: {'x-iw-jwt-token': '<TOKEN>'}};

fetch('https://eure-instanz.iw-erp.de/api/invoice/invoices/42/eventsignup', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://eure-instanz.iw-erp.de/api/invoice/invoices/42/eventsignup"

headers = {"x-iw-jwt-token": "<TOKEN>"}

response = requests.get(url, headers=headers)

print(response.text)

<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://eure-instanz.iw-erp.de/api/invoice/invoices/42/eventsignup', [
  'headers' => [
    'x-iw-jwt-token' => '<TOKEN>',
  ],
]);

echo $response->getBody();

using System.Net.Http.Headers;
var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://eure-instanz.iw-erp.de/api/invoice/invoices/42/eventsignup"),
  Headers =
  {
    { "x-iw-jwt-token", "<TOKEN>" },
  },
};
using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://eure-instanz.iw-erp.de/api/invoice/invoices/42/eventsignup")
  .get()
  .addHeader("x-iw-jwt-token", "<TOKEN>")
  .build();

Response response = client.newCall(request).execute();

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://eure-instanz.iw-erp.de/api/invoice/invoices/42/eventsignup"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-iw-jwt-token", "<TOKEN>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

Dart mit dem Package iw_erp_api

import 'package:iw_erp_api/clients/billing_invoice_controller.dart';
import 'package:iw_erp_api/logic/iw_api_state.dart';

IwApiState().host = 'eure-instanz.iw-erp.de';
IwApiState().currentJwtApiToken = '<TOKEN>';

final result = await BillingInvoiceController.getForEventSignUp('42');
if (result.success) {
  print(result.data);
}

Antwort 200 application/json

{
  "tax": {
    "name": "Beispiel",
    "id": 42,
    "value": 1.5,
    "deleted": true,
    "global_default": true,
    "datev_tax_key": 1
  },
  "accounting_type": {
    "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
    }
  },
  "id": 42,
  "currency": "EUR",
  "name": "Beispiel",
  "linked_number_title": "Beispiel",
  "cancel_text": "Text",
  "token": "string",
  "number": 1,
  "manual_number_prefix": "string"
}

Diese Methode liefert ein neues Rechnungsobjekt für die angegebene Buchung

GET/api/invoice/invoices/{bookingIdentifier}/booking

Pfad-Parameter

bookingIdentifierPflichtstring

Antworten

200Liefert eine neue Rechnung für eine Buchung.Invoice5

Felder anzeigen (45)

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.
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%
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.
base_booking_groupBaseBookingGroup10
Buchungsgruppe, auf der das Dokument basiert.
Felder anzeigen (16)
- idinteger
  Primärschlüssel der Buchungsgruppe. Interne ID.
- start_timestring (date-time)
  Beginn der Buchungsgruppe.
- end_timestring (date-time)
  Ende der Buchungsgruppe.
- booking_typestring
  Art der Buchungen in der Gruppe.
- booking_statusstring
  Status der Buchungen in der Gruppe.
- externalboolean
  Die Gruppe wurde von einer externen Stelle erstellt.
- billing_typestring
  Abrechnungsart der Gruppe, zum Beispiel je Buchung oder je Gruppe.
- people_countinteger
  Anzahl der Personen in der Gruppe.
- createdstring (date-time)
  Zeitpunkt, zu dem der Datensatz angelegt wurde.
- updatedstring (date-time)
  Zeitpunkt, zu dem der Datensatz zuletzt aktualisiert wurde.
- namestring
  Name der Einheit.
- deletedboolean
  Diese Eigenschaft markiert eine Entität als gelöscht / archiviert
- deletion_reasonstring
  Grund der Löschung.
- deletion_datestring (date-time)
  Zeitpunkt der Löschung.
- colorstring
  Hintergrundfarbe als Hexwert.
- fg_colorstring
  Vordergrundfarbe als Hex-Wert.
search_stringstring
Text, unter dem die Entität gesucht werden kann.
accounting_typeAccountingTypePflicht
Buchungsart der Rechnung.
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)
payment_typePaymentType
Zahlungsart der Rechnung.
Felder anzeigen (10)
- idinteger
  Primärschlüssel des Zahlungstyps. Interne ID.
- namestring
  Name der Zahlungsart, zum Beispiel Überweisung oder Barzahlung.
- autoboolean
  Zahlungen dieses Typs werden automatisch zugeordnet.
- conditionsstring
  Bedingungen für die Zuordnung von Zahlungen zu diesem Typ.
- linked_keywordsstring
  Schlüsselwörter in Banktransaktionen, die mit dieser Zahlungsart verknüpft werden.
- global_defaultboolean
  Standard-Zahlungsart für neue Rechnungen.
- bank_import_defaultboolean
  Standard-Zahlungsart für Bankimporte.
- is_direct_debitboolean
  Die Zahlungsart ist ein Lastschriftverfahren.
- is_externalboolean
  Die Zahlung wird über einen externen Dienst abgewickelt.
- deletedboolean
  Diese Eigenschaft markiert eine Entität als gelöscht / archiviert
payment_goalPaymentGoal
Zahlungsbedingung der Rechnung.
Felder anzeigen (5)
- idinteger
  Primärschlüssel des Zahlungsziels. Interne ID.
- namestring
  Name der Zahlungsbedingung, zum Beispiel 14 Tage.
- date_stringstring
  Datumsmuster der Zahlungsfrist als Text.
- deletedboolean
  Die Zahlungsfrist wird gelöscht.
- global_defaultboolean
  Standard-Zahlungsziel für neue Rechnungen.
expense_categoryExpenseCategory10
EÜR-Kategorie für diese Rechnung (Einnahmen-Zuordnung) Wenn nicht gesetzt, wird die Default-Kategorie des AccountingTypes verwendet
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.
itemsarray<InvoiceItem5>
Positionen der Rechnung.
Felder anzeigen (18)
- idinteger
  Primärschlüssel der Rechnungsposition. Interne ID.
- descriptionstring
  Beschreibung der Rechnungsposition.
- price_is_bruttoboolean
  Ob der Preis ein Bruttopreis inklusive Steuer ist.
- skustring
  Artikelnummer (Stock Keeping Unit)
- barcodestring
  Barcode (ISBN, UPC, GTIN usw.)
- item_typestring
  Typ (Item, Shipping)
- netto_valuenumber (float)
  Nettowert der Rechnungsposition.
- brutto_valuenumber (float)
  Bruttowert der Rechnungsposition.
- tax_valuenumber (float)
  Steuerbetrag der Rechnungsposition.
- quantitynumber (float)Pflicht
  Menge der Rechnungsposition.
- pricenumber (float)Pflicht
  Einzelpreis der Rechnungsposition.
- namestringPflicht
  Name der Rechnungsposition.
- unitstringPflicht
  Einheit der Rechnungsposition.
- taxTax
  Auf die Rechnungsposition angewendeter Steuersatz.
- invoiceInvoice5
  Rechnung, zu der der Eintrag gehört.
- project_itemCRMProjectItem11
  Projektposition, aus der die Rechnungsposition erstellt wurde.
- base_event_sign_upBaseEventSignUp11
  Anmeldung, für die die Position angelegt wurde.
- productPredefinedBillingItem18
  Produkt der Position.
buyerInvoiceBuyer5
Käufer der Rechnung.
Felder anzeigen (29)
- idinteger
  Primärschlüssel des Clients. Interne ID.
- namestring
  Name des Kunden auf der Rechnung.
- vat_idstring
  USt-IdNr. des Kunden.
- taxnumberstring
  Steuernummer des Kunden.
- buyer_reference_idstring
  Leitweg-ID oder vom Kunden definierte individuelle Referenz-ID
- secondary_namestring
  Zweite Namenszeile des Kunden auf der Rechnung.
- addressstring
  Adresse als Text.
- address_streetstring
  Straße der Adresse.
- address_house_numberstring
  Hausnummer der Adresse.
- address_street_levelstring
  Straße und Hausnummer der Adresse.
- address_costring
  Care-of-Zeile der Adresse.
- address_citystring
  Ort der Adresse.
- address_zipstring
  Postleitzahl der Adresse.
- address_admin_level1string
  Erste Verwaltungsebene der Adresse, z. B. das Bundesland.
- address_countrystring
  Ländercode der Adresse.
- address_full_countrystring
  Vollständiger Name des Landes der Adresse.
- address_geo_latstring
  Breitengrad der Adresse.
- address_geo_lngstring
  Längengrad der Adresse.
- address_external_provider_idstring
  Feld zur Speicherung der externen Anbieter-ID der Adresse, z. B. Google-Maps-PlaceID wie google:ChIJVcKw5r90sEcRhdjNq6NItqE
- numberstring
  Kundennummer des Käufers.
- search_stringstring
  Text, unter dem die Entität gesucht werden kann.
- payment_ownerstring
  Kontoinhaber der Lastschrift.
- payment_institutionstring
  Name der Bank des Lastschrifteinzugs.
- payment_bicstring
  BIC des Bankkontos.
- payment_ibanstring
  IBAN des Bankkontos.
- payment_mandatestring
  Referenz des SEPA-Mandats.
- payment_mandate_sign_datestring (date-time)
  Datum, an dem das SEPA-Mandat unterschrieben wurde.
- payment_mandate_valid_until_datestring (date-time)
  Datum, bis zu dem das SEPA-Mandat gültig ist.
- invoiceInvoice5
  Rechnung, zu der der Käufer gehört.
payment_datestring (date-time)
Datum, an dem die Rechnung bezahlt wurde.
vat_categorystring
Der umsatzsteuerliche Sachverhalt. Der Steuersatz sagt nicht, in welche Zeile der Voranmeldung ein Umsatz gehört. Null Prozent stehen an einer innergemeinschaftlichen Lieferung (Kennzahl 41), an einer Ausfuhr (43), an einer Leistung nach § 13b UStG (60) und an einem steuerfreien Umsatz nach § 4 UStG (48) - vier verschiedene Zeilen, derselbe Steuersatz. Hier ist die einzige Stelle, an der jemand das weiß: beim Schreiben der Rechnung ist bekannt, ob der Kunde eine USt-IdNr. hat und wohin die Ware geht. Später ist es nicht mehr rekonstruierbar. Ohne Angabe der Regelfall - alles andere war bisher nicht erfassbar.
is_payment_date_from_ext_serviceboolean
Das Zahlungsdatum stammt von einem externen Dienst.
direct_debit_exportedboolean
Die Rechnung wurde für das Lastschriftverfahren exportiert.
offerOffer11
Angebot, aus dem die Rechnung erstellt wurde.
Felder anzeigen (36)
- 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.
- base_booking_groupBaseBookingGroup10
  Buchungsgruppe, auf der das Dokument basiert.
- search_stringstring
  Text, unter dem die Entität gesucht werden kann.
- offer_accounting_typeOfferAccountingTypePflicht
  Buchungsart des Angebots.
- itemsarray<OfferItem10>
  Positionen des Angebots.
- buyerOfferBuyer10
  Käufer des Angebots.
- accepted_datestring (date-time)
  Datum, an dem das Angebot angenommen wurde.
- is_accepted_date_from_ext_serviceboolean
  Das Annahmedatum stammt von einem externen Dienst.
- projectCRMProject19
  Projekt, zu dem das Angebot gehört.
- invoicesarray<Invoice5>
  Aus dem Angebot erstellte Rechnungen.
- base_event_sign_upBaseEventSignUp11
  Anmeldung, für die das Angebot angelegt wurde.
- base_bookingBaseBooking12
  Buchung, für die das Angebot erstellt wurde.
- base_event_sign_up_groupBaseEventSignUpGroup2
  Anmeldegruppe, für die das Angebot angelegt wurde.
time_reportsarray<ProjectTimeReport6>
Auf der Rechnung abgerechnete Zeitberichte.
Felder anzeigen (8)
- idinteger
  Primärschlüssel des Projektzeitberichts. Interne ID.
- projectCRMProject19
  Projekt, zu dem der Zeitbericht gehört.
- invoiceInvoice5
  Rechnung, auf der der Zeitbericht abgerechnet wurde.
- time_billed_on_ticket_closeboolean
  Die Zeit wird abgerechnet, wenn das Ticket geschlossen wird.
- startstring (date-time)
  Beginn des gemeldeten Zeitraums.
- endstring (date-time)
  Ende des gemeldeten Zeitraums.
- time_string_billablestring
  Abrechnungsfähige Zeit als Text.
- time_string_not_billablestring
  Nicht abrechenbare Zeit als Text.
payment_provider_statusstring
Status beim Zahlungsanbieter.
payment_provider_referencestring
Referenz beim Zahlungsanbieter.
payment_provider_transaction_referencestring
Transaktionsreferenz beim Zahlungsanbieter.
cancel_datestring (date-time)
Datum, an dem die Rechnung storniert wurde.
cancel_textstring
Text der Stornierung.
base_event_sign_upBaseEventSignUp11
Anmeldung, für die die Rechnung angelegt wurde.
Felder anzeigen (4)
- bib_range_idinteger
- age_classstring
  Altersklasse nach DLV, z. B. M40 – berechnet aus Geburtstag, Geschlecht und Veranstaltungsdatum.
- idinteger
  Primärschlüssel der Anmeldung. Interne ID.
- … 58 weitere Felder
… 7 weitere Felder

Anfrage

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

const options = {method: 'GET', headers: {'x-iw-jwt-token': '<TOKEN>'}};

fetch('https://eure-instanz.iw-erp.de/api/invoice/invoices/42/booking', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://eure-instanz.iw-erp.de/api/invoice/invoices/42/booking"

headers = {"x-iw-jwt-token": "<TOKEN>"}

response = requests.get(url, headers=headers)

print(response.text)

<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://eure-instanz.iw-erp.de/api/invoice/invoices/42/booking', [
  'headers' => [
    'x-iw-jwt-token' => '<TOKEN>',
  ],
]);

echo $response->getBody();

using System.Net.Http.Headers;
var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://eure-instanz.iw-erp.de/api/invoice/invoices/42/booking"),
  Headers =
  {
    { "x-iw-jwt-token", "<TOKEN>" },
  },
};
using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://eure-instanz.iw-erp.de/api/invoice/invoices/42/booking")
  .get()
  .addHeader("x-iw-jwt-token", "<TOKEN>")
  .build();

Response response = client.newCall(request).execute();

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://eure-instanz.iw-erp.de/api/invoice/invoices/42/booking"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-iw-jwt-token", "<TOKEN>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

Dart mit dem Package iw_erp_api

import 'package:iw_erp_api/clients/billing_invoice_controller.dart';
import 'package:iw_erp_api/logic/iw_api_state.dart';

IwApiState().host = 'eure-instanz.iw-erp.de';
IwApiState().currentJwtApiToken = '<TOKEN>';

final result = await BillingInvoiceController.getForBaseBooking('42');
if (result.success) {
  print(result.data);
}

Antwort 200 application/json

{
  "tax": {
    "name": "Beispiel",
    "id": 42,
    "value": 1.5,
    "deleted": true,
    "global_default": true,
    "datev_tax_key": 1
  },
  "accounting_type": {
    "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
    }
  },
  "id": 42,
  "currency": "EUR",
  "name": "Beispiel",
  "linked_number_title": "Beispiel",
  "cancel_text": "Text",
  "token": "string",
  "number": 1,
  "manual_number_prefix": "string"
}

Diese Methode liefert ein neues Rechnungsobjekt für die angegebene Buchungsgruppe

GET/api/invoice/invoices/{bookingGroupIdentifier}/booking_group

Pfad-Parameter

bookingGroupIdentifierPflichtstring

Antworten

200Liefert eine neue Rechnung für eine Buchungsgruppe.Invoice5

Felder anzeigen (45)

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.
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%
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.
base_booking_groupBaseBookingGroup10
Buchungsgruppe, auf der das Dokument basiert.
Felder anzeigen (16)
- idinteger
  Primärschlüssel der Buchungsgruppe. Interne ID.
- start_timestring (date-time)
  Beginn der Buchungsgruppe.
- end_timestring (date-time)
  Ende der Buchungsgruppe.
- booking_typestring
  Art der Buchungen in der Gruppe.
- booking_statusstring
  Status der Buchungen in der Gruppe.
- externalboolean
  Die Gruppe wurde von einer externen Stelle erstellt.
- billing_typestring
  Abrechnungsart der Gruppe, zum Beispiel je Buchung oder je Gruppe.
- people_countinteger
  Anzahl der Personen in der Gruppe.
- createdstring (date-time)
  Zeitpunkt, zu dem der Datensatz angelegt wurde.
- updatedstring (date-time)
  Zeitpunkt, zu dem der Datensatz zuletzt aktualisiert wurde.
- namestring
  Name der Einheit.
- deletedboolean
  Diese Eigenschaft markiert eine Entität als gelöscht / archiviert
- deletion_reasonstring
  Grund der Löschung.
- deletion_datestring (date-time)
  Zeitpunkt der Löschung.
- colorstring
  Hintergrundfarbe als Hexwert.
- fg_colorstring
  Vordergrundfarbe als Hex-Wert.
search_stringstring
Text, unter dem die Entität gesucht werden kann.
accounting_typeAccountingTypePflicht
Buchungsart der Rechnung.
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)
payment_typePaymentType
Zahlungsart der Rechnung.
Felder anzeigen (10)
- idinteger
  Primärschlüssel des Zahlungstyps. Interne ID.
- namestring
  Name der Zahlungsart, zum Beispiel Überweisung oder Barzahlung.
- autoboolean
  Zahlungen dieses Typs werden automatisch zugeordnet.
- conditionsstring
  Bedingungen für die Zuordnung von Zahlungen zu diesem Typ.
- linked_keywordsstring
  Schlüsselwörter in Banktransaktionen, die mit dieser Zahlungsart verknüpft werden.
- global_defaultboolean
  Standard-Zahlungsart für neue Rechnungen.
- bank_import_defaultboolean
  Standard-Zahlungsart für Bankimporte.
- is_direct_debitboolean
  Die Zahlungsart ist ein Lastschriftverfahren.
- is_externalboolean
  Die Zahlung wird über einen externen Dienst abgewickelt.
- deletedboolean
  Diese Eigenschaft markiert eine Entität als gelöscht / archiviert
payment_goalPaymentGoal
Zahlungsbedingung der Rechnung.
Felder anzeigen (5)
- idinteger
  Primärschlüssel des Zahlungsziels. Interne ID.
- namestring
  Name der Zahlungsbedingung, zum Beispiel 14 Tage.
- date_stringstring
  Datumsmuster der Zahlungsfrist als Text.
- deletedboolean
  Die Zahlungsfrist wird gelöscht.
- global_defaultboolean
  Standard-Zahlungsziel für neue Rechnungen.
expense_categoryExpenseCategory10
EÜR-Kategorie für diese Rechnung (Einnahmen-Zuordnung) Wenn nicht gesetzt, wird die Default-Kategorie des AccountingTypes verwendet
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.
itemsarray<InvoiceItem5>
Positionen der Rechnung.
Felder anzeigen (18)
- idinteger
  Primärschlüssel der Rechnungsposition. Interne ID.
- descriptionstring
  Beschreibung der Rechnungsposition.
- price_is_bruttoboolean
  Ob der Preis ein Bruttopreis inklusive Steuer ist.
- skustring
  Artikelnummer (Stock Keeping Unit)
- barcodestring
  Barcode (ISBN, UPC, GTIN usw.)
- item_typestring
  Typ (Item, Shipping)
- netto_valuenumber (float)
  Nettowert der Rechnungsposition.
- brutto_valuenumber (float)
  Bruttowert der Rechnungsposition.
- tax_valuenumber (float)
  Steuerbetrag der Rechnungsposition.
- quantitynumber (float)Pflicht
  Menge der Rechnungsposition.
- pricenumber (float)Pflicht
  Einzelpreis der Rechnungsposition.
- namestringPflicht
  Name der Rechnungsposition.
- unitstringPflicht
  Einheit der Rechnungsposition.
- taxTax
  Auf die Rechnungsposition angewendeter Steuersatz.
- invoiceInvoice5
  Rechnung, zu der der Eintrag gehört.
- project_itemCRMProjectItem11
  Projektposition, aus der die Rechnungsposition erstellt wurde.
- base_event_sign_upBaseEventSignUp11
  Anmeldung, für die die Position angelegt wurde.
- productPredefinedBillingItem18
  Produkt der Position.
buyerInvoiceBuyer5
Käufer der Rechnung.
Felder anzeigen (29)
- idinteger
  Primärschlüssel des Clients. Interne ID.
- namestring
  Name des Kunden auf der Rechnung.
- vat_idstring
  USt-IdNr. des Kunden.
- taxnumberstring
  Steuernummer des Kunden.
- buyer_reference_idstring
  Leitweg-ID oder vom Kunden definierte individuelle Referenz-ID
- secondary_namestring
  Zweite Namenszeile des Kunden auf der Rechnung.
- addressstring
  Adresse als Text.
- address_streetstring
  Straße der Adresse.
- address_house_numberstring
  Hausnummer der Adresse.
- address_street_levelstring
  Straße und Hausnummer der Adresse.
- address_costring
  Care-of-Zeile der Adresse.
- address_citystring
  Ort der Adresse.
- address_zipstring
  Postleitzahl der Adresse.
- address_admin_level1string
  Erste Verwaltungsebene der Adresse, z. B. das Bundesland.
- address_countrystring
  Ländercode der Adresse.
- address_full_countrystring
  Vollständiger Name des Landes der Adresse.
- address_geo_latstring
  Breitengrad der Adresse.
- address_geo_lngstring
  Längengrad der Adresse.
- address_external_provider_idstring
  Feld zur Speicherung der externen Anbieter-ID der Adresse, z. B. Google-Maps-PlaceID wie google:ChIJVcKw5r90sEcRhdjNq6NItqE
- numberstring
  Kundennummer des Käufers.
- search_stringstring
  Text, unter dem die Entität gesucht werden kann.
- payment_ownerstring
  Kontoinhaber der Lastschrift.
- payment_institutionstring
  Name der Bank des Lastschrifteinzugs.
- payment_bicstring
  BIC des Bankkontos.
- payment_ibanstring
  IBAN des Bankkontos.
- payment_mandatestring
  Referenz des SEPA-Mandats.
- payment_mandate_sign_datestring (date-time)
  Datum, an dem das SEPA-Mandat unterschrieben wurde.
- payment_mandate_valid_until_datestring (date-time)
  Datum, bis zu dem das SEPA-Mandat gültig ist.
- invoiceInvoice5
  Rechnung, zu der der Käufer gehört.
payment_datestring (date-time)
Datum, an dem die Rechnung bezahlt wurde.
vat_categorystring
Der umsatzsteuerliche Sachverhalt. Der Steuersatz sagt nicht, in welche Zeile der Voranmeldung ein Umsatz gehört. Null Prozent stehen an einer innergemeinschaftlichen Lieferung (Kennzahl 41), an einer Ausfuhr (43), an einer Leistung nach § 13b UStG (60) und an einem steuerfreien Umsatz nach § 4 UStG (48) - vier verschiedene Zeilen, derselbe Steuersatz. Hier ist die einzige Stelle, an der jemand das weiß: beim Schreiben der Rechnung ist bekannt, ob der Kunde eine USt-IdNr. hat und wohin die Ware geht. Später ist es nicht mehr rekonstruierbar. Ohne Angabe der Regelfall - alles andere war bisher nicht erfassbar.
is_payment_date_from_ext_serviceboolean
Das Zahlungsdatum stammt von einem externen Dienst.
direct_debit_exportedboolean
Die Rechnung wurde für das Lastschriftverfahren exportiert.
offerOffer11
Angebot, aus dem die Rechnung erstellt wurde.
Felder anzeigen (36)
- 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.
- base_booking_groupBaseBookingGroup10
  Buchungsgruppe, auf der das Dokument basiert.
- search_stringstring
  Text, unter dem die Entität gesucht werden kann.
- offer_accounting_typeOfferAccountingTypePflicht
  Buchungsart des Angebots.
- itemsarray<OfferItem10>
  Positionen des Angebots.
- buyerOfferBuyer10
  Käufer des Angebots.
- accepted_datestring (date-time)
  Datum, an dem das Angebot angenommen wurde.
- is_accepted_date_from_ext_serviceboolean
  Das Annahmedatum stammt von einem externen Dienst.
- projectCRMProject19
  Projekt, zu dem das Angebot gehört.
- invoicesarray<Invoice5>
  Aus dem Angebot erstellte Rechnungen.
- base_event_sign_upBaseEventSignUp11
  Anmeldung, für die das Angebot angelegt wurde.
- base_bookingBaseBooking12
  Buchung, für die das Angebot erstellt wurde.
- base_event_sign_up_groupBaseEventSignUpGroup2
  Anmeldegruppe, für die das Angebot angelegt wurde.
time_reportsarray<ProjectTimeReport6>
Auf der Rechnung abgerechnete Zeitberichte.
Felder anzeigen (8)
- idinteger
  Primärschlüssel des Projektzeitberichts. Interne ID.
- projectCRMProject19
  Projekt, zu dem der Zeitbericht gehört.
- invoiceInvoice5
  Rechnung, auf der der Zeitbericht abgerechnet wurde.
- time_billed_on_ticket_closeboolean
  Die Zeit wird abgerechnet, wenn das Ticket geschlossen wird.
- startstring (date-time)
  Beginn des gemeldeten Zeitraums.
- endstring (date-time)
  Ende des gemeldeten Zeitraums.
- time_string_billablestring
  Abrechnungsfähige Zeit als Text.
- time_string_not_billablestring
  Nicht abrechenbare Zeit als Text.
payment_provider_statusstring
Status beim Zahlungsanbieter.
payment_provider_referencestring
Referenz beim Zahlungsanbieter.
payment_provider_transaction_referencestring
Transaktionsreferenz beim Zahlungsanbieter.
cancel_datestring (date-time)
Datum, an dem die Rechnung storniert wurde.
cancel_textstring
Text der Stornierung.
base_event_sign_upBaseEventSignUp11
Anmeldung, für die die Rechnung angelegt wurde.
Felder anzeigen (4)
- bib_range_idinteger
- age_classstring
  Altersklasse nach DLV, z. B. M40 – berechnet aus Geburtstag, Geschlecht und Veranstaltungsdatum.
- idinteger
  Primärschlüssel der Anmeldung. Interne ID.
- … 58 weitere Felder
… 7 weitere Felder

Anfrage

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

const options = {method: 'GET', headers: {'x-iw-jwt-token': '<TOKEN>'}};

fetch('https://eure-instanz.iw-erp.de/api/invoice/invoices/42/booking_group', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://eure-instanz.iw-erp.de/api/invoice/invoices/42/booking_group"

headers = {"x-iw-jwt-token": "<TOKEN>"}

response = requests.get(url, headers=headers)

print(response.text)

<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://eure-instanz.iw-erp.de/api/invoice/invoices/42/booking_group', [
  'headers' => [
    'x-iw-jwt-token' => '<TOKEN>',
  ],
]);

echo $response->getBody();

using System.Net.Http.Headers;
var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://eure-instanz.iw-erp.de/api/invoice/invoices/42/booking_group"),
  Headers =
  {
    { "x-iw-jwt-token", "<TOKEN>" },
  },
};
using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://eure-instanz.iw-erp.de/api/invoice/invoices/42/booking_group")
  .get()
  .addHeader("x-iw-jwt-token", "<TOKEN>")
  .build();

Response response = client.newCall(request).execute();

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://eure-instanz.iw-erp.de/api/invoice/invoices/42/booking_group"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-iw-jwt-token", "<TOKEN>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

Dart mit dem Package iw_erp_api

import 'package:iw_erp_api/clients/billing_invoice_controller.dart';
import 'package:iw_erp_api/logic/iw_api_state.dart';

IwApiState().host = 'eure-instanz.iw-erp.de';
IwApiState().currentJwtApiToken = '<TOKEN>';

final result = await BillingInvoiceController.getForBaseBookingGroup('42');
if (result.success) {
  print(result.data);
}

Antwort 200 application/json

{
  "tax": {
    "name": "Beispiel",
    "id": 42,
    "value": 1.5,
    "deleted": true,
    "global_default": true,
    "datev_tax_key": 1
  },
  "accounting_type": {
    "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
    }
  },
  "id": 42,
  "currency": "EUR",
  "name": "Beispiel",
  "linked_number_title": "Beispiel",
  "cancel_text": "Text",
  "token": "string",
  "number": 1,
  "manual_number_prefix": "string"
}

Diese Methode speichert neue Rechnungsobjekte für alle Einträge der Veranstaltung

POST/api/invoice/invoices/{eventIdentifier}/events

Pfad-Parameter

eventIdentifierPflichtstring

Antworten

200Erstellt Rechnungen für alle Einträge einer Veranstaltung

Anfrage

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

const options = {method: 'POST', headers: {'x-iw-jwt-token': '<TOKEN>'}};

fetch('https://eure-instanz.iw-erp.de/api/invoice/invoices/42/events', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://eure-instanz.iw-erp.de/api/invoice/invoices/42/events"

headers = {"x-iw-jwt-token": "<TOKEN>"}

response = requests.post(url, headers=headers)

print(response.text)

<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://eure-instanz.iw-erp.de/api/invoice/invoices/42/events', [
  'headers' => [
    'x-iw-jwt-token' => '<TOKEN>',
  ],
]);

echo $response->getBody();

using System.Net.Http.Headers;
var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Post,
  RequestUri = new Uri("https://eure-instanz.iw-erp.de/api/invoice/invoices/42/events"),
  Headers =
  {
    { "x-iw-jwt-token", "<TOKEN>" },
  },
};
using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://eure-instanz.iw-erp.de/api/invoice/invoices/42/events")
  .post(null)
  .addHeader("x-iw-jwt-token", "<TOKEN>")
  .build();

Response response = client.newCall(request).execute();

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://eure-instanz.iw-erp.de/api/invoice/invoices/42/events"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("x-iw-jwt-token", "<TOKEN>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

Dart mit dem Package iw_erp_api

import 'package:iw_erp_api/clients/billing_invoice_controller.dart';
import 'package:iw_erp_api/logic/iw_api_state.dart';

IwApiState().host = 'eure-instanz.iw-erp.de';
IwApiState().currentJwtApiToken = '<TOKEN>';

final result = await BillingInvoiceController.postForEvent('42');
if (result.success) {
  print(result.data);
}

Diese Methode liefert ein neues Rechnungsobjekt für den angegebenen PersonLogBookEntry

GET/api/invoice/invoices/{logBookEntryIdentifier}/logbookentryadd

Pfad-Parameter

logBookEntryIdentifierPflichtstring

Antworten

200Liefert eine neue Rechnung für einen LogBookEntry (Hinzufügen).Invoice6

Felder anzeigen (45)

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.
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%
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.
base_booking_groupBaseBookingGroup10
Buchungsgruppe, auf der das Dokument basiert.
Felder anzeigen (16)
- idinteger
  Primärschlüssel der Buchungsgruppe. Interne ID.
- start_timestring (date-time)
  Beginn der Buchungsgruppe.
- end_timestring (date-time)
  Ende der Buchungsgruppe.
- booking_typestring
  Art der Buchungen in der Gruppe.
- booking_statusstring
  Status der Buchungen in der Gruppe.
- externalboolean
  Die Gruppe wurde von einer externen Stelle erstellt.
- billing_typestring
  Abrechnungsart der Gruppe, zum Beispiel je Buchung oder je Gruppe.
- people_countinteger
  Anzahl der Personen in der Gruppe.
- createdstring (date-time)
  Zeitpunkt, zu dem der Datensatz angelegt wurde.
- updatedstring (date-time)
  Zeitpunkt, zu dem der Datensatz zuletzt aktualisiert wurde.
- namestring
  Name der Einheit.
- deletedboolean
  Diese Eigenschaft markiert eine Entität als gelöscht / archiviert
- deletion_reasonstring
  Grund der Löschung.
- deletion_datestring (date-time)
  Zeitpunkt der Löschung.
- colorstring
  Hintergrundfarbe als Hexwert.
- fg_colorstring
  Vordergrundfarbe als Hex-Wert.
search_stringstring
Text, unter dem die Entität gesucht werden kann.
accounting_typeAccountingTypePflicht
Buchungsart der Rechnung.
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)
payment_typePaymentType
Zahlungsart der Rechnung.
Felder anzeigen (10)
- idinteger
  Primärschlüssel des Zahlungstyps. Interne ID.
- namestring
  Name der Zahlungsart, zum Beispiel Überweisung oder Barzahlung.
- autoboolean
  Zahlungen dieses Typs werden automatisch zugeordnet.
- conditionsstring
  Bedingungen für die Zuordnung von Zahlungen zu diesem Typ.
- linked_keywordsstring
  Schlüsselwörter in Banktransaktionen, die mit dieser Zahlungsart verknüpft werden.
- global_defaultboolean
  Standard-Zahlungsart für neue Rechnungen.
- bank_import_defaultboolean
  Standard-Zahlungsart für Bankimporte.
- is_direct_debitboolean
  Die Zahlungsart ist ein Lastschriftverfahren.
- is_externalboolean
  Die Zahlung wird über einen externen Dienst abgewickelt.
- deletedboolean
  Diese Eigenschaft markiert eine Entität als gelöscht / archiviert
payment_goalPaymentGoal
Zahlungsbedingung der Rechnung.
Felder anzeigen (5)
- idinteger
  Primärschlüssel des Zahlungsziels. Interne ID.
- namestring
  Name der Zahlungsbedingung, zum Beispiel 14 Tage.
- date_stringstring
  Datumsmuster der Zahlungsfrist als Text.
- deletedboolean
  Die Zahlungsfrist wird gelöscht.
- global_defaultboolean
  Standard-Zahlungsziel für neue Rechnungen.
expense_categoryExpenseCategory10
EÜR-Kategorie für diese Rechnung (Einnahmen-Zuordnung) Wenn nicht gesetzt, wird die Default-Kategorie des AccountingTypes verwendet
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.
itemsarray<InvoiceItem6>
Positionen der Rechnung.
Felder anzeigen (19)
- idinteger
  Primärschlüssel der Rechnungsposition. Interne ID.
- descriptionstring
  Beschreibung der Rechnungsposition.
- price_is_bruttoboolean
  Ob der Preis ein Bruttopreis inklusive Steuer ist.
- skustring
  Artikelnummer (Stock Keeping Unit)
- barcodestring
  Barcode (ISBN, UPC, GTIN usw.)
- item_typestring
  Typ (Item, Shipping)
- netto_valuenumber (float)
  Nettowert der Rechnungsposition.
- brutto_valuenumber (float)
  Bruttowert der Rechnungsposition.
- tax_valuenumber (float)
  Steuerbetrag der Rechnungsposition.
- quantitynumber (float)Pflicht
  Menge der Rechnungsposition.
- pricenumber (float)Pflicht
  Einzelpreis der Rechnungsposition.
- namestringPflicht
  Name der Rechnungsposition.
- unitstringPflicht
  Einheit der Rechnungsposition.
- taxTax
  Auf die Rechnungsposition angewendeter Steuersatz.
- invoiceInvoice6
  Rechnung, zu der der Eintrag gehört.
- project_itemCRMProjectItem12
  Projektposition, aus der die Rechnungsposition erstellt wurde.
- base_event_sign_upBaseEventSignUp11
  Anmeldung, für die die Position angelegt wurde.
- unified_categoryUnifiedCategory36
  Kategorie, zu der der Posten gehört.
- productPredefinedBillingItem19
  Produkt der Position.
buyerInvoiceBuyer6
Käufer der Rechnung.
Felder anzeigen (29)
- idinteger
  Primärschlüssel des Clients. Interne ID.
- namestring
  Name des Kunden auf der Rechnung.
- vat_idstring
  USt-IdNr. des Kunden.
- taxnumberstring
  Steuernummer des Kunden.
- buyer_reference_idstring
  Leitweg-ID oder vom Kunden definierte individuelle Referenz-ID
- secondary_namestring
  Zweite Namenszeile des Kunden auf der Rechnung.
- addressstring
  Adresse als Text.
- address_streetstring
  Straße der Adresse.
- address_house_numberstring
  Hausnummer der Adresse.
- address_street_levelstring
  Straße und Hausnummer der Adresse.
- address_costring
  Care-of-Zeile der Adresse.
- address_citystring
  Ort der Adresse.
- address_zipstring
  Postleitzahl der Adresse.
- address_admin_level1string
  Erste Verwaltungsebene der Adresse, z. B. das Bundesland.
- address_countrystring
  Ländercode der Adresse.
- address_full_countrystring
  Vollständiger Name des Landes der Adresse.
- address_geo_latstring
  Breitengrad der Adresse.
- address_geo_lngstring
  Längengrad der Adresse.
- address_external_provider_idstring
  Feld zur Speicherung der externen Anbieter-ID der Adresse, z. B. Google-Maps-PlaceID wie google:ChIJVcKw5r90sEcRhdjNq6NItqE
- numberstring
  Kundennummer des Käufers.
- search_stringstring
  Text, unter dem die Entität gesucht werden kann.
- payment_ownerstring
  Kontoinhaber der Lastschrift.
- payment_institutionstring
  Name der Bank des Lastschrifteinzugs.
- payment_bicstring
  BIC des Bankkontos.
- payment_ibanstring
  IBAN des Bankkontos.
- payment_mandatestring
  Referenz des SEPA-Mandats.
- payment_mandate_sign_datestring (date-time)
  Datum, an dem das SEPA-Mandat unterschrieben wurde.
- payment_mandate_valid_until_datestring (date-time)
  Datum, bis zu dem das SEPA-Mandat gültig ist.
- invoiceInvoice6
  Rechnung, zu der der Käufer gehört.
payment_datestring (date-time)
Datum, an dem die Rechnung bezahlt wurde.
vat_categorystring
Der umsatzsteuerliche Sachverhalt. Der Steuersatz sagt nicht, in welche Zeile der Voranmeldung ein Umsatz gehört. Null Prozent stehen an einer innergemeinschaftlichen Lieferung (Kennzahl 41), an einer Ausfuhr (43), an einer Leistung nach § 13b UStG (60) und an einem steuerfreien Umsatz nach § 4 UStG (48) - vier verschiedene Zeilen, derselbe Steuersatz. Hier ist die einzige Stelle, an der jemand das weiß: beim Schreiben der Rechnung ist bekannt, ob der Kunde eine USt-IdNr. hat und wohin die Ware geht. Später ist es nicht mehr rekonstruierbar. Ohne Angabe der Regelfall - alles andere war bisher nicht erfassbar.
is_payment_date_from_ext_serviceboolean
Das Zahlungsdatum stammt von einem externen Dienst.
direct_debit_exportedboolean
Die Rechnung wurde für das Lastschriftverfahren exportiert.
offerOffer12
Angebot, aus dem die Rechnung erstellt wurde.
Felder anzeigen (36)
- 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.
- base_booking_groupBaseBookingGroup10
  Buchungsgruppe, auf der das Dokument basiert.
- search_stringstring
  Text, unter dem die Entität gesucht werden kann.
- offer_accounting_typeOfferAccountingTypePflicht
  Buchungsart des Angebots.
- itemsarray<OfferItem11>
  Positionen des Angebots.
- buyerOfferBuyer11
  Käufer des Angebots.
- accepted_datestring (date-time)
  Datum, an dem das Angebot angenommen wurde.
- is_accepted_date_from_ext_serviceboolean
  Das Annahmedatum stammt von einem externen Dienst.
- projectCRMProject20
  Projekt, zu dem das Angebot gehört.
- invoicesarray<Invoice6>
  Aus dem Angebot erstellte Rechnungen.
- base_event_sign_upBaseEventSignUp11
  Anmeldung, für die das Angebot angelegt wurde.
- base_bookingBaseBooking12
  Buchung, für die das Angebot erstellt wurde.
- base_event_sign_up_groupBaseEventSignUpGroup2
  Anmeldegruppe, für die das Angebot angelegt wurde.
time_reportsarray<ProjectTimeReport7>
Auf der Rechnung abgerechnete Zeitberichte.
Felder anzeigen (8)
- idinteger
  Primärschlüssel des Projektzeitberichts. Interne ID.
- projectCRMProject20
  Projekt, zu dem der Zeitbericht gehört.
- invoiceInvoice6
  Rechnung, auf der der Zeitbericht abgerechnet wurde.
- time_billed_on_ticket_closeboolean
  Die Zeit wird abgerechnet, wenn das Ticket geschlossen wird.
- startstring (date-time)
  Beginn des gemeldeten Zeitraums.
- endstring (date-time)
  Ende des gemeldeten Zeitraums.
- time_string_billablestring
  Abrechnungsfähige Zeit als Text.
- time_string_not_billablestring
  Nicht abrechenbare Zeit als Text.
payment_provider_statusstring
Status beim Zahlungsanbieter.
payment_provider_referencestring
Referenz beim Zahlungsanbieter.
payment_provider_transaction_referencestring
Transaktionsreferenz beim Zahlungsanbieter.
cancel_datestring (date-time)
Datum, an dem die Rechnung storniert wurde.
cancel_textstring
Text der Stornierung.
base_event_sign_upBaseEventSignUp11
Anmeldung, für die die Rechnung angelegt wurde.
Felder anzeigen (3)
- bib_range_idinteger
- age_classstring
  Altersklasse nach DLV, z. B. M40 – berechnet aus Geburtstag, Geschlecht und Veranstaltungsdatum.
- … 59 weitere Felder
… 8 weitere Felder

Anfrage

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

const options = {method: 'GET', headers: {'x-iw-jwt-token': '<TOKEN>'}};

fetch('https://eure-instanz.iw-erp.de/api/invoice/invoices/42/logbookentryadd', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://eure-instanz.iw-erp.de/api/invoice/invoices/42/logbookentryadd"

headers = {"x-iw-jwt-token": "<TOKEN>"}

response = requests.get(url, headers=headers)

print(response.text)

<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://eure-instanz.iw-erp.de/api/invoice/invoices/42/logbookentryadd', [
  'headers' => [
    'x-iw-jwt-token' => '<TOKEN>',
  ],
]);

echo $response->getBody();

using System.Net.Http.Headers;
var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://eure-instanz.iw-erp.de/api/invoice/invoices/42/logbookentryadd"),
  Headers =
  {
    { "x-iw-jwt-token", "<TOKEN>" },
  },
};
using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://eure-instanz.iw-erp.de/api/invoice/invoices/42/logbookentryadd")
  .get()
  .addHeader("x-iw-jwt-token", "<TOKEN>")
  .build();

Response response = client.newCall(request).execute();

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://eure-instanz.iw-erp.de/api/invoice/invoices/42/logbookentryadd"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-iw-jwt-token", "<TOKEN>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

Dart mit dem Package iw_erp_api

import 'package:iw_erp_api/clients/billing_invoice_controller.dart';
import 'package:iw_erp_api/logic/iw_api_state.dart';

IwApiState().host = 'eure-instanz.iw-erp.de';
IwApiState().currentJwtApiToken = '<TOKEN>';

final result = await BillingInvoiceController.getForLogBookEntryAdd('42');
if (result.success) {
  print(result.data);
}

Antwort 200 application/json

{
  "tax": {
    "name": "Beispiel",
    "id": 42,
    "value": 1.5,
    "deleted": true,
    "global_default": true,
    "datev_tax_key": 1
  },
  "accounting_type": {
    "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
    }
  },
  "id": 42,
  "currency": "EUR",
  "name": "Beispiel",
  "linked_number_title": "Beispiel",
  "cancel_text": "Text",
  "token": "string",
  "number": 1,
  "manual_number_prefix": "string"
}

Diese Methode liefert ein neues Rechnungsobjekt für den angegebenen PersonLogBookEntry

GET/api/invoice/invoices/{logBookEntryIdentifier}/logbookentrydelete

Pfad-Parameter

logBookEntryIdentifierPflichtstring

Antworten

200Liefert eine neue Rechnung für einen LogBookEntry (Löschen).Invoice6

Felder anzeigen (45)

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.
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%
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.
base_booking_groupBaseBookingGroup10
Buchungsgruppe, auf der das Dokument basiert.
Felder anzeigen (16)
- idinteger
  Primärschlüssel der Buchungsgruppe. Interne ID.
- start_timestring (date-time)
  Beginn der Buchungsgruppe.
- end_timestring (date-time)
  Ende der Buchungsgruppe.
- booking_typestring
  Art der Buchungen in der Gruppe.
- booking_statusstring
  Status der Buchungen in der Gruppe.
- externalboolean
  Die Gruppe wurde von einer externen Stelle erstellt.
- billing_typestring
  Abrechnungsart der Gruppe, zum Beispiel je Buchung oder je Gruppe.
- people_countinteger
  Anzahl der Personen in der Gruppe.
- createdstring (date-time)
  Zeitpunkt, zu dem der Datensatz angelegt wurde.
- updatedstring (date-time)
  Zeitpunkt, zu dem der Datensatz zuletzt aktualisiert wurde.
- namestring
  Name der Einheit.
- deletedboolean
  Diese Eigenschaft markiert eine Entität als gelöscht / archiviert
- deletion_reasonstring
  Grund der Löschung.
- deletion_datestring (date-time)
  Zeitpunkt der Löschung.
- colorstring
  Hintergrundfarbe als Hexwert.
- fg_colorstring
  Vordergrundfarbe als Hex-Wert.
search_stringstring
Text, unter dem die Entität gesucht werden kann.
accounting_typeAccountingTypePflicht
Buchungsart der Rechnung.
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)
payment_typePaymentType
Zahlungsart der Rechnung.
Felder anzeigen (10)
- idinteger
  Primärschlüssel des Zahlungstyps. Interne ID.
- namestring
  Name der Zahlungsart, zum Beispiel Überweisung oder Barzahlung.
- autoboolean
  Zahlungen dieses Typs werden automatisch zugeordnet.
- conditionsstring
  Bedingungen für die Zuordnung von Zahlungen zu diesem Typ.
- linked_keywordsstring
  Schlüsselwörter in Banktransaktionen, die mit dieser Zahlungsart verknüpft werden.
- global_defaultboolean
  Standard-Zahlungsart für neue Rechnungen.
- bank_import_defaultboolean
  Standard-Zahlungsart für Bankimporte.
- is_direct_debitboolean
  Die Zahlungsart ist ein Lastschriftverfahren.
- is_externalboolean
  Die Zahlung wird über einen externen Dienst abgewickelt.
- deletedboolean
  Diese Eigenschaft markiert eine Entität als gelöscht / archiviert
payment_goalPaymentGoal
Zahlungsbedingung der Rechnung.
Felder anzeigen (5)
- idinteger
  Primärschlüssel des Zahlungsziels. Interne ID.
- namestring
  Name der Zahlungsbedingung, zum Beispiel 14 Tage.
- date_stringstring
  Datumsmuster der Zahlungsfrist als Text.
- deletedboolean
  Die Zahlungsfrist wird gelöscht.
- global_defaultboolean
  Standard-Zahlungsziel für neue Rechnungen.
expense_categoryExpenseCategory10
EÜR-Kategorie für diese Rechnung (Einnahmen-Zuordnung) Wenn nicht gesetzt, wird die Default-Kategorie des AccountingTypes verwendet
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.
itemsarray<InvoiceItem6>
Positionen der Rechnung.
Felder anzeigen (19)
- idinteger
  Primärschlüssel der Rechnungsposition. Interne ID.
- descriptionstring
  Beschreibung der Rechnungsposition.
- price_is_bruttoboolean
  Ob der Preis ein Bruttopreis inklusive Steuer ist.
- skustring
  Artikelnummer (Stock Keeping Unit)
- barcodestring
  Barcode (ISBN, UPC, GTIN usw.)
- item_typestring
  Typ (Item, Shipping)
- netto_valuenumber (float)
  Nettowert der Rechnungsposition.
- brutto_valuenumber (float)
  Bruttowert der Rechnungsposition.
- tax_valuenumber (float)
  Steuerbetrag der Rechnungsposition.
- quantitynumber (float)Pflicht
  Menge der Rechnungsposition.
- pricenumber (float)Pflicht
  Einzelpreis der Rechnungsposition.
- namestringPflicht
  Name der Rechnungsposition.
- unitstringPflicht
  Einheit der Rechnungsposition.
- taxTax
  Auf die Rechnungsposition angewendeter Steuersatz.
- invoiceInvoice6
  Rechnung, zu der der Eintrag gehört.
- project_itemCRMProjectItem12
  Projektposition, aus der die Rechnungsposition erstellt wurde.
- base_event_sign_upBaseEventSignUp11
  Anmeldung, für die die Position angelegt wurde.
- unified_categoryUnifiedCategory36
  Kategorie, zu der der Posten gehört.
- productPredefinedBillingItem19
  Produkt der Position.
buyerInvoiceBuyer6
Käufer der Rechnung.
Felder anzeigen (29)
- idinteger
  Primärschlüssel des Clients. Interne ID.
- namestring
  Name des Kunden auf der Rechnung.
- vat_idstring
  USt-IdNr. des Kunden.
- taxnumberstring
  Steuernummer des Kunden.
- buyer_reference_idstring
  Leitweg-ID oder vom Kunden definierte individuelle Referenz-ID
- secondary_namestring
  Zweite Namenszeile des Kunden auf der Rechnung.
- addressstring
  Adresse als Text.
- address_streetstring
  Straße der Adresse.
- address_house_numberstring
  Hausnummer der Adresse.
- address_street_levelstring
  Straße und Hausnummer der Adresse.
- address_costring
  Care-of-Zeile der Adresse.
- address_citystring
  Ort der Adresse.
- address_zipstring
  Postleitzahl der Adresse.
- address_admin_level1string
  Erste Verwaltungsebene der Adresse, z. B. das Bundesland.
- address_countrystring
  Ländercode der Adresse.
- address_full_countrystring
  Vollständiger Name des Landes der Adresse.
- address_geo_latstring
  Breitengrad der Adresse.
- address_geo_lngstring
  Längengrad der Adresse.
- address_external_provider_idstring
  Feld zur Speicherung der externen Anbieter-ID der Adresse, z. B. Google-Maps-PlaceID wie google:ChIJVcKw5r90sEcRhdjNq6NItqE
- numberstring
  Kundennummer des Käufers.
- search_stringstring
  Text, unter dem die Entität gesucht werden kann.
- payment_ownerstring
  Kontoinhaber der Lastschrift.
- payment_institutionstring
  Name der Bank des Lastschrifteinzugs.
- payment_bicstring
  BIC des Bankkontos.
- payment_ibanstring
  IBAN des Bankkontos.
- payment_mandatestring
  Referenz des SEPA-Mandats.
- payment_mandate_sign_datestring (date-time)
  Datum, an dem das SEPA-Mandat unterschrieben wurde.
- payment_mandate_valid_until_datestring (date-time)
  Datum, bis zu dem das SEPA-Mandat gültig ist.
- invoiceInvoice6
  Rechnung, zu der der Käufer gehört.
payment_datestring (date-time)
Datum, an dem die Rechnung bezahlt wurde.
vat_categorystring
Der umsatzsteuerliche Sachverhalt. Der Steuersatz sagt nicht, in welche Zeile der Voranmeldung ein Umsatz gehört. Null Prozent stehen an einer innergemeinschaftlichen Lieferung (Kennzahl 41), an einer Ausfuhr (43), an einer Leistung nach § 13b UStG (60) und an einem steuerfreien Umsatz nach § 4 UStG (48) - vier verschiedene Zeilen, derselbe Steuersatz. Hier ist die einzige Stelle, an der jemand das weiß: beim Schreiben der Rechnung ist bekannt, ob der Kunde eine USt-IdNr. hat und wohin die Ware geht. Später ist es nicht mehr rekonstruierbar. Ohne Angabe der Regelfall - alles andere war bisher nicht erfassbar.
is_payment_date_from_ext_serviceboolean
Das Zahlungsdatum stammt von einem externen Dienst.
direct_debit_exportedboolean
Die Rechnung wurde für das Lastschriftverfahren exportiert.
offerOffer12
Angebot, aus dem die Rechnung erstellt wurde.
Felder anzeigen (36)
- 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.
- base_booking_groupBaseBookingGroup10
  Buchungsgruppe, auf der das Dokument basiert.
- search_stringstring
  Text, unter dem die Entität gesucht werden kann.
- offer_accounting_typeOfferAccountingTypePflicht
  Buchungsart des Angebots.
- itemsarray<OfferItem11>
  Positionen des Angebots.
- buyerOfferBuyer11
  Käufer des Angebots.
- accepted_datestring (date-time)
  Datum, an dem das Angebot angenommen wurde.
- is_accepted_date_from_ext_serviceboolean
  Das Annahmedatum stammt von einem externen Dienst.
- projectCRMProject20
  Projekt, zu dem das Angebot gehört.
- invoicesarray<Invoice6>
  Aus dem Angebot erstellte Rechnungen.
- base_event_sign_upBaseEventSignUp11
  Anmeldung, für die das Angebot angelegt wurde.
- base_bookingBaseBooking12
  Buchung, für die das Angebot erstellt wurde.
- base_event_sign_up_groupBaseEventSignUpGroup2
  Anmeldegruppe, für die das Angebot angelegt wurde.
time_reportsarray<ProjectTimeReport7>
Auf der Rechnung abgerechnete Zeitberichte.
Felder anzeigen (8)
- idinteger
  Primärschlüssel des Projektzeitberichts. Interne ID.
- projectCRMProject20
  Projekt, zu dem der Zeitbericht gehört.
- invoiceInvoice6
  Rechnung, auf der der Zeitbericht abgerechnet wurde.
- time_billed_on_ticket_closeboolean
  Die Zeit wird abgerechnet, wenn das Ticket geschlossen wird.
- startstring (date-time)
  Beginn des gemeldeten Zeitraums.
- endstring (date-time)
  Ende des gemeldeten Zeitraums.
- time_string_billablestring
  Abrechnungsfähige Zeit als Text.
- time_string_not_billablestring
  Nicht abrechenbare Zeit als Text.
payment_provider_statusstring
Status beim Zahlungsanbieter.
payment_provider_referencestring
Referenz beim Zahlungsanbieter.
payment_provider_transaction_referencestring
Transaktionsreferenz beim Zahlungsanbieter.
cancel_datestring (date-time)
Datum, an dem die Rechnung storniert wurde.
cancel_textstring
Text der Stornierung.
base_event_sign_upBaseEventSignUp11
Anmeldung, für die die Rechnung angelegt wurde.
Felder anzeigen (3)
- bib_range_idinteger
- age_classstring
  Altersklasse nach DLV, z. B. M40 – berechnet aus Geburtstag, Geschlecht und Veranstaltungsdatum.
- … 59 weitere Felder
… 8 weitere Felder

Anfrage

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

const options = {method: 'GET', headers: {'x-iw-jwt-token': '<TOKEN>'}};

fetch('https://eure-instanz.iw-erp.de/api/invoice/invoices/42/logbookentrydelete', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://eure-instanz.iw-erp.de/api/invoice/invoices/42/logbookentrydelete"

headers = {"x-iw-jwt-token": "<TOKEN>"}

response = requests.get(url, headers=headers)

print(response.text)

<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://eure-instanz.iw-erp.de/api/invoice/invoices/42/logbookentrydelete', [
  'headers' => [
    'x-iw-jwt-token' => '<TOKEN>',
  ],
]);

echo $response->getBody();

using System.Net.Http.Headers;
var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://eure-instanz.iw-erp.de/api/invoice/invoices/42/logbookentrydelete"),
  Headers =
  {
    { "x-iw-jwt-token", "<TOKEN>" },
  },
};
using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://eure-instanz.iw-erp.de/api/invoice/invoices/42/logbookentrydelete")
  .get()
  .addHeader("x-iw-jwt-token", "<TOKEN>")
  .build();

Response response = client.newCall(request).execute();

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://eure-instanz.iw-erp.de/api/invoice/invoices/42/logbookentrydelete"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-iw-jwt-token", "<TOKEN>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

Dart mit dem Package iw_erp_api

import 'package:iw_erp_api/clients/billing_invoice_controller.dart';
import 'package:iw_erp_api/logic/iw_api_state.dart';

IwApiState().host = 'eure-instanz.iw-erp.de';
IwApiState().currentJwtApiToken = '<TOKEN>';

final result = await BillingInvoiceController.getForLogBookEntryDelete('42');
if (result.success) {
  print(result.data);
}

Antwort 200 application/json

{
  "tax": {
    "name": "Beispiel",
    "id": 42,
    "value": 1.5,
    "deleted": true,
    "global_default": true,
    "datev_tax_key": 1
  },
  "accounting_type": {
    "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
    }
  },
  "id": 42,
  "currency": "EUR",
  "name": "Beispiel",
  "linked_number_title": "Beispiel",
  "cancel_text": "Text",
  "token": "string",
  "number": 1,
  "manual_number_prefix": "string"
}

Rechnung zu einer CRMCompany hinzufügen

POST/api/invoice/invoice/{id}/add/to/company

Pfad-Parameter

idPflichtstring

Antworten

200Rechnung zu einer CRMCompany hinzufügenCRMCompany23

Felder anzeigen (62)

idinteger
Primärschlüssel des Unternehmens. Interne ID.
short_namestring
Kurzname des Unternehmens.
company_namestring
Rechtlicher Name der Firma.
secondary_namestring
Zweite Namenszeile des Unternehmens.
direct_dialstring
Durchwahl der Firma.
invoice_emailstring
E-Mail-Adresse für Rechnungen.
send_invoice_emailboolean
Rechnungen per E-Mail versenden.
send_invoice_letterboolean
Rechnungen per Brief versenden.
time_report_emailstring
E-Mail-Adresse für Zeitberichte.
payment_goalPaymentGoal
Zahlungsbedingung der Firma.
Felder anzeigen (5)
- idinteger
  Primärschlüssel des Zahlungsziels. Interne ID.
- namestring
  Name der Zahlungsbedingung, zum Beispiel 14 Tage.
- date_stringstring
  Datumsmuster der Zahlungsfrist als Text.
- deletedboolean
  Die Zahlungsfrist wird gelöscht.
- global_defaultboolean
  Standard-Zahlungsziel für neue Rechnungen.
payment_intervalstring
Intervall der Zahlungen.
vatidstring
Umsatzsteuer-Identifikationsnummer.
taxnumberstring
Steuernummer des Unternehmens.
buyer_reference_idstring
Leitweg-ID oder vom Kunden definierte individuelle Referenz-ID
taxTax
Für das Unternehmen verwendeter Steuersatz.
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%
infostring
Informationen zur Firma.
numberstring
Kunden- oder Lieferantennummer des Unternehmens.
manual_numberinteger
Manuell gesetzte Nummer statt der automatischen Nummer.
number_stringstring
Unternehmensnummer als Text, einschließlich Präfix.
is_customerboolean
Das Unternehmen ist ein Kunde.
is_supplierboolean
Das Unternehmen ist ein Lieferant.
is_otherboolean
Das Unternehmen ist weder Kunde noch Lieferant.
is_memberboolean
Das Unternehmen ist ein Mitglied.
archivedboolean
Das Unternehmen ist archiviert.
categoryCRMCompanyCategory
Kategorie des Unternehmens.
Felder anzeigen (10)
- idinteger
  Primärschlüssel der Unternehmenskategorie. Interne ID.
- namestring
  Name der Firmenkategorie.
- descriptionstring
  Beschreibung der Firmenkategorie.
- deletedboolean
  Die Kategorie ist gelöscht.
- global_defaultboolean
  Standardkategorie für neue Firmen.
- enabled_customer_portalboolean
  Unternehmen dieser Kategorie dürfen das Kundenportal nutzen.
- g_drive_root_dirstring
  Stammordner in Google Drive für Unternehmen dieser Kategorie.
- g_drive_root_dir_archivedstring
  Stammordner in Google Drive für archivierte Unternehmen dieser Kategorie.
- require_company_addressboolean
  Für Unternehmen dieser Kategorie muss eine Adresse eingegeben werden.
- require_company_billingboolean
  Für Unternehmen dieser Kategorie müssen Abrechnungsdaten eingegeben werden.
visible_for_customerboolean
Ob das Unternehmen für den Kunden sichtbar ist.
founding_datestring (date-time)
Gründungsdatum des Unternehmens.
nace_sectionstring
NACE-Abschnittscode (Buchstabe A-U)
nace_codestring
NACE-Code (numerisch, z. B. 01.11, 62.01)
search_stringstring
Text, unter dem die Entität gesucht werden kann.
addressstring
Adresse als Text.
address_streetstring
Straße der Adresse.
address_house_numberstring
Hausnummer der Adresse.
address_street_levelstring
Straße und Hausnummer der Adresse.
address_costring
Care-of-Zeile der Adresse.
address_citystring
Ort der Adresse.
address_zipstring
Postleitzahl der Adresse.
address_admin_level1string
Erste Verwaltungsebene der Adresse, z. B. das Bundesland.
address_countrystring
Ländercode der Adresse.
address_full_countrystring
Vollständiger Name des Landes der Adresse.
address_geo_latstring
Breitengrad der Adresse.
address_geo_lngstring
Längengrad der Adresse.
address_external_provider_idstring
Feld zur Speicherung der externen Anbieter-ID der Adresse, z. B. Google-Maps-PlaceID wie google:ChIJVcKw5r90sEcRhdjNq6NItqE
main_phonestring
Haupttelefonnummer.
main_faxstring
Haupt-Faxnummer.
main_emailstring
Haupt-E-Mail-Adresse.
websitestring
Website-Adresse.
createdstring (date-time)
Zeitpunkt, zu dem der Datensatz angelegt wurde.
updatedstring (date-time)
Zeitpunkt, zu dem der Datensatz zuletzt aktualisiert wurde.
payment_ownerstring
Kontoinhaber der Lastschrift.
payment_institutionstring
Name der Bank des Lastschrifteinzugs.
payment_bicstring
BIC des Bankkontos.
payment_ibanstring
IBAN des Bankkontos.
payment_mandatestring
Referenz des SEPA-Mandats.
payment_mandate_sign_datestring (date-time)
Datum, an dem das SEPA-Mandat unterschrieben wurde.
payment_mandate_valid_until_datestring (date-time)
Datum, bis zu dem das SEPA-Mandat gültig ist.
payment_typePaymentType
Felder anzeigen (10)
- idinteger
  Primärschlüssel des Zahlungstyps. Interne ID.
- namestring
  Name der Zahlungsart, zum Beispiel Überweisung oder Barzahlung.
- autoboolean
  Zahlungen dieses Typs werden automatisch zugeordnet.
- conditionsstring
  Bedingungen für die Zuordnung von Zahlungen zu diesem Typ.
- linked_keywordsstring
  Schlüsselwörter in Banktransaktionen, die mit dieser Zahlungsart verknüpft werden.
- global_defaultboolean
  Standard-Zahlungsart für neue Rechnungen.
- bank_import_defaultboolean
  Standard-Zahlungsart für Bankimporte.
- is_direct_debitboolean
  Die Zahlungsart ist ein Lastschriftverfahren.
- is_externalboolean
  Die Zahlung wird über einen externen Dienst abgewickelt.
- deletedboolean
  Diese Eigenschaft markiert eine Entität als gelöscht / archiviert
company_employee_countinteger
Anzahl der Mitarbeitenden der Firma.
company_founding_yearinteger
Gründungsjahr des Unternehmens.
company_family_ownedboolean
Ob das Unternehmen familiengeführt ist.
company_sales_volumestring
Umsatzvolumen des Unternehmens.
company_segmentstring
Marktsegment der Firma.

Anfrage

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

const options = {method: 'POST', headers: {'x-iw-jwt-token': '<TOKEN>'}};

fetch('https://eure-instanz.iw-erp.de/api/invoice/invoice/42/add/to/company', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://eure-instanz.iw-erp.de/api/invoice/invoice/42/add/to/company"

headers = {"x-iw-jwt-token": "<TOKEN>"}

response = requests.post(url, headers=headers)

print(response.text)

<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://eure-instanz.iw-erp.de/api/invoice/invoice/42/add/to/company', [
  'headers' => [
    'x-iw-jwt-token' => '<TOKEN>',
  ],
]);

echo $response->getBody();

using System.Net.Http.Headers;
var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Post,
  RequestUri = new Uri("https://eure-instanz.iw-erp.de/api/invoice/invoice/42/add/to/company"),
  Headers =
  {
    { "x-iw-jwt-token", "<TOKEN>" },
  },
};
using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://eure-instanz.iw-erp.de/api/invoice/invoice/42/add/to/company")
  .post(null)
  .addHeader("x-iw-jwt-token", "<TOKEN>")
  .build();

Response response = client.newCall(request).execute();

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://eure-instanz.iw-erp.de/api/invoice/invoice/42/add/to/company"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("x-iw-jwt-token", "<TOKEN>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

Dart mit dem Package iw_erp_api

import 'package:iw_erp_api/clients/billing_invoice_controller.dart';
import 'package:iw_erp_api/logic/iw_api_state.dart';
import 'package:iw_erp_api/model/crm_company.dart';
import 'package:iw_erp_api/model/invoice.dart';

IwApiState().host = 'eure-instanz.iw-erp.de';
IwApiState().currentJwtApiToken = '<TOKEN>';

final result = await BillingInvoiceController.addToCrmCompany(Invoice.fromJson({}), CrmCompany.fromJson({}));
if (result.success) {
  print(result.data);
}

Antwort 200 application/json

{
  "id": 42,
  "short_name": "Beispiel",
  "company_name": "Beispiel",
  "secondary_name": "Beispiel",
  "invoice_email": "lena.hartmann@example.org",
  "send_invoice_email": true,
  "time_report_email": "lena.hartmann@example.org",
  "address_street": "Jakobistr. 39",
  "address_city": "Hannover",
  "address_zip": "30163"
}

Eine Rechnung aus einer CRMCompany löschen

POST/api/invoice/invoice/{id}/delete/from/company

Pfad-Parameter

idPflichtstring

Antworten

200Eine Invoice aus einem CRMCompany entfernenCRMCompany23

Felder anzeigen (62)

idinteger
Primärschlüssel des Unternehmens. Interne ID.
short_namestring
Kurzname des Unternehmens.
company_namestring
Rechtlicher Name der Firma.
secondary_namestring
Zweite Namenszeile des Unternehmens.
direct_dialstring
Durchwahl der Firma.
invoice_emailstring
E-Mail-Adresse für Rechnungen.
send_invoice_emailboolean
Rechnungen per E-Mail versenden.
send_invoice_letterboolean
Rechnungen per Brief versenden.
time_report_emailstring
E-Mail-Adresse für Zeitberichte.
payment_goalPaymentGoal
Zahlungsbedingung der Firma.
Felder anzeigen (5)
- idinteger
  Primärschlüssel des Zahlungsziels. Interne ID.
- namestring
  Name der Zahlungsbedingung, zum Beispiel 14 Tage.
- date_stringstring
  Datumsmuster der Zahlungsfrist als Text.
- deletedboolean
  Die Zahlungsfrist wird gelöscht.
- global_defaultboolean
  Standard-Zahlungsziel für neue Rechnungen.
payment_intervalstring
Intervall der Zahlungen.
vatidstring
Umsatzsteuer-Identifikationsnummer.
taxnumberstring
Steuernummer des Unternehmens.
buyer_reference_idstring
Leitweg-ID oder vom Kunden definierte individuelle Referenz-ID
taxTax
Für das Unternehmen verwendeter Steuersatz.
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%
infostring
Informationen zur Firma.
numberstring
Kunden- oder Lieferantennummer des Unternehmens.
manual_numberinteger
Manuell gesetzte Nummer statt der automatischen Nummer.
number_stringstring
Unternehmensnummer als Text, einschließlich Präfix.
is_customerboolean
Das Unternehmen ist ein Kunde.
is_supplierboolean
Das Unternehmen ist ein Lieferant.
is_otherboolean
Das Unternehmen ist weder Kunde noch Lieferant.
is_memberboolean
Das Unternehmen ist ein Mitglied.
archivedboolean
Das Unternehmen ist archiviert.
categoryCRMCompanyCategory
Kategorie des Unternehmens.
Felder anzeigen (10)
- idinteger
  Primärschlüssel der Unternehmenskategorie. Interne ID.
- namestring
  Name der Firmenkategorie.
- descriptionstring
  Beschreibung der Firmenkategorie.
- deletedboolean
  Die Kategorie ist gelöscht.
- global_defaultboolean
  Standardkategorie für neue Firmen.
- enabled_customer_portalboolean
  Unternehmen dieser Kategorie dürfen das Kundenportal nutzen.
- g_drive_root_dirstring
  Stammordner in Google Drive für Unternehmen dieser Kategorie.
- g_drive_root_dir_archivedstring
  Stammordner in Google Drive für archivierte Unternehmen dieser Kategorie.
- require_company_addressboolean
  Für Unternehmen dieser Kategorie muss eine Adresse eingegeben werden.
- require_company_billingboolean
  Für Unternehmen dieser Kategorie müssen Abrechnungsdaten eingegeben werden.
visible_for_customerboolean
Ob das Unternehmen für den Kunden sichtbar ist.
founding_datestring (date-time)
Gründungsdatum des Unternehmens.
nace_sectionstring
NACE-Abschnittscode (Buchstabe A-U)
nace_codestring
NACE-Code (numerisch, z. B. 01.11, 62.01)
search_stringstring
Text, unter dem die Entität gesucht werden kann.
addressstring
Adresse als Text.
address_streetstring
Straße der Adresse.
address_house_numberstring
Hausnummer der Adresse.
address_street_levelstring
Straße und Hausnummer der Adresse.
address_costring
Care-of-Zeile der Adresse.
address_citystring
Ort der Adresse.
address_zipstring
Postleitzahl der Adresse.
address_admin_level1string
Erste Verwaltungsebene der Adresse, z. B. das Bundesland.
address_countrystring
Ländercode der Adresse.
address_full_countrystring
Vollständiger Name des Landes der Adresse.
address_geo_latstring
Breitengrad der Adresse.
address_geo_lngstring
Längengrad der Adresse.
address_external_provider_idstring
Feld zur Speicherung der externen Anbieter-ID der Adresse, z. B. Google-Maps-PlaceID wie google:ChIJVcKw5r90sEcRhdjNq6NItqE
main_phonestring
Haupttelefonnummer.
main_faxstring
Haupt-Faxnummer.
main_emailstring
Haupt-E-Mail-Adresse.
websitestring
Website-Adresse.
createdstring (date-time)
Zeitpunkt, zu dem der Datensatz angelegt wurde.
updatedstring (date-time)
Zeitpunkt, zu dem der Datensatz zuletzt aktualisiert wurde.
payment_ownerstring
Kontoinhaber der Lastschrift.
payment_institutionstring
Name der Bank des Lastschrifteinzugs.
payment_bicstring
BIC des Bankkontos.
payment_ibanstring
IBAN des Bankkontos.
payment_mandatestring
Referenz des SEPA-Mandats.
payment_mandate_sign_datestring (date-time)
Datum, an dem das SEPA-Mandat unterschrieben wurde.
payment_mandate_valid_until_datestring (date-time)
Datum, bis zu dem das SEPA-Mandat gültig ist.
payment_typePaymentType
Felder anzeigen (10)
- idinteger
  Primärschlüssel des Zahlungstyps. Interne ID.
- namestring
  Name der Zahlungsart, zum Beispiel Überweisung oder Barzahlung.
- autoboolean
  Zahlungen dieses Typs werden automatisch zugeordnet.
- conditionsstring
  Bedingungen für die Zuordnung von Zahlungen zu diesem Typ.
- linked_keywordsstring
  Schlüsselwörter in Banktransaktionen, die mit dieser Zahlungsart verknüpft werden.
- global_defaultboolean
  Standard-Zahlungsart für neue Rechnungen.
- bank_import_defaultboolean
  Standard-Zahlungsart für Bankimporte.
- is_direct_debitboolean
  Die Zahlungsart ist ein Lastschriftverfahren.
- is_externalboolean
  Die Zahlung wird über einen externen Dienst abgewickelt.
- deletedboolean
  Diese Eigenschaft markiert eine Entität als gelöscht / archiviert
company_employee_countinteger
Anzahl der Mitarbeitenden der Firma.
company_founding_yearinteger
Gründungsjahr des Unternehmens.
company_family_ownedboolean
Ob das Unternehmen familiengeführt ist.
company_sales_volumestring
Umsatzvolumen des Unternehmens.
company_segmentstring
Marktsegment der Firma.

Anfrage

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

const options = {method: 'POST', headers: {'x-iw-jwt-token': '<TOKEN>'}};

fetch('https://eure-instanz.iw-erp.de/api/invoice/invoice/42/delete/from/company', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://eure-instanz.iw-erp.de/api/invoice/invoice/42/delete/from/company"

headers = {"x-iw-jwt-token": "<TOKEN>"}

response = requests.post(url, headers=headers)

print(response.text)

<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://eure-instanz.iw-erp.de/api/invoice/invoice/42/delete/from/company', [
  'headers' => [
    'x-iw-jwt-token' => '<TOKEN>',
  ],
]);

echo $response->getBody();

using System.Net.Http.Headers;
var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Post,
  RequestUri = new Uri("https://eure-instanz.iw-erp.de/api/invoice/invoice/42/delete/from/company"),
  Headers =
  {
    { "x-iw-jwt-token", "<TOKEN>" },
  },
};
using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://eure-instanz.iw-erp.de/api/invoice/invoice/42/delete/from/company")
  .post(null)
  .addHeader("x-iw-jwt-token", "<TOKEN>")
  .build();

Response response = client.newCall(request).execute();

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://eure-instanz.iw-erp.de/api/invoice/invoice/42/delete/from/company"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("x-iw-jwt-token", "<TOKEN>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

Dart mit dem Package iw_erp_api

import 'package:iw_erp_api/clients/billing_invoice_controller.dart';
import 'package:iw_erp_api/logic/iw_api_state.dart';
import 'package:iw_erp_api/model/crm_company.dart';
import 'package:iw_erp_api/model/invoice.dart';

IwApiState().host = 'eure-instanz.iw-erp.de';
IwApiState().currentJwtApiToken = '<TOKEN>';

final result = await BillingInvoiceController.removeFromCrmCompany(Invoice.fromJson({}), CrmCompany.fromJson({}));
if (result.success) {
  print(result.data);
}

Antwort 200 application/json

{
  "id": 42,
  "short_name": "Beispiel",
  "company_name": "Beispiel",
  "secondary_name": "Beispiel",
  "invoice_email": "lena.hartmann@example.org",
  "send_invoice_email": true,
  "time_report_email": "lena.hartmann@example.org",
  "address_street": "Jakobistr. 39",
  "address_city": "Hannover",
  "address_zip": "30163"
}

Rechnung abschließen

POST/api/invoice/invoice/{id}/close

Pfad-Parameter

idPflichtstring

Antworten

200Rechnung abschließenInvoice5

Felder anzeigen (45)

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.
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%
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.
base_booking_groupBaseBookingGroup10
Buchungsgruppe, auf der das Dokument basiert.
Felder anzeigen (16)
- idinteger
  Primärschlüssel der Buchungsgruppe. Interne ID.
- start_timestring (date-time)
  Beginn der Buchungsgruppe.
- end_timestring (date-time)
  Ende der Buchungsgruppe.
- booking_typestring
  Art der Buchungen in der Gruppe.
- booking_statusstring
  Status der Buchungen in der Gruppe.
- externalboolean
  Die Gruppe wurde von einer externen Stelle erstellt.
- billing_typestring
  Abrechnungsart der Gruppe, zum Beispiel je Buchung oder je Gruppe.
- people_countinteger
  Anzahl der Personen in der Gruppe.
- createdstring (date-time)
  Zeitpunkt, zu dem der Datensatz angelegt wurde.
- updatedstring (date-time)
  Zeitpunkt, zu dem der Datensatz zuletzt aktualisiert wurde.
- namestring
  Name der Einheit.
- deletedboolean
  Diese Eigenschaft markiert eine Entität als gelöscht / archiviert
- deletion_reasonstring
  Grund der Löschung.
- deletion_datestring (date-time)
  Zeitpunkt der Löschung.
- colorstring
  Hintergrundfarbe als Hexwert.
- fg_colorstring
  Vordergrundfarbe als Hex-Wert.
search_stringstring
Text, unter dem die Entität gesucht werden kann.
accounting_typeAccountingTypePflicht
Buchungsart der Rechnung.
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)
payment_typePaymentType
Zahlungsart der Rechnung.
Felder anzeigen (10)
- idinteger
  Primärschlüssel des Zahlungstyps. Interne ID.
- namestring
  Name der Zahlungsart, zum Beispiel Überweisung oder Barzahlung.
- autoboolean
  Zahlungen dieses Typs werden automatisch zugeordnet.
- conditionsstring
  Bedingungen für die Zuordnung von Zahlungen zu diesem Typ.
- linked_keywordsstring
  Schlüsselwörter in Banktransaktionen, die mit dieser Zahlungsart verknüpft werden.
- global_defaultboolean
  Standard-Zahlungsart für neue Rechnungen.
- bank_import_defaultboolean
  Standard-Zahlungsart für Bankimporte.
- is_direct_debitboolean
  Die Zahlungsart ist ein Lastschriftverfahren.
- is_externalboolean
  Die Zahlung wird über einen externen Dienst abgewickelt.
- deletedboolean
  Diese Eigenschaft markiert eine Entität als gelöscht / archiviert
payment_goalPaymentGoal
Zahlungsbedingung der Rechnung.
Felder anzeigen (5)
- idinteger
  Primärschlüssel des Zahlungsziels. Interne ID.
- namestring
  Name der Zahlungsbedingung, zum Beispiel 14 Tage.
- date_stringstring
  Datumsmuster der Zahlungsfrist als Text.
- deletedboolean
  Die Zahlungsfrist wird gelöscht.
- global_defaultboolean
  Standard-Zahlungsziel für neue Rechnungen.
expense_categoryExpenseCategory10
EÜR-Kategorie für diese Rechnung (Einnahmen-Zuordnung) Wenn nicht gesetzt, wird die Default-Kategorie des AccountingTypes verwendet
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.
itemsarray<InvoiceItem5>
Positionen der Rechnung.
Felder anzeigen (18)
- idinteger
  Primärschlüssel der Rechnungsposition. Interne ID.
- descriptionstring
  Beschreibung der Rechnungsposition.
- price_is_bruttoboolean
  Ob der Preis ein Bruttopreis inklusive Steuer ist.
- skustring
  Artikelnummer (Stock Keeping Unit)
- barcodestring
  Barcode (ISBN, UPC, GTIN usw.)
- item_typestring
  Typ (Item, Shipping)
- netto_valuenumber (float)
  Nettowert der Rechnungsposition.
- brutto_valuenumber (float)
  Bruttowert der Rechnungsposition.
- tax_valuenumber (float)
  Steuerbetrag der Rechnungsposition.
- quantitynumber (float)Pflicht
  Menge der Rechnungsposition.
- pricenumber (float)Pflicht
  Einzelpreis der Rechnungsposition.
- namestringPflicht
  Name der Rechnungsposition.
- unitstringPflicht
  Einheit der Rechnungsposition.
- taxTax
  Auf die Rechnungsposition angewendeter Steuersatz.
- invoiceInvoice5
  Rechnung, zu der der Eintrag gehört.
- project_itemCRMProjectItem11
  Projektposition, aus der die Rechnungsposition erstellt wurde.
- base_event_sign_upBaseEventSignUp11
  Anmeldung, für die die Position angelegt wurde.
- productPredefinedBillingItem18
  Produkt der Position.
buyerInvoiceBuyer5
Käufer der Rechnung.
Felder anzeigen (29)
- idinteger
  Primärschlüssel des Clients. Interne ID.
- namestring
  Name des Kunden auf der Rechnung.
- vat_idstring
  USt-IdNr. des Kunden.
- taxnumberstring
  Steuernummer des Kunden.
- buyer_reference_idstring
  Leitweg-ID oder vom Kunden definierte individuelle Referenz-ID
- secondary_namestring
  Zweite Namenszeile des Kunden auf der Rechnung.
- addressstring
  Adresse als Text.
- address_streetstring
  Straße der Adresse.
- address_house_numberstring
  Hausnummer der Adresse.
- address_street_levelstring
  Straße und Hausnummer der Adresse.
- address_costring
  Care-of-Zeile der Adresse.
- address_citystring
  Ort der Adresse.
- address_zipstring
  Postleitzahl der Adresse.
- address_admin_level1string
  Erste Verwaltungsebene der Adresse, z. B. das Bundesland.
- address_countrystring
  Ländercode der Adresse.
- address_full_countrystring
  Vollständiger Name des Landes der Adresse.
- address_geo_latstring
  Breitengrad der Adresse.
- address_geo_lngstring
  Längengrad der Adresse.
- address_external_provider_idstring
  Feld zur Speicherung der externen Anbieter-ID der Adresse, z. B. Google-Maps-PlaceID wie google:ChIJVcKw5r90sEcRhdjNq6NItqE
- numberstring
  Kundennummer des Käufers.
- search_stringstring
  Text, unter dem die Entität gesucht werden kann.
- payment_ownerstring
  Kontoinhaber der Lastschrift.
- payment_institutionstring
  Name der Bank des Lastschrifteinzugs.
- payment_bicstring
  BIC des Bankkontos.
- payment_ibanstring
  IBAN des Bankkontos.
- payment_mandatestring
  Referenz des SEPA-Mandats.
- payment_mandate_sign_datestring (date-time)
  Datum, an dem das SEPA-Mandat unterschrieben wurde.
- payment_mandate_valid_until_datestring (date-time)
  Datum, bis zu dem das SEPA-Mandat gültig ist.
- invoiceInvoice5
  Rechnung, zu der der Käufer gehört.
payment_datestring (date-time)
Datum, an dem die Rechnung bezahlt wurde.
vat_categorystring
Der umsatzsteuerliche Sachverhalt. Der Steuersatz sagt nicht, in welche Zeile der Voranmeldung ein Umsatz gehört. Null Prozent stehen an einer innergemeinschaftlichen Lieferung (Kennzahl 41), an einer Ausfuhr (43), an einer Leistung nach § 13b UStG (60) und an einem steuerfreien Umsatz nach § 4 UStG (48) - vier verschiedene Zeilen, derselbe Steuersatz. Hier ist die einzige Stelle, an der jemand das weiß: beim Schreiben der Rechnung ist bekannt, ob der Kunde eine USt-IdNr. hat und wohin die Ware geht. Später ist es nicht mehr rekonstruierbar. Ohne Angabe der Regelfall - alles andere war bisher nicht erfassbar.
is_payment_date_from_ext_serviceboolean
Das Zahlungsdatum stammt von einem externen Dienst.
direct_debit_exportedboolean
Die Rechnung wurde für das Lastschriftverfahren exportiert.
offerOffer11
Angebot, aus dem die Rechnung erstellt wurde.
Felder anzeigen (36)
- 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.
- base_booking_groupBaseBookingGroup10
  Buchungsgruppe, auf der das Dokument basiert.
- search_stringstring
  Text, unter dem die Entität gesucht werden kann.
- offer_accounting_typeOfferAccountingTypePflicht
  Buchungsart des Angebots.
- itemsarray<OfferItem10>
  Positionen des Angebots.
- buyerOfferBuyer10
  Käufer des Angebots.
- accepted_datestring (date-time)
  Datum, an dem das Angebot angenommen wurde.
- is_accepted_date_from_ext_serviceboolean
  Das Annahmedatum stammt von einem externen Dienst.
- projectCRMProject19
  Projekt, zu dem das Angebot gehört.
- invoicesarray<Invoice5>
  Aus dem Angebot erstellte Rechnungen.
- base_event_sign_upBaseEventSignUp11
  Anmeldung, für die das Angebot angelegt wurde.
- base_bookingBaseBooking12
  Buchung, für die das Angebot erstellt wurde.
- base_event_sign_up_groupBaseEventSignUpGroup2
  Anmeldegruppe, für die das Angebot angelegt wurde.
time_reportsarray<ProjectTimeReport6>
Auf der Rechnung abgerechnete Zeitberichte.
Felder anzeigen (8)
- idinteger
  Primärschlüssel des Projektzeitberichts. Interne ID.
- projectCRMProject19
  Projekt, zu dem der Zeitbericht gehört.
- invoiceInvoice5
  Rechnung, auf der der Zeitbericht abgerechnet wurde.
- time_billed_on_ticket_closeboolean
  Die Zeit wird abgerechnet, wenn das Ticket geschlossen wird.
- startstring (date-time)
  Beginn des gemeldeten Zeitraums.
- endstring (date-time)
  Ende des gemeldeten Zeitraums.
- time_string_billablestring
  Abrechnungsfähige Zeit als Text.
- time_string_not_billablestring
  Nicht abrechenbare Zeit als Text.
payment_provider_statusstring
Status beim Zahlungsanbieter.
payment_provider_referencestring
Referenz beim Zahlungsanbieter.
payment_provider_transaction_referencestring
Transaktionsreferenz beim Zahlungsanbieter.
cancel_datestring (date-time)
Datum, an dem die Rechnung storniert wurde.
cancel_textstring
Text der Stornierung.
base_event_sign_upBaseEventSignUp11
Anmeldung, für die die Rechnung angelegt wurde.
Felder anzeigen (4)
- bib_range_idinteger
- age_classstring
  Altersklasse nach DLV, z. B. M40 – berechnet aus Geburtstag, Geschlecht und Veranstaltungsdatum.
- idinteger
  Primärschlüssel der Anmeldung. Interne ID.
- … 58 weitere Felder
… 7 weitere Felder

Anfrage

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

const options = {method: 'POST', headers: {'x-iw-jwt-token': '<TOKEN>'}};

fetch('https://eure-instanz.iw-erp.de/api/invoice/invoice/42/close', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://eure-instanz.iw-erp.de/api/invoice/invoice/42/close"

headers = {"x-iw-jwt-token": "<TOKEN>"}

response = requests.post(url, headers=headers)

print(response.text)

<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://eure-instanz.iw-erp.de/api/invoice/invoice/42/close', [
  'headers' => [
    'x-iw-jwt-token' => '<TOKEN>',
  ],
]);

echo $response->getBody();

using System.Net.Http.Headers;
var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Post,
  RequestUri = new Uri("https://eure-instanz.iw-erp.de/api/invoice/invoice/42/close"),
  Headers =
  {
    { "x-iw-jwt-token", "<TOKEN>" },
  },
};
using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://eure-instanz.iw-erp.de/api/invoice/invoice/42/close")
  .post(null)
  .addHeader("x-iw-jwt-token", "<TOKEN>")
  .build();

Response response = client.newCall(request).execute();

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://eure-instanz.iw-erp.de/api/invoice/invoice/42/close"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("x-iw-jwt-token", "<TOKEN>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

Dart mit dem Package iw_erp_api

import 'package:iw_erp_api/clients/billing_invoice_controller.dart';
import 'package:iw_erp_api/logic/iw_api_state.dart';
import 'package:iw_erp_api/model/invoice.dart';

IwApiState().host = 'eure-instanz.iw-erp.de';
IwApiState().currentJwtApiToken = '<TOKEN>';

final result = await BillingInvoiceController.close(Invoice.fromJson({}));
if (result.success) {
  print(result.data);
}

Antwort 200 application/json

{
  "tax": {
    "name": "Beispiel",
    "id": 42,
    "value": 1.5,
    "deleted": true,
    "global_default": true,
    "datev_tax_key": 1
  },
  "accounting_type": {
    "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
    }
  },
  "id": 42,
  "currency": "EUR",
  "name": "Beispiel",
  "linked_number_title": "Beispiel",
  "cancel_text": "Text",
  "token": "string",
  "number": 1,
  "manual_number_prefix": "string"
}

Eine Teilzahlung zu einer offenen Invoice erfassen

POST/api/invoice/invoice/{id}/payment

Nur mit der Einstellung billing_invoice_partial_payment. Erreichen die Zahlungen den Bruttobetrag, gilt die Rechnung als bezahlt.

Pfad-Parameter

idPflichtstring

Request-Body application/json

dataobject
Felder anzeigen (3)
- amountnumber
  Bezahlter Betrag (brutto)
- paymentDatestring
  Standardmäßig heute
- cashDiscountnumber
  Skonto (brutto), das mit der Schlusszahlung abgezogen wird; benötigt billing_invoice_cash_discount

Antworten

200Eine Teilzahlung zu einer Invoice erfassenInvoice5

Felder anzeigen (45)

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.
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%
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.
base_booking_groupBaseBookingGroup10
Buchungsgruppe, auf der das Dokument basiert.
Felder anzeigen (16)
- idinteger
  Primärschlüssel der Buchungsgruppe. Interne ID.
- start_timestring (date-time)
  Beginn der Buchungsgruppe.
- end_timestring (date-time)
  Ende der Buchungsgruppe.
- booking_typestring
  Art der Buchungen in der Gruppe.
- booking_statusstring
  Status der Buchungen in der Gruppe.
- externalboolean
  Die Gruppe wurde von einer externen Stelle erstellt.
- billing_typestring
  Abrechnungsart der Gruppe, zum Beispiel je Buchung oder je Gruppe.
- people_countinteger
  Anzahl der Personen in der Gruppe.
- createdstring (date-time)
  Zeitpunkt, zu dem der Datensatz angelegt wurde.
- updatedstring (date-time)
  Zeitpunkt, zu dem der Datensatz zuletzt aktualisiert wurde.
- namestring
  Name der Einheit.
- deletedboolean
  Diese Eigenschaft markiert eine Entität als gelöscht / archiviert
- deletion_reasonstring
  Grund der Löschung.
- deletion_datestring (date-time)
  Zeitpunkt der Löschung.
- colorstring
  Hintergrundfarbe als Hexwert.
- fg_colorstring
  Vordergrundfarbe als Hex-Wert.
search_stringstring
Text, unter dem die Entität gesucht werden kann.
accounting_typeAccountingTypePflicht
Buchungsart der Rechnung.
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)
payment_typePaymentType
Zahlungsart der Rechnung.
Felder anzeigen (10)
- idinteger
  Primärschlüssel des Zahlungstyps. Interne ID.
- namestring
  Name der Zahlungsart, zum Beispiel Überweisung oder Barzahlung.
- autoboolean
  Zahlungen dieses Typs werden automatisch zugeordnet.
- conditionsstring
  Bedingungen für die Zuordnung von Zahlungen zu diesem Typ.
- linked_keywordsstring
  Schlüsselwörter in Banktransaktionen, die mit dieser Zahlungsart verknüpft werden.
- global_defaultboolean
  Standard-Zahlungsart für neue Rechnungen.
- bank_import_defaultboolean
  Standard-Zahlungsart für Bankimporte.
- is_direct_debitboolean
  Die Zahlungsart ist ein Lastschriftverfahren.
- is_externalboolean
  Die Zahlung wird über einen externen Dienst abgewickelt.
- deletedboolean
  Diese Eigenschaft markiert eine Entität als gelöscht / archiviert
payment_goalPaymentGoal
Zahlungsbedingung der Rechnung.
Felder anzeigen (5)
- idinteger
  Primärschlüssel des Zahlungsziels. Interne ID.
- namestring
  Name der Zahlungsbedingung, zum Beispiel 14 Tage.
- date_stringstring
  Datumsmuster der Zahlungsfrist als Text.
- deletedboolean
  Die Zahlungsfrist wird gelöscht.
- global_defaultboolean
  Standard-Zahlungsziel für neue Rechnungen.
expense_categoryExpenseCategory10
EÜR-Kategorie für diese Rechnung (Einnahmen-Zuordnung) Wenn nicht gesetzt, wird die Default-Kategorie des AccountingTypes verwendet
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.
itemsarray<InvoiceItem5>
Positionen der Rechnung.
Felder anzeigen (18)
- idinteger
  Primärschlüssel der Rechnungsposition. Interne ID.
- descriptionstring
  Beschreibung der Rechnungsposition.
- price_is_bruttoboolean
  Ob der Preis ein Bruttopreis inklusive Steuer ist.
- skustring
  Artikelnummer (Stock Keeping Unit)
- barcodestring
  Barcode (ISBN, UPC, GTIN usw.)
- item_typestring
  Typ (Item, Shipping)
- netto_valuenumber (float)
  Nettowert der Rechnungsposition.
- brutto_valuenumber (float)
  Bruttowert der Rechnungsposition.
- tax_valuenumber (float)
  Steuerbetrag der Rechnungsposition.
- quantitynumber (float)Pflicht
  Menge der Rechnungsposition.
- pricenumber (float)Pflicht
  Einzelpreis der Rechnungsposition.
- namestringPflicht
  Name der Rechnungsposition.
- unitstringPflicht
  Einheit der Rechnungsposition.
- taxTax
  Auf die Rechnungsposition angewendeter Steuersatz.
- invoiceInvoice5
  Rechnung, zu der der Eintrag gehört.
- project_itemCRMProjectItem11
  Projektposition, aus der die Rechnungsposition erstellt wurde.
- base_event_sign_upBaseEventSignUp11
  Anmeldung, für die die Position angelegt wurde.
- productPredefinedBillingItem18
  Produkt der Position.
buyerInvoiceBuyer5
Käufer der Rechnung.
Felder anzeigen (29)
- idinteger
  Primärschlüssel des Clients. Interne ID.
- namestring
  Name des Kunden auf der Rechnung.
- vat_idstring
  USt-IdNr. des Kunden.
- taxnumberstring
  Steuernummer des Kunden.
- buyer_reference_idstring
  Leitweg-ID oder vom Kunden definierte individuelle Referenz-ID
- secondary_namestring
  Zweite Namenszeile des Kunden auf der Rechnung.
- addressstring
  Adresse als Text.
- address_streetstring
  Straße der Adresse.
- address_house_numberstring
  Hausnummer der Adresse.
- address_street_levelstring
  Straße und Hausnummer der Adresse.
- address_costring
  Care-of-Zeile der Adresse.
- address_citystring
  Ort der Adresse.
- address_zipstring
  Postleitzahl der Adresse.
- address_admin_level1string
  Erste Verwaltungsebene der Adresse, z. B. das Bundesland.
- address_countrystring
  Ländercode der Adresse.
- address_full_countrystring
  Vollständiger Name des Landes der Adresse.
- address_geo_latstring
  Breitengrad der Adresse.
- address_geo_lngstring
  Längengrad der Adresse.
- address_external_provider_idstring
  Feld zur Speicherung der externen Anbieter-ID der Adresse, z. B. Google-Maps-PlaceID wie google:ChIJVcKw5r90sEcRhdjNq6NItqE
- numberstring
  Kundennummer des Käufers.
- search_stringstring
  Text, unter dem die Entität gesucht werden kann.
- payment_ownerstring
  Kontoinhaber der Lastschrift.
- payment_institutionstring
  Name der Bank des Lastschrifteinzugs.
- payment_bicstring
  BIC des Bankkontos.
- payment_ibanstring
  IBAN des Bankkontos.
- payment_mandatestring
  Referenz des SEPA-Mandats.
- payment_mandate_sign_datestring (date-time)
  Datum, an dem das SEPA-Mandat unterschrieben wurde.
- payment_mandate_valid_until_datestring (date-time)
  Datum, bis zu dem das SEPA-Mandat gültig ist.
- invoiceInvoice5
  Rechnung, zu der der Käufer gehört.
payment_datestring (date-time)
Datum, an dem die Rechnung bezahlt wurde.
vat_categorystring
Der umsatzsteuerliche Sachverhalt. Der Steuersatz sagt nicht, in welche Zeile der Voranmeldung ein Umsatz gehört. Null Prozent stehen an einer innergemeinschaftlichen Lieferung (Kennzahl 41), an einer Ausfuhr (43), an einer Leistung nach § 13b UStG (60) und an einem steuerfreien Umsatz nach § 4 UStG (48) - vier verschiedene Zeilen, derselbe Steuersatz. Hier ist die einzige Stelle, an der jemand das weiß: beim Schreiben der Rechnung ist bekannt, ob der Kunde eine USt-IdNr. hat und wohin die Ware geht. Später ist es nicht mehr rekonstruierbar. Ohne Angabe der Regelfall - alles andere war bisher nicht erfassbar.
is_payment_date_from_ext_serviceboolean
Das Zahlungsdatum stammt von einem externen Dienst.
direct_debit_exportedboolean
Die Rechnung wurde für das Lastschriftverfahren exportiert.
offerOffer11
Angebot, aus dem die Rechnung erstellt wurde.
Felder anzeigen (36)
- 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.
- base_booking_groupBaseBookingGroup10
  Buchungsgruppe, auf der das Dokument basiert.
- search_stringstring
  Text, unter dem die Entität gesucht werden kann.
- offer_accounting_typeOfferAccountingTypePflicht
  Buchungsart des Angebots.
- itemsarray<OfferItem10>
  Positionen des Angebots.
- buyerOfferBuyer10
  Käufer des Angebots.
- accepted_datestring (date-time)
  Datum, an dem das Angebot angenommen wurde.
- is_accepted_date_from_ext_serviceboolean
  Das Annahmedatum stammt von einem externen Dienst.
- projectCRMProject19
  Projekt, zu dem das Angebot gehört.
- invoicesarray<Invoice5>
  Aus dem Angebot erstellte Rechnungen.
- base_event_sign_upBaseEventSignUp11
  Anmeldung, für die das Angebot angelegt wurde.
- base_bookingBaseBooking12
  Buchung, für die das Angebot erstellt wurde.
- base_event_sign_up_groupBaseEventSignUpGroup2
  Anmeldegruppe, für die das Angebot angelegt wurde.
time_reportsarray<ProjectTimeReport6>
Auf der Rechnung abgerechnete Zeitberichte.
Felder anzeigen (8)
- idinteger
  Primärschlüssel des Projektzeitberichts. Interne ID.
- projectCRMProject19
  Projekt, zu dem der Zeitbericht gehört.
- invoiceInvoice5
  Rechnung, auf der der Zeitbericht abgerechnet wurde.
- time_billed_on_ticket_closeboolean
  Die Zeit wird abgerechnet, wenn das Ticket geschlossen wird.
- startstring (date-time)
  Beginn des gemeldeten Zeitraums.
- endstring (date-time)
  Ende des gemeldeten Zeitraums.
- time_string_billablestring
  Abrechnungsfähige Zeit als Text.
- time_string_not_billablestring
  Nicht abrechenbare Zeit als Text.
payment_provider_statusstring
Status beim Zahlungsanbieter.
payment_provider_referencestring
Referenz beim Zahlungsanbieter.
payment_provider_transaction_referencestring
Transaktionsreferenz beim Zahlungsanbieter.
cancel_datestring (date-time)
Datum, an dem die Rechnung storniert wurde.
cancel_textstring
Text der Stornierung.
base_event_sign_upBaseEventSignUp11
Anmeldung, für die die Rechnung angelegt wurde.
Felder anzeigen (4)
- bib_range_idinteger
- age_classstring
  Altersklasse nach DLV, z. B. M40 – berechnet aus Geburtstag, Geschlecht und Veranstaltungsdatum.
- idinteger
  Primärschlüssel der Anmeldung. Interne ID.
- … 58 weitere Felder
… 7 weitere Felder

Anfrage

curl --request POST \
  --url https://eure-instanz.iw-erp.de/api/invoice/invoice/42/payment \
  --header 'content-type: application/json' \
  --header 'x-iw-jwt-token: <TOKEN>' \
  --data '
{
  "data": {
    "amount": 595,
    "paymentDate": "2026-02-20",
    "cashDiscount": 23.8
  }
}
'

const options = {
  method: 'POST',
  headers: {'x-iw-jwt-token': '<TOKEN>', 'content-type': 'application/json'},
  body: JSON.stringify({data: {amount: 595, paymentDate: '2026-02-20', cashDiscount: 23.8}})
};

fetch('https://eure-instanz.iw-erp.de/api/invoice/invoice/42/payment', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://eure-instanz.iw-erp.de/api/invoice/invoice/42/payment"

payload = { "data": {
    "amount": 595,
    "paymentDate": "2026-02-20",
    "cashDiscount": 23.8
  } }
headers = {
  "x-iw-jwt-token": "<TOKEN>",
  "content-type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://eure-instanz.iw-erp.de/api/invoice/invoice/42/payment', [
  'body' => '{"data":{"amount":595,"paymentDate":"2026-02-20","cashDiscount":23.8}}',
  'headers' => [
    'content-type' => 'application/json',
    'x-iw-jwt-token' => '<TOKEN>',
  ],
]);

echo $response->getBody();

using System.Net.Http.Headers;
var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Post,
  RequestUri = new Uri("https://eure-instanz.iw-erp.de/api/invoice/invoice/42/payment"),
  Headers =
  {
    { "x-iw-jwt-token", "<TOKEN>" },
  },
  Content = new StringContent("{\"data\":{\"amount\":595,\"paymentDate\":\"2026-02-20\",\"cashDiscount\":23.8}}")
  {
    Headers =
    {
      ContentType = new MediaTypeHeaderValue("application/json")
    }
  }
};
using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}

OkHttpClient client = new OkHttpClient();

MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\"data\":{\"amount\":595,\"paymentDate\":\"2026-02-20\",\"cashDiscount\":23.8}}");
Request request = new Request.Builder()
  .url("https://eure-instanz.iw-erp.de/api/invoice/invoice/42/payment")
  .post(body)
  .addHeader("x-iw-jwt-token", "<TOKEN>")
  .addHeader("content-type", "application/json")
  .build();

Response response = client.newCall(request).execute();

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://eure-instanz.iw-erp.de/api/invoice/invoice/42/payment"

	payload := strings.NewReader("{\"data\":{\"amount\":595,\"paymentDate\":\"2026-02-20\",\"cashDiscount\":23.8}}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-iw-jwt-token", "<TOKEN>")
	req.Header.Add("content-type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

Dart mit package:http (kein Controller im Package iw_erp_api)

import 'dart:convert';
import 'package:http/http.dart' as http;

final response = await http.post(
  Uri.parse('https://eure-instanz.iw-erp.de/api/invoice/invoice/42/payment'),
  headers: {'x-iw-jwt-token': '<TOKEN>', 'content-type': 'application/json'},
  body: jsonEncode({
    "data": {
      "amount": 595,
      "paymentDate": "2026-02-20",
      "cashDiscount": 23.8
    }
  }),
);
print(response.body);

Antwort 200 application/json

{
  "tax": {
    "name": "Beispiel",
    "id": 42,
    "value": 1.5,
    "deleted": true,
    "global_default": true,
    "datev_tax_key": 1
  },
  "accounting_type": {
    "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
    }
  },
  "id": 42,
  "currency": "EUR",
  "name": "Beispiel",
  "linked_number_title": "Beispiel",
  "cancel_text": "Text",
  "token": "string",
  "number": 1,
  "manual_number_prefix": "string"
}

Rechnung stornieren

POST/api/invoice/invoice/{id}/cancel

Pfad-Parameter

idPflichtstring

Antworten

200Rechnung stornierenInvoice5

Felder anzeigen (45)

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.
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%
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.
base_booking_groupBaseBookingGroup10
Buchungsgruppe, auf der das Dokument basiert.
Felder anzeigen (16)
- idinteger
  Primärschlüssel der Buchungsgruppe. Interne ID.
- start_timestring (date-time)
  Beginn der Buchungsgruppe.
- end_timestring (date-time)
  Ende der Buchungsgruppe.
- booking_typestring
  Art der Buchungen in der Gruppe.
- booking_statusstring
  Status der Buchungen in der Gruppe.
- externalboolean
  Die Gruppe wurde von einer externen Stelle erstellt.
- billing_typestring
  Abrechnungsart der Gruppe, zum Beispiel je Buchung oder je Gruppe.
- people_countinteger
  Anzahl der Personen in der Gruppe.
- createdstring (date-time)
  Zeitpunkt, zu dem der Datensatz angelegt wurde.
- updatedstring (date-time)
  Zeitpunkt, zu dem der Datensatz zuletzt aktualisiert wurde.
- namestring
  Name der Einheit.
- deletedboolean
  Diese Eigenschaft markiert eine Entität als gelöscht / archiviert
- deletion_reasonstring
  Grund der Löschung.
- deletion_datestring (date-time)
  Zeitpunkt der Löschung.
- colorstring
  Hintergrundfarbe als Hexwert.
- fg_colorstring
  Vordergrundfarbe als Hex-Wert.
search_stringstring
Text, unter dem die Entität gesucht werden kann.
accounting_typeAccountingTypePflicht
Buchungsart der Rechnung.
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)
payment_typePaymentType
Zahlungsart der Rechnung.
Felder anzeigen (10)
- idinteger
  Primärschlüssel des Zahlungstyps. Interne ID.
- namestring
  Name der Zahlungsart, zum Beispiel Überweisung oder Barzahlung.
- autoboolean
  Zahlungen dieses Typs werden automatisch zugeordnet.
- conditionsstring
  Bedingungen für die Zuordnung von Zahlungen zu diesem Typ.
- linked_keywordsstring
  Schlüsselwörter in Banktransaktionen, die mit dieser Zahlungsart verknüpft werden.
- global_defaultboolean
  Standard-Zahlungsart für neue Rechnungen.
- bank_import_defaultboolean
  Standard-Zahlungsart für Bankimporte.
- is_direct_debitboolean
  Die Zahlungsart ist ein Lastschriftverfahren.
- is_externalboolean
  Die Zahlung wird über einen externen Dienst abgewickelt.
- deletedboolean
  Diese Eigenschaft markiert eine Entität als gelöscht / archiviert
payment_goalPaymentGoal
Zahlungsbedingung der Rechnung.
Felder anzeigen (5)
- idinteger
  Primärschlüssel des Zahlungsziels. Interne ID.
- namestring
  Name der Zahlungsbedingung, zum Beispiel 14 Tage.
- date_stringstring
  Datumsmuster der Zahlungsfrist als Text.
- deletedboolean
  Die Zahlungsfrist wird gelöscht.
- global_defaultboolean
  Standard-Zahlungsziel für neue Rechnungen.
expense_categoryExpenseCategory10
EÜR-Kategorie für diese Rechnung (Einnahmen-Zuordnung) Wenn nicht gesetzt, wird die Default-Kategorie des AccountingTypes verwendet
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.
itemsarray<InvoiceItem5>
Positionen der Rechnung.
Felder anzeigen (18)
- idinteger
  Primärschlüssel der Rechnungsposition. Interne ID.
- descriptionstring
  Beschreibung der Rechnungsposition.
- price_is_bruttoboolean
  Ob der Preis ein Bruttopreis inklusive Steuer ist.
- skustring
  Artikelnummer (Stock Keeping Unit)
- barcodestring
  Barcode (ISBN, UPC, GTIN usw.)
- item_typestring
  Typ (Item, Shipping)
- netto_valuenumber (float)
  Nettowert der Rechnungsposition.
- brutto_valuenumber (float)
  Bruttowert der Rechnungsposition.
- tax_valuenumber (float)
  Steuerbetrag der Rechnungsposition.
- quantitynumber (float)Pflicht
  Menge der Rechnungsposition.
- pricenumber (float)Pflicht
  Einzelpreis der Rechnungsposition.
- namestringPflicht
  Name der Rechnungsposition.
- unitstringPflicht
  Einheit der Rechnungsposition.
- taxTax
  Auf die Rechnungsposition angewendeter Steuersatz.
- invoiceInvoice5
  Rechnung, zu der der Eintrag gehört.
- project_itemCRMProjectItem11
  Projektposition, aus der die Rechnungsposition erstellt wurde.
- base_event_sign_upBaseEventSignUp11
  Anmeldung, für die die Position angelegt wurde.
- productPredefinedBillingItem18
  Produkt der Position.
buyerInvoiceBuyer5
Käufer der Rechnung.
Felder anzeigen (29)
- idinteger
  Primärschlüssel des Clients. Interne ID.
- namestring
  Name des Kunden auf der Rechnung.
- vat_idstring
  USt-IdNr. des Kunden.
- taxnumberstring
  Steuernummer des Kunden.
- buyer_reference_idstring
  Leitweg-ID oder vom Kunden definierte individuelle Referenz-ID
- secondary_namestring
  Zweite Namenszeile des Kunden auf der Rechnung.
- addressstring
  Adresse als Text.
- address_streetstring
  Straße der Adresse.
- address_house_numberstring
  Hausnummer der Adresse.
- address_street_levelstring
  Straße und Hausnummer der Adresse.
- address_costring
  Care-of-Zeile der Adresse.
- address_citystring
  Ort der Adresse.
- address_zipstring
  Postleitzahl der Adresse.
- address_admin_level1string
  Erste Verwaltungsebene der Adresse, z. B. das Bundesland.
- address_countrystring
  Ländercode der Adresse.
- address_full_countrystring
  Vollständiger Name des Landes der Adresse.
- address_geo_latstring
  Breitengrad der Adresse.
- address_geo_lngstring
  Längengrad der Adresse.
- address_external_provider_idstring
  Feld zur Speicherung der externen Anbieter-ID der Adresse, z. B. Google-Maps-PlaceID wie google:ChIJVcKw5r90sEcRhdjNq6NItqE
- numberstring
  Kundennummer des Käufers.
- search_stringstring
  Text, unter dem die Entität gesucht werden kann.
- payment_ownerstring
  Kontoinhaber der Lastschrift.
- payment_institutionstring
  Name der Bank des Lastschrifteinzugs.
- payment_bicstring
  BIC des Bankkontos.
- payment_ibanstring
  IBAN des Bankkontos.
- payment_mandatestring
  Referenz des SEPA-Mandats.
- payment_mandate_sign_datestring (date-time)
  Datum, an dem das SEPA-Mandat unterschrieben wurde.
- payment_mandate_valid_until_datestring (date-time)
  Datum, bis zu dem das SEPA-Mandat gültig ist.
- invoiceInvoice5
  Rechnung, zu der der Käufer gehört.
payment_datestring (date-time)
Datum, an dem die Rechnung bezahlt wurde.
vat_categorystring
Der umsatzsteuerliche Sachverhalt. Der Steuersatz sagt nicht, in welche Zeile der Voranmeldung ein Umsatz gehört. Null Prozent stehen an einer innergemeinschaftlichen Lieferung (Kennzahl 41), an einer Ausfuhr (43), an einer Leistung nach § 13b UStG (60) und an einem steuerfreien Umsatz nach § 4 UStG (48) - vier verschiedene Zeilen, derselbe Steuersatz. Hier ist die einzige Stelle, an der jemand das weiß: beim Schreiben der Rechnung ist bekannt, ob der Kunde eine USt-IdNr. hat und wohin die Ware geht. Später ist es nicht mehr rekonstruierbar. Ohne Angabe der Regelfall - alles andere war bisher nicht erfassbar.
is_payment_date_from_ext_serviceboolean
Das Zahlungsdatum stammt von einem externen Dienst.
direct_debit_exportedboolean
Die Rechnung wurde für das Lastschriftverfahren exportiert.
offerOffer11
Angebot, aus dem die Rechnung erstellt wurde.
Felder anzeigen (36)
- 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.
- base_booking_groupBaseBookingGroup10
  Buchungsgruppe, auf der das Dokument basiert.
- search_stringstring
  Text, unter dem die Entität gesucht werden kann.
- offer_accounting_typeOfferAccountingTypePflicht
  Buchungsart des Angebots.
- itemsarray<OfferItem10>
  Positionen des Angebots.
- buyerOfferBuyer10
  Käufer des Angebots.
- accepted_datestring (date-time)
  Datum, an dem das Angebot angenommen wurde.
- is_accepted_date_from_ext_serviceboolean
  Das Annahmedatum stammt von einem externen Dienst.
- projectCRMProject19
  Projekt, zu dem das Angebot gehört.
- invoicesarray<Invoice5>
  Aus dem Angebot erstellte Rechnungen.
- base_event_sign_upBaseEventSignUp11
  Anmeldung, für die das Angebot angelegt wurde.
- base_bookingBaseBooking12
  Buchung, für die das Angebot erstellt wurde.
- base_event_sign_up_groupBaseEventSignUpGroup2
  Anmeldegruppe, für die das Angebot angelegt wurde.
time_reportsarray<ProjectTimeReport6>
Auf der Rechnung abgerechnete Zeitberichte.
Felder anzeigen (8)
- idinteger
  Primärschlüssel des Projektzeitberichts. Interne ID.
- projectCRMProject19
  Projekt, zu dem der Zeitbericht gehört.
- invoiceInvoice5
  Rechnung, auf der der Zeitbericht abgerechnet wurde.
- time_billed_on_ticket_closeboolean
  Die Zeit wird abgerechnet, wenn das Ticket geschlossen wird.
- startstring (date-time)
  Beginn des gemeldeten Zeitraums.
- endstring (date-time)
  Ende des gemeldeten Zeitraums.
- time_string_billablestring
  Abrechnungsfähige Zeit als Text.
- time_string_not_billablestring
  Nicht abrechenbare Zeit als Text.
payment_provider_statusstring
Status beim Zahlungsanbieter.
payment_provider_referencestring
Referenz beim Zahlungsanbieter.
payment_provider_transaction_referencestring
Transaktionsreferenz beim Zahlungsanbieter.
cancel_datestring (date-time)
Datum, an dem die Rechnung storniert wurde.
cancel_textstring
Text der Stornierung.
base_event_sign_upBaseEventSignUp11
Anmeldung, für die die Rechnung angelegt wurde.
Felder anzeigen (4)
- bib_range_idinteger
- age_classstring
  Altersklasse nach DLV, z. B. M40 – berechnet aus Geburtstag, Geschlecht und Veranstaltungsdatum.
- idinteger
  Primärschlüssel der Anmeldung. Interne ID.
- … 58 weitere Felder
… 7 weitere Felder

Anfrage

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

const options = {method: 'POST', headers: {'x-iw-jwt-token': '<TOKEN>'}};

fetch('https://eure-instanz.iw-erp.de/api/invoice/invoice/42/cancel', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://eure-instanz.iw-erp.de/api/invoice/invoice/42/cancel"

headers = {"x-iw-jwt-token": "<TOKEN>"}

response = requests.post(url, headers=headers)

print(response.text)

<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://eure-instanz.iw-erp.de/api/invoice/invoice/42/cancel', [
  'headers' => [
    'x-iw-jwt-token' => '<TOKEN>',
  ],
]);

echo $response->getBody();

using System.Net.Http.Headers;
var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Post,
  RequestUri = new Uri("https://eure-instanz.iw-erp.de/api/invoice/invoice/42/cancel"),
  Headers =
  {
    { "x-iw-jwt-token", "<TOKEN>" },
  },
};
using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://eure-instanz.iw-erp.de/api/invoice/invoice/42/cancel")
  .post(null)
  .addHeader("x-iw-jwt-token", "<TOKEN>")
  .build();

Response response = client.newCall(request).execute();

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://eure-instanz.iw-erp.de/api/invoice/invoice/42/cancel"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("x-iw-jwt-token", "<TOKEN>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

Dart mit dem Package iw_erp_api

import 'package:iw_erp_api/clients/billing_invoice_controller.dart';
import 'package:iw_erp_api/logic/iw_api_state.dart';
import 'package:iw_erp_api/model/invoice.dart';

IwApiState().host = 'eure-instanz.iw-erp.de';
IwApiState().currentJwtApiToken = '<TOKEN>';

final result = await BillingInvoiceController.cancel(Invoice.fromJson({}));
if (result.success) {
  print(result.data);
}

Antwort 200 application/json

{
  "tax": {
    "name": "Beispiel",
    "id": 42,
    "value": 1.5,
    "deleted": true,
    "global_default": true,
    "datev_tax_key": 1
  },
  "accounting_type": {
    "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
    }
  },
  "id": 42,
  "currency": "EUR",
  "name": "Beispiel",
  "linked_number_title": "Beispiel",
  "cancel_text": "Text",
  "token": "string",
  "number": 1,
  "manual_number_prefix": "string"
}

Legt die Mail-Absicht für eine Rechnung fest

POST/api/invoice/invoice/{identifier}/mail_intend

Pfad-Parameter

identifierPflichtstring

Antworten

200Legt die Mail-Absicht für eine Rechnung festInvoice7

Felder anzeigen (48)

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.
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%
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.
base_booking_groupBaseBookingGroup10
Buchungsgruppe, auf der das Dokument basiert.
Felder anzeigen (16)
- idinteger
  Primärschlüssel der Buchungsgruppe. Interne ID.
- start_timestring (date-time)
  Beginn der Buchungsgruppe.
- end_timestring (date-time)
  Ende der Buchungsgruppe.
- booking_typestring
  Art der Buchungen in der Gruppe.
- booking_statusstring
  Status der Buchungen in der Gruppe.
- externalboolean
  Die Gruppe wurde von einer externen Stelle erstellt.
- billing_typestring
  Abrechnungsart der Gruppe, zum Beispiel je Buchung oder je Gruppe.
- people_countinteger
  Anzahl der Personen in der Gruppe.
- createdstring (date-time)
  Zeitpunkt, zu dem der Datensatz angelegt wurde.
- updatedstring (date-time)
  Zeitpunkt, zu dem der Datensatz zuletzt aktualisiert wurde.
- namestring
  Name der Einheit.
- deletedboolean
  Diese Eigenschaft markiert eine Entität als gelöscht / archiviert
- deletion_reasonstring
  Grund der Löschung.
- deletion_datestring (date-time)
  Zeitpunkt der Löschung.
- colorstring
  Hintergrundfarbe als Hexwert.
- fg_colorstring
  Vordergrundfarbe als Hex-Wert.
mit_last_send_emailstring (date-time)
Zeitpunkt, zu dem die letzte E-Mail gesendet wurde.
mit_to_emailstring
E-Mail-Adresse, für die die E-Mail bestimmt ist.
mit_should_send_emailboolean
Ob eine E-Mail gesendet werden soll.
mit_last_send_postalstring (date-time)
Zeitpunkt, zu dem das letzte Schreiben versendet wurde.
mit_to_address_namestring
Name des Postempfängers.
mit_to_address_street_levelstring
Straße und Hausnummer des Postempfängers.
mit_to_address_citystring
Ort des Postempfängers.
mit_to_address_zipstring
Postleitzahl des Postempfängers.
mit_to_address_countrystring
Land des Postempfängers.
mit_should_send_postalboolean
Ob ein Brief gesendet werden soll.
search_stringstring
Text, unter dem die Entität gesucht werden kann.
accounting_typeAccountingTypePflicht
Buchungsart der Rechnung.
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)
payment_typePaymentType
Zahlungsart der Rechnung.
Felder anzeigen (10)
- idinteger
  Primärschlüssel des Zahlungstyps. Interne ID.
- namestring
  Name der Zahlungsart, zum Beispiel Überweisung oder Barzahlung.
- autoboolean
  Zahlungen dieses Typs werden automatisch zugeordnet.
- conditionsstring
  Bedingungen für die Zuordnung von Zahlungen zu diesem Typ.
- linked_keywordsstring
  Schlüsselwörter in Banktransaktionen, die mit dieser Zahlungsart verknüpft werden.
- global_defaultboolean
  Standard-Zahlungsart für neue Rechnungen.
- bank_import_defaultboolean
  Standard-Zahlungsart für Bankimporte.
- is_direct_debitboolean
  Die Zahlungsart ist ein Lastschriftverfahren.
- is_externalboolean
  Die Zahlung wird über einen externen Dienst abgewickelt.
- deletedboolean
  Diese Eigenschaft markiert eine Entität als gelöscht / archiviert
payment_goalPaymentGoal
Zahlungsbedingung der Rechnung.
Felder anzeigen (5)
- idinteger
  Primärschlüssel des Zahlungsziels. Interne ID.
- namestring
  Name der Zahlungsbedingung, zum Beispiel 14 Tage.
- date_stringstring
  Datumsmuster der Zahlungsfrist als Text.
- deletedboolean
  Die Zahlungsfrist wird gelöscht.
- global_defaultboolean
  Standard-Zahlungsziel für neue Rechnungen.
expense_categoryExpenseCategory10
EÜR-Kategorie für diese Rechnung (Einnahmen-Zuordnung) Wenn nicht gesetzt, wird die Default-Kategorie des AccountingTypes verwendet
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.
itemsarray<InvoiceItem7>
Positionen der Rechnung.
Felder anzeigen (18)
- idinteger
  Primärschlüssel der Rechnungsposition. Interne ID.
- descriptionstring
  Beschreibung der Rechnungsposition.
- price_is_bruttoboolean
  Ob der Preis ein Bruttopreis inklusive Steuer ist.
- skustring
  Artikelnummer (Stock Keeping Unit)
- barcodestring
  Barcode (ISBN, UPC, GTIN usw.)
- item_typestring
  Typ (Item, Shipping)
- netto_valuenumber (float)
  Nettowert der Rechnungsposition.
- brutto_valuenumber (float)
  Bruttowert der Rechnungsposition.
- tax_valuenumber (float)
  Steuerbetrag der Rechnungsposition.
- quantitynumber (float)Pflicht
  Menge der Rechnungsposition.
- pricenumber (float)Pflicht
  Einzelpreis der Rechnungsposition.
- namestringPflicht
  Name der Rechnungsposition.
- unitstringPflicht
  Einheit der Rechnungsposition.
- taxTax
  Auf die Rechnungsposition angewendeter Steuersatz.
- invoiceInvoice7
  Rechnung, zu der der Eintrag gehört.
- project_itemCRMProjectItem13
  Projektposition, aus der die Rechnungsposition erstellt wurde.
- base_event_sign_upBaseEventSignUp11
  Anmeldung, für die die Position angelegt wurde.
- productPredefinedBillingItem20
  Produkt der Position.
buyerInvoiceBuyer7
Käufer der Rechnung.
Felder anzeigen (29)
- idinteger
  Primärschlüssel des Clients. Interne ID.
- namestring
  Name des Kunden auf der Rechnung.
- vat_idstring
  USt-IdNr. des Kunden.
- taxnumberstring
  Steuernummer des Kunden.
- buyer_reference_idstring
  Leitweg-ID oder vom Kunden definierte individuelle Referenz-ID
- secondary_namestring
  Zweite Namenszeile des Kunden auf der Rechnung.
- addressstring
  Adresse als Text.
- address_streetstring
  Straße der Adresse.
- address_house_numberstring
  Hausnummer der Adresse.
- address_street_levelstring
  Straße und Hausnummer der Adresse.
- address_costring
  Care-of-Zeile der Adresse.
- address_citystring
  Ort der Adresse.
- address_zipstring
  Postleitzahl der Adresse.
- address_admin_level1string
  Erste Verwaltungsebene der Adresse, z. B. das Bundesland.
- address_countrystring
  Ländercode der Adresse.
- address_full_countrystring
  Vollständiger Name des Landes der Adresse.
- address_geo_latstring
  Breitengrad der Adresse.
- address_geo_lngstring
  Längengrad der Adresse.
- address_external_provider_idstring
  Feld zur Speicherung der externen Anbieter-ID der Adresse, z. B. Google-Maps-PlaceID wie google:ChIJVcKw5r90sEcRhdjNq6NItqE
- numberstring
  Kundennummer des Käufers.
- search_stringstring
  Text, unter dem die Entität gesucht werden kann.
- payment_ownerstring
  Kontoinhaber der Lastschrift.
- payment_institutionstring
  Name der Bank des Lastschrifteinzugs.
- payment_bicstring
  BIC des Bankkontos.
- payment_ibanstring
  IBAN des Bankkontos.
- payment_mandatestring
  Referenz des SEPA-Mandats.
- payment_mandate_sign_datestring (date-time)
  Datum, an dem das SEPA-Mandat unterschrieben wurde.
- payment_mandate_valid_until_datestring (date-time)
  Datum, bis zu dem das SEPA-Mandat gültig ist.
- invoiceInvoice7
  Rechnung, zu der der Käufer gehört.
payment_datestring (date-time)
Datum, an dem die Rechnung bezahlt wurde.
vat_categorystring
Der umsatzsteuerliche Sachverhalt. Der Steuersatz sagt nicht, in welche Zeile der Voranmeldung ein Umsatz gehört. Null Prozent stehen an einer innergemeinschaftlichen Lieferung (Kennzahl 41), an einer Ausfuhr (43), an einer Leistung nach § 13b UStG (60) und an einem steuerfreien Umsatz nach § 4 UStG (48) - vier verschiedene Zeilen, derselbe Steuersatz. Hier ist die einzige Stelle, an der jemand das weiß: beim Schreiben der Rechnung ist bekannt, ob der Kunde eine USt-IdNr. hat und wohin die Ware geht. Später ist es nicht mehr rekonstruierbar. Ohne Angabe der Regelfall - alles andere war bisher nicht erfassbar.
is_payment_date_from_ext_serviceboolean
Das Zahlungsdatum stammt von einem externen Dienst.
direct_debit_exportedboolean
Die Rechnung wurde für das Lastschriftverfahren exportiert.
offerOffer13
Angebot, aus dem die Rechnung erstellt wurde.
Felder anzeigen (45)
- 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.
- base_booking_groupBaseBookingGroup10
  Buchungsgruppe, auf der das Dokument basiert.
- mit_last_send_emailstring (date-time)
  Zeitpunkt, zu dem die letzte E-Mail gesendet wurde.
- mit_to_emailstring
  E-Mail-Adresse, für die die E-Mail bestimmt ist.
- mit_should_send_emailboolean
  Ob eine E-Mail gesendet werden soll.
- mit_last_send_postalstring (date-time)
  Zeitpunkt, zu dem das letzte Schreiben versendet wurde.
- mit_to_address_namestring
  Name des Postempfängers.
- mit_to_address_street_levelstring
  Straße und Hausnummer des Postempfängers.
- mit_to_address_citystring
  Ort des Postempfängers.
- mit_to_address_zipstring
  Postleitzahl des Postempfängers.
- mit_to_address_countrystring
  Land des Postempfängers.
- mit_should_send_postalboolean
  Ob ein Brief gesendet werden soll.
- search_stringstring
  Text, unter dem die Entität gesucht werden kann.
- offer_accounting_typeOfferAccountingTypePflicht
  Buchungsart des Angebots.
- itemsarray<OfferItem12>
  Positionen des Angebots.
- buyerOfferBuyer12
  Käufer des Angebots.
- accepted_datestring (date-time)
  Datum, an dem das Angebot angenommen wurde.
- is_accepted_date_from_ext_serviceboolean
  Das Annahmedatum stammt von einem externen Dienst.
- projectCRMProject21
  Projekt, zu dem das Angebot gehört.
- invoicesarray<Invoice7>
  Aus dem Angebot erstellte Rechnungen.
- base_event_sign_upBaseEventSignUp11
  Anmeldung, für die das Angebot angelegt wurde.
- … 2 weitere Felder
… 14 weitere Felder

Anfrage

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

const options = {method: 'POST', headers: {'x-iw-jwt-token': '<TOKEN>'}};

fetch('https://eure-instanz.iw-erp.de/api/invoice/invoice/42/mail_intend', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://eure-instanz.iw-erp.de/api/invoice/invoice/42/mail_intend"

headers = {"x-iw-jwt-token": "<TOKEN>"}

response = requests.post(url, headers=headers)

print(response.text)

<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://eure-instanz.iw-erp.de/api/invoice/invoice/42/mail_intend', [
  'headers' => [
    'x-iw-jwt-token' => '<TOKEN>',
  ],
]);

echo $response->getBody();

using System.Net.Http.Headers;
var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Post,
  RequestUri = new Uri("https://eure-instanz.iw-erp.de/api/invoice/invoice/42/mail_intend"),
  Headers =
  {
    { "x-iw-jwt-token", "<TOKEN>" },
  },
};
using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://eure-instanz.iw-erp.de/api/invoice/invoice/42/mail_intend")
  .post(null)
  .addHeader("x-iw-jwt-token", "<TOKEN>")
  .build();

Response response = client.newCall(request).execute();

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://eure-instanz.iw-erp.de/api/invoice/invoice/42/mail_intend"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("x-iw-jwt-token", "<TOKEN>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

Dart mit dem Package iw_erp_api

import 'package:iw_erp_api/clients/billing_invoice_controller.dart';
import 'package:iw_erp_api/logic/iw_api_state.dart';
import 'package:iw_erp_api/model/invoice.dart';

IwApiState().host = 'eure-instanz.iw-erp.de';
IwApiState().currentJwtApiToken = '<TOKEN>';

final result = await BillingInvoiceController.updateMailIntend(Invoice.fromJson({}));
if (result.success) {
  print(result.data);
}

Antwort 200 application/json

{
  "tax": {
    "name": "Beispiel",
    "id": 42,
    "value": 1.5,
    "deleted": true,
    "global_default": true,
    "datev_tax_key": 1
  },
  "accounting_type": {
    "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
    }
  },
  "id": 42,
  "currency": "EUR",
  "name": "Beispiel",
  "linked_number_title": "Beispiel",
  "mit_last_send_email": "2026-10-15T09:30:00+02:00",
  "mit_to_email": "lena.hartmann@example.org",
  "mit_should_send_email": true,
  "mit_to_address_name": "Beispiel"
}

Eine Invoice an BuchhaltungsButler übertragen (manuelle Übertragung / erneute Übertragung)

POST/api/invoice/invoice/{id}/buchhaltungsbutler_push

Pfad-Parameter

idPflichtstring

Antworten

200Eine Invoice an BuchhaltungsButler übertragenInvoice5

Felder anzeigen (45)

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.
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%
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.
base_booking_groupBaseBookingGroup10
Buchungsgruppe, auf der das Dokument basiert.
Felder anzeigen (16)
- idinteger
  Primärschlüssel der Buchungsgruppe. Interne ID.
- start_timestring (date-time)
  Beginn der Buchungsgruppe.
- end_timestring (date-time)
  Ende der Buchungsgruppe.
- booking_typestring
  Art der Buchungen in der Gruppe.
- booking_statusstring
  Status der Buchungen in der Gruppe.
- externalboolean
  Die Gruppe wurde von einer externen Stelle erstellt.
- billing_typestring
  Abrechnungsart der Gruppe, zum Beispiel je Buchung oder je Gruppe.
- people_countinteger
  Anzahl der Personen in der Gruppe.
- createdstring (date-time)
  Zeitpunkt, zu dem der Datensatz angelegt wurde.
- updatedstring (date-time)
  Zeitpunkt, zu dem der Datensatz zuletzt aktualisiert wurde.
- namestring
  Name der Einheit.
- deletedboolean
  Diese Eigenschaft markiert eine Entität als gelöscht / archiviert
- deletion_reasonstring
  Grund der Löschung.
- deletion_datestring (date-time)
  Zeitpunkt der Löschung.
- colorstring
  Hintergrundfarbe als Hexwert.
- fg_colorstring
  Vordergrundfarbe als Hex-Wert.
search_stringstring
Text, unter dem die Entität gesucht werden kann.
accounting_typeAccountingTypePflicht
Buchungsart der Rechnung.
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)
payment_typePaymentType
Zahlungsart der Rechnung.
Felder anzeigen (10)
- idinteger
  Primärschlüssel des Zahlungstyps. Interne ID.
- namestring
  Name der Zahlungsart, zum Beispiel Überweisung oder Barzahlung.
- autoboolean
  Zahlungen dieses Typs werden automatisch zugeordnet.
- conditionsstring
  Bedingungen für die Zuordnung von Zahlungen zu diesem Typ.
- linked_keywordsstring
  Schlüsselwörter in Banktransaktionen, die mit dieser Zahlungsart verknüpft werden.
- global_defaultboolean
  Standard-Zahlungsart für neue Rechnungen.
- bank_import_defaultboolean
  Standard-Zahlungsart für Bankimporte.
- is_direct_debitboolean
  Die Zahlungsart ist ein Lastschriftverfahren.
- is_externalboolean
  Die Zahlung wird über einen externen Dienst abgewickelt.
- deletedboolean
  Diese Eigenschaft markiert eine Entität als gelöscht / archiviert
payment_goalPaymentGoal
Zahlungsbedingung der Rechnung.
Felder anzeigen (5)
- idinteger
  Primärschlüssel des Zahlungsziels. Interne ID.
- namestring
  Name der Zahlungsbedingung, zum Beispiel 14 Tage.
- date_stringstring
  Datumsmuster der Zahlungsfrist als Text.
- deletedboolean
  Die Zahlungsfrist wird gelöscht.
- global_defaultboolean
  Standard-Zahlungsziel für neue Rechnungen.
expense_categoryExpenseCategory10
EÜR-Kategorie für diese Rechnung (Einnahmen-Zuordnung) Wenn nicht gesetzt, wird die Default-Kategorie des AccountingTypes verwendet
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.
itemsarray<InvoiceItem5>
Positionen der Rechnung.
Felder anzeigen (18)
- idinteger
  Primärschlüssel der Rechnungsposition. Interne ID.
- descriptionstring
  Beschreibung der Rechnungsposition.
- price_is_bruttoboolean
  Ob der Preis ein Bruttopreis inklusive Steuer ist.
- skustring
  Artikelnummer (Stock Keeping Unit)
- barcodestring
  Barcode (ISBN, UPC, GTIN usw.)
- item_typestring
  Typ (Item, Shipping)
- netto_valuenumber (float)
  Nettowert der Rechnungsposition.
- brutto_valuenumber (float)
  Bruttowert der Rechnungsposition.
- tax_valuenumber (float)
  Steuerbetrag der Rechnungsposition.
- quantitynumber (float)Pflicht
  Menge der Rechnungsposition.
- pricenumber (float)Pflicht
  Einzelpreis der Rechnungsposition.
- namestringPflicht
  Name der Rechnungsposition.
- unitstringPflicht
  Einheit der Rechnungsposition.
- taxTax
  Auf die Rechnungsposition angewendeter Steuersatz.
- invoiceInvoice5
  Rechnung, zu der der Eintrag gehört.
- project_itemCRMProjectItem11
  Projektposition, aus der die Rechnungsposition erstellt wurde.
- base_event_sign_upBaseEventSignUp11
  Anmeldung, für die die Position angelegt wurde.
- productPredefinedBillingItem18
  Produkt der Position.
buyerInvoiceBuyer5
Käufer der Rechnung.
Felder anzeigen (29)
- idinteger
  Primärschlüssel des Clients. Interne ID.
- namestring
  Name des Kunden auf der Rechnung.
- vat_idstring
  USt-IdNr. des Kunden.
- taxnumberstring
  Steuernummer des Kunden.
- buyer_reference_idstring
  Leitweg-ID oder vom Kunden definierte individuelle Referenz-ID
- secondary_namestring
  Zweite Namenszeile des Kunden auf der Rechnung.
- addressstring
  Adresse als Text.
- address_streetstring
  Straße der Adresse.
- address_house_numberstring
  Hausnummer der Adresse.
- address_street_levelstring
  Straße und Hausnummer der Adresse.
- address_costring
  Care-of-Zeile der Adresse.
- address_citystring
  Ort der Adresse.
- address_zipstring
  Postleitzahl der Adresse.
- address_admin_level1string
  Erste Verwaltungsebene der Adresse, z. B. das Bundesland.
- address_countrystring
  Ländercode der Adresse.
- address_full_countrystring
  Vollständiger Name des Landes der Adresse.
- address_geo_latstring
  Breitengrad der Adresse.
- address_geo_lngstring
  Längengrad der Adresse.
- address_external_provider_idstring
  Feld zur Speicherung der externen Anbieter-ID der Adresse, z. B. Google-Maps-PlaceID wie google:ChIJVcKw5r90sEcRhdjNq6NItqE
- numberstring
  Kundennummer des Käufers.
- search_stringstring
  Text, unter dem die Entität gesucht werden kann.
- payment_ownerstring
  Kontoinhaber der Lastschrift.
- payment_institutionstring
  Name der Bank des Lastschrifteinzugs.
- payment_bicstring
  BIC des Bankkontos.
- payment_ibanstring
  IBAN des Bankkontos.
- payment_mandatestring
  Referenz des SEPA-Mandats.
- payment_mandate_sign_datestring (date-time)
  Datum, an dem das SEPA-Mandat unterschrieben wurde.
- payment_mandate_valid_until_datestring (date-time)
  Datum, bis zu dem das SEPA-Mandat gültig ist.
- invoiceInvoice5
  Rechnung, zu der der Käufer gehört.
payment_datestring (date-time)
Datum, an dem die Rechnung bezahlt wurde.
vat_categorystring
Der umsatzsteuerliche Sachverhalt. Der Steuersatz sagt nicht, in welche Zeile der Voranmeldung ein Umsatz gehört. Null Prozent stehen an einer innergemeinschaftlichen Lieferung (Kennzahl 41), an einer Ausfuhr (43), an einer Leistung nach § 13b UStG (60) und an einem steuerfreien Umsatz nach § 4 UStG (48) - vier verschiedene Zeilen, derselbe Steuersatz. Hier ist die einzige Stelle, an der jemand das weiß: beim Schreiben der Rechnung ist bekannt, ob der Kunde eine USt-IdNr. hat und wohin die Ware geht. Später ist es nicht mehr rekonstruierbar. Ohne Angabe der Regelfall - alles andere war bisher nicht erfassbar.
is_payment_date_from_ext_serviceboolean
Das Zahlungsdatum stammt von einem externen Dienst.
direct_debit_exportedboolean
Die Rechnung wurde für das Lastschriftverfahren exportiert.
offerOffer11
Angebot, aus dem die Rechnung erstellt wurde.
Felder anzeigen (36)
- 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.
- base_booking_groupBaseBookingGroup10
  Buchungsgruppe, auf der das Dokument basiert.
- search_stringstring
  Text, unter dem die Entität gesucht werden kann.
- offer_accounting_typeOfferAccountingTypePflicht
  Buchungsart des Angebots.
- itemsarray<OfferItem10>
  Positionen des Angebots.
- buyerOfferBuyer10
  Käufer des Angebots.
- accepted_datestring (date-time)
  Datum, an dem das Angebot angenommen wurde.
- is_accepted_date_from_ext_serviceboolean
  Das Annahmedatum stammt von einem externen Dienst.
- projectCRMProject19
  Projekt, zu dem das Angebot gehört.
- invoicesarray<Invoice5>
  Aus dem Angebot erstellte Rechnungen.
- base_event_sign_upBaseEventSignUp11
  Anmeldung, für die das Angebot angelegt wurde.
- base_bookingBaseBooking12
  Buchung, für die das Angebot erstellt wurde.
- base_event_sign_up_groupBaseEventSignUpGroup2
  Anmeldegruppe, für die das Angebot angelegt wurde.
time_reportsarray<ProjectTimeReport6>
Auf der Rechnung abgerechnete Zeitberichte.
Felder anzeigen (8)
- idinteger
  Primärschlüssel des Projektzeitberichts. Interne ID.
- projectCRMProject19
  Projekt, zu dem der Zeitbericht gehört.
- invoiceInvoice5
  Rechnung, auf der der Zeitbericht abgerechnet wurde.
- time_billed_on_ticket_closeboolean
  Die Zeit wird abgerechnet, wenn das Ticket geschlossen wird.
- startstring (date-time)
  Beginn des gemeldeten Zeitraums.
- endstring (date-time)
  Ende des gemeldeten Zeitraums.
- time_string_billablestring
  Abrechnungsfähige Zeit als Text.
- time_string_not_billablestring
  Nicht abrechenbare Zeit als Text.
payment_provider_statusstring
Status beim Zahlungsanbieter.
payment_provider_referencestring
Referenz beim Zahlungsanbieter.
payment_provider_transaction_referencestring
Transaktionsreferenz beim Zahlungsanbieter.
cancel_datestring (date-time)
Datum, an dem die Rechnung storniert wurde.
cancel_textstring
Text der Stornierung.
base_event_sign_upBaseEventSignUp11
Anmeldung, für die die Rechnung angelegt wurde.
Felder anzeigen (4)
- bib_range_idinteger
- age_classstring
  Altersklasse nach DLV, z. B. M40 – berechnet aus Geburtstag, Geschlecht und Veranstaltungsdatum.
- idinteger
  Primärschlüssel der Anmeldung. Interne ID.
- … 58 weitere Felder
… 7 weitere Felder

Anfrage

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

const options = {method: 'POST', headers: {'x-iw-jwt-token': '<TOKEN>'}};

fetch('https://eure-instanz.iw-erp.de/api/invoice/invoice/42/buchhaltungsbutler_push', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://eure-instanz.iw-erp.de/api/invoice/invoice/42/buchhaltungsbutler_push"

headers = {"x-iw-jwt-token": "<TOKEN>"}

response = requests.post(url, headers=headers)

print(response.text)

<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://eure-instanz.iw-erp.de/api/invoice/invoice/42/buchhaltungsbutler_push', [
  'headers' => [
    'x-iw-jwt-token' => '<TOKEN>',
  ],
]);

echo $response->getBody();

using System.Net.Http.Headers;
var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Post,
  RequestUri = new Uri("https://eure-instanz.iw-erp.de/api/invoice/invoice/42/buchhaltungsbutler_push"),
  Headers =
  {
    { "x-iw-jwt-token", "<TOKEN>" },
  },
};
using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://eure-instanz.iw-erp.de/api/invoice/invoice/42/buchhaltungsbutler_push")
  .post(null)
  .addHeader("x-iw-jwt-token", "<TOKEN>")
  .build();

Response response = client.newCall(request).execute();

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://eure-instanz.iw-erp.de/api/invoice/invoice/42/buchhaltungsbutler_push"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("x-iw-jwt-token", "<TOKEN>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

Dart mit package:http (kein Controller im Package iw_erp_api)

import 'package:http/http.dart' as http;

final response = await http.post(
  Uri.parse('https://eure-instanz.iw-erp.de/api/invoice/invoice/42/buchhaltungsbutler_push'),
  headers: {'x-iw-jwt-token': '<TOKEN>'},
);
print(response.body);

Antwort 200 application/json

{
  "tax": {
    "name": "Beispiel",
    "id": 42,
    "value": 1.5,
    "deleted": true,
    "global_default": true,
    "datev_tax_key": 1
  },
  "accounting_type": {
    "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
    }
  },
  "id": 42,
  "currency": "EUR",
  "name": "Beispiel",
  "linked_number_title": "Beispiel",
  "cancel_text": "Text",
  "token": "string",
  "number": 1,
  "manual_number_prefix": "string"
}