Поставщик — ABCP
ABCP — платформа, на которой работают многие поставщики автозапчастей. В PlatParts для такого поставщика используется тип подключения ABCP: по этим настройкам система запрашивает цены и наличие у поставщика в проценке и, если у вас настроен SPO, отправляет заказ поставщику автоматически.
Как понять снаружи, что сайт поставщика «на ABCP»: часто в подвале есть отметка вроде «Работает на abcp.ru». Точные учётные данные и поддомен всё равно нужно взять у менеджера поставщика или из вашего договора.
Где находится
Настройки продаж → Поставщики
Создайте нового поставщика или откройте существующего, в поле «Тип технического интерфейса» выберите ABCP, затем заполните блок «Настройки технического интерфейса» и сохраните карточку.
Что понадобится заранее
Обычно от поставщика или из личного кабинета ABCP нужны:
- поддомен (отдельное короткое имя для API — не весь адрес сайта);
- логин и пароль от учётной записи, с которой вы работаете в кабинете ABCP у этого поставщика;
- IP сервера для белого списка в ABCP — обязательно: без внесённого у поставщика адреса запросы к API не проходят, справочники не подгружаются, проценка не работает (где скопировать IP — в разделе ниже).
Официальное описание методов API ABCP: документация ABCP.API — пригодится, если поставщик просит уточнить технические детали.
Подключение: с чего начать
- Настройки продаж → Поставщики → Создать (или откройте уже созданного поставщика).
- В «Тип технического интерфейса» выберите ABCP.
- Заполните Поддомен, Логин и Пароль (см. следующий раздел).
- Нажмите Сохранить.
После сохранения платформа подтягивает из ABCP списки оплаты, доставки, офисов и адресов. Пустые списки при верных логине и пароле чаще всего значат, что IP ещё не в белом списке у поставщика — скопируйте «IP сервера» (раздел ниже), передайте менеджеру, дождитесь внесения и сохраните поставщика снова.
Если IP уже внесён, а списки пустые — проверьте поддомен, логин и пароль и снова нажмите Сохранить.
В поле «Поддомен» указывайте только одно слово-поддомен, без http://, без https:// и без окончания вида .public.api.abcp.ru. Это то самое «короткое имя», из которого система собирает адрес обращения к API ABCP. Если сомневаетесь — попросите у поставщика строку именно для API или пришлите им пример: ваш_поддомен.public.api.abcp.ru и попросите выделить только первую часть до точки.
Поля настроек ABCP: что за что отвечает
Поддомен, логин и пароль
- Поддомен — ключевой параметр: от него зависит, на какой «экземпляр» ABCP ходят запросы.
- Логин и Пароль — те же, что вы используете для входа в личный кабинет ABCP у этого поставщика (пароль в PlatParts хранится как у любого секрета; в запросах к ABCP используется безопасное преобразование, как требует их API).
Пока поддомен, логин или пароль с ошибкой — проценка не заработает. Пустые списки при верных трёх полях см. выше про IP в белом списке.
Способ оплаты
Выпадающий список «Способ оплаты» подгружается из ABCP: это те варианты, которые заведены в вашем кабинете у поставщика.
Зачем: при отправке заказа в ABCP система передаёт выбранный способ оплаты, чтобы заказ не «застрял» из‑за несогласованных условий.
Если список пустой — сначала IP в белый список (см. ниже), затем снова Сохранить. Если IP уже внесён — проверьте поддомен, логин и пароль.
Способ доставки
Аналогично, список «Способ доставки» приходит из ABCP. Это то, как вы забираете или получаете товар по договору с поставщиком (курьер, транспортная компания, другой вариант из кабинета).
Офис
Поле «Офис» — для вариантов самовывоза из справочника ABCP (склад/точка выдачи поставщика, как они заведены у него в системе).
Имеет смысл выбирать офис, который совпадает с вашей реальной схемой получения заказов.
Адрес доставки
Поле «Адрес доставки» — если ваш сценарий с поставщиком — доставка на адрес, выберите нужный адрес из списка ABCP.
Если вы всегда забираете заказ сами, чаще важнее офис и способ доставки; лишнее не заполняйте, если поставщик это не требует.
Дата отгрузки
Поле «Дата отгрузки» говорит системе, какую дату отгрузки передать в ABCP в момент оформления заказа (мгновенный заказ). Варианты:
- Первая доступная дата — берётся самая ранняя дата из того списка дат, который вернул ABCP для вашей корзины/условий.
- Вторая доступная дата — если у поставщика первая дата «нереальная» или занята, иногда удобнее сразу брать следующую.
- Последняя доступная дата — самая поздняя из предложенных; полезно, если вы сознательно заказываете «на потом».
- Указать вручную — дата берётся из поля «Дата отгрузки вручную» ниже. Используйте только если вы точно знаете допустимый формат даты для этого поставщика (он должен совпадать с тем, как даты приходят из ABCP в списке доступных дат).
- Не передавать дату отгрузки — в заказ уходит без этого параметра; подходит только если ABCP и ваш сценарий это допускают.
Если ABCP не вернул ни одной даты, система просто не пришлёт дату в заказе — и это нормально для варианта «первая/вторая/последняя», когда список пустой.
Дата отгрузки вручную
Заполняется только если в «Дата отгрузки» выбрано «Указать вручную». Впишите дату в том же виде, в каком её ожидает ABCP для вашего аккаунта (обычно это тот же формат, что в списке доступных дат отгрузки в кабинете). Неверный формат приведёт к ошибке уже на стороне поставщика.
Комментарий к заказу у поставщика
Общий текст, который каждый раз уходит в ABCP вместе с заказом — например, постоянное напоминание «звонить перед отгрузкой» или внутренний код договора. Не путайте с комментарием к отдельной строке заказа в PlatParts: это именно сообщение для ABCP.
Использовать online-склады
Если переключатель включён, при поиске брендов и позиций PlatParts передаёт в ABCP признак учёта online-складов (как это понимает сам ABCP).
На практике: при включённом варианте в проценке может быть больше вариантов с другой логикой наличия; при выключенном — более «узкий» поиск. Что именно меняется у конкретного поставщика, лучше спросить у менеджера поставщика и затем сравнить проценку до/после на одном и том же артикуле.
IP сервера и белый список в ABCP
Внизу блока «Настройки технического интерфейса» в карточке поставщика — поле «IP сервера» и кнопка «Копировать». Отправьте значение менеджеру поставщика для внесения в ABCP; после подтверждения сохраните поставщика ещё раз.
Если поставщик не принимает этот адрес — спросите у хостинга внешний (публичный) IP сервера (реже в поле показывается внутренний адрес узла).
Заказы у поставщика (SPO) и ABCP
У ABCP в PlatParts нет режима «положить в корзину у поставщика» через адаптер: поставщик не поддерживает такой сценарий в этой интеграции. Заказ уходит сразу (мгновенное оформление в ABCP).
Чтобы автоматический заказ прошёл успешно, у строки заказа в системе должны быть технические данные позиции из ABCP (идентификаторы, которые система получила при проценке). Проще говоря: заказывайте ту позицию, которую вы добавили в заказ именно из проценки по этому складу ABCP, а не «вручную набранную с нуля» с другого источника.
Если при заказе появляется ошибка про отсутствие данных позиции — чаще всего это значит, что позиция не из ABCP или проценка устарела; сделайте свежую проценку и добавьте позицию заново.
Что проверить после настройки
- Карточка поставщика сохраняется без ошибки.
- Заполнились выпадающие списки (оплата, доставка, при необходимости офис и адрес). Если пусто — IP в белый список (раздел выше), затем снова Сохранить; если IP уже внесён — поддомен, логин и пароль.
- На сайте откройте проценку по известному артикулу и убедитесь, что появляются предложения этого поставщика.
- Переключите «Использовать online-склады», сохраните и сравните результат проценки с тем, что вам обещал поставщик.
- Если используете SPO — оформите тестовый заказ на одну позицию из проценки этого поставщика и проверьте, что в ABCP появился заказ с верными способом оплаты, доставкой и датой отгрузки.
- IP сервера передан поставщику и внесён в ABCP (см. раздел выше); если адрес «не тот» — внешний IP у хостинга.
Сделайте скриншот успешно заполненной карточки поставщика и короткую заметку «какой офис и способ доставки выбрали». Через полгода это сильно экономит время, если сменится менеджер или пароль.
Для ABCP передача IP поставщику и внесение в белый список — обычно обязательное условие, а не «по желанию». Карточка поставщика в PlatParts может спокойно сохраняться, но списки не подгружаются, проценка пустая или с ошибками, пока ваш «IP сервера» не разрешён у поставщика в ABCP. Не спешите переписывать поддомен: сначала закройте вопрос с IP.
Неверный поддомен (лишний https://, целый домен вместо короткого имени и т. п.) тоже ломает подключение — если сомневаетесь, попросите у поставщика строку именно для API и в поле перенесите только поддомен, как в подсказке выше.