Description
Mass receipt of goods works through a group of methods with the keyword Bulk in the name. Methods are available only if the appropriate module is enabled for the key.
Methods allow to obtain up to 10,000 goods at once, from search criteria or list of identifiers, with complete information (descriptions, characteristics, configuration).
Methods work on the basis of background activity, you start the process, wait for its completion and take the result.
Currently, only one such process is allowed at a time, and a repeat run will simply return the previous activity identifier.
Tariffication
Methods of mass receipt of goods have dynamic tariffication: your tariff will include as many Calls as the goods have been successfully received.
Metods
Goods search
RunBulkSearchItems - starts the process of searching for goods and collecting complete information, accepts standard search parameters (more about them can be read in Search (OT API) section), the main difference is that you can specify a value up to 10 000 into frameSize parameter, and returns background activity ID method.
The activity can be monitored by standard means or by the following method:
GetBulkSearchItemsResult - method for retrieving search results, accepts activity ID and getResult parameter. With getResult=false this method will simply return the current state of the process, therefore you can track its progress and expect completion. getResult=true method will return complete information about all collected goods.
Receiving goods from ID list
RunBulkItems - starts the process of collecting complete information about goods, accepts the list of goods identifiers. The main difference is that you can specify up to 10,000 identifiers in ids and returns the method of background activity identifier.
You can monitor activity by standard means or by the following method:
GetBulkItemsResult - method of obtaining results, accepts activity identifier and getResult parameter. With getResult=false the method will simply return the current state of the process, therefore you can track its progress and expect completion. With getResult=true the method will return complete information about all collected goods.
If some requested goods are missing in the final result, then they are not in our database or they have been removed by the sellers.