Update journal entry

PUT /accounting/journalEntries/{journalEntryId}

cURL

cURL

curl --request PUT \
  --url https://api.maesn.dev/accounting/journalEntries/{journalEntryId} \
  --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",
  "accountingReason": "COMMERCIAL",
  "currency": "EUR",
  "description": "Hotel for dreamforce",
  "documentId": "b5e624e5-fb9e-4836-a443-87a3820f5b48",
  "exchangeRate": "1,2045",
  "isProvisional": "false",
  "isReversal": false,
  "journalLineItems": [
    {
      "id": "123f57fd-13ae-47a6-8a2a-000e6ddc60d9",
      "accountCode": "4034",
      "accountId": "94fdb7fd-13ae-47a6-8a2a-000e6ddc60d9",
      "accountNumber": "1200",
      "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"
        }
      ],
      "documentId": "b5e624e5-fb9e-4836-a443-87a3820f5b48",
      "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",
  "recordType": "STANDARD",
  "transactionDate": "2021-01-01T00:00:00Z",
  "version": "AAAAACnY3os1"
}' \
  --form files.items='@example-file'

200

{
  "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",
      "accountingReason": "COMMERCIAL",
      "createdDate": "2021-01-01T00:00:00Z",
      "currency": "EUR",
      "description": "Hotel for dreamforce",
      "documentId": "b5e624e5-fb9e-4836-a443-87a3820f5b48",
      "files": [
        "file1.pdf"
      ],
      "exchangeRate": "1,2045",
      "isProvisional": "false",
      "isReversal": false,
      "journalLineItems": [
        {
          "id": "123f57fd-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"
            }
          ],
          "documentId": "b5e624e5-fb9e-4836-a443-87a3820f5b48",
          "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",
      "recordType": "STANDARD",
      "transactionDate": "2021-01-01T00:00:00Z",
      "updatedDate": "2021-01-01T00:00:00Z",
      "version": "AAAAACnY3os1"
    }
  ]
}

Field support per integration

Dinero

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

Only provisional journal entries (unbooked) can be updated.

Supported request fields:

journal_entry · string · required

Show properties

isProvisional · boolean

Indicates whether the journal entry will be set as provisional (draft) or booked (finalized).

If set to true, the journal entry remains provisional ; if set to false, the journal entry is booked.

Defaults to true if not provided.

journalLineItems · JournalLineItem[]

If the journal line items are not provided, the existing line items associated with the journal entry will remain unchanged and will not be updated.

Show properties

id · string · required

Id for the journal line.

accountNumber · string · required

The account number. Must be numeric.

When documentId is present, the accountNumber should be a bank account

description · string · required

debitCreditIndicator · enum · required

Available options: DEBIT, CREDIT

documentId · string

Reference to an invoice/bill ID for payment lines. When provided, the line becomes a payment that settles the referenced document.

totalNetAmount · number · required

The net amount for the line item. Must be a positive amount.

taxRate · taxRate

Show properties

code · string

VAT code for the account or contra-account.

number · string

Journal entry number. Must be numeric.

transactionDate · string · required

For date format details visits the Standardized Data section.

It is the date the accounting entry is booked into the records.

version · string · required

files · file[]

Visma e-conomic

Supported request fields:

journal_entry · string · required

Show properties

currency · string · required

description · string

exchangeRate · string

isProvisional · boolean

Indicates whether the journal entry will be set as provisional (draft) or booked (finalized).

If set to true, the journal entry remains provisional ; if set to false, the journal entry is booked.

Defaults to true if not provided.

journalCode · string · required

Must be a valid integer.

journalLineItems · JournalLineItem[] · required

Maximum 2 line items are allowed per journal entry. When 2 line items are provided, one must be DEBIT and one must be CREDIT with the same amount.

Show properties

accountNumber · string · required

Must be a valid integer representing the account number.

debitCreditIndicator · enum · required

Available options: DEBIT, CREDIT

taxRate · taxRate

Show properties

code · string

totalGrossAmount · number · required

Must be a positive number with maximum 2 decimal places.

number · string · required

The voucher number.

You can obtain the value by using the GET Journal entry by ID

transactionDate · string · required

For date format details visit the Standardized Data section.

version · string · required

The object version for optimistic concurrency control.

You can obtain the value by using the GET Journal entry by ID

files · file[]

Allowed file types: PDF, JPG, PNG. Maximum file size: 9MB.

If a file is already attached to the updated journal entry, the new file and the existing file will be merged.

Headers

X-API-KEY · string · required

API key

Example:

"example value"

X-ACCOUNT-KEY · string · required

Account key

Example:

"example value"

Path Parameters

journalEntryId · string · required

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

Show child attributes

Response

200 - application/json

meta · object

Show child attributes

data · object[]

Show child attributes