> For the complete documentation index, see [llms.txt](https://apidocs.akinon.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://apidocs.akinon.com/commerce-openapis/admin/product-price.md).

# Product Price

Administrative endpoints for **product price** — the primary selling price of a product in the catalog. There is at most one price record per product (`product` is a one-to-one reference), holding the selling price, the currency, the tax rate, and an optional retail (original) price.

Additional per-seller or per-price-list prices are managed separately through the `extra_product_price` endpoints.

### Core Capabilities

**1. Listing & Filtering**

* Retrieve a paginated list of product-price records.
* Filter by record identifier (`id`) or by product identifier (`product`).
* Order results with the `sort` parameter.

**2. Full CRUD**

* Create a price record for a product.
* Retrieve a single record.
* Fully or partially update a record.
* Call `DELETE` to have the endpoint acknowledge the request without making any change — the record is **never removed** (see **Deleting a Product Price** below).

**3. Bulk Upsert**

* Create or update many records in one request through `POST /product_price/bulk_upsert/`.

### Product Price Fields

| Field           | Type                       | Description                                                                                                                               |
| --------------- | -------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| `pk`            | integer                    | The unique identifier of the record. Read-only.                                                                                           |
| `product`       | integer                    | The identifier of the product this price belongs to. Required on create. One record per product; the product cannot be changed on update. |
| `price`         | string (decimal)           | The selling price. A positive decimal with up to 12 digits and 2 decimal places. Required on create.                                      |
| `currency_type` | string                     | The ISO 4217 currency code (see **Currency Codes** below). Defaults to `try`.                                                             |
| `tax_rate`      | string (decimal)           | The tax rate applied to the price. A decimal with up to 5 digits and 2 decimal places.                                                    |
| `retail_price`  | string (decimal) or `null` | The original or reference retail price. Optional; `null` when not set.                                                                    |
| `extra_field`   | object                     | Free-form JSON for extra data. Optional; defaults to an empty object.                                                                     |

### Currency Codes

The `currency_type` field accepts the following ISO 4217 currency codes.

| Value | Currency                        |
| ----- | ------------------------------- |
| `try` | Turkish Lira                    |
| `eur` | Euro                            |
| `usd` | US Dollar                       |
| `egp` | Egyptian Pound                  |
| `gbp` | Pound Sterling                  |
| `mad` | Moroccan Dirham                 |
| `pln` | Polish Zloty                    |
| `sar` | Saudi Riyal                     |
| `ron` | Romanian Leu                    |
| `uah` | Ukrainian Hryvnia               |
| `czk` | Czech Koruna                    |
| `huf` | Hungarian Forint                |
| `rub` | Russian Ruble                   |
| `bgn` | Bulgarian Lev                   |
| `iqd` | Iraqi Dinar                     |
| `kwd` | Kuwaiti Dinar                   |
| `bhd` | Bahraini Dinar                  |
| `omr` | Omani Rial                      |
| `qar` | Qatari Riyal                    |
| `aed` | UAE Dirham                      |
| `ngn` | Nigerian Naira                  |
| `inr` | Indian Rupee                    |
| `lei` | Romanian Leu (alternative code) |
| `kzt` | Kazakhstani Tenge               |
| `jod` | Jordanian Dinar                 |
| `rsd` | Serbian Dinar                   |
| `amd` | Armenian Dram                   |
| `cfa` | CFA Franc                       |
| `lyd` | Libyan Dinar                    |

### Deleting a Product Price

> **Important:** `DELETE /product_price/{id}/` is a **no-op** — the endpoint returns `204 No Content` but the record is **not** modified and **not** removed. A price record cannot be deleted through the API.

### Dynamic Settings & Environment Variables

The write endpoints are affected by the following dynamic setting, configured in the management panel. It is referenced again in the description of the operations it affects.

| Key                              | Type                        | Default                                                         | Effect                                                                                                                                                                                                                                                                                                                                 |
| -------------------------------- | --------------------------- | --------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `GROUPED_PRODUCT_PRICE_SELECTOR` | string (dotted Python path) | `"omnishop.catalogs.selector.group_product_min_price_selector"` | Selects how a grouped product's representative price is computed from its children after a child price is written. Available selectors: `group_product_min_price_selector` (minimum), `group_product_max_price_selector` (maximum), `group_product_sum_price_selector` (sum). Does not affect read operations or non-grouped products. |

**Environment variables:** No environment variables are read directly by these endpoints.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://apidocs.akinon.com/commerce-openapis/admin/product-price.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
