subcontracting_inventory_move_first/UPGRADE_GUIDE.md

Upgrade Guide - Version 18.0.1.1.0

Overview

This upgrade adds two major enhancements to the Subcontracting Inventory Move First module:

1. Automatic creation of purchase order lines when linking subcontracting moves
2. Filtering out subcontracting moves that have returns

Installation Steps

1. Update Module Files

Ensure all module files are updated to version 18.0.1.1.0

2. Upgrade Module in Odoo

# Option 1: Via Odoo UI
1. Go to Apps menu
2. Remove "Apps" filter
3. Search for "Subcontracting Inventory Move First"
4. Click "Upgrade" button

# Option 2: Via Command Line
./odoo-bin -u subcontracting_inventory_move_first -d your_database_name

3. Verify Installation

After upgrade, verify:

• The has_return field is computed for all stock moves
• The link dialog only shows moves without returns
• Linking a move creates a purchase order line automatically

What's New

Feature 1: Auto-Create Purchase Order Lines

Before: When linking a subcontracting move to a purchase order, you had to manually create the purchase order line.

After: The system automatically creates a purchase order line with:

• Product from the move
• Quantity from the move's demand quantity
• Unit of measure from the move
• Price from product's standard price

Example:

Subcontracting Move:
- Product: Component A
- Quantity: 100 Units

After Linking → Purchase Order Line Created:
- Product: Component A
- Quantity: 100
- UoM: Units
- Price: $10.00 (from product standard price)

Feature 2: Filter Moves with Returns

Before: All subcontracting moves were shown in the link dialog, including those with returns.

After: Only valid moves (without returns) are shown in the link dialog.

How it works:

• The system checks if any return move references the original move
• Moves with returns are automatically filtered out
• The has_return field is available in tree views for manual filtering

Testing the Upgrade

Test Case 1: Auto-Create Purchase Order Line

1. Create a subcontracting move with:
   • Product: Test Product
   • Quantity: 50
2. Create a purchase order
3. Click "Link Subcontracting Moves"
4. Select the move and click "Link to Purchase Order"
5. Expected Result: A purchase order line is automatically created with the product and quantity

Test Case 2: Filter Moves with Returns

1. Create a subcontracting move and mark it as done
2. Create a return for this move
3. Create a new purchase order
4. Click "Link Subcontracting Moves"
5. Expected Result: The move with return should NOT appear in the list

Rollback Instructions

If you need to rollback:

1. Restore the previous version files
2. Downgrade the module:

   ./odoo-bin -u subcontracting_inventory_move_first -d your_database_name
   

Support

For issues or questions:

• Check the CHANGELOG.md for detailed changes
• Review the README.md for usage instructions
• Contact: Suherdy Yacob

Database Changes

New Fields Added:

• stock.move.has_return (Boolean, Computed, Stored)

Modified Methods:

• purchase.order.link_selected_subcontracting_move() - Now creates PO lines
• purchase.order.action_link_subcontracting_moves() - Updated domain filter
• stock.move._compute_has_return() - New compute method

No Data Migration Required

This upgrade does not require data migration. All changes are backward compatible.