Шаги для интеграции с API
1. Настройте магазин
- Зарегистрируйте ваш магазин на платформе LAliExpress, если не сделали этого ранее.
- Получите токен доступа для авторизации в методах локального API.
- Подключите логистическую модель:
- Если вы планируете отправлять товары с использованием интеграции LAliExpress с Почтой России, подключите логистическую модель FBS LAliExpress и Почта России.
- Если вы планируете отправлять товары любой другой службой доставки, подключите логистическую модель FBS Логистика продавца.
- Создайте и настройте шаблон доставки. Настройка зависит от вашей логистической модели:
- Подайте заявку на использование брендов, товары которых вы будете продавать.
- Создайте товарные группы. Группы — это ваши собственные категории. Они будут отображаться в вашем магазине.
2. Разместите товары
Затем используйте API:
3. Получите информацию о заказах
Получите актуальную информацию о своих заказах.
4. Отгрузите товары
Отгрузка по модели FBS LAliExpress и Почта России
Вот, как процесс выглядит в API:
- Создайте отправление.
В ответе, в параметре data.orders.logistic_orders.id придёт идентификатор созданного отправления.
Если какой-то заказ в отправлении окажется слишком большим, система автоматически разделит этот заказ на несколько отправлений. В этом случае в ответе вернётся несколько идентификаторов.
- Получите список отправлений.
При этом используйте фильтры, чтобы получить только нужные отправления.
В запросе вы можете передать идентификаторы только что созданных отправлений, а в ответе, в массиве data.logistic_orders вы получите более подробную информацию по этим отправлениям. Например:
- logistic_order_id — это идентификатор отправления.
- cut_off_date — это дата, до которой нужно передать это отправление в службу доставки.
- status — это статус отправления. Статус New означает, что отправление ещё создаётся. Статус AWAITING_ADDING_TO_HANDOVER означает, что отправление уже создано и вы можете перейти к следующему шагу.
- Если в заказах есть товары, которые требуют обязательной маркировки, коды маркировки должны быть эмитированы в системе «Честный Знак» и наклеены на посылки.
После этого добавьте коды маркировки в систему.
- Распечатайте этикетки, чтобы наклеить их на каждое отправление.
В ответе, в параметре label_url придёт ссылка на PDF с этикетками.
- Для отправлений, которые вы готовы отгрузить и которые находятся в статусе AWAITING_ADDING_TO_HANDOVER, создайте лист передачи. Это файл, который вы передаёте службе доставки вместе с отправлениями.
- Распечатайте лист передачи, чтобы приложить его к отправлениям.
В ответе, в параметре label_url придёт ссылка на PDF с листом передачи.
Дата в листе передачи обязательно должна совпадать с датой на этикетках и быть не позднее даты передачи отправления в службу доставки. Это нужно, чтобы отправление приняли на почте.
- После передачи в службу доставки, смените статус листа передачи на Transferred.
Ваши заказы отправлены.
- Далее вы можете отслеживать статус доставки и статус заказа.
Дальнейшее изменение статуса листа передачи зависит от Почты России и может не меняться. Но если меняется, то может принимать следующие значения:
- когда Почта России обработала лист передачи — Accepted;
- когда отправила посылку — Sent;
- когда доставила заказ — Completed.
Отгрузка по модели FBS Логистика продавца
Вот, как процесс выглядит в API:
- После отправки заказа, присвойте ему статус «Отправлен».
- Когда служба доставки сообщит, что заказ готов к получению, присвойте ему статус «Ожидает получения».
- Когда заказ получен покупателем, присвойте ему статус «Доставлен».