Корзини і замовлення

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

Отримати деталізовану інформацію про товари зі списку резервів

POST /shopping/reserve/products/detailed
Query Parameters:
 
  • reserves_uuid – Масив резервів.

Приклад даних запиту:

{
  "reserves_uuid": ["8166005056A44C2211EA23055666E5EA"]
}

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

{
  "reserved_products": [
    {
      "uuid": "81C8005756BA39E8xxxE6131F90FC2D6",
      "can_edit_delivery": true,
      "number": "ДГ008379xxx",
      "date": "2023-10-02T17:42:56Z",
      "sum": 260.28,
      "shipping_date": "0001-01-01T00:00:00Z",
      "currency": "ГРН",
      "comment": "",
      "status": "В резерві",
      "carrier": "Самовивіз",
      "delivery_date": "0001-01-01T00:00:00Z",
      "delivery_setting": "Самовывоз, XXXX XXX XXX, Луцьк",
      "route": "",
      "route_date": "0001-01-01T00:00:00Z",
      "warehouse": {
        "name": "Луцьк",
        "uuid": "ACF9000C2947F7AxxxE28A2B02C4AD32"
      },
      "owner": {
        "uuid": "92E4005056BAAxxx11ED029410150D0B",
        "name": "XXXXX XXXXX [0000xxxxx]",
        "f": 1
      },
      "products": [
        {
          "uuid": "A153ED96C522A33F42B1A3xxxx6515E5",
          "code": "00011xxxx",
          "article": "302011",
          "brand": "SOLGY",
          "name": "Скло дзеркала (з рамкою) MB Vito (W638) 96-",
          "default_image": "photo\j\u\t\d\a\961caa0d.jpeg",
          "count": 1,
          "multiplicity": 1,
          "price": 260.28,
          "sum": 260.28,
          "restricted_delivery": [
            {
              "uuid": "B4466E1779A2E30B435620CEA0330826",
              "name": "Нова Пошта"
            }
          ],
          "is_paid_delivery": false
        }
      ]
    }
  ]
}

Видалити всі товари зі списку обраних.

DELETE /shopping/wishlist/all_products

При успішному відпрацюванні запиту повернеться відповідь зі статусом 200:

Якщо список обраних товарів порожній і при цьому відбувся запит на видалення, то повернеться відповідь зі статусом 404:

{
  "success": false,
  "message": "Список обраних товарів порожній.",
  "documentation_url": "https://developer.bm.parts/api/v2/"
}

Видалити вибрані товари зі списку обраних.

DELETE /shopping/wishlist/products

Приклад запиту:

{
  "product_uuids": [
    "82339E5CAE8D74EF4E96D400EB83E646"
  ]
}

При успішному відпрацюванні запиту повернеться відповідь зі статусом 200:

{
  "success": true,
  "message": "Товари успішно видалено."
}

При відсутності параметра product_uuids або відсутності значень в ньому повернеться відповідь зі статусом 422:

{
  "success": false,
  "message": "Не передано product_uuids",
  "documentation_url": "https://developer.bm.parts/api/v2/"
}

Отримати товари зі списку резервів

POST /shopping/reserve/products
Query Parameters:
 
  • reserves_uuid – Масив резервів.

Приклад даних запиту:

{
  "reserves_uuid": ["8166005056A44C2211EA23055666E5EA"]
}

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

{
  "reserved_products": [
    {
      "uuid": "81C8005756BA39E8xxxE6131F90FC2D6",
      "number": "ДГ008379xxx",
      "date": "2023-10-02T17:42:56Z",
      "sum": 260.28,
      "shipping_date": "0001-01-01T00:00:00Z",
      "currency": "ГРН",
      "comment": "",
      "status": "В резерві",
      "carrier": "Самовивіз",
      "delivery_date": "0001-01-01T00:00:00Z",
      "delivery_setting": "Самовывоз, XXXX XXX XXX, Луцьк",
      "route": "",
      "route_date": "0001-01-01T00:00:00Z",
      "warehouse": {
        "name": "Луцьк",
        "uuid": "ACF9000C2947F7AxxxE28A2B02C4AD32"
      },
      "owner": {
        "uuid": "92E4005056BAAxxx11ED029410150D0B",
        "name": "XXXXX XXXXX [0000xxxxx]",
        "f": 1
      },
      "products": [
        {
          "uuid": "A153ED96C522A33F42B1A3xxxx6515E5",
          "code": "00011xxxx",
          "article": "302011",
          "brand": "SOLGY",
          "name": "Скло дзеркала (з рамкою) MB Vito (W638) 96-",
          "default_image": "photo\j\u\t\d\a\961caa0d.jpeg",
          "count": 1,
          "multiplicity": 1,
          "price": 260.28,
          "sum": 260.28
        }
      ]
    }
  ]
}

Попередження

Увага! Даний метод є застарілим і буде видалений 19.10.2023.

Зарезервувати замовлення

POST /shopping/reserve/process
Query Parameters:
 
  • order_uuid – ID замовлення.
  • comment – Текст коментаря.
  • warehouse_uuid – ID складу.
 
{
  "result": true,
  "error": null,
  "uuid": "5e9ec625-753c-11e8-8124-005056ac1ea9",
  "analysis": [
    {
      "uuid": "42a29ed4-b44b-457c-bd39-999894ee1ed4",
      "code": "000056032",
      "article": "12635",
      "name": "Датчик давления масла Renault Kangoo 1.2-1.9 97- (0.9 bar) (серый) ",
      "brand_code": 330,
      "brand_name": "FAE",
      "planned": 4,
      "reserved": 0
    }
  ],
  "download_unreserved": "https://api.bm.parts/shopping/download/unreserved",
  "saved_unshipped": {
    "name": "Незарезервированый товар по корзине  124",
    "position_quantity": 1,
    "sum": 7.56,
    "currency_name": "EUR",
    "uuid": "9506a6e0-fd9a-4a22-bc61-6af89842c75c"
  },
  "owner": {
    "uuid": "81Exxx",
    "name": "User Name",
    "f": 1
  }
}

Зберегти невідвантажені товари в корзину

POST /shopping/create/unshipped
Query Parameters:
 
  • products – Список невідвантажених товарів. Приклад: [{“uuid”: “”, “quantity”: 2}]
  • cart_name – Назва корзини (опціонально)

Попередження

Увага! Даний метод є застарілим і буде видалений в найближчих релізах. Використовуйте Створити корзину.

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

{
  "cart": {
    "uuid": "86b2a08541f94974a9fd200ba189b2df",
    "warehouse": {
      "uuid": "ACF9000C2947F7AE11E28A2B02C4AD32",
      "name": "Луцк"
    },
    "products_count": 1,
    "weight": 23.2,
    "total": 144.0,
    "products": [
      {
        "price": 36.0,
        "position_total": 144.0,
        "product": {
          "brand": {
            "uuid": "812C000C2999A7E611E55EBAE141FA90",
            "name": "KYB"
          },
          "uuid": "A358000C2947F7AE11E23F6078EDBDF7",
          "article": "335810",
          "default_image": "photo/f/b/q/h/b/e10e98e2.jpeg",
          "name": "Амортизатор (передний) MB Sprinter 208-316/VW LT 28-35 96-"
        },
        "quantity": 4.0,
        "weight": 5.8
      }
    ],
    "name": "Неотгруженные_14_19__22_06_2018"
  }
}

Примітка

Метод вертає створену корзину з товарами.

Шаблони імпорту

GET /shopping/import/template

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

{
  "import_types": [
    {
      "import_type": "article",
      "name": "Артикул-Бренд-Количество",
      "columns": [
        "article",
        "brand",
        "quantity"
      ]
    },
    {
      "import_type": "code",
      "name": "Код-Количество",
      "columns": [
        "code",
        "quantity"
      ]
    },
    {
      "import_type": "uuid",
      "name": "ID товара-Количество",
      "columns": [
        "uuid",
        "quantity"
      ]
    }
  ]
}

Зберегти налаштування імпорту

POST /shopping/import/settings
Query Parameters:
 
  • import_type – Артикул, бренд, к-сть.
  • name – Назва налаштування.
  • article – Якщо задано тип - Артикул
  • brand – Якщо задано тип - Бренд
  • code – Якщо задано тип - Код
  • UUID – Якщо задано тип - UUID
  • quantity – Колонка кількість

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

Успix:
    Статус: 201;
    Повідомлення:
        {
          message: "Конфігурація успішно створена"
        }

Невдача:
    Статус: 422;
    Повідомлення:
        {
          message: "Параметри задані неправильно"
        }

Видалити налаштування імпорту

DELETE /shopping/import/settings
query setting_uuid:
 UUID налаштування імпорту.

Отримати файл з необробленими рядками при імпорті.

GET /shopping/table/err_file
query type:Тип файлу csv, xls. За замовчуванням xls

Вернути розпізнаний файл.

POST /shopping/table/preload
Query Parameters:
 
  • file – Файл для імпорту.
  • extension – CSV, XLSX, XLS.
  • separator – Опціонально, якщо CSV.

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

{
  "table": [
    [1.0, "", "", 5.0, 7.0,""],
    ["", "", "", "", "", ""],
    [123.0, 123.0, 123.0, "", "", ""],
    ["", "", "", "", "sdfsdf", ""],
    ["", "", "qwe", "", "", 8.0],
    [234.0, "", 545.0, "", "", ""]
  ]
}

Імпорт замовлень з excel або csv

POST /shopping/table/import
query import_type:
 Доступні значення article, code
query article_column:
 Номер колонки з артикулом
query brand_column:
 Номер колонки з брендом
query code_column:
 Номер колонки з кодом
query quantity_column:
 Номер колонки з кількістю
query uuid_column:
 Номер колонки с ID товару
query cart_uuid:
 ID замовлення. Якщо не передано, то буде створено нове замовлення
query separator:
 Розділювач
query name:

Кількість корзин

GET /shopping/carts/count

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

{
  "carts_count": 10
}

Об’єднати корзини

POST /shopping/carts/union

Запит:

query carts_array:
 Масив ID корзин. Приклад: carts_array = ["36eee850af3...", "da6006444f..."]

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

{
  "cart": {
    "uuid": "aeab8fe48c1348ffb26085cc9a78a4ed",
    "warehouse": {
      "name": "Луцк",
      "uuid": "ACF9000C2947F7AE11E28A2B02C4AD32"
    },
    "weight": 0.948,
    "total": 18.63,
    "name": "Корзина 2",
    "products_count": 3
  }
}

Замінити один товар в корзині на інший

POST /shopping/change_product
Query Parameters:
 
  • cart_uuid – ID корзини
  • from – UUID товару котрий заміняємо
  • to – UUID товару на котрий заміняємо

Приклад тіла запиту для заміни товару в корзині

{
  "cart_uuid": "A358000C2947F7AE11E23F5617780B16",
  "from": "81F4005056AC66D611EAD7173350C7AA",
  "to": "81F4005056AC66D611EAD7173350C7AV"
}

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

{
  "success": True,
  "cart": {
    "weight": 39.500,
    "products_count": 2,
    "total": 8005.62,
    "name": "Корзина 1001",
    "uuid": "f96ccd8e69a84fb19ef346238b977bf9",
    "currency_name": "ГРН",
    "owner": {
      "uuid": "812D000C2999A7E611E576524555E66A",
      "name": "ПП | ...",
      "f": 2
    },
    "warehouse": {
      "name": "Луцк",
      "uuid": "ACF9000C2947F7AE11E28A2B02C4AD32"
    }
  }
}

Отримати залишки товарів з корзини

POST /shopping/cart_products
Query Parameters:
 
  • cart_uuid – ID Корзини.
  • warehouse – Масив ID складів.

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

{
  "cart_products": [
    {
      "uuid": "8FAE08210FD7A22D4CD82DBF33E02105",
      "name": "Кліпса кріплення MB C-class (W203) 00-08/E-class (W212) 09-16",
      "article": "47906",
      "brand": "FEBI BILSTEIN",
      "price": 17.94,
      "quantity": 1,
      "multiplicity": 1,
      "sum": 17.94,
      "in_stocks": {
        "816F000C2999A7E611E6FF21C30463AF": {
          "name": "Львів",
          "short_name": "Льв",
          "quantity": "1",
          "sum": "17.94"
        }
      }
    }
  ],
  "total": {
    "cart": 17.94,
    "warehouses": {
      "816F000C2999A7E611E6FF21C30463AF": "17.94
    }
  },
  "currency_name": "ГРН"
}

Отримати залишки товарів з корзини

GET /shopping/cart_products
Query Parameters:
 
  • cart_uuid – ID Корзини.
  • warehouse – Масив ID складів.

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

{
  "cart_products": [
    {
      "uuid": "8FAE08210FD7A22D4CD82DBF33E02105",
      "name": "Кліпса кріплення MB C-class (W203) 00-08/E-class (W212) 09-16",
      "article": "47906",
      "brand": "FEBI BILSTEIN",
      "price": 17.94,
      "quantity": 1,
      "multiplicity": 1,
      "sum": 17.94,
      "in_stocks": {
        "816F000C2999A7E611E6FF21C30463AF": {
          "name": "Львів",
          "short_name": "Льв",
          "quantity": "1",
          "sum": "17.94"
        }
      }
    }
  ],
  "total": {
    "cart": 17.94,
    "warehouses": {
      "816F000C2999A7E611E6FF21C30463AF": "17.94
    }
  },
  "currency_name": "ГРН"
}

Змінити власника корзини

POST /shopping/change_owner
Query Parameters:
 
  • cart_uuid – ID корзини
  • client_uuid – ID нового власника (тільки пов’язані контрагенти)

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

{
  "success": true,
}

Отримати список резервів

GET /shopping/reserves
Query Parameters:
 
  • response_fields – Повертаються наступні значення ‘reserves, picking, all’, за замовчуванням ‘all’. ‘reserves’ поверне резерви, ‘picking’ - замовлення в обробці, ‘all’ - резерви та замовлення в обробці.

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

{
  "reserves": [
    {
      "warehouse_code": "000000005",
      "warehouse_name": "Луцк",
      "warehouse_uuid": "ACF9000C2947F7AE11E28A2B02C4AD32"
      "orders": [
        {
          "uuid": "930F005056BAD76D11EFE3E6CE71A655",
          "number": "ДГ015037754",
          "date": "2025-02-05T19:29:54Z",
          "sum": 20.04,
          "shipping_date": "0001-01-01T00:00:00Z",
          "currency": "ГРН",
          "comment": "test",
          "countrecord": 1,
          "automatically": true,
          "status": "В резерві",
          "carrier": "Доставка",
          "delivery_date": "0001-01-01T00:00:00Z",
          "delivery_setting": "Доставка, ул. тестовая 83ф",
          "route": "",
          "route_date": "0001-01-01T00:00:00Z",
          "owner": {
            "uuid": "81Exxx",
            "name": "UserName",
            "f": 1
          }
        }
      ]
    }
  ]
}

Видалити резерви

DELETE /shopping/reserves
Query Parameters:
 
  • orders – ID резерву. В запиті може бути передано декілька резервів.

Приклад запиту:

curl -X DELETE https://api.bm.parts/shopping/reserves?orders=6e58fa9d-374a-11e8-8118-005056ac1ea9

Отримати список бажаних товарів

GET /shopping/wishlist
Query Parameters:
 
  • cart_uuid – UUID для повернення наявності товарів у кошику.
  • warehouses – UUID складу
  • with_extra – Булевий параметр, який показує ціну з націнкою. За замовчуванням, False.

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

{
  "wishlist": {
    "products_count": 1,
    "products": [
      {
        "product": {
          "price": "745.80",
          "currency_name": "ГРН",
          "article": "818304",
          "default_image": "photo\u\p\w\y\c\9a6500a4.jpeg",
          "brand": {
            "uuid": "812C000C2999A7E611E55EBAE141FAAB",
            "name": "MOTUL"
          },
          "uuid": "82339E5CAE8D74EF4E96D400EB83E646",
          "name": "Антифриз (синій) G11 (60L) Auto Cool Expert Ultra (MB325.0/325.2) 109127",
          "multiplicity": 1,
          "in_cart": {
            "f33f9004-193b-44fb-869b-48d3e1bc9f09": 1
          },
          "restricted_delivery": [
            {
            "uuid": "B4466E1779A2E30B435620CEA0330826",
            "name": "Нова Пошта"
            }
          ],
          "is_paid_delivery": false,
          "weight": 4.5
        },
        "in_stocks": [
          {
            "name": "Луцьк",
            "short_name": "Лцк",
            "uuid": "ACF9000C2947F7AE11E28A2B02C4AD32",
            "quantity": "1"
          }
        ],
        "in_waiting": {
          "uuid": "-",
          "name": "Очікується",
          "quantity": "-"
        },
        "in_others": {
          "uuid": "-",
          "name": "На інших",
          "quantity": "1"
        }
      }
    ]
  }
}

Отримати інформацію про товар при швидкому відвантаженні

POST /shopping/product

Потрібно передати параметри в json форматі в body запиту, наприклад:

{
  "product": {
    "uuid": "B016705373F7E15D424EEEB59F193565",
    "quantity": 1
  },
  "cart_uuid": "20860179ca934ef68058a18da4a80e1c"
}

Параметр cart_uuid необов’язковий. Якщо його не передавати, то замість нього потрібно передавати параметр shipment_type зі значенням single_product. Наприклад:

{
  "product": {
    "uuid": "B016705373F7E15D424EEEB59F193565",
    "quantity": 1
  },
  "shipment_type": "single_product"
}

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

{
  "data": {
    "product": {
      "uuid": "B01670537XXXXE15D424EEEB59F193565",
      "article": "2 000 000 000",
      "name": "Реле стартера втягуюче Citroen Berlingo/C4/C5/Peugeot 206/306 1.8-2.2 -15 замінено на 1986SE1683",
      "default_image": "photo077.jpeg",
      "restricted_delivery": null,
      "is_paid_delivery": false,
      "brand": {
        "uuid": "812C000C2999A7XXXXE55EB9C240D5DB",
        "name": "BOSCH"
      }
    },
    "currency_name": "ГРН",
    "quantity": 1,
    "multiplicity": 1,
    "price": "000.00",
    "position_total": "000.00",
    "in_cart": {
      "cart_name": "Корзина 1",
      "brand_name": "KAPIMSAN",
      "article": "08-01750K",
      "quantity": 1
    },
    "weight": 0.92
  }
}

Список корзин

GET /shopping/carts
Query Parameters:
 
  • with_extra – Булевий параметр, який показує ціну з націнкою. За замовчуванням, False.

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

{
  "carts": [
    {
      "warehouse": {
        "uuid": "816D000C2999A7E611E6EC6B4A1915AF",
        "name": "Киев"
      },
      "total": 1004.50,
      "weight": 110.650,
      "uuid": "35ff5f1d4576467385364541564461bc",
      "name": "Корзина 1",
      "currency_name": "ГРН",
      "products_count": 3,
      "owner": {
        "uuid": "812D000C2999A7E611E576524555E66A",
        "name": "Контрагент [000003927]"
       },
    }
  ]
}

Створити корзину

POST /shopping/carts
Query Parameters:
 
  • id_type – (опціональний) ID Тип для пошуку товару. За замовчуванням - uuid.

Потрібно передати наступні параметри в body запиту:

  • name (опціональний): Назва корзини
  • products (опціональний): Список товарів та їх кількість.

Кожен товар має містити наступні параметри: uuid або `code, qnt - кількість товару. - id_type (опціональний): ID Тип для розпізнавання товару - warehouse (опціональний): ID Складу. За замовчуванням - основний склад. - client_uuid (опціональний): UUID власника корзини. За замовчуванням - поточний користувач.

Приклад запиту для створення порожньої корзини з назвою “Порожня корзина”

{
  "name": "Порожня корзина"
}

Створення корзини з назвою “Моє замовлення” і товаром:

{
  "name": "Моє замовлення",
  "products": [
    {"uuid": "B89C933344A18DA245B89E3FD635AA59", "qnt": 5}
  ]
}

Створення корзини з назвою “Моє замовлення” і тим же товаром за кодом ?id_type=code:

{
  "name": "Моє замовлення",
  "products": [
    {"code": "000048619", "qnt": 5}
  ]
}

Метод повертає статус 201 CREATED в разі успішного створення корзини.

Додати товар до списку обраних.

POST /shopping/wishlist/product/(string: uuid)

При успішному відпрацюванні запиту повернеться відповідь зі статусом 200:

{
  "success": true,
  "message": "Товар успішно додано до списку обраних."
}

Якщо товар вже додано до списку обраних і знову відбувається спроба додати, то повернеться відповідь зі статусом 409:

{
  "success": false,
  "message": "Даний товар вже додано до списку обраних.",
  "documentation_url": "https://developer.bm.parts/api/v2/"
}

Якщо передано некоректне значення uuid товару, то повернеться відповідь зі статусом 422:

{
  "success": false,
  "message": "Некоректне значення uuid - 82339E5CAE8D74EF4E96D400EB8E",
  "documentation_url": "https://developer.bm.parts/api/v2/"
}

Додати товари в корзину

POST /shopping/cart/(string: cart_uuid)/products

Приклад запиту:

{
    "products": [
        {
            "uuid": "82339E5CAE8D74EF4E96D400EB83E646",
            "qnt": 1
        }
    ]
}

При успішному відпрацюванні запиту повернеться response зі статусом 200:

{
    "cart": {
        "weight": 0.872,
        "warehouse": {
            "uuid": "ACF9000C2947F7AE11E28A2B02C4AD32",
            "name": "Луцьк"
        },
        "name": "t1",
        "total": 347.16,
        "uuid": "5700f16fbf21434fa7ae958dcab1dfcd",
        "products_count": 2,
        "currency_name": "ГРН"
    },
    "success": true,
    "error_rows": []
}

При відсутності параметра products, або не переданих даних для нього, повернеться такий response зі статусом 422:

{
    "success": false,
    "message": "Не передано products",
    "documentation_url": "https://developer.bm.parts/api/v2/"
}

При некоректних об’єктах в параметрі products, повернеться такий response зі статусом 200 (при успішному додаванні хоча б 1го товару):

{
    "success": true,
    "cart": {
        "weight": 0.872,
        "warehouse": {
            "uuid": "ACF9000C2947F7AE11E28A2B02C4AD32",
            "name": "Луцьк"
        },
        "name": "t1",
        "total": 347.16,
        "uuid": "5700f16fbf21434fa7ae958dcab1dfcd",
        "products_count": 2,
        "currency_name": "ГРН"
    },
    "error_rows": [
        {
            "uuid": "82339E5CAE8D74EF4E96D400EB83E646",
            "message": "Невалідний uuid товару"
        }
    ]
}

Якщо всі об’єкти некоректні, то повернеться такий response зі статусом 422:

{
    "success": false,
    "error_rows": [
        {
            "uuid": "82339E5CAE8D74EF4E96D400EB83E646",
            "message": "Невалідний uuid товару"
        }
    ],
    "message": "Не передано жодного валідного товару",
    "documentation_url": "https://developer.bm.parts/api/v2/"
}

Додати товар в корзину

POST /shopping/cart/(string: cart_uuid)/product/(string: product_uuid)/(int: quantity)
Query Parameters:
 
  • cart_uuid – ID корзини
  • product_uuid – ID Товару або код в форматі 000042915
  • quantity – Кількість
  • id_type – Вказує на пошук товару по ID або по коду. Допустимі значення uuid та code. За замовчуванням uuid
  • with_extra – Булевий параметр, який показує ціну з націнкою. За замовчуванням, False.

Якщо використовується метод POST кількість буде встановлено на передане значення. Якщо необхідно додати кількість до тих, що уже є в корзині, використовуйте метод PUT.

Додати товар в корзину

PUT /shopping/cart/(string: cart_uuid)/product/(string: product_uuid)/(int: quantity)
Query Parameters:
 
  • cart_uuid – ID корзини
  • product_uuid – ID Товару або код в форматі 000042915
  • quantity – Кількість
  • id_type – Вказує на пошук товару по ID або по коду. Допустимі значення uuid та code. За замовчуванням uuid
  • with_extra – Булевий параметр, який показує ціну з націнкою. За замовчуванням, False.

Якщо використовується метод POST кількість буде встановлено на передане значення. Якщо необхідно додати кількість до тих, що уже є в корзині, використовуйте метод PUT.

Видалити товар з корзини

DELETE /shopping/cart/(string: cart_uuid)/product/(string: product_uuid)
query cart_uuid:
 ID корзини
query product_uuid:
 ID Товару

Додати усі товари зі списку бажань в корзину

POST /shopping/wishlist_to_cart/(string: cart_uuid)

При успішному відпрацюванні запиту повернеться response зі статусом 200:

{
    "cart": {
        "weight": 0.872,
        "warehouse": {
            "uuid": "ACF9000C2947F7AE11E28A2B02C4AD32",
            "name": "Луцьк"
        },
        "name": "t1",
        "total": 347.16,
        "uuid": "5700f16fbf21434fa7ae958dcab1dfcd",
        "products_count": 2,
        "currency_name": "ГРН"
    },
    "success": true,
    "error_rows": []
}

Видалити корзину

DELETE /shopping/cart/(string: cart_uuid)
Query Parameters:
 
  • cart_uuid – ID корзини

При успішному виконанні метод верне 200 Success. У випадку, якщо параметр ID корзини вказано невірно, метод верне 404 Not Found.

Отримати корзину з товарами

GET /shopping/cart/(string: cart_uuid)
Query Parameters:
 
  • with_extra – Булевий параметр, який показує ціну з націнкою. За замовчуванням, False.

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

{
  "cart": {
    "total": 14065.38,
    "weight": 68.700,
    "uuid": "2fe8cf13d75d43298df613508fa63705",
    "currency_name": "ГРН",
    "name": "Корзина 1",
    "products_count": 1,
    "warehouse": {
      "uuid": "ACF9000C2947F7AE11E28A2B02C4AD32",
      "name": "Луцьк"
    },
    "owner": {
      "uuid": "81xxxxx056AC66D611EA2AF9E6xxxxxx",
      "name": "Ім'я Контрагента",
      "f": 1
    },
    "products": [
      {
        "position_total": 14065.38,
        "weight": 68.700,
        "price": 14065.38,
        "quantity": 1.000,
        "product": {
          "article": "818304",
          "default_image": "photo\u\p\w\y\c\9a6500a4.jpeg",
          "brand": {
            "uuid": "812C000C2999A7E611E55EBAE141FAAB",
            "name": "MOTUL"
          },
          "uuid": "82339E5CAE8D74EF4E96D400EB83E646",
          "name": "Антифриз (синій) G11 (60L) Auto Cool Expert Ultra (MB325.0/325.2) 109127",
          "multiplicity": 1,
          "restricted_delivery": [
            {
              "uuid": "927D8673D92E46174374F9AB37AF08FB",
              "name": "Самовивіз"
            },
            {
              "uuid": "B4466E1779A2E30B435620CEA0330826",
              "name": "Нова пошта"
            }
          ],
          "is_paid_delivery": false
        },
        "in_stocks": [
          {
            "name": "Луцьк",
            "short_name": "Лцк",
            "uuid": "ACF9000C2947F7AE11E28A2B02C4AD32",
            "quantity": "1",
            "contract_quantities": [
              {
                "f": 1,
                "quantity": "1"
              }
            ]
          }
        ],
        "in_waiting": {
          "uuid": "-",
          "name": "Очікується",
          "quantity": "-"
        },
        "in_others": {
          "uuid": "-",
          "name": "На інших",
          "quantity": "1"
        }
      }
    ]
  },
  "headers": [
    {
      "warehouse": "Луцьк",
      "short_name": "Лцк",
      "labels": [
        "ДАГ"
      ]
    }
  ]
}

Зміна корзини

POST /shopping/cart/(string: cart_uuid)

Доступні параметри запиту

Параметр Опис
name Новий заголовок корзини
owner_uuid Змінити власника корзини, в рамках ваших контрагентів

У відповідь повертає оновлений обʼєкт корзини

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

{
  "cart": {
    "weight": 0.153,
    "currency_name": "ГРН",
    "uuid": "9005cc87c8004a68a1xxx",
    "owner": {
      "uuid": "92E6005056BAxxx",
      "name": "Owner-name",
      "f": 1
    },
    "total": 183.0,
    "name": "Cart_name",
    "products": [
      {
        "weight": 0.153,
        "price": 183.00,
        "position_total": 183.0,
        "product": {
          "article": "103-929",
          "uuid": "810CF094BC02F47C475C7D95BF4A5111",
          "brand": {
            "name": "FA1",
            "uuid": "812C000C2999A7E611E55EBD7F2B608A"
          },
          "name": "Кронштейн кріплення глушника BMW X5 (E53) 00-06",
          "default_image": "photo\z\g\z\q\f\3ea1c6a5.jpeg"
        },
        "quantity": 1.000
      }
    ],
    "warehouse": {
      "name": "Луцьк",
      "uuid": "ACF9000C2947F7AE11E28A2B02C4AD32"
    },
    "products_count": 1
  },
  "updated": true
}