Ozon Доставка для бизнеса #

Подключение Ozon Доставка для бизнеса к ApiShip #

Чтобы подключить СД Ozon Доставка для бизнеса, необходимо:

Заключить договор с СД Ozon Доставка для бизнеса.
Создать частное приложение в Ozon Delivery
Создать подключение в ЛК ApiShip.

Создание подключения в ЛК Apiship #

Для создания подключения в ЛК ApiShip необходимо:

Войти в свою учетную запись ApiShip.
Перейти в раздел «Службы доставки» в левой навигационной панели.
Выбрать СД Ozon Доставка для бизнеса в списке.
Создайте частное приложение в OZON Delivery
Список прав для добавления
В строке с приложением нажмите на “ключик” и скопируйте client_id и client_secret. Используйте их для подключения в ApiShip
Добавьте метод доставки в ЛК Ozon https://docs.ozon.ru/api/ozon-delivery/#tag/Process После добавления вы получите ID метода доставки, который сможете добавить в ЛК ApiShip, ID метода указан под штрих-кодом
Добавьте методы доставки с которыми хотите работать через ApiShip после создания подключения, выбрав вкладку “Список методов доставки”
Нажмите “Добавить метод доставки”

Параметры подключения представлены в таблице ниже.

Параметр подключения	Обязательный	Описание
Название	нет	Название подключения
ИНН	да	ИНН вашей компании
Передаваемый процент оценочной стоимости	нет	Этот параметр регулирует процент от переданной оценочной стоимости, который мы отправим в службу доставки. Если нужно убрать оценочную стоимость, установите 0. Стандартное значение - 100
Client ID приложения	да	Идентификатор частного приложения из ЛК Ozon (UUID)
Client Secret приложения	да	Секрет частного приложения из ЛК Ozon
Токен доступа	нет	Только для тестового контура, в боевом заполняется автоматически

Нюансы работы с Ozon Доставка для бизнеса #

Склад отрузки #

Указывать не требуется, выбирается по методу доставки выбранному по умолчанию в ЛК ApiShip, либо можно передать через extraParam: ozondel.shipmentMethodId

Передача номера телефона клиента в заказе #

Ozon Доставка для бизнеса ожидает получить номер телефона клиента зарегистрированный в OZON. Если телефон не будет зарегистрирован в OZON - создать заказ не получится.

Передача оценочной стоимости #

Передача нулевой оценочной стоимости в Озон невозможна.

Необходимо проверить, чтобы в параметрах подключения службы доставки Озон, настройка “Передаваемый процент оценочной стоимости” был больше 0 и в заказе оценочная стоимость не была равна 0.

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

Подробней в документации: https://docs.apiship.ru/docs/integrations-marketplaces/insales/settings/#%D0%BE%D1%86%D0%B5%D0%BD%D0%BE%D1%87%D0%BD%D0%B0%D1%8F-%D1%81%D1%82%D0%BE%D0%B8%D0%BC%D0%BE%D1%81%D1%82%D1%8C

При расчете доставки и создании заказов по API также можно передавать extraParams с конкретным методом доставки.

Пример передачи метода доставки по API, вместо метода выбранного в ЛК ApiShip по умолчанию:

"extraParams": {
   "ozondel.shipmentMethodId": "123456789"
}

Какие права указывать при создании приложения #

Категория	Метод	Эндпоинт
delivery-api.all	POST	/v1/return/info
	POST	/v1/return/status-history
	POST	/v1/container/label
	POST	/v1/delivery-point/check-availability
	POST	/v1/delivery-point/info
	POST	/v1/order/checkout
	POST	/v1/order/create
	POST	/v1/posting/cancel
	POST	/v1/return/reset-barcode
	POST	/v1/return/search
	POST	/v1/container/create
	POST	/v1/delivery-point/list
	POST	/v1/posting/info
	POST	/v1/container/approve
	POST	/v1/container/cancel
	POST	/v1/container/info
	POST	/v1/container/remove-postings
	POST	/v1/container/search
	POST	/v1/delivery/check-client
	POST	/v1/delivery/location
	POST	/v1/posting/approve
	POST	/v1/container/fill-postings
	POST	/v1/posting/label
	POST	/v1/posting/search
	POST	/v1/posting/status-history
	POST	/v1/return/download-barcode
delivery-api.container	POST	/v1/container/fill-postings
	POST	/v1/container/info
	POST	/v1/container/label
	POST	/v1/container/remove-postings
	POST	/v1/container/search
	POST	/v1/container/approve
	POST	/v1/container/cancel
	POST	/v1/container/create
delivery-api.delivery	POST	/v1/delivery/check-client
	POST	/v1/delivery/location
delivery-api.delivery-point	POST	/v1/delivery-point/info
	POST	/v1/delivery-point/list
	POST	/v1/delivery-point/check-availability
delivery-api.order	POST	/v1/order/checkout
	POST	/v1/order/create
delivery-api.posting	POST	/v1/posting/search
	POST	/v1/posting/status-history
	POST	/v1/posting/approve
	POST	/v1/posting/cancel
	POST	/v1/posting/info
	POST	/v1/posting/label
delivery-api.return	POST	/v1/return/download_barcode
	POST	/v1/return/info
	POST	/v1/return/reset_barcode
	POST	/v1/return/search
	POST	/v1/return/status-history