Перейти к содержимому

Проценка

Живой поиск предложений у поставщиков, привязанных к точке выдачи. Результат используют для создания заказа с позицией type: manufacturer.

Метод: POST /api/integrations/v1/pricing/searchПраво: pricing.read

Когда использовать

  • Внешняя система хочет узнать цены/наличие «как на сайте»
  • Перед POST /orders нужно выбрать поставщика, бренд, артикул и цену

Тело запроса

ПолеТипОбяз.Описание
pickup_point_idintдаАктивная точка (к ней привязаны поставщики)
articlestring≤191даАртикул
brandsstring[] (≥1)даХотя бы один бренд
storage_idsint[]нетОграничить поставщиками; иначе все привязанные
user_idint|nullнетКонтекст пользователя (скидки и т.п., если применимо)
request_idstring≤64нетИдемпотентность / трассировка на вашей стороне

Цены в сыром data адаптера зависят от поставщика. Для создания заказа передавайте цену в копейках.

bash
curl -sS -X POST "https://ВАШ_ДОМЕН/api/integrations/v1/pricing/search" \
 -H "Authorization: Bearer pp_abc123:ВАШ_СЕКРЕТ" \
 -H "Content-Type: application/json" \
 -H "Accept: application/json" \
 -d '{
 "pickup_point_id": 1,
 "article": "0986AB1234",
 "brands": ["BOSCH"]
 }'
json
{
 "ok": true,
 "pickup_point_id": 1,
 "article": "0986AB1234",
 "brands": ["BOSCH"],
 "results": [
 {
 "storage_id": 5,
 "storage_name": "Поставщик А",
 "status_code": "ok",
 "data": {
 "offers": [
 {
 "brand": "BOSCH",
 "article": "0986AB1234",
 "name": "Колодки тормозные",
 "price": 150000,
 "quantity": 12
 }
 ]
 }
 }
 ]
}

Структура внутри data зависит от адаптера поставщика — это сырой payload проценки, не единый жёсткий контракт на все склады.

Ошибки

HTTPКогда
422Нет brands; точка неактивна/не найдена; нет привязанных поставщиков
403Нет права pricing.read
401Неверный ключ

Дальше

  1. Выберите оффер (storage_id, бренд, артикул, цена)
  2. Создайте заказ: Заказы → POST /orders с type: manufacturer.
  3. Получите точку и способы оплаты/доставки: Справочники.

База знаний для EMS-платформы PlatParts.