Feature #11949
openComplete Ecommerce Shipping Management – Product-Level Free Shipping, Shipping Charges, Multiple Shipments, Tracking, Cancellation
100%
Description
Implement a complete shipping management system across the customer storefront and admin dashboard.
The system must support product-level free shipping and paid shipping independently within the same order.
An order may contain:
Products eligible for free shipping.
Products requiring shipping charges.
Multiple packages or shipments.
Different shipment tracking numbers.
Different shipping charges for individual shipments.
All shipping calculations, order details, tracking, cancellation, returns, refunds, emails, and push notifications must work consistently throughout the entire order lifecycle.
2. Required Screens
A. Customer Storefront
Screen 1: Product Details Page
Display whether the product has free shipping or paid shipping.
Show applicable shipping charges.
Show free shipping eligibility conditions.
Calculate shipping based on delivery location.
Display shipping information before adding to cart.
Screen 2: Cart Page
Display all products separately.
Identify free-shipping products.
Identify paid-shipping products.
Display shipping charges for applicable products or shipment groups.
Show total product amount, shipping amount, discounts, and final amount.
Recalculate charges when quantity, address, or products change.
Screen 3: Checkout Page
Display product-wise shipping eligibility.
Show free-shipping and paid-shipping breakdowns.
Show delivery address and applicable shipping charges.
Display the final payable amount before payment.
Ensure shipping charges are not added twice.
Screen 4: Payment Confirmation Page
Display the final shipping amount.
Show the order-level shipping breakdown.
Confirm that payment and shipping calculations match.
Screen 5: Order Listing Page
Display order number and order date.
Display total products.
Show how many products qualify for free shipping.
Show how many products require shipping charges.
Display total shipping charges.
Display shipment count and tracking status.
Add filters for:
All Orders
Free Shipping
Paid Shipping
Mixed Shipping
No Shipping Charges
Cancelled Orders
Returned Orders
Screen 6: Order Details Page
Display complete order information.
Display product-wise free/paid shipping status.
Display shipping charges for each applicable product or shipment group.
Display total shipping charges.
Support multiple shipments under one order.
Display individual tracking numbers and shipment statuses.
Display shipment-wise delivery information.
Display cancellation and return eligibility.
Display refunds and shipping charge adjustments.
Include complete order and shipment history.
Screen 7: Shipping Analytics Page
Display total shipping charges collected.
Display free shipping amount.
Display paid shipping amount.
Display orders with free shipping.
Display orders with paid shipping.
Display mixed-shipping orders.
Display total shipments.
Display shipping refunds.
Display cancelled and returned shipments.
Provide date, order status, and shipping type filters.
B. Admin Dashboard
Screen 8: Shipping Management Dashboard
Total shipping charges.
Total free-shipping orders.
Total paid-shipping orders.
Mixed-shipping orders.
Pending shipments.
In-transit shipments.
Delivered shipments.
Cancelled and returned shipments.
Screen 9: Shipping Configuration
Enable or disable free shipping globally.
Enable or disable free shipping for individual products.
Configure shipping charges.
Configure minimum order amount.
Configure location-based shipping charges.
Configure weight-based shipping charges if required.
Configure product-specific shipping rules.
Configure shipping methods.
Configure free-shipping eligibility conditions.
Support environment-based default shipping configuration.
Screen 10: Shipment Management
Manage multiple shipments for one order.
Assign products to individual shipments.
Add shipping provider.
Add tracking number.
Update shipment status.
Update shipment charges.
Track each shipment independently.
Maintain shipment history.
Screen 11: Cancellation & Return Management
Cancel individual products.
Cancel complete orders.
Return individual products.
Return multiple products.
Identify free-shipping and paid-shipping products.
Calculate refundable shipping charges based on configured business rules.
Handle partial and complete refunds.
Prevent duplicate shipping refunds.
Maintain cancellation and return history.
Screen 12: Shipping Notifications
Order confirmation email.
Payment confirmation email.
Shipment created notification.
Shipment dispatched notification.
Tracking update notification.
Out-for-delivery notification.
Delivery confirmation notification.
Cancellation notification.
Return request notification.
Refund confirmation notification.
Support email and push notifications.
3. Important Business Scenarios
Scenario 1: All Products Have Free Shipping
Product A: Free shipping.
Product B: Free shipping.
Shipping total: ₹0.
Scenario 2: All Products Have Paid Shipping
Product A: ₹50 shipping.
Product B: ₹40 shipping.
Shipping total: ₹90, provided both charges are independently applicable.
Scenario 3: Mixed Free and Paid Shipping
Product A: Free shipping.
Product B: ₹50 shipping.
Product C: Free shipping.
Shipping total: ₹50.
Scenario 4: One Order With Multiple Shipments
Product A: Free shipping, Shipment 1.
Product B: ₹50 shipping, Shipment 2.
Product C: ₹30 shipping, Shipment 3.
Maintain three independent tracking records under one order.
Scenario 5: Partial Cancellation Before Shipment
Customer cancels one product.
Recalculate the applicable order shipping amount.
Update the final payable or refund amount according to payment status and shipping policy.
Preserve the original calculation history.
Scenario 6: Partial Cancellation After Shipment
Allow cancellation only when the shipment or product is eligible.
Do not cancel unrelated products or shipments.
Apply configured shipping refund rules.
Update the affected shipment independently.
Scenario 7: Partial Return After Delivery
Customer returns one or more products.
Identify the original shipping eligibility of each product.
Calculate product refund and shipping refund separately.
Apply the configured return shipping policy.
Maintain the complete refund history.
4. Environment Configuration
Create and document the required environment variables.
Examples:
SHIPPING_ENABLED
FREE_SHIPPING_ENABLED
DEFAULT_SHIPPING_CHARGE
FREE_SHIPPING_MIN_ORDER_AMOUNT
SHIPPING_CALCULATION_MODE
SHIPPING_PROVIDER_ENABLED
SHIPPING_TRACKING_ENABLED
SHIPPING_EMAIL_NOTIFICATION_ENABLED
SHIPPING_PUSH_NOTIFICATION_ENABLED
All environment variables must have safe defaults and proper validation.
Do not expose sensitive credentials in frontend code.
5. Important Technical Requirements
Maintain product-level shipping eligibility.
Maintain shipment-level shipping charges.
Support multiple shipments under one order.
Maintain individual tracking records.
Maintain order-level shipping summaries.
Avoid duplicate shipping calculations.
Avoid duplicate shipping charges.
Avoid duplicate refunds.
Maintain historical shipping calculations.
Handle payment success, failure, retry, and cancellation.
Maintain accurate order totals.
Support partial cancellation and partial returns.
Use database transactions for payment, cancellation, and refund operations where appropriate.
Maintain audit logs for shipping changes.
6. Acceptance Criteria
Free shipping and paid shipping must work independently for each product.
Mixed-shipping orders must calculate the correct total.
Multiple shipments must be supported under one order.
Each shipment must have its own tracking number and status.
Order listing must show free-shipping and paid-shipping product counts.
Order details must show complete shipping information.
Shipping analytics must show accurate shipping amounts.
Cancellation must correctly adjust eligible shipping charges.
Returns must calculate product and shipping refunds separately.
Emails and push notifications must reflect actual order and shipment events.
Shipping configuration must work through environment variables and admin settings.
Customer and admin screens must display consistent shipping information.
Existing order and payment functionality must not break.
Subtasks
Related issues