Skip to main content
POST
/
accounting
/
bookingProposals
cURL
curl --request POST \
  --url https://api.maesn.dev/accounting/bookingProposals \
  --header 'Content-Type: multipart/form-data' \
  --header 'X-ACCOUNT-KEY: <x-account-key>' \
  --header 'X-API-KEY: <x-api-key>' \
  --form 'bookingProposal={
  "id": "BP-12345",
  "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": [
    {
      "id": "Item-112233",
      "accountCode": "200",
      "accountId": "db32-4f56-8a9b-1234567890ab",
      "accountName": "EXPENSE",
      "accountNumber": 4900,
      "bookingTaxCode": "9",
      "description": "Item A",
      "dimension1": "Marketing",
      "dimension2": "Service and Maintenance",
      "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",
  "totalGrossAmount": 500,
  "vatId": "DE987654321"
}' \
  --form bookingType=INVOICE \
  --form 'folderManagement={
  "category": "Accounting",
  "folder": "Invoices",
  "register": "2025 January"
}'
{
  "meta": {
    "warnings": [
      "Field not used by target system"
    ],
    "pagination": {
      "total": 123,
      "perPage": 123,
      "currentPage": 123,
      "totalPages": 123
    }
  },
  "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",
        "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

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.
Supported Request Parameters:
​
bookingProposal
string
required
​
bookingType
BookingType
required
Available options: INVOICE, BILL
​
files
file[]
The 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.
​
folderManagement
FolderManagement
The folderManagement object defines the three-level folder structure for a booking proposal. If not provided, the default structure will be used.
If you’re not using the Interactive Authentication Flow, make sure the query parameter companyId is correctly populated. You can obtain this value by using the GET Companies endpoint available under the Authentication section.
Supported Request Parameters:
​
bookingProposal
string
required
​
bookingType
BookingType
required
Available options: BILL
​
files
file[]
Supported Request Parameters:
​
bookingProposal
string
required
​
bookingType
BookingType
required
Available options: BILL, INVOICE
​
files
file[]
If you’re not using the Interactive Authentication Flow, make sure the query parameter companyId is correctly populated. You can obtain this value by using the GET Companies endpoint available under the Authentication section.
Supported Request Parameters:
​
bookingProposal
string
required
​
bookingType
BookingType
required
Available options: BILL, INVOICE
​
files
file[]
This endpoint is available only for the following countries: Accounting Plus: 🇨🇦, 🇬🇧, 🇮🇪
Accounting Standard: 🇬🇧, 🇮🇪
Accounting Start: 🇨🇦, 🇬🇧, 🇮🇪
When handling a new connection in your integration, it is advisable to first determine which subscription your customer is using to ensure compatibility. To do this, you can use the GET Companies call to retrieve all businesses available for the user. The user will then select one of these businesses. It is also a good practice to verify that the active property of the selected business is set to true before proceeding with the integration setup.
Supported Request Parameters:
​
bookingProposal
string
required
​
bookingType
BookingType
required
Available options: INVOICE
Supported Request Parameters:
​
bookingProposal
string
required
​
bookingType
BookingType
required
Available options: INVOICE, BILL
​
files
file[]
Supported Request Parameters:
​
bookingProposal
string
required
​
bookingType
BookingType
required
Available options: BILL, INVOICE
Supported Request Parameters:
​
bookingProposal
string
required
​
bookingType
BookingType
required
Available options: BILL, INVOICE
​
files
file[]

Headers

​
X-API-KEY
string
required

API key

Example:

"example value"

​
X-ACCOUNT-KEY
string
required

Account key

Example:

"example value"

Query Parameters

​
companyId
string

Body

multipart/form-data
​
bookingProposal
object
​
bookingType
enum<string>
Available options:
INVOICE,
BILL
​
files
file[]

Array of files to upload

​
folderManagement
object

Response

200 - application/json
​
meta
object
​
data
object
⌘I