-
Notifications
You must be signed in to change notification settings - Fork 2
Air Freight Module ‐ Frontend Beta Testing Guide
This guide provides comprehensive testing procedures for the Air Freight module frontend. The purpose is to:
- Validate end-to-end process flows from booking to shipment delivery
- Identify UI/UX issues, bugs, and functional gaps
- Ensure data integrity and validation rules work correctly
- Test integration points between different doctypes
- Verify dangerous goods compliance workflows
- Test consolidation and pricing features
- Validate milestone tracking and visualization
Based on code analysis, the Air Freight module follows these main process flows:
Sales Quote → Air Booking → Air Shipment → Master Air Waybill → Delivery
Key Steps:
- Create Sales Quote with Air Freight details
- Create Air Booking from Sales Quote (or manually)
- Fetch quotations from Sales Quote to populate Air Booking
- Convert Air Booking to Air Shipment (after submission)
- Link Air Shipment to Master Air Waybill
- Track milestones through delivery
Multiple Air Shipments → Air Consolidation → Master Air Waybill → Delivery
Key Steps:
- Create multiple Air Shipments with compatible routes
- Create Air Consolidation
- Add Air Shipments to consolidation
- Define consolidation routes
- Optimize routes and check capacity
- Generate consolidation reports
Air Shipment with DG → DG Compliance Check → DG Declaration → Compliance Status
Key Steps:
- Mark shipment as containing dangerous goods
- Enter DG details in packages
- Run DG compliance check
- Generate DG declaration
- Monitor compliance status
Sales Quote → Load Charges → Calculate Charges → Recalculate → Total Charges
Key Steps:
- Create Sales Quote with pricing
- Load charges from Sales Quote to Air Shipment
- Recalculate charges based on weight/volume
- Calculate total charges
- Apply discounts and surcharges
Purpose: Verify default settings are applied correctly
Steps:
- Navigate to Air Freight Settings
- Create/Edit settings for your company
- Set default values for:
- Default branch, cost center, profit center
- Default origin/destination ports
- Default airline and freight agent
- Volume to weight factor (default: 167)
- Chargeable weight calculation method
- Default consolidation type
- Auto-create job costing (if applicable)
Expected Results:
- Settings save successfully
- Default values are applied when creating new Air Shipments
- Settings are company-specific
- Cache is cleared on update
Potential Bugs to Check:
- Settings not applying to new documents
- Wrong company settings being used
- Cache not clearing after update
- Validation errors on invalid values
Purpose: Test basic Air Booking creation
Steps:
- Navigate to Air Booking → New
- Fill required fields:
- Booking Date (required)
- Local Customer (required)
- Direction: Import/Export (required)
- Shipper (required)
- Consignee (required)
- Origin Port (required)
- Destination Port (required)
- Fill optional fields:
- Sales Quote (if available)
- Airline
- Freight Agent
- Service Level
- Incoterm
- ETD/ETA dates
- Add packages in Packages table
- Add charges in Charges table
- Save and Submit
Expected Results:
- Document saves successfully
- Required field validations work
- ETD must be before ETA (validation)
- Cost center/profit center/branch belong to company (validation)
- "Convert to Shipment" button appears after submission
- Packages and charges are saved correctly
Potential Bugs to Check:
- Date validation not working (ETD >= ETA)
- Account validation not checking company
- Buttons not appearing/disappearing correctly
- Data not saving in child tables
- Form refresh issues
Purpose: Test integration with Sales Quote
Steps:
- Create a Sales Quote with Air Freight details
- Create new Air Booking
- Select the Sales Quote in the Sales Quote field
- Click "Fetch Quotations" button
- Verify data is populated:
- Customer, Shipper, Consignee
- Origin/Destination ports
- Weight, Volume, Chargeable
- Service Level, Incoterm
- Airline, Freight Agent
- Charges from Sales Quote Air Freight
- Review and adjust populated data
- Save
Expected Results:
- "Fetch Quotations" button appears when Sales Quote is selected
- All relevant fields are populated from Sales Quote
- Charges are correctly mapped from Sales Quote Air Freight
- UOM values are normalized correctly (kg, m³, package, shipment, hour, day)
- Empty fields in Air Booking are filled from Sales Quote
- Existing values in Air Booking are not overwritten
Potential Bugs to Check:
- Button not appearing
- Fields not populating
- Charges not mapping correctly
- UOM normalization errors
- Data overwriting existing values incorrectly
- Error messages not clear
Purpose: Test conversion workflow
Steps:
- Create and Submit an Air Booking
- Click "Convert to Shipment" button
- Confirm the conversion
- Verify new Air Shipment is created with:
- All fields copied from Air Booking
- Packages copied correctly
- Charges copied correctly
- Air Booking reference linked
- Navigate to the new Air Shipment
Expected Results:
- Conversion confirmation dialog appears
- New Air Shipment is created successfully
- All data is copied accurately
- Air Booking reference is set
- User is redirected to new Air Shipment form
- No data loss during conversion
Potential Bugs to Check:
- Conversion fails silently
- Data not copied correctly
- Missing fields in converted document
- Child tables not copied
- Navigation not working
- Duplicate documents created
Purpose: Test automatic application of settings defaults
Steps:
- Ensure Air Freight Settings exist for your company
- Create new Air Shipment
- Verify default values are applied:
- Branch, Cost Center, Profit Center
- Origin/Destination ports
- Airline, Freight Agent
- House Type, Direction, Release Type, Entry Type
- Service Level, Incoterm
- Verify settings are only applied if fields are empty
Expected Results:
- Defaults apply automatically on new document
- Defaults only apply to empty fields
- Settings are company-specific
- No errors during default application
Potential Bugs to Check:
- Defaults not applying
- Defaults overwriting existing values
- Wrong company defaults being used
- Performance issues with settings lookup
Purpose: Test package management and weight calculations
Steps:
- Create new Air Shipment
- Add multiple packages in Packages table:
- Different commodities
- Different weights and volumes
- Different UOMs
- Verify totals are calculated:
- Total weight
- Total volume
- Chargeable weight (based on settings)
- Test volume weight calculation:
- Volume × 167 (or custom factor)
- Chargeable = max(actual weight, volume weight)
- Test with dangerous goods packages:
- Mark package as containing DG
- Enter DG Class, UN Number, Proper Shipping Name
- Verify DG flag is set on shipment
Expected Results:
- Package totals calculate correctly
- Chargeable weight uses correct calculation method
- Volume weight factor is applied correctly
- DG packages trigger compliance checks
- Contains Dangerous Goods flag updates automatically
Potential Bugs to Check:
- Totals not calculating
- Wrong calculation method used
- Volume weight factor incorrect
- DG flag not updating
- Package data not saving
Purpose: Test charge calculation and management
Steps:
- Create Air Shipment with weight/volume data
- Test "Load Charges from Sales Quote" button:
- Link Sales Quote
- Click button
- Verify charges are loaded
- Test charge calculation:
- Add charge manually
- Set charge basis (Per kg, Per m³, Per package, Per shipment, Fixed amount, Percentage)
- Set rate and quantity
- Verify base amount calculates correctly
- Test discount and surcharge:
- Add discount percentage
- Add surcharge amount
- Verify total amount = base - discount + surcharge
- Test "Recalculate All Charges" button
- Test "Calculate Total Charges" button
Expected Results:
- Charges load from Sales Quote correctly
- Charge calculations are accurate for all basis types
- Discounts and surcharges apply correctly
- Recalculate button updates all charges
- Total charges calculation is correct
- Currency is handled properly
Potential Bugs to Check:
- Charges not loading
- Calculation errors for different basis types
- Discount/surcharge not applying
- Recalculate not working
- Total calculation incorrect
- Currency issues
Purpose: Test DG compliance features
Steps:
- Create Air Shipment
- Check "Contains Dangerous Goods" checkbox
- Add package with DG details:
- DG Substance
- UN Number
- Proper Shipping Name
- DG Class
- Is Radioactive (if applicable)
- Temp Controlled (if applicable)
- Emergency Contact Name and Phone
- Verify DG Alert banner appears (if non-compliant)
- Test "Check DG Compliance" button
- Test "Generate DG Declaration" button
- Complete DG declaration:
- Fill all required DG fields
- Mark declaration as complete
- Verify compliance status updates to "Compliant"
- Verify alert banner disappears
Expected Results:
- DG alert appears when non-compliant
- Alert shows correct status and emergency contact
- Compliance check validates all required fields
- DG Declaration is generated successfully
- Compliance status updates correctly
- Alert banner dismisses when compliant
- Milestone view shows DG compliance badge
Potential Bugs to Check:
- Alert not appearing
- Alert not dismissing
- Compliance check not working
- Declaration generation fails
- Status not updating
- Badge not showing in milestones
Purpose: Test milestone HTML generation and display
Steps:
- Create Air Shipment with origin and destination ports
- Verify milestone HTML field displays:
- Origin and destination information
- Shipper and consignee details
- Airline and flight information
- Milestone cards with status
- Route map (if configured)
- Test milestone status updates:
- Capture actual start time
- Capture actual end time
- Verify delayed status shows correctly
- Test milestone actions:
- View milestone details
- Start/End milestone capture
- Change origin/destination ports and verify milestone HTML updates
Expected Results:
- Milestone HTML renders correctly
- All milestone information displays
- Status badges show correct colors
- Delayed milestones are highlighted
- Action icons work correctly
- Map displays route (if API keys configured)
- HTML updates when ports change
Potential Bugs to Check:
- HTML not rendering
- Missing milestone information
- Status badges incorrect
- Action icons not working
- Map not loading
- HTML not updating on port change
- Performance issues with HTML generation
Purpose: Test date field validations
Steps:
- Create Air Shipment
- Test ETD/ETA validation:
- Set ETD after ETA → Should show error
- Set ETD before ETA → Should save
- Test booking date validation
- Test other date fields
Expected Results:
- Date validations work correctly
- Error messages are clear
- Invalid dates are rejected
- Valid dates are accepted
Potential Bugs to Check:
- Validation not working
- Wrong error messages
- Timezone issues
- Date format issues
Purpose: Test consolidation creation
Steps:
- Create multiple Air Shipments with:
- Same origin and destination ports
- Same direction
- Compatible service levels
- Create new Air Consolidation
- Verify settings defaults are applied
- Set consolidation type (Direct, Transit, etc.)
- Add Air Shipments using "Add Air Shipment" button
- Verify shipments are added to consolidation packages table
- Define consolidation routes in Routes table
- Add charges in Charges table
- Save
Expected Results:
- Consolidation creates successfully
- Settings defaults apply
- Shipments are added correctly
- Route validation works (destination of route N = origin of route N+1)
- Capacity constraints are validated
- Incompatible shipments are rejected
- Duplicate shipments are prevented
Potential Bugs to Check:
- Consolidation not saving
- Shipments not adding
- Route validation not working
- Capacity validation not working
- Duplicate shipments allowed
- Settings not applying
Purpose: Test consolidation calculations
Steps:
- Create Air Consolidation with multiple shipments
- Verify metrics calculate:
- Total packages
- Total weight
- Total volume
- Chargeable weight
- Consolidation ratio
- Cost per kg
- Test with different volume-to-weight factors
- Test charge calculations based on chargeable weight
- Test capacity utilization calculations
Expected Results:
- All metrics calculate correctly
- Chargeable weight uses correct method
- Consolidation ratio is accurate
- Cost per kg calculates correctly
- Capacity utilization shows correctly
Potential Bugs to Check:
- Metrics not calculating
- Wrong calculation formulas
- Chargeable weight incorrect
- Ratio calculation wrong
- Capacity utilization wrong
Purpose: Test route optimization features
Steps:
- Create Air Consolidation with multiple routes
- Click "Optimize Routes" button
- Verify routes are reordered by:
- Cost
- Time
- Capacity utilization
- Verify route sequence numbers update
- Test "Check Capacity" button
- Review capacity availability report
Expected Results:
- Routes are optimized correctly
- Sequence numbers update
- Capacity check works
- Report displays correctly
- Optimization considers all factors
Potential Bugs to Check:
- Optimization not working
- Routes not reordering
- Sequence not updating
- Capacity check fails
- Report not displaying
Purpose: Test report generation
Steps:
- Create Air Consolidation with data
- Test "Generate Report" button
- Test "Cost Breakdown" button
- Test "Consolidation Summary" button
- Verify reports show:
- Consolidation details
- Route information
- Package information
- Charge breakdown
- Cost analysis
Expected Results:
- Reports generate successfully
- All data is accurate
- Reports are formatted correctly
- Export functionality works (if available)
Potential Bugs to Check:
- Reports not generating
- Missing data in reports
- Formatting issues
- Export not working
- Performance issues
Purpose: Test DG handling in consolidations
Steps:
- Create Air Consolidation
- Add shipment with dangerous goods
- Verify DG validation:
- Routes must allow DG
- DG segregation rules apply
- Incompatible DG classes are rejected
- Test DG compliance status
- Verify DG packages are tracked
Expected Results:
- DG validation works
- Segregation rules enforced
- Incompatible classes rejected
- Compliance status tracked
- Packages marked correctly
Potential Bugs to Check:
- Validation not working
- Segregation not enforced
- Incompatible classes allowed
- Status not tracking
- Packages not marked
Purpose: Test integration with Sales Quote module
Steps:
- Create Sales Quote with Air Freight section
- Add Air Freight lines with pricing
- Create Air Booking from Sales Quote
- Create Air Shipment from Air Booking
- Verify data flows correctly:
- Customer information
- Route information
- Weight/volume
- Charges and pricing
- Test "Load Charges from Sales Quote" in Air Shipment
Expected Results:
- Data flows correctly through all stages
- Charges are preserved
- Pricing is accurate
- No data loss
Potential Bugs to Check:
- Data not flowing
- Charges missing
- Pricing incorrect
- Data loss
Purpose: Test MAWB linking
Steps:
- Create Master Air Waybill
- Link Air Shipment to MAWB
- Verify flight information appears in Air Shipment
- Test auto-linking from flight schedules
- Verify milestone updates when MAWB status changes
Expected Results:
- Linking works correctly
- Flight info displays
- Auto-linking works
- Milestones update
Potential Bugs to Check:
- Linking not working
- Flight info not showing
- Auto-linking fails
- Milestones not updating
Purpose: Test IATA message handling
Steps:
- Configure IATA Settings
- Test connection
- Send FWB message from Air Shipment
- Receive FSU message
- Verify Air Shipment updates
- Check message queue
Expected Results:
- Connection works
- Messages send/receive correctly
- Shipment updates automatically
- Queue tracks messages
Potential Bugs to Check:
- Connection fails
- Messages not sending
- Messages not receiving
- Shipment not updating
- Queue not tracking
Purpose: Test form usability
Steps:
- Navigate through all Air Freight forms
- Check form layout:
- Sections are logical
- Fields are grouped correctly
- Required fields are marked
- Help text is available
- Test navigation:
- Links work correctly
- Buttons are accessible
- Breadcrumbs work
- Test responsive design (if applicable)
Expected Results:
- Forms are well-organized
- Navigation is intuitive
- All links work
- Responsive design works
Potential Bugs to Check:
- Poor layout
- Fields hard to find
- Navigation broken
- Links not working
- Responsive issues
Purpose: Test all custom buttons
Steps:
- Test all custom buttons in Air Booking:
- Fetch Quotations
- Convert to Shipment
- Test all custom buttons in Air Shipment:
- Load Charges from Sales Quote
- Recalculate All Charges
- Calculate Total Charges
- Check DG Compliance
- Generate DG Declaration
- Send DG Alert
- Test all custom buttons in Air Consolidation:
- Add Air Shipment
- Optimize Routes
- Check Capacity
- Generate Report
- Cost Breakdown
- Consolidation Summary
Expected Results:
- All buttons appear when appropriate
- Buttons execute correctly
- Success/error messages are clear
- Loading indicators show (if applicable)
Potential Bugs to Check:
- Buttons not appearing
- Buttons not working
- Error messages unclear
- No loading indicators
- Buttons appear when they shouldn't
Purpose: Test child table interactions
Steps:
- Test Packages table:
- Add/remove rows
- Edit fields
- Calculations update
- Test Charges table:
- Add/remove rows
- Edit fields
- Calculations update
- Test Routes table (Consolidation):
- Add/remove rows
- Sequence validation
- Date calculations
- Test all child tables for:
- Data persistence
- Validation
- Calculations
Expected Results:
- Child tables work correctly
- Data saves properly
- Validations work
- Calculations update in real-time
Potential Bugs to Check:
- Rows not adding/removing
- Data not saving
- Validations not working
- Calculations not updating
- Performance issues
Purpose: Test alert system
Steps:
- Test DG Alert banner:
- Appears when non-compliant
- Dismisses when compliant
- Shows correct information
- Test form alerts:
- Validation errors
- Success messages
- Warning messages
- Test notification system (if applicable)
Expected Results:
- Alerts appear correctly
- Information is accurate
- Alerts dismiss properly
- Notifications work
Potential Bugs to Check:
- Alerts not appearing
- Wrong information
- Alerts not dismissing
- Notifications not working
Purpose: Test form loading speed
Steps:
- Load Air Shipment with:
- Many packages (50+)
- Many charges (20+)
- Many milestones (10+)
- Measure load time
- Test milestone HTML generation time
- Test with slow network (if possible)
Expected Results:
- Forms load within acceptable time (< 3 seconds)
- Milestone HTML generates quickly
- No timeouts
- Smooth user experience
Potential Bugs to Check:
- Slow loading
- Timeouts
- UI freezing
- Memory issues
Purpose: Test calculation speed
Steps:
- Test charge calculations with many charges
- Test consolidation calculations with many shipments
- Test metric calculations
- Measure calculation time
Expected Results:
- Calculations complete quickly
- No UI blocking
- Results are accurate
Potential Bugs to Check:
- Slow calculations
- UI blocking
- Calculation errors
- Memory leaks
Purpose: Test all validation rules
Steps:
- Test required field validations
- Test date validations (ETD < ETA)
- Test account validations (company matching)
- Test numeric validations (weight, volume > 0)
- Test route validations (consolidation)
- Test DG validations
Expected Results:
- All validations work correctly
- Error messages are clear
- Invalid data is rejected
- Valid data is accepted
Potential Bugs to Check:
- Validations not working
- Wrong error messages
- Invalid data accepted
- Valid data rejected
Purpose: Test data consistency across related documents
Steps:
- Create Air Booking from Sales Quote
- Convert to Air Shipment
- Verify data consistency:
- All fields match
- Totals match
- References are correct
- Test consolidation data consistency
- Test milestone data consistency
Expected Results:
- Data is consistent across documents
- References are correct
- Totals match
- No data corruption
Potential Bugs to Check:
- Data inconsistency
- Wrong references
- Totals don't match
- Data corruption
When reporting bugs, include:
- Title: Clear, concise description
- Module: Air Freight
- Doctype: (Air Booking, Air Shipment, etc.)
- Severity: Critical / High / Medium / Low
-
Steps to Reproduce:
- Step-by-step instructions
- Expected Result: What should happen
- Actual Result: What actually happens
- Screenshots: If applicable
- Browser/Environment: Browser, OS, etc.
- Console Errors: Any JavaScript errors
- ✅ All forms load and save correctly
- ✅ Validations work as expected
- ✅ Calculations are accurate
- ✅ Buttons function properly
- ✅ Data flows correctly between documents
- ✅ DG compliance workflow works
- ✅ Consolidation features work
- ✅ Milestone visualization displays correctly
- ✅ Reports generate successfully
- ✅ Performance is acceptable
- ✅ No console errors
- ✅ No data loss
- ✅ User experience is smooth
- 🔴 Data loss or corruption
- 🔴 System crashes or freezes
- 🔴 Security vulnerabilities
- 🔴 Calculation errors affecting pricing
- 🔴 Validation bypasses
- 🔴 Integration failures
Use this checklist to track your testing progress:
- Air Freight Settings
- Airlines
- Airports/Ports
- Shippers
- Consignees
- Freight Agents
- Manual creation
- Creation from Sales Quote
- Fetch Quotations
- Convert to Shipment
- Validations
- Packages
- Charges
- Settings defaults
- Packages and weight calculations
- Charges management
- DG compliance workflow
- Milestone tracking
- Date validations
- Load charges from Sales Quote
- Creation
- Add shipments
- Metrics and calculations
- Route optimization
- Reports
- DG handling
- Sales Quote integration
- Master Air Waybill integration
- IATA integration (if configured)
- Form layout
- Button functionality
- Child tables
- Alerts and notifications
- Form load time
- Calculation speed
- Validations
- Data consistency
- Test with different user roles (Air Freight Manager, etc.)
- Test with different companies (if multi-company)
- Test edge cases (empty data, large data, special characters)
- Test error scenarios (network failures, invalid data)
- Document any workarounds found
- Note any UI/UX improvements needed
For questions or issues during testing, contact the development team.
Last Updated: Based on code analysis as of current date Version: Beta Testing Guide v1.0
Getting Started
- Getting Started
- Recent Platform Updates
- CargoNext v1 — Release Notes
- CargoNext v1 — Astraea Press Release
- Document Management
- Milestone Tracking
- Customer Portal
Setup and Settings
- Logistics Settings
- Credit Management
- Default Details and Relationships
- Sea Freight Settings
- Air Freight Settings
- Transport Settings
- Warehouse Settings
- Customs Settings
Sea Freight
- Sea Freight Module
- Sea Booking
- Sea Shipment
- Sea Consolidation
- Master Bill
- Shipper
- Consignee
- Container Type
- Container Management
Air Freight
Transport
- Transport Module
- Transport Order
- Transport Job
- Transport Consolidation
- Transport Leg
- Transport Plan
- Run Sheet
- Proof of Delivery
- Transport Template
- Load Type
- Transport Order — Inter-module Field Copy
Customs
Warehousing
- Warehousing Module
- Inbound Order
- Release Order
- Transfer Order
- VAS Order
- Stocktake Order
- Warehouse Job
- Warehouse Contract
- Gate Pass
- Periodic Billing
- Storage Location
- Handling Unit Type
Pricing Center
- Sales Quote
- Sales Quote — Separate Billings and Internal Job
- Change Request
- Sales Quote – Calculation Method
Job Management
- Job Management Module
- Revenue Recognition Policy — Accounts, Dates, and Charges
- Proforma GL Entries
- WIP and Accrual Reversal on Invoicing
Sustainability
Intercompany
Special Projects
Pages
Features
Reports
Glossary