В ApiShip предусмотрено отдельное подключение службы «Ozon Доставка для бизнеса». Оно использует частное приложение Ozon Delivery и собственные методы доставки. Его нельзя настраивать по инструкции для соседней службы «Ozon Доставка для продавцов»: похожие названия относятся к разным сценариям. Ниже разобрана действующая документация, проверенная 29 октября, без утверждения, что все её возможности появились в этот день.

Подготовьте доступ к нужному продукту

Документация ApiShip перечисляет договор с Ozon Доставкой для бизнеса, создание частного приложения и подключение службы в кабинете агрегатора. Для доступа используются Client ID и Client Secret этого приложения, а также ИНН компании. Это не приглашение передавать обычный пароль продавца сотруднику или вставлять секрет в публичный документ.

До настройки проверьте, какой договор заключён и кто отвечает за приложение. Созданное подключение должно быть понятно по названию и назначению, особенно если компания использует несколько логистических сервисов. Сохраните у ответственного сотрудника сведения о владельце доступа и процедуре его замены. Само появление службы в списке ещё не доказывает готовность отправлять реальные заказы.

Проверьте список методов доставки

После создания подключения методы добавляются в Ozon и активируются в ApiShip. Документация описывает выбор подходящего метода по данным отправителя и использование метода по умолчанию, если подходящий не найден. Поэтому значение по умолчанию нельзя оставлять случайным: оно способно определить маршрут в ситуации неполного сопоставления.

Редакционный пример проверки: у магазина два склада отправления. Для каждого создайте тестовый сценарий со своим адресом и проверьте выбранный метод. Если обе заявки попадают в один маршрут, выясните, соответствует ли это плану. Успешный расчёт доставки сам по себе не отвечает на вопрос, с какого объекта фактически ожидается отправка.

Отдельно проверьте обязательные данные заказа

В справке указано, что телефон получателя должен быть зарегистрирован в Ozon, иначе создать заказ не получится. Передача нулевой оценочной стоимости также не допускается. Это конкретные условия описанного подключения. Не пытайтесь устранить ошибку заменой контакта на чужой номер или случайным значением стоимости: так изменяется смысл заказа, а не исправляется интеграция.

Для оценочной стоимости проверьте всю цепочку передачи из магазина. Важны исходное значение и параметр процента, который передаёт агрегатор. Если один из этапов обнуляет сумму, настройка другого этапа не гарантирует исправления. При этом универсальная таблица параметров может содержать варианты, неприменимые к отдельной службе; ориентируйтесь на её специальные ограничения.

Что включить в приёмочный тест

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

Отдельно проверьте обработку ошибки. Сообщение для оператора должно позволять отличить неверный контакт от отсутствующего метода или проблемы авторизации. Не создавайте повторные заказы вслепую после каждого сбоя: сначала установите, появилось ли отправление на стороне службы. Иначе исправление одной ошибки может оставить несколько экземпляров одной клиентской покупки.

Для другого продукта существует инструкция ApiShip для продавцов Ozon. Для самостоятельной разработки пригодится разбор жизненного цикла заказа Ozon Delivery API. Выбор маршрута интеграции должен следовать реальному договору и процессу магазина, а не сходству названий в интерфейсе.