IncomingInvoiceTransaction

Accounting4 EndpointsBilling / IncomingInvoiceTransaction

Returns a list of all IncomingInvoiceTransaction entries.

GET/api/invoice/incoming_invoice_transaction

Query parameters

`id`string
`incomingInvoice`string
`amount`number	Positiver Betrag dieser konkreten Zahlung.
`paymentDate`string
`currency`string
`buchhaltungsButlerTransactionId`string
`created`string
`updated`string
`searchString`string	text to search for in the list
`orderFieldName`string	name of the order field
`orderFieldSort`string	sorting modeAllowed: `DESCASC`
`page`integer	page of the list
`pageSize`integer	number of entries for each page
`withMaxPageNumber`string	returns the number of pages available as a header if this is set

Responses

200Returns a list of all IncomingInvoiceTransaction entriesarray<IncomingInvoiceTransaction>

Show fields (7)

incoming_invoiceIncomingInvoice3
Incoming invoice that was paid.
Show fields (43)
- idinteger
  Primary key of the invoice document. Internal ID.
- tokenstring
  Token that identifies the document for public access.
- numberinteger
  Running document number.
- manual_number_prefixstring
  Prefix of a manually entered document number.
- manual_numberinteger
  Manually entered document number.
- number_stringstring
  Document number as displayed to users.
- generation_datestring (date-time)
  Date the document was generated.
- number_datestring (date-time)
  Date used for the document number.
- messagestring
  Message printed on the document.
- currencystring
  Currency of the document.
- namestring
  Name of the document.
- due_datestring (date-time)
  Due date of the document.
- netto_valuenumber (float)
  Net total of the document.
- brutto_valuenumber (float)
  Gross total of the document.
- tax_valuenumber (float)
  Total tax amount of the document.
- taxTaxrequired
  Tax rate applied to the document.
- linked_number_titlestring
  Title of the linked document number.
- linked_numberstring
  Number of the linked document.
- statusstring
  Status of the document.
- previous_statusstring
  Status before the last change.
- status_updatedstring (date-time)
  Point in time the status was last changed.
- archivedboolean
  Whether the document is archived.
- last_pdf_exportstring (date-time)
  Point in time the PDF was last exported.
- last_status_exportstring
  Status at the last export.
- search_stringstring
  Text that the entity can be searched by.
- 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 der Regelfall.
- vat_self_assessed_ratenumber (float)
  Der Steuersatz, mit dem die selbst geschuldete Steuer zu rechnen ist. Beim innergemeinschaftlichen Erwerb und bei § 13b UStG berechnet der Lieferant keine Steuer - die Rechnung ist netto, und die Steuer schulden wir. Womit sie zu rechnen ist, steht deshalb auf keinem Beleg: es ist der Satz, der im Inland auf diese Leistung anzuwenden wäre. Ohne Angabe rechnet die Voranmeldung mit dem Regelsatz und sagt in den Hinweisen, bei wie vielen Belegen sie das getan hat. Stillschweigend zu raten wäre in einer Steueranmeldung das Falsche.
- import_vat_amountstring
  Die Einfuhrumsatzsteuer aus dem Zollbescheid. Sie steht NICHT auf der Rechnung des Lieferanten - die ist bei einer Einfuhr ohne deutsche Steuer. Entrichtet wird sie an den Zoll, und nur der entrichtete Betrag ist als Vorsteuer abziehbar (§ 15 Abs. 1 Satz 1 Nr. 2 UStG, Kennzahl 62 der Voranmeldung). Den Steuerbetrag der Lieferantenrechnung dafür zu nehmen war schlicht der falsche Beleg.
- paid_valuenumber (float)
  Bereits bezahlter Betrag (für Teilzahlungen)
- sellerIncomingInvoiceSeller
  Verkäufer/Lieferant Informationen (Snapshot)
- expense_categoryExpenseCategory10
  Hauptkategorie für EÜR
- document_pathstring
  Pfad zur gespeicherten Rechnungsdatei (PDF/Bild)
- document_filenamestring
  Original Dateiname
- document_mime_typestring
  MIME Type 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)
  Time the incoming invoice was approved.
amountnumber (float)
Positiver Betrag dieser konkreten Zahlung.
payment_datestring (date-time)
Date of the payment.
currencystring
Currency of the payment.
buchhaltungs_butler_transaction_idstring
ID of the transaction in the external accounting tool.
createdstring (date-time)
Point in time the entity was created.
updatedstring (date-time)
Point in time the entity was last updated.

Request

curl --request GET \
  --url https://your-instance.iw-erp.de/api/invoice/incoming_invoice_transaction \
  --header 'x-iw-jwt-token: <TOKEN>'

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

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

import requests

url = "https://your-instance.iw-erp.de/api/invoice/incoming_invoice_transaction"

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://your-instance.iw-erp.de/api/invoice/incoming_invoice_transaction', [
  '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://your-instance.iw-erp.de/api/invoice/incoming_invoice_transaction"),
  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://your-instance.iw-erp.de/api/invoice/incoming_invoice_transaction")
  .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://your-instance.iw-erp.de/api/invoice/incoming_invoice_transaction"

	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 with package:http (no controller in the iw_erp_api package)

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

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

Response 200 application/json

[
  {
    "currency": "EUR",
    "incoming_invoice": {
      "id": 42,
      "currency": "EUR",
      "name": "Beispiel",
      "linked_number_title": "Beispiel",
      "token": "string",
      "number": 1,
      "manual_number_prefix": "string",
      "manual_number": 1,
      "number_string": "string",
      "generation_date": "2026-10-15T09:30:00+02:00"
    },
    "amount": 49.9,
    "payment_date": "2026-10-15T09:30:00+02:00",
    "buchhaltungs_butler_transaction_id": "42",
    "created": "2026-10-15T09:30:00+02:00",
    "updated": "2026-10-15T09:30:00+02:00"
  }
]

Add an IncomingInvoiceTransaction.

POST/api/invoice/incoming_invoice_transaction

Request body application/json

dataIncomingInvoiceTransaction
Show fields (7)
- incoming_invoiceIncomingInvoice3
  Incoming invoice that was paid.
- amountnumber (float)
  Positiver Betrag dieser konkreten Zahlung.
- payment_datestring (date-time)
  Date of the payment.
- currencystring
  Currency of the payment.
- buchhaltungs_butler_transaction_idstring
  ID of the transaction in the external accounting tool.
- createdstring (date-time)
  Point in time the entity was created.
- updatedstring (date-time)
  Point in time the entity was last updated.

Responses

200Add an IncomingInvoiceTransactionIncomingInvoiceTransaction

Show fields (7)

incoming_invoiceIncomingInvoice3
Incoming invoice that was paid.
Show fields (43)
- idinteger
  Primary key of the invoice document. Internal ID.
- tokenstring
  Token that identifies the document for public access.
- numberinteger
  Running document number.
- manual_number_prefixstring
  Prefix of a manually entered document number.
- manual_numberinteger
  Manually entered document number.
- number_stringstring
  Document number as displayed to users.
- generation_datestring (date-time)
  Date the document was generated.
- number_datestring (date-time)
  Date used for the document number.
- messagestring
  Message printed on the document.
- currencystring
  Currency of the document.
- namestring
  Name of the document.
- due_datestring (date-time)
  Due date of the document.
- netto_valuenumber (float)
  Net total of the document.
- brutto_valuenumber (float)
  Gross total of the document.
- tax_valuenumber (float)
  Total tax amount of the document.
- taxTaxrequired
  Tax rate applied to the document.
- linked_number_titlestring
  Title of the linked document number.
- linked_numberstring
  Number of the linked document.
- statusstring
  Status of the document.
- previous_statusstring
  Status before the last change.
- status_updatedstring (date-time)
  Point in time the status was last changed.
- archivedboolean
  Whether the document is archived.
- last_pdf_exportstring (date-time)
  Point in time the PDF was last exported.
- last_status_exportstring
  Status at the last export.
- search_stringstring
  Text that the entity can be searched by.
- 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 der Regelfall.
- vat_self_assessed_ratenumber (float)
  Der Steuersatz, mit dem die selbst geschuldete Steuer zu rechnen ist. Beim innergemeinschaftlichen Erwerb und bei § 13b UStG berechnet der Lieferant keine Steuer - die Rechnung ist netto, und die Steuer schulden wir. Womit sie zu rechnen ist, steht deshalb auf keinem Beleg: es ist der Satz, der im Inland auf diese Leistung anzuwenden wäre. Ohne Angabe rechnet die Voranmeldung mit dem Regelsatz und sagt in den Hinweisen, bei wie vielen Belegen sie das getan hat. Stillschweigend zu raten wäre in einer Steueranmeldung das Falsche.
- import_vat_amountstring
  Die Einfuhrumsatzsteuer aus dem Zollbescheid. Sie steht NICHT auf der Rechnung des Lieferanten - die ist bei einer Einfuhr ohne deutsche Steuer. Entrichtet wird sie an den Zoll, und nur der entrichtete Betrag ist als Vorsteuer abziehbar (§ 15 Abs. 1 Satz 1 Nr. 2 UStG, Kennzahl 62 der Voranmeldung). Den Steuerbetrag der Lieferantenrechnung dafür zu nehmen war schlicht der falsche Beleg.
- paid_valuenumber (float)
  Bereits bezahlter Betrag (für Teilzahlungen)
- sellerIncomingInvoiceSeller
  Verkäufer/Lieferant Informationen (Snapshot)
- expense_categoryExpenseCategory10
  Hauptkategorie für EÜR
- document_pathstring
  Pfad zur gespeicherten Rechnungsdatei (PDF/Bild)
- document_filenamestring
  Original Dateiname
- document_mime_typestring
  MIME Type 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)
  Time the incoming invoice was approved.
amountnumber (float)
Positiver Betrag dieser konkreten Zahlung.
payment_datestring (date-time)
Date of the payment.
currencystring
Currency of the payment.
buchhaltungs_butler_transaction_idstring
ID of the transaction in the external accounting tool.
createdstring (date-time)
Point in time the entity was created.
updatedstring (date-time)
Point in time the entity was last updated.

Request

curl --request POST \
  --url https://your-instance.iw-erp.de/api/invoice/incoming_invoice_transaction \
  --header 'content-type: application/json' \
  --header 'x-iw-jwt-token: <TOKEN>' \
  --data '
{
  "data": {
    "currency": "EUR",
    "incoming_invoice": {
      "id": 42,
      "currency": "EUR",
      "name": "Beispiel",
      "linked_number_title": "Beispiel",
      "token": "string",
      "number": 1
    },
    "amount": 49.9,
    "payment_date": "2026-10-15T09:30:00+02:00",
    "buchhaltungs_butler_transaction_id": "42",
    "created": "2026-10-15T09:30:00+02:00"
  }
}
'

const options = {
  method: 'POST',
  headers: {'x-iw-jwt-token': '<TOKEN>', 'content-type': 'application/json'},
  body: JSON.stringify({
    data: {
      currency: 'EUR',
      incoming_invoice: {
        id: 42,
        currency: 'EUR',
        name: 'Beispiel',
        linked_number_title: 'Beispiel',
        token: 'string',
        number: 1
      },
      amount: 49.9,
      payment_date: '2026-10-15T09:30:00+02:00',
      buchhaltungs_butler_transaction_id: '42',
      created: '2026-10-15T09:30:00+02:00'
    }
  })
};

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

import requests

url = "https://your-instance.iw-erp.de/api/invoice/incoming_invoice_transaction"

payload = { "data": {
    "currency": "EUR",
    "incoming_invoice": {
      "id": 42,
      "currency": "EUR",
      "name": "Beispiel",
      "linked_number_title": "Beispiel",
      "token": "string",
      "number": 1
    },
    "amount": 49.9,
    "payment_date": "2026-10-15T09:30:00+02:00",
    "buchhaltungs_butler_transaction_id": "42",
    "created": "2026-10-15T09:30:00+02:00"
  } }
headers = {
  "x-iw-jwt-token": "<TOKEN>",
  "content-type": "application/json"
}

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

print(response.text)

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

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://your-instance.iw-erp.de/api/invoice/incoming_invoice_transaction', [
  'body' => '{"data":{"currency":"EUR","incoming_invoice":{"id":42,"currency":"EUR","name":"Beispiel","linked_number_title":"Beispiel","token":"string","number":1},"amount":49.9,"payment_date":"2026-10-15T09:30:00+02:00","buchhaltungs_butler_transaction_id":"42","created":"2026-10-15T09:30:00+02:00"}}',
  'headers' => [
    'content-type' => 'application/json',
    'x-iw-jwt-token' => '<TOKEN>',
  ],
]);

echo $response->getBody();

using System.Net.Http.Headers;
var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Post,
  RequestUri = new Uri("https://your-instance.iw-erp.de/api/invoice/incoming_invoice_transaction"),
  Headers =
  {
    { "x-iw-jwt-token", "<TOKEN>" },
  },
  Content = new StringContent("{\"data\":{\"currency\":\"EUR\",\"incoming_invoice\":{\"id\":42,\"currency\":\"EUR\",\"name\":\"Beispiel\",\"linked_number_title\":\"Beispiel\",\"token\":\"string\",\"number\":1},\"amount\":49.9,\"payment_date\":\"2026-10-15T09:30:00+02:00\",\"buchhaltungs_butler_transaction_id\":\"42\",\"created\":\"2026-10-15T09:30:00+02:00\"}}")
  {
    Headers =
    {
      ContentType = new MediaTypeHeaderValue("application/json")
    }
  }
};
using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}

OkHttpClient client = new OkHttpClient();

MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\"data\":{\"currency\":\"EUR\",\"incoming_invoice\":{\"id\":42,\"currency\":\"EUR\",\"name\":\"Beispiel\",\"linked_number_title\":\"Beispiel\",\"token\":\"string\",\"number\":1},\"amount\":49.9,\"payment_date\":\"2026-10-15T09:30:00+02:00\",\"buchhaltungs_butler_transaction_id\":\"42\",\"created\":\"2026-10-15T09:30:00+02:00\"}}");
Request request = new Request.Builder()
  .url("https://your-instance.iw-erp.de/api/invoice/incoming_invoice_transaction")
  .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://your-instance.iw-erp.de/api/invoice/incoming_invoice_transaction"

	payload := strings.NewReader("{\"data\":{\"currency\":\"EUR\",\"incoming_invoice\":{\"id\":42,\"currency\":\"EUR\",\"name\":\"Beispiel\",\"linked_number_title\":\"Beispiel\",\"token\":\"string\",\"number\":1},\"amount\":49.9,\"payment_date\":\"2026-10-15T09:30:00+02:00\",\"buchhaltungs_butler_transaction_id\":\"42\",\"created\":\"2026-10-15T09:30:00+02:00\"}}")

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

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

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

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

	fmt.Println(string(body))

}

Dart with package:http (no controller in the iw_erp_api package)

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

final response = await http.post(
  Uri.parse('https://your-instance.iw-erp.de/api/invoice/incoming_invoice_transaction'),
  headers: {'x-iw-jwt-token': '<TOKEN>', 'content-type': 'application/json'},
  body: jsonEncode({
    "data": {
      "currency": "EUR",
      "incoming_invoice": {
        "id": 42,
        "currency": "EUR",
        "name": "Beispiel",
        "linked_number_title": "Beispiel",
        "token": "string",
        "number": 1
      },
      "amount": 49.9,
      "payment_date": "2026-10-15T09:30:00+02:00",
      "buchhaltungs_butler_transaction_id": "42",
      "created": "2026-10-15T09:30:00+02:00"
    }
  }),
);
print(response.body);

Response 200 application/json

{
  "currency": "EUR",
  "incoming_invoice": {
    "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"
  },
  "amount": 49.9,
  "payment_date": "2026-10-15T09:30:00+02:00",
  "buchhaltungs_butler_transaction_id": "42",
  "created": "2026-10-15T09:30:00+02:00",
  "updated": "2026-10-15T09:30:00+02:00"
}

Get a single IncomingInvoiceTransaction.

GET/api/invoice/incoming_invoice_transaction/{identifier}

Path parameters

identifierrequiredstring

Responses

200Get a single IncomingInvoiceTransactionIncomingInvoiceTransaction

Show fields (7)

incoming_invoiceIncomingInvoice3
Incoming invoice that was paid.
Show fields (43)
- idinteger
  Primary key of the invoice document. Internal ID.
- tokenstring
  Token that identifies the document for public access.
- numberinteger
  Running document number.
- manual_number_prefixstring
  Prefix of a manually entered document number.
- manual_numberinteger
  Manually entered document number.
- number_stringstring
  Document number as displayed to users.
- generation_datestring (date-time)
  Date the document was generated.
- number_datestring (date-time)
  Date used for the document number.
- messagestring
  Message printed on the document.
- currencystring
  Currency of the document.
- namestring
  Name of the document.
- due_datestring (date-time)
  Due date of the document.
- netto_valuenumber (float)
  Net total of the document.
- brutto_valuenumber (float)
  Gross total of the document.
- tax_valuenumber (float)
  Total tax amount of the document.
- taxTaxrequired
  Tax rate applied to the document.
- linked_number_titlestring
  Title of the linked document number.
- linked_numberstring
  Number of the linked document.
- statusstring
  Status of the document.
- previous_statusstring
  Status before the last change.
- status_updatedstring (date-time)
  Point in time the status was last changed.
- archivedboolean
  Whether the document is archived.
- last_pdf_exportstring (date-time)
  Point in time the PDF was last exported.
- last_status_exportstring
  Status at the last export.
- search_stringstring
  Text that the entity can be searched by.
- 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 der Regelfall.
- vat_self_assessed_ratenumber (float)
  Der Steuersatz, mit dem die selbst geschuldete Steuer zu rechnen ist. Beim innergemeinschaftlichen Erwerb und bei § 13b UStG berechnet der Lieferant keine Steuer - die Rechnung ist netto, und die Steuer schulden wir. Womit sie zu rechnen ist, steht deshalb auf keinem Beleg: es ist der Satz, der im Inland auf diese Leistung anzuwenden wäre. Ohne Angabe rechnet die Voranmeldung mit dem Regelsatz und sagt in den Hinweisen, bei wie vielen Belegen sie das getan hat. Stillschweigend zu raten wäre in einer Steueranmeldung das Falsche.
- import_vat_amountstring
  Die Einfuhrumsatzsteuer aus dem Zollbescheid. Sie steht NICHT auf der Rechnung des Lieferanten - die ist bei einer Einfuhr ohne deutsche Steuer. Entrichtet wird sie an den Zoll, und nur der entrichtete Betrag ist als Vorsteuer abziehbar (§ 15 Abs. 1 Satz 1 Nr. 2 UStG, Kennzahl 62 der Voranmeldung). Den Steuerbetrag der Lieferantenrechnung dafür zu nehmen war schlicht der falsche Beleg.
- paid_valuenumber (float)
  Bereits bezahlter Betrag (für Teilzahlungen)
- sellerIncomingInvoiceSeller
  Verkäufer/Lieferant Informationen (Snapshot)
- expense_categoryExpenseCategory10
  Hauptkategorie für EÜR
- document_pathstring
  Pfad zur gespeicherten Rechnungsdatei (PDF/Bild)
- document_filenamestring
  Original Dateiname
- document_mime_typestring
  MIME Type 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)
  Time the incoming invoice was approved.
amountnumber (float)
Positiver Betrag dieser konkreten Zahlung.
payment_datestring (date-time)
Date of the payment.
currencystring
Currency of the payment.
buchhaltungs_butler_transaction_idstring
ID of the transaction in the external accounting tool.
createdstring (date-time)
Point in time the entity was created.
updatedstring (date-time)
Point in time the entity was last updated.

Request

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

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

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

import requests

url = "https://your-instance.iw-erp.de/api/invoice/incoming_invoice_transaction/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://your-instance.iw-erp.de/api/invoice/incoming_invoice_transaction/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://your-instance.iw-erp.de/api/invoice/incoming_invoice_transaction/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://your-instance.iw-erp.de/api/invoice/incoming_invoice_transaction/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://your-instance.iw-erp.de/api/invoice/incoming_invoice_transaction/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 with package:http (no controller in the iw_erp_api package)

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

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

Response 200 application/json

{
  "currency": "EUR",
  "incoming_invoice": {
    "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"
  },
  "amount": 49.9,
  "payment_date": "2026-10-15T09:30:00+02:00",
  "buchhaltungs_butler_transaction_id": "42",
  "created": "2026-10-15T09:30:00+02:00",
  "updated": "2026-10-15T09:30:00+02:00"
}

Update an IncomingInvoiceTransaction.

PUT/api/invoice/incoming_invoice_transaction/{identifier}

Path parameters

identifierrequiredstring

Request body application/json

dataIncomingInvoiceTransaction
Show fields (7)
- incoming_invoiceIncomingInvoice3
  Incoming invoice that was paid.
- amountnumber (float)
  Positiver Betrag dieser konkreten Zahlung.
- payment_datestring (date-time)
  Date of the payment.
- currencystring
  Currency of the payment.
- buchhaltungs_butler_transaction_idstring
  ID of the transaction in the external accounting tool.
- createdstring (date-time)
  Point in time the entity was created.
- updatedstring (date-time)
  Point in time the entity was last updated.

Responses

200Update an IncomingInvoiceTransactionIncomingInvoiceTransaction

Show fields (7)

incoming_invoiceIncomingInvoice3
Incoming invoice that was paid.
Show fields (43)
- idinteger
  Primary key of the invoice document. Internal ID.
- tokenstring
  Token that identifies the document for public access.
- numberinteger
  Running document number.
- manual_number_prefixstring
  Prefix of a manually entered document number.
- manual_numberinteger
  Manually entered document number.
- number_stringstring
  Document number as displayed to users.
- generation_datestring (date-time)
  Date the document was generated.
- number_datestring (date-time)
  Date used for the document number.
- messagestring
  Message printed on the document.
- currencystring
  Currency of the document.
- namestring
  Name of the document.
- due_datestring (date-time)
  Due date of the document.
- netto_valuenumber (float)
  Net total of the document.
- brutto_valuenumber (float)
  Gross total of the document.
- tax_valuenumber (float)
  Total tax amount of the document.
- taxTaxrequired
  Tax rate applied to the document.
- linked_number_titlestring
  Title of the linked document number.
- linked_numberstring
  Number of the linked document.
- statusstring
  Status of the document.
- previous_statusstring
  Status before the last change.
- status_updatedstring (date-time)
  Point in time the status was last changed.
- archivedboolean
  Whether the document is archived.
- last_pdf_exportstring (date-time)
  Point in time the PDF was last exported.
- last_status_exportstring
  Status at the last export.
- search_stringstring
  Text that the entity can be searched by.
- 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 der Regelfall.
- vat_self_assessed_ratenumber (float)
  Der Steuersatz, mit dem die selbst geschuldete Steuer zu rechnen ist. Beim innergemeinschaftlichen Erwerb und bei § 13b UStG berechnet der Lieferant keine Steuer - die Rechnung ist netto, und die Steuer schulden wir. Womit sie zu rechnen ist, steht deshalb auf keinem Beleg: es ist der Satz, der im Inland auf diese Leistung anzuwenden wäre. Ohne Angabe rechnet die Voranmeldung mit dem Regelsatz und sagt in den Hinweisen, bei wie vielen Belegen sie das getan hat. Stillschweigend zu raten wäre in einer Steueranmeldung das Falsche.
- import_vat_amountstring
  Die Einfuhrumsatzsteuer aus dem Zollbescheid. Sie steht NICHT auf der Rechnung des Lieferanten - die ist bei einer Einfuhr ohne deutsche Steuer. Entrichtet wird sie an den Zoll, und nur der entrichtete Betrag ist als Vorsteuer abziehbar (§ 15 Abs. 1 Satz 1 Nr. 2 UStG, Kennzahl 62 der Voranmeldung). Den Steuerbetrag der Lieferantenrechnung dafür zu nehmen war schlicht der falsche Beleg.
- paid_valuenumber (float)
  Bereits bezahlter Betrag (für Teilzahlungen)
- sellerIncomingInvoiceSeller
  Verkäufer/Lieferant Informationen (Snapshot)
- expense_categoryExpenseCategory10
  Hauptkategorie für EÜR
- document_pathstring
  Pfad zur gespeicherten Rechnungsdatei (PDF/Bild)
- document_filenamestring
  Original Dateiname
- document_mime_typestring
  MIME Type 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)
  Time the incoming invoice was approved.
amountnumber (float)
Positiver Betrag dieser konkreten Zahlung.
payment_datestring (date-time)
Date of the payment.
currencystring
Currency of the payment.
buchhaltungs_butler_transaction_idstring
ID of the transaction in the external accounting tool.
createdstring (date-time)
Point in time the entity was created.
updatedstring (date-time)
Point in time the entity was last updated.

Request

curl --request PUT \
  --url https://your-instance.iw-erp.de/api/invoice/incoming_invoice_transaction/42 \
  --header 'content-type: application/json' \
  --header 'x-iw-jwt-token: <TOKEN>' \
  --data '
{
  "data": {
    "currency": "EUR",
    "incoming_invoice": {
      "id": 42,
      "currency": "EUR",
      "name": "Beispiel",
      "linked_number_title": "Beispiel",
      "token": "string",
      "number": 1
    },
    "amount": 49.9,
    "payment_date": "2026-10-15T09:30:00+02:00",
    "buchhaltungs_butler_transaction_id": "42",
    "created": "2026-10-15T09:30:00+02:00"
  }
}
'

const options = {
  method: 'PUT',
  headers: {'x-iw-jwt-token': '<TOKEN>', 'content-type': 'application/json'},
  body: JSON.stringify({
    data: {
      currency: 'EUR',
      incoming_invoice: {
        id: 42,
        currency: 'EUR',
        name: 'Beispiel',
        linked_number_title: 'Beispiel',
        token: 'string',
        number: 1
      },
      amount: 49.9,
      payment_date: '2026-10-15T09:30:00+02:00',
      buchhaltungs_butler_transaction_id: '42',
      created: '2026-10-15T09:30:00+02:00'
    }
  })
};

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

import requests

url = "https://your-instance.iw-erp.de/api/invoice/incoming_invoice_transaction/42"

payload = { "data": {
    "currency": "EUR",
    "incoming_invoice": {
      "id": 42,
      "currency": "EUR",
      "name": "Beispiel",
      "linked_number_title": "Beispiel",
      "token": "string",
      "number": 1
    },
    "amount": 49.9,
    "payment_date": "2026-10-15T09:30:00+02:00",
    "buchhaltungs_butler_transaction_id": "42",
    "created": "2026-10-15T09:30:00+02:00"
  } }
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://your-instance.iw-erp.de/api/invoice/incoming_invoice_transaction/42', [
  'body' => '{"data":{"currency":"EUR","incoming_invoice":{"id":42,"currency":"EUR","name":"Beispiel","linked_number_title":"Beispiel","token":"string","number":1},"amount":49.9,"payment_date":"2026-10-15T09:30:00+02:00","buchhaltungs_butler_transaction_id":"42","created":"2026-10-15T09:30:00+02:00"}}',
  'headers' => [
    'content-type' => 'application/json',
    'x-iw-jwt-token' => '<TOKEN>',
  ],
]);

echo $response->getBody();

using System.Net.Http.Headers;
var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Put,
  RequestUri = new Uri("https://your-instance.iw-erp.de/api/invoice/incoming_invoice_transaction/42"),
  Headers =
  {
    { "x-iw-jwt-token", "<TOKEN>" },
  },
  Content = new StringContent("{\"data\":{\"currency\":\"EUR\",\"incoming_invoice\":{\"id\":42,\"currency\":\"EUR\",\"name\":\"Beispiel\",\"linked_number_title\":\"Beispiel\",\"token\":\"string\",\"number\":1},\"amount\":49.9,\"payment_date\":\"2026-10-15T09:30:00+02:00\",\"buchhaltungs_butler_transaction_id\":\"42\",\"created\":\"2026-10-15T09:30:00+02:00\"}}")
  {
    Headers =
    {
      ContentType = new MediaTypeHeaderValue("application/json")
    }
  }
};
using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}

OkHttpClient client = new OkHttpClient();

MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\"data\":{\"currency\":\"EUR\",\"incoming_invoice\":{\"id\":42,\"currency\":\"EUR\",\"name\":\"Beispiel\",\"linked_number_title\":\"Beispiel\",\"token\":\"string\",\"number\":1},\"amount\":49.9,\"payment_date\":\"2026-10-15T09:30:00+02:00\",\"buchhaltungs_butler_transaction_id\":\"42\",\"created\":\"2026-10-15T09:30:00+02:00\"}}");
Request request = new Request.Builder()
  .url("https://your-instance.iw-erp.de/api/invoice/incoming_invoice_transaction/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://your-instance.iw-erp.de/api/invoice/incoming_invoice_transaction/42"

	payload := strings.NewReader("{\"data\":{\"currency\":\"EUR\",\"incoming_invoice\":{\"id\":42,\"currency\":\"EUR\",\"name\":\"Beispiel\",\"linked_number_title\":\"Beispiel\",\"token\":\"string\",\"number\":1},\"amount\":49.9,\"payment_date\":\"2026-10-15T09:30:00+02:00\",\"buchhaltungs_butler_transaction_id\":\"42\",\"created\":\"2026-10-15T09:30:00+02:00\"}}")

	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 with package:http (no controller in the iw_erp_api package)

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

final response = await http.put(
  Uri.parse('https://your-instance.iw-erp.de/api/invoice/incoming_invoice_transaction/42'),
  headers: {'x-iw-jwt-token': '<TOKEN>', 'content-type': 'application/json'},
  body: jsonEncode({
    "data": {
      "currency": "EUR",
      "incoming_invoice": {
        "id": 42,
        "currency": "EUR",
        "name": "Beispiel",
        "linked_number_title": "Beispiel",
        "token": "string",
        "number": 1
      },
      "amount": 49.9,
      "payment_date": "2026-10-15T09:30:00+02:00",
      "buchhaltungs_butler_transaction_id": "42",
      "created": "2026-10-15T09:30:00+02:00"
    }
  }),
);
print(response.body);

Response 200 application/json

{
  "currency": "EUR",
  "incoming_invoice": {
    "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"
  },
  "amount": 49.9,
  "payment_date": "2026-10-15T09:30:00+02:00",
  "buchhaltungs_butler_transaction_id": "42",
  "created": "2026-10-15T09:30:00+02:00",
  "updated": "2026-10-15T09:30:00+02:00"
}