POST http://www.cargo3.ru

SOAP Request

<?xml version="1.0" encoding="UTF-8"?>
<soap:Envelope
  xmlns:soap="http://www.w3.org/2003/05/soap-envelope"
  xmlns:ns1="http://www.cargo3.ru"
  xmlns:xs="http://www.w3.org/2001/XMLSchema"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <soap:Header />
  <soap:Body>
    <ns1:SaveWaybillOffice>
      <ns1:Language />
      <ns1:Login>test</ns1:Login>
      <ns1:Password>2016</ns1:Password>
      <ns1:Company />
      <ns1:Number />
      <ns1:ClientNumber>148704450</ns1:ClientNumber>
      <ns1:OrderData>
        <ns1:ClientContact />
        <ns1:DeliveryDate>2025-09-30T09:00:00</ns1:DeliveryDate>
        <ns1:Recipient>
          <ns1:Client>ТЕСТ</ns1:Client>
          <ns1:Official />
          <ns1:Address>
            <ns1:Geography>postcode-127018</ns1:Geography>
            <ns1:Info>АДРЕС ПОЛУЧАТЕЛЯ</ns1:Info>
            <ns1:FreeForm>true</ns1:FreeForm>
          </ns1:Address>
          <ns1:Phone>100</ns1:Phone>
          <ns1:Urgency>18c4f209-458b-11dc-9497-0015170f8c09</ns1:Urgency>
          <ns1:Cargo>
            <ns1:CargoPackageQty>1</ns1:CargoPackageQty>
            <ns1:Weight>1</ns1:Weight>
            <ns1:COD>6047.0</ns1:COD>
            <ns1:CustomerPrepayment>1.0</ns1:CustomerPrepayment>
          </ns1:Cargo>
          <ns1:Products>
            <ns1:Article>УТ-00727861</ns1:Article>
            <ns1:Name>5d93f941-bf99-11ea-aa80-005056bb6b60</ns1:Name>
            <ns1:Price>50.0</ns1:Price>
            <ns1:PackageQty>1</ns1:PackageQty>
          </ns1:Products>
          <ns1:Products>
            <ns1:Article>УТ-12915747</ns1:Article>
            <ns1:Name>74dbb15c-c039-11ea-ae8c-005056bb6b60</ns1:Name>
            <ns1:Price>1999.0</ns1:Price>
            <ns1:PackageQty>3</ns1:PackageQty>
          </ns1:Products>
        </ns1:Recipient>
        <ns1:Sender>
          <ns1:Client>ТЕСТ</ns1:Client>
          <ns1:Address>
            <ns1:Geography>cf862f56-442d-11dc-9497-0015170f8c09</ns1:Geography>
            <ns1:Info>АДРЕС ОТПРАВИТЕЛЯ</ns1:Info>
            <ns1:FreeForm>true</ns1:FreeForm>
          </ns1:Address>
          <ns1:Phone>1110</ns1:Phone>
        </ns1:Sender>
        <ns1:TakeDate>2025-09-01T09:00:00</ns1:TakeDate>
        <ns1:TypeOfCargo>4aab1fc6-fc2b-473a-8728-58bcd4ff79ba</ns1:TypeOfCargo>
        <ns1:TypeOfPayer>0</ns1:TypeOfPayer>
        <ns1:WayOfPayment>1</ns1:WayOfPayment>
        <ns1:DeliveryOfCargo>ДоставкаДоДверей</ns1:DeliveryOfCargo>
        <ns1:DeliveryDateOf>2025-09-30T18:00:00</ns1:DeliveryDateOf>
      </ns1:OrderData>
      <ns1:Office />
    </ns1:SaveWaybillOffice>
  </soap:Body>
</soap:Envelope>

Запрос будет отправлен на сервер. Проверьте параметры перед выполнением.

Ответ появится здесь после выполнения запроса

XML

SaveWaybillOffice: Накладные/накладные с товарами

Функция сохраняет новые накладные в систему «Карго», а также позволяет создавать накладные содержащие список товаров в отправлении

SOAP Endpoint: SaveWaybillOffice Обновлено: 2026-05-20

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

Описание

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

Метод «Сохранить накладную». Содержит авторизацию и основные данные заказа.

Параметр	Тип	Обязательно	Описание
login	string	Да	Логин пользователя
password	string	Да	Пароль
Company	string	Да	Не используется
Number	string	Нет	Номер накладной для редактирования
ClientNumber	string	Нет	Клиентский номер документа, максимальное количество символов – 20
OrderData	OrderData	Нет	Структура данных для заполнения документа
Office	string	Нет	Не используется

Описание параметра OrderData

Основной контейнер с данными накладной. Вся информация о перевозке.

Параметр	Тип	Обязательно	Описание
ClientContact	string	Нет	Контактное лицо клиента
TakeDate	dateTime	Да	Дата и время забора накладной. Обязательно передавать время (yyyy-mm-ddThh:MM:ss)
Comment	string	Нет	Комментарий к накладной
Repository	string	Нет	Склад (GUID), если подключено более одного склада, параметр становится обязателен к заполнению. Используется для накладных с товарами
ReplySMSPhone	string	Нет	Телефон для смс информирования
ReplyEMail	string	Нет	Адрес электронной почты для уведомлений. Формат: <имя пользователя >@<почтовый сервер>. Пример:test@test.com
Sender	DestinationInformation	Да	Данные об отправителе
Recipient	DestinationInformation	Да	Данные о получателе
TypeOfPayer	int	Да	Плательщик, по умолчанию - заказчик. Если вы клиент с категорией не ИМ и в качестве плательщика(TypeOfPayer) указываете заказчика, то ограничения по оплате будут действовать согласно договору. Получить актуальный список способов оплаты можно функцией GetReferenceData:способы оплаты . Если плательщик не заказчик, то способ оплаты должен быть наличный расчет. При указании неверного способа оплаты возникнет ошибка.
WayOfPayment	int	Да	Способо оплаты, по умолчанию - безнал
TypeOfCargo	string	Нет	Вид груза (GUID), по умолчанию - груз
WithReturn	boolean	Нет	Признак того, что отправление требует температурного режима, возврата термоконтейнера и термодатчика
Department	string	Нет	GUID (Globally Unique Identifier) подразделения (получение списка подразделений см. GetReferenceData: подразделения), или подразделение в виде наименования
DescriptionForTheVPDreturn	string	Нет	Описание возврата для ВПД (Возврат при доставке)
Project	string	Нет	Проект клиента (GUID) . При необходимости указания в накладных, будет предоставлен менеджером
DeliveryOfCargo	int	Нет	Тип значения NameOfdeliverytype вида доставки(получение списка видов доставки см. GetReferenceData: DeliveryType - Виды доставок)
DeliveryDate	dateTime	Нет	Согласованная дата доставки начало интервала. Передавать в формате дата время (yyyy-mmddThh:MM:ss). Если параметр передается, то дата доставки должна быть больше даты забора и времени создания документа. Рекомендуется передача даты и интервала, полученных из ответа функции GerReferenceData:AvailableDeliveryDates (Возможные даты доставки).
DeliveryDateOf	dateTime	Нет	Согласованная дата доставки конец интервала. Передавать в формате дата время (yyyy-mmddThh:MM:ss). Параметр становится обязательным, если передан DeliveryDate (Согласованная дата доставки начало интервала)
ParentOrderForWaybill	string	Нет	Номер заказа или накладной (КСЕ)
TypeOfParentForWaybill	string	Нет	Тип документа основания (order/waybill) (КСЕ)
ArrayOfDocumentsPhoto	DocumentsPhoto	Нет	Список документов для фотосъемки при работе клиента в данном режиме (только для накладных) (если список документов отличается от типового)
ClientCodes	ListOfCorrespondences	Нет	Список дополнительных номеров
AdditionalServices	AdditionalServices	Нет	Список дополнительных услуг

Описание параметра Sender и Recipient (тип DestinationInformation)

Параметры которые могут содержаться в массиве отправителя и получателя

Параметр	Тип	Обязательно	Описание
Client	String	Да	Отправитель/Получатель
Official	string	Нет	Контактное лицо отправителя/получателя
Address	DestinationAddress	Да	Адрес отправителя/получателя
Info	string	Нет	Комментарий отправителя/получателя
Phone	string	Да	Телефон отправителя/получателя
Cargo	Cargo	Нет	Данные о грузе, только для получателей (для них обязательный)
EMail	string	Нет	Адрес электронной почты отправителя/получателя Формат: <имя пользователя >@<почтовый сервер>. Пример:test@test.com
Urgency	string	Да	GUID Срочности в соответствии с договором, параметр необходимо передавать в блоке получателя, (получение списка срочностей см. GetReferenceData: URGENCIES)
Products	Products	Нет	Данные о товарах (Могут передавать только ИМ)
DeliveryOptions	DeliveryOptions	Нет	Данные об опциях доставки
PVZ	string	Нет	GIUD пункта выдачи заказов (данные берутся из метода, описанного выше) или Код карточки ПВЗ (передается в формате PVZID-000075020)

Описание параметра Address (тип destinationAddress)

Содержит данные адреса.

Параметр	Тип	Обязательно	Описание
Geography	string	Да	-Населенный пукнт (GUID). -Либо код ФИАС, для этого необходимо передать строку «fias-» и необходисмый код ФИАС. -Для поиска по индексу: «postcode-», затем код страны (цифровой, либо Альфа-2, либо Альфа-3) и индекс для поиска – пример «postcode-KZA00A0A0». Если код страны не вводится, по умолчанию поиск осуществляется по России. Пример для России: «postcode-RU-990500» или «postcode-990500» (данный вариант поиска может возвращать не точную информацию).
Index	string	Нет	Индекс Отправителя/Получателя. Обязательно только для международных отправлений;
FreeForm	string	Да	Всегда истина (true)
Info	string	Да	Адрес целиком. Info:Можно указать в параметре Info в DESTINATIONINFORMATION. 1. Название страны – обязательно только для международных отправлений; 2. Название республики, края, области, автономного округа (области) – обязательно к передаче; 3. Название района – при отсутствии заполнять необязательно; 4. Название населенного пункта – обязательно к передаче; 5. Название улицы, номер дома, номер квартиры – при отсутствии заполнять необязательно. Разделитель - запятая «,». Пример: 115432, г Москва, проезд Проектируемый 4062-й, дом 6, стр 2 Комментарии к адресу, такие как: ∙ Этаж; ∙ Домофон; ∙ Наименование ТЦ/БЦ; ∙ Ориентиры и другая информация, помогающая выполнить сбор/доставку.

Описание параметра Cargo (тип Cargo)

Список параметров для описания груза

Параметр	Тип	Обязательно	Описание
CargoDescription	string	Нет	Описание груза
CargoPackageQty	string	Да	Количество груза
Weight	float	Да	Вес груза
VolumeWeight	float	Нет	Объемный вес
Volume	float	Нет	Объем, м3
Length	float	Нет	Длина
Width	float	Нет	Ширина
Height	float	Нет	Высота
InsuranceRate	float	Нет	Сумма страховой стоимости
InsuranceRateCurrency	string	Нет	Валюта страховой стоимости (по – умолчанию руб.)
DeclaredValueRate	float	Нет	Сумма объявленной стоимости
DeclaredValueRateCurrency	string	Нет	Валюта объявленной стоимости (по – умолчанию руб.)
ValueForCustomsPurposes	float	Нет	Таможенная стоимость груза
ValueForCustomsPurposesCurrency	string	Нет	GUID (Globally Unique Identifier) валюты таможенной стоимости груза (получение списка валют см. GetReferenceData: валюты); если не указано, то валюта – доллар
PackageID	string	Нет	Номер упаковки
COD	float	Нет	Сумма наложенного платежа. Плательщик всегда получатель. Только для ИМ. Заполняется из общей суммы за товары. Если передавали CustomerPrepayment, то COD заполняется, общая сумма за товары минус предоплата.
CODCurrency	string	Нет	GUID (Globally Unique Identifier) валюты наложенного платежа (получение списка валют см. GetReferenceData: валюты); если не указано, то валюта – рубли.
CustomerPrepayment	float	Нет	Сумма предоплаты за товар. Сумма предоплаты не может быть больше суммы за товары. Только для ИМ
CargoPackages	CargoPackages	Нет	Информация по грузовым местам

Описание параметра CargoPackages(тип CargoPackages)

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

Параметр	Тип	Обязательно	Описание
Length	float	Нет	Длина
Width	float	Нет	Ширина
Height	float	Нет	Высота
Package	string	Нет	GUID упаковки (packages)
Weight	float	Да	Вес груза
VolumeWeight	float	Нет	Объемный вес
PackageQty	string	Да	Количество груза
PackageID	string	Нет	Номер упаковки

Описание параметра Products (тип Products )

Описание товарных позиций отправления.

Обратите внимание, перед созданием накладной необходимо передать все используемые в ней товары (функция). Для передачи параметров Party и SerialNumber у товара должен быть установлен соответствующий признак учета.

Параметр	Тип	Обязательно	Описание
Article	string	Да	Артикул товара
Name	string	Нет	Наименование товара или его GUID в справочнике
Price	float	Нет	Цена за единицу товара. По-умолчанию 0.
PackageQty	int	Нет	Количество упаковок товара
Qty	int	Нет	Количество единиц товара (Пересчитывается из количества упаковок)
VATRate	int	Нет	Код ставки НДС (получение списка ставок см. GetReferenceData: ставки НДС: ставки НДС). -Если переданная ставка НДС отличается от ставки НДС в карточке товара, в документе запишутся данные из запроса. - Если передана ставка НДС «0%» или «Без НДС» – в документе записывается «Без НДС». - Если ставка НДС не передана, в создаваемом документе, ставка НДС для товара будет записана из карточки товара
AssessedValue	float	Нет	Оценочная стоимость товара
Comment	string	Нет	Комментарий к товару
SerialNumber	string	Нет	GUID серийного номера товара
UIN	string	Нет	GUID (Globally Unique Identifier) – УИН ювелирного изделия
Party	string	Нет	GUID партии товара

Описание параметра DeliveryOptions (тип DeliveryOptions)

Описание опций доставки

Параметр	Тип	Обязательно	Описание
CashOnDelivery	boolean	Нет	Признак наложенного платежа (true/false)

Описание параметра ClientCodes (тип ClientCodes)

Пользовательские коды

Параметр	Тип	Обязательно	Описание
Items	string	Нет	GUID или код
Info	string	Нет	Значение кода

Описание параметра ArrayOfDocumentsPhoto (тип ArrayOfDocumentsPhoto)

Параметр	Тип	Обязательно	Описание
Document	string	Нет	GUID типа документа
Required	boolean	Нет	Обязателен ли документ (true/false)

Описание параметра AdditionalServices (тип AdditionalServices)

Параметр	Тип	Обязательно	Описание
Items	string	Да	GUID дополнительной услуги
Qty	float	Нет	Количество, используется для передачи номера этажа

Описание параметра возвращаемого параметра return

Параметр	Тип	Обязательно	Описание
Error	boolean	Да	Флаг ошибки на уровне всего ответа. true — есть ошибка, false — успех
ErrorInfo	string	Нет	Общее сообщение об ошибке (если есть) или пустая строка
Items	Items	Нет	Параметр для описания одного результата операции. Может повторяться при создании нескольких накладных за один запрос (например, при нескольких отправлениях)

Описание параметра возвращаемого параметра Items

Структура Items

Параметр	Тип	Обязательно	Описание
Value	string	Нет	Номер созданной накладной (успешный случай) или код ошибки / идентификатор
Error	boolean	Да	Флаг ошибки для конкретной накладной. true — ошибка, false — успешно создана
ErrorInfo	string	Нет	Текст ошибки (если Error = true) или вспомогательная информация (например, ClientNumber из запроса).

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

XML

<?xml version="1.0" encoding="UTF-8"?>
<soap:Envelope
  xmlns:soap="http://www.w3.org/2003/05/soap-envelope"
  xmlns:ns1="http://www.cargo3.ru"
  xmlns:xs="http://www.w3.org/2001/XMLSchema"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <soap:Header />
  <soap:Body>
    <ns1:SaveWaybillOffice>
      <ns1:Language />
      <ns1:Login>test</ns1:Login>
      <ns1:Password>2016</ns1:Password>
      <ns1:Company />
      <ns1:Number />
      <ns1:ClientNumber>148704450</ns1:ClientNumber>
      <ns1:OrderData>
        <ns1:ClientContact />
        <ns1:DeliveryDate>2025-09-30T09:00:00</ns1:DeliveryDate>
        <ns1:Recipient>
          <ns1:Client>ТЕСТ</ns1:Client>
          <ns1:Official />
          <ns1:Address>
            <ns1:Geography>postcode-127018</ns1:Geography>
            <ns1:Info>АДРЕС ПОЛУЧАТЕЛЯ</ns1:Info>
            <ns1:FreeForm>true</ns1:FreeForm>
          </ns1:Address>
          <ns1:Phone>100</ns1:Phone>
          <ns1:Urgency>18c4f209-458b-11dc-9497-0015170f8c09</ns1:Urgency>
          <ns1:Cargo>
            <ns1:CargoPackageQty>1</ns1:CargoPackageQty>
            <ns1:Weight>1</ns1:Weight>
            <ns1:COD>6047.0</ns1:COD>
            <ns1:CustomerPrepayment>1.0</ns1:CustomerPrepayment>
          </ns1:Cargo>
          <ns1:Products>
            <ns1:Article>УТ-00727861</ns1:Article>
            <ns1:Name>5d93f941-bf99-11ea-aa80-005056bb6b60</ns1:Name>
            <ns1:Price>50.0</ns1:Price>
            <ns1:PackageQty>1</ns1:PackageQty>
          </ns1:Products>
          <ns1:Products>
            <ns1:Article>УТ-12915747</ns1:Article>
            <ns1:Name>74dbb15c-c039-11ea-ae8c-005056bb6b60</ns1:Name>
            <ns1:Price>1999.0</ns1:Price>
            <ns1:PackageQty>3</ns1:PackageQty>
          </ns1:Products>
        </ns1:Recipient>
        <ns1:Sender>
          <ns1:Client>ТЕСТ</ns1:Client>
          <ns1:Address>
            <ns1:Geography>cf862f56-442d-11dc-9497-0015170f8c09</ns1:Geography>
            <ns1:Info>АДРЕС ОТПРАВИТЕЛЯ</ns1:Info>
            <ns1:FreeForm>true</ns1:FreeForm>
          </ns1:Address>
          <ns1:Phone>1110</ns1:Phone>
        </ns1:Sender>
        <ns1:TakeDate>2025-09-01T09:00:00</ns1:TakeDate>
        <ns1:TypeOfCargo>4aab1fc6-fc2b-473a-8728-58bcd4ff79ba</ns1:TypeOfCargo>
        <ns1:TypeOfPayer>0</ns1:TypeOfPayer>
        <ns1:WayOfPayment>1</ns1:WayOfPayment>
        <ns1:DeliveryOfCargo>ДоставкаДоДверей</ns1:DeliveryOfCargo>
        <ns1:DeliveryDateOf>2025-09-30T18:00:00</ns1:DeliveryDateOf>
      </ns1:OrderData>
      <ns1:Office />
    </ns1:SaveWaybillOffice>
  </soap:Body>
</soap:Envelope>

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

XML

<soap:Envelope
  xmlns:soap="http://www.w3.org/2003/05/soap-envelope">
  <soap:Body>
    <m:SaveWaybillOfficeResponse
      xmlns:m="http://www.cargo3.ru">
      <m:return
        xmlns:xs="http://www.w3.org/2001/XMLSchema"
        xmlns:xsi="http://www.w3.org/2001/XMLSchemainstance">
        <m:Items>
          <m:Value>496-0106983-00001247</m:Value>
          <m:Error>false</m:Error>
          <m:ErrorInfo>148704450</m:ErrorInfo>
        </m:Items>
        <m:Error>false</m:Error>
        <m:ErrorInfo/>
      </m:return>
    </m:SaveWaybillOfficeResponse>
  </soap:Body>
</soap:Envelope>