HTKapp Logo

Supplier Orders Module (Overview and list)

The HtkDoli Supplier Purchasing module allows you to consult, search and manage your supplier orders. It interacts directly with Dolibarr's business operations, by managing the classic statuses of a purchase order (draft, validated, approved, ordered, received, canceled).

Interface and Features (List)

The main view displays a list of all your supplier orders, classified chronologically with a display of statuses and amounts.

Consultation and Research

  • Search bar: Allows you to quickly search for an order by its reference, by the supplier name or by the supplier reference.
  • Sorting and Grouping: When scrolling, a floating indication appears to help you find your way quickly.
  • Filters: An icon at the top of the screen allows you to apply filters based on Dolibarr business status:
    • All: Shows all commands.
    • Draft: Orders being prepared, not yet validated.
    • Validated-Approved: Orders validated and/or approved, ready to order.
    • Ordered: Orders sent to the supplier and awaiting receipt.
    • Received: Orders received.
    • Canceled: Orders canceled.
    • Refused: Orders refused.

Information displayed (Order Cards)

Each line representing a supplier order displays:

  • The order reference (ex: CF2404-0001) and the associated supplier reference.
  • The name of the associated supplier.
  • The pre-tax amount (excl. VAT) and the currency.
  • The date of the order.
  • The visual status of the order via colored badges reflecting the Dolibarr workflow.

Detail view (Consultation of an order)

Touching an order in the list takes you to the detailed view (SupplierOrderDetailView), which shows the complete information of the purchase order.

General Information

The detail view brings together all the essential data:

  • Reference, amounts, status and supplier information.
  • The product/service lines of the order with their quantities, prices and totals. When the order is in draft, you can add, edit or delete a line.
  • The conditions and method of payment, the linked project, as well as Incoterms information and currency.
  • Access to attached documents and contacts linked to the order.
  • History of receipts and associated supplier invoices.

Actions on the order

Depending on the current status of the order and your Dolibarr permissions, you have access to several actions:

  • Documents: Management, PDF preview of attached documents and sending of new documents (the "PDF preview" concerns the documents attached to the order, not a generated PDF of the order itself).
  • Send an email: Send an email linked to the order.
  • Validate the order: Place an order from draft status to validated.
  • Approve / Order: Approve a validated order, then mark it as ordered.
  • Receive: Manage the receipt of products from an order.
  • Clone / Duplicate: Create a new supplier order identical to the current one.
  • Delete: Delete an order in draft status.

⚠️ No "Cancel", no "Reopen". Both actions have been removed: POST /supplierorders/{id}/cancel and …/reopen do not exist in Dolibarr's API, in version 22 as in 24 — only validation and approval are exposed. The buttons flipped the status on screen before letting it revert. Use the web interface.

Dolibarr business note: Most creation or modification actions (create, validate, delete) require specific rights. For example, creation or deletion requires the supplier.order.create or supplier.order.delete permission respectively, as configured in your Dolibarr instance. Deletions are only possible on orders in draft state.

Screenshots

2 screenshots — click to enlarge