User Tools

Site Tools

  • en

Classic (basic) trading scheme

Conditions

  • The partner knows the list of products in the MONT system to trade
  • The partner have a login for a system and all the required contracts are concluded.
  • For the partner are configured (if required) all the necessary discounts in the price list.

Steps

1. Place order

AddOrder

Description

This method is used to add an order to the Mont Webstore system. The input object contains order number and a list of order lines. Each line matches a single ordered item and has a unique number. It describes: * Product ID (Partnumber);

  • part number of the ordered item;
  • quantity;
  • filled out license form with end user data
  • ID of subscriber that subscription is created for (filled out for subscriptions only).
Parameters
NameTypeDescription
orderRequestSendOrderContractObject containing order parameters
SendOrderContract
NameTypeDescription
OrderNumstringOrder number in the MONT system. It is created on the partner's side and must be unique within the entire pool of partner orders.
SendOrderLinesarray of SendOrderLineContractArray containing all lines of this order
Return value

All replies from B2BServiceV2Xml.svc and B2BServiceV2.svc web-services become a contract of the following format (the contract contains information about errors in web-service operation and a reply from the called method within the <Data> tag):

TypeDescription
OrderContractObject with the placed order containing current order status and numbers of created subscriptions
Possible errors
КодТекст ошибки
2Product not found
4Order with that number (order line) is already exists in the MONT system
6Credit limit exceeded
8Order line number field is not specified
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.
61Subscription not yet activated
71Order number field is not set
72There are no order lines in the order
75Subscriber with the specified code was not found
76Subscriber with the specified code was not activated
87No subscriber specified for a subscription
101Internal service error
200Incorrect EndUserInfo Data
900You do not need an activation form for that product
6000Operation not allowed
6005It is forbidden to order products with personal licenses
7022Unisafe phone check not passed
7023Unisafe phone check error
Sample requests and replies for AddOrder method

XmlOverHttp request without licence form

XmlOverHttp response without licence form


XmlOverHttp request with licence form

XmlOverHttp response with licence form


SOAP request without licence form

SOAP response without licence form


SOAP request with licence form

SOAP response with licence form

2. Get Keys

GetOrder

Description

This method is used to obtain information about the order placed in the MONT system.

Parameters
NameTypeDescription
orderNumberintOrder number
Return value
NameTypeDescription
OrderNumstringOrder number
OrderStatusintCurent order status. Possible values are described by OrderLineStatusEnum
If all order lines are completed successfully, the order status will be “completed successfully”. Otherwise, the status of the order wil be “in process”. (i.e., the status of the Order will never be “error”)
DateCreatedDateTimeOrder create date
OrderLinesarray of OrderLineContractlist of order lines
It should be noted that the Microsoft vendor has products with FulfillmentType = 1. For these products, the vendor limited the link expiry period to 24 hours. To request an updated link, use the same GetOrder method. The reply will contain updated links that are valid at the time of method call.
Errors
Error CodeError Text
3Order not found
Examples

Запрос XmlOverHttp

Ответ XmlOverHttp

SOAP request

SOAP reply