cURL
curl --request PUT \
--url https://api.maesn.dev/accounting/bookingProposals/{bookingProposalId} \
--header 'Content-Type: multipart/form-data' \
--header 'X-ACCOUNT-KEY: <x-account-key>' \
--header 'X-API-KEY: <x-api-key>' \
--form 'bookingProposal={
"addresses": [
{
"city": "city"
}
],
"bankAccountId": "5a6b7f5dw45c1c-403e-ad56-202fbc312414",
"bankAccountNumber": 5407324931,
"bankCode": "50010517",
"bic": "DEUTDEFF",
"bookingProposalDate": "2025-07-14T00:00:00Z",
"contactAccountNumber": 70000,
"contactId": "eaa28f49-6028-4b6e-bb12-d8f6278073fc",
"contactName": "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",
"journalCode": "60",
"iban": "DE43100500000920018963",
"isPaymentOrder": "true",
"ledgerName": "Payroll",
"lineItems": [
{
"accountCode": "200",
"accountId": "db32-4f56-8a9b-1234567890ab",
"accountName": "EXPENSE",
"accountNumber": 4900,
"bookingTaxCode": "9",
"description": "Item A",
"dimension1": "Marketing",
"dimension2": "Service and Maintenance",
"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": "02",
"taxRatePercentage": 19,
"totalGrossAmount": 500,
"totalNetAmount": 450,
"type": "SERVICES"
}
],
"notes": "Bill for maintenance services",
"number": "1233330",
"orderId": "3344566",
"paidDate": "2021-01-01T00:00:00Z",
"paymentTermsId": "03",
"status": "DRAFT",
"totalGrossAmount": 500,
"useCollectiveContact": true,
"vatId": "DE987654321"
}' \
--form files=@example-fileimport requests
url = "https://api.maesn.dev/accounting/bookingProposals/{bookingProposalId}"
files = { "files": ("example-file", open("example-file", "rb")) }
payload = { "bookingProposal": "{
\"addresses\": [
{
\"city\": \"city\"
}
],
\"bankAccountId\": \"5a6b7f5dw45c1c-403e-ad56-202fbc312414\",
\"bankAccountNumber\": 5407324931,
\"bankCode\": \"50010517\",
\"bic\": \"DEUTDEFF\",
\"bookingProposalDate\": \"2025-07-14T00:00:00Z\",
\"contactAccountNumber\": 70000,
\"contactId\": \"eaa28f49-6028-4b6e-bb12-d8f6278073fc\",
\"contactName\": \"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\",
\"journalCode\": \"60\",
\"iban\": \"DE43100500000920018963\",
\"isPaymentOrder\": \"true\",
\"ledgerName\": \"Payroll\",
\"lineItems\": [
{
\"accountCode\": \"200\",
\"accountId\": \"db32-4f56-8a9b-1234567890ab\",
\"accountName\": \"EXPENSE\",
\"accountNumber\": 4900,
\"bookingTaxCode\": \"9\",
\"description\": \"Item A\",
\"dimension1\": \"Marketing\",
\"dimension2\": \"Service and Maintenance\",
\"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\": \"02\",
\"taxRatePercentage\": 19,
\"totalGrossAmount\": 500,
\"totalNetAmount\": 450,
\"type\": \"SERVICES\"
}
],
\"notes\": \"Bill for maintenance services\",
\"number\": \"1233330\",
\"orderId\": \"3344566\",
\"paidDate\": \"2021-01-01T00:00:00Z\",
\"paymentTermsId\": \"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', '{
"addresses": [
{
"city": "city"
}
],
"bankAccountId": "5a6b7f5dw45c1c-403e-ad56-202fbc312414",
"bankAccountNumber": 5407324931,
"bankCode": "50010517",
"bic": "DEUTDEFF",
"bookingProposalDate": "2025-07-14T00:00:00Z",
"contactAccountNumber": 70000,
"contactId": "eaa28f49-6028-4b6e-bb12-d8f6278073fc",
"contactName": "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",
"journalCode": "60",
"iban": "DE43100500000920018963",
"isPaymentOrder": "true",
"ledgerName": "Payroll",
"lineItems": [
{
"accountCode": "200",
"accountId": "db32-4f56-8a9b-1234567890ab",
"accountName": "EXPENSE",
"accountNumber": 4900,
"bookingTaxCode": "9",
"description": "Item A",
"dimension1": "Marketing",
"dimension2": "Service and Maintenance",
"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": "02",
"taxRatePercentage": 19,
"totalGrossAmount": 500,
"totalNetAmount": 450,
"type": "SERVICES"
}
],
"notes": "Bill for maintenance services",
"number": "1233330",
"orderId": "3344566",
"paidDate": "2021-01-01T00:00:00Z",
"paymentTermsId": "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}', 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}",
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 \"addresses\": [\r\n {\r\n \"city\": \"city\"\r\n }\r\n ],\r\n \"bankAccountId\": \"5a6b7f5dw45c1c-403e-ad56-202fbc312414\",\r\n \"bankAccountNumber\": 5407324931,\r\n \"bankCode\": \"50010517\",\r\n \"bic\": \"DEUTDEFF\",\r\n \"bookingProposalDate\": \"2025-07-14T00:00:00Z\",\r\n \"contactAccountNumber\": 70000,\r\n \"contactId\": \"eaa28f49-6028-4b6e-bb12-d8f6278073fc\",\r\n \"contactName\": \"John Doe\",\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 \"journalCode\": \"60\",\r\n \"iban\": \"DE43100500000920018963\",\r\n \"isPaymentOrder\": \"true\",\r\n \"ledgerName\": \"Payroll\",\r\n \"lineItems\": [\r\n {\r\n \"accountCode\": \"200\",\r\n \"accountId\": \"db32-4f56-8a9b-1234567890ab\",\r\n \"accountName\": \"EXPENSE\",\r\n \"accountNumber\": 4900,\r\n \"bookingTaxCode\": \"9\",\r\n \"description\": \"Item A\",\r\n \"dimension1\": \"Marketing\",\r\n \"dimension2\": \"Service and Maintenance\",\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\": \"02\",\r\n \"taxRatePercentage\": 19,\r\n \"totalGrossAmount\": 500,\r\n \"totalNetAmount\": 450,\r\n \"type\": \"SERVICES\"\r\n }\r\n ],\r\n \"notes\": \"Bill for maintenance services\",\r\n \"number\": \"1233330\",\r\n \"orderId\": \"3344566\",\r\n \"paidDate\": \"2021-01-01T00:00:00Z\",\r\n \"paymentTermsId\": \"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}"
payload := strings.NewReader("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"bookingProposal\"\r\n\r\n{\r\n \"addresses\": [\r\n {\r\n \"city\": \"city\"\r\n }\r\n ],\r\n \"bankAccountId\": \"5a6b7f5dw45c1c-403e-ad56-202fbc312414\",\r\n \"bankAccountNumber\": 5407324931,\r\n \"bankCode\": \"50010517\",\r\n \"bic\": \"DEUTDEFF\",\r\n \"bookingProposalDate\": \"2025-07-14T00:00:00Z\",\r\n \"contactAccountNumber\": 70000,\r\n \"contactId\": \"eaa28f49-6028-4b6e-bb12-d8f6278073fc\",\r\n \"contactName\": \"John Doe\",\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 \"journalCode\": \"60\",\r\n \"iban\": \"DE43100500000920018963\",\r\n \"isPaymentOrder\": \"true\",\r\n \"ledgerName\": \"Payroll\",\r\n \"lineItems\": [\r\n {\r\n \"accountCode\": \"200\",\r\n \"accountId\": \"db32-4f56-8a9b-1234567890ab\",\r\n \"accountName\": \"EXPENSE\",\r\n \"accountNumber\": 4900,\r\n \"bookingTaxCode\": \"9\",\r\n \"description\": \"Item A\",\r\n \"dimension1\": \"Marketing\",\r\n \"dimension2\": \"Service and Maintenance\",\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\": \"02\",\r\n \"taxRatePercentage\": 19,\r\n \"totalGrossAmount\": 500,\r\n \"totalNetAmount\": 450,\r\n \"type\": \"SERVICES\"\r\n }\r\n ],\r\n \"notes\": \"Bill for maintenance services\",\r\n \"number\": \"1233330\",\r\n \"orderId\": \"3344566\",\r\n \"paidDate\": \"2021-01-01T00:00:00Z\",\r\n \"paymentTermsId\": \"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}")
.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 \"addresses\": [\r\n {\r\n \"city\": \"city\"\r\n }\r\n ],\r\n \"bankAccountId\": \"5a6b7f5dw45c1c-403e-ad56-202fbc312414\",\r\n \"bankAccountNumber\": 5407324931,\r\n \"bankCode\": \"50010517\",\r\n \"bic\": \"DEUTDEFF\",\r\n \"bookingProposalDate\": \"2025-07-14T00:00:00Z\",\r\n \"contactAccountNumber\": 70000,\r\n \"contactId\": \"eaa28f49-6028-4b6e-bb12-d8f6278073fc\",\r\n \"contactName\": \"John Doe\",\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 \"journalCode\": \"60\",\r\n \"iban\": \"DE43100500000920018963\",\r\n \"isPaymentOrder\": \"true\",\r\n \"ledgerName\": \"Payroll\",\r\n \"lineItems\": [\r\n {\r\n \"accountCode\": \"200\",\r\n \"accountId\": \"db32-4f56-8a9b-1234567890ab\",\r\n \"accountName\": \"EXPENSE\",\r\n \"accountNumber\": 4900,\r\n \"bookingTaxCode\": \"9\",\r\n \"description\": \"Item A\",\r\n \"dimension1\": \"Marketing\",\r\n \"dimension2\": \"Service and Maintenance\",\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\": \"02\",\r\n \"taxRatePercentage\": 19,\r\n \"totalGrossAmount\": 500,\r\n \"totalNetAmount\": 450,\r\n \"type\": \"SERVICES\"\r\n }\r\n ],\r\n \"notes\": \"Bill for maintenance services\",\r\n \"number\": \"1233330\",\r\n \"orderId\": \"3344566\",\r\n \"paidDate\": \"2021-01-01T00:00:00Z\",\r\n \"paymentTermsId\": \"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}")
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 \"addresses\": [\r\n {\r\n \"city\": \"city\"\r\n }\r\n ],\r\n \"bankAccountId\": \"5a6b7f5dw45c1c-403e-ad56-202fbc312414\",\r\n \"bankAccountNumber\": 5407324931,\r\n \"bankCode\": \"50010517\",\r\n \"bic\": \"DEUTDEFF\",\r\n \"bookingProposalDate\": \"2025-07-14T00:00:00Z\",\r\n \"contactAccountNumber\": 70000,\r\n \"contactId\": \"eaa28f49-6028-4b6e-bb12-d8f6278073fc\",\r\n \"contactName\": \"John Doe\",\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 \"journalCode\": \"60\",\r\n \"iban\": \"DE43100500000920018963\",\r\n \"isPaymentOrder\": \"true\",\r\n \"ledgerName\": \"Payroll\",\r\n \"lineItems\": [\r\n {\r\n \"accountCode\": \"200\",\r\n \"accountId\": \"db32-4f56-8a9b-1234567890ab\",\r\n \"accountName\": \"EXPENSE\",\r\n \"accountNumber\": 4900,\r\n \"bookingTaxCode\": \"9\",\r\n \"description\": \"Item A\",\r\n \"dimension1\": \"Marketing\",\r\n \"dimension2\": \"Service and Maintenance\",\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\": \"02\",\r\n \"taxRatePercentage\": 19,\r\n \"totalGrossAmount\": 500,\r\n \"totalNetAmount\": 450,\r\n \"type\": \"SERVICES\"\r\n }\r\n ],\r\n \"notes\": \"Bill for maintenance services\",\r\n \"number\": \"1233330\",\r\n \"orderId\": \"3344566\",\r\n \"paidDate\": \"2021-01-01T00:00:00Z\",\r\n \"paymentTermsId\": \"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": {
"id": "BP-12345",
"addresses ": [
{
"city": "city"
}
],
"bankAccountId": "5a6b7f5dw45c1c-403e-ad56-202fbc312414",
"bankAccountNumber": 5407324931,
"bankCode": "50010517",
"bic": "DEUTDEFF",
"bookingProposalDate": "2025-07-14T00:00:00Z",
"bookingType": "INVOICE",
"contactAccountNumber": 70000,
"contactId": "eaa28f49-6028-4b6e-bb12-d8f6278073fc",
"contactName ": "John Doe",
"createdDate": "2025-07-16T00:00:00Z",
"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",
"files": [
"file1.pdf"
],
"journalCode": "60",
"iban": "DE43100500000920018963",
"isPaymentOrder": "true",
"ledgerName": "Payroll",
"lineItems": [
{
"id": "Item-112233",
"accountCode": "200",
"accountId": "db32-4f56-8a9b-1234567890ab",
"accountName": "EXPENSE",
"accountNumber": 4900,
"bookingTaxCode": "9",
"createdDate": "2021-01-01T00:00:00Z",
"description": "Item A",
"dimension1": "Marketing",
"dimension2": "Service and Maintenance",
"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": "02",
"taxRatePercentage": 19,
"totalGrossAmount": 500,
"totalNetAmount": 450,
"type": "SERVICES",
"updatedDate": "2021-01-01T00:00:00Z"
}
],
"notes": "Bill for maintenance services",
"number": "1233330",
"orderId": "3344566",
"paidDate": "2021-01-01T00:00:00Z",
"paymentTermsId": "03",
"status": "DRAFT",
"taskId": "ADHUR74BCBSW8399DCN",
"totalGrossAmount": 500,
"updatedDate": "2025-07-16T00:00:00Z",
"vatId": "DE987654321"
}
}Booking Proposals
Update booking proposal
PUT
/
accounting
/
bookingProposals
/
{bookingProposalId}
cURL
curl --request PUT \
--url https://api.maesn.dev/accounting/bookingProposals/{bookingProposalId} \
--header 'Content-Type: multipart/form-data' \
--header 'X-ACCOUNT-KEY: <x-account-key>' \
--header 'X-API-KEY: <x-api-key>' \
--form 'bookingProposal={
"addresses": [
{
"city": "city"
}
],
"bankAccountId": "5a6b7f5dw45c1c-403e-ad56-202fbc312414",
"bankAccountNumber": 5407324931,
"bankCode": "50010517",
"bic": "DEUTDEFF",
"bookingProposalDate": "2025-07-14T00:00:00Z",
"contactAccountNumber": 70000,
"contactId": "eaa28f49-6028-4b6e-bb12-d8f6278073fc",
"contactName": "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",
"journalCode": "60",
"iban": "DE43100500000920018963",
"isPaymentOrder": "true",
"ledgerName": "Payroll",
"lineItems": [
{
"accountCode": "200",
"accountId": "db32-4f56-8a9b-1234567890ab",
"accountName": "EXPENSE",
"accountNumber": 4900,
"bookingTaxCode": "9",
"description": "Item A",
"dimension1": "Marketing",
"dimension2": "Service and Maintenance",
"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": "02",
"taxRatePercentage": 19,
"totalGrossAmount": 500,
"totalNetAmount": 450,
"type": "SERVICES"
}
],
"notes": "Bill for maintenance services",
"number": "1233330",
"orderId": "3344566",
"paidDate": "2021-01-01T00:00:00Z",
"paymentTermsId": "03",
"status": "DRAFT",
"totalGrossAmount": 500,
"useCollectiveContact": true,
"vatId": "DE987654321"
}' \
--form files=@example-fileimport requests
url = "https://api.maesn.dev/accounting/bookingProposals/{bookingProposalId}"
files = { "files": ("example-file", open("example-file", "rb")) }
payload = { "bookingProposal": "{
\"addresses\": [
{
\"city\": \"city\"
}
],
\"bankAccountId\": \"5a6b7f5dw45c1c-403e-ad56-202fbc312414\",
\"bankAccountNumber\": 5407324931,
\"bankCode\": \"50010517\",
\"bic\": \"DEUTDEFF\",
\"bookingProposalDate\": \"2025-07-14T00:00:00Z\",
\"contactAccountNumber\": 70000,
\"contactId\": \"eaa28f49-6028-4b6e-bb12-d8f6278073fc\",
\"contactName\": \"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\",
\"journalCode\": \"60\",
\"iban\": \"DE43100500000920018963\",
\"isPaymentOrder\": \"true\",
\"ledgerName\": \"Payroll\",
\"lineItems\": [
{
\"accountCode\": \"200\",
\"accountId\": \"db32-4f56-8a9b-1234567890ab\",
\"accountName\": \"EXPENSE\",
\"accountNumber\": 4900,
\"bookingTaxCode\": \"9\",
\"description\": \"Item A\",
\"dimension1\": \"Marketing\",
\"dimension2\": \"Service and Maintenance\",
\"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\": \"02\",
\"taxRatePercentage\": 19,
\"totalGrossAmount\": 500,
\"totalNetAmount\": 450,
\"type\": \"SERVICES\"
}
],
\"notes\": \"Bill for maintenance services\",
\"number\": \"1233330\",
\"orderId\": \"3344566\",
\"paidDate\": \"2021-01-01T00:00:00Z\",
\"paymentTermsId\": \"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', '{
"addresses": [
{
"city": "city"
}
],
"bankAccountId": "5a6b7f5dw45c1c-403e-ad56-202fbc312414",
"bankAccountNumber": 5407324931,
"bankCode": "50010517",
"bic": "DEUTDEFF",
"bookingProposalDate": "2025-07-14T00:00:00Z",
"contactAccountNumber": 70000,
"contactId": "eaa28f49-6028-4b6e-bb12-d8f6278073fc",
"contactName": "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",
"journalCode": "60",
"iban": "DE43100500000920018963",
"isPaymentOrder": "true",
"ledgerName": "Payroll",
"lineItems": [
{
"accountCode": "200",
"accountId": "db32-4f56-8a9b-1234567890ab",
"accountName": "EXPENSE",
"accountNumber": 4900,
"bookingTaxCode": "9",
"description": "Item A",
"dimension1": "Marketing",
"dimension2": "Service and Maintenance",
"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": "02",
"taxRatePercentage": 19,
"totalGrossAmount": 500,
"totalNetAmount": 450,
"type": "SERVICES"
}
],
"notes": "Bill for maintenance services",
"number": "1233330",
"orderId": "3344566",
"paidDate": "2021-01-01T00:00:00Z",
"paymentTermsId": "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}', 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}",
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 \"addresses\": [\r\n {\r\n \"city\": \"city\"\r\n }\r\n ],\r\n \"bankAccountId\": \"5a6b7f5dw45c1c-403e-ad56-202fbc312414\",\r\n \"bankAccountNumber\": 5407324931,\r\n \"bankCode\": \"50010517\",\r\n \"bic\": \"DEUTDEFF\",\r\n \"bookingProposalDate\": \"2025-07-14T00:00:00Z\",\r\n \"contactAccountNumber\": 70000,\r\n \"contactId\": \"eaa28f49-6028-4b6e-bb12-d8f6278073fc\",\r\n \"contactName\": \"John Doe\",\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 \"journalCode\": \"60\",\r\n \"iban\": \"DE43100500000920018963\",\r\n \"isPaymentOrder\": \"true\",\r\n \"ledgerName\": \"Payroll\",\r\n \"lineItems\": [\r\n {\r\n \"accountCode\": \"200\",\r\n \"accountId\": \"db32-4f56-8a9b-1234567890ab\",\r\n \"accountName\": \"EXPENSE\",\r\n \"accountNumber\": 4900,\r\n \"bookingTaxCode\": \"9\",\r\n \"description\": \"Item A\",\r\n \"dimension1\": \"Marketing\",\r\n \"dimension2\": \"Service and Maintenance\",\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\": \"02\",\r\n \"taxRatePercentage\": 19,\r\n \"totalGrossAmount\": 500,\r\n \"totalNetAmount\": 450,\r\n \"type\": \"SERVICES\"\r\n }\r\n ],\r\n \"notes\": \"Bill for maintenance services\",\r\n \"number\": \"1233330\",\r\n \"orderId\": \"3344566\",\r\n \"paidDate\": \"2021-01-01T00:00:00Z\",\r\n \"paymentTermsId\": \"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}"
payload := strings.NewReader("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"bookingProposal\"\r\n\r\n{\r\n \"addresses\": [\r\n {\r\n \"city\": \"city\"\r\n }\r\n ],\r\n \"bankAccountId\": \"5a6b7f5dw45c1c-403e-ad56-202fbc312414\",\r\n \"bankAccountNumber\": 5407324931,\r\n \"bankCode\": \"50010517\",\r\n \"bic\": \"DEUTDEFF\",\r\n \"bookingProposalDate\": \"2025-07-14T00:00:00Z\",\r\n \"contactAccountNumber\": 70000,\r\n \"contactId\": \"eaa28f49-6028-4b6e-bb12-d8f6278073fc\",\r\n \"contactName\": \"John Doe\",\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 \"journalCode\": \"60\",\r\n \"iban\": \"DE43100500000920018963\",\r\n \"isPaymentOrder\": \"true\",\r\n \"ledgerName\": \"Payroll\",\r\n \"lineItems\": [\r\n {\r\n \"accountCode\": \"200\",\r\n \"accountId\": \"db32-4f56-8a9b-1234567890ab\",\r\n \"accountName\": \"EXPENSE\",\r\n \"accountNumber\": 4900,\r\n \"bookingTaxCode\": \"9\",\r\n \"description\": \"Item A\",\r\n \"dimension1\": \"Marketing\",\r\n \"dimension2\": \"Service and Maintenance\",\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\": \"02\",\r\n \"taxRatePercentage\": 19,\r\n \"totalGrossAmount\": 500,\r\n \"totalNetAmount\": 450,\r\n \"type\": \"SERVICES\"\r\n }\r\n ],\r\n \"notes\": \"Bill for maintenance services\",\r\n \"number\": \"1233330\",\r\n \"orderId\": \"3344566\",\r\n \"paidDate\": \"2021-01-01T00:00:00Z\",\r\n \"paymentTermsId\": \"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}")
.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 \"addresses\": [\r\n {\r\n \"city\": \"city\"\r\n }\r\n ],\r\n \"bankAccountId\": \"5a6b7f5dw45c1c-403e-ad56-202fbc312414\",\r\n \"bankAccountNumber\": 5407324931,\r\n \"bankCode\": \"50010517\",\r\n \"bic\": \"DEUTDEFF\",\r\n \"bookingProposalDate\": \"2025-07-14T00:00:00Z\",\r\n \"contactAccountNumber\": 70000,\r\n \"contactId\": \"eaa28f49-6028-4b6e-bb12-d8f6278073fc\",\r\n \"contactName\": \"John Doe\",\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 \"journalCode\": \"60\",\r\n \"iban\": \"DE43100500000920018963\",\r\n \"isPaymentOrder\": \"true\",\r\n \"ledgerName\": \"Payroll\",\r\n \"lineItems\": [\r\n {\r\n \"accountCode\": \"200\",\r\n \"accountId\": \"db32-4f56-8a9b-1234567890ab\",\r\n \"accountName\": \"EXPENSE\",\r\n \"accountNumber\": 4900,\r\n \"bookingTaxCode\": \"9\",\r\n \"description\": \"Item A\",\r\n \"dimension1\": \"Marketing\",\r\n \"dimension2\": \"Service and Maintenance\",\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\": \"02\",\r\n \"taxRatePercentage\": 19,\r\n \"totalGrossAmount\": 500,\r\n \"totalNetAmount\": 450,\r\n \"type\": \"SERVICES\"\r\n }\r\n ],\r\n \"notes\": \"Bill for maintenance services\",\r\n \"number\": \"1233330\",\r\n \"orderId\": \"3344566\",\r\n \"paidDate\": \"2021-01-01T00:00:00Z\",\r\n \"paymentTermsId\": \"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}")
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 \"addresses\": [\r\n {\r\n \"city\": \"city\"\r\n }\r\n ],\r\n \"bankAccountId\": \"5a6b7f5dw45c1c-403e-ad56-202fbc312414\",\r\n \"bankAccountNumber\": 5407324931,\r\n \"bankCode\": \"50010517\",\r\n \"bic\": \"DEUTDEFF\",\r\n \"bookingProposalDate\": \"2025-07-14T00:00:00Z\",\r\n \"contactAccountNumber\": 70000,\r\n \"contactId\": \"eaa28f49-6028-4b6e-bb12-d8f6278073fc\",\r\n \"contactName\": \"John Doe\",\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 \"journalCode\": \"60\",\r\n \"iban\": \"DE43100500000920018963\",\r\n \"isPaymentOrder\": \"true\",\r\n \"ledgerName\": \"Payroll\",\r\n \"lineItems\": [\r\n {\r\n \"accountCode\": \"200\",\r\n \"accountId\": \"db32-4f56-8a9b-1234567890ab\",\r\n \"accountName\": \"EXPENSE\",\r\n \"accountNumber\": 4900,\r\n \"bookingTaxCode\": \"9\",\r\n \"description\": \"Item A\",\r\n \"dimension1\": \"Marketing\",\r\n \"dimension2\": \"Service and Maintenance\",\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\": \"02\",\r\n \"taxRatePercentage\": 19,\r\n \"totalGrossAmount\": 500,\r\n \"totalNetAmount\": 450,\r\n \"type\": \"SERVICES\"\r\n }\r\n ],\r\n \"notes\": \"Bill for maintenance services\",\r\n \"number\": \"1233330\",\r\n \"orderId\": \"3344566\",\r\n \"paidDate\": \"2021-01-01T00:00:00Z\",\r\n \"paymentTermsId\": \"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": {
"id": "BP-12345",
"addresses ": [
{
"city": "city"
}
],
"bankAccountId": "5a6b7f5dw45c1c-403e-ad56-202fbc312414",
"bankAccountNumber": 5407324931,
"bankCode": "50010517",
"bic": "DEUTDEFF",
"bookingProposalDate": "2025-07-14T00:00:00Z",
"bookingType": "INVOICE",
"contactAccountNumber": 70000,
"contactId": "eaa28f49-6028-4b6e-bb12-d8f6278073fc",
"contactName ": "John Doe",
"createdDate": "2025-07-16T00:00:00Z",
"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",
"files": [
"file1.pdf"
],
"journalCode": "60",
"iban": "DE43100500000920018963",
"isPaymentOrder": "true",
"ledgerName": "Payroll",
"lineItems": [
{
"id": "Item-112233",
"accountCode": "200",
"accountId": "db32-4f56-8a9b-1234567890ab",
"accountName": "EXPENSE",
"accountNumber": 4900,
"bookingTaxCode": "9",
"createdDate": "2021-01-01T00:00:00Z",
"description": "Item A",
"dimension1": "Marketing",
"dimension2": "Service and Maintenance",
"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": "02",
"taxRatePercentage": 19,
"totalGrossAmount": 500,
"totalNetAmount": 450,
"type": "SERVICES",
"updatedDate": "2021-01-01T00:00:00Z"
}
],
"notes": "Bill for maintenance services",
"number": "1233330",
"orderId": "3344566",
"paidDate": "2021-01-01T00:00:00Z",
"paymentTermsId": "03",
"status": "DRAFT",
"taskId": "ADHUR74BCBSW8399DCN",
"totalGrossAmount": 500,
"updatedDate": "2025-07-16T00:00:00Z",
"vatId": "DE987654321"
}
}Field support per integration
Lexware Office
Lexware Office
Supported request parameters:
string
required
Show properties
Show properties
string
required
For date format details visit the
Standardized Data section.string
Required when
useCollectiveContact is false or not provided.string
For date format details visit the
Standardized Data section.
It is only supported for booking proposals of type INVOICE and INVOICE_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
string
required
The
accountId field specifies the id of the posting category in Lexware that represents the general ledger account linked to the individual line item within the booking proposal.To get the correct accountId, you can use the GET Accounts endpoint.number
required
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 contactId needed).BookingType
required
Available options:
BILL, INVOICE, INVOICE_CREDIT_NOTE, BILL_CREDIT_NOTEfile[]
Only one file is supported. The file name must not exceed 255 characters in length.
Path Parameters
Query Parameters
Environment name (required for multi-environment systems such as Business Central)
Body
multipart/form-data
Last modified on November 2, 2026
Was this page helpful?