Получение данных о накладной по её номеру

Описание: Функция WaybillInfo возвращает детальную информацию по накладной на момент запроса.

Информация по накладной включает:

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

Адрес сервиса: /ShipmentService.asmx

SOAP Action: [http://tempuri.org/WaybillInfo](http://tempuri.org/WaybillInfo)

1. Параметры запроса (Request)

Параметр	Описание в WSDL	Описание / Бизнес-смысл
`waybillNumber`	`minOccurs="0"`, `maxOccurs="1"` `type="string"`	Номер накладной МЭ

Пример SOAP-запроса (SOAP 1.1)

XML

POST /ShipmentService.asmx HTTP/1.1
Host: agents.major-express.ru
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://tempuri.org/WaybillInfo"

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
               xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
               xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Header>
    <TicketHeader xmlns="http://tempuri.org/">
      <Ticket>string</Ticket>
      <UserName>string</UserName>
      <CheckSum>int</CheckSum>
      <inRole>boolean</inRole>
    </TicketHeader>
  </soap:Header>
  <soap:Body>
    <WaybillInfo xmlns="http://tempuri.org/">
      <waybillNumber>string</waybillNumber>
    </WaybillInfo>
  </soap:Body>
</soap:Envelope>

Пример SOAP-запроса (SOAP 1.2)

XML

POST /ShipmentService.asmx HTTP/1.1
Host: agents.major-express.ru
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Header>
    <TicketHeader xmlns="http://tempuri.org/">
      <Ticket>string</Ticket>
      <UserName>string</UserName>
      <CheckSum>int</CheckSum>
      <inRole>boolean</inRole>
    </TicketHeader>
  </soap12:Header>
  <soap12:Body>
    <WaybillInfo xmlns="http://tempuri.org/">
      <waybillNumber>string</waybillNumber>
    </WaybillInfo>
  </soap12:Body>
</soap12:Envelope>

2. Параметры ответа (Response)

2.1. Статус выполнения (Верхний уровень)

Параметр	Описание в WSDL	Описание
`ResCode`	`minOccurs="1"` `maxOccurs="1"` `nillable="true"` `type="int"`	Код результата выполнения запроса
`ResText`	`minOccurs="0"` `maxOccurs="1"` `type="string"`	Текстовое сообщение ошибки / успеха
`WBInfo`	`minOccurs="0"` `maxOccurs="1"` `type="tns:WaybillInfo"`	Комплексный объект информации о накладной

2.2. WBInfo.Header — Основные данные

Параметр	Описание в WSDL	Описание
`WBNumber`	`minOccurs="0"` `maxOccurs="1"` `type="string"`	Номер накладной МЭ
`ExternalReference`	`minOccurs="0"` `maxOccurs="1"` `type="tns:ExternalReference"`	Дополнительные связанные номера:
↳ `WBOldNumber`	`minOccurs="0"` `maxOccurs="1"` `type="string"`	Отметка клиента (номер №2)
↳ `FedexNum`	`minOccurs="0"` `maxOccurs="1"` `type="string"`	Номер международной накладной
↳ `WBReturnNumber`	`minOccurs="0"` `maxOccurs="1"` `type="string"`	Номер возвратной накладной
↳ `PackageNumber`	`minOccurs="0"` `maxOccurs="1"` `type="string"`	Номер упаковки для одноместного отправления
`Status`	`minOccurs="0"` `maxOccurs="1"` `type="tns:WaybillStatusLookUp"`	Статус накладной:
↳ `Code`	`minOccurs="1"` `maxOccurs="1"` `type="unsignedByte"`	Код статуса накладной
↳ `Name`	`minOccurs="0"` `maxOccurs="1"` `type="string"`	Наименование статуса
`DeliveryRequirements`	`minOccurs="0"` `maxOccurs="1"` `type="tns:DeliveryRequirements"`	Требования к доставке:
↳ `SpecialDeliveryConditions`	`minOccurs="0"` `maxOccurs="1"` `type="tns:ArrayOfDeliveryFeatures"`	Особые условия доставки и дополнительные услуги
↳ `IsShippmentGuaranted`	`minOccurs="1"` `maxOccurs="1"` `type="boolean"`	Параметр в разработке, временно нерабочий, возвращает всегда false
↳ `IsNeedGuarantee`	`minOccurs="1"` `maxOccurs="1"` `type="boolean"`	Параметр в разработке, временно нерабочий, возвращает всегда false
↳ `IsNeedScan`	`minOccurs="1"` `maxOccurs="1"` `type="boolean"`	Нужен скан с подписью получателя
`WaybillMetaData`	`minOccurs="0"` `maxOccurs="1"` `type="tns:WaybillMetaData"`	Служебная информация:
↳ `Comments`	`minOccurs="0"` `maxOccurs="1"` `type="string"`	Комментарии к накладной
↳ `ReturnAddress`	`minOccurs="0"` `maxOccurs="1"` `type="string"`	Адрес переадресации / возврата
↳ `SpecialRemarks`	`minOccurs="0"` `maxOccurs="1"` `type="string"`	Особые отметки для печати
↳ `Submitter`	`minOccurs="0"` `maxOccurs="1"` `type="string"`	Кто принял груз
↳ `Courier`	`minOccurs="0"` `maxOccurs="1"` `type="string"`	Кто доставил груз
`WBOpenDate`	`minOccurs="1"` `maxOccurs="1"` `nillable="true"` `type="dateTime"`	Дата печати\забора накладной
`ExpectedDeliveryDate`	`minOccurs="1"` `maxOccurs="1"` `nillable="true"` `type="dateTime"`	Расчётная дата доставки
`WBCloseDate`	`minOccurs="1"` `maxOccurs="1"` `nillable="true"` `type="dateTime"`	Дата доставки

2.3. WBInfo.Route — Маршрут и участники

Параметр	Описание в WSDL	Описание
`Shipper`	`minOccurs="0"` `maxOccurs="1"` `type="tns:Shipper"`	Данные отправителя:
↳ `Address.CountryCode`	`minOccurs="1"` `maxOccurs="1"` `type="short"`	Код страны отправителя
↳ `Address.CountryName`	`minOccurs="0"` `maxOccurs="1"` `type="string"`	Страна отправителя
↳ `Address.PostalCode`	`minOccurs="0"` `maxOccurs="1"` `type="string"`	Почтовый индекс отправителя
↳ `Address.CityCode`	`minOccurs="1"` `maxOccurs="1"` `type="int"`	Код города отправителя
↳ `Address.CityName`	`minOccurs="0"` `maxOccurs="1"` `type="string"`	Название города отправителя
↳ `Address.Address`	`minOccurs="0"` `maxOccurs="1"` `type="string"`	Адрес отправителя
↳ `Agent.Code`	`minOccurs="1"` `maxOccurs="1"` `type="short"`	Код Агента отправителя
↳ `Agent.Name`	`minOccurs="0"` `maxOccurs="1"` `type="string"`	Название Агента отправителя
`Consignee`	`minOccurs="0"` `maxOccurs="1"` `type="tns:Consignee"`	Данные получателя:
↳ `Address.CountryCode`	`minOccurs="1"` `maxOccurs="1"` `type="short"`	Код страны получателя
↳ `Address.CountryName`	`minOccurs="0"` `maxOccurs="1"` `type="string"`	Страна получателя
↳ `Address.PostalCode`	`minOccurs="0"` `maxOccurs="1"` `type="string"`	Почтовый индекс получателя
↳ `Address.CityCode`	`minOccurs="1"` `maxOccurs="1"` `type="int"`	Код города получателя
↳ `Address.CityName`	`minOccurs="0"` `maxOccurs="1"` `type="string"`	Название города получателя
↳ `Address.Address`	`minOccurs="0"` `maxOccurs="1"` `type="string"`	Адрес получателя
↳ `Agent.Code`	`minOccurs="1"` `maxOccurs="1"` `type="short"`	Код Агента получателя
↳ `Agent.Name`	`minOccurs="0"` `maxOccurs="1"` `type="string"`	Название Агента получателя
`RouteConfig`	`minOccurs="0"` `maxOccurs="1"` `type="tns:RouteConfig"`	Конфигурация маршрута:
↳ `IsTransitMoscow`	`minOccurs="1"` `maxOccurs="1"` `type="boolean"`	Транзит через Москву\Прямая перевозка
↳ `IsInternationalConsignee`	`minOccurs="1"` `maxOccurs="1"` `type="boolean"`	Признак международного получателя

2.4. WBInfo.CargoInfo — Параметры груза

Параметр	Описание в WSDL	Описание
`Description`	`minOccurs="0"` `maxOccurs="1"` `type="string"`	Описание вложений
`PlaceCount`	`minOccurs="1"` `maxOccurs="1"` `type="short"`	Количество мест в накладной
`Weight`	`minOccurs="1"` `maxOccurs="1"` `type="double"`	Вес груза (кг)
`Length`	`minOccurs="1"` `maxOccurs="1"` `nillable="true"` `type="double"`	Длина (см)
`Width`	`minOccurs="1"` `maxOccurs="1"` `nillable="true"` `type="double"`	Ширина (см)
`Height`	`minOccurs="1"` `maxOccurs="1"` `nillable="true"` `type="double"`	Высота (см)
`Volume`	`minOccurs="1"` `maxOccurs="1"` `nillable="true"` `type="double"`	Объемный вес / Объем
`Cost_RUR`	`minOccurs="1"` `maxOccurs="1"` `type="decimal"`	Объявленная ценность (руб.)
`PackageType`	`minOccurs="1"` `maxOccurs="1"` `type="unsignedByte"`	Код типа упаковки

2.5. WBInfo.PaymentInfo — Информация об оплате

Параметр	Описание в WSDL	Описание
`Payer`	`minOccurs="0"` `maxOccurs="1"` `type="tns:Payer"`	Плательщик:
↳ `PayerCode`	`minOccurs="1"` `maxOccurs="1"` `type="int"`	Номер плательщика (клиентский номер)
↳ `ClientName`	`minOccurs="0"` `maxOccurs="1"` `type="string"`	Название Клиента-плательщика
`WhoWillPay`	`minOccurs="1"` `maxOccurs="1"` `type="unsignedByte"`	Код стороны оплаты: 1 - отправитель 2 - получатель 3 - 3-я сторона
`PaymentType`	`minOccurs="1"` `maxOccurs="1"` `type="unsignedByte"`	Код типа оплаты 1 - Нал 2 - Б\нал
`CalcWeightAgent`	`minOccurs="1"` `maxOccurs="1"` `type="double"`	Расчетный вес для агента
`CalcWeightClient`	`minOccurs="1"` `maxOccurs="1"` `type="double"`	Расчетный вес для клиента
`Insurance_USD`	`minOccurs="1"` `maxOccurs="1"` `type="double"`	Стоимость страховки (USD)
`Insurance_RUR`	`minOccurs="1"` `maxOccurs="1"` `type="double"`	Стоимость страховки (руб.)
`Freight_USD`	`minOccurs="1"` `maxOccurs="1"` `type="double"`	Стоимость перевозки (USD)
`Freight_RUR`	`minOccurs="1"` `maxOccurs="1"` `type="double"`	Стоимость перевозки (руб.)
`AddService_RUR`	`minOccurs="1"` `maxOccurs="1"` `type="double"`	Стоимость доп. услуг (руб.)

2.6. WBInfo.Places — Информация о грузовых местах

Список элементов PlaceModel (minOccurs="0", maxOccurs="unbounded"):

Параметр	Описание в WSDL	Описание
`PlaceNumber`	`minOccurs="0"` `maxOccurs="1"` `type="string"`	Номер грузового места
`Weight`	`minOccurs="1"` `maxOccurs="1"` `type="double"`	Физический вес места (кг)
`Width`	`minOccurs="1"` `maxOccurs="1"` `nillable="true"` `type="double"`	Ширина места (см)
`Length`	`minOccurs="1"` `maxOccurs="1"` `nillable="true"` `type="double"`	Длина места (см)
`Height`	`minOccurs="1"` `maxOccurs="1"` `nillable="true"` `type="double"`	Высота места (см)
`Volume`	`minOccurs="1"` `maxOccurs="1"` `nillable="true"` `type="double"`	Объемный вес места (кг)

Пример SOAP-ответа (SOAP 1.1)

XML

HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
               xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
               xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <WaybillInfoResponse xmlns="http://tempuri.org/">
      <WaybillInfoResult>
        <ResCode>0</ResCode>
        <ResText>Успешно</ResText>
        <WBInfo>
          <Header>
            <WBNumber>1244946107</WBNumber>
            <ExternalReference>
              <WBOldNumber>ORD-2026-99</WBOldNumber>
              <FedexNum>7738291029</FedexNum>
              <WBReturnNumber></WBReturnNumber>
              <PackageNumber>PKG-01</PackageNumber>
            </ExternalReference>
            <Status>
              <Code>5</Code>
              <Name>Доставлено</Name>
            </Status>
            <DeliveryRequirements>
              <IsShippmentGuaranted>true</IsShippmentGuaranted>
              <IsNeedGuarantee>false</IsNeedGuarantee>
              <IsNeedScan>true</IsNeedScan>
            </DeliveryRequirements>
            <WaybillMetaData>
              <Comments>Хрупкий груз</Comments>
              <ReturnAddress></ReturnAddress>
              <SpecialRemarks>Печать на лицевой стороне</SpecialRemarks>
              <Submitter>Иванов И.И.</Submitter>
              <Courier>Петров П.П.</Courier>
            </WaybillMetaData>
            <WBOpenDate>2026-08-01T10:00:00</WBOpenDate>
            <ExpectedDeliveryDate>2026-08-05T18:00:00</ExpectedDeliveryDate>
            <WBCloseDate>2026-08-04T14:20:00</WBCloseDate>
          </Header>
          <Route>
            <Shipper>
              <Address>
                <CountryCode>643</CountryCode>
                <CountryName>Россия</CountryName>
                <PostalCode>101000</PostalCode>
                <CityCode>77</CityCode>
                <CityName>Москва</CityName>
                <Address>ул. Ленина, д. 1</Address>
              </Address>
              <Agent>
                <Code>10</Code>
                <Name>МЭ Москва</Name>
              </Agent>
            </Shipper>
            <Consignee>
              <Address>
                <CountryCode>643</CountryCode>
                <CountryName>Россия</CountryName>
                <PostalCode>190000</PostalCode>
                <CityCode>78</CityCode>
                <CityName>Санкт-Петербург</CityName>
                <Address>Невский пр., д. 10</Address>
              </Address>
              <Agent>
                <Code>20</Code>
                <Name>МЭ СПб</Name>
              </Agent>
            </Consignee>
            <RouteConfig>
              <IsTransitMoscow>false</IsTransitMoscow>
              <IsInternationalConsignee>false</IsInternationalConsignee>
            </RouteConfig>
          </Route>
          <CargoInfo>
            <Description>Запчасти</Description>
            <PlaceCount>1</PlaceCount>
            <Weight>2.5</Weight>
            <Length>30</Length>
            <Width>20</Width>
            <Height>15</Height>
            <Volume>1.8</Volume>
            <Cost_RUR>15000.00</Cost_RUR>
            <PackageType>1</PackageType>
          </CargoInfo>
          <PaymentInfo>
            <Payer>
              <PayerCode>12345</PayerCode>
              <ClientName>ООО Рога и Копыта</ClientName>
            </Payer>
            <WhoWillPay>1</WhoWillPay>
            <PaymentType>1</PaymentType>
            <CalcWeightAgent>2.5</CalcWeightAgent>
            <CalcWeightClient>2.5</CalcWeightClient>
            <Insurance_USD>0</Insurance_USD>
            <Insurance_RUR>150.00</Insurance_RUR>
            <Freight_USD>0</Freight_USD>
            <Freight_RUR>850.00</Freight_RUR>
            <AddService_RUR>0</AddService_RUR>
          </PaymentInfo>
          <SpecialDeliveryConditions />
          <Places>
            <PlaceModel>
              <PlaceNumber>1244946107001</PlaceNumber>
              <Weight>2.5</Weight>
              <Width>20</Width>
              <Length>30</Length>
              <Height>15</Height>
              <Volume>1.8</Volume>
            </PlaceModel>
          </Places>
        </WBInfo>
      </WaybillInfoResult>
    </WaybillInfoResponse>
  </soap:Body>
</soap:Envelope>

Пример SOAP-ответа (SOAP 1.2)

XML

HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <WaybillInfoResponse xmlns="http://tempuri.org/">
      <WaybillInfoResult>
        <ResCode>int</ResCode>
        <ResText>string</ResText>
        <WBInfo>
          <Header>
            <WBNumber>string</WBNumber>
            <ExternalReference xsi:nil="true" />
            <Status xsi:nil="true" />
            <DeliveryRequirements xsi:nil="true" />
            <WaybillMetaData xsi:nil="true" />
            <WBOpenDate>dateTime</WBOpenDate>
            <ExpectedDeliveryDate>dateTime</ExpectedDeliveryDate>
            <WBCloseDate>dateTime</WBCloseDate>
          </Header>
          <Route>
            <Shipper xsi:nil="true" />
            <Consignee xsi:nil="true" />
            <RouteConfig xsi:nil="true" />
          </Route>
          <CargoInfo>
            <Description>string</Description>
            <PlaceCount>short</PlaceCount>
            <Weight>double</Weight>
            <Length>double</Length>
            <Width>double</Width>
            <Height>double</Height>
            <Volume>double</Volume>
            <Cost_RUR>decimal</Cost_RUR>
            <PackageType>unsignedByte</PackageType>
          </CargoInfo>
          <PaymentInfo>
            <Payer xsi:nil="true" />
            <WhoWillPay>unsignedByte</WhoWillPay>
            <PaymentType>unsignedByte</PaymentType>
            <CalcWeightAgent>double</CalcWeightAgent>
            <CalcWeightClient>double</CalcWeightClient>
            <Insurance_USD>double</Insurance_USD>
            <Insurance_RUR>double</Insurance_RUR>
            <Freight_USD>double</Freight_USD>
            <Freight_RUR>double</Freight_RUR>
            <AddService_RUR>double</AddService_RUR>
          </PaymentInfo>
          <SpecialDeliveryConditions>
            <DeliveryFeatures xsi:nil="true" />
            <DeliveryFeatures xsi:nil="true" />
          </SpecialDeliveryConditions>
          <Places>
            <PlaceModel xsi:nil="true" />
            <PlaceModel xsi:nil="true" />
          </Places>
        </WBInfo>
      </WaybillInfoResult>
    </WaybillInfoResponse>
  </soap12:Body>
</soap12:Envelope>