AVGifts — corporate gifts with logo

Поиск товаров каталога avgifts по словам и фильтрам. Возвращает компактный список: id, название, артикул, цена за шт (₽, НДС внутри), наличие, цвет, материал, виды нанесения, картинка, ссылка. Для подбора под тираж передавайте min_stock = тираж. Детали и места нанесения — get_product.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Что ищем: «термокружка 450 мл», «худи оверсайз», «ручка металлическая»"
    },
    "category_id": {
      "type": "integer",
      "description": "Раздел каталога (см. list_categories), включая подразделы"
    },
    "price_min": {
      "type": "number",
      "description": "Цена за шт от, ₽"
    },
    "price_max": {
      "type": "number",
      "description": "Цена за шт до, ₽"
    },
    "color": {
      "type": "string",
      "enum": [
        "black",
        "white",
        "gray",
        "red",
        "orange",
        "yellow",
        "green",
        "blue",
        "purple",
        "pink",
        "brown",
        "beige"
      ],
      "description": "Базовый цвет изделия"
    },
    "min_stock": {
      "type": "integer",
      "description": "Нужное количество в наличии на складе (тираж)"
    },
    "print_method": {
      "type": "string",
      "description": "Вид нанесения по названию: «лазерная гравировка», «УФ-печать», «шелкография», «тиснение», «вышивка», «DTF»… (см. list_print_methods)"
    },
    "eco": {
      "type": "boolean",
      "description": "Только эко-товары"
    },
    "new": {
      "type": "boolean",
      "description": "Только новинки"
    },
    "sort": {
      "type": "string",
      "enum": [
        "relevance",
        "price_asc",
        "price_desc",
        "new",
        "stock"
      ],
      "description": "Сортировка (по умолчанию — релевантность/наличие)"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "description": "Позиций за запрос (до 50)"
    },
    "page": {
      "type": "integer",
      "minimum": 1,
      "description": "Страница выдачи"
    }
  }
}

Полная карточка товара: описание, цена, наличие, размеры/цвета (варианты), места нанесения с максимальными размерами и доступными видами нанесения (код, название, мин. тираж, срок). place_id и code из ответа передавайте в calc_print.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "description": "id товара из search_products"
    },
    "article": {
      "type": "string",
      "description": "Или артикул avgifts"
    },
    "url": {
      "type": "string",
      "description": "Или ссылка на карточку avgifts.ru/product/…"
    }
  }
}

Точная стоимость нанесения логотипа на товар — тем же калькулятором, что на сайте: цена за шт, приладка (разово на тираж), срок производства; плюс стоимость самого товара и итог за штуку и за тираж. Мест может быть несколько.

{
  "type": "object",
  "properties": {
    "product_id": {
      "type": "integer"
    },
    "quantity": {
      "type": "integer",
      "minimum": 1,
      "description": "Тираж, шт"
    },
    "prints": {
      "type": "array",
      "minItems": 1,
      "maxItems": 10,
      "items": {
        "type": "object",
        "required": [
          "place_id",
          "width_cm",
          "height_cm"
        ],
        "properties": {
          "place_id": {
            "type": "integer",
            "description": "Место нанесения из get_product"
          },
          "method": {
            "type": "string",
            "description": "Код вида нанесения из get_product (или его название)"
          },
          "width_cm": {
            "type": "number",
            "description": "Ширина логотипа, см"
          },
          "height_cm": {
            "type": "number",
            "description": "Высота логотипа, см"
          }
        }
      }
    }
  },
  "required": [
    "product_id",
    "quantity",
    "prints"
  ]
}

Разделы каталога avgifts (id, название, ссылка). Без parent_id — верхний уровень, с parent_id — подразделы.

{
  "type": "object",
  "properties": {
    "parent_id": {
      "type": "integer"
    }
  }
}

Справочник видов нанесения: название, коды тарифов, минимальный тираж, срок производства, особенности. Название можно передать в search_products.print_method.

{
  "type": "object",
  "properties": {}
}