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

<payment>1,2,3,5,6</payment>

<sum_delivery>92</sum_delivery>

</item>

<item>

<delivery>1</delivery>

<payment>4</payment>

<sum_delivery>114</sum_delivery>

</item>

<item>

<delivery>2</delivery>

<payment>0,1,2,3,5,6</payment>

<sum_delivery>0</sum_delivery>

</item>

</answer>

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

- курьером – 130 руб.,

- почтой – 92 руб., но при использовании наложенного платежа 114 руб.,

- самовывоз – бесплатно.

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

Без указания параметров доставки и оплаты может использоваться для проверки состава заказа и расчета стоимости «корзины», с параметрами доставки и оплаты – для расчета стоимости доставки, формирования страницы подтверждения заказа и пр.

URL: https://my-shop. ru/cgi-bin/p/info. pl

Параметры запроса:

Имя параметра*	Обязательный	Формат, допустимые значения	Описание
request	ДА	«order_pre»
cart	ДА	строка в формате «X1-Y1,X2-Y2,…Xn-Yn»	Состав заказа: X1, X2…Xn – идентификаторы товаров, Y1, Y2…Yn – соответствующие количества. Внимание! Если в состав заказа включен хотя бы один товар из комплекта товаров, которые не продаются по частям, все остальные части этого комплекта будут добавлены автоматически.
region	нет	число, 1–999	Код региона доставки. В случае доставки «Почтой России» данный параметр игнорируется.
delivery	нет	число, 0–999999	Код способа доставки.
payment	нет	число, 0–255	Код способа оплаты.
zip_code	нет	код из 6 цифр	Почтовый индекс. Используется только в случае доставки «Почтой России», а также при выборе любого из способов предоплаты.
discount	нет	целое число	См. описание одноименного параметра в запросе «Оформление нового заказа».

* Имена параметров, выделенные красным – см. раздел «Права и обязанности партнера».

Параметры ответа:

Имя параметра	Обязательный	Формат, допустимые значения	Описание
order_ok	ДА	«0» или «1»	Результат проверки состава заказа, параметров доставки и оплаты. Значение «1» означает отсутствие ошибок и наличие всех данных, необходимых для расчета стоимости доставки – можно переходить к завершающему этапу оформления заказа.
cart_ok	нет	строка в формате «X1-Y1,X2-Y2,…Xn-Yn»	Исправленный состав заказа: X1, X2…Xn – идентификаторы товаров, Y1, Y2…Yn – соответствующие количества. Данный параметр передается только при обнаружении одной из ошибок в составе заказа: несуществующий товар, товар снят с продажи, товара нет в наличии, нет нужного количества. Если при проверке состава заказа были удалены все товары, значением параметра будет пустая строка.
error_3012	нет	строка	Список id товаров через запятую, которые не могут быть доставлены выбранным способом. Данный параметр передается вместе с ошибкой с кодом 3012.
sum_cart	ДА*	число	Стоимость товаров в заказе, руб.
sum_discount	ДА*	число	Скидка, руб.
sum_delivery	ДА*	число	Стоимость доставки заказа, руб.
sum_total	ДА*	число	Итоговая стоимость заказа, руб.
discount	ДА*	число	Скидка, %. Устаревший параметр: в настоящее время соответствует скидке на заказ в условиях, когда все товары в нём относятся к основной системе скидок. Не рекомендуется использовать. Может быть удалён.
time_days	ДА*	число	Ориентировочное количество рабочих дней до отгрузки заказа.
time_date	ДА*	дата в формате YYYY-MM-DD	Ориентировочная дата отгрузки заказа в формате YYYY-MM-DD.
time_text_a	ДА*	строка	Строка с ориентировочной датой отгрузки заказа следующего вида: «12.01.2010 (Вт.)».
time_text_b	ДА*	строка	Строка, описывающая ориентировочный срок формирования заказа, следующего вида: «2 рабочих дня» (рекомендуется использовать для заказов с предоплатой).

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

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

Разрешается только после подтверждения клиентом всех параметров заказа.

URL: https://my-shop. ru/cgi-bin/p/order.pl

Параметры запроса:

Имя параметра*	Обязательный	Формат, допустимые значения	Описание
request	ДА	«order_new»
test	нет	«0» или «1»	«1» или любое другое значение, отличное от нуля или пустой строки, означает оформление тестового заказа. Тестовый заказ принимается в обычном режиме, но не выполняется магазином.
cart	ДА	строка в формате «X1-Y1,X2-Y2,…Xn-Yn»	Состав заказа: X1, X2…Xn – идентификаторы товаров, Y1, Y2…Yn – соответствующие количества. Внимание! Если в состав заказа включен хотя бы один товар из комплекта товаров, которые не продаются по частям, все остальные части этого комплекта будут добавлены автоматически.
region	ДА (кроме доставки «Почтой России»)	число, 1–999	Код региона доставки.
delivery	ДА	число, 0–999999	Код способа доставки.
payment	ДА	число, 0–255	Код способа оплаты.
zip_code	Только для доставки «Почтой России» и при выборе любого из способов предоплаты	код из 6 цифр	Почтовый индекс.
discount	нет	целое число	Величина скидки в процентах1, которую партнер предоставляет клиенту за счет своего партнерского вознаграждения. Вычитается из вознаграждения партнера. Обычно не может превышать размера вознаграждения партнера, максимальная величина такой скидки указана в константе «partner_discount_max». Для заказа клиента итоговая скидка вычисляется как максимальная из этой скидки и разовой оптовой скидки: http://my-shop. ru/my/helper_24 Внимание! Если используется этот параметр, и клиент получает оптовую скидку, вознаграждение партнера все равно уменьшается на указанную в данном параметре величину. 1 Считается, что скидка, указанная в запросе, относится к основной системе скидок. Для товаров, относящихся к другим системам скидок, величина скидки вычисляется в соответствии с описанием систем скидок: http://my-shop. ru/my/helper_24
sum_total	ДА	число	Итоговая стоимость заказа, руб. Должна использоваться сумма, полученная на этапе предварительной проверки параметров заказа (сумма, которую подтвердил клиент).
time_date	ДА	дата в формате YYYY-MM-DD	Ориентировочная дата отгрузки заказа в формате YYYY-MM-DD. Должна использоваться дата, полученная на этапе предварительной проверки параметров заказа (дата, которую подтвердил клиент).
name	ДА	строка, до 100 символов	ФИО получателя (полностью; русскими буквами). Рекомендуется требовать заполнение трех отдельных полей («Фамилия», «Имя» и «Отчество»), хранить их также отдельно, а в подобных запросах «склеивать» их значения.
address	Кроме сочетания «самовывоз / наличный расчет»	строка, до 255 символов	Адрес получателя. Без региона доставки. Для доставки «Почтой России»: без региона доставки, района и названия населенного пункта (только улица/микр-н, дом, корп., кв./офис).
metro	Только для доставки «курьером My-shop. ru»	число, 1–255	Код ближайшей станции метро.
address_comment	нет	текст (одна или несколько строк)	Комментарий к адресу доставки (номера автобусов, название остановки, номер подъезда, код на дверях, этаж и т. п.). Игнорируется, если выбрана не курьерская доставка.
phone	ДА	строка, до 255 символов	Контактные телефоны.
phone_time	ДА	строка в формате «H1-H2»	Время, когда оператор может позвонить по указанным телефонам, часы (максимальный интервал: 9-21). Примеры: «9-15», «10-21».
phone_sms	ДА	10 цифр, первая – «9»	Номер мобильного телефона для SMS-уведомлений (только телефоны РФ). В федеральном формате, без кода страны «7», пример: 9161112233. Прямые номера необходимо указывать с федеральным кодом: московские абоненты Билайн имеют федеральный аналог своего номера с кодом 903, московские абоненты МТС - с кодом 985, московские абоненты МегаФон - с кодом 925. SMS-уведомления служат исключительно для оповещения покупателей о ходе выполнения их заказов (заказ принят, заказ передан "Почте России", заказ поступил в пункт выдачи и т. п.) и отправляются за счет Интернет-магазина My-shop. ru.
pin	нет	«0» или целое положительное число, до 19 цифр	Значение этого параметра никак не используется магазином, но сохраняется и возвращается в каждом ответе на запрос «Информация о состоянии заказа». Может использоваться партнером для передачи собственного номера заказа, собственного кода клиента или кода «субпартнера».

* Имена параметров, выделенные красным – см. раздел «Права и обязанности партнера».