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