Содержание

Закрытые и закрывающиеся референсы - getclosedref

Поддерживаемые параметры: commercialRef, pageSize, page, brand, update_date

Метод передает список всех закрытых или закрывающихся референсов.

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

https://api.systeme.ru/new-api/XML/getclosedref?accessCode={YourApiToken}

https://api.systeme.ru/new-api/XML/getclosedref?accessCode={YourApiToken}&commercialRef=CCT15284

Пример выдачи в XML:

<content>
    <result>success</result>
    <data>
        <reference>
            <commercialRef>CCT15284</commercialRef>
            <description>СУМЕРЕЧНЫЙ ВЫКЛ. IC 200 С ЩИТОВЫМ ДАТЧИКОМ</description>
            <status>
               <id>99</id>
               <description>Снято с производства, нет в наличии</description>
               <date_close>20.11.2020</date_close>
            </status>
            <stock>
               <id>55994</id>
              <warehouse>Лобня</warehouse>
              <count>0</count>
              <unit>PCE</unit>
              <count_min_date>0</count_min_date>
              <last_update>10.12.2024 12:34:10</last_update>
            </stock>
        </reference>
        <reference>
            <commercialRef>CCT15401</commercialRef>
            <description>РЕЛЕ ВРЕМ ЭЛЕКТРОН IHP+1C 24Ч + 7ДН 1КАН</description>
            <status>
                <id>31</id>
                <description>Плановое снятие с производства, есть в наличии</description>
                <date_close>28.12.2025</date_close>
            </status>
            <stock>
               <id>55994</id>
              <warehouse>Лобня</warehouse>
              <count>5</count>
              <unit>PCE</unit>
              <count_min_date>0</count_min_date>
              <last_update>10.12.2024 12:34:10</last_update>
            </stock>
        </reference>
    </data>
</content>

Описание атрибутов:
commercialRef - наименование референса
description - описание референса
status - статус референса
stock - остатки на складах

Описание атрибута status:
id - идентификатор статуса. Может принимать значения 99 (Закрытый) или 31 (Плановое снятие с производства)
description - описание статуса
date_close - дата закрытия

Описание атрибута stock:
id - идентификатор склада, 55995 (Лобня) и 55994 (Екатеринбург)
warehouse - город, где находится склад (Лобня или Екатеринбург)
unit - единица измерения
status - складской статус, может принимать значения: N (под заказ), S (Складской), D (Закрытый референс)
count - весь свободный остаток продукции в штуках
count_min_date - минимальное количество товара к заказу
last_update - дата и время обновления

Закрытые - эти референсы выведены из производства. В выдаче API такие референсы имеют идентификатор 99 и в description обозначен статус Снято с производства, есть в наличии или Снято с производства, нет в наличии.

<reference>
    <commercialRef>27150</commercialRef>
    <description>Держатель наклеек набор из 10 шт</description>
    <status>
        <id>99</id>
        <description>Снято с производства, нет в наличии</description>
        <date_close>28.12.2023</date_close>
    </status>
</reference>

Закрывающиеся - эти референсы выведены из производства, но на складах еще имеются остатки. В выдаче API такие референсы имеют идентификатор 31 и в description обозначен статус Плановое снятие с производства, есть в наличии или Плановое снятие с производства, нет в наличии.

<reference>
    <commercialRef>BMXAMO0210</commercialRef>
    <description>2 ИЗОЛИРОВАННЫХ ВЫХОДА ТОК/НАПРЯЖЕНИЕ</description>
    <status>
        <id>31</id>
        <description>Закрыт, есть в наличии</description>
        <date_close>04.03.2020</date_close>
    </status>
    <stock>
        <id>55994</id>
        <warehouse>Лобня</warehouse>
        <count>33</count>
        <min_order>1</min_order>
        <last_update>21.11.2019 15:56:21</last_update>
    </stock>
</reference>

Обновление списка закрывающихся референсов происходит ежедневно, а дата закрытия референсов обновляется 4 раза в день - сразу после обновления остатков (метод getstock).

Описание параметров запроса

&page={N} - пагинация, осуществляет переход к указанной странице, где N - ее номер. Общее количество страниц в выдаче системой не определяется (нецелесообразно), поэтому осуществлять перебор данных постранично нужно до тех пор, пока ответ не перестанет возвращать продуктовые данные (выдача станет пустой).

Пример запроса:
https://api.systeme.ru/new-api/XML/getclosedref?accessCode={YourApiToken}&page=2

&pageSize={N} – задает количество записей в выдаче, где N - числовое значение. По умолчанию большинство методов содержит лимит в 50 записей на страницу. Максимальное значение лимита 50.

Пример запроса:
https://api.systeme.ru/new-api/XML/getclosedref?accessCode={YourApiToken}&pageSize=50

&commercialRef={N} – запрос данных по конкретному референсу или списку референсов, где N - точное обозначение референса, например GSL000434. Если в качестве значения задается список референсов, то они должны перечисляться через запятую без пробелов: GSL000434,16765,18636. Максимальное значение лимита 50.

Примеры запросов:
https://api.systeme.ru/new-api/XML/getclosedref?accessCode={YourApiToken}&commercialRef=GSL000434
https://api.systeme.ru/new-api/XML/getclosedref?accessCode={YourApiToken}&commercialRef=GSL000434,16765,18636

&brand - бренд товара.

Поддерживается сортировка товара по бренду, для этого используйте: https://api.systeme.ru/new-api/XML/getclosedref?accessCode={YourApiToken}&brand={ID-бренда}

Чтобы получить список брендов с их идентификаторами (ID) используйте метод API getbrands https://api.systeme.ru/new-api/XML/getbrands?accessCode={YourApiToken}

&update_date={N} – указывает на дату от которой следует запросить обновленные данные у рефренесов. Формат данных «дд.мм.гггг», например «20.04.2026».

Пример запроса:
https://api.systeme.ru/new-api/XML/getclosedref?accessCode={YourApiToken}&update_date=15.07.2026