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, you wait for it to complete, and you take the result.
Методы работают по принципу фоновых активностей, вы запускаете процесс, ожидаете его завершения, и забираете результат.
На данный момент разрешен только один такой процесс единовременно, повторный запуск просто вернет предыдущий идентификатор активности.
Тарификация
Методы массового получения товаров имеют динамическую тарификацию: в ваш тариф будет зачтено столько Вызовов, сколько товаров было успешно получено.
Методы
Поиск товаров
RunBulkSearchItems - запуск процесса поиска товаров и сбора полной информации, принимает стандартные параметры поиска (подробнее о них можно прочитать в разделе Поиск (OT API)), главное отличие это то что в параметр frameSize можно указать значение вплоть до 10 000, и возвращает метод идентификатор фоновой активности.
Следить за активностью можно и стандартными средствами, а можно и следующим методом:
GetBulkSearchItemsResult - метод получения результатов поиска, принимает идентификатор активности и параметр getResult. При getResult=false метод просто вернет текущее состояние процесса, так что таким образом можно следить за его ходом и ожидать завершения. При getResult=true метод вернет полную информацию обо всех собранных товарах.
Получение товаров по списку идентификаторов
RunBulkItems - запуск процесса сбора полной информации о товарах, принимает список идентификаторов товаров, главное отличие это то что в параметр ids можно указать вплоть до 10 000 идентификаторов, и возвращает метод идентификатор фоновой активности.
Следить за активностью можно и стандартными средствами, а можно и следующим методом:
GetBulkItemsResult - метод получения результатов, принимает идентификатор активности и параметр getResult. При getResult=false метод просто вернет текущее состояние процесса, так что таким образом можно следить за его ходом и ожидать завершения. При getResult=true метод вернет полную информацию обо всех собранных товарах.
Если какие-то запрошенные товары отсутствуют в итоговом результате, значит их нет в нашей базе или они были удалены продавцами.