---
title: "Create positions for invoice"
method: POST
path: "/api/v1/invoices/{id}/positions"
tags: ["Invoice"]
---

# Create positions for invoice

`POST /api/v1/invoices/{id}/positions`

Adds invoice positions

## Path parameters

- `id` string, required — Resource identifier.

## Request body

- object[]
  - `salesOrderPosition` object, nullable — Nullable reference to another resource
    - `id` string, required — Resource identifier.
  - `product` object — Reference to another resource
    - `id` string, required — Resource identifier.
  - `quantity` string, float — The quantity for the position
  - `price` 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.
  - `deliveryDate` string, date — The VAT category that applies to the position
  - `discounts` object — Discounts applied to position
    - `totalPercent` string, float, nullable — The percentage discount applied to position

## 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)