Содержание статьи
Рекомендации FBO
Практические рекомендации для эффективной работы с FBO на основе опыта интеграции партнёров.
Справочная информация: Создание поставки · Статусы · Отчёты
Работа с маркированными товарами
При поставках маркируемых товаров (обувь, отдельные категории одежды, парфюмерия) передайте UIT-коды в поле datamatrixes. Количество кодов должно совпадать с quantity.
Полная документация по маркировке: формат UIT, обязательные категории, валидация, нормализация DataMatrix, Python-код — см. Маркировка товаров, CIS-коды, Работа с DataMatrix.
Типичные ошибки
| Ошибка | Причина | Решение |
Datamatrix count mismatch
|
Количество кодов ≠ quantity | Передайте ровно столько кодов, сколько указано в quantity |
Unknown SKU
|
Товар не создан |
Сначала POST /jsonrpc/v1/nomenclatures.store
|
warehouse_code required
|
Не указан склад |
Добавьте warehouse_code (snake_case!)
|
Invalid documentNumber
|
Превышена длина | Максимум 36 символов |
pallets required
|
Нет массива палет |
"pallets": [] (можно пустой)
|
Синхронизация остатков
| Стратегия | Частота | Метод |
| Полная | 1 раз в сутки (ночь) |
POST /jsonrpc/v1/stock.list
|
| Инкрементальная | Каждые 15-30 мин |
POST /jsonrpc/v1/stock.list + фильтр по дате
|
| По событию | При webhook | Обновление конкретных SKU |
Физическая поставка
Требования
- Товары на палетах в коробках
- Штрих-код на каждой палете (номер + название компании)
- Индивидуальная упаковка с EAN на каждом товаре
- Максимальные габариты: 60×40×30 см
Рабочие часы
- 24/7 (кроме 29 декабря — 6 января)
Приёмка
- Водитель за 15 мин до слота
- Приёмка по грузовым местам → отметка в ТН
- Поштучная приёмка → товарная накладная
- При расхождениях → ТОРГ-2
Интеграционный чек-лист
Перед запуском в продакшен:
- Обрабатываете все статусы FBO workflow
- Используете
warehouse_code(snake_case) в запросах - Передаёте все обязательные параметры
- Для маркируемых товаров:
datamatrixes, количество = quantity - Настроены вебхуки для отслеживания статусов
- Реализована обработка ошибок и ретраи
- Логирование всех API-вызовов
См. также
Помогла эта информация?
Спасибо за отзыв
0/1000
Отправить
