Get started
Use cases
Booking Proposals
cURL
Copy
Ask AI
curl --request POST \
--url https://api.maesn.dev/accounting/v2/bookingProposals \
--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": "Berlin"
}
],
"bankAccount": {
"id": "5a6b7f5dw45c1c-403e-ad56-202fbc312414",
"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",
"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,
"vatId": "DE987654321"
}' \
--form bookingType=BILL \
--form 'files=<string>' \
--form 'folderManagement={
"category": "Accounting",
"folder": "Documents",
"register": "2025 January"
}' \
--form files.items='@example-file'Copy
Ask AI
{
"meta": {
"warnings": [
"Field not used by target system"
],
"pagination": {
"total": 125,
"perPage": 50,
"currentPage": 1,
"totalPages": 3
}
},
"data": {
"id": "23a24449-6v28-446e-bb12-3f428073fc",
"addresses ": [
{
"city": "Berlin"
}
],
"bankAccount": {
"id": "5a6b7f5dw45c1c-403e-ad56-202fbc312414",
"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"
},
"createdDate": "2025-07-14T00: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",
"isPaymentOrder": "true",
"ledgerName": "Ausgangsrechnungen",
"lineItems": [
{
"id": "Item-112233",
"account": {
"id": "db32-4f56-8a9b-1234567890ab",
"code": "200",
"name": "EXPENSE",
"number": 4900
},
"createdDate": "2025-07-14T00:00:00Z",
"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",
"updatedDate": "2025-07-16T00:00:00Z"
}
],
"notes": "Bill for maintenance services",
"number": "1233330",
"orderId": "3344566",
"paidDate": "2021-01-01T00:00:00Z",
"paymentTermId": "03",
"status": "DRAFT",
"totalGrossAmount": 500,
"updatedDate": "2025-07-16T00:00:00Z",
"vatId": "DE987654321"
}
}Booking Proposals
Create booking proposal
POST
/
accounting
/
v2
/
bookingProposals
cURL
Copy
Ask AI
curl --request POST \
--url https://api.maesn.dev/accounting/v2/bookingProposals \
--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": "Berlin"
}
],
"bankAccount": {
"id": "5a6b7f5dw45c1c-403e-ad56-202fbc312414",
"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",
"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,
"vatId": "DE987654321"
}' \
--form bookingType=BILL \
--form 'files=<string>' \
--form 'folderManagement={
"category": "Accounting",
"folder": "Documents",
"register": "2025 January"
}' \
--form files.items='@example-file'Copy
Ask AI
{
"meta": {
"warnings": [
"Field not used by target system"
],
"pagination": {
"total": 125,
"perPage": 50,
"currentPage": 1,
"totalPages": 3
}
},
"data": {
"id": "23a24449-6v28-446e-bb12-3f428073fc",
"addresses ": [
{
"city": "Berlin"
}
],
"bankAccount": {
"id": "5a6b7f5dw45c1c-403e-ad56-202fbc312414",
"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"
},
"createdDate": "2025-07-14T00: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",
"isPaymentOrder": "true",
"ledgerName": "Ausgangsrechnungen",
"lineItems": [
{
"id": "Item-112233",
"account": {
"id": "db32-4f56-8a9b-1234567890ab",
"code": "200",
"name": "EXPENSE",
"number": 4900
},
"createdDate": "2025-07-14T00:00:00Z",
"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",
"updatedDate": "2025-07-16T00:00:00Z"
}
],
"notes": "Bill for maintenance services",
"number": "1233330",
"orderId": "3344566",
"paidDate": "2021-01-01T00:00:00Z",
"paymentTermId": "03",
"status": "DRAFT",
"totalGrossAmount": 500,
"updatedDate": "2025-07-16T00:00:00Z",
"vatId": "DE987654321"
}
}Field support per integration
DATEV Unternehmen Online
DATEV Unternehmen Online
This endpoints 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.If you’re not using the Interactive Authentication Flow, make sure the query parameter
companyId is accurately populated with the appropriate company ID. You can obtain this value by using the GET Companies endpoint available under the Authentication section.Show properties
Show properties
The
id field represents the unique identifier of the booking proposal.The
id must be a valid UUID; otherwise, it will be ignored.This field is only relevant and used when uploading files with the booking proposal.ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
Show properties
Show properties
The
accountNumber field represents the account number of the contact associated with the booking proposal.It is the customer account number for INVOICE and CREDIT_NOTE or the vendor account number for BILL and VENDOR_CREDIT.The
name field represents the name of the contact associated with the booking proposal.The
currency field supports ISO 3166-1 alpha-2 (2-letter codes).
For details visits the Standardized Data section.ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
The
discountPaymentDate field represents the date until which a discount (discountAmount and discountPercentage in line items) can be applied to the payment.ISO-8601 date format, e.g., 2024-01-01T00:00:00ZThe
discountPaymentDate2 field represents the date until which a discount (discountAmount2 and discountPercentage2 in line items) can be applied to the payment.ISO-8601 date format, e.g., 2024-01-01T00:00:00ZISO-8601 date format, e.g., 2024-01-01T00:00:00Z
The
isPaymentOrder field determines whether a payment instruction (transfer for bills or direct debit for invoices) should
be automatically created when the booking proposal is processedThe
ledgerName field represents the name of the correct ledger folder where the data will be sent to.To get the correct name, you can use the GET Accounts endpoint.For
INVOICE and CREDIT_NOTE booking proposals, the ledgerName must be of type ACCOUNT_RECEIVABLE, and for BILL and VENDOR_CREDIT booking proposals, it must be of type ACCOUNT_PAYABLE.Show properties
Show properties
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
Available options:
INVOICE, BILL, CREDIT_NOTE, VENDOR_CREDITThe
files array can be used to attach files to the booking proposal.The name of the uploaded files must include the file extension, for example
invoice.pdf.The
folderManagement object defines the three-level folder structure for a booking proposal. If not provided, the default structure will be used.Show properties
Show properties
Query Parameters
Body
multipart/form-data
Was this page helpful?
⌘I