Авторизация
Authorization: Bearer <HALLIFY_PREORDER_DRAFT_TOKEN>Гостевой токен своего публичного черновика предзаказа.
Параметры
draftReferenceПуть · ОбязательноНепрозрачный ссылочный идентификатор публичного черновика. Для авторизации дополнительно требуется отдельный токен черновика.
stringПолное определение
{ "type": "string", "example": "example" }idempotency-keyЗаголовок · ОбязательноОбязательный ключ идемпотентности длиной до 128 символов.
stringПолное определение
{ "type": "string", "minLength": 1, "maxLength": 128, "example": "example" }originЗаголовок · ОбязательноOrigin браузера проверяется по разрешённым источникам публичного канала. Отсутствующий или запрещённый Origin отклоняется без раскрытия закрытой конфигурации заведения.
stringПолное определение
{ "type": "string", "example": "example" }
Тело запроса
Обязательно
По токену черновика проверяет код контакта, актуальную корзину и интервал исполнения, затем выдаёт одноразовое ценовое предложение с ограниченным сроком действия.
application/json
Полное определение
{
"$ref": "#/components/schemas/VerifyPublicPreorderDraftDto"
}Ответы
200Возвращает рассчитанную стоимость, требования к депозиту, доступность и защищённый токен предложения.
Полное определение
{
"$ref": "#/components/schemas/PreorderQuoteDto"
}{
"quoteId": "123728f6-ac4b-43a8-8f9e-44585ec81783",
"quoteToken": "synthetic-example-credential",
"status": "ISSUED",
"serviceMode": "DINE_IN",
"scheduledFor": "2026-01-15T12:00:00.000Z",
"lines": [
{
"clientLineId": "example-id",
"sortOrder": 1,
"quantity": 1,
"menuItemId": "16ee6f36-c0cb-4311-85e8-2d2b3edea0fd",
"menuVariantId": null,
"name": "Example name",
"unitPrice": "1.00",
"lineTotal": "1.00",
"policyHash": "deadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeef",
"structurePlanHash": "deadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeef"
}
],
"financialPolicyVersionId": "b36de587-2415-41cd-8269-c8dc9aa8ee66",
"financialPolicyHash": "deadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeef",
"fulfillmentPolicyHash": "deadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeef",
"adjustmentEvidenceHash": "deadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeef",
"capacityUnits": 1,
"quotedSubtotal": "1.00",
"quotedDiscountTotal": "1.00",
"quotedServiceCharge": "1.00",
"quotedTax": "1.00",
"quotedDeliveryFee": "1.00",
"quotedTotal": "1.00",
"quotedNetPaid": "1.00",
"quotedRemaining": "1.00",
"quotedRefundDue": "1.00",
"quotedDepositRequired": "1.00",
"depositDueAt": null,
"cancellationCutoffAt": null,
"currency": "GEL",
"issuedAt": "2026-01-15T10:00:00.000Z",
"expiresAt": "2026-12-31T18:00:00.000Z"
}401Отклоняет отсутствующий, некорректный, истёкший, отозванный или недействительный ключ preorderDraftToken на границе владеющего домена.
Полное определение
{
"$ref": "#/components/schemas/TranslatedErrorDto"
}{
"statusCode": 401,
"error": "errors:http.unauthorized",
"code": "HTTP_UNAUTHORIZED",
"message": "errors:http.unauthorized",
"translationKey": "errors:http.unauthorized"
}409Ключ идемпотентности уже обрабатывается или повторно использован с другим телом.
Полное определение
{
"$ref": "#/components/schemas/IdempotencyConflictError"
}{
"statusCode": 409,
"error": "errors:http.conflict",
"code": "IDEMPOTENCY_REQUEST_IN_PROGRESS",
"message": "errors:idempotency.inProgress",
"translationKey": "errors:idempotency.inProgress"
}Схемы
VerifyPublicPreorderDraftDto
По токену черновика проверяет код контакта, актуальную корзину и интервал исполнения, затем выдаёт одноразовое ценовое предложение с ограниченным сроком действия.
codeОбязательноСтабильный код
codeдля классификации или идентификации. Ограничения: минимальная длина 6; максимальная длина 6.stringПолное определение
{ "type": "string", "minLength": 6, "maxLength": 6, "description": "Стабильный код `code` для классификации или идентификации. Ограничения: минимальная длина 6; максимальная длина 6.", "example": "000001" }
Полное определение
{
"type": "object",
"properties": {
"code": {
"type": "string",
"minLength": 6,
"maxLength": 6,
"description": "Стабильный код `code` для классификации или идентификации. Ограничения: минимальная длина 6; максимальная длина 6.",
"example": "000001"
}
},
"required": [
"code"
],
"description": "По токену черновика проверяет код контакта, актуальную корзину и интервал исполнения, затем выдаёт одноразовое ценовое предложение с ограниченным сроком действия.",
"example": {
"code": "000001"
}
}PreorderQuoteDto
Возвращает рассчитанные цены, доступность, требования к депозиту и защищённый токен предложения с ограниченным сроком действия.
quoteIdОбязательноUUID Hallify для
quoteId.string · uuidПолное определение
{ "type": "string", "format": "uuid", "description": "UUID Hallify для `quoteId`.", "example": "123728f6-ac4b-43a8-8f9e-44585ec81783" }quoteTokenОбязательноПодписанный токен, связывающий рассчитанное предложение с исходными данными предзаказа, снимком цен и сроком действия для последующего принятия.
stringПолное определение
{ "type": "string", "description": "Подписанный токен, связывающий рассчитанное предложение с исходными данными предзаказа, снимком цен и сроком действия для последующего принятия.", "example": "synthetic-example-credential" }statusОбязательноТекущий статус жизненного цикла
status; допустимые значения: ISSUED, ACCEPTED, DECLINED, EXPIRED, SUPERSEDED.stringПолное определение
{ "type": "string", "enum": [ "ISSUED", "ACCEPTED", "DECLINED", "EXPIRED", "SUPERSEDED" ], "description": "Текущий статус жизненного цикла `status`; допустимые значения: ISSUED, ACCEPTED, DECLINED, EXPIRED, SUPERSEDED.", "example": "ISSUED" }serviceModeОбязательноДопустимые значения
serviceMode: DINE_IN, PICKUP, DELIVERY, CATERING.stringПолное определение
{ "type": "string", "enum": [ "DINE_IN", "PICKUP", "DELIVERY", "CATERING" ], "description": "Допустимые значения `serviceMode`: DINE_IN, PICKUP, DELIVERY, CATERING.", "example": "DINE_IN" }scheduledForОбязательноВремя
scheduledForв формате RFC3339; разные часовые смещения могут обозначать один абсолютный момент.string · date-timeПолное определение
{ "type": "string", "format": "date-time", "description": "Время `scheduledFor` в формате RFC3339; разные часовые смещения могут обозначать один абсолютный момент.", "example": "2026-01-15T12:00:00.000Z" }linesОбязательноКоллекция
linesв составе представления.arrayПолное определение
{ "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "clientLineId": { "type": "string", "minLength": 1, "maxLength": 100, "description": "Непрозрачный идентификатор `clientLineId`; клиент не должен предполагать формат UUID. Ограничения: минимальная длина 1; максимальная длина 100.", "example": "example-id" }, "sortOrder": { "type": "integer", "minimum": 0, "description": "Целочисленная позиция сортировки `sortOrder`; меньшие значения идут первыми. Ограничения: минимум 0.", "example": 1 }, "quantity": { "type": "integer", "minimum": 1, "description": "Целое количество `quantity` в единице измерения содержащей его позиции или строки. Ограничения: минимум 1.", "example": 1 }, "menuItemId": { "type": "string", "format": "uuid", "description": "UUID Hallify для `menuItemId`.", "example": "16ee6f36-c0cb-4311-85e8-2d2b3edea0fd" }, "menuVariantId": { "type": "string", "format": "uuid", "nullable": true, "description": "UUID Hallify для `menuVariantId`. Null означает отсутствие записанного значения в этом представлении.", "example": "94389946-e5d8-4fba-8358-e3a9c8a04b11" }, "name": { "type": "string", "description": "Понятное человеку значение `name`.", "example": "Example name" }, "unitPrice": { "type": "string", "pattern": "^\\d{1,10}\\.\\d{2}$", "description": "Десятичная денежная величина `unitPrice`, сериализованная строкой в валюте поля `currency`. Ноль означает записанную сумму, а не отсутствие значения.", "example": "1.00" }, "lineTotal": { "type": "string", "pattern": "^\\d{1,10}\\.\\d{2}$", "description": "Десятичная денежная величина `lineTotal`, сериализованная строкой в валюте поля `currency`. Ноль означает записанную сумму, а не отсутствие значения.", "example": "1.00" }, "policyHash": { "type": "string", "pattern": "^[a-f0-9]{64}$", "description": "Непрозрачный отпечаток `policyHash` точного снимка применённых правил.", "example": "deadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeef" }, "structurePlanHash": { "type": "string", "pattern": "^[a-f0-9]{64}$", "description": "Непрозрачный отпечаток `structurePlanHash` плана структуры позиции заказа на момент расчёта цены.", "example": "deadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeef" } }, "required": [ "clientLineId", "sortOrder", "quantity", "menuItemId", "menuVariantId", "name", "unitPrice", "lineTotal", "policyHash", "structurePlanHash" ], "example": { "clientLineId": "example-id", "sortOrder": 1, "quantity": 1, "menuItemId": "16ee6f36-c0cb-4311-85e8-2d2b3edea0fd", "menuVariantId": null, "name": "Example name", "unitPrice": "1.00", "lineTotal": "1.00", "policyHash": "deadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeef", "structurePlanHash": "deadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeef" } }, "description": "Коллекция `lines` в составе представления.", "example": [ { "clientLineId": "example-id", "sortOrder": 1, "quantity": 1, "menuItemId": "16ee6f36-c0cb-4311-85e8-2d2b3edea0fd", "menuVariantId": null, "name": "Example name", "unitPrice": "1.00", "lineTotal": "1.00", "policyHash": "deadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeef", "structurePlanHash": "deadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeef" } ] }financialPolicyVersionIdОбязательноUUID Hallify для
financialPolicyVersionId.string · uuidПолное определение
{ "type": "string", "format": "uuid", "description": "UUID Hallify для `financialPolicyVersionId`.", "example": "b36de587-2415-41cd-8269-c8dc9aa8ee66" }financialPolicyHashОбязательноНепрозрачный отпечаток
financialPolicyHashточного снимка применённых правил.stringПолное определение
{ "type": "string", "pattern": "^[a-f0-9]{64}$", "description": "Непрозрачный отпечаток `financialPolicyHash` точного снимка применённых правил.", "example": "deadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeef" }fulfillmentPolicyHashОбязательноНепрозрачный отпечаток
financialPolicyHashточного снимка применённых правил.stringПолное определение
{ "type": "string", "pattern": "^[a-f0-9]{64}$", "description": "Непрозрачный отпечаток `financialPolicyHash` точного снимка применённых правил.", "example": "deadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeef" }adjustmentEvidenceHashОбязательноНепрозрачный отпечаток
adjustmentEvidenceHash, защищающий приложенные неизменяемые доказательства.stringПолное определение
{ "type": "string", "pattern": "^[a-f0-9]{64}$", "description": "Непрозрачный отпечаток `adjustmentEvidenceHash`, защищающий приложенные неизменяемые доказательства.", "example": "deadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeef" }capacityUnitsОбязательноЦелочисленное значение
capacityUnits. Ограничения: минимум 1; максимум 10000.integerПолное определение
{ "type": "integer", "minimum": 1, "maximum": 10000, "description": "Целочисленное значение `capacityUnits`. Ограничения: минимум 1; максимум 10000.", "example": 1 }quotedSubtotalОбязательноДесятичная денежная величина
quotedSubtotal, сериализованная строкой в валюте поляcurrency. Ноль означает записанную сумму, а не отсутствие значения.stringПолное определение
{ "type": "string", "pattern": "^\\d{1,10}\\.\\d{2}$", "description": "Десятичная денежная величина `quotedSubtotal`, сериализованная строкой в валюте поля `currency`. Ноль означает записанную сумму, а не отсутствие значения.", "example": "1.00" }quotedDiscountTotalОбязательноДесятичная денежная величина
quotedDiscountTotal, сериализованная строкой в валюте поляcurrency. Ноль означает записанную сумму, а не отсутствие значения.stringПолное определение
{ "type": "string", "pattern": "^\\d{1,10}\\.\\d{2}$", "description": "Десятичная денежная величина `quotedDiscountTotal`, сериализованная строкой в валюте поля `currency`. Ноль означает записанную сумму, а не отсутствие значения.", "example": "1.00" }quotedServiceChargeОбязательноДесятичная денежная величина
quotedServiceCharge, сериализованная строкой в валюте поляcurrency. Ноль означает записанную сумму, а не отсутствие значения.stringПолное определение
{ "type": "string", "pattern": "^\\d{1,10}\\.\\d{2}$", "description": "Десятичная денежная величина `quotedServiceCharge`, сериализованная строкой в валюте поля `currency`. Ноль означает записанную сумму, а не отсутствие значения.", "example": "1.00" }quotedTaxОбязательноДесятичная денежная величина
quotedTax, сериализованная строкой в валюте поляcurrency. Ноль означает записанную сумму, а не отсутствие значения.stringПолное определение
{ "type": "string", "pattern": "^\\d{1,10}\\.\\d{2}$", "description": "Десятичная денежная величина `quotedTax`, сериализованная строкой в валюте поля `currency`. Ноль означает записанную сумму, а не отсутствие значения.", "example": "1.00" }quotedDeliveryFeeОбязательноДесятичная денежная величина
quotedDeliveryFee, сериализованная строкой в валюте поляcurrency. Ноль означает записанную сумму, а не отсутствие значения.stringПолное определение
{ "type": "string", "pattern": "^\\d{1,10}\\.\\d{2}$", "description": "Десятичная денежная величина `quotedDeliveryFee`, сериализованная строкой в валюте поля `currency`. Ноль означает записанную сумму, а не отсутствие значения.", "example": "1.00" }quotedTotalОбязательноДесятичная денежная величина
quotedTotal, сериализованная строкой в валюте поляcurrency. Ноль означает записанную сумму, а не отсутствие значения.stringПолное определение
{ "type": "string", "pattern": "^\\d{1,10}\\.\\d{2}$", "description": "Десятичная денежная величина `quotedTotal`, сериализованная строкой в валюте поля `currency`. Ноль означает записанную сумму, а не отсутствие значения.", "example": "1.00" }quotedNetPaidОбязательноНепрозрачный идентификатор
quotedNetPaid; клиент не должен предполагать формат UUID.stringПолное определение
{ "type": "string", "pattern": "^\\d{1,10}\\.\\d{2}$", "description": "Непрозрачный идентификатор `quotedNetPaid`; клиент не должен предполагать формат UUID.", "example": "1.00" }quotedRemainingОбязательноРассчитанный остаток
quotedRemaining.stringПолное определение
{ "type": "string", "pattern": "^\\d{1,10}\\.\\d{2}$", "description": "Рассчитанный остаток `quotedRemaining`.", "example": "1.00" }quotedRefundDueОбязательноДесятичная денежная величина
quotedRefundDue, сериализованная строкой в валюте поляcurrency. Ноль означает записанную сумму, а не отсутствие значения.stringПолное определение
{ "type": "string", "pattern": "^\\d{1,10}\\.\\d{2}$", "description": "Десятичная денежная величина `quotedRefundDue`, сериализованная строкой в валюте поля `currency`. Ноль означает записанную сумму, а не отсутствие значения.", "example": "1.00" }quotedDepositRequiredОбязательноТребуемый рассчитанный депозит
quotedDepositRequired.stringПолное определение
{ "type": "string", "pattern": "^\\d{1,10}\\.\\d{2}$", "description": "Требуемый рассчитанный депозит `quotedDepositRequired`.", "example": "1.00" }depositDueAtОбязательноВремя
depositDueAtв формате RFC3339; разные часовые смещения могут обозначать один абсолютный момент. Null означает отсутствие записанного значения в этом представлении.string · date-time · nullПолное определение
{ "type": "string", "format": "date-time", "nullable": true, "description": "Время `depositDueAt` в формате RFC3339; разные часовые смещения могут обозначать один абсолютный момент. Null означает отсутствие записанного значения в этом представлении.", "example": "2026-12-31T18:00:00.000Z" }cancellationCutoffAtОбязательноВремя
cancellationCutoffAtв формате RFC3339; разные часовые смещения могут обозначать один абсолютный момент. Null означает отсутствие записанного значения в этом представлении.string · date-time · nullПолное определение
{ "type": "string", "format": "date-time", "nullable": true, "description": "Время `cancellationCutoffAt` в формате RFC3339; разные часовые смещения могут обозначать один абсолютный момент. Null означает отсутствие записанного значения в этом представлении.", "example": "2026-01-15T12:00:00.000Z" }currencyОбязательноКод валюты ISO 4217 в
currencyдля денежных значений этого представления.stringПолное определение
{ "type": "string", "pattern": "^[A-Z]{3}$", "description": "Код валюты ISO 4217 в `currency` для денежных значений этого представления.", "example": "GEL" }issuedAtОбязательноВремя
issuedAtв формате RFC3339; разные часовые смещения могут обозначать один абсолютный момент.string · date-timeПолное определение
{ "type": "string", "format": "date-time", "description": "Время `issuedAt` в формате RFC3339; разные часовые смещения могут обозначать один абсолютный момент.", "example": "2026-01-15T10:00:00.000Z" }expiresAtОбязательноВремя
expiresAtв формате RFC3339; разные часовые смещения могут обозначать один абсолютный момент.string · date-timeПолное определение
{ "type": "string", "format": "date-time", "description": "Время `expiresAt` в формате RFC3339; разные часовые смещения могут обозначать один абсолютный момент.", "example": "2026-12-31T18:00:00.000Z" }
Полное определение
{
"type": "object",
"properties": {
"quoteId": {
"type": "string",
"format": "uuid",
"description": "UUID Hallify для `quoteId`.",
"example": "123728f6-ac4b-43a8-8f9e-44585ec81783"
},
"quoteToken": {
"type": "string",
"description": "Подписанный токен, связывающий рассчитанное предложение с исходными данными предзаказа, снимком цен и сроком действия для последующего принятия.",
"example": "synthetic-example-credential"
},
"status": {
"type": "string",
"enum": [
"ISSUED",
"ACCEPTED",
"DECLINED",
"EXPIRED",
"SUPERSEDED"
],
"description": "Текущий статус жизненного цикла `status`; допустимые значения: ISSUED, ACCEPTED, DECLINED, EXPIRED, SUPERSEDED.",
"example": "ISSUED"
},
"serviceMode": {
"type": "string",
"enum": [
"DINE_IN",
"PICKUP",
"DELIVERY",
"CATERING"
],
"description": "Допустимые значения `serviceMode`: DINE_IN, PICKUP, DELIVERY, CATERING.",
"example": "DINE_IN"
},
"scheduledFor": {
"type": "string",
"format": "date-time",
"description": "Время `scheduledFor` в формате RFC3339; разные часовые смещения могут обозначать один абсолютный момент.",
"example": "2026-01-15T12:00:00.000Z"
},
"lines": {
"type": "array",
"minItems": 1,
"items": {
"type": "object",
"properties": {
"clientLineId": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "Непрозрачный идентификатор `clientLineId`; клиент не должен предполагать формат UUID. Ограничения: минимальная длина 1; максимальная длина 100.",
"example": "example-id"
},
"sortOrder": {
"type": "integer",
"minimum": 0,
"description": "Целочисленная позиция сортировки `sortOrder`; меньшие значения идут первыми. Ограничения: минимум 0.",
"example": 1
},
"quantity": {
"type": "integer",
"minimum": 1,
"description": "Целое количество `quantity` в единице измерения содержащей его позиции или строки. Ограничения: минимум 1.",
"example": 1
},
"menuItemId": {
"type": "string",
"format": "uuid",
"description": "UUID Hallify для `menuItemId`.",
"example": "16ee6f36-c0cb-4311-85e8-2d2b3edea0fd"
},
"menuVariantId": {
"type": "string",
"format": "uuid",
"nullable": true,
"description": "UUID Hallify для `menuVariantId`. Null означает отсутствие записанного значения в этом представлении.",
"example": "94389946-e5d8-4fba-8358-e3a9c8a04b11"
},
"name": {
"type": "string",
"description": "Понятное человеку значение `name`.",
"example": "Example name"
},
"unitPrice": {
"type": "string",
"pattern": "^\\d{1,10}\\.\\d{2}$",
"description": "Десятичная денежная величина `unitPrice`, сериализованная строкой в валюте поля `currency`. Ноль означает записанную сумму, а не отсутствие значения.",
"example": "1.00"
},
"lineTotal": {
"type": "string",
"pattern": "^\\d{1,10}\\.\\d{2}$",
"description": "Десятичная денежная величина `lineTotal`, сериализованная строкой в валюте поля `currency`. Ноль означает записанную сумму, а не отсутствие значения.",
"example": "1.00"
},
"policyHash": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "Непрозрачный отпечаток `policyHash` точного снимка применённых правил.",
"example": "deadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeef"
},
"structurePlanHash": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "Непрозрачный отпечаток `structurePlanHash` плана структуры позиции заказа на момент расчёта цены.",
"example": "deadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeef"
}
},
"required": [
"clientLineId",
"sortOrder",
"quantity",
"menuItemId",
"menuVariantId",
"name",
"unitPrice",
"lineTotal",
"policyHash",
"structurePlanHash"
],
"example": {
"clientLineId": "example-id",
"sortOrder": 1,
"quantity": 1,
"menuItemId": "16ee6f36-c0cb-4311-85e8-2d2b3edea0fd",
"menuVariantId": null,
"name": "Example name",
"unitPrice": "1.00",
"lineTotal": "1.00",
"policyHash": "deadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeef",
"structurePlanHash": "deadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeef"
}
},
"description": "Коллекция `lines` в составе представления.",
"example": [
{
"clientLineId": "example-id",
"sortOrder": 1,
"quantity": 1,
"menuItemId": "16ee6f36-c0cb-4311-85e8-2d2b3edea0fd",
"menuVariantId": null,
"name": "Example name",
"unitPrice": "1.00",
"lineTotal": "1.00",
"policyHash": "deadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeef",
"structurePlanHash": "deadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeef"
}
]
},
"financialPolicyVersionId": {
"type": "string",
"format": "uuid",
"description": "UUID Hallify для `financialPolicyVersionId`.",
"example": "b36de587-2415-41cd-8269-c8dc9aa8ee66"
},
"financialPolicyHash": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "Непрозрачный отпечаток `financialPolicyHash` точного снимка применённых правил.",
"example": "deadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeef"
},
"fulfillmentPolicyHash": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "Непрозрачный отпечаток `financialPolicyHash` точного снимка применённых правил.",
"example": "deadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeef"
},
"adjustmentEvidenceHash": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "Непрозрачный отпечаток `adjustmentEvidenceHash`, защищающий приложенные неизменяемые доказательства.",
"example": "deadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeef"
},
"capacityUnits": {
"type": "integer",
"minimum": 1,
"maximum": 10000,
"description": "Целочисленное значение `capacityUnits`. Ограничения: минимум 1; максимум 10000.",
"example": 1
},
"quotedSubtotal": {
"type": "string",
"pattern": "^\\d{1,10}\\.\\d{2}$",
"description": "Десятичная денежная величина `quotedSubtotal`, сериализованная строкой в валюте поля `currency`. Ноль означает записанную сумму, а не отсутствие значения.",
"example": "1.00"
},
"quotedDiscountTotal": {
"type": "string",
"pattern": "^\\d{1,10}\\.\\d{2}$",
"description": "Десятичная денежная величина `quotedDiscountTotal`, сериализованная строкой в валюте поля `currency`. Ноль означает записанную сумму, а не отсутствие значения.",
"example": "1.00"
},
"quotedServiceCharge": {
"type": "string",
"pattern": "^\\d{1,10}\\.\\d{2}$",
"description": "Десятичная денежная величина `quotedServiceCharge`, сериализованная строкой в валюте поля `currency`. Ноль означает записанную сумму, а не отсутствие значения.",
"example": "1.00"
},
"quotedTax": {
"type": "string",
"pattern": "^\\d{1,10}\\.\\d{2}$",
"description": "Десятичная денежная величина `quotedTax`, сериализованная строкой в валюте поля `currency`. Ноль означает записанную сумму, а не отсутствие значения.",
"example": "1.00"
},
"quotedDeliveryFee": {
"type": "string",
"pattern": "^\\d{1,10}\\.\\d{2}$",
"description": "Десятичная денежная величина `quotedDeliveryFee`, сериализованная строкой в валюте поля `currency`. Ноль означает записанную сумму, а не отсутствие значения.",
"example": "1.00"
},
"quotedTotal": {
"type": "string",
"pattern": "^\\d{1,10}\\.\\d{2}$",
"description": "Десятичная денежная величина `quotedTotal`, сериализованная строкой в валюте поля `currency`. Ноль означает записанную сумму, а не отсутствие значения.",
"example": "1.00"
},
"quotedNetPaid": {
"type": "string",
"pattern": "^\\d{1,10}\\.\\d{2}$",
"description": "Непрозрачный идентификатор `quotedNetPaid`; клиент не должен предполагать формат UUID.",
"example": "1.00"
},
"quotedRemaining": {
"type": "string",
"pattern": "^\\d{1,10}\\.\\d{2}$",
"description": "Рассчитанный остаток `quotedRemaining`.",
"example": "1.00"
},
"quotedRefundDue": {
"type": "string",
"pattern": "^\\d{1,10}\\.\\d{2}$",
"description": "Десятичная денежная величина `quotedRefundDue`, сериализованная строкой в валюте поля `currency`. Ноль означает записанную сумму, а не отсутствие значения.",
"example": "1.00"
},
"quotedDepositRequired": {
"type": "string",
"pattern": "^\\d{1,10}\\.\\d{2}$",
"description": "Требуемый рассчитанный депозит `quotedDepositRequired`.",
"example": "1.00"
},
"depositDueAt": {
"type": "string",
"format": "date-time",
"nullable": true,
"description": "Время `depositDueAt` в формате RFC3339; разные часовые смещения могут обозначать один абсолютный момент. Null означает отсутствие записанного значения в этом представлении.",
"example": "2026-12-31T18:00:00.000Z"
},
"cancellationCutoffAt": {
"type": "string",
"format": "date-time",
"nullable": true,
"description": "Время `cancellationCutoffAt` в формате RFC3339; разные часовые смещения могут обозначать один абсолютный момент. Null означает отсутствие записанного значения в этом представлении.",
"example": "2026-01-15T12:00:00.000Z"
},
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$",
"description": "Код валюты ISO 4217 в `currency` для денежных значений этого представления.",
"example": "GEL"
},
"issuedAt": {
"type": "string",
"format": "date-time",
"description": "Время `issuedAt` в формате RFC3339; разные часовые смещения могут обозначать один абсолютный момент.",
"example": "2026-01-15T10:00:00.000Z"
},
"expiresAt": {
"type": "string",
"format": "date-time",
"description": "Время `expiresAt` в формате RFC3339; разные часовые смещения могут обозначать один абсолютный момент.",
"example": "2026-12-31T18:00:00.000Z"
}
},
"required": [
"quoteId",
"quoteToken",
"status",
"serviceMode",
"scheduledFor",
"lines",
"financialPolicyVersionId",
"financialPolicyHash",
"fulfillmentPolicyHash",
"adjustmentEvidenceHash",
"capacityUnits",
"quotedSubtotal",
"quotedDiscountTotal",
"quotedServiceCharge",
"quotedTax",
"quotedDeliveryFee",
"quotedTotal",
"quotedNetPaid",
"quotedRemaining",
"quotedRefundDue",
"quotedDepositRequired",
"depositDueAt",
"cancellationCutoffAt",
"currency",
"issuedAt",
"expiresAt"
],
"description": "Возвращает рассчитанные цены, доступность, требования к депозиту и защищённый токен предложения с ограниченным сроком действия.",
"example": {
"quoteId": "123728f6-ac4b-43a8-8f9e-44585ec81783",
"quoteToken": "synthetic-example-credential",
"status": "ISSUED",
"serviceMode": "DINE_IN",
"scheduledFor": "2026-01-15T12:00:00.000Z",
"lines": [
{
"clientLineId": "example-id",
"sortOrder": 1,
"quantity": 1,
"menuItemId": "16ee6f36-c0cb-4311-85e8-2d2b3edea0fd",
"menuVariantId": null,
"name": "Example name",
"unitPrice": "1.00",
"lineTotal": "1.00",
"policyHash": "deadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeef",
"structurePlanHash": "deadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeef"
}
],
"financialPolicyVersionId": "b36de587-2415-41cd-8269-c8dc9aa8ee66",
"financialPolicyHash": "deadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeef",
"fulfillmentPolicyHash": "deadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeef",
"adjustmentEvidenceHash": "deadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeef",
"capacityUnits": 1,
"quotedSubtotal": "1.00",
"quotedDiscountTotal": "1.00",
"quotedServiceCharge": "1.00",
"quotedTax": "1.00",
"quotedDeliveryFee": "1.00",
"quotedTotal": "1.00",
"quotedNetPaid": "1.00",
"quotedRemaining": "1.00",
"quotedRefundDue": "1.00",
"quotedDepositRequired": "1.00",
"depositDueAt": null,
"cancellationCutoffAt": null,
"currency": "GEL",
"issuedAt": "2026-01-15T10:00:00.000Z",
"expiresAt": "2026-12-31T18:00:00.000Z"
}
}TranslatedErrorDto
Стабильная оболочка ошибки общего обработчика HTTP-исключений. Дополнительные машинные данные домена вложены в details.
statusCodeОбязательноHTTP-статус, повторённый из ответа.
integerПолное определение
{ "type": "integer", "description": "HTTP-статус, повторённый из ответа.", "example": 400 }errorОбязательноКлюч перевода HTTP-категории, например errors:http.conflict. Конкретную причину определяют code и translationKey.
stringПолное определение
{ "type": "string", "description": "Ключ перевода HTTP-категории, например errors:http.conflict. Конкретную причину определяют code и translationKey.", "example": "errors.request.invalid" }codeОбязательноСтабильный машинный код домена либо стандартный HTTP_*, если доменный код не задан. Используйте это поле и HTTP-статус для программной логики; локализованная формулировка не управляет повторами или бизнес-решениями.
stringПолное определение
{ "type": "string", "example": "HTTP_BAD_REQUEST", "description": "Стабильный машинный код домена либо стандартный HTTP_*, если доменный код не задан. Используйте это поле и HTTP-статус для программной логики; локализованная формулировка не управляет повторами или бизнес-решениями." }messageОбязательноКлюч перевода, идентичный translationKey. API не возвращает локализованный текст интерфейса. Найдите перевод ключа и подставьте translationValues в приложении-потребителе.
stringПолное определение
{ "type": "string", "example": "errors:http.badRequest", "description": "Ключ перевода, идентичный translationKey. API не возвращает локализованный текст интерфейса. Найдите перевод ключа и подставьте translationValues в приложении-потребителе." }translationKeyОбязательноКанонический ключ перевода, идентичный message. Ключи errors:http.* соответствующего статуса описывают неуточнённые ошибки. Публичные ключи и пояснения EN/RU перечислены в Developers; неизвестный ключ требует локализованного запасного сообщения в клиенте.
stringПолное определение
{ "type": "string", "example": "errors:http.badRequest", "description": "Канонический ключ перевода, идентичный message. Ключи errors:http.* соответствующего статуса описывают неуточнённые ошибки. Публичные ключи и пояснения EN/RU перечислены в Developers; неизвестный ключ требует локализованного запасного сообщения в клиенте." }translationValuesНеобязательноНеобязательные скалярные значения параметров шаблона перевода. Обрабатывайте их как данные, экранируйте при отображении и никогда не используйте как настройки переводчика.
objectПолное определение
{ "type": "object", "additionalProperties": { "oneOf": [ { "type": "string", "example": "example" }, { "type": "number", "example": 0 }, { "type": "boolean", "example": true } ], "example": "example" }, "description": "Необязательные скалярные значения параметров шаблона перевода. Обрабатывайте их как данные, экранируйте при отображении и никогда не используйте как настройки переводчика.", "example": { "exampleKey": "example" } }validationErrorsНеобязательноОшибки проверки полей с ключами переводов и стабильными кодами валидаторов. Введённые значения и исходные тексты валидаторов не включаются.
arrayПолное определение
{ "description": "Ошибки проверки полей с ключами переводов и стабильными кодами валидаторов. Введённые значения и исходные тексты валидаторов не включаются.", "type": "array", "items": { "$ref": "#/components/schemas/ValidationErrorDto" }, "example": [ { "field": "email", "translationKey": "validation:isEmail", "code": "isEmail", "message": "validation:isEmail" } ] }detailsНеобязательноНеобязательные сведения о доменных препятствиях или ошибках валидации.
oneOfПолное определение
{ "description": "Необязательные сведения о доменных препятствиях или ошибках валидации.", "oneOf": [ { "type": "array", "items": { "$ref": "#/components/schemas/JsonValue" }, "example": [ "example" ] }, { "type": "object", "additionalProperties": { "$ref": "#/components/schemas/JsonValue" }, "example": { "exampleKey": "example" } } ], "example": [ "example" ] }
Полное определение
{
"type": "object",
"properties": {
"statusCode": {
"type": "integer",
"description": "HTTP-статус, повторённый из ответа.",
"example": 400
},
"error": {
"type": "string",
"description": "Ключ перевода HTTP-категории, например errors:http.conflict. Конкретную причину определяют code и translationKey.",
"example": "errors.request.invalid"
},
"code": {
"type": "string",
"example": "HTTP_BAD_REQUEST",
"description": "Стабильный машинный код домена либо стандартный HTTP_*, если доменный код не задан. Используйте это поле и HTTP-статус для программной логики; локализованная формулировка не управляет повторами или бизнес-решениями."
},
"message": {
"type": "string",
"example": "errors:http.badRequest",
"description": "Ключ перевода, идентичный translationKey. API не возвращает локализованный текст интерфейса. Найдите перевод ключа и подставьте translationValues в приложении-потребителе."
},
"translationKey": {
"type": "string",
"example": "errors:http.badRequest",
"description": "Канонический ключ перевода, идентичный message. Ключи errors:http.* соответствующего статуса описывают неуточнённые ошибки. Публичные ключи и пояснения EN/RU перечислены в Developers; неизвестный ключ требует локализованного запасного сообщения в клиенте."
},
"translationValues": {
"type": "object",
"additionalProperties": {
"oneOf": [
{
"type": "string",
"example": "example"
},
{
"type": "number",
"example": 0
},
{
"type": "boolean",
"example": true
}
],
"example": "example"
},
"description": "Необязательные скалярные значения параметров шаблона перевода. Обрабатывайте их как данные, экранируйте при отображении и никогда не используйте как настройки переводчика.",
"example": {
"exampleKey": "example"
}
},
"validationErrors": {
"description": "Ошибки проверки полей с ключами переводов и стабильными кодами валидаторов. Введённые значения и исходные тексты валидаторов не включаются.",
"type": "array",
"items": {
"$ref": "#/components/schemas/ValidationErrorDto"
},
"example": [
{
"field": "email",
"translationKey": "validation:isEmail",
"code": "isEmail",
"message": "validation:isEmail"
}
]
},
"details": {
"description": "Необязательные сведения о доменных препятствиях или ошибках валидации.",
"oneOf": [
{
"type": "array",
"items": {
"$ref": "#/components/schemas/JsonValue"
},
"example": [
"example"
]
},
{
"type": "object",
"additionalProperties": {
"$ref": "#/components/schemas/JsonValue"
},
"example": {
"exampleKey": "example"
}
}
],
"example": [
"example"
]
}
},
"required": [
"statusCode",
"error",
"code",
"message",
"translationKey"
],
"description": "Стабильная оболочка ошибки общего обработчика HTTP-исключений. Дополнительные машинные данные домена вложены в details.",
"example": {
"statusCode": 400,
"error": "errors:http.badRequest",
"code": "HTTP_BAD_REQUEST",
"message": "errors:http.badRequest",
"translationKey": "errors:http.badRequest"
}
}ValidationErrorDto
Ошибка проверки поля с путём поля, стабильным кодом валидатора и ключом перевода. Человекочитаемый текст принадлежит приложению-потребителю.
fieldОбязательноПубличный путь поля. Вложенные свойства и индексы массива разделены точками.
stringПолное определение
{ "type": "string", "example": "email", "description": "Публичный путь поля. Вложенные свойства и индексы массива разделены точками." }translationKeyОбязательноКлюч перевода этого валидатора, идентичный message. Найдите его в клиентском словаре; см. публичный каталог ошибок Developers.
stringПолное определение
{ "type": "string", "example": "validation:isEmail", "description": "Ключ перевода этого валидатора, идентичный message. Найдите его в клиентском словаре; см. публичный каталог ошибок Developers." }codeОбязательноСтабильный идентификатор валидатора для ошибки поля. Пользовательские валидаторы могут определять дополнительные идентификаторы.
stringПолное определение
{ "type": "string", "example": "isEmail", "description": "Стабильный идентификатор валидатора для ошибки поля. Пользовательские валидаторы могут определять дополнительные идентификаторы." }messageОбязательноКлюч перевода, описывающий ошибку проверки поля, идентичный translationKey. Введённые значения и тексты валидаторов не включаются.
stringПолное определение
{ "type": "string", "example": "validation:isEmail", "description": "Ключ перевода, описывающий ошибку проверки поля, идентичный translationKey. Введённые значения и тексты валидаторов не включаются." }translationValuesНеобязательноНеобязательные скалярные значения параметров шаблона перевода. Обрабатывайте их как данные, экранируйте при отображении и никогда не используйте как настройки переводчика.
objectПолное определение
{ "type": "object", "additionalProperties": { "oneOf": [ { "type": "string", "example": "example" }, { "type": "number", "example": 0 }, { "type": "boolean", "example": true } ], "example": "example" }, "description": "Необязательные скалярные значения параметров шаблона перевода. Обрабатывайте их как данные, экранируйте при отображении и никогда не используйте как настройки переводчика.", "example": { "exampleKey": "example" } }
Полное определение
{
"type": "object",
"properties": {
"field": {
"type": "string",
"example": "email",
"description": "Публичный путь поля. Вложенные свойства и индексы массива разделены точками."
},
"translationKey": {
"type": "string",
"example": "validation:isEmail",
"description": "Ключ перевода этого валидатора, идентичный message. Найдите его в клиентском словаре; см. публичный каталог ошибок Developers."
},
"code": {
"type": "string",
"example": "isEmail",
"description": "Стабильный идентификатор валидатора для ошибки поля. Пользовательские валидаторы могут определять дополнительные идентификаторы."
},
"message": {
"type": "string",
"example": "validation:isEmail",
"description": "Ключ перевода, описывающий ошибку проверки поля, идентичный translationKey. Введённые значения и тексты валидаторов не включаются."
},
"translationValues": {
"type": "object",
"additionalProperties": {
"oneOf": [
{
"type": "string",
"example": "example"
},
{
"type": "number",
"example": 0
},
{
"type": "boolean",
"example": true
}
],
"example": "example"
},
"description": "Необязательные скалярные значения параметров шаблона перевода. Обрабатывайте их как данные, экранируйте при отображении и никогда не используйте как настройки переводчика.",
"example": {
"exampleKey": "example"
}
}
},
"required": [
"field",
"translationKey",
"code",
"message"
],
"description": "Ошибка проверки поля с путём поля, стабильным кодом валидатора и ключом перевода. Человекочитаемый текст принадлежит приложению-потребителю.",
"example": {
"field": "email",
"translationKey": "validation:isEmail",
"code": "isEmail",
"message": "validation:isEmail"
}
}JsonValue
Рекурсивно допустимое JSON-значение. Используется только там, где контракт явно разрешает произвольные структурированные данные.
Полное определение
{
"oneOf": [
{
"type": "string",
"nullable": true,
"example": "example"
},
{
"type": "number",
"example": 0
},
{
"type": "boolean",
"example": true
},
{
"type": "array",
"items": {
"$ref": "#/components/schemas/JsonValue"
},
"example": [
"example"
]
},
{
"type": "object",
"additionalProperties": {
"$ref": "#/components/schemas/JsonValue"
},
"example": {
"exampleKey": "example"
}
}
],
"description": "Рекурсивно допустимое JSON-значение. Используется только там, где контракт явно разрешает произвольные структурированные данные.",
"example": "example"
}IdempotencyConflictError
Ключ идемпотентности уже обрабатывается или использован повторно с другим телом.
Полное определение
{
"example": {
"statusCode": 409,
"error": "errors:http.conflict",
"code": "IDEMPOTENCY_REQUEST_IN_PROGRESS",
"message": "errors:idempotency.inProgress",
"translationKey": "errors:idempotency.inProgress"
},
"allOf": [
{
"$ref": "#/components/schemas/TranslatedErrorDto"
},
{
"type": "object",
"required": [
"code"
],
"properties": {
"statusCode": {
"type": "integer",
"enum": [
409
],
"description": "Статус конфликта HTTP 409.",
"example": 409
},
"code": {
"type": "string",
"enum": [
"IDEMPOTENCY_REQUEST_NOT_READY",
"IDEMPOTENCY_KEY_PAYLOAD_MISMATCH",
"IDEMPOTENCY_REQUEST_IN_PROGRESS",
"IDEMPOTENCY_SCOPE_INCOMPLETE"
],
"description": "Допустимые значения `code`: IDEMPOTENCY_REQUEST_NOT_READY, IDEMPOTENCY_KEY_PAYLOAD_MISMATCH, IDEMPOTENCY_REQUEST_IN_PROGRESS, IDEMPOTENCY_SCOPE_INCOMPLETE.",
"example": "IDEMPOTENCY_REQUEST_NOT_READY"
}
},
"example": {
"code": "IDEMPOTENCY_REQUEST_NOT_READY"
}
}
],
"description": "Ключ идемпотентности уже обрабатывается или использован повторно с другим телом."
}