GetReferenceData: MarkingTypes — Тип маркировки товара

Функция позволяет получить типы маркировок товаров, которые необходимо передавать при создании товаров определенной категории (обувь, изделия из меха, лекарственные препараты и табачная продукция).

SOAP Endpoint: GetReferenceData Обновлено: 2026-07-11
  • Endpoint: GetReferenceData
  • SOAP-метод: MarkingTypes
  • Группа: GetReferenceData
  • Создано: 16.04.2026 · Обновлено: 11.07.2026

Описание

Функция позволяет получить типы маркировок товаров, которые необходимо передавать при создании товаров определенной категории (обувь, изделия из меха, лекарственные препараты и табачная продукция). 

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

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

Параметр
Тип
Обязательно
Описание
login
string
Да
логин
password
string
Да
пароль
parameters
Element
Да
список параметров

Описание параметра parameters

Параметр parameters содержит настройки запроса в виде иерархической структуры, соответствующей XML-представлению.

Он должен включать:

Key: строка со значением parameters (обязательное);

List: непустой массив элементов, каждый из которых представляет отдельный параметр и сам является структурой с тремя полями:

  • Key: имя параметра (например, Reference);
  • Value: значение параметра указывающая на то какой parameters описывается;
  • ValueType: тип значения — строка, указывающая тип Value(string, int и т.д.).

Пример одного элемента из List:

<car:List>
   <car:Key>Reference</car:Key>
   <car:Value>markingtypes</car:Value>
   <car:ValueType>string</car:ValueType>
</car:List>

Каждый такой элемент — независимый узел внутри parameters. Если List отсутствует или пуст — запрос отклоняется.

Иерархия структуры parameters:

parameters → List (массив) → каждый элемент List → Key, Value, ValueType.

Параметр
Тип
Обязательно
Описание
Reference
string
Да
Имя справочника, должно быть равно «markingtypes»

Возвращаемые параметры

Параметр Element в ответе содержит информацию о типах маркировок товара.

Он включает элементы справочника:

Key: идентификатор справочника, к которому относится запись (например, MarkingTypes);

List: контейнер записи справочника, каждая запись соответствует одному типу маркировки товаров .

Каждый блок List  описывает один тип маркировки в виде структуры Element и содержит в себе:

  • Key: строковой идентификатор типа маркировки (ключ);
  • Value: отображаемое наименование типа маркировки;
  • ValueType: тип значения — строка, указывающая тип Value (string, dateTime и т.п.).

Структура ответа иерархична:

Element → Key + List (массив) → каждый элемент List → Key + Value +ValueType.

Если во время запроса произошла ошибка, информация о ней будет отражена в свойстве Properties (см. метод GetReferenceData: ErrorCodes — Коды ошибок). 

Параметр
Тип
Обязательно
Описание
Key
string
Да
Системное название маркировки
Value
string
Да
Наименование маркировки

Пример запроса (XML Request)

XML 
<soap:Envelope
  xmlns:soap="http://www.w3.org/2003/05/soap-envelope"
  xmlns:car="http://www.cargo3.ru">
  <soap:Header/>
  <soap:Body>
    <car:GetReferenceData>
      <car:login>test</car:login>
      <car:password>2016</car:password>
      <car:parameters>
        <car:Key>parameters</car:Key>
        <car:List>
          <car:Key>Reference</car:Key>
          <car:Value>markingtypes</car:Value>
          <car:ValueType>string</car:ValueType>
        </car:List>
      </car:parameters>
    </car:GetReferenceData>
  </soap:Body>
</soap:Envelope>

Пример ответа (XML Response)

XML 
<soap:Envelope
  xmlns:soap="http://www.w3.org/2003/05/soap-envelope">
  <soap:Body>
    <m:GetReferenceDataResponse
      xmlns:m="http://www.cargo3.ru">
      <m:return
        xmlns:xs="http://www.w3.org/2001/XMLSchema"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
        <m:Key>MarkingTypes</m:Key>
        <m:List>
          <m:Key>ИзделияИзМеха</m:Key>
          <m:Value xsi:type="xs:string">Изделия из меха</m:Value>
          <m:ValueType>string</m:ValueType>
        </m:List>
        <m:List>
          <m:Key>ЛекарственныеПрепараты</m:Key>
          <m:Value xsi:type="xs:string">Лекарственные препараты</m:Value>
          <m:ValueType>string</m:ValueType>
        </m:List>
        <m:List>
          <m:Key>ТабачнаяПродукция</m:Key>
          <m:Value xsi:type="xs:string">Табачная продукция</m:Value>
          <m:ValueType>string</m:ValueType>
        </m:List>
        <m:List>
          <m:Key>ОбувныеТовары</m:Key>
          <m:Value xsi:type="xs:string">Обувные товары</m:Value>
          <m:ValueType>string</m:ValueType>
        </m:List>
        <m:List>
          <m:Key>Духи</m:Key>
          <m:Value xsi:type="xs:string">Парфюмерная продукция</m:Value>
          <m:ValueType>string</m:ValueType>
        </m:List>
        <m:List>
          <m:Key>ЮвелирнаяПродукция</m:Key>
          <m:Value xsi:type="xs:string">Ювелирная продукция</m:Value>
          <m:ValueType>string</m:ValueType>
        </m:List>
      </m:return>
    </m:GetReferenceDataResponse>
  </soap:Body>
</soap:Envelope>