Create expense

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[]

DATEV Unternehmen Online

This endpoint has been deprecated. Please use the Create Expense Async endpoint.

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

The currency field supports ISO 3166-1 alpha-2 (2-letter codes). For details visits the Standardized Data section.

expenseLines

JournalLineItem[]

required

Show properties

accountNumber

number

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

description

string

required

The description field provides details about the specific expense line.It cannot exceed 60 characters in length.

dimensions

Dimension

Show properties

name

string

The name field specifies the name of the dimension associated with the expense line.It cannot exceed 36 characters in length. It must follow the pattern : ^([\S][\S ]{0,34}[\S]|[\S]{0,1})$.Example: Marketing.

documentNumber

string

The documentNumber field represents the document number reference.It must match the pattern: ^[a-zA-Z0-9$%&*\+\-/]{0,36}$.

taxRate

Show properties

code

string

taxRatePercentage

string

The taxRatePercentage field represents the tax rate applied to the expense line.It must be a positive number.

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.

note

string

The note field allows for additional information or comments related to the expense. It cannot exceed 120 characters in length.

totalGrossAmount

number

required

transactionDate

string

required

files

file[]

Exact Online

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

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

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[]

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

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

customerId

string

expenseLines

JournalLineItem[]

required

Show properties

accountId

string

required

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

description

string

required

taxRate

Show properties

code

string

totalNetAmount

number

required

paymentType

enum

required

Available options: CASH, CREDIT_CARD, CHECK

supplierId

string

transactionDate

string

files

file[]

Twinfield

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

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

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

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[]

Get started

Guides

Integrations

Use cases

API reference

Create expense

Field support per integration

Get started

Guides

Integrations

Use cases

API reference

Documentation Index

​Field support per integration

Field support per integration