2
Примеры для сайта site.ru с ключом доступа 1234562f5a3cc1a97f164df9df55d826
Получение списка заказов магазина:
http://site.ru/api/v1/orders/get_list POST Data: secret_key=1234562f5a3cc1a97f164df9df55d826
Вернёт последние 1000 заказов сделанных в магазине.
Пример ответа от сервера:
Array ( [status] => ok [data] => Array ( [0] => Array ( [order_num] => Array ( [type] => int_unsigned [edit] => [value] => 10344 ) [created_at] => Array ( [type] => int_unsigned [edit] => [value] => 1411138705 ) [order_token] => Array ( [type] => str [edit] => [value] => b9016fd8a672bf4bbaab180160f4c66e ) [order_token_url] => Array ( [type] => str [edit] => [value] => http://site.ru/order/info/b9016fd8a672bf4bbaab180160f4c66e ) [order_from_callback] => Array ( [type] => int_unsigned_not_null [edit] => [value] => 0 ) [sites_client_id] => Array ( [type] => int_unsigned [edit] => [value] => 6184 ) [order_status_id] => Array ( [type] => int_unsigned [edit] => 1 [value] => 6 ) [order_address] => Array ( [type] => str [edit] => 1 [value] => Тверская д.8 кв. 51 ) [order_city] => Array ( [type] => str [edit] => 1 [value] => Москва ) [order_region] => Array ( [type] => str [edit] => 1 [value] => Москва ) [order_zip_code] => Array ( [type] => str [edit] => 1 [value] => 603012 ) [order_country] => Array ( [type] => str [edit] => 1 [value] => Россия ) [order_convenient_date] => Array ( [type] => date [edit] => 1 [value] => 2014-03-25 ) [order_convenient_hour_from] => Array ( [type] => int_unsigned [edit] => 1 [value] => 10 ) [order_convenient_hour_to] => Array ( [type] => int_unsigned [edit] => 1 [value] => 15 ) [order_person] => Array ( [type] => str [edit] => 1 [value] => Иванов Иван Иванович ) [order_phone] => Array ( [type] => str [edit] => 1 [value] => +79291234567 ) [order_email] => Array ( [type] => str [edit] => [value] => 79291234567@email.ru ) [order_comment] => Array ( [type] => str [edit] => 1 [value] => Пожалуйста, позвоните перед прибытием курьера ) [order_comment_only_for_staff] => Array ( [type] => str [edit] => 1 [value] => ) [order_tracking_number] => Array ( [type] => str [edit] => 1 [value] => CP245186290CN ) [order_ip] => Array ( [type] => int_unsigned [edit] => [value] => 3166111111 ) [order_refferer] => Array ( [type] => str [edit] => [value] => http://vk.com/news ) [order_utm_source] => Array ( [type] => str [edit] => [value] => ) [order_utm_medium] => Array ( [type] => str [edit] => [value] => ) [order_utm_campaign] => Array ( [type] => str [edit] => [value] => ) [order_utm_content] => Array ( [type] => str [edit] => [value] => ) [order_utm_term] => Array ( [type] => str [edit] => [value] => ) [order_utm_position_type] => Array ( [type] => int_unsigned [edit] => [value] => ) [order_utm_position] => Array ( [type] => int_unsigned [edit] => [value] => ) [order_utm_matchtype] => Array ( [type] => int_unsigned [edit] => [value] => ) [order_utm_placement] => Array ( [type] => str [edit] => [value] => ) [order_utm_network] => Array ( [type] => int_unsigned [edit] => [value] => ) [order_notifications_are_sent] => Array ( [type] => float_unsigned_not_null [edit] => [value] => 1 ) [payment_id] => Array ( [type] => int_unsigned [edit] => 1 [value] => 150550 ) [payment_name] => Array ( [type] => str [edit] => [value] => Через систему Webmoney ) [order_payment] => Array ( [type] => int_unsigned [edit] => 1 [value] => ) [order_payment_method] => Array ( [type] => str [edit] => [value] => ) [order_sum] => Array ( [type] => float_unsigned_not_null [edit] => [value] => 1080.00000 ) [order_sum_without_discont] => Array ( [type] => float_unsigned_not_null [edit] => [value] => 1080.00000 ) [order_discount] => Array ( [type] => float_unsigned_not_null [edit] => [value] => 0.00000 ) [order_discount_percent] => Array ( [type] => float_unsigned_not_null [edit] => [value] => 0.00000 ) [updated_at] => Array ( [type] => int_unsigned [edit] => [value] => 1413543703 ) [line] => Array ( [type] => array [value] => Array ( [0] => Array ( [order_line_id] => Array ( [type] => int_unsigned_not_null [edit] => [value] => 6549254 ) [goods_mod_id] => Array ( [type] => int_unsigned [edit] => [value] => 3830260 ) [goods_mod_rest_value_measure_id] => Array ( [type] => int_unsigned [edit] => [value] => 1 ) [order_line_type_id] => Array ( [type] => int_unsigned [edit] => [value] => 1 ) [order_line_discount_type_id] => Array ( [type] => int_unsigned [edit] => [value] => ) [order_line_art_number] => Array ( [type] => str [edit] => [value] => 014221 ) [order_line_name] => Array ( [type] => str [edit] => 1 [value] => Разъем РШ ВШ 220В 32А 3-х контактн. О/П черный ) [order_line_quantity] => Array ( [type] => float_unsigned_not_null [edit] => 1 [value] => 1.0000 ) [order_line_sum] => Array ( [type] => float_unsigned_not_null [edit] => 1 [value] => 80.00000 ) [order_line_supplier_sum] => Array ( [type] => float_unsigned_not_null [edit] => [value] => 0.00000 ) [order_line_is_debit_rest] => Array ( [type] => int_unsigned [edit] => [value] => ) ) [1] => Array ( [order_line_id] => Array ( [type] => int_unsigned_not_null [edit] => [value] => 6549255 ) [goods_mod_id] => Array ( [type] => int_unsigned [edit] => [value] => ) [goods_mod_rest_value_measure_id] => Array ( [type] => int_unsigned [edit] => [value] => 1 ) [order_line_type_id] => Array ( [type] => int_unsigned [edit] => [value] => 2 ) [order_line_discount_type_id] => Array ( [type] => int_unsigned [edit] => [value] => ) [order_line_art_number] => Array ( [type] => str [edit] => [value] => Доставка ) [order_line_name] => Array ( [type] => str [edit] => 1 [value] => Тестовое название ) [order_line_quantity] => Array ( [type] => float_unsigned_not_null [edit] => 1 [value] => 1.0000 ) [order_line_sum] => Array ( [type] => float_unsigned_not_null [edit] => 1 [value] => 1000.00000 ) [order_line_supplier_sum] => Array ( [type] => float_unsigned_not_null [edit] => [value] => 0.00000 ) [order_line_is_debit_rest] => Array ( [type] => int_unsigned [edit] => [value] => ) ) ) ) [current_status_info] => Array ( [type] => array [value] => Array ( [order_status_id] => Array ( [type] => int_unsigned_not_null [edit] => [value] => 6 ) [order_status_name] => Array ( [type] => str [edit] => [value] => Отменен ) [order_status_desc] => Array ( [type] => str [edit] => [value] => Заказ отменен ) ) ) [order_cancel_reason_text] => Array ( [type] => str [edit] => 1 [value] => ) ) ) )
Полученный список отсортирован по дате создания, сначала новые, затем старые. По умолчанию на страницу выводится по 1000 заказов. Данное значение можно изменять с помощью параметра per_page.
Получить последние 10000 заказов:
http://site.ru/api/v1/orders/get_list POST Data: secret_key=1234562f5a3cc1a97f164df9df55d826 per_page=10000
В результате выполнения операции будет получено 10000 последних заказов, сделаных на сайте. Список аналогичен приведённому выше.
Получение второй страницы списка заказов (с 1001 по 2000):
http://site.ru/api/v1/orders/get_list POST Data: secret_key=1234562f5a3cc1a97f164df9df55d826 page=2
Получение второй страницы списка заказов с произвольным числом заказов на страницу:
http://site.ru/api/v1/orders/get_list POST Data: secret_key=1234562f5a3cc1a97f164df9df55d826 page=2 per_page=10
Покажет заказы с 11 по 20й
Получение данных по одному заказу
Рассмотрим на примере получения заказа, с номером 10034:
http://site.ru/api/v1/orders/get/10034 POST Data: secret_key=0837962f5a3cc1a97f164df9df55d826
Вернёт данные по заказу с номером 10344
Пример ответа от сервера:
Array ( [status] => ok [data] => ( [order_num] => Array ( [type] => int_unsigned [edit] => [value] => 10344 ) [created_at] => Array ( [type] => int_unsigned [edit] => [value] => 1411138705 ) [order_token] => Array ( [type] => str [edit] => [value] => b9016fd8a672bf4bbaab180160f4c66e ) [order_token_url] => Array ( [type] => str [edit] => [value] => http://site.ru/order/info/b9016fd8a672bf4bbaab180160f4c66e ) [order_from_callback] => Array ( [type] => int_unsigned_not_null [edit] => [value] => 0 ) [sites_client_id] => Array ( [type] => int_unsigned [edit] => [value] => 6184 ) [order_status_id] => Array ( [type] => int_unsigned [edit] => 1 [value] => 6 ) [order_address] => Array ( [type] => str [edit] => 1 [value] => Тверская д.8 кв. 51 ) [order_city] => Array ( [type] => str [edit] => 1 [value] => Москва ) [order_region] => Array ( [type] => str [edit] => 1 [value] => Москва ) [order_zip_code] => Array ( [type] => str [edit] => 1 [value] => 603012 ) [order_country] => Array ( [type] => str [edit] => 1 [value] => Россия ) [order_convenient_date] => Array ( [type] => date [edit] => 1 [value] => 2014-03-25 ) [order_convenient_hour_from] => Array ( [type] => int_unsigned [edit] => 1 [value] => 10 ) [order_convenient_hour_to] => Array ( [type] => int_unsigned [edit] => 1 [value] => 15 ) [order_person] => Array ( [type] => str [edit] => 1 [value] => Иванов Иван Иванович ) [order_phone] => Array ( [type] => str [edit] => 1 [value] => +79291234567 ) [order_email] => Array ( [type] => str [edit] => [value] => 79291234567@email.ru ) [order_comment] => Array ( [type] => str [edit] => 1 [value] => Пожалуйста, позвоните перед прибытием курьера ) [order_comment_only_for_staff] => Array ( [type] => str [edit] => 1 [value] => ) [order_tracking_number] => Array ( [type] => str [edit] => 1 [value] => CP245186290CN ) [order_ip] => Array ( [type] => int_unsigned [edit] => [value] => 3166111111 ) [order_refferer] => Array ( [type] => str [edit] => [value] => http://vk.com/news ) [order_utm_source] => Array ( [type] => str [edit] => [value] => ) [order_utm_medium] => Array ( [type] => str [edit] => [value] => ) [order_utm_campaign] => Array ( [type] => str [edit] => [value] => ) [order_utm_content] => Array ( [type] => str [edit] => [value] => ) [order_utm_term] => Array ( [type] => str [edit] => [value] => ) [order_utm_position_type] => Array ( [type] => int_unsigned [edit] => [value] => ) [order_utm_position] => Array ( [type] => int_unsigned [edit] => [value] => ) [order_utm_matchtype] => Array ( [type] => int_unsigned [edit] => [value] => ) [order_utm_placement] => Array ( [type] => str [edit] => [value] => ) [order_utm_network] => Array ( [type] => int_unsigned [edit] => [value] => ) [order_notifications_are_sent] => Array ( [type] => float_unsigned_not_null [edit] => [value] => 1 ) [payment_id] => Array ( [type] => int_unsigned [edit] => 1 [value] => 150550 ) [payment_name] => Array ( [type] => str [edit] => [value] => Через систему Webmoney ) [order_payment] => Array ( [type] => int_unsigned [edit] => 1 [value] => ) [order_payment_method] => Array ( [type] => str [edit] => [value] => ) [order_sum] => Array ( [type] => float_unsigned_not_null [edit] => [value] => 1080.00000 ) [order_sum_without_discont] => Array ( [type] => float_unsigned_not_null [edit] => [value] => 1080.00000 ) [order_discount] => Array ( [type] => float_unsigned_not_null [edit] => [value] => 0.00000 ) [order_discount_percent] => Array ( [type] => float_unsigned_not_null [edit] => [value] => 0.00000 ) [updated_at] => Array ( [type] => int_unsigned [edit] => [value] => 1413543703 ) [line] => Array ( [type] => array [value] => Array ( [0] => Array ( [order_line_id] => Array ( [type] => int_unsigned_not_null [edit] => [value] => 6549254 ) [goods_mod_id] => Array ( [type] => int_unsigned [edit] => [value] => 3830260 ) [goods_mod_rest_value_measure_id] => Array ( [type] => int_unsigned [edit] => [value] => 1 ) [order_line_type_id] => Array ( [type] => int_unsigned [edit] => [value] => 1 ) [order_line_discount_type_id] => Array ( [type] => int_unsigned [edit] => [value] => ) [order_line_art_number] => Array ( [type] => str [edit] => [value] => 014221 ) [order_line_name] => Array ( [type] => str [edit] => 1 [value] => Разъем РШ ВШ 220В 32А 3-х контактн. О/П черный ) [order_line_quantity] => Array ( [type] => float_unsigned_not_null [edit] => 1 [value] => 1.0000 ) [order_line_sum] => Array ( [type] => float_unsigned_not_null [edit] => 1 [value] => 80.00000 ) [order_line_supplier_sum] => Array ( [type] => float_unsigned_not_null [edit] => [value] => 0.00000 ) [order_line_is_debit_rest] => Array ( [type] => int_unsigned [edit] => [value] => ) ) [1] => Array ( [order_line_id] => Array ( [type] => int_unsigned_not_null [edit] => [value] => 6549255 ) [goods_mod_id] => Array ( [type] => int_unsigned [edit] => [value] => ) [goods_mod_rest_value_measure_id] => Array ( [type] => int_unsigned [edit] => [value] => 1 ) [order_line_type_id] => Array ( [type] => int_unsigned [edit] => [value] => 2 ) [order_line_discount_type_id] => Array ( [type] => int_unsigned [edit] => [value] => ) [order_line_art_number] => Array ( [type] => str [edit] => [value] => Доставка ) [order_line_name] => Array ( [type] => str [edit] => 1 [value] => Тестовое название ) [order_line_quantity] => Array ( [type] => float_unsigned_not_null [edit] => 1 [value] => 1.0000 ) [order_line_sum] => Array ( [type] => float_unsigned_not_null [edit] => 1 [value] => 1000.00000 ) [order_line_supplier_sum] => Array ( [type] => float_unsigned_not_null [edit] => [value] => 0.00000 ) [order_line_is_debit_rest] => Array ( [type] => int_unsigned [edit] => [value] => ) ) ) ) [current_status_info] => Array ( [type] => array [value] => Array ( [order_status_id] => Array ( [type] => int_unsigned_not_null [edit] => [value] => 6 ) [order_status_name] => Array ( [type] => str [edit] => [value] => Отменен ) [order_status_desc] => Array ( [type] => str [edit] => [value] => Заказ отменен ) ) ) [order_cancel_reason_text] => Array ( [type] => str [edit] => 1 [value] => ) ) )
Списание остатков по заказу
Рассмотрим на примере списания остатков по заказу, с номером 10034:
http://site.ru/api/v1/orders/modify_rest_value/10034 POST Data: secret_key=0837962f5a3cc1a97f164df9df55d826 form[is_debit]=1
Вернёт информацию о произведённой операции
Пример ответа от сервера:
Array ( [status] => ok [data] => Array ( [errors] => Array ( ) [notice] => Array ( [0] => Остаток по «Описание доставки» восстанавливаться не будет, т.к эта позиция не является товарной [1] => Остаток по «Скидка в процентах, 10% постоянному покупателю» восстанавливаться не будет, т.к эта позиция не является товарной [2] => Остаток по «Скидка в процентах, 10% постоянному покупателю» восстанавливаться не будет, т.к эта позиция не является товарной [3] => Остаток по «Скидка в валюте, 10% постоянному покупателю» восстанавливаться не будет, т.к эта позиция не является товарной [4] => Остаток по «Скидка в процентах, 10% постоянному покупателю» восстанавливаться не будет, т.к эта позиция не является товарной [5] => Остаток по «Скидка в валюте, 10% постоянному покупателю» восстанавливаться не будет, т.к эта позиция не является товарной ) [success] => Array ( [0] => Кофе растворимый Carte Noire, стекло, 95 г. [1] => Кофе зерновой Paulig ) [changed_lines] => Array ( [0] => 16342606 [1] => 16342608 ) ) )Для восстановления остатков используйте значение
form[is_debit]=0
Создание нового заказа
http://site.ru/api/v1/orders/add POST Data: secret_key=0837962f5a3cc1a97f164df9df55d826 form[order_person]=Иванов Иван Иванович form[order_phone]=+79291234567 form[order_address]=ул. Тверская д.8 form[order_city]=Москва form[line][0][goods_mod_id]=6549255 form[line][0][order_line_quantity]=1
Создаст заказ на товарную модификацию. Способ доставки и оплаты будет установлен первый из доступных на сайте. В случае успешного оформления заказа отдаёт информацию о новом созданном заказе:
Array ( [status] => ok [data] => Array ( [order_num] => Array ( [type] => int_unsigned [edit] => [value] => 10359 ) [created_at] => Array ( [type] => int_unsigned [edit] => [value] => 1413808422 ) [order_token] => Array ( [type] => str [edit] => [value] => 9c6cce546d1f05bb518990878b55daff ) [order_token_url] => Array ( [type] => str [edit] => [value] => http://site.ru/order/info/9c6cce546d1f05bb518990878b55daff ) [order_from_callback] => Array ( [type] => int_unsigned_not_null [edit] => [value] => 0 ) [sites_client_id] => Array ( [type] => int_unsigned [edit] => [value] => 1408505 ) [order_status_id] => Array ( [type] => int_unsigned [edit] => 1 [value] => 1 ) [order_address] => Array ( [type] => str [edit] => 1 [value] => ул. Тверская д.8 ) [order_city] => Array ( [type] => str [edit] => 1 [value] => Москва ) [order_region] => Array ( [type] => str [edit] => 1 [value] => ) [order_zip_code] => Array ( [type] => str [edit] => 1 [value] => ) [order_country] => Array ( [type] => str [edit] => 1 [value] => ) [order_convenient_date] => Array ( [type] => date [edit] => 1 [value] => ) [order_convenient_hour_from] => Array ( [type] => int_unsigned [edit] => 1 [value] => ) [order_convenient_hour_to] => Array ( [type] => int_unsigned [edit] => 1 [value] => ) [order_person] => Array ( [type] => str [edit] => 1 [value] => Иванов Иван Иванович ) [order_phone] => Array ( [type] => str [edit] => 1 [value] => 79291234567 ) [order_email] => Array ( [type] => str [edit] => [value] => ) [order_comment] => Array ( [type] => str [edit] => 1 [value] => ) [order_comment_only_for_staff] => Array ( [type] => str [edit] => 1 [value] => ) [order_tracking_number] => Array ( [type] => str [edit] => 1 [value] => ) [order_ip] => Array ( [type] => int_unsigned [edit] => [value] => ) [order_refferer] => Array ( [type] => str [edit] => [value] => ) [order_utm_source] => Array ( [type] => str [edit] => [value] => ) [order_utm_medium] => Array ( [type] => str [edit] => [value] => ) [order_utm_campaign] => Array ( [type] => str [edit] => [value] => ) [order_utm_content] => Array ( [type] => str [edit] => [value] => ) [order_utm_term] => Array ( [type] => str [edit] => [value] => ) [order_utm_position_type] => Array ( [type] => int_unsigned [edit] => [value] => ) [order_utm_position] => Array ( [type] => int_unsigned [edit] => [value] => ) [order_utm_matchtype] => Array ( [type] => int_unsigned [edit] => [value] => ) [order_utm_placement] => Array ( [type] => str [edit] => [value] => ) [order_utm_network] => Array ( [type] => int_unsigned [edit] => [value] => ) [order_notifications_are_sent] => Array ( [type] => float_unsigned_not_null [edit] => [value] => 0 ) [payment_id] => Array ( [type] => int_unsigned [edit] => 1 [value] => 49269 ) [payment_name] => Array ( [type] => str [edit] => [value] => Наличными курьеру ) [order_payment] => Array ( [type] => int_unsigned [edit] => 1 [value] => ) [order_payment_method] => Array ( [type] => str [edit] => [value] => ) [order_sum] => Array ( [type] => float_unsigned_not_null [edit] => [value] => 1080.00000 ) [order_sum_without_discont] => Array ( [type] => float_unsigned_not_null [edit] => [value] => 1080.00000 ) [order_discount] => Array ( [type] => float_unsigned_not_null [edit] => [value] => 0.00000 ) [order_discount_percent] => Array ( [type] => float_unsigned_not_null [edit] => [value] => 0.00000 ) [updated_at] => Array ( [type] => int_unsigned [edit] => [value] => 1413808424 ) [line] => Array ( [type] => array [value] => Array ( [0] => Array ( [order_line_id] => Array ( [type] => int_unsigned_not_null [edit] => [value] => 6872354 ) [goods_mod_id] => Array ( [type] => int_unsigned [edit] => [value] => ) [goods_mod_rest_value_measure_id] => Array ( [type] => int_unsigned [edit] => [value] => 1 ) [order_line_type_id] => Array ( [type] => int_unsigned [edit] => [value] => 2 ) [order_line_discount_type_id] => Array ( [type] => int_unsigned [edit] => [value] => ) [order_line_art_number] => Array ( [type] => str [edit] => [value] => Доставка ) [order_line_name] => Array ( [type] => str [edit] => 1 [value] => Тестовое название ) [order_line_quantity] => Array ( [type] => float_unsigned_not_null [edit] => 1 [value] => 1.0000 ) [order_line_sum] => Array ( [type] => float_unsigned_not_null [edit] => 1 [value] => 1000.00000 ) [order_line_supplier_sum] => Array ( [type] => float_unsigned_not_null [edit] => [value] => 0.00000 ) [order_line_is_debit_rest] => Array ( [type] => int_unsigned [edit] => [value] => ) ) [1] => Array ( [order_line_id] => Array ( [type] => int_unsigned_not_null [edit] => [value] => 6872355 ) [goods_mod_id] => Array ( [type] => int_unsigned [edit] => [value] => 6549255 ) [goods_mod_rest_value_measure_id] => Array ( [type] => int_unsigned [edit] => [value] => 1 ) [order_line_type_id] => Array ( [type] => int_unsigned [edit] => [value] => 1 ) [order_line_discount_type_id] => Array ( [type] => int_unsigned [edit] => [value] => ) [order_line_art_number] => Array ( [type] => str [edit] => [value] => 014221 ) [order_line_name] => Array ( [type] => str [edit] => 1 [value] => Разъем РШ ВШ 220В 32А 3-х контактный О/П черный ) [order_line_quantity] => Array ( [type] => float_unsigned_not_null [edit] => 1 [value] => 1.0000 ) [order_line_sum] => Array ( [type] => float_unsigned_not_null [edit] => 1 [value] => 80.00000 ) [order_line_supplier_sum] => Array ( [type] => float_unsigned_not_null [edit] => [value] => 0.00000 ) [order_line_is_debit_rest] => Array ( [type] => int_unsigned [edit] => [value] => ) ) ) ) [current_status_info] => Array ( [type] => array [value] => Array ( [order_status_id] => Array ( [type] => int_unsigned_not_null [edit] => [value] => 1 ) [order_status_name] => Array ( [type] => str [edit] => [value] => Новый ) [order_status_desc] => Array ( [type] => str [edit] => [value] => Новый заказ ) ) ) [order_cancel_reason_text] => Array ( [type] => str [edit] => 1 [value] => ) ) )
Принимаемые поля:
Обязательные поля
form[order_person] - ФИО
form[order_phone] - Телефон
Не обязательные поля
form[order_address] - адрес доставки
form[order_city] - город доставки
form[order_region] - область доставки
form[order_zip_code] - почтовый индекс
form[order_country] - страна доставки
form[order_convenient_date] - дата доставки в формает YYYY-MM-DD или DD.MM.YYYY
form[order_convenient_hour_from] - удобное время доставки, час с которого можно производить доставку
form[order_convenient_hour_to] - удобное время доставки, час до которого можно производить доставку
form[order_email] - email адрес клиента
form[order_comment] - комментарий к заказу
form[order_comment_only_for_staff] - Комментарий, скрытый от покупателя
form[order_tracking_number] - Номер отслеживания
form[order_ip] - IP адрес покупателя в формате ipv4 (1.2.3.4)
form[order_refferer] - url адрес, с которого пришёл покупатель
form[order_utm_source] - UTM источник, рекламная площадка
form[order_utm_medium] - UTM канал или тип трафика
form[order_utm_campaign] - UTM название рекламной кампании
form[order_utm_content] - UTM содержание объявления
form[order_utm_term] - UTM ключевое слово объявления
form[order_utm_position_type] - UTM позиция объявления
form[order_utm_position] - UTM Тип блока, в котором произошёл показ 1 - Спецразмещение 2 - Cбоку 3 - Другое
form[order_utm_matchtype] - UTM Параметры соответствия ключевого слова 1 - точное соответствие 2 - фразовое соответствие 3 - широкое соответствие
form[order_utm_placement] - UTM Доменное, где произошёл показ
form[order_utm_network] - UTM тип площадки 1 -поисковая система 2- поисковый партнёр 3 - сайт-партнёр из контекстно-медийной сети
form[payment_id] - Идентификатор способа оплаты. Если не указан - будет выбран первый из списка доступных на сайте
form[order_payment] - Оплачен ли заказ
form[delivery_id] - Идентификатор метода доставки. Если не указан - будет выбран первый из списка доступных на сайте
Если необходимо, чтобы ни одна позиция доставки не была добавлена при создании заказа нужно добавить дополнительный параметр в форму запроса:
form[without_delivery]=1
В случае указания этого параметра в значение 1, значение поля form[delivery_id] также не будет учитываться и позиция доставки не будет добавлена в заказ.
form[coupon_code] - Код купона на скидку
form[line][] - Массив с позициями заказа. Указывается аналогично примеру выше, список доступных полей, на пример первой добавляемой позиции заказа:
form[line][0][goods_mod_id] - Идентификатор модификации товара. Указывается только для товарных позиций.
form[line][0][goods_mod_rest_value_measure_id] - Идентификатор единицы измерения товара (1 - шт, 2 - кг, 3 - м, 4 - м², 5 - м³, 6 - л...)
form[line][0][order_line_type_id] - Тип позиции заказа. 1 - товарная позиция, 2 - позиция доставки, 3 - позиция скидки
form[line][0][order_line_discount_type_id] - Тип скидки. Используется только для типа позиции заказа = 3, скидка. 1 - Скидка в процентах, 2 - скидка в валюте
form[line][0][order_line_art_number] - Артикул. Поле заполняется только для товарной позиции, в случае, если не указан идентификатор модификации товара
form[line][0][order_line_name] - Название позиции заказа. При указании идентификатора модификации товара игнорируется.
form[line][0][order_line_quantity] - Количество
form[line][0][order_line_sum] - Цена за единицу товарной позиции. Если указана - перезапишет значение, полученное из текущей модификации товара по идентификатору модификации товара.
form[line][0][order_line_supplier_sum] - Цена закупки. Если указана - перезапишет значение, полученное из текущей модификации товара.
Обновление данных заказа
Рассмотрим на примере заказа, с номером 10034.
Будем изменять статус заказа на статус 5 (Доставлен)
http://site.ru/api/v1/orders/update/10034 POST Data: secret_key=0837962f5a3cc1a97f164df9df55d826 form[order_status_id]=5
Пример ответа от сервера:
Array
(
[status] => ok
)
Изменение статуса оплаты заказа с номером 10034:
http://site.ru/api/v1/orders/update/10034 POST Data: secret_key=0837962f5a3cc1a97f164df9df55d826 form[order_payment]=1
Изменение различных данных заказа
http://site.ru/api/v1/orders/update/10034 POST Data: secret_key=0837962f5a3cc1a97f164df9df55d826 form[order_status_id]=5 form[order_cancel_reason_text]=Нет в наличии form[order_address]=Третьяковская 13-8 form[order_city]=Москва form[order_tracking_number]=1234567 form[order_comment_only_for_staff]=Заказ будет доставлен 20 января.
Принимает к изменению те поля, которые указаны в полученных по заказу данных как edit=true
Изменение позиций заказа:
http://site.ru/api/v1/orders/update/10034 POST Data: secret_key=0837962f5a3cc1a97f164df9df55d826 form[line][0][order_line_id]=6549255 form[line][0][delete]=1 form[line][1][order_line_id]=6549254 form[line][1][order_line_quantity]=10 form[line][2][goods_mod_id]=3830261 form[line][2][order_line_quantity]=5 form[line][3][goods_mod_id]=3830262 form[line][3][order_line_quantity]=5 form[line][3][order_line_sum]=100 form[line][3][order_line_supplier_sum]=50 form[line][4][goods_mod_rest_value_measure_id]=2 form[line][4][order_line_art_number]=BD10-94 form[line][4][order_line_name]=Пляжный набор для двоих form[line][4][order_line_sum]=1000 form[line][4][order_line_supplier_sum]=50 form[line][5][order_line_type_id]=2 form[line][5][order_line_name]=Доставка по москве в пределах МКАД form[line][5][order_line_quantity]=1 form[line][5][order_line_sum]=300 form[line][6][goods_mod_rest_value_measure_id]=5 form[line][6][order_line_type_id]=3 form[line][6][order_line_discount_type_id]=1 form[line][6][order_line_name]=Скидка в процентах, 10% постоянному покупателю form[line][6][order_line_quantity]=10
В результате позиция заказа с идентификатром 6549255 будет удалена.
В позиции заказа с идентификатором 6549254 будет изменено количество до 10 шт.
Будут добавлены новые позиции заказа:
- Товарная модификация с идентификатором 3830261 в количестве 5 шт.
- Товарная модификация с идентификатором 3830262 в количестве 5 шт, с изменением цены продажи до 100 рублей и установкой закупочной цены в 50 рублей, вместо тех, что указаны в самой модификации товара
- Товар (Пляжный набор для двоих), без наличия его на складе, с единицей измерения (2 - кг), артикулом BD10-94, ценой 1000 рублей и 50 рублей ценой закупки. Т.к. информация о количестве не укзана в form[line][4][order_line_quantity], то количество товара будет добавлено 1
- Будет добавлена позиция доставки (Доставка по москве в пределах МКАД) со стоимостью 300 рублей
- 10% скидка на заказ в процентах. Для указания скидки в рублях тип скидки (order_line_discount_type_id) должен быть установлен в значение 2
