Swagger API Личный кабинет Центр поддержки

Работа с габаритами #

В данной статье приведено описание работы с габаритами посылки. О том как правильно складывать несколько товаров в одну посылку.

Item - конкретный товар, имеющий свои отдельные вес, габариты и т.д.

Place - место, в которое складывают Item. Если в заказе много товаров, они могут не вмещаться в одно место.

Order - полный заказ со всеми товарами.

В блоке Order, Place и Item в разделе Асинхронное создание заказа есть параметры:

ПараметрОписаниеТипПример
heightВысота заказа в сантиметрахЧисло10
lengthДлина заказа в сантиметрахЧисло20
widthШирина заказа в сантиметрахЧисло20

Изначально эти параметры задавать необязательно. Система ApiShip автоматически находит минимальную сторону у товаров в заказе и складывает их. У других двух сторон берутся максимальные значения, но не всегда это бывает уместно (см. примеры ниже). Если, например, товар невозможно сложить друг на друга, в меру его свойств, то необходимо самостоятельно заполнять эти поля.

Примеры #

Сложение по минимальной стороне #

Если товар возможно складывать друг на друга, то можно применить сложение по минимальной стороне.

Рассмотрим в качестве примера автомобильные шины.

У нас есть 3 шины, с параметрами:

ПараметрШина 1Шина 2Шина 3
Сторона A709020
Сторона B259065
Сторона С703065

Для расчета параметров посылки мы складываем наименьшие стороны:

1
25 + 30 + 20 = 75

У оставшихся двух сторон берем максимум из всех товаров:

1
65 < 70 < 90

Параметры посылки будут такими: 75 x 90 x 90 см

Сложение по ширине #

Если товар нельзя складывать друг на друга и можно разместить только поставив рядом, то тогда необходимо определить какая из сторон товара является высотой, шириной и длиной.

После этого нужно высоту самого высокого товара в посылке и длину самого длинного товара в посылке взять за соответствующие параметры height и length. Складывать такой товар необходимо в ширину (т.е. прибавлять ширину - width).

Рассмотрим в качестве примера холодильники.

У нас есть 3 холодильника с параметрами:

ПараметрХолодильник 1Холодильник 2Холодильник 3
height (высота)200205190
length (длина)657560
width (ширина)607055

Максимальная height (высота) у холодильников - 205 см, length (длина) - 75 см. Такой товар необходимо складывать в ширину (т.е. прибавлять ширину - width).

Параметры посылки будут такими: 205 x 75 x 185 см

image-20210914153339183

Холодильники сложатся в ширину.