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

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

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

Описание

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

Параметры запроса

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

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

xml

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

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

xml

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