HTKapp Logo

Receptions Module (Overview and list)

The HtkDoli Receptions module lets you consult and search your supplier receptions. It works directly with Dolibarr's business logic, handling the classic statuses of a reception (draft, validated, closed).

Interface and Features (List)

The main view displays a list of all your supplier receptions, with a status display.

No manual creation

A reception is born from a supplier order: from an order's detail view, the "Receive" action creates the reception with its lines. There is no "+" on the list: Dolibarr's API rejects a reception without an originating order (origin_id), then without lines attached to that order — verified on 15 September 2026 against a 24.0.0. The former manual creation form queued a request the server always rejected.

  • Search bar: Lets you quickly search for a reception by its reference or by the associated supplier reference.
  • Filter and sort: You can filter the list by status (All, Draft, Validated, Closed) and sort it by date (most recent / oldest) or by reference (A-Z / Z-A). The filter and sort apply to the receptions already loaded.
  • Empty and Loading states: If no reception matches your search, a clear message indicates this. A loading indicator ("Load more") is present for pagination of results; it disappears as soon as a search, a filter or a non-default sort is active.
  • Refresh: You can refresh the list manually, which triggers a visual status indication (loading, success, error).

Information displayed (Reception Cards)

Each row representing a reception displays:

  • The reception reference (e.g. REC2404-0001) and the associated supplier reference if available.
  • The creation date of the reception.
  • The visual status of the reception via colored badges (Draft, Validated, Closed).

You can also delete a reception directly from the list through the context menu (long press): deletion is immediate, without a confirmation alert.

Detail View (Consulting a reception)

Tapping a reception in the list opens the detailed view (SupplierReceptionDetailView), which shows the complete information of the purchase reception.

General Information (Header / Hero Section)

The detail view groups the essential data at the top of the screen:

  • Reception reference and supplier reference.
  • Current status of the reception.

Connections

If the reception is linked to other elements in Dolibarr, direct links are displayed:

  • Supplier order: Direct access to the associated order.
  • Project: Direct access to the linked project.

Products received

The details of the products or services received are listed:

  • The reference and description of the product.
  • The quantity received.
  • Traceability information, in particular the Lot / Series, and expiration / best-before dates such as the DLUO (best-before) and DLV (use-by) when applicable.

Actions on the reception

  • Documents: You can view, download (PDF preview) and add new documents attached to the reception. A left swipe on a document row reveals a Delete action (with a confirmation alert), which removes the file from the Dolibarr server.
  • Notes: Consultation of the public and private notes associated with the reception.

Screenshots

2 screenshots — click to enlarge

← Previous Quotes / Proposals Module Next → Recruitment Module