Skip to main content
POST
/
service
/
general-ledger
/
reconciliations
curl -X POST https://kube.acho.io/service/general-ledger/reconciliations \
  -H "Authorization: jwt YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "bankAccountId": "a3-bank-account-xxx",
    "statementDate": "2024-01-31",
    "statementEndingBalance": 50000.00,
    "statementBeginningBalance": 45000.00,
    "postingPeriodId": "a3-period-xxx",
    "currency": "USD",
    "memo": "January 2024 Bank Reconciliation"
  }'
{
  "reconciliation_id": "recon-2024-001",
  "bank_account_id": "a3-bank-account-xxx",
  "bank_account_name": "Operating Account",
  "statement_date": "2024-01-31",
  "statement_beginning_balance": 45000.00,
  "statement_ending_balance": 50000.00,
  "gl_beginning_balance": 45000.00,
  "gl_ending_balance": 52000.00,
  "posting_period_id": "a3-period-xxx",
  "currency": "USD",
  "status": "Draft",
  "memo": "January 2024 Bank Reconciliation",
  "created_at": "2024-02-01T10:00:00Z",
  "created_by": "user-123"
}

Request

Create a new bank reconciliation session. The GL ending balance is automatically calculated based on the linked ledger account.

Body Parameters

bankAccountId
string
required
The bank account ID to reconcile
statementDate
string
required
Bank statement date (YYYY-MM-DD)
statementEndingBalance
number
required
Ending balance from bank statement
statementBeginningBalance
number
required
Beginning balance from bank statement
postingPeriodId
string
required
Accounting period for this reconciliation
currency
string
required
Currency code (e.g., USD)
memo
string
Optional description for this reconciliation
curl -X POST https://kube.acho.io/service/general-ledger/reconciliations \
  -H "Authorization: jwt YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "bankAccountId": "a3-bank-account-xxx",
    "statementDate": "2024-01-31",
    "statementEndingBalance": 50000.00,
    "statementBeginningBalance": 45000.00,
    "postingPeriodId": "a3-period-xxx",
    "currency": "USD",
    "memo": "January 2024 Bank Reconciliation"
  }'
{
  "reconciliation_id": "recon-2024-001",
  "bank_account_id": "a3-bank-account-xxx",
  "bank_account_name": "Operating Account",
  "statement_date": "2024-01-31",
  "statement_beginning_balance": 45000.00,
  "statement_ending_balance": 50000.00,
  "gl_beginning_balance": 45000.00,
  "gl_ending_balance": 52000.00,
  "posting_period_id": "a3-period-xxx",
  "currency": "USD",
  "status": "Draft",
  "memo": "January 2024 Bank Reconciliation",
  "created_at": "2024-02-01T10:00:00Z",
  "created_by": "user-123"
}