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

Можно ли продавать товары по ценам, отличающимся от цен My-shop.ru?

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

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

С юридическими лицами сложный документооборот, для этого, как минимум, необходимо заполнять намного больше полей. Кроме того, если юридическое лицо оформляет заказы и на нашем сайте (с

регистрацией и личным счетом, на котором могут оставаться деньги), и через другие сайты, может возникнуть путаница с взаиморасчетами, т. е. для юридических лиц лучше вообще не разрешать «разовые» заказы.

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

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

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

Я сделал(а) партнерский магазин на своем сайте, однако при попытке оформить заказ ваш API сообщает об ошибке «Недопустимый тип запроса для тестового режима работы партнерского магазина». Как включить нормальный режим?

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

http://my-shop. ru/my/helper_11

В письме укажите ваш id партнера и URL страницы, где можно будет проверить работу вашего партнерского магазина.

Как получить код для аутентификации?

Секретный код вы должны указать сами в настройках партнерской программы (в вашем персональном разделе на странице «Партнерская программа»):

http://my-shop. ru/my/partnership

Поле, в котором нужно указать этот код, называется «Секретный код для запросов партнерского магазина». Введите в этом поле случайную последовательность от 20 до 50 символов. Секретный код можно изменить в любой момент.

Зачем вообще нужна аутентификация и секретный код? Если с моим id партнера будет оформлять заказы кто-то еще, я буду только рад(а).

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

Какой метод аутентификации выбрать? Ваш «md5» – это надежно?

Сравним, что будет, если кто-то перехватит значение параметра «auth_code» в вашем запросе:

при аутентификации «plain», этот «кто-то» сможет делать любые запросы от вашего имени, при аутентификации «md5», этот кто-то сможет делать запросы от вашего имени только с тем же значением «request» (для этого требуется одновременный перехват значений параметров «auth_code» и «auth_salt»).

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

В описании API упоминается около 20 типов запросов. Для создания партнерского магазина нужно использовать все эти запросы?

В данном API действительно предусмотрено много типов запросов, и их количество еще может увеличиться. Чтобы принимать заказы на своем сайте, достаточно использовать лишь два типа запросов: «Предварительная проверка параметров заказа» и «Оформление нового заказа». Все остальное – на ваше усмотрение. Решайте сами, что понадобится для вашего магазина, а что нет.

Рекомендации по обновлению справочников и программного обеспечения партнерского магазина.

Мы рекомендуем сделать отдельную программу для ежедневной проверки ответов на запрос «Различные константы». Что стоит делать при этой проверке:

1)  Собственно обновлять константы, которые используются вашими программами.

2)  Проверять, не изменилась ли версия API. См. рекомендации в разделе «Проверка текущей версии API».

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

Даты изменения справочников в ответах на запрос «Различные константы» определяются не автоматически, эти даты мы обновляем вручную. Риск того, что мы забудем изменить дату при изменении справочника, очень невелик, но вы можете дополнительно обновлять справочники с какой-то перериодичностью, при этом лучше ориентироваться на значение параметра «expires_sec» (см. ниже). Обычно изменения справочников таковы, что даже устаревание справочника на несколько месяцев вряд ли будет критично для работы партнерского магазина.

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

1)  Изменилась дата последнего обновления справочника в ответе на запрос «Различные константы».

2)  После последнего обновления справочника прошло время, указанное в параметре «expires_sec» (указанное время не является жестким требованием, его можно изменять в любую сторону).

3)  При работе партнерского магазина получена ошибка, косвенно указывающая на то, что какой-то из справочников устарел.

Рекомендации по проверке «статусов» заказов и новых писем.

Если вы храните историю оформленных заказов, вы также можете дать клиентам возможность отслеживать «статусы» (состояния) их заказов. Это можно сделать двумя способами:

1)  Пассивно: информация о заказе загружается и отображается в «личном кабинете», когда туда заходит клиент.

2)  Активно*: программное обеспечение партнерского магазина с какой-то периодичностью проверяет, не изменилось ли состояние заказов с помощью запроса «list_orders» («Краткий отчет об оформленных заказах»), и, обнаружив изменения, отправляет клиентам соответствующие уведомления по электронной почте. Как и с какой периодичностью это стоит делать (см. расшифровку «статусов» заказов в описании запроса «order_old» – «Информация о состоянии заказа»):

a.  если заказ в обработке (последний статус заказа «2», «3» или «4»), проверять его «статус» раз в три-четыре часа (в ночные часы проверять не стоит), пока статус не изменится на «0», «5» или «6»;

b.  если последний статус заказа «5», проверять его один раз в сутки, пока статус не изменится на «0» или «6»;
при этом необходимо запоминать день, когда статус заказа последний раз изменился на «0» или «6»;
обратите внимание, что не имеет смысла отправлять клиентам сообщение об изменении статуса с «5» на «6».

c.  если последний статус заказа «0» или «6», проверять его максимум один раз в сутки в течение 45 дней.

Если вы хотите обеспечить клиентам возможность переписываться с нашими операторами, проверять наличие новых писем от наших операторов можно теми же способами (в случае «активного» способа – с учетом статуса заказа по тому же алгоритму).

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

Если, вы не нашли ответ на свой вопрос, напишите нам:

http://my-shop. ru/my/helper_11

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

Данный документ описывает программный интерфейс (далее – API) Интернет-магазина My-shop. ru для партнерских магазинов, работающих в рамках партнерской программы My-shop. ru.

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

Для My-shop. ru все заказы, оформленные в партнерском магазине, считаются «разовыми» заказами, сделанными без регистрации клиентов. В связи с этим к заказам, оформленным через партнерский магазин, применяются «разовые оптовые» скидки, но не применяются накопительные скидки. Подробнее о скидках см. здесь:

http://my-shop. ru/my/helper_24

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

Через партнерский магазин невозможно оформление заказов юридических лиц и оформление предварительных заказов (заказов, предполагающих розыск отсутствующих товаров).

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