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

SOAP Endpoint: UpdateClientProducts Обновлено: 2026-05-15

Endpoint: UpdateClientProducts
SOAP-метод: UpdateClientProducts
Группа: UpdateClientProducts
Создано: 16.04.2026 · Обновлено: 15.05.2026

Описание

Функция позволяет создать новый товар контрагента или обновить некоторую информацию по имеющимся. Алгоритм работы метода следующий: если по переданному артикулу не находится товар, то создается новый, иначе обновляется информация по найденной позиции. Для обновления информации по товару можно передать его артикул или 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

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

xml

<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>

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

xml

<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>