Форматы отчетов

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

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

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

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

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

Отчет EXCEL состоит минимум из трех листов

  1. title — содержит лист с общими результатами мониторинга, пояснения по цветовым схемам, сведения о списании и остатках проверок на балансе заказчика.
  2. table_0 — сводная таблица результатов по товарным артикулам
  3. result_0 — подробные отчеты о предложениях по товарным позициям

Ограничения по таблицам — 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 — ссылка на карточку
WorkMethodSTRINGзаданный метод сканирования (автопоиск, поиск по карточке, поиск по запросу)
[ServiceData]ARRAY служебные данные для сбора статистики
Name_foundSTRING Название товара в карточке яндекс-маркета
Slug_foundSTRING слаг (читабельная часть URL карточки)
[Breadcrumbs]ARRAY«хлебные крошки», для варианта парсинга результатов поиска:
name — отображаемое название подкатегории
link — ссылка подкатегории
[Item_filters_found]ARRAYфильтры, найденные в карточке
no — INT, порядковый номер, начиная с 0
name — STRING, название фильтра
measure — STRING, единица измерения
[values] — ARRAY OF STRING, значений, которые есть в предложениях карточки
Offers_declaredINTколичество предложений, указанное на главной странице карточки
Offers_сountedINTколичество предложений показанное внутри карточки
Rating_foundDOUBLEрейтинг товара, если есть
Rates_found INTколичество оценок пользователей, если есть
Replies_qtyINTколичество отзывов о товаре, если есть
Questions_qtyINTколичество вопросов о товаре, если есть
PopularitySTRINGпопулярность товара, например «4 636 покупок за 2 месяца»
Brands_selectedARRAY OF STRINGотфильтрованные бренды, для варианта парсинга результатов поиска
NoteSTRINGкомментарии
ReviewsINTколичество обзоров о товаре

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

IsFromFarINT1, если доставка из другого региона
PlaceINTместо в списке, начиная с нуля
NameSTRINGназвание, указанное продавцом
ShopIdSTRING id продавца на маркете (в последнее время маркет часто указывает свой)
OfferIdSTRING id предложения
MarketidSTRINGid карточки
SkuidSTRINGid SKU яндекс-маркета
ShopRatingDOUBLEрейтинг магазина
SkuRatingDOUBLEрейтинг товара, для варианта парсинга результатов поиска
SkuRatesINTколичество оценок товара, для варианта парсинга результатов поиска
SkuPropertiesARRAY OF STRINGсвойства товара, указанные продавцом
ShopReviewsINTколичество отзывов о магазине
ShopUrlSTRINGссылка на предложение магазина
PriceDOUBLEцена товара
PickupTermSTRINGусловия самовывоза
PickupCostDOUBLEстоимость самовывоза, -1.0, если нет
DeliveryExpressBOOLEANэкспресс-доставка
DeliveryTermSTRING условия доставки
DeliveryCostDOUBLE стоимость доставки, -1.0, если нет
PostalTermSTRING условия отправки почтой
PostalCostDOUBLE стоимость отправки почтой, -1.0, если нет
BuyOnMarketBOOLEANпокупка на маркете
PromosARRAY OF STRINGналичие промокодов и промоакций
PromoCodeSTRINGпромокод, если указан в карточке
PromoConditionsSTRINGусловия промоакции, если указаны в карточке
PromoPriceDOUBLEпромоцена
OldPriceDOUBLEстарая цена, если есть прямая скидка
CommentSTRINGкомментарии
[Offer_filters]ARRAYфильтры, указанные в предложении
no — INT, порядковый номер, начиная с 0
name — STRING, название фильтра
measure — STRING, единица измерения
values — STRING, значений, которые есть в предложениях карточки
Link_noINTпорядковый номер карточки, начиная с нуля, при поиске по нескольким карточкам

Отчеты в 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 — цена товара
……….