Zenky Storefront API (v1)

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

Последнее обновление: Fri, 11 Oct 2024 07:15:37 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-токен, который использовался для выполнения запроса, в этом случае мы не будем его инвалидировать, если только это не потребуется для решения проблемы.

Authentication

Bearer

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

Пожалуста, обратите внимание, что токены, созданные в одном магазине, не будут работать в другом магазине.

Передавайте полученный в ходе аутентификации токен покупателя в HTTP-заголовке Authorization в формате Bearer <TOKEN>, заменив <TOKEN> на актуальное значение токена.

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

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

Security Scheme Type	HTTP
HTTP Authorization Scheme	bearer

Магазин

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

path Parameters

store

required

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
},
"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": "monday",
"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",
"orders": {"authentication_method": "disabled",
"use_early_delivery": true,
"addresses_provider": "dadata",
"repeats": {"enabled": true
}
},
"products": {"use_stock_filter": false
},
"loyalty": {"enabled": true
},
"recaptcha": null,
"websockets": {"app_id": "95ef1441-4bf6-40e7-9d24-6c9ca32b03c1",
"app_key": "OpHi2HcEEtGFjx33Zi9IDCvhjVw6BvWI",
"options": {"host": "wss.zenky.io",
"port": 443
}
}
}
}
}

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

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
},
"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": "monday",
"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",
"orders": {"authentication_method": "disabled",
"use_early_delivery": true,
"addresses_provider": "dadata",
"repeats": {"enabled": true
}
},
"products": {"use_stock_filter": false
},
"loyalty": {"enabled": true
},
"recaptcha": null,
"websockets": {"app_id": "95ef1441-4bf6-40e7-9d24-6c9ca32b03c1",
"app_key": "OpHi2HcEEtGFjx33Zi9IDCvhjVw6BvWI",
"options": {"host": "wss.zenky.io",
"port": 443
}
}
}
}
}

Категории

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

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

Включение	Описание
`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 Поле сортировки

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`	Группы модификаторов
`variants`	Варианты товара
`variants.prices`	Варианты и цены
`variants.dimensions`	Варианты и габариты
`variants.remainders`	Варианты и остатки
`variants.options.option`	Варианты, опции вариантов и их значения
`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,
"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
}
}
],
"variants": [{"id": "92766ffe-4265-4836-a8b4-92f64b090d97",
"sku": "IPHONE12-25",
"barcode": "IPHONE12-25",
"name": "iPhone 12 Pro Белый 128 ГБ",
"price": 0,
"original_price": {"value": 9999000,
"short": "99 990",
"trimmed": "99990",
"full": "99 990₽",
"currency": {"code": "RUB",
"name": "Российский рубль",
"thousands_separator": " ",
"decimals_separator": ".",
"prefix": "",
"suffix": "₽",
"symbol": "₽"
}
},
"discount": {"difference": 0,
"percentage": 0
},
"default_modifiers": null,
"prices": [{"stock_id": null,
"price": 0,
"original_price": 9999000,
"discount": {"difference": 1999800,
"percentage": 20
}
}
],
"dimensions": [{"dimension": "weight",
"type": "netto",
"value": 187
}
],
"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
},
"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
}
]
},
"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`	Группы модификаторов
`variants`	Варианты товара
`variants.prices`	Варианты и цены
`variants.dimensions`	Варианты и габариты
`variants.remainders`	Варианты и остатки
`variants.options.option`	Варианты, опции вариантов и их значения
`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,
"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
}
}
],
"variants": [{"id": "92766ffe-4265-4836-a8b4-92f64b090d97",
"sku": "IPHONE12-25",
"barcode": "IPHONE12-25",
"name": "iPhone 12 Pro Белый 128 ГБ",
"price": 0,
"original_price": {"value": 9999000,
"short": "99 990",
"trimmed": "99990",
"full": "99 990₽",
"currency": {"code": "RUB",
"name": "Российский рубль",
"thousands_separator": " ",
"decimals_separator": ".",
"prefix": "",
"suffix": "₽",
"symbol": "₽"
}
},
"discount": {"difference": 0,
"percentage": 0
},
"default_modifiers": null,
"prices": [{"stock_id": null,
"price": 0,
"original_price": 9999000,
"discount": {"difference": 1999800,
"percentage": 20
}
}
],
"dimensions": [{"dimension": "weight",
"type": "netto",
"value": 187
}
],
"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
},
"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
}
]
},
"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

Array of objects

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

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"
}
}

Адреса

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

path Parameters

store

required

string

ID магазина

Request Body schema: application/json

query	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
}
}
]
}
]
}

Заказы

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

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

Включение	Описание
`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": "string",
"submitted_at": "string",
"deliver_at": "string",
"meta_data": {"deliver_at": "string",
"on_premise": {"table": "string"
}
},
"status": {"id": "string",
"kind": "pending",
"name": "string",
"transitioned_at": "string"
},
"variants": [{"id": "string",
"product_id": "string",
"product_variant_id": "string",
"stock_id": "string",
"promotion": {"id": "string",
"reward_id": "string"
},
"quantity": 0,
"has_measured_quantity": true,
"measured_quantity": 0,
"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,
"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
}
}
],
"variants": [{"id": "92766ffe-4265-4836-a8b4-92f64b090d97",
"sku": "IPHONE12-25",
"barcode": "IPHONE12-25",
"name": "iPhone 12 Pro Белый 128 ГБ",
"price": 0,
"original_price": {"value": 9999000,
"short": "99 990",
"trimmed": "99990",
"full": "99 990₽",
"currency": {"code": "RUB",
"name": "Российский рубль",
"thousands_separator": " ",
"decimals_separator": ".",
"prefix": "",
"suffix": "₽",
"symbol": "₽"
}
},
"discount": {"difference": 0,
"percentage": 0
},
"default_modifiers": null,
"prices": [{"stock_id": null,
"price": null,
"original_price": null,
"discount": null
}
],
"dimensions": [{"dimension": 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
},
"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 ГБ",
"price": 0,
"original_price": {"value": 9999000,
"short": "99 990",
"trimmed": "99990",
"full": "99 990₽",
"currency": {"code": "RUB",
"name": "Российский рубль",
"thousands_separator": " ",
"decimals_separator": ".",
"prefix": "",
"suffix": "₽",
"symbol": "₽"
}
},
"discount": {"difference": 0,
"percentage": 0
},
"default_modifiers": null,
"prices": [{"stock_id": null,
"price": 0,
"original_price": 9999000,
"discount": {"difference": 1999800,
"percentage": 20
}
}
],
"dimensions": [{"dimension": "weight",
"type": "netto",
"value": 187
}
],
"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
},
"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
},
"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": "monday",
"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": "monday",
"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",
"first_name": "Иван",
"last_name": "Иванов",
"phone": {"country": "RU",
"number": "+79641234567",
"national": "+7 (964) 123-45-67"
},
"gender": "male",
"birth_date": "string",
"registered_at": "string",
"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,
"cashback_rate": 20,
"payment_rate": 50
},
"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": "pending",
"name": "string",
"transitioned_at": "string"
}
],
"progress": [{"id": "string",
"kind": "pending",
"name": "string",
"transitioned_at": "string"
}
],
"payments": [{"id": "string",
"type": "payment",
"status": "pending",
"method": "cash",
"amount": 0,
"created_at": "string",
"confirmed_at": "string",
"authorization_confirmed_at": "string",
"cancelled_at": "string",
"refunded_at": "string",
"refund_failed_at": "string",
"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"
}
}
]
}

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

path Parameters

store

required

string

ID магазина

Request Body schema: application/json

city_id

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": "string",
"submitted_at": "string",
"deliver_at": "string",
"meta_data": {"deliver_at": "string",
"on_premise": {"table": "string"
}
},
"status": {"id": "string",
"kind": "pending",
"name": "string",
"transitioned_at": "string"
},
"variants": [{"id": "string",
"product_id": "string",
"product_variant_id": "string",
"stock_id": "string",
"promotion": {"id": "string",
"reward_id": "string"
},
"quantity": 0,
"has_measured_quantity": true,
"measured_quantity": 0,
"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,
"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
}
}
],
"variants": [{"id": "92766ffe-4265-4836-a8b4-92f64b090d97",
"sku": "IPHONE12-25",
"barcode": "IPHONE12-25",
"name": "iPhone 12 Pro Белый 128 ГБ",
"price": 0,
"original_price": {"value": 9999000,
"short": "99 990",
"trimmed": "99990",
"full": "99 990₽",
"currency": {"code": "RUB",
"name": "Российский рубль",
"thousands_separator": " ",
"decimals_separator": ".",
"prefix": "",
"suffix": "₽",
"symbol": "₽"
}
},
"discount": {"difference": 0,
"percentage": 0
},
"default_modifiers": null,
"prices": [{"stock_id": null,
"price": 0,
"original_price": 9999000,
"discount": {"difference": 1999800,
"percentage": 20
}
}
],
"dimensions": [{"dimension": "weight",
"type": "netto",
"value": 187
}
],
"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
},
"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
}
]
},
"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 ГБ",
"price": 0,
"original_price": {"value": 9999000,
"short": "99 990",
"trimmed": "99990",
"full": "99 990₽",
"currency": {"code": "RUB",
"name": "Российский рубль",
"thousands_separator": " ",
"decimals_separator": ".",
"prefix": "",
"suffix": "₽",
"symbol": "₽"
}
},
"discount": {"difference": 0,
"percentage": 0
},
"default_modifiers": null,
"prices": [{"stock_id": null,
"price": 0,
"original_price": 9999000,
"discount": {"difference": 1999800,
"percentage": 20
}
}
],
"dimensions": [{"dimension": "weight",
"type": "netto",
"value": 187
}
],
"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
},
"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
},
"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": "monday",
"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": "monday",
"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",
"first_name": "Иван",
"last_name": "Иванов",
"phone": {"country": "RU",
"number": "+79641234567",
"national": "+7 (964) 123-45-67"
},
"gender": "male",
"birth_date": "string",
"registered_at": "string",
"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,
"cashback_rate": 20,
"payment_rate": 50
},
"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": "pending",
"name": "string",
"transitioned_at": "string"
}
],
"progress": [{"id": "string",
"kind": "pending",
"name": "string",
"transitioned_at": "string"
}
],
"payments": [{"id": "string",
"type": "payment",
"status": "pending",
"method": "cash",
"amount": 0,
"created_at": "string",
"confirmed_at": "string",
"authorization_confirmed_at": "string",
"cancelled_at": "string",
"refunded_at": "string",
"refund_failed_at": "string",
"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"
}
}
}

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

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

Включение	Описание
`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`	Интервал доставки

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": "string",
"submitted_at": "string",
"deliver_at": "string",
"meta_data": {"deliver_at": "string",
"on_premise": {"table": "string"
}
},
"status": {"id": "string",
"kind": "pending",
"name": "string",
"transitioned_at": "string"
},
"variants": [{"id": "string",
"product_id": "string",
"product_variant_id": "string",
"stock_id": "string",
"promotion": {"id": "string",
"reward_id": "string"
},
"quantity": 0,
"has_measured_quantity": true,
"measured_quantity": 0,
"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,
"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
}
}
],
"variants": [{"id": "92766ffe-4265-4836-a8b4-92f64b090d97",
"sku": "IPHONE12-25",
"barcode": "IPHONE12-25",
"name": "iPhone 12 Pro Белый 128 ГБ",
"price": 0,
"original_price": {"value": 9999000,
"short": "99 990",
"trimmed": "99990",
"full": "99 990₽",
"currency": {"code": "RUB",
"name": "Российский рубль",
"thousands_separator": " ",
"decimals_separator": ".",
"prefix": "",
"suffix": "₽",
"symbol": "₽"
}
},
"discount": {"difference": 0,
"percentage": 0
},
"default_modifiers": null,
"prices": [{"stock_id": null,
"price": 0,
"original_price": 9999000,
"discount": {"difference": 1999800,
"percentage": 20
}
}
],
"dimensions": [{"dimension": "weight",
"type": "netto",
"value": 187
}
],
"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
},
"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
}
]
},
"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 ГБ",
"price": 0,
"original_price": {"value": 9999000,
"short": "99 990",
"trimmed": "99990",
"full": "99 990₽",
"currency": {"code": "RUB",
"name": "Российский рубль",
"thousands_separator": " ",
"decimals_separator": ".",
"prefix": "",
"suffix": "₽",
"symbol": "₽"
}
},
"discount": {"difference": 0,
"percentage": 0
},
"default_modifiers": null,
"prices": [{"stock_id": null,
"price": 0,
"original_price": 9999000,
"discount": {"difference": 1999800,
"percentage": 20
}
}
],
"dimensions": [{"dimension": "weight",
"type": "netto",
"value": 187
}
],
"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
},
"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
},
"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": "monday",
"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": "monday",
"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",
"first_name": "Иван",
"last_name": "Иванов",
"phone": {"country": "RU",
"number": "+79641234567",
"national": "+7 (964) 123-45-67"
},
"gender": "male",
"birth_date": "string",
"registered_at": "string",
"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,
"cashback_rate": 20,
"payment_rate": 50
},
"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": "pending",
"name": "string",
"transitioned_at": "string"
}
],
"progress": [{"id": "string",
"kind": "pending",
"name": "string",
"transitioned_at": "string"
}
],
"payments": [{"id": "string",
"type": "payment",
"status": "pending",
"method": "cash",
"amount": 0,
"created_at": "string",
"confirmed_at": "string",
"authorization_confirmed_at": "string",
"cancelled_at": "string",
"refunded_at": "string",
"refund_failed_at": "string",
"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"
}
}
}

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

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

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

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

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

Responses

Request samples

Payload

Content type

application/json

{"product_variant_id": "b11f7b7f-5f41-4bc2-97fa-7df49225a2ba",
"quantity": 1,
"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": "string",
"submitted_at": "string",
"deliver_at": "string",
"meta_data": {"deliver_at": "string",
"on_premise": {"table": "string"
}
},
"status": {"id": "string",
"kind": "pending",
"name": "string",
"transitioned_at": "string"
},
"variants": [{"id": "string",
"product_id": "string",
"product_variant_id": "string",
"stock_id": "string",
"promotion": {"id": "string",
"reward_id": "string"
},
"quantity": 0,
"has_measured_quantity": true,
"measured_quantity": 0,
"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,
"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
}
}
],
"variants": [{"id": "92766ffe-4265-4836-a8b4-92f64b090d97",
"sku": "IPHONE12-25",
"barcode": "IPHONE12-25",
"name": "iPhone 12 Pro Белый 128 ГБ",
"price": 0,
"original_price": {"value": 9999000,
"short": "99 990",
"trimmed": "99990",
"full": "99 990₽",
"currency": {"code": "RUB",
"name": "Российский рубль",
"thousands_separator": " ",
"decimals_separator": ".",
"prefix": "",
"suffix": "₽",
"symbol": "₽"
}
},
"discount": {"difference": 0,
"percentage": 0
},
"default_modifiers": null,
"prices": [{"stock_id": null,
"price": 0,
"original_price": 9999000,
"discount": {"difference": 1999800,
"percentage": 20
}
}
],
"dimensions": [{"dimension": "weight",
"type": "netto",
"value": 187
}
],
"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
},
"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
}
]
},
"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 ГБ",
"price": 0,
"original_price": {"value": 9999000,
"short": "99 990",
"trimmed": "99990",
"full": "99 990₽",
"currency": {"code": "RUB",
"name": "Российский рубль",
"thousands_separator": " ",
"decimals_separator": ".",
"prefix": "",
"suffix": "₽",
"symbol": "₽"
}
},
"discount": {"difference": 0,
"percentage": 0
},
"default_modifiers": null,
"prices": [{"stock_id": null,
"price": 0,
"original_price": 9999000,
"discount": {"difference": 1999800,
"percentage": 20
}
}
],
"dimensions": [{"dimension": "weight",
"type": "netto",
"value": 187
}
],
"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
},
"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
},
"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": "monday",
"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": "monday",
"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",
"first_name": "Иван",
"last_name": "Иванов",
"phone": {"country": "RU",
"number": "+79641234567",
"national": "+7 (964) 123-45-67"
},
"gender": "male",
"birth_date": "string",
"registered_at": "string",
"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,
"cashback_rate": 20,
"payment_rate": 50
},
"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": "pending",
"name": "string",
"transitioned_at": "string"
}
],
"progress": [{"id": "string",
"kind": "pending",
"name": "string",
"transitioned_at": "string"
}
],
"payments": [{"id": "string",
"type": "payment",
"status": "pending",
"method": "cash",
"amount": 0,
"created_at": "string",
"confirmed_at": "string",
"authorization_confirmed_at": "string",
"cancelled_at": "string",
"refunded_at": "string",
"refund_failed_at": "string",
"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"
}
}
}

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

path Parameters

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

query Parameters

token

string

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

Request Body schema: application/json

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

Responses

Request samples

Payload

Content type

application/json

{"product_variant_id": "b11f7b7f-5f41-4bc2-97fa-7df49225a2ba",
"quantity": 1,
"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": "string",
"submitted_at": "string",
"deliver_at": "string",
"meta_data": {"deliver_at": "string",
"on_premise": {"table": "string"
}
},
"status": {"id": "string",
"kind": "pending",
"name": "string",
"transitioned_at": "string"
},
"variants": [{"id": "string",
"product_id": "string",
"product_variant_id": "string",
"stock_id": "string",
"promotion": {"id": "string",
"reward_id": "string"
},
"quantity": 0,
"has_measured_quantity": true,
"measured_quantity": 0,
"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,
"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
}
}
],
"variants": [{"id": "92766ffe-4265-4836-a8b4-92f64b090d97",
"sku": "IPHONE12-25",
"barcode": "IPHONE12-25",
"name": "iPhone 12 Pro Белый 128 ГБ",
"price": 0,
"original_price": {"value": 9999000,
"short": "99 990",
"trimmed": "99990",
"full": "99 990₽",
"currency": {"code": "RUB",
"name": "Российский рубль",
"thousands_separator": " ",
"decimals_separator": ".",
"prefix": "",
"suffix": "₽",
"symbol": "₽"
}
},
"discount": {"difference": 0,
"percentage": 0
},
"default_modifiers": null,
"prices": [{"stock_id": null,
"price": 0,
"original_price": 9999000,
"discount": {"difference": 1999800,
"percentage": 20
}
}
],
"dimensions": [{"dimension": "weight",
"type": "netto",
"value": 187
}
],
"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
},
"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
}
]
},
"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 ГБ",
"price": 0,
"original_price": {"value": 9999000,
"short": "99 990",
"trimmed": "99990",
"full": "99 990₽",
"currency": {"code": "RUB",
"name": "Российский рубль",
"thousands_separator": " ",
"decimals_separator": ".",
"prefix": "",
"suffix": "₽",
"symbol": "₽"
}
},
"discount": {"difference": 0,
"percentage": 0
},
"default_modifiers": null,
"prices": [{"stock_id": null,
"price": 0,
"original_price": 9999000,
"discount": {"difference": 1999800,
"percentage": 20
}
}
],
"dimensions": [{"dimension": "weight",
"type": "netto",
"value": 187
}
],
"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
},
"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
},
"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": "monday",
"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": "monday",
"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",
"first_name": "Иван",
"last_name": "Иванов",
"phone": {"country": "RU",
"number": "+79641234567",
"national": "+7 (964) 123-45-67"
},
"gender": "male",
"birth_date": "string",
"registered_at": "string",
"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,
"cashback_rate": 20,
"payment_rate": 50
},
"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": "pending",
"name": "string",
"transitioned_at": "string"
}
],
"progress": [{"id": "string",
"kind": "pending",
"name": "string",
"transitioned_at": "string"
}
],
"payments": [{"id": "string",
"type": "payment",
"status": "pending",
"method": "cash",
"amount": 0,
"created_at": "string",
"confirmed_at": "string",
"authorization_confirmed_at": "string",
"cancelled_at": "string",
"refunded_at": "string",
"refund_failed_at": "string",
"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"
}
}
}

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

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

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

В зависимости от настроек магазина, в поле 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"
}
}

Оформление

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

path Parameters

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

query Parameters

token

string

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

Request Body schema: application/json

	object Телефон покупателя (обязателен, если нет токена аутентификации)
first_name	string Имя покупателя
last_name	string Фамилия покупателя
gender	string 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

delivery_method	string Enum: "delivery" "pickup" "on_premise" Способ доставки
	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": "string",
"submitted_at": "string",
"deliver_at": "string",
"meta_data": {"deliver_at": "string",
"on_premise": {"table": "string"
}
},
"status": {"id": "string",
"kind": "pending",
"name": "string",
"transitioned_at": "string"
},
"variants": [{"id": "string",
"product_id": "string",
"product_variant_id": "string",
"stock_id": "string",
"promotion": {"id": "string",
"reward_id": "string"
},
"quantity": 0,
"has_measured_quantity": true,
"measured_quantity": 0,
"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,
"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
}
}
],
"variants": [{"id": "92766ffe-4265-4836-a8b4-92f64b090d97",
"sku": "IPHONE12-25",
"barcode": "IPHONE12-25",
"name": "iPhone 12 Pro Белый 128 ГБ",
"price": 0,
"original_price": {"value": 9999000,
"short": "99 990",
"trimmed": "99990",
"full": "99 990₽",
"currency": {"code": "RUB",
"name": "Российский рубль",
"thousands_separator": " ",
"decimals_separator": ".",
"prefix": "",
"suffix": "₽",
"symbol": "₽"
}
},
"discount": {"difference": 0,
"percentage": 0
},
"default_modifiers": null,
"prices": [{"stock_id": null,
"price": 0,
"original_price": 9999000,
"discount": {"difference": 1999800,
"percentage": 20
}
}
],
"dimensions": [{"dimension": "weight",
"type": "netto",
"value": 187
}
],
"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
},
"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
}
]
},
"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 ГБ",
"price": 0,
"original_price": {"value": 9999000,
"short": "99 990",
"trimmed": "99990",
"full": "99 990₽",
"currency": {"code": "RUB",
"name": "Российский рубль",
"thousands_separator": " ",
"decimals_separator": ".",
"prefix": "",
"suffix": "₽",
"symbol": "₽"
}
},
"discount": {"difference": 0,
"percentage": 0
},
"default_modifiers": null,
"prices": [{"stock_id": null,
"price": 0,
"original_price": 9999000,
"discount": {"difference": 1999800,
"percentage": 20
}
}
],
"dimensions": [{"dimension": "weight",
"type": "netto",
"value": 187
}
],
"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
},
"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
},
"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": "monday",
"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": "monday",
"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",
"first_name": "Иван",
"last_name": "Иванов",
"phone": {"country": "RU",
"number": "+79641234567",
"national": "+7 (964) 123-45-67"
},
"gender": "male",
"birth_date": "string",
"registered_at": "string",
"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,
"cashback_rate": 20,
"payment_rate": 50
},
"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": "pending",
"name": "string",
"transitioned_at": "string"
}
],
"progress": [{"id": "string",
"kind": "pending",
"name": "string",
"transitioned_at": "string"
}
],
"payments": [{"id": "string",
"type": "payment",
"status": "pending",
"method": "cash",
"amount": 0,
"created_at": "string",
"confirmed_at": "string",
"authorization_confirmed_at": "string",
"cancelled_at": "string",
"refunded_at": "string",
"refund_failed_at": "string",
"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"
}
}
}

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

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

path Parameters

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

query Parameters

token

string

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

Request Body schema: application/json

object

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

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": "string",
"submitted_at": "string",
"deliver_at": "string",
"meta_data": {"deliver_at": "string",
"on_premise": {"table": "string"
}
},
"status": {"id": "string",
"kind": "pending",
"name": "string",
"transitioned_at": "string"
},
"variants": [{"id": "string",
"product_id": "string",
"product_variant_id": "string",
"stock_id": "string",
"promotion": {"id": "string",
"reward_id": "string"
},
"quantity": 0,
"has_measured_quantity": true,
"measured_quantity": 0,
"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,
"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
}
}
],
"variants": [{"id": "92766ffe-4265-4836-a8b4-92f64b090d97",
"sku": "IPHONE12-25",
"barcode": "IPHONE12-25",
"name": "iPhone 12 Pro Белый 128 ГБ",
"price": 0,
"original_price": {"value": 9999000,
"short": "99 990",
"trimmed": "99990",
"full": "99 990₽",
"currency": {"code": "RUB",
"name": "Российский рубль",
"thousands_separator": " ",
"decimals_separator": ".",
"prefix": "",
"suffix": "₽",
"symbol": "₽"
}
},
"discount": {"difference": 0,
"percentage": 0
},
"default_modifiers": null,
"prices": [{"stock_id": null,
"price": 0,
"original_price": 9999000,
"discount": {"difference": 1999800,
"percentage": 20
}
}
],
"dimensions": [{"dimension": "weight",
"type": "netto",
"value": 187
}
],
"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
},
"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
}
]
},
"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 ГБ",
"price": 0,
"original_price": {"value": 9999000,
"short": "99 990",
"trimmed": "99990",
"full": "99 990₽",
"currency": {"code": "RUB",
"name": "Российский рубль",
"thousands_separator": " ",
"decimals_separator": ".",
"prefix": "",
"suffix": "₽",
"symbol": "₽"
}
},
"discount": {"difference": 0,
"percentage": 0
},
"default_modifiers": null,
"prices": [{"stock_id": null,
"price": 0,
"original_price": 9999000,
"discount": {"difference": 1999800,
"percentage": 20
}
}
],
"dimensions": [{"dimension": "weight",
"type": "netto",
"value": 187
}
],
"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
},
"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
},
"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": "monday",
"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": "monday",
"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",
"first_name": "Иван",
"last_name": "Иванов",
"phone": {"country": "RU",
"number": "+79641234567",
"national": "+7 (964) 123-45-67"
},
"gender": "male",
"birth_date": "string",
"registered_at": "string",
"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,
"cashback_rate": 20,
"payment_rate": 50
},
"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": "pending",
"name": "string",
"transitioned_at": "string"
}
],
"progress": [{"id": "string",
"kind": "pending",
"name": "string",
"transitioned_at": "string"
}
],
"payments": [{"id": "string",
"type": "payment",
"status": "pending",
"method": "cash",
"amount": 0,
"created_at": "string",
"confirmed_at": "string",
"authorization_confirmed_at": "string",
"cancelled_at": "string",
"refunded_at": "string",
"refund_failed_at": "string",
"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"
}
}
}

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

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

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

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

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

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

path Parameters

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

query Parameters

token

string

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

Request Body schema: application/json

Array of objects

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

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": "cash",
"amount": 0,
"created_at": "string",
"confirmed_at": "string",
"authorization_confirmed_at": "string",
"cancelled_at": "string",
"refunded_at": "string",
"refund_failed_at": "string",
"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
}
}

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

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,
"discount": 0,
"total": 0,
"original_total": 0,
"max_bonuses_payment": 0,
"cashback": 0,
"payments": [{"id": "string",
"method": "cash",
"amount": 0,
"bill": 0,
"change": 0,
"save_card": true,
"card_token_id": "string"
}
]
}
}

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

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

Если поле 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

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": "sms",
"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": "string",
"submitted_at": "string",
"deliver_at": "string",
"meta_data": {"deliver_at": "string",
"on_premise": {"table": "string"
}
},
"status": {"id": "string",
"kind": "pending",
"name": "string",
"transitioned_at": "string"
},
"variants": [{"id": "string",
"product_id": "string",
"product_variant_id": "string",
"stock_id": "string",
"promotion": {"id": "string",
"reward_id": "string"
},
"quantity": 0,
"has_measured_quantity": true,
"measured_quantity": 0,
"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,
"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
}
}
],
"variants": [{"id": "92766ffe-4265-4836-a8b4-92f64b090d97",
"sku": "IPHONE12-25",
"barcode": "IPHONE12-25",
"name": "iPhone 12 Pro Белый 128 ГБ",
"price": 0,
"original_price": {"value": 9999000,
"short": "99 990",
"trimmed": "99990",
"full": "99 990₽",
"currency": {"code": "RUB",
"name": "Российский рубль",
"thousands_separator": " ",
"decimals_separator": ".",
"prefix": "",
"suffix": "₽",
"symbol": "₽"
}
},
"discount": {"difference": 0,
"percentage": 0
},
"default_modifiers": null,
"prices": [{"stock_id": null,
"price": null,
"original_price": null,
"discount": null
}
],
"dimensions": [{"dimension": 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
},
"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 ГБ",
"price": 0,
"original_price": {"value": 9999000,
"short": "99 990",
"trimmed": "99990",
"full": "99 990₽",
"currency": {"code": "RUB",
"name": "Российский рубль",
"thousands_separator": " ",
"decimals_separator": ".",
"prefix": "",
"suffix": "₽",
"symbol": "₽"
}
},
"discount": {"difference": 0,
"percentage": 0
},
"default_modifiers": null,
"prices": [{"stock_id": null,
"price": 0,
"original_price": 9999000,
"discount": {"difference": 1999800,
"percentage": 20
}
}
],
"dimensions": [{"dimension": "weight",
"type": "netto",
"value": 187
}
],
"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
},
"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
},
"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": "monday",
"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": "monday",
"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",
"first_name": "Иван",
"last_name": "Иванов",
"phone": {"country": "RU",
"number": "+79641234567",
"national": "+7 (964) 123-45-67"
},
"gender": "male",
"birth_date": "string",
"registered_at": "string",
"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,
"cashback_rate": 20,
"payment_rate": 50
},
"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": "pending",
"name": "string",
"transitioned_at": "string"
}
],
"progress": [{"id": "string",
"kind": "pending",
"name": "string",
"transitioned_at": "string"
}
],
"payments": [{"id": "string",
"type": "payment",
"status": "pending",
"method": "cash",
"amount": 0,
"created_at": "string",
"confirmed_at": "string",
"authorization_confirmed_at": "string",
"cancelled_at": "string",
"refunded_at": "string",
"refund_failed_at": "string",
"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"
}
}
}
}

Подтверждение

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

path Parameters

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

query Parameters

token

string

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

Request Body schema: application/json

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

Responses

Request samples

Payload

Content type

application/json

{"code": 0
}

Response samples

Content type

application/json

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

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

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": "sms"
}
}

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

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

path Parameters

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

query Parameters

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

Responses

Response samples

Content type

application/json

{"data": [{"id": "string",
"order_id": "string",
"type": "increase",
"status": "pending",
"reason": "manual",
"amount": 0,
"source_amount": 0,
"created_at": "string",
"confirmed_at": "string",
"cancelled_at": "string"
}
]
}

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

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": "increase",
"status": "pending",
"reason": "manual",
"amount": 0,
"source_amount": 0,
"created_at": "string",
"confirmed_at": "string",
"cancelled_at": "string"
}
}

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

Этот метод запускает фоновую проверку акций, а результат проверки отправляет в вебсокет-соединение событиями 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
}
]
}

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

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

Возможные ошибки 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

	object Телефон покупателя
password	string Пароль покупателя (от 8 символов)
first_name	string Имя покупателя
last_name	string Фамилия покупателя
gender	string 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": "sms"
}
}

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

Возможные ошибки 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

	object Телефон покупателя
	number or string Код подтверждения
password	string Пароль покупателя (от 8 символов)
first_name	string Имя покупателя
last_name	string Фамилия покупателя
gender	string 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

object

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

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": "sms"
}
}

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

Возможные ошибки 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

object

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

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": "sms"
}
}

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

Возможные ошибки 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

	object Телефон покупателя
	number or string Код сброса пароля
password	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

	object Телефон покупателя
password	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": "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9...."
}
}

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

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

path Parameters

store

required

string

ID магазина

Request Body schema: application/json

object

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

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
}
}

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

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

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

Включение	Описание
`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",
"first_name": "Иван",
"last_name": "Иванов",
"phone": {"country": "RU",
"number": "+79641234567",
"national": "+7 (964) 123-45-67"
},
"gender": "male",
"birth_date": "string",
"registered_at": "string",
"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,
"cashback_rate": 20,
"payment_rate": 50
},
"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

first_name	string Имя покупателя
last_name	string Фамилия покупателя
gender	string 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",
"first_name": "Иван",
"last_name": "Иванов",
"phone": {"country": "RU",
"number": "+79641234567",
"national": "+7 (964) 123-45-67"
},
"gender": "male",
"birth_date": "string",
"registered_at": "string",
"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,
"cashback_rate": 20,
"payment_rate": 50
},
"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

password

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

object

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

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

object

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

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

object

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

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": "visa",
"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 Enum: "increase" "decrease" Тип транзакции (`increase` – пополнение, `decrease` – списание)
status	string Enum: "pending" "confirmed" "cancelled" "refunded" Статус транзакции (`pending` – ожидает подтверждения, `confirmed` – подтверждена, `cancelled` – отменена, `refunded` – возвращена).
reason	string Enum: "manual" "cashback" "referral_reward" "recruit_reward" "payment" "cancellation" "refund" "adjustment" "welcome_bonuses" "promotion_reward" "external" Причина создания транзакции
order_id	string ID связанного заказа

Responses

Response samples

Content type

application/json

{"data": [{"id": "string",
"order_id": "string",
"type": "increase",
"status": "pending",
"reason": "manual",
"amount": 0,
"source_amount": 0,
"created_at": "string",
"confirmed_at": "string",
"cancelled_at": "string"
}
]
}

Акции

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

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

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

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

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

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

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
}
}
}
}
}

Статьи

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

Этот метод поддерживает следующие поля сортировки (передаются в параметре 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": "string",
"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": "string",
"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

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": "string"
}
}

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

path Parameters

store

required

string

ID магазина

Request Body schema: application/json

object

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

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>"
}
}

Ошибка API

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

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

object

{"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"
}