IncomingInvoice

Buchhaltung11 EndpunkteBilling / IncomingInvoice

Liefert eine Liste aller IncomingInvoice-Objekte.

GET/api/invoice/incoming_invoice

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 aller IncomingInvoice-Objekte.array<IncomingInvoice>

Felder anzeigen (46)

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.
external_invoice_numberstring
Externe Rechnungsnummer des Lieferanten
received_datestring (date-time)
Eingangsdatum (wann wurde die Rechnung empfangen)
payment_datestring (date-time)
Zahlungsdatum
service_date_startstring (date-time)
Leistungszeitraum Start
service_date_endstring (date-time)
Leistungszeitraum Ende
vat_categorystring
Der umsatzsteuerliche Sachverhalt. Auf der Eingangsseite entscheidet er darüber, ob die Vorsteuer unter Kennzahl 66 steht (Rechnung eines anderen Unternehmers), unter 61 (innergemeinschaftlicher Erwerb), unter 62 (Einfuhrumsatzsteuer) oder unter 67 (§ 13b UStG). Beim Erwerb und bei § 13b kommt eine zweite Zeile hinzu: Die Steuer schulden wir selbst, obwohl sie uns niemand berechnet hat, und sie steht deshalb zugleich als Umsatzsteuer im Vordruck. Wer nur eine der beiden bucht, zahlt zu viel oder zu wenig. Ohne Angabe gilt der Regelfall.
vat_self_assessed_ratenumber (float)
Der Steuersatz, mit dem die selbst geschuldete Steuer zu rechnen ist. Beim innergemeinschaftlichen Erwerb und bei § 13b UStG berechnet der Lieferant keine Steuer – die Rechnung ist netto, und die Steuer schulden wir. Womit sie zu rechnen ist, steht deshalb auf keinem Beleg: es ist der Satz, der im Inland auf diese Leistung anzuwenden wäre. Ohne Angabe rechnet die Voranmeldung mit dem Regelsatz und sagt in den Hinweisen, bei wie vielen Belegen sie das getan hat. Stillschweigend zu raten wäre in einer Steueranmeldung das Falsche.
import_vat_amountstring
Die Einfuhrumsatzsteuer aus dem Zollbescheid. Sie steht NICHT auf der Rechnung des Lieferanten - die ist bei einer Einfuhr ohne deutsche Steuer. Entrichtet wird sie an den Zoll, und nur der entrichtete Betrag ist als Vorsteuer abziehbar (§ 15 Abs. 1 Satz 1 Nr. 2 UStG, Kennzahl 62 der Voranmeldung). Den Steuerbetrag der Lieferantenrechnung dafür zu nehmen war schlicht der falsche Beleg.
paid_valuenumber (float)
Bereits bezahlter Betrag (für Teilzahlungen)
itemsarray<IncomingInvoiceItem>
Rechnungspositionen
Felder anzeigen (16)
- 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.
- expense_categoryExpenseCategory10
  Kostenkategorie für EÜR (kann von der Hauptkategorie der Rechnung abweichen)
- positioninteger
  Position/Reihenfolge
sellerIncomingInvoiceSeller
Verkäufer/Lieferant Informationen (Snapshot)
Felder anzeigen (25)
- 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.
- main_phonestring
  Haupttelefonnummer.
- main_faxstring
  Haupt-Faxnummer.
- main_emailstring
  Haupt-E-Mail-Adresse.
- websitestring
  Website-Adresse.
expense_categoryExpenseCategory10
Hauptkategorie für EÜR
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.
payment_transactionsarray<PaymentTransaction4>
Verknüpfte Zahlungstransaktionen
Felder anzeigen (14)
- autoboolean
  Die Transaktion wurde automatisch erstellt.
- incomingboolean
  Die Transaktion ist ein Zahlungseingang.
- bank_transactionboolean
  Die Transaktion stammt von einem Bankkonto.
- currencystring
  Währung der Transaktion, zum Beispiel EUR.
- payment_typePaymentType
  Zahlungsart der Transaktion.
- invoicesarray<Invoice31>
- brutto_valuenumber (float)
  Bruttobetrag der Transaktion.
- is_feeboolean
  Die Transaktion ist eine Gebühr, zum Beispiel eine Bankgebühr.
- due_datestring (date-time)
  Dies wird für negative Transaktionen verwendet, um sie von möglichen Zahlungserinnerungen auszuschließen, bis sie fällig sind.
- cash_discountboolean
  Skonto: dieser Teil der Forderung erlischt durch Abzug, nicht durch Zahlung. Kein Geldeingang - Ist-Versteuerung und Mindest-Ist zählen ihn nicht; bei Sollversteuerung mindert er die Bemessungsgrundlage im Zeitraum des Abzugs (§ 17 Abs. 1 UStG).
- deletedboolean
  Diese Eigenschaft markiert eine Entität als gelöscht / archiviert
- namestring
  Name der Einheit.
- createdstring (date-time)
  Zeitpunkt, zu dem der Datensatz angelegt wurde.
- updatedstring (date-time)
  Zeitpunkt, zu dem der Datensatz zuletzt aktualisiert wurde.
incoming_invoice_transactionsarray<IncomingInvoiceTransaction2>
Spezialisierte Zahlungen, die nur dieser Eingangsrechnung zugeordnet sind.
Felder anzeigen (5)
- amountnumber (float)
  Positiver Betrag dieser konkreten Zahlung.
- payment_datestring (date-time)
  Datum der Zahlung.
- currencystring
  Währung der Zahlung.
- createdstring (date-time)
  Zeitpunkt, zu dem der Datensatz angelegt wurde.
- updatedstring (date-time)
  Zeitpunkt, zu dem der Datensatz zuletzt aktualisiert wurde.
document_pathstring
Pfad zur gespeicherten Rechnungsdatei (PDF/Bild)
document_filenamestring
Original Dateiname
document_mime_typestring
MIME-Typ des Dokuments
notesstring
Notizen/Bemerkungen
is_deductibleboolean
Ist die Rechnung für den Vorsteuerabzug relevant?
is_approvedboolean
Wurde die Rechnung geprüft/freigegeben?
approved_atstring (date-time)
Zeitpunkt, zu dem die Eingangsrechnung genehmigt wurde.

Anfrage

curl --request GET \
  --url https://eure-instanz.iw-erp.de/api/invoice/incoming_invoice \
  --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/incoming_invoice', 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/incoming_invoice"

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/incoming_invoice', [
  '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/incoming_invoice"),
  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/incoming_invoice")
  .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/incoming_invoice"

	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/incoming_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 IncomingInvoiceController.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
    },
    "id": 42,
    "currency": "EUR",
    "name": "Beispiel",
    "linked_number_title": "Beispiel",
    "token": "string",
    "number": 1,
    "manual_number_prefix": "string",
    "manual_number": 1,
    "number_string": "string"
  }
]

IncomingInvoice aus einem Datei-Upload importieren (ZUGFeRD-PDF/XML oder normales PDF)

POST/api/invoice/incoming_invoice

Request-Body multipart/form-data

data[file]string (binary)
Rechnungsdatei (PDF oder XML)

Antworten

200IncomingInvoice aus Datei importierenIncomingInvoice

Felder anzeigen (46)

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.
external_invoice_numberstring
Externe Rechnungsnummer des Lieferanten
received_datestring (date-time)
Eingangsdatum (wann wurde die Rechnung empfangen)
payment_datestring (date-time)
Zahlungsdatum
service_date_startstring (date-time)
Leistungszeitraum Start
service_date_endstring (date-time)
Leistungszeitraum Ende
vat_categorystring
Der umsatzsteuerliche Sachverhalt. Auf der Eingangsseite entscheidet er darüber, ob die Vorsteuer unter Kennzahl 66 steht (Rechnung eines anderen Unternehmers), unter 61 (innergemeinschaftlicher Erwerb), unter 62 (Einfuhrumsatzsteuer) oder unter 67 (§ 13b UStG). Beim Erwerb und bei § 13b kommt eine zweite Zeile hinzu: Die Steuer schulden wir selbst, obwohl sie uns niemand berechnet hat, und sie steht deshalb zugleich als Umsatzsteuer im Vordruck. Wer nur eine der beiden bucht, zahlt zu viel oder zu wenig. Ohne Angabe gilt der Regelfall.
vat_self_assessed_ratenumber (float)
Der Steuersatz, mit dem die selbst geschuldete Steuer zu rechnen ist. Beim innergemeinschaftlichen Erwerb und bei § 13b UStG berechnet der Lieferant keine Steuer – die Rechnung ist netto, und die Steuer schulden wir. Womit sie zu rechnen ist, steht deshalb auf keinem Beleg: es ist der Satz, der im Inland auf diese Leistung anzuwenden wäre. Ohne Angabe rechnet die Voranmeldung mit dem Regelsatz und sagt in den Hinweisen, bei wie vielen Belegen sie das getan hat. Stillschweigend zu raten wäre in einer Steueranmeldung das Falsche.
import_vat_amountstring
Die Einfuhrumsatzsteuer aus dem Zollbescheid. Sie steht NICHT auf der Rechnung des Lieferanten - die ist bei einer Einfuhr ohne deutsche Steuer. Entrichtet wird sie an den Zoll, und nur der entrichtete Betrag ist als Vorsteuer abziehbar (§ 15 Abs. 1 Satz 1 Nr. 2 UStG, Kennzahl 62 der Voranmeldung). Den Steuerbetrag der Lieferantenrechnung dafür zu nehmen war schlicht der falsche Beleg.
paid_valuenumber (float)
Bereits bezahlter Betrag (für Teilzahlungen)
itemsarray<IncomingInvoiceItem>
Rechnungspositionen
Felder anzeigen (16)
- 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.
- expense_categoryExpenseCategory10
  Kostenkategorie für EÜR (kann von der Hauptkategorie der Rechnung abweichen)
- positioninteger
  Position/Reihenfolge
sellerIncomingInvoiceSeller
Verkäufer/Lieferant Informationen (Snapshot)
Felder anzeigen (25)
- 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.
- main_phonestring
  Haupttelefonnummer.
- main_faxstring
  Haupt-Faxnummer.
- main_emailstring
  Haupt-E-Mail-Adresse.
- websitestring
  Website-Adresse.
expense_categoryExpenseCategory10
Hauptkategorie für EÜR
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.
payment_transactionsarray<PaymentTransaction4>
Verknüpfte Zahlungstransaktionen
Felder anzeigen (14)
- autoboolean
  Die Transaktion wurde automatisch erstellt.
- incomingboolean
  Die Transaktion ist ein Zahlungseingang.
- bank_transactionboolean
  Die Transaktion stammt von einem Bankkonto.
- currencystring
  Währung der Transaktion, zum Beispiel EUR.
- payment_typePaymentType
  Zahlungsart der Transaktion.
- invoicesarray<Invoice31>
- brutto_valuenumber (float)
  Bruttobetrag der Transaktion.
- is_feeboolean
  Die Transaktion ist eine Gebühr, zum Beispiel eine Bankgebühr.
- due_datestring (date-time)
  Dies wird für negative Transaktionen verwendet, um sie von möglichen Zahlungserinnerungen auszuschließen, bis sie fällig sind.
- cash_discountboolean
  Skonto: dieser Teil der Forderung erlischt durch Abzug, nicht durch Zahlung. Kein Geldeingang - Ist-Versteuerung und Mindest-Ist zählen ihn nicht; bei Sollversteuerung mindert er die Bemessungsgrundlage im Zeitraum des Abzugs (§ 17 Abs. 1 UStG).
- deletedboolean
  Diese Eigenschaft markiert eine Entität als gelöscht / archiviert
- namestring
  Name der Einheit.
- createdstring (date-time)
  Zeitpunkt, zu dem der Datensatz angelegt wurde.
- updatedstring (date-time)
  Zeitpunkt, zu dem der Datensatz zuletzt aktualisiert wurde.
incoming_invoice_transactionsarray<IncomingInvoiceTransaction2>
Spezialisierte Zahlungen, die nur dieser Eingangsrechnung zugeordnet sind.
Felder anzeigen (5)
- amountnumber (float)
  Positiver Betrag dieser konkreten Zahlung.
- payment_datestring (date-time)
  Datum der Zahlung.
- currencystring
  Währung der Zahlung.
- createdstring (date-time)
  Zeitpunkt, zu dem der Datensatz angelegt wurde.
- updatedstring (date-time)
  Zeitpunkt, zu dem der Datensatz zuletzt aktualisiert wurde.
document_pathstring
Pfad zur gespeicherten Rechnungsdatei (PDF/Bild)
document_filenamestring
Original Dateiname
document_mime_typestring
MIME-Typ des Dokuments
notesstring
Notizen/Bemerkungen
is_deductibleboolean
Ist die Rechnung für den Vorsteuerabzug relevant?
is_approvedboolean
Wurde die Rechnung geprüft/freigegeben?
approved_atstring (date-time)
Zeitpunkt, zu dem die Eingangsrechnung genehmigt wurde.

Anfrage

curl --request POST \
  --url https://eure-instanz.iw-erp.de/api/invoice/incoming_invoice \
  --header 'content-type: multipart/form-data' \
  --header 'x-iw-jwt-token: <TOKEN>' \
  --form data[file]='@datei.pdf'

const form = new FormData();
form.append('data[file]', 'datei.pdf');

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

options.body = form;

fetch('https://eure-instanz.iw-erp.de/api/invoice/incoming_invoice', 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/incoming_invoice"

files = { "data[file]": ("datei.pdf", open("datei.pdf", "rb"), "application/pdf") }
headers = {"x-iw-jwt-token": "<TOKEN>"}

response = requests.post(url, files=files, 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/incoming_invoice', [
  'multipart' => [
    [
        'name' => 'data[file]',
        'filename' => 'datei.pdf',
        'contents' => null,
        'headers' => [
                'Content-Type' => 'application/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.Post,
  RequestUri = new Uri("https://eure-instanz.iw-erp.de/api/invoice/incoming_invoice"),
  Headers =
  {
    { "x-iw-jwt-token", "<TOKEN>" },
  },
  Content = new MultipartFormDataContent
  {
    new StringContent("")
    {
      Headers =
      {
        ContentType = new MediaTypeHeaderValue("application/pdf"),
        ContentDisposition = new ContentDispositionHeaderValue("form-data")
        {
          Name = "data[file]",
          FileName = "datei.pdf",
        }
      }
    },
  },
};
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("multipart/form-data; boundary=---011000010111000001101001");
RequestBody body = RequestBody.create(mediaType, "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"data[file]\"; filename=\"datei.pdf\"\r\nContent-Type: application/pdf\r\n\r\n\r\n-----011000010111000001101001--");
Request request = new Request.Builder()
  .url("https://eure-instanz.iw-erp.de/api/invoice/incoming_invoice")
  .post(body)
  .addHeader("x-iw-jwt-token", "<TOKEN>")
  .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/incoming_invoice"

	payload := strings.NewReader("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"data[file]\"; filename=\"datei.pdf\"\r\nContent-Type: application/pdf\r\n\r\n\r\n-----011000010111000001101001--")

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

	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/incoming_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 IncomingInvoiceController.postFile(Stream<List<int>>.fromJson({}), 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
  },
  "id": 42,
  "currency": "EUR",
  "name": "Beispiel",
  "linked_number_title": "Beispiel",
  "token": "string",
  "number": 1,
  "manual_number_prefix": "string",
  "manual_number": 1,
  "number_string": "string"
}

Einzelne IncomingInvoice abrufen

GET/api/invoice/incoming_invoice/{identifier}

Pfad-Parameter

identifierPflichtstring

Antworten

200Einzelne IncomingInvoice abrufenIncomingInvoice

Felder anzeigen (46)

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.
external_invoice_numberstring
Externe Rechnungsnummer des Lieferanten
received_datestring (date-time)
Eingangsdatum (wann wurde die Rechnung empfangen)
payment_datestring (date-time)
Zahlungsdatum
service_date_startstring (date-time)
Leistungszeitraum Start
service_date_endstring (date-time)
Leistungszeitraum Ende
vat_categorystring
Der umsatzsteuerliche Sachverhalt. Auf der Eingangsseite entscheidet er darüber, ob die Vorsteuer unter Kennzahl 66 steht (Rechnung eines anderen Unternehmers), unter 61 (innergemeinschaftlicher Erwerb), unter 62 (Einfuhrumsatzsteuer) oder unter 67 (§ 13b UStG). Beim Erwerb und bei § 13b kommt eine zweite Zeile hinzu: Die Steuer schulden wir selbst, obwohl sie uns niemand berechnet hat, und sie steht deshalb zugleich als Umsatzsteuer im Vordruck. Wer nur eine der beiden bucht, zahlt zu viel oder zu wenig. Ohne Angabe gilt der Regelfall.
vat_self_assessed_ratenumber (float)
Der Steuersatz, mit dem die selbst geschuldete Steuer zu rechnen ist. Beim innergemeinschaftlichen Erwerb und bei § 13b UStG berechnet der Lieferant keine Steuer – die Rechnung ist netto, und die Steuer schulden wir. Womit sie zu rechnen ist, steht deshalb auf keinem Beleg: es ist der Satz, der im Inland auf diese Leistung anzuwenden wäre. Ohne Angabe rechnet die Voranmeldung mit dem Regelsatz und sagt in den Hinweisen, bei wie vielen Belegen sie das getan hat. Stillschweigend zu raten wäre in einer Steueranmeldung das Falsche.
import_vat_amountstring
Die Einfuhrumsatzsteuer aus dem Zollbescheid. Sie steht NICHT auf der Rechnung des Lieferanten - die ist bei einer Einfuhr ohne deutsche Steuer. Entrichtet wird sie an den Zoll, und nur der entrichtete Betrag ist als Vorsteuer abziehbar (§ 15 Abs. 1 Satz 1 Nr. 2 UStG, Kennzahl 62 der Voranmeldung). Den Steuerbetrag der Lieferantenrechnung dafür zu nehmen war schlicht der falsche Beleg.
paid_valuenumber (float)
Bereits bezahlter Betrag (für Teilzahlungen)
itemsarray<IncomingInvoiceItem>
Rechnungspositionen
Felder anzeigen (16)
- 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.
- expense_categoryExpenseCategory10
  Kostenkategorie für EÜR (kann von der Hauptkategorie der Rechnung abweichen)
- positioninteger
  Position/Reihenfolge
sellerIncomingInvoiceSeller
Verkäufer/Lieferant Informationen (Snapshot)
Felder anzeigen (25)
- 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.
- main_phonestring
  Haupttelefonnummer.
- main_faxstring
  Haupt-Faxnummer.
- main_emailstring
  Haupt-E-Mail-Adresse.
- websitestring
  Website-Adresse.
expense_categoryExpenseCategory10
Hauptkategorie für EÜR
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.
payment_transactionsarray<PaymentTransaction4>
Verknüpfte Zahlungstransaktionen
Felder anzeigen (14)
- autoboolean
  Die Transaktion wurde automatisch erstellt.
- incomingboolean
  Die Transaktion ist ein Zahlungseingang.
- bank_transactionboolean
  Die Transaktion stammt von einem Bankkonto.
- currencystring
  Währung der Transaktion, zum Beispiel EUR.
- payment_typePaymentType
  Zahlungsart der Transaktion.
- invoicesarray<Invoice31>
- brutto_valuenumber (float)
  Bruttobetrag der Transaktion.
- is_feeboolean
  Die Transaktion ist eine Gebühr, zum Beispiel eine Bankgebühr.
- due_datestring (date-time)
  Dies wird für negative Transaktionen verwendet, um sie von möglichen Zahlungserinnerungen auszuschließen, bis sie fällig sind.
- cash_discountboolean
  Skonto: dieser Teil der Forderung erlischt durch Abzug, nicht durch Zahlung. Kein Geldeingang - Ist-Versteuerung und Mindest-Ist zählen ihn nicht; bei Sollversteuerung mindert er die Bemessungsgrundlage im Zeitraum des Abzugs (§ 17 Abs. 1 UStG).
- deletedboolean
  Diese Eigenschaft markiert eine Entität als gelöscht / archiviert
- namestring
  Name der Einheit.
- createdstring (date-time)
  Zeitpunkt, zu dem der Datensatz angelegt wurde.
- updatedstring (date-time)
  Zeitpunkt, zu dem der Datensatz zuletzt aktualisiert wurde.
incoming_invoice_transactionsarray<IncomingInvoiceTransaction2>
Spezialisierte Zahlungen, die nur dieser Eingangsrechnung zugeordnet sind.
Felder anzeigen (5)
- amountnumber (float)
  Positiver Betrag dieser konkreten Zahlung.
- payment_datestring (date-time)
  Datum der Zahlung.
- currencystring
  Währung der Zahlung.
- createdstring (date-time)
  Zeitpunkt, zu dem der Datensatz angelegt wurde.
- updatedstring (date-time)
  Zeitpunkt, zu dem der Datensatz zuletzt aktualisiert wurde.
document_pathstring
Pfad zur gespeicherten Rechnungsdatei (PDF/Bild)
document_filenamestring
Original Dateiname
document_mime_typestring
MIME-Typ des Dokuments
notesstring
Notizen/Bemerkungen
is_deductibleboolean
Ist die Rechnung für den Vorsteuerabzug relevant?
is_approvedboolean
Wurde die Rechnung geprüft/freigegeben?
approved_atstring (date-time)
Zeitpunkt, zu dem die Eingangsrechnung genehmigt wurde.

Anfrage

curl --request GET \
  --url https://eure-instanz.iw-erp.de/api/invoice/incoming_invoice/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/incoming_invoice/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/incoming_invoice/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/incoming_invoice/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/incoming_invoice/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/incoming_invoice/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/incoming_invoice/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/incoming_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 IncomingInvoiceController.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
  },
  "id": 42,
  "currency": "EUR",
  "name": "Beispiel",
  "linked_number_title": "Beispiel",
  "token": "string",
  "number": 1,
  "manual_number_prefix": "string",
  "manual_number": 1,
  "number_string": "string"
}

IncomingInvoice aktualisieren

PUT/api/invoice/incoming_invoice/{identifier}

Pfad-Parameter

identifierPflichtstring

Request-Body application/json

dataIncomingInvoice
Felder anzeigen (46)
- idinteger
  Primärschlüssel des Rechnungsdokuments. Interne ID.
- tokenstring
  Token, das das Dokument für den öffentlichen Zugriff identifiziert.
- numberinteger
  Laufende Belegnummer.
- manual_number_prefixstring
  Präfix einer manuell eingegebenen Dokumentnummer.
- manual_numberinteger
  Manuell eingegebene Dokumentnummer.
- number_stringstring
  Belegnummer, wie sie den Benutzern angezeigt wird.
- generation_datestring (date-time)
  Datum, an dem das Dokument erstellt wurde.
- number_datestring (date-time)
  Datum, das für die Belegnummer verwendet wird.
- messagestring
  Auf dem Dokument gedruckte Nachricht.
- currencystring
  Währung des Dokuments.
- namestring
  Name des Dokuments.
- due_datestring (date-time)
  Fälligkeitsdatum des Dokuments.
- netto_valuenumber (float)
  Nettosumme des Dokuments.
- brutto_valuenumber (float)
  Bruttogesamtbetrag des Dokuments.
- tax_valuenumber (float)
  Gesamter Steuerbetrag des Dokuments.
- taxTaxPflicht
  Auf das Dokument angewendeter Steuersatz.
- linked_number_titlestring
  Titel der verknüpften Dokumentnummer.
- linked_numberstring
  Nummer des verknüpften Belegs.
- statusstring
  Status des Dokuments.
- previous_statusstring
  Status vor der letzten Änderung.
- status_updatedstring (date-time)
  Zeitpunkt, zu dem der Status zuletzt geändert wurde.
- archivedboolean
  Ob das Dokument archiviert ist.
- last_pdf_exportstring (date-time)
  Zeitpunkt, zu dem das PDF zuletzt exportiert wurde.
- last_status_exportstring
  Status beim letzten Export.
- search_stringstring
  Text, unter dem die Entität gesucht werden kann.
- external_invoice_numberstring
  Externe Rechnungsnummer des Lieferanten
- received_datestring (date-time)
  Eingangsdatum (wann wurde die Rechnung empfangen)
- payment_datestring (date-time)
  Zahlungsdatum
- service_date_startstring (date-time)
  Leistungszeitraum Start
- service_date_endstring (date-time)
  Leistungszeitraum Ende
- vat_categorystring
  Der umsatzsteuerliche Sachverhalt. Auf der Eingangsseite entscheidet er darüber, ob die Vorsteuer unter Kennzahl 66 steht (Rechnung eines anderen Unternehmers), unter 61 (innergemeinschaftlicher Erwerb), unter 62 (Einfuhrumsatzsteuer) oder unter 67 (§ 13b UStG). Beim Erwerb und bei § 13b kommt eine zweite Zeile hinzu: Die Steuer schulden wir selbst, obwohl sie uns niemand berechnet hat, und sie steht deshalb zugleich als Umsatzsteuer im Vordruck. Wer nur eine der beiden bucht, zahlt zu viel oder zu wenig. Ohne Angabe gilt der Regelfall.
- vat_self_assessed_ratenumber (float)
  Der Steuersatz, mit dem die selbst geschuldete Steuer zu rechnen ist. Beim innergemeinschaftlichen Erwerb und bei § 13b UStG berechnet der Lieferant keine Steuer – die Rechnung ist netto, und die Steuer schulden wir. Womit sie zu rechnen ist, steht deshalb auf keinem Beleg: es ist der Satz, der im Inland auf diese Leistung anzuwenden wäre. Ohne Angabe rechnet die Voranmeldung mit dem Regelsatz und sagt in den Hinweisen, bei wie vielen Belegen sie das getan hat. Stillschweigend zu raten wäre in einer Steueranmeldung das Falsche.
- import_vat_amountstring
  Die Einfuhrumsatzsteuer aus dem Zollbescheid. Sie steht NICHT auf der Rechnung des Lieferanten - die ist bei einer Einfuhr ohne deutsche Steuer. Entrichtet wird sie an den Zoll, und nur der entrichtete Betrag ist als Vorsteuer abziehbar (§ 15 Abs. 1 Satz 1 Nr. 2 UStG, Kennzahl 62 der Voranmeldung). Den Steuerbetrag der Lieferantenrechnung dafür zu nehmen war schlicht der falsche Beleg.
- paid_valuenumber (float)
  Bereits bezahlter Betrag (für Teilzahlungen)
- itemsarray<IncomingInvoiceItem>
  Rechnungspositionen
- sellerIncomingInvoiceSeller
  Verkäufer/Lieferant Informationen (Snapshot)
- expense_categoryExpenseCategory10
  Hauptkategorie für EÜR
- payment_transactionsarray<PaymentTransaction4>
  Verknüpfte Zahlungstransaktionen
- incoming_invoice_transactionsarray<IncomingInvoiceTransaction2>
  Spezialisierte Zahlungen, die nur dieser Eingangsrechnung zugeordnet sind.
- document_pathstring
  Pfad zur gespeicherten Rechnungsdatei (PDF/Bild)
- document_filenamestring
  Original Dateiname
- document_mime_typestring
  MIME-Typ des Dokuments
- notesstring
  Notizen/Bemerkungen
- is_deductibleboolean
  Ist die Rechnung für den Vorsteuerabzug relevant?
- is_approvedboolean
  Wurde die Rechnung geprüft/freigegeben?
- approved_atstring (date-time)
  Zeitpunkt, zu dem die Eingangsrechnung genehmigt wurde.

Antworten

200IncomingInvoice aktualisierenIncomingInvoice

Felder anzeigen (46)

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.
external_invoice_numberstring
Externe Rechnungsnummer des Lieferanten
received_datestring (date-time)
Eingangsdatum (wann wurde die Rechnung empfangen)
payment_datestring (date-time)
Zahlungsdatum
service_date_startstring (date-time)
Leistungszeitraum Start
service_date_endstring (date-time)
Leistungszeitraum Ende
vat_categorystring
Der umsatzsteuerliche Sachverhalt. Auf der Eingangsseite entscheidet er darüber, ob die Vorsteuer unter Kennzahl 66 steht (Rechnung eines anderen Unternehmers), unter 61 (innergemeinschaftlicher Erwerb), unter 62 (Einfuhrumsatzsteuer) oder unter 67 (§ 13b UStG). Beim Erwerb und bei § 13b kommt eine zweite Zeile hinzu: Die Steuer schulden wir selbst, obwohl sie uns niemand berechnet hat, und sie steht deshalb zugleich als Umsatzsteuer im Vordruck. Wer nur eine der beiden bucht, zahlt zu viel oder zu wenig. Ohne Angabe gilt der Regelfall.
vat_self_assessed_ratenumber (float)
Der Steuersatz, mit dem die selbst geschuldete Steuer zu rechnen ist. Beim innergemeinschaftlichen Erwerb und bei § 13b UStG berechnet der Lieferant keine Steuer – die Rechnung ist netto, und die Steuer schulden wir. Womit sie zu rechnen ist, steht deshalb auf keinem Beleg: es ist der Satz, der im Inland auf diese Leistung anzuwenden wäre. Ohne Angabe rechnet die Voranmeldung mit dem Regelsatz und sagt in den Hinweisen, bei wie vielen Belegen sie das getan hat. Stillschweigend zu raten wäre in einer Steueranmeldung das Falsche.
import_vat_amountstring
Die Einfuhrumsatzsteuer aus dem Zollbescheid. Sie steht NICHT auf der Rechnung des Lieferanten - die ist bei einer Einfuhr ohne deutsche Steuer. Entrichtet wird sie an den Zoll, und nur der entrichtete Betrag ist als Vorsteuer abziehbar (§ 15 Abs. 1 Satz 1 Nr. 2 UStG, Kennzahl 62 der Voranmeldung). Den Steuerbetrag der Lieferantenrechnung dafür zu nehmen war schlicht der falsche Beleg.
paid_valuenumber (float)
Bereits bezahlter Betrag (für Teilzahlungen)
itemsarray<IncomingInvoiceItem>
Rechnungspositionen
Felder anzeigen (16)
- 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.
- expense_categoryExpenseCategory10
  Kostenkategorie für EÜR (kann von der Hauptkategorie der Rechnung abweichen)
- positioninteger
  Position/Reihenfolge
sellerIncomingInvoiceSeller
Verkäufer/Lieferant Informationen (Snapshot)
Felder anzeigen (25)
- 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.
- main_phonestring
  Haupttelefonnummer.
- main_faxstring
  Haupt-Faxnummer.
- main_emailstring
  Haupt-E-Mail-Adresse.
- websitestring
  Website-Adresse.
expense_categoryExpenseCategory10
Hauptkategorie für EÜR
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.
payment_transactionsarray<PaymentTransaction4>
Verknüpfte Zahlungstransaktionen
Felder anzeigen (14)
- autoboolean
  Die Transaktion wurde automatisch erstellt.
- incomingboolean
  Die Transaktion ist ein Zahlungseingang.
- bank_transactionboolean
  Die Transaktion stammt von einem Bankkonto.
- currencystring
  Währung der Transaktion, zum Beispiel EUR.
- payment_typePaymentType
  Zahlungsart der Transaktion.
- invoicesarray<Invoice31>
- brutto_valuenumber (float)
  Bruttobetrag der Transaktion.
- is_feeboolean
  Die Transaktion ist eine Gebühr, zum Beispiel eine Bankgebühr.
- due_datestring (date-time)
  Dies wird für negative Transaktionen verwendet, um sie von möglichen Zahlungserinnerungen auszuschließen, bis sie fällig sind.
- cash_discountboolean
  Skonto: dieser Teil der Forderung erlischt durch Abzug, nicht durch Zahlung. Kein Geldeingang - Ist-Versteuerung und Mindest-Ist zählen ihn nicht; bei Sollversteuerung mindert er die Bemessungsgrundlage im Zeitraum des Abzugs (§ 17 Abs. 1 UStG).
- deletedboolean
  Diese Eigenschaft markiert eine Entität als gelöscht / archiviert
- namestring
  Name der Einheit.
- createdstring (date-time)
  Zeitpunkt, zu dem der Datensatz angelegt wurde.
- updatedstring (date-time)
  Zeitpunkt, zu dem der Datensatz zuletzt aktualisiert wurde.
incoming_invoice_transactionsarray<IncomingInvoiceTransaction2>
Spezialisierte Zahlungen, die nur dieser Eingangsrechnung zugeordnet sind.
Felder anzeigen (5)
- amountnumber (float)
  Positiver Betrag dieser konkreten Zahlung.
- payment_datestring (date-time)
  Datum der Zahlung.
- currencystring
  Währung der Zahlung.
- createdstring (date-time)
  Zeitpunkt, zu dem der Datensatz angelegt wurde.
- updatedstring (date-time)
  Zeitpunkt, zu dem der Datensatz zuletzt aktualisiert wurde.
document_pathstring
Pfad zur gespeicherten Rechnungsdatei (PDF/Bild)
document_filenamestring
Original Dateiname
document_mime_typestring
MIME-Typ des Dokuments
notesstring
Notizen/Bemerkungen
is_deductibleboolean
Ist die Rechnung für den Vorsteuerabzug relevant?
is_approvedboolean
Wurde die Rechnung geprüft/freigegeben?
approved_atstring (date-time)
Zeitpunkt, zu dem die Eingangsrechnung genehmigt wurde.

Anfrage

curl --request PUT \
  --url https://eure-instanz.iw-erp.de/api/invoice/incoming_invoice/42 \
  --header 'content-type: application/json' \
  --header 'x-iw-jwt-token: <TOKEN>' \
  --data '
{
  "data": {
    "tax": {
      "name": "Beispiel",
      "id": 42,
      "value": 1.5,
      "deleted": true,
      "global_default": true,
      "datev_tax_key": 1
    },
    "id": 42,
    "currency": "EUR",
    "name": "Beispiel",
    "linked_number_title": "Beispiel",
    "token": "string"
  }
}
'

const options = {
  method: 'PUT',
  headers: {'x-iw-jwt-token': '<TOKEN>', 'content-type': 'application/json'},
  body: JSON.stringify({
    data: {
      tax: {
        name: 'Beispiel',
        id: 42,
        value: 1.5,
        deleted: true,
        global_default: true,
        datev_tax_key: 1
      },
      id: 42,
      currency: 'EUR',
      name: 'Beispiel',
      linked_number_title: 'Beispiel',
      token: 'string'
    }
  })
};

fetch('https://eure-instanz.iw-erp.de/api/invoice/incoming_invoice/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/incoming_invoice/42"

payload = { "data": {
    "tax": {
      "name": "Beispiel",
      "id": 42,
      "value": 1.5,
      "deleted": True,
      "global_default": True,
      "datev_tax_key": 1
    },
    "id": 42,
    "currency": "EUR",
    "name": "Beispiel",
    "linked_number_title": "Beispiel",
    "token": "string"
  } }
headers = {
  "x-iw-jwt-token": "<TOKEN>",
  "content-type": "application/json"
}

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

print(response.text)

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

$client = new \GuzzleHttp\Client();

$response = $client->request('PUT', 'https://eure-instanz.iw-erp.de/api/invoice/incoming_invoice/42', [
  'body' => '{"data":{"tax":{"name":"Beispiel","id":42,"value":1.5,"deleted":true,"global_default":true,"datev_tax_key":1},"id":42,"currency":"EUR","name":"Beispiel","linked_number_title":"Beispiel","token":"string"}}',
  '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.Put,
  RequestUri = new Uri("https://eure-instanz.iw-erp.de/api/invoice/incoming_invoice/42"),
  Headers =
  {
    { "x-iw-jwt-token", "<TOKEN>" },
  },
  Content = new StringContent("{\"data\":{\"tax\":{\"name\":\"Beispiel\",\"id\":42,\"value\":1.5,\"deleted\":true,\"global_default\":true,\"datev_tax_key\":1},\"id\":42,\"currency\":\"EUR\",\"name\":\"Beispiel\",\"linked_number_title\":\"Beispiel\",\"token\":\"string\"}}")
  {
    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\":{\"tax\":{\"name\":\"Beispiel\",\"id\":42,\"value\":1.5,\"deleted\":true,\"global_default\":true,\"datev_tax_key\":1},\"id\":42,\"currency\":\"EUR\",\"name\":\"Beispiel\",\"linked_number_title\":\"Beispiel\",\"token\":\"string\"}}");
Request request = new Request.Builder()
  .url("https://eure-instanz.iw-erp.de/api/invoice/incoming_invoice/42")
  .put(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/incoming_invoice/42"

	payload := strings.NewReader("{\"data\":{\"tax\":{\"name\":\"Beispiel\",\"id\":42,\"value\":1.5,\"deleted\":true,\"global_default\":true,\"datev_tax_key\":1},\"id\":42,\"currency\":\"EUR\",\"name\":\"Beispiel\",\"linked_number_title\":\"Beispiel\",\"token\":\"string\"}}")

	req, _ := http.NewRequest("PUT", 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/incoming_invoice_controller.dart';
import 'package:iw_erp_api/logic/iw_api_state.dart';
import 'package:iw_erp_api/model/incoming_invoice.dart';

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

final result = await IncomingInvoiceController.put(IncomingInvoice.fromJson({
  "tax": {
    "name": "Beispiel",
    "id": 42,
    "value": 1.5,
    "deleted": true,
    "global_default": true,
    "datev_tax_key": 1
  },
  "id": 42,
  "currency": "EUR",
  "name": "Beispiel",
  "linked_number_title": "Beispiel",
  "token": "string"
}));
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
  },
  "id": 42,
  "currency": "EUR",
  "name": "Beispiel",
  "linked_number_title": "Beispiel",
  "token": "string",
  "number": 1,
  "manual_number_prefix": "string",
  "manual_number": 1,
  "number_string": "string"
}

Eine IncomingInvoice löschen (Soft Delete - Archivierung)

DELETE/api/invoice/incoming_invoice/{identifier}

Pfad-Parameter

identifierPflichtstring

Antworten

200Eine IncomingInvoice löschenIncomingInvoice

Felder anzeigen (46)

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.
external_invoice_numberstring
Externe Rechnungsnummer des Lieferanten
received_datestring (date-time)
Eingangsdatum (wann wurde die Rechnung empfangen)
payment_datestring (date-time)
Zahlungsdatum
service_date_startstring (date-time)
Leistungszeitraum Start
service_date_endstring (date-time)
Leistungszeitraum Ende
vat_categorystring
Der umsatzsteuerliche Sachverhalt. Auf der Eingangsseite entscheidet er darüber, ob die Vorsteuer unter Kennzahl 66 steht (Rechnung eines anderen Unternehmers), unter 61 (innergemeinschaftlicher Erwerb), unter 62 (Einfuhrumsatzsteuer) oder unter 67 (§ 13b UStG). Beim Erwerb und bei § 13b kommt eine zweite Zeile hinzu: Die Steuer schulden wir selbst, obwohl sie uns niemand berechnet hat, und sie steht deshalb zugleich als Umsatzsteuer im Vordruck. Wer nur eine der beiden bucht, zahlt zu viel oder zu wenig. Ohne Angabe gilt der Regelfall.
vat_self_assessed_ratenumber (float)
Der Steuersatz, mit dem die selbst geschuldete Steuer zu rechnen ist. Beim innergemeinschaftlichen Erwerb und bei § 13b UStG berechnet der Lieferant keine Steuer – die Rechnung ist netto, und die Steuer schulden wir. Womit sie zu rechnen ist, steht deshalb auf keinem Beleg: es ist der Satz, der im Inland auf diese Leistung anzuwenden wäre. Ohne Angabe rechnet die Voranmeldung mit dem Regelsatz und sagt in den Hinweisen, bei wie vielen Belegen sie das getan hat. Stillschweigend zu raten wäre in einer Steueranmeldung das Falsche.
import_vat_amountstring
Die Einfuhrumsatzsteuer aus dem Zollbescheid. Sie steht NICHT auf der Rechnung des Lieferanten - die ist bei einer Einfuhr ohne deutsche Steuer. Entrichtet wird sie an den Zoll, und nur der entrichtete Betrag ist als Vorsteuer abziehbar (§ 15 Abs. 1 Satz 1 Nr. 2 UStG, Kennzahl 62 der Voranmeldung). Den Steuerbetrag der Lieferantenrechnung dafür zu nehmen war schlicht der falsche Beleg.
paid_valuenumber (float)
Bereits bezahlter Betrag (für Teilzahlungen)
itemsarray<IncomingInvoiceItem>
Rechnungspositionen
Felder anzeigen (16)
- 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.
- expense_categoryExpenseCategory10
  Kostenkategorie für EÜR (kann von der Hauptkategorie der Rechnung abweichen)
- positioninteger
  Position/Reihenfolge
sellerIncomingInvoiceSeller
Verkäufer/Lieferant Informationen (Snapshot)
Felder anzeigen (25)
- 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.
- main_phonestring
  Haupttelefonnummer.
- main_faxstring
  Haupt-Faxnummer.
- main_emailstring
  Haupt-E-Mail-Adresse.
- websitestring
  Website-Adresse.
expense_categoryExpenseCategory10
Hauptkategorie für EÜR
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.
payment_transactionsarray<PaymentTransaction4>
Verknüpfte Zahlungstransaktionen
Felder anzeigen (14)
- autoboolean
  Die Transaktion wurde automatisch erstellt.
- incomingboolean
  Die Transaktion ist ein Zahlungseingang.
- bank_transactionboolean
  Die Transaktion stammt von einem Bankkonto.
- currencystring
  Währung der Transaktion, zum Beispiel EUR.
- payment_typePaymentType
  Zahlungsart der Transaktion.
- invoicesarray<Invoice31>
- brutto_valuenumber (float)
  Bruttobetrag der Transaktion.
- is_feeboolean
  Die Transaktion ist eine Gebühr, zum Beispiel eine Bankgebühr.
- due_datestring (date-time)
  Dies wird für negative Transaktionen verwendet, um sie von möglichen Zahlungserinnerungen auszuschließen, bis sie fällig sind.
- cash_discountboolean
  Skonto: dieser Teil der Forderung erlischt durch Abzug, nicht durch Zahlung. Kein Geldeingang - Ist-Versteuerung und Mindest-Ist zählen ihn nicht; bei Sollversteuerung mindert er die Bemessungsgrundlage im Zeitraum des Abzugs (§ 17 Abs. 1 UStG).
- deletedboolean
  Diese Eigenschaft markiert eine Entität als gelöscht / archiviert
- namestring
  Name der Einheit.
- createdstring (date-time)
  Zeitpunkt, zu dem der Datensatz angelegt wurde.
- updatedstring (date-time)
  Zeitpunkt, zu dem der Datensatz zuletzt aktualisiert wurde.
incoming_invoice_transactionsarray<IncomingInvoiceTransaction2>
Spezialisierte Zahlungen, die nur dieser Eingangsrechnung zugeordnet sind.
Felder anzeigen (5)
- amountnumber (float)
  Positiver Betrag dieser konkreten Zahlung.
- payment_datestring (date-time)
  Datum der Zahlung.
- currencystring
  Währung der Zahlung.
- createdstring (date-time)
  Zeitpunkt, zu dem der Datensatz angelegt wurde.
- updatedstring (date-time)
  Zeitpunkt, zu dem der Datensatz zuletzt aktualisiert wurde.
document_pathstring
Pfad zur gespeicherten Rechnungsdatei (PDF/Bild)
document_filenamestring
Original Dateiname
document_mime_typestring
MIME-Typ des Dokuments
notesstring
Notizen/Bemerkungen
is_deductibleboolean
Ist die Rechnung für den Vorsteuerabzug relevant?
is_approvedboolean
Wurde die Rechnung geprüft/freigegeben?
approved_atstring (date-time)
Zeitpunkt, zu dem die Eingangsrechnung genehmigt wurde.

Anfrage

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

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

fetch('https://eure-instanz.iw-erp.de/api/invoice/incoming_invoice/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/incoming_invoice/42"

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

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

print(response.text)

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

$client = new \GuzzleHttp\Client();

$response = $client->request('DELETE', 'https://eure-instanz.iw-erp.de/api/invoice/incoming_invoice/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.Delete,
  RequestUri = new Uri("https://eure-instanz.iw-erp.de/api/invoice/incoming_invoice/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/incoming_invoice/42")
  .delete(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/incoming_invoice/42"

	req, _ := http.NewRequest("DELETE", 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/incoming_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 IncomingInvoiceController.delete('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
  },
  "id": 42,
  "currency": "EUR",
  "name": "Beispiel",
  "linked_number_title": "Beispiel",
  "token": "string",
  "number": 1,
  "manual_number_prefix": "string",
  "manual_number": 1,
  "number_string": "string"
}

Alle PDF/XML-Rechnungen aus einem ZIP-Archiv importieren.

POST/api/invoice/incoming_invoice/archive

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

200IncomingInvoices aus einem ZIP-Archiv importierenarray<IncomingInvoice>

Felder anzeigen (46)

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.
external_invoice_numberstring
Externe Rechnungsnummer des Lieferanten
received_datestring (date-time)
Eingangsdatum (wann wurde die Rechnung empfangen)
payment_datestring (date-time)
Zahlungsdatum
service_date_startstring (date-time)
Leistungszeitraum Start
service_date_endstring (date-time)
Leistungszeitraum Ende
vat_categorystring
Der umsatzsteuerliche Sachverhalt. Auf der Eingangsseite entscheidet er darüber, ob die Vorsteuer unter Kennzahl 66 steht (Rechnung eines anderen Unternehmers), unter 61 (innergemeinschaftlicher Erwerb), unter 62 (Einfuhrumsatzsteuer) oder unter 67 (§ 13b UStG). Beim Erwerb und bei § 13b kommt eine zweite Zeile hinzu: Die Steuer schulden wir selbst, obwohl sie uns niemand berechnet hat, und sie steht deshalb zugleich als Umsatzsteuer im Vordruck. Wer nur eine der beiden bucht, zahlt zu viel oder zu wenig. Ohne Angabe gilt der Regelfall.
vat_self_assessed_ratenumber (float)
Der Steuersatz, mit dem die selbst geschuldete Steuer zu rechnen ist. Beim innergemeinschaftlichen Erwerb und bei § 13b UStG berechnet der Lieferant keine Steuer – die Rechnung ist netto, und die Steuer schulden wir. Womit sie zu rechnen ist, steht deshalb auf keinem Beleg: es ist der Satz, der im Inland auf diese Leistung anzuwenden wäre. Ohne Angabe rechnet die Voranmeldung mit dem Regelsatz und sagt in den Hinweisen, bei wie vielen Belegen sie das getan hat. Stillschweigend zu raten wäre in einer Steueranmeldung das Falsche.
import_vat_amountstring
Die Einfuhrumsatzsteuer aus dem Zollbescheid. Sie steht NICHT auf der Rechnung des Lieferanten - die ist bei einer Einfuhr ohne deutsche Steuer. Entrichtet wird sie an den Zoll, und nur der entrichtete Betrag ist als Vorsteuer abziehbar (§ 15 Abs. 1 Satz 1 Nr. 2 UStG, Kennzahl 62 der Voranmeldung). Den Steuerbetrag der Lieferantenrechnung dafür zu nehmen war schlicht der falsche Beleg.
paid_valuenumber (float)
Bereits bezahlter Betrag (für Teilzahlungen)
itemsarray<IncomingInvoiceItem>
Rechnungspositionen
Felder anzeigen (16)
- 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.
- expense_categoryExpenseCategory10
  Kostenkategorie für EÜR (kann von der Hauptkategorie der Rechnung abweichen)
- positioninteger
  Position/Reihenfolge
sellerIncomingInvoiceSeller
Verkäufer/Lieferant Informationen (Snapshot)
Felder anzeigen (25)
- 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.
- main_phonestring
  Haupttelefonnummer.
- main_faxstring
  Haupt-Faxnummer.
- main_emailstring
  Haupt-E-Mail-Adresse.
- websitestring
  Website-Adresse.
expense_categoryExpenseCategory10
Hauptkategorie für EÜR
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.
payment_transactionsarray<PaymentTransaction4>
Verknüpfte Zahlungstransaktionen
Felder anzeigen (14)
- autoboolean
  Die Transaktion wurde automatisch erstellt.
- incomingboolean
  Die Transaktion ist ein Zahlungseingang.
- bank_transactionboolean
  Die Transaktion stammt von einem Bankkonto.
- currencystring
  Währung der Transaktion, zum Beispiel EUR.
- payment_typePaymentType
  Zahlungsart der Transaktion.
- invoicesarray<Invoice31>
- brutto_valuenumber (float)
  Bruttobetrag der Transaktion.
- is_feeboolean
  Die Transaktion ist eine Gebühr, zum Beispiel eine Bankgebühr.
- due_datestring (date-time)
  Dies wird für negative Transaktionen verwendet, um sie von möglichen Zahlungserinnerungen auszuschließen, bis sie fällig sind.
- cash_discountboolean
  Skonto: dieser Teil der Forderung erlischt durch Abzug, nicht durch Zahlung. Kein Geldeingang - Ist-Versteuerung und Mindest-Ist zählen ihn nicht; bei Sollversteuerung mindert er die Bemessungsgrundlage im Zeitraum des Abzugs (§ 17 Abs. 1 UStG).
- deletedboolean
  Diese Eigenschaft markiert eine Entität als gelöscht / archiviert
- namestring
  Name der Einheit.
- createdstring (date-time)
  Zeitpunkt, zu dem der Datensatz angelegt wurde.
- updatedstring (date-time)
  Zeitpunkt, zu dem der Datensatz zuletzt aktualisiert wurde.
incoming_invoice_transactionsarray<IncomingInvoiceTransaction2>
Spezialisierte Zahlungen, die nur dieser Eingangsrechnung zugeordnet sind.
Felder anzeigen (5)
- amountnumber (float)
  Positiver Betrag dieser konkreten Zahlung.
- payment_datestring (date-time)
  Datum der Zahlung.
- currencystring
  Währung der Zahlung.
- createdstring (date-time)
  Zeitpunkt, zu dem der Datensatz angelegt wurde.
- updatedstring (date-time)
  Zeitpunkt, zu dem der Datensatz zuletzt aktualisiert wurde.
document_pathstring
Pfad zur gespeicherten Rechnungsdatei (PDF/Bild)
document_filenamestring
Original Dateiname
document_mime_typestring
MIME-Typ des Dokuments
notesstring
Notizen/Bemerkungen
is_deductibleboolean
Ist die Rechnung für den Vorsteuerabzug relevant?
is_approvedboolean
Wurde die Rechnung geprüft/freigegeben?
approved_atstring (date-time)
Zeitpunkt, zu dem die Eingangsrechnung genehmigt wurde.

Anfrage

curl --request POST \
  --url https://eure-instanz.iw-erp.de/api/invoice/incoming_invoice/archive \
  --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/incoming_invoice/archive', 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/incoming_invoice/archive"

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/incoming_invoice/archive', [
  '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/incoming_invoice/archive"),
  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/incoming_invoice/archive")
  .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/incoming_invoice/archive"

	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/incoming_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 IncomingInvoiceController.postArchive(Stream<List<int>>.fromJson({}), 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
    },
    "id": 42,
    "currency": "EUR",
    "name": "Beispiel",
    "linked_number_title": "Beispiel",
    "token": "string",
    "number": 1,
    "manual_number_prefix": "string",
    "manual_number": 1,
    "number_string": "string"
  }
]

Eine IncomingInvoice als genehmigt markieren

POST/api/invoice/incoming_invoice/{identifier}/approve

Pfad-Parameter

identifierPflichtstring

Antworten

200Eine Eingangsrechnung genehmigenIncomingInvoice

Felder anzeigen (46)

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.
external_invoice_numberstring
Externe Rechnungsnummer des Lieferanten
received_datestring (date-time)
Eingangsdatum (wann wurde die Rechnung empfangen)
payment_datestring (date-time)
Zahlungsdatum
service_date_startstring (date-time)
Leistungszeitraum Start
service_date_endstring (date-time)
Leistungszeitraum Ende
vat_categorystring
Der umsatzsteuerliche Sachverhalt. Auf der Eingangsseite entscheidet er darüber, ob die Vorsteuer unter Kennzahl 66 steht (Rechnung eines anderen Unternehmers), unter 61 (innergemeinschaftlicher Erwerb), unter 62 (Einfuhrumsatzsteuer) oder unter 67 (§ 13b UStG). Beim Erwerb und bei § 13b kommt eine zweite Zeile hinzu: Die Steuer schulden wir selbst, obwohl sie uns niemand berechnet hat, und sie steht deshalb zugleich als Umsatzsteuer im Vordruck. Wer nur eine der beiden bucht, zahlt zu viel oder zu wenig. Ohne Angabe gilt der Regelfall.
vat_self_assessed_ratenumber (float)
Der Steuersatz, mit dem die selbst geschuldete Steuer zu rechnen ist. Beim innergemeinschaftlichen Erwerb und bei § 13b UStG berechnet der Lieferant keine Steuer – die Rechnung ist netto, und die Steuer schulden wir. Womit sie zu rechnen ist, steht deshalb auf keinem Beleg: es ist der Satz, der im Inland auf diese Leistung anzuwenden wäre. Ohne Angabe rechnet die Voranmeldung mit dem Regelsatz und sagt in den Hinweisen, bei wie vielen Belegen sie das getan hat. Stillschweigend zu raten wäre in einer Steueranmeldung das Falsche.
import_vat_amountstring
Die Einfuhrumsatzsteuer aus dem Zollbescheid. Sie steht NICHT auf der Rechnung des Lieferanten - die ist bei einer Einfuhr ohne deutsche Steuer. Entrichtet wird sie an den Zoll, und nur der entrichtete Betrag ist als Vorsteuer abziehbar (§ 15 Abs. 1 Satz 1 Nr. 2 UStG, Kennzahl 62 der Voranmeldung). Den Steuerbetrag der Lieferantenrechnung dafür zu nehmen war schlicht der falsche Beleg.
paid_valuenumber (float)
Bereits bezahlter Betrag (für Teilzahlungen)
itemsarray<IncomingInvoiceItem>
Rechnungspositionen
Felder anzeigen (16)
- 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.
- expense_categoryExpenseCategory10
  Kostenkategorie für EÜR (kann von der Hauptkategorie der Rechnung abweichen)
- positioninteger
  Position/Reihenfolge
sellerIncomingInvoiceSeller
Verkäufer/Lieferant Informationen (Snapshot)
Felder anzeigen (25)
- 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.
- main_phonestring
  Haupttelefonnummer.
- main_faxstring
  Haupt-Faxnummer.
- main_emailstring
  Haupt-E-Mail-Adresse.
- websitestring
  Website-Adresse.
expense_categoryExpenseCategory10
Hauptkategorie für EÜR
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.
payment_transactionsarray<PaymentTransaction4>
Verknüpfte Zahlungstransaktionen
Felder anzeigen (14)
- autoboolean
  Die Transaktion wurde automatisch erstellt.
- incomingboolean
  Die Transaktion ist ein Zahlungseingang.
- bank_transactionboolean
  Die Transaktion stammt von einem Bankkonto.
- currencystring
  Währung der Transaktion, zum Beispiel EUR.
- payment_typePaymentType
  Zahlungsart der Transaktion.
- invoicesarray<Invoice31>
- brutto_valuenumber (float)
  Bruttobetrag der Transaktion.
- is_feeboolean
  Die Transaktion ist eine Gebühr, zum Beispiel eine Bankgebühr.
- due_datestring (date-time)
  Dies wird für negative Transaktionen verwendet, um sie von möglichen Zahlungserinnerungen auszuschließen, bis sie fällig sind.
- cash_discountboolean
  Skonto: dieser Teil der Forderung erlischt durch Abzug, nicht durch Zahlung. Kein Geldeingang - Ist-Versteuerung und Mindest-Ist zählen ihn nicht; bei Sollversteuerung mindert er die Bemessungsgrundlage im Zeitraum des Abzugs (§ 17 Abs. 1 UStG).
- deletedboolean
  Diese Eigenschaft markiert eine Entität als gelöscht / archiviert
- namestring
  Name der Einheit.
- createdstring (date-time)
  Zeitpunkt, zu dem der Datensatz angelegt wurde.
- updatedstring (date-time)
  Zeitpunkt, zu dem der Datensatz zuletzt aktualisiert wurde.
incoming_invoice_transactionsarray<IncomingInvoiceTransaction2>
Spezialisierte Zahlungen, die nur dieser Eingangsrechnung zugeordnet sind.
Felder anzeigen (5)
- amountnumber (float)
  Positiver Betrag dieser konkreten Zahlung.
- payment_datestring (date-time)
  Datum der Zahlung.
- currencystring
  Währung der Zahlung.
- createdstring (date-time)
  Zeitpunkt, zu dem der Datensatz angelegt wurde.
- updatedstring (date-time)
  Zeitpunkt, zu dem der Datensatz zuletzt aktualisiert wurde.
document_pathstring
Pfad zur gespeicherten Rechnungsdatei (PDF/Bild)
document_filenamestring
Original Dateiname
document_mime_typestring
MIME-Typ des Dokuments
notesstring
Notizen/Bemerkungen
is_deductibleboolean
Ist die Rechnung für den Vorsteuerabzug relevant?
is_approvedboolean
Wurde die Rechnung geprüft/freigegeben?
approved_atstring (date-time)
Zeitpunkt, zu dem die Eingangsrechnung genehmigt wurde.

Anfrage

curl --request POST \
  --url https://eure-instanz.iw-erp.de/api/invoice/incoming_invoice/42/approve \
  --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/incoming_invoice/42/approve', 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/incoming_invoice/42/approve"

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/incoming_invoice/42/approve', [
  '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/incoming_invoice/42/approve"),
  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/incoming_invoice/42/approve")
  .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/incoming_invoice/42/approve"

	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/incoming_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 IncomingInvoiceController.approve('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
  },
  "id": 42,
  "currency": "EUR",
  "name": "Beispiel",
  "linked_number_title": "Beispiel",
  "token": "string",
  "number": 1,
  "manual_number_prefix": "string",
  "manual_number": 1,
  "number_string": "string"
}

Das KI-Entscheidungsmodell nach einem Buchungsvorschlag fragen (Ausgabenkategorie, USt-Fall).

POST/api/invoice/incoming_invoice/{identifier}/ai_category

Opt-in (inwendo_invoice_ai_expense_category_enabled). Die Kategorie wird nur vorausgefüllt, wenn die Rechnung keine hat und die Wahrscheinlichkeit den Schwellenwert erreicht; der Fall mit Umsatzsteuer bleibt ein Hinweis. Es wird nichts genehmigt oder gebucht.

Pfad-Parameter

identifierPflichtstring

Antworten

200KI-Buchungsvorschlag für eine EingangsrechnungIncomingInvoice

Felder anzeigen (46)

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.
external_invoice_numberstring
Externe Rechnungsnummer des Lieferanten
received_datestring (date-time)
Eingangsdatum (wann wurde die Rechnung empfangen)
payment_datestring (date-time)
Zahlungsdatum
service_date_startstring (date-time)
Leistungszeitraum Start
service_date_endstring (date-time)
Leistungszeitraum Ende
vat_categorystring
Der umsatzsteuerliche Sachverhalt. Auf der Eingangsseite entscheidet er darüber, ob die Vorsteuer unter Kennzahl 66 steht (Rechnung eines anderen Unternehmers), unter 61 (innergemeinschaftlicher Erwerb), unter 62 (Einfuhrumsatzsteuer) oder unter 67 (§ 13b UStG). Beim Erwerb und bei § 13b kommt eine zweite Zeile hinzu: Die Steuer schulden wir selbst, obwohl sie uns niemand berechnet hat, und sie steht deshalb zugleich als Umsatzsteuer im Vordruck. Wer nur eine der beiden bucht, zahlt zu viel oder zu wenig. Ohne Angabe gilt der Regelfall.
vat_self_assessed_ratenumber (float)
Der Steuersatz, mit dem die selbst geschuldete Steuer zu rechnen ist. Beim innergemeinschaftlichen Erwerb und bei § 13b UStG berechnet der Lieferant keine Steuer – die Rechnung ist netto, und die Steuer schulden wir. Womit sie zu rechnen ist, steht deshalb auf keinem Beleg: es ist der Satz, der im Inland auf diese Leistung anzuwenden wäre. Ohne Angabe rechnet die Voranmeldung mit dem Regelsatz und sagt in den Hinweisen, bei wie vielen Belegen sie das getan hat. Stillschweigend zu raten wäre in einer Steueranmeldung das Falsche.
import_vat_amountstring
Die Einfuhrumsatzsteuer aus dem Zollbescheid. Sie steht NICHT auf der Rechnung des Lieferanten - die ist bei einer Einfuhr ohne deutsche Steuer. Entrichtet wird sie an den Zoll, und nur der entrichtete Betrag ist als Vorsteuer abziehbar (§ 15 Abs. 1 Satz 1 Nr. 2 UStG, Kennzahl 62 der Voranmeldung). Den Steuerbetrag der Lieferantenrechnung dafür zu nehmen war schlicht der falsche Beleg.
paid_valuenumber (float)
Bereits bezahlter Betrag (für Teilzahlungen)
itemsarray<IncomingInvoiceItem>
Rechnungspositionen
Felder anzeigen (16)
- 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.
- expense_categoryExpenseCategory10
  Kostenkategorie für EÜR (kann von der Hauptkategorie der Rechnung abweichen)
- positioninteger
  Position/Reihenfolge
sellerIncomingInvoiceSeller
Verkäufer/Lieferant Informationen (Snapshot)
Felder anzeigen (25)
- 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.
- main_phonestring
  Haupttelefonnummer.
- main_faxstring
  Haupt-Faxnummer.
- main_emailstring
  Haupt-E-Mail-Adresse.
- websitestring
  Website-Adresse.
expense_categoryExpenseCategory10
Hauptkategorie für EÜR
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.
payment_transactionsarray<PaymentTransaction4>
Verknüpfte Zahlungstransaktionen
Felder anzeigen (14)
- autoboolean
  Die Transaktion wurde automatisch erstellt.
- incomingboolean
  Die Transaktion ist ein Zahlungseingang.
- bank_transactionboolean
  Die Transaktion stammt von einem Bankkonto.
- currencystring
  Währung der Transaktion, zum Beispiel EUR.
- payment_typePaymentType
  Zahlungsart der Transaktion.
- invoicesarray<Invoice31>
- brutto_valuenumber (float)
  Bruttobetrag der Transaktion.
- is_feeboolean
  Die Transaktion ist eine Gebühr, zum Beispiel eine Bankgebühr.
- due_datestring (date-time)
  Dies wird für negative Transaktionen verwendet, um sie von möglichen Zahlungserinnerungen auszuschließen, bis sie fällig sind.
- cash_discountboolean
  Skonto: dieser Teil der Forderung erlischt durch Abzug, nicht durch Zahlung. Kein Geldeingang - Ist-Versteuerung und Mindest-Ist zählen ihn nicht; bei Sollversteuerung mindert er die Bemessungsgrundlage im Zeitraum des Abzugs (§ 17 Abs. 1 UStG).
- deletedboolean
  Diese Eigenschaft markiert eine Entität als gelöscht / archiviert
- namestring
  Name der Einheit.
- createdstring (date-time)
  Zeitpunkt, zu dem der Datensatz angelegt wurde.
- updatedstring (date-time)
  Zeitpunkt, zu dem der Datensatz zuletzt aktualisiert wurde.
incoming_invoice_transactionsarray<IncomingInvoiceTransaction2>
Spezialisierte Zahlungen, die nur dieser Eingangsrechnung zugeordnet sind.
Felder anzeigen (5)
- amountnumber (float)
  Positiver Betrag dieser konkreten Zahlung.
- payment_datestring (date-time)
  Datum der Zahlung.
- currencystring
  Währung der Zahlung.
- createdstring (date-time)
  Zeitpunkt, zu dem der Datensatz angelegt wurde.
- updatedstring (date-time)
  Zeitpunkt, zu dem der Datensatz zuletzt aktualisiert wurde.
document_pathstring
Pfad zur gespeicherten Rechnungsdatei (PDF/Bild)
document_filenamestring
Original Dateiname
document_mime_typestring
MIME-Typ des Dokuments
notesstring
Notizen/Bemerkungen
is_deductibleboolean
Ist die Rechnung für den Vorsteuerabzug relevant?
is_approvedboolean
Wurde die Rechnung geprüft/freigegeben?
approved_atstring (date-time)
Zeitpunkt, zu dem die Eingangsrechnung genehmigt wurde.

Anfrage

curl --request POST \
  --url https://eure-instanz.iw-erp.de/api/invoice/incoming_invoice/42/ai_category \
  --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/incoming_invoice/42/ai_category', 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/incoming_invoice/42/ai_category"

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/incoming_invoice/42/ai_category', [
  '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/incoming_invoice/42/ai_category"),
  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/incoming_invoice/42/ai_category")
  .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/incoming_invoice/42/ai_category"

	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/incoming_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 IncomingInvoiceController.aiCategory('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
  },
  "id": 42,
  "currency": "EUR",
  "name": "Beispiel",
  "linked_number_title": "Beispiel",
  "token": "string",
  "number": 1,
  "manual_number_prefix": "string",
  "manual_number": 1,
  "number_string": "string"
}

Eine IncomingInvoice als bezahlt markieren

POST/api/invoice/incoming_invoice/{identifier}/paid

Pfad-Parameter

identifierPflichtstring

Request-Body application/json

dataobject
Felder anzeigen (2)
- paidValuenumber
  Standardmäßig der Rechnungsgesamtbetrag
- paymentDatestring
  Standardmäßig heute

Antworten

200IncomingInvoice als bezahlt markierenIncomingInvoice

Felder anzeigen (46)

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.
external_invoice_numberstring
Externe Rechnungsnummer des Lieferanten
received_datestring (date-time)
Eingangsdatum (wann wurde die Rechnung empfangen)
payment_datestring (date-time)
Zahlungsdatum
service_date_startstring (date-time)
Leistungszeitraum Start
service_date_endstring (date-time)
Leistungszeitraum Ende
vat_categorystring
Der umsatzsteuerliche Sachverhalt. Auf der Eingangsseite entscheidet er darüber, ob die Vorsteuer unter Kennzahl 66 steht (Rechnung eines anderen Unternehmers), unter 61 (innergemeinschaftlicher Erwerb), unter 62 (Einfuhrumsatzsteuer) oder unter 67 (§ 13b UStG). Beim Erwerb und bei § 13b kommt eine zweite Zeile hinzu: Die Steuer schulden wir selbst, obwohl sie uns niemand berechnet hat, und sie steht deshalb zugleich als Umsatzsteuer im Vordruck. Wer nur eine der beiden bucht, zahlt zu viel oder zu wenig. Ohne Angabe gilt der Regelfall.
vat_self_assessed_ratenumber (float)
Der Steuersatz, mit dem die selbst geschuldete Steuer zu rechnen ist. Beim innergemeinschaftlichen Erwerb und bei § 13b UStG berechnet der Lieferant keine Steuer – die Rechnung ist netto, und die Steuer schulden wir. Womit sie zu rechnen ist, steht deshalb auf keinem Beleg: es ist der Satz, der im Inland auf diese Leistung anzuwenden wäre. Ohne Angabe rechnet die Voranmeldung mit dem Regelsatz und sagt in den Hinweisen, bei wie vielen Belegen sie das getan hat. Stillschweigend zu raten wäre in einer Steueranmeldung das Falsche.
import_vat_amountstring
Die Einfuhrumsatzsteuer aus dem Zollbescheid. Sie steht NICHT auf der Rechnung des Lieferanten - die ist bei einer Einfuhr ohne deutsche Steuer. Entrichtet wird sie an den Zoll, und nur der entrichtete Betrag ist als Vorsteuer abziehbar (§ 15 Abs. 1 Satz 1 Nr. 2 UStG, Kennzahl 62 der Voranmeldung). Den Steuerbetrag der Lieferantenrechnung dafür zu nehmen war schlicht der falsche Beleg.
paid_valuenumber (float)
Bereits bezahlter Betrag (für Teilzahlungen)
itemsarray<IncomingInvoiceItem>
Rechnungspositionen
Felder anzeigen (16)
- 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.
- expense_categoryExpenseCategory10
  Kostenkategorie für EÜR (kann von der Hauptkategorie der Rechnung abweichen)
- positioninteger
  Position/Reihenfolge
sellerIncomingInvoiceSeller
Verkäufer/Lieferant Informationen (Snapshot)
Felder anzeigen (25)
- 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.
- main_phonestring
  Haupttelefonnummer.
- main_faxstring
  Haupt-Faxnummer.
- main_emailstring
  Haupt-E-Mail-Adresse.
- websitestring
  Website-Adresse.
expense_categoryExpenseCategory10
Hauptkategorie für EÜR
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.
payment_transactionsarray<PaymentTransaction4>
Verknüpfte Zahlungstransaktionen
Felder anzeigen (14)
- autoboolean
  Die Transaktion wurde automatisch erstellt.
- incomingboolean
  Die Transaktion ist ein Zahlungseingang.
- bank_transactionboolean
  Die Transaktion stammt von einem Bankkonto.
- currencystring
  Währung der Transaktion, zum Beispiel EUR.
- payment_typePaymentType
  Zahlungsart der Transaktion.
- invoicesarray<Invoice31>
- brutto_valuenumber (float)
  Bruttobetrag der Transaktion.
- is_feeboolean
  Die Transaktion ist eine Gebühr, zum Beispiel eine Bankgebühr.
- due_datestring (date-time)
  Dies wird für negative Transaktionen verwendet, um sie von möglichen Zahlungserinnerungen auszuschließen, bis sie fällig sind.
- cash_discountboolean
  Skonto: dieser Teil der Forderung erlischt durch Abzug, nicht durch Zahlung. Kein Geldeingang - Ist-Versteuerung und Mindest-Ist zählen ihn nicht; bei Sollversteuerung mindert er die Bemessungsgrundlage im Zeitraum des Abzugs (§ 17 Abs. 1 UStG).
- deletedboolean
  Diese Eigenschaft markiert eine Entität als gelöscht / archiviert
- namestring
  Name der Einheit.
- createdstring (date-time)
  Zeitpunkt, zu dem der Datensatz angelegt wurde.
- updatedstring (date-time)
  Zeitpunkt, zu dem der Datensatz zuletzt aktualisiert wurde.
incoming_invoice_transactionsarray<IncomingInvoiceTransaction2>
Spezialisierte Zahlungen, die nur dieser Eingangsrechnung zugeordnet sind.
Felder anzeigen (5)
- amountnumber (float)
  Positiver Betrag dieser konkreten Zahlung.
- payment_datestring (date-time)
  Datum der Zahlung.
- currencystring
  Währung der Zahlung.
- createdstring (date-time)
  Zeitpunkt, zu dem der Datensatz angelegt wurde.
- updatedstring (date-time)
  Zeitpunkt, zu dem der Datensatz zuletzt aktualisiert wurde.
document_pathstring
Pfad zur gespeicherten Rechnungsdatei (PDF/Bild)
document_filenamestring
Original Dateiname
document_mime_typestring
MIME-Typ des Dokuments
notesstring
Notizen/Bemerkungen
is_deductibleboolean
Ist die Rechnung für den Vorsteuerabzug relevant?
is_approvedboolean
Wurde die Rechnung geprüft/freigegeben?
approved_atstring (date-time)
Zeitpunkt, zu dem die Eingangsrechnung genehmigt wurde.

Anfrage

curl --request POST \
  --url https://eure-instanz.iw-erp.de/api/invoice/incoming_invoice/42/paid \
  --header 'content-type: application/json' \
  --header 'x-iw-jwt-token: <TOKEN>' \
  --data '
{
  "data": {
    "paidValue": 119,
    "paymentDate": "2026-07-30"
  }
}
'

const options = {
  method: 'POST',
  headers: {'x-iw-jwt-token': '<TOKEN>', 'content-type': 'application/json'},
  body: JSON.stringify({data: {paidValue: 119, paymentDate: '2026-07-30'}})
};

fetch('https://eure-instanz.iw-erp.de/api/invoice/incoming_invoice/42/paid', 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/incoming_invoice/42/paid"

payload = { "data": {
    "paidValue": 119,
    "paymentDate": "2026-07-30"
  } }
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/incoming_invoice/42/paid', [
  'body' => '{"data":{"paidValue":119,"paymentDate":"2026-07-30"}}',
  '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/incoming_invoice/42/paid"),
  Headers =
  {
    { "x-iw-jwt-token", "<TOKEN>" },
  },
  Content = new StringContent("{\"data\":{\"paidValue\":119,\"paymentDate\":\"2026-07-30\"}}")
  {
    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\":{\"paidValue\":119,\"paymentDate\":\"2026-07-30\"}}");
Request request = new Request.Builder()
  .url("https://eure-instanz.iw-erp.de/api/invoice/incoming_invoice/42/paid")
  .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/incoming_invoice/42/paid"

	payload := strings.NewReader("{\"data\":{\"paidValue\":119,\"paymentDate\":\"2026-07-30\"}}")

	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/incoming_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 IncomingInvoiceController.markAsPaid('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
  },
  "id": 42,
  "currency": "EUR",
  "name": "Beispiel",
  "linked_number_title": "Beispiel",
  "token": "string",
  "number": 1,
  "manual_number_prefix": "string",
  "manual_number": 1,
  "number_string": "string"
}

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

POST/api/invoice/incoming_invoice/{identifier}/buchhaltungsbutler_push

Pfad-Parameter

identifierPflichtstring

Antworten

200Eine IncomingInvoice an BuchhaltungsButler übertragenIncomingInvoice

Felder anzeigen (46)

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.
external_invoice_numberstring
Externe Rechnungsnummer des Lieferanten
received_datestring (date-time)
Eingangsdatum (wann wurde die Rechnung empfangen)
payment_datestring (date-time)
Zahlungsdatum
service_date_startstring (date-time)
Leistungszeitraum Start
service_date_endstring (date-time)
Leistungszeitraum Ende
vat_categorystring
Der umsatzsteuerliche Sachverhalt. Auf der Eingangsseite entscheidet er darüber, ob die Vorsteuer unter Kennzahl 66 steht (Rechnung eines anderen Unternehmers), unter 61 (innergemeinschaftlicher Erwerb), unter 62 (Einfuhrumsatzsteuer) oder unter 67 (§ 13b UStG). Beim Erwerb und bei § 13b kommt eine zweite Zeile hinzu: Die Steuer schulden wir selbst, obwohl sie uns niemand berechnet hat, und sie steht deshalb zugleich als Umsatzsteuer im Vordruck. Wer nur eine der beiden bucht, zahlt zu viel oder zu wenig. Ohne Angabe gilt der Regelfall.
vat_self_assessed_ratenumber (float)
Der Steuersatz, mit dem die selbst geschuldete Steuer zu rechnen ist. Beim innergemeinschaftlichen Erwerb und bei § 13b UStG berechnet der Lieferant keine Steuer – die Rechnung ist netto, und die Steuer schulden wir. Womit sie zu rechnen ist, steht deshalb auf keinem Beleg: es ist der Satz, der im Inland auf diese Leistung anzuwenden wäre. Ohne Angabe rechnet die Voranmeldung mit dem Regelsatz und sagt in den Hinweisen, bei wie vielen Belegen sie das getan hat. Stillschweigend zu raten wäre in einer Steueranmeldung das Falsche.
import_vat_amountstring
Die Einfuhrumsatzsteuer aus dem Zollbescheid. Sie steht NICHT auf der Rechnung des Lieferanten - die ist bei einer Einfuhr ohne deutsche Steuer. Entrichtet wird sie an den Zoll, und nur der entrichtete Betrag ist als Vorsteuer abziehbar (§ 15 Abs. 1 Satz 1 Nr. 2 UStG, Kennzahl 62 der Voranmeldung). Den Steuerbetrag der Lieferantenrechnung dafür zu nehmen war schlicht der falsche Beleg.
paid_valuenumber (float)
Bereits bezahlter Betrag (für Teilzahlungen)
itemsarray<IncomingInvoiceItem>
Rechnungspositionen
Felder anzeigen (16)
- 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.
- expense_categoryExpenseCategory10
  Kostenkategorie für EÜR (kann von der Hauptkategorie der Rechnung abweichen)
- positioninteger
  Position/Reihenfolge
sellerIncomingInvoiceSeller
Verkäufer/Lieferant Informationen (Snapshot)
Felder anzeigen (25)
- 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.
- main_phonestring
  Haupttelefonnummer.
- main_faxstring
  Haupt-Faxnummer.
- main_emailstring
  Haupt-E-Mail-Adresse.
- websitestring
  Website-Adresse.
expense_categoryExpenseCategory10
Hauptkategorie für EÜR
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.
payment_transactionsarray<PaymentTransaction4>
Verknüpfte Zahlungstransaktionen
Felder anzeigen (14)
- autoboolean
  Die Transaktion wurde automatisch erstellt.
- incomingboolean
  Die Transaktion ist ein Zahlungseingang.
- bank_transactionboolean
  Die Transaktion stammt von einem Bankkonto.
- currencystring
  Währung der Transaktion, zum Beispiel EUR.
- payment_typePaymentType
  Zahlungsart der Transaktion.
- invoicesarray<Invoice31>
- brutto_valuenumber (float)
  Bruttobetrag der Transaktion.
- is_feeboolean
  Die Transaktion ist eine Gebühr, zum Beispiel eine Bankgebühr.
- due_datestring (date-time)
  Dies wird für negative Transaktionen verwendet, um sie von möglichen Zahlungserinnerungen auszuschließen, bis sie fällig sind.
- cash_discountboolean
  Skonto: dieser Teil der Forderung erlischt durch Abzug, nicht durch Zahlung. Kein Geldeingang - Ist-Versteuerung und Mindest-Ist zählen ihn nicht; bei Sollversteuerung mindert er die Bemessungsgrundlage im Zeitraum des Abzugs (§ 17 Abs. 1 UStG).
- deletedboolean
  Diese Eigenschaft markiert eine Entität als gelöscht / archiviert
- namestring
  Name der Einheit.
- createdstring (date-time)
  Zeitpunkt, zu dem der Datensatz angelegt wurde.
- updatedstring (date-time)
  Zeitpunkt, zu dem der Datensatz zuletzt aktualisiert wurde.
incoming_invoice_transactionsarray<IncomingInvoiceTransaction2>
Spezialisierte Zahlungen, die nur dieser Eingangsrechnung zugeordnet sind.
Felder anzeigen (5)
- amountnumber (float)
  Positiver Betrag dieser konkreten Zahlung.
- payment_datestring (date-time)
  Datum der Zahlung.
- currencystring
  Währung der Zahlung.
- createdstring (date-time)
  Zeitpunkt, zu dem der Datensatz angelegt wurde.
- updatedstring (date-time)
  Zeitpunkt, zu dem der Datensatz zuletzt aktualisiert wurde.
document_pathstring
Pfad zur gespeicherten Rechnungsdatei (PDF/Bild)
document_filenamestring
Original Dateiname
document_mime_typestring
MIME-Typ des Dokuments
notesstring
Notizen/Bemerkungen
is_deductibleboolean
Ist die Rechnung für den Vorsteuerabzug relevant?
is_approvedboolean
Wurde die Rechnung geprüft/freigegeben?
approved_atstring (date-time)
Zeitpunkt, zu dem die Eingangsrechnung genehmigt wurde.

Anfrage

curl --request POST \
  --url https://eure-instanz.iw-erp.de/api/invoice/incoming_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/incoming_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/incoming_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/incoming_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/incoming_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/incoming_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/incoming_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/incoming_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
  },
  "id": 42,
  "currency": "EUR",
  "name": "Beispiel",
  "linked_number_title": "Beispiel",
  "token": "string",
  "number": 1,
  "manual_number_prefix": "string",
  "manual_number": 1,
  "number_string": "string"
}

Das Dokument einer IncomingInvoice herunterladen

GET/api/invoice/incoming_invoice/{identifier}/document

Pfad-Parameter

identifierPflichtstring

Antworten

200Liefert die Dokumentdatei

Anfrage

curl --request GET \
  --url https://eure-instanz.iw-erp.de/api/invoice/incoming_invoice/42/document \
  --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/incoming_invoice/42/document', 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/incoming_invoice/42/document"

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/incoming_invoice/42/document', [
  '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/incoming_invoice/42/document"),
  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/incoming_invoice/42/document")
  .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/incoming_invoice/42/document"

	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/incoming_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 IncomingInvoiceController.getDocumentDownloadLink('42');
print(result);