Skip to main content

Parts to Tender Report

The Parts to Tender report allows users to request parts for claims, fleet vehicles, or private jobs. This is where parts are officially entered into the ordering workflow.


Report Location

  • Dashboard: Parts Dashboard
  • Panel: Parts to Tender

Entry Criteria

Records appear in this report when EITHER of these condition groups are met:

Group A: Claim Parts

FormFieldCondition
Part Item ReqTender Status= Pending
Part Item ReqIs Deleted= false
Part Item ReqPart to be Ordered For= Claim
Claims ManagementStatus!= Cancel
Claims ManagementStatus!= Declined
ClaimIs customer vehicle being repaired or total loss!= Total Loss AND != empty

Group B: Non-Claim Parts (Fleet/Private)

FormFieldCondition
Part Item ReqTender Status= Pending
Part Item ReqIs Deleted= false
Part Item ReqPart to be Ordered For!= Claim

Report Columns

ColumnSource FieldDescription
DescriptionPart Item Req → DescriptionPart description
RegistrationPart Item Req → RegistrationVehicle registration
Parts NotesPart Item Req → Part NotesNotes history for the part item
Tender StatusPart Item Req → Tender StatusCurrent tender status
......(other standard columns)

Available Actions

Update Notes Button

Opens the Update Parts Notes form to add follow-up notes for parts in the tender queue.

Form Fields

FieldTypeDescription
DescriptionText (Read-only)Part description (pre-populated from report row)
RegistrationText (Read-only)Vehicle registration (pre-populated from report row)
Part NotesMulti-line (Read-only)Displays existing notes from the Part Item Request record
Add NotesMulti-lineNew notes to append

Form Layout

┌─────────────────────────────────────────────────────────────┐
│ UPDATE PARTS NOTES │
├─────────────────────────────────────────────────────────────┤
│ │
│ Description: [test] (Read Only) │
│ │
│ Registration: [4324234234ss] (Read Only) │
│ │
│ ┌─────────────────────────────────────────────────────┐ │
│ │ Part Notes (Previous) │ │
│ │ │ │
│ │ ganesh kumar 24th July - ... │ │
│ │ ------------------------------------ │ │
│ │ ganesh.au.2024 24th July - ... │ │
│ │ │ │
│ └─────────────────────────────────────────────────────┘ │
│ │
│ ┌─────────────────────────────────────────────────────┐ │
│ │ Add Notes │ │
│ │ │ │
│ │ [Enter new notes here...] │ │
│ │ │ │
│ └─────────────────────────────────────────────────────┘ │
│ │
│ [Submit] │
└─────────────────────────────────────────────────────────────┘

On Success Behavior

When the form is submitted successfully, the system calls parts_item_request.update_parts_notes which:

  1. Gets the user's display name (not email) from the system
  2. Formats the current date with ordinal suffix (e.g., "14th July", "1st August", "23rd June")
  3. Creates a formatted note entry:
    {User Name} {Date} - {Note Content}
  4. Prepends the new note to existing notes with a separator line

Note Format Example

┌─────────────────────────────────────────────────────────────┐
│ Part Notes │
├─────────────────────────────────────────────────────────────┤
│ │
│ John Smith 24th July - Contacted supplier, part is on │
│ backorder. Expected in 2 weeks. │
│ ------------------------------------ │
│ Jane Doe 23rd July - Requested quote from alternative │
│ supplier. │
│ ------------------------------------ │
│ John Smith 22nd July - Initial tender sent to 3 suppliers. │
│ │
└─────────────────────────────────────────────────────────────┘

Date Suffix Rules

DaySuffixExample
1, 21, 31st1st, 21st, 31st
2, 22nd2nd, 22nd
3, 23rd3rd, 23rd
All othersth4th, 5th, 11th, 12th, 14th, etc.

Notes Storage

FormFieldDescription
Part Item RequestPart_NotesStores the concatenated notes history (newest first)

Note: New notes are always added at the top of the existing notes, separated by a line of dashes. This keeps the most recent updates visible first.


Request Parts Button

Opens the Request Parts Form to order parts for:

┌─────────────────────────────────────────────────────────────┐
│ REQUEST PARTS FORM │
├─────────────────────────────────────────────────────────────┤
│ │
│ Parts to be Ordered For: [Dropdown] │
│ ┌──────────────────────────────────────────────────────┐ │
│ │ ○ Claim │ │
│ │ ○ Fleet Vehicle │ │
│ │ ○ Private Job │ │
│ └──────────────────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────┘

Part Types

1. Claim-Based Parts

When Claim is selected:

┌─────────────────────────────────────────────────────────────┐
│ CLAIM SELECTED │
├─────────────────────────────────────────────────────────────┤
│ │
│ Auto-populated fields from Claim: │
│ • Rego (Registration Number) │
│ • Make │
│ • Model │
│ • Year │
│ • VIN Number │
│ • Repairer │
│ │
└─────────────────────────────────────────────────────────────┘

On Submit: Record moves to Parts to Tender report with:

  • Claims Management → Parts Assessment Status = Completed
  • Claims Management → Parts Tendered Status = New

2. Fleet Vehicle Parts

When Fleet Vehicle is selected:

┌─────────────────────────────────────────────────────────────┐
│ FLEET VEHICLE SELECTED │
├─────────────────────────────────────────────────────────────┤
│ │
│ Car Rego: [Dropdown - from Add Car Rego] │
│ │
│ Auto-populated fields from Fleet: │
│ • Make │
│ • Model │
│ • Year │
│ • VIN Number │
│ │
│ * Description appears in BLUE in the report │
│ │
└─────────────────────────────────────────────────────────────┘

Field Updates on Submit:

FieldNew Value
Tendered StatusNew
Parts Tendered DateCurrent date/time

Update Flow: When selecting this record and using Update Parts to Order Form:

  • Moves to Awaiting Approval stage
  • Status changes to Completed

3. Private Job Parts

When Private Job is selected:

┌─────────────────────────────────────────────────────────────┐
│ PRIVATE JOB SELECTED │
├─────────────────────────────────────────────────────────────┤
│ │
│ Manual entry required for all fields: │
│ • Rego (Registration Number) │
│ • Make │
│ • Model │
│ • Year │
│ • VIN Number │
│ │
│ * Same flow as Fleet Vehicle after submission │
│ │
└─────────────────────────────────────────────────────────────┘

Update Parts to Order Form

After selecting a record, the Update Parts to Order Form opens to update the tender.

On Success

ConditionNext Report
Claims Management → Order Parts = YesParts to Order report
Claims Management → Order Parts = No or emptyParts Awaiting Approval report

Field Updates

FormFieldNew Value
Claims ManagementParts Tendered StatusCompleted
Part Item ReqParts Tendered DateCurrent date/time
Part Item ReqDate Approved to OrderCurrent date/time (only if Order Parts = Yes)

Note: The Parts Tendered Date field (displayed as "Date Tendered" column in reports) is automatically populated with the submission timestamp. The Date Approved to Order field is set when the record moves to the Parts to Order report (i.e., when Order Parts = Yes).


Workflow Diagram

┌─────────────────┐
│ Parts to Tender │
└────────┬────────┘


┌─────────────────────────────────────┐
│ Update Parts to Order Form │
└────────┬────────────────────────────┘

┌────┴────────────────┐
│ │
▼ ▼
┌─────────────────┐ ┌─────────────────┐
│ Order Parts=Yes │ │ Order Parts=No │
│ │ │ (or empty) │
└────────┬────────┘ └────────┬────────┘
│ │
▼ ▼
┌─────────────────┐ ┌─────────────────┐
│ Parts to Order │ │ Parts Awaiting │
│ Report │ │ Approval Report │
└─────────────────┘ └─────────────────┘

Visual Indicators

Part TypeDescription Color
ClaimDefault
Fleet VehicleBlue
Private JobDefault (same as Fleet after submit)