cURL
curl --request PUT \
--url https://api.maesn.dev/accounting/bookingProposals/{bookingProposalId}/async \
--header 'Content-Type: multipart/form-data' \
--header 'X-ACCOUNT-KEY: <x-account-key>' \
--header 'X-API-KEY: <x-api-key>' \
--form 'bookingProposal={
"id": "23a24449-6v28-446e-bb12-3f428073fc",
"addresses ": [
{
"city": "city"
}
],
"bankAccount": {
"id": "5a6b7f5dw45c1c-403e-ad56-202fbc312414",
"bankName": "Sparkasse",
"bic": "DEUTDEFF",
"code": "50010517",
"iban": "DE89370400440532013000",
"number": 5407324931
},
"bookingProposalDate": "2025-07-14T00:00:00Z",
"contact": {
"id": "eaa28f49-6028-4b6e-bb12-d8f6278073fc",
"accountNumber": 70000,
"name": "John Doe"
},
"currency": "EUR",
"deliveryDate": "2025-07-26T00:00:00Z",
"discountPaymentDate": "2025-07-16T00:00:00Z",
"discountPaymentDate2": "2025-07-18T00:00:00Z",
"dueDate": "2025-07-24T00:00:00Z",
"generatorName": "Maesn GmbH",
"journalCode": "60",
"isPaymentOrder": "true",
"ledgerName": "Eingangsrechnungen",
"lineItems": [
{
"id": "Item-112233",
"account": {
"id": "db32-4f56-8a9b-1234567890ab",
"code": "200",
"name": "EXPENSE",
"number": 4900
},
"description": "Item A",
"dimensions": [
{
"id": "eaa28f49-6028-4b6e-bb12-d8f6278073fc",
"code": "CS1",
"dimension": "CostCenter",
"name": "Jerde, Greenfelder and Jacobi"
}
],
"discountAmount": 100,
"discountAmount2": 50,
"discountPercentage": 20,
"discountPercentage2": 10,
"taxCode": "9",
"taxRatePercentage": 19,
"totalGrossAmount": 500,
"totalNetAmount": 450,
"type": "SERVICE"
}
],
"notes": "Bill for maintenance services",
"number": "1233330",
"orderId": "3344566",
"paidDate": "2025-07-20T00:00:00Z",
"paymentTermId": "03",
"status": "DRAFT",
"totalGrossAmount": 500,
"useCollectiveContact": true,
"vatId": "DE987654321"
}' \
--form files=@example-fileimport requests
url = "https://api.maesn.dev/accounting/bookingProposals/{bookingProposalId}/async"
files = { "files": ("example-file", open("example-file", "rb")) }
payload = { "bookingProposal": "{
\"id\": \"23a24449-6v28-446e-bb12-3f428073fc\",
\"addresses \": [
{
\"city\": \"city\"
}
],
\"bankAccount\": {
\"id\": \"5a6b7f5dw45c1c-403e-ad56-202fbc312414\",
\"bankName\": \"Sparkasse\",
\"bic\": \"DEUTDEFF\",
\"code\": \"50010517\",
\"iban\": \"DE89370400440532013000\",
\"number\": 5407324931
},
\"bookingProposalDate\": \"2025-07-14T00:00:00Z\",
\"contact\": {
\"id\": \"eaa28f49-6028-4b6e-bb12-d8f6278073fc\",
\"accountNumber\": 70000,
\"name\": \"John Doe\"
},
\"currency\": \"EUR\",
\"deliveryDate\": \"2025-07-26T00:00:00Z\",
\"discountPaymentDate\": \"2025-07-16T00:00:00Z\",
\"discountPaymentDate2\": \"2025-07-18T00:00:00Z\",
\"dueDate\": \"2025-07-24T00:00:00Z\",
\"generatorName\": \"Maesn GmbH\",
\"journalCode\": \"60\",
\"isPaymentOrder\": \"true\",
\"ledgerName\": \"Eingangsrechnungen\",
\"lineItems\": [
{
\"id\": \"Item-112233\",
\"account\": {
\"id\": \"db32-4f56-8a9b-1234567890ab\",
\"code\": \"200\",
\"name\": \"EXPENSE\",
\"number\": 4900
},
\"description\": \"Item A\",
\"dimensions\": [
{
\"id\": \"eaa28f49-6028-4b6e-bb12-d8f6278073fc\",
\"code\": \"CS1\",
\"dimension\": \"CostCenter\",
\"name\": \"Jerde, Greenfelder and Jacobi\"
}
],
\"discountAmount\": 100,
\"discountAmount2\": 50,
\"discountPercentage\": 20,
\"discountPercentage2\": 10,
\"taxCode\": \"9\",
\"taxRatePercentage\": 19,
\"totalGrossAmount\": 500,
\"totalNetAmount\": 450,
\"type\": \"SERVICE\"
}
],
\"notes\": \"Bill for maintenance services\",
\"number\": \"1233330\",
\"orderId\": \"3344566\",
\"paidDate\": \"2025-07-20T00:00:00Z\",
\"paymentTermId\": \"03\",
\"status\": \"DRAFT\",
\"totalGrossAmount\": 500,
\"useCollectiveContact\": true,
\"vatId\": \"DE987654321\"
}" }
headers = {
"X-API-KEY": "<x-api-key>",
"X-ACCOUNT-KEY": "<x-account-key>"
}
response = requests.put(url, data=payload, files=files, headers=headers)
print(response.text)const form = new FormData();
form.append('bookingProposal', '{
"id": "23a24449-6v28-446e-bb12-3f428073fc",
"addresses ": [
{
"city": "city"
}
],
"bankAccount": {
"id": "5a6b7f5dw45c1c-403e-ad56-202fbc312414",
"bankName": "Sparkasse",
"bic": "DEUTDEFF",
"code": "50010517",
"iban": "DE89370400440532013000",
"number": 5407324931
},
"bookingProposalDate": "2025-07-14T00:00:00Z",
"contact": {
"id": "eaa28f49-6028-4b6e-bb12-d8f6278073fc",
"accountNumber": 70000,
"name": "John Doe"
},
"currency": "EUR",
"deliveryDate": "2025-07-26T00:00:00Z",
"discountPaymentDate": "2025-07-16T00:00:00Z",
"discountPaymentDate2": "2025-07-18T00:00:00Z",
"dueDate": "2025-07-24T00:00:00Z",
"generatorName": "Maesn GmbH",
"journalCode": "60",
"isPaymentOrder": "true",
"ledgerName": "Eingangsrechnungen",
"lineItems": [
{
"id": "Item-112233",
"account": {
"id": "db32-4f56-8a9b-1234567890ab",
"code": "200",
"name": "EXPENSE",
"number": 4900
},
"description": "Item A",
"dimensions": [
{
"id": "eaa28f49-6028-4b6e-bb12-d8f6278073fc",
"code": "CS1",
"dimension": "CostCenter",
"name": "Jerde, Greenfelder and Jacobi"
}
],
"discountAmount": 100,
"discountAmount2": 50,
"discountPercentage": 20,
"discountPercentage2": 10,
"taxCode": "9",
"taxRatePercentage": 19,
"totalGrossAmount": 500,
"totalNetAmount": 450,
"type": "SERVICE"
}
],
"notes": "Bill for maintenance services",
"number": "1233330",
"orderId": "3344566",
"paidDate": "2025-07-20T00:00:00Z",
"paymentTermId": "03",
"status": "DRAFT",
"totalGrossAmount": 500,
"useCollectiveContact": true,
"vatId": "DE987654321"
}');
form.append('files', '<string>');
const options = {
method: 'PUT',
headers: {'X-API-KEY': '<x-api-key>', 'X-ACCOUNT-KEY': '<x-account-key>'}
};
options.body = form;
fetch('https://api.maesn.dev/accounting/bookingProposals/{bookingProposalId}/async', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.maesn.dev/accounting/bookingProposals/{bookingProposalId}/async",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"bookingProposal\"\r\n\r\n{\r\n \"id\": \"23a24449-6v28-446e-bb12-3f428073fc\",\r\n \"addresses \": [\r\n {\r\n \"city\": \"city\"\r\n }\r\n ],\r\n \"bankAccount\": {\r\n \"id\": \"5a6b7f5dw45c1c-403e-ad56-202fbc312414\",\r\n \"bankName\": \"Sparkasse\",\r\n \"bic\": \"DEUTDEFF\",\r\n \"code\": \"50010517\",\r\n \"iban\": \"DE89370400440532013000\",\r\n \"number\": 5407324931\r\n },\r\n \"bookingProposalDate\": \"2025-07-14T00:00:00Z\",\r\n \"contact\": {\r\n \"id\": \"eaa28f49-6028-4b6e-bb12-d8f6278073fc\",\r\n \"accountNumber\": 70000,\r\n \"name\": \"John Doe\"\r\n },\r\n \"currency\": \"EUR\",\r\n \"deliveryDate\": \"2025-07-26T00:00:00Z\",\r\n \"discountPaymentDate\": \"2025-07-16T00:00:00Z\",\r\n \"discountPaymentDate2\": \"2025-07-18T00:00:00Z\",\r\n \"dueDate\": \"2025-07-24T00:00:00Z\",\r\n \"generatorName\": \"Maesn GmbH\",\r\n \"journalCode\": \"60\",\r\n \"isPaymentOrder\": \"true\",\r\n \"ledgerName\": \"Eingangsrechnungen\",\r\n \"lineItems\": [\r\n {\r\n \"id\": \"Item-112233\",\r\n \"account\": {\r\n \"id\": \"db32-4f56-8a9b-1234567890ab\",\r\n \"code\": \"200\",\r\n \"name\": \"EXPENSE\",\r\n \"number\": 4900\r\n },\r\n \"description\": \"Item A\",\r\n \"dimensions\": [\r\n {\r\n \"id\": \"eaa28f49-6028-4b6e-bb12-d8f6278073fc\",\r\n \"code\": \"CS1\",\r\n \"dimension\": \"CostCenter\",\r\n \"name\": \"Jerde, Greenfelder and Jacobi\"\r\n }\r\n ],\r\n \"discountAmount\": 100,\r\n \"discountAmount2\": 50,\r\n \"discountPercentage\": 20,\r\n \"discountPercentage2\": 10,\r\n \"taxCode\": \"9\",\r\n \"taxRatePercentage\": 19,\r\n \"totalGrossAmount\": 500,\r\n \"totalNetAmount\": 450,\r\n \"type\": \"SERVICE\"\r\n }\r\n ],\r\n \"notes\": \"Bill for maintenance services\",\r\n \"number\": \"1233330\",\r\n \"orderId\": \"3344566\",\r\n \"paidDate\": \"2025-07-20T00:00:00Z\",\r\n \"paymentTermId\": \"03\",\r\n \"status\": \"DRAFT\",\r\n \"totalGrossAmount\": 500,\r\n \"useCollectiveContact\": true,\r\n \"vatId\": \"DE987654321\"\r\n}\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"files\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001--",
CURLOPT_HTTPHEADER => [
"Content-Type: multipart/form-data",
"X-ACCOUNT-KEY: <x-account-key>",
"X-API-KEY: <x-api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.maesn.dev/accounting/bookingProposals/{bookingProposalId}/async"
payload := strings.NewReader("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"bookingProposal\"\r\n\r\n{\r\n \"id\": \"23a24449-6v28-446e-bb12-3f428073fc\",\r\n \"addresses \": [\r\n {\r\n \"city\": \"city\"\r\n }\r\n ],\r\n \"bankAccount\": {\r\n \"id\": \"5a6b7f5dw45c1c-403e-ad56-202fbc312414\",\r\n \"bankName\": \"Sparkasse\",\r\n \"bic\": \"DEUTDEFF\",\r\n \"code\": \"50010517\",\r\n \"iban\": \"DE89370400440532013000\",\r\n \"number\": 5407324931\r\n },\r\n \"bookingProposalDate\": \"2025-07-14T00:00:00Z\",\r\n \"contact\": {\r\n \"id\": \"eaa28f49-6028-4b6e-bb12-d8f6278073fc\",\r\n \"accountNumber\": 70000,\r\n \"name\": \"John Doe\"\r\n },\r\n \"currency\": \"EUR\",\r\n \"deliveryDate\": \"2025-07-26T00:00:00Z\",\r\n \"discountPaymentDate\": \"2025-07-16T00:00:00Z\",\r\n \"discountPaymentDate2\": \"2025-07-18T00:00:00Z\",\r\n \"dueDate\": \"2025-07-24T00:00:00Z\",\r\n \"generatorName\": \"Maesn GmbH\",\r\n \"journalCode\": \"60\",\r\n \"isPaymentOrder\": \"true\",\r\n \"ledgerName\": \"Eingangsrechnungen\",\r\n \"lineItems\": [\r\n {\r\n \"id\": \"Item-112233\",\r\n \"account\": {\r\n \"id\": \"db32-4f56-8a9b-1234567890ab\",\r\n \"code\": \"200\",\r\n \"name\": \"EXPENSE\",\r\n \"number\": 4900\r\n },\r\n \"description\": \"Item A\",\r\n \"dimensions\": [\r\n {\r\n \"id\": \"eaa28f49-6028-4b6e-bb12-d8f6278073fc\",\r\n \"code\": \"CS1\",\r\n \"dimension\": \"CostCenter\",\r\n \"name\": \"Jerde, Greenfelder and Jacobi\"\r\n }\r\n ],\r\n \"discountAmount\": 100,\r\n \"discountAmount2\": 50,\r\n \"discountPercentage\": 20,\r\n \"discountPercentage2\": 10,\r\n \"taxCode\": \"9\",\r\n \"taxRatePercentage\": 19,\r\n \"totalGrossAmount\": 500,\r\n \"totalNetAmount\": 450,\r\n \"type\": \"SERVICE\"\r\n }\r\n ],\r\n \"notes\": \"Bill for maintenance services\",\r\n \"number\": \"1233330\",\r\n \"orderId\": \"3344566\",\r\n \"paidDate\": \"2025-07-20T00:00:00Z\",\r\n \"paymentTermId\": \"03\",\r\n \"status\": \"DRAFT\",\r\n \"totalGrossAmount\": 500,\r\n \"useCollectiveContact\": true,\r\n \"vatId\": \"DE987654321\"\r\n}\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"files\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001--")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("X-API-KEY", "<x-api-key>")
req.Header.Add("X-ACCOUNT-KEY", "<x-account-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.put("https://api.maesn.dev/accounting/bookingProposals/{bookingProposalId}/async")
.header("X-API-KEY", "<x-api-key>")
.header("X-ACCOUNT-KEY", "<x-account-key>")
.body("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"bookingProposal\"\r\n\r\n{\r\n \"id\": \"23a24449-6v28-446e-bb12-3f428073fc\",\r\n \"addresses \": [\r\n {\r\n \"city\": \"city\"\r\n }\r\n ],\r\n \"bankAccount\": {\r\n \"id\": \"5a6b7f5dw45c1c-403e-ad56-202fbc312414\",\r\n \"bankName\": \"Sparkasse\",\r\n \"bic\": \"DEUTDEFF\",\r\n \"code\": \"50010517\",\r\n \"iban\": \"DE89370400440532013000\",\r\n \"number\": 5407324931\r\n },\r\n \"bookingProposalDate\": \"2025-07-14T00:00:00Z\",\r\n \"contact\": {\r\n \"id\": \"eaa28f49-6028-4b6e-bb12-d8f6278073fc\",\r\n \"accountNumber\": 70000,\r\n \"name\": \"John Doe\"\r\n },\r\n \"currency\": \"EUR\",\r\n \"deliveryDate\": \"2025-07-26T00:00:00Z\",\r\n \"discountPaymentDate\": \"2025-07-16T00:00:00Z\",\r\n \"discountPaymentDate2\": \"2025-07-18T00:00:00Z\",\r\n \"dueDate\": \"2025-07-24T00:00:00Z\",\r\n \"generatorName\": \"Maesn GmbH\",\r\n \"journalCode\": \"60\",\r\n \"isPaymentOrder\": \"true\",\r\n \"ledgerName\": \"Eingangsrechnungen\",\r\n \"lineItems\": [\r\n {\r\n \"id\": \"Item-112233\",\r\n \"account\": {\r\n \"id\": \"db32-4f56-8a9b-1234567890ab\",\r\n \"code\": \"200\",\r\n \"name\": \"EXPENSE\",\r\n \"number\": 4900\r\n },\r\n \"description\": \"Item A\",\r\n \"dimensions\": [\r\n {\r\n \"id\": \"eaa28f49-6028-4b6e-bb12-d8f6278073fc\",\r\n \"code\": \"CS1\",\r\n \"dimension\": \"CostCenter\",\r\n \"name\": \"Jerde, Greenfelder and Jacobi\"\r\n }\r\n ],\r\n \"discountAmount\": 100,\r\n \"discountAmount2\": 50,\r\n \"discountPercentage\": 20,\r\n \"discountPercentage2\": 10,\r\n \"taxCode\": \"9\",\r\n \"taxRatePercentage\": 19,\r\n \"totalGrossAmount\": 500,\r\n \"totalNetAmount\": 450,\r\n \"type\": \"SERVICE\"\r\n }\r\n ],\r\n \"notes\": \"Bill for maintenance services\",\r\n \"number\": \"1233330\",\r\n \"orderId\": \"3344566\",\r\n \"paidDate\": \"2025-07-20T00:00:00Z\",\r\n \"paymentTermId\": \"03\",\r\n \"status\": \"DRAFT\",\r\n \"totalGrossAmount\": 500,\r\n \"useCollectiveContact\": true,\r\n \"vatId\": \"DE987654321\"\r\n}\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"files\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001--")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.maesn.dev/accounting/bookingProposals/{bookingProposalId}/async")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["X-API-KEY"] = '<x-api-key>'
request["X-ACCOUNT-KEY"] = '<x-account-key>'
request.body = "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"bookingProposal\"\r\n\r\n{\r\n \"id\": \"23a24449-6v28-446e-bb12-3f428073fc\",\r\n \"addresses \": [\r\n {\r\n \"city\": \"city\"\r\n }\r\n ],\r\n \"bankAccount\": {\r\n \"id\": \"5a6b7f5dw45c1c-403e-ad56-202fbc312414\",\r\n \"bankName\": \"Sparkasse\",\r\n \"bic\": \"DEUTDEFF\",\r\n \"code\": \"50010517\",\r\n \"iban\": \"DE89370400440532013000\",\r\n \"number\": 5407324931\r\n },\r\n \"bookingProposalDate\": \"2025-07-14T00:00:00Z\",\r\n \"contact\": {\r\n \"id\": \"eaa28f49-6028-4b6e-bb12-d8f6278073fc\",\r\n \"accountNumber\": 70000,\r\n \"name\": \"John Doe\"\r\n },\r\n \"currency\": \"EUR\",\r\n \"deliveryDate\": \"2025-07-26T00:00:00Z\",\r\n \"discountPaymentDate\": \"2025-07-16T00:00:00Z\",\r\n \"discountPaymentDate2\": \"2025-07-18T00:00:00Z\",\r\n \"dueDate\": \"2025-07-24T00:00:00Z\",\r\n \"generatorName\": \"Maesn GmbH\",\r\n \"journalCode\": \"60\",\r\n \"isPaymentOrder\": \"true\",\r\n \"ledgerName\": \"Eingangsrechnungen\",\r\n \"lineItems\": [\r\n {\r\n \"id\": \"Item-112233\",\r\n \"account\": {\r\n \"id\": \"db32-4f56-8a9b-1234567890ab\",\r\n \"code\": \"200\",\r\n \"name\": \"EXPENSE\",\r\n \"number\": 4900\r\n },\r\n \"description\": \"Item A\",\r\n \"dimensions\": [\r\n {\r\n \"id\": \"eaa28f49-6028-4b6e-bb12-d8f6278073fc\",\r\n \"code\": \"CS1\",\r\n \"dimension\": \"CostCenter\",\r\n \"name\": \"Jerde, Greenfelder and Jacobi\"\r\n }\r\n ],\r\n \"discountAmount\": 100,\r\n \"discountAmount2\": 50,\r\n \"discountPercentage\": 20,\r\n \"discountPercentage2\": 10,\r\n \"taxCode\": \"9\",\r\n \"taxRatePercentage\": 19,\r\n \"totalGrossAmount\": 500,\r\n \"totalNetAmount\": 450,\r\n \"type\": \"SERVICE\"\r\n }\r\n ],\r\n \"notes\": \"Bill for maintenance services\",\r\n \"number\": \"1233330\",\r\n \"orderId\": \"3344566\",\r\n \"paidDate\": \"2025-07-20T00:00:00Z\",\r\n \"paymentTermId\": \"03\",\r\n \"status\": \"DRAFT\",\r\n \"totalGrossAmount\": 500,\r\n \"useCollectiveContact\": true,\r\n \"vatId\": \"DE987654321\"\r\n}\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"files\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001--"
response = http.request(request)
puts response.read_body{
"meta": {
"warnings": [
"Field not used by target system"
],
"pagination": {
"total": 125,
"perPage": 50,
"currentPage": 1,
"totalPages": 3
},
"partialErrors": [
{
"code": "FILE_UPLOAD_FAILED",
"message": "Attachment invoice.pdf could not be uploaded to the target system."
}
]
},
"data": {
"taskId": "02cc5849-b23c-48fe-8a9b-96f74bfc9571"
}
}Booking Proposals
Update booking proposal async
PUT
/
accounting
/
bookingProposals
/
{bookingProposalId}
/
async
cURL
curl --request PUT \
--url https://api.maesn.dev/accounting/bookingProposals/{bookingProposalId}/async \
--header 'Content-Type: multipart/form-data' \
--header 'X-ACCOUNT-KEY: <x-account-key>' \
--header 'X-API-KEY: <x-api-key>' \
--form 'bookingProposal={
"id": "23a24449-6v28-446e-bb12-3f428073fc",
"addresses ": [
{
"city": "city"
}
],
"bankAccount": {
"id": "5a6b7f5dw45c1c-403e-ad56-202fbc312414",
"bankName": "Sparkasse",
"bic": "DEUTDEFF",
"code": "50010517",
"iban": "DE89370400440532013000",
"number": 5407324931
},
"bookingProposalDate": "2025-07-14T00:00:00Z",
"contact": {
"id": "eaa28f49-6028-4b6e-bb12-d8f6278073fc",
"accountNumber": 70000,
"name": "John Doe"
},
"currency": "EUR",
"deliveryDate": "2025-07-26T00:00:00Z",
"discountPaymentDate": "2025-07-16T00:00:00Z",
"discountPaymentDate2": "2025-07-18T00:00:00Z",
"dueDate": "2025-07-24T00:00:00Z",
"generatorName": "Maesn GmbH",
"journalCode": "60",
"isPaymentOrder": "true",
"ledgerName": "Eingangsrechnungen",
"lineItems": [
{
"id": "Item-112233",
"account": {
"id": "db32-4f56-8a9b-1234567890ab",
"code": "200",
"name": "EXPENSE",
"number": 4900
},
"description": "Item A",
"dimensions": [
{
"id": "eaa28f49-6028-4b6e-bb12-d8f6278073fc",
"code": "CS1",
"dimension": "CostCenter",
"name": "Jerde, Greenfelder and Jacobi"
}
],
"discountAmount": 100,
"discountAmount2": 50,
"discountPercentage": 20,
"discountPercentage2": 10,
"taxCode": "9",
"taxRatePercentage": 19,
"totalGrossAmount": 500,
"totalNetAmount": 450,
"type": "SERVICE"
}
],
"notes": "Bill for maintenance services",
"number": "1233330",
"orderId": "3344566",
"paidDate": "2025-07-20T00:00:00Z",
"paymentTermId": "03",
"status": "DRAFT",
"totalGrossAmount": 500,
"useCollectiveContact": true,
"vatId": "DE987654321"
}' \
--form files=@example-fileimport requests
url = "https://api.maesn.dev/accounting/bookingProposals/{bookingProposalId}/async"
files = { "files": ("example-file", open("example-file", "rb")) }
payload = { "bookingProposal": "{
\"id\": \"23a24449-6v28-446e-bb12-3f428073fc\",
\"addresses \": [
{
\"city\": \"city\"
}
],
\"bankAccount\": {
\"id\": \"5a6b7f5dw45c1c-403e-ad56-202fbc312414\",
\"bankName\": \"Sparkasse\",
\"bic\": \"DEUTDEFF\",
\"code\": \"50010517\",
\"iban\": \"DE89370400440532013000\",
\"number\": 5407324931
},
\"bookingProposalDate\": \"2025-07-14T00:00:00Z\",
\"contact\": {
\"id\": \"eaa28f49-6028-4b6e-bb12-d8f6278073fc\",
\"accountNumber\": 70000,
\"name\": \"John Doe\"
},
\"currency\": \"EUR\",
\"deliveryDate\": \"2025-07-26T00:00:00Z\",
\"discountPaymentDate\": \"2025-07-16T00:00:00Z\",
\"discountPaymentDate2\": \"2025-07-18T00:00:00Z\",
\"dueDate\": \"2025-07-24T00:00:00Z\",
\"generatorName\": \"Maesn GmbH\",
\"journalCode\": \"60\",
\"isPaymentOrder\": \"true\",
\"ledgerName\": \"Eingangsrechnungen\",
\"lineItems\": [
{
\"id\": \"Item-112233\",
\"account\": {
\"id\": \"db32-4f56-8a9b-1234567890ab\",
\"code\": \"200\",
\"name\": \"EXPENSE\",
\"number\": 4900
},
\"description\": \"Item A\",
\"dimensions\": [
{
\"id\": \"eaa28f49-6028-4b6e-bb12-d8f6278073fc\",
\"code\": \"CS1\",
\"dimension\": \"CostCenter\",
\"name\": \"Jerde, Greenfelder and Jacobi\"
}
],
\"discountAmount\": 100,
\"discountAmount2\": 50,
\"discountPercentage\": 20,
\"discountPercentage2\": 10,
\"taxCode\": \"9\",
\"taxRatePercentage\": 19,
\"totalGrossAmount\": 500,
\"totalNetAmount\": 450,
\"type\": \"SERVICE\"
}
],
\"notes\": \"Bill for maintenance services\",
\"number\": \"1233330\",
\"orderId\": \"3344566\",
\"paidDate\": \"2025-07-20T00:00:00Z\",
\"paymentTermId\": \"03\",
\"status\": \"DRAFT\",
\"totalGrossAmount\": 500,
\"useCollectiveContact\": true,
\"vatId\": \"DE987654321\"
}" }
headers = {
"X-API-KEY": "<x-api-key>",
"X-ACCOUNT-KEY": "<x-account-key>"
}
response = requests.put(url, data=payload, files=files, headers=headers)
print(response.text)const form = new FormData();
form.append('bookingProposal', '{
"id": "23a24449-6v28-446e-bb12-3f428073fc",
"addresses ": [
{
"city": "city"
}
],
"bankAccount": {
"id": "5a6b7f5dw45c1c-403e-ad56-202fbc312414",
"bankName": "Sparkasse",
"bic": "DEUTDEFF",
"code": "50010517",
"iban": "DE89370400440532013000",
"number": 5407324931
},
"bookingProposalDate": "2025-07-14T00:00:00Z",
"contact": {
"id": "eaa28f49-6028-4b6e-bb12-d8f6278073fc",
"accountNumber": 70000,
"name": "John Doe"
},
"currency": "EUR",
"deliveryDate": "2025-07-26T00:00:00Z",
"discountPaymentDate": "2025-07-16T00:00:00Z",
"discountPaymentDate2": "2025-07-18T00:00:00Z",
"dueDate": "2025-07-24T00:00:00Z",
"generatorName": "Maesn GmbH",
"journalCode": "60",
"isPaymentOrder": "true",
"ledgerName": "Eingangsrechnungen",
"lineItems": [
{
"id": "Item-112233",
"account": {
"id": "db32-4f56-8a9b-1234567890ab",
"code": "200",
"name": "EXPENSE",
"number": 4900
},
"description": "Item A",
"dimensions": [
{
"id": "eaa28f49-6028-4b6e-bb12-d8f6278073fc",
"code": "CS1",
"dimension": "CostCenter",
"name": "Jerde, Greenfelder and Jacobi"
}
],
"discountAmount": 100,
"discountAmount2": 50,
"discountPercentage": 20,
"discountPercentage2": 10,
"taxCode": "9",
"taxRatePercentage": 19,
"totalGrossAmount": 500,
"totalNetAmount": 450,
"type": "SERVICE"
}
],
"notes": "Bill for maintenance services",
"number": "1233330",
"orderId": "3344566",
"paidDate": "2025-07-20T00:00:00Z",
"paymentTermId": "03",
"status": "DRAFT",
"totalGrossAmount": 500,
"useCollectiveContact": true,
"vatId": "DE987654321"
}');
form.append('files', '<string>');
const options = {
method: 'PUT',
headers: {'X-API-KEY': '<x-api-key>', 'X-ACCOUNT-KEY': '<x-account-key>'}
};
options.body = form;
fetch('https://api.maesn.dev/accounting/bookingProposals/{bookingProposalId}/async', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.maesn.dev/accounting/bookingProposals/{bookingProposalId}/async",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"bookingProposal\"\r\n\r\n{\r\n \"id\": \"23a24449-6v28-446e-bb12-3f428073fc\",\r\n \"addresses \": [\r\n {\r\n \"city\": \"city\"\r\n }\r\n ],\r\n \"bankAccount\": {\r\n \"id\": \"5a6b7f5dw45c1c-403e-ad56-202fbc312414\",\r\n \"bankName\": \"Sparkasse\",\r\n \"bic\": \"DEUTDEFF\",\r\n \"code\": \"50010517\",\r\n \"iban\": \"DE89370400440532013000\",\r\n \"number\": 5407324931\r\n },\r\n \"bookingProposalDate\": \"2025-07-14T00:00:00Z\",\r\n \"contact\": {\r\n \"id\": \"eaa28f49-6028-4b6e-bb12-d8f6278073fc\",\r\n \"accountNumber\": 70000,\r\n \"name\": \"John Doe\"\r\n },\r\n \"currency\": \"EUR\",\r\n \"deliveryDate\": \"2025-07-26T00:00:00Z\",\r\n \"discountPaymentDate\": \"2025-07-16T00:00:00Z\",\r\n \"discountPaymentDate2\": \"2025-07-18T00:00:00Z\",\r\n \"dueDate\": \"2025-07-24T00:00:00Z\",\r\n \"generatorName\": \"Maesn GmbH\",\r\n \"journalCode\": \"60\",\r\n \"isPaymentOrder\": \"true\",\r\n \"ledgerName\": \"Eingangsrechnungen\",\r\n \"lineItems\": [\r\n {\r\n \"id\": \"Item-112233\",\r\n \"account\": {\r\n \"id\": \"db32-4f56-8a9b-1234567890ab\",\r\n \"code\": \"200\",\r\n \"name\": \"EXPENSE\",\r\n \"number\": 4900\r\n },\r\n \"description\": \"Item A\",\r\n \"dimensions\": [\r\n {\r\n \"id\": \"eaa28f49-6028-4b6e-bb12-d8f6278073fc\",\r\n \"code\": \"CS1\",\r\n \"dimension\": \"CostCenter\",\r\n \"name\": \"Jerde, Greenfelder and Jacobi\"\r\n }\r\n ],\r\n \"discountAmount\": 100,\r\n \"discountAmount2\": 50,\r\n \"discountPercentage\": 20,\r\n \"discountPercentage2\": 10,\r\n \"taxCode\": \"9\",\r\n \"taxRatePercentage\": 19,\r\n \"totalGrossAmount\": 500,\r\n \"totalNetAmount\": 450,\r\n \"type\": \"SERVICE\"\r\n }\r\n ],\r\n \"notes\": \"Bill for maintenance services\",\r\n \"number\": \"1233330\",\r\n \"orderId\": \"3344566\",\r\n \"paidDate\": \"2025-07-20T00:00:00Z\",\r\n \"paymentTermId\": \"03\",\r\n \"status\": \"DRAFT\",\r\n \"totalGrossAmount\": 500,\r\n \"useCollectiveContact\": true,\r\n \"vatId\": \"DE987654321\"\r\n}\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"files\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001--",
CURLOPT_HTTPHEADER => [
"Content-Type: multipart/form-data",
"X-ACCOUNT-KEY: <x-account-key>",
"X-API-KEY: <x-api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.maesn.dev/accounting/bookingProposals/{bookingProposalId}/async"
payload := strings.NewReader("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"bookingProposal\"\r\n\r\n{\r\n \"id\": \"23a24449-6v28-446e-bb12-3f428073fc\",\r\n \"addresses \": [\r\n {\r\n \"city\": \"city\"\r\n }\r\n ],\r\n \"bankAccount\": {\r\n \"id\": \"5a6b7f5dw45c1c-403e-ad56-202fbc312414\",\r\n \"bankName\": \"Sparkasse\",\r\n \"bic\": \"DEUTDEFF\",\r\n \"code\": \"50010517\",\r\n \"iban\": \"DE89370400440532013000\",\r\n \"number\": 5407324931\r\n },\r\n \"bookingProposalDate\": \"2025-07-14T00:00:00Z\",\r\n \"contact\": {\r\n \"id\": \"eaa28f49-6028-4b6e-bb12-d8f6278073fc\",\r\n \"accountNumber\": 70000,\r\n \"name\": \"John Doe\"\r\n },\r\n \"currency\": \"EUR\",\r\n \"deliveryDate\": \"2025-07-26T00:00:00Z\",\r\n \"discountPaymentDate\": \"2025-07-16T00:00:00Z\",\r\n \"discountPaymentDate2\": \"2025-07-18T00:00:00Z\",\r\n \"dueDate\": \"2025-07-24T00:00:00Z\",\r\n \"generatorName\": \"Maesn GmbH\",\r\n \"journalCode\": \"60\",\r\n \"isPaymentOrder\": \"true\",\r\n \"ledgerName\": \"Eingangsrechnungen\",\r\n \"lineItems\": [\r\n {\r\n \"id\": \"Item-112233\",\r\n \"account\": {\r\n \"id\": \"db32-4f56-8a9b-1234567890ab\",\r\n \"code\": \"200\",\r\n \"name\": \"EXPENSE\",\r\n \"number\": 4900\r\n },\r\n \"description\": \"Item A\",\r\n \"dimensions\": [\r\n {\r\n \"id\": \"eaa28f49-6028-4b6e-bb12-d8f6278073fc\",\r\n \"code\": \"CS1\",\r\n \"dimension\": \"CostCenter\",\r\n \"name\": \"Jerde, Greenfelder and Jacobi\"\r\n }\r\n ],\r\n \"discountAmount\": 100,\r\n \"discountAmount2\": 50,\r\n \"discountPercentage\": 20,\r\n \"discountPercentage2\": 10,\r\n \"taxCode\": \"9\",\r\n \"taxRatePercentage\": 19,\r\n \"totalGrossAmount\": 500,\r\n \"totalNetAmount\": 450,\r\n \"type\": \"SERVICE\"\r\n }\r\n ],\r\n \"notes\": \"Bill for maintenance services\",\r\n \"number\": \"1233330\",\r\n \"orderId\": \"3344566\",\r\n \"paidDate\": \"2025-07-20T00:00:00Z\",\r\n \"paymentTermId\": \"03\",\r\n \"status\": \"DRAFT\",\r\n \"totalGrossAmount\": 500,\r\n \"useCollectiveContact\": true,\r\n \"vatId\": \"DE987654321\"\r\n}\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"files\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001--")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("X-API-KEY", "<x-api-key>")
req.Header.Add("X-ACCOUNT-KEY", "<x-account-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.put("https://api.maesn.dev/accounting/bookingProposals/{bookingProposalId}/async")
.header("X-API-KEY", "<x-api-key>")
.header("X-ACCOUNT-KEY", "<x-account-key>")
.body("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"bookingProposal\"\r\n\r\n{\r\n \"id\": \"23a24449-6v28-446e-bb12-3f428073fc\",\r\n \"addresses \": [\r\n {\r\n \"city\": \"city\"\r\n }\r\n ],\r\n \"bankAccount\": {\r\n \"id\": \"5a6b7f5dw45c1c-403e-ad56-202fbc312414\",\r\n \"bankName\": \"Sparkasse\",\r\n \"bic\": \"DEUTDEFF\",\r\n \"code\": \"50010517\",\r\n \"iban\": \"DE89370400440532013000\",\r\n \"number\": 5407324931\r\n },\r\n \"bookingProposalDate\": \"2025-07-14T00:00:00Z\",\r\n \"contact\": {\r\n \"id\": \"eaa28f49-6028-4b6e-bb12-d8f6278073fc\",\r\n \"accountNumber\": 70000,\r\n \"name\": \"John Doe\"\r\n },\r\n \"currency\": \"EUR\",\r\n \"deliveryDate\": \"2025-07-26T00:00:00Z\",\r\n \"discountPaymentDate\": \"2025-07-16T00:00:00Z\",\r\n \"discountPaymentDate2\": \"2025-07-18T00:00:00Z\",\r\n \"dueDate\": \"2025-07-24T00:00:00Z\",\r\n \"generatorName\": \"Maesn GmbH\",\r\n \"journalCode\": \"60\",\r\n \"isPaymentOrder\": \"true\",\r\n \"ledgerName\": \"Eingangsrechnungen\",\r\n \"lineItems\": [\r\n {\r\n \"id\": \"Item-112233\",\r\n \"account\": {\r\n \"id\": \"db32-4f56-8a9b-1234567890ab\",\r\n \"code\": \"200\",\r\n \"name\": \"EXPENSE\",\r\n \"number\": 4900\r\n },\r\n \"description\": \"Item A\",\r\n \"dimensions\": [\r\n {\r\n \"id\": \"eaa28f49-6028-4b6e-bb12-d8f6278073fc\",\r\n \"code\": \"CS1\",\r\n \"dimension\": \"CostCenter\",\r\n \"name\": \"Jerde, Greenfelder and Jacobi\"\r\n }\r\n ],\r\n \"discountAmount\": 100,\r\n \"discountAmount2\": 50,\r\n \"discountPercentage\": 20,\r\n \"discountPercentage2\": 10,\r\n \"taxCode\": \"9\",\r\n \"taxRatePercentage\": 19,\r\n \"totalGrossAmount\": 500,\r\n \"totalNetAmount\": 450,\r\n \"type\": \"SERVICE\"\r\n }\r\n ],\r\n \"notes\": \"Bill for maintenance services\",\r\n \"number\": \"1233330\",\r\n \"orderId\": \"3344566\",\r\n \"paidDate\": \"2025-07-20T00:00:00Z\",\r\n \"paymentTermId\": \"03\",\r\n \"status\": \"DRAFT\",\r\n \"totalGrossAmount\": 500,\r\n \"useCollectiveContact\": true,\r\n \"vatId\": \"DE987654321\"\r\n}\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"files\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001--")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.maesn.dev/accounting/bookingProposals/{bookingProposalId}/async")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["X-API-KEY"] = '<x-api-key>'
request["X-ACCOUNT-KEY"] = '<x-account-key>'
request.body = "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"bookingProposal\"\r\n\r\n{\r\n \"id\": \"23a24449-6v28-446e-bb12-3f428073fc\",\r\n \"addresses \": [\r\n {\r\n \"city\": \"city\"\r\n }\r\n ],\r\n \"bankAccount\": {\r\n \"id\": \"5a6b7f5dw45c1c-403e-ad56-202fbc312414\",\r\n \"bankName\": \"Sparkasse\",\r\n \"bic\": \"DEUTDEFF\",\r\n \"code\": \"50010517\",\r\n \"iban\": \"DE89370400440532013000\",\r\n \"number\": 5407324931\r\n },\r\n \"bookingProposalDate\": \"2025-07-14T00:00:00Z\",\r\n \"contact\": {\r\n \"id\": \"eaa28f49-6028-4b6e-bb12-d8f6278073fc\",\r\n \"accountNumber\": 70000,\r\n \"name\": \"John Doe\"\r\n },\r\n \"currency\": \"EUR\",\r\n \"deliveryDate\": \"2025-07-26T00:00:00Z\",\r\n \"discountPaymentDate\": \"2025-07-16T00:00:00Z\",\r\n \"discountPaymentDate2\": \"2025-07-18T00:00:00Z\",\r\n \"dueDate\": \"2025-07-24T00:00:00Z\",\r\n \"generatorName\": \"Maesn GmbH\",\r\n \"journalCode\": \"60\",\r\n \"isPaymentOrder\": \"true\",\r\n \"ledgerName\": \"Eingangsrechnungen\",\r\n \"lineItems\": [\r\n {\r\n \"id\": \"Item-112233\",\r\n \"account\": {\r\n \"id\": \"db32-4f56-8a9b-1234567890ab\",\r\n \"code\": \"200\",\r\n \"name\": \"EXPENSE\",\r\n \"number\": 4900\r\n },\r\n \"description\": \"Item A\",\r\n \"dimensions\": [\r\n {\r\n \"id\": \"eaa28f49-6028-4b6e-bb12-d8f6278073fc\",\r\n \"code\": \"CS1\",\r\n \"dimension\": \"CostCenter\",\r\n \"name\": \"Jerde, Greenfelder and Jacobi\"\r\n }\r\n ],\r\n \"discountAmount\": 100,\r\n \"discountAmount2\": 50,\r\n \"discountPercentage\": 20,\r\n \"discountPercentage2\": 10,\r\n \"taxCode\": \"9\",\r\n \"taxRatePercentage\": 19,\r\n \"totalGrossAmount\": 500,\r\n \"totalNetAmount\": 450,\r\n \"type\": \"SERVICE\"\r\n }\r\n ],\r\n \"notes\": \"Bill for maintenance services\",\r\n \"number\": \"1233330\",\r\n \"orderId\": \"3344566\",\r\n \"paidDate\": \"2025-07-20T00:00:00Z\",\r\n \"paymentTermId\": \"03\",\r\n \"status\": \"DRAFT\",\r\n \"totalGrossAmount\": 500,\r\n \"useCollectiveContact\": true,\r\n \"vatId\": \"DE987654321\"\r\n}\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"files\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001--"
response = http.request(request)
puts response.read_body{
"meta": {
"warnings": [
"Field not used by target system"
],
"pagination": {
"total": 125,
"perPage": 50,
"currentPage": 1,
"totalPages": 3
},
"partialErrors": [
{
"code": "FILE_UPLOAD_FAILED",
"message": "Attachment invoice.pdf could not be uploaded to the target system."
}
]
},
"data": {
"taskId": "02cc5849-b23c-48fe-8a9b-96f74bfc9571"
}
}Field support per integration
Lexware Office
Lexware Office
This endpoint is asynchronous. To check the status of the request, use the
GET asyncTask endpoint.For more info about asynchronous tasks visit the Asynchronous Task section.string
required
Show properties
Show properties
string
required
For date format details visit the
Standardized Data section.string
For date format details visit the
Standardized Data section.
Only supported for bookingType: INVOICE and CREDIT_NOTE.string
For date format details visit the
Standardized Data section.BookingLineItem[]
required
At least one line item is required. Will replace all existing line items.
Show properties
Show properties
Account
required
Show properties
Show properties
string
required
The
id field specifies the Lexware Office category (account) ID linked to the line item.To get the correct accountId, you can use the GET Accounts endpoint.number
required
Must be a positive number.
number
required
The
totalGrossAmount field represents the total gross amount for the line item. It must have at most 2 decimal places.string
string
required
number
required
The
totalGrossAmount field represents the total gross amount for the entire booking proposal. It must have at most 2 decimal places.boolean
If
true, creates the booking proposal with a collective contact (no contact id needed).BookingType
required
Available options:
INVOICE, BILL, CREDIT_NOTE, VENDOR_CREDIT.file[]
Only one file is supported. The file name must not exceed 255 characters in length.
Path Parameters
Query Parameters
ID of the company (required for multi-company target systems)
Body
multipart/form-data
Last modified on November 2, 2026
Was this page helpful?