Skip to main content
POST
/
service
/
general-ledger
/
journal-entries
/
{journal_entry_id}
/
post
curl -X POST https://kube.acho.io/service/general-ledger/journal-entries/JE-2024-002/post \
  -H "Authorization: jwt YOUR_TOKEN"
{
  "journal_entry_id": "JE-2024-002",
  "status": "Posted",
  "posted_at": "2024-01-16T12:00:00Z",
  "posted_by": "user_123",
  "posting_period_id": "a3UM4R8nYh33A6hgda",
  "posting_period_name": "January 2024"
}

Request

Manually post an approved journal entry to the General Ledger. This is typically used when automatic posting after approval is disabled.
By default, entries are automatically posted after final approval. This endpoint is only needed when manual posting is configured or when posting was deferred.

Headers

Authorization
string
required
JWT authentication token. Format: jwt YOUR_TOKEN

Path Parameters

journal_entry_id
string
required
The unique identifier of the journal entry to post
curl -X POST https://kube.acho.io/service/general-ledger/journal-entries/JE-2024-002/post \
  -H "Authorization: jwt YOUR_TOKEN"
{
  "journal_entry_id": "JE-2024-002",
  "status": "Posted",
  "posted_at": "2024-01-16T12:00:00Z",
  "posted_by": "user_123",
  "posting_period_id": "a3UM4R8nYh33A6hgda",
  "posting_period_name": "January 2024"
}

Posting Requirements

Before an entry can be posted, the system verifies:
  1. Status - Entry must be in Approved status
  2. Period Open - The posting period must be open
  3. Balance - Entry must be balanced (debits = credits)
  4. Accounts Active - All accounts in the entry must be active

What Happens on Post

When a journal entry is posted:
  1. Account balances are updated (debits increase debit-normal accounts, credits increase credit-normal accounts)
  2. Status changes to Posted
  3. The entry becomes immutable - it cannot be edited
  4. An audit trail entry is created