Get started
Integrations
Use cases
API reference
- Accounting
- Overview
- Accounts
- Async Task
- Bills
- Bill Lines
- 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
Create journalentry
curl --request POST \
--url https://api.maesn.dev/accounting/journalEntries \
--header 'Content-Type: multipart/form-data' \
--header 'X-ACCOUNT-KEY: <x-account-key>' \
--header 'X-API-KEY: <x-api-key>' \
--form 'files=[
null
]' \
--form 'filesPos=[
123
]' \
--form 'journal_entry={
"accountId": "d1bfd23-517d-4ec6-b7d4-56f86c7cf246",
"accountingPeriodId": "2021-06",
"companyId": "334455",
"currency": "EUR",
"documentId": "documentId",
"journalLineItems": [
{
"accountId": "94fdb7fd-13ae-47a6-8a2a-000e6ddc60d9",
"currency": "EUR",
"customerId": "782d89b56-13ae-47a6-8a2a-45e6ddc50d9",
"description": "Uitgesteld 21600001 Kantoor 01-01-2021-31-12-2021",
"documentNumber": "123456789",
"exchangeRate": "19",
"supplierId": "998933b56-13ae-47a6-8a32a-45e6ddc50d9",
"taxRate": {
"id": "1895b05b-38a6-4a6a-9653-166389894350",
"code": "03",
"name": "Tax rate name",
"taxRatePercentage": 21
},
"thirdPartyCode": "112233",
"totalGrossAmount": "1190",
"totalNetAmount": "1000",
"totalTaxAmount": "190",
"trackingCategories": [
{
"id": "efa82f42-fd85-11e1-a21f-0800200c9a33",
"name": "Material/Waren"
}
]
}
],
"journalType": "FIN",
"memo": "new journal entry",
"number ": "21900030",
"transactionDate": "2021-01-01T00:00:00Z"
}'
{
"meta": {
"warnings": [
"Field not used by target system"
],
"pagination": {
"total": 123,
"perPage": 123,
"currentPage": 123,
"totalPages": 123
}
},
"data": [
{
"id": "1",
"accountId": "94fdb7fd-13ae-47a6-8a2a-000e6ddc60d9",
"accountingPeriodId": "2021-06",
"companyId": "334455",
"createdDate": "2021-01-01T00:00:00Z",
"currency": "EUR",
"documentId": "documentId",
"files": [
"file1.pdf"
],
"journalLineItems": [
{
"id": "94fdb7fd-13ae-47a6-8a2a-000e6ddc60d9",
"accountId": "da33b47c-98ca-4410-9c59-5db485ecaeb0",
"createdDate ": "2021-01-01T00:00:00Z",
"currency": "EUR",
"customerId": "782d89b56-13ae-47a6-8a2a-45e6ddc50d9",
"description": "Uitgesteld 21600001 Kantoor 01-01-2021-31-12-2021",
"documentNumber": "123456789",
"exchangeRate": "19",
"supplierId": "998933b56-13ae-47a6-8a32a-45e6ddc50d9",
"taxRate": {
"id": "1895b05b-38a6-4a6a-9653-166389894350",
"code": "03",
"name": "Tax rate name",
"taxRatePercentage": 21
},
"thirdPartyCode": "112233",
"totalGrossAmount": "1190",
"totalNetAmount": "1000",
"totalTaxAmount": "190",
"trackingCategories": [
{
"id": "efa82f42-fd85-11e1-a21f-0800200c9a33",
"name": "Material/Waren"
}
],
"updatedDate": "2021-01-01T00:00:00Z"
}
],
"journalType": "FIN",
"memo": "new journal entry",
"number ": "21900030",
"taskId ": "ADB4457839PXTC2220",
"transactionDate": "2021-01-01T00:00:00Z",
"updatedDate": "2021-01-01T00:00:00Z"
}
]
}
Field support per integration
If you’re not using the Interactive Authentication Flow, make sure the query parameters environmentName
and companyId
are correctly populated.
You can obtain these values by using the GET Environments
and GET Companies
endpoints available under the Authentication section.
Supported Request Parameters:
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:
The filesPos
field is an array of line item positions (starting from 1) that correspond to each uploaded file.
The value at index i
in filesPos refers to the line item that the file at index i
in the files array should be linked to.
This field is required when uploading files.
Example:
If you’re uploading 2 files, and you want to link the first file to line item 1 and the second file to line item 3:
filesPos: [1, 3]
If you’re not using the Interactive Authentication Flow, make sure the query parameters environmentName
and companyId
are correctly populated.
You can obtain these values by using the GET Companies
endpoint available under the Authentication section. Please use the id field as the companyId and the environmentId field as the environmentName.
Supported Response Fields:
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 Fields:
Supported Request Parameters:
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
Headers
API key
"example value"
Account key
"example value"
Body
Response
The response is of type object
.
Was this page helpful?
curl --request POST \
--url https://api.maesn.dev/accounting/journalEntries \
--header 'Content-Type: multipart/form-data' \
--header 'X-ACCOUNT-KEY: <x-account-key>' \
--header 'X-API-KEY: <x-api-key>' \
--form 'files=[
null
]' \
--form 'filesPos=[
123
]' \
--form 'journal_entry={
"accountId": "d1bfd23-517d-4ec6-b7d4-56f86c7cf246",
"accountingPeriodId": "2021-06",
"companyId": "334455",
"currency": "EUR",
"documentId": "documentId",
"journalLineItems": [
{
"accountId": "94fdb7fd-13ae-47a6-8a2a-000e6ddc60d9",
"currency": "EUR",
"customerId": "782d89b56-13ae-47a6-8a2a-45e6ddc50d9",
"description": "Uitgesteld 21600001 Kantoor 01-01-2021-31-12-2021",
"documentNumber": "123456789",
"exchangeRate": "19",
"supplierId": "998933b56-13ae-47a6-8a32a-45e6ddc50d9",
"taxRate": {
"id": "1895b05b-38a6-4a6a-9653-166389894350",
"code": "03",
"name": "Tax rate name",
"taxRatePercentage": 21
},
"thirdPartyCode": "112233",
"totalGrossAmount": "1190",
"totalNetAmount": "1000",
"totalTaxAmount": "190",
"trackingCategories": [
{
"id": "efa82f42-fd85-11e1-a21f-0800200c9a33",
"name": "Material/Waren"
}
]
}
],
"journalType": "FIN",
"memo": "new journal entry",
"number ": "21900030",
"transactionDate": "2021-01-01T00:00:00Z"
}'
{
"meta": {
"warnings": [
"Field not used by target system"
],
"pagination": {
"total": 123,
"perPage": 123,
"currentPage": 123,
"totalPages": 123
}
},
"data": [
{
"id": "1",
"accountId": "94fdb7fd-13ae-47a6-8a2a-000e6ddc60d9",
"accountingPeriodId": "2021-06",
"companyId": "334455",
"createdDate": "2021-01-01T00:00:00Z",
"currency": "EUR",
"documentId": "documentId",
"files": [
"file1.pdf"
],
"journalLineItems": [
{
"id": "94fdb7fd-13ae-47a6-8a2a-000e6ddc60d9",
"accountId": "da33b47c-98ca-4410-9c59-5db485ecaeb0",
"createdDate ": "2021-01-01T00:00:00Z",
"currency": "EUR",
"customerId": "782d89b56-13ae-47a6-8a2a-45e6ddc50d9",
"description": "Uitgesteld 21600001 Kantoor 01-01-2021-31-12-2021",
"documentNumber": "123456789",
"exchangeRate": "19",
"supplierId": "998933b56-13ae-47a6-8a32a-45e6ddc50d9",
"taxRate": {
"id": "1895b05b-38a6-4a6a-9653-166389894350",
"code": "03",
"name": "Tax rate name",
"taxRatePercentage": 21
},
"thirdPartyCode": "112233",
"totalGrossAmount": "1190",
"totalNetAmount": "1000",
"totalTaxAmount": "190",
"trackingCategories": [
{
"id": "efa82f42-fd85-11e1-a21f-0800200c9a33",
"name": "Material/Waren"
}
],
"updatedDate": "2021-01-01T00:00:00Z"
}
],
"journalType": "FIN",
"memo": "new journal entry",
"number ": "21900030",
"taskId ": "ADB4457839PXTC2220",
"transactionDate": "2021-01-01T00:00:00Z",
"updatedDate": "2021-01-01T00:00:00Z"
}
]
}