Программный интерфейс My-shop. ru для партнерских магазинов (стр. 1 )

Программный интерфейс My-shop. ru
для партнерских магазинов

Содержание

Версия.. 2

Права и обязанности партнера.. 3

Популярные вопросы. Рекомендации My-shop. ru.. 5

Общие характеристики программного интерфейса.. 8

До оформления заказа.. 11

Корзина. 11

Выбор способов доставки/оплаты.. 12

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

Оформление нового заказа. 16

После оформления заказа.. 21

Информация о состоянии заказа. 21

Аннулирование заказа. 24

Переписка клиента с операторами My-shop. ru: новое сообщение клиента. 25

Переписка клиента с операторами My-shop. ru: список сообщений.. 26

Краткий отчет об оформленных заказах. 28

Справочная информация.. 31

Проверка текущей версии API. 31

Различные константы.. 32

Информация о цене и доступности товара. 34

Справочник регионов доставки.. 36

Справочник способов доставки.. 37

Справочник способов оплаты.. 38

Справочник станций метро. 39

Справочник почтовых индексов. 40

Справочник ограничений на пересылку. 41

Справочник кодов ошибок.. 42

Прочие запросы... 43

Поиск товаров. 43

Версия

Версия описываемого в данном документе программного интерфейса (API) – 1.14.
Дата последнего изменения версии API – 24 апреля 2017 года.

Версия документа – 1.14.0.

Дата последнего изменения документа – 24 апреля 2017 г.

Что нового в версии 1.14:

Параметр «error_3012» в ответах на запросы «order_pre» (Предварительная проверка параметров заказа и расчет стоимости) и «order_new» (Оформление нового заказа).

Что нового в версии 1.13:

Параметр «discount» (Скидка, %) в ответах на все запросы считается устаревшим, его использование не рекомендуется. Данный параметр может быть удалён в следующих версиях API. (Связано с переходом от начисления скидки на заказ целиком к начислению скидки отдельно для каждого товара в заказе.) Если партнёр предоставляет скидку за счёт своего партнёрского вознаграждения, считается, что скидка, указанная в запросе, относится к основной системе скидок. Для товаров, относящихся к другим системам скидок, величина скидки вычисляется в соответствии с описанием систем скидок: http://my-shop. ru/my/helper_24 В ответе на запрос «product» (Информация о цене и доступности товара) появился параметр «ds» (код системы скидок). С помощью запроса «list_orders» (Краткий отчет об оформленных заказах) теперь можно получить значение суммы партнёрского вознаграждения за каждый заказ.

Что нового в версии 1.12:

Запрос «list_search» (Поиск товаров).

Что нового в версии 1.11:

Параметр «phone_sms» (номер мобильного телефона для SMS-уведомлений) стал обязательным при оформлении заказа (запрос «order_new»).
Изменение вступило в силу 17 августа 2013 г. Соответствующие уведомления были разосланы подписчикам рассылки «Новости партнерской программы My-shop. ru» за два с половиной месяца – 31 мая 2013 г.

Что нового в версии 1.10:

В ответе на запрос «list_regions» (Справочник регионов доставки) появился параметр «delivery_0_free» (см. описание ниже). В ответе на запрос «list_delivery» (Справочник способов доставки) появились параметры «info» и «info_importance» (см. описание ниже). C 1 декабря 2012 года использование этих параметров обязательно!

Что нового в версии 1.9:

В ответе на запрос «Различные константы» («const») в параметрах «last_modified_list_regions» и «last_modified_list_delivery» всегда возвращается текущая дата. Эти параметры больше не используются, текущая дата в значениях этих параметров возвращается для совместимости с предыдущими версиями.

Права и обязанности партнера

Участник партнерской программы, использующий данный API, имеет право:

Создавать собственные интерфейсы для выбора товаров и оформления заказов без перенаправления клиентов на сайт Интернет-магазина My-shop. ru. Вести собственную историю заказов. Создавать собственную систему регистрации клиентов. Создавать собственные интерфейсы для реализации «личных кабинетов» клиентов с информацией об оформленных ранее заказах и пр. Использовать собственную систему оповещения клиентов о ходе выполнения их заказов.
Начиная с сентября 2013 г., мы не рекомендуем этого делать, т. к. предоставляем всем клиентам, оформившим заказ в партнерском магазине, доступ к странице заказа на сайте Интернет-магазина My-shop. ru. На этой странице клиент может проверять состояние заказа, вносить изменения в заказ и вести переписку с операторами магазина. Кроме того, таким клиентам отправляются SMS-уведомления о ходе выполнения заказа. Предоставлять клиентам скидки за счет своего партнерского вознаграждения, создавать собственную накопительную систему скидок. Проводить рекламные акции с предоставлением скидок за счет своего партнерского вознаграждения. Ограничивать ассортимент товаров. Использовать собственные ограничения списка регионов доставки. Использовать собственные ограничения набора способов доставки. Использовать собственные ограничения набора способов оплаты.

Участник партнерской программы, использующий данный API, обязан:

Не допускать разглашения кода для аутентификации партнерского магазина. Изменять код для аутентификации партнерского магазина не реже одного раза в год. Не допускать разглашения персональных данных клиентов и информации о заказах клиентов. Разместить на индексируемой странице сайта партнерского магазина ссылку на Интернет-магазин My-shop. ru. Информировать клиентов о том, что заказы выполняет «Интернет-магазин My-shop. ru», а сайт, на котором оформляется заказ, является партнером My-shop. ru. Показывать клиентам текст, возвращаемый данным API в параметре «conditions» в ответ на запрос «const» («Различные константы»). Данный текст должен располагаться над кнопкой «Подтвердить заказ». Перед указанным текстом должна быть примерно такая фраза: «Нажимая кнопку "Подтвердить заказ", Вы подтверждаете свое согласие со следующими условиями». Сам текст может располагаться в поле «textarea», но при этом в видимой части данного поля (без прокрутки) должны находиться, как минимум, первый пункт и первые две строки второго пункта условий. Данный текст должен быть хорошо виден, его затемнение и/или уменьшение размера шрифта не допускается. Предоставлять клиентам достоверную информацию о товарах и услугах Интернет-магазина My-shop. ru. Перед подтверждением заказа клиентом сообщать ему итоговую стоимость заказа и ориентировочную дату отгрузки заказа (для заказов с предоплатой – ориентировочный срок формирования заказа), предлагать клиентам проверять прочие параметры заказа. Сообщать клиенту номер оформленного им заказа (номер заказа в My-shop. ru) и настоятельно рекомендовать сохранять этот номер до момента получения заказа. По запросу клиента предоставлять контактную информацию Интернет-магазина My-shop. ru (см. раздел «Различные константы»). При передаче параметров, имена которых в настоящем описании программного интерфейса выделены красным, использовать только значения, указанные клиентами. Кэшировать справочную информацию в соответствии с рекомендациями, приведенными в настоящем описании программного интерфейса. Выполнять прочие требования, указанные в настоящем описании программного интерфейса. Не производить электронные, SMS и прочие рассылки от имени Интернет-магазина My-shop. ru или с упоминанием Интернет-магазина My-shop. ru без согласия администрации My-shop. ru, данного в письменной форме.

Интернет-магазин My-shop. ru имеет право в любой момент проверять работу партнерского магазина, в том числе, оформляя тестовые заказы, а при выявлении нарушений, запрещать прием заказов через партнерский магазин. При выявлении грубых нарушений возможна полная блокировка регистрационной записи партнера без выплаты вознаграждения.

Популярные вопросы. Рекомендации My-shop.ru

Зачем столько пунктов в «обязанностях партнера»? Разве вам не достаточно, что я отправляю вам заказы?

My-shop. ru – клиент-ориентированная компания. Мы прилагаем все усилия для того, чтобы клиенты остались довольны нашей работой, и требуем того же от наших партнеров. Большая часть наших требований к партнерским магазинам касается правильного информирования клиентов о товарах и услугах. Мы стараемся не допускать ситуаций, когда клиентам не предоставляют необходимую им информацию о товарах и услугах, и тем более не позволяем специально вводить клиентов в заблуждение. Если вы считаете, что руководствоваться интересами клиентов неправильно, не начинайте работу в режиме «партнерского магазина».

Зачем нужно говорить клиенту, что заказы выполняет My-shop.ru?

Возможно, этого требования не было бы, если бы можно было избежать контактов My-shop. ru с клиентом. Но заказы выполняем мы, и в большинстве случаев при выполнении заказов мы так или иначе контактируем с клиентами. Соответственно, клиенту необходима информация о том, кто будет выполнять его заказ (см. предыдущий вопрос). Если клиенты не будут знать, кто выполняет их заказы, увеличится доля заказов, аннулированных из-за различных недоразумений, например, клиент может отказаться от получения заказа на почте, поскольку просто не узнает его: он сделал заказ в одном магазине (напр., наложенным платежом), а ему приходит неизвестно что из неизвестной ему компании, и за это почему-то просят денег. Разумеется, мы не можем себе позволить нести убытки из-за таких недоразумений.
Кроме того, этого требует наше законодательство. Клиент не может не знать, кто является продавцом, кто несет ответственность за выполнение заказа и к кому обращаться в случае возникновения спорного вопроса.

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