Create bookingproposal

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
    }
  ],
  "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,
        "updatedDate": "2021-01-01T00:00:00Z"
      }
    ],
    "notes": "Bill for maintenance services",
    "number": "1233330",
    "orderId": "3344566",
    "paidDate": "2021-01-01T00:00:00Z",
    "paymentTermsId": "03",
    "taskId": "ADHUR74BCBSW8399DCN",
    "totalGrossAmount": 500,
    "updatedDate": "2025-07-16T00:00:00Z",
    "vatId": "DE987654321"
  }
}

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
    }
  ],
  "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,
        "updatedDate": "2021-01-01T00:00:00Z"
      }
    ],
    "notes": "Bill for maintenance services",
    "number": "1233330",
    "orderId": "3344566",
    "paidDate": "2021-01-01T00:00:00Z",
    "paymentTermsId": "03",
    "taskId": "ADHUR74BCBSW8399DCN",
    "totalGrossAmount": 500,
    "updatedDate": "2025-07-16T00:00:00Z",
    "vatId": "DE987654321"
  }
}

Field support per integration

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.

Supported Request Parameters:

bookingProposal

string

required

Show properties

string

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.

addresses

Address[]

Show properties

city

string

bankAccountNumber

number

bankCode

string

bic

string

bookingProposalDate

string

required

ISO-8601 date format, e.g., 2024-01-01T00:00:00Z

contactAccountNumber

number

The contactAccountNumber field represents the account number of the contact associated with the booking proposal.It is the customer account number for INVOICE or the vendor account number for BILL.

contactName

string

The contactName field represents the name of the contact associated with the booking proposal.

currency

enum

required

Available options (3-letter ISO 4217): AED, AFN, ALL, AMD, ANG, AOA, ARS, AUD, AWG, AZN, BAM, BBD, BDT, BGN, BHD, BIF, BMD, BND, BOB, BRL, BSD, BTN, BWP, BYR, BZD, CAD, CDF, CHF, CLP, CNY, COP, CRC, CUC, CVE, CZK, DJF, DKK, DOP, DZD, EEK, EGP, ERN, ETB, EUR, FJD, FKP, GBP, GEL, GHS, GIP, GMD, GNF, GQE, GTQ, GYD, HKD, HNL, HRK, HTG, HUF, IDR, ILS, INR, IQD, IRR, ISK, JMD, JOD, JPY, KES, KGS, KHR, KMF, KPW, KRW, KWD, KYD, KZT, LAK, LBP, LKR, LRD, LSL, LTL, LVL, LYD, MAD, MDL, MGA, MKD, MMK, MNT, MOP, MRO, MUR, MVR, MWK, MXN, MYR, MZM, NAD, NGN, NIO, NOK, NPR, NZD, OMR, PAB, PEN, PGK, PHP, PKR, PLN, PYG, QAR, RON, RSD, RUB, SAR, SBD, SCR, SDG, SEK, SGD, SHP, SLL, SOS, SRD, SYP, SZL, THB, TJS, TMT, TND, TRY, TTD, TWD, TZS, UAH, UGX, USD, UYU, UZS, VEB, VND, VUV, WST, XAF, XCD, XDR, XOF, XPF, YER, ZAR, ZMK, ZWR

deliveryDate

string

ISO-8601 date format, e.g., 2024-01-01T00:00:00Z

discountPaymentDate

string

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:00Z

discountPaymentDate2

string

The 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:00Z

dueDate

string

ISO-8601 date format, e.g., 2024-01-01T00:00:00Z

iban

string

isPaymentOrder

boolean

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 processed

ledgerName

string

required

The 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 booking proposals, the ledgerName must be of type ACCOUNT_RECEIVABLE, and for BILL booking proposals, it must be of type ACCOUNT_PAYABLE.

lineItems

BookingLineItem[]

required

Show properties

accountName

string

The accountName field specifies the name of the general ledger account linked to the individual line item within the invoice or bill.

accountNumber

number

The accountNumber field specifies the general ledger account linked to the individual line item within the invoice or bill.

bookingTaxCode

string

description

string

dimension1

string

The dimension1 field represents the information for cost accounting (KOST1)

dimension2

string

The dimension2 field represents the information for cost accounting (KOST2)

discountAmount

number

discountAmount2

number

discountPercentage

number

discountPercentage2

number

taxRatePercentage

number

totalGrossAmount

number

required

notes

string

number

string

required

orderId

string

paidDate

string

ISO-8601 date format, e.g., 2024-01-01T00:00:00Z

paymentTermsId

string

totalGrossAmount

number

required

vatId

string

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.

Show properties

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

Show child attributes

bookingType

enum<string>

Available options:

INVOICE,

BILL

files

file[]

Array of files to upload

folderManagement

object

Show child attributes

Response

200 - application/json

Get started

Guides

Integrations

Use cases

API reference

Create bookingproposal

Field support per integration

Headers

Query Parameters

Body

Response

Get started

Guides

Integrations

Use cases

API reference

​Field support per integration

Headers

Query Parameters

Body

Response

Field support per integration