API репрайсера

Репрайсер — основной модуль автоматизации SalesFinder, полностью доступный через API. Включает 9 эндпоинтов для управления сценариями и товарами.

Управление сценариями

Список сценариев

POST /api/2025_09/repricer/get_script_list
Authorization: Bearer {token}

Возвращает все настроенные сценарии репрайсера с их статусами и параметрами.

Создать сценарий компенсации СПП

POST /api/2025_09/repricer/create_compensation
Authorization: Bearer {token}
Content-Type: application/json

Логика работы:

Целевая витринная цена: 1 000 руб.
Скидка маркетплейса (СПП): 15%
Репрайсер устанавливает: ~1 176 руб.
Покупатель видит: 1 000 руб.

1. Рассчитывает скидку маркетплейса (СПП на WB, субсидии Ozon)
2. Определяет дельту между ценой продавца и витринной ценой
3. Автоматически корректирует цену для удержания целевой витринной цены

Рекомендация

Начинайте интеграцию с этого сценария — он проще в настройке и имеет меньше рисков. Идеален для защиты маржи при постоянно меняющемся СПП.

Создать сценарий отслеживания конкурентов

POST /api/2025_09/repricer/create_competitor_spp
Authorization: Bearer {token}
Content-Type: application/json

Логика работы:

1. Мониторит витринные цены указанных конкурентов
2. Учитывает СПП конкурентов (реальные цены, не прайсовые)
3. Корректирует вашу цену в заданных границах (min/max)
4. Не опускает цену ниже установленного минимума

Важно

Настройте минимальную цену с учётом себестоимости, комиссии маркетплейса и логистики. Репрайсер не знает вашу маржинальность — он оперирует только заданными границами.

Расширенный сценарий конкурентов

POST /api/2025_09/repricer/store_competitor_plus
Authorization: Bearer {token}
Content-Type: application/json

Продвинутая версия конкурентного сценария с дополнительными параметрами настройки.

Удалить сценарий

POST /api/2025_09/repricer/destroy_script
Authorization: Bearer {token}
Content-Type: application/json

Управление товарами

Список товаров

POST /api/2025_09/repricer/get_product_list
Authorization: Bearer {token}
Content-Type: application/json

Возвращает список товаров магазина, доступных для репрайсинга. Поддерживает пагинацию (take, skip) и фильтрацию.

Обновить цену товара

POST /api/2025_09/repricer/update_product
Authorization: Bearer {token}
Content-Type: application/json

Ручное обновление цены конкретного товара. Используется для точечных корректировок вне автоматических сценариев.

Динамика цен

POST /api/2025_09/repricer/get_sku_dynamic_list
Authorization: Bearer {token}
Content-Type: application/json

Возвращает историю изменений цен управляемых товаров. Включает:

• Дату и время каждого изменения
• Старую и новую цену
• Причину изменения (какой сценарий сработал)

Лог событий

POST /api/2025_09/repricer/get_sku_history_list
Authorization: Bearer {token}
Content-Type: application/json

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

Пример интеграции: Python

import httpx
import time

class SalesFinderRepricer:
    BASE_URL = "https://api.salesfinder.ru/api/2025_09"

    def __init__(self, token: str):
        self.token = token

    def _headers(self):
        return {
            "Authorization": f"Bearer {self.token}",
            "Content-Type": "application/json"
        }

    def _request(self, endpoint: str, data: dict = None):
        """Запрос с rate limiting (1 запрос / 5 секунд)."""
        time.sleep(5)
        resp = httpx.post(
            f"{self.BASE_URL}/{endpoint}",
            headers=self._headers(),
            json=data or {}
        )
        resp.raise_for_status()
        return resp.json()

    def get_scripts(self):
        """Получить все сценарии."""
        return self._request("repricer/get_script_list")

    def create_compensation(self, params: dict):
        """Создать сценарий компенсации СПП."""
        return self._request("repricer/create_compensation", params)

    def create_competitor_tracking(self, params: dict):
        """Создать сценарий отслеживания конкурентов."""
        return self._request("repricer/create_competitor_spp", params)

    def get_products(self, take: int = 100, skip: int = 0):
        """Получить список товаров."""
        return self._request("repricer/get_product_list", {
            "take": take, "skip": skip
        })

    def update_price(self, product_id: int, new_price: float):
        """Обновить цену товара."""
        return self._request("repricer/update_product", {
            "product_id": product_id, "price": new_price
        })

    def get_price_history(self, take: int = 50):
        """Получить историю изменений цен."""
        return self._request("repricer/get_sku_dynamic_list", {
            "take": take
        })

    def get_event_log(self, take: int = 100):
        """Получить лог событий."""
        return self._request("repricer/get_sku_history_list", {
            "take": take
        })

Сводная таблица эндпоинтов

#	Эндпоинт	Назначение	Группа
1	repricer/get_script_list	Список сценариев	Сценарии
2	repricer/create_compensation	Компенсация СПП	Сценарии
3	repricer/create_competitor_spp	Конкуренты (базовый)	Сценарии
4	repricer/store_competitor_plus	Конкуренты (расширенный)	Сценарии
5	repricer/destroy_script	Удаление сценария	Сценарии
6	repricer/get_product_list	Список товаров	Товары
7	repricer/update_product	Обновление цены	Товары
8	repricer/get_sku_dynamic_list	Динамика цен	Аналитика
9	repricer/get_sku_history_list	Лог событий	Аналитика

Сценарии использования для Fotofactor

Сценарий: Управление ценами клиента

1. Клиент подключает магазин → create_user_keys
2. Получаем список товаров → get_product_list
3. Настраиваем компенсацию СПП → create_compensation
4. Мониторим динамику → get_sku_dynamic_list (ежедневно)
5. Отправляем клиенту отчёт с данными из event log

Сценарий: Конкурентная разведка + репрайсинг

1. Анализируем конкурентов через ext-analitic/get_category_product
2. Настраиваем отслеживание → create_competitor_spp
3. Автоматическая корректировка цен в режиме реального времени
4. Еженедельный отчёт клиенту: экономия маржи, позиции