История изменений

• Май 2021
• Апрель 2021
• Март 2021
• Февраль 2021
• 2020 год
• 2019 год

Май 2021

3 мая

• Добавлена документация изменения способа оплаты оформленного заказа.

Апрель 2021

28 апреля

• В структуру товара добавлено поле share;
• К типам статуса заказа добавлены значения awaiting_payment, ready, awaiting_delivery и delivered;
• Добавлена документация API начисленных за заказ бонусов.

Март 2021

16 марта

• В структуру контактов добавлено поле phone_country (заполняется только для телефонных контаков);
• В структуру настроек магазина добавлено поле locale с информацией о локали магазина;
• В структуры настроек сайта и настроек моб. приложения добавлены поля default, хранящие в себе ID каналов продаж по умолчанию.

9 марта

• В структуру способа оплаты online, отдаваемом в API получения возможных способов оплаты заказа, добавлено поле meta;
• Добавлена документация работы со страницей онлайн оплаты заказа (на примере виджета Cloudpayments) через сторонние приложения.

Февраль 2021

9 февраля

• Добавлена документация модификаторов;
• В документацию заказов добавлена информация по добавлению, удалению и получению товаров заказа с привязанными модификаторами;
• Добавлена документация API пересчёта стоимости товара с модификаторами;
• Добавлена документация синхронизации модификаторов и групп модификаторов;
• В документацию синхронизации товаров добавлены описания полей привязки модификаторов и групп модификаторов.

Ноябрь 2020

23 ноября

• Добавлена документация настроек веб-сайта магазина;
• Добавлена документация настроек реферральной программы магазина;
• В структуру профиля программы лояльности добавлено поле referral_program с информацией о профиле реферральной программы магазина;
• В структуру настроек заказов магазина добавлены поля delivery_methods (отображает разрешённые способы доставки) и min_price (минимальная сумма заказа).

7 ноября

• Добавлена документация регистрации и аутентификации бизнес-аккаунтов.

Октябрь 2020

20 октября

• Добавлена документация скидок;
• В структуру варианта товара, заказа и позиции заказа добавлены поля оригинальной цены и суммы скидки (если имеется).

Сентябрь 2020

18 сентября

• В структуру медиа-файлов магазина добавлен медиа-файл квадратного изображения.

17 сентября

• Обновлена структура изображений — добавлены поля с размерами и поддержка WebP-формата;

Август 2020

28 августа

• Добавлена документация фильтрации товаров по видимости;
• Добавлена документация подсказок адресов;
• Добавлена документация изображений складов;
• Добавлена документация приветственных бонусов;

Июль 2020

1 июля

• Добавлена документация проверки возможности отправки заказа.

Июнь 2020

22 июня

• Добавлены настройки мобильных приложений.

Май 2020

27 мая

• Добавлена документация настроек SMS магазина;
• Добавлена документация фильтрации товаров по характеристикам;
• Добавлена документация фильтрации товаров по ценам;
• Изменены позиции бокового меню сайта документации.

19 мая

• Добавлена документация API загрузки изображений;
• Добавлена дополнительная информация о синхронизации изображений товаров.

11 мая

• Добавлены списки возможных ошибок в документацию аутентификации покупателей;
• Добавлена документация профиля покупателей;
• Добавлена документация привязанных карт покупателей;
• Добавлена документация обновления заказа и обновлена документация отправки заказа;
• Добавлена документация оплаты заказа картой онлайн и привязанной картой;
• Добавлена документация получения способов оплаты конкретного заказа.

Апрель 2020

8 апреля

• Поле password в запросе регистрации более не является обязательным;
• Запрос подтверждения регистрации дополнен дополнительными полями password, first_name, last_name, gender и birth_date. Поле password является обязательным, если оно не передавалось в запросе регистрации.

7 апреля

• Добавлена документация запроса повторной отправки кода подтверждения регистрации.

1 апреля

• Обновлена документация аутентификации покупателей.

Март 2020

25 марта

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

20 марта

• Методы привязки покупателя к заказу и отправки заказа теперь обновляют данные существующих покупателей (имя, фамилия, пол, дата рождения) только в запросах, отправленных самим покупателем или сотрудником магазина;

• Метод привязки покупателя к заказу теперь возвращает ответ с пустым телом и статусом HTTP 204 No Content вместо JSON-объекта покупателя и статуса HTTP 200 OK;

• Методы привязки адреса к заказу и отправки заказа теперь сохраняют новые адреса в списке адресов покупателя только в запросах, отправленных самим покупателем или сотрудником магазина;

• API адресов покупателей теперь требуют передачи ID магазина во все методы;

• Включения заказов customer и delivery_address теперь отдаются только для запросов, отправленных самим покупателем или сотрудником магазина. Во всех остальных случаях значением этих полей будет являться null (если поля были запрошены).

3 марта

• Обновлены примеры всех структур;
• Добавлена документация коротких идентификаторов и адресов категорий и товаров;
• Добавлена возможность отправки нескольких платёжных транзакций в запросе отправки заказа;
• Добавлена документация зон доставки;
• Добавлена документация включения statuses_progress заказов;
• Добавлена документация унифицированного API предпросмотра платежей заказа;

Декабрь 2019

25 декабря

• Добавлены глобальные фильтры created_from и created_till во все API списков;
• Добавлены фильтры city_id и delivery_method в API списка заказов;
• Добавлен API обновления заметок заказа;
• Добавлен API обновления способа доставки заказа;
• Добавлена документация интеграции с reCAPTCHA;
• Добавлена документация аутентификации заказов.

6 декабря

• Изменена структура адреса доставки;
• Изменены структуры запросов создания адреса и привязки адреса доставки к заказу.

Ноябрь 2019

20 ноября

• Добавлена документация программы лояльности:
  • настройки магазина;
  • профиль покупателя;
  • бонусные уровни;
  • кэшбэк;
  • платежи.
• Обновлена документация платежей, относящаяся к платежам бонусами.

Октябрь 2019

31 октября

• Добавлена документация метода создания адреса;
• Добавлена документация привязка адреса доставки к заказу;
• Привязка покупателя к заказу теперь должна осуществляться через поле customer. Корневые поля phone, first_name, last_name, gender и birth_date объявлены устаревшими и будут удалены в версии 3.0.

24 октября

• Поля payment_method, bonuses_amount_paid, bonuses_transaction_id, bonuses_transaction_confirmed, amount_paid и expected_payment_amount структуры заказа признаны устаревшими и будут удалены в версии 3.0. Вместо поля amount_paid необходимо использовать поле payments_summary (включение payments_summary). Вместо всех остальных полей необходимо использовать платёжные транзакции (включение payments).

• Обновлена документация отправки заказа:
  • Удалено поле payment_method — вместо него следует использовать поле payment;
  • Удалено поле address — вместо него следует использовать поле delivery_address;
  • Удалены поля phone, first_name, last_name, gender и birth_date — вместо них следует использовать поле customer.
• Добавлена документация адресов покупателей.

21 октября

• Добавлена документация отмены и возврата платежей;
• Добавлена информация об авторизации пользовательским ПИН-кодом;
• В структуру платежа заказа добавлены поля parent_id, type, status и refund_failed_at;
• Добавлена информация о смене статуса заказа.

1 октября

• Изменён домен API с my.zenky.io на api.zenky.io и добавлен путь версии API. Если раньше вы работали с API по базовому URI https://my.zenky.io/api/, то теперь вам следует использовать базовый URI https://api.zenky.io/v2/;
• Изменён домен шлюзов синхронизации с my.zenky.io на api.zenky.io и добавлен путь версии API. Если раньше вы работали со шлюзами синхронизации по базовому URI https://my.zenky.io/sync-gate/TOKEN/, то теперь вам следует использовать базовый URI https://api.zenky.io/v2/sync-gate/TOKEN/;
• Добавлена документация платёжных транзакций заказов;
• Поля payment_method, bonuses_amount_paid, bonuses_transaction_id, bonuses_transaction_confirmed, amount_paid и expected_payment_amount объявлены устаревшими и будут удалены в версии 3.0;
• Исправлена документация ошибок валидации. Ранее в указанном разделе содержалась структура, отличающаяся от фактического ответа сервера;
• Поле city_id более не является обязательным для передачи при создании заказа. Однако, отправка заказов, у которых нет привязанного города, требует передачи поля city_id.

Сентябрь 2019

23 сентября

• Добавлена документация поля visible статусов заказов.

20 сентября

• Добавлена документация массового удаления категорий, городов, характеристик, статусов заказов, товаров, складов и опций вариантов;
• Добавлена документация архивации и восстановления заказов.

18 сентября

• Добавлено поле deliver_at в структуру заказа. Это поле будет заполнено, если покупатель указал точное время доставки во время оформления заказа;
• Добавлено поле deliver_at в запрос оформления заказа;
• Добавлена информация о работе с датами и временем.

11 сентября

• Добавлена документация статусов заказов;
• Поле status в структуре заказов было отмечено как устаревшее — вместо него следует использовать поле current_status.status;
• Фильтр status в запросе списка заказов было отмечено как устаревшее — вместо него следует использовать фильтр order_status_id и передачу туда одного или нескольких (разделённых запятой) ID статусов заказов.

Июль 2019

7 июля 2019

• Добавлена документация работы с заказом.

Май 2019

28 мая 2019

• Добавлено описание структуры пользователя;
• Добавлена документация клиентской аутентификации и регистрации;
• Исправлено название включения variants.option_values.options на variants.option_values.option.

15 мая 2019

• Добавлена информация о мета-данных в ответах API;
• В структуру Цена добавлено поле trimmed.

Апрель 2019

19 апреля 2019

• Добавлена первичная документация API.