Submit a request
Fractional Stock, image

Fractional Stock

Allows you to sell a certain amount of goods or goods with a floating value. You can sell food products (in grams, kilograms), products sold in packages (boxes, boxes) and other things that have a floating amount
Please enter a valid addres(es) of the shop where you are going to use the add-on.
15 200 ₽

Request a trial version

Write a review
Latest module version 2.10.2 Updated: 28.12.2024
Documentation
Have questions about the module? Write to us: HelpDesk
30 days for return
If you are not satisfied with the operation of the module, we will return your money with bonus points in your Personal Account
Bonus for review
We will give 1000 bonus points in your Personal Account for a review after purchasing the module
Multi-display
One price regardless of the number of display cases, no need to pay extra
Support
Free consultation and support on the module, assistance with installation
Discount for revision
We will give a discount of up to 50% on improvements to any functionality when purchasing a module from us
Дробный остаток | Модуль CS-Cart | MakeShop.pro
Fractional Stock, image , 2 image
Fractional Stock, image , 3 image
Fractional Stock, image , 4 image
Fractional Stock, image , 5 image

By default, CS-Cart does not have the ability to work with fractional values of product balances; this causes great inconvenience for owners of grocery stores, construction materials stores, and printing houses. Any product where you need to operate with fractional values.

Another problem is selling goods in packages; you can set the product quantity step, but it will not be clear how many packages the client will receive. Or you sell goods in packages, but count them in the warehouse in pieces, or in weight (kg, g, t) or volume (m3, l3)

Our add-on solves 2 problems at once and allows you to sell goods in fractional parts and packages

Image

You can flexibly configure the add-on for each product individually or for the entire store as a whole, or add exceptions.

The add-on supports displaying the unit of measurement of the quantity of goods, setting the step for selecting quantity, the minimum and maximum quantity of goods to order. It solves the problems of displaying available products on the site and simplifies the sales process.

Image

Selling goods in packages is now very flexible and understandable for both the store owner and the client. You can:

  • Sell only in packages and display packages;
  • Sell in packages and show how many units of goods the client will receive;
  • Sell in pieces and show and let you add the product to your cart in packages.

In this case, you will count the goods individually (in whole numbers or fractions) and you can configure this individually for each product.

Image

Add-on features

  • Sale of goods in fractional units;
  • Setting the unit of measurement for the quantity of goods. Both globally and locally;
  • Disable fractional balance for units included in exceptions;
  • Setting the step for selecting the quantity of goods to order;
  • Setting the minimum and maximum values for the order;
  • Customizable display for sale in packages;
  • Customizable display of the quantity in the cart;
  • Compatible with Unitheme and Youpi templates.

Product:
  • Store Builder
  • Store Builder Ultimate
  • Multi-Vendor
  • Multi-Vendor Plus
  • Multi-Vendor Ultimate
Recipient:
  • Buyers
  • Owners
  • Vendors
Development
:
  • Backend
  • Frontend
Localization:
  • English
  • Русский
Compatible versions:
  • 4.17.X
  • 4.16.X
  • 4.15.X
  • 4.14.X
  • 4.13.X
  • 4.12.X

Installation

After downloading the add-on, its installation is performed using standard CS-Cart tools on the page Admin Panel → Add-ons→ Add-ons Management → Download and install the add-on (+).

For CS-Cart version 4.13.1 and higher, the Admin Panel → Add-ons→ Downloaded add-ons → Gear button → Manual installation.

Image

Installing hooks

To work correctly, you need to install hooks according to the instructions. The information is collected in the add-on tab Information.

This operation for adding hooks is relevant for the current version of the v add-on .2.5.13 and later, in future versions, this operation may no longer be necessary.

Image

To display the quantity of the product in the cart, you need to add 3 hooks to the file “fn.cart.php”:

  1. Open the file fn.cart.php (the file will be located at the path: app/functions/fn.cart.php );
  2. In the opened file, find the line with the code (approximately between lines 6057-6062):
      3. if (!empty($product['qty_step']) && $product['qty_step'] > $min_qty) {
        $min_qty = $product['qty_step'];
  3. After the found line, insert the code:
      4. fn_set_hook('check_amount_in_stock_min_qty', $product, $min_qty, $product_id);
  4. As a result, you should get the following:
      5. if (!empty($product['qty_step']) && $product['qty_step'] > $min_qty) {
        $min_qty = $product['qty_step'];
    }


    **fn_set_hook('check_amount_in_stock_min_qty', $product, $min_qty, $product_id);**

    $cart_amount_changed = false;
      Image
  5. Next, find the line with the code in the file (approximately between lines 6522-6524):
      6. $amount = fn_normalize_amount(@$data['amount']);
  6. After the found line, insert the code:
      7. fn_set_hook('add_product_to_cart_post_normalize_ammount', $product_id, $amount, $data);
  7. As a result, you should get the following:
      8. $amount = fn_normalize_amount(@$data['amount']);

**fn_set_hook('add_product_to_cart_post_normalize_ammount', $product_id, $amount, $data);**

if (!isset($data['extra']['exclude_from_calculate'])) {
      Image
  8. Next, find the line with the code in the file (approximately between lines 9340-9342):
      9. $amount = fn_normalize_amount($v['amount']);
  9. After the found line, insert the code:
      10. fn_set_hook('update_cart_products_normalize_amount_post', $amount, $v);
  10. As a result, you should get the following:
      11. $amount = fn_normalize_amount($v['amount']);

**fn_set_hook('update_cart_products_normalize_amount_post', $amount, $v);**

$v['extra'] = empty($cart['products'][$k]['extra']) ? array() : $cart['products'][$k]['extra'];
      Image
  11. Save the changes to the file;
  12. Clear the cache:
    1. In the admin panel, select Administration → Storage → Clear Cache.
        2. Image

To work with commerceml, you need to add a hook to the file “OrderConvertor.php ”:

  1. Open the file OrderConvertor.php (the file will be located along the path: app/addons/commerceml/src/Convertors/OrderConvertor.php);
  2. In the opened file, find the line with the code (approximately between lines 44-46):
      3. $order->id->external_id = $element->getAsString('id');
  3. After the found line, insert the code:
      4. fn_set_hook('commerceml_order_convertor_convert_pre', $element, $import_storage, $order);
  4. As a result, you should get the following:
      5. $order->id->external_id = $element->getAsString('id');

        **fn_set_hook('commerceml_order_convertor_convert_pre', $element, $import_storage, $order);**

    foreach ($element->get('products/product', []) as $item) {
      Image
  5. Save the changes to the file;
  6. Clear the cache:
    1. In the admin panel, select Administration → Storage → Clear Cache.
        2. Image

Setting

Add-ons Settings (Global Settings)

Go to the section Add-ons → Downloaded add-ons→ Fractional stock→ Settings tab

Basic Settings:

The settings tab is divided into 3 sections, Global settings for products, Global Settings for packages, and Shopping cart settings.

The application of these settings affects all products of the store at once, unless local settings are set for the product (more on this below).

Global settings for products

Use fractional remainder - Enabling this function will allow you to edit the field: Unit of quantity.

Example

Global settings for packages

The product is for sale:

  • Piece by piece - goods are sold in pieces, all goods (unless another setting is selected locally for the product/package sale is enabled) will be sold in a piece or similar form;
  • Packages - goods are sold in packages, you can specify:
    • The quantity of goods in a package is the step of changing the quantity of goods that will be applied to goods sold in packages;
      • Image

Options for displaying the selection of the quantity of the product:

  • Show the number of packages - Display only the counter with the number of packages in the product card and catalog;
Image
  • Show the quantity of goods and packages - Display in the product card and catalog a counter with the number of packages and the number of goods in the package.
Example

Shopping Cart Settings

Quantity display mode on the basket icon - Allows you to select the display option on the basket icon:

  • Number of items - how many types of goods are in the basket;
Image
  • Number of units - how many units of the product are in the basket;
Image
  • Do not display.
Image

In the add-on settings, the Display tab contains settings responsible for displaying units of measurement and methods of sale on the showcase.

Image
  • Display units of measurement in sellers' offers

      • When this function is enabled on the showcase, the seller's offers will display the unit of measurement of the product specified in the global settings of the add-on or the local settings of the product.

Image
  • Display all sales methods on the categories page

      • This and all subsequent settings are responsible for displaying all sales methods on the pages and blocks of your choice.

Image
Example

In the add-on settings, the Information tab displays the instructions for adding hooks described at the beginning of this instruction.

Add-ons Settings (Local Settings)

Go to the section Products → Products → Open the product to set up the fractional stock→ Go to the Add-ons tab → Find the block MS: Fractional Stock.

Image
⚠️
Local product settings have a higher priority and may override global settings for the entire store.

Product Settings

Use a fractional remainder

  • Global Settings:
    • The unit of measurement of quantity from the global settings of the add-on will be used for the product;
    • For the product, you can specify:
      • Step of the quantity selection list;
      • Minimum quantity of goods to order;
      • The maximum quantity for the purchase of one product.
        • ⚠️
        This setting option is suitable for stores where all or most of the products have the same unit of quantity, for example, in grams.
        Example
      • Yes:
        • A fractional remainder will be used forcibly for the product;
        • For the product, you can specify:
          • The unit of measurement of quantity;
          • Step of the quantity selection list;
          • Minimum quantity of goods to order;
          • The maximum quantity for the purchase of one product.
            • ⚠️
            This setting option is suitable for stores where you need to set a fractional quantity sale for certain products.
            Example
          • No:
            • The fractional balance will be forcibly turned off for the product;
            • For the product, you can specify:
              • The unit of measurement of quantity.
                • ⚠️
                This setting option is suitable for stores where only the unit of quantity measurement needs to be set for goods.
                Example

                Packaging Settings

                The product is sold in packages

                • Global Settings:
                  • Global settings for packages will be used for the product;
                  • Fields are not editable for the product:
                    • The quantity of the product in the package;
                    • Options for displaying the selection of the quantity of the product;
                      • ⚠️
                      This option is suitable for stores that sell all products with the same terms of sale.
                      Example
                    • Yes:
                      • For a product, you can set the quantity of the product in the package;
                      • For the product, you can select options for displaying the selection of the quantity of the product;
                          • ⚠️
                          This option is suitable for stores that sell goods with different quantities in a package.
                    • No:
                      • The product is sold in pieces, global settings do not affect the product, local fields are not editable.

                    Mass editing

                    Through updating products in CS-Cart:

  1. Open the Products → Products;
  2. Select the necessary products;
  3. Click Edit Selected;
      4. Image
  4. Select fields to edit;
      5. Image
  5. Click Edit Selected;
  6. Enter new values for the selected fields; Meaning global - Global Settings Y - Yes N - No
      7. Image
  7. Click Save.

Through the export and import of goods:

  1. Open the Administration → Export Data → Products;
  2. Move the following fields from the list of available fields to the exported fields: MS:Allow Fractional Amount MS:Product Amount Step MS:Product minimum order quantity MS:Product maximum order quantity MS:Product Amount Postfix MS:Product Sale Type MS:Show Sale Types These fields will be displayed in a table file for editing fractional remainder settings
      3. Image
  3. Click Export;
  4. Make the necessary changes in the table file and save;
  5. Open the Administration → Data Import → Products section;
  6. Press the + button;
  7. Select a table file;
  8. Go to the next step Matching fields;
  9. Match the fields as shown below:
      10. Image
  10. Click Import.

v2.10.2 от 28.12.2024

[!] Отсутствует хук "create_order_details" в файле init.php. Исправлено

v2.10.1 от 12.11.2024

[!] Исправлено добавление товара в корзину, при первом добавлении товар округлялся до целых чисел

v2.10.0 от 29.10.2024

[+] Новый расчет количества. Происходит расчет кол-во уп. переводится в ед. и сравнивается с кол-во ед. в наличии, если их достаточно, то добавляет в корзину

[*] Подправлены стили

[+] Добавлена запись данных по дробному остатку товара в таблицу order_details после оформления/обновления заказа

[+] Добавлена передача в шаблоны писем по заказу переменные из настроек модуля и переменные по дробному остатку по каждому товару в таблице товаров

[!] Не корректный тег на странице "Товара". Исправлено

[*] Изменены стили для счёткика количества на странице "Товара" и "Корзина" для youpi темы

[!] Ошибка расчёта количества при вводе значения вручную. Исправлено

[!] Дубликат атрибута id на странице "Корзина". Исправлено

[!] При установке количества товара на странице "Корзина" не работает округление. Исправлено

[*] Добавлена переменная для вывода кол-ва товаров csc_fractional_stock

[+] В hooks.php исправлен метод fn_csc_fractional_stock_create_order_details (добалена логика проверки и запись значения в специальную переменную - единичный товар или упаковки товара)

[+] По пути \app\addons\csc_fractional_stock\Tygh\Template\Snippet в класс CscFractionalStockVariables добавлена переменная csc_fractional_stock_show_amount

[+] В класс CscProductVariable в метод attributes добавлена csc_fractional_stock_show_amount

[+] Добавлено отображение символа валюты для переменной csc_fractional_stock_price_by_piece

[!] Неккоректно считалось стоимость товара в упаковке при добавлении в корзину. Исправлено

[!] Исправлена ошибка появляющаяся из за типов данных в параметрах хука

[*] Исправлено отображение цены csc_fractional_stock_price_by_piece - добавлено форматирование цены по аналогии с price в документах заказа

[*] Исправлено отображение наличия товара на витрине в unitheme2

[!] Исправлена ошибка, возникающая при создании комплектов товара

[!] Исправлена ошибка, при добавлении товара с предзаказом

v2.9.1 от 28.03.2024

[*] Стандартизация языковых переменных

[*] Подправлены стили у unitheme2

[+] Добавлены шаблоны и стили для youpitheme

[+] Добавлены настройки для массового редактирования товаров

[*] Подправлены стили unitheme2 и файл лицензии

[+] Добавлена возможность отображать товары в единицах измерений на всех этапах оформления заказа даже если товар продается упаковками

v2.9.0 от 20.02.2024

[*] Проведена оптимизация запросов в базу данных

v2.8.1 от 16.02.2024

[*] Добавил проверку локального значения для товара при отображении цен для единиц товара и для упаковки

v2.8.0 от 16.02.2024

[+] Добавлены настройки в модуле и у товара для управления использования цены (единицы/упаковки)

v2.7.1 от 30.01.2024

[!] Удален дублирующий код, нарушавший добавление в корзину дробного остатка при работе со складами

v2.7.0 от 19.01.2024

[+] Добавлена возможность работы с модулем "Склады"

[*] Исправлено отображение изображения товара на странице детального просмотра заказа на витрине

[*] Подправлены стили

[*] Если товар продается упаковками, то при оформлении заказа количество будет вычитаться в единицах товара, а не в упаковках

[*] Изменен механизм вычитания количества на складах при продаже товара упаковками и включенном режиме отображения "Показывать количество товара и упаковок" товар будет списываться количеством выбранных штук

[*] Изменен механизм вычитания количества на складах при продаже товара упаковками и включенном режиме отображения "Показывать количество упаковок" товар будет списываться: количество упаковок, умноженное на количество штук в упаковке

[*] При продаже товара упаковками и включенном режиме отображения "Показывать количество упаковок" в поле ввода количества упаковок можно ввести только целые исла

v2.6.0 от 10.01.2024

[*] Изменена структура во вкладке Настройки->Информация

[+] Добавлена передача дробных остатков через обмен commerceml

[-] Удалены исключения для единиц измерений

[+] Добавлена передача дробных остатков товаров в заказе через обмен commerceml

[+] Запросы в базу данных из файла addon.xml перенесены в файл func.php для корректной проверки перед выполнением запросов

[*] Изменены стили

[+] Добавлены языковые переменные

[+] Добавлены настройки для управления "Способ изменения количества товаров"

[*] Переименованы настройки "Шаг списка выбора количества" в "Шаг изменения количества товара"

[*] Исправлено увеличение количества упаковок

v2.5.14 23.11.2023

[!] Экспорт/импорт поля "Единица измерения количества"

v2.5.13 14.11.2023

[-] Удаление закомментированного кода

[!] Корректировка поля MS: "Минимальное количество товара для заказа"

[!] Перевод поля "Единица измерения количества"

[!] Корректное отображение в карточке товара

[*] Актуальные номера строк для добавления хуков модуля

[+] Добавлена информация о добавлении хуков модуля

[!] Добавлены виды отображения количества товара на иконке корзины

[!] Отображение дробного значения в корзине

[!] Отображение счетчика количества товаров в карточке товаров

[+] Стандартизация модуля

v2.5.12 от 23.10.2023

[!] Правильный подсчет упаковок на странице корзины

[!] Доступность сервиса на странице заказа в административной панели

[!] Поле "Единица измерения количества" в настройках продукта изменено на тип "float"

[!] Поля, связанные с выбором количества, сохраняют только положительное значения

[!] В поле MS: "Минимальное количество товара для заказа" доступен только ввод цифровых значений

[*] Стандартизация языковых переменных

v2.5.11 от 16.10.2023

[*] Изменены короткие теги

[*] Переработаны настройки модуля

v2.5.10 от 18.07.2023

[!] Корректное отображение в карточке товара

[!] Загрузка иконки

[!] Поле "Шаг количества товара", сохраняет только положительное значения

[!] Корректное отображение названия единиц на страницах товары по акции, новинки, хиты продаж и результат поиска

[!] Отображение единиц измерения на странице отложенные

v2.5.9 от 25.06.2023

[+] Стандартизация модуля

v2.5.8 от 12.06.2023

[+] Стандартизация модуля

v2.5.7 от 08.06.2023

[*] Подправлен стиль в блоке "Хиты продаж" если он открывается в карточке товара

v2.5.6 от 05.06.2023

[+] Добавлена настройка отображения дробного остатка в импорт и экспорт товаров

[+] Добавлены настройки и регулировка отображения всех способов продаж на разных страницах

[+] Добавлена настройка для отображения единицы измерения в блоке предложений от продавцов в карточке товара

[!] Исправлена ошибка, которая ломает страницу просмотра категории

v2.5.5 от 20.05.2023

[+] Добавлена настройка отображения дробного остатка в карточке товара на странице редактирования товара в админке

v2.5.4 от 16.05.2023

[*] Мелкие правки в шаблоне qty.override.tpl

v2.5.3 от 16.05.2023

[!] Исправлена ошибка при добавлении товара в корзину при работающем модуле "Общие товары продавцов"

v2.5.2 от 15.05.2023

[*] Лицензирование

v2.5.1 от 10.05.2023

[!] Исправлен импорт поля product_amount_postfix

Request revision
Бэклог

Локально задавать тип упаковки

Добавление локальной настройки ввода типа упаковки (метры, паллеты, коробки, ящики)

Обучить модуль Склады дробным остаткам

Обучить модуль Склады дробным остаткам

January 2024
1%
Планируется

Разделение модуля Дробный остаток на 2 модуля

Разделение существующего модуля на 2 автономных

July 2023
5%
В работе
Выпущено

Адаптация и настройки отображения счетчика количества товаров

Адаптация и настройки отображения счетчика количества товаров

April 2024
100%

Арифметика продажи упаковками

February 2024
100%

Использование существующей цены как за уп так и за м2

Использование существующей цены как за уп так и за м2

February 2024
100%

Количество товара для отображения в карточке

Доработка модуля

December 2023
100%

Новая логика расчета товара в наличии при продаже уп.

Новая логика расчета товара в наличии при продаже уп.

June 2024
100%

Удобные настройки

Настройки для модуля интуитивно не понятные, надо это исправить, сделать их логичными и удобными

August 2023
100%

шт. или упаковки отображение при оформлении заказа

Настройка отображение типа товара (упаковками, штуками и т.д.) на всех этапах оформления заказа.

March 2024
100%
Reviews
Ярослав
Verified purchase
Использую модуль с самого дня развития, очень помогает по торговле с продуктами, когда нужно продавать не только поштучно, но и на развес, удобно ограничивать минимальный заказ и весовой шаг.
Similar add-ons