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
Create transaction
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
Array of files to upload
"1"
100
"1"
"2021-01-01T00:00:00Z"
"eaa28f49-6028-4b6e-bb12-d8f6278073fc"
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
"Fee posting category"
"Fee payment"
"Reference"
CREATED
, LINKED
, PRIVATE
, BOOKED
, AUTHORISED
, DELETED
19
RECEIVE
, RECEIVE-OVERPAYMENT
, RECEIVE-PREPAYMENT
, SPEND
, SPEND-OVERPAYMENT
, SPEND-PREPAYMENT
, RECEIVE-TRANSFER
, SPEND-TRANSFER
"2021-01-01T00:00:00Z"
Response
"123456"
"1"
"1234"
100
"2021-01-01T00:00:00Z"
"eaa28f49-6028-4b6e-bb12-d8f6278073fc"
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
"Fee posting category"
"Fee payment"
"Reference"
CREATED
, LINKED
, PRIVATE
, BOOKED
, AUTHORISED
, DELETED
"ADB4457839PXTC2220"
19
RECEIVE
, RECEIVE-OVERPAYMENT
, RECEIVE-PREPAYMENT
, SPEND
, SPEND-OVERPAYMENT
, SPEND-PREPAYMENT
, RECEIVE-TRANSFER
, SPEND-TRANSFER
"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"
}
}