Черновик документации. Будет переписано и дополнено в ближайшее время.
Узнать список подключенных провайдеров можно здесь: http://docs.otapi.net/ru/Documentations/Method?name=GetProviderInfoList
Подключение провайдера
Каждый новый товарный провайдер подключается отдельно. Подробности, организационные вопросы и стоимость можно посмотреть тут: http://key.otcommerce.com/ru/service-payments-rates
После того, как товарный провайдер оплачен и подключен, он не появится сразу ни в поиске, ни в каталоге товаров. Его необходимо включить.
Сделать это можно через интерфейс сайта http://open-demo.otcommerce.com/ik.php
Переходим по ссылке и вводим свой ключ:
Затем вводим логин и пароль, которые были получены вместе с ключом:
- Если новый товарный провайдер необходимо использовать как основной, следуем инструкциям в статье: http://docs.otcommerce.com/pages/viewpage.action?pageId=16910165 (Провайдер по умолчанию)
- Включаем поиск от нового провайдера, следуя инструкциям в статье: http://docs.otcommerce.com/pages/viewpage.action?pageId=23890054
- Добавляем в админке (или через API) в свой каталог категории нового провайдера, привязав их в корневой или любой другой категории каталога: http://docs.otcommerce.com/pages/viewpage.action?pageId=16910138 (раздел «Действия с категориями»)
Кроме того, можно работать напрямую с каталогом провайдера.
Как различаются провайдеры?
Работа с разными товарными провайдерами идентична, так как все данные поступают и обрабатываются через OT API.
Чтобы различать, например, товарные идентификаторы различных провайдеров есть специальные префиксы. Например, для 1688.com этот префикс равен «abb-»
Подключенные провайдеры
Узнать список подключенных провайдеров можно здесь: http://docs.otapi.net/ru/Documentations/Method?name=GetProviderInfoList
Например, можно увидеть, что 1688.com в системе ОТ обозначается идентификатором Alibaba1688.
Информация о способах поиска
С помощью метода GetProviderSearchMethodInfoList можно узнать информацию о способах поиска нового товарного провайдера. Подробнее о поиске можно узнать здесь: http://docs.otcommerce.com/pages/viewpage.action?pageId=23889934
Для получения информации, необходимо включить поиск от нового провайдера (см выше).
Работа напрямую с каталогом
Для работы напрямую с каталогом есть методы:
- GetProviderCategory
- GetProviderCategoryRootPath
- GetProviderCategorySubcategories — так как отдельного получения списка корневых категорий нет, используем этот метод с передачей значения RootCategoryId из информации о провайдере.
Поиск товаров по конкретному провайдеру
Для поиска товаров по конкретному провайдеру нужно указать его в параметрах общего метода поиска BatchSearchItemsFrame, например <Provider>Alibaba1688</Provider> ( подробнее описано тут: http://docs.otcommerce.com/pages/viewpage.action?pageId=23889934)
Если параметр не указан, провайдер определяется по категории, продавцу, бренду, и иным идентификаторам, если поиск идет по ним, либо берется провайдер по умолчанию, если поиск например по тексту. При поиске по ссылке на товар на сайте провайдера он также определится автоматически.