Try it — CreateGMH
SOAP Request

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

CreateGMH: Создание ГМХ

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

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

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

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

  • Key — название параметра (варианты в таблице ниже)
  • Value — значение этого параметра
  • ValueType — тип значения этого параметра
Параметр Тип Обязательно Описание
DocumentType string Тип документа, к которому привязываются ГМХ «Waybill»/«Waybills» (для накладных)
Number string Номер документа
numbertype string Номер документа, в который будут добавляться
грузовые места.
Описание параметра data

Содержит список грузовых мест для создания. Содержит Key = "GMH"  и список элементов List

List содержит данные о каждом грузовом месте с Key отражающем идентификатор грузоместа и структурой Fields  отражающую параметры грузового места (габариты, вес, код клиента). Каждый параметр представлен отдельным блоком Fields, содержащим:

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

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

Параметр Тип Обязательно Описание
Height float Высота грузового места (см)
Length float Длина грузового места (см)
Width float Ширина грузового места (см)
Weight float Вес грузового места (кг)
ClientCode string Внешний код грузового места (идентификатор в системе клиента)
Описание возвращаемого параметра return

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

Структура List  пару параметров Key и Properties содержащие информацию по одному из параметров грузового места. Каждый параметр представлен отдельным блоком Properties, содержащим:

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

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

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

Параметр Тип Обязательно Описание
GMH_Number string Сформированный номер грузового места в системе
GMH_GUID string (GUID) GUID созданного грузового места в системе
Примеры запроса/ответа 
<soapenv:Envelope
  xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
  xmlns:car="http://www.cargo3.ru">
  <soapenv:Header/>
  <soapenv:Body>
    <car:CreateGMH>
      <car:Login>test</car:Login>
      <car:Password>2016</car:Password>
      <car:data>
        <car:Key>GMH</car:Key>
        <car:List>
          <car:Key>9110778</car:Key>
          <car:Fields>
            <car:Key>Height</car:Key>
            <car:Value>110</car:Value>
            <car:ValueType>float</car:ValueType>
          </car:Fields>
          <car:Fields>
            <car:Key>Length</car:Key>
            <car:Value>100</car:Value>
            <car:ValueType>float</car:ValueType>
          </car:Fields>
          <car:Fields>
            <car:Key>Width</car:Key>
            <car:Value>10</car:Value>
            <car:ValueType>float</car:ValueType>
          </car:Fields>
          <car:Fields>
            <car:Key>Weight</car:Key>
            <car:Value>10</car:Value>
            <car:ValueType>float</car:ValueType>
          </car:Fields>
          <car:Fields>
            <car:Key>ClientCode</car:Key>
            <car:Value>9110755786</car:Value>
            <car:ValueType>string</car:ValueType>
          </car:Fields>
        </car:List>
        <car:List>
          <car:Key>9110710881</car:Key>
          <car:Fields>
            <car:Key>Height</car:Key>
            <car:Value>250</car:Value>
            <car:ValueType>float</car:ValueType>
          </car:Fields>
          <car:Fields>
            <car:Key>Length</car:Key>
            <car:Value>100</car:Value>
            <car:ValueType>float</car:ValueType>
          </car:Fields>
          <car:Fields>
            <car:Key>Width</car:Key>
            <car:Value>150</car:Value>
            <car:ValueType>float</car:ValueType>
          </car:Fields>
          <car:Fields>
            <car:Key>Weight</car:Key>
            <car:Value>0.5</car:Value>
            <car:ValueType>float</car:ValueType>
          </car:Fields>
          <car:Fields>
            <car:Key>ClientCode</car:Key>
            <car:Value>9110710881</car:Value>
            <car:ValueType>string</car:ValueType>
          </car:Fields>
        </car:List>
      </car:data>
      <car:parameters>
        <car:Key>parameters</car:Key>
        <car:List>
          <car:Key>DocumentType</car:Key>
          <car:Value>waybill</car:Value>
          <car:ValueType>string</car:ValueType>
        </car:List>
        <car:List>
          <car:Key>Number</car:Key>
          <car:Value>888-0006983-00004806</car:Value>
          <car:ValueType>string</car:ValueType>
        </car:List>
        <car:List>
          <car:Key>numbertype</car:Key>
          <car:Value>innernumber</car:Value>
          <car:ValueType>string</car:ValueType>
        </car:List>
      </car:parameters>
    </car:CreateGMH>
  </soapenv:Body>
</soapenv:Envelope>
<soap:Envelope
  xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <m:CreateGMHResponse
      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>CreateGMH</m:Key>
        <m:List>
          <m:Key>GMH</m:Key>
          <m:Properties>
            <m:Key>GMH_Number</m:Key>
            <m:Value xsi:type="xs:string">#PC#888-385 -00000000021</m:Value>
            <m:ValueType>string</m:ValueType>
          </m:Properties>
          <m:Properties>
            <m:Key>GMH_GUID</m:Key>
            <m:Value xsi:type="xs:string">b0d00ca0-2b4b-11e7-b95d-005056b1a128</m:Value>
            <m:ValueType>string</m:ValueType>
          </m:Properties>
        </m:List>
        <m:List>
          <m:Key>GMH</m:Key>
          <m:Properties>
            <m:Key>GMH_Number</m:Key>
            <m:Value xsi:type="xs:string">#PC#888-385 -00000000022</m:Value>
            <m:ValueType>string</m:ValueType>
          </m:Properties>
          <m:Properties>
            <m:Key>GMH_GUID</m:Key>
            <m:Value xsi:type="xs:string">b0d00ca1-2b4b-11e7-b95d-005056b1a128</m:Value>
            <m:ValueType>string</m:ValueType>
          </m:Properties>
        </m:List>
      </m:return>
    </m:CreateGMHResponse>
  </soap:Body>
</soap:Envelope>