Scheduler Triggers

The scheduler service manages recurring jobs such as standing instruction execution, transaction reconciliation, and business day transitions. While these jobs run automatically on their configured schedules, you can trigger them manually via the API for testing or catch-up processing.

Trigger Standing Instructions

Execute all pending standing instructions that are due.

POST /api/v1/jobs/standing-instructions/trigger

cURL

curl -X POST https://api.korastratum.com/api/v1/cba/jobs/standing-instructions/trigger \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-Tenant-ID: demo_bank"

Node.js

const result = await cbaRequest("POST", "/api/v1/jobs/standing-instructions/trigger", token);

Python

result = cba_request("POST", "/api/v1/jobs/standing-instructions/trigger", token)

Go

result, err := cbaRequest(ctx, "POST", "/api/v1/jobs/standing-instructions/trigger", token, nil)

Response:

{
  "job_id": "job-uuid",
  "job_type": "STANDING_INSTRUCTIONS",
  "status": "COMPLETED",
  "instructions_executed": 15,
  "instructions_failed": 0,
  "started_at": "2026-04-07T00:00:00Z",
  "completed_at": "2026-04-07T00:00:12Z"
}

note

This job is idempotent for the current business day. Running it multiple times will not duplicate journal entries — instructions already executed for the current period are skipped.

Trigger Reconciliation

Run a reconciliation pass to match internal transaction records against provider (NIP) records.

POST /api/v1/jobs/reconciliation/trigger

cURL

curl -X POST https://api.korastratum.com/api/v1/cba/jobs/reconciliation/trigger \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-Tenant-ID: demo_bank" \
  -H "Content-Type: application/json" \
  -d '{
    "date": "2026-04-07"
  }'

Node.js

const result = await cbaRequest("POST", "/api/v1/jobs/reconciliation/trigger", token, {
  date: "2026-04-07",
});

Python

result = cba_request("POST", "/api/v1/jobs/reconciliation/trigger", token, {
    "date": "2026-04-07",
})

Go

result, err := cbaRequest(ctx, "POST", "/api/v1/jobs/reconciliation/trigger", token, map[string]string{
    "date": "2026-04-07",
})

Response:

{
  "job_id": "job-uuid",
  "job_type": "RECONCILIATION",
  "status": "COMPLETED",
  "transactions_matched": 1245,
  "transactions_unmatched": 3,
  "discrepancies_found": 1,
  "date": "2026-04-07",
  "completed_at": "2026-04-07T23:15:00Z"
}

warning

Unmatched transactions and discrepancies require manual review. Check the reconciliation report in the Financial Reports section.

Business Day Status

Check the current business day status for the tenant. Business day transitions control when EOD processes (settlement, interest accrual, standing instructions) are executed.

GET /api/v1/jobs/business-day/status

curl https://api.korastratum.com/api/v1/cba/jobs/business-day/status \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-Tenant-ID: demo_bank"

Response:

{
  "current_business_date": "2026-04-07",
  "status": "OPEN",
  "opened_at": "2026-04-07T06:00:00Z",
  "eod_scheduled_at": "2026-04-07T23:00:00Z",
  "previous_business_date": "2026-04-04",
  "next_business_date": "2026-04-08",
  "is_holiday": false,
  "timezone": "Africa/Lagos"
}

Business day statuses:

Status	Description
OPEN	Business day is active, transactions are accepted
EOD_PROCESSING	End-of-day jobs are running
CLOSED	Business day is closed, awaiting next day open

Next Steps

• General Ledger — Standing instructions and journal posting.
• Settlement Processing — EOD settlement batch processing.
• Financial Reports — Reconciliation reports.