Try it — UpdateClientProducts
SOAP Request

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

UpdateClientProducts: Создание новых товаров или обновление имеющихся товаров

  • Создано 16.04.2026
  • Обновлено 16.05.2026
  • Endpoint: UpdateClientProducts
  • Soap-method: UpdateClientProducts
Описание

Функция позволяет создать новый товар контрагента или обновить некоторую информацию по имеющимся. Алгоритм работы метода следующий: если по переданному артикулу не находится товар, то создается новый, иначе обновляется информация по найденной позиции. Для обновления информации по товару можно передать его артикул или GUID (уникальный идентификатор товара в системе Карго)

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

Передается блок parameters, содержащий:

Параметр Тип Обязательно Описание
Key string Значение равное Parameters
Описание параметра data

Содержит список товаров List для создания/обновления.

List содержит пары Key, идентифицирующий товар и структуры Fields и Tables с детальной информацией о товаре

Параметр Тип Обязательно Описание
Key string Наименование товара
Fields Element Содержит детальную информацию, описывающую параметры товара
Tables Element Содержит детальную информацию, описывающую параметры товара
Описание вложенного параметра Fields

 Каждый параметр представлен отдельным блоком Fields, содержащим:

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

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

Параметр Тип Обязательно Описание
Article string Артикул товара (уникальный идентификатор)
Name string Краткое наименование товара
FullName string Тип маркировки товара
MarkingType string GUID базовой единицы измерения
BaseUnit string (GUID) GUID базовой единицы измерения
UseSerialNumbers boolean Признак учета товара по серийным номерам
Описание параметров Tables

 Содержит табличные с Списком серийных номеров товара. Содержит Key с заголовком и List

  Каждый параметр List представлен отдельными блоками Fields, содержащими:

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

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

Параметр Тип Обязательно Описание
Name string Название серийного номера
GTIN string GTIN (глобальный номер товарной позиции)
SerialNumber string Значение серийного номера
NumberGTD string Номер ГТД
KIS string КИС (контрольный идентификационный знак)
Certificate string Номер сертификата
Описание возвращаемых параметров return

Содержит Key и List с результатами

List Содержит информацию об одном обработанном товаре в формате 

  • Key  = "Product"
  • Properties
  • List 

Описание вложенного параметра Properties

 Отображает результаты обработки товара. Каждый параметр представлен отдельным блоком Properties, содержащим:

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

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

Параметр Тип Обязательно Описание
Article string Артикул товара
Type string Тип операции: NEW — создан новый товар, Update — обновлён существующий
ProductGUID string (GUID) GUID созданного/обновлённого товара в системе «Карго»
Name string Название единицы измерения товара
BaseUnitGuid string Уникальный идентификатор единицы измерения товара в системе «Карго»
SerialNumber string Уникальный идентификатор серийного номера товара в системе «Карго»
SerialNumberName string Название серийного номера
UIN string УИН ювелирного изделия
UINNumberName string GUID (Globally Unique Identifier) – УИН ювелирного изделия
Error Element Информация о ошибке при выполнении метода. Содержит признак наличия ошибки и List с описанием в Description
Примеры запроса/ответа 
<SOAP-ENV:Envelope
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xmlns:xsd="http://www.w3.org/2001/XMLSchema"
  xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
  <SOAP-ENV:Body>
    <m:UpdateClientProducts
      xmlns:m="http://www.cargo3.ru">
      <m:Login>test</m:Login>
      <m:Password>2016</m:Password>
      <m:data>
        <m:Key>Productss</m:Key>
        <m:List>
          <m:Key>Товар8889</m:Key>
          <m:Fields>
            <m:Key>Article</m:Key>
            <m:Value>Товар8889</m:Value>
            <m:ValueType>string</m:ValueType>
          </m:Fields>
          <m:Fields>
            <m:Key>Name</m:Key>
            <m:Value>Товар999</m:Value>
            <m:ValueType>string</m:ValueType>
          </m:Fields>
          <m:Fields>
            <m:Key>FullName</m:Key>
            <m:Value>Товар999</m:Value>
            <m:ValueType>string</m:ValueType>
          </m:Fields>
          <m:Fields>
            <m:Key>MarkingType</m:Key>
            <m:Value>ТабачнаяПродукция</m:Value>
            <m:ValueType>string</m:ValueType>
          </m:Fields>
          <m:Fields>
            <m:Key>BaseUnit</m:Key>
            <m:Value>601632e2-976d-11dc-986e-0015170f8c09</m:Value>
            <m:ValueType>string</m:ValueType>
          </m:Fields>
          <m:Tables>
            <m:Key>SerialNumbers</m:Key>
            <m:List>
              <m:Key>SerialNumber</m:Key>
              <m:Fields>
                <m:Key>Name</m:Key>
                <m:Value>Проверка серийника1</m:Value>
                <m:ValueType>string</m:ValueType>
              </m:Fields>
              <m:Fields>
                <m:Key>GTIN</m:Key>
                <m:Value>12345452222</m:Value>
                <m:ValueType>string</m:ValueType>
              </m:Fields>
              <m:Fields>
                <m:Key>SerialNumber</m:Key>
                <m:Value>56333</m:Value>
                <m:ValueType>string</m:ValueType>
              </m:Fields>
              <m:Fields>
                <m:Key>NumberGTD</m:Key>
                <m:Value>44</m:Value>
                <m:ValueType>string</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:List>
          <m:Key>тест</m:Key>
          <m:Fields>
            <m:Key>Article</m:Key>
            <m:Value>тест</m:Value>
            <m:ValueType>string</m:ValueType>
          </m:Fields>
          <m:Fields>
            <m:Key>Name</m:Key>
            <m:Value>tes2t</m:Value>
            <m:ValueType>string</m:ValueType>
          </m:Fields>
          <m:Fields>
            <m:Key>FullName</m:Key>
            <m:Value>test33</m:Value>
            <m:ValueType>string</m:ValueType>
          </m:Fields>
        </m:List>
      </m:data>
      <m:parameters>
        <m:Key>Parameters</m:Key>
      </m:parameters>
    </m:UpdateClientProducts>
  </SOAP-ENV:Body>undefined
</SOAP-ENV:Envelope>
<soap:Envelope
  xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <m:UpdateClientProductsResponse
      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>UpdateClientProducts</m:Key>
        <m:List>
          <m:Key>Product</m:Key>
          <m:Properties>
            <m:Key>Article</m:Key>
            <m:Value xsi:type="xs:string">Товар8889</m:Value>
            <m:ValueType>string</m:ValueType>
          </m:Properties>
          <m:Properties>
            <m:Key>Type</m:Key>
            <m:Value xsi:type="xs:string">NEW</m:Value>
            <m:ValueType>string</m:ValueType>
          </m:Properties>
          <m:Properties>
            <m:Key>ProductGUID</m:Key>
            <m:Value xsi:type="xs:string">fe4efed0-516d-11ea-80da-7cd30aec6901</m:Value>
            <m:ValueType>string</m:ValueType>
          </m:Properties>
          <m:List>
            <m:Key>BaseUnit</m:Key>
            <m:Properties>
              <m:Key>Name</m:Key>
              <m:Value xsi:type="xs:string">Шт</m:Value>
              <m:ValueType>string</m:ValueType>
            </m:Properties>
            <m:Properties>
              <m:Key>BaseUnitGUID</m:Key>
              <m:Value xsi:type="xs:string">fe4efed1-516d-11ea-80da-7cd30aec6901</m:Value>
              <m:ValueType>string</m:ValueType>
            </m:Properties>
          </m:List>
          <m:List>
            <m:Key>SerialNumbers</m:Key>
            <m:Properties>
              <m:Key>SerialNumber</m:Key>
              <m:Value xsi:type="xs:string">fe4efed3-516d-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">Проверка серийника1</m:Value>
              <m:ValueType>string</m:ValueType>
            </m:Properties>
          </m:List>
        </m:List>
        <m:List>
          <m:Key>Product</m:Key>
          <m:Properties>
            <m:Key>Article</m:Key>
            <m:Value xsi:type="xs:string">тест</m:Value>
            <m:ValueType>string</m:ValueType>
          </m:Properties>
          <m:Properties>
            <m:Key>Type</m:Key>
            <m:Value xsi:type="xs:string">Update</m:Value>
            <m:ValueType>string</m:ValueType>
          </m:Properties>
          <m:Properties>
            <m:Key>ProductGUID</m:Key>
            <m:Value xsi:type="xs:string">35d8c7d1-e48f-11e6-839a-001e67086478</m:Value>
            <m:ValueType>string</m:ValueType>
          </m:Properties>
        </m:List>
      </m:return>
    </m:UpdateClientProductsResponse>
  </soap:Body>
</soap:Envelope>