Содержание

Замены референсов - getsubstitution

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

Замены референсов - getsubstitution

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

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

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

<content>
    <result>success</result>
    <data>
        <reference>
            <commercialRef>A9A15213</commercialRef>
            <StatusRef>Выведен из ассортимента</StatusRef>
            <product>
                <description>ЗВОНКОВЫЙ ТРАНСФОРМАТОР iTR 4ВА 8/12В ACTI9</description>
                <eComProductTitles/>
                <eComeProductDescriptions>Звонковый трансформатор iTR 4ВА 8/ диапазон: Acti 9 -
                    его аксессуаров: трансформатор - краткое название устройства: iTR.
                    Преимущества: применения: Управление и контроль электрическими цепями в
                    непроизводственных зданиях.
                </eComeProductDescriptions>
            </product>
            <Substitution>
                <newReference>
                    <NewCommercialReference>A9A15212</NewCommercialReference>
                    <QuantityOld>1</QuantityOld>
                    <QuantityNew>1</QuantityNew>
                    <SubstitutionBeginning>15.02.2021</SubstitutionBeginning>
                </newReference>
            </Substitution>
        </reference>
    </data>
</content>

NewCommercialReference - новый референс, на который заменяется закрытый.

QuantityOld - количество единиц старого референса.

QuantityNew - количество единиц нового референса. Бывают ситуации, когда закрытый 1 референс требует 2 или более единиц нового, чтобы полностью соответстовать прежним параметрам.

SubstitutionBeginning - дата замены. Дата может быть запланированной, т.е. указанное значение больше текущей. Например, сегодня 08.07.2021, а в замене указана дата 01.08.2021. Значит референс с 1 августа будет заменен на новый, старый более продаваться не будет.

Для ручной работы с данными по заменам используйте раздел "Замены", где можно выгружать данные в файл Excel.

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

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

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

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

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

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

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

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

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

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