Прайс-листы
Импорт файла в модуль Прайс-листы панели управления (позиции для проценки через поставщика «Обычный прайс-лист»).
Это не каталог наличия. Файл через эти методы не создаёт и не обновляет карточки в Каталог → Товары.
| Задача | Что использовать |
|---|---|
| Файл в модуль Прайс-листы (проценка) | Этот раздел: POST /price-lists/upload |
| Товары / остатки каталога наличия | Каталог и остатки — products/batch-upsert, stocks/batch-update (JSON, не файл прайса) |
Право: price_lists.write (и для upload, и для status)
Прайс-лист (price_list_id) должен уже существовать и быть активным — создаётся в панели управления: Прайс-листы → Прайс-листы, не через этот API.
Загрузить файл
POST /price-lists/upload — multipart/form-data
| Поле | Тип | Обяз. | Описание |
|---|---|---|---|
price_list_id | int | да | Id активного прайс-листа из модуля «Прайс-листы» |
document | file | да | Файл прайса |
| HTTP | Когда |
|---|---|
422 | Неактивный прайс / файл слишком большой / ошибка сохранения |
403 | Нет права |
200: { "ok": true, "task_id": 123, "status": "pending" } Возможные status: pending | processing | completed | failed.
curl -sS -X POST "https://ВАШ_ДОМЕН/api/integrations/v1/price-lists/upload" \
-H "Authorization: Bearer pp_abc123:ВАШ_СЕКРЕТ" \
-F "price_list_id=3" \
-F "document=@./price.xlsx"{
"ok": true,
"task_id": 123,
"status": "pending"
}Статус задачи
POST /price-lists/status — price_lists.write
Тело: { "task_id": 123 }404 — задача не найдена.
curl -sS -X POST "https://ВАШ_ДОМЕН/api/integrations/v1/price-lists/status" \
-H "Authorization: Bearer pp_abc123:ВАШ_СЕКРЕТ" \
-H "Content-Type: application/json" \
-d '{"task_id":123}'{
"ok": true,
"task_id": 123,
"price_list_id": 3,
"status": "completed",
"file_name": "price.xlsx"
}Отличие от каталога наличия
| Способ | Куда попадают данные |
|---|---|
POST /price-lists/upload | Модуль Прайс-листы → строки прайса → проценка через «Обычный прайс-лист» |
| POST /products/batch-upsert + POST /stocks/batch-update | Каталог наличия (карточки товаров, остатки и цены по точке/складу) |
Файл в Прайс-листы в каталог наличия не попадает — это два разных механизма в PlatParts.