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

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

SOAP Endpoint: UpdateClientProducts Обновлено: 2026-05-16
  • Endpoint: UpdateClientProducts
  • SOAP-метод: UpdateClientProducts
  • Группа: UpdateClientProducts
  • Создано: 16.04.2026 · Обновлено: 16.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>