Order Booking

Order Booking Module - User Guide

1. Introduction πŸ“

The Order Booking module (/orderbookingindex) captures initial customer commitments and quantity reservations before formal Sales Orders are created. It serves as the bridge between sales negotiations and formal order confirmation, allowing sales teams to log pricing, quantities, and customer reference numbers upfront.

ℹ️

In the overall business flow:

  1. Pre-Order Reservation: Records client commitments prior to drafting formal sales orders.
  2. Conditional Activation: Enabled in the system when the system parameter bookingSysParameter is set to "Y". When active, an “Order Booking” button appears on the Sales Order index page.
  3. Strict Downstream Linkage: Once converted or linked to a Sales Order, the booking is permanently locked against modification or deletion.

Typically, this module is managed by Sales Executives, Marketing Managers, and Order Processing Coordinators.


2. Getting Started with Order Booking πŸš€

Accessing the Module

  • Access the module by navigating to Sales > Transactions > Sales Order (/salesorderindex) and clicking the “Order Booking” button (visible when enabled in system parameters), or by directly navigating to /orderbookingindex.

Navigation & Index Overview

The Order Booking Index displays all historical bookings with the following columns:

  • Booking No: Auto-generated sequential booking number (clickable link to /orderbookingdetails/{id}).
  • Booking Date: The date the commitment was recorded.
  • Ref No: Customer reference or enquiry number (up to 20 characters).
  • Party / Branch Name: Combined customer name and delivery branch.
  • Qty: Committed booking quantity.
  • Rate: Agreed unit rate.

Action Buttons on Index:

  • Create New: Opens /orderbookingcreate.
  • Order Booking Report: Opens /orderbookingreportoption to download Excel reports.
  • Back: Returns to the main Sales Order index (/salesorderindex).

3. Features ✨

  • πŸ“ Fast Reservation Entry: Capture quantity, rate, and customer reference with automatic party-branch validation.
  • πŸ”— Connected Documents: View linked downstream records (e.g., Sales Orders) via the built-in document tracker (connecteddocsindex/OB/{id}).
  • πŸ”’ Downstream Protection Lock: Prevents modifying or deleting bookings that have been attached to a Sales Order.
  • πŸ›‘οΈ Mandatory Deletion Reason: Enforces an audited explanation (10 to 250 characters) prior to permanent deletion.
  • πŸ“Š Integrated Reporting: Direct one-click access to pending booking and conversion audit reports.

4. Complete Flow πŸ”„

Create an Order Booking (/orderbookingcreate)

  • Click “Create New” on the index page.
  • Select the Booking Date (uses current fiscal year date constraints).
  • Enter the customer’s Ref No (up to 20 characters).
  • Select the customer Party and Branch from the combo selector (filters to active accounts only).
  • Enter the agreed Qty and Rate.
  • Optionally add Notes (up to 250 characters).
  • Click Save (protected by double-submission guard). Upon saving, you are redirected to the details screen.

Review Details & Connected Documents (/orderbookingdetails/{id})

  • Open any booking from the index.
  • View all header details, quantities, rates, and notes.
  • Click “View” in the Connected Documents row to inspect linked downstream documents (connecteddocsindex/OB/{id}).

Modify an Order Booking (/orderbookingmodify/{id})

  • From the details screen, click “Modify”.

  • The Booking No and Party / Branch Name are read-only.

  • You can update the Booking Date, Ref No, Qty, Rate, and Notes.

  • Click Save to apply changes.

  • ⚠️
    Modification Lock:

If the booking is already linked to one or more Sales Orders (relatedDocsCnt > 0), clicking Modify is immediately blocked with the message: β€œThis order booking is linked to Sales Order. You may not modify or delete.”

Delete an Order Booking


5. Validations and Error Handling ⚠️

Validation TypeWhat is checked?Error Message / Action
Sales Order LockAttempting to modify or delete a booking linked to a Sales Order.Alert: “This order booking is linked to Sales Order. You may not modify or delete.”
Deletion Reason LengthReason must be between 10 and 250 characters.Red warning: “Relevant reason needs to be filled (Upto 250 characters)”
Ref No LengthReference number length constraint.Restricted to a maximum of 20 characters.
Notes LengthNotes field length constraint.Restricted to a maximum of 250 characters.
Fiscal Year DateBooking Date outside fiscal boundaries or future dates.Enforced by standard date picker restrictions.

6. Related Reports πŸ“Š

Marketing ActivitySales Enquiry