Перейти к основному содержимому

Общий интерфейс

API ABCP - Общий интерфейс​

Поиск​

Искать бренд по артикулу​

Операция: search/brands

Метод: GET

Осуществляет поиск по номеру детали и возвращает массив найденных брендов, имеющих деталь с искомым номером. Аналог этапа выбора бренда на сайте.

Параметры запроса

ПараметрОписание
userlogin*Имя пользователя в системе
userpsw*md5-хэш пароля пользователя в системе
number*Искомый номер детали
useOnlineStocksФлаг "использовать online-склады". Может принимать значения 0 или 1 (не использовать и использовать соответственно; по умолчанию - 0). Если выключено, то в выдачу не будут попадать детали с online-складов, что позволит увеличить скорость ответа.
officeIdId офиса.
localeЛокаль. Задается в формате language[_territory], например, ru_RU. По умолчанию используется локаль сайта.
https://demo.public.api.abcp.ru/search/brands/?userlogin=username&userpsw=md5pass&number=01089

Поля ответа

ПолеОписание
brandИмя производителя.
numberКод детали.
numberFix"Очищенный" код детали, содержащий только алфавитные и цифровые символы, и, иногда, знак слеша "/".
descriptionОписание детали.
availabilityФлаг "Имеется ли в наличии".

Искать товар по артикулу и бренду​

Операция: search/articles

Метод: GET

Осуществляет поиск по номеру детали и бренду. Возвращает массив найденных деталей. Так как один и тот же производитель может иметь несколько общепринятых наименований (например, GM и General Motors), система постарается это учесть, используя собственную базу синонимов брендов.

Параметры запроса

ПараметрОписание
userlogin*Имя пользователя в системе
userpsw*md5-хэш пароля пользователя в системе
number*Искомый номер детали
brand*Фильтр по имени производителя
useOnlineStocksФлаг "использовать online-склады". Может принимать значения 0 или 1 (не использовать и использовать соответственно; по умолчанию - 0). Если выключено, то в выдачу не будут попадать детали с online-складов, что позволит увеличить скорость ответа.
disableOnlineFilteringФлаг "отключить фильтры online поставщиков". Может принимать значения 0 или 1 (по умолчанию - 0). Если передать 1, то в выдачу попадут все товары online поставщика, без учета фильтров: "Минимальная вероятность поставки", "Минимальное наличие", "Показывать только точное наличие", "Ограничить срок поставки, в часах". "Доверять кроссам" - при этом включается.
disableFilteringФлаг отключения фильтрации поиска. Может принимать значения 0 или 1 (по умолчанию - 0). В значении 0 - результаты поиска сокращенные. В значении 1 - результаты поиска полные. (Как будто на сайте нажали "Показать все варианты").
withOutAnalogsФлаг "исключить поиск по аналогам". По умолчанию - 0.
profileIdПри передаче этого параметра, поисковая выдача api-администратора формируется как для клиента с переданным профилем. Работает только под API-администратором.
officeIdПри передаче этого параметра, поисковая выдача api-администратора формируется как для сотрудника, закрепленного за конкретным офисом (Персонал/Сотрудники/Офис) И с активированной галочкой "Отображение в результатах поиска только тех поставщиков, которые подключены к тому же офису, что и этот сотрудник". Работает только под API-администратором.
https://demo.public.api.abcp.ru/search/articles/?userlogin=username&userpsw=md5pass&number=01089&brand=Febi

Поля ответа

к сведению

Для пользователя "API-администратор" по каждой позиции возвращается цена поставщика в поле priceIn в валюте сайта, в поле priceRate - коэффициент пересчета цены поставщика из валюты поставщика в валюту сайта, в поле price для администратора возвращается цена, по умолчанию рассчитанная для гостя. При передаче параметра profileId цены и предложения выдаются в соответствии с настройками профиля.

ПолеОписание
brandИмя производителя.
numberКод детали.
numberFix"Очищенный" код детали, содержащий только алфавитные и цифровые символы, и, иногда, знак слеша "/".
descriptionОписание детали.
availabilityНаличие детали на складе.
packingМин. партия для заказа (кратность).
deliveryPeriodСрок поставки (в часах).
deliveryPeriodMaxМаксимальный срок поставки (в часах).
deadlineReplaceЗамена срока поставки (используется вместа срока поставки, если не заполнен максимальный срок поставки).
distributorCodeКод поставщика ("человеко-читаемый" код, который может (но не должен) установить владелец сайта для прайса/поставщика).
supplierCodeКод поставки (ID маршрута поставщика). Необходим для добавления товара в корзину.
supplierColorЦвет поставщика (как в результатах поиска на сайте).
supplierDescriptionОписание поставщика (как в результатах поиска на сайте).
itemKeyКод позиции. Необходим для добавления товара в корзину. **Внимание! Не является уникальным идентификатором!**Параметр "itemKey" обязателен для передачи заказа онлайн-поставщику, а также при передаче заказа от франчайзи к ГК.
priceЦена в валюте сайта.
maxPriceМаксимальная (предельная) цена реализации, передаваемая поставщиком. ПРЦ
weightВес одной единицы товара в килограммах.
volumeОбъем одной единицы товара.
deliveryProbabilityВероятность поставки товара поставщика.
descriptionOfDeliveryProbabilityОписание вероятности поставки
lastUpdateTimeВремя последнего обновления
additionalPriceДополнительная цена в валюте сайта.
noReturnФлаг "Без возврата"
isUsedПризнак б/у детали
meta: tnvedТН ВЭД код из прайса
meta: okpd2ОКПД 2 код из прайса
meta: gtinGTIN код из прайса
meta: certificateEAEUСсылка на сертификат или декларацию соответствия
distributorIdИдентификатор поставщика
grpГруппа поставщика
codeВнутренний код детали (присутствует только при условии что код выгружается в прайсе поставщика), используется как правило для синхронизации с 1С
nonliquidПризнак неликвидности детали (присутствует только при условии выгрузки в прайсе поставщика)

Пакетный запрос без учета аналогов​

Операция: search/batch

Метод: POST

Осуществляет поиск по номеру производителя и бренду детали. Возвращает массив найденных деталей.

Внимание! Данная операция не выполняет поиск по online-складам.

Параметры запроса

ПараметрОписание
userlogin*Имя пользователя в системе
userpsw*md5-хэш пароля пользователя в системе
search*Набор искомых деталей в формате brand - number. Максимум 100 деталей.
profileIdПри передаче этого параметра, поисковая выдача api-администратора формируется как для клиента с переданным профилем. Работает только под API-администратором.
https://demo.public.api.abcp.ru/search/batch

Тело POST запроса

userlogin=username&userpsw=md5pass&search[0][number]=01089&search[0][brand]=Febi&search[1][number]=333305&search[1][brand]=Kyb

Поля ответа

к сведению

Для пользователя "API-администратор" по каждой позиции возвращается цена поставщика в поле priceIn в валюте сайта, в поле priceRate - коэффициент пересчета цены поставщика из валюты поставщика в валюту сайта, в поле price для администратора возвращается цена, по умолчанию рассчитанная для гостя. При передаче параметра profileId цены и предложения выдаются в соответствии с настройками профиля.

ПолеОписание
brandИмя производителя.
numberКод детали.
numberFix"Очищенный" код детали, содержащий только алфавитные и цифровые символы, и, иногда, знак слеша "/".
descriptionОписание детали.
availabilityНаличие детали на складе.
packingМин. партия для заказа (кратность).
deliveryPeriodСрок поставки (в часах).
deliveryPeriodMaxМаксимальный срок поставки (в часах).
distributorCodeКод поставщика ("человеко-читаемый" код, который может (но не должен) установить владелец сайта для прайса/поставщика).
supplierCodeКод поставки. (ID маршрута поставщика). Необходим для добавления товара в корзину.
supplierColorЦвет поставщика (как в результатах поиска на сайте).
supplierDescriptionОписание поставщика (как в результатах поиска на сайте).
itemKeyКод позиции. Необходим для добавления товара в корзину. **Внимание! Не является уникальным идентификатором!**Параметр "itemKey" обязателен для передачи заказа онлайн-поставщику, а также при передаче заказа от франчайзи к ГК.
priceЦена в валюте сайта.
maxPriceМаксимальная (предельная) цена реализации, передаваемая поставщиком. ПРЦ
weightВес одной единицы товара в килограммах.
volumeОбъем одной единицы товара.
deliveryProbabilityВероятность поставки товара поставщика.
descriptionOfDeliveryProbabilityОписание вероятности поставки
additionalPriceДополнительная цена в валюте сайта.
noReturnФлаг "Без возврата"
meta: tnvedТН ВЭД код из прайса
meta: okpd2ОКПД 2 код из прайса
meta: gtinGTIN код из прайса
meta: certificateEAEUСсылка на сертификат или декларацию соответствия
grpГруппа поставщика
codeВнутренний код детали (присутствует только при условии что код выгружается в прайсе поставщика), используется как правило для синхронизации с 1С

Получать историю поиска​

Операция: search/history

Метод: GET

Возвращает массив последних (не более 50) поисковых запросов текущего пользователя.

Параметры запроса

ПараметрОписание
userlogin*Имя пользователя в системе
userpsw*md5-хэш пароля пользователя в системе
https://demo.public.api.abcp.ru/search/history?userlogin=username&userpsw=md5pass

Поля ответа

Метод возвращает массив объектов вида:

ПолеОписание
brandИмя производителя.
numberНомер детали (код производителя).
numberFix"Очищенный" код детали, содержащий только алфавитные и цифровые символы, и, иногда, знак слеша "/".
descriptionОписание детали.
datetimeДата и время поиска в формате ГГГГММДДччммсс.

Подсказки по поиску​

Операция: search/tips

Метод: GET

Возвращает по части номера массив подходящих пар бренд - номер

Параметры запроса

ПараметрОписание
userlogin*Имя пользователя в системе
userpsw*md5-хэш пароля пользователя в системе
number*Номер (часть номера) детали
localeЛокаль. Задается в формате language[_territory], например, ru_RU. По умолчанию используется локаль сайта.
https://demo.public.api.abcp.ru/search/tips?userlogin=username&userpsw=md5pass&number=0108

Поля ответа

Метод возвращает массив объектов вида:

ПолеОписание
brandИмя производителя.
numberНомер детали (код производителя).
descriptionОписание запчасти

Поиск сопутствующих товаров​

Операция: advices

Метод: GET

Функция реализует механизм "с этим товаром покупают" на основе статистики покупки комплектов товаров. Типичный пример использования функции: покупатель выбрал масляный фильтр - система рекомендует остальные товары из набора для ТО. Или, покупатель выбрал левый передний амортизатор, система покажет правый передний. Осуществляет поиск сопутствующих товаров по запрашиваемой паре "Бренд-номер". Дополнительно можно передать параметр limit (рекомендуется = 5), ограничивающий выдачу рекомендаций.

Параметры запроса

ПараметрОписание
userlogin*Имя пользователя в системе
userpsw*md5-хэш пароля пользователя в системе
brand*Имя производителя
number*Номер детали
limitнеобязательный параметр, ограничивающий выдачу
localeЛокаль. Задается в формате language[_territory], например, ru_RU. Это же значение используется по умолчанию.)
https://demo.public.api.abcp.ru/advices/?userlogin=username&userpsw=md5pass&brand=MB&number=A2058350147&limit=5

Поля ответа

Метод возвращает массив объектов вида:

ПолеОписание
brandИмя производителя.
numberНомер детали (код производителя).
totalКоличество заказов, в которых встречается данное сочетание товаров
descriptionОписание товара

Механизм "С этим товаром покупают"​

Операция: advices/batch

Метод: POST

Функция реализует механизм "с этим товаром покупают" по нескольким товарам. Дополнительно можно передать параметр limit (рекомендуется = 5), ограничивающий выдачу рекомендаций. Параметры товаров передаются в виде JSON-массива articles из объектов с полями 'brand' и 'number'.

При использовании этой операции НЕОБХОДИМО! передавать заголовок Content-Type: application/json, а параметры передавать в теле запроса в виде JSON.

Параметры запроса

ПараметрОписание
userlogin*Имя пользователя в системе
userpsw*md5-хэш пароля пользователя в системе
articles*массив объектов, содержащих brand и number
limitнеобязательный параметр, ограничивающий выдачу

https://demo.public.api.abcp.ru/advices/batch

Тело POST запроса (raw JSON)

{
"userlogin": "username",
"userpsw": "md5pass",
"articles": [
{ "brand": "Shell", "number": "550051529" },
{ "brand": "LUKOIL", "number": "3148675" }
],
"limit": 5
}

Поля ответа

Метод возвращает массив объектов вида:

ПолеОписание
brandИмя производителя.
numberНомер детали (код производителя).
advicesМассив объектов с полями: brand - имя производителя, number - номер детали, total - количество заказов, в которых встречается данное сочетание товаров

Корзина​

Получение списка корзин​

Операция: basket/multibasket

Метод: GET

Параметры запроса

ПараметрОписание
userlogin*Имя пользователя в системе
userpsw*md5-хэш пароля пользователя в системе
https://demo.public.api.abcp.ru/basket/multibasket?userlogin=XXXXXX&userpsw=XXXXXXX

Поля ответа

Метод возвращает массив объектов вида:

ПолеОписание
idИдентификатор корзины
nameНазвание корзины

Добавлять товар в корзину. Удаление товара из корзины​

Операция: basket/add

Метод: POST

Осуществляет подготовку к отправке заказа на товары по номеру производителя, бренду и коду поставки или по коду детали. Возвращает статус добавления товара в корзину по каждой позиции.

При добавлении brand - number - itemKey - supplierCode позиции, которая уже была ранее добавлена в корзину, значение quantity будет прибавлено к существующему.

Удаление позиции - при добавлении brand - number - itemKey - supplierCode позиции, которая уже была ранее добавлена в корзину, со значением quantity равным 0, позиция будет удалена из корзины. Для изменения количества рекомендуется удалять позицию и ее добавлять заново с требуемым количеством.

Параметры запроса

ПараметрОписание
userlogin*Имя пользователя в системе
userpsw*md5-хэш пароля пользователя в системе
positions*Набор добавляемых деталей в формате brand - number - itemKey - supplierCode с указанием добавляемого количества в поле quantity и комментария к позиции в поле comment
basketIdНеобязательный параметр - идентификатор корзины при использовании мультикорзины
https://demo.public.api.abcp.ru/basket/add

Тело POST запроса

userlogin=username&userpsw=md5pass&positions[0][number]=01089&positions[0][brand]=Febi&positions[0][supplierCode]=54325&positions[0][itemKey]=HFGJKfkdjghreiHJhfdjKhjskhfk&positions[0][quantity]=15&positions[1][number]=333305&positions[1][brand]=Kyb&positions[1][supplierCode]=87654&positions[1][itemKey]=HjfdksahGHHfsfkdjslajfnmra&positions[1][quantity]=4&positions[1][comment]=срочно!!!

или

userlogin=username&userpsw=md5pass&positions[0][code]=FE01089&positions[0][quantity]=15&positions[0][itemKey]=HFGJKfkdjghreiHJhfdjKhjskhfk&positions[1][code]=KY333305&positions[1][quantity]=4&positions[1][itemKey]=HjfdksahGHHfsfkdjslajfnmra&positions[1][comment]=срочно!!!

Поля ответа

Метод возвращает набор узлов вида:

ПолеОписание
statusСтатус добавления пакета товаров. При возникновении ошибки добавления хотя бы в одной из позиций, параметр примет значение 0, иначе 1.
positionsСписок позиций со статусом выполнения операции.
ПолеОписание
brandИмя производителя.
numberНомер детали (код производителя).
numberFix"Очищенный" код детали, содержащий только алфавитные и цифровые символы, и, иногда, знак слеша "/".
codeКод детали (уникальный код на сайте).
supplierCodeКод поставки. (ID маршрута поставщика)
descriptionОписание детали.
quantityЗаказываемое количество
commentКомментарий к позиции.
statusСтатус добавления позиции в корзину. Принимает значение 0 - произошла ошибка или 1, если все успешно.
errorMessageТекст сообщения об ошибке при статусе 0

Очистка корзины​

Операция: basket/clear

Метод: POST

Удаляет все позиции из корзины.

Параметры запроса

ПараметрОписание
userlogin*Имя пользователя в системе
userpsw*md5-хэш пароля пользователя в системе
basketIdНеобязательный параметр - идентификатор корзины при использовании мультикорзины
https://demo.public.api.abcp.ru/basket/clear

Тело POST запроса

userlogin=username&userpsw=md5pass

Поля ответа

Метод возвращает ответ:

ПолеОписание
statusСтатус очистки корзины. Принимает значение 0 - произошла ошибка или 1, если все успешно.
errorMessageТекст сообщения об ошибке при статусе 0.

Получать список товаров в корзине​

Операция: basket/content

Метод: GET

Возвращает список позиций, находящихся в корзине. Внимание! Если у вас подключена опция "Корзина: разрешать частичное оформление заказа". То в ответ веб-сервиса будут попадать только отмеченные позиции.

Параметры запроса

ПараметрОписание
userlogin*Имя пользователя в системе
userpsw*md5-хэш пароля пользователя в системе
basketIdНеобязательный параметр - идентификатор корзины при использовании мультикорзины
https://demo.public.api.abcp.ru/basket/content?userlogin=username&userpsw=md5pass

Поля ответа

Метод возвращает набор узлов вида:

ПолеОписание
brandИмя производителя.
numberНомер детали (код производителя).
numberFix"Очищенный" код детали, содержащий только алфавитные и цифровые символы, и, иногда, знак слеша "/".
codeКод детали (уникальный код на сайте).
supplierCodeКод поставки. (ID маршрута поставщика)
itemKeyКод позиции. Необходим для добавления товара в корзину. **Внимание! Не является уникальным идентификатором!**Параметр "itemKey" обязателен для передачи заказа онлайн-поставщику, а также при передаче заказа от франчайзи к ГК
descriptionОписание детали.
priceЦена за штуку
priceRateКурс перевода цены в валюту сайта
priceInSiteCurrencyЦена ПРОДАЖИ в валюте сайта
quantityЗаказываемое количество
deadlineСрок поставки в часах
deadlineMaxМаксимальный срок поставки в часах
commentКомментарий к позиции.
statusСтатус позиции в корзине. Принимает значение 0 - при ошибке или 1, если все успешно.
positionIdНомер позиции заказа.
packingМин. партия для заказа (кратность).
errorMessageТекст сообщения об ошибке при статусе 0

Получение опций корзины​

Операция: basket/options

Метод: GET

Возвращает значение некоторых опций Корзины.

Параметры запроса

ПараметрОписание
userlogin*Имя пользователя в системе
userpsw*md5-хэш пароля пользователя в системе
https://demo.public.api.abcp.ru/basket/options

Поля ответа

Поле options содержащее массив со списком:

ПолеОписание
disallow_new_shipment_addressЗначение опции "Корзина: запрещать создание нового адреса доставки". Может пригодиться при использовании Добавление адреса доставки
self_shipmentЗначение опции "Корзина: "Самовывоз" в адресах доставки"

Корзина - оплата и доставка​

Получение списка способов оплаты​

Операция: basket/paymentMethods

Метод: GET

Возвращает список доступных способов оплаты. Идентификатор способа оплаты необходим при отправке заказа (при включенной опции "Корзина: показывать тип оплаты").

Параметры запроса

ПараметрОписание
userlogin*Имя пользователя в системе
userpsw*md5-хэш пароля пользователя в системе
https://demo.public.api.abcp.ru/basket/paymentMethods?userlogin=username&userpsw=md5pass

Поля ответа

Метод возвращает набор узлов вида:

ПолеОписание
idИдентификатор способа оплаты.
nameСпособ оплаты.

Получение списка способов доставки​

Операция: basket/shipmentMethods

Метод: GET

Возвращает список доступных способов доставки. Идентификатор способа доставки необходим при отправке заказа (при включенной опции "Корзина: показывать типы доставки").

Параметры запроса

ПараметрОписание
userlogin*Имя пользователя в системе
userpsw*md5-хэш пароля пользователя в системе
https://demo.public.api.abcp.ru/basket/shipmentMethods?userlogin=username&userpsw=md5pass

Поля ответа

Метод возвращает набор узлов вида:

ПолеОписание
idИдентификатор способа доставки.
nameСпособ доставки.

Получение списка офисов самовывоза​

Операция: basket/shipmentOffices

Метод: GET

Возвращает список доступных офисов для самовывоза. Идентификатор офиса самовывоза при отправке заказа (при включенной опции "Заказы: показывать офисы при выборе самовывоза").

Параметры запроса

ПараметрОписание
userlogin*Имя пользователя в системе
userpsw*md5-хэш пароля пользователя в системе
officesTypeНе обязательный параметр:
https://demo.public.api.abcp.ru/basket/shipmentOffices?userlogin=username&userpsw=md5pass

Поля ответа

Метод возвращает набор узлов вида:

ПолеОписание
idИдентификатор офиса
nameНазвание офиса

Получение списка адресов доставки​

Операция: basket/shipmentAddresses

Метод: GET

Возвращает список доступных адресов доставки. Идентификатор адреса доставки необходим при отправке заказа.

Параметры запроса

ПараметрОписание
userlogin*Имя пользователя в системе
userpsw*md5-хэш пароля пользователя в системе
https://demo.public.api.abcp.ru/basket/shipmentAddresses?userlogin=username&userpsw=md5pass

Поля ответа

Метод возвращает набор узлов вида:

ПолеОписание
idИдентификатор адреса доставки.
nameАдрес доставки.

Получение списка дат отгрузки​

Операция: basket/shipmentDates

Метод: GET

Возвращает список доступных дат отгрузки. Дата отгрузки необходима при отправке заказа при включенной опции "Корзина: показывать дату отгрузки".

Параметры запроса

ПараметрОписание
userlogin*Имя пользователя в системе
userpsw*md5-хэш пароля пользователя в системе
minDeadlineTimeМинимальный срок поставки, в часах, среди всех позиций, которые вы собрались отправлять в заказ.
maxDeadlineTimeМаксимальный срок поставки, в часах, среди всех позиций, которые вы собрались отправлять в заказ.
shipmentAddressid адреса доставки. Необязательный параметр. Необходимо отправлять, если заказ будет оформлен с доставкой. Для подготовки доставки офисам может требоваться дополнительное время на сборку. При отправке параметра shipmentAddress получаем актуальные даты отгрузки с учетом времени комплектации в настройках офиса.

Пример запроса

https://demo.public.api.abcp.ru/basket/shipmentDates?userlogin=username&userpsw=md5pass&minDeadlineTime=24&maxDeadlineTime=48

Поля ответа

Метод возвращает набор узлов вида:

ПолеОписание
dateДата отгрузки в формате ГГГГ-ММ-ДД
nameДата отгрузки и день недели для отображения

Добавление адреса доставки​

Операция: basket/shipmentAddress

Метод: POST

Для текущего покупателя добавляет "адрес доставки" и возвращает его идентификатор используемый в методе "Отправка корзины в заказ".

Параметры запроса

ПараметрОписание
userlogin*Имя пользователя в системе
userpsw*md5-хэш пароля пользователя в системе
address*Обязательный, строка содержащая адрес.
https://demo.public.api.abcp.ru/basket/shipmentAddress

Тело POST запроса

userlogin=username&userpsw=md5pass&address=Россия, г Москва, Пролетарский пр-кт

Поля ответа

ПолеОписание
shipmentAddressIdИдентификатор адреса доставки.

Заказы​

Отправлять корзину в заказ​

Операция: basket/order

Метод: POST

Осуществляет отправку позиций, содержащихся в корзине, в заказ. Возвращает статус операции, а так же список созданных заказов со списками позиций в каждом из них. Внимание! При отправке заказа могут возникнуть ошибки, при этом, часть позиций могут отправиться. Следовательно, независимо от статуса выполнения операции, необходимо проверять узел orders на наличие сформированных заказов.

Внимание изменения с 10 августа 2017! Параметр shipmentAddress становится обязательным для заполнения. Получить идентификатор адреса доставки можно с помощью операции basket/shipmentAddresses, если она не возвращает никаких значений, то shipmentAddress - является необязательным параметром. Если не используете доставку на адрес, а пользуетесь самовывозом, то необходимо передать shipmentAddress=0.

Внимание изменения с 09 июля 2018! Параметр shipmentDate становится обязательным, если Вы используете функционал "Дни отгрузки"(опция "Корзина: показывать дату отгрузки").

Внимание изменения с 20 октября 2025! Параметр shipmentMethod становится обязательным для заполнения. Получить идентификатор способа доставки можно с помощью операции basket/shipmentMethods, если она не возвращает никаких значений, то shipmentMethod - является необязательным параметром.

Внимание! Чтобы корректно использовать параметр positionIds, в ПУ должна быть включена опция "Корзина: разрешать частичное оформление заказа".

Параметры запроса

ПараметрОписание
userlogin*Имя пользователя в системе
userpsw*md5-хэш пароля пользователя в системе
paymentMethod*Идентификатор способа оплаты.
shipmentMethod*Идентификатор способа доставки.
shipmentAddress*Идентификатор адреса доставки.
shipmentOfficeИдентификатор офиса самовывоза
shipmentDate*Дата отгрузки.
commentКомментарий к заказу.
basketIdНеобязательный параметр - идентификатор корзины при использовании мультикорзины
wholeOrderOnlyПризнак - оформить заказ целиком. Принимаемые значения - 0/1. По умолчанию - 0.
positionIdsНеобязательный параметр - массив с номерами позиций заказа. Номера возвращает запрос basket/content
clientOrderNumberНеобязательный параметр-номер заказа в системе учета клиента
https://demo.public.api.abcp.ru/basket/order

Тело POST запроса

userlogin=username&userpsw=md5pass&paymentMethod=37&shipmentMethod=4323&shipmentAddress=788&shipmentDate=2012-12-21&comment=срочно

Поля ответа

Метод возвращает объект вида:

ПолеОписание
statusСтатус отправки корзины. При возникновении ошибки, параметр примет значение 0, иначе - 1.
errorMessageТекст сообщения об ошибке при статусе 0
clientOrderNumberномер заказа в системе учета клиента
ordersСписок созданных заказов со списком позиций.
ПолеОписание
numberНомер заказа в портале
statusСтатус заказа
statusIdУникальный идентификатор статус заказа
statusCodeКод статуса заказа
positionsQuantityКоличество позиций
sumСумма заказа
dateДата заказа
commentКомментарий к заказу
wholeOrderOnlyПризнак - оформить заказ целиком.
positionsСписок позиций заказа.
ПолеОписание
brandИмя производителя.
numberНомер детали (код производителя).
numberFix"Очищенный" код детали, содержащий только алфавитные и цифровые символы, и, иногда, знак слеша "/".
codeКод детали (уникальный код на сайте).
supplierCodeКод поставки.(ID маршрута поставщика)
itemKeyКод позиции. Необходим для добавления товара в корзину. **Внимание! Не является уникальным идентификатором!**Параметр "itemKey" обязателен для передачи заказа онлайн-поставщику, а также при передаче заказа от франчайзи к ГК
descriptionОписание детали.
quantityЗаказываемое количество
priceЦена за единицу товара
deadlineСрок поставки в часах
deadlineMaxМаксимальный срок поставки в часах
commentКомментарий к позиции
statusСтатус позиции заказа
statusIdУникальный идентификатор статус позиции заказа
statusCodeКод статуса позиции заказа
positionIdНомер позиции заказа
warning

Для этой операции существует ограничение на 500 позиций для одного заказа. При попытке добавить большее количество позиций, операция завершится с ошибкой

Моментальный заказ​

Операция: orders/instant

Метод: POST

Объединяет в себе операции basket/add и basket/order, то есть, добавляет переданный в параметрах список товаров в корзину и сразу же отправляет их в заказ. У данной операции есть важная особенность - она не учитывает позиции, которые уже лежат в корзине, в заказ они не попадут и останутся в корзине пользователя. Использование данной операции оптимально при автоматическом перезаказе у клиентов платформы ABCP.

Возвращает статус операции, а так же список созданных заказов со списками позиций в каждом из них.

Внимание! При отправке заказа могут возникнуть ошибки, при этом, часть позиций могут отправиться. Независимо от статуса выполнения операции, необходимо проверять узел orders на наличие сформированных заказов.

Внимание! Параметр shipmentAddress становится обязательным для заполнения. Получить идентификатор адреса доставки можно с помощью операции basket/shipmentAddresses, если она не возвращает никаких значений, то shipmentAddress - является необязательным параметром. Если не используете доставку на адрес, а пользуетесь самовывозом, то необходимо передать shipmentAddress=0.

Внимание изменения с 20 октября 2025! Параметр shipmentMethod становится обязательным для заполнения. Получить идентификатор способа доставки можно с помощью операции basket/shipmentMethods, если она не возвращает никаких значений, то shipmentMethod - является необязательным параметром.

Внимание Параметр shipmentDate становится обязательным, если Вы используете функционал "Дни отгрузки"(опция "Корзина: показывать дату отгрузки").

Параметры запроса

ПараметрОписание
userlogin*Имя пользователя в системе
userpsw*md5-хэш пароля пользователя в системе
positions*Набор добавляемых деталей в формате brand - number - itemKey - supplierCode или code с указанием добавляемого количества в поле quantity и комментария к позиции в поле comment
paymentMethod*Идентификатор способа оплаты.
shipmentMethod*Идентификатор способа доставки.
shipmentAddress*Идентификатор адреса доставки.
shipmentOfficeИдентификатор офиса самовывоза
shipmentDate*Дата отгрузки.
commentКомментарий к заказу.
basketIdНеобязательный параметр - идентификатор корзины при использовании мультикорзины
wholeOrderOnlyПризнак - оформить заказ целиком. Принимаемые значения - 0/1. По умолчанию - 0.
clientOrderNumberНеобязательный параметр - номер заказа в системе учета клиента
https://demo.public.api.abcp.ru/orders/instant

Тело POST запроса

userlogin=username&userpsw=md5pass&positions[0][number]=01089&positions[0][brand]=Febi&positions[0][supplierCode]=54325&positions[0][itemKey]=HFGJKfkdjghreiHJhfdjKhjskhfk&positions[0][quantity]=15&positions[1][number]=333305&positions[1][brand]=Kyb&positions[1][supplierCode]=87654&positions[1][itemKey]=HjfdksahGHHfsfkdjslajfnmra&positions[1][quantity]=4&positions[1][comment]=срочно!!!&paymentMethod=37&shipmentMethod=4323&shipmentAddress=788&shipmentDate=2012-12-21&comment=срочно
или
userlogin=username&userpsw=md5pass&positions[0][code]=FE01089&positions[0][quantity]=15&positions[0][itemKey]=HFGJKfkdjghreiHJhfdjKhjskhfk&positions[1][code]=KY333305&positions[1][quantity]=4&positions[1][itemKey]=HjfdksahGHHfsfkdjslajfnmra&positions[1][comment]=срочно!!!&paymentMethod=37&shipmentMethod=4323&shipmentAddress=788&shipmentDate=2012-12-21&comment=срочно

Поля ответа

Метод возвращает объект вида:

ПолеОписание
statusСтатус отправки корзины. При возникновении ошибки, параметр примет значение 0, иначе - 1.
errorMessageТекст сообщения об ошибке при статусе 0
clientOrderNumberНеобязательный параметр - номер заказа в системе учета клиента
ordersСписок созданных заказов со списком позиций.
ПолеОписание
numberНомер заказа в портале
statusСтатус заказа
statusIdУникальный идентификатор статус заказа
statusCodeКод статуса заказа
positionsQuantityКоличество позиций
sumСумма заказа
dateДата заказа
commentКомментарий к заказу
wholeOrderOnlyПризнак - оформить заказ целиком.
positionsСписок позиций заказа.
ПолеОписание
brandИмя производителя.
numberНомер детали (код производителя).
numberFix"Очищенный" код детали, содержащий только алфавитные и цифровые символы, и, иногда, знак слеша "/".
codeКод детали (уникальный код на сайте).
supplierCodeКод поставки.(ID маршрута поставщика)
itemKeyКод позиции. Необходим для добавления товара в корзину. **Внимание! Не является уникальным идентификатором!**Параметр "itemKey" обязателен для передачи заказа онлайн-поставщику, а также при передаче заказа от франчайзи к ГК
descriptionОписание детали.
quantityЗаказываемое количество
priceЦена за единицу товара
deadlineСрок поставки в часах
deadlineMaxМаксимальный срок поставки в часах
commentКомментарий к позиции
statusСтатус позиции заказа
statusIdУникальный идентификатор статус позиции заказа
statusCodeКод статуса позиции заказа
warning

Для этой операции существует ограничение на 500 позиций для одного заказа. При попытке добавить большее количество позиций, операция завершится с ошибкой

Получение списка статусов​

Операция: orders/statuses

Метод: GET

Осуществляет получение списка всех имеющихся статусов . Возвращает список статусов.

Параметры запроса

ПараметрОписание
userlogin*Имя пользователя в системе
userpsw*md5-хэш пароля пользователя в системе
https://demo.public.api.abcp.ru/orders/statuses?userlogin=username&userpsw=md5pass

Поля ответа Метод возвращает массив объектов вида:

ПолеОписание
idid статуса
nameназвание статуса
colorЦвет статуса
isFinalStatusПризнак конечного статуса

Получение позиций заказов со статусами​

Операция: orders/list

Метод: GET

Принимает список номеров заказов. Осуществляет получение статусов заказов и позиций внутри. Возвращает список заказов со списком позиций в каждом из них.

Параметры запроса

ПараметрОписание
userlogin*Имя пользователя в системе
userpsw*md5-хэш пароля пользователя в системе
orders*список номеров заказов
https://demo.public.api.abcp.ru/orders/list?userlogin=username&userpsw=md5pass&orders[0]=5642365&orders[1]=8765875

Поля ответа

Метод возвращает массив объектов вида:

ПолеОписание
numberНомер заказа в портале
statusСтатус заказа
statusIdИдентификатор статуса заказа уникальный в рамках всей системы
statusCodeКод статуса заказа
statusColorЦвет статуса
positionsQuantityКоличество позиций
deliveryAddressIdИдентификатор адреса доставки
deliveryAddressАдрес доставки
deliveryOfficeIdИдентификатор офиса самовывоза
deliveryOfficeОфис самовывоза
deliveryTypeIdИдентификатор типа доставки
deliveryTypeТип доставки
paymentTypeIdИдентификатор типа оплаты
paymentTypeТип оплаты
deliveryCostСтоимость доставки
shipmentDateДата отгрузки
sumСумма заказа
dateДата заказа
codeЯчейка заказа
debtДолг по оплате заказа
commentКомментарий к заказу
clientOrderNumberНомер заказа в системе учета клиента
positionsСписок позиций заказа.
notesСписок заметок заказа.

Узел positions содержит массив объектов вида:

ПолеОписание
positionIdID позиции
brandИмя производителя.
numberНомер детали (код производителя).
numberFix"Очищенный" код детали, содержащий только алфавитные и цифровые символы, и, иногда, знак слеша "/".
codeКод детали (уникальный код на сайте).
supplierCodeКод поставки.
itemKeyКод позиции. Внимание! Не является уникальным идентификатором! Параметр "itemKey" обязателен для передачи заказа онлайн-поставщику, а также при передаче заказа от франчайзи к ГК.
descriptionОписание детали.
quantityOrderedЗаказываемое количество
quantityИтоговое количество
priceЦена за единицу товара
priceRateКурс перевода цены в валюту сайта
priceInSiteCurrencyЦена ПРОДАЖИ в валюте сайта
deadlineСрок поставки в часах
deadlineMaxМаксимальный срок поставки в часах
commentКомментарий к позиции
commentAnswerОтвет сотрудника на комментарий по позиции
statusСтатус позиции заказа
statusIdИдентификатор статуса позиции заказа уникальный в рамках всей системы
statusCodeКод статуса позиции заказа
statusColorЦвет статуса
statusDateДата установки статуса
noReturnПризнак возврата позиции
referenceДополнительная информация

Получение списка заказов​

Операция: orders

Метод: GET

Осуществляет получение списка всех заказов клиента по страницам. Сортировка по номеру заказа по убыванию, т.е. сначала передаются самые новые заказы.

Параметры запроса

ПараметрОписание
userlogin*Имя пользователя в системе
userpsw*md5-хэш пароля пользователя в системе
format(необязательный) - формат вывода результата. По умолчанию отображается информация только по заказам. При значении p - к заказам добавляется информация по всем позициям.
skip(необязательный) - кол-во заказов, которые нужно пропустить. По умолчанию - 0.
limit(необязательный) - кол-во заказов, которые нужно отобразить за один раз. Допускается любое значение от 1 до 1000. По умолчанию - 100.
https://demo.public.api.abcp.ru/orders/?userlogin=username&userpsw=md5pass
https://demo.public.api.abcp.ru/orders/?userlogin=username&userpsw=md5pass&format=p&skip=10&limit=20

Поля ответа

Метод возвращает данные вида:

ПолеОписание
countКол-во всех заказов
itemsМассив с заказами
ПолеОписание
numberНомер заказа в портале
statusСтатус заказа - актуально,только когда все позиции в одном статусе
statusIdId статуса - актуально,только когда все позиции в одном статусе
statusCodeКод статуса заказа - актуально,только когда все позиции в одном статусе
statusColorЦвет статуса - актуально,только когда все позиции в одном статусе
positionsQuantityКоличество позиций
deliveryAddressIdИдентификатор адреса доставки
deliveryAddressАдрес доставки
deliveryOfficeIdИдентификатор офиса самовывоза
deliveryOfficeОфис самовывоза
deliveryTypeIdИдентификатор типа доставки
deliveryTypeТип доставки
paymentTypeIdИдентификатор типа оплаты
paymentTypeТип оплаты
deliveryCostСтоимость доставки
shipmentDateДата отгрузки
sumСумма заказа
dateДата заказа
debtДолг по оплате заказа
commentКомментарий к заказу
clientOrderNumberНомер заказа в системе учета клиента
positionsСписок позиций заказа (если параметр format имеет значение p)
ПолеОписание
brandИмя производителя.
numberНомер детали (код производителя).
numberFix"Очищенный" код детали, содержащий только алфавитные и цифровые символы, и, иногда, знак слеша "/".
codeКод детали (уникальный код на сайте).
supplierCodeКод поставки.
itemKeyКод позиции. Внимание! Не является уникальным идентификатором! Параметр "itemKey" обязателен для передачи заказа онлайн-поставщику, а также при передаче заказа от франчайзи к ГК.
descriptionОписание детали.
quantityOrderedЗаказываемое количество
quantityИтоговое количество
priceЦена за единицу товара
deadlineСрок поставки в часах
deadlineMaxМаксимальный срок поставки в часах
commentКомментарий к позиции
statusСтатус позиции заказа
statusCodeКод статуса позиции заказа
statusIdId статуса позиции
statusColorцвет статуса позиции
statusDateдата выставления статуса позиции
noReturnпризнак возвратности позиции
commentAnswerответ на комментарий по позиции
priceInSiteCurrencyЦена ПРОДАЖИ в валюте сайта
priceRateКурс перевода цены в валюту сайта
referenceслужебное поле

Запрос на отмену позиции​

Операция: orders/cancelPosition

Метод: POST

Выставляет позиции признак "Запрос на отмену"

Параметры запроса

ПараметрОписание
userlogin*Имя пользователя в системе
userpsw*md5-хэш пароля пользователя в системе
positionId*Идентификатор позиции заказа

Метод возвращает сообщение об успешном запросе на отмену в поле message либо сообщение об ошибке

Пример запроса

 `https://demo.public.api.abcp.ru/orders/cancelPosition`

Тело POST запроса

userlogin=username&userpsw=md5pass&positionId=232324455

Получение версии системы заказов​

Операция: orders/version

Метод: GET

Параметры запроса

ПараметрОписание
userlogin*Имя пользователя в системе
userpsw*md5-хэш пароля пользователя в системе

Метод возвращает версию подсистемы заказов, используемую магазином. Доступные значения 1 и 2.

Пользователь​

Регистрация пользователя​

Операция: user/new

Метод: POST

Принимает параметры для регистрации пользователя. Осуществляет регистрацию нового пользователя в системе. Возвращает статус выполнения операции регистрации, учетные данные нового пользователя, а так же сообщение об ошибке в случае возникновения таковой. Регистрация через API запрещена при использовании модуля франчайзи, если выключен флаг "Разрешить ГК участвовать в продажах".

Параметры запроса

ПараметрОписание
name*Имя
secondNameОтчество
surnameФамилия
mobile*Номер мобильного телефона
office*Идентификатор офиса
password*Пароль
marketTypeТип регистрации:
filialIdКод филиала (если имеются)
birthDateДата рождения, формат YYYY-MM-DD
memberOfClubНазвание автоклуба
emailАдрес электронной почты
icqICQ UIN
skypeSkype
regionIdКод региона
cityГород
organizationNameНаименование организации
businessТип организации. Значение от 1 до 3:
organizationFormПравовая форма организации. Варианты:
organizationOfficialNameНаименование по регистрации (без правовой формы юр. лица)
innИНН
kppКПП
ogrnОГРН
organizationOfficialAddressЮридический адрес организации
bankNameНаименование банка
bikБИК банка
correspondentAccountКорреспондентский счет банка
organizationAccountРасчетный счет организации
deliveryAddressАдрес доставки
commentКомментарий
sendRegistrationEmailНеобязательный, по-умолчанию - 0.
https://demo.public.api.abcp.ru/user/new

Тело POST запроса

marketType=1&name=Василий&surname=Васильев&password=12345&mobile=79000000000&email=vasya5434534@mail.com&regionId=77&city=Москва&deliveryAddress=ул. Ленина, д.2&comment=

Поля ответа

ПолеОписание
statusСтатус выполнения операции
userCodeВнутренний код пользователя. Необходим для активации.
activationCodeКод активации, если включена настройка "Регистрация: активация"
errorMessageМассив сообщений об ошибках, если статус = 0

Активация пользователя​

Операция: user/activation

Метод: POST

Параметры запроса

ПараметрОписание
userCode*Внутренний код пользователя.
activationCode*Код активации при включенной настройке "Регистрация: активация"
https://demo.public.api.abcp.ru/user/activation

Тело POST запроса

userlogin=username&userpsw=md5pass&userCode=12345&activationCode=567ab097bcd

Метод возвращает набор узлов вида:

ПолеОписание
statusСтатус активации.
errorMessageСообщение об ошибке при статусе = 0

Получение данных пользователя (авторизация)​

Операция: user/info

Метод: GET

Возвращает данные пользователя по логину и паролю.

Параметры запроса

ПараметрОписание
userlogin*Имя пользователя в системе
userpsw*md5-хэш пароля пользователя в системе
https://demo.public.api.abcp.ru/user/info?userlogin=username&userpsw=md5pass

Метод возвращает набор узлов вида:

ПолеОписание
idИдентификатор пользователя в системе ABCP.
codeКод пользователя.
emailАдрес электронной почты пользователя.
nameФИО или название организации
mobileМобильный телефон
organizationНаименование юридического лица

Восстановление пароля​

Операция: user/restore

Метод: POST

Операция восстановление пароля пользователя.

Механизм использования

Восстановление пароля состоит из двух этапов:

  1. Запрос восстановления пароля с указанием номера телефона или email. В результате успешного завершения будет отправлено стандартное письмо со ссылкой восстановления пароля на указанный email или код в SMS на указанный номер телефона.
  2. Сохранение нового пароля с указанием кода подтверждения из SMS. Данный этап актуален только для восстановления по номеру телефона, так как в случае с email, в письме придет ссылка на форму восстановления пароля на сайте, и второй этап будет выполнен в ней.

Параметры запроса

ПараметрОписание
emailOrMobile*Email или телефон [первый этап]
passwordNew*Новый пароль [второй этап]
code*Код из смс [второй этап]
https://demo.public.api.abcp.ru/user/restore

Тело POST запроса

emailOrMobile=799912345678

Метод возвращает:

  • при ошибке стандартный ответ с полями errorCode и errorMessage
  • при успешности ответ с полями status (возможные значения 1 и 2) и message c текстом сообщения о статусе выполнения операции

Гараж​

Получение списка автомобилей в гараже​

Операция: user/garage

Метод: GET

Возвращает список автомобилей гаража текущего пользователя

Параметры запроса

к сведению

При выполнении данной операции от имени API-администратора, необходимо передавать параметр userId, содержащий идентификатор пользователя вашего сайта.

ПараметрОписание
userlogin*Имя пользователя в системе
userpsw*md5-хэш пароля пользователя в системе
https://demo.public.api.abcp.ru/user/garage?userlogin=username&userpsw=md5pass

Метод возвращает массив объектов вида:

ПолеОписание
idИдентификатор автомобиля в гараже
nameНазвание автомобиля (пользовательское)
commentКомментарий (пользовательский)
yearГод выпуска автомобиля
vinVIN-код автомобиля
frameНомер кузова автомобиля
mileageПробег автомобиля
manufacturerIdИдентификатор марки автомобиля
manufacturerНазвание марки автомобиля
modelIdИдентификатор модели автомобиля
modelНазвание модели автомобиля
modificationIdИдентификатор модификации автомобиля
modificationНазвание модификации автомобиля
vehicleRegPlateГосударственный номер автомобиля

Получение информации об автомобиле в гараже​

Операция: user/garage/car

Метод: GET

Возвращает данные по одному автомобилю гаража текущего пользователя

Параметры запроса

к сведению

При выполнении данной операции от имени API-администратора, необходимо передавать параметр userId, содержащий идентификатор пользователя вашего сайта.

ПараметрОписание
userlogin*Имя пользователя в системе
userpsw*md5-хэш пароля пользователя в системе
carId*Идентификатор автомобиля в гараже

Пример запроса

https://demo.public.api.abcp.ru/user/garage/car?userlogin=username&userpsw=md5pass&carId=14214

Метод возвращает объект вида:

ПолеОписание
idИдентификатор автомобиля в гараже
nameНазвание автомобиля (пользовательское)
commentКомментарий (пользовательский)
yearГод выпуска автомобиля
vinVIN-код автомобиля
frameНомер кузова автомобиля
mileageПробег автомобиля
manufacturerIdИдентификатор марки автомобиля
manufacturerНазвание марки автомобиля
modelIdИдентификатор модели автомобиля
modelНазвание модели автомобиля
modificationIdИдентификатор модификации автомобиля
modificationНазвание модификации автомобиля
vehicleRegPlateГосударственный номер автомобиля

Добавление автомобиля в гараж​

Операция: user/garage/add

Метод: POST

Добавляет автомобиль в гараж

Параметры запроса

к сведению

Для получения идентификаторов марок/моделей/модификаций воспользуйтесь операциями из раздела "дерево автомобилей".

к сведению

При выполнении данной операции от имени API-администратора, необходимо передавать параметр userId, содержащий идентификатор пользователя вашего сайта.

Внимание! Обязательно к заполнению одно из этих полей: vin, frame или name.

ПараметрОписание
userlogin*Имя пользователя в системе
userpsw*md5-хэш пароля пользователя в системе
name*Название автомобиля (пользовательское)
vin*VIN-код автомобиля
frame*Номер кузова автомобиля
yearГод выпуска автомобиля
commentКомментарий (пользовательский)
mileageПробег автомобиля
manufacturerIdИдентификатор марки автомобиля
modelIdИдентификатор модели автомобиля
modificationIdИдентификатор модификации автомобиля
vehicleRegPlateГосударственный номер автомобиля
https://demo.public.api.abcp.ru/user/garage/add

Тело POST запроса

userlogin=username&userpsw=md5pass&name=Ауди&manufacturerId=5

Метод возвращает объект вида:

ПолеОписание
idИдентификатор автомобиля в гараже
nameНазвание автомобиля (пользовательское)
commentКомментарий (пользовательский)
yearГод выпуска автомобиля
vinVIN-код автомобиля
frameНомер кузова автомобиля
mileageПробег автомобиля
manufacturerIdИдентификатор марки автомобиля
manufacturerНазвание марки автомобиля
modelIdИдентификатор модели автомобиля
modelНазвание модели автомобиля
modificationIdИдентификатор модификации автомобиля
vehicleRegPlateГосударственный номер автомобиля

Обновление автомобиля в гараже​

Операция: user/garage/update

Метод: POST

Изменяет автомобиль в гараже. Обязательным свойством автомобиля является только carId, то есть, можно передавать только те параметры, которые необходимо изменить. Не переданные свойства изменены не будут.

Параметры запроса

к сведению

При выполнении данной операции от имени API-администратора, необходимо передавать параметр userId, содержащий идентификатор пользователя вашего сайта.

ПараметрОписание
userlogin*Имя пользователя в системе
userpsw*md5-хэш пароля пользователя в системе
carId*Идентификатор автомобиля
nameНазвание автомобиля (пользовательское)
commentКомментарий (пользовательский)
yearГод выпуска автомобиля
vinVIN-код автомобиля
frameНомер кузова автомобиля
mileageПробег автомобиля
manufacturerIdИдентификатор марки автомобиля
modelIdИдентификатор модели автомобиля
modificationIdИдентификатор модификации автомобиля
vehicleRegPlateГосударственный номер автомобиля
https://demo.public.api.abcp.ru/user/garage/update

Тело POST запроса

userlogin=username&userpsw=md5pass&carId=146542&name=Бумер&manufacturerId=12

Метод возвращает объект вида:

ПолеОписание
idИдентификатор автомобиля в гараже
nameНазвание автомобиля (пользовательское)
commentКомментарий (пользовательский)
yearГод выпуска автомобиля
vinVIN-код автомобиля
frameНомер кузова автомобиля
mileageПробег автомобиля
manufacturerIdИдентификатор марки автомобиля
manufacturerНазвание марки автомобиля
modelIdИдентификатор модели автомобиля
modelНазвание модели автомобиля
modificationIdИдентификатор модификации автомобиля
modificationНазвание модификации автомобиля
vehicleRegPlateГосударственный номер автомобиля

Удаление автомобиля из гаража​

Операция: user/garage/delete

Метод: POST

Удаляет автомобиль из гаража.

Параметры запроса

к сведению

При выполнении данной операции от имени API-администратора, необходимо передавать параметр userId, содержащий идентификатор пользователя вашего сайта.

ПараметрОписание
userlogin*Имя пользователя в системе
userpsw*md5-хэш пароля пользователя в системе
carId*Идентификатор автомобиля
https://demo.public.api.abcp.ru/user/garage/delete

Тело POST запроса

userlogin=username&userpsw=md5pass&carId=146542&name=Бумер&manufacturerId=12

Метод возвращает значение true в случае успешности удаления или сообщение об ошибке.

Дерево автомобилей​

Получение списка годов дерева автомобилей​

Операция: cartree/years

Метод: GET

Возвращает список доступных годов для дерева автомобилей

Параметры запроса

ПараметрОписание
userlogin*Имя пользователя в системе
userpsw*md5-хэш пароля пользователя в системе
manufacturerIdИдентификатор марки для фильтрации. Необязательное.
https://demo.public.api.abcp.ru/cartree/years?userlogin=username&userpsw=md5pass

Метод возвращает массив доступных годов.

Получение списка марок дерева автомобилей​

Операция: cartree/manufacturers

Метод: GET

Возвращает список доступных марок для дерева автомобилей

Параметры запроса

ПараметрОписание
userlogin*Имя пользователя в системе
userpsw*md5-хэш пароля пользователя в системе
yearГод для фильтрации марок. Необязательное.
https://demo.public.api.abcp.ru/cartree/manufacturers?userlogin=username&userpsw=md5pass

Метод возвращает массив объектов вида:

ПолеОписание
idИдентификатор марки
nameНазвание марки

Получение списка моделей дерева автомобилей​

Операция: cartree/models

Метод: GET

Возвращает список доступных моделей указанной марки для дерева автомобилей

Параметры запроса

ПараметрОписание
userlogin*Имя пользователя в системе
userpsw*md5-хэш пароля пользователя в системе
manufacturerId*Идентификатор марки
yearГод для фильтрации моделей. Необязательное.
https://demo.public.api.abcp.ru/cartree/models?userlogin=username&userpsw=md5pass

Метод возвращает массив объектов вида:

ПолеОписание
idИдентификатор модели
nameНазвание модели
yearFromДата начала выпуска модели
yearToДата окончания выпуска модели

Получение списка модификаций дерева автомобилей​

Операция: cartree/modifications

Метод: GET

Возвращает список доступных модификаций указанной марки и модели для дерева автомобилей

Параметры запроса

ПараметрОписание
userlogin*Имя пользователя в системе
userpsw*md5-хэш пароля пользователя в системе
manufacturerId*Идентификатор марки
modelId*Идентификатор модели
yearГод для фильтрации моделей. Необязательное.
https://demo.public.api.abcp.ru/cartree/modifications?userlogin=username&userpsw=md5pass

Метод возвращает массив объектов вида:

ПолеОписание
idИдентификатор модификации
nameНазвание модификации
yearFromДата начала выпуска модификации
yearToДата окончания выпуска модификации
modelIdИдентификатор модели
modelНазвание модели
manufacturerIdИдентификатор марки
manufacturerНазвание марки
fullNameПолное название модификации, включающее марку и модель
cylinderCapacityCcmОбъем
constructionTypeКузов
powerHPМощность в лошадиных силах
powerKWМощность в киловаттах
motorCodesКод двигателя
fuelTypeТип топлива

Получение списка полей формы​

Операция: form/fields

Метод: GET

Возвращает список полей формы и все параметры в соответствии с установленными настройками в панели управления на странице Внешний вид и контент / Формы. На текущий момент доступны только формы регистрации, реализованные в API-методе user/new. Метод не требует авторизации.

Параметры запроса

ПараметрОписание
name*Имя формы. Возможные значения: registration_wholesale - опт; registration_retail - розница
localeЛокаль формы (по умолчанию, ru_RU)
https://demo.public.api.abcp.ru/form/fields?name=registration_retail&locale=ru_KZ

Метод возвращает массив объектов вида:

ПолеОписание
nameИмя поля. Соответствует имени поля в соответствующем API-методе.
labelМетка поля на языке локали. Название поля в форме.
isRequiredФлаг "Обязательное поле".
errorMessageТекстовое сообщение на языке локали, которое будет показано при некорректном заполнении поля.

Справочник брендов​

Получать данные справочника брендов​

Операция: articles/brands

Метод: GET

Возвращает список всех брендов зарегистрированных в системе с их синонимами.

Параметры запроса

ПараметрОписание
userlogin*Имя пользователя
userpsw*md5-хэш пароля пользователя

Пример запроса

https://demo.public.api.abcp.ru/articles/brands?userlogin=username&userpsw=md5pass

Метод возвращает массив объектов вида:

ПараметрОписание
nameИмя бренда
aliasesМассив, содержащий список синонимов текущего бренда

Получение карточки товара​

Операция: articles/info

Метод: GET

к сведению

Данная операция доступна только API-администратору

Возвращает данные по указанному в параметрах товару

Параметры запроса

ПараметрОписание
userlogin*Имя пользователя
userpsw*md5-хэш пароля пользователя
brand*Имя производителя
number*Код детали
formatФормат ответа. Допустимые значения: [b][n][p][c][h][m][t][i] - формат вывода информации (b - бренд, n - номер, p - свойства, c - кроссы, h - свойства с учетом локали, m - информация о модели, t - вывод типа кроссов с учетом направления, i - изображения запчасти).
cross_imageПри передаче cross_image=1 и [i] в параметре format в ответе операции будут выводиться изображения кроссов.
sourceИсточник кроссов. Необязательный параметр. Через него передается массив со списком источников, в которых нужно искать кроссы.
with_originalПризнак кроссирования через оригинал. Необязательный параметр. Через него передается массив со списком источников, в которых используется кроссирование через оригинал. Работает данный параметр только при ручном указании источников кроссов (source). Если его не передавать то в ответе нет кроссов через оригинал по указанным источникам.
localeЛокаль. Задается в формате language[_territory], например, ru_RU. Это же значение используется по умолчанию.

Пример запроса

https://demo.public.api.abcp.ru/articles/info?userlogin=username&userpsw=md5pass&brand=Febi&number=01089&format=bnpic

Метод возвращает массив объектов вида:

ПараметрОписание
brandИмя производителя
numberИскомый номер детали
outer_numberНомер детали, содержащий пробелы, слэши и другие символы.
short_numberСокращённый номер детали. Нужен для идентификации в вашей поисковой выдаче одинаковых артикулов. Например, в случае двойной маркировки свечей NGK.
alt_numberАльтернативный номер детали. Нужен для идентификации в вашей поисковой выдаче одинаковых артикулов. Например, в случае коротких и полных номеров по бренду Mercedes (с буквой A и без)
propertiesМассив свойств детали: описание, вес, объем и т.п. (при включенном формате p)
crossesМассив информации об аналогах (при включенном формате c).
imagesМассив изображений товара (при включенном формате i). В массиве указаны имена файлов расположенных по адресу https://imgcdn.abcp.ru/p/
reliableДанный параметр означает, что кросс является "надежным" - т.е. получен от проверенного источника (производитель, офиц.дистрибьютор и т.п.).

Каталог ТО​

warning

Каталог ТО через API - отдельная услуга, для подключения необходимо связаться с отделом продаж ABCP

Общая информация по каталогу ТО и использованию операций​

ABCP разрабатывает и поддерживает каталог ТО. Каталог ТО - это дерево модификаций автомобилей (более 40 тысяч шт), к которым через применяемость привязаны артикулы запчастей для ТО в 10 товарных группах (фильтры, тормоза, свечи и т.д.). Кроме информации о применяемости деталей для ТО к конкретной модификации каталог ТО отображает информацию по шинам, дискам и щёткам стеклоочистителей. Процесс подбора в общем случае выглядит так: пользователь видит список производителей, выбирает свою марку, затем видит список моделей, после выбора модели видит список модификаций и выбирает свою модификацию. На финальном этапе пользователь видит информацию о своей модификации, рекомендации по шинам, дискам и щёткам стеклоочистителей и список деталей для ТО с артикулами. Из блоков с информацией по шинам, дискам и щёткам пользователь может перейти в каталог по соответствующей товарной группе. Из списка деталей для ТО пользователь может перейти в проценку по оригинальному бренду и номеру и выбрать в поисковой выдаче устраивающие его по цене и срокам варианты. С примерами реализации каталога ТО на сайте для клиента и с детальным описание всех операций по получению информации вы можете ознакомиться ниже.

Примеры реализации​

  1. b2b.autorus.ru
  2. 4mycar.ru

Получение списка производителей​

Операция: carbase/manufacturers

Метод: GET

Метод позволяет получить список производителей, для которых в дереве модификаций присутствуют модели.

Параметры запроса

ПараметрОписание
userlogin*Имя API-администратора
userpsw*md5-хэш пароля API-администратора

Пример запроса

https://demo.public.api.abcp.ru/carbase/manufacturers?userlogin=username&userpsw=md5pass

Пример ответа (сокращено для лучшего восприятия)

[
{
"id": "3854",
"name": "ABARTH",
"isPopular": "0"
},
{
"id": "184",
"name": "KIA",
"isPopular": "1"
}
]

Описание ответа

Возвращается массив записей о производителях автомобилей, каждый элемент массива содержит информацию:

ОбъектОписание
idИдентификатор производителя в дереве модификаций, используется в операции запроса списка моделей
nameНаименование производителя автомобиля
isPopularПризнак популярности (установлен на стороне дерева модификаций и может быть использован для отображения только популярных марок с возможностью открытия полного списка.

Получение списка моделей автомобилей одного производителя​

Операция: carbase/models

Метод: GET

Метод позволяет получить список моделей, для которых в дереве модификаций присутствуют модификации.

Параметры запроса

ПараметрОписание
userlogin*Имя API-администратора
userpsw*md5-хэш пароля API-администратора
manufacturerId*id производителя из операции carbase/manufacturers

Пример запроса

https://demo.public.api.abcp.ru/carbase/models?userlogin=username&userpsw=md5pass&manufacturerId=184

Пример ответа (сокращено для лучшего восприятия)

{
"CARNIVAL": [
{
"id": "4349",
"name": "CARNIVAL I (UP)",
"yearFrom": "199806",
"yearTo": "200110",
"imagePath": ""
},
{
"id": "4844",
"name": "CARNIVAL II (GQ)",
"yearFrom": "199901",
"yearTo": "200709",
"imagePath": ""
}
],
"RIO": [
{
"id": "10575",
"name": "RIO III Седан (UB)",
"yearFrom": "201103",
"yearTo": "201503",
"imagePath": "084e0fb578151d308d60a82ec941f19c04.jpeg"
},
{
"id": "39288",
"name": "RIO III Седан рестайлинг (UB)",
"yearFrom": "201504",
"yearTo": "201709",
"imagePath": "0921d3c06736526206984e70af55342b98.jpeg"
},
{
"id": "9697",
"name": "RIO III Хэтчбек (UB)",
"yearFrom": "201103",
"yearTo": "201505",
"imagePath": "059eb548dbb279eaab41db542130db330b.jpeg"
},
{
"id": "39287",
"name": "RIO III Хэтчбек 3дв (UB)",
"yearFrom": "201103",
"yearTo": "201505",
"imagePath": "0970e0a22b46eb49822ce4b776acdb23c8.jpeg"
}
]
}

Описание ответа

Возвращает сгруппированный список моделей одного производителя с указанием наименования группы. То есть, все KIA RIO представлены в группе "RIO", все Mercedes-Benz GLE представлены в группе "GLE". Отображение списка моделей в сгруппированном виде не перегружает страницу с контентом и позволяет пользователю быстрее найти его модель, каждая запись в группе моделей содержит:

ОбъектОписание
idИдентификатор модели в дереве модификаций, используется в операции запроса списка модификаций конкретной модели (описана ниже)
nameНаименование модели автомобиля
yearFromГод и месяц начала производства для идентификации нужной пользователю модели.
yearToГод и месяц окончания производства для идентификации нужной пользователю модели.
imagePathИзображение модели (может быть запрошено по адресу https://imgcdn.abcp.ru/p/imagePath, например, полная версия, превью).

Получение списка модификаций одной модели​

Операция: carbase/modifications

Метод: GET

Метод позволяет получить список модификаций конкретной модели одного производителя.

Параметры запроса

ПараметрОписание
userlogin*Имя API-администратора
userpsw*md5-хэш пароля API-администратора
modelId*Идентификатор модели из ответа в операции carbase/models
localeЛокаль, по-умолчанию (если значение не передано) - ru_RU

Пример запроса

https://demo.public.api.abcp.ru/carbase/modifications?userlogin=username&userpsw=md5pass&modelId=10575

Пример ответа (сокращено для лучшего восприятия)

{
"id": "10575",
"name": "RIO III Седан (UB)",
"groupName": "RIO",
"yearFrom": "201103",
"yearTo": "201503",
"imagePath": "084e0fb578151d308d60a82ec941f19c04.jpeg",
"modifications": [
{
"id": "10579",
"modificationName": "1.4 CVVT",
"yearFrom": "201108",
"yearTo": "201503",
"fuelType": "Бензин",
"powerHP": "107",
"powerKW": "79",
"motorCodes": "G4FA",
"cylinder": "4",
"cylinderCapacityCcm": "1396"
},
{
"id": "10580",
"modificationName": "1.4 CVVT",
"yearFrom": "201110",
"yearTo": "0",
"fuelType": "Бензин",
"powerHP": "109",
"powerKW": "80",
"motorCodes": "G4FA",
"cylinder": "4",
"cylinderCapacityCcm": "1396"
},
{
"id": "10581",
"modificationName": "1.6 CVVT",
"yearFrom": "201108",
"yearTo": "201503",
"fuelType": "Бензин",
"powerHP": "123",
"powerKW": "90",
"motorCodes": "G4FC",
"cylinder": "4",
"cylinderCapacityCcm": "1591"
}
]
}

Описание ответа

Возвращается информация о запрашиваемой модели и массив с информацией о модификациях, описание модификации:

ОбъектОписание
idИдентификатор модификации в дереве модификаций, используется в операции запроса информации по одной модификации
modificationNameНаименование модификации автомобиля (для отображения в списке)
yearFromГод и месяц начала производства для идентификации нужной пользователю модели.
yearToГод и месяц окончания производства для идентификации нужной пользователю модели.
fuelTypeТип топлива для отображения в списке модификаций, информация нужна для быстрой идентификации нужной пользователю модификации.
powerHPМощность в л.с. для отображения в списке модификаций, информация нужна для быстрой идентификации нужной пользователю модификации.
powerKWМощность в кВт для отображения в списке модификаций, информация нужна для быстрой идентификации нужной пользователю модификации.
motorCodesКод(ы) двигателя(ей) для отображения в списке модификаций, информация нужна для быстрой идентификации нужной пользователю модификации.
cylinderКоличество цилиндров двигателя для отображения в списке модификаций, информация нужна для быстрой идентификации нужной пользователю модификации.
cylinderCapacityCcmОбъём двигателя в кубических сантиметрах для отображения в списке модификаций, информация нужна для быстрой идентификации нужной пользователю модификации.

Получение информации об одной модификации​

Операция: carbase/modificationInfo

Метод: GET

Метод позволяет получить имеющуюся информацию по одной модификации: шины, диски, щётки, список запчастей для ТО.

Параметры запроса

ПараметрОписание
userlogin*Имя API-администратора
userpsw*md5-хэш пароля API-администратора
modificationId*id модификации, по которой запрашивается информация
localeЛокаль, по-умолчанию (если значение не передано) - ru_RU

Пример запроса

https://demo.public.api.abcp.ru/carbase/modificationInfo?userlogin=username&userpsw=md5pass&modificationId=10580&locale=ru_RU

Пример ответа

{
"modification": {
"manufacturerName": "KIA",
"groupName": "RIO",
"modelName": "RIO III Седан (UB)",
"modelId": "10575",
"modificationName": "1.4 CVVT",
"constructionType": "Седан",
"cylinder": "4",
"cylinderCapacityCcm": "1396",
"fuelType": "Бензин",
"powerHP": "109",
"powerKW": "80",
"yearFrom": "201110",
"yearTo": "0",
"motorCodes": "G4FA",
"imagePath": "084e0fb578151d308d60a82ec941f19c04.jpeg"
},
"disks": {
"bolt": "",
"factory": [
{
"diameter": 15,
"et": 48,
"holes": 4,
"hubDiameter": 54.1,
"name": "6x15/4x100 ET48 DIA54.1",
"pcd": 100,
"rear": null,
"width": 6
},
{
"diameter": 16,
"et": 52,
"holes": 4,
"hubDiameter": 54.1,
"name": "6x16/4x100 ET52 DIA54.1",
"pcd": 100,
"rear": null,
"width": 6
}
],
"nut": "12*1,5"
},
"tires": {
"factory": [
{
"diameter": 15,
"height": 65,
"name": "185/65 R15",
"rear": null,
"width": 185
},
{
"diameter": 16,
"height": 55,
"name": "195/55 R16",
"rear": null,
"width": 195
}
]
},
"wipers": {
"left": {
"length": 650,
"mountType": {
"descr": "крючок",
"type": "hook"
}
},
"right": {
"length": 400,
"mountType": {
"descr": "крючок",
"type": "hook"
}
}
},
"articles": [
{
"brandName": "Hyundai-KIA",
"brandNumber": "2630035531",
"goodsGroupCode": "oil_filter",
"goodsGroupName": "масляные фильтры",
"description": "Фильтр масляный",
"fitAxle": null,
"images": [
{
"name": "0541ea2c5fcc434f9b963d37c8abb769eaffc60002.jpeg",
"order": 0
}
]
},
{
"brandName": "Hyundai-KIA",
"brandNumber": "281131R100",
"goodsGroupCode": "air_filter",
"goodsGroupName": "воздушные фильтры",
"description": "Фильтр воздушный",
"fitAxle": null,
"images": [
{
"name": "0632eda95f7db2c3dfd90f8f353335e06cb6bd0002.jpeg",
"order": 0
}
]
},
{
"brandName": "Hyundai-KIA",
"brandNumber": "971334L000",
"goodsGroupCode": "cabin_filter",
"goodsGroupName": "салонные фильтры",
"description": "ФИЛЬТР САЛОНА",
"fitAxle": null,
"images": [
{
"name": "013c6463b0f56e061dcea348fd57f173d7f8780002.jpeg",
"order": 0
}
]
},
{
"brandName": "Hyundai-KIA",
"brandNumber": "311121R000",
"goodsGroupCode": "fuel_filter",
"goodsGroupName": "топливные фильтры",
"description": "Фильтр топливный",
"fitAxle": null,
"images": [
{
"name": "05237f13cc871f85b31da285c8cfa17b5bd6890002.jpeg",
"order": 0
}
]
},
{
"brandName": "Hyundai-KIA",
"brandNumber": "581014LA00",
"goodsGroupCode": "brake_pad",
"goodsGroupName": "тормозные колодки",
"description": "Колодки передние HYUNDAI Solaris 10-17 / KIA Rio 11-17",
"fitAxle": "передняя ось",
"images": [
{
"name": "067032b81f3f24b05516fa08c6624009b9c2dd0002.jpeg",
"order": 0
}
]
},
{
"brandName": "Hyundai-KIA",
"brandNumber": "517120U000",
"goodsGroupCode": "brake_disk",
"goodsGroupName": "тормозные диски",
"description": "Диск тормозной передний HYUNDAI Solaris/KIA RIO III",
"fitAxle": "передняя ось",
"images": [
{
"name": "064555f12d8c1ec806f38f7068538b3be8d37c0002.jpeg",
"order": 0
}
]
},
{
"brandName": "Hyundai-KIA",
"brandNumber": "583021RA30",
"goodsGroupCode": "brake_pad",
"goodsGroupName": "тормозные колодки",
"description": "Колодки тормозные задние",
"fitAxle": "задняя ось",
"images": [
{
"name": "057132725fadafb1b6dd94fefe8207e4b21b80002.jpeg",
"order": 0
}
]
},
{
"brandName": "Hyundai-KIA",
"brandNumber": "584110U300",
"goodsGroupCode": "brake_disk",
"goodsGroupName": "тормозные диски",
"description": "Диск тормозной задний HYUNDAI Solaris 2010→/KIA Rio III",
"fitAxle": "задняя ось",
"images": [
{
"name": "014766ae0d0ccc01b9e4585765473ae42f775e0002.jpeg",
"order": 0
}
]
},
{
"brandName": "Hyundai-KIA",
"brandNumber": "584110U000",
"goodsGroupCode": "brake_drum",
"goodsGroupName": "тормозные барабаны",
"description": "Тормозной барабан",
"fitAxle": "задняя ось",
"images": [
{
"name": "05cfeb6d7c7fc180275b48b3bd4ff07d898fa0002.jpeg",
"order": 0
}
]
},
{
"brandName": "Hyundai-KIA",
"brandNumber": "583503XA00",
"goodsGroupCode": "brake_pad",
"goodsGroupName": "тормозные колодки",
"description": "Тормозные колодки",
"fitAxle": null,
"images": []
},
{
"brandName": "Hyundai-KIA",
"brandNumber": "2151323001",
"goodsGroupCode": "drain_plug_seal",
"goodsGroupName": "прокладки пробки поддона двигателя",
"description": "Прокладка сливной пробки",
"fitAxle": null,
"images": [
{
"name": "014ef63c6cf94b132dff348704b8c79ef78f480002.jpeg",
"order": 0
}
]
},
{
"brandName": "Hyundai-KIA",
"brandNumber": "1885510060",
"goodsGroupCode": "spark_plugs",
"goodsGroupName": "свечи зажигания",
"description": "Свеча зажигания",
"fitAxle": null,
"images": [
{
"name": "019daa9a974c4cc7f4bf1e87e3532bffc2dd530002.jpeg",
"order": 0
}
]
}
]
}

Описание ответа

Возвращается информацию о модификации (как в методе carbase/modifications), информацию по шинам, дискам и щёткам. Для шин и дисков возвращаются штатные (factory) и альтернативные размерности. Помимо привычных ТТХ шин и дисков (полный набор типоразмеров для перехода в ваш каталог шин и дисков) возвращается справочная информация о крепеже (bolt или nut, то есть для болта или гайки). Для щёток стеклоочистителей кроме длины левой/правой щётки возвращается тип крепления и текстовое описание для отображения пользователю. Эта информация тоже может быть использована для перехода в каталог щёток стеклоочистителя на вашем сайте. Массив запчастей для ТО содержит записи, в каждой записи:

ОбъектОписание
brandNameНаименование бренда оригинального артикула
brandNumberОригинальный артикул
goodsGroupCodeКод товарной группы (может быть использован для быстрой фильтрации результатов)
goodsGroupNameТекстовое описание товарной группы
fitAxleОсь установки (для товарных групп brake_pad/тормозные колодки, brake_disk/тормозные диски, brake_drum/тормозные барабаны, brake_pad_sensors/датчики износа тормозных колодок
descriptionЛокализованное текстовое описание для артикула
imagesМассив с изображениями артикула (может быть запрошено по адресу https://imgcdn.abcp.ru/p/image.name, например, полная версия, превью)