Get started
Integrations
Use cases
API reference
- Accounting
- Overview
- Accounts
- Async Task
- Contacts
- Customers
- Expenses
- Files
- Invoices
- Invoice Lines
- Items
- Journals
- Offers
- Offer Lines
- Projects
- Sales Orders
- Sales Order Lines
- Suppliers
- Tracking categories
- Transactions
- 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 'metadata=[
{
"documentType": "<string>",
"integrationSource": "<string>",
"note": "<string>"
}
]' \
--form 'journal_entry={
"accountId": "accounting period id",
"accountingPeriodId": "accounting period id",
"chartOfAccount": "SKR03",
"companyId": "company id",
"currency": "EUR",
"journalLineItems": [
{
"accountId": "account id",
"currency": "EUR",
"customerId": "customer id",
"description": "description",
"exchangeRate": "19",
"supplierId": "supplier id",
"taxRate": {
"id": "tax rate id",
"code": "code",
"name": "name",
"taxRatePercentage": "tax rate percentage"
},
"thirdPartyCode": "112233",
"totalGrossAmount": "100",
"totalNetAmount": "100",
"totalTaxAmount": "19",
"trackingCategories": [
{
"id": "tracking category id",
"name": "name"
}
]
}
],
"journalType": "FIN",
"memo": "memo",
"number ": "number",
"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": "account id",
"accountingPeriodId": "accounting period id",
"chartOfAccount": "SKR03",
"companyId": "company id",
"createdDate": "2021-01-01T00:00:00Z",
"currency": "EUR",
"files": [
"file1.pdf"
],
"journalLineItems": [
{
"id": "line item id",
"accountId": "account id",
"createdDate ": "2021-01-01T00:00:00Z",
"currency": "EUR",
"customerId": "customer id",
"description": "description",
"exchangeRate": "19",
"supplierId": "supplier id",
"taxRate": {
"id": "tax rate id",
"code": "code",
"name": "name",
"taxRatePercentage": "tax rate percentage"
},
"thirdPartyCode": "112233",
"totalGrossAmount": "119",
"totalNetAmount": "100",
"totalTaxAmount": "19",
"trackingCategories": [
{
"id": "tracking category id",
"name": "name"
}
],
"updatedDate": "2021-01-01T00:00:00Z"
}
],
"journalType": "FIN",
"memo": "memo",
"number ": "number",
"taskId ": "ADB4457839PXTC2220",
"transactionDate": "2021-01-01T00:00:00Z",
"updatedDate": "2021-01-01T00:00:00Z"
}
]
}Test Api token:
663222ee
Test Account token:
85b30b51
Field support per integration
Please ensure the query parameters environmentName and companyId are accurately populated with the appropriate environment and company ID.
You can obtain these values by using the GET Environments and GET Companies endpoints available under the Authentication section.
Supported Request Parameters:
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.
The metadata field is required when uploading files. Each file requires a unique metadata field.
Supported Request Parameters:
Available options:
SKR03, SKR04, SKR42, SKR51, SKR14
Available options (3-letter ISO 4217):
EUR
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 (3-letter ISO 4217):
EUR
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
Please ensure the query parameters environmentName and companyId are accurately populated with the appropriate environment and company ID.
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:
Headers
API key
"example value"
Account key
"example value"
Body
Array of files to upload
"accounting period id"
"accounting period id"
SKR03, SKR04, SKR42, SKR51, SKR14 "SKR03"
"company id"
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 "EUR"
"account id"
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 "EUR"
"customer id"
"description"
"19"
"supplier id"
"112233"
"100"
"100"
"19"
"FIN"
"memo"
"number"
"2021-01-01T00:00:00Z"
Response
"1"
"account id"
"accounting period id"
SKR03, SKR04, SKR42, SKR51, SKR14 "SKR03"
"company id"
"2021-01-01T00:00:00Z"
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 "EUR"
"line item id"
"account id"
"2021-01-01T00:00:00Z"
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 "EUR"
"customer id"
"description"
"19"
"supplier id"
"112233"
"119"
"100"
"19"
"2021-01-01T00:00:00Z"
"FIN"
"memo"
"number"
"ADB4457839PXTC2220"
"2021-01-01T00:00:00Z"
"2021-01-01T00:00:00Z"
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 'metadata=[
{
"documentType": "<string>",
"integrationSource": "<string>",
"note": "<string>"
}
]' \
--form 'journal_entry={
"accountId": "accounting period id",
"accountingPeriodId": "accounting period id",
"chartOfAccount": "SKR03",
"companyId": "company id",
"currency": "EUR",
"journalLineItems": [
{
"accountId": "account id",
"currency": "EUR",
"customerId": "customer id",
"description": "description",
"exchangeRate": "19",
"supplierId": "supplier id",
"taxRate": {
"id": "tax rate id",
"code": "code",
"name": "name",
"taxRatePercentage": "tax rate percentage"
},
"thirdPartyCode": "112233",
"totalGrossAmount": "100",
"totalNetAmount": "100",
"totalTaxAmount": "19",
"trackingCategories": [
{
"id": "tracking category id",
"name": "name"
}
]
}
],
"journalType": "FIN",
"memo": "memo",
"number ": "number",
"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": "account id",
"accountingPeriodId": "accounting period id",
"chartOfAccount": "SKR03",
"companyId": "company id",
"createdDate": "2021-01-01T00:00:00Z",
"currency": "EUR",
"files": [
"file1.pdf"
],
"journalLineItems": [
{
"id": "line item id",
"accountId": "account id",
"createdDate ": "2021-01-01T00:00:00Z",
"currency": "EUR",
"customerId": "customer id",
"description": "description",
"exchangeRate": "19",
"supplierId": "supplier id",
"taxRate": {
"id": "tax rate id",
"code": "code",
"name": "name",
"taxRatePercentage": "tax rate percentage"
},
"thirdPartyCode": "112233",
"totalGrossAmount": "119",
"totalNetAmount": "100",
"totalTaxAmount": "19",
"trackingCategories": [
{
"id": "tracking category id",
"name": "name"
}
],
"updatedDate": "2021-01-01T00:00:00Z"
}
],
"journalType": "FIN",
"memo": "memo",
"number ": "number",
"taskId ": "ADB4457839PXTC2220",
"transactionDate": "2021-01-01T00:00:00Z",
"updatedDate": "2021-01-01T00:00:00Z"
}
]
}