...
Property | Description | Where to show | Comments |
|---|---|---|---|
| DisplayName | vendor name | everywhere | Thanks to this, website admin will be able to change names later, but nothing will change in the logic for Mobile Application logic. |
| DisplayPictureUrl | vendor image | everywhere | Only if available, otherwise there is an image stub in recommended vendors, do not display in other places. Thanks to this, website admin will be able to change images but nothing will change in Mobile Application logic Только если есть, иначе в рекомендуемых продавцах заглушках, в остальных местах не отображать. Благодаря этому позже админ магазина сможет менять картинки, а для МП ничего не поменяется в логике.
|
| Credit/Level | vendor rating from 1 to 20 | in product card | Only if available and more than 0, otherwise it does not need to be displayed. |
| Credit/TotalFeedbacks | number of feedbacks | in product card on vendor's page | Only if available and more than 0, otherwise it does not need to be displayed. |
| Credit/PositiveFeedbacks | number of positive feedbacks | in product card on vendor's page | Only if available and more than 0, otherwise it does not need to be displayed. Display as% of total reviews if available. |
| Scores/DeliveryScore | delivery scrore from 1.0 to 5.0 | in product card on vendor's page | Только если есть и не равно 0, иначе отображать не нужно Only if available and more than 0, otherwise it does not need to be displayed. |
| Scores/ItemScore | item score from 1.0 to 5.0 | in product card on vendor's page | Только если есть и не равно 0, иначе отображать не нужно Only if available and more than 0, otherwise it does not need to be displayed. |
| Scores/ServiceScore | service score from 1.0 to 5.0 | in product card on vendor's page | Только если есть и не равно 0, иначе отображать не нужно. |
Поиск
Основная документация по поиску.
Only if available and more than 0, otherwise it does not need to be displayed. |
Search
Basic documentation on search.
Use only one convenient search method to search for goodsДля поиска товаров используем только один удобный метод поиска: http://docs.otapi.net/ruen/Documentations/Method?name=BatchSearchItemsFrame
При первом открытии категории/продавца/бренда или поискового запроса, вызываем метод BatchSearchItemsFrame с параметром blockListTo open a category / seller / brand or search query for the first time, call BatchSearchItemsFrame method with the blockList parameter: SubCategories,HintCategories,Vendor,Brand,Category,RootPath,SearchProperties,AvailableSearchMethods. В xmlParameters передаем параметры поиска (например ид категории Send search parameters in xmlParameters (for example, category ID <CategoryId>otc-3</CategoryId> или поисковый запрос or search or search query <ItemTitle>dress</ItemTitle>). Мы рекомендуем с параметрами поиска передать: <UseOptimalFrameSize>true</UseOptimalFrameSize>, это позволит получить в ответе оптимальное количество товаров на странице для данного запроса.
Отображаем информацию полученную в ответе.
В узле AvailableSearchMethods приходят все способы поиска, доступные для текущего запроса. Если способов поиска больше чем один - нужно дать возможность покупателю изменять способ поиска.
В узле Items по значениям из узлов Provider и SearchMethod (например: <Provider>Taobao</Provider> <SearchMethod>Extended</SearchMethod>) в AvailableSearchMethods находим подробную информацию о текущем способе поиска, которым сейчас сделан запрос. По этой информации предоставляем пользователю фильтры доступные на текущей странице поиска. О соответствии полей из информации о способе поиска и параметрами поиска можно найти в основной документации.
Показываем пользователю SubCategories (Подкатегории), HintCategories (Возможно вас заинтересует). В узле Items - Categories приходят категории подходящие под текущий поисковый запрос (Уточните категорию).
Показываем товары из узла Items - Items . Проверяем у товара флаг IsSellAllowed=true и SellDisallowReason="IsFiltered" - то показываем заглушку для товара - товар запрещен к покупке. Если ErrorCode товара не равен "Ok" - вместо картинки товара, показываем ошибку: NotFound - Товар удален, NotAvailable - Товар недоступен, все остальные коды ошибок просто слово "Ошибка".
Хорошей практикой является менять отображение в зависимости от того, какие узлы вернулись в ответе на запрос BatchSearchItemsFrame. Если:
- пришел узел Vendor, показываем пользователю страницу продавца с описанием продавца;
- пришел узел Brand, показываем страницу бренда с описанием бренда;
- пришел узел Category, показываем страницу категории с описанием категории;
- иначе - обычную страницу поиска по фразе.
We recommend sending <UseOptimalFrameSize>true</UseOptimalFrameSize> with search parameters. This will allow to get optimal number of products per page for this request.
Display information received in the response.
AvailableSearchMethods node contains all search methods available for current query. Allow customer to change search method if there are more than one search methods.
Find detailed information about the current search method that the query is now made in Items node, using values from Provider and SearchMethod nodes (for example: <Provider> Taobao </Provider> <SearchMethod> Extended </SearchMethod>) in AvailableSearchMethods. Using this information we provide user with filters available on the current search page. The correspondence of fields from information about search method and search parameters can be found in basic documentation.
Show SubCategories (Subcategories), HintCategories (You may be interested) to user. Categories that match current search query (Specify category) come up in Items - Categories node. Show goods from Items - Items node. Check the flag IsSellAllowed = true and SellDisallowReason = "IsFiltered" for the product - then we show the stub for the product - product is not allowed for purchase. Show error: NotFound - product was deleted, NotAvailable - product is unavailable instead of product image if product ErrorCode is not equal to "OK". For all other error codes just show the word "Error".
It is a good practice to change display depending on which nodes are returned in response to BatchSearchItemsFrame request. If:
- Vendor node has arrived, show user vendor's page with vendor description;
- Brand node has arrived, show brand page with brand description;
- Category node has arrived, show category page with category description;
- otherwise, a regular search page by phrase.
This approach will allow you to localize search logic and services will be responsible for page display logicТакой подход позволит локализовать логику поиска и сервисы будут отвечать за логику отображения страницы.
Карточка товара
При первом открытии карточки, нужно использовать метод: http://docs.otapi.net/ru/Documentations/Method?name=BatchGetSimplifiedItemFullInfo , нужно передавать следующие blockList: RootPath,Vendor,MostPopularVendorItems16,Description
...