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

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

Имя параметра	Обязательный	Формат, допустимые значения	Описание
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-страницу необходимо заменять символы новой строки на «<br>», а также превращать URL-ы в гиперссылки.
info_2	нет	текст (одна или несколько строк)	Дополнительная информация, которую рекомендуется передать клиенту. Перед выводом на HTML-страницу необходимо заменять символы новой строки на «<br>», а также превращать URL-ы в гиперссылки.

* Если нет ошибок.

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

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

Позволяет получить информацию только о заказах, оформленных через данный API и только партнером с идентификатором, указанным в параметре «partner».

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

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

Имя параметра	Обязательный	Формат, допустимые значения	Описание
request	ДА	«order_old»
id	ДА	число	Номер заказа.
light	нет	«0» или «1»	Значение «0» – режим по умолчанию, значение «1» – «лайт-режим», позволяющий уменьшить нагрузку и ускорить отправку ответа. При использовании лайт-режима в ответе не будет параметров «cart» и «rpo», а также может быть сокращено значение параметров «info_1» и «info_2». Внимание! Если ваше программное обеспечение не использует значения «cart» и «rpo», мы настоятельно рекомендуем использовать лайт-режим.

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

Имя параметра	Обязательный	Формат, допустимые значения	Описание
order_datetime	ДА	дата и время в формате YYYY-MM-DD HH:MM:SS	Дата и время оформления заказа. Время московское.
cart	ДА (кроме лайт-режима – см. выше)	строка в формате «X1-Y1-Z1-C1,X2-Y2-Z2-C2,…Xn-Yn-Zn-Cn»	Состав заказа: X1, X2…Xn – идентификаторы товаров, Y1, Y2…Yn – соответствующие заказанные количества, Z1, Z2… Zn – соответствующие зарезервированные количества (актуально только для заказов «в обработке»), C1, C2… Cn – стоимость соответствующих товаров в данном заказе (фиксируется в момент оформления заказа). Если сумма Y1, Y2…Yn равна сумме Z1, Z2… Zn, заказ сформирован.
sum_cart	ДА	число	Стоимость товаров в заказе, руб.
sum_discount	ДА	число	Скидка, руб.
sum_delivery	ДА	число	Стоимость доставки заказа, руб.
sum_total	ДА	число	Итоговая стоимость заказа, руб.
discount	ДА	число	Скидка, %. Устаревший параметр: в настоящее время соответствует скидке на заказ в условиях, когда все товары в нём относятся к основной системе скидок. Не рекомендуется использовать. Может быть удалён.
delivery	ДА	число, 0–999999	Код способа доставки.
payment	ДА	число, 0–255	Код способа оплаты.
status	ДА	число, 0–9	Код текущего состояния заказа: 0 – заказ аннулирован, 2 – ожидание предоплаты, 3 – комплектуется, ожидает отправки или находится в пункте выдачи, 4 – заблокирован в ожидании ответа клиента, 5 – отправлен, но не оплачен (только для наложенного платежа), 6 – отправлен и оплачен.
status_text	ДА	строка	Строка с описанием состояния заказа. Помимо состояния заказа может содержать дополнительную информацию о формировании заказа, согласовании доставки, причине аннулирования и пр.
status_0_cause	Только для аннулированных заказов	число, 1–99	Код причины аннулирования заказа: 1 – тестовый заказ (тестирование или чья-то неудачная шутка), 2 – аннулирован по просьбе клиента, 3 – закончился товар (клиент отказался от оставшихся товаров), 4 – почтовый возврат (отказ клиента или ошибка Почты России), 5 – объединен с другим заказом клиента, 6 – истек срок ожидания товара для предварительного заказа, 7 – истек срок ожидания предоплаты, 8 – истек срок ожидания ответа клиента, 9 – невозможно выполнить пожелание клиента, 10 – истек срок ожидания наложенного платежа (вероятно, ошибка Почты России).
url_payment_form	Только для заказов в состоянии ожидания предоплаты	строка	URL страницы с платежной формой или заполненной счет-квитанцией для оплаты заказа в банке или на почте.
assembled	Только для заказов «в обработке»	«0» или «1»	Признак сборки заказа (не путать с формированием заказа – заказ может быть сформирован (укомплектован), но еще не собран): 0 – заказ не собран, 1 – заказ собран.
shipment_date	Только для отправленных заказов	дата в формате YYYY-MM-DD	Дата отгрузки заказа или его передачи в транспортную компанию.
rpo	ДА (кроме лайт-режима – см. выше)	строка в формате «N1,N2,…Nn»	Список идентификаторов РПО (регистрируемых почтовых отправлений – посылок и бандеролей) через запятую. Идентификаторы РПО присваиваются в течение нескольких часов после изменения кода состояния заказа на «5» или «6». Параметр используется только для заказов с почтовой доставкой.
info_1	нет	текст (одна или несколько строк)	Дополнительная информация, которая обязательно должна быть передана клиенту, если это возможно. Перед выводом на HTML-страницу необходимо заменять символы новой строки на «<br>», а также превращать URL-ы в гиперссылки.
info_2	нет	текст (одна или несколько строк)	Дополнительная информация, которую рекомендуется передать клиенту, если это возможно. Перед выводом на HTML-страницу необходимо заменять символы новой строки на «<br>», а также превращать URL-ы в гиперссылки.
pin	нет	число	Значение одноименного параметра, указанное при оформлении заказа. Подробнее см. в описании запроса «Оформление нового заказа».

Для заказов с предоплатой, находящихся «в обработке»: понять, поступил ли платеж, можно по коду состояния заказа: 2 – платеж не поступил или еще не обработан, 3 – платеж поступил.

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

Позволяет аннулировать только заказы, оформленные через данный API, и только партнером с идентификатором, указанным в параметре «partner». Также невозможно аннулировать следующие заказы:

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

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