updateOrder — обновление информации о заказе

Запрос

POST https://[домен]/engine/orders/updateOrder

где [домен] — адрес вашего интернет-магазина;

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

Пример запроса

{
"key": "variant",
"orders":[
{
"order_id": 6,
"status": 3,
"payment": "sber_card",
"goods": [
{
"variant": "ad3ab8e9-d6bb-11e2-957a-0003cd830242~55a6b613-aa00-11ea-93f1-000c29922d30",
"price": "31.00",
"qt": "2"
},
{
"variant": "b0baa588-d6ba-11e2-957a-0003cd830242~fbfb760c-a935-11ea-93f1-000c29922d30",
"price": "226.50",
"qt": "3"
}
]
}
]
}

Описание полей JSON структуры запроса:

key – ключевое поле, по которому можно однозначно идентифицировать товар на сайте. Возможные варианты:

  • code – синхронизация по коду справочника Номенклатура;
  • article – синхронизация по артикулу;
  • variant – синхронизация по guid товара и guid характеристики;

orders – массив структур с описанием заказов для изменения

order_id – идентификатор заказа;
payment – тип оплаты (необязательно). Возможные варианты (данные варианты должны быть предварительно подключены на стороне сайта):

  • sber_card — оплата через эквайринг от Сбербанка
  • sber_installment — оплата через рассрочку от Сбербанка
  • sber_credit — оплата через кредит от Сбербанка
  • sber_QR — оплата по QR коду от Сбербанка
  • yandex_card— оплата через Яндекс.Касса
  • paykeeper_card — оплата через PayKeeper
  • other — любой другой способ оплаты

status – новый статус заказа:

  • 0 – размещен
  • 1 – в обработке
  • 2 – завершен
  • 3 – оплачен
  • 4 - отменен

goods – массив структур с описанием состава заказа

code – код товара в 1С (требуется, если key=code);
article – артикул товара (требуется, если key=article);
variant – идентификатор товара из 1С (вплоть до характеристики номенклатуры, если она используется в 1С). Состоит из GUID товара и GUID характеристики, разделенных знаком «~». Если характеристика не используется, то только GUID товара. Требуется, если key=variant;
qt – количество товара в заказе;
price – цена товара в заказе;
name – наименование товара (будет использоваться, если товара по ключевому полю на сайте не найдено, но необходимо, чтобы в заказе покупателя этот товар появился);

Если в goods не передан какой-то из товаров, который был в заказе, то считается, что данный товар исключен из заказа.

ВАЖНО! Если вы не отправили какой-то из товаров заказа обратно на сервер, то считается, что этот товар исключен из заказа. И в последующих ответах сервера по этому заказу данный товар будет возвращаться, но с количеством 0.

 

Пример ответа сервера:

{
"success": true,
}

Описание полей в ответе сервера:

success — признак корректности обработки запроса.