Expenses
With these methods you maintain the expenses of your account: incoming invoices, receipts and credit notes of your suppliers, with their payments and their receipt.
The methods need the extension Expenses. If it is not active for your account, each of them answers with 403. What cannot be stored the way you send it is refused with the reason: nothing is cut or dropped silently. Lengths count the stored form: billware stores text the way the customer area does, there & takes five characters, < and > four each, " and ' six each.
expense.create
Create a new expense.Data
| Fields | Description | Accepted Types | Defaults To |
|---|---|---|---|
| price Required | Net amount of the expense. Negative for a credit note of the supplier: it counts as paid once the supplier has refunded the money. | Float |
|
| tax_rate Required | Tax rate in percent, from 0 to 99.9999. |
Float |
|
| origin Required | Where the supply comes from. | "domestic" Domestic "eu" Other EU country "other" Non-EU country |
|
| date_invoice | Date of the receipt. Formats: YYYY-MM-DD, YYYY-MM-DD HH:MM:SS or ISO 8601 (e.g. 2026-10-05T09:30:00+02:00). Without an offset the time zone of your account applies. |
String |
|
| date_due | Due date, in the same formats as date_invoice. |
String |
|
| reference_nr | The supplier's number of the receipt, 64 characters at most. | String |
"" |
| expense_nr | Expense number, 32 characters at most. It may exist only once in the account. Without it billware assigns the next number of your number range. | String |
Generated Number |
| user_note | Note, 1024 characters at most. | String |
"" |
| external_ident | Ident of the expense in your system, 512 characters at most. You can filter by it in expense.list. | String |
"" |
| expense_type | Source of the expense, 32 characters at most, e.g. the name of your system. | String |
"billware" |
| supplier_ident | Ident of a supplier of your account, see Suppliers. | String |
|
| account_ident | Ident of a booking account of your account. You find it in the answer of expense.read under account. |
String |
|
| expense_category_ident | Ident of the category, see Categories. | String |
|
| write_off_years | Useful life in years, from 1 to 50. Only counts for write-off categories (AfA). |
Integer |
5 |
Code Examples
# Get your API credentials from your billware customer area
API_APPID="your-app-id"
API_SECRET="your-api-secret"
PAYLOAD='{"price":46.72,"tax_rate":19,"origin":"domestic","date_invoice":"2026-10-05","date_due":"2026-10-19","reference_nr":"RE-2026-0815","user_note":"Toner und Papier","external_ident":"TX-5001","supplier_ident":"ckt8w78bfmj54054","expense_category_ident":"306820h1R33790Ap"}'
# The HMAC is calculated over the exact request body that is sent
HMAC=$(printf '%s' "$PAYLOAD" | openssl dgst -sha256 -hmac "$API_SECRET" -binary | base64)
curl -X POST "https://www.billware.de/api/v1" \
-H "X-Bw-Hmac: $API_APPID:$HMAC" \
-H "X-Bw-Method: expense.create" \
-H "Content-Type: application/json" \
-d "$PAYLOAD"<?php
// Get your API credentials from your billware customer area
$apiAppId = 'your-app-id';
$apiSecret = 'your-api-secret';
$payload = json_encode([
'price' => 46.72,
'tax_rate' => 19,
'origin' => 'domestic',
'date_invoice' => '2026-10-05',
'date_due' => '2026-10-19',
'reference_nr' => 'RE-2026-0815',
'user_note' => 'Toner und Papier',
'external_ident' => 'TX-5001',
'supplier_ident' => 'ckt8w78bfmj54054',
'expense_category_ident' => '306820h1R33790Ap',
]);
// The HMAC is calculated over the exact request body that is sent
$hmac = base64_encode(hash_hmac('sha256', $payload, $apiSecret, true));
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => 'https://www.billware.de/api/v1',
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => $payload,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'X-Bw-Hmac: '.$apiAppId.':'.$hmac,
'X-Bw-Method: expense.create',
'Content-Type: application/json',
],
]);
$response = curl_exec($curl);
curl_close($curl);
print_r(json_decode($response, true));import crypto from 'node:crypto';
// Get your API credentials from your billware customer area
const apiAppId = 'your-app-id';
const apiSecret = 'your-api-secret';
const payload = JSON.stringify({
"price": 46.72,
"tax_rate": 19,
"origin": "domestic",
"date_invoice": "2026-10-05",
"date_due": "2026-10-19",
"reference_nr": "RE-2026-0815",
"user_note": "Toner und Papier",
"external_ident": "TX-5001",
"supplier_ident": "ckt8w78bfmj54054",
"expense_category_ident": "306820h1R33790Ap"
});
// The HMAC is calculated over the exact request body that is sent
const hmac = crypto.createHmac('sha256', apiSecret).update(payload).digest('base64');
const response = await fetch('https://www.billware.de/api/v1', {
method: 'POST',
headers: {
'X-Bw-Hmac': `${apiAppId}:${hmac}`,
'X-Bw-Method': 'expense.create',
'Content-Type': 'application/json'
},
body: payload
});
console.log(await response.json());import base64
import hashlib
import hmac
import json
import requests
# Get your API credentials from your billware customer area
api_appid = "your-app-id"
api_secret = "your-api-secret"
payload = json.dumps({
"price": 46.72,
"tax_rate": 19,
"origin": "domestic",
"date_invoice": "2026-10-05",
"date_due": "2026-10-19",
"reference_nr": "RE-2026-0815",
"user_note": "Toner und Papier",
"external_ident": "TX-5001",
"supplier_ident": "ckt8w78bfmj54054",
"expense_category_ident": "306820h1R33790Ap",
})
# The HMAC is calculated over the exact request body that is sent
signature = base64.b64encode(
hmac.new(api_secret.encode(), payload.encode(), hashlib.sha256).digest()
).decode()
response = requests.post(
"https://www.billware.de/api/v1",
data=payload,
headers={
"X-Bw-Hmac": f"{api_appid}:{signature}",
"X-Bw-Method": "expense.create",
"Content-Type": "application/json",
},
)
print(response.json())using System.Net.Http;
using System.Security.Cryptography;
using System.Text;
using System.Text.Json;
// Get your API credentials from your billware customer area
const string apiAppId = "your-app-id";
const string apiSecret = "your-api-secret";
var payload = JsonSerializer.Serialize(new
{
price = 46.72,
tax_rate = 19,
origin = "domestic",
date_invoice = "2026-10-05",
date_due = "2026-10-19",
reference_nr = "RE-2026-0815",
user_note = "Toner und Papier",
external_ident = "TX-5001",
supplier_ident = "ckt8w78bfmj54054",
expense_category_ident = "306820h1R33790Ap"
});
// The HMAC is calculated over the exact request body that is sent
using var hmac = new HMACSHA256(Encoding.UTF8.GetBytes(apiSecret));
var signature = Convert.ToBase64String(hmac.ComputeHash(Encoding.UTF8.GetBytes(payload)));
using var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "https://www.billware.de/api/v1")
{
Content = new StringContent(payload, Encoding.UTF8, "application/json")
};
request.Headers.Add("X-Bw-Hmac", $"{apiAppId}:{signature}");
request.Headers.Add("X-Bw-Method", "expense.create");
var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());Return Values
The answer holds the created expense with the same structure as expense.read.
Example Responses
// SUCCESS
{
"response": true,
"data": {
"expense_ident": "0nzgcohs25s4y7zv",
"expense_nr": "AG-0001",
"price": "46.7200",
"tax_rate": "19.0000",
"price_total": 55.5968,
...
},
"message": "expense created"
}
// ERROR
{
"response": false,
"data": null,
"message": "tax_rate is required"
}
expense.read
Get an expense with its payments and its receipt.Data
| Fields | Description | Accepted Types |
|---|---|---|
| expense_ident Required | Ident of the expense | String |
Code Examples
# Get your API credentials from your billware customer area
API_APPID="your-app-id"
API_SECRET="your-api-secret"
PAYLOAD='{"expense_ident":"0nzgcohs25s4y7zv"}'
# The HMAC is calculated over the exact request body that is sent
HMAC=$(printf '%s' "$PAYLOAD" | openssl dgst -sha256 -hmac "$API_SECRET" -binary | base64)
curl -X POST "https://www.billware.de/api/v1" \
-H "X-Bw-Hmac: $API_APPID:$HMAC" \
-H "X-Bw-Method: expense.read" \
-H "Content-Type: application/json" \
-d "$PAYLOAD"<?php
// Get your API credentials from your billware customer area
$apiAppId = 'your-app-id';
$apiSecret = 'your-api-secret';
$payload = json_encode([
'expense_ident' => '0nzgcohs25s4y7zv',
]);
// The HMAC is calculated over the exact request body that is sent
$hmac = base64_encode(hash_hmac('sha256', $payload, $apiSecret, true));
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => 'https://www.billware.de/api/v1',
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => $payload,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'X-Bw-Hmac: '.$apiAppId.':'.$hmac,
'X-Bw-Method: expense.read',
'Content-Type: application/json',
],
]);
$response = curl_exec($curl);
curl_close($curl);
print_r(json_decode($response, true));import crypto from 'node:crypto';
// Get your API credentials from your billware customer area
const apiAppId = 'your-app-id';
const apiSecret = 'your-api-secret';
const payload = JSON.stringify({
"expense_ident": "0nzgcohs25s4y7zv"
});
// The HMAC is calculated over the exact request body that is sent
const hmac = crypto.createHmac('sha256', apiSecret).update(payload).digest('base64');
const response = await fetch('https://www.billware.de/api/v1', {
method: 'POST',
headers: {
'X-Bw-Hmac': `${apiAppId}:${hmac}`,
'X-Bw-Method': 'expense.read',
'Content-Type': 'application/json'
},
body: payload
});
console.log(await response.json());import base64
import hashlib
import hmac
import json
import requests
# Get your API credentials from your billware customer area
api_appid = "your-app-id"
api_secret = "your-api-secret"
payload = json.dumps({
"expense_ident": "0nzgcohs25s4y7zv",
})
# The HMAC is calculated over the exact request body that is sent
signature = base64.b64encode(
hmac.new(api_secret.encode(), payload.encode(), hashlib.sha256).digest()
).decode()
response = requests.post(
"https://www.billware.de/api/v1",
data=payload,
headers={
"X-Bw-Hmac": f"{api_appid}:{signature}",
"X-Bw-Method": "expense.read",
"Content-Type": "application/json",
},
)
print(response.json())using System.Net.Http;
using System.Security.Cryptography;
using System.Text;
using System.Text.Json;
// Get your API credentials from your billware customer area
const string apiAppId = "your-app-id";
const string apiSecret = "your-api-secret";
var payload = JsonSerializer.Serialize(new
{
expense_ident = "0nzgcohs25s4y7zv"
});
// The HMAC is calculated over the exact request body that is sent
using var hmac = new HMACSHA256(Encoding.UTF8.GetBytes(apiSecret));
var signature = Convert.ToBase64String(hmac.ComputeHash(Encoding.UTF8.GetBytes(payload)));
using var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "https://www.billware.de/api/v1")
{
Content = new StringContent(payload, Encoding.UTF8, "application/json")
};
request.Headers.Add("X-Bw-Hmac", $"{apiAppId}:{signature}");
request.Headers.Add("X-Bw-Method", "expense.read");
var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());Return Values
| Fields | Description |
|---|---|
| expense_ident | Ident of the expense |
| expense_nr | Expense number |
| reference_nr | The supplier's number of the receipt |
| expense_type | Source of the expense |
| external_ident | Ident of the expense in your system |
| user_note | Note |
| price | Net amount, as a string with four decimals |
| tax_rate | Tax rate in percent |
| price_total | Gross amount, not rounded |
| origin | Where the supply comes from: domestic, eu or other |
| date_invoice date_due date_paid |
Date of the receipt, due date and day of payment in server time (UTC). A date you send without a time is stored as 12:00 in the time zone of your account. The fields ending in _user show the same date in the date format of your account. |
| date_created date_updated |
Time of creation and of the last change in server time (UTC) |
| is_paid | Whether the expense counts as paid: 1 or 0 |
| calculation | open_amount: the gross amount that is still open. is_paid: whether nothing is open any more. |
| status | Status of the expense with its name in the language of your account and its colour |
| supplier_ident supplier |
Ident of the supplier and the supplier with its fields, otherwise null |
| account_ident account |
Ident of the booking account and the account with its number and title, otherwise null |
| expense_category_ident category |
Ident of the category and the category with its name in both languages, otherwise null |
| booked_payments | The booked payments, each as in the answer of expense.createPayment |
| file | The receipt as in the answer of expense.fileUpload, otherwise null |
| write_off_years | Useful life in years |
| input_tax_deductible | Whether the input tax of the expense is deductible: 1 or 0 |
| repetition | Always null: only the templates of recurring expenses hold a repetition, and the API does not hand them out. |
Example Responses
// SUCCESS
{
"response": true,
"data": {
"expense_ident": "0nzgcohs25s4y7zv",
"expense_nr": "AG-0001",
"expense_type": "billware",
"external_ident": "TX-5001",
"reference_nr": "RE-2026-0815",
"user_note": "Toner und Papier",
"price": "46.7200",
"tax_rate": "19.0000",
"price_total": 55.5968,
"currency": "EUR",
"origin": "domestic",
"date_invoice": "2026-10-05 10:00:00",
"date_invoice_user": "05.10.2026",
"date_due": "2026-10-19 10:00:00",
"date_due_user": "19.10.2026",
"date_paid": null,
"date_paid_user": null,
"date_created": "2026-11-16 10:30:10",
"date_updated": "2026-11-16 10:30:10",
"is_paid": 0,
"calculation": {
"open_amount": 35.6,
"is_paid": 0
},
"status": {
"color": "#ffb800",
"name": "Fällig"
},
"supplier_ident": "ckt8w78bfmj54054",
"supplier": {
"supplier_ident": "ckt8w78bfmj54054",
"supplier_nr": "L-7001",
"bill_company": "Papier & Druck KG",
...
},
"account_ident": "oo017520wieoo3vt",
"account": {
"account_ident": "oo017520wieoo3vt",
"account_nr": 4930,
"title": "Bürobedarf",
...
},
"expense_category_ident": "306820h1R33790Ap",
"category": {
"expense_category_ident": "306820h1R33790Ap",
"lang_de": "Büroausstattung und -bedarf",
"lang_en": "Office equipment",
...
},
"booked_payments": [
{
"expense_payment_ident": "lejbm9d8w8rw3e2s",
"expense_ident": "0nzgcohs25s4y7zv",
"date_paid": "2026-10-12 10:00:00",
"amount": "20.0000",
"fee": "0.0000",
"payment_name": "Überweisung",
"external_ident": "",
"user_note": "Anzahlung",
...
}
],
"file": {
"href": "https://www.billware.de/file?t=...",
"file_ident": "71ahxmkcu6ockdzd",
"file_user_name": "Rechnung RE-2026-0815.pdf",
"file_extension": "pdf",
...
},
"write_off_years": 5,
"input_tax_deductible": 1,
"repetition": null,
...
},
"message": "Read expense with ident: 0nzgcohs25s4y7zv"
}
// ERROR
{
"response": false,
"data": null,
"message": "Expense not found"
}
expense.list
Get multiple expenses as a list.Data
| Fields | Description | Accepted Types | Defaults To |
|---|---|---|---|
| date_type | The date the period refers to and the list is sorted by, the newest first. | "date_created" "date_updated" "date_invoice" "date_due" "date_paid" |
"date_created" |
| start_date | Start of the period. Format: Y-m-d H:i:s (e.g. "2026-10-01 00:00:00"), compared with the stored times in server time (UTC). |
String |
|
| end_date | End of the period, in the same format as start_date. |
String |
|
| expense_type | Only expenses of this source. | String |
|
| external_ident | Only the expense with this ident of your system. | String |
|
| supplier_ident | Only expenses of this supplier. | String |
|
| account_ident | Only expenses on this booking account. | String |
|
| expense_category_ident | Only expenses of this category. | String |
|
| is_paid | Only paid or only open expenses. | 0 No 1 Yes |
|
| page | Page of the list. Without it the first page is returned. | Integer |
1 |
| limit | Number of entries per page, from 1 to 100. |
Integer |
25 |
Every field is optional and they can be combined, an expense then has to match every filter. Without any the list holds all expenses of your account. The templates of recurring expenses are not part of it.
Code Examples
expense.list
# Get your API credentials from your billware customer area
API_APPID="your-app-id"
API_SECRET="your-api-secret"
PAYLOAD='{"date_type":"date_invoice","start_date":"2026-10-01 00:00:00","end_date":"2026-10-31 23:59:59","is_paid":0,"page":1,"limit":50}'
# The HMAC is calculated over the exact request body that is sent
HMAC=$(printf '%s' "$PAYLOAD" | openssl dgst -sha256 -hmac "$API_SECRET" -binary | base64)
curl -X POST "https://www.billware.de/api/v1" \
-H "X-Bw-Hmac: $API_APPID:$HMAC" \
-H "X-Bw-Method: expense.list" \
-H "Content-Type: application/json" \
-d "$PAYLOAD"<?php
// Get your API credentials from your billware customer area
$apiAppId = 'your-app-id';
$apiSecret = 'your-api-secret';
$payload = json_encode([
'date_type' => 'date_invoice',
'start_date' => '2026-10-01 00:00:00',
'end_date' => '2026-10-31 23:59:59',
'is_paid' => 0,
'page' => 1,
'limit' => 50,
]);
// The HMAC is calculated over the exact request body that is sent
$hmac = base64_encode(hash_hmac('sha256', $payload, $apiSecret, true));
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => 'https://www.billware.de/api/v1',
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => $payload,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'X-Bw-Hmac: '.$apiAppId.':'.$hmac,
'X-Bw-Method: expense.list',
'Content-Type: application/json',
],
]);
$response = curl_exec($curl);
curl_close($curl);
print_r(json_decode($response, true));import crypto from 'node:crypto';
// Get your API credentials from your billware customer area
const apiAppId = 'your-app-id';
const apiSecret = 'your-api-secret';
const payload = JSON.stringify({
"date_type": "date_invoice",
"start_date": "2026-10-01 00:00:00",
"end_date": "2026-10-31 23:59:59",
"is_paid": 0,
"page": 1,
"limit": 50
});
// The HMAC is calculated over the exact request body that is sent
const hmac = crypto.createHmac('sha256', apiSecret).update(payload).digest('base64');
const response = await fetch('https://www.billware.de/api/v1', {
method: 'POST',
headers: {
'X-Bw-Hmac': `${apiAppId}:${hmac}`,
'X-Bw-Method': 'expense.list',
'Content-Type': 'application/json'
},
body: payload
});
console.log(await response.json());import base64
import hashlib
import hmac
import json
import requests
# Get your API credentials from your billware customer area
api_appid = "your-app-id"
api_secret = "your-api-secret"
payload = json.dumps({
"date_type": "date_invoice",
"start_date": "2026-10-01 00:00:00",
"end_date": "2026-10-31 23:59:59",
"is_paid": 0,
"page": 1,
"limit": 50,
})
# The HMAC is calculated over the exact request body that is sent
signature = base64.b64encode(
hmac.new(api_secret.encode(), payload.encode(), hashlib.sha256).digest()
).decode()
response = requests.post(
"https://www.billware.de/api/v1",
data=payload,
headers={
"X-Bw-Hmac": f"{api_appid}:{signature}",
"X-Bw-Method": "expense.list",
"Content-Type": "application/json",
},
)
print(response.json())using System.Net.Http;
using System.Security.Cryptography;
using System.Text;
using System.Text.Json;
// Get your API credentials from your billware customer area
const string apiAppId = "your-app-id";
const string apiSecret = "your-api-secret";
var payload = JsonSerializer.Serialize(new
{
date_type = "date_invoice",
start_date = "2026-10-01 00:00:00",
end_date = "2026-10-31 23:59:59",
is_paid = 0,
page = 1,
limit = 50
});
// The HMAC is calculated over the exact request body that is sent
using var hmac = new HMACSHA256(Encoding.UTF8.GetBytes(apiSecret));
var signature = Convert.ToBase64String(hmac.ComputeHash(Encoding.UTF8.GetBytes(payload)));
using var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "https://www.billware.de/api/v1")
{
Content = new StringContent(payload, Encoding.UTF8, "application/json")
};
request.Headers.Add("X-Bw-Hmac", $"{apiAppId}:{signature}");
request.Headers.Add("X-Bw-Method", "expense.list");
var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());expense.list (one supplier)
# Get your API credentials from your billware customer area
API_APPID="your-app-id"
API_SECRET="your-api-secret"
PAYLOAD='{"supplier_ident":"ckt8w78bfmj54054"}'
# The HMAC is calculated over the exact request body that is sent
HMAC=$(printf '%s' "$PAYLOAD" | openssl dgst -sha256 -hmac "$API_SECRET" -binary | base64)
curl -X POST "https://www.billware.de/api/v1" \
-H "X-Bw-Hmac: $API_APPID:$HMAC" \
-H "X-Bw-Method: expense.list" \
-H "Content-Type: application/json" \
-d "$PAYLOAD"<?php
// Get your API credentials from your billware customer area
$apiAppId = 'your-app-id';
$apiSecret = 'your-api-secret';
$payload = json_encode([
'supplier_ident' => 'ckt8w78bfmj54054',
]);
// The HMAC is calculated over the exact request body that is sent
$hmac = base64_encode(hash_hmac('sha256', $payload, $apiSecret, true));
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => 'https://www.billware.de/api/v1',
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => $payload,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'X-Bw-Hmac: '.$apiAppId.':'.$hmac,
'X-Bw-Method: expense.list',
'Content-Type: application/json',
],
]);
$response = curl_exec($curl);
curl_close($curl);
print_r(json_decode($response, true));import crypto from 'node:crypto';
// Get your API credentials from your billware customer area
const apiAppId = 'your-app-id';
const apiSecret = 'your-api-secret';
const payload = JSON.stringify({
"supplier_ident": "ckt8w78bfmj54054"
});
// The HMAC is calculated over the exact request body that is sent
const hmac = crypto.createHmac('sha256', apiSecret).update(payload).digest('base64');
const response = await fetch('https://www.billware.de/api/v1', {
method: 'POST',
headers: {
'X-Bw-Hmac': `${apiAppId}:${hmac}`,
'X-Bw-Method': 'expense.list',
'Content-Type': 'application/json'
},
body: payload
});
console.log(await response.json());import base64
import hashlib
import hmac
import json
import requests
# Get your API credentials from your billware customer area
api_appid = "your-app-id"
api_secret = "your-api-secret"
payload = json.dumps({
"supplier_ident": "ckt8w78bfmj54054",
})
# The HMAC is calculated over the exact request body that is sent
signature = base64.b64encode(
hmac.new(api_secret.encode(), payload.encode(), hashlib.sha256).digest()
).decode()
response = requests.post(
"https://www.billware.de/api/v1",
data=payload,
headers={
"X-Bw-Hmac": f"{api_appid}:{signature}",
"X-Bw-Method": "expense.list",
"Content-Type": "application/json",
},
)
print(response.json())using System.Net.Http;
using System.Security.Cryptography;
using System.Text;
using System.Text.Json;
// Get your API credentials from your billware customer area
const string apiAppId = "your-app-id";
const string apiSecret = "your-api-secret";
var payload = JsonSerializer.Serialize(new
{
supplier_ident = "ckt8w78bfmj54054"
});
// The HMAC is calculated over the exact request body that is sent
using var hmac = new HMACSHA256(Encoding.UTF8.GetBytes(apiSecret));
var signature = Convert.ToBase64String(hmac.ComputeHash(Encoding.UTF8.GetBytes(payload)));
using var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "https://www.billware.de/api/v1")
{
Content = new StringContent(payload, Encoding.UTF8, "application/json")
};
request.Headers.Add("X-Bw-Hmac", $"{apiAppId}:{signature}");
request.Headers.Add("X-Bw-Method", "expense.list");
var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());Return Values
The expenses array contains entries with the same structure as the answer of expense.read.
Pagination
The response includes metadata to support pagination:
page: The current page number that was requested.limit: The number of entries per page.total: The total number of entries that match the filter.total_pages: The total number of pages available based on the result count and page size.
Use page to walk through the pages and limit to set how many entries a page holds. A page holds 100 entries at most, there is no limit in total: through the pages up to total_pages you reach every entry.
Example Responses
// SUCCESS
{
"response": true,
"data": {
"page": 1,
"limit": 25,
"total": 38,
"total_pages": 2,
"expenses": [
{
"expense_ident": "0nzgcohs25s4y7zv",
"expense_nr": "AG-0001",
"date_invoice": "2026-10-05 10:00:00",
"price": "46.7200",
...
},
...
]
},
"message": "Expense list retrieved successfully"
}
// ERROR
{
"response": false,
"data": null,
"message": "Invalid date_type. Allowed: date_created, date_updated, date_invoice, date_due, date_paid"
}
expense.update
Update one or more fields of an expense.Data
| Fields | Description | Accepted Types |
|---|---|---|
| expense_ident Required | Ident of the expense | String |
Plus every field of expense.create you want to change. Only fields you send change. An empty text empties a text field; for a date or an ident (supplier_ident, account_ident, expense_category_ident) it takes the date or the link away. The expense number cannot be emptied.
Code Examples
# Get your API credentials from your billware customer area
API_APPID="your-app-id"
API_SECRET="your-api-secret"
PAYLOAD='{"expense_ident":"0nzgcohs25s4y7zv","user_note":"Toner, Papier und Ordner","date_due":"2026-10-26"}'
# The HMAC is calculated over the exact request body that is sent
HMAC=$(printf '%s' "$PAYLOAD" | openssl dgst -sha256 -hmac "$API_SECRET" -binary | base64)
curl -X POST "https://www.billware.de/api/v1" \
-H "X-Bw-Hmac: $API_APPID:$HMAC" \
-H "X-Bw-Method: expense.update" \
-H "Content-Type: application/json" \
-d "$PAYLOAD"<?php
// Get your API credentials from your billware customer area
$apiAppId = 'your-app-id';
$apiSecret = 'your-api-secret';
$payload = json_encode([
'expense_ident' => '0nzgcohs25s4y7zv',
'user_note' => 'Toner, Papier und Ordner',
'date_due' => '2026-10-26',
]);
// The HMAC is calculated over the exact request body that is sent
$hmac = base64_encode(hash_hmac('sha256', $payload, $apiSecret, true));
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => 'https://www.billware.de/api/v1',
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => $payload,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'X-Bw-Hmac: '.$apiAppId.':'.$hmac,
'X-Bw-Method: expense.update',
'Content-Type: application/json',
],
]);
$response = curl_exec($curl);
curl_close($curl);
print_r(json_decode($response, true));import crypto from 'node:crypto';
// Get your API credentials from your billware customer area
const apiAppId = 'your-app-id';
const apiSecret = 'your-api-secret';
const payload = JSON.stringify({
"expense_ident": "0nzgcohs25s4y7zv",
"user_note": "Toner, Papier und Ordner",
"date_due": "2026-10-26"
});
// The HMAC is calculated over the exact request body that is sent
const hmac = crypto.createHmac('sha256', apiSecret).update(payload).digest('base64');
const response = await fetch('https://www.billware.de/api/v1', {
method: 'POST',
headers: {
'X-Bw-Hmac': `${apiAppId}:${hmac}`,
'X-Bw-Method': 'expense.update',
'Content-Type': 'application/json'
},
body: payload
});
console.log(await response.json());import base64
import hashlib
import hmac
import json
import requests
# Get your API credentials from your billware customer area
api_appid = "your-app-id"
api_secret = "your-api-secret"
payload = json.dumps({
"expense_ident": "0nzgcohs25s4y7zv",
"user_note": "Toner, Papier und Ordner",
"date_due": "2026-10-26",
})
# The HMAC is calculated over the exact request body that is sent
signature = base64.b64encode(
hmac.new(api_secret.encode(), payload.encode(), hashlib.sha256).digest()
).decode()
response = requests.post(
"https://www.billware.de/api/v1",
data=payload,
headers={
"X-Bw-Hmac": f"{api_appid}:{signature}",
"X-Bw-Method": "expense.update",
"Content-Type": "application/json",
},
)
print(response.json())using System.Net.Http;
using System.Security.Cryptography;
using System.Text;
using System.Text.Json;
// Get your API credentials from your billware customer area
const string apiAppId = "your-app-id";
const string apiSecret = "your-api-secret";
var payload = JsonSerializer.Serialize(new
{
expense_ident = "0nzgcohs25s4y7zv",
user_note = "Toner, Papier und Ordner",
date_due = "2026-10-26"
});
// The HMAC is calculated over the exact request body that is sent
using var hmac = new HMACSHA256(Encoding.UTF8.GetBytes(apiSecret));
var signature = Convert.ToBase64String(hmac.ComputeHash(Encoding.UTF8.GetBytes(payload)));
using var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "https://www.billware.de/api/v1")
{
Content = new StringContent(payload, Encoding.UTF8, "application/json")
};
request.Headers.Add("X-Bw-Hmac", $"{apiAppId}:{signature}");
request.Headers.Add("X-Bw-Method", "expense.update");
var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());Return Values
The answer holds the expense as it is now, with the same structure as expense.read.
Example Responses
// SUCCESS
{
"response": true,
"data": {
"expense_ident": "0nzgcohs25s4y7zv",
"user_note": "Toner, Papier und Ordner",
...
},
"message": "expense updated"
}
// ERROR
{
"response": false,
"data": null,
"message": "expense_nr is taken already"
}
expense.put
Create or update an expense, in one call.With expense_ident the call changes that expense like expense.update. Without expense_ident it creates a new one like expense.create, then price, tax_rate and origin are required. Fields and answer are the same as there.
Code Examples
expense.put (create)
# Get your API credentials from your billware customer area
API_APPID="your-app-id"
API_SECRET="your-api-secret"
PAYLOAD='{"price":13.64,"tax_rate":19,"origin":"domestic","date_invoice":"2026-11-03","external_ident":"TX-5003"}'
# The HMAC is calculated over the exact request body that is sent
HMAC=$(printf '%s' "$PAYLOAD" | openssl dgst -sha256 -hmac "$API_SECRET" -binary | base64)
curl -X POST "https://www.billware.de/api/v1" \
-H "X-Bw-Hmac: $API_APPID:$HMAC" \
-H "X-Bw-Method: expense.put" \
-H "Content-Type: application/json" \
-d "$PAYLOAD"<?php
// Get your API credentials from your billware customer area
$apiAppId = 'your-app-id';
$apiSecret = 'your-api-secret';
$payload = json_encode([
'price' => 13.64,
'tax_rate' => 19,
'origin' => 'domestic',
'date_invoice' => '2026-11-03',
'external_ident' => 'TX-5003',
]);
// The HMAC is calculated over the exact request body that is sent
$hmac = base64_encode(hash_hmac('sha256', $payload, $apiSecret, true));
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => 'https://www.billware.de/api/v1',
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => $payload,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'X-Bw-Hmac: '.$apiAppId.':'.$hmac,
'X-Bw-Method: expense.put',
'Content-Type: application/json',
],
]);
$response = curl_exec($curl);
curl_close($curl);
print_r(json_decode($response, true));import crypto from 'node:crypto';
// Get your API credentials from your billware customer area
const apiAppId = 'your-app-id';
const apiSecret = 'your-api-secret';
const payload = JSON.stringify({
"price": 13.64,
"tax_rate": 19,
"origin": "domestic",
"date_invoice": "2026-11-03",
"external_ident": "TX-5003"
});
// The HMAC is calculated over the exact request body that is sent
const hmac = crypto.createHmac('sha256', apiSecret).update(payload).digest('base64');
const response = await fetch('https://www.billware.de/api/v1', {
method: 'POST',
headers: {
'X-Bw-Hmac': `${apiAppId}:${hmac}`,
'X-Bw-Method': 'expense.put',
'Content-Type': 'application/json'
},
body: payload
});
console.log(await response.json());import base64
import hashlib
import hmac
import json
import requests
# Get your API credentials from your billware customer area
api_appid = "your-app-id"
api_secret = "your-api-secret"
payload = json.dumps({
"price": 13.64,
"tax_rate": 19,
"origin": "domestic",
"date_invoice": "2026-11-03",
"external_ident": "TX-5003",
})
# The HMAC is calculated over the exact request body that is sent
signature = base64.b64encode(
hmac.new(api_secret.encode(), payload.encode(), hashlib.sha256).digest()
).decode()
response = requests.post(
"https://www.billware.de/api/v1",
data=payload,
headers={
"X-Bw-Hmac": f"{api_appid}:{signature}",
"X-Bw-Method": "expense.put",
"Content-Type": "application/json",
},
)
print(response.json())using System.Net.Http;
using System.Security.Cryptography;
using System.Text;
using System.Text.Json;
// Get your API credentials from your billware customer area
const string apiAppId = "your-app-id";
const string apiSecret = "your-api-secret";
var payload = JsonSerializer.Serialize(new
{
price = 13.64,
tax_rate = 19,
origin = "domestic",
date_invoice = "2026-11-03",
external_ident = "TX-5003"
});
// The HMAC is calculated over the exact request body that is sent
using var hmac = new HMACSHA256(Encoding.UTF8.GetBytes(apiSecret));
var signature = Convert.ToBase64String(hmac.ComputeHash(Encoding.UTF8.GetBytes(payload)));
using var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "https://www.billware.de/api/v1")
{
Content = new StringContent(payload, Encoding.UTF8, "application/json")
};
request.Headers.Add("X-Bw-Hmac", $"{apiAppId}:{signature}");
request.Headers.Add("X-Bw-Method", "expense.put");
var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());expense.put (update)
# Get your API credentials from your billware customer area
API_APPID="your-app-id"
API_SECRET="your-api-secret"
PAYLOAD='{"expense_ident":"0nzgcohs25s4y7zv","price":50}'
# The HMAC is calculated over the exact request body that is sent
HMAC=$(printf '%s' "$PAYLOAD" | openssl dgst -sha256 -hmac "$API_SECRET" -binary | base64)
curl -X POST "https://www.billware.de/api/v1" \
-H "X-Bw-Hmac: $API_APPID:$HMAC" \
-H "X-Bw-Method: expense.put" \
-H "Content-Type: application/json" \
-d "$PAYLOAD"<?php
// Get your API credentials from your billware customer area
$apiAppId = 'your-app-id';
$apiSecret = 'your-api-secret';
$payload = json_encode([
'expense_ident' => '0nzgcohs25s4y7zv',
'price' => 50,
]);
// The HMAC is calculated over the exact request body that is sent
$hmac = base64_encode(hash_hmac('sha256', $payload, $apiSecret, true));
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => 'https://www.billware.de/api/v1',
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => $payload,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'X-Bw-Hmac: '.$apiAppId.':'.$hmac,
'X-Bw-Method: expense.put',
'Content-Type: application/json',
],
]);
$response = curl_exec($curl);
curl_close($curl);
print_r(json_decode($response, true));import crypto from 'node:crypto';
// Get your API credentials from your billware customer area
const apiAppId = 'your-app-id';
const apiSecret = 'your-api-secret';
const payload = JSON.stringify({
"expense_ident": "0nzgcohs25s4y7zv",
"price": 50
});
// The HMAC is calculated over the exact request body that is sent
const hmac = crypto.createHmac('sha256', apiSecret).update(payload).digest('base64');
const response = await fetch('https://www.billware.de/api/v1', {
method: 'POST',
headers: {
'X-Bw-Hmac': `${apiAppId}:${hmac}`,
'X-Bw-Method': 'expense.put',
'Content-Type': 'application/json'
},
body: payload
});
console.log(await response.json());import base64
import hashlib
import hmac
import json
import requests
# Get your API credentials from your billware customer area
api_appid = "your-app-id"
api_secret = "your-api-secret"
payload = json.dumps({
"expense_ident": "0nzgcohs25s4y7zv",
"price": 50,
})
# The HMAC is calculated over the exact request body that is sent
signature = base64.b64encode(
hmac.new(api_secret.encode(), payload.encode(), hashlib.sha256).digest()
).decode()
response = requests.post(
"https://www.billware.de/api/v1",
data=payload,
headers={
"X-Bw-Hmac": f"{api_appid}:{signature}",
"X-Bw-Method": "expense.put",
"Content-Type": "application/json",
},
)
print(response.json())using System.Net.Http;
using System.Security.Cryptography;
using System.Text;
using System.Text.Json;
// Get your API credentials from your billware customer area
const string apiAppId = "your-app-id";
const string apiSecret = "your-api-secret";
var payload = JsonSerializer.Serialize(new
{
expense_ident = "0nzgcohs25s4y7zv",
price = 50
});
// The HMAC is calculated over the exact request body that is sent
using var hmac = new HMACSHA256(Encoding.UTF8.GetBytes(apiSecret));
var signature = Convert.ToBase64String(hmac.ComputeHash(Encoding.UTF8.GetBytes(payload)));
using var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "https://www.billware.de/api/v1")
{
Content = new StringContent(payload, Encoding.UTF8, "application/json")
};
request.Headers.Add("X-Bw-Hmac", $"{apiAppId}:{signature}");
request.Headers.Add("X-Bw-Method", "expense.put");
var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());expense.delete
Delete an expense with its payments and its receipt.Data
| Fields | Description | Accepted Types |
|---|---|---|
| expense_ident Required | Ident of the expense | String |
Code Examples
# Get your API credentials from your billware customer area
API_APPID="your-app-id"
API_SECRET="your-api-secret"
PAYLOAD='{"expense_ident":"0nzgcohs25s4y7zv"}'
# The HMAC is calculated over the exact request body that is sent
HMAC=$(printf '%s' "$PAYLOAD" | openssl dgst -sha256 -hmac "$API_SECRET" -binary | base64)
curl -X POST "https://www.billware.de/api/v1" \
-H "X-Bw-Hmac: $API_APPID:$HMAC" \
-H "X-Bw-Method: expense.delete" \
-H "Content-Type: application/json" \
-d "$PAYLOAD"<?php
// Get your API credentials from your billware customer area
$apiAppId = 'your-app-id';
$apiSecret = 'your-api-secret';
$payload = json_encode([
'expense_ident' => '0nzgcohs25s4y7zv',
]);
// The HMAC is calculated over the exact request body that is sent
$hmac = base64_encode(hash_hmac('sha256', $payload, $apiSecret, true));
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => 'https://www.billware.de/api/v1',
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => $payload,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'X-Bw-Hmac: '.$apiAppId.':'.$hmac,
'X-Bw-Method: expense.delete',
'Content-Type: application/json',
],
]);
$response = curl_exec($curl);
curl_close($curl);
print_r(json_decode($response, true));import crypto from 'node:crypto';
// Get your API credentials from your billware customer area
const apiAppId = 'your-app-id';
const apiSecret = 'your-api-secret';
const payload = JSON.stringify({
"expense_ident": "0nzgcohs25s4y7zv"
});
// The HMAC is calculated over the exact request body that is sent
const hmac = crypto.createHmac('sha256', apiSecret).update(payload).digest('base64');
const response = await fetch('https://www.billware.de/api/v1', {
method: 'POST',
headers: {
'X-Bw-Hmac': `${apiAppId}:${hmac}`,
'X-Bw-Method': 'expense.delete',
'Content-Type': 'application/json'
},
body: payload
});
console.log(await response.json());import base64
import hashlib
import hmac
import json
import requests
# Get your API credentials from your billware customer area
api_appid = "your-app-id"
api_secret = "your-api-secret"
payload = json.dumps({
"expense_ident": "0nzgcohs25s4y7zv",
})
# The HMAC is calculated over the exact request body that is sent
signature = base64.b64encode(
hmac.new(api_secret.encode(), payload.encode(), hashlib.sha256).digest()
).decode()
response = requests.post(
"https://www.billware.de/api/v1",
data=payload,
headers={
"X-Bw-Hmac": f"{api_appid}:{signature}",
"X-Bw-Method": "expense.delete",
"Content-Type": "application/json",
},
)
print(response.json())using System.Net.Http;
using System.Security.Cryptography;
using System.Text;
using System.Text.Json;
// Get your API credentials from your billware customer area
const string apiAppId = "your-app-id";
const string apiSecret = "your-api-secret";
var payload = JsonSerializer.Serialize(new
{
expense_ident = "0nzgcohs25s4y7zv"
});
// The HMAC is calculated over the exact request body that is sent
using var hmac = new HMACSHA256(Encoding.UTF8.GetBytes(apiSecret));
var signature = Convert.ToBase64String(hmac.ComputeHash(Encoding.UTF8.GetBytes(payload)));
using var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "https://www.billware.de/api/v1")
{
Content = new StringContent(payload, Encoding.UTF8, "application/json")
};
request.Headers.Add("X-Bw-Hmac", $"{apiAppId}:{signature}");
request.Headers.Add("X-Bw-Method", "expense.delete");
var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());Example Responses
// SUCCESS
{
"response": true,
"data": null,
"message": "expense deleted"
}
// ERROR
{
"response": false,
"data": null,
"message": "Expense not found"
}
expense.createPayment
Book a payment on an expense.Data
| Fields | Description | Accepted Types | Defaults To |
|---|---|---|---|
| expense_ident Required | Ident of the expense | String |
|
| date_paid Required | Day of the payment. Formats: YYYY-MM-DD, YYYY-MM-DD HH:MM:SS or ISO 8601 (e.g. 2026-10-05T09:30:00+02:00). Without an offset the time zone of your account applies. |
String |
|
| amount | Amount of the payment, not 0. Negative when the supplier refunds a credit note. Without it the open amount of the expense is booked. |
Float |
The open amount |
| fee | Fee of the payment, from 0. |
Float |
0 |
| payment_name | Payment method, 64 characters at most, e.g. "Bank transfer". | String |
"" |
| external_ident | Ident of the payment in your system, 256 characters at most. | String |
"" |
| user_note | Note on the payment, 1024 characters at most. | String |
"" |
| set_paid | Whether the expense counts as paid afterwards. Without it the expense counts as paid as soon as nothing is open any more. When a payment leaves something open again, a refund for instance, a paid expense counts as open again. | 0 No 1 Yes |
Code Examples
# Get your API credentials from your billware customer area
API_APPID="your-app-id"
API_SECRET="your-api-secret"
PAYLOAD='{"expense_ident":"0nzgcohs25s4y7zv","date_paid":"2026-10-12","amount":20,"payment_name":"Überweisung","user_note":"Anzahlung"}'
# The HMAC is calculated over the exact request body that is sent
HMAC=$(printf '%s' "$PAYLOAD" | openssl dgst -sha256 -hmac "$API_SECRET" -binary | base64)
curl -X POST "https://www.billware.de/api/v1" \
-H "X-Bw-Hmac: $API_APPID:$HMAC" \
-H "X-Bw-Method: expense.createPayment" \
-H "Content-Type: application/json" \
-d "$PAYLOAD"<?php
// Get your API credentials from your billware customer area
$apiAppId = 'your-app-id';
$apiSecret = 'your-api-secret';
$payload = json_encode([
'expense_ident' => '0nzgcohs25s4y7zv',
'date_paid' => '2026-10-12',
'amount' => 20,
'payment_name' => 'Überweisung',
'user_note' => 'Anzahlung',
]);
// The HMAC is calculated over the exact request body that is sent
$hmac = base64_encode(hash_hmac('sha256', $payload, $apiSecret, true));
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => 'https://www.billware.de/api/v1',
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => $payload,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'X-Bw-Hmac: '.$apiAppId.':'.$hmac,
'X-Bw-Method: expense.createPayment',
'Content-Type: application/json',
],
]);
$response = curl_exec($curl);
curl_close($curl);
print_r(json_decode($response, true));import crypto from 'node:crypto';
// Get your API credentials from your billware customer area
const apiAppId = 'your-app-id';
const apiSecret = 'your-api-secret';
const payload = JSON.stringify({
"expense_ident": "0nzgcohs25s4y7zv",
"date_paid": "2026-10-12",
"amount": 20,
"payment_name": "Überweisung",
"user_note": "Anzahlung"
});
// The HMAC is calculated over the exact request body that is sent
const hmac = crypto.createHmac('sha256', apiSecret).update(payload).digest('base64');
const response = await fetch('https://www.billware.de/api/v1', {
method: 'POST',
headers: {
'X-Bw-Hmac': `${apiAppId}:${hmac}`,
'X-Bw-Method': 'expense.createPayment',
'Content-Type': 'application/json'
},
body: payload
});
console.log(await response.json());import base64
import hashlib
import hmac
import json
import requests
# Get your API credentials from your billware customer area
api_appid = "your-app-id"
api_secret = "your-api-secret"
payload = json.dumps({
"expense_ident": "0nzgcohs25s4y7zv",
"date_paid": "2026-10-12",
"amount": 20,
"payment_name": "Überweisung",
"user_note": "Anzahlung",
})
# The HMAC is calculated over the exact request body that is sent
signature = base64.b64encode(
hmac.new(api_secret.encode(), payload.encode(), hashlib.sha256).digest()
).decode()
response = requests.post(
"https://www.billware.de/api/v1",
data=payload,
headers={
"X-Bw-Hmac": f"{api_appid}:{signature}",
"X-Bw-Method": "expense.createPayment",
"Content-Type": "application/json",
},
)
print(response.json())using System.Net.Http;
using System.Security.Cryptography;
using System.Text;
using System.Text.Json;
// Get your API credentials from your billware customer area
const string apiAppId = "your-app-id";
const string apiSecret = "your-api-secret";
var payload = JsonSerializer.Serialize(new
{
expense_ident = "0nzgcohs25s4y7zv",
date_paid = "2026-10-12",
amount = 20,
payment_name = "Überweisung",
user_note = "Anzahlung"
});
// The HMAC is calculated over the exact request body that is sent
using var hmac = new HMACSHA256(Encoding.UTF8.GetBytes(apiSecret));
var signature = Convert.ToBase64String(hmac.ComputeHash(Encoding.UTF8.GetBytes(payload)));
using var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "https://www.billware.de/api/v1")
{
Content = new StringContent(payload, Encoding.UTF8, "application/json")
};
request.Headers.Add("X-Bw-Hmac", $"{apiAppId}:{signature}");
request.Headers.Add("X-Bw-Method", "expense.createPayment");
var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());Return Values
The answer holds the booked payment. You need its expense_payment_ident to take the payment back with expense.deletePayment. The fields ending in _user show the same values in the format of your account.
Example Responses
// SUCCESS
{
"response": true,
"data": {
"expense_payment_ident": "lejbm9d8w8rw3e2s",
"expense_ident": "0nzgcohs25s4y7zv",
"date_created": "2026-11-16 10:30:10",
"date_paid": "2026-10-12 10:00:00",
"date_paid_user": "12.10.2026 12:00",
"amount": "20.0000",
"amount_user": "20,00 €",
"fee": "0.0000",
"fee_user": "0,00 €",
"payment_name": "Überweisung",
"payment_name_user": "Überweisung",
"external_ident": "",
"user_note": "Anzahlung",
"type": "payment",
...
},
"message": "Expense payment created"
}
// ERROR
{
"response": false,
"data": null,
"message": "date_paid is required"
}
expense.deletePayment
Take a booked payment back.Data
| Fields | Description | Accepted Types |
|---|---|---|
| expense_ident Required | Ident of the expense | String |
| expense_payment_ident Required | Ident of the payment, from the answer of expense.createPayment or from booked_payments of the expense. |
String |
Code Examples
# Get your API credentials from your billware customer area
API_APPID="your-app-id"
API_SECRET="your-api-secret"
PAYLOAD='{"expense_ident":"0nzgcohs25s4y7zv","expense_payment_ident":"lejbm9d8w8rw3e2s"}'
# The HMAC is calculated over the exact request body that is sent
HMAC=$(printf '%s' "$PAYLOAD" | openssl dgst -sha256 -hmac "$API_SECRET" -binary | base64)
curl -X POST "https://www.billware.de/api/v1" \
-H "X-Bw-Hmac: $API_APPID:$HMAC" \
-H "X-Bw-Method: expense.deletePayment" \
-H "Content-Type: application/json" \
-d "$PAYLOAD"<?php
// Get your API credentials from your billware customer area
$apiAppId = 'your-app-id';
$apiSecret = 'your-api-secret';
$payload = json_encode([
'expense_ident' => '0nzgcohs25s4y7zv',
'expense_payment_ident' => 'lejbm9d8w8rw3e2s',
]);
// The HMAC is calculated over the exact request body that is sent
$hmac = base64_encode(hash_hmac('sha256', $payload, $apiSecret, true));
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => 'https://www.billware.de/api/v1',
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => $payload,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'X-Bw-Hmac: '.$apiAppId.':'.$hmac,
'X-Bw-Method: expense.deletePayment',
'Content-Type: application/json',
],
]);
$response = curl_exec($curl);
curl_close($curl);
print_r(json_decode($response, true));import crypto from 'node:crypto';
// Get your API credentials from your billware customer area
const apiAppId = 'your-app-id';
const apiSecret = 'your-api-secret';
const payload = JSON.stringify({
"expense_ident": "0nzgcohs25s4y7zv",
"expense_payment_ident": "lejbm9d8w8rw3e2s"
});
// The HMAC is calculated over the exact request body that is sent
const hmac = crypto.createHmac('sha256', apiSecret).update(payload).digest('base64');
const response = await fetch('https://www.billware.de/api/v1', {
method: 'POST',
headers: {
'X-Bw-Hmac': `${apiAppId}:${hmac}`,
'X-Bw-Method': 'expense.deletePayment',
'Content-Type': 'application/json'
},
body: payload
});
console.log(await response.json());import base64
import hashlib
import hmac
import json
import requests
# Get your API credentials from your billware customer area
api_appid = "your-app-id"
api_secret = "your-api-secret"
payload = json.dumps({
"expense_ident": "0nzgcohs25s4y7zv",
"expense_payment_ident": "lejbm9d8w8rw3e2s",
})
# The HMAC is calculated over the exact request body that is sent
signature = base64.b64encode(
hmac.new(api_secret.encode(), payload.encode(), hashlib.sha256).digest()
).decode()
response = requests.post(
"https://www.billware.de/api/v1",
data=payload,
headers={
"X-Bw-Hmac": f"{api_appid}:{signature}",
"X-Bw-Method": "expense.deletePayment",
"Content-Type": "application/json",
},
)
print(response.json())using System.Net.Http;
using System.Security.Cryptography;
using System.Text;
using System.Text.Json;
// Get your API credentials from your billware customer area
const string apiAppId = "your-app-id";
const string apiSecret = "your-api-secret";
var payload = JsonSerializer.Serialize(new
{
expense_ident = "0nzgcohs25s4y7zv",
expense_payment_ident = "lejbm9d8w8rw3e2s"
});
// The HMAC is calculated over the exact request body that is sent
using var hmac = new HMACSHA256(Encoding.UTF8.GetBytes(apiSecret));
var signature = Convert.ToBase64String(hmac.ComputeHash(Encoding.UTF8.GetBytes(payload)));
using var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "https://www.billware.de/api/v1")
{
Content = new StringContent(payload, Encoding.UTF8, "application/json")
};
request.Headers.Add("X-Bw-Hmac", $"{apiAppId}:{signature}");
request.Headers.Add("X-Bw-Method", "expense.deletePayment");
var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());Return Values
The answer holds the expense as it is now, with the same structure as expense.read. If the remaining payments no longer cover the amount, the expense is open again.
Example Responses
// SUCCESS
{
"response": true,
"data": {
"expense_ident": "0nzgcohs25s4y7zv",
"is_paid": 0,
"booked_payments": [],
...
},
"message": "Expense payment deleted"
}
// ERROR
{
"response": false,
"data": null,
"message": "Expense payment not found"
}
expense.fileUpload
Store the receipt of an expense.Data
| Fields | Description | Accepted Types | Defaults To |
|---|---|---|---|
| expense_ident Required | Ident of the expense | String |
|
| file_base64 | The content of the file, Base64 encoded. Either file_base64 or file_url, not both. |
String |
|
| file_url | A link billware fetches the file from. https only, and only addresses that are publicly reachable. |
String |
|
| file_name | Name of the file. Without it the receipt is called like the expense number, e.g. AG-0001.pdf. |
String |
The expense number |
- A receipt is a PDF file, an XML file (an e-invoice, e.g. XRechnung), a picture as JPG or PNG or a text file (TXT).
- The file is taken by its content, not by its name. A file may be 10 MB at most.
- A file name may hold letters, digits, spaces and
. _ - ( ), 128 characters at most. Its ending has to fit the content: a PDF file is called.pdf. - An expense has one receipt: a new one takes the place of the one before.
- With
file_urlbillware follows three redirects at most, gives up after 20 seconds and fetches nothing larger than 10 MB.
Code Examples
expense.fileUpload (Base64)
# Get your API credentials from your billware customer area
API_APPID="your-app-id"
API_SECRET="your-api-secret"
PAYLOAD='{"expense_ident":"0nzgcohs25s4y7zv","file_base64":"JVBERi0xLjQKMSAwIG9iago8PCAvVHlwZSAvQ2F0YWxvZyA+PgplbmRvYmoKdHJhaWxlcgo8PCAvUm9vdCAxIDAgUiA+PgolJUVPRgo=","file_name":"Rechnung RE-2026-0815.pdf"}'
# The HMAC is calculated over the exact request body that is sent
HMAC=$(printf '%s' "$PAYLOAD" | openssl dgst -sha256 -hmac "$API_SECRET" -binary | base64)
curl -X POST "https://www.billware.de/api/v1" \
-H "X-Bw-Hmac: $API_APPID:$HMAC" \
-H "X-Bw-Method: expense.fileUpload" \
-H "Content-Type: application/json" \
-d "$PAYLOAD"<?php
// Get your API credentials from your billware customer area
$apiAppId = 'your-app-id';
$apiSecret = 'your-api-secret';
$payload = json_encode([
'expense_ident' => '0nzgcohs25s4y7zv',
'file_base64' => 'JVBERi0xLjQKMSAwIG9iago8PCAvVHlwZSAvQ2F0YWxvZyA+PgplbmRvYmoKdHJhaWxlcgo8PCAvUm9vdCAxIDAgUiA+PgolJUVPRgo=',
'file_name' => 'Rechnung RE-2026-0815.pdf',
]);
// The HMAC is calculated over the exact request body that is sent
$hmac = base64_encode(hash_hmac('sha256', $payload, $apiSecret, true));
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => 'https://www.billware.de/api/v1',
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => $payload,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'X-Bw-Hmac: '.$apiAppId.':'.$hmac,
'X-Bw-Method: expense.fileUpload',
'Content-Type: application/json',
],
]);
$response = curl_exec($curl);
curl_close($curl);
print_r(json_decode($response, true));import crypto from 'node:crypto';
// Get your API credentials from your billware customer area
const apiAppId = 'your-app-id';
const apiSecret = 'your-api-secret';
const payload = JSON.stringify({
"expense_ident": "0nzgcohs25s4y7zv",
"file_base64": "JVBERi0xLjQKMSAwIG9iago8PCAvVHlwZSAvQ2F0YWxvZyA+PgplbmRvYmoKdHJhaWxlcgo8PCAvUm9vdCAxIDAgUiA+PgolJUVPRgo=",
"file_name": "Rechnung RE-2026-0815.pdf"
});
// The HMAC is calculated over the exact request body that is sent
const hmac = crypto.createHmac('sha256', apiSecret).update(payload).digest('base64');
const response = await fetch('https://www.billware.de/api/v1', {
method: 'POST',
headers: {
'X-Bw-Hmac': `${apiAppId}:${hmac}`,
'X-Bw-Method': 'expense.fileUpload',
'Content-Type': 'application/json'
},
body: payload
});
console.log(await response.json());import base64
import hashlib
import hmac
import json
import requests
# Get your API credentials from your billware customer area
api_appid = "your-app-id"
api_secret = "your-api-secret"
payload = json.dumps({
"expense_ident": "0nzgcohs25s4y7zv",
"file_base64": "JVBERi0xLjQKMSAwIG9iago8PCAvVHlwZSAvQ2F0YWxvZyA+PgplbmRvYmoKdHJhaWxlcgo8PCAvUm9vdCAxIDAgUiA+PgolJUVPRgo=",
"file_name": "Rechnung RE-2026-0815.pdf",
})
# The HMAC is calculated over the exact request body that is sent
signature = base64.b64encode(
hmac.new(api_secret.encode(), payload.encode(), hashlib.sha256).digest()
).decode()
response = requests.post(
"https://www.billware.de/api/v1",
data=payload,
headers={
"X-Bw-Hmac": f"{api_appid}:{signature}",
"X-Bw-Method": "expense.fileUpload",
"Content-Type": "application/json",
},
)
print(response.json())using System.Net.Http;
using System.Security.Cryptography;
using System.Text;
using System.Text.Json;
// Get your API credentials from your billware customer area
const string apiAppId = "your-app-id";
const string apiSecret = "your-api-secret";
var payload = JsonSerializer.Serialize(new
{
expense_ident = "0nzgcohs25s4y7zv",
file_base64 = "JVBERi0xLjQKMSAwIG9iago8PCAvVHlwZSAvQ2F0YWxvZyA+PgplbmRvYmoKdHJhaWxlcgo8PCAvUm9vdCAxIDAgUiA+PgolJUVPRgo=",
file_name = "Rechnung RE-2026-0815.pdf"
});
// The HMAC is calculated over the exact request body that is sent
using var hmac = new HMACSHA256(Encoding.UTF8.GetBytes(apiSecret));
var signature = Convert.ToBase64String(hmac.ComputeHash(Encoding.UTF8.GetBytes(payload)));
using var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "https://www.billware.de/api/v1")
{
Content = new StringContent(payload, Encoding.UTF8, "application/json")
};
request.Headers.Add("X-Bw-Hmac", $"{apiAppId}:{signature}");
request.Headers.Add("X-Bw-Method", "expense.fileUpload");
var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());expense.fileUpload (link)
# Get your API credentials from your billware customer area
API_APPID="your-app-id"
API_SECRET="your-api-secret"
PAYLOAD='{"expense_ident":"0nzgcohs25s4y7zv","file_url":"https://www.example.com/rechnungen/RE-2026-0815.pdf"}'
# The HMAC is calculated over the exact request body that is sent
HMAC=$(printf '%s' "$PAYLOAD" | openssl dgst -sha256 -hmac "$API_SECRET" -binary | base64)
curl -X POST "https://www.billware.de/api/v1" \
-H "X-Bw-Hmac: $API_APPID:$HMAC" \
-H "X-Bw-Method: expense.fileUpload" \
-H "Content-Type: application/json" \
-d "$PAYLOAD"<?php
// Get your API credentials from your billware customer area
$apiAppId = 'your-app-id';
$apiSecret = 'your-api-secret';
$payload = json_encode([
'expense_ident' => '0nzgcohs25s4y7zv',
'file_url' => 'https://www.example.com/rechnungen/RE-2026-0815.pdf',
]);
// The HMAC is calculated over the exact request body that is sent
$hmac = base64_encode(hash_hmac('sha256', $payload, $apiSecret, true));
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => 'https://www.billware.de/api/v1',
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => $payload,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'X-Bw-Hmac: '.$apiAppId.':'.$hmac,
'X-Bw-Method: expense.fileUpload',
'Content-Type: application/json',
],
]);
$response = curl_exec($curl);
curl_close($curl);
print_r(json_decode($response, true));import crypto from 'node:crypto';
// Get your API credentials from your billware customer area
const apiAppId = 'your-app-id';
const apiSecret = 'your-api-secret';
const payload = JSON.stringify({
"expense_ident": "0nzgcohs25s4y7zv",
"file_url": "https://www.example.com/rechnungen/RE-2026-0815.pdf"
});
// The HMAC is calculated over the exact request body that is sent
const hmac = crypto.createHmac('sha256', apiSecret).update(payload).digest('base64');
const response = await fetch('https://www.billware.de/api/v1', {
method: 'POST',
headers: {
'X-Bw-Hmac': `${apiAppId}:${hmac}`,
'X-Bw-Method': 'expense.fileUpload',
'Content-Type': 'application/json'
},
body: payload
});
console.log(await response.json());import base64
import hashlib
import hmac
import json
import requests
# Get your API credentials from your billware customer area
api_appid = "your-app-id"
api_secret = "your-api-secret"
payload = json.dumps({
"expense_ident": "0nzgcohs25s4y7zv",
"file_url": "https://www.example.com/rechnungen/RE-2026-0815.pdf",
})
# The HMAC is calculated over the exact request body that is sent
signature = base64.b64encode(
hmac.new(api_secret.encode(), payload.encode(), hashlib.sha256).digest()
).decode()
response = requests.post(
"https://www.billware.de/api/v1",
data=payload,
headers={
"X-Bw-Hmac": f"{api_appid}:{signature}",
"X-Bw-Method": "expense.fileUpload",
"Content-Type": "application/json",
},
)
print(response.json())using System.Net.Http;
using System.Security.Cryptography;
using System.Text;
using System.Text.Json;
// Get your API credentials from your billware customer area
const string apiAppId = "your-app-id";
const string apiSecret = "your-api-secret";
var payload = JsonSerializer.Serialize(new
{
expense_ident = "0nzgcohs25s4y7zv",
file_url = "https://www.example.com/rechnungen/RE-2026-0815.pdf"
});
// The HMAC is calculated over the exact request body that is sent
using var hmac = new HMACSHA256(Encoding.UTF8.GetBytes(apiSecret));
var signature = Convert.ToBase64String(hmac.ComputeHash(Encoding.UTF8.GetBytes(payload)));
using var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "https://www.billware.de/api/v1")
{
Content = new StringContent(payload, Encoding.UTF8, "application/json")
};
request.Headers.Add("X-Bw-Hmac", $"{apiAppId}:{signature}");
request.Headers.Add("X-Bw-Method", "expense.fileUpload");
var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());Return Values
| Fields | Description |
|---|---|
| href | Link to download the file. It works without a login, so pass it on to authorised people only. |
| file_ident | Ident of the file |
| parent_ident | Ident of the record the file belongs to |
| file_user_name | The file name as you sent it |
| file_name | The name billware stores the file under |
| file_extension | Ending of the file, e.g. pdf |
| reference_nr | Number of the record the file belongs to, as it was at the upload |
| date_updated | Time of the upload in server time (UTC) |
Example Responses
// SUCCESS
{
"response": true,
"data": {
"href": "https://www.billware.de/file?t=...",
"file_ident": "71ahxmkcu6ockdzd",
"controller": "expense",
"parent_ident": "0nzgcohs25s4y7zv",
"file_name": "file_8ebbc5cc9f30521b4fcb3d259befdb66985c146e.pdf",
"file_user_name": "Rechnung RE-2026-0815.pdf",
"file_type": "user",
"file_extension": "pdf",
"reference_nr": "AG-0001",
"date_updated": "2026-11-16 10:30:10",
"date_updated_user": "16.11.2026"
},
"message": "File uploaded"
}
// ERROR
{
"response": false,
"data": null,
"message": "Only PDF, XML, JPG, PNG and TXT files are accepted"
}
expense.fileDelete
Delete the receipt of an expense.Data
| Fields | Description | Accepted Types |
|---|---|---|
| expense_ident Required | Ident of the expense | String |
| file_ident | Ident of the receipt. It is not needed because an expense has one receipt only. If you send it, it has to be the one of this receipt. | String |
Code Examples
# Get your API credentials from your billware customer area
API_APPID="your-app-id"
API_SECRET="your-api-secret"
PAYLOAD='{"expense_ident":"0nzgcohs25s4y7zv"}'
# The HMAC is calculated over the exact request body that is sent
HMAC=$(printf '%s' "$PAYLOAD" | openssl dgst -sha256 -hmac "$API_SECRET" -binary | base64)
curl -X POST "https://www.billware.de/api/v1" \
-H "X-Bw-Hmac: $API_APPID:$HMAC" \
-H "X-Bw-Method: expense.fileDelete" \
-H "Content-Type: application/json" \
-d "$PAYLOAD"<?php
// Get your API credentials from your billware customer area
$apiAppId = 'your-app-id';
$apiSecret = 'your-api-secret';
$payload = json_encode([
'expense_ident' => '0nzgcohs25s4y7zv',
]);
// The HMAC is calculated over the exact request body that is sent
$hmac = base64_encode(hash_hmac('sha256', $payload, $apiSecret, true));
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => 'https://www.billware.de/api/v1',
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => $payload,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'X-Bw-Hmac: '.$apiAppId.':'.$hmac,
'X-Bw-Method: expense.fileDelete',
'Content-Type: application/json',
],
]);
$response = curl_exec($curl);
curl_close($curl);
print_r(json_decode($response, true));import crypto from 'node:crypto';
// Get your API credentials from your billware customer area
const apiAppId = 'your-app-id';
const apiSecret = 'your-api-secret';
const payload = JSON.stringify({
"expense_ident": "0nzgcohs25s4y7zv"
});
// The HMAC is calculated over the exact request body that is sent
const hmac = crypto.createHmac('sha256', apiSecret).update(payload).digest('base64');
const response = await fetch('https://www.billware.de/api/v1', {
method: 'POST',
headers: {
'X-Bw-Hmac': `${apiAppId}:${hmac}`,
'X-Bw-Method': 'expense.fileDelete',
'Content-Type': 'application/json'
},
body: payload
});
console.log(await response.json());import base64
import hashlib
import hmac
import json
import requests
# Get your API credentials from your billware customer area
api_appid = "your-app-id"
api_secret = "your-api-secret"
payload = json.dumps({
"expense_ident": "0nzgcohs25s4y7zv",
})
# The HMAC is calculated over the exact request body that is sent
signature = base64.b64encode(
hmac.new(api_secret.encode(), payload.encode(), hashlib.sha256).digest()
).decode()
response = requests.post(
"https://www.billware.de/api/v1",
data=payload,
headers={
"X-Bw-Hmac": f"{api_appid}:{signature}",
"X-Bw-Method": "expense.fileDelete",
"Content-Type": "application/json",
},
)
print(response.json())using System.Net.Http;
using System.Security.Cryptography;
using System.Text;
using System.Text.Json;
// Get your API credentials from your billware customer area
const string apiAppId = "your-app-id";
const string apiSecret = "your-api-secret";
var payload = JsonSerializer.Serialize(new
{
expense_ident = "0nzgcohs25s4y7zv"
});
// The HMAC is calculated over the exact request body that is sent
using var hmac = new HMACSHA256(Encoding.UTF8.GetBytes(apiSecret));
var signature = Convert.ToBase64String(hmac.ComputeHash(Encoding.UTF8.GetBytes(payload)));
using var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "https://www.billware.de/api/v1")
{
Content = new StringContent(payload, Encoding.UTF8, "application/json")
};
request.Headers.Add("X-Bw-Hmac", $"{apiAppId}:{signature}");
request.Headers.Add("X-Bw-Method", "expense.fileDelete");
var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());Return Values
The answer holds the expense as it is now, with the same structure as expense.read; file is null then.
Example Responses
// SUCCESS
{
"response": true,
"data": {
"expense_ident": "0nzgcohs25s4y7zv",
"file": null,
...
},
"message": "File deleted"
}
// ERROR
{
"response": false,
"data": null,
"message": "File not found"
}
Categories
The categories are the same for every account. A category sorts the expense into your reports, for example into the cash-basis accounting. For the write-off categories (AfA) write_off_years counts as well.
| expense_category_ident | Category | Group | Write-off (AfA) |
|---|---|---|---|
1541Va0E606695KI |
External services | No | |
15KVm4d10x066E95 |
Material costs | No | |
462Y50pC8d5231za |
Commuting allowance | Car and travel expenses | No |
6j16402367X3x80P |
Leasing costs | Car and travel expenses | No |
6rq16n6780YZ30j8 |
Other travel costs | Car and travel expenses | No |
462H50852JG33i1m |
Repair and maintenance | Car and travel expenses | No |
61640KQa26X7X8S0 |
Taxes, insurances and car tolls | Car and travel expenses | No |
61666780M3308H46 |
Travel costs for external vehicles | Car and travel expenses | No |
15416zH950Qmk7l7 |
Travel costs home-workplace | Car and travel expenses | No |
30QX8201yk332T90 |
Personal drawings | Drawings | No |
4623p0200X85v20R |
Accommodation and extra travel costs - Entrepreneur | Fully deductible expenses | No |
616h4026j7810yA8 |
Account management charges | Fully deductible expenses | No |
4w6Yr238020C085Q |
Advertising costs | Fully deductible expenses | No |
30U8j33a90154Wwu |
Continued education costs | Fully deductible expenses | No |
pfysr7ryoq6j90nv |
Costs for packaging and transport | Fully deductible expenses | No |
1L541e6b9q50L7k7 |
Dues | Fully deductible expenses | No |
jj7mduecx9okfsot |
EDP-expenses (consulting, repairs) | Fully deductible expenses | No |
bjn4bnjh9h90fxcb |
Import Sales Tax | Fully deductible expenses | No |
13a5pm541006F695 |
Insurances | Fully deductible expenses | No |
46Bx2U5085N23I1U |
Interest on debt for financing | Fully deductible expenses | No |
462wx5cF0985231B |
Leasing | Fully deductible expenses | No |
15P43tk169C5k077 |
legal, tax advice and accounting costs | Fully deductible expenses | No |
306820h1R33790Ap |
Office equipment | Fully deductible expenses | No |
6164q0P2F678aDY0 |
Other Expenses (fully deductible) | Fully deductible expenses | No |
30833V901Ca5vYE4 |
Other interest on debt | Fully deductible expenses | No |
616678G7aeDn0308 |
Paid Input Tax | Fully deductible expenses | No |
3w50v8l339IF0154 |
Paid VAT | Fully deductible expenses | No |
15n4XP1m0066Tt95 |
Soft- and hardware | Fully deductible expenses | No |
6N16FC5640267w80 |
Telephone and internet | Fully deductible expenses | No |
9y3kp4yx4ay4ythj |
Work equipment (office, postage) | Fully deductible expenses | No |
15Yw4xs169m5077H |
Business Tax | Partly Deductible | No |
6n16yxc40L26l780 |
Entertainment expenses | Partly Deductible | No |
6166h7482030J8eD |
Gifts | Partly Deductible | No |
154M1u6E92Rn5077 |
Home Office | Partly Deductible | No |
43625Y23071G43d2 |
Other Expenses (partly deductible) | Partly Deductible | No |
4A6f27E5V0852V31 |
Per diems | Partly Deductible | No |
46230n2s00cLl854 |
Accounts paypable | Paypables and Receivables | No |
308RVgJ2015339f0 |
Accounts receivable | Paypables and Receivables | No |
46250Ac85k231QQi |
Payroll and church taxes | Personnel Expenses | No |
61u6E4702n66u780 |
Salaries | Personnel Expenses | No |
15ta41x006CJ695H |
Social insurances | Personnel Expenses | No |
1p5d4t21S00669Q5 |
Travel Costs Employees | Personnel Expenses | No |
1Dp54X169505n77t |
Expenditures for double housekeeping | Premises Expenses | No |
30n8Ab20Hn1339i0 |
Rent | Premises Expenses | No |
1D541p0063698ak5 |
Service charges | Premises Expenses | No |
vod9ym8whckeibhp |
AfA for immovable assets | Write-off for wear and tear (AfA) | Yes |
x17t13u5ztopaf1u |
AfA for intangible assets | Write-off for wear and tear (AfA) | Yes |
xbsyq14mv2vj1y2e |
AfA for low-value assets | Write-off for wear and tear (AfA) | No |
3kkqyys4uag4kg8p |
AfA for office equipment (movable assets) | Write-off for wear and tear (AfA) | Yes |
thnjv54nvgomnvv3 |
AfA for vehicles (movable assets) | Write-off for wear and tear (AfA) | Yes |