Try it — Товары - PutReferenceData
SOAP Request

Отредактируйте параметры запроса и нажмите Выполнить для отправки запроса на сервер

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

  • Создано 16.04.2026
  • Обновлено 19.05.2026
  • Endpoint: PutReferenceData
  • Soap-method: Товары - PutReferenceData
Параметры запроса
Параметр Тип Обязательно Описание
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 — Коды ошибок). 

Параметр Тип Обязательно Описание
Примеры запроса/ответа 
<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>
<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>