Zenky Storefront API (v1)

Поддержка API: tech@zenky.io URL: https://openapi.zenky.io/sf1/ License: MIT

Последнее обновление: Tue, 16 Jun 2026 14:21:09 GMT

Начало работы

Storefront API – это новый, легковесный API от Zenky.io, который идеально подходит для разработки клиентских приложений (веб-сайтов, мобильных приложений и т.д.), которым не требуется полноценный API с большим количеством данных. С помощью Storefront API вы можете получить доступ к каталогу магазина, профилю покупателя (включая регистрацию, вход в аккаунт и восстановление пароля), контентным ресурсам (статьи, категории статей, акции) и, конечно, к полноценному процессу оформления заказов.

Разумеется, вы можете по-прежнему использовать полную версию API для разработки клиентский приложений, однако, мы рекомендуем внедрять Storefront API для разработки новых приложений, так как он более простой и удобный в использовании.

Выполнение запросов

Базовый адрес для выполнения запросов к API - https://storefront.zenky.io/v1. Формат возвращаемых данных - JSON.

HTTP-методы

Каждый метод API может поддерживать один или несколько из перечисленных HTTP-методов:

GET для чтения информации;
POST для создания нового объекта или для выполнения команд (таких как отправка заказа);
PUT для изменения существующего объекта;
DELETE для удаления существующего объекта.

Заголовки

Все запросы к API должны выполняться с заголовком Accept: application/json. В некоторых случаях, если заголовок Accept не был передан или его значением не является строка application/json, вы можете получить в ответ HTML-код или перенаправление на внутренние страницы панели управления магазином.

ID магазина

Все запросы к Storefront API требуют передачи обязательного параметра {store} в пути запроса. Значением этого параметра должен быть идентификатор магазина, с которым в данный момент выполняется работа.

Пример полного URL: https://storefront.zenky.io/v1/store/8b53353d-3f62-45f0-a7e6-b7a993ea7f68.

Если мы будем добавлять новые методы Storefront API, которые могут быть вызваны вне контекста магазина, это будет отражено в документации к таким методам. На данный момент все методы относятся только к магазинам.

Ответы API

Любой успешный ответ обязательно содержит в себе корневое поле data, в котором, в зависимости от запроса, располагается тело ответа.

Если был выполнен запрос на получение списка объектов, то в поле data будет находиться массив объектов. Если же был выполнен запрос на получение одного объекта, то в поля data будет находиться объект.

Кроме того, на одном уровне с полем data может присутствовать поле meta - в основном оно используется для передачи информации о количестве страниц списка объектов.

Включения ответов

Кроме основной информации об объекте методы могут отдавать расширенную информацию о вложенных сущностях (т.н. включения ответов или includes). У каждого метода, который поддерживает такие включения, имеется свой список возможных включений, которые необходимо передавать с помощью параметра with. Если требуется вернуть несколько включений, их необходимо разделять запятыми.

Включения, которые поддерживаются конкретным методом, перечислены в его описании. Кроме этого, в описании структуры объектов также указаны названия включений тех или иных полей.

Обработка ошибок

Запросы, выполнение которых завершилось с ошибкой, содержат в себе поле error, в котором дано подробное описание произошедшей ошибки. В случае, если вы не можете исправить ошибку самостоятельно или не знаете что именно пошло не так, всегда предоставляйте полное тело ответа при обращении в техподдержку.

Возможные коды ошибок и способы их решения перечислены в описании методов.

Если вы столкнулись с неизвестной ошибкой, пожалуйста, создайте новый issue в нашем репозитории на GitHub. Обратите внимание, что этот репозиторий является публичным и любой пользователь может просматривать ваши обращения. Не публикуйте ваши API-токены и другую конфиденциальную информацию, особенно относящуюся к покупателям.

В случае, если ваш запрос содержит конфиденциальную информацию, вместо создания issue вы можете написать нам на почту tech@zenky.io с подробным описанием проблемы, приложив полное тело запроса, включая URL и ID магазина. Так же при обращении на почту вы можете указать API-токен, который использовался для выполнения запроса, в этом случае мы не будем его инвалидировать, если только это не потребуется для решения проблемы.

Магазин

Получить профиль магазина

Этот метод поддерживает следующие включения:

Включение	Описание
`website`	Сайт магазина
`mobile_app`	Моб. приложение магазина

path Parameters

store

required

string

ID магазина

query Parameters

website_id

string

ID вебсайта, для которого нужно вернуть настройки

Responses

Response samples

Content type

application/json

{"data": {"id": "9275c4be-3ec7-4ed3-8c9c-5ac2c8404987",
"name": "Мой магазин",
"domain": "example.org",
"app_store_url": "https://apps.apple.com/ru/app/-/id1234557890",
"google_play_url": "https://play.google.com/store/apps/details?id=io.zenky.cashier&hl=ru_RU",
"logo": {"placeholder": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"medium": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"large": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"xlarge": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"hd": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
}
},
"square_logo": {"placeholder": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"medium": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"large": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"xlarge": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"hd": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
}
},
"links": [{"type": "twitter",
"value": "https://instagram.com/zenky.io"
}
],
"phones": [{"country": "RU",
"number": "+79641234567",
"national": "+7 (964) 123-45-67"
}
],
"cities": [{"id": "9275c4be-44de-49d8-a308-d1322a8efa08",
"is_default": true,
"name": "Улан-Удэ",
"timezone": "Asia/Irkutsk",
"coordinates": {"latitude": 51.8121373,
"longitude": 107.6641822
},
"schedule": {"is_open_now": false,
"opening_at": "2023-06-20T10:00:00+08:00:00",
"closing_at": "2023-06-20T20:00:00+08:00:00",
"day_id": "friday",
"days": {"monday": {"hours": "10:00-19:00"
},
"tuesday": {"hours": "10:00-19:00"
},
"wednesday": {"hours": "10:00-19:00"
},
"thursday": {"hours": "10:00-19:00"
},
"friday": {"hours": "10:00-19:00"
},
"saturday": {"hours": "10:00-19:00"
},
"sunday": {"hours": "10:00-19:00"
}
}
},
"stocks": [{"id": "9655d648-9ed3-4fee-94fa-4a7bc807e5c7",
"name": "ТРК «Еврозона»",
"description": null,
"address": "г Улан-Удэ, ул Балтахинова, д 13",
"coordinates": {"latitude": 51.8121373,
"longitude": 107.6641822
},
"links": [{"type": "twitter",
"value": "https://instagram.com/zenky.io"
}
],
"phones": [{"country": "RU",
"number": "+79641234567",
"national": "+7 (964) 123-45-67"
}
],
"schedule": {"is_open_now": false,
"opening_at": "2023-06-20T10:00:00+08:00:00",
"closing_at": "2023-06-20T20:00:00+08:00:00",
"day_id": "friday",
"days": {"monday": {"hours": "10:00-19:00"
},
"tuesday": {"hours": "10:00-19:00"
},
"wednesday": {"hours": "10:00-19:00"
},
"thursday": {"hours": "10:00-19:00"
},
"friday": {"hours": "10:00-19:00"
},
"saturday": {"hours": "10:00-19:00"
},
"sunday": {"hours": "10:00-19:00"
}
}
}
}
],
"delivery_zones": [{"id": "96ad06d6-4c2b-4671-9f03-77e0544bbf14",
"name": "Первая зона",
"coordinates": [{"latitude": 51.86046585577859,
"longitude": 107.51617115746944
},
{"latitude": 51.869045905165855,
"longitude": 107.64526460749036
},
{"latitude": 51.81444475690688,
"longitude": 107.66697977167492
},
{"latitude": 51.80646099581586,
"longitude": 107.59888650849196
},
{"latitude": 51.80869899574977,
"longitude": 107.52450082880388
},
{"latitude": 51.86046585577859,
"longitude": 107.51617115746944
}
],
"description": "Первая зона доставки",
"color": "#ee44d7",
"min_price": 100000,
"free_delivery_price": 20000000,
"delivery_price": 2000000,
"delivery_time": "1 час"
}
]
}
],
"settings": {"country": "RU",
"currency": "RUB",
"appearance": {"primary_color": "#33CC99"
},
"legal": {"documents": {"available": ["privacy_policy",
"personal_data"
]
}
},
"orders": {"authentication_method": "disabled",
"use_early_delivery": true,
"addresses_provider": "dadata",
"repeats": {"enabled": true
},
"checkout_ui": {"enabled": true,
"message": "Уважаемые покупатели! Обратите внимание, что в связи с высокой нагрузкой время обработки заказов может увеличиться. Спасибо за понимание!",
"closed_message": "Сейчас мы не работаем, но вы можете оформить предзаказ на завтра.",
"legal": {"accept_label": "Принимаю условия политики конфиденциальности"
}
}
},
"products": {"use_stock_filter": false,
"search": {"enabled": true
}
},
"loyalty": {"enabled": true
},
"recaptcha": null,
"websockets": {"app_id": "95ef1441-4bf6-40e7-9d24-6c9ca32b03c1",
"app_key": "OpHi2HcEEtGFjx33Zi9IDCvhjVw6BvWI",
"options": {"host": "wss.zenky.io",
"port": 443
}
}
},
"website": {"id": "a1c58d94-e7b8-4512-9738-94b799396b34",
"internal_domain": "demo.on-zenky.ru",
"external_domain": null,
"settings": {"logos": {"header": "https://cdn.assets.zenky.io/uploads/98ad8301-6559-4146-b8f3-0385c71d7e76/conversions/zenky-logo-1024x1024-medium_webp.webp"
},
"home": {"offers": {"autoplay": true
}
}
},
"snippets": [{"region": "head_start",
"snippets": [{"language": "html",
"content": "<meta name=\"example\" content=\"hello world\">"
}
]
}
],
"pages": [{"id": "a1cab8eb-4d84-47c7-8114-4eb92bc3b7b1",
"type": "about_us",
"path": null
}
],
"integrations": [{"id": "a1e32200-8d2d-427d-88e9-d8760938302e",
"installation_id": "a1e33656-f13c-434d-a1b4-25e0a72454a6",
"files": [{"language": "js",
"url": "https://example.org/uploads/integrations/a1e32200-8d2d-427d-88e9-d8760938302e/web-assets/2026-05-28T19:28:26Z-orpvvu/demo.js",
"integrity": "sha384-6IBUgVpLuZ+46F+hoPBLdgXnn8YO4lSRziTVdOMBvKibHfPMO/UnbMDM0HPnIXCf"
}
],
"settings": {"counter": {"counter_id": "1234554321",
"webvisor_enabled": true
}
}
}
]
},
"mobile_app": {"id": "978759e1-2e86-45c1-af1a-936f97b4a65d",
"settings": {"general": {"info": {"logo": "https://cdn.assets.zenky.io/uploads/98ad8301-6559-4146-b8f3-0385c71d7e76/conversions/zenky-logo-1024x1024-medium_webp.webp",
"name": "Zenky Store"
}
},
"widgets": {"links_widget": {"title": "Ссылки"
}
}
}
}
}
}

Получить профиль магазина по App Bundle ID

Этот метод поддерживает следующие включения:

Включение	Описание
`website`	Сайт магазина
`mobile_app`	Моб. приложение магазина

path Parameters

appBundleId

required

string

App Bundle ID

Responses

Response samples

Content type

application/json

{"data": {"id": "9275c4be-3ec7-4ed3-8c9c-5ac2c8404987",
"name": "Мой магазин",
"domain": "example.org",
"app_store_url": "https://apps.apple.com/ru/app/-/id1234557890",
"google_play_url": "https://play.google.com/store/apps/details?id=io.zenky.cashier&hl=ru_RU",
"logo": {"placeholder": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"medium": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"large": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"xlarge": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"hd": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
}
},
"square_logo": {"placeholder": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"medium": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"large": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"xlarge": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"hd": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
}
},
"links": [{"type": "twitter",
"value": "https://instagram.com/zenky.io"
}
],
"phones": [{"country": "RU",
"number": "+79641234567",
"national": "+7 (964) 123-45-67"
}
],
"cities": [{"id": "9275c4be-44de-49d8-a308-d1322a8efa08",
"is_default": true,
"name": "Улан-Удэ",
"timezone": "Asia/Irkutsk",
"coordinates": {"latitude": 51.8121373,
"longitude": 107.6641822
},
"schedule": {"is_open_now": false,
"opening_at": "2023-06-20T10:00:00+08:00:00",
"closing_at": "2023-06-20T20:00:00+08:00:00",
"day_id": "friday",
"days": {"monday": {"hours": "10:00-19:00"
},
"tuesday": {"hours": "10:00-19:00"
},
"wednesday": {"hours": "10:00-19:00"
},
"thursday": {"hours": "10:00-19:00"
},
"friday": {"hours": "10:00-19:00"
},
"saturday": {"hours": "10:00-19:00"
},
"sunday": {"hours": "10:00-19:00"
}
}
},
"stocks": [{"id": "9655d648-9ed3-4fee-94fa-4a7bc807e5c7",
"name": "ТРК «Еврозона»",
"description": null,
"address": "г Улан-Удэ, ул Балтахинова, д 13",
"coordinates": {"latitude": 51.8121373,
"longitude": 107.6641822
},
"links": [{"type": "twitter",
"value": "https://instagram.com/zenky.io"
}
],
"phones": [{"country": "RU",
"number": "+79641234567",
"national": "+7 (964) 123-45-67"
}
],
"schedule": {"is_open_now": false,
"opening_at": "2023-06-20T10:00:00+08:00:00",
"closing_at": "2023-06-20T20:00:00+08:00:00",
"day_id": "friday",
"days": {"monday": {"hours": "10:00-19:00"
},
"tuesday": {"hours": "10:00-19:00"
},
"wednesday": {"hours": "10:00-19:00"
},
"thursday": {"hours": "10:00-19:00"
},
"friday": {"hours": "10:00-19:00"
},
"saturday": {"hours": "10:00-19:00"
},
"sunday": {"hours": "10:00-19:00"
}
}
}
}
],
"delivery_zones": [{"id": "96ad06d6-4c2b-4671-9f03-77e0544bbf14",
"name": "Первая зона",
"coordinates": [{"latitude": 51.86046585577859,
"longitude": 107.51617115746944
},
{"latitude": 51.869045905165855,
"longitude": 107.64526460749036
},
{"latitude": 51.81444475690688,
"longitude": 107.66697977167492
},
{"latitude": 51.80646099581586,
"longitude": 107.59888650849196
},
{"latitude": 51.80869899574977,
"longitude": 107.52450082880388
},
{"latitude": 51.86046585577859,
"longitude": 107.51617115746944
}
],
"description": "Первая зона доставки",
"color": "#ee44d7",
"min_price": 100000,
"free_delivery_price": 20000000,
"delivery_price": 2000000,
"delivery_time": "1 час"
}
]
}
],
"settings": {"country": "RU",
"currency": "RUB",
"appearance": {"primary_color": "#33CC99"
},
"legal": {"documents": {"available": ["privacy_policy",
"personal_data"
]
}
},
"orders": {"authentication_method": "disabled",
"use_early_delivery": true,
"addresses_provider": "dadata",
"repeats": {"enabled": true
},
"checkout_ui": {"enabled": true,
"message": "Уважаемые покупатели! Обратите внимание, что в связи с высокой нагрузкой время обработки заказов может увеличиться. Спасибо за понимание!",
"closed_message": "Сейчас мы не работаем, но вы можете оформить предзаказ на завтра.",
"legal": {"accept_label": "Принимаю условия политики конфиденциальности"
}
}
},
"products": {"use_stock_filter": false,
"search": {"enabled": true
}
},
"loyalty": {"enabled": true
},
"recaptcha": null,
"websockets": {"app_id": "95ef1441-4bf6-40e7-9d24-6c9ca32b03c1",
"app_key": "OpHi2HcEEtGFjx33Zi9IDCvhjVw6BvWI",
"options": {"host": "wss.zenky.io",
"port": 443
}
}
},
"website": {"id": "a1c58d94-e7b8-4512-9738-94b799396b34",
"internal_domain": "demo.on-zenky.ru",
"external_domain": null,
"settings": {"logos": {"header": "https://cdn.assets.zenky.io/uploads/98ad8301-6559-4146-b8f3-0385c71d7e76/conversions/zenky-logo-1024x1024-medium_webp.webp"
},
"home": {"offers": {"autoplay": true
}
}
},
"snippets": [{"region": "head_start",
"snippets": [{"language": "html",
"content": "<meta name=\"example\" content=\"hello world\">"
}
]
}
],
"pages": [{"id": "a1cab8eb-4d84-47c7-8114-4eb92bc3b7b1",
"type": "about_us",
"path": null
}
],
"integrations": [{"id": "a1e32200-8d2d-427d-88e9-d8760938302e",
"installation_id": "a1e33656-f13c-434d-a1b4-25e0a72454a6",
"files": [{"language": "js",
"url": "https://example.org/uploads/integrations/a1e32200-8d2d-427d-88e9-d8760938302e/web-assets/2026-05-28T19:28:26Z-orpvvu/demo.js",
"integrity": "sha384-6IBUgVpLuZ+46F+hoPBLdgXnn8YO4lSRziTVdOMBvKibHfPMO/UnbMDM0HPnIXCf"
}
],
"settings": {"counter": {"counter_id": "1234554321",
"webvisor_enabled": true
}
}
}
]
},
"mobile_app": {"id": "978759e1-2e86-45c1-af1a-936f97b4a65d",
"settings": {"general": {"info": {"logo": "https://cdn.assets.zenky.io/uploads/98ad8301-6559-4146-b8f3-0385c71d7e76/conversions/zenky-logo-1024x1024-medium_webp.webp",
"name": "Zenky Store"
}
},
"widgets": {"links_widget": {"title": "Ссылки"
}
}
}
}
}
}

Правовые документы

Получить реквизиты магазина

Responses

Response samples

Content type

application/json

{"data": {"name": "ООО «Рога и копыта»",
"legal_address": "г. Москва, ул Ленина, д 1",
"postal_address": "г. Москва, ул Ленина, д 1",
"fields": [{"field": "email",
"value": "info@example.org"
},
{"field": "ceo",
"value": "Иванов Иван Иванович"
},
{"field": "ceo_genitive",
"value": "Иванова Ивана Ивановича"
},
{"field": "ks",
"value": "11111111111111111111"
},
{"field": "rs",
"value": "1111 1111 1111 1111 1111"
},
{"field": "bic",
"value": "044525974"
},
{"field": "inn",
"value": "000011122233"
},
{"field": "bank",
"value": "АО \"ТБанк\""
},
{"field": "ogrn",
"value": "222222222222222"
}
]
}
}

Получить политику конфиденциальности

Этот метод возвращает текст документа с типом privacy_policy.

Responses

Response samples

Content type

application/json

{"data": {"content": "string"
}
}

Получить политику обработки персональных данных

Этот метод возвращает текст документа с типом personal_data.

Responses

Response samples

Content type

application/json

{"data": {"content": "string"
}
}

Получить пользовательское соглашение

Этот метод возвращает текст документа с типом eula.

Responses

Response samples

Content type

application/json

{"data": {"content": "string"
}
}

Получить публичную оферту

Этот метод возвращает текст документа с типом terms.

Responses

Response samples

Content type

application/json

{"data": {"content": "string"
}
}

Получить согласие на обработку перс. данных

Этот метод возвращает текст документа с типом personal_data_agreement.

Responses

Response samples

Content type

application/json

{"data": {"content": "string"
}
}

Получить правила лояльности

Этот метод возвращает текст документа с типом loyalty_rules.

Responses

Response samples

Content type

application/json

{"data": {"content": "string"
}
}

Сайты

Получить информацию о странице сайта

path Parameters

store required	string ID магазина
website required	string ID сайта
page required	string ID страницы

Responses

Response samples

Content type

application/json

{"data": {"id": "a1cab8eb-4d84-47c7-8114-4eb92bc3b7b1",
"type": "about_us",
"path": null,
"seo": {"title": "Смартфоны: цены, большой каталог, новинки",
"description": "Большой ассортимент электроники, цифровой и бытовой техники, а так же товаров для дома.",
"meta": [{"name": {"attribute": "name",
"value": "description"
},
"value": {"attribute": "content",
"value": "Большой ассортимент электроники, цифровой и бытовой техники, а так же товаров для дома."
}
},
{"name": {"attribute": "name",
"value": "og:image"
},
"value": {"attribute": "content",
"value": "https://assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg"
}
},
{"name": {"attribute": "name",
"value": "name"
},
"value": {"attribute": "content",
"value": "width=device-width, initial-scale=1"
},
"additional": [{"attribute": "id",
"value": "viewport"
}
]
}
]
},
"content": "<h2>Кто мы</h2>\n<p>Мы — команда энтузиастов, которые верят в то, что каждая деталь имеет значение. Наш магазин начался как небольшая идея, и сегодня мы обслуживаем сотни клиентов каждый день.</p>\n<h2>Наши принципы</h2>\n<ul>\n        <li>Качество&nbsp;— мы выбираем только проверенных поставщиков</li>\n        <li>Скорость&nbsp;— доставляем в день заказа</li>\n        <li>Честность&nbsp;— никаких скрытых условий и звёздочек</li>\n    </ul>\n<h2>Свяжитесь с нами</h2>\n<p>Если у вас есть вопросы, пожелания или идеи — напишите нам. Мы всегда рады обратной связи.</p>\n",
"cover": {"placeholder": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"medium": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"large": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"xlarge": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"hd": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
}
}
}
}

Получить дерево категорий

Этот метод поддерживает следующие включения:

Включение	Описание
`cover`	Обложка категории
`seo`	SEO

path Parameters

store

required

string

ID магазина

query Parameters

with	string Список включений

Responses

Response samples

Content type

application/json

{"data": [{"id": "961172f7-ac30-43d5-9687-6ab70c13790b",
"short_id": "961172f7ac303790",
"parent_id": "998f217c-5470-477c-870c-b3c768afecf0",
"is_featured": false,
"slug": "smartfony",
"name": "Смартфоны",
"description": null,
"children": [{ }
],
"cover": {"placeholder": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"medium": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"large": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"xlarge": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"hd": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
}
},
"seo": {"title": "Смартфоны: цены, большой каталог, новинки",
"description": "Большой ассортимент электроники, цифровой и бытовой техники, а так же товаров для дома.",
"meta": [{"name": {"attribute": "name",
"value": "description"
},
"value": {"attribute": "content",
"value": "Большой ассортимент электроники, цифровой и бытовой техники, а так же товаров для дома."
}
},
{"name": {"attribute": "name",
"value": "og:image"
},
"value": {"attribute": "content",
"value": "https://assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg"
}
},
{"name": {"attribute": "name",
"value": "name"
},
"value": {"attribute": "content",
"value": "width=device-width, initial-scale=1"
},
"additional": [{"attribute": "id",
"value": "viewport"
}
]
}
]
}
}
]
}

Получить список категорий

Этот метод поддерживает следующие включения:

Включение	Описание
`cover`	Обложка категории
`seo`	SEO

Этот метод поддерживает следующие поля сортировки (передаются в параметре order_by):

Поле	Описание
`name`	По названию (asc)
`-name`	По названию (desc)

path Parameters

store

required

string

ID магазина

query Parameters

with	string Список включений
count	integer Количество записей
page	integer Номер страницы
search	string Строка поиска
order_by	string Поле сортировки
featured	boolean Вернуть только избранные категории

Responses

Response samples

Content type

application/json

{"data": [{"id": "961172f7-ac30-43d5-9687-6ab70c13790b",
"short_id": "961172f7ac303790",
"parent_id": "998f217c-5470-477c-870c-b3c768afecf0",
"is_featured": false,
"slug": "smartfony",
"name": "Смартфоны",
"description": null,
"cover": {"placeholder": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"medium": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"large": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"xlarge": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"hd": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
}
},
"seo": {"title": "Смартфоны: цены, большой каталог, новинки",
"description": "Большой ассортимент электроники, цифровой и бытовой техники, а так же товаров для дома.",
"meta": [{"name": {"attribute": "name",
"value": "description"
},
"value": {"attribute": "content",
"value": "Большой ассортимент электроники, цифровой и бытовой техники, а так же товаров для дома."
}
},
{"name": {"attribute": "name",
"value": "og:image"
},
"value": {"attribute": "content",
"value": "https://assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg"
}
},
{"name": {"attribute": "name",
"value": "name"
},
"value": {"attribute": "content",
"value": "width=device-width, initial-scale=1"
},
"additional": [{"attribute": "id",
"value": "viewport"
}
]
}
]
}
}
]
}

Получить категорию

Этот метод поддерживает следующие включения:

Включение	Описание
`cover`	Обложка категории
`seo`	SEO

path Parameters

store required	string ID магазина
category required	string ID категории

query Parameters

with	string Список включений

Responses

Response samples

Content type

application/json

{"data": {"id": "961172f7-ac30-43d5-9687-6ab70c13790b",
"short_id": "961172f7ac303790",
"parent_id": "998f217c-5470-477c-870c-b3c768afecf0",
"is_featured": false,
"slug": "smartfony",
"name": "Смартфоны",
"description": null,
"cover": {"placeholder": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"medium": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"large": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"xlarge": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"hd": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
}
},
"seo": {"title": "Смартфоны: цены, большой каталог, новинки",
"description": "Большой ассортимент электроники, цифровой и бытовой техники, а так же товаров для дома.",
"meta": [{"name": {"attribute": "name",
"value": "description"
},
"value": {"attribute": "content",
"value": "Большой ассортимент электроники, цифровой и бытовой техники, а так же товаров для дома."
}
},
{"name": {"attribute": "name",
"value": "og:image"
},
"value": {"attribute": "content",
"value": "https://assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg"
}
},
{"name": {"attribute": "name",
"value": "name"
},
"value": {"attribute": "content",
"value": "width=device-width, initial-scale=1"
},
"additional": [{"attribute": "id",
"value": "viewport"
}
]
}
]
}
}
}

Получить список групп характеристик для категории

Возвращет список групп характеристик, доступных для использования в указанной категории и её подкатегориях. Список возвращается с характеристиками (вложенными в группу) и значениями (вложенными в характеристики).

path Parameters

store required	string ID магазина
category required	string ID категории

Responses

Response samples

Content type

application/json

{"data": [{"id": "96546cb3-ec0f-454e-83f8-711cc815c27c",
"name": "Внешний вид",
"description": "Внешний вид устройств.",
"features": [{"id": "92766ffd-f182-48ca-a4ae-6e4ccc3a243e",
"alias": "a243",
"name": "Размер дисплея",
"filterable": true,
"type": "range",
"range": "float",
"values": [{"id": "92766ffd-f182-48ca-a4ae-6e4ccc3a243e",
"alias": "a243",
"name": "Размер дисплея",
"range": "float"
}
]
}
]
}
]
}

Получить список характеристик для категории

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

path Parameters

store required	string ID магазина
category required	string ID категории

Responses

Response samples

Content type

application/json

{"data": [{"id": "92766ffd-f182-48ca-a4ae-6e4ccc3a243e",
"alias": "a243",
"name": "Размер дисплея",
"filterable": true,
"type": "range",
"range": "float",
"values": [{"id": "92766ffd-f182-48ca-a4ae-6e4ccc3a243e",
"alias": "a243",
"name": "Размер дисплея",
"range": "float"
}
]
}
]
}

Коллекции товаров

Получить список коллекций

Этот метод поддерживает следующие поля сортировки (передаются в параметре order_by):

Поле	Описание
`name`	По названию (asc)
`-name`	По названию (desc)
`sorting`	По заданной сортировке (asc)
`-sorting`	По заданной сортировке (desc)

path Parameters

store

required

string

ID магазина

query Parameters

count	integer Количество записей
page	integer Номер страницы
search	string Строка поиска
order_by	string Поле сортировки
app_visibility	string Enum: "visible" "hidden" Фильтр коллекций для моб. приложений. Если `visible`, коллекции приложений будут возвращены. Если не передано или `hidden` – не будут возвращены.

Responses

Response samples

Content type

application/json

{"data": [{"id": "966e602c-bf62-4583-a4b3-ccd321ebfe94",
"name": "Аксессуары",
"description": "В комплекте нет зарядника? Легко исправить!",
"cover": {"placeholder": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"medium": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"large": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"xlarge": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"hd": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
}
}
}
]
}

Получить коллекцию

path Parameters

store required	string ID магазина
collection required	string ID коллекции

Responses

Response samples

Content type

application/json

{"data": {"id": "966e602c-bf62-4583-a4b3-ccd321ebfe94",
"name": "Аксессуары",
"description": "В комплекте нет зарядника? Легко исправить!",
"cover": {"placeholder": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"medium": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"large": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"xlarge": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"hd": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
}
}
}
}

Товары

Получить список товаров

Изображения включены по умолчанию.

Этот метод поддерживает следующие включения:

Включение	Описание
`categories`	Категории
`categories.cover`	Категории и обложки
`categories.seo`	Категории и SEO
`features`	Характеристики
`features_groups`	Группы характеристик
`modifiers`	Модификаторы
`modifiers_groups`	Группы модификаторов
`custom_fields`	Пользовательские поля
`variants`	Варианты товара
`variants.prices`	Варианты и цены
`variants.dimensions`	Варианты и габариты
`variants.remainders`	Варианты и остатки
`variants.options`	Варианты, опции вариантов и их значения
`variants.custom_fields`	Варианты и пользовательские поля
`seo`	SEO

Этот метод поддерживает следующие поля сортировки (передаются в параметре order_by):

Поле	Описание
`name`	По названию (asc)
`-name`	По названию (desc)
`price`	По цене (asc)
`-price`	По цене (desc)
`manual`	По заданной сортировке (asc)
`-manual`	По заданной сортировке (desc)

path Parameters

store

required

string

ID магазина

query Parameters

with	string Список включений
count	integer Количество записей
page	integer Номер страницы
search	string Строка поиска
order_by	string Поле сортировки
category_id	string ID категории
features	Array of strings ID значений характеристик (ключи - ID характеристик)
f	Array of strings Алиасы значений характеристик (ключи – алиасы характеристик). Несколько значений можно разделять запятой.
city_id	string ID города (несовместим с `stock_id`)
stock_id	string ID склада (несовместим с `city_id`)
collection_id	string ID коллекции товаров
group_id	string ID группы товаров
	number or string Минимальная цена
	number or string Максимальная цена
featured_categories	boolean Товары из избранных категорий
promotion_reward	string Default: "no" Enum: "yes" "no" "all" Товары-подарки за акции
context_type	string Enum: "category" "group" "variant_option" "variant_option_value" Тип контекста товаров (используется вместе с `context_id`)
context_id	string ID контекста товаров (используется вместе с `context_type`)

Responses

Response samples

Content type

application/json

{"data": [{"id": "92766ffe-2d0e-4f67-87fe-35312f545b30",
"short_id": "92766ffe2d0e45b3",
"slug": "iphone-12-pro",
"name": "iPhone 12 Pro",
"description": "A14 Bionic, самый быстрый процессор iPhone. Дисплей OLED от края до края. Передняя панель Ceramic Shield, которая в четыре раза снижает риск повреждений дисплея при падении. И Ночной режим на всех камерах. Всё это есть в iPhone 12. В двух размерах.",
"unit_type": "piece",
"weight": 187,
"nutrition_facts": {"calories": 100,
"proteins": 2.5,
"fats": 3.5,
"carbohydrates": 13
},
"quantity_step": 0.4,
"is_promotion_reward": false,
"categories": [{"id": "961172f7-ac30-43d5-9687-6ab70c13790b",
"short_id": "961172f7ac303790",
"parent_id": "998f217c-5470-477c-870c-b3c768afecf0",
"is_featured": false,
"slug": "smartfony",
"name": "Смартфоны",
"description": null,
"cover": {"placeholder": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"medium": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"large": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"xlarge": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"hd": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
}
},
"seo": {"title": "Смартфоны: цены, большой каталог, новинки",
"description": "Большой ассортимент электроники, цифровой и бытовой техники, а так же товаров для дома.",
"meta": [{"name": {"attribute": "name",
"value": "description"
},
"value": {"attribute": "content",
"value": "Большой ассортимент электроники, цифровой и бытовой техники, а так же товаров для дома."
}
},
{"name": {"attribute": "name",
"value": "og:image"
},
"value": {"attribute": "content",
"value": "https://assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg"
}
},
{"name": {"attribute": "name",
"value": "name"
},
"value": {"attribute": "content",
"value": "width=device-width, initial-scale=1"
},
"additional": [{"attribute": "id",
"value": "viewport"
}
]
}
]
}
}
],
"images": [{"placeholder": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"medium": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"large": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"xlarge": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"hd": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
}
}
],
"custom_fields": [{"id": "brand",
"name": "Производитель",
"type": "text",
"value": "Apple, Inc."
}
],
"variants": [{"id": "92766ffe-4265-4836-a8b4-92f64b090d97",
"sku": "IPHONE12-25",
"barcode": "IPHONE12-25",
"name": "iPhone 12 Pro Белый 128 ГБ",
"nutrition_facts": {"calories": 100,
"proteins": 2.5,
"fats": 3.5,
"carbohydrates": 13
},
"price": 0,
"original_price": 9999000,
"discount": {"difference": 1999800,
"percentage": 20
},
"default_modifiers": { },
"prices": [{"stock_id": null,
"price": 0,
"original_price": 9999000,
"discount": {"difference": 1999800,
"percentage": 20
}
}
],
"dimensions": [{"dimension": "weight",
"type": "netto",
"value": 187
}
],
"custom_fields": [{"id": "brand",
"name": "Производитель",
"type": "text",
"value": "Apple, Inc."
}
],
"remainders": [{"stock_id": "92766ffd-fdf7-44b0-bd51-0755d0aa027c",
"quantity": 10,
"label": "Мало"
}
],
"options": [{"id": "95e15ded-7fd0-4d30-900e-32f8cf0e4549",
"name": "Цвет",
"type": "color",
"value": {"id": "95e15ded-81eb-4d36-90d2-4de607140840",
"name": "Золотой",
"color": "#F9E5C9"
}
}
]
}
],
"features": [{"id": "92766ffd-f182-48ca-a4ae-6e4ccc3a243e",
"alias": "a243",
"name": "Размер дисплея",
"filterable": true,
"type": "range",
"range": "float",
"values": [{"id": "92766ffd-f182-48ca-a4ae-6e4ccc3a243e",
"alias": "a243",
"name": "Размер дисплея",
"range": "float"
}
]
}
],
"features_groups": [{"id": "96546cb3-ec0f-454e-83f8-711cc815c27c",
"name": "Внешний вид",
"description": "Внешний вид устройств.",
"features": [{"id": "92766ffd-f182-48ca-a4ae-6e4ccc3a243e",
"alias": "a243",
"name": "Размер дисплея",
"filterable": true,
"type": "range",
"range": "float",
"values": [{"id": "92766ffd-f182-48ca-a4ae-6e4ccc3a243e",
"alias": "a243",
"name": "Размер дисплея",
"range": "float"
}
]
}
]
}
],
"modifiers": [{"modifier": {"id": "92861b69-93c4-4c4e-991c-487c329d105d",
"sku": "string",
"name": "Подарочная упаковка",
"price": 0,
"cover": {"placeholder": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"medium": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"large": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"xlarge": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"hd": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
}
}
},
"is_required": false,
"min_quantity": 0,
"max_quantity": 1
}
],
"modifiers_groups": [{"group": {"id": "92861bd9-2809-43f9-a7c3-78d0e5bc6e33",
"name": "План Apple Care",
"modifiers": [{"id": "92861b69-93c4-4c4e-991c-487c329d105d",
"sku": "string",
"name": "Подарочная упаковка",
"price": 0,
"cover": {"placeholder": {"url": null,
"width": null,
"height": null
},
"medium": {"url": null,
"width": null,
"height": null
},
"large": {"url": null,
"width": null,
"height": null
},
"xlarge": {"url": null,
"width": null,
"height": null
},
"hd": {"url": null,
"width": null,
"height": null
}
}
}
]
},
"is_required": false,
"min_quantity": 0,
"max_quantity": 1
}
],
"seo": {"title": "Смартфоны: цены, большой каталог, новинки",
"description": "Большой ассортимент электроники, цифровой и бытовой техники, а так же товаров для дома.",
"meta": [{"name": {"attribute": "name",
"value": "description"
},
"value": {"attribute": "content",
"value": "Большой ассортимент электроники, цифровой и бытовой техники, а так же товаров для дома."
}
},
{"name": {"attribute": "name",
"value": "og:image"
},
"value": {"attribute": "content",
"value": "https://assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg"
}
},
{"name": {"attribute": "name",
"value": "name"
},
"value": {"attribute": "content",
"value": "width=device-width, initial-scale=1"
},
"additional": [{"attribute": "id",
"value": "viewport"
}
]
}
]
}
}
]
}

Получить товар

Изображения включены по умолчанию.

Этот метод поддерживает следующие включения:

Включение	Описание
`categories`	Категории
`categories.cover`	Категории и обложки
`categories.seo`	Категории и SEO
`features`	Характеристики
`features_groups`	Группы характеристик
`modifiers`	Модификаторы
`modifiers_groups`	Группы модификаторов
`custom_fields`	Пользовательские поля
`variants`	Варианты товара
`variants.prices`	Варианты и цены
`variants.dimensions`	Варианты и габариты
`variants.remainders`	Варианты и остатки
`variants.options`	Варианты, опции вариантов и их значения
`variants.custom_fields`	Варианты и пользовательские поля
`seo`	SEO

path Parameters

store required	string ID магазина
product required	string ID товара

query Parameters

with	string Список включений
stock_id	string ID склада

Responses

Response samples

Content type

application/json

{"data": {"id": "92766ffe-2d0e-4f67-87fe-35312f545b30",
"short_id": "92766ffe2d0e45b3",
"slug": "iphone-12-pro",
"name": "iPhone 12 Pro",
"description": "A14 Bionic, самый быстрый процессор iPhone. Дисплей OLED от края до края. Передняя панель Ceramic Shield, которая в четыре раза снижает риск повреждений дисплея при падении. И Ночной режим на всех камерах. Всё это есть в iPhone 12. В двух размерах.",
"unit_type": "piece",
"weight": 187,
"nutrition_facts": {"calories": 100,
"proteins": 2.5,
"fats": 3.5,
"carbohydrates": 13
},
"quantity_step": 0.4,
"is_promotion_reward": false,
"categories": [{"id": "961172f7-ac30-43d5-9687-6ab70c13790b",
"short_id": "961172f7ac303790",
"parent_id": "998f217c-5470-477c-870c-b3c768afecf0",
"is_featured": false,
"slug": "smartfony",
"name": "Смартфоны",
"description": null,
"cover": {"placeholder": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"medium": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"large": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"xlarge": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"hd": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
}
},
"seo": {"title": "Смартфоны: цены, большой каталог, новинки",
"description": "Большой ассортимент электроники, цифровой и бытовой техники, а так же товаров для дома.",
"meta": [{"name": {"attribute": "name",
"value": "description"
},
"value": {"attribute": "content",
"value": "Большой ассортимент электроники, цифровой и бытовой техники, а так же товаров для дома."
}
},
{"name": {"attribute": "name",
"value": "og:image"
},
"value": {"attribute": "content",
"value": "https://assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg"
}
},
{"name": {"attribute": "name",
"value": "name"
},
"value": {"attribute": "content",
"value": "width=device-width, initial-scale=1"
},
"additional": [{"attribute": "id",
"value": "viewport"
}
]
}
]
}
}
],
"images": [{"placeholder": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"medium": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"large": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"xlarge": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"hd": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
}
}
],
"custom_fields": [{"id": "brand",
"name": "Производитель",
"type": "text",
"value": "Apple, Inc."
}
],
"variants": [{"id": "92766ffe-4265-4836-a8b4-92f64b090d97",
"sku": "IPHONE12-25",
"barcode": "IPHONE12-25",
"name": "iPhone 12 Pro Белый 128 ГБ",
"nutrition_facts": {"calories": 100,
"proteins": 2.5,
"fats": 3.5,
"carbohydrates": 13
},
"price": 0,
"original_price": 9999000,
"discount": {"difference": 1999800,
"percentage": 20
},
"default_modifiers": { },
"prices": [{"stock_id": null,
"price": 0,
"original_price": 9999000,
"discount": {"difference": 1999800,
"percentage": 20
}
}
],
"dimensions": [{"dimension": "weight",
"type": "netto",
"value": 187
}
],
"custom_fields": [{"id": "brand",
"name": "Производитель",
"type": "text",
"value": "Apple, Inc."
}
],
"remainders": [{"stock_id": "92766ffd-fdf7-44b0-bd51-0755d0aa027c",
"quantity": 10,
"label": "Мало"
}
],
"options": [{"id": "95e15ded-7fd0-4d30-900e-32f8cf0e4549",
"name": "Цвет",
"type": "color",
"value": {"id": "95e15ded-81eb-4d36-90d2-4de607140840",
"name": "Золотой",
"color": "#F9E5C9"
}
}
]
}
],
"features": [{"id": "92766ffd-f182-48ca-a4ae-6e4ccc3a243e",
"alias": "a243",
"name": "Размер дисплея",
"filterable": true,
"type": "range",
"range": "float",
"values": [{"id": "92766ffd-f182-48ca-a4ae-6e4ccc3a243e",
"alias": "a243",
"name": "Размер дисплея",
"range": "float"
}
]
}
],
"features_groups": [{"id": "96546cb3-ec0f-454e-83f8-711cc815c27c",
"name": "Внешний вид",
"description": "Внешний вид устройств.",
"features": [{"id": "92766ffd-f182-48ca-a4ae-6e4ccc3a243e",
"alias": "a243",
"name": "Размер дисплея",
"filterable": true,
"type": "range",
"range": "float",
"values": [{"id": "92766ffd-f182-48ca-a4ae-6e4ccc3a243e",
"alias": "a243",
"name": "Размер дисплея",
"range": "float"
}
]
}
]
}
],
"modifiers": [{"modifier": {"id": "92861b69-93c4-4c4e-991c-487c329d105d",
"sku": "string",
"name": "Подарочная упаковка",
"price": 0,
"cover": {"placeholder": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"medium": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"large": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"xlarge": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"hd": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
}
}
},
"is_required": false,
"min_quantity": 0,
"max_quantity": 1
}
],
"modifiers_groups": [{"group": {"id": "92861bd9-2809-43f9-a7c3-78d0e5bc6e33",
"name": "План Apple Care",
"modifiers": [{"id": "92861b69-93c4-4c4e-991c-487c329d105d",
"sku": "string",
"name": "Подарочная упаковка",
"price": 0,
"cover": {"placeholder": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"medium": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"large": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"xlarge": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"hd": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
}
}
}
]
},
"is_required": false,
"min_quantity": 0,
"max_quantity": 1
}
],
"seo": {"title": "Смартфоны: цены, большой каталог, новинки",
"description": "Большой ассортимент электроники, цифровой и бытовой техники, а так же товаров для дома.",
"meta": [{"name": {"attribute": "name",
"value": "description"
},
"value": {"attribute": "content",
"value": "Большой ассортимент электроники, цифровой и бытовой техники, а так же товаров для дома."
}
},
{"name": {"attribute": "name",
"value": "og:image"
},
"value": {"attribute": "content",
"value": "https://assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg"
}
},
{"name": {"attribute": "name",
"value": "name"
},
"value": {"attribute": "content",
"value": "width=device-width, initial-scale=1"
},
"additional": [{"attribute": "id",
"value": "viewport"
}
]
}
]
}
}
}

Получить цену варианта товара

Вычисляет цену варианта товара с выбранными модификаторами. Передавайте параметр city_id, чтобы получить переопределённую для выбранного города цену. Поле modifiers_hash из ответа следует использовать для поиска такого же варианта в корзине текущего заказа.

path Parameters

store required	string ID магазина
product required	string ID товара
variant required	string ID варианта товара

query Parameters

city_id	string ID текущего города.
stock_id	string ID выбранного склада.

Request Body schema: application/json
required

Array of objects

Выбранные модификаторы

Array

modifier_id	string ID модификатора
	string or null ID группы модификаторов. Для одиночных модификаторов не заполняется (можно не добавлять в запрос).
quantity	integer Количество модификаторов

Responses

Request samples

Payload

Content type

application/json

{"modifiers": [{"modifier_id": "95e3405c-b27a-4b1c-8934-77b42130659c",
"modifiers_group_id": "95e2efb8-b665-4ae8-8b9b-2b24ff52e931",
"quantity": 1
},
{"modifier_id": "95e79bf4-4a43-4081-9156-e5de9fb3276c",
"quantity": 1
}
]
}

Response samples

Content type

application/json

{"data": {"price": 0,
"original_price": 9999000,
"discount": {"difference": 1999800,
"percentage": 20
},
"modifiers_hash": "4c9c72f032c624330a6c24fb3c92a99a"
}
}

Получить список рекомендованных товаров

Этот метод возвращает товары, которые можно рекомендовать вместе с указанным товаром.

Если передать order_id и order_token, товары из переданного заказа будут исключены из рекомендаций. При проверке доступности товаров может использоваться город или склад из заказа.

Пагинация для этого метода не используется.

Этот метод поддерживает следующие включения:

Включение	Описание
`categories.cover`	Категории и обложки
`categories.seo`	Категории и SEO
`features`	Характеристики
`features_groups`	Группы характеристик
`modifiers`	Модификаторы
`modifiers_groups`	Группы модификаторов
`custom_fields`	Пользовательские поля
`variants`	Варианты товара
`variants.prices`	Варианты и цены
`variants.dimensions`	Варианты и габариты
`variants.remainders`	Варианты и остатки
`variants.options`	Варианты, опции вариантов и их значения
`variants.custom_fields`	Варианты и пользовательские поля
`seo`	SEO

path Parameters

store required	string ID магазина
product required	string ID товара

query Parameters

with	string Список включений
count	number [ 1 .. 20 ] Default: 10 Количество рекомендаций
city_id	string ID города (несовместим с `stock_id`)
stock_id	string ID склада (несовместим с `city_id`)
order_id	string ID текущего заказа (используется вместе с `order_token`)
order_token	string Токен текущего заказа (используется вместе с `order_id`)

Responses

Response samples

Content type

application/json

{"data": [{"id": "92766ffe-2d0e-4f67-87fe-35312f545b30",
"short_id": "92766ffe2d0e45b3",
"slug": "iphone-12-pro",
"name": "iPhone 12 Pro",
"description": "A14 Bionic, самый быстрый процессор iPhone. Дисплей OLED от края до края. Передняя панель Ceramic Shield, которая в четыре раза снижает риск повреждений дисплея при падении. И Ночной режим на всех камерах. Всё это есть в iPhone 12. В двух размерах.",
"unit_type": "piece",
"weight": 187,
"nutrition_facts": {"calories": 100,
"proteins": 2.5,
"fats": 3.5,
"carbohydrates": 13
},
"quantity_step": 0.4,
"is_promotion_reward": false,
"categories": [{"id": "961172f7-ac30-43d5-9687-6ab70c13790b",
"short_id": "961172f7ac303790",
"parent_id": "998f217c-5470-477c-870c-b3c768afecf0",
"is_featured": false,
"slug": "smartfony",
"name": "Смартфоны",
"description": null,
"cover": {"placeholder": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"medium": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"large": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"xlarge": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"hd": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
}
},
"seo": {"title": "Смартфоны: цены, большой каталог, новинки",
"description": "Большой ассортимент электроники, цифровой и бытовой техники, а так же товаров для дома.",
"meta": [{"name": {"attribute": "name",
"value": "description"
},
"value": {"attribute": "content",
"value": "Большой ассортимент электроники, цифровой и бытовой техники, а так же товаров для дома."
}
},
{"name": {"attribute": "name",
"value": "og:image"
},
"value": {"attribute": "content",
"value": "https://assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg"
}
},
{"name": {"attribute": "name",
"value": "name"
},
"value": {"attribute": "content",
"value": "width=device-width, initial-scale=1"
},
"additional": [{"attribute": "id",
"value": "viewport"
}
]
}
]
}
}
],
"images": [{"placeholder": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"medium": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"large": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"xlarge": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"hd": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
}
}
],
"custom_fields": [{"id": "brand",
"name": "Производитель",
"type": "text",
"value": "Apple, Inc."
}
],
"variants": [{"id": "92766ffe-4265-4836-a8b4-92f64b090d97",
"sku": "IPHONE12-25",
"barcode": "IPHONE12-25",
"name": "iPhone 12 Pro Белый 128 ГБ",
"nutrition_facts": {"calories": 100,
"proteins": 2.5,
"fats": 3.5,
"carbohydrates": 13
},
"price": 0,
"original_price": 9999000,
"discount": {"difference": 1999800,
"percentage": 20
},
"default_modifiers": { },
"prices": [{"stock_id": null,
"price": 0,
"original_price": 9999000,
"discount": {"difference": 1999800,
"percentage": 20
}
}
],
"dimensions": [{"dimension": "weight",
"type": "netto",
"value": 187
}
],
"custom_fields": [{"id": "brand",
"name": "Производитель",
"type": "text",
"value": "Apple, Inc."
}
],
"remainders": [{"stock_id": "92766ffd-fdf7-44b0-bd51-0755d0aa027c",
"quantity": 10,
"label": "Мало"
}
],
"options": [{"id": "95e15ded-7fd0-4d30-900e-32f8cf0e4549",
"name": "Цвет",
"type": "color",
"value": {"id": "95e15ded-81eb-4d36-90d2-4de607140840",
"name": "Золотой",
"color": "#F9E5C9"
}
}
]
}
],
"features": [{"id": "92766ffd-f182-48ca-a4ae-6e4ccc3a243e",
"alias": "a243",
"name": "Размер дисплея",
"filterable": true,
"type": "range",
"range": "float",
"values": [{"id": "92766ffd-f182-48ca-a4ae-6e4ccc3a243e",
"alias": "a243",
"name": "Размер дисплея",
"range": "float"
}
]
}
],
"features_groups": [{"id": "96546cb3-ec0f-454e-83f8-711cc815c27c",
"name": "Внешний вид",
"description": "Внешний вид устройств.",
"features": [{"id": "92766ffd-f182-48ca-a4ae-6e4ccc3a243e",
"alias": "a243",
"name": "Размер дисплея",
"filterable": true,
"type": "range",
"range": "float",
"values": [{"id": "92766ffd-f182-48ca-a4ae-6e4ccc3a243e",
"alias": "a243",
"name": "Размер дисплея",
"range": "float"
}
]
}
]
}
],
"modifiers": [{"modifier": {"id": "92861b69-93c4-4c4e-991c-487c329d105d",
"sku": "string",
"name": "Подарочная упаковка",
"price": 0,
"cover": {"placeholder": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"medium": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"large": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"xlarge": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"hd": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
}
}
},
"is_required": false,
"min_quantity": 0,
"max_quantity": 1
}
],
"modifiers_groups": [{"group": {"id": "92861bd9-2809-43f9-a7c3-78d0e5bc6e33",
"name": "План Apple Care",
"modifiers": [{"id": "92861b69-93c4-4c4e-991c-487c329d105d",
"sku": "string",
"name": "Подарочная упаковка",
"price": 0,
"cover": {"placeholder": {"url": null,
"width": null,
"height": null
},
"medium": {"url": null,
"width": null,
"height": null
},
"large": {"url": null,
"width": null,
"height": null
},
"xlarge": {"url": null,
"width": null,
"height": null
},
"hd": {"url": null,
"width": null,
"height": null
}
}
}
]
},
"is_required": false,
"min_quantity": 0,
"max_quantity": 1
}
],
"seo": {"title": "Смартфоны: цены, большой каталог, новинки",
"description": "Большой ассортимент электроники, цифровой и бытовой техники, а так же товаров для дома.",
"meta": [{"name": {"attribute": "name",
"value": "description"
},
"value": {"attribute": "content",
"value": "Большой ассортимент электроники, цифровой и бытовой техники, а так же товаров для дома."
}
},
{"name": {"attribute": "name",
"value": "og:image"
},
"value": {"attribute": "content",
"value": "https://assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg"
}
},
{"name": {"attribute": "name",
"value": "name"
},
"value": {"attribute": "content",
"value": "width=device-width, initial-scale=1"
},
"additional": [{"attribute": "id",
"value": "viewport"
}
]
}
]
}
}
]
}

Адреса

Получить подсказки адресов

path Parameters

store

required

string

ID магазина

Request Body schema: application/json
required

query required	string Строка поиска адреса
city_id	string Город, в котором нужно искать адреса
count	number Количество записей (по умолчанию 5, не более 20)

Responses

Request samples

Payload

Content type

application/json

{"query": "улан-удэ, жердева 104б",
"count": 10
}

Response samples

Content type

application/json

{"data": {"provider": "dadata",
"suggestions": [{"value": "г Улан-Удэ, ул Жердева, д 104Б",
"unrestricted_value": "670033, Респ Бурятия, г Улан-Удэ, Октябрьский р-н, ул Жердева, д 104Б",
"data": {"postal_code": "670033",
"country": "Россия",
"country_iso_code": "RU",
"federal_district": "Дальневосточный",
"region_fias_id": "a84ebed3-153d-4ba9-8532-8bdf879e1f5a",
"region_kladr_id": "0300000000000",
"region_iso_code": "RU-BU",
"region_with_type": "Респ Бурятия",
"region_type": "Респ",
"region_type_full": "республика",
"region": "Бурятия",
"area_fias_id": null,
"area_kladr_id": null,
"area_with_type": null,
"area_type": null,
"area_type_full": null,
"area": null,
"city_fias_id": "9fdcc25f-a3d0-4f28-8b61-40648d099065",
"city_kladr_id": "0300000100000",
"city_with_type": "г Улан-Удэ",
"city_type": "г",
"city_type_full": "город",
"city": "Улан-Удэ",
"city_area": null,
"city_district_fias_id": null,
"city_district_kladr_id": null,
"city_district_with_type": null,
"city_district_type": null,
"city_district_type_full": null,
"city_district": null,
"settlement_fias_id": null,
"settlement_kladr_id": null,
"settlement_with_type": null,
"settlement_type": null,
"settlement_type_full": null,
"settlement": null,
"street_fias_id": "342b9610-b11c-47b7-bd21-2e24ff8326dd",
"street_kladr_id": "03000001000012700",
"street_with_type": "ул Жердева",
"street_type": "ул",
"street_type_full": "улица",
"street": "Жердева",
"stead_fias_id": null,
"stead_cadnum": null,
"stead_type": null,
"stead_type_full": null,
"stead": null,
"house_fias_id": "9ed5b60b-4c7e-42c3-8e5c-fbbf97859186",
"house_kladr_id": "0300000100001270174",
"house_cadnum": null,
"house_type": "д",
"house_type_full": "дом",
"house": "104Б",
"block_type": null,
"block_type_full": null,
"block": null,
"entrance": null,
"floor": null,
"flat_fias_id": null,
"flat_cadnum": null,
"flat_type": null,
"flat_type_full": null,
"flat": null,
"flat_area": null,
"square_meter_price": null,
"flat_price": null,
"room_fias_id": null,
"room_cadnum": null,
"room_type": null,
"room_type_full": null,
"room": null,
"postal_box": null,
"fias_id": "9ed5b60b-4c7e-42c3-8e5c-fbbf97859186",
"fias_code": null,
"fias_level": "8",
"fias_actuality_state": "0",
"kladr_id": "0300000100001270174",
"geoname_id": "2014407",
"capital_marker": "2",
"okato": "81401368000",
"oktmo": "81701000001",
"tax_office": "0300",
"tax_office_legal": "0300",
"timezone": null,
"geo_lat": "51.8121373",
"geo_lon": "107.6641822",
"beltway_hit": null,
"beltway_distance": null,
"metro": null,
"divisions": null,
"qc_geo": "0",
"qc_complete": null,
"qc_house": null,
"history_values": null,
"unparsed_parts": null,
"source": null,
"qc": null
}
}
]
}
}

Получить подсказки адресов по координатам.

Этот метод может вернуть подсказки с уровнем ниже, чем "до дома" (например, город или регион).

path Parameters

store

required

string

ID магазина

Request Body schema: application/json
required

latitude required	number Широта точки
longitude required	number Долгота точки
count	number Количество записей (по умолчанию 5, не более 20)

Responses

Request samples

Payload

Content type

application/json

{"latitude": 51.8121373,
"longitude": 107.6641822,
"count": 10
}

Response samples

Content type

application/json

{"data": [{"provider": "dadata",
"suggestions": [{"value": "г Улан-Удэ, ул Жердева, д 104Б",
"unrestricted_value": "670033, Респ Бурятия, г Улан-Удэ, Октябрьский р-н, ул Жердева, д 104Б",
"data": {"postal_code": "670033",
"country": "Россия",
"country_iso_code": "RU",
"federal_district": "Дальневосточный",
"region_fias_id": "a84ebed3-153d-4ba9-8532-8bdf879e1f5a",
"region_kladr_id": "0300000000000",
"region_iso_code": "RU-BU",
"region_with_type": "Респ Бурятия",
"region_type": "Респ",
"region_type_full": "республика",
"region": "Бурятия",
"area_fias_id": null,
"area_kladr_id": null,
"area_with_type": null,
"area_type": null,
"area_type_full": null,
"area": null,
"city_fias_id": "9fdcc25f-a3d0-4f28-8b61-40648d099065",
"city_kladr_id": "0300000100000",
"city_with_type": "г Улан-Удэ",
"city_type": "г",
"city_type_full": "город",
"city": "Улан-Удэ",
"city_area": null,
"city_district_fias_id": null,
"city_district_kladr_id": null,
"city_district_with_type": null,
"city_district_type": null,
"city_district_type_full": null,
"city_district": null,
"settlement_fias_id": null,
"settlement_kladr_id": null,
"settlement_with_type": null,
"settlement_type": null,
"settlement_type_full": null,
"settlement": null,
"street_fias_id": "342b9610-b11c-47b7-bd21-2e24ff8326dd",
"street_kladr_id": "03000001000012700",
"street_with_type": "ул Жердева",
"street_type": "ул",
"street_type_full": "улица",
"street": "Жердева",
"stead_fias_id": null,
"stead_cadnum": null,
"stead_type": null,
"stead_type_full": null,
"stead": null,
"house_fias_id": "9ed5b60b-4c7e-42c3-8e5c-fbbf97859186",
"house_kladr_id": "0300000100001270174",
"house_cadnum": null,
"house_type": "д",
"house_type_full": "дом",
"house": "104Б",
"block_type": null,
"block_type_full": null,
"block": null,
"entrance": null,
"floor": null,
"flat_fias_id": null,
"flat_cadnum": null,
"flat_type": null,
"flat_type_full": null,
"flat": null,
"flat_area": null,
"square_meter_price": null,
"flat_price": null,
"room_fias_id": null,
"room_cadnum": null,
"room_type": null,
"room_type_full": null,
"room": null,
"postal_box": null,
"fias_id": "9ed5b60b-4c7e-42c3-8e5c-fbbf97859186",
"fias_code": null,
"fias_level": "8",
"fias_actuality_state": "0",
"kladr_id": "0300000100001270174",
"geoname_id": "2014407",
"capital_marker": "2",
"okato": "81401368000",
"oktmo": "81701000001",
"tax_office": "0300",
"tax_office_legal": "0300",
"timezone": null,
"geo_lat": "51.8121373",
"geo_lon": "107.6641822",
"beltway_hit": null,
"beltway_distance": null,
"metro": null,
"divisions": null,
"qc_geo": "0",
"qc_complete": null,
"qc_house": null,
"history_values": null,
"unparsed_parts": null,
"source": null,
"qc": null
}
}
]
}
]
}

Заказы

Получить список оформленных заказов покупателя

Этот метод поддерживает следующие включения:

Включение	Описание
`variants`	Позиции заказа
`variants.variant`	Позиции заказа и варианты товаров
`variants.variant.options`	Позиции, варианты, опции вариантов и их значения
`variants.modifiers`	Позиции и выбранные модификаторы товаров
`variants.modifiers.modifier`	Позиции, выбранные модификаторы и оригинальные модификаторы
`variants.modifiers.modifiers_group`	Позиции, выбранные модификаторы и оригинальные группы модификаторов
`variants.product`	Позиции заказа и товары
`variants.product.images`	Позиции заказа, товары и изображения
`variants.product.categories`	Позиции заказа, товары и категории
`city.settings`	Город и настройки
`stock.schedule`	Склад и режим работы
`customer`	Покупатель
`delivery_address`	Адрес доставки
`delivery_zone`	Зона доставки
`statuses`	История изменения статусов
`progress`	Прогресс изменения статусов
`payments`	Платёжные транзакции
`delivery_interval`	Интервал доставки

Authorizations:

Bearer

path Parameters

store

required

string

ID магазина

query Parameters

with	string Список включений
count	integer Количество записей
page	integer Номер страницы
search	string Строка поиска
order_by	string Поле сортировки
submitted_from	string Начальная дата оформления заказа (поддерживаемые форматы: `YYYY-MM-DD HH:MM:SS`, `YYYY-MM-DD HH:MM`, `YYYY-MM-DD`)
submitted_till	string Конечная дата оформления заказа (поддерживаемые форматы: `YYYY-MM-DD HH:MM:SS`, `YYYY-MM-DD HH:MM`, `YYYY-MM-DD`)
order_status_id	string ID статуса заказа (можно перечислять несколько через запятую)
city_id	string ID города
submission_period	string Период оформленных заказов. Поддерживаются следующие периоды: сутки (`24h`), неделя (`7d`), месяц (`30d`), год (`1y`). Не рекомендуется использовать вместе с `submitted_from`/`submitted_till`.

Responses

Response samples

Content type

application/json

{"data": [{"id": "string",
"token": "string",
"can_cancel": true,
"number": "string",
"delivery_method": "delivery",
"total_price": 0,
"original_total_price": 0,
"discount": {"difference": 0,
"percentage": 0
},
"notes": "string",
"created_at": "2019-08-24T14:15:22Z",
"submitted_at": "2019-08-24T14:15:22Z",
"deliver_at": "2019-08-24T14:15:22Z",
"meta_data": {"deliver_at": "string",
"on_premise": {"table": "string"
}
},
"status": {"id": "string",
"kind": "awaiting_delivery",
"name": "string",
"transitioned_at": "2019-08-24T14:15:22Z"
},
"variants": [{"id": "string",
"product_id": "string",
"product_variant_id": "string",
"stock_id": "string",
"promotion": {"id": "string",
"reward_id": "string"
},
"promocode_id": "string",
"is_reward": true,
"is_promocode_reward": true,
"quantity": 0,
"has_measured_quantity": true,
"measured_quantity": 0.1,
"total_price": 0,
"original_total_price": 0,
"unit_price": 0,
"original_unit_price": 0,
"discount": {"difference": 0,
"percentage": 0
},
"modifiers_hash": "string",
"product": {"id": "92766ffe-2d0e-4f67-87fe-35312f545b30",
"short_id": "92766ffe2d0e45b3",
"slug": "iphone-12-pro",
"name": "iPhone 12 Pro",
"description": "A14 Bionic, самый быстрый процессор iPhone. Дисплей OLED от края до края. Передняя панель Ceramic Shield, которая в четыре раза снижает риск повреждений дисплея при падении. И Ночной режим на всех камерах. Всё это есть в iPhone 12. В двух размерах.",
"unit_type": "piece",
"weight": 187,
"nutrition_facts": {"calories": 100,
"proteins": 2.5,
"fats": 3.5,
"carbohydrates": 13
},
"quantity_step": 0.4,
"is_promotion_reward": false,
"categories": [{"id": "961172f7-ac30-43d5-9687-6ab70c13790b",
"short_id": "961172f7ac303790",
"parent_id": "998f217c-5470-477c-870c-b3c768afecf0",
"is_featured": false,
"slug": "smartfony",
"name": "Смартфоны",
"description": null,
"cover": {"placeholder": {"url": null,
"width": null,
"height": null
},
"medium": {"url": null,
"width": null,
"height": null
},
"large": {"url": null,
"width": null,
"height": null
},
"xlarge": {"url": null,
"width": null,
"height": null
},
"hd": {"url": null,
"width": null,
"height": null
}
},
"seo": {"title": "Смартфоны: цены, большой каталог, новинки",
"description": "Большой ассортимент электроники, цифровой и бытовой техники, а так же товаров для дома.",
"meta": [{"name": {"attribute": "name",
"value": "description"
},
"value": {"attribute": "content",
"value": "Большой ассортимент электроники, цифровой и бытовой техники, а так же товаров для дома."
}
},
{"name": {"attribute": "name",
"value": "og:image"
},
"value": {"attribute": "content",
"value": "https://assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg"
}
},
{"name": {"attribute": "name",
"value": "name"
},
"value": {"attribute": "content",
"value": "width=device-width, initial-scale=1"
},
"additional": [{"attribute": "id",
"value": "viewport"
}
]
}
]
}
}
],
"images": [{"placeholder": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"medium": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"large": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"xlarge": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"hd": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
}
}
],
"custom_fields": [{"id": "brand",
"name": "Производитель",
"type": "text",
"value": "Apple, Inc."
}
],
"variants": [{"id": "92766ffe-4265-4836-a8b4-92f64b090d97",
"sku": "IPHONE12-25",
"barcode": "IPHONE12-25",
"name": "iPhone 12 Pro Белый 128 ГБ",
"nutrition_facts": {"calories": 100,
"proteins": 2.5,
"fats": 3.5,
"carbohydrates": 13
},
"price": 0,
"original_price": 9999000,
"discount": {"difference": 1999800,
"percentage": 20
},
"default_modifiers": { },
"prices": [{"stock_id": null,
"price": null,
"original_price": null,
"discount": null
}
],
"dimensions": [{"dimension": null,
"type": null,
"value": null
}
],
"custom_fields": [{"id": null,
"name": null,
"type": null,
"value": null
}
],
"remainders": [{"stock_id": "92766ffd-fdf7-44b0-bd51-0755d0aa027c",
"quantity": 10,
"label": "Мало"
}
],
"options": [{"id": null,
"name": null,
"type": null,
"value": { }
}
]
}
],
"features": [{"id": "92766ffd-f182-48ca-a4ae-6e4ccc3a243e",
"alias": "a243",
"name": "Размер дисплея",
"filterable": true,
"type": "range",
"range": "float",
"values": [{"id": null,
"alias": null,
"name": null,
"range": null
}
]
}
],
"features_groups": [{"id": "96546cb3-ec0f-454e-83f8-711cc815c27c",
"name": "Внешний вид",
"description": "Внешний вид устройств.",
"features": [{"id": null,
"alias": null,
"name": null,
"filterable": null,
"type": null,
"range": null,
"values": [ ]
}
]
}
],
"modifiers": [{"modifier": {"id": "92861b69-93c4-4c4e-991c-487c329d105d",
"sku": "string",
"name": "Подарочная упаковка",
"price": 0,
"cover": {"placeholder": null,
"medium": null,
"large": null,
"xlarge": null,
"hd": null
}
},
"is_required": false,
"min_quantity": 0,
"max_quantity": 1
}
],
"modifiers_groups": [{"group": {"id": "92861bd9-2809-43f9-a7c3-78d0e5bc6e33",
"name": "План Apple Care",
"modifiers": [null
]
},
"is_required": false,
"min_quantity": 0,
"max_quantity": 1
}
],
"seo": {"title": "Смартфоны: цены, большой каталог, новинки",
"description": "Большой ассортимент электроники, цифровой и бытовой техники, а так же товаров для дома.",
"meta": [{"name": {"attribute": "name",
"value": "description"
},
"value": {"attribute": "content",
"value": "Большой ассортимент электроники, цифровой и бытовой техники, а так же товаров для дома."
}
},
{"name": {"attribute": "name",
"value": "og:image"
},
"value": {"attribute": "content",
"value": "https://assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg"
}
},
{"name": {"attribute": "name",
"value": "name"
},
"value": {"attribute": "content",
"value": "width=device-width, initial-scale=1"
},
"additional": [{"attribute": "id",
"value": "viewport"
}
]
}
]
}
},
"variant": {"id": "92766ffe-4265-4836-a8b4-92f64b090d97",
"sku": "IPHONE12-25",
"barcode": "IPHONE12-25",
"name": "iPhone 12 Pro Белый 128 ГБ",
"nutrition_facts": {"calories": 100,
"proteins": 2.5,
"fats": 3.5,
"carbohydrates": 13
},
"price": 0,
"original_price": 9999000,
"discount": {"difference": 1999800,
"percentage": 20
},
"default_modifiers": { },
"prices": [{"stock_id": null,
"price": 0,
"original_price": 9999000,
"discount": {"difference": 1999800,
"percentage": 20
}
}
],
"dimensions": [{"dimension": "weight",
"type": "netto",
"value": 187
}
],
"custom_fields": [{"id": "brand",
"name": "Производитель",
"type": "text",
"value": "Apple, Inc."
}
],
"remainders": [{"stock_id": "92766ffd-fdf7-44b0-bd51-0755d0aa027c",
"quantity": 10,
"label": "Мало"
}
],
"options": [{"id": "95e15ded-7fd0-4d30-900e-32f8cf0e4549",
"name": "Цвет",
"type": "color",
"value": {"id": "95e15ded-81eb-4d36-90d2-4de607140840",
"name": "Золотой",
"color": "#F9E5C9"
}
}
]
},
"modifiers": [{"id": "string",
"modifiers_group_id": "string",
"quantity": 0,
"total_price": 0,
"unit_price": 0,
"original_price": 0,
"original_unit_price": 0,
"modifier": {"id": "92861b69-93c4-4c4e-991c-487c329d105d",
"sku": "string",
"name": "Подарочная упаковка",
"price": 0,
"cover": {"placeholder": {"url": null,
"width": null,
"height": null
},
"medium": {"url": null,
"width": null,
"height": null
},
"large": {"url": null,
"width": null,
"height": null
},
"xlarge": {"url": null,
"width": null,
"height": null
},
"hd": {"url": null,
"width": null,
"height": null
}
}
},
"modifiers_group": {"id": "92861bd9-2809-43f9-a7c3-78d0e5bc6e33",
"name": "План Apple Care"
}
}
]
}
],
"city": {"id": "9275c4be-44de-49d8-a308-d1322a8efa08",
"is_default": true,
"name": "Улан-Удэ",
"timezone": "Asia/Irkutsk",
"coordinates": {"latitude": 51.8121373,
"longitude": 107.6641822
},
"schedule": {"is_open_now": false,
"opening_at": "2023-06-20T10:00:00+08:00:00",
"closing_at": "2023-06-20T20:00:00+08:00:00",
"day_id": "friday",
"days": {"monday": {"hours": "10:00-19:00"
},
"tuesday": {"hours": "10:00-19:00"
},
"wednesday": {"hours": "10:00-19:00"
},
"thursday": {"hours": "10:00-19:00"
},
"friday": {"hours": "10:00-19:00"
},
"saturday": {"hours": "10:00-19:00"
},
"sunday": {"hours": "10:00-19:00"
}
}
},
"stocks": [{"id": "9655d648-9ed3-4fee-94fa-4a7bc807e5c7",
"name": "ТРК «Еврозона»",
"description": null,
"address": "г Улан-Удэ, ул Балтахинова, д 13",
"coordinates": {"latitude": 51.8121373,
"longitude": 107.6641822
},
"links": [{"type": "twitter",
"value": "https://instagram.com/zenky.io"
}
],
"phones": [{"country": "RU",
"number": "+79641234567",
"national": "+7 (964) 123-45-67"
}
],
"schedule": {"is_open_now": false,
"opening_at": "2023-06-20T10:00:00+08:00:00",
"closing_at": "2023-06-20T20:00:00+08:00:00",
"day_id": "friday",
"days": {"monday": {"hours": "10:00-19:00"
},
"tuesday": {"hours": "10:00-19:00"
},
"wednesday": {"hours": "10:00-19:00"
},
"thursday": {"hours": "10:00-19:00"
},
"friday": {"hours": "10:00-19:00"
},
"saturday": {"hours": "10:00-19:00"
},
"sunday": {"hours": "10:00-19:00"
}
}
}
}
],
"delivery_zones": [{"id": "96ad06d6-4c2b-4671-9f03-77e0544bbf14",
"name": "Первая зона",
"coordinates": [{"latitude": 51.86046585577859,
"longitude": 107.51617115746944
},
{"latitude": 51.869045905165855,
"longitude": 107.64526460749036
},
{"latitude": 51.81444475690688,
"longitude": 107.66697977167492
},
{"latitude": 51.80646099581586,
"longitude": 107.59888650849196
},
{"latitude": 51.80869899574977,
"longitude": 107.52450082880388
},
{"latitude": 51.86046585577859,
"longitude": 107.51617115746944
}
],
"description": "Первая зона доставки",
"color": "#ee44d7",
"min_price": 100000,
"free_delivery_price": 20000000,
"delivery_price": 2000000,
"delivery_time": "1 час"
}
]
},
"stock": {"id": "9655d648-9ed3-4fee-94fa-4a7bc807e5c7",
"name": "ТРК «Еврозона»",
"description": null,
"address": "г Улан-Удэ, ул Балтахинова, д 13",
"coordinates": {"latitude": 51.8121373,
"longitude": 107.6641822
},
"links": [{"type": "twitter",
"value": "https://instagram.com/zenky.io"
}
],
"phones": [{"country": "RU",
"number": "+79641234567",
"national": "+7 (964) 123-45-67"
}
],
"schedule": {"is_open_now": false,
"opening_at": "2023-06-20T10:00:00+08:00:00",
"closing_at": "2023-06-20T20:00:00+08:00:00",
"day_id": "friday",
"days": {"monday": {"hours": "10:00-19:00"
},
"tuesday": {"hours": "10:00-19:00"
},
"wednesday": {"hours": "10:00-19:00"
},
"thursday": {"hours": "10:00-19:00"
},
"friday": {"hours": "10:00-19:00"
},
"saturday": {"hours": "10:00-19:00"
},
"sunday": {"hours": "10:00-19:00"
}
}
}
},
"customer": {"id": "95e340eb-526c-4e8d-be07-026f944bb20f",
"store_profile_id": "95e340ef-b08c-4cd3-903d-15e22c488ad3",
"order_count": 0,
"orders_total_price": 0,
"first_name": "Иван",
"last_name": "Иванов",
"phone": {"country": "RU",
"number": "+79641234567",
"national": "+7 (964) 123-45-67"
},
"gender": "female",
"birth_date": "2019-08-24T14:15:22Z",
"registered_at": "2019-08-24T14:15:22Z",
"loyalty": {"referral_program": {"code": "EntertainingBlondKite",
"join_url": "https://promo.example.org/join/EntertainingBlondKite",
"invite_url": "https://promo.example.org/invite/EntertainingBlondKite"
},
"balance": 0,
"expenses": 0,
"bonuses_level": {"id": "94494cd1-f719-48ff-bd20-5b7d63f39153",
"name": "Пятый",
"expenses": 0,
"rates": {"cashback": 0,
"payment": 0
}
},
"rates": {"cashback": 0,
"payment": 0
}
},
"settings": {"onesignal_id": "a121bb68-72a6-4d4a-ac5b-4877b09f6632",
"device_id": "245CD19D-93AB-486F-89DE-C2B1156151B0",
"device_token": "9ba072e0ee65c50a5059342fc16137f80d560301dd9400b145441a17ff1a3e8b",
"device_os": "ios",
"barcode": {"content": "0000584720791",
"url": "https://api.zenky.io/v3/media/barcode?content=MDAwMDU4NDcyMDc5MQ==&input=base64"
},
"qrcode": {"content": "0000584720791",
"url": "https://api.zenky.io/v3/media/qrcode?content=aHR0cHM6Ly93d3cueW91dHViZS5jb20vd2F0Y2g/dj1kUXc0dzlXZ1hjUQ==&input=base64"
}
},
"avatar": {"placeholder": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"medium": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"large": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"xlarge": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"hd": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
}
}
},
"delivery_address": {"id": "93e6151c-57ed-41f4-ab75-4c64898f9696",
"resolver": "dadata",
"name": "Домашний адрес",
"address": "г Улан-Удэ, ул Жердева, д 104Б",
"coordinates": {"latitude": 51.8121373,
"longitude": 107.6641822
},
"country": "Россия",
"city": "Улан-Удэ",
"settlement": "113-й",
"street": "Жердева",
"house": "104Б",
"block": 1,
"apartment": "офис 505",
"entrance": "1",
"floor": "цокольный",
"has_intercom": true
},
"delivery_zone": {"id": "96ad06d6-4c2b-4671-9f03-77e0544bbf14",
"name": "Первая зона",
"coordinates": [{"latitude": 51.86046585577859,
"longitude": 107.51617115746944
},
{"latitude": 51.869045905165855,
"longitude": 107.64526460749036
},
{"latitude": 51.81444475690688,
"longitude": 107.66697977167492
},
{"latitude": 51.80646099581586,
"longitude": 107.59888650849196
},
{"latitude": 51.80869899574977,
"longitude": 107.52450082880388
},
{"latitude": 51.86046585577859,
"longitude": 107.51617115746944
}
],
"description": "Первая зона доставки",
"color": "#ee44d7",
"min_price": 100000,
"free_delivery_price": 20000000,
"delivery_price": 2000000,
"delivery_time": "1 час"
},
"statuses": [{"id": "string",
"kind": "awaiting_delivery",
"name": "string",
"transitioned_at": "2019-08-24T14:15:22Z"
}
],
"progress": [{"id": "string",
"kind": "awaiting_delivery",
"name": "string",
"transitioned_at": "2019-08-24T14:15:22Z"
}
],
"payments": [{"id": "string",
"type": "payment",
"status": "pending",
"method": "bonuses",
"amount": 0,
"created_at": "2019-08-24T14:15:22Z",
"confirmed_at": "2019-08-24T14:15:22Z",
"authorization_confirmed_at": "2019-08-24T14:15:22Z",
"cancelled_at": "2019-08-24T14:15:22Z",
"refunded_at": "2019-08-24T14:15:22Z",
"refund_failed_at": "2019-08-24T14:15:22Z",
"transaction_meta": {"change": 0,
"bill": 0
}
}
],
"delivery_interval": {"id": "9a661517-6b81-4428-a47d-bb4406885a12",
"date": {"iso": "2023-11-05",
"date": "05.11.2023"
},
"start_time": "10:00",
"end_time": "11:59"
},
"promocode": {"type": "plain",
"promocode": "EXAMPLE",
"message": "Спасибо! Ваш промокод будет передан оператору."
}
}
]
}

Создать заказ

path Parameters

store

required

string

ID магазина

Request Body schema: application/json
required

city_id

required

string

ID города

Responses

Request samples

Payload

Content type

application/json

{"city_id": "dcb2f209-c9a4-482c-8427-fc6e651e3ddf"
}

Response samples

Content type

application/json

{"data": {"id": "string",
"token": "string",
"can_cancel": true,
"number": "string",
"delivery_method": "delivery",
"total_price": 0,
"original_total_price": 0,
"discount": {"difference": 0,
"percentage": 0
},
"notes": "string",
"created_at": "2019-08-24T14:15:22Z",
"submitted_at": "2019-08-24T14:15:22Z",
"deliver_at": "2019-08-24T14:15:22Z",
"meta_data": {"deliver_at": "string",
"on_premise": {"table": "string"
}
},
"status": {"id": "string",
"kind": "awaiting_delivery",
"name": "string",
"transitioned_at": "2019-08-24T14:15:22Z"
},
"variants": [{"id": "string",
"product_id": "string",
"product_variant_id": "string",
"stock_id": "string",
"promotion": {"id": "string",
"reward_id": "string"
},
"promocode_id": "string",
"is_reward": true,
"is_promocode_reward": true,
"quantity": 0,
"has_measured_quantity": true,
"measured_quantity": 0.1,
"total_price": 0,
"original_total_price": 0,
"unit_price": 0,
"original_unit_price": 0,
"discount": {"difference": 0,
"percentage": 0
},
"modifiers_hash": "string",
"product": {"id": "92766ffe-2d0e-4f67-87fe-35312f545b30",
"short_id": "92766ffe2d0e45b3",
"slug": "iphone-12-pro",
"name": "iPhone 12 Pro",
"description": "A14 Bionic, самый быстрый процессор iPhone. Дисплей OLED от края до края. Передняя панель Ceramic Shield, которая в четыре раза снижает риск повреждений дисплея при падении. И Ночной режим на всех камерах. Всё это есть в iPhone 12. В двух размерах.",
"unit_type": "piece",
"weight": 187,
"nutrition_facts": {"calories": 100,
"proteins": 2.5,
"fats": 3.5,
"carbohydrates": 13
},
"quantity_step": 0.4,
"is_promotion_reward": false,
"categories": [{"id": "961172f7-ac30-43d5-9687-6ab70c13790b",
"short_id": "961172f7ac303790",
"parent_id": "998f217c-5470-477c-870c-b3c768afecf0",
"is_featured": false,
"slug": "smartfony",
"name": "Смартфоны",
"description": null,
"cover": {"placeholder": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"medium": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"large": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"xlarge": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"hd": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
}
},
"seo": {"title": "Смартфоны: цены, большой каталог, новинки",
"description": "Большой ассортимент электроники, цифровой и бытовой техники, а так же товаров для дома.",
"meta": [{"name": {"attribute": "name",
"value": "description"
},
"value": {"attribute": "content",
"value": "Большой ассортимент электроники, цифровой и бытовой техники, а так же товаров для дома."
}
},
{"name": {"attribute": "name",
"value": "og:image"
},
"value": {"attribute": "content",
"value": "https://assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg"
}
},
{"name": {"attribute": "name",
"value": "name"
},
"value": {"attribute": "content",
"value": "width=device-width, initial-scale=1"
},
"additional": [{"attribute": "id",
"value": "viewport"
}
]
}
]
}
}
],
"images": [{"placeholder": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"medium": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"large": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"xlarge": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"hd": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
}
}
],
"custom_fields": [{"id": "brand",
"name": "Производитель",
"type": "text",
"value": "Apple, Inc."
}
],
"variants": [{"id": "92766ffe-4265-4836-a8b4-92f64b090d97",
"sku": "IPHONE12-25",
"barcode": "IPHONE12-25",
"name": "iPhone 12 Pro Белый 128 ГБ",
"nutrition_facts": {"calories": 100,
"proteins": 2.5,
"fats": 3.5,
"carbohydrates": 13
},
"price": 0,
"original_price": 9999000,
"discount": {"difference": 1999800,
"percentage": 20
},
"default_modifiers": { },
"prices": [{"stock_id": null,
"price": 0,
"original_price": 9999000,
"discount": {"difference": 1999800,
"percentage": 20
}
}
],
"dimensions": [{"dimension": "weight",
"type": "netto",
"value": 187
}
],
"custom_fields": [{"id": "brand",
"name": "Производитель",
"type": "text",
"value": "Apple, Inc."
}
],
"remainders": [{"stock_id": "92766ffd-fdf7-44b0-bd51-0755d0aa027c",
"quantity": 10,
"label": "Мало"
}
],
"options": [{"id": "95e15ded-7fd0-4d30-900e-32f8cf0e4549",
"name": "Цвет",
"type": "color",
"value": {"id": "95e15ded-81eb-4d36-90d2-4de607140840",
"name": "Золотой",
"color": "#F9E5C9"
}
}
]
}
],
"features": [{"id": "92766ffd-f182-48ca-a4ae-6e4ccc3a243e",
"alias": "a243",
"name": "Размер дисплея",
"filterable": true,
"type": "range",
"range": "float",
"values": [{"id": "92766ffd-f182-48ca-a4ae-6e4ccc3a243e",
"alias": "a243",
"name": "Размер дисплея",
"range": "float"
}
]
}
],
"features_groups": [{"id": "96546cb3-ec0f-454e-83f8-711cc815c27c",
"name": "Внешний вид",
"description": "Внешний вид устройств.",
"features": [{"id": "92766ffd-f182-48ca-a4ae-6e4ccc3a243e",
"alias": "a243",
"name": "Размер дисплея",
"filterable": true,
"type": "range",
"range": "float",
"values": [null
]
}
]
}
],
"modifiers": [{"modifier": {"id": "92861b69-93c4-4c4e-991c-487c329d105d",
"sku": "string",
"name": "Подарочная упаковка",
"price": 0,
"cover": {"placeholder": {"url": null,
"width": null,
"height": null
},
"medium": {"url": null,
"width": null,
"height": null
},
"large": {"url": null,
"width": null,
"height": null
},
"xlarge": {"url": null,
"width": null,
"height": null
},
"hd": {"url": null,
"width": null,
"height": null
}
}
},
"is_required": false,
"min_quantity": 0,
"max_quantity": 1
}
],
"modifiers_groups": [{"group": {"id": "92861bd9-2809-43f9-a7c3-78d0e5bc6e33",
"name": "План Apple Care",
"modifiers": [{"id": null,
"sku": null,
"name": null,
"price": null,
"cover": null
}
]
},
"is_required": false,
"min_quantity": 0,
"max_quantity": 1
}
],
"seo": {"title": "Смартфоны: цены, большой каталог, новинки",
"description": "Большой ассортимент электроники, цифровой и бытовой техники, а так же товаров для дома.",
"meta": [{"name": {"attribute": "name",
"value": "description"
},
"value": {"attribute": "content",
"value": "Большой ассортимент электроники, цифровой и бытовой техники, а так же товаров для дома."
}
},
{"name": {"attribute": "name",
"value": "og:image"
},
"value": {"attribute": "content",
"value": "https://assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg"
}
},
{"name": {"attribute": "name",
"value": "name"
},
"value": {"attribute": "content",
"value": "width=device-width, initial-scale=1"
},
"additional": [{"attribute": "id",
"value": "viewport"
}
]
}
]
}
},
"variant": {"id": "92766ffe-4265-4836-a8b4-92f64b090d97",
"sku": "IPHONE12-25",
"barcode": "IPHONE12-25",
"name": "iPhone 12 Pro Белый 128 ГБ",
"nutrition_facts": {"calories": 100,
"proteins": 2.5,
"fats": 3.5,
"carbohydrates": 13
},
"price": 0,
"original_price": 9999000,
"discount": {"difference": 1999800,
"percentage": 20
},
"default_modifiers": { },
"prices": [{"stock_id": null,
"price": 0,
"original_price": 9999000,
"discount": {"difference": 1999800,
"percentage": 20
}
}
],
"dimensions": [{"dimension": "weight",
"type": "netto",
"value": 187
}
],
"custom_fields": [{"id": "brand",
"name": "Производитель",
"type": "text",
"value": "Apple, Inc."
}
],
"remainders": [{"stock_id": "92766ffd-fdf7-44b0-bd51-0755d0aa027c",
"quantity": 10,
"label": "Мало"
}
],
"options": [{"id": "95e15ded-7fd0-4d30-900e-32f8cf0e4549",
"name": "Цвет",
"type": "color",
"value": {"id": "95e15ded-81eb-4d36-90d2-4de607140840",
"name": "Золотой",
"color": "#F9E5C9"
}
}
]
},
"modifiers": [{"id": "string",
"modifiers_group_id": "string",
"quantity": 0,
"total_price": 0,
"unit_price": 0,
"original_price": 0,
"original_unit_price": 0,
"modifier": {"id": "92861b69-93c4-4c4e-991c-487c329d105d",
"sku": "string",
"name": "Подарочная упаковка",
"price": 0,
"cover": {"placeholder": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"medium": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"large": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"xlarge": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"hd": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
}
}
},
"modifiers_group": {"id": "92861bd9-2809-43f9-a7c3-78d0e5bc6e33",
"name": "План Apple Care"
}
}
]
}
],
"city": {"id": "9275c4be-44de-49d8-a308-d1322a8efa08",
"is_default": true,
"name": "Улан-Удэ",
"timezone": "Asia/Irkutsk",
"coordinates": {"latitude": 51.8121373,
"longitude": 107.6641822
},
"schedule": {"is_open_now": false,
"opening_at": "2023-06-20T10:00:00+08:00:00",
"closing_at": "2023-06-20T20:00:00+08:00:00",
"day_id": "friday",
"days": {"monday": {"hours": "10:00-19:00"
},
"tuesday": {"hours": "10:00-19:00"
},
"wednesday": {"hours": "10:00-19:00"
},
"thursday": {"hours": "10:00-19:00"
},
"friday": {"hours": "10:00-19:00"
},
"saturday": {"hours": "10:00-19:00"
},
"sunday": {"hours": "10:00-19:00"
}
}
},
"stocks": [{"id": "9655d648-9ed3-4fee-94fa-4a7bc807e5c7",
"name": "ТРК «Еврозона»",
"description": null,
"address": "г Улан-Удэ, ул Балтахинова, д 13",
"coordinates": {"latitude": 51.8121373,
"longitude": 107.6641822
},
"links": [{"type": "twitter",
"value": "https://instagram.com/zenky.io"
}
],
"phones": [{"country": "RU",
"number": "+79641234567",
"national": "+7 (964) 123-45-67"
}
],
"schedule": {"is_open_now": false,
"opening_at": "2023-06-20T10:00:00+08:00:00",
"closing_at": "2023-06-20T20:00:00+08:00:00",
"day_id": "friday",
"days": {"monday": {"hours": "10:00-19:00"
},
"tuesday": {"hours": "10:00-19:00"
},
"wednesday": {"hours": "10:00-19:00"
},
"thursday": {"hours": "10:00-19:00"
},
"friday": {"hours": "10:00-19:00"
},
"saturday": {"hours": "10:00-19:00"
},
"sunday": {"hours": "10:00-19:00"
}
}
}
}
],
"delivery_zones": [{"id": "96ad06d6-4c2b-4671-9f03-77e0544bbf14",
"name": "Первая зона",
"coordinates": [{"latitude": 51.86046585577859,
"longitude": 107.51617115746944
},
{"latitude": 51.869045905165855,
"longitude": 107.64526460749036
},
{"latitude": 51.81444475690688,
"longitude": 107.66697977167492
},
{"latitude": 51.80646099581586,
"longitude": 107.59888650849196
},
{"latitude": 51.80869899574977,
"longitude": 107.52450082880388
},
{"latitude": 51.86046585577859,
"longitude": 107.51617115746944
}
],
"description": "Первая зона доставки",
"color": "#ee44d7",
"min_price": 100000,
"free_delivery_price": 20000000,
"delivery_price": 2000000,
"delivery_time": "1 час"
}
]
},
"stock": {"id": "9655d648-9ed3-4fee-94fa-4a7bc807e5c7",
"name": "ТРК «Еврозона»",
"description": null,
"address": "г Улан-Удэ, ул Балтахинова, д 13",
"coordinates": {"latitude": 51.8121373,
"longitude": 107.6641822
},
"links": [{"type": "twitter",
"value": "https://instagram.com/zenky.io"
}
],
"phones": [{"country": "RU",
"number": "+79641234567",
"national": "+7 (964) 123-45-67"
}
],
"schedule": {"is_open_now": false,
"opening_at": "2023-06-20T10:00:00+08:00:00",
"closing_at": "2023-06-20T20:00:00+08:00:00",
"day_id": "friday",
"days": {"monday": {"hours": "10:00-19:00"
},
"tuesday": {"hours": "10:00-19:00"
},
"wednesday": {"hours": "10:00-19:00"
},
"thursday": {"hours": "10:00-19:00"
},
"friday": {"hours": "10:00-19:00"
},
"saturday": {"hours": "10:00-19:00"
},
"sunday": {"hours": "10:00-19:00"
}
}
}
},
"customer": {"id": "95e340eb-526c-4e8d-be07-026f944bb20f",
"store_profile_id": "95e340ef-b08c-4cd3-903d-15e22c488ad3",
"order_count": 0,
"orders_total_price": 0,
"first_name": "Иван",
"last_name": "Иванов",
"phone": {"country": "RU",
"number": "+79641234567",
"national": "+7 (964) 123-45-67"
},
"gender": "female",
"birth_date": "2019-08-24T14:15:22Z",
"registered_at": "2019-08-24T14:15:22Z",
"loyalty": {"referral_program": {"code": "EntertainingBlondKite",
"join_url": "https://promo.example.org/join/EntertainingBlondKite",
"invite_url": "https://promo.example.org/invite/EntertainingBlondKite"
},
"balance": 0,
"expenses": 0,
"bonuses_level": {"id": "94494cd1-f719-48ff-bd20-5b7d63f39153",
"name": "Пятый",
"expenses": 0,
"rates": {"cashback": 0,
"payment": 0
}
},
"rates": {"cashback": 0,
"payment": 0
}
},
"settings": {"onesignal_id": "a121bb68-72a6-4d4a-ac5b-4877b09f6632",
"device_id": "245CD19D-93AB-486F-89DE-C2B1156151B0",
"device_token": "9ba072e0ee65c50a5059342fc16137f80d560301dd9400b145441a17ff1a3e8b",
"device_os": "ios",
"barcode": {"content": "0000584720791",
"url": "https://api.zenky.io/v3/media/barcode?content=MDAwMDU4NDcyMDc5MQ==&input=base64"
},
"qrcode": {"content": "0000584720791",
"url": "https://api.zenky.io/v3/media/qrcode?content=aHR0cHM6Ly93d3cueW91dHViZS5jb20vd2F0Y2g/dj1kUXc0dzlXZ1hjUQ==&input=base64"
}
},
"avatar": {"placeholder": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"medium": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"large": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"xlarge": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"hd": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
}
}
},
"delivery_address": {"id": "93e6151c-57ed-41f4-ab75-4c64898f9696",
"resolver": "dadata",
"name": "Домашний адрес",
"address": "г Улан-Удэ, ул Жердева, д 104Б",
"coordinates": {"latitude": 51.8121373,
"longitude": 107.6641822
},
"country": "Россия",
"city": "Улан-Удэ",
"settlement": "113-й",
"street": "Жердева",
"house": "104Б",
"block": 1,
"apartment": "офис 505",
"entrance": "1",
"floor": "цокольный",
"has_intercom": true
},
"delivery_zone": {"id": "96ad06d6-4c2b-4671-9f03-77e0544bbf14",
"name": "Первая зона",
"coordinates": [{"latitude": 51.86046585577859,
"longitude": 107.51617115746944
},
{"latitude": 51.869045905165855,
"longitude": 107.64526460749036
},
{"latitude": 51.81444475690688,
"longitude": 107.66697977167492
},
{"latitude": 51.80646099581586,
"longitude": 107.59888650849196
},
{"latitude": 51.80869899574977,
"longitude": 107.52450082880388
},
{"latitude": 51.86046585577859,
"longitude": 107.51617115746944
}
],
"description": "Первая зона доставки",
"color": "#ee44d7",
"min_price": 100000,
"free_delivery_price": 20000000,
"delivery_price": 2000000,
"delivery_time": "1 час"
},
"statuses": [{"id": "string",
"kind": "awaiting_delivery",
"name": "string",
"transitioned_at": "2019-08-24T14:15:22Z"
}
],
"progress": [{"id": "string",
"kind": "awaiting_delivery",
"name": "string",
"transitioned_at": "2019-08-24T14:15:22Z"
}
],
"payments": [{"id": "string",
"type": "payment",
"status": "pending",
"method": "bonuses",
"amount": 0,
"created_at": "2019-08-24T14:15:22Z",
"confirmed_at": "2019-08-24T14:15:22Z",
"authorization_confirmed_at": "2019-08-24T14:15:22Z",
"cancelled_at": "2019-08-24T14:15:22Z",
"refunded_at": "2019-08-24T14:15:22Z",
"refund_failed_at": "2019-08-24T14:15:22Z",
"transaction_meta": {"change": 0,
"bill": 0
}
}
],
"delivery_interval": {"id": "9a661517-6b81-4428-a47d-bb4406885a12",
"date": {"iso": "2023-11-05",
"date": "05.11.2023"
},
"start_time": "10:00",
"end_time": "11:59"
},
"promocode": {"type": "plain",
"promocode": "EXAMPLE",
"message": "Спасибо! Ваш промокод будет передан оператору."
}
}
}

Получить заказ

Этот метод поддерживает следующие включения:

Включение	Описание
`variants`	Позиции заказа
`variants.variant`	Позиции заказа и варианты товаров
`variants.variant.options`	Позиции, варианты, опции вариантов и их значения
`variants.modifiers`	Позиции и выбранные модификаторы товаров
`variants.modifiers.modifier`	Позиции, выбранные модификаторы и оригинальные модификаторы
`variants.modifiers.modifiers_group`	Позиции, выбранные модификаторы и оригинальные группы модификаторов
`variants.product`	Позиции заказа и товары
`variants.product.images`	Позиции заказа, товары и изображения
`variants.product.categories`	Позиции заказа, товары и категории
`city.settings`	Город и настройки
`stock.schedule`	Склад и режим работы
`customer`	Покупатель
`delivery_address`	Адрес доставки
`delivery_zone`	Зона доставки
`statuses`	История изменения статусов
`progress`	Прогресс изменения статусов
`payments`	Платёжные транзакции
`delivery_interval`	Интервал доставки
`promocode`	Промокод, применённый к заказу

path Parameters

store required	string ID магазина
order required	string ID заказа

query Parameters

with	string Список включений
token	string Токен заказа (для неаутентифицированных запросов)

Responses

Response samples

Content type

application/json

{"data": {"id": "string",
"token": "string",
"can_cancel": true,
"number": "string",
"delivery_method": "delivery",
"total_price": 0,
"original_total_price": 0,
"discount": {"difference": 0,
"percentage": 0
},
"notes": "string",
"created_at": "2019-08-24T14:15:22Z",
"submitted_at": "2019-08-24T14:15:22Z",
"deliver_at": "2019-08-24T14:15:22Z",
"meta_data": {"deliver_at": "string",
"on_premise": {"table": "string"
}
},
"status": {"id": "string",
"kind": "awaiting_delivery",
"name": "string",
"transitioned_at": "2019-08-24T14:15:22Z"
},
"variants": [{"id": "string",
"product_id": "string",
"product_variant_id": "string",
"stock_id": "string",
"promotion": {"id": "string",
"reward_id": "string"
},
"promocode_id": "string",
"is_reward": true,
"is_promocode_reward": true,
"quantity": 0,
"has_measured_quantity": true,
"measured_quantity": 0.1,
"total_price": 0,
"original_total_price": 0,
"unit_price": 0,
"original_unit_price": 0,
"discount": {"difference": 0,
"percentage": 0
},
"modifiers_hash": "string",
"product": {"id": "92766ffe-2d0e-4f67-87fe-35312f545b30",
"short_id": "92766ffe2d0e45b3",
"slug": "iphone-12-pro",
"name": "iPhone 12 Pro",
"description": "A14 Bionic, самый быстрый процессор iPhone. Дисплей OLED от края до края. Передняя панель Ceramic Shield, которая в четыре раза снижает риск повреждений дисплея при падении. И Ночной режим на всех камерах. Всё это есть в iPhone 12. В двух размерах.",
"unit_type": "piece",
"weight": 187,
"nutrition_facts": {"calories": 100,
"proteins": 2.5,
"fats": 3.5,
"carbohydrates": 13
},
"quantity_step": 0.4,
"is_promotion_reward": false,
"categories": [{"id": "961172f7-ac30-43d5-9687-6ab70c13790b",
"short_id": "961172f7ac303790",
"parent_id": "998f217c-5470-477c-870c-b3c768afecf0",
"is_featured": false,
"slug": "smartfony",
"name": "Смартфоны",
"description": null,
"cover": {"placeholder": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"medium": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"large": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"xlarge": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"hd": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
}
},
"seo": {"title": "Смартфоны: цены, большой каталог, новинки",
"description": "Большой ассортимент электроники, цифровой и бытовой техники, а так же товаров для дома.",
"meta": [{"name": {"attribute": "name",
"value": "description"
},
"value": {"attribute": "content",
"value": "Большой ассортимент электроники, цифровой и бытовой техники, а так же товаров для дома."
}
},
{"name": {"attribute": "name",
"value": "og:image"
},
"value": {"attribute": "content",
"value": "https://assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg"
}
},
{"name": {"attribute": "name",
"value": "name"
},
"value": {"attribute": "content",
"value": "width=device-width, initial-scale=1"
},
"additional": [{"attribute": "id",
"value": "viewport"
}
]
}
]
}
}
],
"images": [{"placeholder": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"medium": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"large": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"xlarge": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"hd": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
}
}
],
"custom_fields": [{"id": "brand",
"name": "Производитель",
"type": "text",
"value": "Apple, Inc."
}
],
"variants": [{"id": "92766ffe-4265-4836-a8b4-92f64b090d97",
"sku": "IPHONE12-25",
"barcode": "IPHONE12-25",
"name": "iPhone 12 Pro Белый 128 ГБ",
"nutrition_facts": {"calories": 100,
"proteins": 2.5,
"fats": 3.5,
"carbohydrates": 13
},
"price": 0,
"original_price": 9999000,
"discount": {"difference": 1999800,
"percentage": 20
},
"default_modifiers": { },
"prices": [{"stock_id": null,
"price": 0,
"original_price": 9999000,
"discount": {"difference": 1999800,
"percentage": 20
}
}
],
"dimensions": [{"dimension": "weight",
"type": "netto",
"value": 187
}
],
"custom_fields": [{"id": "brand",
"name": "Производитель",
"type": "text",
"value": "Apple, Inc."
}
],
"remainders": [{"stock_id": "92766ffd-fdf7-44b0-bd51-0755d0aa027c",
"quantity": 10,
"label": "Мало"
}
],
"options": [{"id": "95e15ded-7fd0-4d30-900e-32f8cf0e4549",
"name": "Цвет",
"type": "color",
"value": {"id": "95e15ded-81eb-4d36-90d2-4de607140840",
"name": "Золотой",
"color": "#F9E5C9"
}
}
]
}
],
"features": [{"id": "92766ffd-f182-48ca-a4ae-6e4ccc3a243e",
"alias": "a243",
"name": "Размер дисплея",
"filterable": true,
"type": "range",
"range": "float",
"values": [{"id": "92766ffd-f182-48ca-a4ae-6e4ccc3a243e",
"alias": "a243",
"name": "Размер дисплея",
"range": "float"
}
]
}
],
"features_groups": [{"id": "96546cb3-ec0f-454e-83f8-711cc815c27c",
"name": "Внешний вид",
"description": "Внешний вид устройств.",
"features": [{"id": "92766ffd-f182-48ca-a4ae-6e4ccc3a243e",
"alias": "a243",
"name": "Размер дисплея",
"filterable": true,
"type": "range",
"range": "float",
"values": [null
]
}
]
}
],
"modifiers": [{"modifier": {"id": "92861b69-93c4-4c4e-991c-487c329d105d",
"sku": "string",
"name": "Подарочная упаковка",
"price": 0,
"cover": {"placeholder": {"url": null,
"width": null,
"height": null
},
"medium": {"url": null,
"width": null,
"height": null
},
"large": {"url": null,
"width": null,
"height": null
},
"xlarge": {"url": null,
"width": null,
"height": null
},
"hd": {"url": null,
"width": null,
"height": null
}
}
},
"is_required": false,
"min_quantity": 0,
"max_quantity": 1
}
],
"modifiers_groups": [{"group": {"id": "92861bd9-2809-43f9-a7c3-78d0e5bc6e33",
"name": "План Apple Care",
"modifiers": [{"id": null,
"sku": null,
"name": null,
"price": null,
"cover": null
}
]
},
"is_required": false,
"min_quantity": 0,
"max_quantity": 1
}
],
"seo": {"title": "Смартфоны: цены, большой каталог, новинки",
"description": "Большой ассортимент электроники, цифровой и бытовой техники, а так же товаров для дома.",
"meta": [{"name": {"attribute": "name",
"value": "description"
},
"value": {"attribute": "content",
"value": "Большой ассортимент электроники, цифровой и бытовой техники, а так же товаров для дома."
}
},
{"name": {"attribute": "name",
"value": "og:image"
},
"value": {"attribute": "content",
"value": "https://assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg"
}
},
{"name": {"attribute": "name",
"value": "name"
},
"value": {"attribute": "content",
"value": "width=device-width, initial-scale=1"
},
"additional": [{"attribute": "id",
"value": "viewport"
}
]
}
]
}
},
"variant": {"id": "92766ffe-4265-4836-a8b4-92f64b090d97",
"sku": "IPHONE12-25",
"barcode": "IPHONE12-25",
"name": "iPhone 12 Pro Белый 128 ГБ",
"nutrition_facts": {"calories": 100,
"proteins": 2.5,
"fats": 3.5,
"carbohydrates": 13
},
"price": 0,
"original_price": 9999000,
"discount": {"difference": 1999800,
"percentage": 20
},
"default_modifiers": { },
"prices": [{"stock_id": null,
"price": 0,
"original_price": 9999000,
"discount": {"difference": 1999800,
"percentage": 20
}
}
],
"dimensions": [{"dimension": "weight",
"type": "netto",
"value": 187
}
],
"custom_fields": [{"id": "brand",
"name": "Производитель",
"type": "text",
"value": "Apple, Inc."
}
],
"remainders": [{"stock_id": "92766ffd-fdf7-44b0-bd51-0755d0aa027c",
"quantity": 10,
"label": "Мало"
}
],
"options": [{"id": "95e15ded-7fd0-4d30-900e-32f8cf0e4549",
"name": "Цвет",
"type": "color",
"value": {"id": "95e15ded-81eb-4d36-90d2-4de607140840",
"name": "Золотой",
"color": "#F9E5C9"
}
}
]
},
"modifiers": [{"id": "string",
"modifiers_group_id": "string",
"quantity": 0,
"total_price": 0,
"unit_price": 0,
"original_price": 0,
"original_unit_price": 0,
"modifier": {"id": "92861b69-93c4-4c4e-991c-487c329d105d",
"sku": "string",
"name": "Подарочная упаковка",
"price": 0,
"cover": {"placeholder": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"medium": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"large": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"xlarge": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"hd": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
}
}
},
"modifiers_group": {"id": "92861bd9-2809-43f9-a7c3-78d0e5bc6e33",
"name": "План Apple Care"
}
}
]
}
],
"city": {"id": "9275c4be-44de-49d8-a308-d1322a8efa08",
"is_default": true,
"name": "Улан-Удэ",
"timezone": "Asia/Irkutsk",
"coordinates": {"latitude": 51.8121373,
"longitude": 107.6641822
},
"schedule": {"is_open_now": false,
"opening_at": "2023-06-20T10:00:00+08:00:00",
"closing_at": "2023-06-20T20:00:00+08:00:00",
"day_id": "friday",
"days": {"monday": {"hours": "10:00-19:00"
},
"tuesday": {"hours": "10:00-19:00"
},
"wednesday": {"hours": "10:00-19:00"
},
"thursday": {"hours": "10:00-19:00"
},
"friday": {"hours": "10:00-19:00"
},
"saturday": {"hours": "10:00-19:00"
},
"sunday": {"hours": "10:00-19:00"
}
}
},
"stocks": [{"id": "9655d648-9ed3-4fee-94fa-4a7bc807e5c7",
"name": "ТРК «Еврозона»",
"description": null,
"address": "г Улан-Удэ, ул Балтахинова, д 13",
"coordinates": {"latitude": 51.8121373,
"longitude": 107.6641822
},
"links": [{"type": "twitter",
"value": "https://instagram.com/zenky.io"
}
],
"phones": [{"country": "RU",
"number": "+79641234567",
"national": "+7 (964) 123-45-67"
}
],
"schedule": {"is_open_now": false,
"opening_at": "2023-06-20T10:00:00+08:00:00",
"closing_at": "2023-06-20T20:00:00+08:00:00",
"day_id": "friday",
"days": {"monday": {"hours": "10:00-19:00"
},
"tuesday": {"hours": "10:00-19:00"
},
"wednesday": {"hours": "10:00-19:00"
},
"thursday": {"hours": "10:00-19:00"
},
"friday": {"hours": "10:00-19:00"
},
"saturday": {"hours": "10:00-19:00"
},
"sunday": {"hours": "10:00-19:00"
}
}
}
}
],
"delivery_zones": [{"id": "96ad06d6-4c2b-4671-9f03-77e0544bbf14",
"name": "Первая зона",
"coordinates": [{"latitude": 51.86046585577859,
"longitude": 107.51617115746944
},
{"latitude": 51.869045905165855,
"longitude": 107.64526460749036
},
{"latitude": 51.81444475690688,
"longitude": 107.66697977167492
},
{"latitude": 51.80646099581586,
"longitude": 107.59888650849196
},
{"latitude": 51.80869899574977,
"longitude": 107.52450082880388
},
{"latitude": 51.86046585577859,
"longitude": 107.51617115746944
}
],
"description": "Первая зона доставки",
"color": "#ee44d7",
"min_price": 100000,
"free_delivery_price": 20000000,
"delivery_price": 2000000,
"delivery_time": "1 час"
}
]
},
"stock": {"id": "9655d648-9ed3-4fee-94fa-4a7bc807e5c7",
"name": "ТРК «Еврозона»",
"description": null,
"address": "г Улан-Удэ, ул Балтахинова, д 13",
"coordinates": {"latitude": 51.8121373,
"longitude": 107.6641822
},
"links": [{"type": "twitter",
"value": "https://instagram.com/zenky.io"
}
],
"phones": [{"country": "RU",
"number": "+79641234567",
"national": "+7 (964) 123-45-67"
}
],
"schedule": {"is_open_now": false,
"opening_at": "2023-06-20T10:00:00+08:00:00",
"closing_at": "2023-06-20T20:00:00+08:00:00",
"day_id": "friday",
"days": {"monday": {"hours": "10:00-19:00"
},
"tuesday": {"hours": "10:00-19:00"
},
"wednesday": {"hours": "10:00-19:00"
},
"thursday": {"hours": "10:00-19:00"
},
"friday": {"hours": "10:00-19:00"
},
"saturday": {"hours": "10:00-19:00"
},
"sunday": {"hours": "10:00-19:00"
}
}
}
},
"customer": {"id": "95e340eb-526c-4e8d-be07-026f944bb20f",
"store_profile_id": "95e340ef-b08c-4cd3-903d-15e22c488ad3",
"order_count": 0,
"orders_total_price": 0,
"first_name": "Иван",
"last_name": "Иванов",
"phone": {"country": "RU",
"number": "+79641234567",
"national": "+7 (964) 123-45-67"
},
"gender": "female",
"birth_date": "2019-08-24T14:15:22Z",
"registered_at": "2019-08-24T14:15:22Z",
"loyalty": {"referral_program": {"code": "EntertainingBlondKite",
"join_url": "https://promo.example.org/join/EntertainingBlondKite",
"invite_url": "https://promo.example.org/invite/EntertainingBlondKite"
},
"balance": 0,
"expenses": 0,
"bonuses_level": {"id": "94494cd1-f719-48ff-bd20-5b7d63f39153",
"name": "Пятый",
"expenses": 0,
"rates": {"cashback": 0,
"payment": 0
}
},
"rates": {"cashback": 0,
"payment": 0
}
},
"settings": {"onesignal_id": "a121bb68-72a6-4d4a-ac5b-4877b09f6632",
"device_id": "245CD19D-93AB-486F-89DE-C2B1156151B0",
"device_token": "9ba072e0ee65c50a5059342fc16137f80d560301dd9400b145441a17ff1a3e8b",
"device_os": "ios",
"barcode": {"content": "0000584720791",
"url": "https://api.zenky.io/v3/media/barcode?content=MDAwMDU4NDcyMDc5MQ==&input=base64"
},
"qrcode": {"content": "0000584720791",
"url": "https://api.zenky.io/v3/media/qrcode?content=aHR0cHM6Ly93d3cueW91dHViZS5jb20vd2F0Y2g/dj1kUXc0dzlXZ1hjUQ==&input=base64"
}
},
"avatar": {"placeholder": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"medium": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"large": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"xlarge": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"hd": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
}
}
},
"delivery_address": {"id": "93e6151c-57ed-41f4-ab75-4c64898f9696",
"resolver": "dadata",
"name": "Домашний адрес",
"address": "г Улан-Удэ, ул Жердева, д 104Б",
"coordinates": {"latitude": 51.8121373,
"longitude": 107.6641822
},
"country": "Россия",
"city": "Улан-Удэ",
"settlement": "113-й",
"street": "Жердева",
"house": "104Б",
"block": 1,
"apartment": "офис 505",
"entrance": "1",
"floor": "цокольный",
"has_intercom": true
},
"delivery_zone": {"id": "96ad06d6-4c2b-4671-9f03-77e0544bbf14",
"name": "Первая зона",
"coordinates": [{"latitude": 51.86046585577859,
"longitude": 107.51617115746944
},
{"latitude": 51.869045905165855,
"longitude": 107.64526460749036
},
{"latitude": 51.81444475690688,
"longitude": 107.66697977167492
},
{"latitude": 51.80646099581586,
"longitude": 107.59888650849196
},
{"latitude": 51.80869899574977,
"longitude": 107.52450082880388
},
{"latitude": 51.86046585577859,
"longitude": 107.51617115746944
}
],
"description": "Первая зона доставки",
"color": "#ee44d7",
"min_price": 100000,
"free_delivery_price": 20000000,
"delivery_price": 2000000,
"delivery_time": "1 час"
},
"statuses": [{"id": "string",
"kind": "awaiting_delivery",
"name": "string",
"transitioned_at": "2019-08-24T14:15:22Z"
}
],
"progress": [{"id": "string",
"kind": "awaiting_delivery",
"name": "string",
"transitioned_at": "2019-08-24T14:15:22Z"
}
],
"payments": [{"id": "string",
"type": "payment",
"status": "pending",
"method": "bonuses",
"amount": 0,
"created_at": "2019-08-24T14:15:22Z",
"confirmed_at": "2019-08-24T14:15:22Z",
"authorization_confirmed_at": "2019-08-24T14:15:22Z",
"cancelled_at": "2019-08-24T14:15:22Z",
"refunded_at": "2019-08-24T14:15:22Z",
"refund_failed_at": "2019-08-24T14:15:22Z",
"transaction_meta": {"change": 0,
"bill": 0
}
}
],
"delivery_interval": {"id": "9a661517-6b81-4428-a47d-bb4406885a12",
"date": {"iso": "2023-11-05",
"date": "05.11.2023"
},
"start_time": "10:00",
"end_time": "11:59"
},
"promocode": {"type": "plain",
"promocode": "EXAMPLE",
"message": "Спасибо! Ваш промокод будет передан оператору."
}
}
}

Настройки заказа

Метод возвращает список опций, способов доставки и способов оплаты, которые доступны для выбранного заказа.

path Parameters

store required	string ID магазина
order required	string ID заказа

query Parameters

token

string

Токен заказа (для неаутентифицированных запросов)

Responses

Response samples

Content type

application/json

{"data": {"payment_methods": [{"id": "cash",
"name": "Наличные"
},
{"id": "mobile_bank",
"name": "Мобильный банк"
},
{"id": "credit-card",
"name": "Картой при получении"
},
{"id": "cloudpayments",
"name": "Картой онлайн",
"meta": {"payment_page_url": "https://payments.zenky.io/orders/..."
}
},
{"id": "card_token",
"name": "Visa XXXX-4242",
"token": {"id": "96ef1a01-06a7-4c57-9251-60d9405ca4de",
"type": "visa",
"first_six": "424242",
"last_four": "4242",
"bank": null
}
}
],
"delivery_methods": [{"id": "delivery",
"name": "Курьер",
"min_price": 150000,
"delivery_price": null,
"discount": null
},
{"id": "pickup",
"name": "Самовывоз",
"min_price": 10000,
"delivery_price": null,
"discount": {"type": "percentage",
"value": 5
}
},
{"id": "on_premise",
"name": "В заведении",
"min_price": 200000,
"delivery_price": null,
"discount": null
}
],
"options": [{"id": "persons_count",
"kind": "persons_count",
"meta": null
},
{"id": "delivery_intervals",
"kind": "delivery_intervals",
"meta": {"is_required": true,
"delivery_methods": ["delivery"
],
"intervals": [{"day_id": "tuesday",
"date": "2023-10-24",
"name": "Сегодня",
"intervals": [{"id": "9a661517-6044-4d96-9de1-d9c7e6ba0d7a",
"price": null,
"name": "18:00-19:59",
"description": "Стандартная стоимость доставки"
},
{"id": "9a661517-60d6-4504-942b-887904234552",
"price": null,
"name": "20:00-21:59",
"description": "Стандартная стоимость доставки"
},
{"id": "9a661517-6210-4c9f-9b9f-8f2422a293b6",
"price": null,
"name": "22:00-23:59",
"description": "Стандартная стоимость доставки"
}
]
},
{"day_id": "wednesday",
"date": "2023-10-25",
"name": "Завтра",
"intervals": [{"id": "9a661517-626f-49c8-8a0d-bd68a8143bb5",
"price": null,
"name": "10:00-11:59",
"description": "Стандартная стоимость доставки"
},
{"id": "9a661517-62ef-41a9-b9b2-599289f9dc40",
"price": null,
"name": "12:00-13:59",
"description": "Стандартная стоимость доставки"
},
{"id": "9a661517-6373-4e81-82c4-f983f37197a6",
"price": null,
"name": "14:00-15:59",
"description": "Стандартная стоимость доставки"
},
{"id": "9a661517-63e7-4c82-a1e7-dba2efee074c",
"price": null,
"name": "16:00-17:59",
"description": "Стандартная стоимость доставки"
},
{"id": "9a661517-645d-423e-8b31-c347da5a1714",
"price": null,
"name": "18:00-19:59",
"description": "Стандартная стоимость доставки"
},
{"id": "9a661517-64af-408b-b31e-0f9f7ada4863",
"price": null,
"name": "20:00-21:59",
"description": "Стандартная стоимость доставки"
},
{"id": "9a661517-6512-4d7c-9f49-53382914cbaf",
"price": 25000,
"name": "22:00-23:59",
"description": "250₽"
}
]
}
]
}
}
]
}
}

Повторить заказ

Этот метод позволяет повторить ранее оформленный заказ.

В новый заказ будут скопированы все доступные для заказа товары из исходного заказа (включая модификаторы товаров). К новому заказу так же будут привязаны покупатель и способ доставки (связанный склад или адрес доставки).

Этот метод можно вызвать только с передачей API-токена покупателя, который оформлял заказ.

Если у магазина отключена возможность повтора заказов, метод завершится с ошибкой.

В ответе на запрос будут возвращены идентификатор и токен нового заказа.

Передавайте ID текущего заказа в поле current_order_id, чтобы получить websocket-уведомление о копировании заказа (orders.repeated).

Возможные ошибки API

Во время выполнения этого запроса вы можете столкнуться со следующими ошибками:

HTTP	Код	Причина	Решение
503	`orders.repeat.failed`	Невозможно повторить выбранный заказ. В поле `meta` может содержаться код причины ошибки (поле `reason`).	Проверить, что повтор заказов подключён для магазина.
403	`orders.repeat.invalid_customer_profile`	Выбранный заказ был оформлен другим покупателем.	Убедиться, что передаётся токен аутентифицированного покупателя, который оформлял выбранный заказ.
422	`orders.repeat.must_be_submitted`	Повторить можно только оформленные заказы.	Не отображать кнопку «Повторить заказ» для заказов, которые ещё не были оформлены.

Authorizations:

Bearer

path Parameters

store required	string ID магазина
order required	string ID заказа

Request Body schema: application/json
required

current_order_id

string

ID текущего заказа

Responses

Request samples

Payload

Content type

application/json

{"current_order_id": "9a6857af-f758-497a-ade4-dcb9bd038252"
}

Response samples

Content type

application/json

{"data": {"id": "string",
"token": "string"
}
}

Отменить заказ

Этот метод позволяет отменить заказ. Возможность отмены заказа необходимо проверять в boolean-поле can_cancel структуры заказа.

Возможные ошибки API

Во время выполнения этого запроса вы можете столкнуться со следующими ошибками:

HTTP	Код	Причина	Решение
403	`orders.cant_be_cancelled`	Истекли условия, при которых можно отменить заказ.	Не отображать кнопку «Отменить заказ» для заказов, которые нельзя отменить (поле `can_cancel` у заказов).

Authorizations:

Bearer

path Parameters

store required	string ID магазина
order required	string ID заказа

Responses

Response samples

Content type

application/json

{"message": "Unauthenticated."
}

Позиции заказа

Добавить товары к заказу

path Parameters

store required	string ID магазина
order required	string ID заказа

query Parameters

token

string

Токен заказа (для неаутентифицированных запросов)

Request Body schema: application/json
required

product_variant_id required	string ID варианта товара
quantity required	integer Количество
stock_id	string or null ID связанного склада
promotion_id	string ID акции, с которой связан добавляемый подарок
promotion_reward_id	string ID подарка акции, с которым связан добавляемый вариант
	Array of objects (ProductModifierInput) Список модификаторов

Responses

Request samples

Payload

Content type

application/json

{"product_variant_id": "b11f7b7f-5f41-4bc2-97fa-7df49225a2ba",
"quantity": 1,
"stock_id": null,
"promotion_id": "7c2efbaf-ed05-4981-9748-b94a1b78ad33",
"promotion_reward_id": "9f5934fb-ed3c-42fe-8dd4-ae3f12699957",
"modifiers": [{"modifier_id": "ed4df70c-ee98-487e-b9ce-93ca0369b7ac",
"quantity": 1
},
{"modifier_id": "bdeccb16-bb4a-4f25-9692-729713e2a3ee",
"quantity": 2,
"modifiers_group_id": "f04b5da0-c29f-4983-8786-d32429537b53"
}
]
}

Response samples

Content type

application/json

{"data": {"id": "string",
"token": "string",
"can_cancel": true,
"number": "string",
"delivery_method": "delivery",
"total_price": 0,
"original_total_price": 0,
"discount": {"difference": 0,
"percentage": 0
},
"notes": "string",
"created_at": "2019-08-24T14:15:22Z",
"submitted_at": "2019-08-24T14:15:22Z",
"deliver_at": "2019-08-24T14:15:22Z",
"meta_data": {"deliver_at": "string",
"on_premise": {"table": "string"
}
},
"status": {"id": "string",
"kind": "awaiting_delivery",
"name": "string",
"transitioned_at": "2019-08-24T14:15:22Z"
},
"variants": [{"id": "string",
"product_id": "string",
"product_variant_id": "string",
"stock_id": "string",
"promotion": {"id": "string",
"reward_id": "string"
},
"promocode_id": "string",
"is_reward": true,
"is_promocode_reward": true,
"quantity": 0,
"has_measured_quantity": true,
"measured_quantity": 0.1,
"total_price": 0,
"original_total_price": 0,
"unit_price": 0,
"original_unit_price": 0,
"discount": {"difference": 0,
"percentage": 0
},
"modifiers_hash": "string",
"product": {"id": "92766ffe-2d0e-4f67-87fe-35312f545b30",
"short_id": "92766ffe2d0e45b3",
"slug": "iphone-12-pro",
"name": "iPhone 12 Pro",
"description": "A14 Bionic, самый быстрый процессор iPhone. Дисплей OLED от края до края. Передняя панель Ceramic Shield, которая в четыре раза снижает риск повреждений дисплея при падении. И Ночной режим на всех камерах. Всё это есть в iPhone 12. В двух размерах.",
"unit_type": "piece",
"weight": 187,
"nutrition_facts": {"calories": 100,
"proteins": 2.5,
"fats": 3.5,
"carbohydrates": 13
},
"quantity_step": 0.4,
"is_promotion_reward": false,
"categories": [{"id": "961172f7-ac30-43d5-9687-6ab70c13790b",
"short_id": "961172f7ac303790",
"parent_id": "998f217c-5470-477c-870c-b3c768afecf0",
"is_featured": false,
"slug": "smartfony",
"name": "Смартфоны",
"description": null,
"cover": {"placeholder": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"medium": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"large": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"xlarge": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"hd": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
}
},
"seo": {"title": "Смартфоны: цены, большой каталог, новинки",
"description": "Большой ассортимент электроники, цифровой и бытовой техники, а так же товаров для дома.",
"meta": [{"name": {"attribute": "name",
"value": "description"
},
"value": {"attribute": "content",
"value": "Большой ассортимент электроники, цифровой и бытовой техники, а так же товаров для дома."
}
},
{"name": {"attribute": "name",
"value": "og:image"
},
"value": {"attribute": "content",
"value": "https://assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg"
}
},
{"name": {"attribute": "name",
"value": "name"
},
"value": {"attribute": "content",
"value": "width=device-width, initial-scale=1"
},
"additional": [{"attribute": "id",
"value": "viewport"
}
]
}
]
}
}
],
"images": [{"placeholder": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"medium": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"large": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"xlarge": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"hd": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
}
}
],
"custom_fields": [{"id": "brand",
"name": "Производитель",
"type": "text",
"value": "Apple, Inc."
}
],
"variants": [{"id": "92766ffe-4265-4836-a8b4-92f64b090d97",
"sku": "IPHONE12-25",
"barcode": "IPHONE12-25",
"name": "iPhone 12 Pro Белый 128 ГБ",
"nutrition_facts": {"calories": 100,
"proteins": 2.5,
"fats": 3.5,
"carbohydrates": 13
},
"price": 0,
"original_price": 9999000,
"discount": {"difference": 1999800,
"percentage": 20
},
"default_modifiers": { },
"prices": [{"stock_id": null,
"price": 0,
"original_price": 9999000,
"discount": {"difference": 1999800,
"percentage": 20
}
}
],
"dimensions": [{"dimension": "weight",
"type": "netto",
"value": 187
}
],
"custom_fields": [{"id": "brand",
"name": "Производитель",
"type": "text",
"value": "Apple, Inc."
}
],
"remainders": [{"stock_id": "92766ffd-fdf7-44b0-bd51-0755d0aa027c",
"quantity": 10,
"label": "Мало"
}
],
"options": [{"id": "95e15ded-7fd0-4d30-900e-32f8cf0e4549",
"name": "Цвет",
"type": "color",
"value": {"id": "95e15ded-81eb-4d36-90d2-4de607140840",
"name": "Золотой",
"color": "#F9E5C9"
}
}
]
}
],
"features": [{"id": "92766ffd-f182-48ca-a4ae-6e4ccc3a243e",
"alias": "a243",
"name": "Размер дисплея",
"filterable": true,
"type": "range",
"range": "float",
"values": [{"id": "92766ffd-f182-48ca-a4ae-6e4ccc3a243e",
"alias": "a243",
"name": "Размер дисплея",
"range": "float"
}
]
}
],
"features_groups": [{"id": "96546cb3-ec0f-454e-83f8-711cc815c27c",
"name": "Внешний вид",
"description": "Внешний вид устройств.",
"features": [{"id": "92766ffd-f182-48ca-a4ae-6e4ccc3a243e",
"alias": "a243",
"name": "Размер дисплея",
"filterable": true,
"type": "range",
"range": "float",
"values": [null
]
}
]
}
],
"modifiers": [{"modifier": {"id": "92861b69-93c4-4c4e-991c-487c329d105d",
"sku": "string",
"name": "Подарочная упаковка",
"price": 0,
"cover": {"placeholder": {"url": null,
"width": null,
"height": null
},
"medium": {"url": null,
"width": null,
"height": null
},
"large": {"url": null,
"width": null,
"height": null
},
"xlarge": {"url": null,
"width": null,
"height": null
},
"hd": {"url": null,
"width": null,
"height": null
}
}
},
"is_required": false,
"min_quantity": 0,
"max_quantity": 1
}
],
"modifiers_groups": [{"group": {"id": "92861bd9-2809-43f9-a7c3-78d0e5bc6e33",
"name": "План Apple Care",
"modifiers": [{"id": null,
"sku": null,
"name": null,
"price": null,
"cover": null
}
]
},
"is_required": false,
"min_quantity": 0,
"max_quantity": 1
}
],
"seo": {"title": "Смартфоны: цены, большой каталог, новинки",
"description": "Большой ассортимент электроники, цифровой и бытовой техники, а так же товаров для дома.",
"meta": [{"name": {"attribute": "name",
"value": "description"
},
"value": {"attribute": "content",
"value": "Большой ассортимент электроники, цифровой и бытовой техники, а так же товаров для дома."
}
},
{"name": {"attribute": "name",
"value": "og:image"
},
"value": {"attribute": "content",
"value": "https://assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg"
}
},
{"name": {"attribute": "name",
"value": "name"
},
"value": {"attribute": "content",
"value": "width=device-width, initial-scale=1"
},
"additional": [{"attribute": "id",
"value": "viewport"
}
]
}
]
}
},
"variant": {"id": "92766ffe-4265-4836-a8b4-92f64b090d97",
"sku": "IPHONE12-25",
"barcode": "IPHONE12-25",
"name": "iPhone 12 Pro Белый 128 ГБ",
"nutrition_facts": {"calories": 100,
"proteins": 2.5,
"fats": 3.5,
"carbohydrates": 13
},
"price": 0,
"original_price": 9999000,
"discount": {"difference": 1999800,
"percentage": 20
},
"default_modifiers": { },
"prices": [{"stock_id": null,
"price": 0,
"original_price": 9999000,
"discount": {"difference": 1999800,
"percentage": 20
}
}
],
"dimensions": [{"dimension": "weight",
"type": "netto",
"value": 187
}
],
"custom_fields": [{"id": "brand",
"name": "Производитель",
"type": "text",
"value": "Apple, Inc."
}
],
"remainders": [{"stock_id": "92766ffd-fdf7-44b0-bd51-0755d0aa027c",
"quantity": 10,
"label": "Мало"
}
],
"options": [{"id": "95e15ded-7fd0-4d30-900e-32f8cf0e4549",
"name": "Цвет",
"type": "color",
"value": {"id": "95e15ded-81eb-4d36-90d2-4de607140840",
"name": "Золотой",
"color": "#F9E5C9"
}
}
]
},
"modifiers": [{"id": "string",
"modifiers_group_id": "string",
"quantity": 0,
"total_price": 0,
"unit_price": 0,
"original_price": 0,
"original_unit_price": 0,
"modifier": {"id": "92861b69-93c4-4c4e-991c-487c329d105d",
"sku": "string",
"name": "Подарочная упаковка",
"price": 0,
"cover": {"placeholder": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"medium": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"large": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"xlarge": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"hd": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
}
}
},
"modifiers_group": {"id": "92861bd9-2809-43f9-a7c3-78d0e5bc6e33",
"name": "План Apple Care"
}
}
]
}
],
"city": {"id": "9275c4be-44de-49d8-a308-d1322a8efa08",
"is_default": true,
"name": "Улан-Удэ",
"timezone": "Asia/Irkutsk",
"coordinates": {"latitude": 51.8121373,
"longitude": 107.6641822
},
"schedule": {"is_open_now": false,
"opening_at": "2023-06-20T10:00:00+08:00:00",
"closing_at": "2023-06-20T20:00:00+08:00:00",
"day_id": "friday",
"days": {"monday": {"hours": "10:00-19:00"
},
"tuesday": {"hours": "10:00-19:00"
},
"wednesday": {"hours": "10:00-19:00"
},
"thursday": {"hours": "10:00-19:00"
},
"friday": {"hours": "10:00-19:00"
},
"saturday": {"hours": "10:00-19:00"
},
"sunday": {"hours": "10:00-19:00"
}
}
},
"stocks": [{"id": "9655d648-9ed3-4fee-94fa-4a7bc807e5c7",
"name": "ТРК «Еврозона»",
"description": null,
"address": "г Улан-Удэ, ул Балтахинова, д 13",
"coordinates": {"latitude": 51.8121373,
"longitude": 107.6641822
},
"links": [{"type": "twitter",
"value": "https://instagram.com/zenky.io"
}
],
"phones": [{"country": "RU",
"number": "+79641234567",
"national": "+7 (964) 123-45-67"
}
],
"schedule": {"is_open_now": false,
"opening_at": "2023-06-20T10:00:00+08:00:00",
"closing_at": "2023-06-20T20:00:00+08:00:00",
"day_id": "friday",
"days": {"monday": {"hours": "10:00-19:00"
},
"tuesday": {"hours": "10:00-19:00"
},
"wednesday": {"hours": "10:00-19:00"
},
"thursday": {"hours": "10:00-19:00"
},
"friday": {"hours": "10:00-19:00"
},
"saturday": {"hours": "10:00-19:00"
},
"sunday": {"hours": "10:00-19:00"
}
}
}
}
],
"delivery_zones": [{"id": "96ad06d6-4c2b-4671-9f03-77e0544bbf14",
"name": "Первая зона",
"coordinates": [{"latitude": 51.86046585577859,
"longitude": 107.51617115746944
},
{"latitude": 51.869045905165855,
"longitude": 107.64526460749036
},
{"latitude": 51.81444475690688,
"longitude": 107.66697977167492
},
{"latitude": 51.80646099581586,
"longitude": 107.59888650849196
},
{"latitude": 51.80869899574977,
"longitude": 107.52450082880388
},
{"latitude": 51.86046585577859,
"longitude": 107.51617115746944
}
],
"description": "Первая зона доставки",
"color": "#ee44d7",
"min_price": 100000,
"free_delivery_price": 20000000,
"delivery_price": 2000000,
"delivery_time": "1 час"
}
]
},
"stock": {"id": "9655d648-9ed3-4fee-94fa-4a7bc807e5c7",
"name": "ТРК «Еврозона»",
"description": null,
"address": "г Улан-Удэ, ул Балтахинова, д 13",
"coordinates": {"latitude": 51.8121373,
"longitude": 107.6641822
},
"links": [{"type": "twitter",
"value": "https://instagram.com/zenky.io"
}
],
"phones": [{"country": "RU",
"number": "+79641234567",
"national": "+7 (964) 123-45-67"
}
],
"schedule": {"is_open_now": false,
"opening_at": "2023-06-20T10:00:00+08:00:00",
"closing_at": "2023-06-20T20:00:00+08:00:00",
"day_id": "friday",
"days": {"monday": {"hours": "10:00-19:00"
},
"tuesday": {"hours": "10:00-19:00"
},
"wednesday": {"hours": "10:00-19:00"
},
"thursday": {"hours": "10:00-19:00"
},
"friday": {"hours": "10:00-19:00"
},
"saturday": {"hours": "10:00-19:00"
},
"sunday": {"hours": "10:00-19:00"
}
}
}
},
"customer": {"id": "95e340eb-526c-4e8d-be07-026f944bb20f",
"store_profile_id": "95e340ef-b08c-4cd3-903d-15e22c488ad3",
"order_count": 0,
"orders_total_price": 0,
"first_name": "Иван",
"last_name": "Иванов",
"phone": {"country": "RU",
"number": "+79641234567",
"national": "+7 (964) 123-45-67"
},
"gender": "female",
"birth_date": "2019-08-24T14:15:22Z",
"registered_at": "2019-08-24T14:15:22Z",
"loyalty": {"referral_program": {"code": "EntertainingBlondKite",
"join_url": "https://promo.example.org/join/EntertainingBlondKite",
"invite_url": "https://promo.example.org/invite/EntertainingBlondKite"
},
"balance": 0,
"expenses": 0,
"bonuses_level": {"id": "94494cd1-f719-48ff-bd20-5b7d63f39153",
"name": "Пятый",
"expenses": 0,
"rates": {"cashback": 0,
"payment": 0
}
},
"rates": {"cashback": 0,
"payment": 0
}
},
"settings": {"onesignal_id": "a121bb68-72a6-4d4a-ac5b-4877b09f6632",
"device_id": "245CD19D-93AB-486F-89DE-C2B1156151B0",
"device_token": "9ba072e0ee65c50a5059342fc16137f80d560301dd9400b145441a17ff1a3e8b",
"device_os": "ios",
"barcode": {"content": "0000584720791",
"url": "https://api.zenky.io/v3/media/barcode?content=MDAwMDU4NDcyMDc5MQ==&input=base64"
},
"qrcode": {"content": "0000584720791",
"url": "https://api.zenky.io/v3/media/qrcode?content=aHR0cHM6Ly93d3cueW91dHViZS5jb20vd2F0Y2g/dj1kUXc0dzlXZ1hjUQ==&input=base64"
}
},
"avatar": {"placeholder": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"medium": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"large": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"xlarge": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"hd": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
}
}
},
"delivery_address": {"id": "93e6151c-57ed-41f4-ab75-4c64898f9696",
"resolver": "dadata",
"name": "Домашний адрес",
"address": "г Улан-Удэ, ул Жердева, д 104Б",
"coordinates": {"latitude": 51.8121373,
"longitude": 107.6641822
},
"country": "Россия",
"city": "Улан-Удэ",
"settlement": "113-й",
"street": "Жердева",
"house": "104Б",
"block": 1,
"apartment": "офис 505",
"entrance": "1",
"floor": "цокольный",
"has_intercom": true
},
"delivery_zone": {"id": "96ad06d6-4c2b-4671-9f03-77e0544bbf14",
"name": "Первая зона",
"coordinates": [{"latitude": 51.86046585577859,
"longitude": 107.51617115746944
},
{"latitude": 51.869045905165855,
"longitude": 107.64526460749036
},
{"latitude": 51.81444475690688,
"longitude": 107.66697977167492
},
{"latitude": 51.80646099581586,
"longitude": 107.59888650849196
},
{"latitude": 51.80869899574977,
"longitude": 107.52450082880388
},
{"latitude": 51.86046585577859,
"longitude": 107.51617115746944
}
],
"description": "Первая зона доставки",
"color": "#ee44d7",
"min_price": 100000,
"free_delivery_price": 20000000,
"delivery_price": 2000000,
"delivery_time": "1 час"
},
"statuses": [{"id": "string",
"kind": "awaiting_delivery",
"name": "string",
"transitioned_at": "2019-08-24T14:15:22Z"
}
],
"progress": [{"id": "string",
"kind": "awaiting_delivery",
"name": "string",
"transitioned_at": "2019-08-24T14:15:22Z"
}
],
"payments": [{"id": "string",
"type": "payment",
"status": "pending",
"method": "bonuses",
"amount": 0,
"created_at": "2019-08-24T14:15:22Z",
"confirmed_at": "2019-08-24T14:15:22Z",
"authorization_confirmed_at": "2019-08-24T14:15:22Z",
"cancelled_at": "2019-08-24T14:15:22Z",
"refunded_at": "2019-08-24T14:15:22Z",
"refund_failed_at": "2019-08-24T14:15:22Z",
"transaction_meta": {"change": 0,
"bill": 0
}
}
],
"delivery_interval": {"id": "9a661517-6b81-4428-a47d-bb4406885a12",
"date": {"iso": "2023-11-05",
"date": "05.11.2023"
},
"start_time": "10:00",
"end_time": "11:59"
},
"promocode": {"type": "plain",
"promocode": "EXAMPLE",
"message": "Спасибо! Ваш промокод будет передан оператору."
}
}
}

Удалить товары из заказа

path Parameters

store required	string ID магазина
order required	string ID заказа

query Parameters

token

string

Токен заказа (для неаутентифицированных запросов)

Request Body schema: application/json
required

product_variant_id required	string ID варианта товара
quantity required	integer Количество
stock_id	string or null ID связанного склада
promotion_id	string ID акции, с которой связан удаляемый подарок
promotion_reward_id	string ID подарка акции, с которым связан удаляемый вариант
	Array of objects (ProductModifierInput) Список модификаторов

Responses

Request samples

Payload

Content type

application/json

{"product_variant_id": "b11f7b7f-5f41-4bc2-97fa-7df49225a2ba",
"quantity": 1,
"stock_id": null,
"promotion_id": "7c2efbaf-ed05-4981-9748-b94a1b78ad33",
"promotion_reward_id": "9f5934fb-ed3c-42fe-8dd4-ae3f12699957",
"modifiers": [{"modifier_id": "ed4df70c-ee98-487e-b9ce-93ca0369b7ac",
"quantity": 1
},
{"modifier_id": "bdeccb16-bb4a-4f25-9692-729713e2a3ee",
"quantity": 2,
"modifiers_group_id": "f04b5da0-c29f-4983-8786-d32429537b53"
}
]
}

Response samples

Content type

application/json

{"data": {"id": "string",
"token": "string",
"can_cancel": true,
"number": "string",
"delivery_method": "delivery",
"total_price": 0,
"original_total_price": 0,
"discount": {"difference": 0,
"percentage": 0
},
"notes": "string",
"created_at": "2019-08-24T14:15:22Z",
"submitted_at": "2019-08-24T14:15:22Z",
"deliver_at": "2019-08-24T14:15:22Z",
"meta_data": {"deliver_at": "string",
"on_premise": {"table": "string"
}
},
"status": {"id": "string",
"kind": "awaiting_delivery",
"name": "string",
"transitioned_at": "2019-08-24T14:15:22Z"
},
"variants": [{"id": "string",
"product_id": "string",
"product_variant_id": "string",
"stock_id": "string",
"promotion": {"id": "string",
"reward_id": "string"
},
"promocode_id": "string",
"is_reward": true,
"is_promocode_reward": true,
"quantity": 0,
"has_measured_quantity": true,
"measured_quantity": 0.1,
"total_price": 0,
"original_total_price": 0,
"unit_price": 0,
"original_unit_price": 0,
"discount": {"difference": 0,
"percentage": 0
},
"modifiers_hash": "string",
"product": {"id": "92766ffe-2d0e-4f67-87fe-35312f545b30",
"short_id": "92766ffe2d0e45b3",
"slug": "iphone-12-pro",
"name": "iPhone 12 Pro",
"description": "A14 Bionic, самый быстрый процессор iPhone. Дисплей OLED от края до края. Передняя панель Ceramic Shield, которая в четыре раза снижает риск повреждений дисплея при падении. И Ночной режим на всех камерах. Всё это есть в iPhone 12. В двух размерах.",
"unit_type": "piece",
"weight": 187,
"nutrition_facts": {"calories": 100,
"proteins": 2.5,
"fats": 3.5,
"carbohydrates": 13
},
"quantity_step": 0.4,
"is_promotion_reward": false,
"categories": [{"id": "961172f7-ac30-43d5-9687-6ab70c13790b",
"short_id": "961172f7ac303790",
"parent_id": "998f217c-5470-477c-870c-b3c768afecf0",
"is_featured": false,
"slug": "smartfony",
"name": "Смартфоны",
"description": null,
"cover": {"placeholder": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"medium": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"large": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"xlarge": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"hd": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
}
},
"seo": {"title": "Смартфоны: цены, большой каталог, новинки",
"description": "Большой ассортимент электроники, цифровой и бытовой техники, а так же товаров для дома.",
"meta": [{"name": {"attribute": "name",
"value": "description"
},
"value": {"attribute": "content",
"value": "Большой ассортимент электроники, цифровой и бытовой техники, а так же товаров для дома."
}
},
{"name": {"attribute": "name",
"value": "og:image"
},
"value": {"attribute": "content",
"value": "https://assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg"
}
},
{"name": {"attribute": "name",
"value": "name"
},
"value": {"attribute": "content",
"value": "width=device-width, initial-scale=1"
},
"additional": [{"attribute": "id",
"value": "viewport"
}
]
}
]
}
}
],
"images": [{"placeholder": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"medium": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"large": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"xlarge": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"hd": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
}
}
],
"custom_fields": [{"id": "brand",
"name": "Производитель",
"type": "text",
"value": "Apple, Inc."
}
],
"variants": [{"id": "92766ffe-4265-4836-a8b4-92f64b090d97",
"sku": "IPHONE12-25",
"barcode": "IPHONE12-25",
"name": "iPhone 12 Pro Белый 128 ГБ",
"nutrition_facts": {"calories": 100,
"proteins": 2.5,
"fats": 3.5,
"carbohydrates": 13
},
"price": 0,
"original_price": 9999000,
"discount": {"difference": 1999800,
"percentage": 20
},
"default_modifiers": { },
"prices": [{"stock_id": null,
"price": 0,
"original_price": 9999000,
"discount": {"difference": 1999800,
"percentage": 20
}
}
],
"dimensions": [{"dimension": "weight",
"type": "netto",
"value": 187
}
],
"custom_fields": [{"id": "brand",
"name": "Производитель",
"type": "text",
"value": "Apple, Inc."
}
],
"remainders": [{"stock_id": "92766ffd-fdf7-44b0-bd51-0755d0aa027c",
"quantity": 10,
"label": "Мало"
}
],
"options": [{"id": "95e15ded-7fd0-4d30-900e-32f8cf0e4549",
"name": "Цвет",
"type": "color",
"value": {"id": "95e15ded-81eb-4d36-90d2-4de607140840",
"name": "Золотой",
"color": "#F9E5C9"
}
}
]
}
],
"features": [{"id": "92766ffd-f182-48ca-a4ae-6e4ccc3a243e",
"alias": "a243",
"name": "Размер дисплея",
"filterable": true,
"type": "range",
"range": "float",
"values": [{"id": "92766ffd-f182-48ca-a4ae-6e4ccc3a243e",
"alias": "a243",
"name": "Размер дисплея",
"range": "float"
}
]
}
],
"features_groups": [{"id": "96546cb3-ec0f-454e-83f8-711cc815c27c",
"name": "Внешний вид",
"description": "Внешний вид устройств.",
"features": [{"id": "92766ffd-f182-48ca-a4ae-6e4ccc3a243e",
"alias": "a243",
"name": "Размер дисплея",
"filterable": true,
"type": "range",
"range": "float",
"values": [null
]
}
]
}
],
"modifiers": [{"modifier": {"id": "92861b69-93c4-4c4e-991c-487c329d105d",
"sku": "string",
"name": "Подарочная упаковка",
"price": 0,
"cover": {"placeholder": {"url": null,
"width": null,
"height": null
},
"medium": {"url": null,
"width": null,
"height": null
},
"large": {"url": null,
"width": null,
"height": null
},
"xlarge": {"url": null,
"width": null,
"height": null
},
"hd": {"url": null,
"width": null,
"height": null
}
}
},
"is_required": false,
"min_quantity": 0,
"max_quantity": 1
}
],
"modifiers_groups": [{"group": {"id": "92861bd9-2809-43f9-a7c3-78d0e5bc6e33",
"name": "План Apple Care",
"modifiers": [{"id": null,
"sku": null,
"name": null,
"price": null,
"cover": null
}
]
},
"is_required": false,
"min_quantity": 0,
"max_quantity": 1
}
],
"seo": {"title": "Смартфоны: цены, большой каталог, новинки",
"description": "Большой ассортимент электроники, цифровой и бытовой техники, а так же товаров для дома.",
"meta": [{"name": {"attribute": "name",
"value": "description"
},
"value": {"attribute": "content",
"value": "Большой ассортимент электроники, цифровой и бытовой техники, а так же товаров для дома."
}
},
{"name": {"attribute": "name",
"value": "og:image"
},
"value": {"attribute": "content",
"value": "https://assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg"
}
},
{"name": {"attribute": "name",
"value": "name"
},
"value": {"attribute": "content",
"value": "width=device-width, initial-scale=1"
},
"additional": [{"attribute": "id",
"value": "viewport"
}
]
}
]
}
},
"variant": {"id": "92766ffe-4265-4836-a8b4-92f64b090d97",
"sku": "IPHONE12-25",
"barcode": "IPHONE12-25",
"name": "iPhone 12 Pro Белый 128 ГБ",
"nutrition_facts": {"calories": 100,
"proteins": 2.5,
"fats": 3.5,
"carbohydrates": 13
},
"price": 0,
"original_price": 9999000,
"discount": {"difference": 1999800,
"percentage": 20
},
"default_modifiers": { },
"prices": [{"stock_id": null,
"price": 0,
"original_price": 9999000,
"discount": {"difference": 1999800,
"percentage": 20
}
}
],
"dimensions": [{"dimension": "weight",
"type": "netto",
"value": 187
}
],
"custom_fields": [{"id": "brand",
"name": "Производитель",
"type": "text",
"value": "Apple, Inc."
}
],
"remainders": [{"stock_id": "92766ffd-fdf7-44b0-bd51-0755d0aa027c",
"quantity": 10,
"label": "Мало"
}
],
"options": [{"id": "95e15ded-7fd0-4d30-900e-32f8cf0e4549",
"name": "Цвет",
"type": "color",
"value": {"id": "95e15ded-81eb-4d36-90d2-4de607140840",
"name": "Золотой",
"color": "#F9E5C9"
}
}
]
},
"modifiers": [{"id": "string",
"modifiers_group_id": "string",
"quantity": 0,
"total_price": 0,
"unit_price": 0,
"original_price": 0,
"original_unit_price": 0,
"modifier": {"id": "92861b69-93c4-4c4e-991c-487c329d105d",
"sku": "string",
"name": "Подарочная упаковка",
"price": 0,
"cover": {"placeholder": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"medium": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"large": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"xlarge": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"hd": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
}
}
},
"modifiers_group": {"id": "92861bd9-2809-43f9-a7c3-78d0e5bc6e33",
"name": "План Apple Care"
}
}
]
}
],
"city": {"id": "9275c4be-44de-49d8-a308-d1322a8efa08",
"is_default": true,
"name": "Улан-Удэ",
"timezone": "Asia/Irkutsk",
"coordinates": {"latitude": 51.8121373,
"longitude": 107.6641822
},
"schedule": {"is_open_now": false,
"opening_at": "2023-06-20T10:00:00+08:00:00",
"closing_at": "2023-06-20T20:00:00+08:00:00",
"day_id": "friday",
"days": {"monday": {"hours": "10:00-19:00"
},
"tuesday": {"hours": "10:00-19:00"
},
"wednesday": {"hours": "10:00-19:00"
},
"thursday": {"hours": "10:00-19:00"
},
"friday": {"hours": "10:00-19:00"
},
"saturday": {"hours": "10:00-19:00"
},
"sunday": {"hours": "10:00-19:00"
}
}
},
"stocks": [{"id": "9655d648-9ed3-4fee-94fa-4a7bc807e5c7",
"name": "ТРК «Еврозона»",
"description": null,
"address": "г Улан-Удэ, ул Балтахинова, д 13",
"coordinates": {"latitude": 51.8121373,
"longitude": 107.6641822
},
"links": [{"type": "twitter",
"value": "https://instagram.com/zenky.io"
}
],
"phones": [{"country": "RU",
"number": "+79641234567",
"national": "+7 (964) 123-45-67"
}
],
"schedule": {"is_open_now": false,
"opening_at": "2023-06-20T10:00:00+08:00:00",
"closing_at": "2023-06-20T20:00:00+08:00:00",
"day_id": "friday",
"days": {"monday": {"hours": "10:00-19:00"
},
"tuesday": {"hours": "10:00-19:00"
},
"wednesday": {"hours": "10:00-19:00"
},
"thursday": {"hours": "10:00-19:00"
},
"friday": {"hours": "10:00-19:00"
},
"saturday": {"hours": "10:00-19:00"
},
"sunday": {"hours": "10:00-19:00"
}
}
}
}
],
"delivery_zones": [{"id": "96ad06d6-4c2b-4671-9f03-77e0544bbf14",
"name": "Первая зона",
"coordinates": [{"latitude": 51.86046585577859,
"longitude": 107.51617115746944
},
{"latitude": 51.869045905165855,
"longitude": 107.64526460749036
},
{"latitude": 51.81444475690688,
"longitude": 107.66697977167492
},
{"latitude": 51.80646099581586,
"longitude": 107.59888650849196
},
{"latitude": 51.80869899574977,
"longitude": 107.52450082880388
},
{"latitude": 51.86046585577859,
"longitude": 107.51617115746944
}
],
"description": "Первая зона доставки",
"color": "#ee44d7",
"min_price": 100000,
"free_delivery_price": 20000000,
"delivery_price": 2000000,
"delivery_time": "1 час"
}
]
},
"stock": {"id": "9655d648-9ed3-4fee-94fa-4a7bc807e5c7",
"name": "ТРК «Еврозона»",
"description": null,
"address": "г Улан-Удэ, ул Балтахинова, д 13",
"coordinates": {"latitude": 51.8121373,
"longitude": 107.6641822
},
"links": [{"type": "twitter",
"value": "https://instagram.com/zenky.io"
}
],
"phones": [{"country": "RU",
"number": "+79641234567",
"national": "+7 (964) 123-45-67"
}
],
"schedule": {"is_open_now": false,
"opening_at": "2023-06-20T10:00:00+08:00:00",
"closing_at": "2023-06-20T20:00:00+08:00:00",
"day_id": "friday",
"days": {"monday": {"hours": "10:00-19:00"
},
"tuesday": {"hours": "10:00-19:00"
},
"wednesday": {"hours": "10:00-19:00"
},
"thursday": {"hours": "10:00-19:00"
},
"friday": {"hours": "10:00-19:00"
},
"saturday": {"hours": "10:00-19:00"
},
"sunday": {"hours": "10:00-19:00"
}
}
}
},
"customer": {"id": "95e340eb-526c-4e8d-be07-026f944bb20f",
"store_profile_id": "95e340ef-b08c-4cd3-903d-15e22c488ad3",
"order_count": 0,
"orders_total_price": 0,
"first_name": "Иван",
"last_name": "Иванов",
"phone": {"country": "RU",
"number": "+79641234567",
"national": "+7 (964) 123-45-67"
},
"gender": "female",
"birth_date": "2019-08-24T14:15:22Z",
"registered_at": "2019-08-24T14:15:22Z",
"loyalty": {"referral_program": {"code": "EntertainingBlondKite",
"join_url": "https://promo.example.org/join/EntertainingBlondKite",
"invite_url": "https://promo.example.org/invite/EntertainingBlondKite"
},
"balance": 0,
"expenses": 0,
"bonuses_level": {"id": "94494cd1-f719-48ff-bd20-5b7d63f39153",
"name": "Пятый",
"expenses": 0,
"rates": {"cashback": 0,
"payment": 0
}
},
"rates": {"cashback": 0,
"payment": 0
}
},
"settings": {"onesignal_id": "a121bb68-72a6-4d4a-ac5b-4877b09f6632",
"device_id": "245CD19D-93AB-486F-89DE-C2B1156151B0",
"device_token": "9ba072e0ee65c50a5059342fc16137f80d560301dd9400b145441a17ff1a3e8b",
"device_os": "ios",
"barcode": {"content": "0000584720791",
"url": "https://api.zenky.io/v3/media/barcode?content=MDAwMDU4NDcyMDc5MQ==&input=base64"
},
"qrcode": {"content": "0000584720791",
"url": "https://api.zenky.io/v3/media/qrcode?content=aHR0cHM6Ly93d3cueW91dHViZS5jb20vd2F0Y2g/dj1kUXc0dzlXZ1hjUQ==&input=base64"
}
},
"avatar": {"placeholder": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"medium": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"large": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"xlarge": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"hd": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
}
}
},
"delivery_address": {"id": "93e6151c-57ed-41f4-ab75-4c64898f9696",
"resolver": "dadata",
"name": "Домашний адрес",
"address": "г Улан-Удэ, ул Жердева, д 104Б",
"coordinates": {"latitude": 51.8121373,
"longitude": 107.6641822
},
"country": "Россия",
"city": "Улан-Удэ",
"settlement": "113-й",
"street": "Жердева",
"house": "104Б",
"block": 1,
"apartment": "офис 505",
"entrance": "1",
"floor": "цокольный",
"has_intercom": true
},
"delivery_zone": {"id": "96ad06d6-4c2b-4671-9f03-77e0544bbf14",
"name": "Первая зона",
"coordinates": [{"latitude": 51.86046585577859,
"longitude": 107.51617115746944
},
{"latitude": 51.869045905165855,
"longitude": 107.64526460749036
},
{"latitude": 51.81444475690688,
"longitude": 107.66697977167492
},
{"latitude": 51.80646099581586,
"longitude": 107.59888650849196
},
{"latitude": 51.80869899574977,
"longitude": 107.52450082880388
},
{"latitude": 51.86046585577859,
"longitude": 107.51617115746944
}
],
"description": "Первая зона доставки",
"color": "#ee44d7",
"min_price": 100000,
"free_delivery_price": 20000000,
"delivery_price": 2000000,
"delivery_time": "1 час"
},
"statuses": [{"id": "string",
"kind": "awaiting_delivery",
"name": "string",
"transitioned_at": "2019-08-24T14:15:22Z"
}
],
"progress": [{"id": "string",
"kind": "awaiting_delivery",
"name": "string",
"transitioned_at": "2019-08-24T14:15:22Z"
}
],
"payments": [{"id": "string",
"type": "payment",
"status": "pending",
"method": "bonuses",
"amount": 0,
"created_at": "2019-08-24T14:15:22Z",
"confirmed_at": "2019-08-24T14:15:22Z",
"authorization_confirmed_at": "2019-08-24T14:15:22Z",
"cancelled_at": "2019-08-24T14:15:22Z",
"refunded_at": "2019-08-24T14:15:22Z",
"refund_failed_at": "2019-08-24T14:15:22Z",
"transaction_meta": {"change": 0,
"bill": 0
}
}
],
"delivery_interval": {"id": "9a661517-6b81-4428-a47d-bb4406885a12",
"date": {"iso": "2023-11-05",
"date": "05.11.2023"
},
"start_time": "10:00",
"end_time": "11:59"
},
"promocode": {"type": "plain",
"promocode": "EXAMPLE",
"message": "Спасибо! Ваш промокод будет передан оператору."
}
}
}

Проверить актуальность корзины

Этот метод позволяет проверить актуальность корзины по следующим параметрам:

Корректность цен. Если у товаров из корзины изменилась цена, проблемные товары могут быть удалены;
Полное наличие остатков. Если какие-либо товары в корзине отсутствуют в полном составе на складах (в зависмости от настроек магазина), проблемные товары могут быть удалены;
Недоступность товаров. Если у каких-либо товаров была отключена возможность заказа, проблемые товары могут быть удалены.

В зависимости от настроек магазина, в поле action будет строка none (корзина не менялась) либо cleanup (проблемые товары были удалены). Если произошло удаление товаров, вам следует перезагрузить весь заказ и уведомить покупателя, что состав корзины изменился.

path Parameters

store required	string ID магазина
order required	string ID заказа

query Parameters

token

string

Токен заказа (для неаутентифицированных запросов)

Responses

Response samples

Content type

application/json

{"data": {"order_variants": [{"id": "97ee0657-13fb-40b1-b700-b994e64f94af",
"product_variant_id": "96560b2f-6bd3-4a1e-8a3d-b491bab09892",
"quantity": 1,
"reasons": ["price_mismatch",
"out_of_stock"
]
}
],
"action": "none"
}
}

Получить список рекомендованных товаров для заказа

Этот метод возвращает рекомендации на основе товаров, которые уже добавлены в заказ.

Для доступа к заказу можно передать его токен в параметре token. Если токен не передан и запрос выполняется без аутентификации покупателя, метод завершится ошибкой.

Пагинация для этого метода не используется.

Этот метод поддерживает следующие включения:

Включение	Описание
`categories.cover`	Категории и обложки
`categories.seo`	Категории и SEO
`features`	Характеристики
`features_groups`	Группы характеристик
`modifiers`	Модификаторы
`modifiers_groups`	Группы модификаторов
`variants`	Варианты товара
`variants.prices`	Варианты и цены
`variants.dimensions`	Варианты и габариты
`variants.remainders`	Варианты и остатки
`variants.options`	Варианты, опции вариантов и их значения
`seo`	SEO

path Parameters

store required	string ID магазина
order required	string ID заказа

query Parameters

with	string Список включений
token	string Токен заказа (для неаутентифицированных запросов)
count	number [ 1 .. 20 ] Default: 10 Количество рекомендаций
city_id	string ID города (несовместим с `stock_id`)
stock_id	string ID склада (несовместим с `city_id`)

Responses

Response samples

Content type

application/json

{"data": [{"id": "92766ffe-2d0e-4f67-87fe-35312f545b30",
"short_id": "92766ffe2d0e45b3",
"slug": "iphone-12-pro",
"name": "iPhone 12 Pro",
"description": "A14 Bionic, самый быстрый процессор iPhone. Дисплей OLED от края до края. Передняя панель Ceramic Shield, которая в четыре раза снижает риск повреждений дисплея при падении. И Ночной режим на всех камерах. Всё это есть в iPhone 12. В двух размерах.",
"unit_type": "piece",
"weight": 187,
"nutrition_facts": {"calories": 100,
"proteins": 2.5,
"fats": 3.5,
"carbohydrates": 13
},
"quantity_step": 0.4,
"is_promotion_reward": false,
"categories": [{"id": "961172f7-ac30-43d5-9687-6ab70c13790b",
"short_id": "961172f7ac303790",
"parent_id": "998f217c-5470-477c-870c-b3c768afecf0",
"is_featured": false,
"slug": "smartfony",
"name": "Смартфоны",
"description": null,
"cover": {"placeholder": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"medium": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"large": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"xlarge": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"hd": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
}
},
"seo": {"title": "Смартфоны: цены, большой каталог, новинки",
"description": "Большой ассортимент электроники, цифровой и бытовой техники, а так же товаров для дома.",
"meta": [{"name": {"attribute": "name",
"value": "description"
},
"value": {"attribute": "content",
"value": "Большой ассортимент электроники, цифровой и бытовой техники, а так же товаров для дома."
}
},
{"name": {"attribute": "name",
"value": "og:image"
},
"value": {"attribute": "content",
"value": "https://assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg"
}
},
{"name": {"attribute": "name",
"value": "name"
},
"value": {"attribute": "content",
"value": "width=device-width, initial-scale=1"
},
"additional": [{"attribute": "id",
"value": "viewport"
}
]
}
]
}
}
],
"images": [{"placeholder": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"medium": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"large": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"xlarge": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"hd": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
}
}
],
"custom_fields": [{"id": "brand",
"name": "Производитель",
"type": "text",
"value": "Apple, Inc."
}
],
"variants": [{"id": "92766ffe-4265-4836-a8b4-92f64b090d97",
"sku": "IPHONE12-25",
"barcode": "IPHONE12-25",
"name": "iPhone 12 Pro Белый 128 ГБ",
"nutrition_facts": {"calories": 100,
"proteins": 2.5,
"fats": 3.5,
"carbohydrates": 13
},
"price": 0,
"original_price": 9999000,
"discount": {"difference": 1999800,
"percentage": 20
},
"default_modifiers": { },
"prices": [{"stock_id": null,
"price": 0,
"original_price": 9999000,
"discount": {"difference": 1999800,
"percentage": 20
}
}
],
"dimensions": [{"dimension": "weight",
"type": "netto",
"value": 187
}
],
"custom_fields": [{"id": "brand",
"name": "Производитель",
"type": "text",
"value": "Apple, Inc."
}
],
"remainders": [{"stock_id": "92766ffd-fdf7-44b0-bd51-0755d0aa027c",
"quantity": 10,
"label": "Мало"
}
],
"options": [{"id": "95e15ded-7fd0-4d30-900e-32f8cf0e4549",
"name": "Цвет",
"type": "color",
"value": {"id": "95e15ded-81eb-4d36-90d2-4de607140840",
"name": "Золотой",
"color": "#F9E5C9"
}
}
]
}
],
"features": [{"id": "92766ffd-f182-48ca-a4ae-6e4ccc3a243e",
"alias": "a243",
"name": "Размер дисплея",
"filterable": true,
"type": "range",
"range": "float",
"values": [{"id": "92766ffd-f182-48ca-a4ae-6e4ccc3a243e",
"alias": "a243",
"name": "Размер дисплея",
"range": "float"
}
]
}
],
"features_groups": [{"id": "96546cb3-ec0f-454e-83f8-711cc815c27c",
"name": "Внешний вид",
"description": "Внешний вид устройств.",
"features": [{"id": "92766ffd-f182-48ca-a4ae-6e4ccc3a243e",
"alias": "a243",
"name": "Размер дисплея",
"filterable": true,
"type": "range",
"range": "float",
"values": [{"id": "92766ffd-f182-48ca-a4ae-6e4ccc3a243e",
"alias": "a243",
"name": "Размер дисплея",
"range": "float"
}
]
}
]
}
],
"modifiers": [{"modifier": {"id": "92861b69-93c4-4c4e-991c-487c329d105d",
"sku": "string",
"name": "Подарочная упаковка",
"price": 0,
"cover": {"placeholder": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"medium": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"large": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"xlarge": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"hd": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
}
}
},
"is_required": false,
"min_quantity": 0,
"max_quantity": 1
}
],
"modifiers_groups": [{"group": {"id": "92861bd9-2809-43f9-a7c3-78d0e5bc6e33",
"name": "План Apple Care",
"modifiers": [{"id": "92861b69-93c4-4c4e-991c-487c329d105d",
"sku": "string",
"name": "Подарочная упаковка",
"price": 0,
"cover": {"placeholder": {"url": null,
"width": null,
"height": null
},
"medium": {"url": null,
"width": null,
"height": null
},
"large": {"url": null,
"width": null,
"height": null
},
"xlarge": {"url": null,
"width": null,
"height": null
},
"hd": {"url": null,
"width": null,
"height": null
}
}
}
]
},
"is_required": false,
"min_quantity": 0,
"max_quantity": 1
}
],
"seo": {"title": "Смартфоны: цены, большой каталог, новинки",
"description": "Большой ассортимент электроники, цифровой и бытовой техники, а так же товаров для дома.",
"meta": [{"name": {"attribute": "name",
"value": "description"
},
"value": {"attribute": "content",
"value": "Большой ассортимент электроники, цифровой и бытовой техники, а так же товаров для дома."
}
},
{"name": {"attribute": "name",
"value": "og:image"
},
"value": {"attribute": "content",
"value": "https://assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg"
}
},
{"name": {"attribute": "name",
"value": "name"
},
"value": {"attribute": "content",
"value": "width=device-width, initial-scale=1"
},
"additional": [{"attribute": "id",
"value": "viewport"
}
]
}
]
}
}
]
}

Программа лояльности

Получить список транзакций заказа

path Parameters

store required	string ID магазина
order required	string ID заказа

query Parameters

count	integer Количество записей
page	integer Номер страницы
token	string Токен заказа (для неаутентифицированных запросов)
type	string (BonusesTransactionDirection) Enum: "decrease" "increase" Тип транзакции (`increase` – пополнение, `decrease` – списание)
status	string (BonusesTransactionStatusFilter) Enum: "cancelled" "confirmed" "pending" "refunded" Статус транзакции (`pending` – ожидает подтверждения, `confirmed` – подтверждена, `cancelled` – отменена, `refunded` – возвращена).
reason	string (BonusesTransactionReason) Enum: "adjustment" "cancellation" "cashback" "external" "manual" "payment" "promotion_reward" "recruit_reward" "referral_reward" "refund" "welcome_bonuses" Причина создания транзакции

Responses

Response samples

Content type

application/json

{"data": [{"id": "string",
"order_id": "string",
"type": "decrease",
"status": "cancelled",
"reason": "adjustment",
"amount": 0,
"source_amount": 0,
"created_at": "2019-08-24T14:15:22Z",
"confirmed_at": "2019-08-24T14:15:22Z",
"cancelled_at": "2019-08-24T14:15:22Z"
}
]
}

Получить транзакцию кэшбэка для заказа

path Parameters

store required	string ID магазина
order required	string ID заказа

query Parameters

token

string

Токен заказа (для неаутентифицированных запросов)

Responses

Response samples

Content type

application/json

{"data": {"id": "string",
"order_id": "string",
"type": "decrease",
"status": "cancelled",
"reason": "adjustment",
"amount": 0,
"source_amount": 0,
"created_at": "2019-08-24T14:15:22Z",
"confirmed_at": "2019-08-24T14:15:22Z",
"cancelled_at": "2019-08-24T14:15:22Z"
}
}

Запустить проверку выполненных акций

Этот метод запускает фоновую проверку акций, а результат проверки отправляет в вебсокет-соединение событиями orders.promotions.not_found (если у заказа не выполнены условия ни для одной акции) или orders.rewards.display_selection (если покупателю доступен выбор товаров в качестве подарка).

Так же после запуска проверки вы можете получить событие orders.rewards.reload, после чего нужно перезагрузить список подарков (или весь заказ, если вам так удобнее). Это событие может быть отправлено, если покупатель получил подарок в виде бонусов (фактически бонусы будут начислены только после выполнения заказа).

path Parameters

store required	string ID магазина
order required	string ID заказа

query Parameters

token

string

Токен заказа (для неаутентифицированных запросов)

Responses

Response samples

Content type

application/json

{"data": {"dispatched": true
}
}

Получить список выбранных наград за акции

path Parameters

store required	string ID магазина
order required	string ID заказа

query Parameters

token

string

Токен заказа (для неаутентифицированных запросов)

Responses

Response samples

Content type

application/json

{"data": [{"id": "96f18eff-6320-4109-b196-a6c64c9a0a85",
"promotion_id": "97f9d364-0b87-4d8b-9b70-3c65fafb8771",
"promotion_reward_id": "96478542-f5bf-4fc9-b993-feca49f27ca8",
"item_id": null,
"amount": 50000,
"total_amount": 150000,
"count": 3
}
]
}

Информация о заказе

Сводка о заказе

path Parameters

store required	string ID магазина
order required	string ID заказа

query Parameters

token

string

Токен заказа (для неаутентифицированных запросов)

Responses

Response samples

Content type

application/json

{"data": {"min_price": 0,
"subtotal": 0,
"original_subtotal": 0,
"delivery_price": 0,
"delivery_discount": 0,
"promocode_discount": 0,
"discount": 0,
"total": 0,
"original_total": 0,
"max_bonuses_payment": 0,
"service_fee": 0,
"cashback": 0,
"payments": [{"id": "string",
"method": "string",
"name": "string",
"amount": 0,
"bill": 0,
"change": 0,
"save_card": true,
"card_token_id": "string"
}
]
}
}

Покупатель

Привязать покупателя к заказу

path Parameters

store required	string ID магазина
order required	string ID заказа

query Parameters

token

string

Токен заказа (для неаутентифицированных запросов)

Request Body schema: application/json
required

	object Телефон покупателя (обязателен, если нет токена аутентификации)
first_name	string Имя покупателя
last_name	string Фамилия покупателя
gender	string (CustomerGenderType) Enum: "female" "male" "other" Пол покупателя
birth_date	string Дата рождения покупателя (в формате `YYYY-MM-DD`)

Responses

Request samples

Payload

Content type

application/json

{"phone": {"number": "+7 (964) 123-45-67",
"country": "RU"
},
"first_name": "Иван",
"gender": "male",
"birth_date": "1991-09-20"
}

Response samples

Content type

application/json

{"error": {"message": "У вас нет доступа к этому магазину.",
"original_message": "You have no access to this store.",
"http_code": 403,
"error_code": "store.access_denied"
}
}

Способ доставки

Указать способ доставки заказа

path Parameters

store required	string ID магазина
order required	string ID заказа

query Parameters

token

string

Токен заказа (для неаутентифицированных запросов)

Request Body schema: application/json
required

delivery_method required	string (DeliveryMethodKind) Enum: "delivery" "on_premise" "pickup" Способ доставки
	object Адрес доставки (обязателен, если `delivery_method` – `delivery`)
stock_id	string ID склада (обязателен, если `delivery_method` – `pickup` или `on_premise`)
	object Информация о заказе в заведении (обязателен, если `delivery_method` – `on_premise`)
deliver_at	string Дата отложенной доставки в часовом поясе города (в формате `YYYY-MM-DD HH:MM`)
	object Интервал доставки

Responses

Request samples

Payload

Content type

application/json

{"delivery_method": "delivery",
"delivery_address": {"address": "г. Улан-Удэ, ул. Балтахинова, д. 13",
"apartment": "1024",
"floor": "10",
"entrance": "1",
"has_intercom": false,
"intercom_code": null
},
"deliver_at": "2021-07-20 19:00"
}

Response samples

Content type

application/json

{"data": {"id": "string",
"token": "string",
"can_cancel": true,
"number": "string",
"delivery_method": "delivery",
"total_price": 0,
"original_total_price": 0,
"discount": {"difference": 0,
"percentage": 0
},
"notes": "string",
"created_at": "2019-08-24T14:15:22Z",
"submitted_at": "2019-08-24T14:15:22Z",
"deliver_at": "2019-08-24T14:15:22Z",
"meta_data": {"deliver_at": "string",
"on_premise": {"table": "string"
}
},
"status": {"id": "string",
"kind": "awaiting_delivery",
"name": "string",
"transitioned_at": "2019-08-24T14:15:22Z"
},
"variants": [{"id": "string",
"product_id": "string",
"product_variant_id": "string",
"stock_id": "string",
"promotion": {"id": "string",
"reward_id": "string"
},
"promocode_id": "string",
"is_reward": true,
"is_promocode_reward": true,
"quantity": 0,
"has_measured_quantity": true,
"measured_quantity": 0.1,
"total_price": 0,
"original_total_price": 0,
"unit_price": 0,
"original_unit_price": 0,
"discount": {"difference": 0,
"percentage": 0
},
"modifiers_hash": "string",
"product": {"id": "92766ffe-2d0e-4f67-87fe-35312f545b30",
"short_id": "92766ffe2d0e45b3",
"slug": "iphone-12-pro",
"name": "iPhone 12 Pro",
"description": "A14 Bionic, самый быстрый процессор iPhone. Дисплей OLED от края до края. Передняя панель Ceramic Shield, которая в четыре раза снижает риск повреждений дисплея при падении. И Ночной режим на всех камерах. Всё это есть в iPhone 12. В двух размерах.",
"unit_type": "piece",
"weight": 187,
"nutrition_facts": {"calories": 100,
"proteins": 2.5,
"fats": 3.5,
"carbohydrates": 13
},
"quantity_step": 0.4,
"is_promotion_reward": false,
"categories": [{"id": "961172f7-ac30-43d5-9687-6ab70c13790b",
"short_id": "961172f7ac303790",
"parent_id": "998f217c-5470-477c-870c-b3c768afecf0",
"is_featured": false,
"slug": "smartfony",
"name": "Смартфоны",
"description": null,
"cover": {"placeholder": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"medium": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"large": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"xlarge": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"hd": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
}
},
"seo": {"title": "Смартфоны: цены, большой каталог, новинки",
"description": "Большой ассортимент электроники, цифровой и бытовой техники, а так же товаров для дома.",
"meta": [{"name": {"attribute": "name",
"value": "description"
},
"value": {"attribute": "content",
"value": "Большой ассортимент электроники, цифровой и бытовой техники, а так же товаров для дома."
}
},
{"name": {"attribute": "name",
"value": "og:image"
},
"value": {"attribute": "content",
"value": "https://assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg"
}
},
{"name": {"attribute": "name",
"value": "name"
},
"value": {"attribute": "content",
"value": "width=device-width, initial-scale=1"
},
"additional": [{"attribute": "id",
"value": "viewport"
}
]
}
]
}
}
],
"images": [{"placeholder": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"medium": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"large": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"xlarge": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"hd": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
}
}
],
"custom_fields": [{"id": "brand",
"name": "Производитель",
"type": "text",
"value": "Apple, Inc."
}
],
"variants": [{"id": "92766ffe-4265-4836-a8b4-92f64b090d97",
"sku": "IPHONE12-25",
"barcode": "IPHONE12-25",
"name": "iPhone 12 Pro Белый 128 ГБ",
"nutrition_facts": {"calories": 100,
"proteins": 2.5,
"fats": 3.5,
"carbohydrates": 13
},
"price": 0,
"original_price": 9999000,
"discount": {"difference": 1999800,
"percentage": 20
},
"default_modifiers": { },
"prices": [{"stock_id": null,
"price": 0,
"original_price": 9999000,
"discount": {"difference": 1999800,
"percentage": 20
}
}
],
"dimensions": [{"dimension": "weight",
"type": "netto",
"value": 187
}
],
"custom_fields": [{"id": "brand",
"name": "Производитель",
"type": "text",
"value": "Apple, Inc."
}
],
"remainders": [{"stock_id": "92766ffd-fdf7-44b0-bd51-0755d0aa027c",
"quantity": 10,
"label": "Мало"
}
],
"options": [{"id": "95e15ded-7fd0-4d30-900e-32f8cf0e4549",
"name": "Цвет",
"type": "color",
"value": {"id": "95e15ded-81eb-4d36-90d2-4de607140840",
"name": "Золотой",
"color": "#F9E5C9"
}
}
]
}
],
"features": [{"id": "92766ffd-f182-48ca-a4ae-6e4ccc3a243e",
"alias": "a243",
"name": "Размер дисплея",
"filterable": true,
"type": "range",
"range": "float",
"values": [{"id": "92766ffd-f182-48ca-a4ae-6e4ccc3a243e",
"alias": "a243",
"name": "Размер дисплея",
"range": "float"
}
]
}
],
"features_groups": [{"id": "96546cb3-ec0f-454e-83f8-711cc815c27c",
"name": "Внешний вид",
"description": "Внешний вид устройств.",
"features": [{"id": "92766ffd-f182-48ca-a4ae-6e4ccc3a243e",
"alias": "a243",
"name": "Размер дисплея",
"filterable": true,
"type": "range",
"range": "float",
"values": [null
]
}
]
}
],
"modifiers": [{"modifier": {"id": "92861b69-93c4-4c4e-991c-487c329d105d",
"sku": "string",
"name": "Подарочная упаковка",
"price": 0,
"cover": {"placeholder": {"url": null,
"width": null,
"height": null
},
"medium": {"url": null,
"width": null,
"height": null
},
"large": {"url": null,
"width": null,
"height": null
},
"xlarge": {"url": null,
"width": null,
"height": null
},
"hd": {"url": null,
"width": null,
"height": null
}
}
},
"is_required": false,
"min_quantity": 0,
"max_quantity": 1
}
],
"modifiers_groups": [{"group": {"id": "92861bd9-2809-43f9-a7c3-78d0e5bc6e33",
"name": "План Apple Care",
"modifiers": [{"id": null,
"sku": null,
"name": null,
"price": null,
"cover": null
}
]
},
"is_required": false,
"min_quantity": 0,
"max_quantity": 1
}
],
"seo": {"title": "Смартфоны: цены, большой каталог, новинки",
"description": "Большой ассортимент электроники, цифровой и бытовой техники, а так же товаров для дома.",
"meta": [{"name": {"attribute": "name",
"value": "description"
},
"value": {"attribute": "content",
"value": "Большой ассортимент электроники, цифровой и бытовой техники, а так же товаров для дома."
}
},
{"name": {"attribute": "name",
"value": "og:image"
},
"value": {"attribute": "content",
"value": "https://assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg"
}
},
{"name": {"attribute": "name",
"value": "name"
},
"value": {"attribute": "content",
"value": "width=device-width, initial-scale=1"
},
"additional": [{"attribute": "id",
"value": "viewport"
}
]
}
]
}
},
"variant": {"id": "92766ffe-4265-4836-a8b4-92f64b090d97",
"sku": "IPHONE12-25",
"barcode": "IPHONE12-25",
"name": "iPhone 12 Pro Белый 128 ГБ",
"nutrition_facts": {"calories": 100,
"proteins": 2.5,
"fats": 3.5,
"carbohydrates": 13
},
"price": 0,
"original_price": 9999000,
"discount": {"difference": 1999800,
"percentage": 20
},
"default_modifiers": { },
"prices": [{"stock_id": null,
"price": 0,
"original_price": 9999000,
"discount": {"difference": 1999800,
"percentage": 20
}
}
],
"dimensions": [{"dimension": "weight",
"type": "netto",
"value": 187
}
],
"custom_fields": [{"id": "brand",
"name": "Производитель",
"type": "text",
"value": "Apple, Inc."
}
],
"remainders": [{"stock_id": "92766ffd-fdf7-44b0-bd51-0755d0aa027c",
"quantity": 10,
"label": "Мало"
}
],
"options": [{"id": "95e15ded-7fd0-4d30-900e-32f8cf0e4549",
"name": "Цвет",
"type": "color",
"value": {"id": "95e15ded-81eb-4d36-90d2-4de607140840",
"name": "Золотой",
"color": "#F9E5C9"
}
}
]
},
"modifiers": [{"id": "string",
"modifiers_group_id": "string",
"quantity": 0,
"total_price": 0,
"unit_price": 0,
"original_price": 0,
"original_unit_price": 0,
"modifier": {"id": "92861b69-93c4-4c4e-991c-487c329d105d",
"sku": "string",
"name": "Подарочная упаковка",
"price": 0,
"cover": {"placeholder": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"medium": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"large": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"xlarge": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"hd": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
}
}
},
"modifiers_group": {"id": "92861bd9-2809-43f9-a7c3-78d0e5bc6e33",
"name": "План Apple Care"
}
}
]
}
],
"city": {"id": "9275c4be-44de-49d8-a308-d1322a8efa08",
"is_default": true,
"name": "Улан-Удэ",
"timezone": "Asia/Irkutsk",
"coordinates": {"latitude": 51.8121373,
"longitude": 107.6641822
},
"schedule": {"is_open_now": false,
"opening_at": "2023-06-20T10:00:00+08:00:00",
"closing_at": "2023-06-20T20:00:00+08:00:00",
"day_id": "friday",
"days": {"monday": {"hours": "10:00-19:00"
},
"tuesday": {"hours": "10:00-19:00"
},
"wednesday": {"hours": "10:00-19:00"
},
"thursday": {"hours": "10:00-19:00"
},
"friday": {"hours": "10:00-19:00"
},
"saturday": {"hours": "10:00-19:00"
},
"sunday": {"hours": "10:00-19:00"
}
}
},
"stocks": [{"id": "9655d648-9ed3-4fee-94fa-4a7bc807e5c7",
"name": "ТРК «Еврозона»",
"description": null,
"address": "г Улан-Удэ, ул Балтахинова, д 13",
"coordinates": {"latitude": 51.8121373,
"longitude": 107.6641822
},
"links": [{"type": "twitter",
"value": "https://instagram.com/zenky.io"
}
],
"phones": [{"country": "RU",
"number": "+79641234567",
"national": "+7 (964) 123-45-67"
}
],
"schedule": {"is_open_now": false,
"opening_at": "2023-06-20T10:00:00+08:00:00",
"closing_at": "2023-06-20T20:00:00+08:00:00",
"day_id": "friday",
"days": {"monday": {"hours": "10:00-19:00"
},
"tuesday": {"hours": "10:00-19:00"
},
"wednesday": {"hours": "10:00-19:00"
},
"thursday": {"hours": "10:00-19:00"
},
"friday": {"hours": "10:00-19:00"
},
"saturday": {"hours": "10:00-19:00"
},
"sunday": {"hours": "10:00-19:00"
}
}
}
}
],
"delivery_zones": [{"id": "96ad06d6-4c2b-4671-9f03-77e0544bbf14",
"name": "Первая зона",
"coordinates": [{"latitude": 51.86046585577859,
"longitude": 107.51617115746944
},
{"latitude": 51.869045905165855,
"longitude": 107.64526460749036
},
{"latitude": 51.81444475690688,
"longitude": 107.66697977167492
},
{"latitude": 51.80646099581586,
"longitude": 107.59888650849196
},
{"latitude": 51.80869899574977,
"longitude": 107.52450082880388
},
{"latitude": 51.86046585577859,
"longitude": 107.51617115746944
}
],
"description": "Первая зона доставки",
"color": "#ee44d7",
"min_price": 100000,
"free_delivery_price": 20000000,
"delivery_price": 2000000,
"delivery_time": "1 час"
}
]
},
"stock": {"id": "9655d648-9ed3-4fee-94fa-4a7bc807e5c7",
"name": "ТРК «Еврозона»",
"description": null,
"address": "г Улан-Удэ, ул Балтахинова, д 13",
"coordinates": {"latitude": 51.8121373,
"longitude": 107.6641822
},
"links": [{"type": "twitter",
"value": "https://instagram.com/zenky.io"
}
],
"phones": [{"country": "RU",
"number": "+79641234567",
"national": "+7 (964) 123-45-67"
}
],
"schedule": {"is_open_now": false,
"opening_at": "2023-06-20T10:00:00+08:00:00",
"closing_at": "2023-06-20T20:00:00+08:00:00",
"day_id": "friday",
"days": {"monday": {"hours": "10:00-19:00"
},
"tuesday": {"hours": "10:00-19:00"
},
"wednesday": {"hours": "10:00-19:00"
},
"thursday": {"hours": "10:00-19:00"
},
"friday": {"hours": "10:00-19:00"
},
"saturday": {"hours": "10:00-19:00"
},
"sunday": {"hours": "10:00-19:00"
}
}
}
},
"customer": {"id": "95e340eb-526c-4e8d-be07-026f944bb20f",
"store_profile_id": "95e340ef-b08c-4cd3-903d-15e22c488ad3",
"order_count": 0,
"orders_total_price": 0,
"first_name": "Иван",
"last_name": "Иванов",
"phone": {"country": "RU",
"number": "+79641234567",
"national": "+7 (964) 123-45-67"
},
"gender": "female",
"birth_date": "2019-08-24T14:15:22Z",
"registered_at": "2019-08-24T14:15:22Z",
"loyalty": {"referral_program": {"code": "EntertainingBlondKite",
"join_url": "https://promo.example.org/join/EntertainingBlondKite",
"invite_url": "https://promo.example.org/invite/EntertainingBlondKite"
},
"balance": 0,
"expenses": 0,
"bonuses_level": {"id": "94494cd1-f719-48ff-bd20-5b7d63f39153",
"name": "Пятый",
"expenses": 0,
"rates": {"cashback": 0,
"payment": 0
}
},
"rates": {"cashback": 0,
"payment": 0
}
},
"settings": {"onesignal_id": "a121bb68-72a6-4d4a-ac5b-4877b09f6632",
"device_id": "245CD19D-93AB-486F-89DE-C2B1156151B0",
"device_token": "9ba072e0ee65c50a5059342fc16137f80d560301dd9400b145441a17ff1a3e8b",
"device_os": "ios",
"barcode": {"content": "0000584720791",
"url": "https://api.zenky.io/v3/media/barcode?content=MDAwMDU4NDcyMDc5MQ==&input=base64"
},
"qrcode": {"content": "0000584720791",
"url": "https://api.zenky.io/v3/media/qrcode?content=aHR0cHM6Ly93d3cueW91dHViZS5jb20vd2F0Y2g/dj1kUXc0dzlXZ1hjUQ==&input=base64"
}
},
"avatar": {"placeholder": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"medium": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"large": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"xlarge": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"hd": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
}
}
},
"delivery_address": {"id": "93e6151c-57ed-41f4-ab75-4c64898f9696",
"resolver": "dadata",
"name": "Домашний адрес",
"address": "г Улан-Удэ, ул Жердева, д 104Б",
"coordinates": {"latitude": 51.8121373,
"longitude": 107.6641822
},
"country": "Россия",
"city": "Улан-Удэ",
"settlement": "113-й",
"street": "Жердева",
"house": "104Б",
"block": 1,
"apartment": "офис 505",
"entrance": "1",
"floor": "цокольный",
"has_intercom": true
},
"delivery_zone": {"id": "96ad06d6-4c2b-4671-9f03-77e0544bbf14",
"name": "Первая зона",
"coordinates": [{"latitude": 51.86046585577859,
"longitude": 107.51617115746944
},
{"latitude": 51.869045905165855,
"longitude": 107.64526460749036
},
{"latitude": 51.81444475690688,
"longitude": 107.66697977167492
},
{"latitude": 51.80646099581586,
"longitude": 107.59888650849196
},
{"latitude": 51.80869899574977,
"longitude": 107.52450082880388
},
{"latitude": 51.86046585577859,
"longitude": 107.51617115746944
}
],
"description": "Первая зона доставки",
"color": "#ee44d7",
"min_price": 100000,
"free_delivery_price": 20000000,
"delivery_price": 2000000,
"delivery_time": "1 час"
},
"statuses": [{"id": "string",
"kind": "awaiting_delivery",
"name": "string",
"transitioned_at": "2019-08-24T14:15:22Z"
}
],
"progress": [{"id": "string",
"kind": "awaiting_delivery",
"name": "string",
"transitioned_at": "2019-08-24T14:15:22Z"
}
],
"payments": [{"id": "string",
"type": "payment",
"status": "pending",
"method": "bonuses",
"amount": 0,
"created_at": "2019-08-24T14:15:22Z",
"confirmed_at": "2019-08-24T14:15:22Z",
"authorization_confirmed_at": "2019-08-24T14:15:22Z",
"cancelled_at": "2019-08-24T14:15:22Z",
"refunded_at": "2019-08-24T14:15:22Z",
"refund_failed_at": "2019-08-24T14:15:22Z",
"transaction_meta": {"change": 0,
"bill": 0
}
}
],
"delivery_interval": {"id": "9a661517-6b81-4428-a47d-bb4406885a12",
"date": {"iso": "2023-11-05",
"date": "05.11.2023"
},
"start_time": "10:00",
"end_time": "11:59"
},
"promocode": {"type": "plain",
"promocode": "EXAMPLE",
"message": "Спасибо! Ваш промокод будет передан оператору."
}
}
}

Интервал доставки

Указать интервал доставки заказа

Используйте этот метод, если интервал доставки невозможно указать вместе со способом доставки (например, если вы запросили у покупателя способ доставки до наполнения корзины).

path Parameters

store required	string ID магазина
order required	string ID заказа

query Parameters

token

string

Токен заказа (для неаутентифицированных запросов)

Request Body schema: application/json
required

object

Интервал доставки

date	string Дата доставки (в формате `YYYY-MM-DD`)
id	string ID интервала доставки

Responses

Request samples

Payload

Content type

application/json

{"delivery_interval": {"date": "2023-11-27",
"id": "9a661517-6c0e-4608-9d1e-65602e9addb0"
}
}

Response samples

Content type

application/json

{"data": {"id": "string",
"token": "string",
"can_cancel": true,
"number": "string",
"delivery_method": "delivery",
"total_price": 0,
"original_total_price": 0,
"discount": {"difference": 0,
"percentage": 0
},
"notes": "string",
"created_at": "2019-08-24T14:15:22Z",
"submitted_at": "2019-08-24T14:15:22Z",
"deliver_at": "2019-08-24T14:15:22Z",
"meta_data": {"deliver_at": "string",
"on_premise": {"table": "string"
}
},
"status": {"id": "string",
"kind": "awaiting_delivery",
"name": "string",
"transitioned_at": "2019-08-24T14:15:22Z"
},
"variants": [{"id": "string",
"product_id": "string",
"product_variant_id": "string",
"stock_id": "string",
"promotion": {"id": "string",
"reward_id": "string"
},
"promocode_id": "string",
"is_reward": true,
"is_promocode_reward": true,
"quantity": 0,
"has_measured_quantity": true,
"measured_quantity": 0.1,
"total_price": 0,
"original_total_price": 0,
"unit_price": 0,
"original_unit_price": 0,
"discount": {"difference": 0,
"percentage": 0
},
"modifiers_hash": "string",
"product": {"id": "92766ffe-2d0e-4f67-87fe-35312f545b30",
"short_id": "92766ffe2d0e45b3",
"slug": "iphone-12-pro",
"name": "iPhone 12 Pro",
"description": "A14 Bionic, самый быстрый процессор iPhone. Дисплей OLED от края до края. Передняя панель Ceramic Shield, которая в четыре раза снижает риск повреждений дисплея при падении. И Ночной режим на всех камерах. Всё это есть в iPhone 12. В двух размерах.",
"unit_type": "piece",
"weight": 187,
"nutrition_facts": {"calories": 100,
"proteins": 2.5,
"fats": 3.5,
"carbohydrates": 13
},
"quantity_step": 0.4,
"is_promotion_reward": false,
"categories": [{"id": "961172f7-ac30-43d5-9687-6ab70c13790b",
"short_id": "961172f7ac303790",
"parent_id": "998f217c-5470-477c-870c-b3c768afecf0",
"is_featured": false,
"slug": "smartfony",
"name": "Смартфоны",
"description": null,
"cover": {"placeholder": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"medium": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"large": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"xlarge": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"hd": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
}
},
"seo": {"title": "Смартфоны: цены, большой каталог, новинки",
"description": "Большой ассортимент электроники, цифровой и бытовой техники, а так же товаров для дома.",
"meta": [{"name": {"attribute": "name",
"value": "description"
},
"value": {"attribute": "content",
"value": "Большой ассортимент электроники, цифровой и бытовой техники, а так же товаров для дома."
}
},
{"name": {"attribute": "name",
"value": "og:image"
},
"value": {"attribute": "content",
"value": "https://assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg"
}
},
{"name": {"attribute": "name",
"value": "name"
},
"value": {"attribute": "content",
"value": "width=device-width, initial-scale=1"
},
"additional": [{"attribute": "id",
"value": "viewport"
}
]
}
]
}
}
],
"images": [{"placeholder": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"medium": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"large": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"xlarge": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"hd": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
}
}
],
"custom_fields": [{"id": "brand",
"name": "Производитель",
"type": "text",
"value": "Apple, Inc."
}
],
"variants": [{"id": "92766ffe-4265-4836-a8b4-92f64b090d97",
"sku": "IPHONE12-25",
"barcode": "IPHONE12-25",
"name": "iPhone 12 Pro Белый 128 ГБ",
"nutrition_facts": {"calories": 100,
"proteins": 2.5,
"fats": 3.5,
"carbohydrates": 13
},
"price": 0,
"original_price": 9999000,
"discount": {"difference": 1999800,
"percentage": 20
},
"default_modifiers": { },
"prices": [{"stock_id": null,
"price": 0,
"original_price": 9999000,
"discount": {"difference": 1999800,
"percentage": 20
}
}
],
"dimensions": [{"dimension": "weight",
"type": "netto",
"value": 187
}
],
"custom_fields": [{"id": "brand",
"name": "Производитель",
"type": "text",
"value": "Apple, Inc."
}
],
"remainders": [{"stock_id": "92766ffd-fdf7-44b0-bd51-0755d0aa027c",
"quantity": 10,
"label": "Мало"
}
],
"options": [{"id": "95e15ded-7fd0-4d30-900e-32f8cf0e4549",
"name": "Цвет",
"type": "color",
"value": {"id": "95e15ded-81eb-4d36-90d2-4de607140840",
"name": "Золотой",
"color": "#F9E5C9"
}
}
]
}
],
"features": [{"id": "92766ffd-f182-48ca-a4ae-6e4ccc3a243e",
"alias": "a243",
"name": "Размер дисплея",
"filterable": true,
"type": "range",
"range": "float",
"values": [{"id": "92766ffd-f182-48ca-a4ae-6e4ccc3a243e",
"alias": "a243",
"name": "Размер дисплея",
"range": "float"
}
]
}
],
"features_groups": [{"id": "96546cb3-ec0f-454e-83f8-711cc815c27c",
"name": "Внешний вид",
"description": "Внешний вид устройств.",
"features": [{"id": "92766ffd-f182-48ca-a4ae-6e4ccc3a243e",
"alias": "a243",
"name": "Размер дисплея",
"filterable": true,
"type": "range",
"range": "float",
"values": [null
]
}
]
}
],
"modifiers": [{"modifier": {"id": "92861b69-93c4-4c4e-991c-487c329d105d",
"sku": "string",
"name": "Подарочная упаковка",
"price": 0,
"cover": {"placeholder": {"url": null,
"width": null,
"height": null
},
"medium": {"url": null,
"width": null,
"height": null
},
"large": {"url": null,
"width": null,
"height": null
},
"xlarge": {"url": null,
"width": null,
"height": null
},
"hd": {"url": null,
"width": null,
"height": null
}
}
},
"is_required": false,
"min_quantity": 0,
"max_quantity": 1
}
],
"modifiers_groups": [{"group": {"id": "92861bd9-2809-43f9-a7c3-78d0e5bc6e33",
"name": "План Apple Care",
"modifiers": [{"id": null,
"sku": null,
"name": null,
"price": null,
"cover": null
}
]
},
"is_required": false,
"min_quantity": 0,
"max_quantity": 1
}
],
"seo": {"title": "Смартфоны: цены, большой каталог, новинки",
"description": "Большой ассортимент электроники, цифровой и бытовой техники, а так же товаров для дома.",
"meta": [{"name": {"attribute": "name",
"value": "description"
},
"value": {"attribute": "content",
"value": "Большой ассортимент электроники, цифровой и бытовой техники, а так же товаров для дома."
}
},
{"name": {"attribute": "name",
"value": "og:image"
},
"value": {"attribute": "content",
"value": "https://assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg"
}
},
{"name": {"attribute": "name",
"value": "name"
},
"value": {"attribute": "content",
"value": "width=device-width, initial-scale=1"
},
"additional": [{"attribute": "id",
"value": "viewport"
}
]
}
]
}
},
"variant": {"id": "92766ffe-4265-4836-a8b4-92f64b090d97",
"sku": "IPHONE12-25",
"barcode": "IPHONE12-25",
"name": "iPhone 12 Pro Белый 128 ГБ",
"nutrition_facts": {"calories": 100,
"proteins": 2.5,
"fats": 3.5,
"carbohydrates": 13
},
"price": 0,
"original_price": 9999000,
"discount": {"difference": 1999800,
"percentage": 20
},
"default_modifiers": { },
"prices": [{"stock_id": null,
"price": 0,
"original_price": 9999000,
"discount": {"difference": 1999800,
"percentage": 20
}
}
],
"dimensions": [{"dimension": "weight",
"type": "netto",
"value": 187
}
],
"custom_fields": [{"id": "brand",
"name": "Производитель",
"type": "text",
"value": "Apple, Inc."
}
],
"remainders": [{"stock_id": "92766ffd-fdf7-44b0-bd51-0755d0aa027c",
"quantity": 10,
"label": "Мало"
}
],
"options": [{"id": "95e15ded-7fd0-4d30-900e-32f8cf0e4549",
"name": "Цвет",
"type": "color",
"value": {"id": "95e15ded-81eb-4d36-90d2-4de607140840",
"name": "Золотой",
"color": "#F9E5C9"
}
}
]
},
"modifiers": [{"id": "string",
"modifiers_group_id": "string",
"quantity": 0,
"total_price": 0,
"unit_price": 0,
"original_price": 0,
"original_unit_price": 0,
"modifier": {"id": "92861b69-93c4-4c4e-991c-487c329d105d",
"sku": "string",
"name": "Подарочная упаковка",
"price": 0,
"cover": {"placeholder": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"medium": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"large": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"xlarge": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"hd": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
}
}
},
"modifiers_group": {"id": "92861bd9-2809-43f9-a7c3-78d0e5bc6e33",
"name": "План Apple Care"
}
}
]
}
],
"city": {"id": "9275c4be-44de-49d8-a308-d1322a8efa08",
"is_default": true,
"name": "Улан-Удэ",
"timezone": "Asia/Irkutsk",
"coordinates": {"latitude": 51.8121373,
"longitude": 107.6641822
},
"schedule": {"is_open_now": false,
"opening_at": "2023-06-20T10:00:00+08:00:00",
"closing_at": "2023-06-20T20:00:00+08:00:00",
"day_id": "friday",
"days": {"monday": {"hours": "10:00-19:00"
},
"tuesday": {"hours": "10:00-19:00"
},
"wednesday": {"hours": "10:00-19:00"
},
"thursday": {"hours": "10:00-19:00"
},
"friday": {"hours": "10:00-19:00"
},
"saturday": {"hours": "10:00-19:00"
},
"sunday": {"hours": "10:00-19:00"
}
}
},
"stocks": [{"id": "9655d648-9ed3-4fee-94fa-4a7bc807e5c7",
"name": "ТРК «Еврозона»",
"description": null,
"address": "г Улан-Удэ, ул Балтахинова, д 13",
"coordinates": {"latitude": 51.8121373,
"longitude": 107.6641822
},
"links": [{"type": "twitter",
"value": "https://instagram.com/zenky.io"
}
],
"phones": [{"country": "RU",
"number": "+79641234567",
"national": "+7 (964) 123-45-67"
}
],
"schedule": {"is_open_now": false,
"opening_at": "2023-06-20T10:00:00+08:00:00",
"closing_at": "2023-06-20T20:00:00+08:00:00",
"day_id": "friday",
"days": {"monday": {"hours": "10:00-19:00"
},
"tuesday": {"hours": "10:00-19:00"
},
"wednesday": {"hours": "10:00-19:00"
},
"thursday": {"hours": "10:00-19:00"
},
"friday": {"hours": "10:00-19:00"
},
"saturday": {"hours": "10:00-19:00"
},
"sunday": {"hours": "10:00-19:00"
}
}
}
}
],
"delivery_zones": [{"id": "96ad06d6-4c2b-4671-9f03-77e0544bbf14",
"name": "Первая зона",
"coordinates": [{"latitude": 51.86046585577859,
"longitude": 107.51617115746944
},
{"latitude": 51.869045905165855,
"longitude": 107.64526460749036
},
{"latitude": 51.81444475690688,
"longitude": 107.66697977167492
},
{"latitude": 51.80646099581586,
"longitude": 107.59888650849196
},
{"latitude": 51.80869899574977,
"longitude": 107.52450082880388
},
{"latitude": 51.86046585577859,
"longitude": 107.51617115746944
}
],
"description": "Первая зона доставки",
"color": "#ee44d7",
"min_price": 100000,
"free_delivery_price": 20000000,
"delivery_price": 2000000,
"delivery_time": "1 час"
}
]
},
"stock": {"id": "9655d648-9ed3-4fee-94fa-4a7bc807e5c7",
"name": "ТРК «Еврозона»",
"description": null,
"address": "г Улан-Удэ, ул Балтахинова, д 13",
"coordinates": {"latitude": 51.8121373,
"longitude": 107.6641822
},
"links": [{"type": "twitter",
"value": "https://instagram.com/zenky.io"
}
],
"phones": [{"country": "RU",
"number": "+79641234567",
"national": "+7 (964) 123-45-67"
}
],
"schedule": {"is_open_now": false,
"opening_at": "2023-06-20T10:00:00+08:00:00",
"closing_at": "2023-06-20T20:00:00+08:00:00",
"day_id": "friday",
"days": {"monday": {"hours": "10:00-19:00"
},
"tuesday": {"hours": "10:00-19:00"
},
"wednesday": {"hours": "10:00-19:00"
},
"thursday": {"hours": "10:00-19:00"
},
"friday": {"hours": "10:00-19:00"
},
"saturday": {"hours": "10:00-19:00"
},
"sunday": {"hours": "10:00-19:00"
}
}
}
},
"customer": {"id": "95e340eb-526c-4e8d-be07-026f944bb20f",
"store_profile_id": "95e340ef-b08c-4cd3-903d-15e22c488ad3",
"order_count": 0,
"orders_total_price": 0,
"first_name": "Иван",
"last_name": "Иванов",
"phone": {"country": "RU",
"number": "+79641234567",
"national": "+7 (964) 123-45-67"
},
"gender": "female",
"birth_date": "2019-08-24T14:15:22Z",
"registered_at": "2019-08-24T14:15:22Z",
"loyalty": {"referral_program": {"code": "EntertainingBlondKite",
"join_url": "https://promo.example.org/join/EntertainingBlondKite",
"invite_url": "https://promo.example.org/invite/EntertainingBlondKite"
},
"balance": 0,
"expenses": 0,
"bonuses_level": {"id": "94494cd1-f719-48ff-bd20-5b7d63f39153",
"name": "Пятый",
"expenses": 0,
"rates": {"cashback": 0,
"payment": 0
}
},
"rates": {"cashback": 0,
"payment": 0
}
},
"settings": {"onesignal_id": "a121bb68-72a6-4d4a-ac5b-4877b09f6632",
"device_id": "245CD19D-93AB-486F-89DE-C2B1156151B0",
"device_token": "9ba072e0ee65c50a5059342fc16137f80d560301dd9400b145441a17ff1a3e8b",
"device_os": "ios",
"barcode": {"content": "0000584720791",
"url": "https://api.zenky.io/v3/media/barcode?content=MDAwMDU4NDcyMDc5MQ==&input=base64"
},
"qrcode": {"content": "0000584720791",
"url": "https://api.zenky.io/v3/media/qrcode?content=aHR0cHM6Ly93d3cueW91dHViZS5jb20vd2F0Y2g/dj1kUXc0dzlXZ1hjUQ==&input=base64"
}
},
"avatar": {"placeholder": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"medium": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"large": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"xlarge": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"hd": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
}
}
},
"delivery_address": {"id": "93e6151c-57ed-41f4-ab75-4c64898f9696",
"resolver": "dadata",
"name": "Домашний адрес",
"address": "г Улан-Удэ, ул Жердева, д 104Б",
"coordinates": {"latitude": 51.8121373,
"longitude": 107.6641822
},
"country": "Россия",
"city": "Улан-Удэ",
"settlement": "113-й",
"street": "Жердева",
"house": "104Б",
"block": 1,
"apartment": "офис 505",
"entrance": "1",
"floor": "цокольный",
"has_intercom": true
},
"delivery_zone": {"id": "96ad06d6-4c2b-4671-9f03-77e0544bbf14",
"name": "Первая зона",
"coordinates": [{"latitude": 51.86046585577859,
"longitude": 107.51617115746944
},
{"latitude": 51.869045905165855,
"longitude": 107.64526460749036
},
{"latitude": 51.81444475690688,
"longitude": 107.66697977167492
},
{"latitude": 51.80646099581586,
"longitude": 107.59888650849196
},
{"latitude": 51.80869899574977,
"longitude": 107.52450082880388
},
{"latitude": 51.86046585577859,
"longitude": 107.51617115746944
}
],
"description": "Первая зона доставки",
"color": "#ee44d7",
"min_price": 100000,
"free_delivery_price": 20000000,
"delivery_price": 2000000,
"delivery_time": "1 час"
},
"statuses": [{"id": "string",
"kind": "awaiting_delivery",
"name": "string",
"transitioned_at": "2019-08-24T14:15:22Z"
}
],
"progress": [{"id": "string",
"kind": "awaiting_delivery",
"name": "string",
"transitioned_at": "2019-08-24T14:15:22Z"
}
],
"payments": [{"id": "string",
"type": "payment",
"status": "pending",
"method": "bonuses",
"amount": 0,
"created_at": "2019-08-24T14:15:22Z",
"confirmed_at": "2019-08-24T14:15:22Z",
"authorization_confirmed_at": "2019-08-24T14:15:22Z",
"cancelled_at": "2019-08-24T14:15:22Z",
"refunded_at": "2019-08-24T14:15:22Z",
"refund_failed_at": "2019-08-24T14:15:22Z",
"transaction_meta": {"change": 0,
"bill": 0
}
}
],
"delivery_interval": {"id": "9a661517-6b81-4428-a47d-bb4406885a12",
"date": {"iso": "2023-11-05",
"date": "05.11.2023"
},
"start_time": "10:00",
"end_time": "11:59"
},
"promocode": {"type": "plain",
"promocode": "EXAMPLE",
"message": "Спасибо! Ваш промокод будет передан оператору."
}
}
}

Удалить интервал доставки заказа

Используйте этот метод, чтобы удалить ранее привязанный интервал доставки заказа.

path Parameters

store required	string ID магазина
order required	string ID заказа

query Parameters

token

string

Токен заказа (для неаутентифицированных запросов)

Responses

Response samples

Content type

application/json

{"error": {"message": "У вас нет доступа к этому магазину.",
"original_message": "You have no access to this store.",
"http_code": 403,
"error_code": "store.access_denied"
}
}

Время доставки

Указать время доставки заказа

Используйте этот метод, если время доставки невозможно указать вместе со способом доставки (например, если вы запросили у покупателя способ доставки до наполнения корзины).

path Parameters

store required	string ID магазина
order required	string ID заказа

query Parameters

token

string

Токен заказа (для неаутентифицированных запросов)

Request Body schema: application/json
required

deliver_at

string

Дата отложенной доставки в часовом поясе города (в формате YYYY-MM-DD HH:MM)

Responses

Request samples

Payload

Content type

application/json

{"deliver_at": "2021-07-20 19:00"
}

Response samples

Content type

application/json

{"data": {"id": "string",
"token": "string",
"can_cancel": true,
"number": "string",
"delivery_method": "delivery",
"total_price": 0,
"original_total_price": 0,
"discount": {"difference": 0,
"percentage": 0
},
"notes": "string",
"created_at": "2019-08-24T14:15:22Z",
"submitted_at": "2019-08-24T14:15:22Z",
"deliver_at": "2019-08-24T14:15:22Z",
"meta_data": {"deliver_at": "string",
"on_premise": {"table": "string"
}
},
"status": {"id": "string",
"kind": "awaiting_delivery",
"name": "string",
"transitioned_at": "2019-08-24T14:15:22Z"
},
"variants": [{"id": "string",
"product_id": "string",
"product_variant_id": "string",
"stock_id": "string",
"promotion": {"id": "string",
"reward_id": "string"
},
"promocode_id": "string",
"is_reward": true,
"is_promocode_reward": true,
"quantity": 0,
"has_measured_quantity": true,
"measured_quantity": 0.1,
"total_price": 0,
"original_total_price": 0,
"unit_price": 0,
"original_unit_price": 0,
"discount": {"difference": 0,
"percentage": 0
},
"modifiers_hash": "string",
"product": {"id": "92766ffe-2d0e-4f67-87fe-35312f545b30",
"short_id": "92766ffe2d0e45b3",
"slug": "iphone-12-pro",
"name": "iPhone 12 Pro",
"description": "A14 Bionic, самый быстрый процессор iPhone. Дисплей OLED от края до края. Передняя панель Ceramic Shield, которая в четыре раза снижает риск повреждений дисплея при падении. И Ночной режим на всех камерах. Всё это есть в iPhone 12. В двух размерах.",
"unit_type": "piece",
"weight": 187,
"nutrition_facts": {"calories": 100,
"proteins": 2.5,
"fats": 3.5,
"carbohydrates": 13
},
"quantity_step": 0.4,
"is_promotion_reward": false,
"categories": [{"id": "961172f7-ac30-43d5-9687-6ab70c13790b",
"short_id": "961172f7ac303790",
"parent_id": "998f217c-5470-477c-870c-b3c768afecf0",
"is_featured": false,
"slug": "smartfony",
"name": "Смартфоны",
"description": null,
"cover": {"placeholder": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"medium": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"large": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"xlarge": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"hd": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
}
},
"seo": {"title": "Смартфоны: цены, большой каталог, новинки",
"description": "Большой ассортимент электроники, цифровой и бытовой техники, а так же товаров для дома.",
"meta": [{"name": {"attribute": "name",
"value": "description"
},
"value": {"attribute": "content",
"value": "Большой ассортимент электроники, цифровой и бытовой техники, а так же товаров для дома."
}
},
{"name": {"attribute": "name",
"value": "og:image"
},
"value": {"attribute": "content",
"value": "https://assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg"
}
},
{"name": {"attribute": "name",
"value": "name"
},
"value": {"attribute": "content",
"value": "width=device-width, initial-scale=1"
},
"additional": [{"attribute": "id",
"value": "viewport"
}
]
}
]
}
}
],
"images": [{"placeholder": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"medium": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"large": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"xlarge": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"hd": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
}
}
],
"custom_fields": [{"id": "brand",
"name": "Производитель",
"type": "text",
"value": "Apple, Inc."
}
],
"variants": [{"id": "92766ffe-4265-4836-a8b4-92f64b090d97",
"sku": "IPHONE12-25",
"barcode": "IPHONE12-25",
"name": "iPhone 12 Pro Белый 128 ГБ",
"nutrition_facts": {"calories": 100,
"proteins": 2.5,
"fats": 3.5,
"carbohydrates": 13
},
"price": 0,
"original_price": 9999000,
"discount": {"difference": 1999800,
"percentage": 20
},
"default_modifiers": { },
"prices": [{"stock_id": null,
"price": 0,
"original_price": 9999000,
"discount": {"difference": 1999800,
"percentage": 20
}
}
],
"dimensions": [{"dimension": "weight",
"type": "netto",
"value": 187
}
],
"custom_fields": [{"id": "brand",
"name": "Производитель",
"type": "text",
"value": "Apple, Inc."
}
],
"remainders": [{"stock_id": "92766ffd-fdf7-44b0-bd51-0755d0aa027c",
"quantity": 10,
"label": "Мало"
}
],
"options": [{"id": "95e15ded-7fd0-4d30-900e-32f8cf0e4549",
"name": "Цвет",
"type": "color",
"value": {"id": "95e15ded-81eb-4d36-90d2-4de607140840",
"name": "Золотой",
"color": "#F9E5C9"
}
}
]
}
],
"features": [{"id": "92766ffd-f182-48ca-a4ae-6e4ccc3a243e",
"alias": "a243",
"name": "Размер дисплея",
"filterable": true,
"type": "range",
"range": "float",
"values": [{"id": "92766ffd-f182-48ca-a4ae-6e4ccc3a243e",
"alias": "a243",
"name": "Размер дисплея",
"range": "float"
}
]
}
],
"features_groups": [{"id": "96546cb3-ec0f-454e-83f8-711cc815c27c",
"name": "Внешний вид",
"description": "Внешний вид устройств.",
"features": [{"id": "92766ffd-f182-48ca-a4ae-6e4ccc3a243e",
"alias": "a243",
"name": "Размер дисплея",
"filterable": true,
"type": "range",
"range": "float",
"values": [null
]
}
]
}
],
"modifiers": [{"modifier": {"id": "92861b69-93c4-4c4e-991c-487c329d105d",
"sku": "string",
"name": "Подарочная упаковка",
"price": 0,
"cover": {"placeholder": {"url": null,
"width": null,
"height": null
},
"medium": {"url": null,
"width": null,
"height": null
},
"large": {"url": null,
"width": null,
"height": null
},
"xlarge": {"url": null,
"width": null,
"height": null
},
"hd": {"url": null,
"width": null,
"height": null
}
}
},
"is_required": false,
"min_quantity": 0,
"max_quantity": 1
}
],
"modifiers_groups": [{"group": {"id": "92861bd9-2809-43f9-a7c3-78d0e5bc6e33",
"name": "План Apple Care",
"modifiers": [{"id": null,
"sku": null,
"name": null,
"price": null,
"cover": null
}
]
},
"is_required": false,
"min_quantity": 0,
"max_quantity": 1
}
],
"seo": {"title": "Смартфоны: цены, большой каталог, новинки",
"description": "Большой ассортимент электроники, цифровой и бытовой техники, а так же товаров для дома.",
"meta": [{"name": {"attribute": "name",
"value": "description"
},
"value": {"attribute": "content",
"value": "Большой ассортимент электроники, цифровой и бытовой техники, а так же товаров для дома."
}
},
{"name": {"attribute": "name",
"value": "og:image"
},
"value": {"attribute": "content",
"value": "https://assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg"
}
},
{"name": {"attribute": "name",
"value": "name"
},
"value": {"attribute": "content",
"value": "width=device-width, initial-scale=1"
},
"additional": [{"attribute": "id",
"value": "viewport"
}
]
}
]
}
},
"variant": {"id": "92766ffe-4265-4836-a8b4-92f64b090d97",
"sku": "IPHONE12-25",
"barcode": "IPHONE12-25",
"name": "iPhone 12 Pro Белый 128 ГБ",
"nutrition_facts": {"calories": 100,
"proteins": 2.5,
"fats": 3.5,
"carbohydrates": 13
},
"price": 0,
"original_price": 9999000,
"discount": {"difference": 1999800,
"percentage": 20
},
"default_modifiers": { },
"prices": [{"stock_id": null,
"price": 0,
"original_price": 9999000,
"discount": {"difference": 1999800,
"percentage": 20
}
}
],
"dimensions": [{"dimension": "weight",
"type": "netto",
"value": 187
}
],
"custom_fields": [{"id": "brand",
"name": "Производитель",
"type": "text",
"value": "Apple, Inc."
}
],
"remainders": [{"stock_id": "92766ffd-fdf7-44b0-bd51-0755d0aa027c",
"quantity": 10,
"label": "Мало"
}
],
"options": [{"id": "95e15ded-7fd0-4d30-900e-32f8cf0e4549",
"name": "Цвет",
"type": "color",
"value": {"id": "95e15ded-81eb-4d36-90d2-4de607140840",
"name": "Золотой",
"color": "#F9E5C9"
}
}
]
},
"modifiers": [{"id": "string",
"modifiers_group_id": "string",
"quantity": 0,
"total_price": 0,
"unit_price": 0,
"original_price": 0,
"original_unit_price": 0,
"modifier": {"id": "92861b69-93c4-4c4e-991c-487c329d105d",
"sku": "string",
"name": "Подарочная упаковка",
"price": 0,
"cover": {"placeholder": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"medium": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"large": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"xlarge": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"hd": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
}
}
},
"modifiers_group": {"id": "92861bd9-2809-43f9-a7c3-78d0e5bc6e33",
"name": "План Apple Care"
}
}
]
}
],
"city": {"id": "9275c4be-44de-49d8-a308-d1322a8efa08",
"is_default": true,
"name": "Улан-Удэ",
"timezone": "Asia/Irkutsk",
"coordinates": {"latitude": 51.8121373,
"longitude": 107.6641822
},
"schedule": {"is_open_now": false,
"opening_at": "2023-06-20T10:00:00+08:00:00",
"closing_at": "2023-06-20T20:00:00+08:00:00",
"day_id": "friday",
"days": {"monday": {"hours": "10:00-19:00"
},
"tuesday": {"hours": "10:00-19:00"
},
"wednesday": {"hours": "10:00-19:00"
},
"thursday": {"hours": "10:00-19:00"
},
"friday": {"hours": "10:00-19:00"
},
"saturday": {"hours": "10:00-19:00"
},
"sunday": {"hours": "10:00-19:00"
}
}
},
"stocks": [{"id": "9655d648-9ed3-4fee-94fa-4a7bc807e5c7",
"name": "ТРК «Еврозона»",
"description": null,
"address": "г Улан-Удэ, ул Балтахинова, д 13",
"coordinates": {"latitude": 51.8121373,
"longitude": 107.6641822
},
"links": [{"type": "twitter",
"value": "https://instagram.com/zenky.io"
}
],
"phones": [{"country": "RU",
"number": "+79641234567",
"national": "+7 (964) 123-45-67"
}
],
"schedule": {"is_open_now": false,
"opening_at": "2023-06-20T10:00:00+08:00:00",
"closing_at": "2023-06-20T20:00:00+08:00:00",
"day_id": "friday",
"days": {"monday": {"hours": "10:00-19:00"
},
"tuesday": {"hours": "10:00-19:00"
},
"wednesday": {"hours": "10:00-19:00"
},
"thursday": {"hours": "10:00-19:00"
},
"friday": {"hours": "10:00-19:00"
},
"saturday": {"hours": "10:00-19:00"
},
"sunday": {"hours": "10:00-19:00"
}
}
}
}
],
"delivery_zones": [{"id": "96ad06d6-4c2b-4671-9f03-77e0544bbf14",
"name": "Первая зона",
"coordinates": [{"latitude": 51.86046585577859,
"longitude": 107.51617115746944
},
{"latitude": 51.869045905165855,
"longitude": 107.64526460749036
},
{"latitude": 51.81444475690688,
"longitude": 107.66697977167492
},
{"latitude": 51.80646099581586,
"longitude": 107.59888650849196
},
{"latitude": 51.80869899574977,
"longitude": 107.52450082880388
},
{"latitude": 51.86046585577859,
"longitude": 107.51617115746944
}
],
"description": "Первая зона доставки",
"color": "#ee44d7",
"min_price": 100000,
"free_delivery_price": 20000000,
"delivery_price": 2000000,
"delivery_time": "1 час"
}
]
},
"stock": {"id": "9655d648-9ed3-4fee-94fa-4a7bc807e5c7",
"name": "ТРК «Еврозона»",
"description": null,
"address": "г Улан-Удэ, ул Балтахинова, д 13",
"coordinates": {"latitude": 51.8121373,
"longitude": 107.6641822
},
"links": [{"type": "twitter",
"value": "https://instagram.com/zenky.io"
}
],
"phones": [{"country": "RU",
"number": "+79641234567",
"national": "+7 (964) 123-45-67"
}
],
"schedule": {"is_open_now": false,
"opening_at": "2023-06-20T10:00:00+08:00:00",
"closing_at": "2023-06-20T20:00:00+08:00:00",
"day_id": "friday",
"days": {"monday": {"hours": "10:00-19:00"
},
"tuesday": {"hours": "10:00-19:00"
},
"wednesday": {"hours": "10:00-19:00"
},
"thursday": {"hours": "10:00-19:00"
},
"friday": {"hours": "10:00-19:00"
},
"saturday": {"hours": "10:00-19:00"
},
"sunday": {"hours": "10:00-19:00"
}
}
}
},
"customer": {"id": "95e340eb-526c-4e8d-be07-026f944bb20f",
"store_profile_id": "95e340ef-b08c-4cd3-903d-15e22c488ad3",
"order_count": 0,
"orders_total_price": 0,
"first_name": "Иван",
"last_name": "Иванов",
"phone": {"country": "RU",
"number": "+79641234567",
"national": "+7 (964) 123-45-67"
},
"gender": "female",
"birth_date": "2019-08-24T14:15:22Z",
"registered_at": "2019-08-24T14:15:22Z",
"loyalty": {"referral_program": {"code": "EntertainingBlondKite",
"join_url": "https://promo.example.org/join/EntertainingBlondKite",
"invite_url": "https://promo.example.org/invite/EntertainingBlondKite"
},
"balance": 0,
"expenses": 0,
"bonuses_level": {"id": "94494cd1-f719-48ff-bd20-5b7d63f39153",
"name": "Пятый",
"expenses": 0,
"rates": {"cashback": 0,
"payment": 0
}
},
"rates": {"cashback": 0,
"payment": 0
}
},
"settings": {"onesignal_id": "a121bb68-72a6-4d4a-ac5b-4877b09f6632",
"device_id": "245CD19D-93AB-486F-89DE-C2B1156151B0",
"device_token": "9ba072e0ee65c50a5059342fc16137f80d560301dd9400b145441a17ff1a3e8b",
"device_os": "ios",
"barcode": {"content": "0000584720791",
"url": "https://api.zenky.io/v3/media/barcode?content=MDAwMDU4NDcyMDc5MQ==&input=base64"
},
"qrcode": {"content": "0000584720791",
"url": "https://api.zenky.io/v3/media/qrcode?content=aHR0cHM6Ly93d3cueW91dHViZS5jb20vd2F0Y2g/dj1kUXc0dzlXZ1hjUQ==&input=base64"
}
},
"avatar": {"placeholder": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"medium": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"large": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"xlarge": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"hd": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
}
}
},
"delivery_address": {"id": "93e6151c-57ed-41f4-ab75-4c64898f9696",
"resolver": "dadata",
"name": "Домашний адрес",
"address": "г Улан-Удэ, ул Жердева, д 104Б",
"coordinates": {"latitude": 51.8121373,
"longitude": 107.6641822
},
"country": "Россия",
"city": "Улан-Удэ",
"settlement": "113-й",
"street": "Жердева",
"house": "104Б",
"block": 1,
"apartment": "офис 505",
"entrance": "1",
"floor": "цокольный",
"has_intercom": true
},
"delivery_zone": {"id": "96ad06d6-4c2b-4671-9f03-77e0544bbf14",
"name": "Первая зона",
"coordinates": [{"latitude": 51.86046585577859,
"longitude": 107.51617115746944
},
{"latitude": 51.869045905165855,
"longitude": 107.64526460749036
},
{"latitude": 51.81444475690688,
"longitude": 107.66697977167492
},
{"latitude": 51.80646099581586,
"longitude": 107.59888650849196
},
{"latitude": 51.80869899574977,
"longitude": 107.52450082880388
},
{"latitude": 51.86046585577859,
"longitude": 107.51617115746944
}
],
"description": "Первая зона доставки",
"color": "#ee44d7",
"min_price": 100000,
"free_delivery_price": 20000000,
"delivery_price": 2000000,
"delivery_time": "1 час"
},
"statuses": [{"id": "string",
"kind": "awaiting_delivery",
"name": "string",
"transitioned_at": "2019-08-24T14:15:22Z"
}
],
"progress": [{"id": "string",
"kind": "awaiting_delivery",
"name": "string",
"transitioned_at": "2019-08-24T14:15:22Z"
}
],
"payments": [{"id": "string",
"type": "payment",
"status": "pending",
"method": "bonuses",
"amount": 0,
"created_at": "2019-08-24T14:15:22Z",
"confirmed_at": "2019-08-24T14:15:22Z",
"authorization_confirmed_at": "2019-08-24T14:15:22Z",
"cancelled_at": "2019-08-24T14:15:22Z",
"refunded_at": "2019-08-24T14:15:22Z",
"refund_failed_at": "2019-08-24T14:15:22Z",
"transaction_meta": {"change": 0,
"bill": 0
}
}
],
"delivery_interval": {"id": "9a661517-6b81-4428-a47d-bb4406885a12",
"date": {"iso": "2023-11-05",
"date": "05.11.2023"
},
"start_time": "10:00",
"end_time": "11:59"
},
"promocode": {"type": "plain",
"promocode": "EXAMPLE",
"message": "Спасибо! Ваш промокод будет передан оператору."
}
}
}

Удалить время доставки заказа

Используйте этот метод, чтобы удалить ранее привязанное время доставки заказа.

path Parameters

store required	string ID магазина
order required	string ID заказа

query Parameters

token

string

Токен заказа (для неаутентифицированных запросов)

Responses

Response samples

Content type

application/json

{"error": {"message": "У вас нет доступа к этому магазину.",
"original_message": "You have no access to this store.",
"http_code": 403,
"error_code": "store.access_denied"
}
}

Способ оплаты

Указать способ оплаты заказа

Используйте этот метод для передачи одного основного способа оплаты (cash, credit-card, mobile_bank, cloudpayments, card_token, yookassa или alfa) и (опционально) суммы оплаты бонусами (bonuses).

Если покупатель списывает бонусы, вам необходимо передать сумму списания в поле amount объекта оплаты бонусами. Для остальных способов оплаты это поле заполнять не нужно – оно будет проигнорировано на сервере.

В случае передачи нескольких основных способов оплаты (отличающихся от bonuses), будет выбран первый способ оплаты из списка, все остальные будут проигнорированы.

Бонусы и платежи по токену (card_token) не списываются после вызова этого метода. Списание произойдёт только во время оформления заказа.

Повторные вызовы этого метода будут удалять все предыдущие платёжные транзакции и создавать новые.

path Parameters

store required	string ID магазина
order required	string ID заказа

query Parameters

token

string

Токен заказа (для неаутентифицированных запросов)

Request Body schema: application/json
required

Array of objects (SetOrderPaymentsItem)

Список способов оплаты

Array

method	string Способ оплаты
amount	integer Сумма
bill	integer Купюра к оплате
save_card	boolean Сохранить карту
card_token_id	string ID сохранённой карты

Responses

Request samples

Payload

Content type

application/json

{"payments": [{"method": "bonuses",
"amount": 100
},
{"method": "cash",
"bill": 5000
}
]
}

Response samples

Content type

application/json

{"data": [{"id": "string",
"type": "payment",
"status": "pending",
"method": "bonuses",
"amount": 0,
"created_at": "2019-08-24T14:15:22Z",
"confirmed_at": "2019-08-24T14:15:22Z",
"authorization_confirmed_at": "2019-08-24T14:15:22Z",
"cancelled_at": "2019-08-24T14:15:22Z",
"refunded_at": "2019-08-24T14:15:22Z",
"refund_failed_at": "2019-08-24T14:15:22Z",
"transaction_meta": {"change": 0,
"bill": 0
}
}
]
}

Оплата бонусами

Предпросмотр бонусов

Используйте этот метод, чтобы получить оставшуюся сумму к оплате после применения бонусов.

Если в параметре amount будет передана сумма бонусов, превышающая лимит списания (из-за ограничений на процент оплаты или из-за нехватки баланса), в поле bonuses будет указана максимальная сумма списания.

В поле unpaid будет указана оставшаяся сумма к оплате. Если сумма равна нулю, это означает, что заказ может быть полностью оплачен бонусами и основной способ оплаты можно не передавать.

Внимание: этот метод не регистрирует платёжные транзакции и не списывает бонусы.

path Parameters

store required	string ID магазина
order required	string ID заказа

query Parameters

token	string Токен заказа (для неаутентифицированных запросов)
required	string or number Сумма бонусов для списания

Responses

Response samples

Content type

application/json

{"data": {"bonuses": 0,
"unpaid": 0
}
}

Онлайн-оплата

Получить URL страницы оплаты

Этот метод позволяет получить URL страницы оплаты заказа для способов yookassa и alfa. Чтобы покупатель был перенаправлен на конкретную страницу после оплаты, передавайте её полный URL в параметре current_url тела запроса.

Внимание: если используется способ оплаты alfa (Альфа-Банк) и покупатель по какой-то причине не завершил оплату, повторно вызывать этот метод не следует. Вместо этого нужно вызывать метод повтора онлайн-оплаты. В ответе этого метода также будет доступен redirect_url.

path Parameters

store required	string ID магазина
transactionId required	string ID транзакции оплаты
order required	string ID заказа

query Parameters

token

string

Токен заказа (для неаутентифицированных запросов)

Request Body schema: application/json
required

current_url

string or null

URL текущей страницы. Если указано, покупатель будет перенаправлен на эту страницу после оплаты

Responses

Request samples

Payload

Content type

application/json

{"current_url": "https://example.com"
}

Response samples

Content type

application/json

{"data": {"redirect_url": "https://alfa.rbsuat.com/payment/merchants/ecom2/payment_ru.html?mdOrder=01619a6b-f44a-7180-b79c-c78902690adf"
}
}

Повторить попытку онлайн-оплаты заказа

Этот метод следует вызывать, если покупатель попытался оплатить заказ онлайн через Альфа-Банк (alfa), но по какой-то причине не завершил оплату. Передавайте поле current_url, чтобы вернуть покупателя на конкретную страницу.

path Parameters

store required	string ID магазина
order required	string ID заказа

query Parameters

token

string

Токен заказа (для неаутентифицированных запросов)

Request Body schema: application/json
required

current_url

string or null

URL текущей страницы. Если указано, покупатель будет перенаправлен на эту страницу после оплаты

Responses

Request samples

Payload

Content type

application/json

{"current_url": "https://example.com"
}

Response samples

Content type

application/json

{"data": {"redirect_url": "https://alfa.rbsuat.com/payment/merchants/ecom2/payment_ru.html?mdOrder=01619a6b-f44a-7180-b79c-c78902690adf"
}
}

Промокоды

Привязать промокод к заказу

path Parameters

store required	string ID магазина
order required	string ID заказа

query Parameters

token

string

Токен заказа (для неаутентифицированных запросов)

Request Body schema: application/json
required

promocode

required

string

Промокод для применения к заказу

Responses

Request samples

Payload

Content type

application/json

{"promocode": "EXAMPLE"
}

Response samples

Content type

application/json

{"data": {"type": "plain",
"promocode": "EXAMPLE",
"message": "Спасибо! Ваш промокод будет передан оператору."
}
}

Получить привязанный к заказу промокод

path Parameters

store required	string ID магазина
order required	string ID заказа

query Parameters

token

string

Токен заказа (для неаутентифицированных запросов)

Responses

Response samples

Content type

application/json

{"data": {"type": "plain",
"promocode": "EXAMPLE",
"message": "Спасибо! Ваш промокод будет передан оператору."
}
}

Удалить промокод из заказа

path Parameters

store required	string ID магазина
order required	string ID заказа

query Parameters

token

string

Токен заказа (для неаутентифицированных запросов)

Responses

Response samples

Content type

application/json

{"error": {"message": "У вас нет доступа к этому магазину.",
"original_message": "You have no access to this store.",
"http_code": 403,
"error_code": "store.access_denied"
}
}

Оформление заказа

Оформить заказ

Этот метод должен быть вызван только после привязки покупателя, указания способа доставки и способа оплаты заказа.

Если поле confirmation_required установлено в true, необходимо выполнить подтверждение заказа кодом из SMS, который был отправлен покупателю (см. раздел «Подтверждение»). Первоначальная отправка кода выполняется автоматически.

Возможные ошибки API

Во время выполнения этого запроса вы можете столкнуться со следующими ошибками:

HTTP	Код	Причина	Решение
503	`orders.submission.disabled`	Приём заказов временно недоступен для этого магазина.	Включить приём заказов (если вы владелец магазина), оформить заказ в рабочее время.
422	`orders.no_city`	К заказу не привязан город.	Привязать город к заказу и повторить процесс оформления заказа.
422	`orders.already_submitted`	Этот заказ уже был оформлен ранее.	После оформления каждого заказа следует создавать новый и работать с ним.
401	`orders.checkout.authentication_required`	Требуется аутентификация покупателя.	Заказ нужно оформлять только после регистрации или входа покупателя в свой аккаунт.
422	`orders.no_customer`	Покупатель не найден.	Убедиться, что покупатель был привязан.
503	`security.ban`	Запрос не может быть выполнен из-за блокировки телефона или IP-адреса.	Дождаться снятия блокировки или написать письмо на tech@zenky.io, если блокировка была ошибочной.
422	`orders.invalid_delivery_method`	Выбранный способ доставки отключен у магазина.	Включить в настройках магазина нужный способ доставки или использовать другой доступный.
422	`orders.stock_missing`	Склад самовывоза не указан.	Передать ID склада самовывоза.
422	`orders.delivery.city_stock_mismatch`	Выбранный склад самовывоза не относится к выбранному городу.	Передать ID склада самовывоза, который относится к выбранному городу, или изменить город.
422	`addresses.not_specified`	Адрес доставки не указан.	Убедиться, что адрес доставки был задан до оформления.
422	`orders.on_premise.table_missing`	Не указан номер стола.	Убедиться, что номер стола в заведении был задан до оформления.
422	`orders.delivery_address.out_of_delivery`	Адрес доставки не входит ни в одну зону доставки.	Привязать другой адрес или изменить границы зоны доставки в панели управления магазином.
422	`orders.min_price.too_low`	Сумма заказа меньше минимальной суммы для оформления.	Добавить товары, чтобы сумма заказа стала равна и больше минимальной суммы или изменить минимальную суммму для оформления.
422	`orders.payments.invalid_method`	Выбранный способ оплаты недоступен.	Включить в настройках магазина нужный способ оплаты или привязать другой доступный.
422	`orders.payments.amount_is_not_enough`	Сумма зарегистрированных платежей меньше суммы заказа.	Зарегистрировать способы оплаты ещё раз или отключить проверку суммы оплаты в настройках магазина. Если покупатель изменяет корзину после регистрации платежей, их нужно регистрировать заново.
422	`orders.payments.amount_exceeds_total_price`	Переданная сумма платежей превышает сумму заказа.	Изменить сумму платежей или отключить проверку суммы оплаты в настройках магазина.
422	`orders.products.ordering_disabled`	Некоторые товары недоступны для заказа.	Убрать из корзины недоступные для заказа товары или отключить блокировку в редактировании товара.
422	`orders.products.out_of_stock`	Некоторых товаров нет в наличии.	Изменить содержание корзины или изменить настройку проверки наличия товаров в панели управления магазином.
422	`orders.products.price_mismatch`	У некоторых товаров изменилась цена после добавления в корзину.	Изменить содержание корзины или изменить настройку проверки соответствия цен в панели управления магазином.
422	`orders.promotions.extra_rewards`	В заказе содержатся лишние товары-подарки за акции.	Удалить лишние товары-подарки за акции.
503	`loyalty.disabled`	Программа лояльности отключена.	Убрать из списка платежей оплату бонусами.
503	`loyalty.not_available`	API программы лояльности недоступен.	Обратиться в техподдержку, передав ID заказа.
404	`orders.payments.card_token.not_found`	Токен сохранённой карты не найден.	Убедитесь, что передаётся корректный ID токена сохранённой карты. Обратитесь в техподдержку, передав ID заказа, ID токена сохранённой карты и полный ответ сервера.
404	`orders.payments.card_token.invalid_acquiring`	Неизвестный сервис эквайринга.	Обратитесь в техподдержку, передав ID заказа и ID токена сохранённой карты.
503	`orders.payments.card_token.failed`	Оплата по токену карты не удалась.	Обратитесь в техподдержку, передав ID заказа и ID токена сохранённой карты.
503	`acquiring.not_available`	Сервис эквайринга не подключен.	Подключить эквайринг в панели управления магазином.

path Parameters

store required	string ID магазина
order required	string ID заказа

query Parameters

token

string

Токен заказа (для неаутентифицированных запросов)

Request Body schema: application/json
required

notes	string Комментарий к заказу
persons_count	number Количество персон

Responses

Request samples

Payload

Content type

application/json

{"notes": "Без палочек.",
"persons_count": 2
}

Response samples

Content type

application/json

{"data": {"confirmation": {"required": true,
"method": "call",
"phone": {"country": "RU",
"number": "+79641234567",
"national": "+7 (964) 123-45-67"
}
},
"online_payment": {"required": true,
"url": "string"
},
"order": {"id": "string",
"token": "string",
"can_cancel": true,
"number": "string",
"delivery_method": "delivery",
"total_price": 0,
"original_total_price": 0,
"discount": {"difference": 0,
"percentage": 0
},
"notes": "string",
"created_at": "2019-08-24T14:15:22Z",
"submitted_at": "2019-08-24T14:15:22Z",
"deliver_at": "2019-08-24T14:15:22Z",
"meta_data": {"deliver_at": "string",
"on_premise": {"table": "string"
}
},
"status": {"id": "string",
"kind": "awaiting_delivery",
"name": "string",
"transitioned_at": "2019-08-24T14:15:22Z"
},
"variants": [{"id": "string",
"product_id": "string",
"product_variant_id": "string",
"stock_id": "string",
"promotion": {"id": "string",
"reward_id": "string"
},
"promocode_id": "string",
"is_reward": true,
"is_promocode_reward": true,
"quantity": 0,
"has_measured_quantity": true,
"measured_quantity": 0.1,
"total_price": 0,
"original_total_price": 0,
"unit_price": 0,
"original_unit_price": 0,
"discount": {"difference": 0,
"percentage": 0
},
"modifiers_hash": "string",
"product": {"id": "92766ffe-2d0e-4f67-87fe-35312f545b30",
"short_id": "92766ffe2d0e45b3",
"slug": "iphone-12-pro",
"name": "iPhone 12 Pro",
"description": "A14 Bionic, самый быстрый процессор iPhone. Дисплей OLED от края до края. Передняя панель Ceramic Shield, которая в четыре раза снижает риск повреждений дисплея при падении. И Ночной режим на всех камерах. Всё это есть в iPhone 12. В двух размерах.",
"unit_type": "piece",
"weight": 187,
"nutrition_facts": {"calories": 100,
"proteins": 2.5,
"fats": 3.5,
"carbohydrates": 13
},
"quantity_step": 0.4,
"is_promotion_reward": false,
"categories": [{"id": "961172f7-ac30-43d5-9687-6ab70c13790b",
"short_id": "961172f7ac303790",
"parent_id": "998f217c-5470-477c-870c-b3c768afecf0",
"is_featured": false,
"slug": "smartfony",
"name": "Смартфоны",
"description": null,
"cover": {"placeholder": {"url": null,
"width": null,
"height": null
},
"medium": {"url": null,
"width": null,
"height": null
},
"large": {"url": null,
"width": null,
"height": null
},
"xlarge": {"url": null,
"width": null,
"height": null
},
"hd": {"url": null,
"width": null,
"height": null
}
},
"seo": {"title": "Смартфоны: цены, большой каталог, новинки",
"description": "Большой ассортимент электроники, цифровой и бытовой техники, а так же товаров для дома.",
"meta": [{"name": {"attribute": "name",
"value": "description"
},
"value": {"attribute": "content",
"value": "Большой ассортимент электроники, цифровой и бытовой техники, а так же товаров для дома."
}
},
{"name": {"attribute": "name",
"value": "og:image"
},
"value": {"attribute": "content",
"value": "https://assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg"
}
},
{"name": {"attribute": "name",
"value": "name"
},
"value": {"attribute": "content",
"value": "width=device-width, initial-scale=1"
},
"additional": [{"attribute": "id",
"value": "viewport"
}
]
}
]
}
}
],
"images": [{"placeholder": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"medium": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"large": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"xlarge": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"hd": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
}
}
],
"custom_fields": [{"id": "brand",
"name": "Производитель",
"type": "text",
"value": "Apple, Inc."
}
],
"variants": [{"id": "92766ffe-4265-4836-a8b4-92f64b090d97",
"sku": "IPHONE12-25",
"barcode": "IPHONE12-25",
"name": "iPhone 12 Pro Белый 128 ГБ",
"nutrition_facts": {"calories": 100,
"proteins": 2.5,
"fats": 3.5,
"carbohydrates": 13
},
"price": 0,
"original_price": 9999000,
"discount": {"difference": 1999800,
"percentage": 20
},
"default_modifiers": { },
"prices": [{"stock_id": null,
"price": null,
"original_price": null,
"discount": null
}
],
"dimensions": [{"dimension": null,
"type": null,
"value": null
}
],
"custom_fields": [{"id": null,
"name": null,
"type": null,
"value": null
}
],
"remainders": [{"stock_id": "92766ffd-fdf7-44b0-bd51-0755d0aa027c",
"quantity": 10,
"label": "Мало"
}
],
"options": [{"id": null,
"name": null,
"type": null,
"value": { }
}
]
}
],
"features": [{"id": "92766ffd-f182-48ca-a4ae-6e4ccc3a243e",
"alias": "a243",
"name": "Размер дисплея",
"filterable": true,
"type": "range",
"range": "float",
"values": [{"id": null,
"alias": null,
"name": null,
"range": null
}
]
}
],
"features_groups": [{"id": "96546cb3-ec0f-454e-83f8-711cc815c27c",
"name": "Внешний вид",
"description": "Внешний вид устройств.",
"features": [{"id": null,
"alias": null,
"name": null,
"filterable": null,
"type": null,
"range": null,
"values": [ ]
}
]
}
],
"modifiers": [{"modifier": {"id": "92861b69-93c4-4c4e-991c-487c329d105d",
"sku": "string",
"name": "Подарочная упаковка",
"price": 0,
"cover": {"placeholder": null,
"medium": null,
"large": null,
"xlarge": null,
"hd": null
}
},
"is_required": false,
"min_quantity": 0,
"max_quantity": 1
}
],
"modifiers_groups": [{"group": {"id": "92861bd9-2809-43f9-a7c3-78d0e5bc6e33",
"name": "План Apple Care",
"modifiers": [null
]
},
"is_required": false,
"min_quantity": 0,
"max_quantity": 1
}
],
"seo": {"title": "Смартфоны: цены, большой каталог, новинки",
"description": "Большой ассортимент электроники, цифровой и бытовой техники, а так же товаров для дома.",
"meta": [{"name": {"attribute": "name",
"value": "description"
},
"value": {"attribute": "content",
"value": "Большой ассортимент электроники, цифровой и бытовой техники, а так же товаров для дома."
}
},
{"name": {"attribute": "name",
"value": "og:image"
},
"value": {"attribute": "content",
"value": "https://assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg"
}
},
{"name": {"attribute": "name",
"value": "name"
},
"value": {"attribute": "content",
"value": "width=device-width, initial-scale=1"
},
"additional": [{"attribute": "id",
"value": "viewport"
}
]
}
]
}
},
"variant": {"id": "92766ffe-4265-4836-a8b4-92f64b090d97",
"sku": "IPHONE12-25",
"barcode": "IPHONE12-25",
"name": "iPhone 12 Pro Белый 128 ГБ",
"nutrition_facts": {"calories": 100,
"proteins": 2.5,
"fats": 3.5,
"carbohydrates": 13
},
"price": 0,
"original_price": 9999000,
"discount": {"difference": 1999800,
"percentage": 20
},
"default_modifiers": { },
"prices": [{"stock_id": null,
"price": 0,
"original_price": 9999000,
"discount": {"difference": 1999800,
"percentage": 20
}
}
],
"dimensions": [{"dimension": "weight",
"type": "netto",
"value": 187
}
],
"custom_fields": [{"id": "brand",
"name": "Производитель",
"type": "text",
"value": "Apple, Inc."
}
],
"remainders": [{"stock_id": "92766ffd-fdf7-44b0-bd51-0755d0aa027c",
"quantity": 10,
"label": "Мало"
}
],
"options": [{"id": "95e15ded-7fd0-4d30-900e-32f8cf0e4549",
"name": "Цвет",
"type": "color",
"value": {"id": "95e15ded-81eb-4d36-90d2-4de607140840",
"name": "Золотой",
"color": "#F9E5C9"
}
}
]
},
"modifiers": [{"id": "string",
"modifiers_group_id": "string",
"quantity": 0,
"total_price": 0,
"unit_price": 0,
"original_price": 0,
"original_unit_price": 0,
"modifier": {"id": "92861b69-93c4-4c4e-991c-487c329d105d",
"sku": "string",
"name": "Подарочная упаковка",
"price": 0,
"cover": {"placeholder": {"url": null,
"width": null,
"height": null
},
"medium": {"url": null,
"width": null,
"height": null
},
"large": {"url": null,
"width": null,
"height": null
},
"xlarge": {"url": null,
"width": null,
"height": null
},
"hd": {"url": null,
"width": null,
"height": null
}
}
},
"modifiers_group": {"id": "92861bd9-2809-43f9-a7c3-78d0e5bc6e33",
"name": "План Apple Care"
}
}
]
}
],
"city": {"id": "9275c4be-44de-49d8-a308-d1322a8efa08",
"is_default": true,
"name": "Улан-Удэ",
"timezone": "Asia/Irkutsk",
"coordinates": {"latitude": 51.8121373,
"longitude": 107.6641822
},
"schedule": {"is_open_now": false,
"opening_at": "2023-06-20T10:00:00+08:00:00",
"closing_at": "2023-06-20T20:00:00+08:00:00",
"day_id": "friday",
"days": {"monday": {"hours": "10:00-19:00"
},
"tuesday": {"hours": "10:00-19:00"
},
"wednesday": {"hours": "10:00-19:00"
},
"thursday": {"hours": "10:00-19:00"
},
"friday": {"hours": "10:00-19:00"
},
"saturday": {"hours": "10:00-19:00"
},
"sunday": {"hours": "10:00-19:00"
}
}
},
"stocks": [{"id": "9655d648-9ed3-4fee-94fa-4a7bc807e5c7",
"name": "ТРК «Еврозона»",
"description": null,
"address": "г Улан-Удэ, ул Балтахинова, д 13",
"coordinates": {"latitude": 51.8121373,
"longitude": 107.6641822
},
"links": [{"type": "twitter",
"value": "https://instagram.com/zenky.io"
}
],
"phones": [{"country": "RU",
"number": "+79641234567",
"national": "+7 (964) 123-45-67"
}
],
"schedule": {"is_open_now": false,
"opening_at": "2023-06-20T10:00:00+08:00:00",
"closing_at": "2023-06-20T20:00:00+08:00:00",
"day_id": "friday",
"days": {"monday": {"hours": "10:00-19:00"
},
"tuesday": {"hours": "10:00-19:00"
},
"wednesday": {"hours": "10:00-19:00"
},
"thursday": {"hours": "10:00-19:00"
},
"friday": {"hours": "10:00-19:00"
},
"saturday": {"hours": "10:00-19:00"
},
"sunday": {"hours": "10:00-19:00"
}
}
}
}
],
"delivery_zones": [{"id": "96ad06d6-4c2b-4671-9f03-77e0544bbf14",
"name": "Первая зона",
"coordinates": [{"latitude": 51.86046585577859,
"longitude": 107.51617115746944
},
{"latitude": 51.869045905165855,
"longitude": 107.64526460749036
},
{"latitude": 51.81444475690688,
"longitude": 107.66697977167492
},
{"latitude": 51.80646099581586,
"longitude": 107.59888650849196
},
{"latitude": 51.80869899574977,
"longitude": 107.52450082880388
},
{"latitude": 51.86046585577859,
"longitude": 107.51617115746944
}
],
"description": "Первая зона доставки",
"color": "#ee44d7",
"min_price": 100000,
"free_delivery_price": 20000000,
"delivery_price": 2000000,
"delivery_time": "1 час"
}
]
},
"stock": {"id": "9655d648-9ed3-4fee-94fa-4a7bc807e5c7",
"name": "ТРК «Еврозона»",
"description": null,
"address": "г Улан-Удэ, ул Балтахинова, д 13",
"coordinates": {"latitude": 51.8121373,
"longitude": 107.6641822
},
"links": [{"type": "twitter",
"value": "https://instagram.com/zenky.io"
}
],
"phones": [{"country": "RU",
"number": "+79641234567",
"national": "+7 (964) 123-45-67"
}
],
"schedule": {"is_open_now": false,
"opening_at": "2023-06-20T10:00:00+08:00:00",
"closing_at": "2023-06-20T20:00:00+08:00:00",
"day_id": "friday",
"days": {"monday": {"hours": "10:00-19:00"
},
"tuesday": {"hours": "10:00-19:00"
},
"wednesday": {"hours": "10:00-19:00"
},
"thursday": {"hours": "10:00-19:00"
},
"friday": {"hours": "10:00-19:00"
},
"saturday": {"hours": "10:00-19:00"
},
"sunday": {"hours": "10:00-19:00"
}
}
}
},
"customer": {"id": "95e340eb-526c-4e8d-be07-026f944bb20f",
"store_profile_id": "95e340ef-b08c-4cd3-903d-15e22c488ad3",
"order_count": 0,
"orders_total_price": 0,
"first_name": "Иван",
"last_name": "Иванов",
"phone": {"country": "RU",
"number": "+79641234567",
"national": "+7 (964) 123-45-67"
},
"gender": "female",
"birth_date": "2019-08-24T14:15:22Z",
"registered_at": "2019-08-24T14:15:22Z",
"loyalty": {"referral_program": {"code": "EntertainingBlondKite",
"join_url": "https://promo.example.org/join/EntertainingBlondKite",
"invite_url": "https://promo.example.org/invite/EntertainingBlondKite"
},
"balance": 0,
"expenses": 0,
"bonuses_level": {"id": "94494cd1-f719-48ff-bd20-5b7d63f39153",
"name": "Пятый",
"expenses": 0,
"rates": {"cashback": 0,
"payment": 0
}
},
"rates": {"cashback": 0,
"payment": 0
}
},
"settings": {"onesignal_id": "a121bb68-72a6-4d4a-ac5b-4877b09f6632",
"device_id": "245CD19D-93AB-486F-89DE-C2B1156151B0",
"device_token": "9ba072e0ee65c50a5059342fc16137f80d560301dd9400b145441a17ff1a3e8b",
"device_os": "ios",
"barcode": {"content": "0000584720791",
"url": "https://api.zenky.io/v3/media/barcode?content=MDAwMDU4NDcyMDc5MQ==&input=base64"
},
"qrcode": {"content": "0000584720791",
"url": "https://api.zenky.io/v3/media/qrcode?content=aHR0cHM6Ly93d3cueW91dHViZS5jb20vd2F0Y2g/dj1kUXc0dzlXZ1hjUQ==&input=base64"
}
},
"avatar": {"placeholder": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"medium": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"large": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"xlarge": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"hd": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
}
}
},
"delivery_address": {"id": "93e6151c-57ed-41f4-ab75-4c64898f9696",
"resolver": "dadata",
"name": "Домашний адрес",
"address": "г Улан-Удэ, ул Жердева, д 104Б",
"coordinates": {"latitude": 51.8121373,
"longitude": 107.6641822
},
"country": "Россия",
"city": "Улан-Удэ",
"settlement": "113-й",
"street": "Жердева",
"house": "104Б",
"block": 1,
"apartment": "офис 505",
"entrance": "1",
"floor": "цокольный",
"has_intercom": true
},
"delivery_zone": {"id": "96ad06d6-4c2b-4671-9f03-77e0544bbf14",
"name": "Первая зона",
"coordinates": [{"latitude": 51.86046585577859,
"longitude": 107.51617115746944
},
{"latitude": 51.869045905165855,
"longitude": 107.64526460749036
},
{"latitude": 51.81444475690688,
"longitude": 107.66697977167492
},
{"latitude": 51.80646099581586,
"longitude": 107.59888650849196
},
{"latitude": 51.80869899574977,
"longitude": 107.52450082880388
},
{"latitude": 51.86046585577859,
"longitude": 107.51617115746944
}
],
"description": "Первая зона доставки",
"color": "#ee44d7",
"min_price": 100000,
"free_delivery_price": 20000000,
"delivery_price": 2000000,
"delivery_time": "1 час"
},
"statuses": [{"id": "string",
"kind": "awaiting_delivery",
"name": "string",
"transitioned_at": "2019-08-24T14:15:22Z"
}
],
"progress": [{"id": "string",
"kind": "awaiting_delivery",
"name": "string",
"transitioned_at": "2019-08-24T14:15:22Z"
}
],
"payments": [{"id": "string",
"type": "payment",
"status": "pending",
"method": "bonuses",
"amount": 0,
"created_at": "2019-08-24T14:15:22Z",
"confirmed_at": "2019-08-24T14:15:22Z",
"authorization_confirmed_at": "2019-08-24T14:15:22Z",
"cancelled_at": "2019-08-24T14:15:22Z",
"refunded_at": "2019-08-24T14:15:22Z",
"refund_failed_at": "2019-08-24T14:15:22Z",
"transaction_meta": {"change": 0,
"bill": 0
}
}
],
"delivery_interval": {"id": "9a661517-6b81-4428-a47d-bb4406885a12",
"date": {"iso": "2023-11-05",
"date": "05.11.2023"
},
"start_time": "10:00",
"end_time": "11:59"
},
"promocode": {"type": "plain",
"promocode": "EXAMPLE",
"message": "Спасибо! Ваш промокод будет передан оператору."
}
}
}
}

Подтверждение заказа

Подтвердить оформление заказа

path Parameters

store required	string ID магазина
order required	string ID заказа

query Parameters

token

string

Токен заказа (для неаутентифицированных запросов)

Request Body schema: application/json
required

code

required

integer

Код подтверждения из SMS

Responses

Request samples

Payload

Content type

application/json

{"code": 0
}

Response samples

Content type

application/json

{"data": {"success": true,
"token": "string"
}
}

Повторно отправить код подтверждения заказа

path Parameters

store required	string ID магазина
order required	string ID заказа

query Parameters

token

string

Токен заказа (для неаутентифицированных запросов)

Responses

Response samples

Content type

application/json

{"data": {"success": true,
"method": "call"
}
}

Аутентификация

Регистрация нового покупателя

Возможные ошибки API

Во время выполнения этого запроса вы можете столкнуться со следующими ошибками:

HTTP	Код	Причина	Решение
404	`auth.registration.referrer.not_found`	Учетная запись пригласившего вас пользователя не найдена.	Использовать другой код приглашения (`referrer_code`) или ID пригласившего пользователя (`referrer_id`).
422	`auth.already_registered`	Эта учётная запись уже зарегистрирована.	Использовать другой номер телефона.
503	`security.ban`	Запрос не может быть выполнен из-за блокировки телефона или IP-адреса.	Дождаться снятия блокировки.
422	`customers.phone_required`	Нужно указать номер телефона покупателя.	Убедиться, что номер телефона передан.

path Parameters

store

required

string

ID магазина

Request Body schema: application/json
required

	object or null (RecaptchaInput) Данные для проверки reCAPTCHA v3. Обязательный параметр, если у магазина включена проверка reCAPTCHA v3 для действия `registration`.
	object (PhoneInput) Телефон покупателя
password	string Пароль покупателя (от 8 символов)
first_name	string Имя покупателя
last_name	string Фамилия покупателя
gender	string (CustomerGenderType) Enum: "female" "male" "other" Пол покупателя
birth_date	string Дата рождения покупателя (в формате `YYYY-MM-DD`)
referrer_code	string Код приглашения для программы «Пригласи друга» (вместо `referrer_id`)
referrer_id	string ID пользователя для программы «Пригласи друга» (вместо `referrer_code`)

Responses

Request samples

Payload

Content type

application/json

{"phone": {"number": "+7 (964) 123-45-67",
"country": "RU"
},
"password": "1jEIjf3bnW",
"first_name": "Иван",
"last_name": "Иванов",
"referrer_code": "MiniatureSilverStilt"
}

Response samples

Content type

application/json

{"data": {"confirmation_required": true,
"queued_to": "+79641234567",
"method": "call"
}
}

Подтверждение регистрации

Возможные ошибки API

Во время выполнения этого запроса вы можете столкнуться со следующими ошибками:

HTTP	Код	Причина	Решение
404	`auth.user_not_found`	Учётная запись не найдена.	Убедиться, что передан правильный номер телефона.
422	`auth.registration.already_confirmed`	Эта учётная запись уже подтверждена.	Использовать другой номер телефона для подтверждения.
403	`auth.registration.invalid_confirmation_code`	Неправильный код подтверждения регистрации.	Убедиться, что передан правильный код подтверждения.
422	`auth.registration.password_required`	Нужно указать пароль.	Убедиться, что пароль был передан во время регистрации или во время подтверждения.

path Parameters

store

required

string

ID магазина

Request Body schema: application/json
required

	object (PhoneInput) Телефон покупателя
required	number or string Код подтверждения
password	string Пароль покупателя (от 8 символов)
first_name	string Имя покупателя
last_name	string Фамилия покупателя
gender	string (CustomerGenderType) Enum: "female" "male" "other" Пол покупателя
birth_date	string Дата рождения покупателя (в формате `YYYY-MM-DD`)

Responses

Request samples

Payload

Content type

application/json

{"phone": {"number": "+7 (964) 123-45-67",
"country": "RU"
},
"code": "1234",
"password": "1jEIjf3bnW",
"first_name": "Иван",
"last_name": "Иванов"
}

Response samples

Content type

application/json

{"data": {"token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9...."
}
}

Повторно выслать код подтверждения регистрации

Возможные ошибки API

Во время выполнения этого запроса вы можете столкнуться со следующими ошибками:

HTTP	Код	Причина	Решение
404	`auth.user_not_found`	Учётная запись не найдена.	Убедиться, что передан правильный номер телефона.
422	`auth.registration.already_confirmed`	Эта учётная запись уже подтверждена.	Использовать другой номер телефона для подтверждения.
503	`security.ban`	Запрос не может быть выполнен из-за блокировки телефона или IP-адреса.	Дождаться снятия блокировки или написать письмо на tech@zenky.io, если блокировка была ошибочной.

path Parameters

store

required

string

ID магазина

Request Body schema: application/json
required

	object or null (RecaptchaInput) Данные для проверки reCAPTCHA v3.
	object (PhoneInput) Телефон покупателя

Responses

Request samples

Payload

Content type

application/json

{"phone": {"number": "+7 (964) 123-45-67",
"country": "RU"
}
}

Response samples

Content type

application/json

{"data": {"confirmation_required": true,
"queued_to": "+79641234567",
"method": "call"
}
}

Запросить код для сброса пароля

Возможные ошибки API

Во время выполнения этого запроса вы можете столкнуться со следующими ошибками:

HTTP	Код	Причина	Решение
404	`auth.user_not_found`	Учётная запись не найдена.	Убедиться, что передан правильный номер телефона.
503	`auth.password_reset.not_available`	Сброс пароля недоступен для этой учётной записи.	Ошибка возникает только на системных демо-аккаунтах.
503	`security.ban`	Запрос не может быть выполнен из-за блокировки телефона или IP-адреса.	Дождаться снятия блокировки или написать письмо на tech@zenky.io, если блокировка была ошибочной.

path Parameters

store

required

string

ID магазина

Request Body schema: application/json
required

	object or null (RecaptchaInput) Данные для проверки reCAPTCHA v3. Обязательный параметр, если у магазина включена проверка reCAPTCHA v3 для действия `reset_password`.
	object (PhoneInput) Телефон покупателя

Responses

Request samples

Payload

Content type

application/json

{"phone": {"number": "+7 (964) 123-45-67",
"country": "RU"
}
}

Response samples

Content type

application/json

{"data": {"success": true,
"queued_to": "+79641234567",
"method": "call"
}
}

Установить новый пароль

Возможные ошибки API

Во время выполнения этого запроса вы можете столкнуться со следующими ошибками:

HTTP	Код	Причина	Решение
404	`auth.user_not_found`	Учётная запись не найдена.	Убедиться, что передан правильный номер телефона.
503	`auth.password_reset.not_available`	Сброс пароля недоступен для этой учётной записи.	Ошибка возникает только на системных демо-аккаунтах.
422	`auth.password_reset.code_expired`	Код сброса пароля истёк.	Запросить новый код сброса пароля.
422	`auth.password_reset.invalid_code`	Неправильный код сброса пароля.	Указать правильный код сброса пароля.

path Parameters

store

required

string

ID магазина

Request Body schema: application/json
required

	object (PhoneInput) Телефон покупателя
required	number or string Код сброса пароля
password required	string Новый пароль (от 8 символов)

Responses

Request samples

Payload

Content type

application/json

{"phone": {"number": "+7 (964) 123-45-67",
"country": "RU"
},
"code": "1234",
"password": "LHP5q2HuNc"
}

Response samples

Content type

application/json

{"data": {"token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9...."
}
}

Вход в аккаунт

Во время выполнения этого запроса вы можете столкнуться со следующими ошибками:

HTTP	Код	Причина	Решение
404	`auth.user_not_found`	Учётная запись не найдена.	Убедиться, что передан правильный номер телефона.
403	`auth.registration.confirmation_required`	Нужно подтвердить номер телефона, указанный при регистрации.	Перенаправить покупателя на страницу подтверждения регистрации.
403	`auth.invalid_password`	Неправильный пароль.	Убедиться, что передан правильный пароль.

path Parameters

store

required

string

ID магазина

Request Body schema: application/json
required

	object (PhoneInput) Телефон покупателя
password required	string Пароль покупателя (от 8 символов)

Responses

Request samples

Payload

Content type

application/json

{"phone": {"number": "+7 (964) 123-45-67",
"country": "RU"
},
"password": "1jEIjf3bnW"
}

Response samples

Content type

application/json

{"data": {"token": "kv53MKLpAW88E2sZzGCIkNZcEpbCxPOxLSKTqiGd10ebc1b3"
}
}

Проверка телефона

Используйте этот метод, чтобы определить, регистрировался ли покупатель в магазине.

path Parameters

store

required

string

ID магазина

Request Body schema: application/json
required

object (PhoneInput)

Телефон покупателя

number required	string Номер телефона
country required	string Страна телефона (ISO 3166-1 alpha-2)

Responses

Request samples

Payload

Content type

application/json

{"phone": {"number": "+7 (964) 123-45-67",
"country": "RU"
}
}

Response samples

Content type

application/json

{"data": {"registered": true,
"confirmed": false
}
}

Обмен токена v2 на Storefront

Этот метод позволяет обменять токен, выданный в версии API v2 на токен нового формата для Storefront API. Внимание: для этого метода в заголовке Authorization нужно передавать токен из версии API v2! В ответе вы либо получите новый токен, либо ошибку (если v2-токен истёк или был создан для другого магазина).

Authorizations:

Bearer

path Parameters

store

required

string

ID магазина

Responses

Response samples

Content type

application/json

{"data": {"token": "kv53MKLpAW88E2sZzGCIkNZcEpbCxPOxLSKTqiGd10ebc1b3"
}
}

Профиль покупателя

Просмотр профиля покупателя

Этот метод поддерживает следующие включения:

Включение	Описание
`avatar`	Аватар
`settings`	Настройки

Authorizations:

Bearer

path Parameters

store

required

string

ID магазина

query Parameters

with	string Список включений

Responses

Response samples

Content type

application/json

{"data": {"id": "95e340eb-526c-4e8d-be07-026f944bb20f",
"store_profile_id": "95e340ef-b08c-4cd3-903d-15e22c488ad3",
"order_count": 0,
"orders_total_price": 0,
"first_name": "Иван",
"last_name": "Иванов",
"phone": {"country": "RU",
"number": "+79641234567",
"national": "+7 (964) 123-45-67"
},
"gender": "female",
"birth_date": "2019-08-24T14:15:22Z",
"registered_at": "2019-08-24T14:15:22Z",
"loyalty": {"referral_program": {"code": "EntertainingBlondKite",
"join_url": "https://promo.example.org/join/EntertainingBlondKite",
"invite_url": "https://promo.example.org/invite/EntertainingBlondKite"
},
"balance": 0,
"expenses": 0,
"bonuses_level": {"id": "94494cd1-f719-48ff-bd20-5b7d63f39153",
"name": "Пятый",
"expenses": 0,
"rates": {"cashback": 0,
"payment": 0
}
},
"rates": {"cashback": 0,
"payment": 0
}
},
"settings": {"onesignal_id": "a121bb68-72a6-4d4a-ac5b-4877b09f6632",
"device_id": "245CD19D-93AB-486F-89DE-C2B1156151B0",
"device_token": "9ba072e0ee65c50a5059342fc16137f80d560301dd9400b145441a17ff1a3e8b",
"device_os": "ios",
"barcode": {"content": "0000584720791",
"url": "https://api.zenky.io/v3/media/barcode?content=MDAwMDU4NDcyMDc5MQ==&input=base64"
},
"qrcode": {"content": "0000584720791",
"url": "https://api.zenky.io/v3/media/qrcode?content=aHR0cHM6Ly93d3cueW91dHViZS5jb20vd2F0Y2g/dj1kUXc0dzlXZ1hjUQ==&input=base64"
}
},
"avatar": {"placeholder": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"medium": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"large": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"xlarge": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"hd": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
}
}
}
}

Изменение профиля покупателя

Возможные ошибки API

Во время выполнения этого запроса вы можете столкнуться со следующими ошибками:

HTTP	Код	Причина	Решение
422	`customers.birth_date.forbidden`	Дату рождения изменять нельзя.	Сообщить покупателю, что он может изменить дату рождения, обратившись к представителям магазина.
422	`auth.invalid_password`	Неправильный пароль.	Убедиться, что в поле `current_password` передан правильный пароль (требуется, если покупатель хочет изменить пароль).

Authorizations:

Bearer

path Parameters

store

required

string

ID магазина

Request Body schema: application/json
required

first_name	string Имя покупателя
last_name	string Фамилия покупателя
gender	string (CustomerGenderType) Enum: "female" "male" "other" Пол покупателя
birth_date	string Дата рождения покупателя (в формате `YYYY-MM-DD`)
password	string Новый пароль покупателя (от 8 символов)
current_password	string Текущий пароль покупателя (требуется, если заполнено поле `password`)

Responses

Request samples

Payload

Content type

application/json

{"first_name": "Иван",
"last_name": "Иванов"
}

Response samples

Content type

application/json

{"data": {"id": "95e340eb-526c-4e8d-be07-026f944bb20f",
"store_profile_id": "95e340ef-b08c-4cd3-903d-15e22c488ad3",
"order_count": 0,
"orders_total_price": 0,
"first_name": "Иван",
"last_name": "Иванов",
"phone": {"country": "RU",
"number": "+79641234567",
"national": "+7 (964) 123-45-67"
},
"gender": "female",
"birth_date": "2019-08-24T14:15:22Z",
"registered_at": "2019-08-24T14:15:22Z",
"loyalty": {"referral_program": {"code": "EntertainingBlondKite",
"join_url": "https://promo.example.org/join/EntertainingBlondKite",
"invite_url": "https://promo.example.org/invite/EntertainingBlondKite"
},
"balance": 0,
"expenses": 0,
"bonuses_level": {"id": "94494cd1-f719-48ff-bd20-5b7d63f39153",
"name": "Пятый",
"expenses": 0,
"rates": {"cashback": 0,
"payment": 0
}
},
"rates": {"cashback": 0,
"payment": 0
}
},
"settings": {"onesignal_id": "a121bb68-72a6-4d4a-ac5b-4877b09f6632",
"device_id": "245CD19D-93AB-486F-89DE-C2B1156151B0",
"device_token": "9ba072e0ee65c50a5059342fc16137f80d560301dd9400b145441a17ff1a3e8b",
"device_os": "ios",
"barcode": {"content": "0000584720791",
"url": "https://api.zenky.io/v3/media/barcode?content=MDAwMDU4NDcyMDc5MQ==&input=base64"
},
"qrcode": {"content": "0000584720791",
"url": "https://api.zenky.io/v3/media/qrcode?content=aHR0cHM6Ly93d3cueW91dHViZS5jb20vd2F0Y2g/dj1kUXc0dzlXZ1hjUQ==&input=base64"
}
},
"avatar": {"placeholder": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"medium": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"large": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"xlarge": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"hd": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
}
}
}
}

Удаление профиля покупателя

Этот метод удаляет все адреса доставки покупателя, привязанные карты и обнуляет баланс бонусов. Номер телефона становится доступным для новой регистрации.

Возможные ошибки API

Во время выполнения этого запроса вы можете столкнуться со следующими ошибками:

HTTP	Код	Причина	Решение
403	`auth.invalid_password`	Указан неправильный пароль.	Убедиться, что в поле `password` передан правильный пароль.

Authorizations:

Bearer

path Parameters

store

required

string

ID магазина

Request Body schema: application/json
required

password

required

string

Пароль покупателя

Responses

Request samples

Payload

Content type

application/json

{"password": "1jEIjf3bnW"
}

Настройки покупателя

Просмотр настроек профиля покупателя

Authorizations:

Bearer

path Parameters

store

required

string

ID магазина

Responses

Response samples

Content type

application/json

{"data": {"onesignal_id": "a121bb68-72a6-4d4a-ac5b-4877b09f6632",
"device_id": "245CD19D-93AB-486F-89DE-C2B1156151B0",
"device_token": "9ba072e0ee65c50a5059342fc16137f80d560301dd9400b145441a17ff1a3e8b",
"device_os": "ios",
"barcode": {"content": "0000584720791",
"url": "https://api.zenky.io/v3/media/barcode?content=MDAwMDU4NDcyMDc5MQ==&input=base64"
},
"qrcode": {"content": "0000584720791",
"url": "https://api.zenky.io/v3/media/qrcode?content=aHR0cHM6Ly93d3cueW91dHViZS5jb20vd2F0Y2g/dj1kUXc0dzlXZ1hjUQ==&input=base64"
}
}
}

Изменение настроек профиля покупателя

Этот метод обновляет только те настройки, ключи которых были переданы в запросе.

Authorizations:

Bearer

path Parameters

store

required

string

ID магазина

Request Body schema: application/json
required

object

Объект с изменяемыми настройками

	string or null ID профиля OneSignal
	string or null ID мобильного устройства для Push-уведомлений
	string or null Токен мобильного устройства для Push-уведомлений
	string or null ОС мобильного устройства
	string or null Контент штрих-кода профиля
	string or null Контент QR-кода профиля

Responses

Request samples

Payload

Content type

application/json

{"settings": {"onesignal_id": "a121bb68-72a6-4d4a-ac5b-4877b09f6632",
"device_id": "245CD19D-93AB-486F-89DE-C2B1156151B0",
"device_token": "9ba072e0ee65c50a5059342fc16137f80d560301dd9400b145441a17ff1a3e8b",
"device_os": "ios",
"barcode": "0000584720791",
"qrcode": "0000584720791"
}
}

Response samples

Content type

application/json

{"data": {"onesignal_id": "a121bb68-72a6-4d4a-ac5b-4877b09f6632",
"device_id": "245CD19D-93AB-486F-89DE-C2B1156151B0",
"device_token": "9ba072e0ee65c50a5059342fc16137f80d560301dd9400b145441a17ff1a3e8b",
"device_os": "ios",
"barcode": {"content": "0000584720791",
"url": "https://api.zenky.io/v3/media/barcode?content=MDAwMDU4NDcyMDc5MQ==&input=base64"
},
"qrcode": {"content": "0000584720791",
"url": "https://api.zenky.io/v3/media/qrcode?content=aHR0cHM6Ly93d3cueW91dHViZS5jb20vd2F0Y2g/dj1kUXc0dzlXZ1hjUQ==&input=base64"
}
}
}

Адреса покупателя

Получить список адресов покупателя

Authorizations:

Bearer

path Parameters

store

required

string

ID магазина

query Parameters

with	string Список включений
count	integer Количество записей
page	integer Номер страницы
search	string Строка поиска
order_by	string Поле сортировки

Responses

Response samples

Content type

application/json

{"data": [{"id": "93e6151c-57ed-41f4-ab75-4c64898f9696",
"resolver": "dadata",
"name": "Домашний адрес",
"address": "г Улан-Удэ, ул Жердева, д 104Б",
"coordinates": {"latitude": 51.8121373,
"longitude": 107.6641822
},
"country": "Россия",
"city": "Улан-Удэ",
"settlement": "113-й",
"street": "Жердева",
"house": "104Б",
"block": 1,
"apartment": "офис 505",
"entrance": "1",
"floor": "цокольный",
"has_intercom": true
}
]
}

Создать адрес покупателя

В поле delivery_address должен быть один из следующих объектов:

Если магазин использует DaData.ru, объект с обязательным полем address, в котором должен быть указан полный адрес доставки до дома (включая город/населённый пункт, микрорайон (если есть), улицу (если есть), номер дома и корпус (если есть)). Вместе с адресом можно передать подъезд, квартиру, этаж, наличие домофона и заметку;
Если магазин не использует DaData.ru, объект с отдельными полями адреса (city, street, house и т.д.).

Возможные ошибки API

Во время выполнения этого запроса вы можете столкнуться со следующими ошибками:

HTTP	Код	Причина	Решение
422	`addresses.resolver.failed`	Не удалось определить адрес доставки.	Убедиться, что адрес введён правильно и полностью.

Authorizations:

Bearer

path Parameters

store

required

string

ID магазина

Request Body schema: application/json
required

object

Адрес покупателя

One of

name	string or null Название адреса
address required	string Адрес одной строкой (до дома)
apartment	string or null Квартира/офис
entrance	string or null Подъезд/вход
floor	string or null Этаж
has_intercom	boolean or null Наличие домофона
intercom_code	string or null Код домофона

Responses

Request samples

Payload

Content type

application/json

{"delivery_address": {"name": "string",
"address": "string",
"apartment": "string",
"entrance": "string",
"floor": "string",
"has_intercom": true,
"intercom_code": "string"
}
}

Response samples

Content type

application/json

{"data": {"id": "93e6151c-57ed-41f4-ab75-4c64898f9696",
"resolver": "dadata",
"name": "Домашний адрес",
"address": "г Улан-Удэ, ул Жердева, д 104Б",
"coordinates": {"latitude": 51.8121373,
"longitude": 107.6641822
},
"country": "Россия",
"city": "Улан-Удэ",
"settlement": "113-й",
"street": "Жердева",
"house": "104Б",
"block": 1,
"apartment": "офис 505",
"entrance": "1",
"floor": "цокольный",
"has_intercom": true
}
}

Изменить адрес покупателя

В поле delivery_address должен быть один из следующих объектов:

Если магазин использует DaData.ru, объект с обязательным полем address, в котором должен быть указан полный адрес доставки до дома (включая город/населённый пункт, микрорайон (если есть), улицу (если есть), номер дома и корпус (если есть)). Вместе с адресом можно передать подъезд, квартиру, этаж, наличие домофона и заметку;
Если магазин не использует DaData.ru, объект с отдельными полями адреса (city, street, house и т.д.).

Возможные ошибки API

Во время выполнения этого запроса вы можете столкнуться со следующими ошибками:

HTTP	Код	Причина	Решение
404	`addresses.not_found`	Адрес не найден.	Убедиться, что адрес относится к покупателю.
422	`addresses.resolver.failed`	Не удалось определить адрес доставки.	Убедиться, что адрес введён правильно и полностью.

Authorizations:

Bearer

path Parameters

store required	string ID магазина
address required	string ID адреса

Request Body schema: application/json
required

object

Адрес покупателя

One of

name	string or null Название адреса
address required	string Адрес одной строкой (до дома)
apartment	string or null Квартира/офис
entrance	string or null Подъезд/вход
floor	string or null Этаж
has_intercom	boolean or null Наличие домофона
intercom_code	string or null Код домофона

Responses

Request samples

Payload

Content type

application/json

{"delivery_address": {"name": "string",
"address": "string",
"apartment": "string",
"entrance": "string",
"floor": "string",
"has_intercom": true,
"intercom_code": "string"
}
}

Response samples

Content type

application/json

{"data": {"id": "93e6151c-57ed-41f4-ab75-4c64898f9696",
"resolver": "dadata",
"name": "Домашний адрес",
"address": "г Улан-Удэ, ул Жердева, д 104Б",
"coordinates": {"latitude": 51.8121373,
"longitude": 107.6641822
},
"country": "Россия",
"city": "Улан-Удэ",
"settlement": "113-й",
"street": "Жердева",
"house": "104Б",
"block": 1,
"apartment": "офис 505",
"entrance": "1",
"floor": "цокольный",
"has_intercom": true
}
}

Удалить адрес покупателя

Возможные ошибки API

Во время выполнения этого запроса вы можете столкнуться со следующими ошибками:

HTTP	Код	Причина	Решение
404	`addresses.not_found`	Адрес не найден.	Убедиться, что адрес относится к покупателю.

Authorizations:

Bearer

path Parameters

store required	string ID магазина
address required	string ID адреса

Responses

Способы оплаты покупателя

Получить список карт покупателя

Authorizations:

Bearer

path Parameters

store

required

string

ID магазина

query Parameters

count	integer Количество записей
page	integer Номер страницы

Responses

Response samples

Content type

application/json

{"data": [{"id": "971af824-fd6e-45d4-8fc2-7528b119281b",
"acquiring_type": {"id": "cloudpayments",
"name": "Cloudpayments"
},
"card_type": "american-express",
"card_first_six": "424242",
"card_last_four": "4242",
"name": "Привязанной картой онлайн",
"bank": {"id": "ru-tinkoff",
"name": "Тинькофф Банк",
"url": "https://www.tinkoff.ru/",
"background_colors": ["#444",
"#222"
],
"primary_background_color": "#333",
"background_style": "dark",
"logo_style": "white",
"text_color": "#fff",
"logos": {"png": null,
"svg": "https://my.zenky.io/assets/images/banks/banks-logos/ru-tinkoff.svg"
},
"payment_system": {"id": "visa",
"name": "Visa",
"logos": {"black": "https://my.zenky.io/assets/images/banks/brands-logos/visa-black.svg",
"white": "https://my.zenky.io/assets/images/banks/brands-logos/visa-white.svg",
"colored": "https://my.zenky.io/assets/images/banks/brands-logos/visa-colored.svg"
}
}
}
}
]
}

Удалить карту покупателя

Возможные ошибки API

Во время выполнения этого запроса вы можете столкнуться со следующими ошибками:

HTTP	Код	Причина	Решение
404	`orders.payments.card_token.not_found`	Сохранённая карта не найдена.	Убедиться, что карта относится к покупателю.

Authorizations:

Bearer

path Parameters

store required	string ID магазина
paymentMethod required	string ID карты

Responses

Программа лояльности

Получить актуальный баланс бонусов

Authorizations:

Bearer

path Parameters

store

required

string

ID магазина

Responses

Response samples

Content type

application/json

{"data": {"balance": 56000
}
}

Получить список транзакций программы лояльности

Authorizations:

Bearer

path Parameters

store

required

string

ID магазина

query Parameters

count	integer Количество записей
page	integer Номер страницы
type	string (BonusesTransactionDirection) Enum: "decrease" "increase" Тип транзакции (`increase` – пополнение, `decrease` – списание)
status	string (BonusesTransactionStatusFilter) Enum: "cancelled" "confirmed" "pending" "refunded" Статус транзакции (`pending` – ожидает подтверждения, `confirmed` – подтверждена, `cancelled` – отменена, `refunded` – возвращена).
reason	string (BonusesTransactionReason) Enum: "adjustment" "cancellation" "cashback" "external" "manual" "payment" "promotion_reward" "recruit_reward" "referral_reward" "refund" "welcome_bonuses" Причина создания транзакции
order_id	string ID связанного заказа

Responses

Response samples

Content type

application/json

{"data": [{"id": "string",
"order_id": "string",
"type": "decrease",
"status": "cancelled",
"reason": "adjustment",
"amount": 0,
"source_amount": 0,
"created_at": "2019-08-24T14:15:22Z",
"confirmed_at": "2019-08-24T14:15:22Z",
"cancelled_at": "2019-08-24T14:15:22Z"
}
]
}

Программа лояльности

Получить список бонусных уровней

path Parameters

store

required

string

ID магазина

Responses

Response samples

Content type

application/json

{"data": [{"id": "94494cd1-f719-48ff-bd20-5b7d63f39153",
"name": "Пятый",
"expenses": 0,
"rates": {"cashback": 0,
"payment": 0
}
}
]
}

Акции

Акции делятся на 2 части: контентная (объект Offer) и функциональная. Контентные данные используются в баннерах на сайтах и в приложениях, а так же в статьях, которые дают подбробные описания того, как работает акция.

Функциональная часть отвечает за проверку выполнения условий акций и выдачу подарков. Эти данные нигде не отображаются и используются в основном в серверной части Zenky.

Запуск проверки выполненных акций должен выполняться вручную по команде с сайта/приложения. Результат проверки будет доставлен в клиентское приложение через вебсокеты (см. подробнее в разделе «Продажи» – «Программа лояльности»).

Получить список акций

Этот метод поддерживает следующие включения:

Включение	Описание
`article`	Статья

Этот метод поддерживает следующие поля сортировки (передаются в параметре order_by):

Поле	Описание
`created_at`	По дате создания (asc)
`-created_at`	По дате создания (desc)
`sorting`	По ручной сортировке (asc)
`-sorting`	По ручной сортировке (desc)

path Parameters

store

required

string

ID магазина

query Parameters

with	string Список включений
count	integer Количество записей
page	integer Номер страницы
search	string Строка поиска
order_by	string Поле сортировки

Responses

Response samples

Content type

application/json

{"data": [{"id": "93da821f-d044-42b3-9e3d-54af20b5dd3a",
"short_id": "93da821fd0445dd3",
"slug": "akciya-v-den-rozdeniya",
"banners": {"desktop": {"title": "Акция в День Рождения",
"description": "Предъявите паспорт курьеру или оператору и получите скидку в 20%!",
"image": {"placeholder": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"medium": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"large": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"xlarge": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"hd": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
}
}
},
"mobile": {"title": "Акция в День Рождения",
"description": "Предъявите паспорт курьеру или оператору и получите скидку в 20%!",
"image": {"placeholder": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"medium": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"large": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"xlarge": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"hd": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
}
}
}
},
"article": {"title": "Акция в День Рождения",
"intro": "Предъявите паспорт курьеру или оператору и получите скидку в 20%!",
"body": "Предъявите паспорт курьеру или оператору и получите скидку в 20%! Акция действует за 1 день до, в день и через 1 день после дня рождения.",
"cover": {"placeholder": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"medium": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"large": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"xlarge": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"hd": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
}
}
}
}
]
}

Получить акцию

Этот метод поддерживает следующие включения:

Включение	Описание
`article`	Статья

path Parameters

store required	string ID магазина
offer required	string ID акции

query Parameters

with	string Список включений

Responses

Response samples

Content type

application/json

{"data": {"id": "93da821f-d044-42b3-9e3d-54af20b5dd3a",
"short_id": "93da821fd0445dd3",
"slug": "akciya-v-den-rozdeniya",
"banners": {"desktop": {"title": "Акция в День Рождения",
"description": "Предъявите паспорт курьеру или оператору и получите скидку в 20%!",
"image": {"placeholder": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"medium": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"large": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"xlarge": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"hd": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
}
}
},
"mobile": {"title": "Акция в День Рождения",
"description": "Предъявите паспорт курьеру или оператору и получите скидку в 20%!",
"image": {"placeholder": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"medium": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"large": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"xlarge": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"hd": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
}
}
}
},
"article": {"title": "Акция в День Рождения",
"intro": "Предъявите паспорт курьеру или оператору и получите скидку в 20%!",
"body": "Предъявите паспорт курьеру или оператору и получите скидку в 20%! Акция действует за 1 день до, в день и через 1 день после дня рождения.",
"cover": {"placeholder": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"medium": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"large": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"xlarge": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"hd": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
}
}
}
}
}

Креативы

Креативы – это баннеры и сторис, которые можно показывать на сайтах и в мобильных приложениях.

Баннеры делятся на два вида:

горизонтальные – используются на сайтах с возможностью загрузить версию баннеров для мобильной версии сайта;
вертикальные – можно использовать как на сайтах, так и в приложениях. Баннеры имеют соотношение сторон 3:4.

Сторис имеют набор слайдов (до 10), в каждом слайде может быть загружено изображение или видео. Также у каждого слайда может быть опциональное действие:

добавить товар в корзину;
применить промокод;
открыть ссылку.

Действие «Открыть ссылку» имеет тип ссылки, от которого зависят дополнительные поля:

товар;
категория товаров;
коллекция товаров;
акция;
статья в блоге;
произвольная ссылка.

Все типы кроме произвольной ссылки имеют дополнительные поля с идентификаторами связанных ресурсов. С их помощью вы можете открывать нужные страницы, используя встроенную в ваш сайт или приложение систему роутинга.

Получить список креативов

path Parameters

store

required

string

ID магазина

query Parameters

sales_channel_id required	string ID канала продаж, для которого нужно вернуть креативы. Если параметр не задан, будет возвращён пустой список.
city_id	string ID города, для которого нужно вернуть креативы. Если параметр не задан, будут возвращены креативы, доступные для всех городов.

Responses

Response samples

Content type

application/json

{"data": [{"id": "string",
"type": "horizontal_banner",
"items": [{"slot": "default",
"media": {"type": "image",
"files": [{"url": "string",
"width": 0,
"height": 0
}
],
"poster": {"url": "string",
"width": 0,
"height": 0
}
},
"header": "string",
"description": "string"
}
],
"slides": [{"id": "string",
"media": {"type": "image",
"files": [{"url": "string",
"width": 0,
"height": 0
}
],
"poster": {"url": "string",
"width": 0,
"height": 0
}
},
"action": { }
}
],
"action": { }
}
]
}

Статьи

Получить список категорий статей

Этот метод поддерживает следующие поля сортировки (передаются в параметре order_by):

Поле	Описание
`name`	По названию (asc)
`-name`	По названию (desc)

path Parameters

store

required

string

ID магазина

query Parameters

count	integer Количество записей
page	integer Номер страницы
search	string Строка поиска

Responses

Response samples

Content type

application/json

{"data": [{"id": "92e68846-2403-417f-a287-687b843a3351",
"short_id": "92e688462403a335",
"slug": "novosti",
"name": "Новости"
}
]
}

Получить категорию статей

path Parameters

store required	string ID магазина
category required	string ID категории

Responses

Response samples

Content type

application/json

{"data": {"id": "92e68846-2403-417f-a287-687b843a3351",
"short_id": "92e688462403a335",
"slug": "novosti",
"name": "Новости"
}
}

Получить список статей в блоге

Этот метод поддерживает следующие включения:

Включение	Описание
`category`	Категория статей

path Parameters

store

required

string

ID магазина

query Parameters

with	string Список включений
count	integer Количество записей
page	integer Номер страницы
search	string Строка поиска
category_id	string ID категории статей

Responses

Response samples

Content type

application/json

{"data": [{"id": "93e5f60b-abf3-4f9a-b00d-7355a41e2515",
"short_id": "93e5f60babf3e251",
"slug": "skoro-v-prodaze-ogranicennaya-partiya-konsolei-playstation-5",
"title": "Скоро в продаже! Ограниченная партия консолей PlayStation 5",
"intro": "Количество товара строго ограничено!",
"body": "<p>Консоль поддерживает форматы 4K и 8K. Конфигурация модели не имеет слабых мест. Консоль оборудована 3.5-гигагерцовым процессором AMD Zen 2, видеоядром AMD RDNA 2 и 16 ГБ памяти GDDR6. Объем встроенной памяти (в качестве которой используется твердотельный накопитель) – 825 ГБ. Поддерживающая технологию Tempest 3D AudioTech предлагает пользователям игровой консоли PlayStation 5 насладиться невероятным уровнем качества звука.</p>",
"updated_at": "2019-08-24T14:15:22Z",
"cover": {"placeholder": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"medium": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"large": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"xlarge": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"hd": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
}
},
"category": {"id": "92e68846-2403-417f-a287-687b843a3351",
"short_id": "92e688462403a335",
"slug": "novosti",
"name": "Новости"
}
}
]
}

Получить статью

Этот метод поддерживает следующие включения:

Включение	Описание
`category`	Категория статей

path Parameters

store required	string ID магазина
article required	string ID статьи

query Parameters

with	string Список включений

Responses

Response samples

Content type

application/json

{"data": {"id": "93e5f60b-abf3-4f9a-b00d-7355a41e2515",
"short_id": "93e5f60babf3e251",
"slug": "skoro-v-prodaze-ogranicennaya-partiya-konsolei-playstation-5",
"title": "Скоро в продаже! Ограниченная партия консолей PlayStation 5",
"intro": "Количество товара строго ограничено!",
"body": "<p>Консоль поддерживает форматы 4K и 8K. Конфигурация модели не имеет слабых мест. Консоль оборудована 3.5-гигагерцовым процессором AMD Zen 2, видеоядром AMD RDNA 2 и 16 ГБ памяти GDDR6. Объем встроенной памяти (в качестве которой используется твердотельный накопитель) – 825 ГБ. Поддерживающая технологию Tempest 3D AudioTech предлагает пользователям игровой консоли PlayStation 5 насладиться невероятным уровнем качества звука.</p>",
"updated_at": "2019-08-24T14:15:22Z",
"cover": {"placeholder": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"medium": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"large": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"xlarge": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
},
"hd": {"url": "https://cdn.assets.zenky.io/uploads/93e61053-3bff-48c3-82c2-d6c6806a0c3d/conversions/0928db5470dd9911_1920xH-large.jpg",
"width": 798,
"height": 449
}
},
"category": {"id": "92e68846-2403-417f-a287-687b843a3351",
"short_id": "92e688462403a335",
"slug": "novosti",
"name": "Новости"
}
}
}

Обратная связь

Создать запрос обратной связи

Поле email должно быть указано, если поле phone не указано (и наоборот).

path Parameters

store

required

string

ID магазина

Request Body schema: application/json
required

	object or null (RecaptchaInput) Данные для проверки reCAPTCHA v3. Обязательный параметр, если у магазина включена проверка reCAPTCHA v3 для действия `feedback_request`.
name	string Имя пользователя
email	string Email
	object Телефон покупателя
comment	string Текст запроса

Responses

Request samples

Payload

Content type

application/json

{"name": "Иван Иванов",
"email": "example@example.org",
"phone": {"number": "+7 (964) 123-45-67",
"country": "RU"
},
"comment": "Перезвоните мне."
}

Response samples

Content type

application/json

{"data": {"id": "93e61c42-569d-4daf-b98a-fdb8fa968c75",
"name": "Иван Иванов",
"email": "example@example.org",
"phone": {"country": "RU",
"number": "+79641234567",
"national": "+7 (964) 123-45-67"
},
"comment": "Перезвоните мне.",
"created_at": "2019-08-24T14:15:22Z"
}
}

Создать запрос обратного звонка

path Parameters

store

required

string

ID магазина

Request Body schema: application/json
required

	object or null (RecaptchaInput) Данные для проверки reCAPTCHA v3. Обязательный параметр, если у магазина включена проверка reCAPTCHA v3 для действия `callback`.
	object (PhoneInput) Телефон покупателя

Responses

Request samples

Payload

Content type

application/json

{"phone": {"number": "+7 (964) 123-45-67",
"country": "RU"
}
}

Response samples

Content type

application/json

{"data": {"submitted": true
}
}

Объявления

Получить активное объявление

Этот метод позволяет запросить активное объявление для показа пользователю. Если подходящего объявления нет, то в поле data будет значение null.

path Parameters

store

required

string

ID магазина

query Parameters

city_id

string

ID активного города для показа объявления

Responses

Response samples

Content type

application/json

{"data": {"id": "995029c6-9b4c-4542-bc78-d80d2dbbefb8",
"type": "banner",
"header": "Доставка заказов в праздники",
"message": "<p>Уважаемые покупатели! Для своевременной доставки заказа в праздничные дни, пожалуйста, оформляйте предзаказы.</p>",
"hide_unti": "2019-08-24T14:15:22Z"
}
}

Пуш-рассылки

Получить список сообщений пуш-рассылок

Authorizations:

Bearer

query Parameters

count	integer Количество записей
page	integer Номер страницы

Responses

Response samples

Content type

application/json

{"data": [{"id": "7d1123dc-e408-47dc-8db9-1d21f566d001",
"campaign_id": "a18647ff-0ce2-44a9-9861-2926e870ba39",
"title": "Дарим Пепперони 22 см",
"body": "Пора просыпаться от спячки и добавлять в свою жизнь больше вкусного 🌸🌸🌸 ДАРИМ ПЕППЕРОНИ 22 см при заказе от 1050 руб.",
"sent_at": "2026-04-12T11:04:20+03:00",
"delivered_at": "string",
"read_at": "string",
"created_at": "2026-04-12T11:04:19+03:00"
}
]
}

Получить счётчики сообщений пуш-рассылок

Authorizations:

Bearer

Responses

Response samples

Content type

application/json

{"data": {"total_count": 10,
"unread_count": 2
}
}

Отметить сообщение пуш-рассылки как прочитанное

Этот метод отмечает сообщения пуш-рассылки как прочитанные. Метод может вызываться в следующих случаях:

Если покупатель нажимает на пуш-уведомление;
Если покупатель открыл пуш-уведомление из истории рассылок;
Если покупатель отметил все сообщения пуш-рассылок как прочитанные.

В полезной нагрузке рассылочных пуш-уведомлений мы добавляем поле campaign_id – его можно использовать для вызова метода при открытии приложение из пуш-уведомления.

В каждом сообщении пуш-рассылок также имеется поле campaign_id, которое можно использовать для вызова метода при открытии уведомления из истории.

Если же покупатель хочет отметить все уведомления как прочитанные, достаточно вызывать метод прочтения без передачи campaign_id (или отправляя null / пустое значение).

Authorizations:

Bearer

Request Body schema: application/json
required

campaign_id

string or null

ID пуш-рассылки (из поля campaign_id). Если не передаётся, то будут отмечены прочитанными все сообщения пуш-рассылок, отправленные пользователю.

Responses

Request samples

Payload

Content type

application/json

{"campaign_id": "a18647ff-0ce2-44a9-9861-2926e870ba39"
}

Ошибка API

Ошибка выполнения операции. Возникает при дополнительных проверках данных (после валидации) или при невозможности продолжить выполнение запроса.

Такие ошибки имеют уникальный код и текст сообщения, по которым можно определить причину ошибки и способ её устранения. Список возможных ошибок может быть перечислен в документации к конкретному методу API.

object

message	string Сообщение об ошибке
original_message	string Оригинальный текст сообщения
http_code	integer HTTP-код ошибки
error_code	string Внутренний код ошибки
meta	object or null Мета-данные ошибки

{"error": {"message": "Товар не найден.",
"original_message": "Product was not found.",
"http_code": 404,
"error_code": "products.not_found",
"meta": {"product_id": "2b8da121-4567-4e5f-9c9b-a3e6ddcb64e3"
}
}
}

Ошибка валидации

Ошибка валидации входных данных. Возникает в том случае, если вы передали некорректные данные или не передали их вообще.

Исправить их проще всего – нужно изучить проблемные поля и свериться с документацией для исправления передаваемых данных.

Если вы не уверены, как исправить ошибку валидации, пожалуйста, создайте новый issue в нашем репозитории на GitHub. Обратите внимание, что этот репозиторий является публичным и любой пользователь может просматривать ваши обращения. Не публикуйте ваши API-токены и другую конфиденциальную информацию, особенно относящуюся к покупателям.

message	string Сообщение об ошибке
	object Список ошибок валидации

{"message": "The given data was invalid.",
"errors": {"name": ["Поле Название обязательно для заполнения."
]
}
}

Телефон

country	string Код страны (ISO 3166-1 alpha-2)
number	string Номер телефона в формате E.164
national	string Номер телефона в национальном формате

{"country": "RU",
"number": "+79641234567",
"national": "+7 (964) 123-45-67"
}

Zenky Storefront API (v1)

Начало работы

Выполнение запросов

HTTP-методы

Заголовки

ID магазина

Ответы API

Включения ответов

Обработка ошибок

Магазин

Получить профиль магазина

path Parameters

query Parameters

Responses

Response samples

Получить профиль магазина по App Bundle ID

path Parameters

Responses

Response samples

Правовые документы

Получить реквизиты магазина

Responses

Response samples

Получить политику конфиденциальности

Responses

Response samples

Получить политику обработки персональных данных

Responses

Response samples

Получить пользовательское соглашение

Responses

Response samples

Получить публичную оферту

Responses

Response samples

Получить согласие на обработку перс. данных

Responses

Response samples

Получить правила лояльности

Responses

Response samples

Сайты

Получить информацию о странице сайта

path Parameters

Responses

Response samples

Категории

Получить дерево категорий

path Parameters

query Parameters

Responses

Response samples

Получить список категорий

path Parameters

query Parameters

Responses

Response samples

Получить категорию

path Parameters

query Parameters

Responses

Response samples

Получить список групп характеристик для категории

path Parameters

Responses

Response samples

Получить список характеристик для категории

path Parameters

Responses

Response samples

Коллекции товаров

Получить список коллекций

path Parameters

query Parameters

Responses

Response samples

Получить коллекцию

path Parameters

Responses

Response samples

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required