Warehouses Module (Stock)

The HtkDoli Warehouses module lets you view and manage your warehouses (or storage points) along with the related stock movements. Each stockable product can be split across several warehouses; this module gives the per-warehouse view.

Interface and Features (List)

The main view shows the list of all the warehouses configured in Dolibarr.

Browsing and Search

• Search bar: Search by warehouse name, reference, postal code or town.
• Sorting:
  • Name (A→Z, Z→A)
  • Reference (A→Z, Z→A)
  • Town (A→Z)
• Status filters:
  • All
  • Open
  • Closed
• Refresh: Dedicated button in the header, with a visual state during synchronization.

Information Displayed (Warehouse Cards)

Each row representing a warehouse shows:

• A badge O (Open, green) or F (Closed, grey).
• The warehouse label.
• An Open / Closed badge.
• The warehouse reference.
• The town and postal code if provided.

Quick Actions

• Floating "+" button: Create a new warehouse (only visible if you hold the stock.creer permission).
• Context menu (long press): Edit, Delete.
• Swipe right: Edit button.
• Swipe left: Delete button (with confirmation).

Pagination

• Loaded in batches of 50 warehouses, with a "Load more" button.
• Pull-to-refresh available.

Detail View (Viewing a Warehouse)

Tapping a warehouse in the list opens its detailed sheet.

Header (Hero Section)

• Building icon.
• Warehouse reference and label.
• Open or Closed badge.

Address Details

• Full address
• Postal code
• Town
• Country

Recent Movements

List of the latest stock movements linked to this warehouse, sorted from newest to oldest. Each row shows:

• A directional icon: a green down arrow for an inbound movement (positive quantity), a red up arrow for an outbound movement (negative quantity).
• The movement label (reason).
• The product concerned (the row is tappable to navigate to its sheet).
• The movement date and time.
• The signed quantity (+ or −).

A dedicated "+" button lets you create a new movement directly from this section.

A "Load more" button appears if the history contains additional movements.

Stock

List of all products with a non-zero stock in this warehouse. A counter shows the number of products. Each row shows:

• The product label and reference.
• The quantity present in this warehouse.
• The product's total stock (across all warehouses).

Each row is tappable to navigate to the product sheet.

Description

Free-text description of the warehouse (access instructions, opening hours, etc.).

Documents

• Viewing and previewing the documents attached to the warehouse.
• Downloading.
• Adding new documents.

Available Actions

From the floating header:

• Edit: Full edit of the warehouse sheet (stock.creer permission). The edit form groups together: reference and label (required), Open/Closed status, description, contact details (phone, fax), and address & location (location/placement, address, postal code, town, country code).
• Delete: Permanent deletion (stock.supprimer permission).

Creating a Stock Movement

From the warehouse sheet (the "+" button in the Movements section) or from a product sheet (the Stock correction action), a dedicated screen lets you record a movement.

The screen offers a segmented selector with two movement types:

• Correction: Manual stock adjustment (increase or decrease).
  • Choice of Add (+) or Remove (-).
  • Selection of the warehouse concerned.
  • Entry of the quantity.
  • Entry of a label (reason), pre-filled with "Stock correction".
• Transfer: Moving stock from one warehouse to another.
  • Selection of the source warehouse.
  • Selection of the target warehouse (which must differ from the source).
  • Entry of the quantity to transfer.
  • Entry of a label, pre-filled with "Stock transfer".

⚠️ No unit price is entered when creating a movement: only the product, the warehouse (or the source/target pair), the quantity and the label are recorded.

Product Selection

• If the movement is created from a product sheet, the product is pre-selected.
• Otherwise, a selector lets you search for the product in the catalog.

Offline Behavior

The movement is saved locally and then pushed to Dolibarr on the next synchronization. A success notification confirms the immediate local save.

Business Behavior and Dolibarr

Rights and Permissions

• Read: Read permission on the Stock module is required to display the list.
• Create / Edit: The "+" button in the top bar and the edit action are conditioned by the stock.creer permission.
• Delete: Conditioned by the stock.supprimer permission.

Synchronization

• List paginated by 50.
• The stock movements and the documents attached to a warehouse are loaded when the sheet is opened.
• Movements created on the go are queued and synchronized automatically to Dolibarr.

Open / Closed Status

A warehouse that is closed in Dolibarr remains viewable but cannot receive new movements. The status badge on the list and the sheet reflects this setting.

Screenshots

2 screenshots — click to enlarge

Close