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.
Получение товаров по списку идентификаторов
RunBulkItems - запуск процесса сбора полной информации о товарах, принимает список идентификаторов товаров, главное отличие это то что в параметр ids можно указать вплоть до 10 000 идентификаторов, и возвращает метод идентификатор фоновой активности.
Следить за активностью можно и стандартными средствами, а можно и следующим методом:
GetBulkItemsResult - метод получения результатов, принимает идентификатор активности и параметр getResult. При getResult=false метод просто вернет текущее состояние процесса, так что таким образом можно следить за его ходом и ожидать завершения. При getResult=true метод вернет полную информацию обо всех собранных товарах.
Если какие-то запрошенные товары отсутствуют в итоговом результате, значит их нет в нашей базе или они были удалены продавцами.