---
title: "Create liability"
method: POST
path: "/api/v1/liabilities"
tags: ["Liability"]
---

# Create liability

`POST /api/v1/liabilities`

Creates a single new liability.

## Request body

- object
  - `date` string, date, nullable
  - `supplier` object, required — Supplier reference
    - `id` string, required — Resource identifier.
  - `supplierInvoiceNumber` string — The invoice number issued by the supplier
  - `receiptDate` string, date-time, nullable — The date when the supplier invoice was received by the recipient
  - `serviceDate` string, date, nullable — The date on which the service was provided
  - `status` 'open' | 'paid' — Workflow status of the liability
  - `clarificationCase` boolean — A boolean flag to mark the liability as a clarification case, e.g. to check the deferred account assignments or open questions
  - `clarificationReason` string — A string that specifies the reason or justification provided for the clarification case in the liability process.
  - `release` boolean — A boolean flag with which the goods delivery is confirmed as complete and the traffic light is switched to green.
  - `invoiceRelease` boolean — A boolean flag with which the accounting check of the incoming document is confirmed as complete and correct for tax purposes and the traffic light is switched to green.
  - `internalComment` string — A text field for adding internal comments or notes related to the liability, not visible to external parties.
  - `financials` object — financial information
    - `amountGross` object — Money object with amount and currency
      - `amount` string, float — A string representing the amount
      - `currency` 'EUR' | 'USD' | 'JPY' | 'BGN' | 'CZK' | 'DKK' | 'GBP' | 'HUF' | 'PLN' | 'RON' | 'SEK' | 'CHF' | 'ISK' | 'NOK' | 'HRK' | 'RUB' | 'TRY' | 'AUD' | 'BRL' | 'CAD' | 'CNY' | 'HKD' | 'IDR' | 'ILS' | 'INR' | 'KRW' | 'MXN' | 'MYR' | 'NZD' | 'PHP' | 'SGD' | 'THB' | 'ZAR' | 'ARS' | 'CLP' | 'SAR' | 'AED' | 'QAR' — Currency matches one of currency values as specified in ISO-4217.
    - `amountNet` object — Money object with amount and currency
      - `amount` string, float — A string representing the amount
      - `currency` 'EUR' | 'USD' | 'JPY' | 'BGN' | 'CZK' | 'DKK' | 'GBP' | 'HUF' | 'PLN' | 'RON' | 'SEK' | 'CHF' | 'ISK' | 'NOK' | 'HRK' | 'RUB' | 'TRY' | 'AUD' | 'BRL' | 'CAD' | 'CNY' | 'HKD' | 'IDR' | 'ILS' | 'INR' | 'KRW' | 'MXN' | 'MYR' | 'NZD' | 'PHP' | 'SGD' | 'THB' | 'ZAR' | 'ARS' | 'CLP' | 'SAR' | 'AED' | 'QAR' — Currency matches one of currency values as specified in ISO-4217.
    - `freightCharge` number, float — Freight costs
    - `taxation` string
    - `taxes` object
      - `normalTax` object, nullable
        - `rate` number — percentual rate
        - `amount` number, float — absolut amount
      - `reducedTax` object, nullable
        - `rate` number — percentual rate
        - `amount` number, float — absolut amount
      - `customTax1` object, nullable
        - `rate` number — percentual rate
        - `amount` number, float — absolut amount
      - `customTax2` object, nullable
        - `rate` number — percentual rate
        - `amount` number, float — absolut amount
    - `paymentTerms` object
      - `dueDate` string, date, nullable
      - `earlyPaymentDate` string, date, nullable
      - `earlyPaymentDiscount` number, float
      - `earlyPaymentDiscountAmount` number, float
    - `bookingText` string — header booking text
    - `payment` object — payment information
      - `methodName` string
      - `paidAmount` number, float
      - `paidOnDate` string, date, nullable
      - `discountReceived` number, float
    - `glAccount` string, nullable — ledger account
    - `costCenter` string, nullable — cost center
  - `assignedPurchaseOrders` object[], nullable
    - `id` string, required — Resource identifier.
    - `number` string
    - `amountGross` number, float
    - `amountNet` number, float
    - `project` object, required — related project ID
      - `id` string, required — Resource identifier.
    - `salesOrder` object, nullable
      - `id` string, required — Resource identifier.
    - `costCenter` string
  - `bookingText` string — header booking text
  - `project` object — related project ID
    - `id` string — Resource identifier.
  - `accounting` object[]
    - `glAccount` string — Resource identifier.
    - `bookingText` string — 1st accounting entry text
    - `amount` object — Money object with amount and currency
      - `amount` string, float — A string representing the amount
      - `currency` 'EUR' | 'USD' | 'JPY' | 'BGN' | 'CZK' | 'DKK' | 'GBP' | 'HUF' | 'PLN' | 'RON' | 'SEK' | 'CHF' | 'ISK' | 'NOK' | 'HRK' | 'RUB' | 'TRY' | 'AUD' | 'BRL' | 'CAD' | 'CNY' | 'HKD' | 'IDR' | 'ILS' | 'INR' | 'KRW' | 'MXN' | 'MYR' | 'NZD' | 'PHP' | 'SGD' | 'THB' | 'ZAR' | 'ARS' | 'CLP' | 'SAR' | 'AED' | 'QAR' — Currency matches one of currency values as specified in ISO-4217.
    - `tax` object — percentual tax rate
      - `rate` number, float
    - `costCenter` string
  - `paymentTerms` object
    - `dueDate` string, date, nullable
    - `earlyPaymentDate` string, date, nullable
    - `earlyPaymentDiscount` number, float
  - `payment` object — payment information
    - `methodName` string
    - `paidAmount` number, float
    - `paidOnDate` string, date, nullable
    - `discountReceived` number, float
  - `positions` object[]
    - `sort` number — The position of the position in the list
    - `number` string
    - `purchaseOrder` object, nullable
      - `id` string — Resource identifier.
    - `product` object, required
      - `id` string, required — Resource identifier.
      - `supplierProductNumber` string
    - `deliveryDate` string, date, nullable — The date the position was delivered
    - `quantity` number — The quantity of the position
    - `unit` string
    - `packagingUnit` string
    - `price` object, required — Money object with amount and currency
      - `amount` string, float — A string representing the amount
      - `currency` 'EUR' | 'USD' | 'JPY' | 'BGN' | 'CZK' | 'DKK' | 'GBP' | 'HUF' | 'PLN' | 'RON' | 'SEK' | 'CHF' | 'ISK' | 'NOK' | 'HRK' | 'RUB' | 'TRY' | 'AUD' | 'BRL' | 'CAD' | 'CNY' | 'HKD' | 'IDR' | 'ILS' | 'INR' | 'KRW' | 'MXN' | 'MYR' | 'NZD' | 'PHP' | 'SGD' | 'THB' | 'ZAR' | 'ARS' | 'CLP' | 'SAR' | 'AED' | 'QAR' — Currency matches one of currency values as specified in ISO-4217.
    - `costCenter` string
    - `tax` object, required
      - `vatCategory` string — The category of the value added tax
      - `rate` number, float, required — Tax rate in percent
      - `taxText` string, nullable

## Response `201`

Resource successfully created response

## Other responses

- `400` — IETF RFC 9457 Problem API compliant response
- `401` — Unable to authenticate the client
- `403` — Unable to authorize the client
- `404` — Resource was not found or not enough access privileges
- `415` — Resource representation send in the request is not supported.
- `429` — Too many API calls made.

---

[API](https://skmtc.net/xentral/apis/xentral-api.md) · [All operations](https://skmtc.net/xentral/apis/xentral-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/xentral/xentral-api/revisions/8a27ba392442/schema)