Само значение индекса качества мало помогает исправлять работу магазина. Полезнее связать изменение показателя с конкретными заказами, проверить обстоятельства и назначить действие. API Яндекс Маркета позволяет построить такой разбор в два шага.

Получить показатель и его детализацию

Сначала метод POST v2/businesses/{businessId}/ratings/quality возвращает значение индекса и составляющие для указанных кампаний. Затем POST v2/campaigns/{campaignId}/ratings/quality/details позволяет получить информацию о заказах, повлиявших на показатель конкретного магазина. Это разные уровни запроса: кабинет для сводки и кампания для детализации.

В руководстве не приводим универсальную формулу индекса или обещание его восстановления за определённое число дней. Описанная API-инструкция подтверждает получение данных, но не заменяет условия расчёта показателя и правила соответствующей модели работы.

Превратить список заказов в разбор причин

Редакционный подход — соединить детализацию с внутренней историей выполнения заказа. Для каждой строки нужны магазин, номер заказа, событие, которое требует проверки, и подтверждение из собственной системы. Это может быть время изменения статуса, запись об остатке или результат передачи данных. Выбирать подтверждение следует по реальной причине, которую показывает Маркет.

Не объединяйте все проблемные заказы одной пометкой «ошибка склада». Если товар отсутствовал физически, задача относится к учёту. Если он был собран, но статус не передался, проверять нужно интеграцию. Одинаковый итог для покупателя может возникнуть из разных процессов, а значит, потребовать разных исправлений.

Проверить, что исправление работает

Для повторяющихся случаев заведите короткую карточку: причина, ответственный, действие, срок проверки. После изменения процесса наблюдайте за новыми заказами такого же типа. Одно исчезнувшее расхождение не доказывает, что исправлена вся цепочка: важно исключить повтор той же причины.

Сравнивать магазины стоит отдельно, сохраняя модель работы и состав заказов. Магазин с небольшим объёмом требует особенно внимательного чтения отдельных случаев. Итогом автоматизации должен стать не только график индекса, но и понятный перечень исправлений с доказательствами. Такой отчёт помогает управлять процессом, не подменяя официальную оценку собственной формулой.