PutReferenceData: Создание серийных номеров для товаров клиента

SOAP Endpoint: PutReferenceData Обновлено: 2026-05-19

Endpoint: PutReferenceData
SOAP-метод: Товары - PutReferenceData
Группа: PutReferenceData
Создано: 16.04.2026 · Обновлено: 19.05.2026

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

Параметр	Тип	Обязательно	Описание
login	string	да	Логин пользователя
password	string	да	Пароль
parameters	Element	да	Список параметров
data	Element	нет	Список данных

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

Параметры справочника содержит Key = "parameters" и элементы List

Описание: Параметры справочника, в который добавляются/обновляются элементы. Каждый параметр представлен отдельным блоком List, содержащим:

Key — название параметра (варианты в таблице ниже)
Value — значение этого параметра
ValueType — тип значения этого параметра

Таблица параметров (возможные значения Key внутри List):

Параметр	Тип	Обязательно	Описание
Reference	string	да	Имя справочника (например, serialnumbers— серийные номера)

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

Содержит список товары и их серийные номера. Содержит Key = "elements" и список элементов List

List содержит данные об одном товаре в формате Key — наименование товара Tables -Содержит табличные данные товара

Описание вложенного параметра Tables . Каждый параметр представлен отдельным блоком Tables , содержащим Key = "SerialNumbers" и List с данными в рамках этого серийного номера

List содержит данные о серийном номере товара в формате Key = "SerialNumbers" и Fields с данными в рамках этого серийного номера

Key — название параметра (варианты в таблице ниже)
Value — значение этого параметра
ValueType — тип значения этого параметра

Таблица параметров (возможные значения Key для Fields):

Параметр	Тип	Обязательно	Описание
Name	string	да	Название нового элемента в системе Карго
GTIN	string	нет	Идентификатор продукта GTIN
SerialNumber	string	нет	Серийный номер товара
NumberGTD	string	нет	Номер ГТД
ExpirationDate	date	нет	Срок годности
KIS	string	нет	Контрольный (идентификационный) знак (КиЗ)
Certificate	string	нет	Номер сертификата
Country	string	нет	GUID страны товара из классификатора стран (см метод GetrefernseData).

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

Содержит пару параметров Key и List содержащие ответ по одному элементу

Структура List группирует результат по одному элементу:

Key — название параметра
Value — результат изменения
ValueType — тип значения этого параметра

---

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

Параметр	Тип	Обязательно	Описание
		нет

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

xml

<SOAP-ENV:Envelope
  xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
  xmlns:m="http://www.cargo3.ru">
  <SOAP-ENV:Header/>
  <SOAP-ENV:Body>
    <m:PutReferenceData>
      <m:login>test</m:login>
      <m:password>2016</m:password>
      <m:data>
        <m:Key>elements</m:Key>
        <m:List>
          <m:Key>Товар999</m:Key>
          <m:Tables>
            <m:Key>SerialNumbers</m:Key>
            <m:List>
              <m:Key>SerialNumber</m:Key>
              <m:Fields>
                <m:Key>Name</m:Key>
                <m:Value>Проверка серийника3</m:Value>
                <m:ValueType>string</m:ValueType>
              </m:Fields>
              <m:Fields>
                <m:Key>GTIN</m:Key>
                <m:Value>100002</m:Value>
                <m:ValueType>string</m:ValueType>
              </m:Fields>
              <m:Fields>
                <m:Key>SerialNumber</m:Key>
                <m:Value>783434343</m:Value>
                <m:ValueType>string</m:ValueType>
              </m:Fields>
              <m:Fields>
                <m:Key>NumberGTD</m:Key>
                <m:Value>442</m:Value>
                <m:ValueType>string</m:ValueType>
              </m:Fields>
              <m:Fields>
                <m:Key>ExpirationDate</m:Key>
                <m:Value>2022-09-09</m:Value>
                <m:ValueType>dateTime</m:ValueType>
              </m:Fields>
              <m:Fields>
                <m:Key>KIS</m:Key>
                <m:Value>10</m:Value>
                <m:ValueType>string</m:ValueType>
              </m:Fields>
              <m:Fields>
                <m:Key>Certificate</m:Key>
                <m:Value>1</m:Value>
                <m:ValueType>string</m:ValueType>
              </m:Fields>
            </m:List>
          </m:Tables>
        </m:List>
      </m:data>
      <m:parameters>
        <m:Key>Parameters</m:Key>
        <m:List>
          <m:Key>Reference</m:Key>
          <m:Value>serialnumbers</m:Value>
          <m:ValueType>string</m:ValueType>
        </m:List>
      </m:parameters>
    </m:PutReferenceData>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

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

xml

<soap:Envelope
  xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <m:PutReferenceDataResponse
      xmlns:m="http://www.cargo3.ru">
      <m:return xsi:type="m:Element"
        xmlns:xs="http://www.w3.org/2001/XMLSchema"
        xmlns:xsi="http://www.w3.org/2001/XMLSchemainstance">
        <m:Key>SerialNumbers</m:Key>
        <m:List>
          <m:Properties>
            <m:Key>SerialNumber</m:Key>
            <m:Value xsi:type="xs:string">e105ab6b-5169-11ea-80da-7cd30aec6901</m:Value>
            <m:ValueType>string</m:ValueType>
          </m:Properties>
          <m:Properties>
            <m:Key>SerialNumberName</m:Key>
            <m:Value xsi:type="xs:string">Проверка серийника3</m:Value>
            <m:ValueType>string</m:ValueType>
          </m:Properties>
        </m:List>
      </m:return>
    </m:PutReferenceDataResponse>
  </soap:Body>
</soap:Envelope>

Смежные методы

Проекты - PutReferenceData

Функция позволяет создавать новые проекты клиента либо изменять имеющиеся.

Подразделения - PutReferenceData

Функция позволяет создавать новые подразделения клиента либо изменять имеющиеся.