Get started
Integrations
Use cases
API reference
- Accounting
- Overview
- Accounts
- Async Task
- Contacts
- Customers
- Dimensions
- Expenses
- Files
- Invoices
- Invoice Lines
- Items
- Journals
- Offers
- Offer Lines
- Payment Terms
- Projects
- Sales Orders
- Sales Order Lines
- Suppliers
- Tracking categories
- Tax Rates
- Transactions
- Authentication
- Tenant Management
- User
Transactions
Create transaction
POST
/
accounting
/
transactions
curl --request POST \
--url https://api.maesn.dev/accounting/transactions \
--header 'Content-Type: multipart/form-data' \
--header 'X-ACCOUNT-KEY: <x-account-key>' \
--header 'X-API-KEY: <x-api-key>' \
--form 'files=[
null
]' \
--form 'transaction={
"accountId": "1",
"accountNumber": "1",
"amount": 100,
"bookingDate": "2021-01-01T00:00:00Z",
"contact": "eaa28f49-6028-4b6e-bb12-d8f6278073fc",
"currency": "AED",
"feeAmount": 123,
"feePostingCategory": "Fee posting category",
"feeTaxRatePercentage": 123,
"purpose": "Fee payment",
"reference": "Reference",
"status": "CREATED",
"taxRatePercentage": 19,
"type": "RECEIVE",
"valueDate": "2021-01-01T00:00:00Z"
}'{
"meta": {
"warnings": [
"Field not used by target system"
],
"pagination": {
"total": 123,
"perPage": 123,
"currentPage": 123,
"totalPages": 123
}
},
"data": {
"id": "123456",
"accountId": "1",
"accountNumber": "1234",
"amount": 100,
"bookingDate": "2021-01-01T00:00:00Z",
"contact": "eaa28f49-6028-4b6e-bb12-d8f6278073fc",
"currency": "AED",
"feeAmount": 123,
"feePostingCategory": "Fee posting category",
"feeTaxRatePercentage": 123,
"files": [
"file1.pdf"
],
"purpose": "Fee payment",
"reference": "Reference",
"status": "CREATED",
"taskId": "ADB4457839PXTC2220",
"taxRatePercentage": 19,
"type": "RECEIVE",
"valueDate": "2021-01-01T00:00:00Z"
}
}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:
Query Parameters
Body
multipart/form-data
Array of files to upload
Example:
"1"
Example:
100
Example:
"1"
Example:
"2021-01-01T00:00:00Z"
Example:
"eaa28f49-6028-4b6e-bb12-d8f6278073fc"
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:
"Fee posting category"
Example:
"Fee payment"
Example:
"Reference"
Available options:
CREATED, LINKED, PRIVATE, BOOKED, AUTHORISED, DELETED Example:
19
Available options:
RECEIVE, RECEIVE-OVERPAYMENT, RECEIVE-PREPAYMENT, SPEND, SPEND-OVERPAYMENT, SPEND-PREPAYMENT, RECEIVE-TRANSFER, SPEND-TRANSFER Example:
"2021-01-01T00:00:00Z"
Response
200 - application/json
Example:
"123456"
Example:
"1"
Example:
"1234"
Example:
100
Example:
"2021-01-01T00:00:00Z"
Example:
"eaa28f49-6028-4b6e-bb12-d8f6278073fc"
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:
"Fee posting category"
Example:
"Fee payment"
Example:
"Reference"
Available options:
CREATED, LINKED, PRIVATE, BOOKED, AUTHORISED, DELETED Example:
"ADB4457839PXTC2220"
Example:
19
Available options:
RECEIVE, RECEIVE-OVERPAYMENT, RECEIVE-PREPAYMENT, SPEND, SPEND-OVERPAYMENT, SPEND-PREPAYMENT, RECEIVE-TRANSFER, SPEND-TRANSFER Example:
"2021-01-01T00:00:00Z"
Was this page helpful?
curl --request POST \
--url https://api.maesn.dev/accounting/transactions \
--header 'Content-Type: multipart/form-data' \
--header 'X-ACCOUNT-KEY: <x-account-key>' \
--header 'X-API-KEY: <x-api-key>' \
--form 'files=[
null
]' \
--form 'transaction={
"accountId": "1",
"accountNumber": "1",
"amount": 100,
"bookingDate": "2021-01-01T00:00:00Z",
"contact": "eaa28f49-6028-4b6e-bb12-d8f6278073fc",
"currency": "AED",
"feeAmount": 123,
"feePostingCategory": "Fee posting category",
"feeTaxRatePercentage": 123,
"purpose": "Fee payment",
"reference": "Reference",
"status": "CREATED",
"taxRatePercentage": 19,
"type": "RECEIVE",
"valueDate": "2021-01-01T00:00:00Z"
}'{
"meta": {
"warnings": [
"Field not used by target system"
],
"pagination": {
"total": 123,
"perPage": 123,
"currentPage": 123,
"totalPages": 123
}
},
"data": {
"id": "123456",
"accountId": "1",
"accountNumber": "1234",
"amount": 100,
"bookingDate": "2021-01-01T00:00:00Z",
"contact": "eaa28f49-6028-4b6e-bb12-d8f6278073fc",
"currency": "AED",
"feeAmount": 123,
"feePostingCategory": "Fee posting category",
"feeTaxRatePercentage": 123,
"files": [
"file1.pdf"
],
"purpose": "Fee payment",
"reference": "Reference",
"status": "CREATED",
"taskId": "ADB4457839PXTC2220",
"taxRatePercentage": 19,
"type": "RECEIVE",
"valueDate": "2021-01-01T00:00:00Z"
}
}