Skip to main content

Lock Before Opening Baseline

POST 

/api/ledger/close/hard-date/opening

Move the accounting start date to a new opening baseline and set the hard close date to the day before it, in one transaction, so everything before it is frozen while the opening day stays open for reconciling. This is the one case where the date need not be a month end. It only moves forward, runs immediately rather than in the background, and when the hard date is already there it only moves the start date. A moved start date then parks the opening-balance transition, as a settings save would.

Required scope: accounting:write

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

Body: start_date (date, Y-m-d, required) — the opening baseline date.

Returns the resulting hard_date.

Authentication: Bearer token. Requires the accounting.period.hard_close permission.

Errors: 422 when the books are already locked past that day, or when it would cover a closed month. Use Move Hard Close Date in those cases.

Request​

Responses​

OK

Response Headers
    Content-Type