iRetail PRO store node 1.0.0-m1: pricing

6 операций

← Вся документация · Источник: контракты, openapi/store-v1.yaml на коммите 8000474.

Справочники на английском — на языке контрактов, из которых они созданы.

← iRetail PRO store node 1.0.0-m1

Операции

POST /v1/pricing/proposals Prices proposed from the last receiving cost by a markup rule (spec/PRICING.md). Writes nothing.

operationId proposePrices · Право price.edit

Параметры

Имя Где Тип Описание
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).

Тело запроса обязательный

Ответы

GET /v1/expiry-rules Expiry rules (spec/PRICING.md, Expiry rules).

operationId listExpiryRules · Право 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).

Ответы

POST /v1/expiry-rules Add an expiry rule.

operationId createExpiryRule · Право expiry.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.

Тело запроса обязательный

Ответы

PATCH /v1/expiry-rules/{id} Change an expiry rule.

operationId patchExpiryRule · Право expiry.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.

Тело запроса обязательный

Ответы

  • 200 OK ExpiryRule
  • 400 Error (spec/API.md). Error
  • 401 Error (spec/API.md). Error
  • 403 Error (spec/API.md). Error
  • 404 Error (spec/API.md). Error
  • 409 Error (spec/API.md). Error
  • 412 Error (spec/API.md). Error
  • 422 Error (spec/API.md). Error
DELETE /v1/expiry-rules/{id} Delete an expiry rule.

operationId deleteExpiryRule · Право expiry.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.

Ответы

  • 204 Done
  • 401 Error (spec/API.md). Error
  • 403 Error (spec/API.md). Error
  • 404 Error (spec/API.md). Error
  • 409 Error (spec/API.md). Error
  • 412 Error (spec/API.md). Error
POST /v1/expiry-rules/run Run today's expiry rules if they have not run; answers the day's documents either way.

operationId runExpiryRules · Право expiry.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).

Ответы

Схемы

Error object

Every error response.

error обязательный string Stable code, see spec/API.md.
message обязательный string English text for logs.
details object

PriceProposalRequest object

Either item_ids or group_id.

item_ids array of string (uuid)
group_id string (uuid)
markup_ppm обязательный integer
round_to_minor integer
ending_minor integer | null
ending_base integer | null

PriceProposals object

lines обязательный array of object

ExpiryStep object

days_before обязательный integer
rate_ppm обязательный integer

ExpiryRule object

spec/PRICING.md, Expiry rules; hub-owned in a chain.

id обязательный string (uuid)
item_ids обязательный array of string (uuid)
group_ids обязательный array of string (uuid)
markdowns обязательный array of ExpiryStep
auto_post обязательный boolean
write_off_expired обязательный boolean
round_to_minor обязательный integer
ending_minor обязательный integer | null
ending_base обязательный integer | null
active обязательный boolean
version обязательный integer (int64)

ExpiryRuleWrite object

item_ids array of string (uuid)
group_ids array of string (uuid)
markdowns обязательный array of ExpiryStep
auto_post boolean
write_off_expired boolean
round_to_minor integer
ending_minor integer | null
ending_base integer | null
active boolean

ExpiryRulePatch object

item_ids array of string (uuid)
group_ids array of string (uuid)
markdowns array of ExpiryStep
auto_post boolean
write_off_expired boolean
round_to_minor integer
ending_minor integer | null
ending_base integer | null
active boolean

ExpiryRun object

The documents a day's expiry run made.

business_date обязательный string (date)
ran_at обязательный string (date-time)
price_change_ids обязательный array of string (uuid)
write_off_id обязательный string (uuid) | null