iRetail PRO store node 1.0.0-m1: catalog
4 операции
← Вся документация · Источник: контракты, openapi/store-v1.yaml на коммите 8000474.
Справочники на английском — на языке контрактов, из которых они созданы.
← iRetail PRO store node 1.0.0-m1
Операции
GET
/v1/recipes
Recipes (spec/STOCK.md, Recipes and production).
operationId
listRecipes · Право item.read
Параметры
| Имя | Где | Тип | Описание |
|---|---|---|---|
IRetail-App
|
header | string |
Which app sends the request, at which version: <app>/<version>, optionally a space and (<platform>), as cashier/1.2.0 (windows-x64) or manager/1.2.0 (web). The register (cashier), the back office and the console (manager) and the device gateway (gateway) send it on every request; a request without it is not one of the apps and is served as the current API, and a device token of an app's kind without it is an app of an unknown version; a header that does not parse counts as absent. The node may refuse an app 426 app_update_required by it, except on the operations marked x-app-update-exempt. Not a security boundary (spec/API.md, Transport; spec/RELEASES.md, Who is asking). |
product_item_id
|
query | string (uuid) |
One product's. |
Ответы
POST
/v1/recipes
Add a recipe.
operationId
createRecipe · Право production.manage
Параметры
| Имя | Где | Тип | Описание |
|---|---|---|---|
IRetail-App
|
header | string |
Which app sends the request, at which version: <app>/<version>, optionally a space and (<platform>), as cashier/1.2.0 (windows-x64) or manager/1.2.0 (web). The register (cashier), the back office and the console (manager) and the device gateway (gateway) send it on every request; a request without it is not one of the apps and is served as the current API, and a device token of an app's kind without it is an app of an unknown version; a header that does not parse counts as absent. The node may refuse an app 426 app_update_required by it, except on the operations marked x-app-update-exempt. Not a security boundary (spec/API.md, Transport; spec/RELEASES.md, Who is asking). |
Idempotency-Key
|
header | string |
spec/API.md, Idempotency. |
Тело запроса обязательный
application/jsonRecipeWrite
Ответы
PATCH
/v1/recipes/{id}
Change a recipe.
operationId
patchRecipe · Право production.manage
Параметры
| Имя | Где | Тип | Описание |
|---|---|---|---|
IRetail-App
|
header | string |
Which app sends the request, at which version: <app>/<version>, optionally a space and (<platform>), as cashier/1.2.0 (windows-x64) or manager/1.2.0 (web). The register (cashier), the back office and the console (manager) and the device gateway (gateway) send it on every request; a request without it is not one of the apps and is served as the current API, and a device token of an app's kind without it is an app of an unknown version; a header that does not parse counts as absent. The node may refuse an app 426 app_update_required by it, except on the operations marked x-app-update-exempt. Not a security boundary (spec/API.md, Transport; spec/RELEASES.md, Who is asking). |
id обязательный
|
path | string (uuid) |
Id. |
If-Match
|
header | string |
The version the change is based on. |
Тело запроса обязательный
application/jsonRecipePatch
Ответы
GET
/v1/items/{id}/price-split
How a quantity of the item splits into lines by batch price (spec/PRICING.md, Batch prices); nothing is held.
operationId
priceSplit · Право item.read
Параметры
| Имя | Где | Тип | Описание |
|---|---|---|---|
IRetail-App
|
header | string |
Which app sends the request, at which version: <app>/<version>, optionally a space and (<platform>), as cashier/1.2.0 (windows-x64) or manager/1.2.0 (web). The register (cashier), the back office and the console (manager) and the device gateway (gateway) send it on every request; a request without it is not one of the apps and is served as the current API, and a device token of an app's kind without it is an app of an unknown version; a header that does not parse counts as absent. The node may refuse an app 426 app_update_required by it, except on the operations marked x-app-update-exempt. Not a security boundary (spec/API.md, Transport; spec/RELEASES.md, Who is asking). |
id обязательный
|
path | string (uuid) |
Id. |
quantity_milli обязательный
|
query | integer (int64) |
The item's whole quantity on the receipt. |
lot
|
query | string |
A GS1 code's lot, taken first. |
Ответы
Схемы
Error object
Every error response.
error обязательный
|
string |
Stable code, see spec/API.md. |
message обязательный
|
string |
English text for logs. |
details
|
object |
ReceiptLineBatch object
batch_id обязательный
|
string (uuid) |
|
quantity_milli обязательный
|
integer (int64) |
|
item_id
|
string (uuid) |
A kit line's component the batch belongs to (spec/STOCK.md, Kits). |
Component object
A kit's or a recipe's component: how much of the item (spec/STOCK.md).
item_id обязательный
|
string (uuid) |
|
quantity_milli обязательный
|
integer (int64) |
Recipe object
spec/STOCK.md, Recipes and production; hub-owned in a chain.
id обязательный
|
string (uuid) |
|
product_item_id обязательный
|
string (uuid) |
|
yield_milli обязательный
|
integer (int64) |
|
components обязательный
|
array of Component |
|
active обязательный
|
boolean |
|
version обязательный
|
integer (int64) |
RecipeWrite object
product_item_id обязательный
|
string (uuid) |
|
yield_milli обязательный
|
integer (int64) |
|
components обязательный
|
array of Component |
|
active
|
boolean |
RecipePatch object
yield_milli
|
integer (int64) |
|
components
|
array of Component |
|
active
|
boolean |
PriceSplitLine object
One line of the price split (spec/PRICING.md, Batch prices).
unit_price_minor обязательный
|
integer (int64) |
|
quantity_milli обязательный
|
integer (int64) |
|
batches обязательный
|
array of ReceiptLineBatch |
PriceSplit object
item_id обязательный
|
string (uuid) |
|
lines обязательный
|
array of PriceSplitLine |