Create expense

cURL

curl --request POST \
  --url https://api.maesn.dev/accounting/expenses \
  --header 'Content-Type: multipart/form-data' \
  --header 'X-ACCOUNT-KEY: <x-account-key>' \
  --header 'X-API-KEY: <x-api-key>' \
  --form 'expense={
  "id ": "9dea18d2-748e-4bda-9f4c-02b08a9622cd",
  "accountCode ": "200",
  "accountId ": "6527a18d2-748e-4bda-9f4c-02b08a9622cd",
  "accountNumber ": 70000,
  "currency": "EUR",
  "customerId": "8a32de4f-55cc-4962-b000-a2a20662b821",
  "description": "Expense_07/25 for business trip",
  "documentId": "c77fbedb-1ff3-4fed-8716-4d3e3fc85ccf",
  "exchangeRate": "1",
  "expenseLines": [
    {
      "id": "b9dade6b-2b69-42c9-bcd4-841960f6cd9f",
      "accountCode": "200",
      "accountId": "56dec6c2-b14c-43ea-87bb-cc67b0ba2545",
      "accountNumber": 4900,
      "currency": "EUR",
      "description": "Gasoline for business trip",
      "dimensions": [
        {
          "id": "efa82f42-fd85-11e1-a21f-0800200c9a33",
          "name": "Material/Waren"
        }
      ],
      "documentNumber": "EXP-12345",
      "exchangeRate": 1,
      "itemId": "9fc4f3a2-5b8e-4d1b-8a0c-9f6e7d2f3e4b",
      "taxRate": {
        "id": "1895b05b-38a6-4a6a-9653-166389894350",
        "code": "03",
        "name": "Tax19",
        "taxRatePercentage": "19"
      },
      "totalGrossAmount": 119,
      "totalNetAmount": 100
    }
  ],
  "journalCode": "60",
  "ledgerName": "Payroll",
  "note": "Gasoline for business trip",
  "paymentTermId": "d2f3e4b5-6a7b-8c9d-0e1f-2g3h4i5j6k7l",
  "paymentType": "CASH",
  "supplierId": "52c049b9-91b7-4828-b346-e1eeadfa31dd",
  "type": "EXPENSE",
  "totalGrossAmount": 119,
  "totalNetAmount": 100,
  "totalTaxAmount": 5,
  "transactionDate": "2025-07-15T00:00:00Z"
}'

{
  "meta": {
    "warnings": [
      "Field not used by target system"
    ],
    "pagination": {
      "total": 123,
      "perPage": 123,
      "currentPage": 123,
      "totalPages": 123
    }
  },
  "data": {
    "id": "9dea18d2-748e-4bda-9f4c-02b08a9622cd",
    "accountCode ": "200",
    "accountId ": "6527a18d2-748e-4bda-9f4c-02b08a9622cd",
    "accountNumber ": 70000,
    "createdDate": "2025-07-15T00:00:00Z",
    "currency": "EUR",
    "customerId": "8a32de4f-55cc-4962-b000-a2a20662b821",
    "description": "Expense_07/25 for business trip",
    "documentId": "c77fbedb-1ff3-4fed-8716-4d3e3fc85ccf",
    "exchangeRate": "1",
    "expenseLines": [
      {
        "id": "b9dade6b-2b69-42c9-bcd4-841960f6cd9f",
        "accountCode": "200",
        "accountId": "56dec6c2-b14c-43ea-87bb-cc67b0ba2545",
        "accountNumber": 4900,
        "createdDate ": "2025-07-15T00:00:00Z",
        "currency": "EUR",
        "description": "Gasoline for business trip",
        "dimensions": [
          {
            "id": "efa82f42-fd85-11e1-a21f-0800200c9a33",
            "name": "Material/Waren"
          }
        ],
        "documentNumber": "EXP-12345",
        "exchangeRate": 1,
        "itemId": "9fc4f3a2-5b8e-4d1b-8a0c-9f6e7d2f3e4b",
        "taxRate": {
          "id": "1895b05b-38a6-4a6a-9653-166389894350",
          "code": "03",
          "name": "Tax19",
          "taxRatePercentage": "19"
        },
        "totalGrossAmount": 119,
        "totalNetAmount": 100,
        "updatedDate": "2025-07-15T00:00:00Z"
      }
    ],
    "files": [
      "file1.pdf"
    ],
    "journalCode": "60",
    "ledgerName": "Payroll",
    "note": "Gasoline for business trip",
    "paymentTermId": "d2f3e4b5-6a7b-8c9d-0e1f-2g3h4i5j6k7l",
    "paymentType": "CASH",
    "supplierId": "52c049b9-91b7-4828-b346-e1eeadfa31dd",
    "taskId ": "ADB4457839PXTC2220",
    "type": "EXPENSE",
    "totalGrossAmount": 119,
    "totalNetAmount": 100,
    "totalTaxAmount": 19,
    "transactionDate": "2025-07-15T00:00:00Z",
    "updatedDate": "2025-07-15T00:00:00Z"
  }
}

POST

accounting

expenses

cURL

curl --request POST \
  --url https://api.maesn.dev/accounting/expenses \
  --header 'Content-Type: multipart/form-data' \
  --header 'X-ACCOUNT-KEY: <x-account-key>' \
  --header 'X-API-KEY: <x-api-key>' \
  --form 'expense={
  "id ": "9dea18d2-748e-4bda-9f4c-02b08a9622cd",
  "accountCode ": "200",
  "accountId ": "6527a18d2-748e-4bda-9f4c-02b08a9622cd",
  "accountNumber ": 70000,
  "currency": "EUR",
  "customerId": "8a32de4f-55cc-4962-b000-a2a20662b821",
  "description": "Expense_07/25 for business trip",
  "documentId": "c77fbedb-1ff3-4fed-8716-4d3e3fc85ccf",
  "exchangeRate": "1",
  "expenseLines": [
    {
      "id": "b9dade6b-2b69-42c9-bcd4-841960f6cd9f",
      "accountCode": "200",
      "accountId": "56dec6c2-b14c-43ea-87bb-cc67b0ba2545",
      "accountNumber": 4900,
      "currency": "EUR",
      "description": "Gasoline for business trip",
      "dimensions": [
        {
          "id": "efa82f42-fd85-11e1-a21f-0800200c9a33",
          "name": "Material/Waren"
        }
      ],
      "documentNumber": "EXP-12345",
      "exchangeRate": 1,
      "itemId": "9fc4f3a2-5b8e-4d1b-8a0c-9f6e7d2f3e4b",
      "taxRate": {
        "id": "1895b05b-38a6-4a6a-9653-166389894350",
        "code": "03",
        "name": "Tax19",
        "taxRatePercentage": "19"
      },
      "totalGrossAmount": 119,
      "totalNetAmount": 100
    }
  ],
  "journalCode": "60",
  "ledgerName": "Payroll",
  "note": "Gasoline for business trip",
  "paymentTermId": "d2f3e4b5-6a7b-8c9d-0e1f-2g3h4i5j6k7l",
  "paymentType": "CASH",
  "supplierId": "52c049b9-91b7-4828-b346-e1eeadfa31dd",
  "type": "EXPENSE",
  "totalGrossAmount": 119,
  "totalNetAmount": 100,
  "totalTaxAmount": 5,
  "transactionDate": "2025-07-15T00:00:00Z"
}'

{
  "meta": {
    "warnings": [
      "Field not used by target system"
    ],
    "pagination": {
      "total": 123,
      "perPage": 123,
      "currentPage": 123,
      "totalPages": 123
    }
  },
  "data": {
    "id": "9dea18d2-748e-4bda-9f4c-02b08a9622cd",
    "accountCode ": "200",
    "accountId ": "6527a18d2-748e-4bda-9f4c-02b08a9622cd",
    "accountNumber ": 70000,
    "createdDate": "2025-07-15T00:00:00Z",
    "currency": "EUR",
    "customerId": "8a32de4f-55cc-4962-b000-a2a20662b821",
    "description": "Expense_07/25 for business trip",
    "documentId": "c77fbedb-1ff3-4fed-8716-4d3e3fc85ccf",
    "exchangeRate": "1",
    "expenseLines": [
      {
        "id": "b9dade6b-2b69-42c9-bcd4-841960f6cd9f",
        "accountCode": "200",
        "accountId": "56dec6c2-b14c-43ea-87bb-cc67b0ba2545",
        "accountNumber": 4900,
        "createdDate ": "2025-07-15T00:00:00Z",
        "currency": "EUR",
        "description": "Gasoline for business trip",
        "dimensions": [
          {
            "id": "efa82f42-fd85-11e1-a21f-0800200c9a33",
            "name": "Material/Waren"
          }
        ],
        "documentNumber": "EXP-12345",
        "exchangeRate": 1,
        "itemId": "9fc4f3a2-5b8e-4d1b-8a0c-9f6e7d2f3e4b",
        "taxRate": {
          "id": "1895b05b-38a6-4a6a-9653-166389894350",
          "code": "03",
          "name": "Tax19",
          "taxRatePercentage": "19"
        },
        "totalGrossAmount": 119,
        "totalNetAmount": 100,
        "updatedDate": "2025-07-15T00:00:00Z"
      }
    ],
    "files": [
      "file1.pdf"
    ],
    "journalCode": "60",
    "ledgerName": "Payroll",
    "note": "Gasoline for business trip",
    "paymentTermId": "d2f3e4b5-6a7b-8c9d-0e1f-2g3h4i5j6k7l",
    "paymentType": "CASH",
    "supplierId": "52c049b9-91b7-4828-b346-e1eeadfa31dd",
    "taskId ": "ADB4457839PXTC2220",
    "type": "EXPENSE",
    "totalGrossAmount": 119,
    "totalNetAmount": 100,
    "totalTaxAmount": 19,
    "transactionDate": "2025-07-15T00:00:00Z",
    "updatedDate": "2025-07-15T00:00:00Z"
  }
}

Field support per integration

Business Central

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:

expense

string

required

Show properties

documentId

string

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

expenseLines

JournalLineItem[]

required

Show properties

accountId

string

required

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

description

string

itemId

string

taxRate

Show properties

code

string

totalNetAmount

number

required

transactonDate

string

supplierId

string

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:

expense

string

required

Show properties

accountId

string

required

The accountId represents the id of the GL account of type BANK related to the expense.You can obtain this value by using the GET Accounts endpoint.

currency

enum

description

string

expenseLines

JournalLineItem[]

required

Show properties

accountId

string

required

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

description

string

taxRate

Show properties

code

string

taxRatePercentage

string

totalGrossAmount

number

required

journalCode

string

required

paymentTermId

string

supplierId

string

required

type

enum

Available options: EXPENSE

files

file[]

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:

expense

string

required

Show properties

currency

enum

required

expenseLines

JournalLineItem[]

required

Show properties

accountNumber

number

required

The accountNumber field specifies the general ledger account linked to the expense line item.

description

string

required

documentNumber

string

taxRate

required

Show properties

taxRatePercentage

string

required

totalGrossAmount

number

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.

totalGrossAmount

number

required

transactionDate

string

required

files

file[]

QuickBooks

Supported Request Parameters:

expense

string

required

Show properties

accountId

string

required

To get the correct id, you can use the GET Accounts endpoint. The account type has to be of type Cash, Credit Card, Check, the same as the paymentType field.

currency

enum

customerId

string

exchangeRate

string

expenseLines

JournalLineItem[]

required

Show properties

accountId

string

required

The accountCode field represents the code of the GL account that is used for the expense line.To get the correct code, you can use the GET Accounts endpoint.

description

string

required

taxRate

Show properties

code

string

supplierId

string

totalNetAmount

number

required

paymentType

enum

required

Available options: CASH, CREDIT_CARD, CHECK

files

file[]

Twinfield

Supported Request Parameters:

expense

string

required

Show properties

accountNumber

number

required

customerId

string

documentId

string

expenseLines

JournalLineItem[]

required

Show properties

accountNumber

number

required

description

string

documentNumber

string

exchangeRate

number

taxRate

Show properties

code

string

totalGrossAmount

number

totalNetAmount

number

required

journalCode

string

required

Xero

Supported Request Parameters:

expense

string

required

Show properties

accountId

string

required

The accountIdfield represents the id of the GL account of type BANK that is used for the expense.To get the correct id, you can use the GET Accounts endpoint.

currency

enum

customerId

string

If supplierId is not provided, customerId is required.

exchangeRate

string

expenseLines

JournalLineItem[]

required

Show properties

accountCode

string

required

The accountCode field represents the code of the GL account that is used for the expense line.To get the correct code, you can use the GET Accounts endpoint.

description

string

required

dimensions

Dimension

Show properties

name

string

itemId

string

taxRate

Show properties

code

string

totalGrossAmount

number

required

supplierId

string

If customerId is not provided, supplierId is required.

type

enum

required

Available options: EXPENSE, REFUND

transactionDate

string

files

file[]

Headers

X-API-KEY

string

required

API key

X-ACCOUNT-KEY

string

required

Account key

Query Parameters

companyId

string

environmentName

string

Body

multipart/form-data

files

file[]

Array of files to upload

expense

object

Show child attributes

Response

200 - application/json

Get started

Guides

Integrations

Use cases

API reference

Create expense

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