User Tools

Site Tools

  • en

Reserve trading scheme (with sms keys delivering)

Positive scenario

  • End user request an order for several products (no more than 5 products, each not more than 5 keys)
  • Reseller system send request to Webstore to create a reserve (lifetime = 15 minutes). The Request must contain the telephone number of the end user.
  • Webstore return number of reserve. It mean that the order can be complete succefully if order is placed.
  • Reseller system confirm reserve and place an order
  • End user pay for order
  • Reseller system, using order number, send request to Webstore to send keys to end user by SMS
  • Webstore send order data to financional reporting system

Scheme

Negative scenario

  • End user request an order for several products (no more than 5 products, each not more than 5 keys)
  • Reseller system send request to Webstore to create a reserve (lifetime = 15 minutes). The Request must contain the telephone number of the end user.
  • Webstore return error result at the moment
  • Reseller try again in several seconds

Positive scenario 2

  • End user request an order for several products (no more than 5 products, each not more than 5 keys)
  • Reseller system send request to Webstore to create a reserve (lifetime = 15 minutes). The Request must contain the telephone number of the end user.
  • Webstore return number of reserve. It mean that the order can be complete succefully if order is placed.
  • Reseller system confirm reserve and place an order
  • Error raised in Reseller or MONT systems
  • When problem is resolved, Reseller system, using order number, send request to Webstore to send keys to end user by SMS
  • After 24 hours from placing order, data of it is already send to MONT reporting system

Positive scenario 3

  • End user request an order for several products (no more than 5 products, each not more than 5 keys)
  • Reseller system send request to Webstore to create a reserve (lifetime = 15 minutes). The Request must contain the telephone number of the end user.
  • Webstore return number of reserve. It mean that the order can be complete succefully if order is placed.
  • Reseller system confirm reserve and place an order
  • End user can't pay for order
  • Reseller system send request to cancel order
  • if 24 hours not passed - order will be succesfully canceled

Methods

Steps

1. Create reserve (AddReserve)

Description

The method is used to place a reserve in the MontWebstore system. The input object contains the phone number of the end user, to which the keys will be sent, the list of reserve lines. Each line corresponds to one ordered item. It describes:

  • Product ID (Partnumber);
  • Quantity;
  • Completed licence form with end user data;
  • End user price
Extra information

In the DomainPrefix field, you can specify code, which describes< for example, branch office. When creating orders on the side of Webstore, order numbers will include this prefix by the rule: DomainPrefix + “-Reserve” + Reserve_number

Restrictions

  • With that method can't place reserve on subscriptions

Input parameters

OrderReserveContract
NameTypeDescription
PhonestringEnd user phone number for SMS
ReseveLinesarray of OrderReserveLineContractArray of reservelines
OrderPrefixstringOrder prefix. Result order number will be <OrderPrefix>-reserve<reserve number>. Order lines numbers will be: <OrderPrefix>-reserve<reserve number>-<orderline count>
ReceiptIdstringVoucher ID
OrderReserveLineContract
NameTypeDescription
PartNumstringProduct ID (PartNumber)
QuantityintQuantity of product units
EndUserInfoEndUserInfoContractEnd user info (if required)
EndUserPricedecimalEnd user price
CurrencyCodestringEnd user price currency code
EndUserInfoContract
NameTypeDescription
Fieldsarray of EndUserInfoFieldContractList of the end user license form fields

Return value

All replies of web services B2BServiceV2Xml.svc and B2BServiceV2.svc are wrapped in a contract type (the contract contains information about the violations in the operation of the web service, as well as the response of the called method inside the <Data> tag.):

NameTypeDescription
ReservedboolReserve rusult. If false - reserve not created and it's reserve number will be 0
ReserveNumstringReserve number. If = 0 reserve not created
ReservedLinesarray of OrderReserveResultLineContractList of reserve lines
OrderReserveResultLineContract
NameTypeDescription
PartNumstringProduct ID (PartNumber)
ReservedQuantityintQuantity of reserved keys
RequestedQuantityintRequested quantity of keys to reserve

Errors

Error codeError text
2Product not found
6Credit limit exceeded
10Product is blocked
12The license form has not been specified
16Reseller is blocked
17Quantity is incorrect
25Invalid format for the order line number. For Microsoft products, the line number must not exceed 32 characters
45Reservelines not found
200Incorrect EndUserInfo Data
46Can't Reserve Subscription
53End User Price Missmatch
6009ReservesForbidden - Reserve not allowed for reseller

Examples

XmlOverHttp request without license form example

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

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

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

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

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

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

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

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

XmlOverHttp response (without license form) example

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

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

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

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

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

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

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

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

XmlOverHttp request with license form example

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

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

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

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

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

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

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

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

XmlOverHttp response (with license form) example

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

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

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

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

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

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

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

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

SOAP request without license form

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

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

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

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

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

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

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

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

SOAP response without license form

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

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

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

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

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

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

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

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

SOAP request with license form

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

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

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

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

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

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

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

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

SOAP response with license form

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

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

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

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

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

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

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

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

2. Reserve confirmation (ConfirmReserve)

Description

The method is used to confirm the placed reserve in the MontWebstore system.

Restrictions

  • Confirmation or cancellation of the reserve is possible within 15 minutes after its creation
  • The unconfirmed within 15 minutes reserve is considered to be canceled

Parameters

NameTypeDescription
reserveNumstringNumber of reserve

Return value

NameTypeDescription
ConfirmationResultboolConfirmation result
OrderNumstringReserved order number

Errors

КодТекст ошибки
52Reserve not found
48Reserve already confirmed
50Canceled reseve cant be confirmed

Examples

XmlOverHttp request

Запрос XmlOverHttp

Ответ XmlOverHttp

Запрос SOAP

Ответ SOAP

XmlOverHttp response

Запрос XmlOverHttp

Ответ XmlOverHttp

Запрос SOAP

Ответ SOAP

SOAP request

Запрос XmlOverHttp

Ответ XmlOverHttp

Запрос SOAP

Ответ SOAP

SOAP response

Запрос XmlOverHttp

Ответ XmlOverHttp

Запрос SOAP

Ответ SOAP

2а. Reserve cancelation (CancelReserve)

Description

The method is used to cancel the placed reserve in the MontWebstore system.

Restrictions

  • Confirmation or cancellation of the reserve is possible within 15 minutes after its creation
  • The unconfirmed within 15 minutes reserve is considered to be canceled

Parameters

NameTypeDescription
reserveNumstringReserve number

Return value

TypeDescription
boolOperation result

Errors

КодТекст ошибки
52Reserve not found
48Reserve already canceled
50Confirmed reseve cant be canceled
Examples
XmlOverHttp request

Запрос XmlOverHttp

Ответ XmlOverHttp

Запрос SOAP

Ответ SOAP

XmlOverHttp response

Запрос XmlOverHttp

Ответ XmlOverHttp

Запрос SOAP

Ответ SOAP

SOAP request

Запрос XmlOverHttp

Ответ XmlOverHttp

Запрос SOAP

Ответ SOAP

SOAP response

Запрос XmlOverHttp

Ответ XmlOverHttp

Запрос SOAP

Ответ SOAP

3. Send keys to end user by SMS (ConfirmOrderSms)

Description

The method is used to confirm the placed order (according to the SMS scheme) in the MontWebstore system.

Restrictions

  • Confirmation or cancellation of the order is possible within 24 hours after confirmation of the reserve
  • An order not canceled within 24 hours - is deemed to be confirmed

Parameters

NameTypeDescription
orderNumstringNumber of order

Return value

TypeDescription
boolOperation result

Errors

КодТекст ошибки
3Reserve not found
6007Order is canceled
6006Can't confirm non-reserved order

Examples

XmlOverHttp request

Запрос XmlOverHttp

Ответ XmlOverHttp

Запрос SOAP

Ответ SOAP

XmlOverHttp response

Запрос XmlOverHttp

Ответ XmlOverHttp

Запрос SOAP

Ответ SOAP

SOAP request

Запрос XmlOverHttp

Ответ XmlOverHttp

Запрос SOAP

Ответ SOAP

SOAP response

Запрос XmlOverHttp

Ответ XmlOverHttp

Запрос SOAP

Ответ SOAP

3а. Order cancelation (CancelOrderSms)

Description

The method is used to cancel a placed order (according to the SMS scheme) in the MontWebstore system.

Restrictions

  • Confirmation or cancellation of the order is possible within 24 hours after confirmation of the reserve
  • An order not canceled within 24 hours - is deemed to be confirmed

Parameters

NameTypeDescription
orderNumstringOrder number

Return value

TypeDescription
boolOperation result

Errors

КодТекст ошибки
3Order not found
6004Can't cancel reserved order
6007Order already canceled
6006Can't cancel non-reserved order

Examples

XmlOverHttp request

Запрос XmlOverHttp

Ответ XmlOverHttp

Запрос SOAP

Ответ SOAP

XmlOverHttp response

Запрос XmlOverHttp

Ответ XmlOverHttp

Запрос SOAP

Ответ SOAP

SOAP request

Запрос XmlOverHttp

Ответ XmlOverHttp

Запрос SOAP

Ответ SOAP

SOAP response

Запрос XmlOverHttp

Ответ XmlOverHttp

Запрос SOAP

Ответ SOAP