Метод устарел.
Был заменён на метод:
Получение данных о накладной по её номеру (текущее состояние)
WaybillInfo
и
Получение данных о накладной по её номеру с полной историей событий
WaybillInfoWithHistory
Обоснование замены:
| Критерий | me_FullInvoce | WaybillInfo / WaybillInfoWithHistory | Почему новый метод лучше |
|---|---|---|---|
| Структура модели | Плоский список из множества полей | Данные сгруппированы в логические объекты (Header, Route, CargoInfo, PaymentInfo) | Контракт легче понимать и анализировать |
| Объектное моделирование | Напоминает результат большого SQL-запроса | Модель отражает реальные бизнес-сущности | API ближе к предметной области |
| Композиция объектов | Почти отсутствует | Накладная состоит из вложенных объектов | Модель становится более естественной и расширяемой |
| Связность (Cohesion) | Связанные данные разбросаны по всему контракту | Данные одной сущности находятся вместе | Проще сопровождать и находить нужную информацию |
| Расширяемость | Новые поля увеличивают общий список | Новые свойства добавляются в соответствующий объект | Изменения локализованы и меньше влияют на остальные части контракта |
| Читаемость | Большое количество однотипных полей (Shipper*, Consignee*, WB*) | Чёткая иерархия объектов | Контракт проще воспринимать визуально |
| Типизация | Есть числовые значения, представленные как string | Используются подходящие типы (double, decimal, dateTime) | Уменьшается вероятность ошибок при обработке данных |
| История событий | История встроена в общий ответ | В WaybillInfoWithHistory выделена в отдельный раздел History | История логически отделена от основной информации |
| Производительность | Всегда возвращает полный объём данных | Можно выбрать: с историей или без неё | Клиент получает только необходимые данные |
| Поддерживаемость | При развитии контракт быстро разрастается | Изменения чаще затрагивают отдельные разделы модели | Контракт проще сопровождать в долгосрочной перспективе |
Бывшее местоположение: Major Express Wiki > WEB-СЕРВИСЫ > WEB-СЕРВИС АГЕНТСКИЙ > ЭКСПРЕСС-ДОСТАВКА > МЕТОДЫ > НАКЛАДНАЯ > Информация по накладной с детализацией по местам
Функция me_FullInvoce возвращает полную информацию по накладной, включая ИСТОРИЮ СОБЫТИЙ, ДАННЫЕ ОТПРАВИТЕЛЯ, ПОЛУЧАТЕЛЯ, ПАРАМЕТРЫ ГРУЗА
Полный портрет накладной
ОПИСАНИЕ ПАРАМЕТРОВ ЗАПРОСА
| ПАРАМЕТРЫ | ОПИСАНИЕ В WSDL | ОПИСАНИЕ |
| MajorNumber | minOccurs=”0” maxOccurs=”1” type=”string“ | номер накладной МЭ |
POST /manifest.asmx HTTP/1.1
Host: agents.major-express.ru
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://tempuri.org/me_FullInvoce"
<?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>
<me_FullInvoce xmlns="http://tempuri.org/">
<MajorNumber>string</MajorNumber>
</me_FullInvoce>
</soap:Body>
</soap:Envelope>ОПИСАНИЕ ПАРАМЕТРОВ ОТВЕТА
| Параметр | Описание в WSDL | Описание |
| ResCode | minOccurs="1" maxOccurs="1" type="int" | код ответа |
| ResText | minOccurs="0" maxOccurs="1" type="string" | текст ответа |
| WBNumber | minOccurs="0" maxOccurs="1" type="string" | номер накладной МЭ |
| WBOpenDate | minOccurs="1" maxOccurs="1" nillable="true" type="dateTime" | дата, время ввода накладной МЭ |
| WBOldNumber | minOccurs="0" maxOccurs="1" type="string" | накладная №2 (клиентская информация) |
| FedexNum | minOccurs="0" maxOccurs="1" type="string" | номер FedEx для международных перевозок |
| Client_Name | minOccurs="0" maxOccurs="1" type="string" | название Клиента |
| PayerCode | minOccurs="1" maxOccurs="1" nillable="true" type="int" | номер плательщика (клиентский номер МЭ) |
| ShipperLastName | minOccurs="0" maxOccurs="1" type="s:string" | ФИО отправителя |
| ShipperCompany | minOccurs="0" maxOccurs="1" type="s:string" | организация отправитель |
| ShipperCountry | minOccurs="0" maxOccurs="1" type="string" | страна отправления |
| ShipperCountryCode | minOccurs="1" maxOccurs="1" nillable="true" type="short" | код страны отправителя |
| ShipperPhone | minOccurs="0" maxOccurs="1" type="string" | телефон Отправителя |
| ShipperPostIndex | minOccurs="0" maxOccurs="1" type="string" | почтовый индекс отправителя |
| ShipperAdres | minOccurs="0" maxOccurs="1" type="string" | адрес отправителя |
| ShipperCityCode | minOccurs="1" maxOccurs="1" nillable="true" type="int" | код города отправителя |
| ShipperCity_Name | minOccurs="0" maxOccurs="1" type="string" | название города отправителя |
| ShipperAgentCode | minOccurs="1" maxOccurs="1" type="short" | код Агента отправителя |
| ConsigneeLastName | minOccurs="0" maxOccurs="1" type="string" | ФИО получателя |
| ConsigneeCompany | minOccurs="0" maxOccurs="1" type="string" | организация получатель |
| ConsigneeAdres | minOccurs="0" maxOccurs="1" type="string" | адрес получателя |
| ConsigneePhone | minOccurs="0" maxOccurs="1" type="string" | телефон получателя |
| ConsigneePostIndex | minOccurs="0" maxOccurs="1" type="string" | почтовый индекс получателя |
| ConsigneeCityCode | minOccurs="1" maxOccurs="1" nillable="true" type="int" | код города получателя |
| ConsigneeCity_Name | minOccurs="0" maxOccurs="1" type="string" | название города получателя |
| ConsigneeAgentCode | minOccurs="1" maxOccurs="1" type="short" | код Агента получателя |
| ConsigneeCountry | minOccurs="0" maxOccurs="1" type="string" | страна получателя |
| ConsigneeCountryCode | minOccurs="1" maxOccurs="1" nillable="true" type="short" | код страны получателя |
| WBPackage | minOccurs="1" maxOccurs="1" nillable="true" type="short" | количество мест в накладной |
| WBWeight | minOccurs="1" maxOccurs="1" type="float" | вес груза (кг) |
| WBPackageType | minOccurs="1" maxOccurs="1" nillable="true" type="unsignedByte" | код типа упаковки |
| WbLength | minOccurs="0" maxOccurs="1" type="string" | длина (см) |
| WbWidth | minOccurs="0" maxOccurs="1" type="string" | ширина (см) |
| WbHeight | minOccurs="0" maxOccurs="1" type="string" | высота (см) |
| WBVolumeWeight | minOccurs="1" maxOccurs="1" nillable="true" type="float" | объемный вес груза (кг) |
| WBCost | minOccurs="1" maxOccurs="1" type="float" | объявленная ценность в рублях (не может быть отрицательной или нулевой, а также превышать 100.000.000 рублей) |
| MoneyType | minOccurs="0" maxOccurs="1" type="string" | валюта объявленной стоимости |
| WhoWillPay | minOccurs="1" maxOccurs="1" nillable="true" type="unsignedByte" | код стороны оплаты 1 - отправитель, 2 - получатель, 3 - я сторона |
| PaymentSide | minOccurs="0" maxOccurs="1" type="string" | кто платит (отправитель, получатель,3-я сторона) |
| PaymentType | minOccurs="1" maxOccurs="1" nillable="true" type="unsignedByte" | код типа оплаты |
| PaymentType_Name | minOccurs="0" maxOccurs="1" type="string" | название типа оплаты |
| Comments | minOccurs="0" maxOccurs="1" type="string" | комментарии |
| WBCloseDate | minOccurs="1" maxOccurs="1" nillable="true" type="dateTime" | дата доставки |
| WBCloseTime | minOccurs="0" maxOccurs="1" type="string" | время доставки |
| Submitter | minOccurs="0" maxOccurs="1" type="string" | принял груз |
| Courier | minOccurs="0" maxOccurs="1" type="string" | доставил груз |
| Insurance_USD | minOccurs="1" maxOccurs="1" nillable="true" type="double" | стоимость страховки (USD) |
| Freight_USD | minOccurs="1" maxOccurs="1" nillable="true" type="double" | стоимость перевозки (USD) |
| Freight_RUR | minOccurs="1" maxOccurs="1" nillable="true" type="double" | стоимость перевозки (руб.) |
| Insurance_RUR | minOccurs="1" maxOccurs="1" nillable="true" type="double" | стоимость страховки (руб.) |
| TransitMoscow | minOccurs="1" maxOccurs="1" type="int" | транзит через Москву |
| FreightType | minOccurs="1" maxOccurs="1" type="boolean" | тип перевозки |
| WBDescription | minOccurs="0" maxOccurs="1" type="string" | описание вложений |
| ReAddr | minOccurs="0" maxOccurs="1" type="string" | комментарии (переадресация) |
| NaklStatusId | minOccurs="1" maxOccurs="1" type="unsignedByte" | код статуса накладной |
| NaklStatus | minOccurs="0" maxOccurs="1" type="string" | название статуса накладной |
| SpecialDelivConditions | minOccurs="0" maxOccurs="1" nillable="true" type="string" | спец. условия доставки |
| IsNeedScan | minOccurs="1" maxOccurs="1" type="boolean" | нужен ли скан |
| SpecialDeliveryConditions | minOccurs="0" maxOccurs="1" type="tns:ArrayOfSpecialDeliveryCondition" | перечень спец. условий доставки |
| WbReturnNumber | minOccurs="0" maxOccurs="1" type="string" | номер возвращаемой накладной |
| Agents | minOccurs="0" maxOccurs="1" type="tns:ArrayOfAgent" | информация об агенте отправителе |
| Agents1 | minOccurs="0" maxOccurs="1" type="tns:ArrayOfAgent" | информация об агенте получателя |
| HistoryEvents | minOccurs="0" maxOccurs="1" type="tns:ArrayOfHistoryEvent" | события истории |
| Places | minOccurs="0" maxOccurs="1" type="tns:ArrayOfPlace" | информация по грузовым местам |
| SpecialRemarks | minOccurs="0" maxOccurs="1" type="string" | особые отметки для печати |
| ExpectedDeliveryDate | minOccurs="1" maxOccurs="1" nillable="true" type="dateTime" | расчетная дата доставки |
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>
<me_FullInvoceResponse xmlns="http://tempuri.org/">
<me_FullInvoceResult>
<WBNumber>string</WBNumber>
<WBOpenDate>dateTime</WBOpenDate>
<WBOldNumber>string</WBOldNumber>
<FedexNum>string</FedexNum>
<Client_Name>string</Client_Name>
<PayerCode>int</PayerCode>
<ShipperLastName>string</ShipperLastName>
<ShipperPhone>string</ShipperPhone>
<ShipperCompany>string</ShipperCompany>
<ShipperPostIndex>string</ShipperPostIndex>
<ShipperAdres>string</ShipperAdres>
<ShipperCityCode>int</ShipperCityCode>
<ShipperCity_Name>string</ShipperCity_Name>
<ShipperAgentCode>short</ShipperAgentCode>
<ShipperCountryCode>short</ShipperCountryCode>
<ShipperCountry>string</ShipperCountry>
<ConsigneeLastName>string</ConsigneeLastName>
<ConsigneePhone>string</ConsigneePhone>
<ConsigneeCompany>string</ConsigneeCompany>
<ConsigneePostIndex>string</ConsigneePostIndex>
<ConsigneeAdres>string</ConsigneeAdres>
<ConsigneeCountryCode>short</ConsigneeCountryCode>
<ConsigneeCountry>string</ConsigneeCountry>
<ConsigneeCityCode>int</ConsigneeCityCode>
<ConsigneeCity_Name>string</ConsigneeCity_Name>
<ConsigneeAgentCode>short</ConsigneeAgentCode>
<WBWeight>string</WBWeight>
<WBPackage>short</WBPackage>
<WBPackageType>unsignedByte</WBPackageType>
<WBLength>string</WBLength>
<WBWidth>string</WBWidth>
<WBHeight>string</WBHeight>
<WBVolumeWeight>float</WBVolumeWeight>
<PaymentType>unsignedByte</PaymentType>
<PaymentType_Name>string</PaymentType_Name>
<WhoWillPay>unsignedByte</WhoWillPay>
<PaymentSide>string</PaymentSide>
<WBCost>string</WBCost>
<MoneyType>string</MoneyType>
<WBDescription>string</WBDescription>
<Comments>string</Comments>
<ReAddr>string</ReAddr>
<WBCloseDate>dateTime</WBCloseDate>
<WBCloseTime>string</WBCloseTime>
<Submitter>string</Submitter>
<Courier>string</Courier>
<Insurance_USD>double</Insurance_USD>
<Insurance_RUR>double</Insurance_RUR>
<Freight_USD>double</Freight_USD>
<Freight_RUR>double</Freight_RUR>
<TransitMoscow>int</TransitMoscow>
<FreightType>boolean</FreightType>
<NaklStatusId>unsignedByte</NaklStatusId>
<NaklStatus>string</NaklStatus>
<SpecialDelivConditions>unsignedByte</SpecialDelivConditions>
<IsNeedScan>int</IsNeedScan>
<Agents>
<Agent>
<AgentCode>short</AgentCode>
<AgentNameRus>string</AgentNameRus>
<AgentTel>string</AgentTel>
</Agent>
<Agent>
<AgentCode>short</AgentCode>
<AgentNameRus>string</AgentNameRus>
<AgentTel>string</AgentTel>
</Agent>
</Agents>
<Agents1>
<Agent>
<AgentCode>short</AgentCode>
<AgentNameRus>string</AgentNameRus>
<AgentTel>string</AgentTel>
</Agent>
<Agent>
<AgentCode>short</AgentCode>
<AgentNameRus>string</AgentNameRus>
<AgentTel>string</AgentTel>
</Agent>
</Agents1>
<HistoryEvents>
<HistoryEvent>
<WBNumber>string</WBNumber>
<EventNum>unsignedByte</EventNum>
<Event_Name>string</Event_Name>
<DateCreate>dateTime</DateCreate>
<CityCode>int</CityCode>
<City_Name>string</City_Name>
<AgentCode>short</AgentCode>
<Agent_Name>string</Agent_Name>
<EventDate>string</EventDate>
<EventTime>string</EventTime>
<Comments>string</Comments>
</HistoryEvent>
<HistoryEvent>
<WBNumber>string</WBNumber>
<EventNum>unsignedByte</EventNum>
<Event_Name>string</Event_Name>
<DateCreate>dateTime</DateCreate>
<CityCode>int</CityCode>
<City_Name>string</City_Name>
<AgentCode>short</AgentCode>
<Agent_Name>string</Agent_Name>
<EventDate>string</EventDate>
<EventTime>string</EventTime>
<Comments>string</Comments>
</HistoryEvent>
</HistoryEvents>
<Places>
<Place>
<WBNumber>string</WBNumber>
<MPS>string</MPS>
<Weight>double</Weight>
<Width>double</Width>
<Length>double</Length>
<Height>double</Height>
<VolWeight>double</VolWeight>
<IsPackage>boolean</IsPackage>
</Place>
<Place>
<WBNumber>string</WBNumber>
<MPS>string</MPS>
<Weight>double</Weight>
<Width>double</Width>
<Length>double</Length>
<Height>double</Height>
<VolWeight>double</VolWeight>
<IsPackage>boolean</IsPackage>
</Place>
</Places>
<SpecialDeliveryConditions>
<SpecialDeliveryCondition TypeId="int" />
<SpecialDeliveryCondition TypeId="int" />
</SpecialDeliveryConditions>
<WBReturnNumber>string</WBReturnNumber>
<SpecialRemarks>string</SpecialRemarks>
</me_FullInvoceResult>
</me_FullInvoceResponse>
</soap:Body>
</soap:Envelope>