Public API

Получить список позиций КТРУ с пагинацией и фильтрацией

Query параметры:

Пример ответа:

{
  "count": 77000,
  "next": "https://moy-zakupki.ru/api/public/v2/ktru/?page=2",
  "previous": null,
  "results": [
    {
      "code": "01.11.11.110-00000001",
      "name": "Пшеница продовольственная",
      "shortname": "Пшеница",
      "status": "Включено в КТРУ",
      "is_enlarged": false,
      "okpd2_code": "01.11.11",
      "okpd2_name": "Выращивание зерновых культур",
      "unit_name": "тонн",
      "characteristics_count": 3
    }
  ]
}

Получить детальную информацию о позиции КТРУ, включая характеристики и ограничения

Пример ответа:

{
  "code": "26.20.11.110-00000165",
  "name": "Компьютеры портативные массой не более 10 кг",
  "shortname": "Ноутбук",
  "description": "...",
  "status": "Включено в КТРУ",
  "is_enlarged": false,
  "okpd2_code": "26.20.11",
  "okpd2_name": "Компьютеры портативные",
  "unit_name": "шт",
  "characteristics": [
    {
      "key": "Диагональ экрана",
      "values": ["13.3", "15.6", "17.3"]
    }
  ],
  "limitations": [
    {
      "name": "Ограничение по цене",
      "group": "price"
    }
  ],
  "last_version": {
    "version": 3,
    "publish_date": "2024-10-15",
    "application_date_start": "2024-11-01",
    "inclusion_date": "2024-10-15"
  }
}

Поиск КТРУ по характеристикам

Request body:

{
  "characteristics": ["мощность", "размер диагонали:27"],
  "status": "Включено в КТРУ",
  "is_enlarged": false
}

Поля status и is_enlarged необязательные. Характеристики можно передавать как ключевые слова или пары "ключ:значение".

Получить список кодов ОКПД-2 с пагинацией и фильтрацией

Query параметры:

Пример ответа:

{
  "count": 20372,
  "next": "https://moy-zakupki.ru/api/public/v2/okpd2/?page=2",
  "previous": null,
  "results": [
    {
      "code": "01.11.11",
      "name": "Выращивание зерновых культур",
      "level": 5,
      "parent_code": "01.11",
      "is_actual": true
    }
  ]
}

Получить детальную информацию о коде ОКПД-2, включая дочерние коды и ограничения

Пример ответа:

{
  "code": "01.11",
  "name": "Выращивание зерновых и зернобобовых культур",
  "level": 4,
  "parent_code": "01",
  "is_actual": true,
  "children": [
    {
      "code": "01.11.11",
      "name": "Выращивание зерновых культур",
      "level": 5
    }
  ],
  "limitations": [
    {
      "name": "Ограничение",
      "group": "regulatory"
    }
  ],
  "ktru_count": 42
}

Список ваших ТЗ без позиций — быстрый, подходит для регулярной синхронизации.

Query параметры:

Полная структура: позиции, коды ОКПД-2/КТРУ и характеристики.

Пример ответа:

{
  "id": "3f1c…",
  "name": "Закупка лестниц",
  "status": "ready",
  "products_count": 2,
  "products": [
    {
      "position": 1,
      "name": "Лестница алюминиевая трёхсекционная",
      "quantity": "5.00",
      "unit": "шт",
      "is_included": true,
      "ktru_code": "25.99.29.190-00000123",
      "okpd2_code": "25.99.29.190",
      "characteristics": [
        {
          "name": "Объем встроенного накопителя",
          "unit": "Гигабайт",
          "source": "ktru",
          "is_included": true,
          "values": [
            {
              "value": "512",
              "display": "≥ 512",
              "requirement_type": "range",
              "range_type": "greater_or_equal",
              "extra_value": null,
              "extra_range_type": null
            }
          ]
        }
      ]
    }
  ]
}

Ставит генерацию в очередь. Списывает одну генерацию за каждую позицию в items.

Тело запроса:

{
  "items": [
    {
      "product_name": "Ноутбук офисный",
      "product_code": "26.20.13.000-00000002",
      "quantity": 5,
      "unit": "шт"
    }
  ]
}

Обязательно только product_name. Остальное необязательно: product_code — код КТРУ или ОКПД2 (классификатор определяется самим кодом: у позиции КТРУ есть номер через дефис), max_resources (1–20, по умолчанию 5) и max_sites (1–10, по умолчанию 3) управляют широтой поиска источников. Блок settings с header и footer задаёт шапку и подвал документа.

Ответ 201:

{
  "id": "8c2e…",
  "status": "processing",
  "progress": 0,
  "is_finished": false,
  "product_name": "Ноутбук офисный",
  "tech_spec_id": "3f1c…",
  "error": null,
  "generation_quota_remaining": 47
}

Статус запуска. Опрашивайте раз в 10 секунд, пока is_finished не станет true: бесплатный ключ даёт 10 запросов в минуту на всё, и частый опрос упрётся в 429. Генерация занимает около полутора минут, в тяжёлых случаях — до шести.

Список всех ваших запусков — GET /api/public/v2/tech-spec-generations/.

Полный цикл

import time, requests

H = {"Authorization": "Api-Key mz_live_…"}
BASE = "https://moy-zakupki.ru/api/public/v2"

def is_quota_refusal(r):
    """429 с полем error — кончилась квота: ждать бесполезно."""
    try:
        return "error" in r.json()
    except ValueError:  # 429 от прокси приходит HTML-страницей
        return False

def call(method, path, **kwargs):
    """Запрос с повтором, пока действует лимит запросов в минуту."""
    while True:
        r = requests.request(method, f"{BASE}{path}", headers=H, timeout=60, **kwargs)
        if r.status_code != 429 or is_quota_refusal(r):
            return r
        time.sleep(int(r.headers.get("Retry-After", 10)))

# 1. Запускаем генерацию
r = call("POST", "/tech-spec-generations/", json={
    "items": [{"product_name": "Ноутбук офисный", "quantity": 5, "unit": "шт"}]
})
if r.status_code == 429:  # insufficient_generation_quota
    raise SystemExit(r.json()["detail"])
r.raise_for_status()  # 400, 401 и прочие отказы
task = r.json()

# 2. Ждём завершения — не чаще раза в 10 секунд
while not task["is_finished"]:
    time.sleep(10)
    r = call("GET", f"/tech-spec-generations/{task['id']}/")
    r.raise_for_status()
    task = r.json()

if task["status"] == "failed":
    raise RuntimeError(task["error"])

# 3. Забираем готовое ТЗ
r = call("GET", f"/tech-specs/{task['tech_spec_id']}/")
r.raise_for_status()
spec = r.json()
print(spec["name"], spec["products_count"])

Принимает документ и ставит распознавание в очередь. Передайте что-то одно: файл или текст.

# Файл
curl -X POST "https://moy-zakupki.ru/api/public/v2/product-imports/" \
  -H "Authorization: Api-Key mz_live_ваш_ключ" \
  -H "Idempotency-Key: spec-2026-09-27-01" \
  -F file=@spec.pdf

# Текст
curl -X POST "https://moy-zakupki.ru/api/public/v2/product-imports/" \
  -H "Authorization: Api-Key mz_live_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{"text": "1. Ноутбук — 5 шт. Диагональ не менее 15,6 дюйма, ОЗУ не менее 16 ГБ\n2. Мышь беспроводная — 5 шт."}'

# Дописать в конец своего ТЗ
curl -X POST "https://moy-zakupki.ru/api/public/v2/product-imports/" \
  -H "Authorization: Api-Key mz_live_ваш_ключ" \
  -F file=@spec.xlsx \
  -F tech_spec_id=3f1c2b7a-5d4e-4f60-9a8b-7c6d5e4f3a21

Не принимаются .doc и .xls (пересохраните в .docx, .xlsx или PDF), файлы с макросами и защищённые паролем. Сканы в PDF распознаются; Word-файл, где вместо текста картинки, — нет: загрузите его как PDF.

Ответ 201 с заголовком Location:

{
  "id": "5b0e2c7a-…",
  "status": "pending",
  "is_finished": false,
  "stage": "",
  "progress": 0,
  "source": {
    "type": "pdf",
    "filename": "spec.pdf",
    "size_bytes": 184320,
    "pages": 4,
    "chars": null,
    "is_scan": false
  },
  "products_count": 0,
  "products_extracted": 0,
  "codes": {"linked": 0, "not_found": 0, "not_in_document": 0},
  "tech_spec_id": null,
  "target_tech_spec_id": null,
  "error_code": null,
  "error": null,
  "warnings": [],
  "skipped_count": 0,
  "quota_refunded": false,
  "resumed_after_auth": false,
  "created_at": "2026-09-27T10:15:02.114000+00:00",
  "finished_at": null,
  "poll_after_seconds": 10,
  "import_quota": {
    "used": 1,
    "limit": 5,
    "available": 4,
    "resets_at": "2026-10-01T00:00:00+03:00",
    "pages_per_import": 10,
    "plan": "free"
  }
}

source.pages — сколько страниц засчитано. У PDF и текста они известны сразу, у Word и Excel — после разбора, поэтому до завершения там null.

Статус загрузки, после завершения — товары. Опрашивайте не чаще раза в poll_after_seconds секунд (10), пока is_finished не станет true: бесплатный ключ даёт 10 запросов в минуту на всё.

Пример ответа после завершения:

{
  "id": "5b0e2c7a-…",
  "status": "completed",
  "is_finished": true,
  "stage": "done",
  "progress": 100,
  "source": {"type": "pdf", "filename": "spec.pdf", "size_bytes": 184320,
             "pages": 4, "chars": 6953, "is_scan": false},
  "products_count": 2,
  "products_extracted": 2,
  "codes": {"linked": 2, "not_found": 0, "not_in_document": 0},
  "tech_spec_id": "3f1c…",
  "error_code": null,
  "error": null,
  "warnings": [],
  "skipped_count": 0,
  "quota_refunded": false,
  "resumed_after_auth": false,
  "created_at": "2026-09-27T10:15:02.114000+00:00",
  "finished_at": "2026-09-27T10:16:31.402000+00:00",
  "poll_after_seconds": null,
  "products": [
    {
      "id": "a91d…",
      "position": 1,
      "name": "Ноутбук",
      "unit": "шт",
      "quantity": 5.0,
      "code": {
        "as_written": "26.20.11.110-00000165",
        "ktru_code": "26.20.11.110-00000165",
        "okpd2_code": "26.20.11.110",
        "match": "ktru_exact"
      },
      "characteristics": [
        {"name": "Диагональ экрана", "value": "≥ 15.6", "unit": "дюйм", "by_ktru": true},
        {"name": "Объем оперативной памяти", "value": "не менее 16", "unit": "Гигабайт", "by_ktru": true},
        {"name": "Тип накопителя", "value": "SSD", "unit": null, "by_ktru": false}
      ],
      "notes": ["Характеристик сопоставлено с КТРУ: 2 из 3."]
    },
    {
      "id": "c07b…",
      "position": 2,
      "name": "Мышь компьютерная беспроводная",
      "unit": "шт",
      "quantity": 5.0,
      "code": {
        "as_written": "26.20.16.170-00000999",
        "ktru_code": null,
        "okpd2_code": "26.20.16.170",
        "match": "ktru_not_found_okpd2_from_prefix"
      },
      "characteristics": [
        {"name": "Тип подключения", "value": "беспроводное", "unit": null, "by_ktru": false}
      ],
      "notes": ["Код КТРУ «26.20.16.170-00000999» не найден; привязан ОКПД2 26.20.16.170."]
    }
  ]
}

Ваши загрузки, новые сверху, без товаров. Параметры page и per_page (до 50), фильтры status (например, completed) и created_after (2026-09-01 или ISO 8601 с временем); ответ — в обычной пагинации. Загрузки из личного кабинета здесь тоже видны.

Форматы, лимиты тарифов и расход загрузок этого месяца. Удобно проверить до отправки большого документа.

{
  "formats": [".pdf", ".docx", ".xlsx", ".txt", "text"],
  "max_file_bytes": 20971520,
  "chars_per_page": 1800,
  "free": {"monthly_imports": 5, "pages_per_import": 10},
  "paid": {"monthly_imports": 50, "pages_per_import": 50},
  "import_quota": {
    "used": 1,
    "limit": 5,
    "available": 4,
    "resets_at": "2026-10-01T00:00:00+03:00",
    "pages_per_import": 10,
    "plan": "free"
  }
}

Ошибки загрузки

Отказ приходит в одной форме: {"error": "<код>", "detail": "<пояснение>"}. Ни один отказ не списывает загрузку.

429 без поля error — это лимит запросов в минуту: подождите Retry-After секунд и повторите. У Word и Excel страницы считаются уже при разборе, поэтому лишние страницы в них приходят не 422, а статусом rejected с error_code: "too_many_pages".

Полный цикл

import time, uuid, requests

H = {"Authorization": "Api-Key mz_live_…"}
BASE = "https://moy-zakupki.ru/api/public/v2"

def is_quota_refusal(r):
    """429 с полем error — кончилась квота: ждать бесполезно."""
    try:
        return "error" in r.json()
    except ValueError:  # 429 от прокси приходит HTML-страницей
        return False

def call(method, path, headers=None, **kwargs):
    """Запрос с повтором, пока действует лимит запросов в минуту."""
    while True:
        r = requests.request(method, f"{BASE}{path}", headers={**H, **(headers or {})},
                             timeout=120, **kwargs)
        if r.status_code != 429 or is_quota_refusal(r):
            return r
        time.sleep(int(r.headers.get("Retry-After", 10)))

# 1. Загружаем файл. Ключ идемпотентности — один на документ:
#    повтор с ним после обрыва сети не спишет вторую загрузку.
with open("spec.pdf", "rb") as fh:
    data = fh.read()
key = str(uuid.uuid4())

r = call("POST", "/product-imports/", headers={"Idempotency-Key": key},
         files={"file": ("spec.pdf", data)})
if r.status_code == 429:  # import_quota_exceeded
    body = r.json()
    raise SystemExit(f"{body['detail']} Тарифы: https://moy-zakupki.ru{body['payment_url']}")
if r.status_code not in (200, 201):  # 400, 409, 413, 415, 422, 500 — не списано
    raise SystemExit(f"{r.status_code}: {r.text[:500]}")
job = r.json()

# 2. Ждём завершения — не чаще, чем просит сервер
while not job["is_finished"]:
    time.sleep(job["poll_after_seconds"] or 10)
    r = call("GET", f"/product-imports/{job['id']}/")
    r.raise_for_status()
    job = r.json()

# 3. Результат
if job["status"] in ("failed", "rejected"):  # загрузка возвращена в квоту
    raise SystemExit(f"{job['error_code']}: {job['error']}")
for warning in job["warnings"]:
    print("Внимание:", warning)
if not job["products"]:
    print(job["error"])  # «В документе не найдено товаров» — тоже не списано

for p in job["products"]:
    code = p["code"]["ktru_code"] or p["code"]["okpd2_code"] or "без кода"
    print(f"{p['position']}. {p['name']} — {p['quantity']:g} {p['unit']} [{code}]")
    for c in p["characteristics"]:
        print(f"    {c['name']}: {c['value']} {c['unit'] or ''}")
    for note in p["notes"]:
        print(f"    ! {note}")

Python (requests)

import requests

API_KEY = "mz_live_ваш_ключ"
BASE_URL = "https://moy-zakupki.ru/api/public/v2"
HEADERS = {"Authorization": f"Api-Key {API_KEY}"}

# Получить список КТРУ
response = requests.get(
    f"{BASE_URL}/ktru/",
    headers=HEADERS,
    params={"status": "Включено в КТРУ", "per_page": 10}
)
data = response.json()
print(f"Всего записей: {data['count']}")
for item in data["results"]:
    print(f"  {item['code']} — {item['name']}")

# Получить детали по коду
response = requests.get(
    f"{BASE_URL}/ktru/26.20.11.110-00000165/",
    headers=HEADERS
)
detail = response.json()
print(f"Характеристик: {len(detail['characteristics'])}")

JavaScript (Fetch API)

const API_KEY = "mz_live_ваш_ключ";
const BASE_URL = "https://moy-zakupki.ru/api/public/v2";

// Получить список КТРУ
const response = await fetch(
  `${BASE_URL}/ktru/?status=Включено+в+КТРУ&per_page=10`,
  { headers: { "Authorization": `Api-Key ${API_KEY}` } }
);
const data = await response.json();
console.log(`Всего записей: ${data.count}`);
data.results.forEach(item =>
  console.log(`  ${item.code} — ${item.name}`)
);

// Получить детали ОКПД-2
const okpdResponse = await fetch(
  `${BASE_URL}/okpd2/26.20.11/`,
  { headers: { "Authorization": `Api-Key ${API_KEY}` } }
);
const okpd = await okpdResponse.json();
console.log(`Дочерних кодов: ${okpd.children.length}`);

cURL

# Список КТРУ
curl "https://moy-zakupki.ru/api/public/v2/ktru/?per_page=5" \
  -H "Authorization: Api-Key mz_live_ваш_ключ"

# Детали КТРУ по коду
curl "https://moy-zakupki.ru/api/public/v2/ktru/26.20.11.110-00000165/" \
  -H "Authorization: Api-Key mz_live_ваш_ключ"

# Список ОКПД-2 (уровень 3)
curl "https://moy-zakupki.ru/api/public/v2/okpd2/?level=3&per_page=10" \
  -H "Authorization: Api-Key mz_live_ваш_ключ"

# Поиск КТРУ по характеристикам
curl -X POST "https://moy-zakupki.ru/api/public/v2/ktru/search/" \
  -H "Authorization: Api-Key mz_live_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{"characteristics": ["мощность", "напряжение:220"]}'