Репрайсер: цены, экономика и согласование изменений

Зачем это нужно

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

Пример из работы магазина

Как начать

1. Подключите магазин и проверьте agent.me, capabilities.list и automations.credentials.requirements с domain=pricing.
2. Согласуйте в памяти магазина товары, цели, затраты, сроки действия и ограничения. Для настройки нужны operations.read, operations.plan и доступ к задаче.
3. Прочитайте текущую конфигурацию, подготовьте новую версию, проверьте repricer.config.validate и привяжите условия к актуальной задаче.
4. Сохраните конфигурацию, выполните один предварительный расчёт и прочитайте решения. Для возможной отправки используйте отдельный точный план и подтверждение владельца.

Что вы получите

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

Что важно учитывать

Конфигурация и предварительные расчёты работают в observe/shadow. Отдельный исполнитель согласованных цен существует, но успешный реальный пилот изменения на WB не объявляется подтверждённым. Наличие ключа и метода не доказывает готовность конкретного магазина. Автономная переоценка без точного согласования не включена.

Из чего состоит репрайсер

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

Какие параметры читает расчёт

Текущий адаптер цен не рассчитывает дни запаса автоматически из сырых заказов и остатков. Если такого входа нет, stock-cover вернёт missing_stock_cover. Для target-seller-price дни запаса не являются обязательной частью стратегии.

Структура конфигурации и задачи

Неизвестные поля и стратегии отклоняются. На один товар допускается одна включённая задача. Лимит определения — до 100 задач и суммарно 1000 товарных строк; это ограничение файла, а не обещание производительности для 1000 магазинов.

Настройки ограничений

interval_seconds задаётся отдельно: 60–86400 секунд, по умолчанию 900. Само сохранение интервала не включает расписание. Значения по умолчанию описывают контракт и не являются рекомендацией для вашей экономики.

Полный учебный профиль репрайсера

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

{
  "repricer_version": 2,
  "config_id": "repricer-example-v2",
  "mode": "shadow",
  "tasks": [
    {
      "task_id": "example-target-price",
      "enabled": false,
      "binding": {
        "memory_revision_ref": "example-memory-revision-1",
        "task_revision_ref": "example-task-revision-1"
      },
      "valid_until": "2099-01-01T00:00:00Z",
      "strategy": {
        "kind": "target-seller-price"
      },
      "products": [
        {
          "target_id": "123456",
          "safe_min_price": 900,
          "safe_max_price": 1300,
          "target_price": 1100,
          "economics": {
            "revision_ref": "example-economics-revision-1",
            "fixed_cost_rub": 550,
            "variable_cost_percent": 20
          }
        }
      ]
    }
  ],
  "expected_config_sha256": ""
}

• Опубликованный шаблон для скачивания

Как получается предложение цены

1. Проверяется задача: включена ли, не истёк ли срок, однозначно ли выбран товар.
2. Проверяется цена и история: свежесть, незавершённые действия, ручная остановка и внешние изменения.
3. Рассчитывается нижний порог модели затрат.
4. Стратегия определяет желаемое направление.
5. Финансовый порог пересекается с коридором владельца, допустимым шагом и оставшимся лимитом движения.
6. Если пересечение пустое, товар блокируется; если отклонение мало — цена удерживается. Предложение сохраняется с причиной.

Порог = fixed_cost_rub / (1 − variable_cost_percent / 100 − minimum_margin_percent / 100). Знаменатель должен быть положительным. Порог округляется вверх до копейки. Расходы на налоги, возвраты, комиссию, рекламу и логистику должны быть согласованно включены в модель; сервис не угадывает их и не добавляет повторно.

Учебный расчёт: фиксированные расходы 550 ₽, переменная доля 20%, минимальная маржинальность 15%. Порог = 550 / 0,65 = 846,16 ₽ после округления вверх. При коридоре 900–1300 ₽, текущей цене 1000 ₽, цели 1100 ₽ и шаге 5% ближайшее предложение не выше 1050 ₽, если остальные проверки пройдены. Это пример механики, не прогноз прибыли.

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

Порядок работы через методы

{
  "domain": "pricing"
}

1. Возьмите текущую конфигурацию и её server SHA-256. Не передавайте обратно служебные поля ответа.
2. Вызовите repricer.config.validate с полным объектом config. Получите effective config и bindings[].success_criterion.
3. Добавьте критерий в соответствующую задачу памяти, сохранив остальные критерии. Через tasks.resume прочитайте UUID и текущую version; укажите их в binding.
4. Вызовите automations.config.apply с domain=pricing, config и idempotency_key. После записи перечитайте config.get.
5. Выполните один automations.shadow.run либо создайте automations.jobs.create. Прочитайте результат и причины через runs.list или jobs.get.

{
  "domain": "pricing",
  "idempotency_key": "guide-pricing-preview-001"
}

{
  "domain": "pricing",
  "limit": 5
}

Примеры показывают форму запроса. Артикулы, Memory refs и ключи идемпотентности заменяются для реальной задачи. Вызов расчёта сохраняет результат X-MP, но не меняет цену WB.

Точный план, согласование и чтение результата

{
  "target_ids": [
    "123456"
  ],
  "idempotency_key": "guide-pricing-plan-001"
}

repricer.plan принимает 1–5 артикулов и повторно читает собственные цены зарегистрированным методом. Возвращает plan_id, точные значения, контрольную сумму конфигурации, срок и approval_url. План действует 10 минут. Повтор с тем же ключом возвращает тот же план, а не новый произвольный расчёт.

1. Владелец открывает approval_url в своей сессии и проверяет товары, цены до/после, базовую цену и скидку.
2. Отправка возможна только после точного подтверждения владельца и повторной серверной проверки. Кнопка отправки — отдельное действие, не часть чтения руководства.
3. repricer.plan.get показывает состояние. repricer.reconcile проверяет загрузку и фактические цены, ничего не отправляя повторно.
4. succeeded означает совпадение подтверждённого статуса загрузки и фактической базовой цены, скидки и цены продавца. pending/unknown требуют проверки, а не слепого повторения.

Исполнитель сохраняет текущую скидку и работает с общей ценой RUB при одинаковых ценах размеров. Акции, отдельные размеры, управление персональной ценой покупателя и автоматическое следование конкуренту этим путём не поддерживаются. Возврат к старой цене — новый проверяемый план.

Причины удержания и блокировки

Методы и параметры

Параметры ниже относятся к MCP arguments. Идентичность и ключ не передаются в них. Для полного объекта config следуйте руководству домена.

{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "domain"
  ],
  "properties": {
    "domain": {
      "enum": [
        "advertising",
        "advertising-budget",
        "card-experiment",
        "catalog",
        "custom",
        "inventory-fbs",
        "pricing",
        "reputation",
        "supplies"
      ]
    }
  }
}

{
  "type": "object",
  "additionalProperties": false
}

{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "domain"
  ],
  "properties": {
    "domain": {
      "enum": [
        "advertising",
        "pricing",
        "catalog",
        "responder"
      ]
    }
  }
}

{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "domain",
    "config",
    "idempotency_key"
  ],
  "properties": {
    "domain": {
      "enum": [
        "advertising",
        "pricing",
        "catalog",
        "responder"
      ]
    },
    "config": {
      "type": "object",
      "minProperties": 1
    },
    "idempotency_key": {
      "type": "string",
      "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]{7,127}$"
    }
  }
}

{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "domain",
    "idempotency_key"
  ],
  "properties": {
    "domain": {
      "enum": [
        "advertising",
        "pricing",
        "catalog",
        "responder"
      ]
    },
    "idempotency_key": {
      "type": "string",
      "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]{7,127}$"
    }
  }
}

{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "domain",
    "idempotency_key"
  ],
  "properties": {
    "domain": {
      "enum": [
        "advertising",
        "pricing",
        "catalog",
        "responder"
      ]
    },
    "idempotency_key": {
      "type": "string",
      "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]{7,127}$"
    }
  }
}

{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "job_id"
  ],
  "properties": {
    "job_id": {
      "type": "string",
      "format": "uuid"
    }
  }
}

{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 20
    }
  }
}

{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "domain"
  ],
  "properties": {
    "domain": {
      "enum": [
        "advertising",
        "pricing",
        "catalog",
        "responder"
      ]
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  }
}

{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "reason"
  ],
  "properties": {
    "reason": {
      "type": "string",
      "minLength": 1,
      "maxLength": 500
    }
  }
}

{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "config"
  ],
  "properties": {
    "config": {
      "type": "object"
    }
  }
}

{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "target_ids",
    "idempotency_key"
  ],
  "properties": {
    "target_ids": {
      "type": "array",
      "minItems": 1,
      "maxItems": 5,
      "items": {
        "type": "string",
        "pattern": "^[0-9]+$"
      }
    },
    "idempotency_key": {
      "type": "string",
      "minLength": 8,
      "maxLength": 128
    }
  }
}

{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "plan_id"
  ],
  "properties": {
    "plan_id": {
      "type": "string"
    }
  }
}

{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "plan_id"
  ],
  "properties": {
    "plan_id": {
      "type": "string"
    }
  }
}

Связанные возможности

Репрайсер

Готовить цены с учётом экономики товара

Планы и согласование. Исполнитель согласованной цены развёрнут; реальный пилот изменения цены на WB ещё не подтверждён.