Swagger API Личный кабинет Центр поддержки
  • Languages Русский

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

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

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

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

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

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

  1. Войти в свою учетную запись ApiShip.

  2. Перейти в раздел «Службы доставки» в левой навигационной панели. img

  3. Выбрать СД Ozon Доставка для бизнеса в списке. img

  4. Создайте частное приложение в OZON Delivery img

    Список прав для добавления

  5. В строке с приложением нажмите на “ключик” и скопируйте client_id и client_secret. Используйте их для подключения в ApiShip img

  6. Добавьте метод доставки в ЛК Ozon https://docs.ozon.ru/api/ozon-delivery/#tag/Process img

  7. Добавьте методы доставки с которыми хотите работать через ApiShip после создания подключения, выбрав вкладку “Список методов доставки” и нажав на “+”, активируя этот способ в ApiShip img

  8. Метод доставки по умолчанию можно поменять нажав на “Звездочку” img Система автоматически выбирает подходящий метод доставки, ориентируясь на данные отправителя. Если подходящий метод не находится, применяется метод, заданный по умолчанию.

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

Параметр подключенияОбязательныйОписание
НазваниенетНазвание подключения
ИННдаИНН вашей компании
Передаваемый процент оценочной стоимостинетЭтот параметр регулирует процент от переданной оценочной стоимости, который мы отправим в службу доставки. Если нужно убрать оценочную стоимость, установите 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.allPOST/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.containerPOST/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.deliveryPOST/v1/delivery/check-client
POST/v1/delivery/location
delivery-api.delivery-pointPOST/v1/delivery-point/info
POST/v1/delivery-point/list
POST/v1/delivery-point/check-availability
delivery-api.orderPOST/v1/order/checkout
POST/v1/order/create
delivery-api.postingPOST/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.returnPOST/v1/return/download_barcode
POST/v1/return/info
POST/v1/return/reset_barcode
POST/v1/return/search
POST/v1/return/status-history