Create transaction

cURL

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 'transaction={
  "id": "f733a433-9662-4a40-8e36-e38ebda94fe1",
  "accountId": "14a6b5e92-a261-4be9-814d-84dec9636c16",
  "accountNumber": 4900,
  "amount": 100,
  "bookingDate": "2025-07-15T00:00:00Z",
  "contact": "eaa28f49-6028-4b6e-bb12-d8f6278073fc",
  "currency": "EUR",
  "description": "Hotel for dreamforce",
  "journalCode": "31",
  "ledgerName": "Payroll",
  "reference": "RCXF197253F",
  "status": "CREATED",
  "taxRatePercentage": 19,
  "type": "SPEND",
  "valueDate": "2025-07-15T00:00:00Z"
}'

{
  "meta": {
    "warnings": [
      "Field not used by target system"
    ],
    "pagination": {
      "total": 123,
      "perPage": 123,
      "currentPage": 123,
      "totalPages": 123
    }
  },
  "data": {
    "id": "f733a433-9662-4a40-8e36-e38ebda94fe1",
    "accountId": "14a6b5e92-a261-4be9-814d-84dec9636c16",
    "accountNumber": 4900,
    "amount": 100,
    "bookingDate": "2025-07-15T00:00:00Z",
    "contact": "eaa28f49-6028-4b6e-bb12-d8f6278073fc",
    "currency": "EUR",
    "description": "Hotel for dreamforce",
    "files": [
      "file1.pdf"
    ],
    "journalCode": "31",
    "ledgerName": "Payroll",
    "reference": "RCXF197253F",
    "status": "CREATED",
    "taskId": "ADB4457839PXTC2220",
    "taxRatePercentage": 19,
    "type": "SPEND",
    "valueDate": "2025-07-15T00:00:00Z"
  }
}

POST

accounting

transactions

cURL

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 'transaction={
  "id": "f733a433-9662-4a40-8e36-e38ebda94fe1",
  "accountId": "14a6b5e92-a261-4be9-814d-84dec9636c16",
  "accountNumber": 4900,
  "amount": 100,
  "bookingDate": "2025-07-15T00:00:00Z",
  "contact": "eaa28f49-6028-4b6e-bb12-d8f6278073fc",
  "currency": "EUR",
  "description": "Hotel for dreamforce",
  "journalCode": "31",
  "ledgerName": "Payroll",
  "reference": "RCXF197253F",
  "status": "CREATED",
  "taxRatePercentage": 19,
  "type": "SPEND",
  "valueDate": "2025-07-15T00:00:00Z"
}'

{
  "meta": {
    "warnings": [
      "Field not used by target system"
    ],
    "pagination": {
      "total": 123,
      "perPage": 123,
      "currentPage": 123,
      "totalPages": 123
    }
  },
  "data": {
    "id": "f733a433-9662-4a40-8e36-e38ebda94fe1",
    "accountId": "14a6b5e92-a261-4be9-814d-84dec9636c16",
    "accountNumber": 4900,
    "amount": 100,
    "bookingDate": "2025-07-15T00:00:00Z",
    "contact": "eaa28f49-6028-4b6e-bb12-d8f6278073fc",
    "currency": "EUR",
    "description": "Hotel for dreamforce",
    "files": [
      "file1.pdf"
    ],
    "journalCode": "31",
    "ledgerName": "Payroll",
    "reference": "RCXF197253F",
    "status": "CREATED",
    "taskId": "ADB4457839PXTC2220",
    "taxRatePercentage": 19,
    "type": "SPEND",
    "valueDate": "2025-07-15T00:00:00Z"
  }
}

Field support per integration

DATEV Unternehmen Online

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.

If you’re not using the Interactive Authentication Flow, make sure 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:

transaction

string

required

Show properties

string

required

The id field is the identifier for the transaction.

accountNumber

number

required

The accountNumber field specifies the general ledger account linked to the transaction.

amount

number

required

bookingDate

string

required

currency

enum

required

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

description

string

required

ledgerName

string

required

The ledgerName field represents the name of the correct ledger folder where the data will be sent to.To get the correct name, you can use the GET Accounts endpoint.

The ledgerName must be of type CASH.

taxRatePercentage

number

required

files

file[]

Exact

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:

transaction

string

required

Show properties

accountId

string

required

The accountId is the id of the GL account related to the transaction.You can obtain this value by using the GET Accounts endpoint.

amount

number

required

bookingDate

string

contact

string

currency

enum

description

string

journalCode

string

required

reference

string

status

string

taxRatePercentage

string

Lexware Office

Supported Request Fields:

transaction

string

required

Show properties

accountId

string

required

The accountId is the id of the bank account related to the transaction.

amount

number

required

bookingDate

string

required

description

string

required

reference

string

valueDate

string

required

sevdesk

Supported Request Fields:

transaction

string

required

Show properties

accountId

string

required

The accountId is the id of the bank account related to the transaction.You can obtain this value by using the GET Bank Accounts endpoint.

amount

number

required

contact

string

required

description

string

status

enum

required

Available options: CREATED, LINKED, PRIVATE, BOOKED

valueDate

string

required

Headers

X-API-KEY

string

required

API key

X-ACCOUNT-KEY

string

required

Account key

Query Parameters

companyId

string

journalCode

string

Body

multipart/form-data

files

file[]

Array of files to upload

transaction

object

Show child attributes

Response

200 - application/json

Get started

Guides

Integrations

Use cases

API reference

Create transaction

Field support per integration

Headers

Query Parameters

Body

Response

Get started

Guides

Integrations

Use cases

API reference

​Field support per integration

Headers

Query Parameters

Body

Response

Field support per integration