Новость на модерации
Содержание статьи
Практические рекомендации для эффективной работы с моделью FBO (Fulfillment by Operator) на основе опыта интеграции партнёров.
Подготовка к поставке
Прогноз поставок
Еженедельно (до 12:00 четверга) сообщайте менеджеру прогноз поставок на следующую неделю. Это позволяет Lamoda подготовить ресурсы для приёмки.
Создание поставки за 2 дня
- Создайте товары через
v1.nomenclatures.store - Дождитесь прохождения модерации
- Создайте поставку через
POST /api/v1/shipments/fulfilment - Дождитесь статуса
confirmed - Подготовьте документы
Документы
| Документ | Формат | Примечание |
| ТОРГ-12 / УПД | ЭДО (формализованный) | Дата не позже физической отгрузки |
| Транспортная накладная | Бумажный (1 экз.) | Должна быть у водителя |
warehouse_code обязателен с 30.09.2025. Получите список складов через v1.fbo.warehouse.list.
Работа с маркированными товарами
Обязательные категории
- Обувь
- Одежда (отдельные категории)
- Парфюмерия
Рекомендации
- Передавайте UIT, не полный DataMatrix — криптохвост не нужен
- Количество кодов = quantity — если 3 единицы, то 3 уникальных кода
- Валидируйте формат — 31 символ (без ТН ВЭД) или 38 (с ТН ВЭД)
{
"items": [
{
"sku": "SHOES-001",
"quantity": 2,
"datamatrixes": [
"010467003301005321gJk6o54AQBJfX2406401",
"010467003301005321hKl7p65BRCKgY2406401"
]
}
]
}
Синхронизация остатков
Стратегии
| Стратегия | Частота | Параметры |
| Полная синхронизация | 1-2 раза в сутки |
withZeroQuantity=1
|
| Инкрементальная | Каждые 15-30 минут |
updatedAt=YYYY-MM-DD+hh:mm:ss
|
Что НЕ видно в остатках
- Излишки — до оформления документов
- Брак — товары не прошедшие контроль качества
- На проверке — возвраты в процессе проверки
Обработка расхождений при приёмке
Типы расхождений
| Тип | Поле API | Действие |
| Недостача |
missing
|
Проверить отправку, подать претензию перевозчику |
| Излишки |
surplus
|
Оформить документы в течение 7 дней |
| Брак |
damaged
|
Возврат/утилизация по договорённости |
Сроки документов ТОРГ-2
- Передача ТОРГ-2 партнёру: 30 дней после приёмки (не позднее 5-го рабочего дня следующего месяца)
- Подписание партнёром: 5 дней после получения
- Оформление излишков: 7 календарных дней
Обработка возвратов
Типы возвратов
- Отказы (rejections) — клиент отказался до/во время примерки. Вторичная приёмка на складе.
- Возвраты (claims) — клиент вернул после покупки. Полная проверка качества.
Рекомендации
- Подпишитесь на нотификации
itemStatusChanged - Отслеживайте статусы
Claimed,Claimed ok - Товары после проверки автоматически возвращаются в сток
Мониторинг статусов поставок
Терминальные статусы
closed— поставка принята, товары в стокеrejected— поставка отменена
Промежуточные статусы (с 30.10.2025)
draft→validation→ready_for_shipment→unloading→processing→closed
fulfilmentShipmentStatusChanged для отслеживания статусов в реальном времени.
Частые ошибки
| Ошибка | Причина | Решение |
| Поставка не подтверждается | Отсутствуют атрибуты маркировки | Добавить обязательные атрибуты для этикетки |
validation_error
|
Ошибка в данных | Скачать файл поставки, проверить ошибки |
| Неизвестные артикулы | Товар не создан в системе |
Сначала создать товар через nomenclatures.store
|
| Смешанная поставка | Ювелирка вместе с другими товарами | Разделить на отдельные поставки |
Ювелирные товары
Особые требования:
- Поставка только отдельно от других категорий
- График: Пн-Пт, 8:00–16:00
- Обязательные параметры:
ean,weightна уровне каждого изделия
Чек-лист перед поставкой
- Товары созданы и прошли модерацию
-
warehouse_codeуказан - Коды маркировки (для маркированных категорий)
- Количество
datamatrixes=quantity - Документы в ЭДО подготовлены
- Дата в ТОРГ-12/УПД не позже физической отгрузки
- Нотификации настроены
См. также
Помогла эта информация?
Спасибо за отзыв
