DW.get_products_sale - datawizio/pythonAPI GitHub Wiki

get_products_sale – повертає продажі по товарах.

Повертає дані по продажах заданих товарів за вказаний період. Показує оборот товару за вказаний період, кількість проданого товару, залишок товару на складі, його собівартість. Результат групується по днях, тижнях, місяцях, роках.

Parameters:

  • products: int,list

    id товару, або список з id по яких буде робитися вибірка.

  • Передавши параметр "sum" останнім елементом списку, отримаємо додаткову колонку з сумою відповідного показника.

  • categories: int,list

    id категорії або список з id, по яких буде робитися вибірка.

  • shops: int,list

    id магазину або список з id, по яких буде робитися вибірка.

  • weekday: int {понеділок - 0, неділя - 6}

    день тижня, по якому буде робитися вибірка.

  • date_from: datetime, str {%Y-%m-%d}

    початкова дата вибірки.

  • date_to: datetime, str {%Y-%m-%d}

    кінцева дата вибірки.

Якщо проміжок [date_from, date_to] не заданий, то вибірка буде за останні 30 днів клієнта.

Якщо ж заданий тільки один з параметрів, то вибірка буде за 30 днів клієнта від вибраного параметра.

interval: str,{"days","months","weeks","years", default: "days" } залежно від параметра, результат буде згруповано по днях, тижнях, місяцях, або роках.

  • by: str, list
  •                      {"turnover": оборот,
                         "qty": кількість проданих товарів,
                         "receipts_qty": кількість чеків,
                         "profit": прибуток,
                         "sold_product_value": собівартість проданих товарів,
                         "self_price_per_product":ціна без націнки за одиницю товару,
                         "price": середня ціна за одиницю товару,
                         default:"turnover"}
    
    поле або поля, по яких хочемо отримати результат вибірки.
  • show: str,
  •             {"name": <category_name> для назв колонок,
                "id": <category_id> для назв колонок,
                "both": <category_id>_<category_name> для назв колонок,
                default: "name".
  • view_type: raw, represent
  • формат представлення таблиці.

    Returns: якщо view_type: raw, то формує наступну таблицю:

    date product qty ...N
    1 by by by by
    2 by by by by
    ...N by by by by

    якщо view_type: represent, то формує таку таблицю:

    product 1 product 2 ...product N
    date 1 by by by
    date 2 by by by
    ...date N by by by

    Examples:

    dw = datawiz.DW()
    dw.get_products_sale(products = [2833024, 2286946, 'sum'],by='turnover',
                                  shops = [305, 306, 318, 321], 
                                  date_from = datetime.date(2015, 8, 9), 
                                  date_to = datetime.date(2015, 9, 9),
                                  interval = datawiz.WEEKS)

    Повертає дані по обороту товарів з id [2833024, 2286946], з 9.8.2015 по 9.9.2015 по магазинах [305, 306, 318, 321], згруповані по тижнях.

    ⚠️ **GitHub.com Fallback** ⚠️