Parser.market – сервис, рассчитанный на компании разного уровня – от крупных оптовых компаний и вендоров со своим штатом IT-специалистов до небольших (пока) оптовиков и интернет-магазинов, руководители которых решают, как правило, широкий спектр задач.

Мы не гонимся (пока) за большим количеством форматов ввода данных и экспорта в различные системы, предпочитая сосредоточиться на качестве результатов мониторинга.
Вместе с тем, с уважением относимся к вашему времени, поэтому отчеты предоставляются в нескольких вариантах:

• Для программистов – форматы JSON/XML/CSV, для компаний, имеющих в штате или на фрилансе IT-специалистов, которые могли бы встроить полученные данные в собственную систему учета
• Для коммерсантов – формат EXCEL с удобной навигацией, позволяющий сразу ознакомиться с ситуацией на рынке людям, отвечающим за коммерцию, не дожидаясь обработки данных и ввода их в вашу учетную систему.

Отчеты в EXCEL (см также отчеты в csv, отчеты JSON/XML)

Листы в отчете

Ограничения по таблицам – 10000 товаров для сводных таблиц, 300 – для подробных, далее таблицы разбиваются, появляется table_1, result_1 и так далее.
Чтобы комфортнее пользоваться таким отчетом, большие прайс-листы лучше отправлять в обработку частями – если в такой части будет до 10000 позиций, они все окажутся в одной сводной таблице, удобнее будет фильтровать, искать и сортировать.

Подробная таблица

Переход на эту часть таблицы происходит в ячейку “Обновлено… Посмотреть предложения на Яндекс-маркете.”
Именно она, в зависимости от предыдущего перехода может оказаться сверху или снизу активного экрана (так уж устроено в EXCEL).
Эта же ячейка представляет собой ссылку на карточку Яндекс-маркета.

Соседняя ячейка с красным текстом “ВОЗВРАТ В ТАБЛИЦУ / … ” тоже ссылка, клик по ней вернет Вас на то место, откуда Вы пришли.
Таким образом осуществляется навигация по документу.

Дополнительный список карточек

Нам удалось создать неплохой алгоритм сопоставления вашего товара карточке на Яндекс-маркете, но, не секрет, что любой подобный алгоритм работает не всегда точно.
Иначе говоря, Вы получаете данные не о том товаре, которым интересуетесь.

Причин тут несколько, они, возможно, будут описаны отдельно.
Пока отметьте, что первая позиция в дополнительном списке – это еще одна карточка на тот же самый товар.
Если перейти на эту карточку, предложений по ней нет, но, возможны варианты.
Мы учитывали этот фактор и стараемся искать наиболее популярную карточку, но стопроцентного успеха гарантировать невозможно.

По этой причине при первом мониторинге снизу от блока карточек будет показан список “похожих” по мнению системы карточек (до 5 шт).
Впрочем, можно уточнить карточку при следующем запросе (о том, как это сделать – в соответствующем разделе).

---

Отчеты в JSON/XML

Поля отчетов JSON/XML

Поля в отчете описаны ниже под спойлером.
Не все из них будут заполнены, некоторые относятся к другому типу задачи, какие-то устаревают с изменениями на Яндекс-маркете.

Общие сведения по заданию:

id	идентификатор задания
username	имя пользователя
regioncode	код региона в задании
ordermail	электронная почта для уведомлений
items_received	количество позиций в прайс-листе
items_accepted	количество принятых позиций (при недостатке проверок на балансе обрабатываются первые позиции по числу доступных проверок)
received	задание получено
started	задание запущено или помещено в очередь заданий
finished	задание закончено
used_checks_total	использовано проверок всего (не всегда совпадает с количеством позиций в прайс-листе)
used_checks_free	использовано бонусных проверок
used_checks_paid	использовано оплаченных проверок
cost_rub	стоимость по заданию в рублях
checks_free_before	бонусных проверок до отчета
checks_paid_before	бонусных проверок после отчета
checks_free_after	оплаченных проверок до отчета
checks_paid_after	оплаченных проверок после отчета
report_operationcomment	комментарии при составлении отчета
csvfile	ссылка на отчет CSV
xlsfile	ссылка на отчет XLS
jsonfile	ссылка на отчет JSON
xmlfile	ссылка на отчет XML
comments	замечания по выполнению задачи

[data] массив результатов обработки товарных позиций

[data] – общее

Первые поля повторяют поля в вашем задании, за исключением linkset.
Массив linkset в распознанном виде присутствует в массиве [sku] (элемент массива [data]), если он был указан в задании либо сохранен системой ранее

category	категория товара, если указана в задании
code	код товара из системы пользователя, если указан в задании
productid	общепринятый артикул товара, если указан в задании
brand	бренд, если указан в задании
name	название товара, указанное в задании (обязательное поле)
marketid	id карточки товара на яндекс-маркете, если указано в задании или сохранено системой
price	цена из вашего прайс-листа, если указана
donotsearch	1 – директива не искать карточки товара помимо указанных если они не найдены системой
textsearch	поисковый запрос, если заполнен – показываются только результаты поиска на яндекс-маркете по этому запросу
searchquery	сформированный системой запрос для поиска по карточек либо testsearch
link	найденная ссылка на карточку товара либо результаты поиска
[sku]	массив свойств найденной карточки
[offers]	массив найденных предложений

[data] – [sku] – данные по карточке товара (для поиска по нескольким карточкам – по первой из них)

[Similar_id_list]	ARRAY	Массив “похожих по названию карточек”: place – буквенно-цифровой индекс “похожести” названия rating – не используется offers – количество предложений, если найдено name – найденное имя товара name_0 – не используется marketid – id карточки cardlink – ссылка на карточку
WorkMethod	STRING	заданный метод сканирования (автопоиск, поиск по карточке, поиск по запросу)
[ServiceData]	ARRAY	служебные данные для сбора статистики
Name_found	STRING	Название товара в карточке яндекс-маркета
Slug_found	STRING	слаг (читабельная часть URL карточки)
[Breadcrumbs]	ARRAY	“хлебные крошки”, для варианта парсинга результатов поиска: name – отображаемое название подкатегории link – ссылка подкатегории
[Item_filters_found]	ARRAY	фильтры, найденные в карточке no – INT, порядковый номер, начиная с 0 name – STRING, название фильтра measure – STRING, единица измерения [values] – ARRAY OF STRING, значений, которые есть в предложениях карточки
Offers_declared	INT	количество предложений, указанное на главной странице карточки
Offers_сounted	INT	количество предложений показанное внутри карточки
Rating_found	DOUBLE	рейтинг товара, если есть
Rates_found	INT	количество оценок пользователей, если есть
Replies_qty	INT	количество отзывов о товаре, если есть
Questions_qty	INT	количество вопросов о товаре, если есть
Popularity	STRING	популярность товара, например “4 636 покупок за 2 месяца”
Brands_selected	ARRAY OF STRING	отфильтрованные бренды, для варианта парсинга результатов поиска
Note	STRING	комментарии
Reviews	INT	количество обзоров о товаре

[data] – [offers] – данные по предложениям в карточке

IsFromFar	INT	1, если доставка из другого региона
Place	INT	место в списке, начиная с нуля
Name	STRING	название, указанное продавцом
ShopId	STRING	id продавца на маркете (в последнее время маркет часто указывает свой)
OfferId	STRING	id предложения
Marketid	STRING	id карточки
Skuid	STRING	id SKU яндекс-маркета
ShopRating	DOUBLE	рейтинг магазина
SkuRating	DOUBLE	рейтинг товара, для варианта парсинга результатов поиска
SkuRates	INT	количество оценок товара, для варианта парсинга результатов поиска
SkuProperties	ARRAY OF STRING	свойства товара, указанные продавцом
ShopReviews	INT	количество отзывов о магазине
ShopUrl	STRING	ссылка на предложение магазина
Price	DOUBLE	цена товара
PickupTerm	STRING	условия самовывоза
PickupCost	DOUBLE	стоимость самовывоза, -1.0, если нет
DeliveryExpress	BOOLEAN	экспресс-доставка
DeliveryTerm	STRING	условия доставки
DeliveryCost	DOUBLE	стоимость доставки, -1.0, если нет
PostalTerm	STRING	условия отправки почтой
PostalCost	DOUBLE	стоимость отправки почтой, -1.0, если нет
BuyOnMarket	BOOLEAN	покупка на маркете
Promos	ARRAY OF STRING	наличие промокодов и промоакций
PromoCode	STRING	промокод, если указан в карточке
PromoConditions	STRING	условия промоакции, если указаны в карточке
PromoPrice	DOUBLE	промоцена
OldPrice	DOUBLE	старая цена, если есть прямая скидка
Comment	STRING	комментарии
[Offer_filters]	ARRAY	фильтры, указанные в предложении no – INT, порядковый номер, начиная с 0 name – STRING, название фильтра measure – STRING, единица измерения values – STRING, значений, которые есть в предложениях карточки
Link_no	INT	порядковый номер карточки, начиная с нуля, при поиске по нескольким карточкам

---

Отчеты в CSV (см также отчеты в EXCEL)

Отчет в CSV – это файл с разделителем “;” в кодировке UTF-8 со следующими полями:

поля, относящиеся к товару(карточке)
category – категория товара, как указано в вашем прайсе
code – код (не артикул!) товара из вашего прайса, для интеграции в систему
id – общепринятый артикул вашего товара
brand – бренд товара из вашего прайса
name – наименование товара из вашего прайса
marketid – найденный автоматически (либо указанный Вами) идентификатор карточки на Яндекс-маркете
price – ваша цена товара
link – ссылка на карточку товара в Яндекс-маркете
cardfound – 1, если карточка найдена, 0 – если нет
marketname – наименование товара в карточке на Яндекс-маркете
rating – рейтинг товара на Маркете
replies – количество отзывов о товаре
questions – количество вопросов о товаре
offers – количество найденных предложений
salepoints – количество точек продаж (не используется)
reviews – количество обзоров о товаре (не используется)
finished – время обработки
comments – результат обработки
поля, относящиеся к найденным предложениям по товару (“1_” и т.д. – порядковый номер предложения)
1_Place – место (сортировка по возрастанию цены)
1_Price – цена товара
1_Name – наименование товара в предложении магазина
1_BuyOnMarket – “покупка на маркете” (True/False), похоже, уже не актуально – всегда True
1_ ShopName – название магазина
1_ ShopRating – рейтинг магазина
1_ ShopReviews – отзывов о магазине
1_ PickupCost – цена доставки (-1, если доставки нет)
1_ PickupTerm – условия доставки
1_ DeliveryCost – цена самовывоза (-1, если нет)
1_ DeliveryTerm – условия самовывоза
1_ PostalCost – цена почтовой отправки (-1, если нет)
1_ PostalTerm – условие отправки по почте
2_Place – место (сортировка по возрастанию цены)
2_Price – цена товара
……….