Get journal entries

cURL

curl --request GET \
  --url https://api.maesn.dev/accounting/journalEntries \
  --header 'X-ACCOUNT-KEY: <x-account-key>' \
  --header 'X-API-KEY: <x-api-key>'

{
  "meta": {
    "warnings": [
      "Field not used by target system"
    ],
    "pagination": {
      "total": 125,
      "perPage": 50,
      "currentPage": 1,
      "totalPages": 3
    }
  },
  "data": [
    {
      "id": "8df2df10-0fae-40ad-9d22-f25e5ab0ba23",
      "accountId": "94fdb7fd-13ae-47a6-8a2a-000e6ddc60d9",
      "accountingPeriodId": "2021-06",
      "createdDate": "2021-01-01T00:00:00Z",
      "currency": "EUR",
      "description": "Hotel for dreamforce",
      "documentId": "b5e624e5-fb9e-4836-a443-87a3820f5b48",
      "files": [
        "file1.pdf"
      ],
      "isProvisional": "false",
      "journalLineItems": [
        {
          "id": "94fdb7fd-13ae-47a6-8a2a-000e6ddc60d9",
          "accountCode": "4034",
          "accountId": "da33b47c-98ca-4410-9c59-5db485ecaeb0",
          "accountNumber": 8200,
          "createdDate ": "2021-01-01T00:00:00Z",
          "currency": "EUR",
          "customerId": "782d89b56-13ae-47a6-8a2a-45e6ddc50d9",
          "debitCreditIndicator": "DEBIT",
          "description": "Uitgesteld 21600001 Kantoor 01-01-2021-31-12-2021",
          "dimensions": [
            {
              "id": "efa82f42-fd85-11e1-a21f-0800200c9a33",
              "categoryName": "CostCenter",
              "code": "KD1",
              "name": "Material/Waren"
            }
          ],
          "documentNumber": "123456789",
          "exchangeRate": 1,
          "supplierId": "998933b56-13ae-47a6-8a32a-45e6ddc50d9",
          "taxRate": {
            "id": "1895b05b-38a6-4a6a-9653-166389894350",
            "code": "03",
            "name": "Tax19",
            "taxRatePercentage": "19"
          },
          "thirdPartyCode": "112233",
          "totalGrossAmount": 1190,
          "totalNetAmount": 1000,
          "totalTaxAmount": 190,
          "updatedDate": "2021-01-01T00:00:00Z"
        }
      ],
      "journalCode": "60",
      "journalType": "FIN",
      "number ": "21900030",
      "transactionDate": "2021-01-01T00:00:00Z",
      "updatedDate": "2021-01-01T00:00:00Z"
    }
  ]
}

GET

accounting

journalEntries

cURL

curl --request GET \
  --url https://api.maesn.dev/accounting/journalEntries \
  --header 'X-ACCOUNT-KEY: <x-account-key>' \
  --header 'X-API-KEY: <x-api-key>'

{
  "meta": {
    "warnings": [
      "Field not used by target system"
    ],
    "pagination": {
      "total": 125,
      "perPage": 50,
      "currentPage": 1,
      "totalPages": 3
    }
  },
  "data": [
    {
      "id": "8df2df10-0fae-40ad-9d22-f25e5ab0ba23",
      "accountId": "94fdb7fd-13ae-47a6-8a2a-000e6ddc60d9",
      "accountingPeriodId": "2021-06",
      "createdDate": "2021-01-01T00:00:00Z",
      "currency": "EUR",
      "description": "Hotel for dreamforce",
      "documentId": "b5e624e5-fb9e-4836-a443-87a3820f5b48",
      "files": [
        "file1.pdf"
      ],
      "isProvisional": "false",
      "journalLineItems": [
        {
          "id": "94fdb7fd-13ae-47a6-8a2a-000e6ddc60d9",
          "accountCode": "4034",
          "accountId": "da33b47c-98ca-4410-9c59-5db485ecaeb0",
          "accountNumber": 8200,
          "createdDate ": "2021-01-01T00:00:00Z",
          "currency": "EUR",
          "customerId": "782d89b56-13ae-47a6-8a2a-45e6ddc50d9",
          "debitCreditIndicator": "DEBIT",
          "description": "Uitgesteld 21600001 Kantoor 01-01-2021-31-12-2021",
          "dimensions": [
            {
              "id": "efa82f42-fd85-11e1-a21f-0800200c9a33",
              "categoryName": "CostCenter",
              "code": "KD1",
              "name": "Material/Waren"
            }
          ],
          "documentNumber": "123456789",
          "exchangeRate": 1,
          "supplierId": "998933b56-13ae-47a6-8a32a-45e6ddc50d9",
          "taxRate": {
            "id": "1895b05b-38a6-4a6a-9653-166389894350",
            "code": "03",
            "name": "Tax19",
            "taxRatePercentage": "19"
          },
          "thirdPartyCode": "112233",
          "totalGrossAmount": 1190,
          "totalNetAmount": 1000,
          "totalTaxAmount": 190,
          "updatedDate": "2021-01-01T00:00:00Z"
        }
      ],
      "journalCode": "60",
      "journalType": "FIN",
      "number ": "21900030",
      "transactionDate": "2021-01-01T00:00:00Z",
      "updatedDate": "2021-01-01T00:00:00Z"
    }
  ]
}

Field support per integration

bexio

Supported filters: noneSupport pagination: trueSupport rawData: true
Supported Response Fields:

string

journalLineItems

JournalLineItem[]

Show properties

string

accountId

string

currency

string

debitCreditIndicator

enum

Available options: DEBIT, CREDIT

description

string

exchangeRate

number

taxRate

Show properties

string

totalGrossAmount

number

string

transactionDate

string

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 filters:

lastModifiedAt

Support pagination: trueSupport rawData: true
Supported Response Fields:

string

accountId

string

description

string

number

string

updatedDate

string

DATEV Rechnungswesen

This endpoint is only available when using the datev-rewe-export target system for DATEV Rechnungswesen. For more details, refer to the Data Retrieval section.

This endpoint is asynchronous. The response returns a taskId. Use GET/asyncTask/{taskId} to check the task status and obtain the response data once it is ready.For more info about asynchronous tasks visit the Asynchronous Task section.

The query parameter fiscalYearStartDate is required and must be a valid date.

If you’re not using the Interactive Authentication Flow, make sure the query parameter companyId is correctly populated.

Supported filters: noneSupport pagination: falseSupport rawData: false
Supported Response Fields

currency

string

debitCreditIndicator

enum

Available options: DEBIT, CREDIT

description

string

documentId

string

journalLineItems

JournalLineItem[]

Show properties

accountNumber

number

dimensions

Dimension[]

Show properties

name

string

taxRate

Show properties

code

string

totalGrossAmount

number

string

transactionDate

string

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 filters:

lastModifiedAt

Support pagination: trueSupport rawData: true
Supported Response Fields:

string

accountingPeriodId

string

createdDate

string

description

string

journalCode

string

journalType

string

number

string

updatedDate

string

fortnox

Supported filters:

lastModifiedAt

Support pagination: trueSupport rawData: true
Supported Response Fields:

string

accountingPeriodId

string

description

string

journalCode

string

journalType

string

number

string

transactionDate

string

Odoo

Supported filters:

lastModifiedAt

Support pagination: trueSupport rawData: true
Supported Response Fields:

string

createdDate

string

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

journalCode

string

journalType

string

number

string

transactionDate

string

updatedDate

string

Sage Active

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 Companies endpoint available under the Authentication section. Please use the id field as the companyId and the environmentId field as the environmentName.

Supported filters:

lastModifiedAt

Support pagination: trueSupport rawData: true
Supported Response Fields:

string

accountingPeriodId

string

createdDate

string

description

string

journalLineItems

JournalLineItem[]

Show properties

string

accountId

string

createdDate

string

debitCreditIndicator

enum

Available options: DEBIT, CREDIT

description

string

taxRate

Show properties

string

codes

string

name

string

taxRatePercentage

string

thirdPartyCode

string

totalGrossAmount

number

updatedDate

string

journalType

string

number

string

transactionDate

string

updatedDate

string

Xero

Supported filters:

lastModifiedAt

Support pagination: trueSupport rawData: true
Supported Response Fields:

string

accountingPeriodId

string

description

string

description

string

journalLineItems

JournalLineItem[]

Show properties

accountId

string

createdDate

string

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

debitCreditIndicator

enum

Available options: DEBIT, CREDIT

description

string

dimensions

Dimension[]

Show properties

string

name

string

exchangeRate

string

supplierId

string

totalGrossAmount

number

totalNetAmount

number

totalTaxAmount

number

taxRate

Show properties

string

codes

string

name

string

taxRatePercentage

string

updatedDate

string

number

string

transactionDate

string

updatedDate

string

Headers

X-API-KEY

string

required

API key

Example:

"example value"

X-ACCOUNT-KEY

string

required

Account key

Example:

"example value"

Query Parameters

page

number

limit

enum<number>

Available options:

5,

10,

20,

50,

100

companyId

string

environmentName

string

fiscalYearStartDate

string

lastModifiedAt

number

rawData

boolean

Response

200 - application/json

Get started

Guides

Integrations

Use cases

API reference

Get journal entries

Field support per integration

Headers

Query Parameters

Response

Get started

Guides

Integrations

Use cases

API reference

​Field support per integration

Headers

Query Parameters

Response

Field support per integration