Get started
Integrations
Use cases
API reference
- Accounting
- Overview
- Accounts
- Async Task
- Bills
- Bookings
- Booking Proposals
- Contacts
- Customers
- Dimensions
- Expenses
- Files
- Invoices
- Invoice Lines
- Items
- Journals
- Journal Entries
- Offers
- Offer Lines
- Payments
- Payment Terms
- Projects
- Sales Orders
- Sales Order Lines
- Suppliers
- Tax Rates
- Transactions
- Vendor Credits
- Authentication
- Tenant Management
- User
Bookings
Create bookings
POST
/
accounting
/
bookings
curl --request POST \
--url https://api.maesn.dev/accounting/bookings \
--header 'Content-Type: application/json' \
--header 'X-ACCOUNT-KEY: <x-account-key>' \
--header 'X-API-KEY: <x-api-key>' \
--data '{
"accountLength": "4",
"chartOfAccount": "SKR03",
"entries": [
{
"accountNumber": "1400",
"amount": "1000",
"bookingDate": "2021-01-01T00:00:00Z",
"bookingTaxCode": "9",
"bookingType": "PARTIAL_INVOICE",
"contraAccountNumber": "70000",
"costCenter1": "Cost Center1",
"costCenter2": "Cost Center2",
"currency": "EUR",
"debitCreditIndicator": "DEBIT",
"documentNumber": "1234567890",
"dueDate": "2021-01-01T00:00:00Z",
"fileId": "AA7N4ICJ0SJIU38",
"purpose": "payment"
}
],
"fiscalYearStartDate": "2021-01-01T00:00:00Z"
}'{
"meta": {
"warnings": [
"Field not used by target system"
],
"pagination": {
"total": 123,
"perPage": 123,
"currentPage": 123,
"totalPages": 123
}
},
"data": {
"id": "433445",
"accountLength": "4",
"chartOfAccount": "SKR03",
"entries": [
{
"accountNumber": "1400",
"amount": "1000",
"bookingDate": "2021-01-01T00:00:00Z",
"bookingTaxCode": "9",
"bookingType": "PARTIAL_INVOICE",
"contraAccountNumber": "70000",
"costCenter1": "Cost Center1",
"costCenter2": "Cost Center2",
"currency": "EUR",
"debitCreditIndicator": "DEBIT",
"documentNumber": "1234567890",
"dueDate": "2021-01-01T00:00:00Z",
"fileId": "AA7N4ICJ0SJIU38",
"purpose": "payment"
}
],
"createdDate": "2021-01-01T00:00:00Z",
"fiscalYearStartDate": "2021-01-01T00:00:00Z",
"taskId": "ABBDU8834993NND"
}
}Test Api token:
663222ee
Test Account token:
85b30b51
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.
Please ensure 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:
Available options: SKR03, SKR04, SKR42, SKR51, SKR14
Available options: PARTIAL_INVOICE, ADVANCED_PAYMENT_RECEIVED, FINAL_INVOICE, OTHER
Available options: EUR
Available options: DEBIT, CREDIT
Headers
API key
Example:
"example value"
Account key
Example:
"example value"
Query Parameters
Body
application/json
Example:
"4"
Available options:
SKR03, SKR04, SKR42, SKR51, SKR14 Example:
"SKR03"
Example:
"1400"
Example:
"1000"
Example:
"2021-01-01T00:00:00Z"
Example:
"9"
Available options:
PARTIAL_INVOICE, ADVANCED_PAYMENT_RECEIVED, FINAL_INVOICE, OTHER Example:
"PARTIAL_INVOICE"
Example:
"70000"
Example:
"Cost Center1"
Example:
"Cost Center2"
Available options:
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 Example:
"EUR"
Available options:
DEBIT, CREDIT Example:
"1234567890"
Example:
"2021-01-01T00:00:00Z"
Example:
"AA7N4ICJ0SJIU38"
Example:
"payment"
Example:
"2021-01-01T00:00:00Z"
Response
200 - application/json
Example:
"433445"
Example:
"4"
Available options:
SKR03, SKR04, SKR42, SKR51, SKR14 Example:
"SKR03"
Example:
"1400"
Example:
"1000"
Example:
"2021-01-01T00:00:00Z"
Example:
"9"
Available options:
PARTIAL_INVOICE, ADVANCED_PAYMENT_RECEIVED, FINAL_INVOICE, OTHER Example:
"PARTIAL_INVOICE"
Example:
"70000"
Example:
"Cost Center1"
Example:
"Cost Center2"
Available options:
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 Example:
"EUR"
Available options:
DEBIT, CREDIT Example:
"1234567890"
Example:
"2021-01-01T00:00:00Z"
Example:
"AA7N4ICJ0SJIU38"
Example:
"payment"
Example:
"2021-01-01T00:00:00Z"
Example:
"2021-01-01T00:00:00Z"
Example:
"ABBDU8834993NND"
Was this page helpful?
curl --request POST \
--url https://api.maesn.dev/accounting/bookings \
--header 'Content-Type: application/json' \
--header 'X-ACCOUNT-KEY: <x-account-key>' \
--header 'X-API-KEY: <x-api-key>' \
--data '{
"accountLength": "4",
"chartOfAccount": "SKR03",
"entries": [
{
"accountNumber": "1400",
"amount": "1000",
"bookingDate": "2021-01-01T00:00:00Z",
"bookingTaxCode": "9",
"bookingType": "PARTIAL_INVOICE",
"contraAccountNumber": "70000",
"costCenter1": "Cost Center1",
"costCenter2": "Cost Center2",
"currency": "EUR",
"debitCreditIndicator": "DEBIT",
"documentNumber": "1234567890",
"dueDate": "2021-01-01T00:00:00Z",
"fileId": "AA7N4ICJ0SJIU38",
"purpose": "payment"
}
],
"fiscalYearStartDate": "2021-01-01T00:00:00Z"
}'{
"meta": {
"warnings": [
"Field not used by target system"
],
"pagination": {
"total": 123,
"perPage": 123,
"currentPage": 123,
"totalPages": 123
}
},
"data": {
"id": "433445",
"accountLength": "4",
"chartOfAccount": "SKR03",
"entries": [
{
"accountNumber": "1400",
"amount": "1000",
"bookingDate": "2021-01-01T00:00:00Z",
"bookingTaxCode": "9",
"bookingType": "PARTIAL_INVOICE",
"contraAccountNumber": "70000",
"costCenter1": "Cost Center1",
"costCenter2": "Cost Center2",
"currency": "EUR",
"debitCreditIndicator": "DEBIT",
"documentNumber": "1234567890",
"dueDate": "2021-01-01T00:00:00Z",
"fileId": "AA7N4ICJ0SJIU38",
"purpose": "payment"
}
],
"createdDate": "2021-01-01T00:00:00Z",
"fiscalYearStartDate": "2021-01-01T00:00:00Z",
"taskId": "ABBDU8834993NND"
}
}