Book creator

Удалить страницу из книги

Показать или изменить шаблон книги (0 страниц(ы))

Помощь

Содержание

AddReserve
- Описание

AddReserve

Описание

Метод используется для размещения резерва в системе MОНТ. Объект, принимаемый на вход, содержит в себе номер телефона конечного пользователя, на который будут отправлены ключи и список строк резерва. Каждая строка соответствует одной заказываемой позиции. В ней описывается:

партномер заказываемого товара;
количество;
заполненная лицензионная форма с данными о конечном пользователе;
РРЦ конечного пользователя

Дополнительная информация

В поле DomainPrefix можно указывать коды филиалов. При формировании заказов на стороне МОНТ номера заказов будут включать этот префикс по правилу: DomainPrefix+«-Reserve»+Номер_резерва

Ограничения

С помощью данного метода нельзя создавать резервы на товары типа «Подписка»

Входные параметры

Тип OrderReserveContract

Название	Тип	Описание
Phone	string	Номер телефона конечного пользователя.
ReseveLines	array of OrderReserveLineContract	Массив, содержащий все строки данного резерва
OrderPrefix	string	Префикс заказа. Выходной заказ будет иметь номер OrderPrefix-reserve<номер резерва>. Строки заказа будут иметь номера:OrderPrefix-reserve<номер резерва>-<номер строки в заказе>
ReceiptId	string	Номер чека

Тип OrderReserveLineContract

Название	Тип	Описание
PartNum	string	Партномер заказываемого товара/услуги
Quantity	int	Количество заказываемых позиций
EndUserInfo	EndUserInfoContract	Данные о конечном пользователе. Необязательное поле - его необходимо заполнять, только если для продукта это требуется. Информация о необходимости лиц. формы содержится в прайсе, в поле «LicenseFormRequired»
EndUserPrice	decimal	Цена для конечного пользователя (РРЦ)
CurrencyCode	string	Код валюты РРЦ

Тип EndUserInfoContract

Название	Тип	Описание
Fields	array of EndUserInfoFieldContract	Список полей лицензионной формы конечного пользователя

Возвращаемое значение

Название	Тип	Описание
Reserved	bool	Удалось ли создать резерв. Если = false, то резерв не создан, его номер будет равен 0 в ответе
ReserveNum	string	Номер резерва. Если номер = 0, то резерв не был создан
ReservedLines	array of OrderReserveResultLineContract	Список строк резерва

Тип OrderReserveResultLineContract

Название	Тип	Описание
PartNum	string	Партномер
ReservedQuantity	int	Сколько ключей можно зарезервировать
RequestedQuantity	int	Сколько ключей изначально запрашивали

Возможные ошибки

Код	Текст ошибки
2	Продукт не найден
6	Превышен кредитный лимит
10	Продукт заблокирован
12	Лицензионная форма не передана
16	Реселлер заблокирован
17	Количество задано не верно
25	Неверный формат номера строки заказа. Для продуктов Microsoft номер строки не должен превышать 32 символов.
45	Отсутствуют строки резерва в заказе
200	Incorrect EndUserInfo Data
46	Can't Reserve Subscription
53	End User Price Missmatch - Указана неверная цена конечного пользователя
6009	ReservesForbidden - пользователю запрещено создавать резервы

Примеры запросов и ответов метода AddReserve

Запрос XmlOverHttp без лицензионной формы

POST https://sandbox.mont.ru/Version2/Service/B2BServiceV2Xml.svc/AddReserve

<?xml version="1.0" encoding="utf-8"?>
<OrderReserveContract>
 <OrderPrefix>Myshop</OrderPrefix> 
  <Phone>9101112233</Phone>
   <ReseveLines>
     <OrderReserveLineContract>
      <EndUserInfo />            
      <PartNum>6GQ-00084</PartNum>
      <Quantity>1</Quantity>
      <EndUserPrice>4399.00</EndUserPrice>
      <CurrencyCode>RUR</CurrencyCode>
    </OrderReserveLineContract>
   </ReseveLines>
  </OrderReserveContract>

Ответ XmlOverHttp (без лицензионной формы)

<?xml version="1.0" encoding="utf-8"?>
<AddReserveResponse xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <AddReserveResult>
        <Data>
            <Reserved>true</Reserved>
            <ReserveNum>2081</ReserveNum>
            <ReservedLines>
                <OrderReserveResultLineContract>
                    <PartNum>6GQ-00084</PartNum>
                    <ReservedQuantity>1</ReservedQuantity>
                    <RequestedQuantity>1</RequestedQuantity>
                </OrderReserveResultLineContract>
            </ReservedLines>
        </Data>
        <IsError>false</IsError>
        <ErrorCode>0</ErrorCode>
        <Errors/>
    </AddReserveResult>
</AddReserveResponse>

Запрос SOAP без лицензионной формы

POST https://sandbox.mont.ru/Version2/Service/B2BServiceV2.svc

<AddReserve>
  <MethodParameters>
    <reserve>
      <OrderPrefix>Myshop1</OrderPrefix>
      <Phone>9101112233</Phone>
      <ReceiptId isNull="false" />
      <ReseveLines attr0="OrderReserveLineContractArray" isNull="false">
        <OrderReserveLineContractArray0>
          <CurrencyCode>RUR</CurrencyCode>
          <EndUserInfo>
            <Fields attr0="EndUserInfoFieldContractArray" isNull="false">
              <EndUserInfoFieldContractArray0>
                <FieldName isNull="false" />
                <FieldValue isNull="false" />
              </EndUserInfoFieldContractArray0>
            </Fields>
          </EndUserInfo>
          <EndUserPrice>4399</EndUserPrice>
          <PartNum>6GQ-00084</PartNum>
          <Quantity>1</Quantity>
        </OrderReserveLineContractArray0>
      </ReseveLines>
    </reserve>
  </MethodParameters>
</AddReserve>

Ответ SOAP (без лицензионной формы)

<AddReserve>
  <MethodParameters>
    <WebStoreResponseContractOfOrderReserveResultContractxDcf_SQ1_P>
      <Data>
        <ReserveNum>2080</ReserveNum>
        <Reserved>True</Reserved>
        <ReservedLines attr0="OrderReserveResultLineContractArray" isNull="false">
          <OrderReserveResultLineContractArray0>
            <PartNum>6GQ-00084</PartNum>
            <RequestedQuantity>1</RequestedQuantity>
            <ReservedQuantity>1</ReservedQuantity>
          </OrderReserveResultLineContractArray0>
        </ReservedLines>
      </Data>
      <ErrorCode>0</ErrorCode>
      <ErrorText isNull="true" />
      <Errors attr0="ErrorContractArray" isNull="false" />
      <IsError>False</IsError>
    </WebStoreResponseContractOfOrderReserveResultContractxDcf_SQ1_P>
  </MethodParameters>
</AddReserve>

Запрос XmlOverHttp (с лицензионной формой)

POST https://sandbox.mont.ru/Version2/Service/B2BServiceV2Xml.svc/AddReserve

<?xml version="1.0" encoding="utf-8"?>
    <OrderReserveContract>
     <OrderPrefix>Myshop2</OrderPrefix> 
     <Phone>9101112233</Phone>
      <ReseveLines>
        <OrderReserveLineContract>
          <EndUserInfo>
            <Fields attr0="EndUserInfoFieldContractArray" isNull="false">
              <EndUserInfoFieldContract>
                <FieldName>KasperskyPIN</FieldName>
                <FieldValue>12345678</FieldValue>
             </EndUserInfoFieldContract>
              <EndUserInfoFieldContract>
                <FieldName>CustomerOrganization</FieldName>
                <FieldValue>MyPetShop</FieldValue>
              </EndUserInfoFieldContract>
              <EndUserInfoFieldContract>
                <FieldName>IsLegalPerson</FieldName>
                <FieldValue>true</FieldValue>
              </EndUserInfoFieldContract>
              <EndUserInfoFieldContract>
                <FieldName>Email</FieldName>
                <FieldValue>my@email.ru</FieldValue>
              </EndUserInfoFieldContract>
            </Fields>
          </EndUserInfo>
          <PartNum>KL1849RDBFY</PartNum>
          <Quantity>1</Quantity>
          <EndUserPrice>4000</EndUserPrice>
          <CurrencyCode>RUR</CurrencyCode>
        </OrderReserveLineContract>
      </ReseveLines>
    </OrderReserveContract>

Ответ XmlOverHttp (с лицензионной формой)

<?xml version="1.0" encoding="utf-8"?>
<AddReserveResponse xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <AddReserveResult>
        <Data>
            <Reserved>true</Reserved>
            <ReserveNum>2082</ReserveNum>
            <ReservedLines>
                <OrderReserveResultLineContract>
                    <PartNum>KL1849RDBFY</PartNum>
                    <ReservedQuantity>1</ReservedQuantity>
                    <RequestedQuantity>1</RequestedQuantity>
                </OrderReserveResultLineContract>
            </ReservedLines>
        </Data>
        <IsError>false</IsError>
        <ErrorCode>0</ErrorCode>
        <Errors/>
    </AddReserveResult>
</AddReserveResponse>

Запрос SOAP (с лицензионной формой)

POST https://sandbox.mont.ru/Version2/Service/B2BServiceV2.svc

<AddReserve>
  <MethodParameters>
    <reserve>
      <OrderPrefix>Myshop2</OrderPrefix>
      <Phone>9101112233</Phone>
      <ReceiptId isNull="false" />
      <ReseveLines attr0="OrderReserveLineContractArray" isNull="false">
        <OrderReserveLineContractArray0>
          <CurrencyCode>RUR</CurrencyCode>
          <EndUserInfo>
            <Fields attr0="EndUserInfoFieldContractArray" isNull="false">
              <EndUserInfoFieldContractArray0>
                <FieldName>KasperskyPIN</FieldName>
                <FieldValue>12345678</FieldValue>
              </EndUserInfoFieldContractArray0>
              <EndUserInfoFieldContractArray1>
                <FieldName>CustomerOrganization</FieldName>
                <FieldValue>MyPetShop</FieldValue>
              </EndUserInfoFieldContractArray1>
              <EndUserInfoFieldContractArray2>
                <FieldName>IsLegalPerson</FieldName>
                <FieldValue>true</FieldValue>
              </EndUserInfoFieldContractArray2>
              <EndUserInfoFieldContractArray3>
                <FieldName>Email</FieldName>
                <FieldValue>my@email.ru</FieldValue>
              </EndUserInfoFieldContractArray3>
            </Fields>
          </EndUserInfo>
          <EndUserPrice>4000</EndUserPrice>
          <PartNum>KL1849RDBFY</PartNum>
          <Quantity>1</Quantity>
        </OrderReserveLineContractArray0>
      </ReseveLines>
    </reserve>
  </MethodParameters>
</AddReserve>

Ответ SOAP (с лицензионной формой)

<AddReserve>
  <MethodParameters>
    <WebStoreResponseContractOfOrderReserveResultContractxDcf_SQ1_P>
      <Data>
        <ReserveNum>2083</ReserveNum>
        <Reserved>True</Reserved>
        <ReservedLines attr0="OrderReserveResultLineContractArray" isNull="false">
          <OrderReserveResultLineContractArray0>
            <PartNum>KL1849RDBFY</PartNum>
            <RequestedQuantity>1</RequestedQuantity>
            <ReservedQuantity>1</ReservedQuantity>
          </OrderReserveResultLineContractArray0>
        </ReservedLines>
      </Data>
      <ErrorCode>0</ErrorCode>
      <ErrorText isNull="true" />
      <Errors attr0="ErrorContractArray" isNull="false" />
      <IsError>False</IsError>
    </WebStoreResponseContractOfOrderReserveResultContractxDcf_SQ1_P>
  </MethodParameters>
</AddReserve>

Примеры скриптов на PHP

Пример выполнения REST и SOAP-запроса

метод, esd

Инструменты пользователя

Инструменты сайта