Skip to main content
POST
/
accounting
/
journalEntries
cURL
curl --request POST \
  --url https://api.maesn.dev/accounting/journalEntries \
  --header 'Content-Type: multipart/form-data' \
  --header 'X-ACCOUNT-KEY: <x-account-key>' \
  --header 'X-API-KEY: <x-api-key>' \
  --form 'files=<string>' \
  --form filesPos=123 \
  --form 'journal_entry={
  "accountId": "d1bfd23-517d-4ec6-b7d4-56f86c7cf246",
  "accountingPeriodId": "2021-06",
  "currency": "EUR",
  "description": "Hotel for dreamforce",
  "documentId": "b5e624e5-fb9e-4836-a443-87a3820f5b48",
  "isProvisional": "false",
  "journalLineItems": [
    {
      "accountCode": "4034",
      "accountId": "94fdb7fd-13ae-47a6-8a2a-000e6ddc60d9",
      "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
    }
  ],
  "journalCode": "60",
  "journalType": "FIN",
  "number ": "21900030",
  "transactionDate": "2021-01-01T00:00:00Z"
}' \
  --form files.items='@example-file'
{
  "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

Supported Request Parameters:
​
files
file[]
​
journal_entry
string
required
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:
​
journal_entry
string
required
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:
​
journal_entry
string
required
​
files
file[]
​
filesPos
number[]
The filesPos field is an array of line item positions (starting from 1) that correspond to each uploaded file. The value at index i in filesPos refers to the line item that the file at index i in the files array should be linked to. This field is required when uploading files.Example: If you’re uploading 2 files, and you want to link the first file to line item 1 and the second file to line item 3: filesPos: [1, 3]
Supported Request Parameters:
​
id
string
​
accountingPeriodId
string
required
​
description
string
required
​
journalCode
string
required
​
journalLineItems
JournalLineItem[]
​
journalType
string
​
number
string
​
transactionDate
string
required
Supported Request Parameters:
​
journal_entry
string
required
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. Please use the id field as the companyId.
Supported Request Parameters:
​
journal_entry
string
required
​
files
file[]
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 Fields:
​
journalCode
string
required
​
customerId
string
​
documentId
string
​
isProvisional
boolean
​
journalLineItems
JournalLineItem[]
required
Supported Request Parameters:
​
journal_entry
string
required
​
files
file[]
required

Headers

​
X-API-KEY
string
required

API key

Example:

"example value"

​
X-ACCOUNT-KEY
string
required

Account key

Example:

"example value"

Query Parameters

​
companyId
string
​
environmentName
string

Body

multipart/form-data
​
files
file[]

Array of files to upload

​
filesPos
number[]

Array of file positions

​
journal_entry
object

Response

200 - application/json
​
meta
object
​
data
object[]
Last modified on June 10, 2026