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:
- Pre-Order Reservation: Records client commitments prior to drafting formal sales orders.
- Conditional Activation: Enabled in the system when the system parameter
bookingSysParameteris set to"Y". When active, an “Order Booking” button appears on the Sales Order index page. - 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
/orderbookingreportoptionto 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
- From the details screen, click “Delete”.
- If linked to a Sales Order, deletion is blocked immediately.
- If unlinked, a confirmation dialog appears asking: “Do you really want to delete this record permanently?”
- You must provide a Reason for Deletion between 10 and 250 characters. The system will not allow deletion until a valid reason within this range is entered.
5. Validations and Error Handling β οΈ
| Validation Type | What is checked? | Error Message / Action |
|---|---|---|
| Sales Order Lock | Attempting 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 Length | Reason must be between 10 and 250 characters. | Red warning: “Relevant reason needs to be filled (Upto 250 characters)” |
| Ref No Length | Reference number length constraint. | Restricted to a maximum of 20 characters. |
| Notes Length | Notes field length constraint. | Restricted to a maximum of 250 characters. |
| Fiscal Year Date | Booking Date outside fiscal boundaries or future dates. | Enforced by standard date picker restrictions. |
6. Related Reports π
- π Pending Order Booking (
Pending_Order_Booking.xlsx): Lists all bookings where committed quantity has not yet been converted into Sales Orders. - π Order Booking Details (
Order_Booking_Details.xlsx): Full conversion trace showing booking commitment, matching sales order numbers, and subsequent invoice details.