/api/lite/orders/delivery
Заказ →→ обновление данных доставки
/api/lite/orders/delivery
Возможность обновить все данные по доставке заказа
id - номер заказа
Формат аналогичный секции delivery в GET /orders
Описание результата запроса
Основной статус заказа. Описывает жизненный цикл заказа.
Статус подтверждения заказа
Размер оценочной стоимости / страховки заказа.
По умолчанию равен общей сумме заказа или рассчитывается, исходя из процента расчёта страховки, указанного в аккаунте.
Статус оплаты заказа покупателем.
Имеет смысл только для заказов с предоплатой (например, оплата картой на сайте).
Заказы с оплатой ONLINE, и NOT_PAID - не передаются на комплектацию.
Тип оплаты заказа.
Код и наименование способа оплаты заказа.
Базовые способы оплаты (по умолчанию), в формате paymentMethodCode (paymentMethodType) "paymentMethodName":
Флаг, указывающий на необходимость оплаты заказа покупателем перед отгрузкой.
Например, если paymentMethodType = ONLINE и paymentStatus = NOT_PAID, тогда needCustomerPayment = true
Сырые данные URL запроса, с которыми покупатель пришел на сайт. В формате JSON.
Как правило, в основном это UTM метки, для понимания рекламного канала, с которого пришел покупатель.
Сокращенная ссылка на заказ. Используется для предоставления покупателю, например в SMS.
Например http://r.kak2c.ru/i806zlu
B2B заказ. Если true, то биллинг по такому заказу будет считаться как для B2B.
*Настройка для B2B включается по запросу клиента; по умолчанию не используется.
Секретный ключ для доступа к заказу через публичный метод получения заказа.
Пример значения: 94ccc02a-2379-0eac-e5cf-260485cc35bd
Тип заказа
Подтип заказа, в случае orderType = CUSTOM.
вывод суммарных оборотных данных по заказу
например: "amountORDERED": 3,"amountRESERVED": 0,"amountPACKED": 0,"amountSHIPPED": 0,"amountLOST": 0,"amountDELIVERED": 0,"amountRETURNED": 0,
"amountRETURNED_DEFECTIVE": 0
Флаг, определяющий заказы маркетплейсов
Дата планируемой отгрузки
Флаг, определяющий готовность заказа к выгрузке в Темполайн
Объект, описывающий доставку
code
ранее deliveryCode
Технический идентификатор способа доставки (договора доставки).
Пример: 258296e9-acee-4361-a55b-bd4c3f3913af
type
Тип доставки:
title
ранее courier
Наименование курьерской службы
Пример: Boxberry
trackingNumber
ранее был вне delivery
trackingURL
ранее trackingLink
Часть ссылки на трекинг. Для получения полной ссылки на трекинг в курьерской службе, необходимо сцепить trackingURL и trackingNumber.
Пример: trackingURL="https://boxberry.ru/tracking/" + trackingNumber="11122233" дают полную ссылку на трекинг https://boxberry.ru/tracking/11122233.
Желаемая покупателем дата доставки.
Кактус передает эту информацию в курьерские службы как рекомендательный параметр. Не все курьерские службы учитывают эту информацию.
desiredDeliveryTimeFrom": "09:00",
ранее timeFrom
Желаемое время доставки "от". С лидирующими нулями.
Пример "09:00".
"desiredDeliveryTimeTo": "20:00",
ранее timeTo
Желаемое время доставки "по". С лидирующими нулями.
Пример "20:00".
Комментарий для целей доставки.
В случае способа доставки через ПВЗ, содержит адрес и время работы ПВЗ.
Дата фактической доставки от курьерской службы
Плановая дата доставки от курьерской службы
Причина переноса плановой даты доставки от курьерской службы
Двухбуквенный код страны по стандарту ISO 3166-1 (Alpha 2).
https://ru.wikipedia.org/wiki/ISO_3166-1
Этаж (при передаче в deliveryServices LIFT_TO_DOOR_MANUAL этаж -- обязателен для заполнения)
Максимальные габариты в см
Либо 1 число - сумма 3х измерений
Либо в формате 36x36x60
Контрагент покупатель, с юридической точки зрения.
Если покупатель - обычное физическое лицо, type = PERSON, если юридическое лицо (ИП, ООО и т.п.), type = COMPANY
Тип контрагента:
variantId
ранее skuId
Идентификатор варианта - основной идентификатор позиции заказа. У продукта всегда есть один вариант.
В случае строки "Доставка", содержит "delivery".
Идентификатор продукта. Общий идентификатор (один продукт может иметь несколько вариантов).
В случае строки "Доставка", содержит "delivery".
article
ранее skuArticle
Количество заказанного товара
Ставка НДС для строки заказа:
Ставка НДС в карточке данного продукта
для товаров - вывод оборотных данных по заказу по каждой позиции
например: "amountORDERED": 3,"amountRESERVED": 0,"amountPACKED": 0,"amountSHIPPED": 0,"amountLOST": 0,"amountDELIVERED": 0,"amountRETURNED": 0,
"amountRETURNED_DEFECTIVE": 0
"amountRETURNED_TO_CLIENT": 0
Тип позиции:
Используемые свойства, характеризующие данный вариант (если используются варианты для данного продукта).
Упаковки (транспортные места) заказа. Содержит информацию только после упаковки заказа (в том числе частичной упаковке).
Содержит размеры упаковки в миллиметрах
Пример
{
"height": 120,"width": 120,"depth": 120
}
Список разрешений на внесение изменений в группы полей заказа
- type = одно из значений групп полей заказа:
ITEMS_EDITABLE, PAYMENT_EDITABLE, IS_PAID_EDITABLE, RECEIVER_EDITABLE, DELIVERY_EDITABLE, WAREHOUSE_EDITABLE), COMMENTS_EDITABLE
- value - флаг, разрешены ли изменения
- reason - причина запрета, если value = false
Список разрешений на действия с заказом (кнопки)
- type = одно из значений действий с заказом:
CANCEL, CONFIRM, NEED_CONFIRM, PACK, COPY, PACK_CONTROL, UNPACK, SHIPPING, UNSHIPPING, REFRESH_RESERVE, RETURN_TO_DELIVERY, REVERT_RETURNS
- value - флаг, разрешены ли изменения
- reason - причина запрета, если value = false
Список переводов наложенных платежей по данному заказу
Технический id изначального заказа (заказ-подписка например)
Список опций упаковки
Тип онлайн оплаты:
Настройки отгрузки
Пример запроса по одному заказу и полными данным
Запрос
{
"id": "8202-1051",
"delivery": {
"code": "624f1b23-049f-a1aa-ee21-b6b1523a88b1",
"pickupPointId": "2201-002",
"deliveryComment": "Поскорее",
"desiredDeliveryDate": "2020-08-13",
"desiredDeliveryTimeFrom": "09:00",
"desiredDeliveryTimeTo": "20:00",
"isDeliverySumLimitActive": true,
"deliverySumLimitAmount": 5000,
"deliverySumBelowLimitAmount": 1000,
"address": {
"country": "Россия",
"countryCode": "RU",
"region": "Алтайский",
"area": null,
"city": "Томск",
"settlement": null,
"street": "Барнаульская",
"house": "1",
"block": "",
"building": "",
"flat": "",
"fullAddress": "Алтайский, Барнаул, Барнаульская, д 1",
"fullCity": null,
"rawData": "Алтайский, Барнаул, Барнаульская, д 1",
"zip": "",
"regionFias": "8276c6a1-1a86-4f0d-8920-aba34d4cc34a",
"areaFias": null,
"cityFias": "d13945a8-7017-46ab-b1e6-ede1e89317ad",
"settlementFias": null
},
"receiver": {
"name": "Сергей",
"surname": "Сергеев",
"patronymic": "",
"fullName": "Толстой Петр",
"phone": "89011111111",
"rawPhone": "89011111111",
"alternativePhone": "",
"email": "exhila.rate1111111@mail.ru",
"post": null,
"personType": "CUSTOMER"
},
"deliveryServices": null,
"deliveryPayerType": "RECEIVER", // SENDER
"isDeliverySumLimitActive": true,
"deliverySumLimitAmount": 324234,
"deliverySumBelowLimitAmount": 23432432
}
}Пример успешного ответа
{
"success": true
}В случае ошибки:
{
"success": false,
"errors": [
{
"code": 0,
"message": "Текст ошибки"
}
]
}