Accounting

Hydrate a business case from a template id for the authenticated company.

This operation remains available until <b>2027-08-14</b> and is removed after that date. Use <code>GET /core/v1/accounting/business-cases</code> instead.<br/><br/>Loads the fully hydrated business-case aggregate the booking form needs: the template id, the company-VAT and fiscal-year context resolved from the optional date filters, the pre-translated display label, and the recursive snippet / field tree. When <code>dateForFilteringFiscalYear</code> is supplied it drives the fiscal-year resolution; otherwise <code>dateForFilteringCompanyVat</code> is used; otherwise the downstream service resolves the fiscal year that covers today. Tenant and company are derived from the bearer-token session — they are never accepted from the URL. The endpoint is a pure read — idempotent, no side effects. The caller must hold the <code>ACCOUNTING</code> permission on the company in scope.

get/core/latest/accounting/business-cases

Request

  • Base URL: https://api.klara.ch
  • URL: https://api.klara.ch/core/latest/accounting/business-cases
  • Auth: one of:
    • API key in header X-API-KEY
    • HTTP bearer

Query parameters

businessCaseTemplateIdinteger required
Example:101

Numeric id of the business-case template to hydrate. Obtain it from <code>GET /core/latest/accounting/companies/current/business-case-templates</code>.

dateForFilteringCompanyVatstring date
Example:2024-06-15

ISO date (<code>yyyy-MM-dd</code>) used to resolve the company-VAT regime applicable to the business case. Used as the fallback for <code>dateForFilteringFiscalYear</code> when that is omitted.

dateForFilteringFiscalYearstring date
Example:2024-06-15

ISO date (<code>yyyy-MM-dd</code>) used to resolve the fiscal year that hydrates the business case. When omitted, falls back to <code>dateForFilteringCompanyVat</code>; when both are omitted the downstream service resolves the fiscal year that covers today.

Headers

Accept-Languagestring
Example:de-CH

IETF language tag used to translate the snippet labels and field captions. Examples: <code>de-CH</code>, <code>fr-CH</code>, <code>it-CH</code>, <code>en</code>.

Response

Hydrated business-case aggregate for the requested template.

businessCaseIdinteger

Identifier of the business case instance when persisted; null on a freshly hydrated template.

businessCaseTemplateIdinteger

Identifier of the business-case template this aggregate was hydrated from.

documentIdstring

Identifier of the underlying document the business case is attached to; null when the booking is not yet linked to a document.

displaystring

Pre-translated display label of the business-case template for the request's Accept-Language.

bookingNumbersstring

Comma-separated list of booking numbers already generated for this business case; empty on a fresh template.

effectiveCompanyVatDatestring date

Date used to resolve the company-VAT regime applicable to this business case (ISO yyyy-MM-dd).

documentDatestring date

Document date associated with the business case (ISO yyyy-MM-dd).

effectiveFiscalYearDatestring date

Date used to resolve the fiscal year applicable to this business case (ISO yyyy-MM-dd).

fiscalYearHasCreatedAutoboolean

True when the downstream service had to auto-create the fiscal year covering the resolved date.

withOPboolean

True when this business case is tracked as an open item (OP). May be null when not applicable.

fieldsobject

Recursive snippet-and-field tree driving the booking form, keyed by snippet code. The shape of each entry follows the downstream BusinessCaseField model (see analysis report §8.2).

entriesDefinitionobject[]

Per-field entries definitions used by the booking form to resolve enum-like fields. Each entry mirrors the downstream FieldEntriesDefinition model (see analysis report §8.2).

Example response

{
  "businessCaseTemplateId": 101,
  "documentId": "null",
  "display": "Bürobedarf",
  "effectiveCompanyVatDate": "2024-06-15",
  "documentDate": "2024-06-15",
  "effectiveFiscalYearDate": "2024-06-15",
  "fields": {
    "PAYMENT": {
      "snippetId": 42,
      "nestedFields": {}
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.