Последнее обновление: 23 марта 2023 г.
Дисконт (временно неактуально)
Цены тарифа Екатеринбург - getekaterinburgprice
Получение цен за 2 недели - getfutureprice
В Systeme Electric существует понятие "тариф". Тариф в обычном понимании - это закупочная цена референса.
Тарифы имеют ограниченный срок предложения и обновляются с некоторой частотой (раз в несколько месяцев, не фиксированно). Каждый тариф имеет свой определенный список референсов и этот список может меняться по мере обновления цен.
При каждом обновлении тарифа данные ПОЛНОСТЬЮ обновляются. Это совершенно новый список референсов и цен. Данные старого тарифа считают полностью неактуальными и не хранятся в нашей базе данных.
Если у референса указана цена 0, это означает что в новом тарифе этого референса нет, информации о цене тоже нет, и запрашивался, соответственно, референс из старого тарифа. Если вам нужна цена по референсу, которого нет в тарифе, необходимо запросить данные у вашего менеджера со стороны SE.
Методы передают информацию о цене в рублях. Если вам нужна информация для других валют, сделайте запрос вашему менеджеру со стороны SE или на почту поддержки.
Перечень передаваемых данных:
Поддерживаемые параметры: commercialRef, pageSize, page, discount
Метод передает информацию по тарифу "Москва". Для получения актуальных сведений всегда полностью обновляйте данные в БД, т.к. в новом списке может не быть старых референсов и цена по ним также уже является не актуальной.
По умолчанию метод возвращает записи о первых 100 референсах. Для получения полных сведений используйте поддерживаемые параметры.
Пример запроса:
https://api.systeme.ru/new-api/XML/getprice?accessCode={YouApiToken}
Пример выдачи:
<content>
<result>success</result>
<data>
<reference>
<commercialRef>10545</commercialRef>
<description>
ШИНКА ГРЕБЕНЧАТАЯ ЛЕВАЯ ГРУПП 4П (NL1L2L3(ШАГ18ММ)NL1NL2…NL3(ШАГ9MM)) 12 МОД.80А
</description>
<series>ACTI9</series>
<series_id>1</series_id>
<price>4885.00</price>
<currency_price>руб.</currency_price>
<date>01.01.2020</date>
<unit>за штуку</unit>
<unit_id>1</unit_id>
<comments/>
<warehouse>
<stock_status>N</stock_status>
<stock_status_description>Под заказ</stock_status_description>
</warehouse>
<shipment>
<delivery>-</delivery>
<guar_shipment/>
<min_order_quantity>12</min_order_quantity>
</shipment>
</reference>
</data>
</content>
Описание основных атрибутов:
series - название серии.
series_id - идентификатор серии.
price - цена референса за указанную единицу в теге unit.
currency_price - валюта.
date - дата цены/тарифа.
unit - единица измерения.
unit_id - идентификаор единицы измерения.
stock_status - складской статус.
stock_status_description - расшифровка статуса.
delivery - срок поставки.
min_order_quantity - минимальная партия к заказу (кратность упаковки).
Указанная цена является публичной для всех партнеров и не содержит информацию о персональных скидках. Для получения конечной стоимости с учетом персональных скидок необходимо производить все расчеты на своей стороне. Получить актуальные сведения по персональным скидкам вы можете у вашего менеджера со стороны SE.
Иногда в выдаче значение цены может быть 0:
<reference>
<commercialRef>SMC2000I-2URS</commercialRef>
<description>ИБП APC Smart-UPS, 4 розетки Schuko, 2000 ВА 230 В</description>
<series/>
<price>0.00</price>
<date>12.02.2019</date>
<unit>Не указано</unit>
</reference>
Это означает, что референс не тарифный и цену необходимо запрашивать у вашего менеджера в SE. Дата, в таком случае, обозначает последную дату обновления цены (когда она установилась на 0)
Информация об обновлении тарифа рассылается автоматически партнерам, имеющим прямой контракт с SE. Дополнительно информирование происходит посредством информационных рассылок API. Для их получения необходимо подписаться.
Перидоически могут открываться продажи референсов по дисконту. API передает эту информацию через getprice с использованием параметра discount=1 и содержит конечную цену с учетом скидки.
Распродажи не являются персональными скидками!
Если ваша компания имеет персональные скидки, то их дополнительно нужно учитывать от значения распродажной цены.
Пример запроса:
https://api.systeme.ru/new-api/XML/getprice?accessCode={YouApiToken}&discount=1
Пример выдачи в XML:
<reference>
<commercialRef>A9C62225</commercialRef>
<description>АВТ. ВЫКЛ. REFLEX iC60N 2П 25A C Ti24</description>
<series>Acti9_Smartlink</series>
<price>4432.36</price>
<date>10.06.2019</date>
<discount_start>01.06.2019</discount_start>
<discount_end>31.08.2019</discount_end>
<unit>за штуку</unit>
</reference>
При использовании параметра discount=1 в выдаче появляются атрибуты дисконтной цены. Без использования этого параметра значение цены базовое.
Описание параметров:
discount_start - дата начала распродажи. Распродажа действует с 00:00:01 часов.
discount_end - дата завершения распродажи включительно до 23:59:59 часов.
По завершения дисконта информация автоматически обновляется и референсу возвращается прежняя тарифная цена.
Получить полный список распродажных референсов можно "сквозным" запросом через метод getprice с параметрами discount=1 и page.
Поддерживаемые параметры: commercialRef, pageSize, page, discount
Метод передает данные тарифа Екатеринбург, цены которого могут отличаться от тарифа Москва в виду отличий логистики. Если ваша деятельность находится в Уральском федеральном округе или ближе к нему, чем к Центральному федеральному округу, имеет смысл забирать данные по этому тарифу, т.к. они адаптированы для указанного геоположения.
Структура выдачи метода полностью совпадает со структурой getprice.
Пример запроса:
https://api.systeme.ru/new-api/XML/getekaterinburgprice?accessCode={YouApiToken}
Пример выдачи:
<content>
<result>success</result>
<data>
<reference>
<commercialRef>10545</commercialRef>
<description>
ШИНКА ГРЕБЕНЧАТАЯ ЛЕВАЯ ГРУПП 4П (NL1L2L3(ШАГ18ММ)NL1NL2…NL3(ШАГ9MM)) 12 МОД.80А
</description>
<series>ACTI9</series>
<series_id>1</series_id>
<price>4885.00</price>
<currency_price>руб.</currency_price>
<date>17.02.2020</date>
<unit>за штуку</unit>
<unit_id>1</unit_id>
<comments/>
<warehouse>
<stock_status>N</stock_status>
<stock_status_description>Под заказ</stock_status_description>
</warehouse>
<shipment>
<delivery>C3(4)</delivery>
<guar_shipment/>
<min_order_quantity>12</min_order_quantity>
</shipment>
</reference>
</data>
</content>
API позволяет получить данные о ценах за 2 недели до их вступления в силу. Как правило, эта информация распространяется в информационных бюллетенях (они же рассылки по e-mail) для всех партнеров, имеющих соответствующие подписные аккаунты и регистрацию на портале eS.
Для получения данных необходимо выполнить следующие запросы:
Тариф Москва
https://api.systeme.ru/new-api/XML/getfutureprice?accessCode={YouApiToken}
Тариф Екатеринбург
https://api.systeme.ru/new-api/XML/getfutureekaterinburgprice?accessCode={YouApiToken}
Структура выдачи данных идентична обычным методам получения цен, меняется только содержимое (цена и ее дата обновления). Как только наступает дата актуальности нового тарифа (в 00:00 по Москве), цены автоматически обновляются и в обычных методах. Данные о будущих ценах появляются в API в течение дня рассылки информационных писем об изменениях.
Получение цен заранее может быть полезным в случаях, если вашему магазину нужно, например, подготовить ценники для их обновления в торговом зале.
Продолжая просмотр сайта www.api.systeme.ru я соглашаюсь с использованием файлов cookie владельцем сайта в соответствии с «Политикой в отношении файлов cookie», в том числе на передачу данных, указанных в Политике, третьим лицам - статистическим службам сети Интернет.