--- title: "Create a new manual booking for the authenticated company." method: POST path: "/core/latest/bookings" tags: ["Accounting"] deprecated: true --- # Create a new manual booking for the authenticated company. `POST /core/latest/bookings` ## Request - Base URL: `https://api.klara.ch` - URL: `https://api.klara.ch/core/latest/bookings` - Auth: one of: - API key in header `X-API-KEY` - HTTP bearer > **Deprecated.** This operation remains available until 2027-08-14 and is removed after that date. Use POST /core/v1/bookings instead.

Records a manual journal entry against the authenticated caller's company and returns the persisted booking with its server-assigned identifiers. The booking must contain at least two debit/credit lines whose totals balance — the downstream service rejects unbalanced postings. By default the bookingDate must fall inside an open fiscal year; set confirmDontMindClosingFiscalYear to true to accept a booking that targets a closing fiscal year. Set ignore-unsubscripted-dates to true to bypass the subscription-period guard that normally rejects bookings outside the active Klara Accounting subscription window. Tenant and company are derived from the bearer token — the request body's id and companyId are ignored. The caller must hold the ACCOUNTING permission on the targeted company. ## Query parameters - `autoCalculateVat` boolean - `confirmDontMindClosingFiscalYear` boolean - `ignore-unsubscripted-dates` boolean ## Headers - `Accept-Language` string ## Request body - PublicApiBookingHeader: A booking (manual journal entry) together with its debit/credit lines. - `id` integer: Internal id of the booking. Assigned by the server on creation; omit when sending a new booking. - `companyId` integer: Internal id of the company this booking belongs to. Filled by the server from the caller's session; ignored on input. - `documentDate` string, date-time, required: Date printed on the underlying document, e.g. supplier invoice date (yyyy-MM-ddT00:00:00Z). - `bookingDate` string, date-time, required: Effective accounting date of the booking; must fall inside an open fiscal year unless confirmDontMindClosingFiscalYear is set (yyyy-MM-ddT00:00:00Z). - `documentIds` string[]: Ids of supporting documents (uploaded files / e-mails) attached to this booking. - `businessCase` string: Free-text business case label shown on the journal. - `snippets` string[]: Snippet identifiers applied to this booking, copied from the booking template. - `bookingStatus` string: Status of the booking. Allowed values: DRAFT, BOOKED, CANCELLED. - `internalComment` string: Internal comment, visible only to accounting users. - `businessCaseId` string: Id of the Klara business case that produced this booking. Set by the server and ignored on input: a booking created through this API never belongs to a business case, so leave it empty. This is not the business case template code (use businessCase for a label). A non-numeric value is rejected with 400 booking.business_case_id_invalid. - `relatedBookingHeaderLinks` string[]: URIs of bookings that are related to this one (e.g. payment ↔ invoice, original ↔ delimitation). - `bookingDetails` PublicApiBookingDetail[], required: Debit and credit lines of the booking. Must contain at least two lines whose debit and credit totals balance. - `id` integer: Internal id of the booking detail. Assigned by the server on creation; omit when sending a new booking. - `accountCode` integer, required: Ledger account number the amount is posted to (Swiss SME chart of accounts). - `crdrType` string, required: Whether this line is a credit or a debit. Allowed values: CR, DR. - `description` string, required: Free-text description shown on the journal report. - `amount` number, required: Absolute posting amount in the company main currency. Always positive; sign is carried by crdrType. - `partialPaymentAmount` number: Amount already paid against this line — only used for open-position bookings (invoices, credit notes). - `tags` string, required: Comma-separated list of string tags. Each tag is free-form and should represent a topic that the booking line should be associated with. Provide at least one tag per line. - `links` string: Comma-separated list of structured links of entities that are considered the sub-accounts associated with an account code when making a booking line.This string can be empty when no sub-account is required for the current account code of the booking line.Each link has the format key:uri-path. Important: the exact URI values — including the tenant UUID and company ID segments — are returned verbatim by GET /core/v1/accounting/accounts/account-displaying in the account's specificationItem.link field; copy them as-is, do not construct them manually.

Supported link type keys:
Bank / cash sub-accounts (secondary dropdown in GUI for accounts 1000, 1020, 1030, 1040, and similar):
Counterpart links (customer / supplier / employee sub-ledger):
Tax / VAT links:
Asset / liability / equity links:
Revenue / inventory / other links:
Multiple entries are comma-separated. Leave empty when none apply. - `seq` integer: Ordering of the line inside the booking, starting at 0. - `vatAccountCode` integer: GUI-style VAT input, used only with autoCalculateVat=true: the account the automatically generated VAT counterpart line is posted to (the GUI "VAT account", e.g. 1170). Required on a VAT-bearing line when the line carries a vat_rate link and omits its own VAT line. Ignored when autoCalculateVat is false (caller pre-splits the lines). - `vatTypeDescription` string: How VAT is recorded for this line. Allowed values: INCLUSIVE, EXCLUSIVE, NONE. - `vatBookingDetailLink` string: URI of the companion VAT booking detail, when one was generated automatically. - `vatAmount` number: VAT amount carried on this line, in the company main currency. - `vatRate` number: Effective VAT rate (percent) applied to this line. - `vatRateDisplay` string: Display string of the VAT rate as rendered in the UI. - `vatBookingDetail` boolean: True when this line is the automatically generated VAT counterpart of another line. - `bookingTypeCode` string, required: Business meaning of the booking line. Allowed values include GENERAL_LEDGER, AR_INVOICE, AP_INVOICE, AR_PAYMENT, AP_PAYMENT, AR_CREDIT_NOTE, AP_CREDIT_NOTE. - `openPositionStatus` string: Lifecycle of the open position represented by this line. Allowed values include OPEN, PARTIALLY_PAID, PAID, CLOSED. - `creditorReference` string: Creditor reference (QR-bill / ISO 11649) attached to the open position. - `isrReference` string: ISR reference number attached to the open position. - `isrMember` string: ISR participant (member) number of the creditor. - `partnerIban` string: IBAN of the counterpart used for outgoing payments. - `endToEndId` string: Pain.001 end-to-end id, propagated to the outgoing payment instruction. - `isExcludeVatAmount` boolean: When true, the gross amount on this line excludes VAT; otherwise it includes VAT. - `foreignCurrencyAmount` number: Posting amount in the foreign currency, when the line is booked in a non-main currency. - `foreignCurrencyUnit` string: ISO 4217 code of the foreign currency. - `paidDate` string, date-time: Date on which the open position was settled (yyyy-MM-ddT00:00:00Z). - `dueDate` string, date-time: Date on which the open position becomes overdue (yyyy-MM-ddT00:00:00Z). - `paymentDate` string, date-time: Date on which the payment instruction is scheduled (yyyy-MM-ddT00:00:00Z). - `servicePeriodFrom` string, date-time: Start of the service period covered by the line (yyyy-MM-ddT00:00:00Z). - `servicePeriodTo` string, date-time: End of the service period covered by the line (yyyy-MM-ddT00:00:00Z). - `paymentPercentage` number: Percentage of the open-position amount already settled. - `isDunningBlocked` boolean: When true, dunning reminders are suppressed for this open position. - `invoiceNumber` string: Invoice number printed on the document. - `orderManagementInvoiceLink` string: Klara order-management invoice URI when the booking was generated from a Klara invoice. - `bookingTemplateId` integer: Id of the booking template the user picked when creating this entry. - `bookingTitle` string: Short title of the booking shown in lists. - `totalAmount` number: Sum of the absolute amounts of the booking lines, in the company main currency. - `bookingTypeCode` string: Business meaning of the booking. Allowed values include GENERAL_LEDGER, AR_INVOICE, AP_INVOICE, AR_PAYMENT, AP_PAYMENT, AR_CREDIT_NOTE, AP_CREDIT_NOTE. ## Response `200` Booking created. - PublicApiBookingHeader: A booking (manual journal entry) together with its debit/credit lines. - `id` integer: Internal id of the booking. Assigned by the server on creation; omit when sending a new booking. - `companyId` integer: Internal id of the company this booking belongs to. Filled by the server from the caller's session; ignored on input. - `documentDate` string, date-time, required: Date printed on the underlying document, e.g. supplier invoice date (yyyy-MM-ddT00:00:00Z). - `bookingDate` string, date-time, required: Effective accounting date of the booking; must fall inside an open fiscal year unless confirmDontMindClosingFiscalYear is set (yyyy-MM-ddT00:00:00Z). - `documentIds` string[]: Ids of supporting documents (uploaded files / e-mails) attached to this booking. - `businessCase` string: Free-text business case label shown on the journal. - `snippets` string[]: Snippet identifiers applied to this booking, copied from the booking template. - `bookingStatus` string: Status of the booking. Allowed values: DRAFT, BOOKED, CANCELLED. - `internalComment` string: Internal comment, visible only to accounting users. - `businessCaseId` string: Id of the Klara business case that produced this booking. Set by the server and ignored on input: a booking created through this API never belongs to a business case, so leave it empty. This is not the business case template code (use businessCase for a label). A non-numeric value is rejected with 400 booking.business_case_id_invalid. - `relatedBookingHeaderLinks` string[]: URIs of bookings that are related to this one (e.g. payment ↔ invoice, original ↔ delimitation). - `bookingDetails` PublicApiBookingDetail[], required: Debit and credit lines of the booking. Must contain at least two lines whose debit and credit totals balance. - `id` integer: Internal id of the booking detail. Assigned by the server on creation; omit when sending a new booking. - `accountCode` integer, required: Ledger account number the amount is posted to (Swiss SME chart of accounts). - `crdrType` string, required: Whether this line is a credit or a debit. Allowed values: CR, DR. - `description` string, required: Free-text description shown on the journal report. - `amount` number, required: Absolute posting amount in the company main currency. Always positive; sign is carried by crdrType. - `partialPaymentAmount` number: Amount already paid against this line — only used for open-position bookings (invoices, credit notes). - `tags` string, required: Comma-separated list of string tags. Each tag is free-form and should represent a topic that the booking line should be associated with. Provide at least one tag per line. - `links` string: Comma-separated list of structured links of entities that are considered the sub-accounts associated with an account code when making a booking line.This string can be empty when no sub-account is required for the current account code of the booking line.Each link has the format key:uri-path. Important: the exact URI values — including the tenant UUID and company ID segments — are returned verbatim by GET /core/v1/accounting/accounts/account-displaying in the account's specificationItem.link field; copy them as-is, do not construct them manually.

Supported link type keys:
Bank / cash sub-accounts (secondary dropdown in GUI for accounts 1000, 1020, 1030, 1040, and similar):
Counterpart links (customer / supplier / employee sub-ledger):
Tax / VAT links:
Asset / liability / equity links:
Revenue / inventory / other links:
Multiple entries are comma-separated. Leave empty when none apply. - `seq` integer: Ordering of the line inside the booking, starting at 0. - `vatAccountCode` integer: GUI-style VAT input, used only with autoCalculateVat=true: the account the automatically generated VAT counterpart line is posted to (the GUI "VAT account", e.g. 1170). Required on a VAT-bearing line when the line carries a vat_rate link and omits its own VAT line. Ignored when autoCalculateVat is false (caller pre-splits the lines). - `vatTypeDescription` string: How VAT is recorded for this line. Allowed values: INCLUSIVE, EXCLUSIVE, NONE. - `vatBookingDetailLink` string: URI of the companion VAT booking detail, when one was generated automatically. - `vatAmount` number: VAT amount carried on this line, in the company main currency. - `vatRate` number: Effective VAT rate (percent) applied to this line. - `vatRateDisplay` string: Display string of the VAT rate as rendered in the UI. - `vatBookingDetail` boolean: True when this line is the automatically generated VAT counterpart of another line. - `bookingTypeCode` string, required: Business meaning of the booking line. Allowed values include GENERAL_LEDGER, AR_INVOICE, AP_INVOICE, AR_PAYMENT, AP_PAYMENT, AR_CREDIT_NOTE, AP_CREDIT_NOTE. - `openPositionStatus` string: Lifecycle of the open position represented by this line. Allowed values include OPEN, PARTIALLY_PAID, PAID, CLOSED. - `creditorReference` string: Creditor reference (QR-bill / ISO 11649) attached to the open position. - `isrReference` string: ISR reference number attached to the open position. - `isrMember` string: ISR participant (member) number of the creditor. - `partnerIban` string: IBAN of the counterpart used for outgoing payments. - `endToEndId` string: Pain.001 end-to-end id, propagated to the outgoing payment instruction. - `isExcludeVatAmount` boolean: When true, the gross amount on this line excludes VAT; otherwise it includes VAT. - `foreignCurrencyAmount` number: Posting amount in the foreign currency, when the line is booked in a non-main currency. - `foreignCurrencyUnit` string: ISO 4217 code of the foreign currency. - `paidDate` string, date-time: Date on which the open position was settled (yyyy-MM-ddT00:00:00Z). - `dueDate` string, date-time: Date on which the open position becomes overdue (yyyy-MM-ddT00:00:00Z). - `paymentDate` string, date-time: Date on which the payment instruction is scheduled (yyyy-MM-ddT00:00:00Z). - `servicePeriodFrom` string, date-time: Start of the service period covered by the line (yyyy-MM-ddT00:00:00Z). - `servicePeriodTo` string, date-time: End of the service period covered by the line (yyyy-MM-ddT00:00:00Z). - `paymentPercentage` number: Percentage of the open-position amount already settled. - `isDunningBlocked` boolean: When true, dunning reminders are suppressed for this open position. - `invoiceNumber` string: Invoice number printed on the document. - `orderManagementInvoiceLink` string: Klara order-management invoice URI when the booking was generated from a Klara invoice. - `bookingTemplateId` integer: Id of the booking template the user picked when creating this entry. - `bookingTitle` string: Short title of the booking shown in lists. - `totalAmount` number: Sum of the absolute amounts of the booking lines, in the company main currency. - `bookingTypeCode` string: Business meaning of the booking. Allowed values include GENERAL_LEDGER, AR_INVOICE, AP_INVOICE, AR_PAYMENT, AP_PAYMENT, AR_CREDIT_NOTE, AP_CREDIT_NOTE. ## Other responses - `400`: Data invalid

Failures detected by a downstream service carry that service's own code, which this reference does not enumerate, so the code field may hold a value not documented here. Treat an unrecognised code as a generic failure of the status it arrives with, and do not branch on a code this reference does not list. - `401`: No Authorization header found or invalid token

Failures detected by a downstream service carry that service's own code, which this reference does not enumerate, so the code field may hold a value not documented here. Treat an unrecognised code as a generic failure of the status it arrives with, and do not branch on a code this reference does not list. - `403`: The current user is not allowed to access this company data

Failures detected by a downstream service carry that service's own code, which this reference does not enumerate, so the code field may hold a value not documented here. Treat an unrecognised code as a generic failure of the status it arrives with, and do not branch on a code this reference does not list. - `410`: Gone. This operation is removed after 2027-08-14; every call after that date answers 410. Use POST /core/v1/bookings instead.

Failures detected by a downstream service carry that service's own code, which this reference does not enumerate, so the code field may hold a value not documented here. Treat an unrecognised code as a generic failure of the status it arrives with, and do not branch on a code this reference does not list. - `429`: API rate limit exceeded

Failures detected by a downstream service carry that service's own code, which this reference does not enumerate, so the code field may hold a value not documented here. Treat an unrecognised code as a generic failure of the status it arrives with, and do not branch on a code this reference does not list. - `500`: Something went wrong on our side while processing the request. Please kindly contact our support.

Failures detected by a downstream service carry that service's own code, which this reference does not enumerate, so the code field may hold a value not documented here. Treat an unrecognised code as a generic failure of the status it arrives with, and do not branch on a code this reference does not list. --- [API](https://skmtc.dev/klara/apis/klara-public-api.md) · [All operations](https://skmtc.dev/klara/apis/klara-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/klara/apis/klara-public-api/revisions/490b1a879fc2?raw)