Склады FBY и LaaS: как сопоставить идентификатор Маркета с фактическим адресом
Как использовать справочник фулфилмент-складов Маркета: campaignId, идентификатор склада, название, адрес и координаты в реестре поставок.
Содержание статьи
Название склада в таблице поставок недостаточно для надёжного сопоставления. В справочнике фулфилмент-складов Маркета есть технический идентификатор, адрес и координаты: их полезно хранить вместе, не смешивая со складами самого продавца.
Почему название не должно быть единственным ключом
Список фулфилмент-складов возвращает id, name и address. Адрес включает город, улицу, дом, корпус, строение и координаты при наличии соответствующих полей. Для фильтра по складам конкретной кампании предусмотрен campaignId. Метод доступен моделям FBY и LaaS; это отдельный справочник складов Маркета.
Во внутреннем файле одно и то же место могут записать сокращённо, с названием населённого пункта или с привычным обозначением менеджера. Сопоставление только по строке способно объединить разные адреса либо создать две записи одного склада. Используйте технический ключ внутри системы, а понятное название оставьте для человека, который готовит и проверяет поставку.
Как собрать карту соответствий
В отдельной таблице храните идентификатор площадки, внутренний код, исходное название, полный адрес и момент обновления. Разбивайте адрес на поля до формирования печатной строки. Корпус и строение нельзя терять только потому, что в старом шаблоне было одно поле «дом». Не дополняйте отсутствующую часть адреса догадкой по названию склада.
Если в кабинете несколько магазинов, проверьте нужную кампанию перед выгрузкой. При этом не путайте campaignId с идентификатором склада. Связь с поставкой прослеживается через её данные; подход к такой цепочке описан в руководстве о дереве заявок FBY. Справочник мест хранения и конкретная заявка решают разные вопросы.
Как обновлять адреса без потери истории
Сравнивайте новую выгрузку с предыдущим снимком по идентификатору. Изменение отображаемого имени не должно автоматически создавать новый объект. Разницу в адресе, наоборот, стоит вынести на проверку перед следующей поездкой. Храните прошлое значение рядом с датой изменения, чтобы старые документы оставались объяснимыми и не подменялись текущим адресом задним числом.
Пропавшую строку сначала пометьте для разбора, особенно если изменился фильтр кампании. Отсутствие в одной выборке ещё не доказывает физическое закрытие склада. Проверьте параметры запроса и данные действующей поставки. Официальный справочник не заменяет подтверждение времени, условий приёмки и возможности привезти конкретный груз.
Что проверить перед использованием в документах
Возьмите несколько уже известных складов и сопоставьте технический код, адрес и данные заявки. Отдельно проверьте совпадающие названия, пустые части адреса и смену кампании. В документах не должны появляться координаты другого объекта только потому, что оператор выбрал похожую строку в списке. Результат проверки зафиксируйте по конкретным идентификаторам.
Не переносите правила объединения запасов собственных складов на этот справочник. Различие объясняет материал о группах складов продавца. Здесь цель — корректная привязка объекта Маркета к адресу, а не расчёт общего остатка. Руководство подготовлено по документации, проверенной 22 октября 2026 года; рекомендации по истории изменений являются редакционными.
Материал отражает сведения на указанную дату. Правила и условия работы площадок могут измениться. Редакционные принципы