Товари

Базова адреса для функцій роботи з даним розділом /product/.

Отримати очікувану кількість товару

GET /product/(product_uuid)/in_waiting
Query Parameters:
 
  • product_uuid – Обов’язковий ID товару

Приклад відповіді:

{
    "in_waiting": [
        {
            "uuid": "816D000C2999A7E611E6E85ACA5426DF",
            "quantity": "-",
            "name": "Принимается"
        },
        {
            "uuid": "-",
            "quantity": "> 20",
            "name": "В пути"
        }
    ]
}

Отримати залишки товару по всім складам

GET /product/(product_uuid)/in_stocks
Query Parameters:
 
  • product_uuid – Обов’язковий ID товару
  • id_type – Вказує виконувати пошук товару по ID або по коду

Приклад відповіді:

{
    "in_stocks": [
        {
            "uuid": "ACF9000C2947F7AE11E28A2B02C4AD32",
            "name": "Луцк",
            "quantity": "-"
        },
        {
            "uuid": "816D000C2999A7E611E6EC6B4A1915AF",
            "name": "Киев",
            "quantity": "1"
        },
        {
            "uuid": "816F000C2999A7E611E6FF21C30463AF",
            "name": "Львов",
            "quantity": "-"
        },
        {
            "uuid": "817D000C2999A7E611E73FA5C76CC5F8",
            "name": "Хмельницкий",
            "quantity": "-"
        }
    ]
}

Отримати ціну товару в основних валютах

GET /product/(product_uuid)/prices
Query Parameters:
 
  • product_uuid – Обов’язковий ID товару
  • id_type – Вказує виконувати пошук товару по ID або по коду

Приклад відповіді:

{
  "prices": [
    {
      "currency_name": "ГРН", 
      "price": 1420.188
    }, 
    {
      "currency_name": "USD", 
      "price": 50.912
    }, 
    {
      "currency_name": "EUR", 
      "price": 44.66
    }
  ]
}

Отримати актуальну ціну товару

GET /product/(product_uuid)/price
Query Parameters:
 
  • product_uuid – Обов’язковий ID товару
  • currency – ID Валюти для відображення ціни. За замовчуванням, валюта основного договору.
  • id_type – Вказує виконувати пошук товару по ID або по коду

Приклад відповіді:

{
    "price": "10.00",
    "currency_name": "EUR",
}

Отримати інформацію по товару

GET /product/(string: product_uuid)
Query Parameters:
 
  • product_uuid – Обов’язковий ID товару
  • warehouses – ID складів по яким вертати залишки: &warehouses=816D000C2999A7E611E6EC6B4A1915AF&warehouses=ACF9000C2947F7AE11E28A2B02C4AD32. Значення all верне залишки по всім складам. За замовчуванням, вертає залишки для основного складу.
  • currency – ID Валюти для відображення ціни. За замовчуванням, валюта основного договору.
  • id_type – Вказує виконувати пошук товару по ID або по коду
  • products_as – Формат товарів які повертаються. Можливі варіанти: obj, arr. За замовчуванням, obj.
  • q – Пошукова фраза для збереження в історію пошуку.
  • save – Прапорець збереження запиту в історію пошуку. За замовчуванням, True. Збереження вимагає заповненого значення параметра q.
  • promos – Якщо передати значення full, додасть в відповідь ключ promos_full з інформацією про акції, в яких товар бере участь.
  • oe – Формат поля що повертається oe. Можливі варіанти: short - вертає тільки номери, full - повертає додатково конструкційний брендю. За замовчуванням, short.
  • output_field – Вказує параметр, який потрібно повернути. Можливі варіанти: all, analogs, cars, oe, buy_with, paired_products, components_of_kit, files. За замовчуванням, all.
  • analogs_available – Не повертати товари-аналоги, яких немає в наявності. Можливі варіанти: 1, 0 (1 - true, 0 - false). За замовчуванням, 0.

Приклад відповіді:

{
  "product": {
    "uuid": "80048E1C4209BF3D4AFC0F154A5C9701",
    "promos": [],
    "article": "534 0417 10",
    "brand": "INA",
    "name": "Натяжитель ремня генератора Hyundai Accent/Kia Cerato 1.6 CVVT 04-",
    "default_image": "photo\h\x\c\g\b\a60c9479.jpeg",
    "images": [
      "photo\h\x\c\g\b\a60c9479.jpeg"
    ],
    "promotion": true,
    "special_offer": false,
    "tools": false,
    "new_product": false,
    "nodes": "ДВИГАТЕЛЬ/Ременный привод, составляющие/Поликлиновой  ремень, составляющие/Натяжитель ремня генератора",
    "oe": [],
    "cars": [],
    "weight": 1.02,
    "description": "",
    "barcodes": [
      "4005108804495",
      "4005108541215",
      "4005108350992",
      "4005108527790",
      "4005108351869",
      "4005108844125",
      "4005108613028",
      "4005108556608",
      "4005108560209"
    ],
    "price": "2271.30",
    "currency_name": "ГРН",
    "in_stocks": [
      {
        "name": "Луцк",
        "short_name": "Лцк"
        "uuid": "ACF9000C2947F7AE11E28A2B02C4AD32",
        "quantity": "-",
        "contract_quantities": [
          {
            "f": 0,
            "quantity": "-"
          },
          {
            "f": 1,
            "quantity": "-"
          }
        ]
      }
    ],
    "analogs": {
      "A80DE81B3891086049C2F8742A0524BB": {
        "special_offer": false,
        "name": "Ролик генератора Hyundai Accent/Kia Cerato 1.6 CVVT 04- (натяжной)",
        "default_image": "photo\v\x\f\w\t\a44417e6.jpeg",
        "new_product": false,
        "tools": false,
        "brand": "MAGNETI MARELLI",
        "promos":[],
        "article": "331316171229",
        "promotion": false,
        "in_stocks": [
          {
            "name": "Луцк",
            "short_name": "Лцк",
            "uuid": "ACF9000C2947F7AE11E28A2B02C4AD32",
            "quantity": "1",
            "contract_quantities": [
              {
                "f": 0,
                "quantity": "1"
              },
              {
                "f": 1,
                "quantity": "1"
              }
            ]
          }
        ],
        "in_others": {
          "uuid": "-",
          "name": "На других",
          "quantity": "-"
        },
        "in_waiting": {
          "uuid": "-",
          "name": "Ожидается",
          "quantity": "1"
        },
        "available": true,
        "price": "188.64",
        "currency_name": "ГРН",
        "found_by": null,
        "in_cart": null
      }
    },
    "buy_with": null,
    "paired_products": null,
    "in_cart": null,
    "in_others": {
      "uuid": "-",
      "name": "На других",
      "quantity": "-"
    },
    "in_waiting": {
      "uuid": "-",
      "name": "Ожидается",
      "quantity": "2"
    },
    "available": false,
    "found_by": null,
    "components_of_kit": [
        {
            "description": "Болтик",
            "article": "115 906 1"
        },
        {
            "description": "Гаечка",
            "article": "115 906 2"
        }
    ],
    "files": [
        {
            "name": "Інструкція з монтажу",
            "url": "https://example.com/instruction.pdf",
            "type": "link"
        }
    ],
    "details": {
      "Наружный диаметр [мм]": "76,00",
      "Ширина [мм]": "26,00",
      "SVHC": "Не содержит особо опасных веществ!"
    }
  },
  "headers": [
    {
      "warehouse": "Луцьк",
      "short_name": "Лцк",
      "labels": [
        "Все",
        "ДАГ"
      ]
    }
  ]
}

В випадку якщо по ID товар не знайдено, буде повернуто відповіть 404 NOT FOUND. В випадку якщо product_uuid задано не вірно, буде повернуто відповідь 422 UNPROCESSABLE ENTITY