0,1,2,3,5,6
0
Из этого ответа следует, что стоимость доставки данного заказа в выбранном регионе:
- курьером – 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 цифр
|
Значение этого параметра никак не используется магазином, но сохраняется и возвращается в каждом ответе на запрос «Информация о состоянии заказа».
Может использоваться партнером для передачи собственного номера заказа, собственного кода клиента или кода «субпартнера».
|
* Имена параметров, выделенные красным – см. раздел «Права и обязанности партнера».
Параметры ответа:
Имя параметра
|
Обязательный
|
Формат, допустимые значения
|
Описание
|
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 рабочих дня» (рекомендуется использовать для заказов с предоплатой).
|
id
|
ДА*
|
число
|
Номер заказа.
|
url_payment_form
|
Только для заказов с предоплатой
|
строка
|
URL страницы с платежной формой или заполненной счет-квитанцией для оплаты заказа в банке или на почте.
|
info_1
|
нет
|
текст (одна или несколько строк)
|
Дополнительная информация, которая обязательно должна быть передана клиенту.
Перед выводом на HTML-страницу необходимо заменять символы новой строки на «
», а также превращать URL-ы в гиперссылки.
|
info_2
|
нет
|
текст (одна или несколько строк)
|
Дополнительная информация, которую рекомендуется передать клиенту.
Перед выводом на HTML-страницу необходимо заменять символы новой строки на «
», а также превращать URL-ы в гиперссылки.
|
* Если нет ошибок. |
