Commit 6d314260ee for woocommerce
commit 6d314260eeb74eff2216d0c7052f6d1f0f7e5956
Author: Taha Paksu <3295+tpaksu@users.noreply.github.com>
Date: Mon Jul 21 12:11:46 2025 +0300
Order fulfillments entity project PR (#57536)
* Add new database tables for fulfillments (#57428)
* Add new database tables for fulfillments
* Add changefile(s) from automation for the following project(s): woocommerce
* Update fulfillment tables to use CURRENT_TIMESTAMP for `date_updated`, which replaces `date_created`
* Add auto update to current timestamp
* Remove setting `date_updated` automatically, making it managed via code
* Add `status` and `is_fulfilled` columns to fulfillments table
---------
Co-authored-by: github-actions <github-actions@github.com>
Co-authored-by: Vladimir Reznichenko <kalessil@gmail.com>
* Add order fulfillments data store (#57429)
* Add new database tables for fulfillments
* Add changefile(s) from automation for the following project(s): woocommerce
* Initial commit
* Add fulfillment object and its data store
* Add changefile(s) from automation for the following project(s): woocommerce
* Move fulfillment related code to src folder
* Remove leftover code changes
* Fix unit test and linter error
* Update fulfillment tables to use CURRENT_TIMESTAMP for `date_updated`, which replaces `date_created`
* Add auto update to current timestamp
* Get datastore via dependency injection, rename date_created to date_updated
* Remove setting `date_updated` automatically, making it managed via code
* Convert errors to exceptions
* Add data and return types to class methods
* Add `status` and `is_fulfilled` columns to fulfillments table
* Refactor Fulfillment class to use data array for properties and update database insertion logic
* Add `read_fulfillments` method, add new column getters/setters, fix tests
* Set defaults, change reset approach
---------
Co-authored-by: github-actions <github-actions@github.com>
Co-authored-by: Vladimir Reznichenko <kalessil@gmail.com>
* Add order fulfillments REST API endpoints (#57496)
* Add new database tables for fulfillments
* Add changefile(s) from automation for the following project(s): woocommerce
* Initial commit
* Add fulfillment object and its data store
* Add changefile(s) from automation for the following project(s): woocommerce
* Move fulfillment related code to src folder
* Remove leftover code changes
* Fix unit test and linter error
* Update fulfillment tables to use CURRENT_TIMESTAMP for `date_updated`, which replaces `date_created`
* Add auto update to current timestamp
* Get datastore via dependency injection, rename date_created to date_updated
* Remove setting `date_updated` automatically, making it managed via code
* Convert errors to exceptions
* Add data and return types to class methods
* Initial commit
* Create the base REST controller file
* Register the REST controller on container, add service provider
* Rename ServiceProvider, omit RestController from the name
* Add strict types declaration
* Add base of the REST methods
* Add `status` and `is_fulfilled` columns to fulfillments table
* Refactor Fulfillment class to use data array for properties and update database insertion logic
* Add `read_fulfillments` method, add new column getters/setters, fix tests
* Set defaults, change reset approach
* Complete fulfillments REST controller code
* Start adding tests
* Fix helper namespace, add strict types check to helper file
* Add more tests
* Finish tests
* Remove meta id assertions from meta data tests
* Remove date_deleted field from test
* Replace using body params with JSON params, fix tests
* Implement not applying actions on deleted records
* Allow arrays to be saved as meta by saving all meta as JSON encoded to the DB
* Reduce duplicated code, improve array validation
* Throw exception instead of returning an error on fulfillment validation
---------
Co-authored-by: github-actions <github-actions@github.com>
Co-authored-by: Vladimir Reznichenko <kalessil@gmail.com>
* Add base user interface for order fulfillments (#57732)
* Initial commit
* Add fulfillments drawer renderer and component
* Add changefile(s) from automation for the following project(s): woocommerce, woocommerce/client/admin
* Fix comments and method naming
* Add tests
* Add check for null screen
* Test returning internal meta keyse to fix unit test error on Github
* Fix non-static method called as static method
* Remove fix attempt as it didn't work
* Fix test error caused by container mock
* Address multiple issues
---------
Co-authored-by: github-actions <github-actions@github.com>
* Add fulfillment editor form on base user interface (#57758)
* Initial commit
* Add fulfillments drawer renderer and component
* Add changefile(s) from automation for the following project(s): woocommerce, woocommerce/client/admin
* Fix comments and method naming
* Add tests
* Add check for null screen
* Test returning internal meta keyse to fix unit test error on Github
* Fix non-static method called as static method
* Remove fix attempt as it didn't work
* Fix test error caused by container mock
* Initial commit
* Add item listing and shipment information blocks
* Add checkbox selection details
* Fix bulk checkbox, add select all link
* Finish shipment information form
* Add notification box and buttons
* Add ShipmentFormContext, restructure components
* Refactor code, create fulfillments list
* Add fulfillment editor
* Fix items reverting after click, fix radio group on shipping options, keep order items visible when a fulfillment details are open
* Address multiple issues
* Add update, delete actions, shipping form manual edit names, componentize recurring code
* Add JS tests
* Fix issues with icons and images, add max-width to drawer
* Split PR into multiple PR's that solve only the focused issue
* Add disabled state when editing a fulfillment
* Disable other fulfillments when editing, add disabled states to buttons, fix test, fix fulfillment UI update after edit
* Add collapse to pending items, css styling
* Fix test
* Set order items open when no fulfillments are available
* Add changefile(s) from automation for the following project(s): woocommerce, woocommerce/client/admin
* Styling fixes, item price fixes
* Fix item selection
* Show new fulfillment form items as checked initially
* Skip disabling header on edit, exit edit mode on drawer close
* Small fixes
---------
Co-authored-by: github-actions <github-actions@github.com>
* Add shipment information box on fulfillment editor (#57989)
* Initial commit
* Add fulfillments drawer renderer and component
* Add changefile(s) from automation for the following project(s): woocommerce, woocommerce/client/admin
* Fix comments and method naming
* Add tests
* Add check for null screen
* Test returning internal meta keyse to fix unit test error on Github
* Fix non-static method called as static method
* Remove fix attempt as it didn't work
* Fix test error caused by container mock
* Initial commit
* Add item listing and shipment information blocks
* Add checkbox selection details
* Fix bulk checkbox, add select all link
* Finish shipment information form
* Add notification box and buttons
* Add ShipmentFormContext, restructure components
* Refactor code, create fulfillments list
* Add fulfillment editor
* Fix items reverting after click, fix radio group on shipping options, keep order items visible when a fulfillment details are open
* Address multiple issues
* Add update, delete actions, shipping form manual edit names, componentize recurring code
* Add JS tests
* Fix issues with icons and images, add max-width to drawer
* Split PR into multiple PR's that solve only the focused issue
* Add disabled state when editing a fulfillment
* Disable other fulfillments when editing, add disabled states to buttons, fix test, fix fulfillment UI update after edit
* Add collapse to pending items, css styling
* Fix test
* Set order items open when no fulfillments are available
* Add changefile(s) from automation for the following project(s): woocommerce, woocommerce/client/admin
* Add shipment information box and tests
* Fix fulfillment shipping settings not updating as expected, add constants for meta keys, disable changing values on lookup form, fix tests
* Add changefile(s) from automation for the following project(s): woocommerce, woocommerce/client/admin
* Styling fixes, item price fixes
* Fix item selection
* Replace H4's with component labels, apply design to tracking number lookup result, add useMemo to context values
* Show new fulfillment form items as checked initially
* Change icon color, undisable header, disable edit mode before closing drawer
* Skip disabling header on edit, exit edit mode on drawer close
* Small fixes
* Increase meta list font size
---------
Co-authored-by: github-actions <github-actions@github.com>
* Add the fulfillment metadata display box (#58010)
* Initial commit
* Add fulfillments drawer renderer and component
* Add changefile(s) from automation for the following project(s): woocommerce, woocommerce/client/admin
* Fix comments and method naming
* Add tests
* Add check for null screen
* Test returning internal meta keyse to fix unit test error on Github
* Fix non-static method called as static method
* Remove fix attempt as it didn't work
* Fix test error caused by container mock
* Initial commit
* Add item listing and shipment information blocks
* Add checkbox selection details
* Fix bulk checkbox, add select all link
* Finish shipment information form
* Add notification box and buttons
* Add ShipmentFormContext, restructure components
* Refactor code, create fulfillments list
* Add fulfillment editor
* Fix items reverting after click, fix radio group on shipping options, keep order items visible when a fulfillment details are open
* Address multiple issues
* Add update, delete actions, shipping form manual edit names, componentize recurring code
* Add JS tests
* Fix issues with icons and images, add max-width to drawer
* Split PR into multiple PR's that solve only the focused issue
* Add disabled state when editing a fulfillment
* Disable other fulfillments when editing, add disabled states to buttons, fix test, fix fulfillment UI update after edit
* Add collapse to pending items, css styling
* Fix test
* Set order items open when no fulfillments are available
* Add changefile(s) from automation for the following project(s): woocommerce, woocommerce/client/admin
* Add shipment information box and tests
* Fix fulfillment shipping settings not updating as expected, add constants for meta keys, disable changing values on lookup form, fix tests
* Add changefile(s) from automation for the following project(s): woocommerce, woocommerce/client/admin
* Add the fulfillment metadata display box
* Add changefile(s) from automation for the following project(s): woocommerce, woocommerce/client/admin
* Styling fixes, item price fixes
* Fix item selection
* Replace H4's with component labels, apply design to tracking number lookup result, add useMemo to context values
* Show new fulfillment form items as checked initially
* Change icon color, undisable header, disable edit mode before closing drawer
* Skip disabling header on edit, exit edit mode on drawer close
* Small fixes
* Increase meta list font size
---------
Co-authored-by: github-actions <github-actions@github.com>
* Add customer notification box to fulfillment editor form (#58551)
* Initial commit
* Add fulfillments drawer renderer and component
* Add changefile(s) from automation for the following project(s): woocommerce, woocommerce/client/admin
* Fix comments and method naming
* Add tests
* Add check for null screen
* Test returning internal meta keyse to fix unit test error on Github
* Fix non-static method called as static method
* Remove fix attempt as it didn't work
* Fix test error caused by container mock
* Initial commit
* Add item listing and shipment information blocks
* Add checkbox selection details
* Fix bulk checkbox, add select all link
* Finish shipment information form
* Add notification box and buttons
* Add ShipmentFormContext, restructure components
* Refactor code, create fulfillments list
* Add fulfillment editor
* Fix items reverting after click, fix radio group on shipping options, keep order items visible when a fulfillment details are open
* Address multiple issues
* Add update, delete actions, shipping form manual edit names, componentize recurring code
* Add JS tests
* Fix issues with icons and images, add max-width to drawer
* Split PR into multiple PR's that solve only the focused issue
* Add disabled state when editing a fulfillment
* Disable other fulfillments when editing, add disabled states to buttons, fix test, fix fulfillment UI update after edit
* Add collapse to pending items, css styling
* Fix test
* Set order items open when no fulfillments are available
* Add changefile(s) from automation for the following project(s): woocommerce, woocommerce/client/admin
* Add shipment information box and tests
* Fix fulfillment shipping settings not updating as expected, add constants for meta keys, disable changing values on lookup form, fix tests
* Add changefile(s) from automation for the following project(s): woocommerce, woocommerce/client/admin
* Add the fulfillment metadata display box
* Add changefile(s) from automation for the following project(s): woocommerce, woocommerce/client/admin
* Add customer notification box, connect it to REST API endpoints
* Styling fixes, item price fixes
* Fix item selection
* Replace H4's with component labels, apply design to tracking number lookup result, add useMemo to context values
* Show new fulfillment form items as checked initially
* Change icon color, undisable header, disable edit mode before closing drawer
* Skip disabling header on edit, exit edit mode on drawer close
* Fix indenting errors after merge commit
* Add remove fulfilled fulfillment confirmation modal
* Small fixes
* Increase meta list font size
* Fix tests
* Add confirmation test
* Add changefile(s) from automation for the following project(s): woocommerce, woocommerce/client/admin
---------
Co-authored-by: github-actions <github-actions@github.com>
* Add order fulfillment notification emails (#58558)
* Initial commit
* Add fulfillments drawer renderer and component
* Add changefile(s) from automation for the following project(s): woocommerce, woocommerce/client/admin
* Fix comments and method naming
* Add tests
* Add check for null screen
* Test returning internal meta keyse to fix unit test error on Github
* Fix non-static method called as static method
* Remove fix attempt as it didn't work
* Fix test error caused by container mock
* Initial commit
* Add item listing and shipment information blocks
* Add checkbox selection details
* Fix bulk checkbox, add select all link
* Finish shipment information form
* Add notification box and buttons
* Add ShipmentFormContext, restructure components
* Refactor code, create fulfillments list
* Add fulfillment editor
* Fix items reverting after click, fix radio group on shipping options, keep order items visible when a fulfillment details are open
* Address multiple issues
* Add update, delete actions, shipping form manual edit names, componentize recurring code
* Add JS tests
* Fix issues with icons and images, add max-width to drawer
* Split PR into multiple PR's that solve only the focused issue
* Add disabled state when editing a fulfillment
* Disable other fulfillments when editing, add disabled states to buttons, fix test, fix fulfillment UI update after edit
* Add collapse to pending items, css styling
* Fix test
* Set order items open when no fulfillments are available
* Add changefile(s) from automation for the following project(s): woocommerce, woocommerce/client/admin
* Add shipment information box and tests
* Fix fulfillment shipping settings not updating as expected, add constants for meta keys, disable changing values on lookup form, fix tests
* Add changefile(s) from automation for the following project(s): woocommerce, woocommerce/client/admin
* Add the fulfillment metadata display box
* Add changefile(s) from automation for the following project(s): woocommerce, woocommerce/client/admin
* Add customer notification box, connect it to REST API endpoints
* Styling fixes, item price fixes
* Fix item selection
* Replace H4's with component labels, apply design to tracking number lookup result, add useMemo to context values
* Show new fulfillment form items as checked initially
* Change icon color, undisable header, disable edit mode before closing drawer
* Skip disabling header on edit, exit edit mode on drawer close
* Fix indenting errors after merge commit
* Add remove fulfilled fulfillment confirmation modal
* Small fixes
* Increase meta list font size
* Fix tests
* Add confirmation test
* Add changefile(s) from automation for the following project(s): woocommerce, woocommerce/client/admin
* Initial push
* Add fulfillment created emails and bind to actions
* Add plaintext fulfillment emails
* Add tests, rename file
* Add changefile(s) from automation for the following project(s): woocommerce
* Fix code indentation error after merge
* Fix `woocommmerce` typo
* Fix comments and optimize code
---------
Co-authored-by: github-actions <github-actions@github.com>
* Add fulfillments to customer order details page (#58713)
* Initial push
* Add customer order display modifications
* Fix error caused by null order
* Add changefile(s) from automation for the following project(s): woocommerce
* Add `_fulfilled_date` metadata automatically on fulfill
* Add date fulfilled getter/setter as a method of Fulfillment object
* Move fulfillment details into hook, fix file paths in comments
* Replace strong with mark on order status details text
* Replace with space
---------
Co-authored-by: github-actions <github-actions@github.com>
* Add lock meta and it's handling (#58832)
* Add lock meta and it's handling
* Add JS tests
* Add changefile(s) from automation for the following project(s): woocommerce, woocommerce/client/admin
* Update design
* Update plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/user-interface/lock-label.tsx
Co-authored-by: Fernando Espinosa <Ferdev@users.noreply.github.com>
---------
Co-authored-by: github-actions <github-actions@github.com>
Co-authored-by: Fernando Espinosa <Ferdev@users.noreply.github.com>
* Add bulk fulfillment actions (#58824)
* Initial push
* Add initial bulk actions code
* Handle fulfilling existing fulfillments of the order
* Add tests
* Add legacy CPT order type support
* Fix tests
* Add changefile(s) from automation for the following project(s): woocommerce
* Fix utility method
* Remove unfulfill action
* Ensure items are saved as arrays
* Fix test
* Fix formatting after merge
---------
Co-authored-by: github-actions <github-actions@github.com>
* Add filter and action for fulfillment creation (#58793)
* Add filter and action for fulfillment creation
* Remove metadata viewer test code
* Fix JS tests
* Refine fulfillment error message delivery via hooks
* Add changefile(s) from automation for the following project(s): woocommerce, woocommerce/client/admin
* Fix comment
* Modify fulfill items button to show message
* Optimize JS code
* Optimize missed JS code
* Remove code that tries to recreate fulfillment after deletion
* Fix alignment
* Apply patch to remove React checkbox component warnings
---------
Co-authored-by: github-actions <github-actions@github.com>
* Add initial shipping providers support (#58731)
* Initial push
* Add initial shipping providers support
* Fix tests
* Add strict types declaration
* Add changefile(s) from automation for the following project(s): woocommerce, woocommerce/client/admin
* Add tests
* Fix test related to emails PR, unrelated with this one
* Improve comment, fix printing prices for orders without currency
* Use wp_localize_script instead of echo
* Revert wp_localize_script mods
---------
Co-authored-by: github-actions <github-actions@github.com>
* Add filter and action for fulfillment update (#58810)
* Add filter and action for fulfillment creation
* Remove metadata viewer test code
* Fix JS tests
* Refine fulfillment error message delivery via hooks
* Initial push
* Add filter and action for fulfillment update
* Add changefile(s) from automation for the following project(s): woocommerce, woocommerce/client/admin
* Add changefile(s) from automation for the following project(s): woocommerce
* Add changefile(s) from automation for the following project(s): woocommerce
* Fix comment
* Modify fulfill items button to show message
* Modify update button to show error
* Optimize JS code
* Optimize JS code
* Optimize missed JS code
* Remove code that tries to recreate fulfillment after deletion
* Fix alignment
* Fix circular execution of hook
* Remove debug code
---------
Co-authored-by: github-actions <github-actions@github.com>
* Add filter and action for fulfillment delete (#58812)
* Add filter and action for fulfillment creation
* Remove metadata viewer test code
* Fix JS tests
* Refine fulfillment error message delivery via hooks
* Initial push
* Add filter and action for fulfillment update
* Add changefile(s) from automation for the following project(s): woocommerce, woocommerce/client/admin
* Add changefile(s) from automation for the following project(s): woocommerce
* Add filter and action for fulfillment delete
* Add changefile(s) from automation for the following project(s): woocommerce
* Add changefile(s) from automation for the following project(s): woocommerce
* Fix comment
* Modify fulfill items button to show message
* Modify update button to show error
* Modify remove button to show error
* Optimize JS code
* Optimize JS code
* Optimize JS code
* Optimize missed JS code
* Remove code that tries to recreate fulfillment after deletion
* Fix alignment
* Fix circular execution of hook
* Add check for action to prevent recursion
* Remove debug code
---------
Co-authored-by: github-actions <github-actions@github.com>
* Add filter and action for fulfillment fulfilling (#58823)
* Add filter and action for fulfillment creation
* Remove metadata viewer test code
* Fix JS tests
* Refine fulfillment error message delivery via hooks
* Initial push
* Add filter and action for fulfillment update
* Add changefile(s) from automation for the following project(s): woocommerce, woocommerce/client/admin
* Add changefile(s) from automation for the following project(s): woocommerce
* Add filter and action for fulfillment delete
* Add changefile(s) from automation for the following project(s): woocommerce
* Add changefile(s) from automation for the following project(s): woocommerce
* Fix comment
* Add filter and action for fulfillment fulfilling
* Add changefile(s) from automation for the following project(s): woocommerce, woocommerce/client/admin
* Modify fulfill items button to show message
* Modify update button to show error
* Modify remove button to show error
* Update fulfill-items-button.tsx
* Optimize JS code
* Optimize JS code
* Optimize JS code
* Optimize missed JS code
* Remove code that tries to recreate fulfillment after deletion
* Fix alignment
* Fix circular execution of hook
* Add check for action to prevent recursion
* Add constraints for hooks, and param docblocks
* Remove debug code
---------
Co-authored-by: github-actions <github-actions@github.com>
* Fix fulfillment object rendering (#58978)
* Fix fulfillment object rendering
* Add changefile(s) from automation for the following project(s): woocommerce
* Fix tests
---------
Co-authored-by: github-actions <github-actions@github.com>
* Add fulfillments drawer to order details (#58859)
* Add filter by fulfillment status select to the orders list (#58865)
* Add the select to the orders list
* Add filter query
* Fix lint error
* Fix linter error
* Save order fulfillment statuses as order meta on each update
* Fix tests and bugs found from tests
* Make filters work both in legacy orders table and HPOS order table
* Remove initial order fulfillment status setting, and adjust filters
* Remove fulfillment status saving on table render
* Fix tests
* Add tests
* Add changefile(s) from automation for the following project(s): woocommerce
* Fix merge conflicts and tests
* Fix select displaying labels properly
---------
Co-authored-by: github-actions <github-actions@github.com>
* Add auto-fulfillment settings for virtual and downloadable items (#59085)
* Fix class autoloader, and add settings page mods
* Fix email rendering issues
* Add changefile(s) from automation for the following project(s): woocommerce
* Use order object instead of order_id and `wc_get_order` call
* Make the order check a bit more secure
* Change hooks used for auto-fulfillment covering all scenarios
* Defer settings modification to init to make product settings tests pass
---------
Co-authored-by: github-actions <github-actions@github.com>
* Add `wc_fulfillment_statuses` filter, and utility to get status properties (#58963)
* Add the select to the orders list
* Add filter query
* Add filter and util
* Fix recursion by converting main filter to a getter
* Fix lint error
* Fix lint error
* Fix linter error
* Save order fulfillment statuses as order meta on each update
* Fix tests and bugs found from tests
* Make filters work both in legacy orders table and HPOS order table
* Remove initial order fulfillment status setting, and adjust filters
* Remove fulfillment status saving on table render
* Fix tests
* Add tests
* Add changefile(s) from automation for the following project(s): woocommerce
* Revert changes
* Add custom status support and rendering props
* Fix tests and merge conflicts
* Fix linter error after merge
* Allow plugins to modify order fulfillment status
* Add tests for fulfillment status filters
* Fix namespace
* Fix client scripts to display fulfillment statuses correctly
* Add changefile(s) from automation for the following project(s): woocommerce, woocommerce/client/admin
* Make is_fulfilled field private, and computed from status field, fix tests
* Remove private set_is_fulfilled call
---------
Co-authored-by: github-actions <github-actions@github.com>
* Add filter for individual item auto-fulfillment (#59101)
* Add shipping provider PNG image logos and replace base64 encoded images (#59205)
* Add shipping provider PNG image logos and replace base64 encoded images
* Add changefile(s) from automation for the following project(s): woocommerce
---------
Co-authored-by: github-actions <github-actions@github.com>
* Convert shipping provider configuration arrays into shipping provider classes (#59214)
* Add shipping provider PNG image logos and replace base64 encoded images
* Add changefile(s) from automation for the following project(s): woocommerce
* Convert shipping provider configuration arrays into shipping provider classes, adapt UI and JS variable export to changes
* Add tests
* Fix namespace
* Fix class name case
* Fix another classname case issue
* Fix shipping provider class initialization with DI
* Fix tracking number parse response handling
* Fix test
* Add all matches to parsing results, normalize tracking number
---------
Co-authored-by: github-actions <github-actions@github.com>
* Add tracking number parsing support for UPS shipping provider (#59222)
* Add shipping provider PNG image logos and replace base64 encoded images
* Add changefile(s) from automation for the following project(s): woocommerce
* Convert shipping provider configuration arrays into shipping provider classes, adapt UI and JS variable export to changes
* Add tests
* Fix namespace
* Fix class name case
* Fix another classname case issue
* Add tracking number parsing support for UPS shipping provider
* Fix shipping provider class initialization with DI
* Fix tracking number parse response handling
* Fix test
* Fix namespace of test file
* Add ambiguity scoring
* Shipping provider and test changes
* Elaborate Surepost format
* Add all matches to parsing results, normalize tracking number
---------
Co-authored-by: github-actions <github-actions@github.com>
* Add tracking number parsing support for USPS shipping provider (#59229)
* Add shipping provider PNG image logos and replace base64 encoded images
* Add changefile(s) from automation for the following project(s): woocommerce
* Convert shipping provider configuration arrays into shipping provider classes, adapt UI and JS variable export to changes
* Add tests
* Fix namespace
* Fix class name case
* Fix another classname case issue
* Add tracking number parsing support for UPS shipping provider
* Fix shipping provider class initialization with DI
* Fix tracking number parse response handling
* Fix test
* Fix namespace of test file
* Add tracking number parsing support for USPS shipping provider
* Add ambiguity scoring
* Add ambiguity scoring
* Shipping provider and test changes
* Modify USPS parser code
* Boost score when one of the countries is US
* Elaborate Surepost format
* Add all matches to parsing results, normalize tracking number
---------
Co-authored-by: github-actions <github-actions@github.com>
* Add tracking number parsing support for FedEx shipping provider (#59248)
* Add shipping provider PNG image logos and replace base64 encoded images
* Add changefile(s) from automation for the following project(s): woocommerce
* Convert shipping provider configuration arrays into shipping provider classes, adapt UI and JS variable export to changes
* Add tests
* Fix namespace
* Fix class name case
* Fix another classname case issue
* Add tracking number parsing support for UPS shipping provider
* Fix shipping provider class initialization with DI
* Fix tracking number parse response handling
* Fix test
* Fix namespace of test file
* Add tracking number parsing support for USPS shipping provider
* Add ambiguity scoring
* Add ambiguity scoring
* Add tracking number parsing support for FedEx shipping provider
* Shipping provider and test changes
* Modify USPS parser code
* Shipping provider changes
* Boost score when one of the countries is US
* Elaborate Surepost format
* Add all matches to parsing results, normalize tracking number
---------
Co-authored-by: github-actions <github-actions@github.com>
* Add tracking number parsing support for DHL shipping provider (#59249)
* Add shipping provider PNG image logos and replace base64 encoded images
* Add changefile(s) from automation for the following project(s): woocommerce
* Convert shipping provider configuration arrays into shipping provider classes, adapt UI and JS variable export to changes
* Add tests
* Fix namespace
* Fix class name case
* Fix another classname case issue
* Add tracking number parsing support for UPS shipping provider
* Fix shipping provider class initialization with DI
* Fix tracking number parse response handling
* Fix test
* Fix namespace of test file
* Add tracking number parsing support for USPS shipping provider
* Add ambiguity scoring
* Add ambiguity scoring
* Add tracking number parsing support for FedEx shipping provider
* Add tracking number parsing support for DHL shipping provider
### Submission Review Guidelines:
- I have followed the [WooCommerce Contributing Guidelines](https://github.com/woocommerce/woocommerce/blob/trunk/.github/CONTRIBUTING.md) and the [WordPress Coding Standards](https://make.wordpress.org/core/handbook/best-practices/coding-standards/).
- I have checked to ensure there aren't other open [Pull Requests](https://github.com/woocommerce/woocommerce/pulls) for the same update/change.
- I have reviewed my code for [security best practices](https://developer.wordpress.org/apis/security/).
- Following the above guidelines will result in quick merges and clear and detailed feedback when appropriate.
### Changes proposed in this Pull Request:
This PR adds initial support for detecting and parsing DHL tracking numbers within the fulfillment provider system.
Closes #59204 WOOPLUG-4802
### How to test the changes in this Pull Request:
1. Checkout this branch
2. Run `pnpm run watch:build`
3. Run `composer dumpautoload` if needed
4. Go to WooCommerce > Orders and create a fulfillment if needed
5. In the shipping information box, enter the following tracking numbers:
#### ✅ Valid DHL
- `1234567890` (DE → US) → DHL (Score: 80)
- `JJD1234567890` (US → FR) → DHL (Score: 95)
- `JJD00123456789012` (GB → IT) → DHL (Score: 95)
#### ❌ Not DHL
- `INVALID1234` (DE → US)
- `JJD123` (JP → GB)
- `1234567890` (ZZ → US)
Verify correct results appear in the fulfillment drawer.
### Changelog entry
- [x] This Pull Request does not require a changelog entry. (Comment required below)
<details>
<summary>Changelog Entry Details</summary>
#### Significance
- [x] Patch
#### Type
- [x] Add - Adds functionality
#### Message
</details>
<details>
<summary>Changelog Entry Comment</summary>
#### Comment
This is a part of a feature branch which will have a single changelog entry when merged to trunk.
</details>
* Shipping provider and test changes
* Modify USPS parser code
* Shipping provider changes
* Shipping provider changes
* Boost score when one of the countries is US
* Elaborate Surepost format
* Add all matches to parsing results, normalize tracking number
---------
Co-authored-by: github-actions <github-actions@github.com>
* Add tracking number parsing support for Amazon Logistics shipping provider (#59250)
* Add shipping provider PNG image logos and replace base64 encoded images
* Add changefile(s) from automation for the following project(s): woocommerce
* Convert shipping provider configuration arrays into shipping provider classes, adapt UI and JS variable export to changes
* Add tests
* Fix namespace
* Fix class name case
* Fix another classname case issue
* Add tracking number parsing support for UPS shipping provider
* Fix shipping provider class initialization with DI
* Fix tracking number parse response handling
* Fix test
* Fix namespace of test file
* Add tracking number parsing support for USPS shipping provider
* Add ambiguity scoring
* Add ambiguity scoring
* Add tracking number parsing support for FedEx shipping provider
* Add tracking number parsing support for DHL shipping provider
### Submission Review Guidelines:
- I have followed the [WooCommerce Contributing Guidelines](https://github.com/woocommerce/woocommerce/blob/trunk/.github/CONTRIBUTING.md) and the [WordPress Coding Standards](https://make.wordpress.org/core/handbook/best-practices/coding-standards/).
- I have checked to ensure there aren't other open [Pull Requests](https://github.com/woocommerce/woocommerce/pulls) for the same update/change.
- I have reviewed my code for [security best practices](https://developer.wordpress.org/apis/security/).
- Following the above guidelines will result in quick merges and clear and detailed feedback when appropriate.
### Changes proposed in this Pull Request:
This PR adds initial support for detecting and parsing DHL tracking numbers within the fulfillment provider system.
Closes #59204 WOOPLUG-4802
### How to test the changes in this Pull Request:
1. Checkout this branch
2. Run `pnpm run watch:build`
3. Run `composer dumpautoload` if needed
4. Go to WooCommerce > Orders and create a fulfillment if needed
5. In the shipping information box, enter the following tracking numbers:
#### ✅ Valid DHL
- `1234567890` (DE → US) → DHL (Score: 80)
- `JJD1234567890` (US → FR) → DHL (Score: 95)
- `JJD00123456789012` (GB → IT) → DHL (Score: 95)
#### ❌ Not DHL
- `INVALID1234` (DE → US)
- `JJD123` (JP → GB)
- `1234567890` (ZZ → US)
Verify correct results appear in the fulfillment drawer.
### Changelog entry
- [x] This Pull Request does not require a changelog entry. (Comment required below)
<details>
<summary>Changelog Entry Details</summary>
#### Significance
- [x] Patch
#### Type
- [x] Add - Adds functionality
#### Message
</details>
<details>
<summary>Changelog Entry Comment</summary>
#### Comment
This is a part of a feature branch which will have a single changelog entry when merged to trunk.
</details>
* Add tracking number parsing support for Amazon Logistics shipping provider
### Submission Review Guidelines:
- I have followed the [WooCommerce Contributing Guidelines](https://github.com/woocommerce/woocommerce/blob/trunk/.github/CONTRIBUTING.md) and the [WordPress Coding Standards](https://make.wordpress.org/core/handbook/best-practices/coding-standards/).
- I have checked to ensure there aren't other open [Pull Requests](https://github.com/woocommerce/woocommerce/pulls) for the same update/change.
- I have reviewed my code for [security best practices](https://developer.wordpress.org/apis/security/).
### Changes proposed in this Pull Request:
This PR adds initial support for detecting and parsing **Amazon Logistics (TBA...)** tracking numbers in the fulfillment provider system. Amazon tracking numbers typically start with `TBA` and are specific to Amazon's delivery network.
Closes #59233 WOOPLUG-4816
### How to test the changes in this Pull Request:
1. Checkout this branch
2. Run `pnpm run watch:build`
3. Run `composer dumpautoload` if needed
4. Go to WooCommerce > Orders and create a fulfillment if you don't have one.
5. In the fulfillment shipping info box, use tracking numbers like the following:
```md
- TBA1234567890 (US → US) → ✅ Amazon Logistics
- TBA000000000X (CA → CA) → ✅ Amazon Logistics
- tba111222333 (GB → DE) → ✅ Amazon Logistics
- TBX1234567890 (US → US) → ❌ Not Amazon Logistics
- TBA1234567890 (US → BR) → ❌ Not Amazon Logistics
* Fix tests
* Shipping provider and test changes
* Modify USPS parser code
* Shipping provider changes
* Shipping provider changes
* Shipping provider changes
* Fix lint errors
* Boost score when one of the countries is US
* Elaborate Surepost format
* Add all matches to parsing results, normalize tracking number
---------
Co-authored-by: github-actions <github-actions@github.com>
* Add tracking number parsing support for DPD shipping provider (#59256)
* Add shipping provider PNG image logos and replace base64 encoded images
* Add changefile(s) from automation for the following project(s): woocommerce
* Convert shipping provider configuration arrays into shipping provider classes, adapt UI and JS variable export to changes
* Add tests
* Fix namespace
* Fix class name case
* Fix another classname case issue
* Add tracking number parsing support for UPS shipping provider
* Fix shipping provider class initialization with DI
* Fix tracking number parse response handling
* Fix test
* Fix namespace of test file
* Add tracking number parsing support for USPS shipping provider
* Add ambiguity scoring
* Add ambiguity scoring
* Add tracking number parsing support for FedEx shipping provider
* Add tracking number parsing support for DHL shipping provider
### Submission Review Guidelines:
- I have followed the [WooCommerce Contributing Guidelines](https://github.com/woocommerce/woocommerce/blob/trunk/.github/CONTRIBUTING.md) and the [WordPress Coding Standards](https://make.wordpress.org/core/handbook/best-practices/coding-standards/).
- I have checked to ensure there aren't other open [Pull Requests](https://github.com/woocommerce/woocommerce/pulls) for the same update/change.
- I have reviewed my code for [security best practices](https://developer.wordpress.org/apis/security/).
- Following the above guidelines will result in quick merges and clear and detailed feedback when appropriate.
### Changes proposed in this Pull Request:
This PR adds initial support for detecting and parsing DHL tracking numbers within the fulfillment provider system.
Closes #59204 WOOPLUG-4802
### How to test the changes in this Pull Request:
1. Checkout this branch
2. Run `pnpm run watch:build`
3. Run `composer dumpautoload` if needed
4. Go to WooCommerce > Orders and create a fulfillment if needed
5. In the shipping information box, enter the following tracking numbers:
#### ✅ Valid DHL
- `1234567890` (DE → US) → DHL (Score: 80)
- `JJD1234567890` (US → FR) → DHL (Score: 95)
- `JJD00123456789012` (GB → IT) → DHL (Score: 95)
#### ❌ Not DHL
- `INVALID1234` (DE → US)
- `JJD123` (JP → GB)
- `1234567890` (ZZ → US)
Verify correct results appear in the fulfillment drawer.
### Changelog entry
- [x] This Pull Request does not require a changelog entry. (Comment required below)
<details>
<summary>Changelog Entry Details</summary>
#### Significance
- [x] Patch
#### Type
- [x] Add - Adds functionality
#### Message
</details>
<details>
<summary>Changelog Entry Comment</summary>
#### Comment
This is a part of a feature branch which will have a single changelog entry when merged to trunk.
</details>
* Add tracking number parsing support for Amazon Logistics shipping provider
### Submission Review Guidelines:
- I have followed the [WooCommerce Contributing Guidelines](https://github.com/woocommerce/woocommerce/blob/trunk/.github/CONTRIBUTING.md) and the [WordPress Coding Standards](https://make.wordpress.org/core/handbook/best-practices/coding-standards/).
- I have checked to ensure there aren't other open [Pull Requests](https://github.com/woocommerce/woocommerce/pulls) for the same update/change.
- I have reviewed my code for [security best practices](https://developer.wordpress.org/apis/security/).
### Changes proposed in this Pull Request:
This PR adds initial support for detecting and parsing **Amazon Logistics (TBA...)** tracking numbers in the fulfillment provider system. Amazon tracking numbers typically start with `TBA` and are specific to Amazon's delivery network.
Closes #59233 WOOPLUG-4816
### How to test the changes in this Pull Request:
1. Checkout this branch
2. Run `pnpm run watch:build`
3. Run `composer dumpautoload` if needed
4. Go to WooCommerce > Orders and create a fulfillment if you don't have one.
5. In the fulfillment shipping info box, use tracking numbers like the following:
```md
- TBA1234567890 (US → US) → ✅ Amazon Logistics
- TBA000000000X (CA → CA) → ✅ Amazon Logistics
- tba111222333 (GB → DE) → ✅ Amazon Logistics
- TBX1234567890 (US → US) → ❌ Not Amazon Logistics
- TBA1234567890 (US → BR) → ❌ Not Amazon Logistics
* Fix tests
* Add tracking number parsing support for DPD shipping provider
* Shipping provider and test changes
* Modify USPS parser code
* Shipping provider changes
* Shipping provider changes
* Shipping provider changes
* Fix lint errors
* Shipping provider changes
* Fix linter error
* Boost score when one of the countries is US
* Elaborate Surepost format
* Add all matches to parsing results, normalize tracking number
* Prioritize DPD over FedEx in EU
---------
Co-authored-by: github-actions <github-actions@github.com>
* Add tracking number parsing support for Evri (Hermes) shipping provider (#59298)
* Add shipping provider PNG image logos and replace base64 encoded images
* Add changefile(s) from automation for the following project(s): woocommerce
* Convert shipping provider configuration arrays into shipping provider classes, adapt UI and JS variable export to changes
* Add tests
* Fix namespace
* Fix class name case
* Fix another classname case issue
* Add tracking number parsing support for UPS shipping provider
* Fix shipping provider class initialization with DI
* Fix tracking number parse response handling
* Fix test
* Fix namespace of test file
* Add tracking number parsing support for USPS shipping provider
* Add ambiguity scoring
* Add ambiguity scoring
* Add tracking number parsing support for FedEx shipping provider
* Add tracking number parsing support for DHL shipping provider
### Submission Review Guidelines:
- I have followed the [WooCommerce Contributing Guidelines](https://github.com/woocommerce/woocommerce/blob/trunk/.github/CONTRIBUTING.md) and the [WordPress Coding Standards](https://make.wordpress.org/core/handbook/best-practices/coding-standards/).
- I have checked to ensure there aren't other open [Pull Requests](https://github.com/woocommerce/woocommerce/pulls) for the same update/change.
- I have reviewed my code for [security best practices](https://developer.wordpress.org/apis/security/).
- Following the above guidelines will result in quick merges and clear and detailed feedback when appropriate.
### Changes proposed in this Pull Request:
This PR adds initial support for detecting and parsing DHL tracking numbers within the fulfillment provider system.
Closes #59204 WOOPLUG-4802
### How to test the changes in this Pull Request:
1. Checkout this branch
2. Run `pnpm run watch:build`
3. Run `composer dumpautoload` if needed
4. Go to WooCommerce > Orders and create a fulfillment if needed
5. In the shipping information box, enter the following tracking numbers:
#### ✅ Valid DHL
- `1234567890` (DE → US) → DHL (Score: 80)
- `JJD1234567890` (US → FR) → DHL (Score: 95)
- `JJD00123456789012` (GB → IT) → DHL (Score: 95)
#### ❌ Not DHL
- `INVALID1234` (DE → US)
- `JJD123` (JP → GB)
- `1234567890` (ZZ → US)
Verify correct results appear in the fulfillment drawer.
### Changelog entry
- [x] This Pull Request does not require a changelog entry. (Comment required below)
<details>
<summary>Changelog Entry Details</summary>
#### Significance
- [x] Patch
#### Type
- [x] Add - Adds functionality
#### Message
</details>
<details>
<summary>Changelog Entry Comment</summary>
#### Comment
This is a part of a feature branch which will have a single changelog entry when merged to trunk.
</details>
* Add tracking number parsing support for Amazon Logistics shipping provider
### Submission Review Guidelines:
- I have followed the [WooCommerce Contributing Guidelines](https://github.com/woocommerce/woocommerce/blob/trunk/.github/CONTRIBUTING.md) and the [WordPress Coding Standards](https://make.wordpress.org/core/handbook/best-practices/coding-standards/).
- I have checked to ensure there aren't other open [Pull Requests](https://github.com/woocommerce/woocommerce/pulls) for the same update/change.
- I have reviewed my code for [security best practices](https://developer.wordpress.org/apis/security/).
### Changes proposed in this Pull Request:
This PR adds initial support for detecting and parsing **Amazon Logistics (TBA...)** tracking numbers in the fulfillment provider system. Amazon tracking numbers typically start with `TBA` and are specific to Amazon's delivery network.
Closes #59233 WOOPLUG-4816
### How to test the changes in this Pull Request:
1. Checkout this branch
2. Run `pnpm run watch:build`
3. Run `composer dumpautoload` if needed
4. Go to WooCommerce > Orders and create a fulfillment if you don't have one.
5. In the fulfillment shipping info box, use tracking numbers like the following:
```md
- TBA1234567890 (US → US) → ✅ Amazon Logistics
- TBA000000000X (CA → CA) → ✅ Amazon Logistics
- tba111222333 (GB → DE) → ✅ Amazon Logistics
- TBX1234567890 (US → US) → ❌ Not Amazon Logistics
- TBA1234567890 (US → BR) → ❌ Not Amazon Logistics
* Fix tests
* Add tracking number parsing support for DPD shipping provider
* Shipping provider and test changes
* Modify USPS parser code
* Shipping provider changes
* Shipping provider changes
* Shipping provider changes
* Fix lint errors
* Shipping provider changes
* Fix linter error
* Add tracking number parsing support for Evri (Hermes) shipping provider
* Boost score when one of the countries is US
* Elaborate Surepost format
* Add all matches to parsing results, normalize tracking number
---------
Co-authored-by: github-actions <github-actions@github.com>
* Add tracking number parsing support for Canada Post shipping provider (#59308)
* Add shipping provider PNG image logos and replace base64 encoded images
* Add changefile(s) from automation for the following project(s): woocommerce
* Convert shipping provider configuration arrays into shipping provider classes, adapt UI and JS variable export to changes
* Add tests
* Fix namespace
* Fix class name case
* Fix another classname case issue
* Add tracking number parsing support for UPS shipping provider
* Fix shipping provider class initialization with DI
* Fix tracking number parse response handling
* Fix test
* Fix namespace of test file
* Add tracking number parsing support for USPS shipping provider
* Add ambiguity scoring
* Add ambiguity scoring
* Add tracking number parsing support for FedEx shipping provider
* Add tracking number parsing support for DHL shipping provider
### Submission Review Guidelines:
- I have followed the [WooCommerce Contributing Guidelines](https://github.com/woocommerce/woocommerce/blob/trunk/.github/CONTRIBUTING.md) and the [WordPress Coding Standards](https://make.wordpress.org/core/handbook/best-practices/coding-standards/).
- I have checked to ensure there aren't other open [Pull Requests](https://github.com/woocommerce/woocommerce/pulls) for the same update/change.
- I have reviewed my code for [security best practices](https://developer.wordpress.org/apis/security/).
- Following the above guidelines will result in quick merges and clear and detailed feedback when appropriate.
### Changes proposed in this Pull Request:
This PR adds initial support for detecting and parsing DHL tracking numbers within the fulfillment provider system.
Closes #59204 WOOPLUG-4802
### How to test the changes in this Pull Request:
1. Checkout this branch
2. Run `pnpm run watch:build`
3. Run `composer dumpautoload` if needed
4. Go to WooCommerce > Orders and create a fulfillment if needed
5. In the shipping information box, enter the following tracking numbers:
#### ✅ Valid DHL
- `1234567890` (DE → US) → DHL (Score: 80)
- `JJD1234567890` (US → FR) → DHL (Score: 95)
- `JJD00123456789012` (GB → IT) → DHL (Score: 95)
#### ❌ Not DHL
- `INVALID1234` (DE → US)
- `JJD123` (JP → GB)
- `1234567890` (ZZ → US)
Verify correct results appear in the fulfillment drawer.
### Changelog entry
- [x] This Pull Request does not require a changelog entry. (Comment required below)
<details>
<summary>Changelog Entry Details</summary>
#### Significance
- [x] Patch
#### Type
- [x] Add - Adds functionality
#### Message
</details>
<details>
<summary>Changelog Entry Comment</summary>
#### Comment
This is a part of a feature branch which will have a single changelog entry when merged to trunk.
</details>
* Add tracking number parsing support for Amazon Logistics shipping provider
### Submission Review Guidelines:
- I have followed the [WooCommerce Contributing Guidelines](https://github.com/woocommerce/woocommerce/blob/trunk/.github/CONTRIBUTING.md) and the [WordPress Coding Standards](https://make.wordpress.org/core/handbook/best-practices/coding-standards/).
- I have checked to ensure there aren't other open [Pull Requests](https://github.com/woocommerce/woocommerce/pulls) for the same update/change.
- I have reviewed my code for [security best practices](https://developer.wordpress.org/apis/security/).
### Changes proposed in this Pull Request:
This PR adds initial support for detecting and parsing **Amazon Logistics (TBA...)** tracking numbers in the fulfillment provider system. Amazon tracking numbers typically start with `TBA` and are specific to Amazon's delivery network.
Closes #59233 WOOPLUG-4816
### How to test the changes in this Pull Request:
1. Checkout this branch
2. Run `pnpm run watch:build`
3. Run `composer dumpautoload` if needed
4. Go to WooCommerce > Orders and create a fulfillment if you don't have one.
5. In the fulfillment shipping info box, use tracking numbers like the following:
```md
- TBA1234567890 (US → US) → ✅ Amazon Logistics
- TBA000000000X (CA → CA) → ✅ Amazon Logistics
- tba111222333 (GB → DE) → ✅ Amazon Logistics
- TBX1234567890 (US → US) → ❌ Not Amazon Logistics
- TBA1234567890 (US → BR) → ❌ Not Amazon Logistics
* Fix tests
* Add tracking number parsing support for DPD shipping provider
* Shipping provider and test changes
* Modify USPS parser code
* Shipping provider changes
* Shipping provider changes
* Shipping provider changes
* Fix lint errors
* Shipping provider changes
* Fix linter error
* Add tracking number parsing support for Evri (Hermes) shipping provider
* Boost score when one of the countries is US
* Elaborate Surepost format
* Add all matches to parsing results, normalize tracking number
* Add Canada Post shipping provider tracking number parsing
* Add Canada Post icon
---------
Co-authored-by: github-actions <github-actions@github.com>
* Add Royal Mail shipping provider tracking number parsing (#59311)
* Add shipping provider PNG image logos and replace base64 encoded images
* Add changefile(s) from automation for the following project(s): woocommerce
* Convert shipping provider configuration arrays into shipping provider classes, adapt UI and JS variable export to changes
* Add tests
* Fix namespace
* Fix class name case
* Fix another classname case issue
* Add tracking number parsing support for UPS shipping provider
* Fix shipping provider class initialization with DI
* Fix tracking number parse response handling
* Fix test
* Fix namespace of test file
* Add tracking number parsing support for USPS shipping provider
* Add ambiguity scoring
* Add ambiguity scoring
* Add tracking number parsing support for FedEx shipping provider
* Add tracking number parsing support for DHL shipping provider
### Submission Review Guidelines:
- I have followed the [WooCommerce Contributing Guidelines](https://github.com/woocommerce/woocommerce/blob/trunk/.github/CONTRIBUTING.md) and the [WordPress Coding Standards](https://make.wordpress.org/core/handbook/best-practices/coding-standards/).
- I have checked to ensure there aren't other open [Pull Requests](https://github.com/woocommerce/woocommerce/pulls) for the same update/change.
- I have reviewed my code for [security best practices](https://developer.wordpress.org/apis/security/).
- Following the above guidelines will result in quick merges and clear and detailed feedback when appropriate.
### Changes proposed in this Pull Request:
This PR adds initial support for detecting and parsing DHL tracking numbers within the fulfillment provider system.
Closes #59204 WOOPLUG-4802
### How to test the changes in this Pull Request:
1. Checkout this branch
2. Run `pnpm run watch:build`
3. Run `composer dumpautoload` if needed
4. Go to WooCommerce > Orders and create a fulfillment if needed
5. In the shipping information box, enter the following tracking numbers:
#### ✅ Valid DHL
- `1234567890` (DE → US) → DHL (Score: 80)
- `JJD1234567890` (US → FR) → DHL (Score: 95)
- `JJD00123456789012` (GB → IT) → DHL (Score: 95)
#### ❌ Not DHL
- `INVALID1234` (DE → US)
- `JJD123` (JP → GB)
- `1234567890` (ZZ → US)
Verify correct results appear in the fulfillment drawer.
### Changelog entry
- [x] This Pull Request does not require a changelog entry. (Comment required below)
<details>
<summary>Changelog Entry Details</summary>
#### Significance
- [x] Patch
#### Type
- [x] Add - Adds functionality
#### Message
</details>
<details>
<summary>Changelog Entry Comment</summary>
#### Comment
This is a part of a feature branch which will have a single changelog entry when merged to trunk.
</details>
* Add tracking number parsing support for Amazon Logistics shipping provider
### Submission Review Guidelines:
- I have followed the [WooCommerce Contributing Guidelines](https://github.com/woocommerce/woocommerce/blob/trunk/.github/CONTRIBUTING.md) and the [WordPress Coding Standards](https://make.wordpress.org/core/handbook/best-practices/coding-standards/).
- I have checked to ensure there aren't other open [Pull Requests](https://github.com/woocommerce/woocommerce/pulls) for the same update/change.
- I have reviewed my code for [security best practices](https://developer.wordpress.org/apis/security/).
### Changes proposed in this Pull Request:
This PR adds initial support for detecting and parsing **Amazon Logistics (TBA...)** tracking numbers in the fulfillment provider system. Amazon tracking numbers typically start with `TBA` and are specific to Amazon's delivery network.
Closes #59233 WOOPLUG-4816
### How to test the changes in this Pull Request:
1. Checkout this branch
2. Run `pnpm run watch:build`
3. Run `composer dumpautoload` if needed
4. Go to WooCommerce > Orders and create a fulfillment if you don't have one.
5. In the fulfillment shipping info box, use tracking numbers like the following:
```md
- TBA1234567890 (US → US) → ✅ Amazon Logistics
- TBA000000000X (CA → CA) → ✅ Amazon Logistics
- tba111222333 (GB → DE) → ✅ Amazon Logistics
- TBX1234567890 (US → US) → ❌ Not Amazon Logistics
- TBA1234567890 (US → BR) → ❌ Not Amazon Logistics
* Fix tests
* Add tracking number parsing support for DPD shipping provider
* Shipping provider and test changes
* Modify USPS parser code
* Shipping provider changes
* Shipping provider changes
* Shipping provider changes
* Fix lint errors
* Shipping provider changes
* Fix linter error
* Add tracking number parsing support for Evri (Hermes) shipping provider
* Boost score when one of the countries is US
* Elaborate Surepost format
* Add all matches to parsing results, normalize tracking number
* Add Canada Post shipping provider tracking number parsing
* Add Canada Post icon
* Add Royal Mail shipping provider tracking number parsing
* Add S10 check digit validation for UPU format
* Fix wrong merge and failing tests because of it
* Fix comment
---------
Co-authored-by: github-actions <github-actions@github.com>
* Add Australia Post shipping provider tracking number parsing (#59320)
* Add shipping provider PNG image logos and replace base64 encoded images
* Add changefile(s) from automation for the following project(s): woocommerce
* Convert shipping provider configuration arrays into shipping provider classes, adapt UI and JS variable export to changes
* Add tests
* Fix namespace
* Fix class name case
* Fix another classname case issue
* Add tracking number parsing support for UPS shipping provider
* Fix shipping provider class initialization with DI
* Fix tracking number parse response handling
* Fix test
* Fix namespace of test file
* Add tracking number parsing support for USPS shipping provider
* Add ambiguity scoring
* Add ambiguity scoring
* Add tracking number parsing support for FedEx shipping provider
* Add tracking number parsing support for DHL shipping provider
### Submission Review Guidelines:
- I have followed the [WooCommerce Contributing Guidelines](https://github.com/woocommerce/woocommerce/blob/trunk/.github/CONTRIBUTING.md) and the [WordPress Coding Standards](https://make.wordpress.org/core/handbook/best-practices/coding-standards/).
- I have checked to ensure there aren't other open [Pull Requests](https://github.com/woocommerce/woocommerce/pulls) for the same update/change.
- I have reviewed my code for [security best practices](https://developer.wordpress.org/apis/security/).
- Following the above guidelines will result in quick merges and clear and detailed feedback when appropriate.
### Changes proposed in this Pull Request:
This PR adds initial support for detecting and parsing DHL tracking numbers within the fulfillment provider system.
Closes #59204 WOOPLUG-4802
### How to test the changes in this Pull Request:
1. Checkout this branch
2. Run `pnpm run watch:build`
3. Run `composer dumpautoload` if needed
4. Go to WooCommerce > Orders and create a fulfillment if needed
5. In the shipping information box, enter the following tracking numbers:
#### ✅ Valid DHL
- `1234567890` (DE → US) → DHL (Score: 80)
- `JJD1234567890` (US → FR) → DHL (Score: 95)
- `JJD00123456789012` (GB → IT) → DHL (Score: 95)
#### ❌ Not DHL
- `INVALID1234` (DE → US)
- `JJD123` (JP → GB)
- `1234567890` (ZZ → US)
Verify correct results appear in the fulfillment drawer.
### Changelog entry
- [x] This Pull Request does not require a changelog entry. (Comment required below)
<details>
<summary>Changelog Entry Details</summary>
#### Significance
- [x] Patch
#### Type
- [x] Add - Adds functionality
#### Message
</details>
<details>
<summary>Changelog Entry Comment</summary>
#### Comment
This is a part of a feature branch which will have a single changelog entry when merged to trunk.
</details>
* Add tracking number parsing support for Amazon Logistics shipping provider
### Submission Review Guidelines:
- I have followed the [WooCommerce Contributing Guidelines](https://github.com/woocommerce/woocommerce/blob/trunk/.github/CONTRIBUTING.md) and the [WordPress Coding Standards](https://make.wordpress.org/core/handbook/best-practices/coding-standards/).
- I have checked to ensure there aren't other open [Pull Requests](https://github.com/woocommerce/woocommerce/pulls) for the same update/change.
- I have reviewed my code for [security best practices](https://developer.wordpress.org/apis/security/).
### Changes proposed in this Pull Request:
This PR adds initial support for detecting and parsing **Amazon Logistics (TBA...)** tracking numbers in the fulfillment provider system. Amazon tracking numbers typically start with `TBA` and are specific to Amazon's delivery network.
Closes #59233 WOOPLUG-4816
### How to test the changes in this Pull Request:
1. Checkout this branch
2. Run `pnpm run watch:build`
3. Run `composer dumpautoload` if needed
4. Go to WooCommerce > Orders and create a fulfillment if you don't have one.
5. In the fulfillment shipping info box, use tracking numbers like the following:
```md
- TBA1234567890 (US → US) → ✅ Amazon Logistics
- TBA000000000X (CA → CA) → ✅ Amazon Logistics
- tba111222333 (GB → DE) → ✅ Amazon Logistics
- TBX1234567890 (US → US) → ❌ Not Amazon Logistics
- TBA1234567890 (US → BR) → ❌ Not Amazon Logistics
* Fix tests
* Add tracking number parsing support for DPD shipping provider
* Shipping provider and test changes
* Modify USPS parser code
* Shipping provider changes
* Shipping provider changes
* Shipping provider changes
* Fix lint errors
* Shipping provider changes
* Fix linter error
* Add tracking number parsing support for Evri (Hermes) shipping provider
* Boost score when one of the countries is US
* Elaborate Surepost format
* Add all matches to parsing results, normalize tracking number
* Add Canada Post shipping provider tracking number parsing
* Add Canada Post icon
* Add Royal Mail shipping provider tracking number parsing
* Add S10 check digit validation for UPU format
* Add Australia Post shipping provider tracking number parsing
* Add Australia Post logo
* Join country list to one single line
* Fix lint error
---------
Co-authored-by: github-actions <github-actions@github.com>
* Add feature flag for order fulfillments (#59148)
* Add feature flag for order fulfillments
* Add changefile(s) from automation for the following project(s): woocommerce
* Isolate email modifications with feature flag
* Fix tests
* Move DB schema from installation to activation
* Add DB tables only when the feature is first enabled, hide feature UI
* Fix tests
* Fix more tests
* Remove the condition for adding fulfillments tables, make them always listed
---------
Co-authored-by: github-actions <github-actions@github.com>
* Fix fulfillments UI design issues found in design review (#59380)
* Change chevron direction, remove bulk selection labels, collapse new fulfillment form
* Prevent body scrolling on drawer open, refactor drawer classes, scroll to error message on error
* Make "Other" shipping provider option sticky at bottom
* Update order fulfillment status in real time
* Fix tests
* Disable collapsing when there's only one fulfillment with all items in the drawer
* Fix lint and test issues
* Fix hasPendingItems method, clear error messages when order changes
* Fix CSS style lint issues, formatter breaks it
* Fix scrollintoview margin issue
* Merge branch 'feature/57353-order-fulfillments-entity' into fix/58715-fix-design-review-problems
* Fix lint error caused by line length limit
* Align price text to right
* Fix lint error
* Add mocking for scrollIntoView in jest tests
* Add UX improvements for tracking number lookup (#59427)
* Add UX improvements for tracking number resolution
* Fix linter error
* Fix tests
* Remove unnecessary utility, fix conditional rendering
* Add support for querying deleted fulfillments programmatically on backend (#59504)
* Add refunds handling to fulfillments (#59585)
* Add refunds handling to fulfillments
* Don't remove refunded items from all fulfillments repeatingly, use counter
* Add tests
* Add FulfillmentUtilsTest initialization code
* Fix tests again
* Add combined testing for tracking number parsers (#59469)
* Add validations for tracking numbers, add new formats, add global test
* Fix lint error
* Fix more lint errors
* Add some fixes for AMZL, AusPost and Evri
* Fix linter error
* More adjustments
* Fix tests in other files
* Remove all fulfillment related changelogs (#59771)
* Add changefile(s) from automation for the following project(s): woocommerce, woocommerce/client/admin
* Bump fulfillment hook and template versions to 10.1.0 (#59783)
* Standardize hook names, bump versions
* Remove extra changelog file
* Replace more findings
* Bump template versions
* Revert unwanted change
* Fix important coderabbit findings
---------
Co-authored-by: github-actions <github-actions@github.com>
Co-authored-by: Vladimir Reznichenko <kalessil@gmail.com>
Co-authored-by: Fernando Espinosa <Ferdev@users.noreply.github.com>
diff --git a/plugins/woocommerce/assets/images/shipping_providers/acs-courier.png b/plugins/woocommerce/assets/images/shipping_providers/acs-courier.png
new file mode 100644
index 0000000000..79515af498
Binary files /dev/null and b/plugins/woocommerce/assets/images/shipping_providers/acs-courier.png differ
diff --git a/plugins/woocommerce/assets/images/shipping_providers/amazon-logistics.png b/plugins/woocommerce/assets/images/shipping_providers/amazon-logistics.png
new file mode 100644
index 0000000000..697dc29986
Binary files /dev/null and b/plugins/woocommerce/assets/images/shipping_providers/amazon-logistics.png differ
diff --git a/plugins/woocommerce/assets/images/shipping_providers/an-post.png b/plugins/woocommerce/assets/images/shipping_providers/an-post.png
new file mode 100644
index 0000000000..673ea3adc0
Binary files /dev/null and b/plugins/woocommerce/assets/images/shipping_providers/an-post.png differ
diff --git a/plugins/woocommerce/assets/images/shipping_providers/aras-kargo.png b/plugins/woocommerce/assets/images/shipping_providers/aras-kargo.png
new file mode 100644
index 0000000000..e71fd18848
Binary files /dev/null and b/plugins/woocommerce/assets/images/shipping_providers/aras-kargo.png differ
diff --git a/plugins/woocommerce/assets/images/shipping_providers/australia-post.png b/plugins/woocommerce/assets/images/shipping_providers/australia-post.png
new file mode 100644
index 0000000000..d2316063a0
Binary files /dev/null and b/plugins/woocommerce/assets/images/shipping_providers/australia-post.png differ
diff --git a/plugins/woocommerce/assets/images/shipping_providers/azerpost.png b/plugins/woocommerce/assets/images/shipping_providers/azerpost.png
new file mode 100644
index 0000000000..9f803dcea4
Binary files /dev/null and b/plugins/woocommerce/assets/images/shipping_providers/azerpost.png differ
diff --git a/plugins/woocommerce/assets/images/shipping_providers/bartolini-brt.png b/plugins/woocommerce/assets/images/shipping_providers/bartolini-brt.png
new file mode 100644
index 0000000000..ea44c4092a
Binary files /dev/null and b/plugins/woocommerce/assets/images/shipping_providers/bartolini-brt.png differ
diff --git a/plugins/woocommerce/assets/images/shipping_providers/belpochta.png b/plugins/woocommerce/assets/images/shipping_providers/belpochta.png
new file mode 100644
index 0000000000..9824010194
Binary files /dev/null and b/plugins/woocommerce/assets/images/shipping_providers/belpochta.png differ
diff --git a/plugins/woocommerce/assets/images/shipping_providers/bpost.png b/plugins/woocommerce/assets/images/shipping_providers/bpost.png
new file mode 100644
index 0000000000..1f3199af4e
Binary files /dev/null and b/plugins/woocommerce/assets/images/shipping_providers/bpost.png differ
diff --git a/plugins/woocommerce/assets/images/shipping_providers/bulgarian-posts.png b/plugins/woocommerce/assets/images/shipping_providers/bulgarian-posts.png
new file mode 100644
index 0000000000..116ffcb7a5
Binary files /dev/null and b/plugins/woocommerce/assets/images/shipping_providers/bulgarian-posts.png differ
diff --git a/plugins/woocommerce/assets/images/shipping_providers/canada-post.png b/plugins/woocommerce/assets/images/shipping_providers/canada-post.png
new file mode 100644
index 0000000000..2f8cdb1c63
Binary files /dev/null and b/plugins/woocommerce/assets/images/shipping_providers/canada-post.png differ
diff --git a/plugins/woocommerce/assets/images/shipping_providers/cdek.png b/plugins/woocommerce/assets/images/shipping_providers/cdek.png
new file mode 100644
index 0000000000..a59895880d
Binary files /dev/null and b/plugins/woocommerce/assets/images/shipping_providers/cdek.png differ
diff --git a/plugins/woocommerce/assets/images/shipping_providers/ceska-posta.png b/plugins/woocommerce/assets/images/shipping_providers/ceska-posta.png
new file mode 100644
index 0000000000..e954600d14
Binary files /dev/null and b/plugins/woocommerce/assets/images/shipping_providers/ceska-posta.png differ
diff --git a/plugins/woocommerce/assets/images/shipping_providers/chronopost.png b/plugins/woocommerce/assets/images/shipping_providers/chronopost.png
new file mode 100644
index 0000000000..f53e820cd0
Binary files /dev/null and b/plugins/woocommerce/assets/images/shipping_providers/chronopost.png differ
diff --git a/plugins/woocommerce/assets/images/shipping_providers/correos.png b/plugins/woocommerce/assets/images/shipping_providers/correos.png
new file mode 100644
index 0000000000..a1fda63289
Binary files /dev/null and b/plugins/woocommerce/assets/images/shipping_providers/correos.png differ
diff --git a/plugins/woocommerce/assets/images/shipping_providers/ctt.png b/plugins/woocommerce/assets/images/shipping_providers/ctt.png
new file mode 100644
index 0000000000..58ccdb4999
Binary files /dev/null and b/plugins/woocommerce/assets/images/shipping_providers/ctt.png differ
diff --git a/plugins/woocommerce/assets/images/shipping_providers/cyprus-post.png b/plugins/woocommerce/assets/images/shipping_providers/cyprus-post.png
new file mode 100644
index 0000000000..310be94b4f
Binary files /dev/null and b/plugins/woocommerce/assets/images/shipping_providers/cyprus-post.png differ
diff --git a/plugins/woocommerce/assets/images/shipping_providers/deutsche-post.png b/plugins/woocommerce/assets/images/shipping_providers/deutsche-post.png
new file mode 100644
index 0000000000..be9ec80d41
Binary files /dev/null and b/plugins/woocommerce/assets/images/shipping_providers/deutsche-post.png differ
diff --git a/plugins/woocommerce/assets/images/shipping_providers/dhl.png b/plugins/woocommerce/assets/images/shipping_providers/dhl.png
new file mode 100644
index 0000000000..489ea88513
Binary files /dev/null and b/plugins/woocommerce/assets/images/shipping_providers/dhl.png differ
diff --git a/plugins/woocommerce/assets/images/shipping_providers/dpd.png b/plugins/woocommerce/assets/images/shipping_providers/dpd.png
new file mode 100644
index 0000000000..e9d25fa88a
Binary files /dev/null and b/plugins/woocommerce/assets/images/shipping_providers/dpd.png differ
diff --git a/plugins/woocommerce/assets/images/shipping_providers/econt.png b/plugins/woocommerce/assets/images/shipping_providers/econt.png
new file mode 100644
index 0000000000..b7bbbb1059
Binary files /dev/null and b/plugins/woocommerce/assets/images/shipping_providers/econt.png differ
diff --git a/plugins/woocommerce/assets/images/shipping_providers/eimskip.png b/plugins/woocommerce/assets/images/shipping_providers/eimskip.png
new file mode 100644
index 0000000000..9e808895f5
Binary files /dev/null and b/plugins/woocommerce/assets/images/shipping_providers/eimskip.png differ
diff --git a/plugins/woocommerce/assets/images/shipping_providers/elta.png b/plugins/woocommerce/assets/images/shipping_providers/elta.png
new file mode 100644
index 0000000000..f24db621af
Binary files /dev/null and b/plugins/woocommerce/assets/images/shipping_providers/elta.png differ
diff --git a/plugins/woocommerce/assets/images/shipping_providers/evri-hermes.png b/plugins/woocommerce/assets/images/shipping_providers/evri-hermes.png
new file mode 100644
index 0000000000..61cea3d181
Binary files /dev/null and b/plugins/woocommerce/assets/images/shipping_providers/evri-hermes.png differ
diff --git a/plugins/woocommerce/assets/images/shipping_providers/fan-courier.png b/plugins/woocommerce/assets/images/shipping_providers/fan-courier.png
new file mode 100644
index 0000000000..fbcddd5396
Binary files /dev/null and b/plugins/woocommerce/assets/images/shipping_providers/fan-courier.png differ
diff --git a/plugins/woocommerce/assets/images/shipping_providers/fastway.png b/plugins/woocommerce/assets/images/shipping_providers/fastway.png
new file mode 100644
index 0000000000..611c4b0f1f
Binary files /dev/null and b/plugins/woocommerce/assets/images/shipping_providers/fastway.png differ
diff --git a/plugins/woocommerce/assets/images/shipping_providers/fedex.png b/plugins/woocommerce/assets/images/shipping_providers/fedex.png
new file mode 100644
index 0000000000..11565abad4
Binary files /dev/null and b/plugins/woocommerce/assets/images/shipping_providers/fedex.png differ
diff --git a/plugins/woocommerce/assets/images/shipping_providers/geniki-taxydromiki.png b/plugins/woocommerce/assets/images/shipping_providers/geniki-taxydromiki.png
new file mode 100644
index 0000000000..7aaef8dc6c
Binary files /dev/null and b/plugins/woocommerce/assets/images/shipping_providers/geniki-taxydromiki.png differ
diff --git a/plugins/woocommerce/assets/images/shipping_providers/gls.png b/plugins/woocommerce/assets/images/shipping_providers/gls.png
new file mode 100644
index 0000000000..4ad69fb2ad
Binary files /dev/null and b/plugins/woocommerce/assets/images/shipping_providers/gls.png differ
diff --git a/plugins/woocommerce/assets/images/shipping_providers/haypost.png b/plugins/woocommerce/assets/images/shipping_providers/haypost.png
new file mode 100644
index 0000000000..b7f09bf5de
Binary files /dev/null and b/plugins/woocommerce/assets/images/shipping_providers/haypost.png differ
diff --git a/plugins/woocommerce/assets/images/shipping_providers/helthjem.png b/plugins/woocommerce/assets/images/shipping_providers/helthjem.png
new file mode 100644
index 0000000000..9d3b36a19f
Binary files /dev/null and b/plugins/woocommerce/assets/images/shipping_providers/helthjem.png differ
diff --git a/plugins/woocommerce/assets/images/shipping_providers/hrvatska-posta.png b/plugins/woocommerce/assets/images/shipping_providers/hrvatska-posta.png
new file mode 100644
index 0000000000..3009d71094
Binary files /dev/null and b/plugins/woocommerce/assets/images/shipping_providers/hrvatska-posta.png differ
diff --git a/plugins/woocommerce/assets/images/shipping_providers/inpost.png b/plugins/woocommerce/assets/images/shipping_providers/inpost.png
new file mode 100644
index 0000000000..947d72a012
Binary files /dev/null and b/plugins/woocommerce/assets/images/shipping_providers/inpost.png differ
diff --git a/plugins/woocommerce/assets/images/shipping_providers/islandspostur.png b/plugins/woocommerce/assets/images/shipping_providers/islandspostur.png
new file mode 100644
index 0000000000..064a99f051
Binary files /dev/null and b/plugins/woocommerce/assets/images/shipping_providers/islandspostur.png differ
diff --git a/plugins/woocommerce/assets/images/shipping_providers/itella.png b/plugins/woocommerce/assets/images/shipping_providers/itella.png
new file mode 100644
index 0000000000..acbbaf9064
Binary files /dev/null and b/plugins/woocommerce/assets/images/shipping_providers/itella.png differ
diff --git a/plugins/woocommerce/assets/images/shipping_providers/kazpost.png b/plugins/woocommerce/assets/images/shipping_providers/kazpost.png
new file mode 100644
index 0000000000..e045c2eb45
Binary files /dev/null and b/plugins/woocommerce/assets/images/shipping_providers/kazpost.png differ
diff --git a/plugins/woocommerce/assets/images/shipping_providers/la-poste-colissimo.png b/plugins/woocommerce/assets/images/shipping_providers/la-poste-colissimo.png
new file mode 100644
index 0000000000..4ff0521b80
Binary files /dev/null and b/plugins/woocommerce/assets/images/shipping_providers/la-poste-colissimo.png differ
diff --git a/plugins/woocommerce/assets/images/shipping_providers/lasership-ontrac.png b/plugins/woocommerce/assets/images/shipping_providers/lasership-ontrac.png
new file mode 100644
index 0000000000..e9d8bd4320
Binary files /dev/null and b/plugins/woocommerce/assets/images/shipping_providers/lasership-ontrac.png differ
diff --git a/plugins/woocommerce/assets/images/shipping_providers/latvijas-pasts.png b/plugins/woocommerce/assets/images/shipping_providers/latvijas-pasts.png
new file mode 100644
index 0000000000..140ab895d4
Binary files /dev/null and b/plugins/woocommerce/assets/images/shipping_providers/latvijas-pasts.png differ
diff --git a/plugins/woocommerce/assets/images/shipping_providers/liechtensteinische-post.png b/plugins/woocommerce/assets/images/shipping_providers/liechtensteinische-post.png
new file mode 100644
index 0000000000..8129d7d805
Binary files /dev/null and b/plugins/woocommerce/assets/images/shipping_providers/liechtensteinische-post.png differ
diff --git a/plugins/woocommerce/assets/images/shipping_providers/magyar-posta.png b/plugins/woocommerce/assets/images/shipping_providers/magyar-posta.png
new file mode 100644
index 0000000000..daf7563e50
Binary files /dev/null and b/plugins/woocommerce/assets/images/shipping_providers/magyar-posta.png differ
diff --git a/plugins/woocommerce/assets/images/shipping_providers/makedonska-posta.png b/plugins/woocommerce/assets/images/shipping_providers/makedonska-posta.png
new file mode 100644
index 0000000000..f7141e1854
Binary files /dev/null and b/plugins/woocommerce/assets/images/shipping_providers/makedonska-posta.png differ
diff --git a/plugins/woocommerce/assets/images/shipping_providers/maltapost.png b/plugins/woocommerce/assets/images/shipping_providers/maltapost.png
new file mode 100644
index 0000000000..61013ff2df
Binary files /dev/null and b/plugins/woocommerce/assets/images/shipping_providers/maltapost.png differ
diff --git a/plugins/woocommerce/assets/images/shipping_providers/matkahuolto.png b/plugins/woocommerce/assets/images/shipping_providers/matkahuolto.png
new file mode 100644
index 0000000000..8e1a11a742
Binary files /dev/null and b/plugins/woocommerce/assets/images/shipping_providers/matkahuolto.png differ
diff --git a/plugins/woocommerce/assets/images/shipping_providers/mondial-relay.png b/plugins/woocommerce/assets/images/shipping_providers/mondial-relay.png
new file mode 100644
index 0000000000..61c47b953e
Binary files /dev/null and b/plugins/woocommerce/assets/images/shipping_providers/mondial-relay.png differ
diff --git a/plugins/woocommerce/assets/images/shipping_providers/mpl.png b/plugins/woocommerce/assets/images/shipping_providers/mpl.png
new file mode 100644
index 0000000000..daf7563e50
Binary files /dev/null and b/plugins/woocommerce/assets/images/shipping_providers/mpl.png differ
diff --git a/plugins/woocommerce/assets/images/shipping_providers/mrw.png b/plugins/woocommerce/assets/images/shipping_providers/mrw.png
new file mode 100644
index 0000000000..3821e4d91c
Binary files /dev/null and b/plugins/woocommerce/assets/images/shipping_providers/mrw.png differ
diff --git a/plugins/woocommerce/assets/images/shipping_providers/new-zealand-post.png b/plugins/woocommerce/assets/images/shipping_providers/new-zealand-post.png
new file mode 100644
index 0000000000..ed3efeee53
Binary files /dev/null and b/plugins/woocommerce/assets/images/shipping_providers/new-zealand-post.png differ
diff --git a/plugins/woocommerce/assets/images/shipping_providers/nova-poshta.png b/plugins/woocommerce/assets/images/shipping_providers/nova-poshta.png
new file mode 100644
index 0000000000..882f74121a
Binary files /dev/null and b/plugins/woocommerce/assets/images/shipping_providers/nova-poshta.png differ
diff --git a/plugins/woocommerce/assets/images/shipping_providers/omniva.png b/plugins/woocommerce/assets/images/shipping_providers/omniva.png
new file mode 100644
index 0000000000..1a52736a30
Binary files /dev/null and b/plugins/woocommerce/assets/images/shipping_providers/omniva.png differ
diff --git a/plugins/woocommerce/assets/images/shipping_providers/osterreichische-post.png b/plugins/woocommerce/assets/images/shipping_providers/osterreichische-post.png
new file mode 100644
index 0000000000..abbb079014
Binary files /dev/null and b/plugins/woocommerce/assets/images/shipping_providers/osterreichische-post.png differ
diff --git a/plugins/woocommerce/assets/images/shipping_providers/parcelforce.png b/plugins/woocommerce/assets/images/shipping_providers/parcelforce.png
new file mode 100644
index 0000000000..3efcd78fec
Binary files /dev/null and b/plugins/woocommerce/assets/images/shipping_providers/parcelforce.png differ
diff --git a/plugins/woocommerce/assets/images/shipping_providers/poczta-polska.png b/plugins/woocommerce/assets/images/shipping_providers/poczta-polska.png
new file mode 100644
index 0000000000..376314b1d7
Binary files /dev/null and b/plugins/woocommerce/assets/images/shipping_providers/poczta-polska.png differ
diff --git a/plugins/woocommerce/assets/images/shipping_providers/post-luxembourg.png b/plugins/woocommerce/assets/images/shipping_providers/post-luxembourg.png
new file mode 100644
index 0000000000..4e8a6436bf
Binary files /dev/null and b/plugins/woocommerce/assets/images/shipping_providers/post-luxembourg.png differ
diff --git a/plugins/woocommerce/assets/images/shipping_providers/posta-moldovei.png b/plugins/woocommerce/assets/images/shipping_providers/posta-moldovei.png
new file mode 100644
index 0000000000..e4b0048b33
Binary files /dev/null and b/plugins/woocommerce/assets/images/shipping_providers/posta-moldovei.png differ
diff --git a/plugins/woocommerce/assets/images/shipping_providers/posta-romana.png b/plugins/woocommerce/assets/images/shipping_providers/posta-romana.png
new file mode 100644
index 0000000000..b688e03b50
Binary files /dev/null and b/plugins/woocommerce/assets/images/shipping_providers/posta-romana.png differ
diff --git a/plugins/woocommerce/assets/images/shipping_providers/poste-italiane.png b/plugins/woocommerce/assets/images/shipping_providers/poste-italiane.png
new file mode 100644
index 0000000000..cc813cdf82
Binary files /dev/null and b/plugins/woocommerce/assets/images/shipping_providers/poste-italiane.png differ
diff --git a/plugins/woocommerce/assets/images/shipping_providers/poste-san-marino.png b/plugins/woocommerce/assets/images/shipping_providers/poste-san-marino.png
new file mode 100644
index 0000000000..c17396a9b8
Binary files /dev/null and b/plugins/woocommerce/assets/images/shipping_providers/poste-san-marino.png differ
diff --git a/plugins/woocommerce/assets/images/shipping_providers/posten-norge-bring.png b/plugins/woocommerce/assets/images/shipping_providers/posten-norge-bring.png
new file mode 100644
index 0000000000..4d1b4a0a58
Binary files /dev/null and b/plugins/woocommerce/assets/images/shipping_providers/posten-norge-bring.png differ
diff --git a/plugins/woocommerce/assets/images/shipping_providers/postnl.png b/plugins/woocommerce/assets/images/shipping_providers/postnl.png
new file mode 100644
index 0000000000..aed95066dc
Binary files /dev/null and b/plugins/woocommerce/assets/images/shipping_providers/postnl.png differ
diff --git a/plugins/woocommerce/assets/images/shipping_providers/postnord.png b/plugins/woocommerce/assets/images/shipping_providers/postnord.png
new file mode 100644
index 0000000000..54d8c1eea8
Binary files /dev/null and b/plugins/woocommerce/assets/images/shipping_providers/postnord.png differ
diff --git a/plugins/woocommerce/assets/images/shipping_providers/purolator.png b/plugins/woocommerce/assets/images/shipping_providers/purolator.png
new file mode 100644
index 0000000000..9ffeec8412
Binary files /dev/null and b/plugins/woocommerce/assets/images/shipping_providers/purolator.png differ
diff --git a/plugins/woocommerce/assets/images/shipping_providers/royal-mail.png b/plugins/woocommerce/assets/images/shipping_providers/royal-mail.png
new file mode 100644
index 0000000000..5653963769
Binary files /dev/null and b/plugins/woocommerce/assets/images/shipping_providers/royal-mail.png differ
diff --git a/plugins/woocommerce/assets/images/shipping_providers/russian-post.png b/plugins/woocommerce/assets/images/shipping_providers/russian-post.png
new file mode 100644
index 0000000000..750185166f
Binary files /dev/null and b/plugins/woocommerce/assets/images/shipping_providers/russian-post.png differ
diff --git a/plugins/woocommerce/assets/images/shipping_providers/sda.png b/plugins/woocommerce/assets/images/shipping_providers/sda.png
new file mode 100644
index 0000000000..836aa8a494
Binary files /dev/null and b/plugins/woocommerce/assets/images/shipping_providers/sda.png differ
diff --git a/plugins/woocommerce/assets/images/shipping_providers/seur.png b/plugins/woocommerce/assets/images/shipping_providers/seur.png
new file mode 100644
index 0000000000..b25b3ad7d9
Binary files /dev/null and b/plugins/woocommerce/assets/images/shipping_providers/seur.png differ
diff --git a/plugins/woocommerce/assets/images/shipping_providers/slovenska-posta.png b/plugins/woocommerce/assets/images/shipping_providers/slovenska-posta.png
new file mode 100644
index 0000000000..5de8e3db4c
Binary files /dev/null and b/plugins/woocommerce/assets/images/shipping_providers/slovenska-posta.png differ
diff --git a/plugins/woocommerce/assets/images/shipping_providers/spee-dee-delivery.png b/plugins/woocommerce/assets/images/shipping_providers/spee-dee-delivery.png
new file mode 100644
index 0000000000..9ab5f17c09
Binary files /dev/null and b/plugins/woocommerce/assets/images/shipping_providers/spee-dee-delivery.png differ
diff --git a/plugins/woocommerce/assets/images/shipping_providers/startrack.png b/plugins/woocommerce/assets/images/shipping_providers/startrack.png
new file mode 100644
index 0000000000..d2316063a0
Binary files /dev/null and b/plugins/woocommerce/assets/images/shipping_providers/startrack.png differ
diff --git a/plugins/woocommerce/assets/images/shipping_providers/swiss-post.png b/plugins/woocommerce/assets/images/shipping_providers/swiss-post.png
new file mode 100644
index 0000000000..c7049d13f4
Binary files /dev/null and b/plugins/woocommerce/assets/images/shipping_providers/swiss-post.png differ
diff --git a/plugins/woocommerce/assets/images/shipping_providers/toll.png b/plugins/woocommerce/assets/images/shipping_providers/toll.png
new file mode 100644
index 0000000000..325a83b10f
Binary files /dev/null and b/plugins/woocommerce/assets/images/shipping_providers/toll.png differ
diff --git a/plugins/woocommerce/assets/images/shipping_providers/ukrposhta.png b/plugins/woocommerce/assets/images/shipping_providers/ukrposhta.png
new file mode 100644
index 0000000000..c5cd027ac6
Binary files /dev/null and b/plugins/woocommerce/assets/images/shipping_providers/ukrposhta.png differ
diff --git a/plugins/woocommerce/assets/images/shipping_providers/ups.png b/plugins/woocommerce/assets/images/shipping_providers/ups.png
new file mode 100644
index 0000000000..a8595b4b88
Binary files /dev/null and b/plugins/woocommerce/assets/images/shipping_providers/ups.png differ
diff --git a/plugins/woocommerce/assets/images/shipping_providers/urgent-cargus.png b/plugins/woocommerce/assets/images/shipping_providers/urgent-cargus.png
new file mode 100644
index 0000000000..28a6b0fe74
Binary files /dev/null and b/plugins/woocommerce/assets/images/shipping_providers/urgent-cargus.png differ
diff --git a/plugins/woocommerce/assets/images/shipping_providers/usps.png b/plugins/woocommerce/assets/images/shipping_providers/usps.png
new file mode 100644
index 0000000000..2ec1c97bdb
Binary files /dev/null and b/plugins/woocommerce/assets/images/shipping_providers/usps.png differ
diff --git a/plugins/woocommerce/assets/images/shipping_providers/yurtici-kargo.png b/plugins/woocommerce/assets/images/shipping_providers/yurtici-kargo.png
new file mode 100644
index 0000000000..f357709346
Binary files /dev/null and b/plugins/woocommerce/assets/images/shipping_providers/yurtici-kargo.png differ
diff --git a/plugins/woocommerce/assets/images/shipping_providers/zasilkovna.png b/plugins/woocommerce/assets/images/shipping_providers/zasilkovna.png
new file mode 100644
index 0000000000..c2aa667050
Binary files /dev/null and b/plugins/woocommerce/assets/images/shipping_providers/zasilkovna.png differ
diff --git a/plugins/woocommerce/changelog/57536-feature-57353-order-fulfillments-entity b/plugins/woocommerce/changelog/57536-feature-57353-order-fulfillments-entity
new file mode 100644
index 0000000000..3065e029f3
--- /dev/null
+++ b/plugins/woocommerce/changelog/57536-feature-57353-order-fulfillments-entity
@@ -0,0 +1,4 @@
+Significance: patch
+Type: add
+Comment: Introduced experimental fulfillment system, hidden behind a feature flag for beta testing.
+
diff --git a/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/action-buttons/cancel-link.tsx b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/action-buttons/cancel-link.tsx
new file mode 100644
index 0000000000..487b68e034
--- /dev/null
+++ b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/action-buttons/cancel-link.tsx
@@ -0,0 +1,22 @@
+/**
+ * External dependencies
+ */
+import { Button } from '@wordpress/components';
+import { __ } from '@wordpress/i18n';
+
+/**
+ * Internal dependencies
+ */
+
+export default function CancelLink( { onClick }: { onClick: () => void } ) {
+ return (
+ <Button
+ variant="link"
+ onClick={ onClick }
+ style={ { flex: 1 } }
+ __next40pxDefaultSize
+ >
+ { __( 'Cancel', 'woocommerce' ) }
+ </Button>
+ );
+}
diff --git a/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/action-buttons/edit-fulfillment-button.tsx b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/action-buttons/edit-fulfillment-button.tsx
new file mode 100644
index 0000000000..b1423387c4
--- /dev/null
+++ b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/action-buttons/edit-fulfillment-button.tsx
@@ -0,0 +1,17 @@
+/**
+ * External dependencies
+ */
+import { Button } from '@wordpress/components';
+import { __ } from '@wordpress/i18n';
+
+export default function EditFulfillmentButton( {
+ onClick,
+}: {
+ onClick: () => void;
+} ) {
+ return (
+ <Button variant="secondary" onClick={ onClick } __next40pxDefaultSize>
+ { __( 'Edit fulfillment', 'woocommerce' ) }
+ </Button>
+ );
+}
diff --git a/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/action-buttons/fulfill-items-button.tsx b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/action-buttons/fulfill-items-button.tsx
new file mode 100644
index 0000000000..0492a39059
--- /dev/null
+++ b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/action-buttons/fulfill-items-button.tsx
@@ -0,0 +1,69 @@
+/**
+ * External dependencies
+ */
+import { Button } from '@wordpress/components';
+import { __ } from '@wordpress/i18n';
+import { useDispatch, select } from '@wordpress/data';
+import { useState } from 'react';
+
+/**
+ * Internal dependencies
+ */
+import { useFulfillmentContext } from '../../context/fulfillment-context';
+import { store as FulfillmentStore } from '../../data/store';
+import {
+ getFulfillmentItems,
+ refreshOrderFulfillmentStatus,
+} from '../../utils/fulfillment-utils';
+import { useFulfillmentDrawerContext } from '../../context/drawer-context';
+
+export default function FulfillItemsButton( {
+ setError,
+}: {
+ setError: ( message: string | null ) => void;
+} ) {
+ const { setIsEditing } = useFulfillmentDrawerContext();
+ const { order, fulfillment, notifyCustomer } = useFulfillmentContext();
+ const [ isExecuting, setIsExecuting ] = useState( false );
+ const { saveFulfillment } = useDispatch( FulfillmentStore );
+
+ const handleFulfillItems = async () => {
+ setError( null );
+ if ( ! fulfillment || ! order ) {
+ return;
+ }
+ if ( getFulfillmentItems( fulfillment ).length === 0 ) {
+ setError( __( 'Select items to be fulfilled.', 'woocommerce' ) );
+ return;
+ }
+
+ setIsExecuting( true );
+
+ // Mark fulfillment as fulfilled.
+ fulfillment.is_fulfilled = true;
+ fulfillment.status = 'fulfilled';
+ await saveFulfillment( order.id, fulfillment, notifyCustomer );
+
+ const error = select( FulfillmentStore ).getError( order.id );
+ if ( error ) {
+ setError( error );
+ } else {
+ refreshOrderFulfillmentStatus( order.id );
+ setIsEditing( false );
+ }
+
+ setIsExecuting( false );
+ };
+
+ return (
+ <Button
+ variant="primary"
+ onClick={ handleFulfillItems }
+ __next40pxDefaultSize
+ isBusy={ isExecuting }
+ disabled={ isExecuting }
+ >
+ { __( 'Fulfill items', 'woocommerce' ) }
+ </Button>
+ );
+}
diff --git a/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/action-buttons/remove-button.tsx b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/action-buttons/remove-button.tsx
new file mode 100644
index 0000000000..60eebecd3e
--- /dev/null
+++ b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/action-buttons/remove-button.tsx
@@ -0,0 +1,113 @@
+/**
+ * External dependencies
+ */
+import { Button, Modal } from '@wordpress/components';
+import { __ } from '@wordpress/i18n';
+import { useDispatch, select } from '@wordpress/data';
+import { useState } from 'react';
+
+/**
+ * Internal dependencies
+ */
+import { useFulfillmentContext } from '../../context/fulfillment-context';
+import { store as FulfillmentStore } from '../../data/store';
+import { useFulfillmentDrawerContext } from '../../context/drawer-context';
+import CustomerNotificationBox from '../customer-notification-form';
+import { refreshOrderFulfillmentStatus } from '../../utils/fulfillment-utils';
+
+export default function RemoveButton( {
+ setError,
+}: {
+ setError: ( message: string | null ) => void;
+} ) {
+ const { setIsEditing, setOpenSection } = useFulfillmentDrawerContext();
+ const { order, fulfillment, notifyCustomer } = useFulfillmentContext();
+ const [ isExecuting, setIsExecuting ] = useState< boolean >( false );
+ const { deleteFulfillment } = useDispatch( FulfillmentStore );
+
+ const [ isOpen, setOpen ] = useState( false );
+ const openModal = () => setOpen( true );
+ const closeModal = () => setOpen( false );
+
+ const handleDeleteFulfillment = async () => {
+ setError( null );
+ if ( ! fulfillment || ! fulfillment.id || ! order || ! order.id ) {
+ return;
+ }
+ setIsExecuting( true );
+ await deleteFulfillment( order.id, fulfillment.id, notifyCustomer );
+ const error = select( FulfillmentStore ).getError( order.id );
+ if ( error ) {
+ setError( error );
+ } else {
+ refreshOrderFulfillmentStatus( order.id );
+ setOpenSection( 'order' );
+ setIsEditing( false );
+ }
+ setIsExecuting( false );
+ };
+
+ const handleRemoveButtonClick = ( event: React.MouseEvent ) => {
+ event.stopPropagation();
+ event.preventDefault();
+ if ( ! fulfillment || isExecuting ) {
+ return;
+ }
+
+ if ( fulfillment.is_fulfilled ) {
+ openModal();
+ } else {
+ handleDeleteFulfillment();
+ }
+ };
+
+ return (
+ <>
+ <Button
+ variant="secondary"
+ onClick={ handleRemoveButtonClick }
+ isBusy={ isExecuting }
+ __next40pxDefaultSize
+ >
+ { __( 'Remove', 'woocommerce' ) }
+ </Button>
+ { isOpen && (
+ <Modal
+ title={ __( 'Remove fulfillment', 'woocommerce' ) }
+ onRequestClose={ closeModal }
+ size="medium"
+ isDismissible={ false }
+ className="woocommerce-fulfillment-modal"
+ >
+ <p className="woocommerce-fulfillment-modal-text">
+ { __(
+ 'Are you sure you want to remove this fulfillment?',
+ 'woocommerce'
+ ) }
+ </p>
+ <CustomerNotificationBox type="remove" />
+ <div className="woocommerce-fulfillment-modal-actions">
+ <Button
+ variant="link"
+ onClick={ closeModal }
+ __next40pxDefaultSize
+ >
+ { __( 'Cancel', 'woocommerce' ) }
+ </Button>
+ <Button
+ variant="primary"
+ onClick={ () => {
+ handleDeleteFulfillment();
+ closeModal();
+ } }
+ isBusy={ isExecuting }
+ __next40pxDefaultSize
+ >
+ { __( 'Remove fulfillment', 'woocommerce' ) }
+ </Button>
+ </div>
+ </Modal>
+ ) }
+ </>
+ );
+}
diff --git a/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/action-buttons/save-draft-button.tsx b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/action-buttons/save-draft-button.tsx
new file mode 100644
index 0000000000..3543e840a9
--- /dev/null
+++ b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/action-buttons/save-draft-button.tsx
@@ -0,0 +1,61 @@
+/**
+ * External dependencies
+ */
+import { Button } from '@wordpress/components';
+import { __ } from '@wordpress/i18n';
+import { useDispatch, select } from '@wordpress/data';
+import { useState } from 'react';
+
+/**
+ * Internal dependencies
+ */
+import { useFulfillmentContext } from '../../context/fulfillment-context';
+import { store as FulfillmentStore } from '../../data/store';
+import {
+ getFulfillmentItems,
+ refreshOrderFulfillmentStatus,
+} from '../../utils/fulfillment-utils';
+import { useFulfillmentDrawerContext } from '../../context/drawer-context';
+
+export default function SaveAsDraftButton( {
+ setError,
+}: {
+ setError: ( message: string | null ) => void;
+} ) {
+ const { setIsEditing } = useFulfillmentDrawerContext();
+ const { order, fulfillment, notifyCustomer } = useFulfillmentContext();
+ const [ isExecuting, setIsExecuting ] = useState( false );
+ const { saveFulfillment } = useDispatch( FulfillmentStore );
+
+ const handleFulfillItems = async () => {
+ setError( null );
+ if ( ! fulfillment || ! order ) {
+ return;
+ }
+ if ( getFulfillmentItems( fulfillment ).length === 0 ) {
+ setError( __( 'Select items to be fulfilled.', 'woocommerce' ) );
+ return;
+ }
+ setIsExecuting( true );
+ await saveFulfillment( order.id, fulfillment, notifyCustomer );
+ const error = select( FulfillmentStore ).getError( order.id );
+ if ( error ) {
+ setError( error );
+ } else {
+ refreshOrderFulfillmentStatus( order.id );
+ setIsEditing( false );
+ }
+ setIsExecuting( false );
+ };
+
+ return (
+ <Button
+ variant="secondary"
+ onClick={ handleFulfillItems }
+ __next40pxDefaultSize
+ isBusy={ isExecuting }
+ >
+ { __( 'Save as draft', 'woocommerce' ) }
+ </Button>
+ );
+}
diff --git a/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/action-buttons/test/cancel-link.test.js b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/action-buttons/test/cancel-link.test.js
new file mode 100644
index 0000000000..1d0f481072
--- /dev/null
+++ b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/action-buttons/test/cancel-link.test.js
@@ -0,0 +1,24 @@
+/**
+ * External dependencies
+ */
+import { render, screen, fireEvent } from '@testing-library/react';
+
+/**
+ * Internal dependencies
+ */
+import CancelLink from '../cancel-link';
+
+describe( 'CancelLink component', () => {
+ it( 'should render a cancel button', () => {
+ render( <CancelLink onClick={ () => {} } /> );
+ expect( screen.getByText( 'Cancel' ) ).toBeInTheDocument();
+ } );
+
+ it( 'should call onClick handler when clicked', () => {
+ const mockOnClick = jest.fn();
+ render( <CancelLink onClick={ mockOnClick } /> );
+
+ fireEvent.click( screen.getByText( 'Cancel' ) );
+ expect( mockOnClick ).toHaveBeenCalledTimes( 1 );
+ } );
+} );
diff --git a/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/action-buttons/test/edit-fulfillment-button.test.js b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/action-buttons/test/edit-fulfillment-button.test.js
new file mode 100644
index 0000000000..b3e0e13d8e
--- /dev/null
+++ b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/action-buttons/test/edit-fulfillment-button.test.js
@@ -0,0 +1,24 @@
+/**
+ * External dependencies
+ */
+import { render, screen, fireEvent } from '@testing-library/react';
+
+/**
+ * Internal dependencies
+ */
+import EditFulfillmentButton from '../edit-fulfillment-button';
+
+describe( 'EditFulfillmentButton component', () => {
+ it( 'should render button with correct text', () => {
+ render( <EditFulfillmentButton onClick={ () => {} } /> );
+ expect( screen.getByText( 'Edit fulfillment' ) ).toBeInTheDocument();
+ } );
+
+ it( 'should call onClick handler when clicked', () => {
+ const mockOnClick = jest.fn();
+ render( <EditFulfillmentButton onClick={ mockOnClick } /> );
+
+ fireEvent.click( screen.getByText( 'Edit fulfillment' ) );
+ expect( mockOnClick ).toHaveBeenCalledTimes( 1 );
+ } );
+} );
diff --git a/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/action-buttons/test/fulfill-items-button.test.js b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/action-buttons/test/fulfill-items-button.test.js
new file mode 100644
index 0000000000..c1121c38c6
--- /dev/null
+++ b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/action-buttons/test/fulfill-items-button.test.js
@@ -0,0 +1,106 @@
+/**
+ * External dependencies
+ */
+import { render, screen, fireEvent } from '@testing-library/react';
+import { useDispatch } from '@wordpress/data';
+
+/**
+ * Internal dependencies
+ */
+import '../../../test-helper/global-mock';
+import FulfillItemsButton from '../fulfill-items-button';
+import { useFulfillmentContext } from '../../../context/fulfillment-context';
+
+const setError = jest.fn();
+
+// Mock dependencies
+jest.mock( '@wordpress/data', () => {
+ const originalModule = jest.requireActual( '@wordpress/data' );
+ return {
+ ...originalModule,
+ useDispatch: jest.fn( () => {} ),
+ };
+} );
+
+jest.mock( '../../../context/fulfillment-context', () => ( {
+ useFulfillmentContext: jest.fn(),
+} ) );
+
+describe( 'FulfillItemsButton component', () => {
+ beforeEach( () => {
+ // Reset mocks
+ jest.clearAllMocks();
+
+ // Default mock implementations
+ useDispatch.mockReturnValue( { saveFulfillment: jest.fn() } );
+ useFulfillmentContext.mockReturnValue( {
+ order: { id: 123 },
+ fulfillment: { id: 456 },
+ notifyCustomer: true,
+ } );
+ } );
+
+ it( 'should render button with correct text', () => {
+ render( <FulfillItemsButton setError={ setError } /> );
+ expect( screen.getByText( 'Fulfill items' ) ).toBeInTheDocument();
+ } );
+
+ it( 'should call saveFulfillment when button is clicked', async () => {
+ const mockSaveFulfillment = jest.fn( () => Promise.resolve() );
+ useDispatch.mockReturnValue( { saveFulfillment: mockSaveFulfillment } );
+
+ const mockFulfillment = {
+ id: 456,
+ meta_data: [
+ {
+ id: 1,
+ key: '_items',
+ value: [
+ {
+ id: 1,
+ name: 'Item 1',
+ quantity: 2,
+ },
+ {
+ id: 2,
+ name: 'Item 2',
+ quantity: 3,
+ },
+ ],
+ },
+ ],
+ };
+ useFulfillmentContext.mockReturnValue( {
+ order: { id: 123 },
+ fulfillment: mockFulfillment,
+ notifyCustomer: true,
+ } );
+
+ render( <FulfillItemsButton setError={ setError } /> );
+ fireEvent.click( screen.getByText( 'Fulfill items' ) );
+
+ expect( mockFulfillment.is_fulfilled ).toBe( true );
+ expect( mockFulfillment.status ).toBe( 'fulfilled' );
+ expect( await mockSaveFulfillment ).toHaveBeenCalledWith(
+ 123,
+ mockFulfillment,
+ true
+ );
+ } );
+
+ it( 'should not call saveFulfillment when fulfillment is undefined', () => {
+ const mockSaveFulfillment = jest.fn();
+ useDispatch.mockReturnValue( { saveFulfillment: mockSaveFulfillment } );
+
+ useFulfillmentContext.mockReturnValue( {
+ order: { id: 123 },
+ fulfillment: undefined,
+ notifyCustomer: true,
+ } );
+
+ render( <FulfillItemsButton setError={ setError } /> );
+ fireEvent.click( screen.getByText( 'Fulfill items' ) );
+
+ expect( mockSaveFulfillment ).not.toHaveBeenCalled();
+ } );
+} );
diff --git a/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/action-buttons/test/remove-button.test.js b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/action-buttons/test/remove-button.test.js
new file mode 100644
index 0000000000..33df88df6a
--- /dev/null
+++ b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/action-buttons/test/remove-button.test.js
@@ -0,0 +1,148 @@
+/**
+ * External dependencies
+ */
+import { render, screen, fireEvent } from '@testing-library/react';
+import { useDispatch } from '@wordpress/data';
+
+/**
+ * Internal dependencies
+ */
+import '../../../test-helper/global-mock';
+import RemoveButton from '../remove-button';
+import { useFulfillmentContext } from '../../../context/fulfillment-context';
+
+// Mock dependencies
+jest.mock( '@wordpress/data', () => {
+ const originalModule = jest.requireActual( '@wordpress/data' );
+ return {
+ ...originalModule,
+ useDispatch: jest.fn( () => {} ),
+ };
+} );
+
+jest.mock( '../../../context/fulfillment-context', () => ( {
+ useFulfillmentContext: jest.fn(),
+} ) );
+
+const setError = jest.fn();
+
+describe( 'RemoveButton component', () => {
+ beforeEach( () => {
+ // Reset mocks
+ jest.clearAllMocks();
+
+ // Default mock implementations
+ useDispatch.mockReturnValue( {
+ deleteFulfillment: jest.fn(),
+ } );
+
+ useFulfillmentContext.mockReturnValue( {
+ order: { id: 123 },
+ fulfillment: { id: 456, is_fulfilled: false },
+ notifyCustomer: true,
+ } );
+ } );
+
+ it( 'should render button with correct text', () => {
+ render( <RemoveButton setError={ setError } /> );
+ expect( screen.getByText( 'Remove' ) ).toBeInTheDocument();
+ } );
+
+ it( 'should not call deleteFulfillment when fulfillment is undefined', () => {
+ const mockDeleteFulfillment = jest.fn();
+ useDispatch.mockReturnValue( {
+ deleteFulfillment: mockDeleteFulfillment,
+ } );
+
+ useFulfillmentContext.mockReturnValue( {
+ order: { id: 123 },
+ fulfillment: undefined,
+ notifyCustomer: true,
+ } );
+
+ render( <RemoveButton setError={ setError } /> );
+
+ fireEvent.click( screen.getByText( 'Remove' ) );
+
+ expect( mockDeleteFulfillment ).not.toHaveBeenCalled();
+ } );
+
+ it( 'should not call deleteFulfillment when fulfillment has no id', () => {
+ const mockDeleteFulfillment = jest.fn();
+ useDispatch.mockReturnValue( {
+ deleteFulfillment: mockDeleteFulfillment,
+ } );
+
+ useFulfillmentContext.mockReturnValue( {
+ order: { id: 123 },
+ fulfillment: {
+ /* no id */
+ is_fulfilled: false,
+ },
+ notifyCustomer: true,
+ } );
+
+ render( <RemoveButton setError={ setError } /> );
+ fireEvent.click( screen.getByText( 'Remove' ) );
+
+ expect( mockDeleteFulfillment ).not.toHaveBeenCalled();
+ } );
+
+ it( 'should call deleteFulfillment when button is clicked on unfulfilled fulfillment', async () => {
+ const mockDeleteFulfillment = jest.fn( () => Promise.resolve() );
+ useDispatch.mockReturnValue( {
+ deleteFulfillment: mockDeleteFulfillment,
+ } );
+
+ useFulfillmentContext.mockReturnValue( {
+ order: { id: 123 },
+ fulfillment: { id: 456, is_fulfilled: false },
+ notifyCustomer: true,
+ } );
+
+ render( <RemoveButton setError={ setError } /> );
+
+ fireEvent.click( screen.getByText( 'Remove' ) );
+
+ expect( await mockDeleteFulfillment ).toHaveBeenCalledWith(
+ 123,
+ 456,
+ true
+ );
+ } );
+
+ it( 'should open confirmation modal when button is clicked on fulfilled fulfillment', async () => {
+ const mockDeleteFulfillment = jest.fn( () => Promise.resolve() );
+ useDispatch.mockReturnValue( {
+ deleteFulfillment: mockDeleteFulfillment,
+ } );
+
+ useFulfillmentContext.mockReturnValue( {
+ order: { id: 123 },
+ fulfillment: { id: 456, is_fulfilled: true },
+ notifyCustomer: true,
+ } );
+
+ render( <RemoveButton setError={ setError } /> );
+
+ fireEvent.click( screen.getByText( 'Remove' ) );
+
+ expect(
+ screen.getByText(
+ 'Are you sure you want to remove this fulfillment?'
+ )
+ ).toBeInTheDocument();
+
+ expect( mockDeleteFulfillment ).not.toHaveBeenCalled();
+
+ // Simulate confirmation
+ fireEvent.click(
+ screen.getByRole( 'button', { name: 'Remove fulfillment' } )
+ );
+ expect( await mockDeleteFulfillment ).toHaveBeenCalledWith(
+ 123,
+ 456,
+ true
+ );
+ } );
+} );
diff --git a/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/action-buttons/test/save-draft-button.test.js b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/action-buttons/test/save-draft-button.test.js
new file mode 100644
index 0000000000..78846e6168
--- /dev/null
+++ b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/action-buttons/test/save-draft-button.test.js
@@ -0,0 +1,122 @@
+/**
+ * External dependencies
+ */
+import { render, screen, fireEvent } from '@testing-library/react';
+import { useDispatch } from '@wordpress/data';
+
+/**
+ * Internal dependencies
+ */
+import '../../../test-helper/global-mock';
+import SaveAsDraftButton from '../save-draft-button';
+import { useFulfillmentContext } from '../../../context/fulfillment-context';
+
+// Mock dependencies
+jest.mock( '@wordpress/data', () => {
+ const originalModule = jest.requireActual( '@wordpress/data' );
+ return {
+ ...originalModule,
+ useDispatch: jest.fn( () => {} ),
+ };
+} );
+
+jest.mock( '../../../context/fulfillment-context', () => ( {
+ useFulfillmentContext: jest.fn(),
+} ) );
+
+const setError = jest.fn();
+
+describe( 'SaveAsDraftButton component', () => {
+ beforeEach( () => {
+ // Reset mocks
+ jest.clearAllMocks();
+
+ // Default mock implementations
+ useDispatch.mockReturnValue( { saveFulfillment: jest.fn() } );
+ useFulfillmentContext.mockReturnValue( {
+ order: { id: 123 },
+ fulfillment: {
+ id: 456,
+ meta_data: [
+ {
+ id: 1,
+ key: '_items',
+ value: [
+ {
+ id: 1,
+ name: 'Item 1',
+ quantity: 2,
+ },
+ {
+ id: 2,
+ name: 'Item 2',
+ quantity: 3,
+ },
+ ],
+ },
+ ],
+ },
+ } );
+ } );
+
+ it( 'should render button with correct text', () => {
+ render( <SaveAsDraftButton setError={ setError } /> );
+ expect( screen.getByText( 'Save as draft' ) ).toBeInTheDocument();
+ } );
+
+ it( 'should call saveFulfillment when button is clicked', async () => {
+ const mockSaveFulfillment = jest.fn( () => Promise.resolve() );
+ useDispatch.mockReturnValue( { saveFulfillment: mockSaveFulfillment } );
+
+ const mockFulfillment = {
+ id: 456,
+ meta_data: [
+ {
+ id: 1,
+ key: '_items',
+ value: [
+ {
+ id: 1,
+ name: 'Item 1',
+ quantity: 2,
+ },
+ {
+ id: 2,
+ name: 'Item 2',
+ quantity: 3,
+ },
+ ],
+ },
+ ],
+ };
+ useFulfillmentContext.mockReturnValue( {
+ order: { id: 123 },
+ fulfillment: mockFulfillment,
+ notifyCustomer: true,
+ } );
+
+ render( <SaveAsDraftButton setError={ setError } /> );
+ fireEvent.click( screen.getByText( 'Save as draft' ) );
+
+ expect( mockSaveFulfillment ).toHaveBeenCalledWith(
+ 123,
+ mockFulfillment,
+ true
+ );
+ } );
+
+ it( 'should not call saveFulfillment when fulfillment is undefined', () => {
+ const mockSaveFulfillment = jest.fn();
+ useDispatch.mockReturnValue( { saveFulfillment: mockSaveFulfillment } );
+
+ useFulfillmentContext.mockReturnValue( {
+ order: { id: 123 },
+ fulfillment: undefined,
+ } );
+
+ render( <SaveAsDraftButton setError={ setError } /> );
+ fireEvent.click( screen.getByText( 'Save as draft' ) );
+
+ expect( mockSaveFulfillment ).not.toHaveBeenCalled();
+ } );
+} );
diff --git a/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/action-buttons/test/update-button.test.js b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/action-buttons/test/update-button.test.js
new file mode 100644
index 0000000000..09442bf1f6
--- /dev/null
+++ b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/action-buttons/test/update-button.test.js
@@ -0,0 +1,126 @@
+/**
+ * External dependencies
+ */
+import { render, screen, fireEvent } from '@testing-library/react';
+import { useDispatch } from '@wordpress/data';
+
+/**
+ * Internal dependencies
+ */
+import '../../../test-helper/global-mock';
+import UpdateButton from '../update-button';
+import { useFulfillmentContext } from '../../../context/fulfillment-context';
+
+const setError = jest.fn();
+
+// Mock dependencies
+jest.mock( '@wordpress/data', () => {
+ const originalModule = jest.requireActual( '@wordpress/data' );
+ return {
+ ...originalModule,
+ useDispatch: jest.fn( () => {} ),
+ };
+} );
+
+jest.mock( '../../../context/fulfillment-context', () => ( {
+ useFulfillmentContext: jest.fn(),
+} ) );
+
+describe( 'UpdateButton component', () => {
+ beforeEach( () => {
+ // Reset mocks
+ jest.clearAllMocks();
+
+ // Default mock implementations
+ useDispatch.mockReturnValue( { updateFulfillment: jest.fn() } );
+ useFulfillmentContext.mockReturnValue( {
+ order: { id: 123 },
+ fulfillment: {
+ id: 456,
+ meta_data: [
+ {
+ id: 1,
+ key: '_items',
+ value: [
+ {
+ id: 1,
+ name: 'Item 1',
+ quantity: 2,
+ },
+ {
+ id: 2,
+ name: 'Item 2',
+ quantity: 3,
+ },
+ ],
+ },
+ ],
+ },
+ } );
+ } );
+
+ it( 'should render button with correct text', () => {
+ render( <UpdateButton setError={ setError } /> );
+ expect( screen.getByText( 'Update' ) ).toBeInTheDocument();
+ } );
+
+ it( 'should call updateFulfillment when button is clicked', async () => {
+ const mockUpdateFulfillment = jest.fn( () => Promise.resolve() );
+ useDispatch.mockReturnValue( {
+ updateFulfillment: mockUpdateFulfillment,
+ } );
+
+ const mockFulfillment = {
+ id: 456,
+ meta_data: [
+ {
+ id: 1,
+ key: '_items',
+ value: [
+ {
+ id: 1,
+ name: 'Item 1',
+ quantity: 2,
+ },
+ {
+ id: 2,
+ name: 'Item 2',
+ quantity: 3,
+ },
+ ],
+ },
+ ],
+ };
+ useFulfillmentContext.mockReturnValue( {
+ order: { id: 123 },
+ fulfillment: mockFulfillment,
+ notifyCustomer: true,
+ } );
+
+ render( <UpdateButton setError={ setError } /> );
+ fireEvent.click( screen.getByText( 'Update' ) );
+
+ expect( await mockUpdateFulfillment ).toHaveBeenCalledWith(
+ 123,
+ mockFulfillment,
+ true
+ );
+ } );
+
+ it( 'should not call updateFulfillment when fulfillment is undefined', () => {
+ const mockUpdateFulfillment = jest.fn();
+ useDispatch.mockReturnValue( {
+ updateFulfillment: mockUpdateFulfillment,
+ } );
+
+ useFulfillmentContext.mockReturnValue( {
+ order: { id: 123 },
+ fulfillment: undefined,
+ } );
+
+ render( <UpdateButton setError={ setError } /> );
+ fireEvent.click( screen.getByText( 'Update' ) );
+
+ expect( mockUpdateFulfillment ).not.toHaveBeenCalled();
+ } );
+} );
diff --git a/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/action-buttons/update-button.tsx b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/action-buttons/update-button.tsx
new file mode 100644
index 0000000000..d9cc18d5a2
--- /dev/null
+++ b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/action-buttons/update-button.tsx
@@ -0,0 +1,69 @@
+/**
+ * External dependencies
+ */
+import { Button } from '@wordpress/components';
+import { __ } from '@wordpress/i18n';
+import { useDispatch, select } from '@wordpress/data';
+import { useState } from 'react';
+
+/**
+ * Internal dependencies
+ */
+import { useFulfillmentContext } from '../../context/fulfillment-context';
+import { store as FulfillmentStore } from '../../data/store';
+import {
+ getFulfillmentItems,
+ refreshOrderFulfillmentStatus,
+} from '../../utils/fulfillment-utils';
+import { useFulfillmentDrawerContext } from '../../context/drawer-context';
+
+export default function UpdateButton( {
+ setError,
+}: {
+ setError: ( message: string | null ) => void;
+} ) {
+ const { setIsEditing } = useFulfillmentDrawerContext();
+ const { order, fulfillment, notifyCustomer } = useFulfillmentContext();
+ const { updateFulfillment } = useDispatch( FulfillmentStore );
+ const [ isExecuting, setIsExecuting ] = useState< boolean >( false );
+
+ const handleUpdateFulfillment = async () => {
+ if ( ! fulfillment || ! order ) {
+ setError(
+ __(
+ 'An unexpected error has occurred. Please refresh the page and try again.',
+ 'woocommerce'
+ )
+ );
+ return;
+ }
+ if ( getFulfillmentItems( fulfillment ).length === 0 ) {
+ setError( __( 'Select items to be fulfilled.', 'woocommerce' ) );
+ return;
+ }
+
+ setError( null );
+ setIsExecuting( true );
+ await updateFulfillment( order.id, fulfillment, notifyCustomer );
+ const error = select( FulfillmentStore ).getError( order.id );
+ if ( error ) {
+ setError( error );
+ } else {
+ refreshOrderFulfillmentStatus( order.id );
+ setIsEditing( false );
+ }
+ setIsExecuting( false );
+ };
+
+ return (
+ <Button
+ variant="primary"
+ onClick={ handleUpdateFulfillment }
+ disabled={ isExecuting }
+ isBusy={ isExecuting }
+ __next40pxDefaultSize
+ >
+ { __( 'Update', 'woocommerce' ) }
+ </Button>
+ );
+}
diff --git a/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/customer-notification-form/index.tsx b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/customer-notification-form/index.tsx
new file mode 100644
index 0000000000..e920209d37
--- /dev/null
+++ b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/customer-notification-form/index.tsx
@@ -0,0 +1,71 @@
+/**
+ * External dependencies
+ */
+import { ToggleControl } from '@wordpress/components';
+import { __ } from '@wordpress/i18n';
+
+/**
+ * Internal dependencies
+ */
+import FulfillmentCard from '../user-interface/fulfillments-card/card';
+import { EnvelopeIcon } from '../../utils/icons';
+import { useFulfillmentContext } from '../../context/fulfillment-context';
+
+/**
+ * Internal dependencies
+ */
+
+export default function CustomerNotificationBox( {
+ type = 'fulfill',
+}: {
+ type: 'fulfill' | 'update' | 'remove';
+} ) {
+ const { notifyCustomer, setNotifyCustomer } = useFulfillmentContext();
+
+ const headerStrings = {
+ fulfill: __( 'Fulfillment notification', 'woocommerce' ),
+ remove: __( 'Removal update', 'woocommerce' ),
+ update: __( 'Update notification', 'woocommerce' ),
+ };
+
+ const contentStrings = {
+ fulfill: __(
+ 'Automatically send an email to the customer when the selected items are fulfilled.',
+ 'woocommerce'
+ ),
+ remove: __(
+ 'Automatically send an email to the customer notifying that the fulfillment is cancelled.',
+ 'woocommerce'
+ ),
+ update: __(
+ 'Automatically send an email to the customer when the fulfillment is updated.',
+ 'woocommerce'
+ ),
+ };
+
+ return (
+ <FulfillmentCard
+ size="small"
+ isCollapsable={ false }
+ initialState="expanded"
+ header={
+ <>
+ <EnvelopeIcon />
+ <h3>{ headerStrings[ type ] || headerStrings.fulfill }</h3>
+ <ToggleControl
+ __nextHasNoMarginBottom
+ checked={ notifyCustomer }
+ label={ null }
+ onChange={ ( checked ) => {
+ setNotifyCustomer( checked );
+ } }
+ />
+ </>
+ }
+ >
+ <p className="woocommerce-fulfillment-description">
+ { contentStrings[ type ] || contentStrings.fulfill }
+ </p>
+ </FulfillmentCard>
+ );
+}
diff --git a/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/customer-notification-form/test/index.test.js b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/customer-notification-form/test/index.test.js
new file mode 100644
index 0000000000..eb48185a3d
--- /dev/null
+++ b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/customer-notification-form/test/index.test.js
@@ -0,0 +1,89 @@
+/**
+ * External dependencies
+ */
+import { render, screen } from '@testing-library/react';
+
+/**
+ * Internal dependencies
+ */
+import CustomerNotificationBox from '../index';
+
+// Mock dependencies
+jest.mock( '../../user-interface/fulfillments-card/card', () => ( {
+ __esModule: true,
+ default: ( { children, header } ) => (
+ <div data-testid="fulfillment-card">
+ <div data-testid="card-header">{ header }</div>
+ <div data-testid="card-body">{ children }</div>
+ </div>
+ ),
+} ) );
+
+jest.mock( '../../../utils/icons', () => ( {
+ EnvelopeIcon: () => <div data-testid="envelope-icon" />,
+} ) );
+
+const setValue = jest.fn();
+
+jest.mock( '../../../context/fulfillment-context', () => ( {
+ useFulfillmentContext: jest.fn( () => ( {
+ notifyCustomer: true,
+ setNotifyCustomer: setValue,
+ } ) ),
+} ) );
+
+// Mock ToggleControl to make testing easier
+jest.mock( '@wordpress/components', () => ( {
+ ToggleControl: ( props ) => (
+ <div data-testid="toggle-control">
+ <input
+ type="checkbox"
+ checked={ props.checked }
+ onChange={ () => props.onChange( ! props.checked ) }
+ data-testid="toggle-input"
+ />
+ </div>
+ ),
+} ) );
+
+describe( 'CustomerNotificationBox component', () => {
+ it( 'should render the component with proper title', () => {
+ render( <CustomerNotificationBox type="fulfill" /> );
+
+ // Check title and icon
+ expect(
+ screen.getByText( 'Fulfillment notification' )
+ ).toBeInTheDocument();
+ expect( screen.getByTestId( 'envelope-icon' ) ).toBeInTheDocument();
+ } );
+
+ it( 'should render the description text', () => {
+ render( <CustomerNotificationBox type="fulfill" /> );
+
+ // Check description text
+ expect(
+ screen.getByText(
+ 'Automatically send an email to the customer when the selected items are fulfilled.'
+ )
+ ).toBeInTheDocument();
+ } );
+
+ it( 'should call setValue with the correct value when toggle is changed', () => {
+ render( <CustomerNotificationBox type="fulfill" /> );
+
+ // Find and click the toggle input
+ const toggleInput = screen.getByTestId( 'toggle-input' );
+ toggleInput.click();
+
+ // Check that setValue was called with true (toggling from true -> false)
+ expect( setValue ).toHaveBeenCalledWith( false );
+ } );
+
+ it( 'should render with toggle in correct state based on value prop', () => {
+ render( <CustomerNotificationBox type="fulfill" /> );
+
+ // Verify toggle is checked
+ const toggleInput = screen.getByTestId( 'toggle-input' );
+ expect( toggleInput.checked ).toBe( true );
+ } );
+} );
diff --git a/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/fulfillments/fulfillment-editor.tsx b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/fulfillments/fulfillment-editor.tsx
new file mode 100644
index 0000000000..2d3bd9856c
--- /dev/null
+++ b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/fulfillments/fulfillment-editor.tsx
@@ -0,0 +1,212 @@
+/**
+ * External dependencies
+ */
+import { Button, Icon } from '@wordpress/components';
+import { useEffect, useState } from 'react';
+import { __, sprintf } from '@wordpress/i18n';
+
+/**
+ * Internal dependencies
+ */
+import { Fulfillment } from '../../data/types';
+import {
+ combineItems,
+ getItemsFromFulfillment,
+ getItemsNotInAnyFulfillment,
+} from '../../utils/order-utils';
+import { FulfillmentProvider } from '../../context/fulfillment-context';
+import ItemSelector from './item-selector';
+import EditFulfillmentButton from '../action-buttons/edit-fulfillment-button';
+import FulfillItemsButton from '../action-buttons/fulfill-items-button';
+import CancelLink from '../action-buttons/cancel-link';
+import RemoveButton from '../action-buttons/remove-button';
+import UpdateButton from '../action-buttons/update-button';
+import CustomerNotificationBox from '../customer-notification-form';
+import FulfillmentStatusBadge from './fulfillment-status-badge';
+import ErrorLabel from '../user-interface/error-label';
+import { useFulfillmentDrawerContext } from '../../context/drawer-context';
+import ShipmentViewer from '../shipment-form/shipment-viewer';
+import ShipmentForm from '../shipment-form';
+import { ShipmentFormProvider } from '../../context/shipment-form-context';
+import MetadataViewer from '../metadata-viewer';
+import { getFulfillmentLockState } from '../../utils/fulfillment-utils';
+import LockLabel from '../user-interface/lock-label';
+
+interface FulfillmentEditorProps {
+ index: number;
+ expanded: boolean;
+ onExpand: () => void;
+ onCollapse: () => void;
+ fulfillment: Fulfillment;
+ disabled?: boolean;
+}
+export default function FulfillmentEditor( {
+ index,
+ expanded,
+ onExpand,
+ onCollapse,
+ fulfillment,
+ disabled = false,
+}: FulfillmentEditorProps ) {
+ const { order, fulfillments, refunds } = useFulfillmentDrawerContext();
+ const { isEditing, setIsEditing } = useFulfillmentDrawerContext();
+ const [ error, setError ] = useState< string | null >( null );
+ const itemsInFulfillment = order
+ ? getItemsFromFulfillment( order, fulfillment )
+ : [];
+ const itemsNotInAnyFulfillment = order
+ ? getItemsNotInAnyFulfillment( fulfillments, order, refunds )
+ : [];
+ const selectableItems = combineItems(
+ [ ...itemsInFulfillment ],
+ [ ...itemsNotInAnyFulfillment ]
+ );
+
+ const fulfillmentLockState = getFulfillmentLockState( fulfillment );
+
+ // Reset error when order changes
+ useEffect( () => {
+ setError( null );
+ }, [ order?.id ] );
+
+ const handleChevronClick = () => {
+ if ( isEditing ) return;
+ if (
+ itemsNotInAnyFulfillment.length === 0 &&
+ fulfillments.length === 1
+ )
+ return;
+ if ( ! expanded ) {
+ onExpand();
+ } else {
+ onCollapse();
+ }
+ };
+
+ return (
+ <div
+ className={ [
+ 'woocommerce-fulfillment-stored-fulfillment-list-item',
+ disabled
+ ? 'woocommerce-fulfillment-stored-fulfillment-list-item__disabled'
+ : '',
+ ].join( ' ' ) }
+ >
+ <div
+ className={ [
+ 'woocommerce-fulfillment-stored-fulfillment-list-item-header',
+ expanded ? 'is-open' : '',
+ ].join( ' ' ) }
+ onClick={ handleChevronClick }
+ onKeyUp={ ( event ) => {
+ if ( event.key === 'Enter' ) {
+ handleChevronClick();
+ }
+ } }
+ role="button"
+ tabIndex={ -1 }
+ >
+ <h3>
+ {
+ // eslint-disable-next-line @wordpress/valid-sprintf
+ sprintf(
+ isEditing
+ ? /* translators: %s: Fulfillment ID */
+ __( 'Editing fulfillment #%s', 'woocommerce' )
+ : /* translators: %s: Fulfillment ID */
+ __( 'Fulfillment #%s', 'woocommerce' ),
+ index + 1
+ )
+ }
+ </h3>
+ <FulfillmentStatusBadge fulfillment={ fulfillment } />
+ { ( itemsNotInAnyFulfillment.length > 0 ||
+ fulfillments.length > 1 ) && (
+ <Button __next40pxDefaultSize size="small">
+ <Icon
+ icon={
+ expanded ? 'arrow-up-alt2' : 'arrow-down-alt2'
+ }
+ size={ 16 }
+ color={ isEditing ? '#dddddd' : undefined }
+ />
+ </Button>
+ ) }
+ </div>
+ { expanded && (
+ <div className="woocommerce-fulfillment-stored-fulfillment-list-item-content">
+ { error && <ErrorLabel error={ error } /> }
+
+ <ShipmentFormProvider fulfillment={ fulfillment }>
+ <FulfillmentProvider
+ order={ order }
+ fulfillment={ fulfillment }
+ items={
+ isEditing ? selectableItems : itemsInFulfillment
+ }
+ >
+ <ItemSelector editMode={ isEditing } />
+ { isEditing && <ShipmentForm /> }
+ { ! isEditing && (
+ <>
+ <ShipmentViewer />
+ <MetadataViewer
+ fulfillment={ fulfillment }
+ />
+ </>
+ ) }
+ { ( ( fulfillment.is_fulfilled && isEditing ) ||
+ ( ! fulfillment.is_fulfilled &&
+ ! isEditing ) ) && (
+ <CustomerNotificationBox type="update" />
+ ) }
+ { fulfillmentLockState.isLocked ? (
+ <div className="woocommerce-fulfillment-item-lock-container">
+ <LockLabel
+ message={ fulfillmentLockState.reason }
+ />
+ </div>
+ ) : (
+ <div className="woocommerce-fulfillment-item-actions">
+ { ! isEditing ? (
+ <>
+ <EditFulfillmentButton
+ onClick={ () => {
+ setIsEditing( true );
+ } }
+ />
+ { ! fulfillment.is_fulfilled && (
+ <FulfillItemsButton
+ setError={ setError }
+ />
+ ) }
+ </>
+ ) : (
+ <>
+ <CancelLink
+ onClick={ () => {
+ setError( null );
+ setIsEditing( false );
+ } }
+ />
+ <RemoveButton
+ setError={ ( message ) =>
+ setError( message )
+ }
+ />
+ <UpdateButton
+ setError={ ( message ) =>
+ setError( message )
+ }
+ />
+ </>
+ ) }
+ </div>
+ ) }
+ </FulfillmentProvider>
+ </ShipmentFormProvider>
+ </div>
+ ) }
+ </div>
+ );
+}
diff --git a/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/fulfillments/fulfillment-line-item.tsx b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/fulfillments/fulfillment-line-item.tsx
new file mode 100644
index 0000000000..f0f77b6343
--- /dev/null
+++ b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/fulfillments/fulfillment-line-item.tsx
@@ -0,0 +1,195 @@
+/**
+ * External dependencies
+ */
+import { useContext, useState } from 'react';
+import { CheckboxControl, Icon } from '@wordpress/components';
+import CurrencyFactory, {
+ CurrencyContext,
+ SymbolPosition,
+} from '@woocommerce/currency';
+import { decodeEntities } from '@wordpress/html-entities';
+import { range } from 'lodash';
+
+/**
+ * Internal dependencies
+ */
+import { LineItem } from '../../data/types';
+
+type FulfillmentItemProps = {
+ item: LineItem;
+ quantity: number;
+ currency: string;
+ editMode: boolean;
+ toggleItem: ( id: number, index: number, checked: boolean ) => void;
+ isChecked: ( id: number, index: number ) => boolean;
+ isIndeterminate: ( id: number ) => boolean;
+};
+
+export default function FulfillmentLineItem( {
+ item,
+ quantity,
+ currency,
+ editMode,
+ toggleItem,
+ isChecked,
+ isIndeterminate,
+}: FulfillmentItemProps ) {
+ const [ itemExpanded, setItemExpanded ] = useState( false );
+
+ const currencyContext = useContext( CurrencyContext );
+
+ const storeCurrency = currencyContext.getCurrencyConfig();
+
+ const getFormattedItemTotal = (
+ total: number | string,
+ orderCurrencyCode: string
+ ) => {
+ if ( ! orderCurrencyCode ) {
+ orderCurrencyCode = storeCurrency?.code || 'USD';
+ }
+
+ // If the order currency is the same as the store currency, we show the formatted amount.
+ if ( storeCurrency && storeCurrency.code === orderCurrencyCode ) {
+ return currencyContext.formatAmount( total );
+ }
+
+ const symbol =
+ window.wcFulfillmentSettings.currency_symbols[ orderCurrencyCode ];
+
+ if ( ! symbol ) {
+ // This should never happen, but if it does, we'll just show the currency code.
+ return `${ orderCurrencyCode }${ total }`;
+ }
+
+ // If the order currency is different from the store currency, we show the currency code and amount in the order currency.
+ return CurrencyFactory( {
+ ...storeCurrency,
+ symbol: decodeEntities( symbol ),
+ symbolPosition: storeCurrency.symbolPosition as
+ | SymbolPosition
+ | undefined,
+ code: orderCurrencyCode,
+ } ).formatAmount( total );
+ };
+
+ return (
+ <>
+ <div
+ className={ [
+ 'woocommerce-fulfillment-item-container',
+ itemExpanded ? 'woocommerce-fulfillment-item-expanded' : '',
+ ].join( ' ' ) }
+ >
+ { editMode && (
+ <div className="woocommerce-fulfillment-item-checkbox">
+ <CheckboxControl
+ value={ item.id }
+ checked={ isChecked( item.id, -1 ) }
+ onChange={ ( value ) => {
+ toggleItem( item.id, -1, value );
+ } }
+ indeterminate={ isIndeterminate( item.id ) }
+ __nextHasNoMarginBottom
+ />
+ </div>
+ ) }
+ { editMode && quantity > 1 && (
+ <Icon
+ icon={
+ itemExpanded ? 'arrow-up-alt2' : 'arrow-down-alt2'
+ }
+ onClick={ () => {
+ setItemExpanded( ! itemExpanded );
+ } }
+ size={ 16 }
+ />
+ ) }
+ <div className="woocommerce-fulfillment-item-title">
+ <div className="woocommerce-fulfillment-item-image-container">
+ { item.image?.src && (
+ <img
+ src={ item.image?.src }
+ alt={ item.name }
+ width={ 32 }
+ height={ 32 }
+ className="woocommerce-fulfillment-item-image"
+ />
+ ) }
+ </div>
+ <div className="woocommerce-fulfillment-item-name-sku">
+ <div className="woocommerce-fulfillment-item-name">
+ { item.name }
+ </div>
+ { item.sku && (
+ <span className="woocommerce-fulfillment-item-sku">
+ { item.sku }
+ </span>
+ ) }
+ </div>
+ </div>
+ { quantity > 1 && (
+ <div className="woocommerce-fulfillment-item-quantity">
+ { 'x' + quantity }
+ </div>
+ ) }
+ <div className="woocommerce-fulfillment-item-price">
+ { getFormattedItemTotal(
+ parseFloat( item.total ) * ( quantity / item.quantity ),
+ currency
+ ) }
+ </div>
+ </div>
+ { editMode && itemExpanded && (
+ <div className="woocommerce-fulfillment-item-expansion">
+ { range( quantity ).map( ( index ) => (
+ <div
+ key={ 'fulfillment-item-expansion-' + index }
+ className="woocommerce-fulfillment-item-expansion-row"
+ >
+ { editMode && (
+ <div className="woocommerce-fulfillment-item-checkbox">
+ <CheckboxControl
+ name={ `fulfillment-item-${ item.id }-${ index }` }
+ value={ item.id + '-' + index }
+ checked={ isChecked( item.id, index ) }
+ onChange={ ( value ) => {
+ toggleItem( item.id, index, value );
+ } }
+ __nextHasNoMarginBottom
+ />
+ </div>
+ ) }
+ <div className="woocommerce-fulfillment-item-title">
+ <div className="woocommerce-fulfillment-item-image-container">
+ <img
+ src={ item.image.src }
+ alt={ item.name }
+ width={ 32 }
+ height={ 32 }
+ className="woocommerce-fulfillment-item-image"
+ />
+ </div>
+ <div className="woocommerce-fulfillment-item-name-sku">
+ <div className="woocommerce-fulfillment-item-name">
+ { item.name }
+ </div>
+ { item.sku && (
+ <span className="woocommerce-fulfillment-item-sku">
+ { item.sku }
+ </span>
+ ) }
+ </div>
+ </div>
+ <div className="woocommerce-fulfillment-item-price">
+ { getFormattedItemTotal(
+ parseInt( item.total, 10 ) / item.quantity,
+ currency
+ ) }
+ </div>
+ </div>
+ ) ) }
+ </div>
+ ) }
+ </>
+ );
+}
diff --git a/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/fulfillments/fulfillment-status-badge.tsx b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/fulfillments/fulfillment-status-badge.tsx
new file mode 100644
index 0000000000..99b0c9db0c
--- /dev/null
+++ b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/fulfillments/fulfillment-status-badge.tsx
@@ -0,0 +1,30 @@
+/**
+ * Internal dependencies
+ */
+import { Fulfillment } from '../../data/types';
+
+export default function FulfillmentStatusBadge( {
+ fulfillment,
+}: {
+ fulfillment: Fulfillment;
+} ) {
+ const statuses = window.wcFulfillmentSettings?.fulfillment_statuses || {};
+ const fulfillmentStatus = statuses[ fulfillment.status ] || {
+ label: fulfillment.status,
+ is_fulfilled: false,
+ background_color: '',
+ text_color: '',
+ };
+
+ return (
+ <div
+ className={ `woocommerce-fulfillment-status-badge woocommerce-fulfillment-status-badge__${ fulfillment.status }` }
+ style={ {
+ backgroundColor: fulfillmentStatus.background_color,
+ color: fulfillmentStatus.text_color,
+ } }
+ >
+ { fulfillmentStatus.label }
+ </div>
+ );
+}
diff --git a/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/fulfillments/fulfillments-list.tsx b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/fulfillments/fulfillments-list.tsx
new file mode 100644
index 0000000000..44dacfb454
--- /dev/null
+++ b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/fulfillments/fulfillments-list.tsx
@@ -0,0 +1,35 @@
+/**
+ * Internal dependencies
+ */
+import FulfillmentEditor from './fulfillment-editor';
+import { useFulfillmentDrawerContext } from '../../context/drawer-context';
+
+export default function FulfillmentsList() {
+ const { fulfillments, openSection, setOpenSection, isEditing } =
+ useFulfillmentDrawerContext();
+
+ return (
+ fulfillments.length > 0 && (
+ <div className="woocommerce-fulfillment-stored-fulfillments-list">
+ { fulfillments.map( ( fulfillment, index ) => (
+ <FulfillmentEditor
+ index={ index }
+ disabled={
+ isEditing &&
+ openSection !== 'fulfillment-' + fulfillment.id
+ }
+ expanded={
+ openSection === 'fulfillment-' + fulfillment.id
+ }
+ onExpand={ () =>
+ setOpenSection( 'fulfillment-' + fulfillment.id )
+ }
+ onCollapse={ () => setOpenSection( '' ) }
+ key={ fulfillment.id }
+ fulfillment={ fulfillment }
+ />
+ ) ) }
+ </div>
+ )
+ );
+}
diff --git a/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/fulfillments/item-selector.tsx b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/fulfillments/item-selector.tsx
new file mode 100644
index 0000000000..e88a8c421d
--- /dev/null
+++ b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/fulfillments/item-selector.tsx
@@ -0,0 +1,176 @@
+/**
+ * External dependencies
+ */
+import { CheckboxControl } from '@wordpress/components';
+import { _n, sprintf } from '@wordpress/i18n';
+
+/**
+ * Internal dependencies
+ */
+import FulfillmentLineItem from './fulfillment-line-item';
+import { ItemSelection } from '../../utils/order-utils';
+import { useFulfillmentContext } from '../../context/fulfillment-context';
+
+type ItemSelectorProps = {
+ editMode: boolean;
+};
+
+export default function ItemSelector( { editMode }: ItemSelectorProps ) {
+ const { order, selectedItems, setSelectedItems } = useFulfillmentContext();
+
+ const itemsCount = selectedItems.reduce(
+ ( acc, item ) => acc + item.selection.length,
+ 0
+ );
+
+ const selectedItemsCount = selectedItems.reduce(
+ ( acc, item ) =>
+ acc +
+ item.selection.filter( ( selection ) => selection.checked ).length,
+ 0
+ );
+
+ const clearSelectedItems = () => {
+ setSelectedItems(
+ selectedItems.map( ( item ) => ( {
+ ...item,
+ selection: item.selection.map( ( selection ) => ( {
+ ...selection,
+ checked: false,
+ } ) ),
+ } ) )
+ );
+ };
+
+ const selectAllItems = () => {
+ setSelectedItems(
+ selectedItems.map( ( item ) => ( {
+ ...item,
+ selection: item.selection.map( ( selection ) => ( {
+ ...selection,
+ checked: true,
+ } ) ),
+ } ) )
+ );
+ };
+
+ const handleToggleItem = (
+ id: number,
+ index: number,
+ checked: boolean
+ ) => {
+ if ( index < 0 ) {
+ // If the index is negative, it means we are trying to toggle the whole item.
+ // We will toggle all selections for this item.
+ setSelectedItems( [
+ ...selectedItems.map( ( item ) => {
+ if ( item.item_id === id ) {
+ return {
+ ...item,
+ selection: item.selection.map( ( selection ) => ( {
+ ...selection,
+ checked,
+ } ) ),
+ };
+ }
+ return item;
+ } ),
+ ] );
+ return;
+ }
+ setSelectedItems( [
+ ...selectedItems.map( ( item ) => {
+ if ( item.item_id === id ) {
+ item.selection.map( ( selection ) => {
+ if ( selection.index === index ) {
+ selection.checked = checked;
+ }
+ return selection;
+ } );
+ }
+ return item;
+ } ),
+ ] );
+ };
+
+ const isChecked = ( id: number, index: number ) => {
+ if ( index < 0 ) {
+ // If the index is negative, it means we are trying to determine if the whole item is checked.
+ return selectedItems.some(
+ ( item ) =>
+ item.item_id === id &&
+ item.selection.every( ( selection ) => selection.checked )
+ );
+ }
+ const _item = selectedItems.find( ( item ) => item.item_id === id );
+ if ( ! _item ) {
+ return false;
+ }
+ const _selection = _item.selection.find(
+ ( selection ) => selection.index === index
+ );
+ return _selection ? _selection.checked : false;
+ };
+
+ const isIndeterminate = ( id: number ) => {
+ const _item = selectedItems.find( ( item ) => item.item_id === id );
+ if ( ! _item ) {
+ return false;
+ }
+ const checkedCount = _item.selection.filter(
+ ( selection ) => selection.checked
+ ).length;
+ return checkedCount > 0 && checkedCount < _item.selection.length;
+ };
+
+ return (
+ <ul className="woocommerce-fulfillment-item-list">
+ <li>
+ <div className="woocommerce-fulfillment-item-bulk-select">
+ { editMode && (
+ <CheckboxControl
+ onChange={ () => {
+ if ( selectedItemsCount === itemsCount ) {
+ clearSelectedItems();
+ } else {
+ selectAllItems();
+ }
+ } }
+ checked={ selectedItemsCount === itemsCount }
+ indeterminate={
+ selectedItemsCount > 0 &&
+ selectedItemsCount < itemsCount
+ }
+ __nextHasNoMarginBottom
+ />
+ ) }
+ <div className="woocommerce-fulfillment-item-bulk-select__label">
+ { sprintf(
+ /* translators: %s: number of selected items */
+ _n(
+ '%s selected',
+ '%s selected',
+ selectedItemsCount,
+ 'woocommerce'
+ ),
+ selectedItemsCount
+ ) }
+ </div>
+ </div>
+ </li>
+ { selectedItems.map( ( item: ItemSelection ) => (
+ <li key={ item.item_id }>
+ <FulfillmentLineItem
+ item={ item.item }
+ quantity={ item.selection.length }
+ editMode={ editMode }
+ currency={ order?.currency ?? '' }
+ toggleItem={ handleToggleItem }
+ isChecked={ isChecked }
+ isIndeterminate={ isIndeterminate }
+ />
+ </li>
+ ) ) }
+ </ul>
+ );
+}
diff --git a/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/fulfillments/new-fulfillment-form.tsx b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/fulfillments/new-fulfillment-form.tsx
new file mode 100644
index 0000000000..444e02b2d0
--- /dev/null
+++ b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/fulfillments/new-fulfillment-form.tsx
@@ -0,0 +1,142 @@
+/**
+ * External dependencies
+ */
+import { useEffect, useMemo, useState } from 'react';
+import { __ } from '@wordpress/i18n';
+import { Button, Icon } from '@wordpress/components';
+
+/**
+ * Internal dependencies
+ */
+import { LineItem, Order } from '../../data/types';
+import { FulfillmentProvider } from '../../context/fulfillment-context';
+import SaveAsDraftButton from '../action-buttons/save-draft-button';
+import FulfillItemsButton from '../action-buttons/fulfill-items-button';
+import { getItemsNotInAnyFulfillment } from '../../utils/order-utils';
+import ItemSelector from './item-selector';
+import { useFulfillmentDrawerContext } from '../../context/drawer-context';
+import ErrorLabel from '../user-interface/error-label';
+import { ShipmentFormProvider } from '../../context/shipment-form-context';
+import ShipmentForm from '../shipment-form';
+import CustomerNotificationBox from '../customer-notification-form';
+
+const NewFulfillmentForm: React.FC = () => {
+ const {
+ order,
+ fulfillments,
+ refunds,
+ openSection,
+ setOpenSection,
+ isEditing,
+ } = useFulfillmentDrawerContext();
+ const [ error, setError ] = useState< string | null >( null );
+
+ // Reset error when order changes
+ useEffect( () => {
+ setError( null );
+ }, [ order?.id ] );
+
+ const remainingItems = useMemo(
+ () =>
+ getItemsNotInAnyFulfillment(
+ fulfillments,
+ order ?? ( { line_items: [] as LineItem[] } as Order ),
+ refunds ?? []
+ ).map( ( item ) => ( {
+ ...item,
+ selection: item.selection.map( ( selection ) => ( {
+ ...selection,
+ checked: true,
+ } ) ),
+ } ) ),
+ [ fulfillments, order, refunds ]
+ );
+
+ if ( ! order ) {
+ return null;
+ }
+
+ if ( remainingItems.length === 0 ) {
+ return null;
+ }
+
+ return (
+ <div
+ className={ [
+ 'woocommerce-fulfillment-new-fulfillment-form',
+ isEditing
+ ? 'woocommerce-fulfillment-new-fulfillment-form__disabled'
+ : '',
+ fulfillments.length === 0
+ ? 'woocommerce-fulfillment-new-fulfillment-form__first'
+ : '',
+ ].join( ' ' ) }
+ >
+ <div
+ className={ [
+ 'woocommerce-fulfillment-new-fulfillment-form__header',
+ openSection === 'order' ? 'is-open' : '',
+ ].join( ' ' ) }
+ onClick={ () => {
+ if ( fulfillments.length > 0 ) {
+ setOpenSection(
+ openSection === 'order' ? '' : 'order'
+ );
+ }
+ } }
+ onKeyDown={ ( event ) => {
+ if ( fulfillments.length > 0 ) {
+ if ( event.key === 'Enter' || event.key === ' ' ) {
+ setOpenSection(
+ openSection === 'order' ? '' : 'order'
+ );
+ }
+ }
+ } }
+ tabIndex={ 0 }
+ role="button"
+ >
+ <h3>
+ { fulfillments.length === 0
+ ? __( 'Order Items', 'woocommerce' )
+ : __( 'Pending Items', 'woocommerce' ) }
+ </h3>
+ { fulfillments.length > 0 && (
+ <Button __next40pxDefaultSize size="small">
+ <Icon
+ icon={
+ openSection === 'order'
+ ? 'arrow-up-alt2'
+ : 'arrow-down-alt2'
+ }
+ size={ 16 }
+ />
+ </Button>
+ ) }
+ </div>
+ { ! isEditing && openSection === 'order' && (
+ <div className="woocommerce-fulfillment-new-fulfillment-form__content">
+ { error && <ErrorLabel error={ error } /> }
+ <ShipmentFormProvider>
+ <FulfillmentProvider
+ order={ order }
+ fulfillment={ null }
+ items={ remainingItems }
+ >
+ <ItemSelector editMode={ true } />
+
+ <ShipmentForm />
+ <CustomerNotificationBox type="fulfill" />
+ <div className="woocommerce-fulfillment-item-actions">
+ <SaveAsDraftButton setError={ setError } />
+ <FulfillItemsButton setError={ setError } />
+ </div>
+ </FulfillmentProvider>
+ </ShipmentFormProvider>
+ </div>
+ ) }
+ </div>
+ );
+};
+
+export default NewFulfillmentForm;
diff --git a/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/fulfillments/test/fulfillment-editor.test.js b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/fulfillments/test/fulfillment-editor.test.js
new file mode 100644
index 0000000000..28d9115fa0
--- /dev/null
+++ b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/fulfillments/test/fulfillment-editor.test.js
@@ -0,0 +1,276 @@
+/**
+ * External dependencies
+ */
+import { render, screen, fireEvent } from '@testing-library/react';
+
+/**
+ * Internal dependencies
+ */
+import '../../../test-helper/global-mock';
+import FulfillmentEditor from '../fulfillment-editor';
+
+jest.mock( '@wordpress/components', () => ( {
+ Button: ( { onClick, children } ) => (
+ <button data-testid="button" onClick={ onClick }>
+ { children }
+ </button>
+ ),
+ Icon: ( { icon } ) => <span data-testid="icon">{ icon }</span>,
+} ) );
+jest.mock(
+ '../../action-buttons/edit-fulfillment-button',
+ () =>
+ ( { onClick } ) =>
+ (
+ <button
+ data-testid="edit-fulfillment-button"
+ onClick={ onClick }
+ >
+ Edit
+ </button>
+ )
+);
+jest.mock( '../../action-buttons/fulfill-items-button', () => () => (
+ <button data-testid="fulfill-items-button">Fulfill items</button>
+) );
+jest.mock( '../../action-buttons/cancel-link', () => ( { onClick } ) => (
+ <button data-testid="cancel-link" onClick={ onClick }>
+ Cancel
+ </button>
+) );
+jest.mock( '../../action-buttons/remove-button', () => () => (
+ <button data-testid="remove-button">Remove</button>
+) );
+jest.mock( '../../action-buttons/update-button', () => () => (
+ <button data-testid="update-button">Update</button>
+) );
+jest.mock( '../item-selector', () => () => (
+ <div data-testid="item-selector" />
+) );
+jest.mock( '../fulfillment-status-badge', () => () => (
+ <div data-testid="fulfillment-status-badge" />
+) );
+jest.mock( '../../customer-notification-form', () => () => (
+ <div data-testid="fulfillment-customer-notification-form" />
+) );
+
+describe( 'FulfillmentEditor', () => {
+ const mockProps = {
+ index: 0,
+ expanded: false,
+ onExpand: jest.fn(),
+ onCollapse: jest.fn(),
+ fulfillment: {
+ id: 1,
+ status: 'unfulfilled',
+ is_fulfilled: false,
+ meta_data: [
+ {
+ id: 1,
+ key: '_items',
+ value: [
+ {
+ item_id: 1,
+ qty: 2,
+ },
+ {
+ item_id: 2,
+ qty: 1,
+ },
+ ],
+ },
+ ],
+ },
+ fulfillments: [
+ {
+ id: 1,
+ status: 'pending',
+ is_fulfilled: false,
+ meta_data: [
+ {
+ id: 1,
+ key: '_items',
+ value: [
+ {
+ item_id: 1,
+ qty: 2,
+ },
+ {
+ item_id: 2,
+ qty: 1,
+ },
+ ],
+ },
+ ],
+ },
+ {
+ id: 2,
+ status: 'unfulfilled',
+ is_fulfilled: false,
+ meta_data: [
+ {
+ id: 1,
+ key: '_items',
+ value: [
+ {
+ item_id: 1,
+ qty: 2,
+ },
+ {
+ item_id: 2,
+ qty: 1,
+ },
+ ],
+ },
+ ],
+ },
+ ],
+ order: {
+ id: 1,
+ currency: 'USD',
+ line_items: [
+ {
+ id: 1,
+ name: 'Item 1',
+ quantity: 2,
+ image: { src: 'example.png' },
+ },
+ {
+ id: 2,
+ name: 'Item 2',
+ quantity: 1,
+ image: { src: 'example.png' },
+ },
+ ],
+ },
+ };
+
+ it( 'renders the header and status badge', () => {
+ render( <FulfillmentEditor { ...mockProps } /> );
+ expect( screen.getByText( 'Fulfillment #1' ) ).toBeInTheDocument();
+ expect(
+ screen.getByTestId( 'fulfillment-status-badge' )
+ ).toBeInTheDocument();
+ } );
+
+ it( 'calls onExpand when header is clicked and not expanded', () => {
+ const { container } = render( <FulfillmentEditor { ...mockProps } /> );
+ fireEvent.click(
+ container.querySelector(
+ '.woocommerce-fulfillment-stored-fulfillment-list-item-header'
+ )
+ );
+ expect( mockProps.onExpand ).toHaveBeenCalled();
+ } );
+
+ it( 'calls onCollapse when header is clicked and expanded', () => {
+ const { container } = render(
+ <FulfillmentEditor { ...mockProps } expanded={ true } />
+ );
+ fireEvent.click(
+ container.querySelector(
+ '.woocommerce-fulfillment-stored-fulfillment-list-item-header'
+ )
+ );
+ expect( mockProps.onCollapse ).toHaveBeenCalled();
+ } );
+ it( 'doesn`t show the buttons when fulfillment is locked - default message', () => {
+ const lockMetadata = [
+ {
+ id: 2,
+ key: '_is_locked',
+ value: true,
+ },
+ ];
+ const lockedProps = {
+ ...mockProps,
+ expanded: true,
+ fulfillment: {
+ ...mockProps.fulfillment,
+ meta_data: [
+ ...mockProps.fulfillment.meta_data,
+ ...lockMetadata,
+ ],
+ },
+ fulfillments: [
+ {
+ ...mockProps.fulfillments[ 0 ],
+ meta_data: [
+ ...mockProps.fulfillments[ 0 ].meta_data,
+ ...lockMetadata,
+ ],
+ },
+ ],
+ };
+ render( <FulfillmentEditor { ...lockedProps } /> );
+ expect(
+ screen.queryByTestId( 'edit-fulfillment-button' )
+ ).not.toBeInTheDocument();
+ expect(
+ screen.queryByTestId( 'fulfill-items-button' )
+ ).not.toBeInTheDocument();
+ expect( screen.queryByTestId( 'cancel-link' ) ).not.toBeInTheDocument();
+ expect(
+ screen.queryByTestId( 'remove-button' )
+ ).not.toBeInTheDocument();
+ expect(
+ screen.queryByTestId( 'update-button' )
+ ).not.toBeInTheDocument();
+ // Check that the lock message is displayed
+ expect(
+ screen.getByText( 'This item is locked and cannot be edited.' )
+ ).toBeInTheDocument();
+ } );
+ it( 'doesn`t show the buttons when fulfillment is locked - custom message', () => {
+ const lockMetadata = [
+ {
+ id: 2,
+ key: '_is_locked',
+ value: true,
+ },
+ {
+ id: 3,
+ key: '_lock_message',
+ value: 'This fulfillment is locked.',
+ },
+ ];
+ const lockedProps = {
+ ...mockProps,
+ expanded: true,
+ fulfillment: {
+ ...mockProps.fulfillment,
+ meta_data: [
+ ...mockProps.fulfillment.meta_data,
+ ...lockMetadata,
+ ],
+ },
+ fulfillments: [
+ {
+ ...mockProps.fulfillments[ 0 ],
+ meta_data: [
+ ...mockProps.fulfillments[ 0 ].meta_data,
+ ...lockMetadata,
+ ],
+ },
+ ],
+ };
+ render( <FulfillmentEditor { ...lockedProps } /> );
+ expect(
+ screen.queryByTestId( 'edit-fulfillment-button' )
+ ).not.toBeInTheDocument();
+ expect(
+ screen.queryByTestId( 'fulfill-items-button' )
+ ).not.toBeInTheDocument();
+ expect( screen.queryByTestId( 'cancel-link' ) ).not.toBeInTheDocument();
+ expect(
+ screen.queryByTestId( 'remove-button' )
+ ).not.toBeInTheDocument();
+ expect(
+ screen.queryByTestId( 'update-button' )
+ ).not.toBeInTheDocument();
+ // Check that the lock message is displayed
+ expect(
+ screen.getByText( 'This fulfillment is locked.' )
+ ).toBeInTheDocument();
+ } );
+} );
diff --git a/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/fulfillments/test/fulfillment-line-item.test.js b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/fulfillments/test/fulfillment-line-item.test.js
new file mode 100644
index 0000000000..aef8b7e710
--- /dev/null
+++ b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/fulfillments/test/fulfillment-line-item.test.js
@@ -0,0 +1,110 @@
+/**
+ * External dependencies
+ */
+import { render, screen, fireEvent } from '@testing-library/react';
+
+/**
+ * Internal dependencies
+ */
+import '../../../test-helper/global-mock';
+import FulfillmentLineItem from '../fulfillment-line-item';
+
+jest.mock( '@wordpress/components', () => ( {
+ CheckboxControl: ( { value, checked, onChange } ) => (
+ <input
+ type="checkbox"
+ data-testid={ `checkbox-${ value }` }
+ checked={ checked }
+ onChange={ ( e ) => onChange( e.target.checked ) }
+ />
+ ),
+ Icon: ( { icon, onClick } ) => (
+ <div
+ role="button"
+ tabIndex={ 0 }
+ data-testid={ `icon-${ icon }` }
+ onClick={ onClick }
+ onKeyUp={ () => {} }
+ ></div>
+ ),
+} ) );
+
+describe( 'FulfillmentLineItem', () => {
+ const mockToggleItem = jest.fn();
+ const mockIsChecked = jest.fn();
+ const mockIsIndeterminate = jest.fn();
+
+ const item = {
+ id: '1',
+ name: 'Test Item',
+ sku: 'SKU123',
+ total: '100',
+ quantity: 1,
+ image: { src: 'image-src' },
+ };
+
+ beforeEach( () => {
+ jest.clearAllMocks();
+ } );
+
+ it( 'renders item details', () => {
+ render(
+ <FulfillmentLineItem
+ item={ item }
+ quantity={ 1 }
+ currency="USD"
+ editMode={ false }
+ toggleItem={ mockToggleItem }
+ isChecked={ mockIsChecked }
+ isIndeterminate={ mockIsIndeterminate }
+ />
+ );
+
+ expect( screen.getByText( 'Test Item' ) ).toBeInTheDocument();
+ expect( screen.getByText( 'SKU123' ) ).toBeInTheDocument();
+ expect( screen.getByAltText( 'Test Item' ) ).toBeInTheDocument();
+ expect( screen.getByText( '$100.00' ) ).toBeInTheDocument();
+ } );
+
+ it( 'renders checkbox in edit mode', () => {
+ mockIsChecked.mockReturnValue( true );
+ render(
+ <FulfillmentLineItem
+ item={ item }
+ quantity={ 1 }
+ currency="USD"
+ editMode={ true }
+ toggleItem={ mockToggleItem }
+ isChecked={ mockIsChecked }
+ isIndeterminate={ mockIsIndeterminate }
+ />
+ );
+
+ const checkbox = screen.getByTestId( 'checkbox-1' );
+ expect( checkbox ).toBeInTheDocument();
+ expect( checkbox ).toBeChecked();
+
+ fireEvent.click( checkbox );
+ expect( mockToggleItem ).toHaveBeenCalledWith( '1', -1, false );
+ } );
+
+ it( 'toggles item expansion when quantity > 1 in edit mode', () => {
+ render(
+ <FulfillmentLineItem
+ item={ item }
+ quantity={ 2 }
+ currency="USD"
+ editMode={ true }
+ toggleItem={ mockToggleItem }
+ isChecked={ mockIsChecked }
+ isIndeterminate={ mockIsIndeterminate }
+ />
+ );
+
+ const icon = screen.getByTestId( 'icon-arrow-down-alt2' );
+ expect( icon ).toBeInTheDocument();
+
+ fireEvent.click( icon );
+ expect( screen.getByText( 'x2' ) ).toBeInTheDocument();
+ } );
+} );
diff --git a/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/fulfillments/test/new-fulfillment-form.test.js b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/fulfillments/test/new-fulfillment-form.test.js
new file mode 100644
index 0000000000..33e9ff2669
--- /dev/null
+++ b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/fulfillments/test/new-fulfillment-form.test.js
@@ -0,0 +1,93 @@
+/**
+ * External dependencies
+ */
+import { render, screen } from '@testing-library/react';
+
+/**
+ * Internal dependencies
+ */
+import '../../../test-helper/global-mock';
+import NewFulfillmentForm from '../new-fulfillment-form';
+import { useFulfillmentDrawerContext } from '../../../context/drawer-context';
+
+jest.mock( '../../../context/drawer-context', () => ( {
+ useFulfillmentDrawerContext: jest.fn(),
+} ) );
+jest.mock( '../../action-buttons/save-draft-button', () => () => (
+ <button data-testid="save-draft-button">Save as Draft</button>
+) );
+jest.mock( '../../action-buttons/fulfill-items-button', () => () => (
+ <button data-testid="fulfill-items-button">Fulfill Items</button>
+) );
+jest.mock( '../item-selector', () => () => (
+ <div data-testid="item-selector" />
+) );
+jest.mock( '../../customer-notification-form', () => () => (
+ <div data-testid="fulfillment-customer-notification-form" />
+) );
+
+jest.mock( '../../../context/fulfillment-context', () => ( {
+ FulfillmentProvider: ( { children } ) => (
+ <div data-testid="fulfillment-provider">{ children }</div>
+ ),
+ useFulfillmentContext: jest.fn( () => ( {
+ order: { id: 1, currency: 'USD', line_items: [] },
+ fulfillment: null,
+ notifyCustomer: true,
+ } ) ),
+} ) );
+
+jest.mock( '../../../utils/order-utils', () => ( {
+ getItemsNotInAnyFulfillment: jest.fn( () => [] ),
+ spreadItems: jest.fn( () => [] ),
+} ) );
+
+describe( 'NewFulfillmentForm', () => {
+ const mockContext = {
+ order: null,
+ fulfillments: [],
+ openSection: 'order',
+ };
+
+ beforeEach( () => {
+ jest.clearAllMocks();
+ useFulfillmentDrawerContext.mockReturnValue( mockContext );
+ } );
+
+ it( 'renders nothing when order is null', () => {
+ mockContext.order = null;
+ const { container } = render( <NewFulfillmentForm /> );
+ expect( container.firstChild ).toBeNull();
+ } );
+
+ it( 'renders nothing when there are no remaining items', () => {
+ mockContext.order = { id: 1, currency: 'USD', line_items: [] };
+ require( '../../../utils/order-utils' ).getItemsNotInAnyFulfillment.mockReturnValue(
+ []
+ );
+ const { container } = render( <NewFulfillmentForm /> );
+ expect( container.firstChild ).toBeNull();
+ } );
+
+ it( 'renders the form when there are remaining items', () => {
+ mockContext.order = { id: 1, currency: 'USD', line_items: [] };
+ require( '../../../utils/order-utils' ).getItemsNotInAnyFulfillment.mockReturnValue(
+ [
+ {
+ id: 1,
+ name: 'Item 1',
+ selection: [ { index: 0, checked: true } ],
+ },
+ ]
+ );
+
+ render( <NewFulfillmentForm /> );
+
+ expect( screen.getByText( 'Order Items' ) ).toBeInTheDocument();
+ expect( screen.getByTestId( 'item-selector' ) ).toBeInTheDocument();
+ expect( screen.getByTestId( 'save-draft-button' ) ).toBeInTheDocument();
+ expect(
+ screen.getByTestId( 'fulfill-items-button' )
+ ).toBeInTheDocument();
+ } );
+} );
diff --git a/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/metadata-viewer/index.tsx b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/metadata-viewer/index.tsx
new file mode 100644
index 0000000000..5c8706162a
--- /dev/null
+++ b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/metadata-viewer/index.tsx
@@ -0,0 +1,45 @@
+/**
+ * External dependencies
+ */
+import { __ } from '@wordpress/i18n';
+
+/**
+ * Internal dependencies
+ */
+import { Fulfillment } from '../../data/types';
+import { PostListIcon } from '../../utils/icons';
+import FulfillmentCard from '../user-interface/fulfillments-card/card';
+import MetaList from '../user-interface/meta-list/meta-list';
+
+interface MetadataViewerProps {
+ fulfillment: Fulfillment;
+}
+
+export default function MetadataViewer( { fulfillment }: MetadataViewerProps ) {
+ const publicMetadata = fulfillment.meta_data.filter(
+ ( meta ) => meta.key.startsWith( '_' ) === false
+ );
+
+ return (
+ <FulfillmentCard
+ isCollapsable={ true }
+ header={
+ <>
+ <PostListIcon />
+ <h3>{ __( 'Fulfillment details', 'woocommerce' ) }</h3>
+ </>
+ }
+ >
+ { publicMetadata.length === 0 && (
+ <p>{ __( 'No metadata available.', 'woocommerce' ) }</p>
+ ) }
+ { publicMetadata.length > 0 && (
+ <MetaList
+ metaList={ publicMetadata.map( ( d ) => {
+ return { label: d.key, value: d.value as string };
+ } ) }
+ />
+ ) }
+ </FulfillmentCard>
+ );
+}
diff --git a/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/metadata-viewer/test/index.test.js b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/metadata-viewer/test/index.test.js
new file mode 100644
index 0000000000..39636a07ab
--- /dev/null
+++ b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/metadata-viewer/test/index.test.js
@@ -0,0 +1,84 @@
+/**
+ * External dependencies
+ */
+import React from 'react';
+import { render, screen } from '@testing-library/react';
+
+/**
+ * Internal dependencies
+ */
+import MetadataViewer from '../index';
+
+// Mock FulfillmentCard wrapper
+jest.mock( '../../user-interface/fulfillments-card/card', () => ( {
+ __esModule: true,
+ default: ( { header, children } ) => (
+ <div data-testid="fulfillment-card">
+ <div data-testid="card-header">{ header }</div>
+ <div data-testid="card-body">{ children }</div>
+ </div>
+ ),
+} ) );
+
+// Mock icon component
+jest.mock( '../../../utils/icons', () => ( {
+ __esModule: true,
+ PostListIcon: () => <span data-testid="post-list-icon" />,
+} ) );
+
+// Mock MetaList component
+jest.mock( '../../user-interface/meta-list/meta-list', () => ( {
+ __esModule: true,
+ default: ( { metaList } ) => (
+ <ul data-testid="meta-list">
+ { metaList.map( ( item, i ) => (
+ <li key={ i }>
+ { item.label }: { item.value }
+ </li>
+ ) ) }
+ </ul>
+ ),
+} ) );
+
+describe( 'MetadataViewer component', () => {
+ it( 'renders header and icon', () => {
+ render(
+ <MetadataViewer
+ fulfillment={ {
+ meta_data: [
+ { key: 'test_key', value: 'test_value' },
+ { key: 'test_key_2', value: 'test_value_2' },
+ { key: 'test_key_3', value: 'test_value_3' },
+ ],
+ } }
+ />
+ );
+ expect( screen.getByTestId( 'card-header' ) ).toHaveTextContent(
+ 'Fulfillment details'
+ );
+ expect( screen.getByTestId( 'post-list-icon' ) ).toBeInTheDocument();
+ } );
+
+ it( 'renders list of metadata items', () => {
+ render(
+ <MetadataViewer
+ fulfillment={ {
+ meta_data: [
+ { key: 'test_key', value: 'test_value' },
+ { key: 'test_key_2', value: 'test_value_2' },
+ { key: 'test_key_3', value: 'test_value_3' },
+ ],
+ } }
+ />
+ );
+ const list = screen.getByTestId( 'meta-list' );
+ expect( list ).toBeInTheDocument();
+ expect( screen.getAllByRole( 'listitem' ) ).toHaveLength( 3 );
+ } );
+ it( 'renders empty state when no metadata', () => {
+ render( <MetadataViewer fulfillment={ { meta_data: [] } } /> );
+ expect(
+ screen.getByText( /No metadata available/ )
+ ).toBeInTheDocument();
+ } );
+} );
diff --git a/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/shipment-form/index.tsx b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/shipment-form/index.tsx
new file mode 100644
index 0000000000..1807df2522
--- /dev/null
+++ b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/shipment-form/index.tsx
@@ -0,0 +1,94 @@
+/**
+ * External dependencies
+ */
+import { __ } from '@wordpress/i18n';
+import { CheckboxControl } from '@wordpress/components';
+
+/**
+ * Internal dependencies
+ */
+import ShipmentTrackingNumberForm from './shipment-tracking-number-form';
+import ShipmentManualEntryForm from './shipment-manual-entry-form';
+import { TruckIcon } from '../../utils/icons';
+import FulfillmentCard from '../user-interface/fulfillments-card/card';
+import './style.scss';
+import {
+ SHIPMENT_OPTION_MANUAL_ENTRY,
+ SHIPMENT_OPTION_NO_INFO,
+ SHIPMENT_OPTION_TRACKING_NUMBER,
+} from '../../data/constants';
+import { useShipmentFormContext } from '../../context/shipment-form-context';
+
+export default function ShipmentForm() {
+ const { selectedOption, setSelectedOption } = useShipmentFormContext();
+ const randomRadioGroupName =
+ 'radio-group-' + String( Math.floor( Math.random() * 1000000 ) );
+
+ return (
+ <FulfillmentCard
+ isCollapsable={ false }
+ initialState="expanded"
+ header={
+ <>
+ <TruckIcon />
+ <h3>{ __( 'Shipment Information', 'woocommerce' ) }</h3>
+ </>
+ }
+ >
+ <div className="woocommerce-fulfillment-shipment-information-options">
+ <div className="woocommerce-fulfillment-shipment-information-option-tracking-number">
+ <CheckboxControl
+ type="radio"
+ name={ randomRadioGroupName }
+ value={ SHIPMENT_OPTION_TRACKING_NUMBER }
+ checked={
+ selectedOption === SHIPMENT_OPTION_TRACKING_NUMBER
+ }
+ onChange={ ( value ) =>
+ value &&
+ setSelectedOption( SHIPMENT_OPTION_TRACKING_NUMBER )
+ }
+ label={ __( 'Tracking Number', 'woocommerce' ) }
+ __nextHasNoMarginBottom
+ />
+ { selectedOption === SHIPMENT_OPTION_TRACKING_NUMBER && (
+ <ShipmentTrackingNumberForm />
+ ) }
+ </div>
+ <div className="woocommerce-fulfillment-shipment-information-option-manual-entry">
+ <CheckboxControl
+ type="radio"
+ name={ randomRadioGroupName }
+ value={ SHIPMENT_OPTION_MANUAL_ENTRY }
+ checked={
+ selectedOption === SHIPMENT_OPTION_MANUAL_ENTRY
+ }
+ onChange={ ( value ) =>
+ value &&
+ setSelectedOption( SHIPMENT_OPTION_MANUAL_ENTRY )
+ }
+ label={ __( 'Enter manually', 'woocommerce' ) }
+ __nextHasNoMarginBottom
+ />
+ { selectedOption === SHIPMENT_OPTION_MANUAL_ENTRY && (
+ <ShipmentManualEntryForm />
+ ) }
+ </div>
+ <div className="woocommerce-fulfillment-shipment-information-option-no-info">
+ <CheckboxControl
+ type="radio"
+ name={ randomRadioGroupName }
+ value={ SHIPMENT_OPTION_NO_INFO }
+ checked={ selectedOption === SHIPMENT_OPTION_NO_INFO }
+ onChange={ ( value ) =>
+ value &&
+ setSelectedOption( SHIPMENT_OPTION_NO_INFO )
+ }
+ label={ __( 'No shipment information', 'woocommerce' ) }
+ __nextHasNoMarginBottom
+ />
+ </div>
+ </div>
+ </FulfillmentCard>
+ );
+}
diff --git a/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/shipment-form/shipment-manual-entry-form.tsx b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/shipment-form/shipment-manual-entry-form.tsx
new file mode 100644
index 0000000000..7385d2ddaa
--- /dev/null
+++ b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/shipment-form/shipment-manual-entry-form.tsx
@@ -0,0 +1,138 @@
+/**
+ * External dependencies
+ */
+import { ComboboxControl, TextControl } from '@wordpress/components';
+import { ComboboxControlOption } from '@wordpress/components/build-types/combobox-control/types';
+import { __ } from '@wordpress/i18n';
+
+/**
+ * Internal dependencies
+ */
+import { useShipmentFormContext } from '../../context/shipment-form-context';
+import ShipmentProviders from '../../data/shipment-providers';
+import { SearchIcon } from '../../utils/icons';
+
+const ShippingProviderListItem = ( {
+ item,
+}: {
+ item: ComboboxControlOption;
+} ) => {
+ return (
+ <div
+ className={ [
+ 'woocommerce-fulfillment-shipping-provider-list-item',
+ 'woocommerce-fulfillment-shipping-provider-list-item-' +
+ item.value,
+ ].join( ' ' ) }
+ >
+ { item.icon && (
+ <div className="woocommerce-fulfillment-shipping-provider-list-item-icon">
+ <img src={ item.icon } alt={ item.label } />
+ </div>
+ ) }
+ <div className="woocommerce-fulfillment-shipping-provider-list-item-label">
+ { item.label }
+ </div>
+ </div>
+ );
+};
+
+export default function ShipmentManualEntryForm() {
+ const {
+ trackingNumber,
+ setTrackingNumber,
+ shipmentProvider,
+ setShipmentProvider,
+ providerName,
+ setProviderName,
+ trackingUrl,
+ setTrackingUrl,
+ } = useShipmentFormContext();
+ return (
+ <>
+ <p className="woocommerce-fulfillment-description">
+ { __(
+ 'Provide the shipment information for this fulfillment.',
+ 'woocommerce'
+ ) }
+ </p>
+ <div className="woocommerce-fulfillment-input-container">
+ <div className="woocommerce-fulfillment-input-group">
+ <TextControl
+ label={ __( 'Tracking Number', 'woocommerce' ) }
+ type="text"
+ placeholder={ __(
+ 'Enter tracking number',
+ 'woocommerce'
+ ) }
+ value={ trackingNumber }
+ onChange={ ( value: string ) => {
+ setTrackingNumber( value );
+ } }
+ __next40pxDefaultSize
+ __nextHasNoMarginBottom
+ />
+ </div>
+ </div>
+ <div className="woocommerce-fulfillment-input-container">
+ <div className="woocommerce-fulfillment-input-group">
+ <ComboboxControl
+ label={ __( 'Provider', 'woocommerce' ) }
+ __experimentalRenderItem={ ( { item } ) => (
+ <ShippingProviderListItem item={ item } />
+ ) }
+ allowReset={ false }
+ __next40pxDefaultSize
+ value={ shipmentProvider }
+ options={ ShipmentProviders }
+ onChange={ ( value ) => {
+ setShipmentProvider( value as string );
+ } }
+ __nextHasNoMarginBottom
+ />
+ <div className="woocommerce-fulfillment-shipment-provider-search-icon">
+ <SearchIcon />
+ </div>
+ </div>
+ </div>
+ { shipmentProvider === 'other' && (
+ <div className="woocommerce-fulfillment-input-container">
+ <div className="woocommerce-fulfillment-input-group">
+ <TextControl
+ label={ __( 'Provider Name', 'woocommerce' ) }
+ type="text"
+ placeholder={ __(
+ 'Enter provider name',
+ 'woocommerce'
+ ) }
+ value={ providerName }
+ onChange={ ( value: string ) => {
+ setProviderName( value );
+ } }
+ __next40pxDefaultSize
+ __nextHasNoMarginBottom
+ />
+ </div>
+ </div>
+ ) }
+ <div className="woocommerce-fulfillment-input-container">
+ <div className="woocommerce-fulfillment-input-group">
+ <TextControl
+ label={ __( 'Tracking URL', 'woocommerce' ) }
+ type="text"
+ placeholder={ __(
+ 'Enter tracking URL',
+ 'woocommerce'
+ ) }
+ value={ trackingUrl }
+ onChange={ ( value: string ) => {
+ setTrackingUrl( value );
+ } }
+ __next40pxDefaultSize
+ __nextHasNoMarginBottom
+ />
+ </div>
+ </div>
+ </>
+ );
+}
diff --git a/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/shipment-form/shipment-tracking-number-form.tsx b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/shipment-form/shipment-tracking-number-form.tsx
new file mode 100644
index 0000000000..df663ef9c5
--- /dev/null
+++ b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/shipment-form/shipment-tracking-number-form.tsx
@@ -0,0 +1,221 @@
+/**
+ * External dependencies
+ */
+
+import { Button, ExternalLink, TextControl } from '@wordpress/components';
+import { __ } from '@wordpress/i18n';
+import { useEffect, useState } from 'react';
+import { isEmpty } from 'lodash';
+import apiFetch from '@wordpress/api-fetch';
+
+/**
+ * Internal dependencies
+ */
+import { useShipmentFormContext } from '../../context/shipment-form-context';
+import ErrorLabel from '../user-interface/error-label';
+import { EditIcon } from '../../utils/icons';
+import { findShipmentProviderName } from '../../utils/fulfillment-utils';
+import ShipmentProviders from '../../data/shipment-providers';
+import { useFulfillmentContext } from '../../context/fulfillment-context';
+
+interface TrackingNumberParsingResponse {
+ tracking_number_details: {
+ tracking_number: string;
+ tracking_url: string;
+ shipping_provider: string;
+ };
+}
+
+const ShipmentProviderIcon = ( { providerKey }: { providerKey: string } ) => {
+ const provider = ShipmentProviders.find( ( p ) => p.value === providerKey );
+ const icon = provider?.icon;
+ if ( ! provider || ! icon ) {
+ return null;
+ }
+
+ return (
+ <div className="woocommerce-fulfillment-shipment-provider-icon">
+ <img src={ icon } alt={ provider.label } key={ providerKey } />
+ </div>
+ );
+};
+
+export default function ShipmentTrackingNumberForm() {
+ const [ trackingNumberTemp, setTrackingNumberTemp ] = useState( '' );
+ const [ error, setError ] = useState< string | null >( null );
+ const [ editMode, setEditMode ] = useState( false );
+ const [ isLoading, setIsLoading ] = useState( false );
+ const { order } = useFulfillmentContext();
+ const {
+ trackingNumber,
+ setTrackingNumber,
+ trackingUrl,
+ setTrackingUrl,
+ setProviderName,
+ shipmentProvider,
+ setShipmentProvider,
+ } = useShipmentFormContext();
+
+ // Reset error when order changes
+ useEffect( () => {
+ setError( null );
+ }, [ order?.id ] );
+
+ const handleTrackingNumberLookup = async () => {
+ setError( null );
+ try {
+ setIsLoading( true );
+ const { tracking_number_details } =
+ await apiFetch< TrackingNumberParsingResponse >( {
+ path: `/wc/v3/orders/${ order?.id }/fulfillments/lookup?tracking_number=${ trackingNumberTemp }`,
+ method: 'GET',
+ } );
+ if ( ! tracking_number_details.tracking_number ) {
+ setError(
+ __(
+ 'No information found for this tracking number. Check the number or enter the details manually.',
+ 'woocommerce'
+ )
+ );
+ return;
+ }
+ setTrackingNumber( tracking_number_details.tracking_number );
+ setTrackingUrl( tracking_number_details.tracking_url );
+ setShipmentProvider( tracking_number_details.shipping_provider );
+ setProviderName( '' );
+ setEditMode( false );
+ } catch ( err ) {
+ setError(
+ __( 'Failed to fetch shipment information.', 'woocommerce' )
+ );
+ } finally {
+ setIsLoading( false );
+ }
+ };
+
+ useEffect( () => {
+ if ( isEmpty( trackingNumber ) ) {
+ setEditMode( true );
+ }
+ }, [ trackingNumber ] );
+
+ return (
+ <>
+ <p className="woocommerce-fulfillment-description">
+ { __(
+ 'Provide the shipment tracking number to find the shipment provider and tracking URL.',
+ 'woocommerce'
+ ) }
+ </p>
+ { editMode ? (
+ <div className="woocommerce-fulfillment-input-container">
+ <div className="woocommerce-fulfillment-input-group">
+ <TextControl
+ type="text"
+ label={ __( 'Tracking Number', 'woocommerce' ) }
+ placeholder={ __(
+ 'Enter tracking number',
+ 'woocommerce'
+ ) }
+ value={ trackingNumberTemp }
+ onChange={ ( value ) => {
+ setTrackingNumberTemp( value );
+ } }
+ onKeyDown={ ( event ) => {
+ if (
+ event.key === 'Enter' &&
+ ! isLoading &&
+ ! isEmpty( trackingNumberTemp.trim() )
+ ) {
+ handleTrackingNumberLookup();
+ }
+ } }
+ __next40pxDefaultSize
+ __nextHasNoMarginBottom
+ />
+ <Button
+ variant="secondary"
+ text="Find info"
+ disabled={
+ isLoading ||
+ isEmpty( trackingNumberTemp.trim() )
+ }
+ isBusy={ isLoading }
+ onClick={ handleTrackingNumberLookup }
+ __next40pxDefaultSize
+ />
+ </div>
+ </div>
+ ) : (
+ <>
+ <div className="woocommerce-fulfillment-input-container">
+ <h4>{ __( 'Tracking Number', 'woocommerce' ) }</h4>
+ <div className="woocommerce-fulfillment-input-group space-between">
+ <span
+ onClick={ () => {
+ setEditMode( true );
+ setTrackingNumberTemp( trackingNumber );
+ } }
+ role="button"
+ tabIndex={ 0 }
+ onKeyDown={ ( event ) => {
+ if (
+ event.key === 'Enter' ||
+ event.key === ' '
+ ) {
+ setEditMode( true );
+ setTrackingNumberTemp( trackingNumber );
+ }
+ } }
+ style={ { cursor: 'pointer' } }
+ >
+ { trackingNumber }
+ </span>
+ <Button
+ size="small"
+ onClick={ () => {
+ setEditMode( true );
+ setTrackingNumberTemp( trackingNumber );
+ } }
+ >
+ <EditIcon />
+ </Button>
+ </div>
+ </div>
+ <div className="woocommerce-fulfillment-input-container">
+ <h4>{ __( 'Provider', 'woocommerce' ) }</h4>
+ <div className="woocommerce-fulfillment-input-group">
+ <div>
+ <ShipmentProviderIcon
+ providerKey={ shipmentProvider }
+ />
+ <span>
+ { findShipmentProviderName(
+ shipmentProvider
+ ) }
+ </span>
+ </div>
+ </div>
+ </div>
+ <div className="woocommerce-fulfillment-input-container">
+ <h4>{ __( 'Tracking URL', 'woocommerce' ) }</h4>
+ <div className="woocommerce-fulfillment-input-group">
+ <ExternalLink
+ href={ trackingUrl }
+ style={ {
+ width: '100%',
+ textOverflow: 'ellipsis',
+ whiteSpace: 'nowrap',
+ overflow: 'hidden',
+ } }
+ >
+ { trackingUrl }
+ </ExternalLink>
+ </div>
+ </div>
+ </>
+ ) }
+ { error && <ErrorLabel error={ error } /> }
+ </>
+ );
+}
diff --git a/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/shipment-form/shipment-viewer.tsx b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/shipment-form/shipment-viewer.tsx
new file mode 100644
index 0000000000..7f66a836df
--- /dev/null
+++ b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/shipment-form/shipment-viewer.tsx
@@ -0,0 +1,101 @@
+/**
+ * External dependencies
+ */
+import { __ } from '@wordpress/i18n';
+
+/**
+ * Internal dependencies
+ */
+import { useShipmentFormContext } from '../../context/shipment-form-context';
+import ShipmentProviders from '../../data/shipment-providers';
+import { CopyIcon, TruckIcon } from '../../utils/icons';
+import FulfillmentCard from '../user-interface/fulfillments-card/card';
+import MetaList from '../user-interface/meta-list/meta-list';
+import { findShipmentProviderName } from '../../utils/fulfillment-utils';
+import { SHIPMENT_OPTION_NO_INFO } from '../../data/constants';
+
+export default function ShipmentViewer() {
+ const {
+ shipmentProvider,
+ providerName,
+ trackingNumber,
+ trackingUrl,
+ selectedOption,
+ } = useShipmentFormContext();
+ const isShipmentInformationProvided =
+ selectedOption !== SHIPMENT_OPTION_NO_INFO &&
+ trackingNumber.trim() !== '';
+
+ const shipmentProviderObject =
+ shipmentProvider !== 'other'
+ ? ShipmentProviders.find( ( p ) => p.value === shipmentProvider )
+ : null;
+
+ const getShipmentProviderLabel = (
+ savedProvider: string,
+ savedProviderName: string
+ ) => {
+ if ( savedProvider === 'other' ) {
+ return savedProviderName;
+ }
+ return (
+ findShipmentProviderName( savedProvider ) ||
+ savedProviderName ||
+ __( 'Unknown', 'woocommerce' )
+ );
+ };
+
+ return (
+ <FulfillmentCard
+ isCollapsable={ isShipmentInformationProvided }
+ initialState="collapsed"
+ header={
+ isShipmentInformationProvided ? (
+ <>
+ { shipmentProviderObject ? (
+ <img
+ src={ shipmentProviderObject.icon || '' }
+ alt={ shipmentProviderObject.label || '' }
+ />
+ ) : (
+ <TruckIcon />
+ ) }
+ <h3>
+ { trackingNumber }{ ' ' }
+ <CopyIcon copyText={ trackingNumber } />
+ </h3>
+ </>
+ ) : (
+ <>
+ <TruckIcon />
+ <h3>
+ { __( 'No shipment information', 'woocommerce' ) }
+ </h3>
+ </>
+ )
+ }
+ >
+ { isShipmentInformationProvided && (
+ <MetaList
+ metaList={ [
+ {
+ label: __( 'Tracking number', 'woocommerce' ),
+ value: trackingNumber,
+ },
+ {
+ label: __( 'Provider name', 'woocommerce' ),
+ value: getShipmentProviderLabel(
+ shipmentProvider,
+ providerName
+ ),
+ },
+ {
+ label: __( 'Tracking URL', 'woocommerce' ),
+ value: trackingUrl,
+ },
+ ] }
+ />
+ ) }
+ </FulfillmentCard>
+ );
+}
diff --git a/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/shipment-form/style.scss b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/shipment-form/style.scss
new file mode 100644
index 0000000000..410b0bd6b8
--- /dev/null
+++ b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/shipment-form/style.scss
@@ -0,0 +1,156 @@
+.woocommerce-fulfillment-shipment-information-options {
+ width: 100%;
+ .woocommerce-fulfillment-shipment-information-option-tracking-number,
+ .woocommerce-fulfillment-shipment-information-option-manual-entry,
+ .woocommerce-fulfillment-shipment-information-option-no-info {
+ display: flex;
+ flex-direction: column;
+ padding: 20px 0;
+ gap: 16px;
+ width: 100%;
+ justify-content: flex-start;
+ border-bottom: 1px solid #e0e0e0;
+ .components-checkbox-control {
+ width: 100%;
+ svg {
+ display: none;
+ }
+ }
+ }
+
+ .woocommerce-fulfillment-shipment-information-option-tracking-number {
+ padding: 12px 0 20px 0;
+ }
+
+ .woocommerce-fulfillment-shipment-information-option-no-info {
+ border-bottom: 0;
+ padding: 20px 0 12px 0;
+ }
+
+ .woocommerce-fulfillment-input-container {
+ display: flex;
+ flex-direction: column;
+ gap: 8px;
+ width: 100%;
+
+ h4 {
+ font-size: 11px;
+ line-height: 16px;
+ font-weight: 500;
+ color: #1e1e1e;
+ margin: 0;
+ text-transform: uppercase;
+ }
+
+ .woocommerce-fulfillment-input-group {
+ display: flex;
+ flex-direction: row;
+ gap: 12px;
+ width: 100%;
+ align-items: flex-end;
+ justify-content: flex-start;
+ position: relative;
+
+ & > div {
+ flex: 1;
+ }
+
+ &.space-between {
+ justify-content: space-between;
+ }
+
+ .woocommerce-fulfillment-shipment-provider-search-icon {
+ position: absolute;
+ right: 14px;
+ top: 36px;
+ }
+
+ .woocommerce-fulfillment-shipment-provider-icon {
+ width: 16px;
+ height: 16px;
+ display: flex;
+ align-items: center;
+ justify-content: center;
+ float: left;
+ margin-right: 8px;
+
+ img {
+ height: 16px;
+ }
+ }
+
+ .components-base-control {
+ flex: 1;
+ .components-base-control__field {
+ margin: 0;
+ }
+ }
+
+ .woocommerce-fulfillment-input {
+ width: 100%;
+ border-radius: 2px;
+ border: 1px solid #ddd;
+ padding: 4px 8px;
+ font-size: 13px;
+ line-height: 20px;
+ color: #1e1e1e;
+
+ &::placeholder {
+ color: var(--wc-admin-subtext, #767676);
+ font-size: 11px;
+ line-height: 16px;
+ font-weight: 400;
+ }
+ }
+ .components-combobox-control__suggestions-container {
+ .components-form-token-field__suggestions-list {
+ max-height: 180px;
+ li {
+ padding: 0 16px;
+ background-color: var(--wc-content-bg, #fff);
+ &:hover,
+ &.is-selected {
+ background-color: var(--wp-admin-theme-color, #3858e9);
+ }
+
+ .woocommerce-fulfillment-shipping-provider-list-item {
+ display: flex;
+ flex-direction: row;
+ gap: 8px;
+ align-items: center;
+ justify-content: flex-start;
+ padding: 8px 0;
+
+ &.woocommerce-fulfillment-shipping-provider-list-item-other {
+ border-top: 1px solid #e0e0e0;
+ }
+
+ .woocommerce-fulfillment-shipping-provider-list-item-icon {
+ width: 24px;
+ height: 24px;
+ display: flex;
+ align-items: center;
+ justify-content: center;
+
+ img {
+ width: 16px;
+ height: 16px;
+ }
+ }
+ .woocommerce-fulfillment-shipping-provider-list-item-label {
+ flex: 1;
+ font-size: 13px;
+ line-height: 20px;
+ font-weight: 400;
+ }
+ }
+ &:has(.woocommerce-fulfillment-shipping-provider-list-item-other) {
+ position: sticky;
+ bottom: 0;
+ }
+ }
+ }
+ }
+ }
+ }
+}
diff --git a/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/shipment-form/test/index.test.js b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/shipment-form/test/index.test.js
new file mode 100644
index 0000000000..a542ffdc87
--- /dev/null
+++ b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/shipment-form/test/index.test.js
@@ -0,0 +1,104 @@
+/**
+ * External dependencies
+ */
+import { render, screen, fireEvent } from '@testing-library/react';
+
+/**
+ * Internal dependencies
+ */
+import ShipmentForm from '../../shipment-form';
+import { useShipmentFormContext } from '../../../context/shipment-form-context';
+import {
+ SHIPMENT_OPTION_MANUAL_ENTRY,
+ SHIPMENT_OPTION_NO_INFO,
+ SHIPMENT_OPTION_TRACKING_NUMBER,
+} from '../../../data/constants';
+
+// 🔁 Mock dependent components
+jest.mock( '../shipment-tracking-number-form', () => () => (
+ <div data-testid="tracking-form" />
+) );
+jest.mock( '../shipment-manual-entry-form', () => () => (
+ <div data-testid="manual-form" />
+) );
+jest.mock( '../../../utils/icons', () => ( {
+ TruckIcon: () => <div data-testid="truck-icon" />,
+} ) );
+
+// 🧪 Mock context
+const mockSetSelectedOption = jest.fn();
+
+jest.mock( '../../../context/shipment-form-context', () => ( {
+ useShipmentFormContext: jest.fn(),
+} ) );
+
+beforeEach( () => {
+ jest.clearAllMocks();
+} );
+
+function setup( selectedOption ) {
+ useShipmentFormContext.mockReturnValue( {
+ selectedOption,
+ setSelectedOption: mockSetSelectedOption,
+ } );
+
+ render( <ShipmentForm /> );
+}
+
+describe( '<ShipmentForm />', () => {
+ it( 'renders all shipment option radios', () => {
+ setup();
+
+ expect(
+ screen.getByLabelText( 'Tracking Number' )
+ ).toBeInTheDocument();
+ expect( screen.getByLabelText( 'Enter manually' ) ).toBeInTheDocument();
+ expect(
+ screen.getByLabelText( 'No shipment information' )
+ ).toBeInTheDocument();
+ } );
+
+ it( 'shows tracking number form when selected', () => {
+ setup( SHIPMENT_OPTION_TRACKING_NUMBER );
+
+ expect( screen.getByTestId( 'tracking-form' ) ).toBeInTheDocument();
+ expect( screen.queryByTestId( 'manual-form' ) ).not.toBeInTheDocument();
+ } );
+
+ it( 'shows manual entry form when selected', () => {
+ setup( SHIPMENT_OPTION_MANUAL_ENTRY );
+
+ expect( screen.getByTestId( 'manual-form' ) ).toBeInTheDocument();
+ expect(
+ screen.queryByTestId( 'tracking-form' )
+ ).not.toBeInTheDocument();
+ } );
+
+ it( 'does not show any form when no info is selected', () => {
+ setup( SHIPMENT_OPTION_NO_INFO );
+
+ expect(
+ screen.queryByTestId( 'tracking-form' )
+ ).not.toBeInTheDocument();
+ expect( screen.queryByTestId( 'manual-form' ) ).not.toBeInTheDocument();
+ } );
+
+ it( 'calls setSelectedOption when a different radio is selected', async () => {
+ setup( '' );
+
+ fireEvent.click( screen.getByLabelText( 'Tracking Number' ) );
+ expect( mockSetSelectedOption ).toHaveBeenCalledWith(
+ SHIPMENT_OPTION_TRACKING_NUMBER
+ );
+
+ fireEvent.click( screen.getByLabelText( 'Enter manually' ) );
+ expect( mockSetSelectedOption ).toHaveBeenCalledWith(
+ SHIPMENT_OPTION_MANUAL_ENTRY
+ );
+
+ fireEvent.click( screen.getByLabelText( 'No shipment information' ) );
+ expect( mockSetSelectedOption ).toHaveBeenCalledWith(
+ SHIPMENT_OPTION_NO_INFO
+ );
+ } );
+} );
diff --git a/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/shipment-form/test/shipment-manual-entry-form.test.js b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/shipment-form/test/shipment-manual-entry-form.test.js
new file mode 100644
index 0000000000..7afce4b677
--- /dev/null
+++ b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/shipment-form/test/shipment-manual-entry-form.test.js
@@ -0,0 +1,116 @@
+/**
+ * External dependencies
+ */
+import { render, screen, fireEvent } from '@testing-library/react';
+
+/**
+ * Internal dependencies
+ */
+import '../../../test-helper/global-mock';
+import ShipmentManualEntryForm from '../shipment-manual-entry-form';
+import { useShipmentFormContext } from '../../../context/shipment-form-context';
+
+jest.mock( '../../../context/shipment-form-context', () => ( {
+ useShipmentFormContext: jest.fn(),
+} ) );
+
+jest.mock( '../../../utils/icons', () => ( {
+ SearchIcon: () => <span data-testid="search-icon" />,
+} ) );
+
+jest.mock( '@wordpress/components', () => ( {
+ ...jest.requireActual( '@wordpress/components' ),
+ ComboboxControl: ( { value, onChange, options } ) => (
+ <div data-testid="combobox-control">
+ <select
+ value={ value }
+ onChange={ ( e ) => onChange( e.target.value ) }
+ >
+ { options.map( ( option ) => (
+ <option key={ option.value } value={ option.value }>
+ { option.label }
+ </option>
+ ) ) }
+ </select>
+ </div>
+ ),
+} ) );
+
+describe( 'ShipmentManualEntryForm', () => {
+ const mockContext = {
+ trackingNumber: '',
+ setTrackingNumber: jest.fn(),
+ shipmentProvider: '',
+ setShipmentProvider: jest.fn(),
+ providerName: '',
+ setProviderName: jest.fn(),
+ trackingUrl: '',
+ setTrackingUrl: jest.fn(),
+ };
+
+ beforeEach( () => {
+ jest.clearAllMocks();
+ useShipmentFormContext.mockReturnValue( mockContext );
+ } );
+
+ it( 'renders tracking number input', () => {
+ render( <ShipmentManualEntryForm /> );
+ expect(
+ screen.getByPlaceholderText( 'Enter tracking number' )
+ ).toBeInTheDocument();
+ } );
+
+ it( 'renders provider combobox and search icon', () => {
+ render( <ShipmentManualEntryForm /> );
+ expect( screen.getByRole( 'combobox' ) ).toBeInTheDocument();
+ expect( screen.getByTestId( 'search-icon' ) ).toBeInTheDocument();
+ } );
+
+ it( 'renders provider name input when provider is set to other', () => {
+ mockContext.shipmentProvider = 'other';
+ render( <ShipmentManualEntryForm /> );
+ expect(
+ screen.getByPlaceholderText( 'Enter provider name' )
+ ).toBeInTheDocument();
+ } );
+
+ it( 'renders tracking URL input', () => {
+ render( <ShipmentManualEntryForm /> );
+ expect(
+ screen.getByPlaceholderText( 'Enter tracking URL' )
+ ).toBeInTheDocument();
+ } );
+
+ it( 'calls setTrackingNumber on input change', () => {
+ render( <ShipmentManualEntryForm /> );
+ const input = screen.getByPlaceholderText( 'Enter tracking number' );
+ fireEvent.change( input, { target: { value: '12345' } } );
+ expect( mockContext.setTrackingNumber ).toHaveBeenCalledWith( '12345' );
+ } );
+
+ it( 'calls setShipmentProvider on combobox change', () => {
+ render( <ShipmentManualEntryForm /> );
+ const combobox = screen.getByRole( 'combobox' );
+ fireEvent.change( combobox, { target: { value: 'dhl' } } );
+ expect( mockContext.setShipmentProvider ).toHaveBeenCalledWith( 'dhl' );
+ } );
+
+ it( 'calls setProviderName on provider name input change', () => {
+ mockContext.shipmentProvider = 'other';
+ render( <ShipmentManualEntryForm /> );
+ const input = screen.getByPlaceholderText( 'Enter provider name' );
+ fireEvent.change( input, { target: { value: 'Custom Provider' } } );
+ expect( mockContext.setProviderName ).toHaveBeenCalledWith(
+ 'Custom Provider'
+ );
+ } );
+
+ it( 'calls setTrackingUrl on tracking URL input change', () => {
+ render( <ShipmentManualEntryForm /> );
+ const input = screen.getByPlaceholderText( 'Enter tracking URL' );
+ fireEvent.change( input, { target: { value: 'http://example.com' } } );
+ expect( mockContext.setTrackingUrl ).toHaveBeenCalledWith(
+ 'http://example.com'
+ );
+ } );
+} );
diff --git a/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/shipment-form/test/shipment-tracking-number-form.test.js b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/shipment-form/test/shipment-tracking-number-form.test.js
new file mode 100644
index 0000000000..9d7b8b3cbd
--- /dev/null
+++ b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/shipment-form/test/shipment-tracking-number-form.test.js
@@ -0,0 +1,181 @@
+/**
+ * External dependencies
+ */
+import { render, screen, fireEvent, waitFor } from '@testing-library/react';
+import apiFetch from '@wordpress/api-fetch';
+
+/**
+ * Internal dependencies
+ */
+import '../../../test-helper/global-mock';
+import ShipmentTrackingNumberForm from '../shipment-tracking-number-form';
+import { useShipmentFormContext } from '../../../context/shipment-form-context';
+
+jest.mock( '../../../context/shipment-form-context', () => ( {
+ useShipmentFormContext: jest.fn(),
+} ) );
+
+jest.mock( '../../../utils/icons', () => ( {
+ EditIcon: () => <span data-testid="edit-icon" />,
+} ) );
+
+jest.mock( '@wordpress/api-fetch' );
+
+jest.mock( '@wordpress/components', () => ( {
+ ...jest.requireActual( '@wordpress/components' ),
+ TextControl: ( { value, onChange, placeholder, onKeyDown } ) => (
+ <div data-testid="text-control">
+ <input
+ type="text"
+ value={ value }
+ placeholder={ placeholder }
+ onChange={ ( e ) => onChange( e.target.value ) }
+ onKeyDown={ onKeyDown }
+ />
+ </div>
+ ),
+} ) );
+
+describe( 'ShipmentTrackingNumberForm', () => {
+ const mockContext = {
+ trackingNumber: '',
+ setTrackingNumber: jest.fn(),
+ shipmentProvider: '',
+ setShipmentProvider: jest.fn(),
+ trackingUrl: '',
+ setTrackingUrl: jest.fn(),
+ providerName: '',
+ setProviderName: jest.fn(),
+ };
+
+ beforeEach( () => {
+ jest.clearAllMocks();
+ useShipmentFormContext.mockReturnValue( mockContext );
+ } );
+
+ it( 'renders tracking number input in edit mode', () => {
+ render( <ShipmentTrackingNumberForm /> );
+ expect(
+ screen.getByPlaceholderText( 'Enter tracking number' )
+ ).toBeInTheDocument();
+ expect( screen.getByText( 'Find info' ) ).toBeInTheDocument();
+ } );
+
+ it( 'renders tracking number and provider in view mode', () => {
+ mockContext.trackingNumber = '1Z12345E0291980793';
+ mockContext.shipmentProvider = 'ups';
+ render( <ShipmentTrackingNumberForm /> );
+ expect( screen.getByText( '1Z12345E0291980793' ) ).toBeInTheDocument();
+ expect( screen.getByText( 'UPS' ) ).toBeInTheDocument();
+ expect( screen.getByTestId( 'edit-icon' ) ).toBeInTheDocument();
+ } );
+
+ it( 'calls setTrackingNumber and switches to view mode on valid lookup', async () => {
+ mockContext.trackingNumber = '';
+ mockContext.shipmentProvider = '';
+ apiFetch.mockResolvedValueOnce( {
+ tracking_number_details: {
+ tracking_number: '1Z12345E0291980793',
+ shipping_provider: 'ups',
+ tracking_url:
+ 'https://www.ups.com/track?tracknum=1Z12345E0291980793',
+ },
+ } );
+ render( <ShipmentTrackingNumberForm /> );
+ const input = screen.getByPlaceholderText( 'Enter tracking number' );
+ fireEvent.change( input, { target: { value: '1Z12345E0291980793' } } );
+ fireEvent.click( screen.getByText( 'Find info' ) );
+
+ await waitFor( () => {
+ expect( mockContext.setTrackingNumber ).toHaveBeenCalledWith(
+ '1Z12345E0291980793'
+ );
+ } );
+ await expect( mockContext.setShipmentProvider ).toHaveBeenCalledWith(
+ 'ups'
+ );
+ await expect( mockContext.setTrackingUrl ).toHaveBeenCalledWith(
+ 'https://www.ups.com/track?tracknum=1Z12345E0291980793'
+ );
+ await expect(
+ screen.queryByPlaceholderText( 'Enter tracking number' )
+ ).not.toBeInTheDocument();
+ } );
+
+ it( 'shows error message on invalid lookup', async () => {
+ mockContext.trackingNumber = '';
+ mockContext.shipmentProvider = '';
+ apiFetch.mockResolvedValueOnce( { tracking_number_details: [] } );
+ render( <ShipmentTrackingNumberForm /> );
+ const input = screen.getByPlaceholderText( 'Enter tracking number' );
+ fireEvent.change( input, { target: { value: 'invalid' } } );
+ fireEvent.click( screen.getByText( 'Find info' ) );
+ await waitFor( () => {
+ expect(
+ screen.getByText(
+ 'No information found for this tracking number. Check the number or enter the details manually.'
+ )
+ ).toBeInTheDocument();
+ } );
+ } );
+
+ it( 'switches back to edit mode when edit button is clicked', () => {
+ mockContext.trackingNumber = '12345678';
+ render( <ShipmentTrackingNumberForm /> );
+ fireEvent.click( screen.getByTestId( 'edit-icon' ) );
+ expect(
+ screen.getByPlaceholderText( 'Enter tracking number' )
+ ).toBeInTheDocument();
+ } );
+
+ it( 'calls handleTrackingNumberLookup when Enter key is pressed', async () => {
+ mockContext.trackingNumber = '';
+ mockContext.shipmentProvider = '';
+ apiFetch.mockResolvedValueOnce( {
+ tracking_number_details: {
+ tracking_number: '1Z12345E0291980793',
+ shipping_provider: 'ups',
+ tracking_url:
+ 'https://www.ups.com/track?tracknum=1Z12345E0291980793',
+ },
+ } );
+ render( <ShipmentTrackingNumberForm /> );
+ const input = screen.getByPlaceholderText( 'Enter tracking number' );
+ fireEvent.change( input, { target: { value: '1Z12345E0291980793' } } );
+ fireEvent.keyDown( input, { key: 'Enter' } );
+
+ await waitFor( () => {
+ expect( mockContext.setTrackingNumber ).toHaveBeenCalledWith(
+ '1Z12345E0291980793'
+ );
+ } );
+ await expect( mockContext.setShipmentProvider ).toHaveBeenCalledWith(
+ 'ups'
+ );
+ await expect( mockContext.setTrackingUrl ).toHaveBeenCalledWith(
+ 'https://www.ups.com/track?tracknum=1Z12345E0291980793'
+ );
+ } );
+
+ it( 'does not call handleTrackingNumberLookup when Enter key is pressed with empty input', () => {
+ mockContext.trackingNumber = '';
+ render( <ShipmentTrackingNumberForm /> );
+ const input = screen.getByPlaceholderText( 'Enter tracking number' );
+ fireEvent.keyDown( input, { key: 'Enter' } );
+
+ expect( mockContext.setTrackingNumber ).not.toHaveBeenCalled();
+ } );
+
+ it( 'switches to edit mode when tracking number is clicked', () => {
+ mockContext.trackingNumber = '1Z12345E0291980793';
+ render( <ShipmentTrackingNumberForm /> );
+ const trackingNumberSpan = screen.getByRole( 'button', {
+ name: '1Z12345E0291980793',
+ } );
+ fireEvent.click( trackingNumberSpan );
+
+ expect(
+ screen.getByPlaceholderText( 'Enter tracking number' )
+ ).toBeInTheDocument();
+ } );
+} );
diff --git a/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/shipment-form/test/shipment-viewer.test.js b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/shipment-form/test/shipment-viewer.test.js
new file mode 100644
index 0000000000..32e5b06379
--- /dev/null
+++ b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/shipment-form/test/shipment-viewer.test.js
@@ -0,0 +1,94 @@
+/**
+ * External dependencies
+ */
+import { render, screen } from '@testing-library/react';
+
+/**
+ * Internal dependencies
+ */
+import '../../../test-helper/global-mock';
+import ShipmentViewer from '../shipment-viewer';
+import { useShipmentFormContext } from '../../../context/shipment-form-context';
+
+jest.mock( '../../../context/shipment-form-context', () => ( {
+ useShipmentFormContext: jest.fn(),
+} ) );
+
+jest.mock( '../../../utils/icons', () => ( {
+ CopyIcon: ( { copyText } ) => (
+ <span data-testid="copy-icon">{ copyText }</span>
+ ),
+ TruckIcon: () => <span data-testid="truck-icon" />,
+} ) );
+
+jest.mock( '../../user-interface/fulfillments-card/card', () => ( {
+ __esModule: true,
+ default: ( { header, children } ) => (
+ <div data-testid="fulfillment-card">
+ <div data-testid="card-header">{ header }</div>
+ <div data-testid="card-body">{ children }</div>
+ </div>
+ ),
+} ) );
+
+jest.mock( '../../user-interface/meta-list/meta-list', () => ( {
+ __esModule: true,
+ default: ( { metaList } ) => (
+ <ul data-testid="meta-list">
+ { metaList.map( ( item, index ) => (
+ <li key={ index }>
+ { item.label }: { item.value }
+ </li>
+ ) ) }
+ </ul>
+ ),
+} ) );
+
+describe( 'ShipmentViewer', () => {
+ const mockContext = {
+ shipmentProvider: '',
+ trackingNumber: '',
+ trackingUrl: '',
+ selectedOption: '',
+ };
+
+ beforeEach( () => {
+ jest.clearAllMocks();
+ useShipmentFormContext.mockReturnValue( mockContext );
+ } );
+
+ it( 'renders no shipment information when option is set to no info', () => {
+ mockContext.selectedOption = 'no-info';
+ render( <ShipmentViewer /> );
+ expect( screen.getByTestId( 'truck-icon' ) ).toBeInTheDocument();
+ expect(
+ screen.getByText( 'No shipment information' )
+ ).toBeInTheDocument();
+ } );
+
+ it( 'renders shipment information when data is provided', () => {
+ mockContext.selectedOption = 'tracking-number';
+ mockContext.shipmentProvider = 'ups';
+ mockContext.trackingNumber = '12345678';
+ mockContext.trackingUrl = 'https://www.ups.com/track?tracknum=12345678';
+ render( <ShipmentViewer /> );
+ expect(
+ screen.getByRole( 'heading', { level: 3, name: /12345678/ } )
+ ).toBeInTheDocument();
+ expect( screen.getByTestId( 'copy-icon' ) ).toHaveTextContent(
+ '12345678'
+ );
+ expect( screen.getByTestId( 'meta-list' ) ).toBeInTheDocument();
+ expect(
+ screen.getByText( 'Tracking number: 12345678' )
+ ).toBeInTheDocument();
+ expect(
+ screen.getByText( /Provider name\s*:\s*UPS/ )
+ ).toBeInTheDocument();
+ expect(
+ screen.getByText(
+ 'Tracking URL: https://www.ups.com/track?tracknum=12345678'
+ )
+ ).toBeInTheDocument();
+ } );
+} );
diff --git a/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/user-interface/error-label.tsx b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/user-interface/error-label.tsx
new file mode 100644
index 0000000000..1b49055130
--- /dev/null
+++ b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/user-interface/error-label.tsx
@@ -0,0 +1,41 @@
+/**
+ * External dependencies
+ */
+import { useLayoutEffect, useRef } from 'react';
+
+export default function ErrorLabel( { error }: { error: string } ) {
+ const labelRef = useRef< HTMLDivElement >( null );
+ useLayoutEffect( () => {
+ if ( error ) {
+ // Scroll to the top of the error label when an error occurs.
+ labelRef.current?.scrollIntoView( {
+ behavior: 'smooth',
+ block: 'start',
+ inline: 'nearest',
+ } );
+ }
+ }, [ error ] );
+ return (
+ <div className="woocommerce-fulfillment-error-label" ref={ labelRef }>
+ <span className="woocommerce-fulfillment-error-label__icon">
+ <svg
+ width="16"
+ height="16"
+ viewBox="0 0 16 16"
+ fill="none"
+ xmlns="http://www.w3.org/2000/svg"
+ >
+ <path
+ d="M7.99996 13.3333C10.9455 13.3333 13.3333 10.9455 13.3333 7.99996C13.3333 5.05444 10.9455 2.66663 7.99996 2.66663C5.05444 2.66663 2.66663 5.05444 2.66663 7.99996C2.66663 10.9455 5.05444 13.3333 7.99996 13.3333Z"
+ strokeWidth="1.5"
+ />
+ <path d="M8.66671 4.66663H7.33337V8.66663H8.66671V4.66663Z" />
+ <path d="M8.66671 10H7.33337V11.3333H8.66671V10Z" />
+ </svg>
+ </span>
+ <span className="woocommerce-fulfillment-error-label__text">
+ { error }
+ </span>
+ </div>
+ );
+}
diff --git a/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/user-interface/fulfillment-drawer/fulfillment-drawer-body.tsx b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/user-interface/fulfillment-drawer/fulfillment-drawer-body.tsx
new file mode 100644
index 0000000000..080a2985f2
--- /dev/null
+++ b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/user-interface/fulfillment-drawer/fulfillment-drawer-body.tsx
@@ -0,0 +1,9 @@
+export default function FulfillmentDrawerBody( {
+ children,
+}: {
+ children: React.ReactNode;
+} ) {
+ return (
+ <div className="woocommerce-fulfillment-drawer__body">{ children }</div>
+ );
+}
diff --git a/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/user-interface/fulfillment-drawer/fulfillment-drawer-header.tsx b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/user-interface/fulfillment-drawer/fulfillment-drawer-header.tsx
new file mode 100644
index 0000000000..2d7411dd8f
--- /dev/null
+++ b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/user-interface/fulfillment-drawer/fulfillment-drawer-header.tsx
@@ -0,0 +1,51 @@
+/**
+ * External dependencies
+ */
+import moment from 'moment';
+
+/**
+ * Internal dependencies
+ */
+import { useFulfillmentDrawerContext } from '../../../context/drawer-context';
+
+export default function FulfillmentsDrawerHeader( {
+ onClose,
+}: {
+ onClose: () => void;
+} ) {
+ const { order, setIsEditing, setOpenSection } =
+ useFulfillmentDrawerContext();
+ if ( ! order ) {
+ return null;
+ }
+
+ return (
+ order && (
+ <div className={ 'woocommerce-fulfillment-drawer__header' }>
+ <div className="woocommerce-fulfillment-drawer__header__title">
+ <h2>
+ #{ order.id }{ ' ' }
+ { order.billing.first_name +
+ ' ' +
+ order.billing.last_name }
+ </h2>
+ <button
+ className="woocommerce-fulfillment-drawer__header__close-button"
+ onClick={ () => {
+ setIsEditing( false );
+ setOpenSection( 'order' );
+ onClose();
+ } }
+ >
+ ×
+ </button>
+ </div>
+ <p>
+ { moment( order.date_created ).format(
+ 'MMMM D, YYYY, H:mma'
+ ) }
+ </p>
+ </div>
+ )
+ );
+}
diff --git a/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/user-interface/fulfillment-drawer/fulfillment-drawer.scss b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/user-interface/fulfillment-drawer/fulfillment-drawer.scss
new file mode 100644
index 0000000000..db6c13ef47
--- /dev/null
+++ b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/user-interface/fulfillment-drawer/fulfillment-drawer.scss
@@ -0,0 +1,129 @@
+.woocommerce-fulfillment-drawer {
+ position: fixed;
+ inset: 0;
+ top: 32px;
+ left: auto;
+ height: calc(100vh - 32px);
+ z-index: 9999;
+ width: calc(27.7778vw + 1px);
+ min-width: 401px;
+ max-width: 501px;
+ pointer-events: none;
+ overflow: hidden;
+ overscroll-behavior-y: none;
+
+ &__panel {
+ position: absolute;
+ right: 0;
+ top: 0;
+ width: 27.7778vw;
+ min-width: 400px;
+ max-width: 500px;
+ height: 100%;
+ background: #fff;
+ padding: 0;
+ pointer-events: auto;
+ border-left: 1px solid #ddd !important;
+ transform: translateX(100%);
+ transition: transform 0.3s ease-in-out;
+ overflow-y: auto;
+ scrollbar-gutter: stable;
+
+ &.is-open {
+ pointer-events: auto;
+ transition: transform 0.3s ease-in-out;
+ transform: translateX(0%);
+ }
+ }
+
+ &__header {
+ padding: 16px 20px;
+ display: flex;
+ flex-direction: column;
+ justify-content: space-between;
+ gap: 4px;
+ inset: 0;
+ bottom: auto;
+ background-color: #fff;
+ border-bottom: 1px solid #ddd;
+ z-index: 1;
+
+ &__title {
+ display: flex;
+ flex-direction: row;
+ align-items: center;
+ justify-content: space-between;
+ flex-grow: 1;
+
+ h2 {
+ letter-spacing: 0%;
+ font-size: 15px;
+ line-height: 20px;
+ font-weight: 500;
+ color: #070707;
+ margin: 0;
+ }
+ }
+
+ &__close-button {
+ background: transparent;
+ border: 0 solid transparent;
+ cursor: pointer;
+ font-size: 20px;
+ line-height: 16px;
+ width: 16px;
+ height: 16px;
+ padding: 0;
+ font-weight: 200;
+ }
+
+ p {
+ font-size: 11px;
+ line-height: 16px;
+ font-weight: 400;
+ color: var(--wc-admin-subtext, #767676);
+ margin: 0;
+ }
+ }
+
+ &__body {
+ display: flex;
+ flex-direction: column;
+ height: fit-content;
+ overflow-y: auto;
+ overscroll-behavior: none;
+ }
+}
+
+.woocommerce-fulfillment-drawer__backdrop {
+ position: fixed;
+ top: 0;
+ left: 0;
+ width: 100%;
+ height: 100%;
+ z-index: 9998;
+ background-color: #1e1e1e80;
+}
+
+@media screen and (max-width: 782px) {
+ .woocommerce-fulfillment-drawer {
+ top: 46px;
+ height: calc(100vh - 46px);
+ width: 100%;
+ min-width: 100%;
+ max-width: 100%;
+ &__panel {
+ width: 100%;
+ min-width: 100%;
+ max-width: 100%;
+ }
+ &__body {
+ height: calc(100% - 73px);
+ }
+ }
+
+ // Prevent scrolling of the body when the drawer is open.
+ body:has(.woocommerce-fulfillment-drawer__body) {
+ overflow: hidden;
+ }
+}
diff --git a/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/user-interface/fulfillment-drawer/fulfillment-drawer.tsx b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/user-interface/fulfillment-drawer/fulfillment-drawer.tsx
new file mode 100644
index 0000000000..71c31439ff
--- /dev/null
+++ b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/user-interface/fulfillment-drawer/fulfillment-drawer.tsx
@@ -0,0 +1,62 @@
+/**
+ * External dependencies
+ */
+import React from 'react';
+
+/**
+ * Internal dependencies
+ */
+import NewFulfillmentForm from '../../fulfillments/new-fulfillment-form';
+import { ErrorBoundary } from '~/error-boundary';
+import FulfillmentsList from '../../fulfillments/fulfillments-list';
+import FulfillmentsDrawerHeader from './fulfillment-drawer-header';
+import { FulfillmentDrawerProvider } from '../../../context/drawer-context';
+import './fulfillment-drawer.scss';
+import FulfillmentDrawerBody from './fulfillment-drawer-body';
+
+interface Props {
+ isOpen: boolean;
+ hasBackdrop?: boolean;
+ onClose: () => void;
+ orderId: number | null;
+}
+
+const FulfillmentDrawer: React.FC< Props > = ( {
+ isOpen,
+ hasBackdrop = false,
+ onClose,
+ orderId,
+} ) => {
+ return (
+ <>
+ { hasBackdrop && (
+ <div
+ className="woocommerce-fulfillment-drawer__backdrop"
+ onClick={ onClose }
+ role="presentation"
+ style={ { display: isOpen ? 'block' : 'none' } }
+ />
+ ) }
+ <div className="woocommerce-fulfillment-drawer">
+ <div
+ className={ [
+ 'woocommerce-fulfillment-drawer__panel',
+ isOpen ? 'is-open' : 'is-closed',
+ ].join( ' ' ) }
+ >
+ <ErrorBoundary>
+ <FulfillmentDrawerProvider orderId={ orderId }>
+ <FulfillmentsDrawerHeader onClose={ onClose } />
+ <FulfillmentDrawerBody>
+ <NewFulfillmentForm />
+ <FulfillmentsList />
+ </FulfillmentDrawerBody>
+ </FulfillmentDrawerProvider>
+ </ErrorBoundary>
+ </div>
+ </div>
+ </>
+ );
+};
+
+export default FulfillmentDrawer;
diff --git a/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/user-interface/fulfillment-drawer/test/fulfillment-drawer.test.js b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/user-interface/fulfillment-drawer/test/fulfillment-drawer.test.js
new file mode 100644
index 0000000000..8c62bc09e0
--- /dev/null
+++ b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/user-interface/fulfillment-drawer/test/fulfillment-drawer.test.js
@@ -0,0 +1,64 @@
+/**
+ * External dependencies
+ */
+import { render, screen } from '@testing-library/react';
+
+/**
+ * Internal dependencies
+ */
+import FulfillmentDrawer from '../fulfillment-drawer';
+
+jest.mock( '../../../fulfillments/new-fulfillment-form', () => () => (
+ <div data-testid="new-fulfillment-form" />
+) );
+jest.mock( '../../../fulfillments/fulfillments-list', () => () => (
+ <div data-testid="fulfillments-list" />
+) );
+jest.mock( '../fulfillment-drawer-header', () => () => (
+ <div data-testid="fulfillment-drawer-header" />
+) );
+jest.mock( '../../../../context/drawer-context', () => ( {
+ FulfillmentDrawerProvider: ( { children } ) => (
+ <div data-testid="drawer-provider">{ children }</div>
+ ),
+} ) );
+jest.mock( '~/error-boundary', () => ( {
+ ErrorBoundary: ( { children } ) => (
+ <div data-testid="error-boundary">{ children }</div>
+ ),
+} ) );
+
+describe( 'FulfillmentDrawer', () => {
+ it( 'renders the drawer with all components when open', () => {
+ const { container } = render(
+ <FulfillmentDrawer
+ isOpen={ true }
+ onClose={ jest.fn() }
+ orderId={ 123 }
+ />
+ );
+
+ expect( screen.getByTestId( 'error-boundary' ) ).toBeInTheDocument();
+ expect( screen.getByTestId( 'drawer-provider' ) ).toBeInTheDocument();
+ expect(
+ screen.getByTestId( 'fulfillment-drawer-header' )
+ ).toBeInTheDocument();
+ expect(
+ screen.getByTestId( 'new-fulfillment-form' )
+ ).toBeInTheDocument();
+ expect( screen.getByTestId( 'fulfillments-list' ) ).toBeInTheDocument();
+ expect( container.querySelector( '.is-open' ) ).toBeInTheDocument();
+ } );
+
+ it( 'renders the drawer as closed when isOpen is false', () => {
+ const { container } = render(
+ <FulfillmentDrawer
+ isOpen={ false }
+ onClose={ jest.fn() }
+ orderId={ 123 }
+ />
+ );
+
+ expect( container.querySelector( '.is-closed' ) ).toBeInTheDocument();
+ } );
+} );
diff --git a/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/user-interface/fulfillments-card/card.scss b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/user-interface/fulfillments-card/card.scss
new file mode 100644
index 0000000000..71c06d1924
--- /dev/null
+++ b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/user-interface/fulfillments-card/card.scss
@@ -0,0 +1,69 @@
+.woocommerce-fulfillment-card {
+ border: 1px solid #e0e0e0;
+ border-radius: 4px;
+ display: flex;
+ flex-direction: column;
+
+ & &__header {
+ & &--clickable {
+ cursor: pointer;
+ }
+ display: flex;
+ gap: 8px;
+ align-items: center;
+ justify-content: space-between;
+ padding: 16px 24px;
+
+ h3 {
+ display: flex;
+ flex: 1;
+ align-items: center;
+ gap: 8px;
+ flex: 1;
+ font-size: 13px;
+ line-height: 20px;
+ font-weight: 500;
+ color: #1e1e1e;
+ margin: 0;
+ padding: 0 !important;
+ }
+ img,
+ svg {
+ width: 24px;
+ height: 24px;
+ box-sizing: border-box;
+ padding: 2px 4px;
+ }
+ button {
+ padding: 0;
+ width: 24px;
+ height: 24px;
+ border: 0;
+ display: flex;
+ align-items: center;
+ justify-content: center;
+
+ &:focus {
+ outline: none;
+ box-shadow: none;
+ }
+ }
+ }
+
+ & &__body {
+ display: flex;
+ padding: 8px 24px 24px 24px;
+ &.no-collapse {
+ padding: 0 24px 24px 24px;
+ }
+ }
+}
+
+.woocommerce-fulfillment-card__size-small {
+ .woocommerce-fulfillment-card__header {
+ padding: 16px 24px 0;
+ }
+ .woocommerce-fulfillment-card__body {
+ padding: 8px 24px 16px 24px !important;
+ }
+}
diff --git a/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/user-interface/fulfillments-card/card.tsx b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/user-interface/fulfillments-card/card.tsx
new file mode 100644
index 0000000000..d694969820
--- /dev/null
+++ b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/user-interface/fulfillments-card/card.tsx
@@ -0,0 +1,61 @@
+/**
+ * External dependencies
+ */
+import { Button, Icon } from '@wordpress/components';
+import React, { ReactNode, useState } from 'react';
+
+/**
+ * Internal dependencies
+ */
+import './card.scss';
+
+export default function FulfillmentCard( {
+ header,
+ isCollapsable,
+ initialState,
+ size = 'medium',
+ children,
+}: {
+ header: ReactNode;
+ isCollapsable?: boolean;
+ initialState?: 'collapsed' | 'expanded';
+ size?: 'small' | 'medium' | 'large';
+ children: ReactNode;
+} ) {
+ const [ isOpen, setIsOpen ] = useState( initialState === 'expanded' );
+ const hasChildren = React.Children.toArray( children ).length > 0;
+
+ return (
+ <div
+ className={ `woocommerce-fulfillment-card woocommerce-fulfillment-card__size-${ size }` }
+ >
+ <div className="woocommerce-fulfillment-card__header">
+ { header }
+ { isCollapsable && (
+ <Button
+ __next40pxDefaultSize
+ size="small"
+ onClick={ () => setIsOpen( ! isOpen ) }
+ >
+ <Icon
+ icon={
+ isOpen ? 'arrow-up-alt2' : 'arrow-down-alt2'
+ }
+ size={ 16 }
+ />
+ </Button>
+ ) }
+ </div>
+ { isOpen && hasChildren && (
+ <div
+ className={ [
+ 'woocommerce-fulfillment-card__body',
+ isCollapsable ? '' : 'no-collapse',
+ ].join( ' ' ) }
+ >
+ { children }
+ </div>
+ ) }
+ </div>
+ );
+}
diff --git a/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/user-interface/fulfillments-card/test/card.test.js b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/user-interface/fulfillments-card/test/card.test.js
new file mode 100644
index 0000000000..197985a705
--- /dev/null
+++ b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/user-interface/fulfillments-card/test/card.test.js
@@ -0,0 +1,96 @@
+/**
+ * External dependencies
+ */
+import { render, screen, fireEvent } from '@testing-library/react';
+
+/**
+ * Internal dependencies
+ */
+import FulfillmentCard from '../card';
+
+jest.mock( '@wordpress/components', () => ( {
+ Button: ( { onClick, children } ) => (
+ <button data-testid="button" onClick={ onClick }>
+ { children }
+ </button>
+ ),
+ Icon: ( { icon } ) => <span data-testid="icon">{ icon }</span>,
+} ) );
+
+describe( 'FulfillmentCard', () => {
+ it( 'renders the header and children', () => {
+ render(
+ <FulfillmentCard header={ <h1>Header</h1> } isCollapsable>
+ <p>Child content</p>
+ </FulfillmentCard>
+ );
+
+ expect( screen.getByText( 'Header' ) ).toBeInTheDocument();
+ // Children should not be visible by default for collapsable
+ expect( screen.queryByText( 'Child content' ) ).not.toBeInTheDocument();
+ // Click to expand
+ fireEvent.click( screen.getByTestId( 'button' ) );
+ expect( screen.getByText( 'Child content' ) ).toBeInTheDocument();
+ } );
+
+ it( 'renders as collapsable and toggles visibility', () => {
+ render(
+ <FulfillmentCard header={ <h1>Header</h1> } isCollapsable>
+ <p>Child content</p>
+ </FulfillmentCard>
+ );
+
+ const button = screen.getByTestId( 'button' );
+ expect( screen.queryByText( 'Child content' ) ).not.toBeInTheDocument();
+
+ fireEvent.click( button );
+ expect( screen.getByText( 'Child content' ) ).toBeInTheDocument();
+
+ fireEvent.click( button );
+ expect( screen.queryByText( 'Child content' ) ).not.toBeInTheDocument();
+ } );
+
+ it( 'renders without collapse button when not collapsable', () => {
+ render(
+ <FulfillmentCard header={ <h1>Header</h1> } isCollapsable={ false }>
+ <p>Child content</p>
+ </FulfillmentCard>
+ );
+
+ expect( screen.queryByTestId( 'button' ) ).not.toBeInTheDocument();
+ // Children should not be visible if not collapsable (matches component behavior)
+ expect( screen.queryByText( 'Child content' ) ).not.toBeInTheDocument();
+ } );
+
+ it( 'renders children if initialState is open (collapsable)', () => {
+ render(
+ <FulfillmentCard
+ header={ <h1>Header</h1> }
+ isCollapsable
+ initialState="open"
+ >
+ <p>Child content</p>
+ </FulfillmentCard>
+ );
+
+ const button = screen.getByTestId( 'button' );
+ // Children may not be visible by default, so click to expand
+ fireEvent.click( button );
+ expect( screen.getByText( 'Child content' ) ).toBeInTheDocument();
+ } );
+
+ it( 'does not render children if initialState is closed (collapsable)', () => {
+ render(
+ <FulfillmentCard
+ header={ <h1>Header</h1> }
+ isCollapsable
+ initialState="closed"
+ >
+ <p>Child content</p>
+ </FulfillmentCard>
+ );
+
+ expect( screen.getByTestId( 'button' ) ).toBeInTheDocument();
+ expect( screen.queryByText( 'Child content' ) ).not.toBeInTheDocument();
+ } );
+} );
diff --git a/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/user-interface/lock-label.tsx b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/user-interface/lock-label.tsx
new file mode 100644
index 0000000000..5e27757ba7
--- /dev/null
+++ b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/user-interface/lock-label.tsx
@@ -0,0 +1,30 @@
+/**
+ * External dependencies
+ */
+import { __ } from '@wordpress/i18n';
+
+export default function LockLabel( { message }: { message: string } ) {
+ return (
+ <div className="woocommerce-fulfillment-lock-label">
+ <span className="woocommerce-fulfillment-lock-label__icon">
+ <svg
+ width="10"
+ height="15"
+ viewBox="0 0 10 15"
+ fill="none"
+ xmlns="http://www.w3.org/2000/svg"
+ aria-hidden="true"
+ >
+ <path d="M9.16667 6.33341H8.16667V3.83341C8.16667 2.08341 6.75 0.666748 5 0.666748C3.25 0.666748 1.83333 2.08341 1.83333 3.83341V6.33341H0.833333C0.333333 6.33341 0 6.66675 0 7.16675V13.8334C0 14.3334 0.333333 14.6667 0.833333 14.6667H9.16667C9.66667 14.6667 10 14.3334 10 13.8334V7.16675C10 6.66675 9.66667 6.33341 9.16667 6.33341ZM3.16667 3.83341C3.16667 2.83341 4 2.00008 5 2.00008C6 2.00008 6.83333 2.83341 6.83333 3.83341V6.33341H3.16667V3.83341ZM8.75 13.4167H1.25V7.58341H8.75V13.4167Z" />
+ </svg>
+ </span>
+ <span className="woocommerce-fulfillment-lock-label__text">
+ { message ||
+ __(
+ 'This item is locked and cannot be edited.',
+ 'woocommerce'
+ ) }
+ </span>
+ </div>
+ );
+}
diff --git a/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/user-interface/meta-list/meta-list.scss b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/user-interface/meta-list/meta-list.scss
new file mode 100644
index 0000000000..f0778460ca
--- /dev/null
+++ b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/user-interface/meta-list/meta-list.scss
@@ -0,0 +1,36 @@
+ul.woocommerce-fulfillment-meta-list {
+ list-style: none;
+ padding: 0;
+ margin: 0;
+ display: flex;
+ flex-direction: column;
+ gap: 16px;
+ width: 100%;
+
+ .woocommerce-fulfillment-meta-list__item {
+ display: flex;
+ flex-direction: row;
+ align-items: center;
+ margin: 0;
+ padding: 0;
+
+ .woocommerce-fulfillment-meta-list__item-label {
+ font-size: 12px;
+ line-height: 20px;
+ font-weight: 500;
+ color: #1e1e1e;
+ min-width: 140px;
+ }
+
+ .woocommerce-fulfillment-meta-list__item-value {
+ flex: 1;
+ font-size: 12px;
+ line-height: 16px;
+ font-weight: 400;
+ color: var(--wc-admin-subtext, #757575);
+ white-space: nowrap;
+ overflow: hidden;
+ text-overflow: ellipsis;
+ }
+ }
+}
diff --git a/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/user-interface/meta-list/meta-list.tsx b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/user-interface/meta-list/meta-list.tsx
new file mode 100644
index 0000000000..207eb76d03
--- /dev/null
+++ b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/user-interface/meta-list/meta-list.tsx
@@ -0,0 +1,39 @@
+/**
+ * External dependencies
+ */
+import { __ } from '@wordpress/i18n';
+import { isEmpty } from 'lodash';
+
+/**
+ * Internal dependencies
+ */
+import './meta-list.scss';
+
+export default function MetaList( {
+ metaList,
+}: {
+ metaList: Array< {
+ label: string;
+ value: string;
+ } >;
+} ) {
+ return (
+ <ul className="woocommerce-fulfillment-meta-list">
+ { metaList.map( ( meta, index ) => (
+ <li
+ key={ index }
+ className="woocommerce-fulfillment-meta-list__item"
+ >
+ <div className="woocommerce-fulfillment-meta-list__item-label">
+ { meta.label }
+ </div>
+ <div className="woocommerce-fulfillment-meta-list__item-value">
+ { isEmpty( String( meta.value ) )
+ ? __( '(empty)', 'woocommerce' )
+ : String( meta.value ) }
+ </div>
+ </li>
+ ) ) }
+ </ul>
+ );
+}
diff --git a/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/user-interface/meta-list/test/meta-list.test.js b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/user-interface/meta-list/test/meta-list.test.js
new file mode 100644
index 0000000000..158aa2c789
--- /dev/null
+++ b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/components/user-interface/meta-list/test/meta-list.test.js
@@ -0,0 +1,34 @@
+/**
+ * External dependencies
+ */
+import { render, screen } from '@testing-library/react';
+
+/**
+ * Internal dependencies
+ */
+import MetaList from '../meta-list';
+
+describe( 'MetaList', () => {
+ it( 'renders a list of meta items', () => {
+ const metaList = [
+ { label: 'Label 1', value: 'Value 1' },
+ { label: 'Label 2', value: 'Value 2' },
+ ];
+
+ render( <MetaList metaList={ metaList } /> );
+
+ expect( screen.getByText( 'Label 1' ) ).toBeInTheDocument();
+ expect( screen.getByText( 'Value 1' ) ).toBeInTheDocument();
+ expect( screen.getByText( 'Label 2' ) ).toBeInTheDocument();
+ expect( screen.getByText( 'Value 2' ) ).toBeInTheDocument();
+ } );
+
+ it( 'renders (empty) for empty values', () => {
+ const metaList = [ { label: 'Label 1', value: '' } ];
+
+ render( <MetaList metaList={ metaList } /> );
+
+ expect( screen.getByText( 'Label 1' ) ).toBeInTheDocument();
+ expect( screen.getByText( '(empty)' ) ).toBeInTheDocument();
+ } );
+} );
diff --git a/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/context/drawer-context.tsx b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/context/drawer-context.tsx
new file mode 100644
index 0000000000..1a87d12bcf
--- /dev/null
+++ b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/context/drawer-context.tsx
@@ -0,0 +1,136 @@
+/**
+ * External dependencies
+ */
+import React, { createContext, useLayoutEffect, useState } from 'react';
+import { useSelect } from '@wordpress/data';
+import { isEqual } from 'lodash';
+
+/**
+ * Internal dependencies
+ */
+import { Fulfillment, Order, Refund } from '../data/types';
+import { store as FulfillmentsStore } from '../data/store';
+import { getItemsNotInAnyFulfillment } from '../utils/order-utils';
+
+interface FulfillmentDrawerContextProps {
+ fulfillments: Fulfillment[];
+ setFulfillments: ( fulfillments: Fulfillment[] ) => void;
+ order: Order | null;
+ setOrder: ( order: Order | null ) => void;
+ refunds: Refund[];
+ setRefunds: ( refunds: Refund[] ) => void;
+ openSection: string;
+ setOpenSection: ( section: string ) => void;
+ isEditing: boolean;
+ setIsEditing: ( isEditing: boolean ) => void;
+}
+
+const defaultContextProps: FulfillmentDrawerContextProps = {
+ fulfillments: [],
+ setFulfillments: () => {},
+ order: null,
+ setOrder: () => {},
+ refunds: [],
+ setRefunds: () => {},
+ openSection: '',
+ setOpenSection: () => {},
+ isEditing: false,
+ setIsEditing: () => {},
+};
+
+const FulfillmentDrawerContextValue =
+ createContext< FulfillmentDrawerContextProps >( defaultContextProps );
+
+export const useFulfillmentDrawerContext = () => {
+ const context = React.useContext( FulfillmentDrawerContextValue );
+ if ( ! context ) {
+ throw new Error(
+ 'useFulfillmentDrawerContext must be used within a FulfillmentDrawerProvider'
+ );
+ }
+ return context;
+};
+
+export const FulfillmentDrawerProvider = ( {
+ orderId,
+ children,
+}: {
+ orderId: number | null;
+ children: React.ReactNode;
+} ) => {
+ const [ openSection, setOpenSection ] = useState( 'order' );
+ const [ isEditing, setIsEditing ] = useState( false );
+ const [ fulfillments, setFulfillments ] = useState< Fulfillment[] >();
+ const [ refunds, setRefunds ] = useState< Refund[] >();
+ const [ order, setOrder ] = useState< Order | null >();
+
+ useSelect(
+ ( select ) => {
+ if ( ! orderId ) {
+ return;
+ }
+ const store = select( FulfillmentsStore );
+ const orderData = store.getOrder( orderId );
+ const fulfillmentsData = store.readFulfillments( orderId );
+ const refundsData = store.getRefunds( orderId );
+ if ( ! isEqual( orderData, order ) ) {
+ setOrder( orderData );
+ setIsEditing( false );
+ }
+ if ( ! isEqual( refundsData, refunds ) ) {
+ setRefunds( refundsData ?? [] );
+ setIsEditing( false );
+ }
+ if ( ! isEqual( fulfillmentsData, fulfillments ) ) {
+ setFulfillments( fulfillmentsData ?? [] );
+ setIsEditing( false );
+ }
+ },
+ [ orderId, fulfillments, order, refunds ]
+ );
+
+ useLayoutEffect( () => {
+ const hasPendingItemsInOrder =
+ order &&
+ fulfillments &&
+ getItemsNotInAnyFulfillment( fulfillments, order, refunds ).length >
+ 0;
+
+ if ( hasPendingItemsInOrder ) {
+ // If there are pending items in the order and multiple fulfillments,
+ // open the order section to allow adding a new fulfillment.
+ setOpenSection( 'order' );
+ } else if ( fulfillments && fulfillments.length === 1 ) {
+ // If all the items are in a single fulfillment,
+ // open that fulfillment section directly.
+ setOpenSection( 'fulfillment-' + fulfillments[ 0 ].id );
+ } else {
+ // If there are no pending items and multiple fulfillments,
+ // collapse all.
+ setOpenSection( '' );
+ }
+ }, [ orderId, fulfillments, order, refunds ] );
+
+ if ( orderId === null ) {
+ return null;
+ }
+
+ return (
+ <FulfillmentDrawerContextValue.Provider
+ value={ {
+ fulfillments: fulfillments ?? [],
+ setFulfillments,
+ order: order ?? null,
+ setOrder,
+ refunds: refunds ?? [],
+ setRefunds,
+ openSection,
+ setOpenSection,
+ isEditing,
+ setIsEditing,
+ } }
+ >
+ { children }
+ </FulfillmentDrawerContextValue.Provider>
+ );
+};
diff --git a/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/context/fulfillment-context.tsx b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/context/fulfillment-context.tsx
new file mode 100644
index 0000000000..b7412928ee
--- /dev/null
+++ b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/context/fulfillment-context.tsx
@@ -0,0 +1,192 @@
+/**
+ * External dependencies
+ */
+import React, { createContext, useEffect, useMemo, useState } from 'react';
+
+/**
+ * Internal dependencies
+ */
+import { Fulfillment, Order } from '../data/types';
+import { ItemSelection } from '../utils/order-utils';
+import { useShipmentFormContext } from './shipment-form-context';
+import {
+ ITEMS_META_KEY,
+ PROVIDER_NAME_META_KEY,
+ SHIPMENT_OPTION_NO_INFO,
+ SHIPMENT_PROVIDER_META_KEY,
+ SHIPPING_OPTION_META_KEY,
+ TRACKING_NUMBER_META_KEY,
+ TRACKING_URL_META_KEY,
+ WC_ORDER_CLASS,
+} from '../data/constants';
+
+interface FulfillmentContextProps {
+ order: Order | null;
+ fulfillment: Fulfillment | null;
+ setFulfillment: ( fulfillment: Fulfillment | null ) => void;
+ selectedItems: ItemSelection[];
+ setSelectedItems: ( items: ItemSelection[] ) => void;
+ notifyCustomer: boolean;
+ setNotifyCustomer: ( notifyCustomer: boolean ) => void;
+}
+
+const defaultContextProps: FulfillmentContextProps = {
+ order: null,
+ fulfillment: null,
+ setFulfillment: () => {},
+ selectedItems: [],
+ setSelectedItems: () => {},
+ notifyCustomer: true,
+ setNotifyCustomer: () => {},
+};
+
+const FulfillmentContextValue =
+ createContext< FulfillmentContextProps >( defaultContextProps );
+
+export const useFulfillmentContext = () => {
+ const context = React.useContext( FulfillmentContextValue );
+ if ( ! context ) {
+ throw new Error(
+ 'useFulfillmentContext must be used within a FulfillmentProvider'
+ );
+ }
+ return context;
+};
+
+export const FulfillmentProvider = ( {
+ order,
+ fulfillment,
+ items,
+ children,
+}: {
+ order: Order | null;
+ fulfillment?: Fulfillment | null;
+ items?: ItemSelection[];
+ children: React.ReactNode;
+} ) => {
+ const [ _fulfillment, _setFulfillment ] =
+ React.useState< Fulfillment | null >( fulfillment ?? null );
+ const [ notifyCustomer, setNotifyCustomer ] = React.useState( true );
+
+ const {
+ selectedOption,
+ trackingNumber,
+ trackingUrl,
+ shipmentProvider,
+ providerName,
+ } = useShipmentFormContext();
+
+ const [ selectedItems, setSelectedItems ] = useState< ItemSelection[] >(
+ items ?? []
+ );
+
+ // Refresh the selected items when the items prop changes.
+ useEffect( () => {
+ setSelectedItems( items ?? [] );
+ }, [ items ] );
+
+ // Set the fulfillment object based on the order and selected items.
+ useEffect( () => {
+ if ( ! order?.id ) {
+ _setFulfillment( null );
+ return;
+ }
+ _setFulfillment( {
+ id: fulfillment?.id ?? undefined,
+ fulfillment_id: fulfillment?.id ?? undefined,
+ entity_id: String( order.id ),
+ entity_type: WC_ORDER_CLASS,
+ is_fulfilled: fulfillment?.is_fulfilled ?? false,
+ status: fulfillment?.status ?? 'unfulfilled',
+ meta_data: [
+ {
+ id: 0,
+ key: SHIPPING_OPTION_META_KEY,
+ value: selectedOption,
+ },
+ {
+ id: 0,
+ key: TRACKING_NUMBER_META_KEY,
+ value:
+ selectedOption === SHIPMENT_OPTION_NO_INFO
+ ? ''
+ : trackingNumber,
+ },
+ {
+ id: 0,
+ key: TRACKING_URL_META_KEY,
+ value:
+ selectedOption === SHIPMENT_OPTION_NO_INFO
+ ? ''
+ : trackingUrl,
+ },
+ {
+ id: 0,
+ key: SHIPMENT_PROVIDER_META_KEY,
+ value:
+ selectedOption === SHIPMENT_OPTION_NO_INFO
+ ? ''
+ : shipmentProvider,
+ },
+ {
+ id: 0,
+ key: PROVIDER_NAME_META_KEY,
+ value:
+ selectedOption === SHIPMENT_OPTION_NO_INFO
+ ? ''
+ : providerName,
+ },
+ {
+ id: 0,
+ key: ITEMS_META_KEY,
+ value: selectedItems
+ .map( ( item ) => {
+ return {
+ item_id: item.item_id,
+ qty: item.selection.filter(
+ ( selection ) => selection.checked
+ ).length,
+ };
+ } )
+ .filter( ( item ) => item.qty > 0 ),
+ },
+ ],
+ } as Fulfillment );
+ }, [
+ order,
+ trackingNumber,
+ trackingUrl,
+ shipmentProvider,
+ providerName,
+ selectedOption,
+ fulfillment,
+ selectedItems,
+ ] );
+
+ const contextValues = useMemo(
+ () => ( {
+ order,
+ fulfillment: _fulfillment,
+ setFulfillment: _setFulfillment,
+ selectedItems,
+ setSelectedItems,
+ notifyCustomer,
+ setNotifyCustomer,
+ } ),
+ [
+ order,
+ _fulfillment,
+ _setFulfillment,
+ selectedItems,
+ setSelectedItems,
+ notifyCustomer,
+ setNotifyCustomer,
+ ]
+ );
+
+ return (
+ <FulfillmentContextValue.Provider value={ contextValues }>
+ { children }
+ </FulfillmentContextValue.Provider>
+ );
+};
diff --git a/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/context/shipment-form-context.tsx b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/context/shipment-form-context.tsx
new file mode 100644
index 0000000000..debf167e79
--- /dev/null
+++ b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/context/shipment-form-context.tsx
@@ -0,0 +1,137 @@
+/**
+ * External dependencies
+ */
+import React, { createContext, useMemo } from 'react';
+
+/**
+ * Internal dependencies
+ */
+import { Fulfillment } from '../data/types';
+import { getFulfillmentMeta } from '../utils/fulfillment-utils';
+import {
+ PROVIDER_NAME_META_KEY,
+ SHIPMENT_OPTION_DEFAULT,
+ SHIPMENT_PROVIDER_META_KEY,
+ SHIPPING_OPTION_META_KEY,
+ TRACKING_NUMBER_META_KEY,
+ TRACKING_URL_META_KEY,
+} from '../data/constants';
+
+interface ShipmentFormContextProps {
+ selectedOption: string;
+ setSelectedOption: ( selectedOption: string ) => void;
+ trackingNumber: string;
+ setTrackingNumber: ( trackingNumber: string ) => void;
+ shipmentProvider: string;
+ setShipmentProvider: ( shipmentProvider: string ) => void;
+ trackingUrl: string;
+ setTrackingUrl: ( trackingUrl: string ) => void;
+ providerName: string;
+ setProviderName: ( providerName: string ) => void;
+}
+
+const defaultContextProps: ShipmentFormContextProps = {
+ selectedOption: SHIPMENT_OPTION_DEFAULT,
+ setSelectedOption: () => {},
+ trackingNumber: '',
+ setTrackingNumber: () => {},
+ shipmentProvider: '',
+ setShipmentProvider: () => {},
+ trackingUrl: '',
+ setTrackingUrl: () => {},
+ providerName: '',
+ setProviderName: () => {},
+};
+
+const ShipmentFormContextValue =
+ createContext< ShipmentFormContextProps >( defaultContextProps );
+
+export const useShipmentFormContext = () => {
+ const context = React.useContext( ShipmentFormContextValue );
+ if ( ! context ) {
+ throw new Error(
+ 'useShipmentFormContext must be used within a ShipmentFormProvider'
+ );
+ }
+ return context;
+};
+
+export const ShipmentFormProvider = ( {
+ fulfillment = null,
+ children,
+}: {
+ fulfillment?: Fulfillment | null;
+ children: React.ReactNode;
+} ) => {
+ const [ selectedOption, setSelectedOption ] = React.useState(
+ defaultContextProps.selectedOption
+ );
+ const [ trackingNumber, setTrackingNumber ] = React.useState(
+ defaultContextProps.trackingNumber
+ );
+ const [ shipmentProvider, setShipmentProvider ] = React.useState(
+ defaultContextProps.shipmentProvider
+ );
+ const [ trackingUrl, setTrackingUrl ] = React.useState(
+ defaultContextProps.trackingUrl
+ );
+ const [ providerName, setProviderName ] = React.useState(
+ defaultContextProps.providerName
+ );
+
+ // Update the context state when the fulfillment changes.
+ React.useEffect( () => {
+ setSelectedOption(
+ getFulfillmentMeta(
+ fulfillment,
+ SHIPPING_OPTION_META_KEY,
+ 'tracking-number'
+ )
+ );
+ setTrackingNumber(
+ getFulfillmentMeta( fulfillment, TRACKING_NUMBER_META_KEY, '' )
+ );
+ setShipmentProvider(
+ getFulfillmentMeta( fulfillment, SHIPMENT_PROVIDER_META_KEY, '' )
+ );
+ setTrackingUrl(
+ getFulfillmentMeta( fulfillment, TRACKING_URL_META_KEY, '' )
+ );
+ setProviderName(
+ getFulfillmentMeta( fulfillment, PROVIDER_NAME_META_KEY, '' )
+ );
+ }, [ fulfillment ] );
+
+ const contextValues = useMemo(
+ () => ( {
+ selectedOption,
+ setSelectedOption,
+ trackingNumber,
+ setTrackingNumber,
+ shipmentProvider,
+ setShipmentProvider,
+ trackingUrl,
+ setTrackingUrl,
+ providerName,
+ setProviderName,
+ } ),
+ [
+ selectedOption,
+ setSelectedOption,
+ trackingNumber,
+ setTrackingNumber,
+ shipmentProvider,
+ setShipmentProvider,
+ trackingUrl,
+ setTrackingUrl,
+ providerName,
+ setProviderName,
+ ]
+ );
+
+ return (
+ <ShipmentFormContextValue.Provider value={ contextValues }>
+ { children }
+ </ShipmentFormContextValue.Provider>
+ );
+};
diff --git a/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/data/constants.ts b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/data/constants.ts
new file mode 100644
index 0000000000..3a32be1405
--- /dev/null
+++ b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/data/constants.ts
@@ -0,0 +1,11 @@
+export const SHIPPING_OPTION_META_KEY = '_shipping_option';
+export const TRACKING_NUMBER_META_KEY = '_tracking_number';
+export const TRACKING_URL_META_KEY = '_tracking_url';
+export const SHIPMENT_PROVIDER_META_KEY = '_shipment_provider';
+export const PROVIDER_NAME_META_KEY = '_provider_name';
+export const ITEMS_META_KEY = '_items';
+export const SHIPMENT_OPTION_TRACKING_NUMBER = 'tracking-number';
+export const SHIPMENT_OPTION_MANUAL_ENTRY = 'manual-entry';
+export const SHIPMENT_OPTION_NO_INFO = 'no-info';
+export const SHIPMENT_OPTION_DEFAULT = SHIPMENT_OPTION_TRACKING_NUMBER;
+export const WC_ORDER_CLASS = 'WC_Order';
diff --git a/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/data/shipment-providers.tsx b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/data/shipment-providers.tsx
new file mode 100644
index 0000000000..20ffa6af9f
--- /dev/null
+++ b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/data/shipment-providers.tsx
@@ -0,0 +1,14 @@
+/**
+ * External dependencies
+ */
+import { __ } from '@wordpress/i18n';
+
+const ShipmentProviders: ShipmentProvider[] = [
+ ...Object.values( window.wcFulfillmentSettings.providers ?? {} ),
+ {
+ label: __( 'Other', 'woocommerce' ),
+ icon: null,
+ value: 'other',
+ },
+];
+export default ShipmentProviders;
diff --git a/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/data/store.ts b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/data/store.ts
new file mode 100644
index 0000000000..15d51461e3
--- /dev/null
+++ b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/data/store.ts
@@ -0,0 +1,387 @@
+/**
+ * External dependencies
+ */
+import apiFetch from '@wordpress/api-fetch';
+import { createReduxStore, register } from '@wordpress/data';
+
+/**
+ * Internal dependencies
+ */
+import { Order, Fulfillment, Refund } from './types';
+
+export const STORE_NAME = 'order/fulfillments';
+
+const getFulfillmentErrorMessage = (
+ error: unknown,
+ defaultMessage: string
+): string => {
+ if (
+ error &&
+ typeof error === 'object' &&
+ 'message' in error &&
+ 'code' in error
+ ) {
+ const apiError = error as { message: string; code: string };
+ if ( apiError.code === 'woocommerce_fulfillment_error' ) {
+ return apiError.message;
+ }
+ }
+ return defaultMessage;
+};
+
+const actionTypes = {
+ SET_ORDER: 'SET_ORDER',
+ SET_REFUNDS: 'SET_REFUNDS',
+ SET_LOADING: 'SET_LOADING',
+ SET_ERROR: 'SET_ERROR',
+ SET_FULFILLMENTS: 'SET_FULFILLMENTS',
+ SET_FULFILLMENT: 'SET_FULFILLMENT',
+ DELETE_FULFILLMENT: 'DELETE_FULFILLMENT',
+} as const;
+
+interface ResponseWithFulfillment {
+ fulfillment: Fulfillment & { id: number };
+}
+interface ResponseWithFulfillments {
+ fulfillments: Fulfillment[];
+}
+
+interface OrderState {
+ order: Order | null;
+ refunds: Refund[];
+ fulfillments: Fulfillment[];
+ loading: boolean;
+ error: string | null;
+}
+
+const DEFAULT_STATE: { orderMap: Record< string, OrderState > } = {
+ orderMap: {},
+};
+
+const getInitialOrderState = (): OrderState => ( {
+ order: null,
+ refunds: [],
+ fulfillments: [],
+ loading: false,
+ error: null,
+} );
+
+// --- Internal Action Creators
+const internalActions = {
+ setOrder( orderId: number, order: Order ) {
+ return { type: actionTypes.SET_ORDER, orderId, order };
+ },
+ setRefunds( orderId: number, refunds: Refund[] ) {
+ return { type: actionTypes.SET_REFUNDS, orderId, refunds };
+ },
+ setLoading( orderId: number, isLoading: boolean ) {
+ return { type: actionTypes.SET_LOADING, orderId, isLoading };
+ },
+ setError( orderId: number, error: string | null ) {
+ return { type: actionTypes.SET_ERROR, orderId, error };
+ },
+ setFulfillments( orderId: number, fulfillments: Fulfillment[] ) {
+ return { type: actionTypes.SET_FULFILLMENTS, orderId, fulfillments };
+ },
+ setFulfillment(
+ orderId: number,
+ fulfillmentId: number,
+ fulfillment: Fulfillment
+ ) {
+ return {
+ type: actionTypes.SET_FULFILLMENT,
+ orderId,
+ fulfillmentId,
+ fulfillment,
+ };
+ },
+ deleteFulfillmentRecord( orderId: number, fulfillmentId: number ) {
+ return { type: actionTypes.DELETE_FULFILLMENT, orderId, fulfillmentId };
+ },
+};
+
+// --- Public Async Actions
+const publicActions = {
+ saveFulfillment:
+ (
+ orderId: number,
+ fulfillment: Fulfillment,
+ notify_customer: boolean
+ ) =>
+ async ( { dispatch }: { dispatch: typeof actions } ) => {
+ dispatch.setLoading( orderId, true );
+ dispatch.setError( orderId, null );
+ try {
+ const saved = await apiFetch< ResponseWithFulfillment >( {
+ path: `/wc/v3/orders/${ orderId }/fulfillments?notify_customer=${ notify_customer }`,
+ method: 'POST',
+ data: fulfillment,
+ } );
+ dispatch.setFulfillment(
+ orderId,
+ saved.fulfillment.id,
+ saved.fulfillment
+ );
+ } catch ( error: unknown ) {
+ dispatch.setError(
+ orderId,
+ getFulfillmentErrorMessage(
+ error,
+ 'Failed to save fulfillment'
+ )
+ );
+ } finally {
+ dispatch.setLoading( orderId, false );
+ }
+ },
+
+ updateFulfillment:
+ (
+ orderId: number,
+ fulfillment: Fulfillment,
+ notifyCustomer: boolean
+ ) =>
+ async ( { dispatch }: { dispatch: typeof actions } ) => {
+ dispatch.setLoading( orderId, true );
+ dispatch.setError( orderId, null );
+ try {
+ const updated = await apiFetch< ResponseWithFulfillment >( {
+ path: `/wc/v3/orders/${ orderId }/fulfillments/${ fulfillment.id }?notify_customer=${ notifyCustomer }`,
+ method: 'PUT',
+ data: fulfillment,
+ } );
+ dispatch.setFulfillment(
+ orderId,
+ updated.fulfillment.id,
+ updated.fulfillment
+ );
+ } catch ( error: unknown ) {
+ dispatch.setError(
+ orderId,
+ getFulfillmentErrorMessage(
+ error,
+ 'Failed to update fulfillment'
+ )
+ );
+ } finally {
+ dispatch.setLoading( orderId, false );
+ }
+ },
+
+ deleteFulfillment:
+ ( orderId: number, fulfillmentId: number, notify_customer: boolean ) =>
+ async ( { dispatch }: { dispatch: typeof actions } ) => {
+ dispatch.setLoading( orderId, true );
+ dispatch.setError( orderId, null );
+ try {
+ await apiFetch( {
+ path: `/wc/v3/orders/${ orderId }/fulfillments/${ fulfillmentId }?notify_customer=${ notify_customer }`,
+ method: 'DELETE',
+ } );
+ dispatch.deleteFulfillmentRecord( orderId, fulfillmentId );
+ } catch ( error: unknown ) {
+ dispatch.setError(
+ orderId,
+ getFulfillmentErrorMessage(
+ error,
+ 'Failed to delete fulfillment'
+ )
+ );
+ } finally {
+ dispatch.setLoading( orderId, false );
+ }
+ },
+};
+
+const actions = {
+ ...internalActions,
+ ...publicActions,
+};
+
+type Action = ReturnType<
+ ( typeof internalActions )[ keyof typeof internalActions ]
+>;
+
+// --- Reducer
+function reducer( state = DEFAULT_STATE, action: Action ) {
+ const prev = state.orderMap[ action.orderId ] || getInitialOrderState();
+
+ switch ( action.type ) {
+ case actionTypes.SET_ORDER:
+ return {
+ ...state,
+ orderMap: {
+ ...state.orderMap,
+ [ action.orderId ]: { ...prev, order: action.order },
+ },
+ };
+ case actionTypes.SET_REFUNDS:
+ return {
+ ...state,
+ orderMap: {
+ ...state.orderMap,
+ [ action.orderId ]: {
+ ...prev,
+ refunds: action.refunds,
+ },
+ },
+ };
+ case actionTypes.SET_LOADING:
+ return {
+ ...state,
+ orderMap: {
+ ...state.orderMap,
+ [ action.orderId ]: { ...prev, loading: action.isLoading },
+ },
+ };
+ case actionTypes.SET_ERROR:
+ return {
+ ...state,
+ orderMap: {
+ ...state.orderMap,
+ [ action.orderId ]: { ...prev, error: action.error },
+ },
+ };
+ case actionTypes.SET_FULFILLMENTS:
+ return {
+ ...state,
+ orderMap: {
+ ...state.orderMap,
+ [ action.orderId ]: {
+ ...prev,
+ fulfillments: action.fulfillments,
+ },
+ },
+ };
+ case actionTypes.SET_FULFILLMENT:
+ return {
+ ...state,
+ orderMap: {
+ ...state.orderMap,
+ [ action.orderId ]: {
+ ...prev,
+ fulfillments: [
+ ...prev.fulfillments.filter(
+ ( f ) => f.id !== action.fulfillmentId
+ ),
+ action.fulfillment,
+ ],
+ },
+ },
+ };
+ case actionTypes.DELETE_FULFILLMENT:
+ return {
+ ...state,
+ orderMap: {
+ ...state.orderMap,
+ [ action.orderId ]: {
+ ...prev,
+ fulfillments: prev.fulfillments.filter(
+ ( f ) => f.id !== action.fulfillmentId
+ ),
+ },
+ },
+ };
+ default:
+ return state;
+ }
+}
+
+// --- Selectors
+const selectors = {
+ getState( state: typeof DEFAULT_STATE ) {
+ return state;
+ },
+ getOrder( state: typeof DEFAULT_STATE, orderId: number ) {
+ return state.orderMap[ orderId ]?.order;
+ },
+ getRefunds( state: typeof DEFAULT_STATE, orderId: number ) {
+ return state.orderMap[ orderId ]?.refunds || [];
+ },
+ isLoading( state: typeof DEFAULT_STATE, orderId: number ) {
+ return !! state.orderMap[ orderId ]?.loading;
+ },
+ getError( state: typeof DEFAULT_STATE, orderId: number ) {
+ return state.orderMap[ orderId ]?.error || null;
+ },
+ readFulfillments( state: typeof DEFAULT_STATE, orderId: number ) {
+ return state.orderMap[ orderId ]?.fulfillments || [];
+ },
+ readFulfillment(
+ state: typeof DEFAULT_STATE,
+ orderId: number,
+ fulfillmentId: number
+ ) {
+ return (
+ state.orderMap[ orderId ]?.fulfillments?.find(
+ ( f ) => f.id === fulfillmentId
+ ) || null
+ );
+ },
+};
+
+// --- Resolvers
+const resolvers = {
+ getOrder:
+ ( orderId: number ) =>
+ async ( { dispatch }: { dispatch: typeof actions } ) => {
+ dispatch.setLoading( orderId, true );
+ dispatch.setError( orderId, null );
+ try {
+ const order: Order = await apiFetch( {
+ path: `/wc/v3/orders/${ orderId }`,
+ method: 'GET',
+ } );
+ dispatch.setOrder( orderId, order );
+ if ( order.refunds.length > 0 ) {
+ const refunds: Refund[] = await apiFetch( {
+ path: `/wc/v3/orders/${ orderId }/refunds`,
+ method: 'GET',
+ } );
+ dispatch.setRefunds( orderId, refunds );
+ }
+ } catch ( error: unknown ) {
+ dispatch.setError(
+ orderId,
+ error instanceof Error
+ ? error.message
+ : 'Failed to load order'
+ );
+ } finally {
+ dispatch.setLoading( orderId, false );
+ }
+ },
+ readFulfillments:
+ ( orderId: number ) =>
+ async ( { dispatch }: { dispatch: typeof actions } ) => {
+ dispatch.setLoading( orderId, true );
+ dispatch.setError( orderId, null );
+ try {
+ const { fulfillments } =
+ await apiFetch< ResponseWithFulfillments >( {
+ path: `/wc/v3/orders/${ orderId }/fulfillments`,
+ method: 'GET',
+ } );
+ dispatch.setFulfillments( orderId, fulfillments );
+ } catch ( error: unknown ) {
+ dispatch.setError(
+ orderId,
+ error instanceof Error
+ ? error.message
+ : 'Failed to load fulfillments'
+ );
+ } finally {
+ dispatch.setLoading( orderId, false );
+ }
+ },
+};
+
+// --- Store Registration
+export const store = createReduxStore( STORE_NAME, {
+ reducer,
+ actions,
+ selectors,
+ resolvers,
+} );
+
+register( store );
diff --git a/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/data/types.ts b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/data/types.ts
new file mode 100644
index 0000000000..ca8b472f4b
--- /dev/null
+++ b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/data/types.ts
@@ -0,0 +1,177 @@
+export interface Order {
+ id: number;
+ parent_id: number;
+ status: string;
+ currency: string;
+ version: string;
+ prices_include_tax: boolean;
+ date_created: Date;
+ date_modified: Date;
+ discount_total: string;
+ discount_tax: string;
+ shipping_total: string;
+ shipping_tax: string;
+ cart_tax: string;
+ total: string;
+ total_tax: string;
+ customer_id: number;
+ order_key: string;
+ billing: Ing;
+ shipping: Ing;
+ payment_method: string;
+ payment_method_title: string;
+ transaction_id: string;
+ customer_ip_address: string;
+ customer_user_agent: string;
+ created_via: string;
+ customer_note: string;
+ date_completed: null;
+ date_paid: Date;
+ cart_hash: string;
+ number: string;
+ meta_data: OrderMetaDatum[];
+ line_items: LineItem[];
+ shipping_lines: ShippingLine[];
+ refunds: OrderRefund[];
+ payment_url: string;
+ is_editable: boolean;
+ needs_payment: boolean;
+ needs_processing: boolean;
+ date_created_gmt: Date;
+ date_modified_gmt: Date;
+ date_completed_gmt: null;
+ date_paid_gmt: Date;
+ currency_symbol: string;
+ _links: Links;
+}
+
+export interface OrderRefund {
+ id: number;
+ reason: string;
+ total: string;
+}
+
+export interface Refund {
+ id: number;
+ parent_id: number;
+ date_created: Date;
+ date_created_gmt: Date;
+ amount: string;
+ reason: string;
+ refunded_by: number;
+ refunded_payment: boolean;
+ meta_data: OrderMetaDatum[];
+ line_items: LineItem[];
+ shipping_lines: ShippingLine[];
+ tax_lines: OrderMetaDatum[];
+ fee_lines: OrderMetaDatum[];
+ _links: Links;
+}
+
+export interface Links {
+ self: Self[];
+ collection: Collection[];
+ email_templates: EmailTemplate[];
+ customer: Collection[];
+}
+
+export interface Collection {
+ href: string;
+}
+
+export interface EmailTemplate {
+ embeddable: boolean;
+ href: string;
+}
+
+export interface Self {
+ href: string;
+ targetHints: TargetHints;
+}
+
+export interface TargetHints {
+ allow: string[];
+}
+
+export interface Ing {
+ first_name: string;
+ last_name: string;
+ company: string;
+ address_1: string;
+ address_2: string;
+ city: string;
+ state: string;
+ postcode: string;
+ country: string;
+ email?: string;
+ phone: string;
+}
+
+export interface LineItem {
+ id: number;
+ name: string;
+ product_id: number;
+ variation_id: number;
+ quantity: number;
+ tax_class: string;
+ subtotal: string;
+ subtotal_tax: string;
+ total: string;
+ total_tax: string;
+ sku: string;
+ price: number;
+ image: Image;
+ parent_name: null;
+}
+
+export interface Image {
+ id: string;
+ src: string;
+}
+
+export interface OrderMetaDatum {
+ id: number;
+ key: string;
+ value: string;
+}
+
+export interface ShippingLine {
+ id: number;
+ method_title: string;
+ method_id: string;
+ instance_id: string;
+ total: string;
+ total_tax: string;
+ tax_status: string;
+ meta_data: ShippingLineMetaDatum[];
+}
+
+export interface ShippingLineMetaDatum {
+ id: number;
+ key: string;
+ value: string;
+ display_key: string;
+ display_value: string;
+}
+
+export interface Fulfillment {
+ id?: number;
+ fulfillment_id?: number;
+ entity_type: string;
+ entity_id: string;
+ status: string;
+ is_fulfilled: boolean;
+ date_updated?: Date;
+ meta_data: MetaDatum[];
+}
+
+export interface MetaDatum {
+ id: number;
+ key: string;
+ value: string | number | boolean | object | null;
+}
+
+export interface FulfillmentItem {
+ item_id: number;
+ qty: number;
+}
diff --git a/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/global.d.ts b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/global.d.ts
new file mode 100644
index 0000000000..f411c2fd3f
--- /dev/null
+++ b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/global.d.ts
@@ -0,0 +1,25 @@
+export {};
+
+declare global {
+ interface ShipmentProvider {
+ label: string;
+ icon: string | null;
+ value: string;
+ }
+
+ interface FulfillmentStatusProps {
+ label: string;
+ is_fulfilled: boolean;
+ background_color: string;
+ text_color: string;
+ }
+
+ interface Window {
+ wcFulfillmentSettings: {
+ providers: Record< string, ShipmentProvider >;
+ currency_symbols: Record< string, string >;
+ fulfillment_statuses: Record< string, FulfillmentStatusProps >;
+ order_fulfillment_statuses: Record< string, FulfillmentStatusProps >;
+ };
+ }
+}
diff --git a/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/index.tsx b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/index.tsx
new file mode 100644
index 0000000000..4b31afaef4
--- /dev/null
+++ b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/index.tsx
@@ -0,0 +1,83 @@
+/**
+ * External dependencies
+ */
+import React, { useCallback, useLayoutEffect, useState } from 'react';
+import { createRoot } from '@wordpress/element';
+import { getQuery } from '@woocommerce/navigation';
+
+/**
+ * Internal dependencies
+ */
+import './style.scss';
+import FulfillmentDrawer from './components/user-interface/fulfillment-drawer/fulfillment-drawer';
+
+function FulfillmentsController() {
+ const [ isOpen, setIsOpen ] = useState( false );
+ const [ orderId, setOrderId ] = useState< number | null >( null );
+
+ const deselectOrderRow = useCallback( () => {
+ document.querySelectorAll( '.type-shop_order' ).forEach( ( row ) => {
+ row.classList.remove( 'is-selected' );
+ } );
+ }, [] );
+
+ const selectOrderRow = useCallback(
+ ( button: HTMLButtonElement ) => {
+ const targetRow = button.closest( 'tr' );
+ deselectOrderRow();
+ targetRow?.classList.add( 'is-selected' );
+ },
+ [ deselectOrderRow ]
+ );
+
+ useLayoutEffect( () => {
+ const handleClick = ( e: Event ) => {
+ const target = e.target as HTMLElement;
+ if ( target.closest( '.fulfillments-trigger' ) ) {
+ const button = target.closest(
+ '.fulfillments-trigger'
+ ) as HTMLButtonElement;
+ const id = parseInt( button.dataset.orderId || '', 10 );
+ if ( id ) {
+ e.preventDefault();
+ e.stopPropagation();
+ selectOrderRow( button );
+ setOrderId( id );
+ setIsOpen( true );
+ }
+ }
+ };
+
+ document.body.addEventListener( 'click', handleClick );
+
+ return () => {
+ document.body.removeEventListener( 'click', handleClick );
+ };
+ }, [ selectOrderRow ] );
+
+ const query = getQuery();
+ const isOrderDetailsPage = query.hasOwnProperty( 'id' );
+
+ return (
+ <FulfillmentDrawer
+ hasBackdrop={ isOrderDetailsPage }
+ isOpen={ isOpen }
+ orderId={ orderId }
+ onClose={ () => {
+ deselectOrderRow();
+ setIsOpen( false );
+ setTimeout( () => {
+ setOrderId( null );
+ }, 300 );
+ } }
+ />
+ );
+}
+
+export default FulfillmentsController;
+
+const container = document.querySelector(
+ '#wc_order_fulfillments_panel_container'
+) as HTMLElement;
+
+createRoot( container ).render( <FulfillmentsController /> );
diff --git a/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/style.scss b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/style.scss
new file mode 100644
index 0000000000..50ffebf84c
--- /dev/null
+++ b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/style.scss
@@ -0,0 +1,443 @@
+.woocommerce-fulfillment-new-fulfillment-form {
+ display: flex;
+ flex-direction: column;
+ border-bottom: 1px solid #e0e0e0;
+
+ &.woocommerce-fulfillment-new-fulfillment-form__disabled {
+ opacity: 0.3;
+ pointer-events: none !important;
+ }
+ &.woocommerce-fulfillment-new-fulfillment-form__first {
+ border-bottom: none;
+ }
+ .woocommerce-fulfillment-new-fulfillment-form__header {
+ padding: 16px 20px;
+ display: flex;
+ gap: 12px;
+ align-items: center;
+ justify-content: flex-start;
+ cursor: pointer;
+
+ &.is-open {
+ cursor: default;
+ }
+
+ h3 {
+ flex: 1;
+ font-size: 13px;
+ line-height: 20px;
+ font-weight: 500;
+ color: #1e1e1e;
+ margin: 0;
+ padding: 0 !important;
+ }
+ button {
+ padding: 0;
+ width: 24px;
+ height: 24px;
+ border: 0;
+ display: flex;
+ align-items: center;
+ justify-content: center;
+
+ &:focus {
+ outline: none;
+ box-shadow: none;
+ }
+ }
+ }
+ .woocommerce-fulfillment-new-fulfillment-form__content {
+ padding: 0 20px 12px 20px;
+ display: flex;
+ flex-direction: column;
+ gap: 12px;
+ }
+
+ .components-checkbox-control {
+ padding: 0;
+ width: 16px;
+ height: 16px;
+ margin: 0;
+ }
+}
+
+.woocommerce-fulfillment-item-bulk-select {
+ display: flex;
+ gap: 16px;
+ align-items: center;
+ border-bottom: 1px solid #e0e0e0;
+ padding: 8px 0 12px;
+
+ .woocommerce-fulfillment-item-bulk-select__label {
+ text-transform: uppercase;
+ font-weight: 500;
+ font-size: 11px;
+ line-height: 16px;
+ color: #1e1e1e;
+ }
+
+ .woocommerce-fulfillment-item-bulk-select__link {
+ text-decoration: none;
+ font-weight: 400;
+ font-size: 12px;
+ line-height: 16px;
+ }
+}
+
+.woocommerce-fulfillment-item-list {
+ display: flex;
+ flex-direction: column;
+ margin: 0;
+
+ li {
+ list-style: none;
+ padding: 0;
+ margin: 0;
+ }
+
+ li:last-child .woocommerce-fulfillment-item-container {
+ border-bottom: 0;
+ }
+
+ .woocommerce-fulfillment-item-container,
+ .woocommerce-fulfillment-item-expansion {
+ display: flex;
+ flex-direction: row;
+ padding: 16px 0;
+ gap: 16px;
+ width: 100%;
+ align-items: center;
+ justify-content: flex-start;
+ border-bottom: 1px solid #e0e0e0;
+
+ &.woocommerce-fulfillment-item-expanded {
+ border-bottom: 0 solid transparent;
+ }
+
+ .woocommerce-fulfillment-item-checkbox {
+ display: flex;
+ flex-direction: row;
+ align-items: center;
+ gap: 8px;
+ }
+
+ .woocommerce-fulfillment-item-title {
+ display: flex;
+ flex-direction: row;
+ align-items: center;
+ gap: 8px;
+ flex: 1;
+
+ .woocommerce-fulfillment-item-image-container {
+ display: flex;
+ flex-direction: row;
+ align-items: center;
+ gap: 8px;
+
+ img {
+ width: 32px;
+ height: 32px;
+ border-radius: 2px;
+ object-fit: cover;
+ flex-shrink: 0;
+ border: 1px solid #ddd;
+ }
+ }
+
+ .woocommerce-fulfillment-item-name-sku {
+ display: flex;
+ flex-direction: column;
+
+ .woocommerce-fulfillment-item-name {
+ font-size: 13px;
+ line-height: 20px;
+ font-weight: 400;
+ color: #1e1e1e;
+ }
+
+ .woocommerce-fulfillment-item-sku {
+ font-size: 11px;
+ line-height: 16px;
+ font-weight: 400;
+ color: var(--wc-admin-subtext, #767676);
+ margin: 0;
+ }
+ }
+ }
+
+ .woocommerce-fulfillment-item-quantity {
+ background-color: #f0f0f0;
+ padding: 4px 8px;
+ border-radius: 2px;
+ font-size: 13px;
+ line-height: 20px;
+ }
+
+ .woocommerce-fulfillment-item-price {
+ min-width: 52px;
+ text-align: right;
+ }
+ }
+ .woocommerce-fulfillment-item-expansion {
+ flex-direction: column;
+ gap: 32px;
+ .woocommerce-fulfillment-item-expansion-row {
+ display: flex;
+ flex-direction: row !important;
+ gap: 16px;
+ padding-left: 40px;
+ align-self: stretch;
+ }
+ }
+}
+
+.woocommerce-fulfillment-modal {
+ width: 436px !important;
+ .components-modal__header {
+ padding: 32px;
+ height: auto;
+ h1 {
+ font-weight: 500;
+ }
+ .components-toggle-control .components-h-stack {
+ gap: 0;
+ }
+ }
+ p.woocommerce-fulfillment-modal-text {
+ margin-top: 8px;
+ margin-bottom: 12px;
+ }
+ .woocommerce-fulfillment-modal-actions {
+ justify-content: flex-end;
+ display: flex;
+ flex-direction: row;
+ gap: 20px;
+ align-items: center;
+ padding: 32px 0 0;
+ }
+}
+
+.woocommerce-fulfillment-item-actions {
+ justify-content: flex-end;
+ display: flex;
+ flex-direction: row;
+ gap: 12px;
+ align-items: center;
+ padding: 12px 0;
+}
+
+.woocommerce-fulfillment-stored-fulfillments-list {
+ display: flex;
+ flex-direction: column;
+ .woocommerce-fulfillment-stored-fulfillment-list-item {
+ display: flex;
+ flex-direction: column;
+ padding: 0;
+ margin-bottom: 4px;
+ justify-content: center;
+ border-bottom: 1px solid #e0e0e0;
+
+ &.woocommerce-fulfillment-stored-fulfillment-list-item__disabled {
+ opacity: 0.3;
+ pointer-events: none !important;
+ }
+
+ .woocommerce-fulfillment-stored-fulfillment-list-item-header {
+ display: flex;
+ flex-direction: row;
+ align-items: center;
+ justify-content: space-between;
+ padding: 12px 20px;
+ gap: 9.64px;
+ flex: 1;
+ cursor: pointer;
+
+ &.is-open {
+ cursor: default;
+ }
+
+ h3 {
+ flex: 1;
+ font-size: 13px;
+ line-height: 20px;
+ font-weight: 500;
+ color: #1e1e1e;
+ margin: 0;
+ padding: 0;
+ }
+ button {
+ padding: 0;
+ width: 24px;
+ height: 24px;
+ border: 0;
+ display: flex;
+ align-items: center;
+ justify-content: center;
+
+ &:focus {
+ outline: none;
+ box-shadow: none;
+ }
+ }
+ }
+ .woocommerce-fulfillment-stored-fulfillment-list-item-content {
+ display: flex;
+ flex-direction: column;
+ padding: 0 20px 12px 20px;
+ gap: 12px;
+ }
+ }
+}
+
+.woocommerce-fulfillment-description {
+ font-size: 12px;
+ line-height: 16px;
+ font-weight: 400;
+ color: var(--wc-admin-subtext, #767676);
+ margin: 0;
+}
+
+.woocommerce-fulfillment-status-badge {
+ display: flex;
+ flex-direction: row;
+ align-items: center;
+ justify-content: center;
+ padding: 4px 12px;
+ border-radius: 2px;
+ font-size: 12px;
+ line-height: 16px;
+ height: 28px;
+ font-weight: 400;
+ background-color: #e0e0e0;
+ color: #1e1e1e;
+
+ &.woocommerce-fulfillment-status-badge__fulfilled {
+ background-color: #c6e1c6;
+ color: #13550f;
+ }
+}
+
+.woocommerce-fulfillment-error-label {
+ display: flex;
+ flex-direction: row;
+ align-items: flex-start;
+ gap: 4px;
+ scroll-margin-top: 16px;
+ & &__icon {
+ width: 16px;
+ height: 16px;
+ svg {
+ path[stroke-width] {
+ stroke: var(--wc-red, #cc1818) !important;
+ }
+ path:not([stroke-width]) {
+ fill: var(--wc-red, #cc1818) !important;
+ }
+ }
+ }
+ & &__text {
+ font-size: 12px;
+ line-height: 16px;
+ font-weight: 400;
+ letter-spacing: 0%;
+ vertical-align: middle;
+ color: var(--wc-red, #cc1818) !important;
+ }
+}
+
+.woocommerce-fulfillment-item-lock-container {
+ display: flex;
+ flex-direction: row;
+ justify-content: center;
+ align-items: center;
+ padding: 14px 0;
+}
+
+.woocommerce-fulfillment-lock-label {
+ display: flex;
+ flex-direction: row;
+ align-items: flex-start;
+ gap: 4px;
+ & &__icon {
+ width: 16px;
+ height: 16px;
+ svg {
+ path[stroke-width] {
+ stroke: #757575;
+ }
+ path:not([stroke-width]) {
+ fill: #757575;
+ }
+ }
+ }
+ & &__text {
+ font-size: 12px;
+ line-height: 16px;
+ font-weight: 400;
+ letter-spacing: 0%;
+ vertical-align: middle;
+ color: #757575;
+ }
+}
+
+a.fulfillments-trigger {
+ float: right;
+ height: 16px;
+ width: 16px;
+ padding: 4px 4px;
+ border: 2px solid transparent;
+ border-radius: 4px;
+ line-height: 16px;
+
+ svg {
+ fill: #2271b1;
+ }
+
+ &:hover {
+ svg {
+ fill: #135e96;
+ }
+ border: 2px solid var(--wp-admin-theme-color, #00a0d2);
+ }
+}
+
+.column-fulfillment_status,
+.column-shipment_tracking,
+.column-shipment_provider {
+ width: 14ch !important;
+ .fulfillment-status-wrapper {
+ display: flex;
+ flex-direction: row;
+ flex-wrap: nowrap;
+ align-items: center;
+ justify-content: space-between;
+ gap: 8px;
+ }
+}
+
+tr.type-shop_order.is-selected {
+ background-color: #3858e914;
+
+ th.check-column {
+ border-left: 3px solid #3858e9;
+ padding-left: calc(1em - 3px) !important;
+ }
+}
+
+.wc-order-fulfillment-badges {
+ width: auto;
+ display: flex;
+ gap: 12px;
+ .fulfillments-trigger {
+ margin-left: -8px;
+ svg {
+ fill: #949494;
+ }
+ &:hover {
+ svg {
+ fill: #000;
+ }
+ border-color: transparent;
+ }
+ }
+}
diff --git a/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/test-helper/global-mock.ts b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/test-helper/global-mock.ts
new file mode 100644
index 0000000000..63651c5ae8
--- /dev/null
+++ b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/test-helper/global-mock.ts
@@ -0,0 +1,70 @@
+/**
+ * Internal dependencies
+ */
+import '../global.d.ts';
+
+// Mock scrollIntoView method for testing
+Object.defineProperty( HTMLElement.prototype, 'scrollIntoView', {
+ value: jest.fn(),
+ writable: true,
+} );
+
+// This needs to be defined before importing the component
+global.window.wcFulfillmentSettings = {
+ providers: {
+ ups: {
+ label: 'UPS',
+ icon: '',
+ value: 'ups',
+ },
+ dhl: {
+ label: 'DHL',
+ icon: '',
+ value: 'dhl',
+ },
+ },
+ currency_symbols: {
+ USD: '$',
+ EUR: '€',
+ },
+ fulfillment_statuses: {
+ fulfilled: {
+ label: 'Fulfilled',
+ is_fulfilled: true,
+ background_color: '#f0f0f0',
+ text_color: '#6c757d',
+ },
+ unfulfilled: {
+ label: 'Unfulfilled',
+ is_fulfilled: false,
+ background_color: '#fff3cd',
+ text_color: '#856404',
+ },
+ },
+ order_fulfillment_statuses: {
+ fulfilled: {
+ label: 'Fulfilled',
+ is_fulfilled: true,
+ background_color: '#d4edda',
+ text_color: '#155724',
+ },
+ unfulfilled: {
+ label: 'Unfulfilled',
+ is_fulfilled: false,
+ background_color: '#f8d7da',
+ text_color: '#721c24',
+ },
+ partially_fulfilled: {
+ label: 'Partially Fulfilled',
+ is_fulfilled: false,
+ background_color: '#fff3cd',
+ text_color: '#856404',
+ },
+ no_fulfillments: {
+ label: 'No Fulfillments',
+ is_fulfilled: false,
+ background_color: '#f0f0f0',
+ text_color: '#6c757d',
+ },
+ },
+};
diff --git a/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/utils/fulfillment-utils.ts b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/utils/fulfillment-utils.ts
new file mode 100644
index 0000000000..37421efcb8
--- /dev/null
+++ b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/utils/fulfillment-utils.ts
@@ -0,0 +1,101 @@
+/**
+ * External dependencies
+ */
+import { dispatch, resolveSelect } from '@wordpress/data';
+import { __ } from '@wordpress/i18n';
+
+/**
+ * Internal dependencies
+ */
+import ShipmentProviders from '../data/shipment-providers';
+import { Fulfillment, FulfillmentItem, Order } from '../data/types';
+import { store as FulfillmentStore } from '../data/store';
+
+export function getFulfillmentMeta< T >(
+ fulfillment: Fulfillment | null,
+ metaKey: string,
+ defaultValue: T
+) {
+ if ( ! fulfillment ) {
+ return defaultValue;
+ }
+ const meta = fulfillment.meta_data.find(
+ ( _meta ) => _meta.key === metaKey
+ )?.value as T;
+ return meta ? meta : defaultValue;
+}
+
+export function getFulfillmentItems(
+ fulfillment: Fulfillment
+): Array< FulfillmentItem > {
+ return getFulfillmentMeta< Array< FulfillmentItem > >(
+ fulfillment,
+ '_items',
+ []
+ ) as Array< FulfillmentItem >;
+}
+
+export async function refreshOrderFulfillmentStatus( orderId: number ) {
+ dispatch( FulfillmentStore ).invalidateResolution( 'getOrder', [
+ orderId,
+ ] );
+ const order: Order | null = await resolveSelect(
+ FulfillmentStore
+ ).getOrder( orderId );
+ if ( order ) {
+ const order_status =
+ ( order.meta_data.find(
+ ( meta ) => meta.key === '_fulfillment_status'
+ )?.value as string ) ?? 'no_fulfillments';
+ const marker = document.querySelector(
+ `.order-${ orderId } td.fulfillment_status mark`
+ );
+ if ( marker ) {
+ const status = window.wcFulfillmentSettings
+ .order_fulfillment_statuses[ order_status ] || {
+ label: __( 'Unknown', 'woocommerce' ),
+ background_color: '#f8f9fa',
+ text_color: '#6c757d',
+ };
+ // Set content of the marker to the label of the status.
+ const textContainer = marker.querySelector( 'span' );
+ if ( textContainer ) {
+ textContainer.textContent = status.label;
+ } else {
+ // If the span is not found, create it and append it to the marker.
+ const span = document.createElement( 'span' );
+ span.textContent = status.label;
+ marker.replaceChildren( span );
+ }
+ // Set the style attribute of the marker.
+ marker.setAttribute(
+ 'style',
+ `background-color: ${ status.background_color }; color: ${ status.text_color };`
+ );
+ }
+ }
+}
+
+export function getFulfillmentLockState( fulfillment: Fulfillment ): {
+ isLocked: boolean;
+ reason: string;
+} {
+ const isLocked = getFulfillmentMeta< boolean >(
+ fulfillment,
+ '_is_locked',
+ false
+ );
+ const reason = getFulfillmentMeta< string >(
+ fulfillment,
+ '_lock_message',
+ ''
+ );
+ return { isLocked, reason };
+}
+
+export function findShipmentProviderName( key: string ) {
+ const shipmentProvider = ShipmentProviders.find(
+ ( provider ) => provider.value === key
+ );
+ return shipmentProvider ? shipmentProvider.label : '';
+}
diff --git a/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/utils/icons.tsx b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/utils/icons.tsx
new file mode 100644
index 0000000000..ad9043bbdd
--- /dev/null
+++ b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/utils/icons.tsx
@@ -0,0 +1,113 @@
+/**
+ * External dependencies
+ */
+import { Button } from '@wordpress/components';
+
+export const SearchIcon = () => (
+ <svg
+ width="12"
+ height="12"
+ viewBox="0 0 12 12"
+ fill="none"
+ xmlns="http://www.w3.org/2000/svg"
+ >
+ <path
+ d="M6.75 0.75C4.275 0.75 2.25 2.775 2.25 5.25C2.25 6.3 2.625 7.275 3.225 8.025L0.375 10.875L1.2 11.7L4.05 8.85C4.8 9.45 5.775 9.825 6.825 9.825C9.3 9.825 11.325 7.8 11.325 5.325C11.325 2.85 9.225 0.75 6.75 0.75ZM6.75 8.625C4.875 8.625 3.375 7.125 3.375 5.25C3.375 3.375 4.875 1.875 6.75 1.875C8.625 1.875 10.125 3.375 10.125 5.25C10.125 7.125 8.625 8.625 6.75 8.625Z"
+ fill="#1E1E1E"
+ />
+ </svg>
+);
+
+export const TruckIcon = () => (
+ <svg
+ width="18"
+ height="14"
+ viewBox="0 0 18 14"
+ fill="none"
+ xmlns="http://www.w3.org/2000/svg"
+ >
+ <path
+ fillRule="evenodd"
+ clipRule="evenodd"
+ d="M0.5 1.75C0.5 0.783502 1.2835 0 2.25 0L12.5 0V3H14.5607L18 6.43934V8.75C18 9.7165 17.2165 10.5 16.25 10.5H16.2377C16.2458 10.5822 16.25 10.6656 16.25 10.75C16.25 12.1307 15.1307 13.25 13.75 13.25C12.3693 13.25 11.25 12.1307 11.25 10.75C11.25 10.6656 11.2542 10.5822 11.2623 10.5H7.23766C7.24582 10.5822 7.25 10.6656 7.25 10.75C7.25 12.1307 6.13071 13.25 4.75 13.25C3.36929 13.25 2.25 12.1307 2.25 10.75C2.25 10.6656 2.25418 10.5822 2.26234 10.5H0.5V1.75ZM11 9V1.5H2.25C2.11193 1.5 2 1.61193 2 1.75V9H2.96464C3.41837 8.53716 4.05065 8.25 4.75 8.25C5.44935 8.25 6.08163 8.53716 6.53536 9H11ZM15.5354 9H16.25C16.3881 9 16.5 8.88807 16.5 8.75V7.06066L13.9393 4.5H12.5V8.58446C12.8677 8.37174 13.2946 8.25 13.75 8.25C14.4493 8.25 15.0816 8.53716 15.5354 9ZM3.7815 10.5C3.76094 10.5799 3.75 10.6637 3.75 10.75C3.75 11.3023 4.19772 11.75 4.75 11.75C5.30228 11.75 5.75 11.3023 5.75 10.75C5.75 10.6637 5.73906 10.5799 5.7185 10.5C5.60749 10.0687 5.21596 9.75 4.75 9.75C4.28404 9.75 3.89251 10.0687 3.7815 10.5ZM12.7815 10.5C12.7609 10.5799 12.75 10.6637 12.75 10.75C12.75 11.3023 13.1977 11.75 13.75 11.75C14.3023 11.75 14.75 11.3023 14.75 10.75C14.75 10.6637 14.7391 10.5799 14.7185 10.5C14.7144 10.4841 14.7099 10.4683 14.705 10.4526C14.5784 10.0456 14.1987 9.75 13.75 9.75C13.284 9.75 12.8925 10.0687 12.7815 10.5Z"
+ fill="#1E1E1E"
+ />
+ </svg>
+);
+
+export const PostListIcon = () => (
+ <svg
+ width="16"
+ height="16"
+ viewBox="0 0 16 16"
+ fill="none"
+ xmlns="http://www.w3.org/2000/svg"
+ >
+ <path
+ d="M14 1.5H2C1.86739 1.5 1.74021 1.55268 1.64645 1.64645C1.55268 1.74021 1.5 1.86739 1.5 2V14C1.5 14.1326 1.55268 14.2598 1.64645 14.3536C1.74021 14.4473 1.86739 14.5 2 14.5H14C14.1326 14.5 14.2598 14.4473 14.3536 14.3536C14.4473 14.2598 14.5 14.1326 14.5 14V2C14.5 1.86739 14.4473 1.74021 14.3536 1.64645C14.2598 1.55268 14.1326 1.5 14 1.5ZM2 0H14C14.5304 0 15.0391 0.210714 15.4142 0.585786C15.7893 0.960859 16 1.46957 16 2V14C16 14.5304 15.7893 15.0391 15.4142 15.4142C15.0391 15.7893 14.5304 16 14 16H2C1.46957 16 0.960859 15.7893 0.585786 15.4142C0.210714 15.0391 0 14.5304 0 14V2C0 1.46957 0.210714 0.960859 0.585786 0.585786C0.960859 0.210714 1.46957 0 2 0ZM3 5H4.5V6.5H3V5ZM4.5 9.5H3V11H4.5V9.5ZM6 5H13V6.5H6V5ZM13 9.5H6V11H13V9.5Z"
+ fill="#1E1E1E"
+ />
+ </svg>
+);
+
+export const EnvelopeIcon = () => (
+ <svg
+ width="18"
+ height="14"
+ viewBox="0 0 18 14"
+ fill="none"
+ xmlns="http://www.w3.org/2000/svg"
+ >
+ <path
+ fillRule="evenodd"
+ clipRule="evenodd"
+ d="M0 2C0 0.89543 0.895431 0 2 0H16C17.1046 0 18 0.895431 18 2V12C18 13.1046 17.1046 14 16 14H2C0.89543 14 0 13.1046 0 12V2ZM2 1.5H16C16.2761 1.5 16.5 1.72386 16.5 2V2.93754L9.00005 8.5625L1.5 2.93746V2C1.5 1.72386 1.72386 1.5 2 1.5ZM1.5 4.81246V12C1.5 12.2761 1.72386 12.5 2 12.5H16C16.2761 12.5 16.5 12.2761 16.5 12V4.81254L9.00005 10.4375L1.5 4.81246Z"
+ fill="#1E1E1E"
+ />
+ </svg>
+);
+
+export const CopyIcon = ( { copyText }: { copyText: string } ) => {
+ return (
+ <Button
+ size="small"
+ iconSize={ 14 }
+ onClick={ () => {
+ navigator.clipboard.writeText( copyText );
+ } }
+ icon={
+ <svg
+ width="14"
+ height="14"
+ viewBox="0 0 14 14"
+ fill="none"
+ xmlns="http://www.w3.org/2000/svg"
+ >
+ <path
+ fillRule="evenodd"
+ clipRule="evenodd"
+ d="M1.68815 1.5835H9.81315C9.87065 1.5835 9.91732 1.63016 9.91732 1.68766V9.81266C9.91732 9.84029 9.90634 9.86679 9.88681 9.88632C9.86727 9.90586 9.84078 9.91683 9.81315 9.91683H1.68815C1.66052 9.91683 1.63403 9.90586 1.61449 9.88632C1.59496 9.86679 1.58398 9.84029 1.58398 9.81266V1.68766C1.58398 1.63016 1.63065 1.5835 1.68815 1.5835ZM0.333984 1.68766C0.333984 0.940163 0.940651 0.333496 1.68815 0.333496H9.81315C10.5615 0.333496 11.1673 0.940163 11.1673 1.68766V9.81266C11.1673 10.561 10.5615 11.1668 9.81315 11.1668H1.68815C1.329 11.1668 0.984566 11.0242 0.730611 10.7702C0.476655 10.5162 0.333984 10.1718 0.333984 9.81266V1.68766ZM12.4173 11.401V3.901H13.6673V11.401C13.6673 12.6668 12.6423 13.6668 11.3765 13.6668H2.20898V12.4168H11.3765C11.9515 12.4168 12.4173 11.9768 12.4173 11.401Z"
+ fill="#949494"
+ />
+ </svg>
+ }
+ label={ 'Copy' }
+ __next40pxDefaultSize
+ />
+ );
+};
+
+export const EditIcon = () => (
+ <svg
+ width="16"
+ height="16"
+ viewBox="0 0 12 14"
+ fill="none"
+ xmlns="http://www.w3.org/2000/svg"
+ >
+ <path
+ d="M11.8333 2.83301L9.33329 0.333008L2.24996 7.41634L1.41663 10.7497L4.74996 9.91634L11.8333 2.83301ZM5.99996 12.4163H0.166626V13.6663H5.99996V12.4163Z"
+ fill="#1E1E1E"
+ />
+ </svg>
+);
diff --git a/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/utils/order-utils.ts b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/utils/order-utils.ts
new file mode 100644
index 0000000000..8d32f30abe
--- /dev/null
+++ b/plugins/woocommerce/client/admin/client/wp-admin-scripts/fulfillments/utils/order-utils.ts
@@ -0,0 +1,199 @@
+/**
+ * External dependencies
+ */
+import { range } from 'lodash';
+
+/**
+ * Internal dependencies
+ */
+import { Fulfillment, LineItem, Order, Refund } from '../data/types';
+import { getFulfillmentItems } from './fulfillment-utils';
+
+/**
+ * ItemSelection interface represents an item as a tree, and holds the checked state for each single quantity.
+ * It is used to manage the items in the order and fulfillments.
+ */
+export interface ItemSelection {
+ item_id: number;
+ item: LineItem;
+ selection: { index: number; checked: boolean }[];
+}
+
+/**
+ * Get the items from the order, with the quantity and checked status.
+ *
+ * @param order The order received from the API
+ * @return Array<ItemSelection> The items in the order
+ */
+export const getItemsFromOrder = ( order: Order ): ItemSelection[] => {
+ const items: ItemSelection[] = [];
+ order.line_items.forEach( ( item: LineItem ) => {
+ items.push( {
+ item_id: item.id,
+ item,
+ selection: range( item.quantity ).map( ( index ) => ( {
+ index,
+ checked: false,
+ } ) ),
+ } as ItemSelection );
+ } );
+ return items;
+};
+
+/**
+ * Get the items from the fulfillment, with the quantity and checked status.
+ *
+ * @param order The order received from the API
+ * @param fulfillment The fulfillment received from the API
+ * @return Array<ItemSelection> The items in the fulfillment
+ */
+export const getItemsFromFulfillment = (
+ order: Order,
+ fulfillment: Fulfillment
+): ItemSelection[] => {
+ const fulfillmentItems = getFulfillmentItems( fulfillment );
+ return fulfillmentItems.map( ( item ) => {
+ const orderItem = order.line_items.find(
+ ( lineItem ) => lineItem.id === item.item_id
+ );
+
+ return {
+ item_id: item.item_id,
+ item: orderItem ? orderItem : ( {} as LineItem ),
+ selection: range( item.qty ).map( ( index ) => ( {
+ index,
+ checked: true,
+ } ) ),
+ } as ItemSelection;
+ } );
+};
+
+export const getOrderItemsCount = ( order: Order ): number => {
+ return order.line_items.reduce( ( acc, item ) => {
+ return acc + item.quantity;
+ }, 0 );
+};
+
+/**
+ * Combine two arrays of items.
+ *
+ * @param items1 The first array of items
+ * @param items2 The second array of items
+ * @return Array<ItemSelection> The combined array of items
+ */
+export const combineItems = (
+ items1: ItemSelection[],
+ items2: ItemSelection[]
+): ItemSelection[] => {
+ const itemMap: Record< string, ItemSelection > = {};
+ items1.forEach( ( item ) => {
+ itemMap[ item.item_id ] = { ...item };
+ } );
+ items2.forEach( ( item ) => {
+ if ( itemMap[ item.item_id ] ) {
+ itemMap[ item.item_id ].selection = [
+ ...itemMap[ item.item_id ].selection,
+ ...item.selection,
+ ].map( ( selection, index ) => {
+ selection.index = index;
+ return selection;
+ } );
+ } else {
+ itemMap[ item.item_id ] = { ...item };
+ }
+ } );
+
+ return Object.values( itemMap );
+};
+
+/**
+ * Reduce the quantities of items in the first array by the quantities of items in the second array.
+ * If the quantity of an item in the first array is less than or equal to 0, it is removed from the array.
+ *
+ * @param items The first array of items
+ * @param itemsToReduce The second array of items
+ * @return Array<ItemSelection> The reduced array of items
+ */
+const reduceItems = (
+ items: ItemSelection[],
+ itemsToReduce: ItemSelection[]
+): ItemSelection[] => {
+ const itemMap: Record< string, ItemSelection > = {};
+ items.forEach( ( item ) => {
+ itemMap[ item.item_id ] = { ...item } as ItemSelection;
+ } );
+ itemsToReduce.forEach( ( item ) => {
+ if ( itemMap[ item.item_id ] ) {
+ // Reduce the selection count
+ itemMap[ item.item_id ].selection.splice(
+ 0,
+ item.selection.length
+ );
+ // Reorder the selection indices
+ itemMap[ item.item_id ].selection = itemMap[
+ item.item_id
+ ].selection.map( ( selection, index ) => {
+ selection.index = index;
+ return selection;
+ } );
+ } else {
+ itemMap[ item.item_id ] = { ...item } as ItemSelection;
+ }
+ } );
+
+ return Object.values( itemMap );
+};
+
+/**
+ * Get the items that are not in any fulfillment.
+ * If there are no fulfillments, return all items from the order.
+ *
+ * @param fulfillments The array of fulfillments
+ * @param order The order received from the API
+ * @return Array<ItemSelection> The items not in any fulfillment
+ */
+export const getItemsNotInAnyFulfillment = (
+ fulfillments: Fulfillment[],
+ order: Order,
+ refunds: Refund[] = []
+): ItemSelection[] => {
+ let itemsFromOrder = getItemsFromOrder( order );
+
+ if ( refunds.length > 0 ) {
+ const itemsRefunded = refunds.reduce( ( acc, refund ) => {
+ const refundedItems = refund.line_items.map(
+ ( item: LineItem ) => ( {
+ // Refunded items have a different item_id, find the original item in the order.
+ item_id:
+ itemsFromOrder.find(
+ ( orderItem ) =>
+ orderItem.item.product_id === item.product_id
+ )?.item_id || item.id,
+ item,
+ selection: range( -item.quantity ).map( ( index ) => ( {
+ index,
+ checked: true,
+ } ) ),
+ } )
+ );
+ return combineItems( acc, refundedItems );
+ }, [] as ItemSelection[] );
+
+ // Reduce the refunded items from the order items.
+ itemsFromOrder = reduceItems( itemsFromOrder, itemsRefunded );
+ }
+
+ if ( fulfillments.length > 0 ) {
+ // If there are fulfillments, combine the items from all fulfillments and reduce them from the order items.
+ const itemsInAnyFulfillment = fulfillments.reduce(
+ ( acc, fulfillment ) => {
+ const items = getItemsFromFulfillment( order, fulfillment );
+ return combineItems( acc, items );
+ },
+ [] as ItemSelection[]
+ );
+ itemsFromOrder = reduceItems( itemsFromOrder, itemsInAnyFulfillment );
+ }
+
+ return itemsFromOrder.filter( ( item ) => item.selection.length > 0 );
+};
diff --git a/plugins/woocommerce/client/legacy/css/admin.scss b/plugins/woocommerce/client/legacy/css/admin.scss
index f874cdc9df..0bcc83c7d4 100644
--- a/plugins/woocommerce/client/legacy/css/admin.scss
+++ b/plugins/woocommerce/client/legacy/css/admin.scss
@@ -1892,6 +1892,20 @@ ul.wc_coupon_list_block {
font-size: 16px;
}
+ .order_data_header {
+ display: flex;
+ flex-direction: row;
+ justify-content: space-between;
+ gap: 16px;
+ }
+
+ @media screen and (max-width: 1280px) {
+ .order_data_header {
+ flex-direction: column;
+ gap: 24px;
+ }
+ }
+
.order_data_column_container {
clear: both;
@@ -3180,7 +3194,7 @@ ul.wc_coupon_list_block {
}
}
-.order-status {
+.order-status, .fulfillment-status {
display: inline-flex;
line-height: 2.5em;
color: #454545;
diff --git a/plugins/woocommerce/includes/admin/meta-boxes/class-wc-meta-box-order-data.php b/plugins/woocommerce/includes/admin/meta-boxes/class-wc-meta-box-order-data.php
index 25157c614d..b040ea8013 100644
--- a/plugins/woocommerce/includes/admin/meta-boxes/class-wc-meta-box-order-data.php
+++ b/plugins/woocommerce/includes/admin/meta-boxes/class-wc-meta-box-order-data.php
@@ -214,70 +214,86 @@ class WC_Meta_Box_Order_Data {
<input name="post_title" type="hidden" value="<?php echo esc_attr( empty( $order->get_title() ) ? __( 'Order', 'woocommerce' ) : $order->get_title() ); ?>" />
<input name="post_status" type="hidden" value="<?php echo esc_attr( $order->get_status() ); ?>" />
<div id="order_data" class="panel woocommerce-order-data">
- <h2 class="woocommerce-order-data__heading">
- <?php
-
- printf(
- /* translators: 1: order type 2: order number */
- esc_html__( '%1$s #%2$s details', 'woocommerce' ),
- esc_html( $order_type_object->labels->singular_name ),
- esc_html( $order->get_order_number() )
- );
-
- ?>
- </h2>
- <p class="woocommerce-order-data__meta order_number">
- <?php
-
- $meta_list = array();
-
- if ( $payment_method && 'other' !== $payment_method ) {
- $payment_method_string = sprintf(
- /* translators: %s: payment method */
- __( 'Payment via %s', 'woocommerce' ),
- esc_html( isset( $payment_gateways[ $payment_method ] ) ? $payment_gateways[ $payment_method ]->get_title() : $payment_method )
- );
-
- $transaction_id = $order->get_transaction_id();
- if ( $transaction_id ) {
-
- $to_add = null;
- if ( isset( $payment_gateways[ $payment_method ] ) ) {
- $url = $payment_gateways[ $payment_method ]->get_transaction_url( $order );
- if ( $url ) {
- $to_add .= ' (<a href="' . esc_url( $url ) . '" target="_blank">' . esc_html( $transaction_id ) . '</a>)';
+ <div class="order_data_header">
+ <div class="order_data_header_column">
+ <h2 class="woocommerce-order-data__heading">
+ <?php
+
+ printf(
+ /* translators: 1: order type 2: order number */
+ esc_html__( '%1$s #%2$s details', 'woocommerce' ),
+ esc_html( $order_type_object->labels->singular_name ),
+ esc_html( $order->get_order_number() )
+ );
+
+ ?>
+ </h2>
+ <p class="woocommerce-order-data__meta order_number">
+ <?php
+
+ $meta_list = array();
+
+ if ( $payment_method && 'other' !== $payment_method ) {
+ $payment_method_string = sprintf(
+ /* translators: %s: payment method */
+ __( 'Payment via %s', 'woocommerce' ),
+ esc_html( isset( $payment_gateways[ $payment_method ] ) ? $payment_gateways[ $payment_method ]->get_title() : $payment_method )
+ );
+
+ $transaction_id = $order->get_transaction_id();
+ if ( $transaction_id ) {
+
+ $to_add = null;
+ if ( isset( $payment_gateways[ $payment_method ] ) ) {
+ $url = $payment_gateways[ $payment_method ]->get_transaction_url( $order );
+ if ( $url ) {
+ $to_add .= ' (<a href="' . esc_url( $url ) . '" target="_blank">' . esc_html( $transaction_id ) . '</a>)';
+ }
+ }
+
+ $to_add = $to_add ?? ' (' . esc_html( $transaction_id ) . ')';
+ $payment_method_string .= $to_add;
}
+
+ $meta_list[] = $payment_method_string;
}
- $to_add = $to_add ?? ' (' . esc_html( $transaction_id ) . ')';
- $payment_method_string .= $to_add;
- }
-
- $meta_list[] = $payment_method_string;
- }
-
- if ( $order->get_date_paid() ) {
- $meta_list[] = sprintf(
- /* translators: 1: date 2: time */
- __( 'Paid on %1$s @ %2$s', 'woocommerce' ),
- wc_format_datetime( $order->get_date_paid() ),
- wc_format_datetime( $order->get_date_paid(), get_option( 'time_format' ) )
- );
- }
-
- $ip_address = $order->get_customer_ip_address();
- if ( $ip_address ) {
- $meta_list[] = sprintf(
- /* translators: %s: IP address */
- __( 'Customer IP: %s', 'woocommerce' ),
- '<span class="woocommerce-Order-customerIP">' . esc_html( $ip_address ) . '</span>'
- );
- }
-
- echo wp_kses_post( implode( '. ', $meta_list ) );
-
- ?>
- </p>
+ if ( $order->get_date_paid() ) {
+ $meta_list[] = sprintf(
+ /* translators: 1: date 2: time */
+ __( 'Paid on %1$s @ %2$s', 'woocommerce' ),
+ wc_format_datetime( $order->get_date_paid() ),
+ wc_format_datetime( $order->get_date_paid(), get_option( 'time_format' ) )
+ );
+ }
+
+ $ip_address = $order->get_customer_ip_address();
+ if ( $ip_address ) {
+ $meta_list[] = sprintf(
+ /* translators: %s: IP address */
+ __( 'Customer IP: %s', 'woocommerce' ),
+ '<span class="woocommerce-Order-customerIP">' . esc_html( $ip_address ) . '</span>'
+ );
+ }
+
+ echo wp_kses_post( implode( '. ', $meta_list ) );
+
+ ?>
+ </p>
+ </div>
+ <div class="order_data_header_column">
+ <?php
+ /**
+ * Hook allowing extenders to render custom content
+ * besides the Order header.
+ *
+ * @param $order WC_Order The order object being displayed.
+ * @since 9.9.0
+ */
+ do_action( 'woocommerce_admin_order_data_header_right', $order );
+ ?>
+ </div>
+ </div>
<?php
/**
* Hook allowing extenders to render custom content
@@ -367,7 +383,7 @@ class WC_Meta_Box_Order_Data {
$customer = new WC_Customer( $user_id );
/* translators: 1: user display name 2: user ID 3: user email */
$user_string = sprintf(
- /* translators: 1: customer name, 2 customer id, 3: customer email */
+ /* translators: 1: customer name, 2 customer id, 3: customer email */
esc_html__( '%1$s (#%2$s – %3$s)', 'woocommerce' ),
$customer->get_first_name() . ' ' . $customer->get_last_name(),
$customer->get_id(),
diff --git a/plugins/woocommerce/includes/class-wc-emails.php b/plugins/woocommerce/includes/class-wc-emails.php
index dda9547768..b0f6e58cf4 100644
--- a/plugins/woocommerce/includes/class-wc-emails.php
+++ b/plugins/woocommerce/includes/class-wc-emails.php
@@ -14,6 +14,7 @@ use Automattic\Jetpack\Constants;
use Automattic\WooCommerce\Blocks\Package;
use Automattic\WooCommerce\Blocks\Domain\Services\CheckoutFields;
use Automattic\WooCommerce\Enums\ProductType;
+use Automattic\WooCommerce\Internal\Fulfillments\Fulfillment;
use Automattic\WooCommerce\Utilities\FeaturesUtil;
defined( 'ABSPATH' ) || exit;
@@ -240,6 +241,12 @@ class WC_Emails {
add_action( 'woocommerce_email_customer_details', array( $this, 'additional_checkout_fields' ), 30, 3 );
add_action( 'woocommerce_email_customer_address_section', array( $this, 'additional_address_fields' ), 30, 4 );
+ if ( FeaturesUtil::feature_is_enabled( 'fulfillments' ) ) {
+ // Fulfillment details and meta.
+ add_action( 'woocommerce_email_fulfillment_details', array( $this, 'fulfillment_details' ), 10, 5 );
+ add_action( 'woocommerce_email_fulfillment_meta', array( $this, 'fulfillment_meta' ), 30, 4 );
+ }
+
// Hooks for sending emails during store events.
add_action( 'woocommerce_low_stock_notification', array( $this, 'low_stock' ) );
add_action( 'woocommerce_no_stock_notification', array( $this, 'no_stock' ) );
@@ -284,6 +291,12 @@ class WC_Emails {
$this->emails['WC_Email_Customer_POS_Refunded_Order'] = include __DIR__ . '/emails/class-wc-email-customer-pos-refunded-order.php';
}
+ if ( FeaturesUtil::feature_is_enabled( 'fulfillments' ) ) {
+ $this->emails['WC_Email_Customer_Fulfillment_Created'] = include __DIR__ . '/emails/class-wc-email-customer-fulfillment-created.php';
+ $this->emails['WC_Email_Customer_Fulfillment_Updated'] = include __DIR__ . '/emails/class-wc-email-customer-fulfillment-updated.php';
+ $this->emails['WC_Email_Customer_Fulfillment_Deleted'] = include __DIR__ . '/emails/class-wc-email-customer-fulfillment-deleted.php';
+ }
+
/**
* Filter the email classes.
*
@@ -626,6 +639,78 @@ class WC_Emails {
}
}
+ /**
+ * Show the fulfillment details
+ *
+ * @param WC_Order $order Order instance.
+ * @param Fulfillment $fulfillment Fulfillment instance.
+ * @param bool $sent_to_admin If should sent to admin.
+ * @param bool $plain_text If is plain text email.
+ * @param string $email Email address.
+ */
+ public function fulfillment_details( $order, $fulfillment, $sent_to_admin = false, $plain_text = false, $email = '' ) {
+ if ( $plain_text ) {
+ wc_get_template(
+ 'emails/plain/email-fulfillment-details.php',
+ array(
+ 'order' => $order,
+ 'fulfillment' => $fulfillment,
+ 'sent_to_admin' => $sent_to_admin,
+ 'plain_text' => $plain_text,
+ 'email' => $email,
+ )
+ );
+ } else {
+ wc_get_template(
+ 'emails/email-fulfillment-details.php',
+ array(
+ 'order' => $order,
+ 'fulfillment' => $fulfillment,
+ 'sent_to_admin' => $sent_to_admin,
+ 'plain_text' => $plain_text,
+ 'email' => $email,
+ )
+ );
+ }
+ }
+
+ /**
+ * Add fulfillment meta to email templates.
+ *
+ * @param WC_Order $order Order instance.
+ * @param Fulfillment $fulfillment Fulfillment instance.
+ * @param bool $sent_to_admin If should sent to admin.
+ * @param bool $plain_text If is plain text email.
+ */
+ public function fulfillment_meta( $order, $fulfillment, $sent_to_admin = false, $plain_text = false ) {
+ $fields = $fulfillment->get_meta_data();
+ $public_fields = array_filter(
+ $fields,
+ function ( $field ) {
+ return ! str_starts_with( $field->key, '_' );
+ }
+ );
+
+ if ( 0 < count( $public_fields ) ) {
+
+ foreach ( $public_fields as $field ) {
+ if ( isset( $field->key ) && isset( $field->value ) && $field->value ) {
+ /**
+ * Allows developers to translate the fulfillment meta key for display in emails.
+ *
+ * @since 10.1.0
+ */
+ $meta_key_translation = apply_filters( 'woocommerce_fulfillment_translate_meta_key', $field->key );
+ if ( $plain_text ) {
+ echo esc_attr( $meta_key_translation ) . ': ' . esc_attr( $field->value ) . PHP_EOL;
+ } else {
+ echo '<p><strong>' . esc_attr( $meta_key_translation ) . ':</strong> ' . esc_attr( $field->value ) . '</p>';
+ }
+ }
+ }
+ }
+ }
+
/**
* Is customer detail field valid?
*
@@ -891,7 +976,7 @@ class WC_Emails {
$subject = sprintf( '[%s] %s', $this->get_blogname(), __( 'Product low in stock', 'woocommerce' ) );
$message = sprintf(
- /* translators: 1: product name 2: items in stock */
+ /* translators: 1: product name 2: items in stock */
__( '%1$s is low in stock. There are %2$d left.', 'woocommerce' ),
html_entity_decode( wp_strip_all_tags( $product->get_formatted_name() ), ENT_QUOTES, get_bloginfo( 'charset' ) ),
html_entity_decode( wp_strip_all_tags( $product->get_stock_quantity() ) )
@@ -900,50 +985,50 @@ class WC_Emails {
$this->add_email_sender_filters();
wp_mail(
- /**
- * Filter the recipient of the low stock notification email.
- *
- * @since 3.0.0
- * @param string $recipient The recipient email address.
- * @param WC_Product $product Product instance.
- * @param null $null Unused.
- */
+ /**
+ * Filter the recipient of the low stock notification email.
+ *
+ * @since 3.0.0
+ * @param string $recipient The recipient email address.
+ * @param WC_Product $product Product instance.
+ * @param null $null Unused.
+ */
apply_filters( 'woocommerce_email_recipient_low_stock', get_option( 'woocommerce_stock_email_recipient' ), $product, null ),
/**
- * Filter the subject of the low stock notification email.
- *
- * @since 3.0.0
- * @param string $subject The email subject.
- * @param WC_Product $product Product instance.
- * @param null $null Unused.
- */
+ * Filter the subject of the low stock notification email.
+ *
+ * @since 3.0.0
+ * @param string $subject The email subject.
+ * @param WC_Product $product Product instance.
+ * @param null $null Unused.
+ */
apply_filters( 'woocommerce_email_subject_low_stock', $subject, $product, null ),
/**
- * Filter the content of the low stock notification email.
- *
- * @since 3.0.0
- * @param string $message The email content.
- * @param WC_Product $product Product instance.
- * @param null $null Unused.
- */
+ * Filter the content of the low stock notification email.
+ *
+ * @since 3.0.0
+ * @param string $message The email content.
+ * @param WC_Product $product Product instance.
+ * @param null $null Unused.
+ */
apply_filters( 'woocommerce_email_content_low_stock', $message, $product ),
/**
- * Filter the headers of the low stock notification email.
- *
- * @since 3.0.0
- * @param string $headers The email headers.
- * @param WC_Product $product Product instance.
- * @param null $null Unused.
- */
+ * Filter the headers of the low stock notification email.
+ *
+ * @since 3.0.0
+ * @param string $headers The email headers.
+ * @param WC_Product $product Product instance.
+ * @param null $null Unused.
+ */
apply_filters( 'woocommerce_email_headers', '', 'low_stock', $product, null ),
/**
- * Filter the attachments of the low stock notification email.
- *
- * @since 3.0.0
- * @param array $attachments The email attachments.
- * @param WC_Product $product Product instance.
- * @param null $null Unused.
- */
+ * Filter the attachments of the low stock notification email.
+ *
+ * @since 3.0.0
+ * @param array $attachments The email attachments.
+ * @param WC_Product $product Product instance.
+ * @param null $null Unused.
+ */
apply_filters( 'woocommerce_email_attachments', array(), 'low_stock', $product, null )
);
@@ -986,50 +1071,50 @@ class WC_Emails {
$this->add_email_sender_filters();
wp_mail(
- /**
- * Filter the recipient of the no stock notification email.
- *
- * @since 3.0.0
- * @param string $recipient The recipient email address.
- * @param WC_Product $product Product instance.
- * @param null $null Unused.
- */
+ /**
+ * Filter the recipient of the no stock notification email.
+ *
+ * @since 3.0.0
+ * @param string $recipient The recipient email address.
+ * @param WC_Product $product Product instance.
+ * @param null $null Unused.
+ */
apply_filters( 'woocommerce_email_recipient_no_stock', get_option( 'woocommerce_stock_email_recipient' ), $product, null ),
/**
- * Filter the subject of the no stock notification email.
- *
- * @since 3.0.0
- * @param string $subject The email subject.
- * @param WC_Product $product Product instance.
- * @param null $null Unused.
- */
+ * Filter the subject of the no stock notification email.
+ *
+ * @since 3.0.0
+ * @param string $subject The email subject.
+ * @param WC_Product $product Product instance.
+ * @param null $null Unused.
+ */
apply_filters( 'woocommerce_email_subject_no_stock', $subject, $product, null ),
/**
- * Filter the content of the no stock notification email.
- *
- * @since 3.0.0
- * @param string $message The email content.
- * @param WC_Product $product Product instance.
- * @param null $null Unused.
- */
+ * Filter the content of the no stock notification email.
+ *
+ * @since 3.0.0
+ * @param string $message The email content.
+ * @param WC_Product $product Product instance.
+ * @param null $null Unused.
+ */
apply_filters( 'woocommerce_email_content_no_stock', $message, $product ),
/**
- * Filter the headers of the no stock notification email.
- *
- * @since 3.0.0
- * @param string $headers The email headers.
- * @param WC_Product $product Product instance.
- * @param null $null Unused.
- */
+ * Filter the headers of the no stock notification email.
+ *
+ * @since 3.0.0
+ * @param string $headers The email headers.
+ * @param WC_Product $product Product instance.
+ * @param null $null Unused.
+ */
apply_filters( 'woocommerce_email_headers', '', 'no_stock', $product, null ),
/**
- * Filter the attachments of the no stock notification email.
- *
- * @since 3.0.0
- * @param array $attachments The email attachments.
- * @param WC_Product $product Product instance.
- * @param null $null Unused.
- */
+ * Filter the attachments of the no stock notification email.
+ *
+ * @since 3.0.0
+ * @param array $attachments The email attachments.
+ * @param WC_Product $product Product instance.
+ * @param null $null Unused.
+ */
apply_filters( 'woocommerce_email_attachments', array(), 'no_stock', $product, null )
);
@@ -1053,10 +1138,10 @@ class WC_Emails {
$order = wc_get_order( $args['order_id'] );
if (
- ! $args['product'] ||
- ! is_object( $args['product'] ) ||
- ! $args['quantity'] ||
- ! $order
+ ! $args['product'] ||
+ ! is_object( $args['product'] ) ||
+ ! $args['quantity'] ||
+ ! $order
) {
return;
}
@@ -1071,50 +1156,50 @@ class WC_Emails {
$this->add_email_sender_filters();
wp_mail(
- /**
- * Filter the recipient of the backorder notification email.
- *
- * @since 3.0.0
- * @param string $recipient The recipient email address.
- * @param array $args Arguments.
- * @param null $null Unused.
- */
+ /**
+ * Filter the recipient of the backorder notification email.
+ *
+ * @since 3.0.0
+ * @param string $recipient The recipient email address.
+ * @param array $args Arguments.
+ * @param null $null Unused.
+ */
apply_filters( 'woocommerce_email_recipient_backorder', get_option( 'woocommerce_stock_email_recipient' ), $args, null ),
/**
- * Filter the subject of the backorder notification email.
- *
- * @since 3.0.0
- * @param string $subject The email subject.
- * @param array $args Arguments.
- * @param null $null Unused.
- */
+ * Filter the subject of the backorder notification email.
+ *
+ * @since 3.0.0
+ * @param string $subject The email subject.
+ * @param array $args Arguments.
+ * @param null $null Unused.
+ */
apply_filters( 'woocommerce_email_subject_backorder', $subject, $args, null ),
/**
- * Filter the content of the backorder notification email.
- *
- * @since 3.0.0
- * @param string $message The email content.
- * @param array $args Arguments.
- * @param null $null Unused.
- */
+ * Filter the content of the backorder notification email.
+ *
+ * @since 3.0.0
+ * @param string $message The email content.
+ * @param array $args Arguments.
+ * @param null $null Unused.
+ */
apply_filters( 'woocommerce_email_content_backorder', $message, $args ),
/**
- * Filter the headers of the backorder notification email.
- *
- * @since 3.0.0
- * @param string $headers The email headers.
- * @param array $args Arguments.
- * @param null $null Unused.
- */
+ * Filter the headers of the backorder notification email.
+ *
+ * @since 3.0.0
+ * @param string $headers The email headers.
+ * @param array $args Arguments.
+ * @param null $null Unused.
+ */
apply_filters( 'woocommerce_email_headers', '', 'backorder', $args, null ),
/**
- * Filter the attachments of the backorder notification email.
- *
- * @since 3.0.0
- * @param array $attachments The email attachments.
- * @param array $args Arguments.
- * @param null $null Unused.
- */
+ * Filter the attachments of the backorder notification email.
+ *
+ * @since 3.0.0
+ * @param array $attachments The email attachments.
+ * @param array $args Arguments.
+ * @param null $null Unused.
+ */
apply_filters( 'woocommerce_email_attachments', array(), 'backorder', $args, null )
);
diff --git a/plugins/woocommerce/includes/class-wc-install.php b/plugins/woocommerce/includes/class-wc-install.php
index 1d4aa50805..4e65792ce3 100644
--- a/plugins/woocommerce/includes/class-wc-install.php
+++ b/plugins/woocommerce/includes/class-wc-install.php
@@ -1951,7 +1951,7 @@ CREATE TABLE {$wpdb->prefix}wc_category_lookup (
PRIMARY KEY (category_tree_id,category_id)
) $collate;
$hpos_table_schema;
- ";
+";
return $tables;
}
@@ -1998,6 +1998,8 @@ $hpos_table_schema;
"{$wpdb->prefix}wc_admin_note_actions",
"{$wpdb->prefix}wc_customer_lookup",
"{$wpdb->prefix}wc_category_lookup",
+ "{$wpdb->prefix}wc_order_fulfillments",
+ "{$wpdb->prefix}wc_order_fulfillment_meta",
// HPOS.
"{$wpdb->prefix}wc_orders",
diff --git a/plugins/woocommerce/includes/class-woocommerce.php b/plugins/woocommerce/includes/class-woocommerce.php
index 93050eab01..e63276fe30 100644
--- a/plugins/woocommerce/includes/class-woocommerce.php
+++ b/plugins/woocommerce/includes/class-woocommerce.php
@@ -349,6 +349,7 @@ final class WooCommerce {
$container->get( Automattic\WooCommerce\Internal\Admin\Settings\PaymentsProviders\WooPayments\WooPaymentsController::class )->register();
$container->get( Automattic\WooCommerce\Internal\Utilities\LegacyRestApiStub::class )->register();
$container->get( Automattic\WooCommerce\Internal\Email\EmailStyleSync::class )->register();
+ $container->get( Automattic\WooCommerce\Internal\Fulfillments\FulfillmentsController::class )->register();
// Classes inheriting from RestApiControllerBase.
$container->get( Automattic\WooCommerce\Internal\ReceiptRendering\ReceiptRenderingRestController::class )->register();
diff --git a/plugins/woocommerce/includes/emails/class-wc-email-customer-fulfillment-created.php b/plugins/woocommerce/includes/emails/class-wc-email-customer-fulfillment-created.php
new file mode 100644
index 0000000000..51c3eaf214
--- /dev/null
+++ b/plugins/woocommerce/includes/emails/class-wc-email-customer-fulfillment-created.php
@@ -0,0 +1,212 @@
+<?php
+/**
+ * Class WC_Email_Customer_Fulfillment_Created file.
+ *
+ * @package WooCommerce\Emails
+ */
+
+use Automattic\WooCommerce\Internal\Fulfillments\Fulfillment;
+
+if ( ! defined( 'ABSPATH' ) ) {
+ exit; // Exit if accessed directly.
+}
+
+if ( ! class_exists( 'WC_Email_Customer_Fulfillment_Created', false ) ) :
+
+ /**
+ * Customer Fulfillment Created Email.
+ *
+ * Fulfillment created emails are sent to the customer when the merchant creates a fulfillment for the order, and marks it as fulfilled. The notification isn’t sent for draft fulfillments.
+ *
+ * @class WC_Email_Customer_Fulfillment_Created
+ * @version 1.0.0
+ * @package WooCommerce\Classes\Emails
+ * @extends WC_Email
+ */
+ class WC_Email_Customer_Fulfillment_Created extends WC_Email {
+ /**
+ * Fulfillment object.
+ *
+ * @var Fulfillment|null
+ */
+ private $fulfillment;
+
+ /**
+ * Constructor.
+ */
+ public function __construct() {
+ $this->id = 'customer_fulfillment_created';
+ $this->customer_email = true;
+ $this->title = __( 'Fulfillment created', 'woocommerce' );
+ $this->template_html = 'emails/customer-fulfillment-created.php';
+ $this->template_plain = 'emails/plain/customer-fulfillment-created.php';
+ $this->placeholders = array(
+ '{order_date}' => '',
+ '{order_number}' => '',
+ );
+
+ // Triggers for this email.
+ add_action( 'woocommerce_fulfillment_created_notification', array( $this, 'trigger' ), 10, 3 );
+
+ // Call parent constructor.
+ parent::__construct();
+
+ $this->description = __( 'Fulfillment created emails are sent to the customer when the merchant creates a fulfillment for the order, and marks it as fulfilled. The notification isn’t sent for draft fulfillments.', 'woocommerce' );
+ }
+
+ /**
+ * Trigger the sending of this email.
+ *
+ * @param int $order_id The order ID.
+ * @param Fulfillment $fulfillment The fulfillment.
+ * @param WC_Order|false $order Order object.
+ */
+ public function trigger( $order_id, $fulfillment, $order = false ) {
+ $this->setup_locale();
+
+ if ( $order_id && ! is_a( $order, 'WC_Order' ) ) {
+ $order = wc_get_order( $order_id );
+ }
+
+ if ( is_a( $order, 'WC_Order' ) ) {
+ $this->object = $order;
+ $this->fulfillment = $fulfillment;
+ $this->recipient = $this->object->get_billing_email();
+ $this->placeholders['{order_date}'] = wc_format_datetime( $this->object->get_date_created() );
+ $this->placeholders['{order_number}'] = $this->object->get_order_number();
+ }
+
+ if ( $this->is_enabled() && $this->get_recipient() ) {
+ $this->send( $this->get_recipient(), $this->get_subject(), $this->get_content(), $this->get_headers(), $this->get_attachments() );
+ }
+
+ $this->restore_locale();
+ }
+
+ /**
+ * Get email subject.
+ *
+ * @since 3.1.0
+ * @return string
+ */
+ public function get_default_subject() {
+ return __( 'An item from {site_title} order {order_number} has been fulfilled!', 'woocommerce' );
+ }
+
+ /**
+ * Get email heading.
+ *
+ * @since 3.1.0
+ * @return string
+ */
+ public function get_default_heading() {
+ return __( 'Your item is on the way!', 'woocommerce' );
+ }
+
+ /**
+ * Get content html.
+ *
+ * @return string
+ */
+ public function get_content_html() {
+ $this->maybe_init_fulfillment_for_preview( $this->object );
+ return wc_get_template_html(
+ $this->template_html,
+ array(
+ 'order' => $this->object,
+ 'fulfillment' => $this->fulfillment,
+ 'email_heading' => $this->get_heading(),
+ 'additional_content' => $this->get_additional_content(),
+ 'sent_to_admin' => false,
+ 'plain_text' => false,
+ 'email' => $this,
+ )
+ );
+ }
+
+ /**
+ * Get content plain.
+ *
+ * @return string
+ */
+ public function get_content_plain() {
+ $this->maybe_init_fulfillment_for_preview( $this->object );
+ return wc_get_template_html(
+ $this->template_plain,
+ array(
+ 'order' => $this->object,
+ 'fulfillment' => $this->fulfillment,
+ 'email_heading' => $this->get_heading(),
+ 'additional_content' => $this->get_additional_content(),
+ 'sent_to_admin' => false,
+ 'plain_text' => true,
+ 'email' => $this,
+ )
+ );
+ }
+
+ /**
+ * Default content to show below main email content.
+ *
+ * @since 3.7.0
+ * @return string
+ */
+ public function get_default_additional_content() {
+ return __( 'Please note that couriers may need some time to provide the latest shipping information.', 'woocommerce' );
+ }
+
+ /**
+ * Initialize fulfillment for email preview.
+ *
+ * This method sets up a dummy fulfillment object when the email is being previewed in the admin.
+ *
+ * @param WC_Order $order The order object.
+ *
+ * @since 10.1.0
+ */
+ private function maybe_init_fulfillment_for_preview( $order ) {
+ /**
+ * Filter to determine if this is an email preview.
+ *
+ * @since 9.8.0
+ */
+ $is_email_preview = apply_filters( 'woocommerce_is_email_preview', false );
+ if ( $is_email_preview ) {
+ // If this is a preview, we need to set up a dummy fulfillment object.
+ $this->fulfillment = new Fulfillment();
+ $this->fulfillment->set_items(
+ array_map(
+ function ( $item ) {
+ return array(
+ 'item_id' => $item->get_id(),
+ 'qty' => 1,
+ );
+ },
+ $order->get_items()
+ )
+ );
+
+ // Some private meta data to simulate a real fulfillment.
+ $this->fulfillment->add_meta_data( '_tracking_number', '123456789' );
+ $this->fulfillment->add_meta_data( '_shipment_provider', 'dhl' );
+ $this->fulfillment->add_meta_data( '_tracking_url', 'https://www.dhl.com/tracking/123456789' );
+ // Some public data to simulate a real fulfillment.
+ $this->fulfillment->add_meta_data( 'service', 'Standard Shipping' );
+ $this->fulfillment->add_meta_data( 'expected_delivery', '2025-06-30' );
+
+ // Add translations for metadata keys.
+ add_filter(
+ 'woocommerce_fulfillment_meta_key_translations',
+ function ( $keys ) {
+ $keys['service'] = __( 'Service', 'woocommerce' );
+ $keys['expected_delivery'] = __( 'Expected Delivery', 'woocommerce' );
+ return $keys;
+ }
+ );
+ }
+ }
+ }
+
+endif;
+
+return new WC_Email_Customer_Fulfillment_Created();
diff --git a/plugins/woocommerce/includes/emails/class-wc-email-customer-fulfillment-deleted.php b/plugins/woocommerce/includes/emails/class-wc-email-customer-fulfillment-deleted.php
new file mode 100644
index 0000000000..674d4b4bb5
--- /dev/null
+++ b/plugins/woocommerce/includes/emails/class-wc-email-customer-fulfillment-deleted.php
@@ -0,0 +1,197 @@
+<?php
+/**
+ * Class WC_Email_Customer_Fulfillment_Deleted file.
+ *
+ * @package WooCommerce\Emails
+ */
+
+use Automattic\WooCommerce\Internal\Fulfillments\Fulfillment;
+
+if ( ! defined( 'ABSPATH' ) ) {
+ exit; // Exit if accessed directly.
+}
+
+if ( ! class_exists( 'WC_Email_Customer_Fulfillment_Deleted', false ) ) :
+
+ /**
+ * Customer Fulfillment Deleted Email.
+ *
+ * Fulfillment deleted emails are sent to the customer when the merchant cancels an already fulfilled fulfillment. The notification isn’t sent for draft fulfillments.
+ *
+ * @class WC_Email_Customer_Fulfillment_Deleted
+ * @version 1.0.0
+ * @package WooCommerce\Classes\Emails
+ * @extends WC_Email
+ */
+ class WC_Email_Customer_Fulfillment_Deleted extends WC_Email {
+ /**
+ * Fulfillment object.
+ *
+ * @var Fulfillment|null
+ */
+ private $fulfillment;
+
+ /**
+ * Constructor.
+ */
+ public function __construct() {
+ $this->id = 'customer_fulfillment_deleted';
+ $this->customer_email = true;
+ $this->title = __( 'Fulfillment deleted', 'woocommerce' );
+ $this->template_html = 'emails/customer-fulfillment-deleted.php';
+ $this->template_plain = 'emails/plain/customer-fulfillment-deleted.php';
+ $this->placeholders = array(
+ '{order_date}' => '',
+ '{order_number}' => '',
+ );
+
+ // Triggers for this email.
+ add_action( 'woocommerce_fulfillment_deleted_notification', array( $this, 'trigger' ), 10, 3 );
+
+ // Call parent constructor.
+ parent::__construct();
+
+ $this->description = __( 'Fulfillment deleted emails are sent to the customer when the merchant cancels an already fulfilled fulfillment. The notification isn’t sent for draft fulfillments.', 'woocommerce' );
+ }
+
+ /**
+ * Trigger the sending of this email.
+ *
+ * @param int $order_id The order ID.
+ * @param Fulfillment $fulfillment The fulfillment.
+ * @param WC_Order|false $order Order object.
+ */
+ public function trigger( $order_id, $fulfillment, $order = false ) {
+ $this->setup_locale();
+
+ if ( $order_id && ! is_a( $order, 'WC_Order' ) ) {
+ $order = wc_get_order( $order_id );
+ }
+
+ if ( is_a( $order, 'WC_Order' ) ) {
+ $this->object = $order;
+ $this->fulfillment = $fulfillment;
+ $this->recipient = $this->object->get_billing_email();
+ $this->placeholders['{order_date}'] = wc_format_datetime( $this->object->get_date_created() );
+ $this->placeholders['{order_number}'] = $this->object->get_order_number();
+ }
+
+ if ( $this->is_enabled() && $this->get_recipient() ) {
+ $this->send( $this->get_recipient(), $this->get_subject(), $this->get_content(), $this->get_headers(), $this->get_attachments() );
+ }
+
+ $this->restore_locale();
+ }
+
+ /**
+ * Get email subject.
+ *
+ * @since 3.1.0
+ * @return string
+ */
+ public function get_default_subject() {
+ return __( 'A shipment from {site_title} order {order_number} has been cancelled', 'woocommerce' );
+ }
+
+ /**
+ * Get email heading.
+ *
+ * @since 3.1.0
+ * @return string
+ */
+ public function get_default_heading() {
+ return __( 'One of your shipments has been removed', 'woocommerce' );
+ }
+
+ /**
+ * Get content html.
+ *
+ * @return string
+ */
+ public function get_content_html() {
+ $this->maybe_init_fulfillment_for_preview( $this->object );
+ return wc_get_template_html(
+ $this->template_html,
+ array(
+ 'order' => $this->object,
+ 'fulfillment' => $this->fulfillment,
+ 'email_heading' => $this->get_heading(),
+ 'additional_content' => $this->get_additional_content(),
+ 'sent_to_admin' => false,
+ 'plain_text' => false,
+ 'email' => $this,
+ )
+ );
+ }
+
+ /**
+ * Get content plain.
+ *
+ * @return string
+ */
+ public function get_content_plain() {
+ $this->maybe_init_fulfillment_for_preview( $this->object );
+ return wc_get_template_html(
+ $this->template_plain,
+ array(
+ 'order' => $this->object,
+ 'fulfillment' => $this->fulfillment,
+ 'email_heading' => $this->get_heading(),
+ 'additional_content' => $this->get_additional_content(),
+ 'sent_to_admin' => false,
+ 'plain_text' => true,
+ 'email' => $this,
+ )
+ );
+ }
+
+ /**
+ * Default content to show below main email content.
+ *
+ * @since 3.7.0
+ * @return string
+ */
+ public function get_default_additional_content() {
+ return __( 'If you have any questions or notice anything unexpected, feel free to reach out to our support team through your account or reply to this email.', 'woocommerce' );
+ }
+
+ /**
+ * Initialize fulfillment for email preview.
+ *
+ * This method sets up a dummy fulfillment object when the email is being previewed in the admin.
+ *
+ * @param WC_Order $order The order object.
+ *
+ * @since 10.1.0
+ */
+ private function maybe_init_fulfillment_for_preview( $order ) {
+ /**
+ * Filter to determine if this is an email preview.
+ *
+ * @since 9.8.0
+ */
+ $is_email_preview = apply_filters( 'woocommerce_is_email_preview', false );
+ if ( $is_email_preview ) {
+ // If this is a preview, we need to set up a dummy fulfillment object.
+ $this->fulfillment = new Fulfillment();
+ $this->fulfillment->set_items(
+ array_map(
+ function ( $item ) {
+ return array(
+ 'item_id' => $item->get_id(),
+ 'qty' => 1,
+ );
+ },
+ $order->get_items()
+ )
+ );
+
+ // Set the deleted status.
+ $this->fulfillment->set_date_deleted( gmdate( 'Y-m-d H:i:s' ) );
+ }
+ }
+ }
+
+endif;
+
+return new WC_Email_Customer_Fulfillment_Deleted();
diff --git a/plugins/woocommerce/includes/emails/class-wc-email-customer-fulfillment-updated.php b/plugins/woocommerce/includes/emails/class-wc-email-customer-fulfillment-updated.php
new file mode 100644
index 0000000000..65c8a36948
--- /dev/null
+++ b/plugins/woocommerce/includes/emails/class-wc-email-customer-fulfillment-updated.php
@@ -0,0 +1,212 @@
+<?php
+/**
+ * Class WC_Email_Customer_Fulfillment_Updated file.
+ *
+ * @package WooCommerce\Emails
+ */
+
+use Automattic\WooCommerce\Internal\Fulfillments\Fulfillment;
+
+if ( ! defined( 'ABSPATH' ) ) {
+ exit; // Exit if accessed directly.
+}
+
+if ( ! class_exists( 'WC_Email_Customer_Fulfillment_Updated', false ) ) :
+
+ /**
+ * Customer Fulfillment Updated Email.
+ *
+ * Fulfillment updated emails are sent to the customer when the merchant updates a fulfillment for the order. The notification isn’t sent for draft fulfillments.
+ *
+ * @class WC_Email_Customer_Fulfillment_Updated
+ * @version 1.0.0
+ * @package WooCommerce\Classes\Emails
+ * @extends WC_Email
+ */
+ class WC_Email_Customer_Fulfillment_Updated extends WC_Email {
+ /**
+ * Fulfillment object.
+ *
+ * @var Fulfillment|null
+ */
+ private $fulfillment;
+
+ /**
+ * Constructor.
+ */
+ public function __construct() {
+ $this->id = 'customer_fulfillment_updated';
+ $this->customer_email = true;
+ $this->title = __( 'Fulfillment updated', 'woocommerce' );
+ $this->template_html = 'emails/customer-fulfillment-updated.php';
+ $this->template_plain = 'emails/plain/customer-fulfillment-updated.php';
+ $this->placeholders = array(
+ '{order_date}' => '',
+ '{order_number}' => '',
+ );
+
+ // Triggers for this email.
+ add_action( 'woocommerce_fulfillment_updated_notification', array( $this, 'trigger' ), 10, 3 );
+
+ // Call parent constructor.
+ parent::__construct();
+
+ $this->description = __( 'Fulfillment updated emails are sent to the customer when the merchant updates a fulfillment for the order. The notification isn’t sent for draft fulfillments.', 'woocommerce' );
+ }
+
+ /**
+ * Trigger the sending of this email.
+ *
+ * @param int $order_id The order ID.
+ * @param Fulfillment $fulfillment The fulfillment.
+ * @param WC_Order|false $order Order object.
+ */
+ public function trigger( $order_id, $fulfillment, $order = false ) {
+ $this->setup_locale();
+
+ if ( $order_id && ! is_a( $order, 'WC_Order' ) ) {
+ $order = wc_get_order( $order_id );
+ }
+
+ if ( is_a( $order, 'WC_Order' ) ) {
+ $this->object = $order;
+ $this->fulfillment = $fulfillment;
+ $this->recipient = $this->object->get_billing_email();
+ $this->placeholders['{order_date}'] = wc_format_datetime( $this->object->get_date_created() );
+ $this->placeholders['{order_number}'] = $this->object->get_order_number();
+ }
+
+ if ( $this->is_enabled() && $this->get_recipient() ) {
+ $this->send( $this->get_recipient(), $this->get_subject(), $this->get_content(), $this->get_headers(), $this->get_attachments() );
+ }
+
+ $this->restore_locale();
+ }
+
+ /**
+ * Get email subject.
+ *
+ * @since 3.1.0
+ * @return string
+ */
+ public function get_default_subject() {
+ return __( 'A shipment from {site_title} order {order_number} has been updated', 'woocommerce' );
+ }
+
+ /**
+ * Get email heading.
+ *
+ * @since 3.1.0
+ * @return string
+ */
+ public function get_default_heading() {
+ return __( 'Your shipment has been updated', 'woocommerce' );
+ }
+
+ /**
+ * Get content html.
+ *
+ * @return string
+ */
+ public function get_content_html() {
+ $this->maybe_init_fulfillment_for_preview( $this->object );
+ return wc_get_template_html(
+ $this->template_html,
+ array(
+ 'order' => $this->object,
+ 'fulfillment' => $this->fulfillment,
+ 'email_heading' => $this->get_heading(),
+ 'additional_content' => $this->get_additional_content(),
+ 'sent_to_admin' => false,
+ 'plain_text' => false,
+ 'email' => $this,
+ )
+ );
+ }
+
+ /**
+ * Get content plain.
+ *
+ * @return string
+ */
+ public function get_content_plain() {
+ $this->maybe_init_fulfillment_for_preview( $this->object );
+ return wc_get_template_html(
+ $this->template_plain,
+ array(
+ 'order' => $this->object,
+ 'fulfillment' => $this->fulfillment,
+ 'email_heading' => $this->get_heading(),
+ 'additional_content' => $this->get_additional_content(),
+ 'sent_to_admin' => false,
+ 'plain_text' => true,
+ 'email' => $this,
+ )
+ );
+ }
+
+ /**
+ * Default content to show below main email content.
+ *
+ * @since 3.7.0
+ * @return string
+ */
+ public function get_default_additional_content() {
+ return __( 'If anything looks off or you have questions, feel free to contact our support team.', 'woocommerce' );
+ }
+
+ /**
+ * Initialize fulfillment for email preview.
+ *
+ * This method sets up a dummy fulfillment object when the email is being previewed in the admin.
+ *
+ * @param WC_Order $order The order object.
+ *
+ * @since 10.1.0
+ */
+ private function maybe_init_fulfillment_for_preview( $order ) {
+ /**
+ * Filter to determine if this is an email preview.
+ *
+ * @since 9.8.0
+ */
+ $is_email_preview = apply_filters( 'woocommerce_is_email_preview', false );
+ if ( $is_email_preview ) {
+ // If this is a preview, we need to set up a dummy fulfillment object.
+ $this->fulfillment = new Fulfillment();
+ $this->fulfillment->set_items(
+ array_map(
+ function ( $item ) {
+ return array(
+ 'item_id' => $item->get_id(),
+ 'qty' => 1,
+ );
+ },
+ $order->get_items()
+ )
+ );
+
+ // Some private meta data to simulate a real fulfillment.
+ $this->fulfillment->add_meta_data( '_tracking_number', '123456789' );
+ $this->fulfillment->add_meta_data( '_shipment_provider', 'dhl' );
+ $this->fulfillment->add_meta_data( '_tracking_url', 'https://www.dhl.com/tracking/123456789' );
+ // Some public data to simulate a real fulfillment.
+ $this->fulfillment->add_meta_data( 'service', 'Standard Shipping' );
+ $this->fulfillment->add_meta_data( 'expected_delivery', '2025-06-30' );
+
+ // Add translations for metadata keys.
+ add_filter(
+ 'woocommerce_fulfillment_meta_key_translations',
+ function ( $keys ) {
+ $keys['service'] = __( 'Service', 'woocommerce' );
+ $keys['expected_delivery'] = __( 'Expected Delivery', 'woocommerce' );
+ return $keys;
+ }
+ );
+ }
+ }
+ }
+
+endif;
+
+return new WC_Email_Customer_Fulfillment_Updated();
diff --git a/plugins/woocommerce/includes/wc-template-functions.php b/plugins/woocommerce/includes/wc-template-functions.php
index d5770d6b6d..b8df5382be 100644
--- a/plugins/woocommerce/includes/wc-template-functions.php
+++ b/plugins/woocommerce/includes/wc-template-functions.php
@@ -13,6 +13,8 @@ use Automattic\WooCommerce\Blocks\Utils\CartCheckoutUtils;
use Automattic\WooCommerce\Enums\OrderStatus;
use Automattic\WooCommerce\Enums\PaymentGatewayFeature;
use Automattic\WooCommerce\Enums\ProductType;
+use Automattic\WooCommerce\Internal\DataStores\Fulfillments\FulfillmentsDataStore;
+use Automattic\WooCommerce\Internal\Fulfillments\Fulfillment;
use Automattic\WooCommerce\Internal\Utilities\HtmlSanitizer;
use Automattic\WooCommerce\Utilities\FeaturesUtil;
@@ -2881,8 +2883,18 @@ if ( ! function_exists( 'woocommerce_order_details_table' ) ) {
return;
}
+ $template = 'order/order-details.php';
+
+ if ( FeaturesUtil::feature_is_enabled( 'fulfillments' ) ) {
+ $fulfillment_data_store = wc_get_container()->get( FulfillmentsDataStore::class );
+ $fulfillments = $fulfillment_data_store->read_fulfillments( WC_Order::class, $order_id );
+ if ( ! empty( $fulfillments ) ) {
+ $template = 'order/order-details-fulfillments.php';
+ }
+ }
+
wc_get_template(
- 'order/order-details.php',
+ $template,
array(
'order_id' => $order_id,
/**
@@ -3615,6 +3627,107 @@ if ( ! function_exists( 'wc_get_email_order_items' ) ) {
}
}
+if ( ! function_exists( 'wc_get_email_fulfillment_items' ) ) {
+ /**
+ * Get HTML for the order items to be shown in emails.
+ *
+ * @param WC_Order $order Order object.
+ * @param Fulfillment $fulfillment Fulfillment object.
+ * @param array $args Arguments.
+ *
+ * @since 3.0.0
+ * @return string
+ */
+ function wc_get_email_fulfillment_items( $order, $fulfillment, $args = array() ) {
+ ob_start();
+
+ $email_improvements_enabled = FeaturesUtil::feature_is_enabled( 'email_improvements' );
+ $image_size = $email_improvements_enabled ? 48 : 32;
+
+ $defaults = array(
+ 'show_sku' => false,
+ 'show_image' => $email_improvements_enabled,
+ 'image_size' => array( $image_size, $image_size ),
+ 'plain_text' => false,
+ 'sent_to_admin' => false,
+ );
+
+ $args = wp_parse_args( $args, $defaults );
+ $template = $args['plain_text'] ? 'emails/plain/email-fulfillment-items.php' : 'emails/email-fulfillment-items.php';
+
+ $fulfillment_items = $fulfillment->get_items();
+ if ( empty( $fulfillment_items ) ) {
+ // If there are no fulfillment items, we return an empty string.
+ return '';
+ }
+
+ $order_items = $order->get_items();
+ if ( empty( $order_items ) ) {
+ // If there are no order items, we return an empty string.
+ return '';
+ }
+
+ $order_items_filtered = array();
+ foreach ( $fulfillment_items as $fulfillment_item ) {
+ // Filter order items to only include those that are part of the fulfillment.
+ foreach ( $order_items as $order_item ) {
+ if ( $order_item->get_id() === $fulfillment_item['item_id'] ) {
+ if ( method_exists( $order_item, 'get_subtotal' )
+ && method_exists( $order_item, 'set_subtotal' )
+ && method_exists( $order_item, 'get_quantity' ) ) {
+ $order_item->set_subtotal(
+ $order_item->get_subtotal() * $fulfillment_item['qty'] / $order_item->get_quantity()
+ );
+ }
+ $order_items_filtered[] = (object) array(
+ 'item_id' => $order_item->get_id(),
+ 'qty' => $fulfillment_item['qty'],
+ 'item' => $order_item,
+ );
+ break;
+ }
+ }
+ }
+
+ wc_get_template(
+ $template,
+ /**
+ * Filter to modify the arguments for the email fulfillment items.
+ *
+ * @since 10.1.0
+ *
+ * @param array $args The arguments for the email fulfillment items.
+ */
+ apply_filters(
+ 'woocommerce_email_fulfillment_items_args',
+ array(
+ 'order' => $order,
+ 'fulfillment' => $fulfillment,
+ 'items' => $order_items_filtered,
+ 'show_download_links' => $order->is_download_permitted() && ! $args['sent_to_admin'],
+ 'show_sku' => $args['show_sku'],
+ 'show_purchase_note' => $order->is_paid() && ! $args['sent_to_admin'],
+ 'show_image' => $args['show_image'],
+ 'image_size' => $args['image_size'],
+ 'plain_text' => $args['plain_text'],
+ 'sent_to_admin' => $args['sent_to_admin'],
+ )
+ )
+ );
+
+ /**
+ * Filter to modify the email fulfillment items table HTML.
+ *
+ * @since 10.1.0
+ *
+ * @param string $html The HTML output of the fulfillment items table.
+ * @param WC_Order $order The order object.
+ * @param Fulfillment $fulfillment The fulfillment object.
+ */
+ return apply_filters( 'woocommerce_get_email_fulfillment_items_table', ob_get_clean(), $order, $fulfillment );
+ }
+}
+
if ( ! function_exists( 'wc_display_item_meta' ) ) {
/**
* Display item meta data.
diff --git a/plugins/woocommerce/src/Internal/DataStores/Fulfillments/FulfillmentsDataStore.php b/plugins/woocommerce/src/Internal/DataStores/Fulfillments/FulfillmentsDataStore.php
new file mode 100644
index 0000000000..571dec42d7
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/DataStores/Fulfillments/FulfillmentsDataStore.php
@@ -0,0 +1,600 @@
+<?php
+/**
+ * Class FulfillmentsDataStore file.
+ *
+ * @package WooCommerce\DataStores
+ */
+
+declare( strict_types=1 );
+
+namespace Automattic\WooCommerce\Internal\DataStores\Fulfillments;
+
+use Automattic\WooCommerce\Internal\Fulfillments\Fulfillment;
+use Automattic\WooCommerce\Internal\Fulfillments\FulfillmentUtils;
+use WC_Meta_Data;
+
+if ( ! defined( 'ABSPATH' ) ) {
+ exit;
+}
+
+/**
+ * WC Order Item Product Data Store
+ *
+ * @version 9.9.0
+ */
+class FulfillmentsDataStore extends \WC_Data_Store_WP implements \WC_Object_Data_Store_Interface, FulfillmentsDataStoreInterface {
+
+ /**
+ * Method to create a new fulfillment in the database.
+ *
+ * @param Fulfillment $data The fulfillment object to create.
+ *
+ * @return void
+ *
+ * @throws \Exception If the fulfillment data is invalid.
+ * @throws \Exception If the fulfillment can't be created.
+ */
+ public function create( &$data ): void {
+ // Validate the fulfillment data.
+ if ( ! $data->get_entity_type() ) {
+ throw new \Exception( esc_html__( 'Invalid entity type.', 'woocommerce' ) );
+ }
+ if ( ! $data->get_entity_id() ) {
+ throw new \Exception( esc_html__( 'Invalid entity ID.', 'woocommerce' ) );
+ }
+ if ( ! FulfillmentUtils::is_valid_fulfillment_status( $data->get_status() ) ) {
+ throw new \Exception( esc_html__( 'Invalid fulfillment status.', 'woocommerce' ) );
+ }
+
+ $this->validate_items( $data );
+
+ // Set fulfillment properties.
+ $data->set_date_updated( current_time( 'mysql' ) );
+
+ /**
+ * Filter to modify the fulfillment data before it is created.
+ *
+ * @since 10.1.0
+ */
+ $data = apply_filters( 'woocommerce_fulfillment_before_create', $data );
+
+ $is_fulfill_action = $data->get_is_fulfilled();
+ // If the fulfillment is fulfilled, set the fulfilled date.
+ if ( $is_fulfill_action ) {
+ $data->set_date_fulfilled( current_time( 'mysql' ) );
+
+ /**
+ * Filter to modify the fulfillment data before it is fulfilled.
+ *
+ * @since 10.1.0
+ */
+ $data = apply_filters(
+ 'woocommerce_fulfillment_before_fulfill',
+ $data
+ );
+ }
+
+ // Save the fulfillment to the database.
+ global $wpdb;
+ $rows_inserted = $wpdb->insert(
+ $wpdb->prefix . 'wc_order_fulfillments',
+ array(
+ 'entity_type' => $data->get_entity_type(),
+ 'entity_id' => $data->get_entity_id(),
+ 'status' => $data->get_status() ?? 'unfulfilled',
+ 'is_fulfilled' => $data->get_is_fulfilled() ? 1 : 0,
+ 'date_updated' => $data->get_date_updated(),
+ 'date_deleted' => $data->get_date_deleted(),
+ ),
+ array( '%s', '%s', '%s', '%d', '%s', '%s' )
+ );
+
+ // Check for errors.
+ if ( false === $rows_inserted ) {
+ throw new \Exception( esc_html__( 'Failed to insert fulfillment.', 'woocommerce' ) );
+ }
+
+ // Set the ID of the fulfillment object.
+ $data_id = $wpdb->insert_id;
+
+ $data->set_id( $data_id );
+
+ // If the fulfillment is fulfilled, set the fulfilled date.
+ if ( $data->get_is_fulfilled() ) {
+ $data->set_date_fulfilled( current_time( 'mysql' ) );
+ }
+
+ // Save the metadata for the fulfillment to the database.
+ $data->save_meta_data();
+
+ // Apply changes let's the object know that the current object reflects the database and no "changes" exist between the two.
+ $data->apply_changes();
+ $data->set_object_read( true );
+
+ if ( ! doing_action( 'woocommerce_fulfillment_after_create' ) ) {
+ /**
+ * Action to perform after a fulfillment is created.
+ *
+ * @param Fulfillment $data The fulfillment object that was created.
+ *
+ * @since 10.1.0
+ */
+ do_action( 'woocommerce_fulfillment_after_create', $data );
+ }
+
+ if ( $is_fulfill_action && ! doing_action( 'woocommerce_fulfillment_after_fulfill' ) ) {
+ /**
+ * Action to perform after a fulfillment is fulfilled.
+ *
+ * @since 10.1.0
+ */
+ do_action( 'woocommerce_fulfillment_after_fulfill', $data );
+ }
+ }
+
+ /**
+ * Method to read a fulfillment from the database.
+ *
+ * @param Fulfillment $data The fulfillment object to read.
+ *
+ * @return void
+ *
+ * @throws \Exception If the fulfillment data can't be read.
+ */
+ public function read( &$data ): void {
+ // Read the fulfillment from the database.
+ global $wpdb;
+
+ $data_id = $data->get_id();
+ $fulfillment_data = $wpdb->get_row(
+ $wpdb->prepare(
+ "SELECT * FROM {$wpdb->prefix}wc_order_fulfillments WHERE fulfillment_id = %d",
+ $data_id
+ ),
+ ARRAY_A
+ );
+
+ if ( empty( $fulfillment_data ) ) {
+ throw new \Exception( esc_html__( 'Fulfillment not found.', 'woocommerce' ) );
+ }
+
+ $data->set_props( $fulfillment_data );
+ $data->read_meta_data( true );
+ $data->set_object_read( true );
+ }
+
+ /**
+ * Method to update an existing fulfillment in the database.
+ *
+ * @param Fulfillment $data The fulfillment object to update.
+ *
+ * @return void
+ *
+ * @throws \Exception If the fulfillment can't be updated.
+ */
+ public function update( &$data ): void {
+ // If the fulfillment is deleted, do nothing.
+ if ( $data->get_date_deleted() ) {
+ return;
+ }
+
+ // Update the fulfillment in the database.
+ $data_id = $data->get_id();
+
+ if ( ! FulfillmentUtils::is_valid_fulfillment_status( $data->get_status() ) ) {
+ throw new \Exception( esc_html__( 'Invalid fulfillment status.', 'woocommerce' ) );
+ }
+
+ $this->validate_items( $data );
+
+ /**
+ * Filter to modify the fulfillment data before it is updated.
+ *
+ * @param Fulfillment $data The fulfillment object that is being updated.
+ *
+ * @since 10.1.0
+ */
+ $data = apply_filters( 'woocommerce_fulfillment_before_update', $data );
+
+ // If the fulfillment is fulfilled, set the fulfilled date.
+ $is_fulfill_action = false;
+ if ( $data->get_is_fulfilled() && empty( $data->get_date_fulfilled() ) ) {
+ $is_fulfill_action = true;
+ $data->set_date_fulfilled( current_time( 'mysql' ) );
+
+ /**
+ * Filter to modify the fulfillment data before it is fulfilled.
+ *
+ * @param Fulfillment $data The fulfillment object that is being fulfilled.
+ *
+ * @since 10.1.0
+ */
+ $data = apply_filters(
+ 'woocommerce_fulfillment_before_fulfill',
+ $data
+ );
+ }
+
+ global $wpdb;
+
+ $wpdb->update(
+ $wpdb->prefix . 'wc_order_fulfillments',
+ array(
+ 'entity_type' => $data->get_entity_type(),
+ 'entity_id' => $data->get_entity_id(),
+ 'status' => $data->get_status(),
+ 'is_fulfilled' => $data->get_is_fulfilled() ? 1 : 0,
+ 'date_updated' => current_time( 'mysql' ),
+ 'date_deleted' => $data->get_date_deleted(),
+ ),
+ array(
+ 'fulfillment_id' => $data_id,
+ 'date_deleted' => null,
+ ),
+ array( '%s', '%s', '%s', '%d', '%s', '%s' ),
+ array( '%d' )
+ );
+
+ // Check for errors.
+ if ( $wpdb->last_error ) {
+ throw new \Exception( esc_html__( 'Failed to update fulfillment.', 'woocommerce' ) );
+ }
+
+ // If the fulfillment is fulfilled, set the fulfilled date.
+ if ( $data->get_is_fulfilled() && ! $data->meta_exists( '_fulfilled_date' ) ) {
+ $data->set_date_fulfilled( current_time( 'mysql' ) );
+ }
+
+ // Update the metadata for the fulfillment.
+ $data->save_meta_data();
+ $data->apply_changes();
+
+ $data->set_object_read( true );
+
+ if ( ! doing_action( 'woocommerce_fulfillment_after_update' ) ) {
+ /**
+ * Action to perform after a fulfillment is updated.
+ *
+ * @param Fulfillment $data The fulfillment object that was updated.
+ *
+ * @since 10.1.0
+ */
+ do_action( 'woocommerce_fulfillment_after_update', $data );
+ }
+
+ if ( $is_fulfill_action && ! doing_action( 'woocommerce_fulfillment_after_fulfill' ) ) {
+ /**
+ * Action to perform after a fulfillment is fulfilled.
+ *
+ * @param Fulfillment $data The fulfillment object that was fulfilled.
+ *
+ * @since 10.1.0
+ */
+ do_action( 'woocommerce_fulfillment_after_fulfill', $data );
+ }
+ }
+
+ /**
+ * Method to delete a fulfillment from the database.
+ *
+ * @param Fulfillment $data The fulfillment object to delete.
+ * @param array $args Optional arguments to pass to the delete method.
+ *
+ * @return void
+ *
+ * @throws \Exception If the fulfillment can't be deleted.
+ */
+ public function delete( &$data, $args = array() ): void {
+ // If the record is already deleted, do nothing.
+ if ( $data->get_date_deleted() ) {
+ return;
+ }
+
+ /**
+ * Filter to modify the fulfillment data before it is updated.
+ *
+ * @since 10.1.0
+ */
+ $data = apply_filters( 'woocommerce_fulfillment_before_delete', $data );
+
+ // Soft Delete the fulfillment from the database.
+ global $wpdb;
+
+ $data_id = $data->get_id();
+ $deletion_time = current_time( 'mysql' );
+ $wpdb->update(
+ $wpdb->prefix . 'wc_order_fulfillments',
+ array( 'date_deleted' => $deletion_time ),
+ array(
+ 'fulfillment_id' => $data_id,
+ 'date_deleted' => null,
+ ),
+ array( '%s' ),
+ array( '%d' )
+ );
+
+ // Check for errors.
+ if ( $wpdb->last_error ) {
+ throw new \Exception( esc_html__( 'Failed to delete fulfillment.', 'woocommerce' ) );
+ }
+
+ $data->set_date_deleted( $deletion_time );
+ $data->apply_changes();
+ $data->set_object_read( true );
+
+ if ( ! doing_action( 'woocommerce_fulfillment_after_delete' ) ) {
+ /**
+ * Action to perform after a fulfillment is deleted.
+ *
+ * @since 10.1.0
+ */
+ do_action( 'woocommerce_fulfillment_after_delete', $data );
+ }
+
+ // Set the fulfillment object to a fresh state.
+ $data = new Fulfillment();
+ }
+
+ /**
+ * Method to read the metadata for a fulfillment.
+ *
+ * @param Fulfillment $data The fulfillment object to read.
+ * @return array
+ *
+ * @throws \Exception If the fulfillment is not saved.
+ */
+ public function read_meta( &$data ): array {
+ if ( ! $data->get_id() ) {
+ throw new \Exception( esc_html__( 'Invalid fulfillment.', 'woocommerce' ) );
+ }
+
+ // Read the metadata for the fulfillment.
+ global $wpdb;
+
+ $data_id = $data->get_id();
+ $meta_data = $wpdb->get_results(
+ $wpdb->prepare(
+ "SELECT * FROM {$wpdb->prefix}wc_order_fulfillment_meta WHERE fulfillment_id = %d",
+ $data_id
+ ),
+ OBJECT
+ );
+
+ return array_map(
+ function ( $meta ) {
+ $meta->meta_value = json_decode( $meta->meta_value, true ) ?? $meta->meta_value;
+ return $meta;
+ },
+ $meta_data
+ );
+ }
+
+ /**
+ * Method to delete the metadata for a fulfillment.
+ *
+ * @param Fulfillment $data The fulfillment object to delete.
+ * @param WC_Meta_Data $meta Meta object (containing at least ->id).
+ *
+ * @return void
+ *
+ * @throws \Exception If the fulfillment or meta is not saved.
+ */
+ public function delete_meta( &$data, $meta ): void {
+ // Check if the fulfillment and meta are saved.
+ $data_id = $data->get_id();
+
+ // Prevent deletion of metadata from a deleted fulfillment.
+ if ( $data->get_date_deleted() ) {
+ throw new \Exception( esc_html__( 'Cannot delete meta from a deleted fulfillment.', 'woocommerce' ) );
+ }
+
+ $meta_id = $meta->id;
+ if ( ! is_numeric( $data_id ) || $data_id <= 0 || ! is_numeric( $meta_id ) || $meta_id <= 0 ) {
+ throw new \Exception( esc_html__( 'Invalid fulfillment or meta.', 'woocommerce' ) );
+ }
+
+ // Delete the metadata for the fulfillment.
+ global $wpdb;
+
+ $wpdb->delete(
+ $wpdb->prefix . 'wc_order_fulfillment_meta',
+ array(
+ 'fulfillment_id' => $data_id,
+ 'meta_id' => $meta_id,
+ ),
+ array(
+ '%d',
+ '%d',
+ )
+ );
+ }
+
+ /**
+ * Method to add metadata for a fulfillment.
+ *
+ * @param Fulfillment $data The fulfillment object to save.
+ * @param WC_Meta_Data $meta Meta object (containing at least ->id).
+ * @return int meta ID or WP_Error on failure.
+ *
+ * @throws \Exception If the fulfillment or meta is not saved.
+ */
+ public function add_meta( &$data, $meta ): int {
+ // Add the metadata for the fulfillment.
+ global $wpdb;
+
+ // Prevent adding metadata to a deleted fulfillment.
+ if ( $data->get_date_deleted() ) {
+ throw new \Exception( esc_html__( 'Cannot add meta to a deleted fulfillment.', 'woocommerce' ) );
+ }
+
+ // Data ID can't be something wrong as this function is called after the meta is read.
+ // See WC_Data::save_meta_data().
+ $data_id = $data->get_id();
+
+ $wpdb->insert(
+ $wpdb->prefix . 'wc_order_fulfillment_meta',
+ array(
+ 'fulfillment_id' => $data_id,
+ 'meta_key' => $meta->key, // phpcs:ignore WordPress.DB.SlowDBQuery.slow_db_query_meta_key
+ 'meta_value' => wp_json_encode( $meta->value ), // phpcs:ignore WordPress.DB.SlowDBQuery.slow_db_query_meta_value
+ ),
+ array(
+ '%d',
+ '%s',
+ '%s',
+ )
+ );
+
+ // Note: There is no error check on WC_Data::save_meta_data(), and it expects us to return an ID in all cases.
+ // If there's an error, we should return null to indicate we didn't save it.
+ if ( $wpdb->last_error ) {
+ throw new \Exception( esc_html__( 'Failed to insert fulfillment meta.', 'woocommerce' ) );
+ }
+
+ return $wpdb->insert_id;
+ }
+
+ /**
+ * Method to save the metadata for a fulfillment.
+ *
+ * @param Fulfillment $data The fulfillment object to save.
+ * @param WC_Meta_Data $meta Meta object (containing at least ->id).
+ *
+ * @return int Number of rows updated.
+ *
+ * @throws \Exception If the fulfillment or meta is not saved.
+ */
+ public function update_meta( &$data, $meta ): int {
+ // Update the metadata for the fulfillment.
+ global $wpdb;
+
+ $data_id = $data->get_id();
+
+ // Prevent updating metadata for a deleted fulfillment.
+ if ( $data->get_date_deleted() ) {
+ throw new \Exception( esc_html__( 'Cannot update meta for a deleted fulfillment.', 'woocommerce' ) );
+ }
+
+ $rows_updated = $wpdb->update(
+ $wpdb->prefix . 'wc_order_fulfillment_meta',
+ array(
+ 'meta_value' => wp_json_encode( $meta->value ), // phpcs:ignore WordPress.DB.SlowDBQuery.slow_db_query_meta_value
+ ),
+ array(
+ 'fulfillment_id' => $data_id,
+ 'meta_id' => $meta->id,
+ 'meta_key' => $meta->key, // phpcs:ignore WordPress.DB.SlowDBQuery.slow_db_query_meta_key
+ ),
+ array(
+ '%s',
+ ),
+ array(
+ '%d',
+ '%d',
+ '%s',
+ )
+ );
+
+ // Check for errors.
+ if ( $wpdb->last_error ) {
+ throw new \Exception( esc_html__( 'Failed to update fulfillment meta.', 'woocommerce' ) );
+ }
+
+ return $rows_updated;
+ }
+
+ /**
+ * Method to read the fulfillment data.
+ *
+ * @param string $entity_type The entity type.
+ * @param string $entity_id The entity ID.
+ * @param bool $with_deleted Whether to include deleted fulfillments in the results.
+ *
+ * @return Fulfillment[] Fulfillment object.
+ *
+ * @throws \Exception If the fulfillment data can't be read.
+ */
+ public function read_fulfillments( string $entity_type, string $entity_id, bool $with_deleted = false ): array {
+ // Read the fulfillment data from the database.
+ global $wpdb;
+
+ if ( ! $with_deleted ) {
+ $fulfillment_data = $wpdb->get_results(
+ $wpdb->prepare(
+ "SELECT * FROM {$wpdb->prefix}wc_order_fulfillments WHERE entity_type = %s AND entity_id = %s AND date_deleted IS NULL",
+ $entity_type,
+ $entity_id
+ ),
+ ARRAY_A
+ );
+ } else {
+ $fulfillment_data = $wpdb->get_results(
+ $wpdb->prepare(
+ "SELECT * FROM {$wpdb->prefix}wc_order_fulfillments WHERE entity_type = %s AND entity_id = %s",
+ $entity_type,
+ $entity_id
+ ),
+ ARRAY_A
+ );
+ }
+
+ if ( is_wp_error( $fulfillment_data ) ) {
+ throw new \Exception( esc_html__( 'Failed to read fulfillment data.', 'woocommerce' ) );
+ }
+
+ // Create Fulfillment objects from the data.
+ $fulfillments = array();
+ foreach ( $fulfillment_data as $data ) {
+ // Note: Don't initialize with ID, it will cause a re-read from the database.
+ // Set the ID directly after the object is created.
+ $fulfillment = new Fulfillment();
+ $fulfillment->set_id( $data['fulfillment_id'] );
+ $fulfillment->set_props( $data );
+ $fulfillment->apply_changes();
+ $fulfillment->set_object_read( true );
+
+ // Read the metadata for the fulfillment.
+ $fulfillment->read_meta_data( true );
+
+ $fulfillments[] = $fulfillment;
+ }
+
+ return $fulfillments;
+ }
+
+ /**
+ * Method to validate the items in a fulfillment.
+ *
+ * @param Fulfillment $data The fulfillment object to validate.
+ *
+ * @return void
+ *
+ * @throws \Exception If the fulfillment data is invalid.
+ */
+ private function validate_items( Fulfillment $data ): void {
+ $items = $data->get_meta( '_items', true );
+ if ( empty( $items ) ) {
+ throw new \Exception( esc_html__( 'The fulfillment should contain at least one item.', 'woocommerce' ) );
+ }
+
+ if ( ! is_array( $items ) ) {
+ throw new \Exception( esc_html__( 'The fulfillment items should be an array.', 'woocommerce' ) );
+ }
+
+ foreach ( $data->get_items() as $item ) {
+ if ( ! isset( $item['item_id'] )
+ // The item ID and qty should be set.
+ || ! isset( $item['qty'] )
+ // The item ID should be integers.
+ || ! is_int( $item['item_id'] )
+ // Allow the qty to be a float too.
+ || ( ! is_int( $item['qty'] ) && ! is_float( $item['qty'] ) )
+ // The item ID and qty should be greater than 0.
+ || $item['item_id'] <= 0
+ || $item['qty'] <= 0
+ ) {
+ throw new \Exception( esc_html__( 'Invalid item.', 'woocommerce' ) );
+ }
+ }
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/DataStores/Fulfillments/FulfillmentsDataStoreInterface.php b/plugins/woocommerce/src/Internal/DataStores/Fulfillments/FulfillmentsDataStoreInterface.php
new file mode 100644
index 0000000000..c5ecc31e07
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/DataStores/Fulfillments/FulfillmentsDataStoreInterface.php
@@ -0,0 +1,27 @@
+<?php
+/**
+ * Fulfillments Data Store Interface
+ */
+
+declare( strict_types=1 );
+
+namespace Automattic\WooCommerce\Internal\DataStores\Fulfillments;
+
+use Automattic\WooCommerce\Internal\Fulfillments\Fulfillment;
+
+/**
+ * Interface FulfillmentsDataStoreInterface
+ *
+ * @package Automattic\WooCommerce\Internal\DataStores\Fulfillments
+ */
+interface FulfillmentsDataStoreInterface {
+ /**
+ * Read the fulfillment data.
+ *
+ * @param string $entity_type The entity type.
+ * @param string $entity_id The entity ID.
+ *
+ * @return Fulfillment[] Fulfillment object.
+ */
+ public function read_fulfillments( string $entity_type, string $entity_id ): array;
+}
diff --git a/plugins/woocommerce/src/Internal/Features/FeaturesController.php b/plugins/woocommerce/src/Internal/Features/FeaturesController.php
index 71873398ba..93167ba9a3 100644
--- a/plugins/woocommerce/src/Internal/Features/FeaturesController.php
+++ b/plugins/woocommerce/src/Internal/Features/FeaturesController.php
@@ -501,6 +501,16 @@ class FeaturesController {
'is_legacy' => true,
'is_experimental' => true,
),
+ 'fulfillments' => array(
+ 'name' => __( 'Order Fulfillments', 'woocommerce' ),
+ 'description' => __(
+ 'Enable the Order Fulfillments feature to manage order fulfillment and shipping.',
+ 'woocommerce'
+ ),
+ 'enabled_by_default' => false,
+ 'disable_ui' => true,
+ 'is_experimental' => false,
+ ),
'experimental-iapi-mini-cart' => array(
'name' => __( 'Interactivity API powered Mini Cart', 'woocommerce' ),
'description' => __( 'Enable the new version of the Mini Cart that uses the Interactivity API instead of React in the frontend.', 'woocommerce' ),
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Fulfillment.php b/plugins/woocommerce/src/Internal/Fulfillments/Fulfillment.php
new file mode 100644
index 0000000000..a59a1b9050
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Fulfillment.php
@@ -0,0 +1,312 @@
+<?php
+/**
+ * WooCommerce order fulfillments.
+ *
+ * The WooCommerce order fulfillments class gets contains fulfillment related properties and methods.
+ *
+ * @package WooCommerce\Classes
+ * @version 9.9.0
+ */
+
+declare( strict_types=1 );
+
+namespace Automattic\WooCommerce\Internal\Fulfillments;
+
+use Automattic\WooCommerce\Internal\DataStores\Fulfillments\FulfillmentsDataStore;
+use WC_Meta_Data;
+
+defined( 'ABSPATH' ) || exit;
+
+
+/**
+ * WC Order Fulfillment Class
+ *
+ * @since 10.1.0
+ */
+class Fulfillment extends \WC_Data {
+ /**
+ * Fulfillment constructor. Loads fulfillment data.
+ *
+ * @param array|string|Fulfillment $data Fulfillment data.
+ */
+ public function __construct( $data = '' ) {
+ parent::__construct( $data );
+
+ if ( $data instanceof Fulfillment ) {
+ $this->set_id( absint( $data->get_id() ) );
+ } elseif ( is_numeric( $data ) ) {
+ $this->set_id( absint( $data ) );
+ } elseif ( is_array( $data ) && isset( $data['id'] ) ) {
+ $this->set_id( absint( $data['id'] ) );
+ } elseif ( is_string( $data ) && ! empty( $data ) ) {
+ $this->set_id( absint( $data ) );
+ } elseif ( is_object( $data ) && isset( $data->id ) ) {
+ $this->set_id( absint( $data->id ) );
+ } else {
+ $this->set_object_read( true );
+ }
+
+ // Load the items array.
+ $this->data_store = wc_get_container()->get( FulfillmentsDataStore::class );
+ if ( $this->get_id() > 0 ) {
+ $this->data_store->read( $this );
+ }
+ }
+
+ /**
+ * Get the fulfillment ID.
+ *
+ * @return int Fulfillment ID.
+ */
+ public function get_id(): int {
+ return $this->data['fulfillment_id'] ?? 0;
+ }
+
+ /**
+ * Set the fulfillment ID.
+ *
+ * @param int $id Fulfillment ID.
+ */
+ public function set_id( $id ): void {
+ $this->data['fulfillment_id'] = is_numeric( $id ) ? absint( $id ) : 0;
+ parent::set_id( $this->data['fulfillment_id'] );
+ }
+
+ /**
+ * Get the entity type.
+ *
+ * @return string|null Entity type.
+ */
+ public function get_entity_type(): ?string {
+ return $this->data['entity_type'] ?? null;
+ }
+
+ /**
+ * Set the entity type.
+ *
+ * @param class-string|null $entity_type Entity type.
+ */
+ public function set_entity_type( ?string $entity_type ): void {
+ $this->data['entity_type'] = $entity_type;
+ }
+
+ /**
+ * Get the entity ID.
+ *
+ * @return string|null Entity ID.
+ */
+ public function get_entity_id(): ?string {
+ return $this->data['entity_id'] ?? null;
+ }
+
+ /**
+ * Set the entity ID.
+ *
+ * @param string|null $entity_id Entity ID.
+ */
+ public function set_entity_id( ?string $entity_id ): void {
+ $this->data['entity_id'] = $entity_id;
+ }
+
+ /**
+ * Set fulfillment status.
+ *
+ * @param string|null $status Fulfillment status.
+ *
+ * @return void
+ *
+ * @throws \InvalidArgumentException If the status is invalid.
+ */
+ public function set_status( ?string $status ): void {
+ $statuses = FulfillmentUtils::get_fulfillment_statuses();
+ if ( ! isset( $statuses[ $status ] ) ) {
+ // Change the status to an existing one if the provided status is not valid.
+ $status = $this->get_is_fulfilled() ? 'fulfilled' : 'unfulfilled';
+ }
+ // Set the fulfillment status.
+ $this->set_is_fulfilled( $statuses[ $status ]['is_fulfilled'] ?? false );
+ // Set the status in the data array.
+ $this->data['status'] = $status;
+ }
+
+ /**
+ * Get the fulfillment status.
+ *
+ * @return string|null Fulfillment status.
+ */
+ public function get_status(): ?string {
+ return $this->data['status'] ?? null;
+ }
+
+ /**
+ * Set if the fulfillment is fulfilled. This is an internal method which is bound to the fulfillment status.
+ *
+ * @param bool $is_fulfilled Whether the fulfillment is fulfilled.
+ *
+ * @return void
+ */
+ private function set_is_fulfilled( bool $is_fulfilled ): void {
+ $this->data['is_fulfilled'] = $is_fulfilled;
+ }
+
+ /**
+ * Get if the fulfillment is fulfilled.
+ *
+ * @return bool Whether the fulfillment is fulfilled.
+ */
+ public function get_is_fulfilled(): bool {
+ return $this->data['is_fulfilled'] ?? false;
+ }
+
+ /**
+ * Check if the fulfillment is locked.
+ *
+ * @return bool Whether the fulfillment is locked.
+ */
+ public function is_locked(): bool {
+ return boolval( $this->get_meta( '_is_locked' ) );
+ }
+
+ /**
+ * Get the lock message.
+ *
+ * @return string Lock message.
+ */
+ public function get_lock_message(): string {
+ return $this->get_meta( '_lock_message' ) ?? '';
+ }
+
+ /**
+ * Set the lock status and message.
+ *
+ * @param bool $locked Whether the fulfillment is locked.
+ * @param string $message Optional. The lock message.
+ * Defaults to an empty string.
+ *
+ * @return void
+ */
+ public function set_locked( bool $locked, string $message = '' ): void {
+ $this->update_meta_data( '_is_locked', $locked );
+ if ( $locked ) {
+ $this->update_meta_data( '_lock_message', $message );
+ } else {
+ $this->delete_meta_data( '_lock_message' );
+ }
+ }
+
+ /**
+ * Get the date updated.
+ *
+ * @return string|null Date updated.
+ */
+ public function get_date_updated(): ?string {
+ return $this->data['date_updated'] ?? null;
+ }
+
+ /**
+ * Set the date updated.
+ *
+ * @param string|null $date_updated Date updated.
+ */
+ public function set_date_updated( ?string $date_updated ): void {
+ $this->data['date_updated'] = $date_updated;
+ }
+
+ /**
+ * Get the date the fulfillment was fulfilled.
+ */
+ public function get_date_fulfilled(): ?string {
+ return $this->meta_exists( '_date_fulfilled' ) ? $this->get_meta( '_date_fulfilled', true ) : null;
+ }
+
+ /**
+ * Set the date the fulfillment was fulfilled.
+ *
+ * @param string $date_fulfilled Date fulfilled.
+ */
+ public function set_date_fulfilled( string $date_fulfilled ): void {
+ $this->add_meta_data( '_date_fulfilled', $date_fulfilled, true );
+ }
+
+ /**
+ * Get the date deleted.
+ *
+ * @return string|null Date deleted.
+ */
+ public function get_date_deleted(): ?string {
+ return $this->data['date_deleted'] ?? null;
+ }
+
+ /**
+ * Set the date deleted.
+ *
+ * @param string|null $date_deleted Date deleted.
+ * @return void
+ */
+ public function set_date_deleted( ?string $date_deleted ): void {
+ $this->data['date_deleted'] = $date_deleted;
+ }
+
+ /**
+ * Get the fulfillment items.
+ *
+ * @return array Fulfillment items.
+ */
+ public function get_items(): array {
+ $items = $this->get_meta( '_items' );
+ return $items ? $items : array();
+ }
+
+ /**
+ * Set the fulfillment items.
+ *
+ * @param array $items Fulfillment items.
+ */
+ public function set_items( array $items ): void {
+ $this->update_meta_data( '_items', array_values( $items ) );
+ }
+
+ /**
+ * Get the order associated with this fulfillment.
+ *
+ * This method retrieves the order based on the entity type and entity ID.
+ * If the entity type is `WC_Order`, it returns the order object.
+ *
+ * @return \WC_Order|null The order object or null if not found.
+ */
+ public function get_order(): ?\WC_Order {
+ $entity_type = $this->get_entity_type();
+ $entity_id = $this->get_entity_id();
+
+ if ( ! $entity_type || ! $entity_id ) {
+ return null;
+ }
+
+ if ( \WC_Order::class === $entity_type ) {
+ $order = wc_get_order( (int) $entity_id );
+ if ( $order instanceof \WC_Order ) {
+ return $order;
+ }
+ }
+
+ return null;
+ }
+
+ /**
+ * Returns all data for this object as an associative array.
+ *
+ * @return array
+ */
+ public function get_raw_data() {
+ return array_merge( array( 'id' => $this->get_id() ), $this->data, array( 'meta_data' => $this->get_raw_meta_data() ) );
+ }
+
+ /**
+ * Returns the meta data as array for this object.
+ *
+ * @return array
+ */
+ public function get_raw_meta_data() {
+ return array_map( fn( WC_Meta_Data $meta ) => (array) $meta->get_data(), $this->get_meta_data() );
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/FulfillmentException.php b/plugins/woocommerce/src/Internal/Fulfillments/FulfillmentException.php
new file mode 100644
index 0000000000..6fd5007014
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/FulfillmentException.php
@@ -0,0 +1,25 @@
+<?php declare( strict_types = 1 );
+
+namespace Automattic\WooCommerce\Internal\Fulfillments;
+
+use Automattic\WooCommerce\Internal\Admin\Settings\Exceptions\ApiException;
+
+/**
+ * FulfillmentException class.
+ * This exception is thrown when there is an issue with fulfillment operations,
+ * such as creating, updating, or deleting fulfillments.
+ */
+class FulfillmentException extends ApiException {
+ /**
+ * Setup exception.
+ *
+ * @param string $message User-friendly translated error message, e.g. 'Fulfillment creation failed'.
+ * @param int $http_status_code Optional. Proper HTTP status code to respond with.
+ * Defaults to 400 (Bad request).
+ * @param array $additional_data Optional. Extra data (key value pairs) to expose in the error response.
+ * Defaults to empty array.
+ */
+ public function __construct( string $message, int $http_status_code = 400, array $additional_data = array() ) {
+ parent::__construct( 'woocommerce_fulfillment_error', $message, $http_status_code, $additional_data );
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/FulfillmentUtils.php b/plugins/woocommerce/src/Internal/Fulfillments/FulfillmentUtils.php
new file mode 100644
index 0000000000..c1c579c4b0
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/FulfillmentUtils.php
@@ -0,0 +1,679 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments;
+
+use Automattic\WooCommerce\Internal\Fulfillments\Providers\AbstractShippingProvider;
+use WC_Order;
+
+/**
+ * Class FulfillmentUtils
+ *
+ * Utility class for handling order fulfillments.
+ */
+class FulfillmentUtils {
+
+ /**
+ * Get pending items for an order.
+ *
+ * @param WC_Order $order The order object.
+ * @param array $fulfillments An array of fulfillments to check.
+ * @param bool $without_refunds Whether to exclude refunded items from the pending items.
+ *
+ * @return array An array of pending items.
+ */
+ public static function get_pending_items( WC_Order $order, $fulfillments, $without_refunds = true ): array {
+ $items_in_fulfillments = self::get_all_items_of_fulfillments( $fulfillments );
+ $order_items = array_map(
+ function ( $item ) use ( $order, $without_refunds ) {
+ // Refunded item quantities are saved as negative values in the order.
+ return array(
+ 'item_id' => $item->get_id(),
+ 'item' => $item,
+ 'qty' => $item->get_quantity() + ( $without_refunds ? $order->get_qty_refunded_for_item( $item->get_id() ) : 0 ),
+ );
+ },
+ $order->get_items() ?? array()
+ );
+
+ // If there are items in fulfillments, subtract their quantities from the order items.
+ if ( ! empty( $items_in_fulfillments ) ) {
+ foreach ( $order_items as $item_id => &$item ) {
+ if ( isset( $items_in_fulfillments[ $item_id ] ) ) {
+ $item['qty'] = $item['qty'] - $items_in_fulfillments[ $item_id ];
+ }
+ }
+ }
+
+ return array_filter(
+ $order_items,
+ function ( $item ) {
+ return $item['qty'] > 0; // Only return items with a positive quantity.
+ }
+ );
+ }
+
+ /**
+ * Get refunded items for an order.
+ *
+ * @param WC_Order $order The order object.
+ *
+ * @return array An array of refunded items with their IDs and quantities.
+ */
+ public static function get_refunded_items( WC_Order $order ): array {
+ $items_refunded = array();
+ foreach ( $order->get_items() as $item ) {
+ $items_refunded[ $item->get_id() ] = -1 * $order->get_qty_refunded_for_item( $item->get_id() );
+ }
+ return array_filter(
+ $items_refunded,
+ function ( $qty ) {
+ return $qty > 0; // Only include items that have been refunded.
+ }
+ );
+ }
+
+ /**
+ * Get order items for a fulfillment.
+ *
+ * @param WC_Order $order The order object.
+ * @param Fulfillment $fulfillment The fulfillment object.
+ *
+ * @return array An array of order items.
+ */
+ public static function get_fulfillment_items( WC_Order $order, Fulfillment $fulfillment ): array {
+ $fulfillment_items = array_combine(
+ array_column( $fulfillment->get_items(), 'item_id' ),
+ array_column( $fulfillment->get_items(), 'qty' )
+ );
+
+ $order_items = array_map(
+ function ( $item ) use ( $order ) {
+ return array(
+ 'item_id' => $item->get_id(),
+ 'item' => $item,
+ 'qty' => $item->get_quantity() - $order->get_qty_refunded_for_item( $item ),
+ );
+ },
+ $order->get_items()
+ );
+
+ return array_map(
+ function ( $item ) use ( $fulfillment_items ) {
+ $item['qty'] = $fulfillment_items[ $item['item_id'] ];
+ return $item;
+ },
+ array_filter(
+ $order_items,
+ function ( $item ) use ( $fulfillment_items ) {
+ return isset( $fulfillment_items[ $item['item_id'] ] );
+ }
+ )
+ );
+ }
+
+ /**
+ * Check if an order has pending items.
+ *
+ * @param WC_Order $order The order object.
+ * @param array $fulfillments An array of fulfillments to check.
+ *
+ * @return bool True if there are pending items, false otherwise.
+ */
+ public static function has_pending_items( WC_Order $order, array $fulfillments ): bool {
+ $pending_items = self::get_pending_items( $order, $fulfillments );
+ return ! empty( $pending_items );
+ }
+
+ /**
+ * Get the fulfillment status of the entity. This runs like a computed property, where
+ * it checks the fulfillment status of each fulfillment attached to the order,
+ * and computes the overall fulfillment status of the order.
+ *
+ * @param WC_Order $order The order object.
+ * @param array $fulfillments An array of fulfillments to check.
+ *
+ * @return string The fulfillment status.
+ */
+ public static function calculate_order_fulfillment_status( WC_Order $order, $fulfillments = array() ): string {
+ $has_fulfillments = ! empty( $fulfillments );
+ if ( $has_fulfillments ) {
+ $pending_items = self::get_pending_items( $order, $fulfillments );
+
+ $all_fulfilled = true;
+ $some_fulfilled = false;
+
+ foreach ( $fulfillments as $fulfillment ) {
+ if ( ! $fulfillment->get_is_fulfilled() ) {
+ $all_fulfilled = false;
+ } else {
+ $some_fulfilled = true;
+ }
+ }
+
+ if ( $all_fulfilled && empty( $pending_items ) ) {
+ $status = 'fulfilled';
+ } elseif ( $some_fulfilled ) {
+ $status = 'partially_fulfilled';
+ } else {
+ $status = 'unfulfilled';
+ }
+ } else {
+ $status = 'no_fulfillments';
+ }
+
+ /**
+ * This filter allows plugins to modify the fulfillment status of an order.
+ *
+ * @since 10.1.0
+ *
+ * @param string $status The default fulfillment status.
+ * @param WC_Order $order The order object.
+ * @param array $fulfillments An array of fulfillments for the order.
+ */
+ return apply_filters(
+ 'woocommerce_fulfillment_calculate_order_fulfillment_status',
+ $status,
+ $order,
+ $fulfillments
+ );
+ }
+
+ /**
+ * Get all items from the fulfillments.
+ *
+ * @param array $fulfillments An array of fulfillments.
+ *
+ * @return array An associative array of item IDs and their quantities.
+ */
+ public static function get_all_items_of_fulfillments( array $fulfillments ): array {
+ $items = array();
+ foreach ( $fulfillments as $fulfillment ) {
+ $fulfillment_items = $fulfillment->get_items();
+ foreach ( $fulfillment_items as $item ) {
+ if ( ! isset( $items[ $item['item_id'] ] ) ) {
+ $items[ $item['item_id'] ] = 0; // Initialize if not set.
+ }
+ // Sum the quantities for each item.
+ $items[ $item['item_id'] ] += $item['qty'];
+ }
+ }
+ return $items;
+ }
+
+ /**
+ * Get the HTML for the fulfillment tracking number.
+ *
+ * @param Fulfillment $fulfillment The fulfillment object.
+ *
+ * @return string The HTML for the tracking number.
+ */
+ public static function get_tracking_info_html( Fulfillment $fulfillment ): string {
+ $tracking_html = '';
+ $tracking_url = $fulfillment->get_meta( '_tracking_url', true );
+ $tracking_number = $fulfillment->get_meta( '_tracking_number', true );
+ if ( ! empty( $tracking_url ) && ! empty( $tracking_number ) ) {
+ $tracking_html .= '<a href="' . esc_url( $tracking_url ) . '" target="_blank" rel="noopener noreferrer">';
+ $tracking_html .= esc_html( $tracking_number );
+ $tracking_html .= '</a>';
+ } elseif ( ! empty( $tracking_number ) ) {
+ $tracking_html .= esc_html( $tracking_number );
+ } else {
+ $tracking_html .= '<span class="no-tracking">' . esc_html__( 'No tracking number available', 'woocommerce' ) . '</span>';
+ }
+ return $tracking_html;
+ }
+
+ /**
+ * Get the fulfillment status text for an order.
+ *
+ * @param WC_Order $order The order object.
+ *
+ * @return string The fulfillment status text.
+ */
+ public static function get_order_fulfillment_status_text( WC_Order $order ): string {
+ // Ensure the order is a valid WC_Order object.
+ if ( ! $order instanceof WC_Order ) {
+ return '';
+ }
+
+ // Check if the order meta exists for fulfillment status.
+ $fulfillment_status = $order->meta_exists( '_fulfillment_status' ) ? $order->get_meta( '_fulfillment_status', true ) : 'no_fulfillments';
+
+ $fulfillment_status_text = '';
+ switch ( $fulfillment_status ) {
+ case 'fulfilled':
+ $fulfillment_status_text = ' ' . __( 'It has been <mark class="fulfillment-status">Fulfilled</mark>.', 'woocommerce' );
+ break;
+ case 'partially_fulfilled':
+ $fulfillment_status_text = ' ' . __( 'It has been <mark class="fulfillment-status">Partially fulfilled</mark>.', 'woocommerce' );
+ break;
+ case 'unfulfilled':
+ $fulfillment_status_text = ' ' . __( 'It is currently <mark class="fulfillment-status">Unfulfilled</mark>.', 'woocommerce' );
+ break;
+ case 'no_fulfillments':
+ $fulfillment_status_text = ' ' . __( 'It has <mark class="fulfillment-status">no fulfillments</mark> yet.', 'woocommerce' );
+ break;
+ }
+
+ /**
+ * This filter allows plugins to modify the fulfillment status text for an order for their custom fulfillment statuses.
+ *
+ * @since 10.1.0
+ *
+ * @param string $fulfillment_status_text The default fulfillment status text.
+ * @param string $fulfillment_status The fulfillment status of the order.
+ * @param WC_Order $order The order object.
+ */
+ return apply_filters(
+ 'woocommerce_fulfillment_order_fulfillment_status_text',
+ $fulfillment_status_text,
+ $fulfillment_status,
+ $order
+ );
+ }
+
+ /**
+ * Check if the given fulfillment status is valid.
+ *
+ * @param string|null $status The fulfillment status to check.
+ *
+ * @return bool True if the status is valid, false otherwise.
+ */
+ public static function is_valid_order_fulfillment_status( ?string $status ): bool {
+ if ( is_null( $status ) ) {
+ return false;
+ }
+ $order_fulfillment_statuses = self::get_order_fulfillment_statuses();
+ return in_array( $status, array_keys( $order_fulfillment_statuses ), true );
+ }
+
+ /**
+ * Check if the given fulfillment status is valid.
+ *
+ * @param string|null $status The fulfillment status to check.
+ *
+ * @return bool True if the status is valid, false otherwise.
+ */
+ public static function is_valid_fulfillment_status( ?string $status ): bool {
+ if ( is_null( $status ) ) {
+ return false;
+ }
+ $fulfillment_statuses = self::get_fulfillment_statuses();
+ return in_array( $status, array_keys( $fulfillment_statuses ), true );
+ }
+
+ /**
+ * Get the order fulfillment statuses.
+ *
+ * This method provides the order fulfillment statuses that can be used
+ * in the WooCommerce Fulfillments system. It can be filtered using the
+ * `woocommerce_fulfillment_order_fulfillment_statuses` filter.
+ *
+ * @return array An associative array of order fulfillment statuses.
+ */
+ public static function get_order_fulfillment_statuses(): array {
+ /**
+ * This filter allows plugins to modify the list of order fulfillment statuses.
+ * It can be used to add, remove, or change the order fulfillment statuses available in the
+ * WooCommerce Fulfillments system.
+ *
+ * @since 10.1.0
+ *
+ * @param array $order_fulfillment_statuses The default list of order fulfillment statuses.
+ */
+ return apply_filters(
+ 'woocommerce_fulfillment_order_fulfillment_statuses',
+ self::get_default_order_fulfillment_statuses()
+ );
+ }
+
+ /**
+ * Get the fulfillment statuses.
+ *
+ * This method provides the fulfillment statuses that can be used
+ * in the WooCommerce Fulfillments system. It can be filtered using the
+ * `woocommerce_fulfillment_fulfillment_statuses` filter.
+ *
+ * @return array An associative array of fulfillment statuses.
+ */
+ public static function get_fulfillment_statuses(): array {
+ /**
+ * This filter allows plugins to modify the list of fulfillment statuses.
+ * It can be used to add, remove, or change the fulfillment statuses available in the
+ * WooCommerce Fulfillments system.
+ *
+ * @since 10.1.0
+ *
+ * @param array $fulfillment_statuses The default list of fulfillment statuses.
+ */
+ return apply_filters(
+ 'woocommerce_fulfillment_fulfillment_statuses',
+ self::get_default_fulfillment_statuses()
+ );
+ }
+
+ /**
+ * Get the shipping providers.
+ *
+ * This method retrieves the shipping providers registered in the WooCommerce Fulfillments system.
+ * It can be filtered using the `woocommerce_fulfillment_shipping_providers` filter.
+ *
+ * @return array An associative array of shipping providers with their details.
+ */
+ public static function get_shipping_providers(): array {
+ /**
+ * This filter allows plugins to modify the list of shipping providers.
+ * It can be used to add, remove, or change the shipping providers available in the
+ * WooCommerce Fulfillments system.
+ *
+ * @since 10.1.0
+ *
+ * @param array $shipping_providers The default list of shipping providers.
+ */
+ return apply_filters(
+ 'woocommerce_fulfillment_shipping_providers',
+ array()
+ );
+ }
+
+ /**
+ * Get the shipping providers as an array of JS objects, for use in the fulfillment UI.
+ *
+ * @return array An associative array of shipping providers with their details.
+ */
+ public static function get_shipping_providers_object(): array {
+ $shipping_providers = self::get_shipping_providers();
+ if ( ! is_array( $shipping_providers ) ) {
+ return array();
+ }
+ $shipping_providers_object = array();
+ foreach ( $shipping_providers as $shipping_provider ) {
+ if ( is_string( $shipping_provider )
+ && class_exists( $shipping_provider )
+ && is_subclass_of( $shipping_provider, AbstractShippingProvider::class )
+ ) {
+ try {
+ // Instantiate the shipping provider class.
+ $shipping_provider_instance = wc_get_container()->get( $shipping_provider );
+ } catch ( \Throwable $e ) {
+ continue; // Skip if instantiation fails.
+ }
+ $shipping_providers_object[ $shipping_provider_instance->get_key() ] = array(
+ 'label' => $shipping_provider_instance->get_name(),
+ 'icon' => $shipping_provider_instance->get_icon(),
+ 'value' => $shipping_provider_instance->get_key(),
+ );
+ }
+ if ( is_object( $shipping_provider ) && $shipping_provider instanceof AbstractShippingProvider ) {
+ $shipping_providers_object[ $shipping_provider->get_key() ] = array(
+ 'label' => $shipping_provider->get_name(),
+ 'icon' => $shipping_provider->get_icon(),
+ 'value' => $shipping_provider->get_key(),
+ );
+ }
+ }
+
+ return $shipping_providers_object;
+ }
+
+ /**
+ * Get the default order fulfillment statuses.
+ *
+ * This method provides the default order fulfillment statuses that can be used
+ * in the WooCommerce Fulfillments system. It can be filtered using the
+ * `woocommerce_fulfillment_order_fulfillment_statuses` filter.
+ *
+ * @return array An associative array of default order fulfillment statuses.
+ */
+ protected static function get_default_order_fulfillment_statuses(): array {
+ return array(
+ 'fulfilled' => array(
+ 'label' => __( 'Fulfilled', 'woocommerce' ),
+ 'background_color' => '#C6E1C6',
+ 'text_color' => '#13550F',
+ ),
+ 'partially_fulfilled' => array(
+ 'label' => __( 'Partially fulfilled', 'woocommerce' ),
+ 'background_color' => '#C8D7E1',
+ 'text_color' => '#003D66',
+ ),
+ 'unfulfilled' => array(
+ 'label' => __( 'Unfulfilled', 'woocommerce' ),
+ 'background_color' => '#FBE5E5',
+ 'text_color' => '#CC1818',
+ ),
+ 'no_fulfillments' => array(
+ 'label' => __( 'No fulfillments', 'woocommerce' ),
+ 'background_color' => '#F0F0F0',
+ 'text_color' => '#2F2F2F',
+ ),
+ );
+ }
+
+ /**
+ * Get the default fulfillment statuses.
+ *
+ * This method provides the default fulfillment statuses that can be used
+ * in the WooCommerce Fulfillments system. It can be filtered using the
+ * `woocommerce_fulfillment_fulfillment_statuses` filter.
+ *
+ * @return array An associative array of default fulfillment statuses.
+ */
+ protected static function get_default_fulfillment_statuses(): array {
+ return array(
+ 'fulfilled' => array(
+ 'label' => __( 'Fulfilled', 'woocommerce' ),
+ 'is_fulfilled' => true,
+ 'background_color' => '#C6E1C6',
+ 'text_color' => '#13550F',
+ ),
+ 'unfulfilled' => array(
+ 'label' => __( 'Unfulfilled', 'woocommerce' ),
+ 'is_fulfilled' => false,
+ 'background_color' => '#FBE5E5',
+ 'text_color' => '#CC1818',
+ ),
+ );
+ }
+
+ /**
+ * Calculate the S10 check digit for UPU tracking numbers.
+ *
+ * @param string $tracking_number The tracking number without the check digit.
+ *
+ * @return bool True if the check digit is valid, false otherwise.
+ */
+ public static function check_s10_upu_format( string $tracking_number ): bool {
+ if ( preg_match( '/^[A-Z]{2}\d{9}[A-Z]{2}$/', $tracking_number ) ) {
+ // The tracking number is in the UPU S10 format.
+ $tracking_number = substr( $tracking_number, 2, -2 );
+ } elseif ( ! preg_match( '/^\d{9}$/', $tracking_number ) ) {
+ // Ensure the tracking number is exactly 9 digits.
+ return false;
+ }
+
+ // Define the weights for the S10 check digit calculation.
+ $weights = array( 8, 6, 4, 2, 3, 5, 9, 7 );
+ $sum = 0;
+
+ // Calculate the weighted sum of the digits.
+ for ( $i = 0; $i < 8; $i++ ) {
+ $sum += $weights[ $i ] * (int) $tracking_number[ $i ];
+ }
+
+ // Calculate the check digit.
+ $check_digit = 11 - ( $sum % 11 );
+ if ( 10 === $check_digit ) {
+ $check_digit = 0;
+ } elseif ( 11 === $check_digit ) {
+ $check_digit = 5;
+ }
+
+ // Validate the check digit against the last digit of the tracking number.
+ return (int) $tracking_number[8] === $check_digit;
+ }
+
+ /**
+ * Validate UPS 1Z tracking number using Mod 10 check digit.
+ *
+ * @param string $tracking_number The UPS 1Z tracking number.
+ * @return bool True if valid, false otherwise.
+ */
+ public static function validate_ups_1z_check_digit( string $tracking_number ): bool {
+ if ( ! preg_match( '/^1Z[0-9A-Z]{15,16}$/', $tracking_number ) ) {
+ return false;
+ }
+
+ // Extract the trackable part (remove 1Z prefix).
+ $trackable = substr( $tracking_number, 2 );
+ $check_digit = (int) substr( $trackable, -1 );
+ $trackable = substr( $trackable, 0, -1 );
+
+ $sum = 0;
+ $odd_position = true;
+
+ // Process each character from right to left.
+ for ( $i = strlen( $trackable ) - 1; $i >= 0; $i-- ) {
+ $char = $trackable[ $i ];
+ $value = is_numeric( $char ) ? (int) $char : ord( $char ) - 55; // A=10, B=11, etc.
+
+ if ( $odd_position ) {
+ $value *= 2;
+ if ( $value > 9 ) {
+ $value = (int) ( $value / 10 ) + ( $value % 10 );
+ }
+ }
+
+ $sum += $value;
+ $odd_position = ! $odd_position;
+ }
+
+ $calculated_check = ( 10 - ( $sum % 10 ) ) % 10;
+ return $calculated_check === $check_digit;
+ }
+
+ /**
+ * Validate Mod 7 check digit for numeric tracking numbers.
+ *
+ * @param string $tracking_number The numeric tracking number.
+ * @return bool True if valid, false otherwise.
+ */
+ public static function validate_mod7_check_digit( string $tracking_number ): bool {
+ if ( ! preg_match( '/^\d+$/', $tracking_number ) || strlen( $tracking_number ) < 2 ) {
+ return false;
+ }
+
+ $check_digit = (int) substr( $tracking_number, -1 );
+ $number = substr( $tracking_number, 0, -1 );
+ $sum = 0;
+ $weights = array( 3, 1, 3, 1, 3, 1, 3 ); // Mod 7 weights.
+ $weight_index = 0;
+ // Process each digit from right to left.
+ for ( $i = strlen( $number ) - 1; $i >= 0; $i-- ) {
+ $digit = (int) $number[ $i ];
+ $sum += $digit * $weights[ $weight_index % count( $weights ) ];
+ ++$weight_index;
+ }
+ $calculated_check = $sum % 7;
+ if ( 0 === $calculated_check ) {
+ $calculated_check = 7; // If the sum is a multiple of 7, the check digit is 7.
+ }
+ return $calculated_check === $check_digit;
+ }
+
+ /**
+ * Validate Mod 10 check digit for numeric tracking numbers.
+ *
+ * @param string $tracking_number The numeric tracking number.
+ * @return bool True if valid, false otherwise.
+ */
+ public static function validate_mod10_check_digit( string $tracking_number ): bool {
+ if ( ! preg_match( '/^\d+$/', $tracking_number ) || strlen( $tracking_number ) < 2 ) {
+ return false;
+ }
+
+ $check_digit = (int) substr( $tracking_number, -1 );
+ $number = substr( $tracking_number, 0, -1 );
+
+ $sum = 0;
+ $odd_position = true;
+
+ // Process each digit from right to left.
+ for ( $i = strlen( $number ) - 1; $i >= 0; $i-- ) {
+ $digit = (int) $number[ $i ];
+
+ if ( $odd_position ) {
+ $digit *= 2;
+ if ( $digit > 9 ) {
+ $digit = (int) ( $digit / 10 ) + ( $digit % 10 );
+ }
+ }
+
+ $sum += $digit;
+ $odd_position = ! $odd_position;
+ }
+
+ $calculated_check = ( 10 - ( $sum % 10 ) ) % 10;
+ return $calculated_check === $check_digit;
+ }
+
+ /**
+ * Validate Mod 11 check digit for tracking numbers (used by DHL).
+ *
+ * @param string $tracking_number The tracking number.
+ * @return bool True if valid, false otherwise.
+ */
+ public static function validate_mod11_check_digit( string $tracking_number ): bool {
+ if ( ! preg_match( '/^\d+$/', $tracking_number ) || strlen( $tracking_number ) < 2 ) {
+ return false;
+ }
+
+ $check_digit = (int) substr( $tracking_number, -1 );
+ $number = substr( $tracking_number, 0, -1 );
+
+ $weights = array( 2, 3, 4, 5, 6, 7, 8, 9, 10, 11 );
+ $sum = 0;
+ $weight_index = 0;
+
+ // Process each digit from right to left.
+ for ( $i = strlen( $number ) - 1; $i >= 0; $i-- ) {
+ $digit = (int) $number[ $i ];
+ $sum += $digit * $weights[ $weight_index % count( $weights ) ];
+ ++$weight_index;
+ }
+
+ $calculated_check = 11 - ( $sum % 11 );
+ if ( 10 === $calculated_check ) {
+ $calculated_check = 0;
+ } elseif ( 11 === $calculated_check ) {
+ $calculated_check = 5;
+ }
+
+ return $calculated_check === $check_digit;
+ }
+
+ /**
+ * Validate FedEx check digit for 12/14-digit tracking numbers.
+ *
+ * @param string $tracking_number The FedEx tracking number.
+ * @return bool True if valid, false otherwise.
+ */
+ public static function validate_fedex_check_digit( string $tracking_number ): bool {
+ if ( ! preg_match( '/^\d{12}$/', $tracking_number ) ) {
+ return false;
+ }
+ $digits = str_split( substr( $tracking_number, 0, 11 ) );
+ $multipliers = array( 3, 1, 7 );
+ $sum = 0;
+ $multiplier_index = 0;
+ for ( $i = 10; $i >= 0; $i-- ) {
+ $sum += $digits[ $i ] * $multipliers[ $multiplier_index ];
+ $multiplier_index = ( ++$multiplier_index ) % 3;
+ }
+ $check = $sum % 11;
+ if ( 10 === $check ) {
+ $check = 0;
+ }
+ return intval( $tracking_number[11] ) === $check;
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/FulfillmentsController.php b/plugins/woocommerce/src/Internal/Fulfillments/FulfillmentsController.php
new file mode 100644
index 0000000000..871af3e47c
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/FulfillmentsController.php
@@ -0,0 +1,209 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments;
+
+use Automattic\WooCommerce\Internal\Features\FeaturesController;
+use Automattic\WooCommerce\Internal\Utilities\DatabaseUtil;
+
+/**
+ * Class FulfillmentsController
+ *
+ * Base controller for fulfillments management.
+ */
+class FulfillmentsController {
+ /**
+ * Database utility instance.
+ *
+ * @var DatabaseUtil
+ */
+ private DatabaseUtil $database_util;
+
+ /**
+ * FeaturesController instance.
+ *
+ * @var FeaturesController
+ */
+ private FeaturesController $features_controller;
+
+ /**
+ * Provides the list of classes that this controller provides.
+ *
+ * @var string[]
+ */
+ private $provides = array(
+ FulfillmentsManager::class,
+ FulfillmentsRenderer::class,
+ FulfillmentsSettings::class,
+ OrderFulfillmentsRestController::class,
+ );
+
+ /**
+ * FulfillmentsController constructor.
+ */
+ public function __construct() {
+ $container = wc_get_container();
+ $this->database_util = $container->get( DatabaseUtil::class );
+ $this->features_controller = $container->get( FeaturesController::class );
+ }
+
+ /**
+ * Initialize the controller.
+ *
+ * @return void
+ */
+ public function register() {
+ // If fulfillments feature is not enabled, do not add the DB tables, and don't register the controller.
+ if ( ! $this->features_controller->feature_is_enabled( 'fulfillments' ) ) {
+ return;
+ }
+
+ // Create the database tables if they do not exist.
+ $this->maybe_create_db_tables();
+
+ // Register the classes that this controller provides.
+ $container = wc_get_container();
+ foreach ( $this->provides as $class ) {
+ $class = $container->get( $class );
+ if ( method_exists( $class, 'register' ) ) {
+ $class->register();
+ }
+ }
+ }
+
+ /**
+ * Create the database tables if they do not exist.
+ *
+ * @return void
+ */
+ private function maybe_create_db_tables(): void {
+ global $wpdb;
+
+ if ( get_option( 'woocommerce_fulfillments_db_tables_created', false ) ) {
+ // The tables already exist, no need to create them again.
+ return;
+ }
+
+ // Drop the tables if they exist, to ensure a clean slate.
+ // If one table exists and the other does not, it will be an issue.
+ $wpdb->query( "DROP TABLE IF EXISTS {$wpdb->prefix}wc_order_fulfillments" );
+ $wpdb->query( "DROP TABLE IF EXISTS {$wpdb->prefix}wc_order_fulfillment_meta" );
+
+ // Bulk delete order fulfillment status meta from legacy and HPOS order tables.
+ $this->bulk_delete_order_fulfillment_status_meta();
+
+ $collate = '';
+ $max_index_length = $this->database_util->get_max_index_length();
+ if ( $wpdb->has_cap( 'collation' ) ) {
+ $collate = $wpdb->get_charset_collate();
+ }
+
+ $schema = "CREATE TABLE {$wpdb->prefix}wc_order_fulfillments (
+ fulfillment_id bigint(20) unsigned NOT NULL AUTO_INCREMENT,
+ entity_type varchar(255) NOT NULL,
+ entity_id bigint(20) unsigned NOT NULL,
+ status varchar(255) NOT NULL,
+ is_fulfilled tinyint(1) NOT NULL DEFAULT 0,
+ date_updated datetime NOT NULL,
+ date_deleted datetime NULL,
+ PRIMARY KEY (fulfillment_id),
+ KEY entity_type_id (entity_type({$max_index_length}), entity_id)
+ ) $collate;
+ CREATE TABLE {$wpdb->prefix}wc_order_fulfillment_meta (
+ meta_id bigint(20) unsigned NOT NULL AUTO_INCREMENT,
+ fulfillment_id bigint(20) unsigned NOT NULL,
+ meta_key varchar(255) NULL,
+ meta_value longtext NULL,
+ date_updated datetime NOT NULL,
+ date_deleted datetime NULL,
+ PRIMARY KEY (meta_id),
+ KEY meta_key (meta_key({$max_index_length})),
+ KEY fulfillment_id (fulfillment_id)
+ ) $collate;";
+
+ $this->database_util->dbdelta( $schema );
+
+ // Update the option to indicate that the tables have been created.
+ update_option( 'woocommerce_fulfillments_db_tables_created', true );
+ }
+
+ /**
+ * Bulk delete fulfillment status meta for specific order IDs, or all orders if no order ID specified.
+ *
+ * This method deletes the fulfillment status meta for the specified order IDs from both the legacy postmeta table
+ * and the HPOS meta table.
+ *
+ * @param array<int> $order_ids Array of order IDs to delete fulfillment status meta for.
+ */
+ private function bulk_delete_order_fulfillment_status_meta( $order_ids = array() ): void {
+ $this->delete_legacy_order_fulfillment_meta( $order_ids );
+ $this->delete_hpos_order_fulfillment_meta( $order_ids );
+ }
+
+ /**
+ * Delete fulfillment status meta from legacy postmeta table.
+ *
+ * @param array<int> $order_ids Array of order IDs to delete fulfillment status meta for.
+ */
+ private function delete_legacy_order_fulfillment_meta( $order_ids = array() ) {
+ global $wpdb;
+
+ if ( ! empty( $order_ids ) ) {
+ $order_params = array_merge( array( '_fulfillment_status' ), $order_ids );
+ $wpdb->query(
+ $wpdb->prepare(
+ "DELETE pm FROM {$wpdb->postmeta} pm
+ INNER JOIN {$wpdb->posts} p ON pm.post_id = p.ID
+ WHERE p.post_type = 'shop_order'
+ AND pm.meta_key = %s
+ AND pm.post_id IN (" . implode( ',', array_fill( 0, count( $order_ids ), '%d' ) ) . ')',
+ ...$order_params
+ )
+ );
+ } else {
+ $wpdb->query(
+ $wpdb->prepare(
+ "DELETE pm FROM {$wpdb->postmeta} pm
+ INNER JOIN {$wpdb->posts} p ON pm.post_id = p.ID
+ WHERE p.post_type = 'shop_order'
+ AND pm.meta_key = %s",
+ '_fulfillment_status'
+ )
+ );
+ }
+ }
+
+ /**
+ * Delete fulfillment status meta from HPOS meta table.
+ *
+ * @param array<int> $order_ids Array of order IDs to delete fulfillment status meta for.
+ */
+ private function delete_hpos_order_fulfillment_meta( $order_ids = array() ): void {
+ global $wpdb;
+
+ // Check if HPOS meta table exists.
+ $table_name = $wpdb->prefix . 'wc_orders_meta';
+ if ( $wpdb->get_var( $wpdb->prepare( 'SHOW TABLES LIKE %s', $table_name ) ) !== $table_name ) {
+ return;
+ }
+
+ if ( ! empty( $order_ids ) ) {
+ $order_params = array_merge( array( '_fulfillment_status' ), $order_ids );
+ $wpdb->query(
+ $wpdb->prepare(
+ "DELETE FROM {$wpdb->prefix}wc_orders_meta
+ WHERE meta_key = %s
+ AND order_id IN (" . implode( ',', array_fill( 0, count( $order_ids ), '%d' ) ) . ')',
+ ...$order_params
+ )
+ );
+ } else {
+ $wpdb->query(
+ $wpdb->prepare(
+ "DELETE FROM {$wpdb->prefix}wc_orders_meta
+ WHERE meta_key = %s",
+ '_fulfillment_status'
+ )
+ );
+ }
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/FulfillmentsManager.php b/plugins/woocommerce/src/Internal/Fulfillments/FulfillmentsManager.php
new file mode 100644
index 0000000000..e9be415daf
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/FulfillmentsManager.php
@@ -0,0 +1,432 @@
+<?php
+/**
+ * WooCommerce Fulfillment Hooks
+ */
+
+declare( strict_types=1 );
+
+namespace Automattic\WooCommerce\Internal\Fulfillments;
+
+use Automattic\WooCommerce\Internal\DataStores\Fulfillments\FulfillmentsDataStore;
+use Automattic\WooCommerce\Internal\Fulfillments\Providers\AbstractShippingProvider;
+use WC_Order;
+use WC_Order_Refund;
+
+/**
+ * FulfillmentsManager class.
+ *
+ * This class is responsible for adding hooks related to fulfillments in WooCommerce.
+ *
+ * @since 10.1.0
+ * @package WooCommerce\Internal\Fulfillments
+ */
+class FulfillmentsManager {
+ /**
+ * Class constructor.
+ */
+ public function __construct() {
+ add_filter( 'woocommerce_fulfillment_shipping_providers', array( $this, 'get_initial_shipping_providers' ), 10, 1 );
+ add_filter( 'woocommerce_fulfillment_translate_meta_key', array( $this, 'translate_fulfillment_meta_key' ), 10, 1 );
+ add_filter( 'woocommerce_fulfillment_parse_tracking_number', array( $this, 'try_parse_tracking_number' ), 10, 3 );
+
+ $this->init_fulfillment_status_hooks();
+ $this->init_refund_hooks();
+ }
+
+ /**
+ * Hook fulfillment status events.
+ *
+ * This method hooks into the fulfillment status events to update the order fulfillment status
+ * when a fulfillment is created, updated, or deleted.
+ */
+ private function init_fulfillment_status_hooks() {
+ // Update order fulfillment status when a fulfillment is created, updated, or deleted.
+ add_action( 'woocommerce_fulfillment_after_create', array( $this, 'update_order_fulfillment_status_on_fulfillment_update' ), 10, 1 );
+ add_action( 'woocommerce_fulfillment_after_update', array( $this, 'update_order_fulfillment_status_on_fulfillment_update' ), 10, 1 );
+ add_action( 'woocommerce_fulfillment_after_delete', array( $this, 'update_order_fulfillment_status_on_fulfillment_update' ), 10, 1 );
+ }
+
+ /**
+ * Initialize refund-related hooks.
+ *
+ * This method initializes the hooks related to refunds, such as updating fulfillments after a refund is created
+ */
+ private function init_refund_hooks() {
+ add_action( 'woocommerce_refund_created', array( $this, 'update_fulfillments_after_refund' ), 10, 1 );
+ add_action( 'woocommerce_delete_order_refund', array( $this, 'update_fulfillment_status_after_refund_deleted' ), 10, 1 );
+ }
+
+ /**
+ * Translate fulfillment meta keys.
+ *
+ * @param string $meta_key The meta key to translate.
+ * @return string Translated meta key.
+ */
+ public function translate_fulfillment_meta_key( $meta_key ) {
+ /**
+ * Filter to translate fulfillment meta keys.
+ *
+ * This filter allows us to translate fulfillment meta keys
+ * to make them more user-friendly in the admin interface and emails.
+ *
+ * @since 10.1.0
+ */
+ $meta_key_translations = apply_filters(
+ 'woocommerce_fulfillment_meta_key_translations',
+ array(
+ 'fulfillment_status' => __( 'Fulfillment Status', 'woocommerce' ),
+ 'shipment_tracking' => __( 'Shipment Tracking', 'woocommerce' ),
+ 'shipment_provider' => __( 'Shipment Provider', 'woocommerce' ),
+ )
+ );
+ return isset( $meta_key_translations[ $meta_key ] ) ? $meta_key_translations[ $meta_key ] : $meta_key;
+ }
+
+ /**
+ * Get initial shipping providers.
+ *
+ * This method provides the initial shipping providers that feeds the `woocommerce_fulfillment_shipping_providers` filter,
+ * which is used to populate the list of available shipping providers on the fulfillment UI.
+ *
+ * @param array $shipping_providers The current list of shipping providers.
+ *
+ * @return array The modified list of shipping providers.
+ */
+ public function get_initial_shipping_providers( $shipping_providers ) {
+ if ( ! is_array( $shipping_providers ) ) {
+ $shipping_providers = array();
+ }
+
+ $shipping_providers = array_merge(
+ $shipping_providers,
+ include __DIR__ . '/ShippingProviders.php'
+ );
+
+ ksort( $shipping_providers );
+
+ return $shipping_providers;
+ }
+
+ /**
+ * Update order fulfillment status after a fulfillment is created, updated, or deleted.
+ *
+ * @param Fulfillment $data The fulfillment data.
+ */
+ public function update_order_fulfillment_status_on_fulfillment_update( Fulfillment $data ) {
+ if ( ! $data instanceof Fulfillment ) {
+ return;
+ }
+
+ $order = $data->get_order();
+ if ( ! $order instanceof \WC_Order ) {
+ return;
+ }
+
+ /**
+ * Get the FulfillmentsDataStore instance.
+ *
+ * @var FulfillmentsDataStore $fulfillments_data_store
+ */
+ $fulfillments_data_store = wc_get_container()->get( FulfillmentsDataStore::class );
+ // Read all fulfillments for the order.
+ $fulfillments = $fulfillments_data_store->read_fulfillments( \WC_Order::class, (string) $order->get_id() );
+
+ $this->update_fulfillment_status( $order, $fulfillments );
+ }
+
+ /**
+ * Update fulfillment status after a refund is deleted.
+ *
+ * This method updates the fulfillment status after a refund is deleted to ensure that the fulfillment status
+ * and items are correctly adjusted based on the refund deletion.
+ *
+ * @param int $refund_id The ID of the refund being deleted.
+ *
+ * @return void
+ */
+ public function update_fulfillment_status_after_refund_deleted( int $refund_id ): void {
+ $refund = wc_get_order( $refund_id );
+ if ( ! $refund instanceof \WC_Order ) {
+ return; // If the refund is not a valid order, do nothing.
+ }
+
+ $order_id = $refund->get_parent_id();
+ if ( ! $order_id ) {
+ return; // If the refund does not have a parent order, do nothing.
+ }
+
+ $order = wc_get_order( $order_id );
+ if ( ! $order instanceof \WC_Order ) {
+ return; // If the order is not valid, do nothing.
+ }
+
+ $fulfillments_data_store = wc_get_container()->get( FulfillmentsDataStore::class );
+ $fulfillments = $fulfillments_data_store->read_fulfillments( \WC_Order::class, (string) $order_id );
+
+ $this->update_fulfillment_status( $order, $fulfillments );
+ }
+
+
+ /**
+ * Update fulfillments after a refund is created.
+ *
+ * @param int $refund_id The ID of the refund created.
+ *
+ * @return void
+ */
+ public function update_fulfillments_after_refund( int $refund_id ): void {
+ // Get the order object.
+ $refund = $refund_id ? wc_get_order( $refund_id ) : null;
+ if ( ! $refund instanceof WC_Order_Refund ) {
+ return; // If the order is not valid, do nothing.
+ }
+
+ $order_id = $refund->get_parent_id();
+ if ( ! $order_id ) {
+ return; // If the refund does not have a parent order, do nothing.
+ }
+ $order = wc_get_order( $order_id );
+ if ( ! $order instanceof \WC_Order ) {
+ return; // If the order is not valid, do nothing.
+ }
+
+ // If there are no refunded items, we can skip the fulfillment update.
+ $items_refunded = FulfillmentUtils::get_refunded_items( $order );
+ if ( empty( $items_refunded ) ) {
+ return; // No items were refunded, so no need to update fulfillments.
+ }
+
+ // Get the fulfillments data store and read all fulfillments for the order.
+ $fulfillments_data_store = wc_get_container()->get( FulfillmentsDataStore::class );
+ $fulfillments = $fulfillments_data_store->read_fulfillments( \WC_Order::class, (string) $order_id );
+ if ( empty( $fulfillments ) ) {
+ return; // No fulfillments found for the order.
+ }
+
+ // Get all refunded items from the order.
+ $pending_items_without_refunds = FulfillmentUtils::get_pending_items( $order, $fulfillments, false );
+ $pending_items_without_refunds = array_map(
+ function ( $item ) {
+ return array(
+ 'item_id' => $item['item_id'],
+ 'qty' => $item['qty'],
+ );
+ },
+ $pending_items_without_refunds
+ );
+
+ // Check if the refunded items can be removed from pending items.
+ foreach ( $items_refunded as $item_id => &$refunded_qty ) {
+ $pending_item_record = array_filter(
+ $pending_items_without_refunds,
+ function ( $item ) use ( $item_id ) {
+ return isset( $item['item_id'] ) && $item['item_id'] === $item_id;
+ }
+ );
+ if ( ! empty( $pending_item_record ) ) {
+ $pending_item_record = reset( $pending_item_record );
+ if ( isset( $pending_item_record['qty'] ) && $pending_item_record['qty'] > 0 ) {
+ // If the pending item quantity is greater than the refunded quantity, reduce it.
+ $refunded_qty -= $pending_item_record['qty'];
+ }
+ }
+ }
+
+ // If all refunded items can be removed from pending items, we can skip the fulfillment update.
+ $items_need_removal_from_fulfillments = array_filter(
+ $items_refunded,
+ function ( $actual_qty ) {
+ return $actual_qty > 0;
+ }
+ );
+
+ if ( empty( $items_need_removal_from_fulfillments ) ) {
+ return;
+ }
+
+ // Now we need to adjust the fulfillments based on the refunded items.
+ // Loop through each fulfillment and adjust the items based on the refunded quantities.
+ // We will remove items from fulfillments if they are fully refunded, or reduce their quantity if partially refunded.
+ // If a fulfillment has no items left after adjustment, we will delete it.
+ // If a fulfillment has items left, we will update the fulfillment with the new items.
+ foreach ( $fulfillments as $fulfillment ) {
+ if ( ! $fulfillment instanceof Fulfillment ) {
+ continue; // Skip if the fulfillment is not an instance of Fulfillment.
+ }
+
+ if ( $fulfillment->get_is_fulfilled() ) {
+ continue; // Skip if the fulfillment is already fulfilled. We don't remove items from fulfilled fulfillments.
+ }
+
+ // Get the items from the fulfillment.
+ $items = $fulfillment->get_items();
+ if ( empty( $items ) ) {
+ continue; // Skip if there are no items in the fulfillment.
+ }
+
+ // Adjust the items based on the refund.
+ $new_items = array();
+ foreach ( $items as $item ) {
+ if ( isset( $item['qty'] ) && isset( $item['item_id'] ) && isset( $items_need_removal_from_fulfillments[ $item['item_id'] ] ) ) {
+ if ( $items_need_removal_from_fulfillments[ $item['item_id'] ] <= $item['qty'] ) {
+ // If the refunded quantity is less than or equal to the item quantity, reduce the item quantity.
+ $item['qty'] -= $items_need_removal_from_fulfillments[ $item['item_id'] ];
+ $items_need_removal_from_fulfillments[ $item['item_id'] ] = 0; // Set refunded quantity to zero after adjustment.
+ } else {
+ // If the refunded quantity is greater than the item quantity, set the item quantity to zero.
+ $item['qty'] = 0;
+ $items_need_removal_from_fulfillments[ $item['item_id'] ] -= $item['qty']; // Reduce the refunded quantity.
+ }
+ $new_items[] = $item; // Add the adjusted item to the new items array.
+ } else {
+ $new_items[] = $item; // If the item is not in the refunded items, keep it as is.
+ }
+ }
+
+ $new_items = array_filter(
+ $new_items,
+ function ( $item ) {
+ return isset( $item['qty'] ) && $item['qty'] > 0; // Only keep items with a positive quantity.
+ }
+ );
+
+ if ( empty( $new_items ) ) {
+ // If no items remain after adjustment, delete the fulfillment.
+ $fulfillment->delete();
+ } else {
+ // Update the fulfillment items with the new items.
+ $fulfillment->set_items( $new_items );
+ $fulfillment->save();
+ }
+ }
+
+ $this->update_fulfillment_status( $order, $fulfillments );
+ }
+
+ /**
+ * Update the fulfillment status for the order.
+ *
+ * @param \WC_Order $order The order object.
+ * @param array $fulfillments The fulfillments data store.
+ *
+ * This method updates the fulfillment status for the order based on the fulfillments data store.
+ */
+ private function update_fulfillment_status( $order, $fulfillments = array() ) {
+ $last_status = FulfillmentUtils::calculate_order_fulfillment_status( $order, $fulfillments );
+ if ( 'no_fulfillments' === $last_status ) {
+ $order->delete_meta_data( '_fulfillment_status' );
+ } else {
+ // Update the fulfillment status meta data.
+ $order->update_meta_data( '_fulfillment_status', $last_status );
+ }
+
+ $order->save();
+ }
+
+ /**
+ * Try to parse the tracking number with additional parameters.
+ *
+ * @param string $tracking_number The tracking number.
+ * @param string $shipping_from The country code from which the shipment is sent.
+ * @param string $shipping_to The country code to which the shipment is sent.
+ *
+ * @return array An array containing the provider as key, and the parsing results.
+ */
+ public function try_parse_tracking_number( string $tracking_number, string $shipping_from, string $shipping_to ): array {
+ // Validate the tracking number format and length.
+ if ( ! is_string( $tracking_number ) || empty( $tracking_number ) || strlen( $tracking_number ) > 50 ) {
+ $tracking_number = is_string( $tracking_number ) && ! empty( $tracking_number ) ? substr( $tracking_number, 0, 50 ) : '';
+ return array(
+ 'tracking_number' => $tracking_number,
+ 'shipping_provider' => '',
+ 'tracking_url' => '',
+ );
+ }
+
+ // Normalize the tracking number to uppercase.
+ $tracking_number = strtoupper( $tracking_number );
+ $tracking_number = preg_replace( '/[^A-Z0-9]/', '', $tracking_number ); // Remove non-alphanumeric characters.
+
+ $shipping_providers = FulfillmentUtils::get_shipping_providers();
+ $results = array();
+ foreach ( $shipping_providers as $provider ) {
+ if ( class_exists( $provider ) && is_subclass_of( $provider, AbstractShippingProvider::class ) ) {
+ try {
+ /**
+ * Instantiate the shipping provider class.
+ *
+ * @var AbstractShippingProvider $provider_instance
+ */
+ $provider_instance = wc_get_container()->get( $provider );
+ } catch ( \Throwable $e ) {
+ $logger = wc_get_logger();
+ $logger->error(
+ sprintf(
+ 'Error instantiating shipping provider class %s: %s',
+ $provider,
+ $e->getMessage()
+ ),
+ array( 'source' => 'woocommerce-fulfillments' )
+ );
+ continue; // Skip if the provider class cannot be instantiated.
+ }
+ } else {
+ continue; // Skip if the provider class does not exist or is not a valid shipping provider.
+ }
+
+ $parsing_result = $provider_instance->try_parse_tracking_number( $tracking_number, $shipping_from, $shipping_to );
+ if ( ! is_null( $parsing_result ) ) {
+ $results[ $provider_instance->get_key() ] = $parsing_result;
+ }
+ }
+
+ if ( 1 === count( $results ) ) {
+ $result = reset( $results );
+ $key = key( $results );
+ $results = array(
+ 'tracking_number' => $tracking_number,
+ 'shipping_provider' => $key,
+ 'tracking_url' => $result['url'] ?? '',
+ );
+ } elseif ( 1 < count( $results ) ) {
+ // If multiple providers could parse the tracking number, find the one with the highest ambiguity score.
+ $possibilities = $results;
+ $results = $this->get_best_parsing_result( $results, $tracking_number );
+ $results['possibilities'] = $possibilities; // Include all possibilities for reference.
+ }
+
+ return $results;
+ }
+
+ /**
+ * Get the best parsing result from multiple results.
+ *
+ * This method finds the provider with the highest ambiguity score from the results.
+ *
+ * @param array $results The results from multiple providers.
+ * @param string $tracking_number The tracking number being parsed.
+ *
+ * @return array The best parsing result.
+ */
+ private function get_best_parsing_result( array $results, string $tracking_number ): array {
+ $best_result = null;
+ $best_provider = '';
+ $best_score = 0;
+ foreach ( $results as $provider_key => $result ) {
+ if ( ! isset( $result['ambiguity_score'] ) || ! is_numeric( $result['ambiguity_score'] ) ) {
+ continue; // Skip if ambiguity score is not set or not numeric.
+ }
+
+ if ( is_null( $best_result ) || $result['ambiguity_score'] > $best_score ) {
+ $best_result = $result;
+ $best_provider = $provider_key;
+ $best_score = $result['ambiguity_score'];
+ }
+ }
+ return is_null( $best_result ) ? array() : array(
+ 'tracking_number' => $tracking_number,
+ 'shipping_provider' => $best_provider,
+ 'tracking_url' => $best_result['url'],
+ );
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/FulfillmentsRenderer.php b/plugins/woocommerce/src/Internal/Fulfillments/FulfillmentsRenderer.php
new file mode 100644
index 0000000000..562fb67705
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/FulfillmentsRenderer.php
@@ -0,0 +1,579 @@
+<?php
+/**
+ * WooCommerce order fulfillments renderer script.
+ */
+
+declare( strict_types=1 );
+
+namespace Automattic\WooCommerce\Internal\Fulfillments;
+
+use Automattic\WooCommerce\Internal\Admin\WCAdminAssets;
+use Automattic\WooCommerce\Internal\DataStores\Fulfillments\FulfillmentsDataStore;
+use Automattic\WooCommerce\Utilities\OrderUtil;
+use WC_Order;
+
+/**
+ * FulfillmentsRenderer class.
+ */
+class FulfillmentsRenderer {
+
+ /**
+ * Fulfillments cache, that holds the fulfillments for each order to eliminate
+ * fetching fulfillment records of an order on each column render.
+ *
+ * @var array
+ */
+ private array $fulfillments_cache = array();
+
+ /**
+ * CLass constructor.
+ */
+ public function __construct() {
+ if ( OrderUtil::custom_orders_table_usage_is_enabled() ) {
+ // Hook into column definitions and add the new fulfillment columns.
+ add_filter( 'manage_woocommerce_page_wc-orders_columns', array( $this, 'add_fulfillment_columns' ) );
+ // Hook into the column rendering and render the new fulfillment columns.
+ add_action( 'manage_woocommerce_page_wc-orders_custom_column', array( $this, 'render_fulfillment_column_row_data' ), 10, 2 );
+ } else {
+ // For legacy orders table, hook into column definitions and add the new fulfillment columns.
+ add_filter( 'manage_edit-shop_order_columns', array( $this, 'add_fulfillment_columns' ) );
+ // Hook into the column rendering and render the new fulfillment columns.
+ add_action( 'manage_shop_order_posts_custom_column', array( $this, 'render_fulfillment_column_row_data_legacy' ), 25, 1 );
+ }
+ // Hook into the admin footer to add the fulfillment drawer slot, which the React component will mount on.
+ add_action( 'admin_footer', array( $this, 'render_fulfillment_drawer_slot' ) );
+ // Hook into the admin enqueue scripts to load the fulfillment drawer component.
+ add_action( 'admin_enqueue_scripts', array( $this, 'load_components' ) );
+ // Hook into the order details page to render the fulfillment badges.
+ add_action( 'woocommerce_admin_order_data_header_right', array( $this, 'render_order_details_badges' ) );
+ // Hook into the order details before order table to render the fulfillment customer details.
+ add_action( 'woocommerce_order_details_before_order_table', array( $this, 'render_fulfillment_customer_details' ) );
+ // Initialize the renderer for bulk actions.
+ add_action( 'admin_init', array( $this, 'init_admin_hooks' ) );
+ // Hook into the order status text to append the fulfillment status.
+ add_filter( 'woocommerce_order_details_status', array( $this, 'render_fulfillment_status_text' ), 10, 2 );
+ add_filter( 'woocommerce_order_tracking_status', array( $this, 'render_fulfillment_status_text' ), 10, 2 );
+ }
+
+ /**
+ * Initialize the hooks that should run after `admin_init` hook.
+ */
+ public function init_admin_hooks() {
+ if ( OrderUtil::custom_orders_table_usage_is_enabled() ) {
+ // For custom orders table, we need to add the bulk actions to the custom orders table.
+ add_filter( 'bulk_actions-woocommerce_page_wc-orders', array( $this, 'define_fulfillment_bulk_actions' ) );
+ add_filter( 'handle_bulk_actions-woocommerce_page_wc-orders', array( $this, 'handle_fulfillment_bulk_actions' ), 10, 3 );
+ // For custom orders table, we need to filter the query to include fulfillment status.
+ add_action( 'woocommerce_order_list_table_restrict_manage_orders', array( $this, 'render_fulfillment_filters' ) );
+ add_filter( 'woocommerce_order_query_args', array( $this, 'filter_orders_list_table_query' ), 10, 1 );
+ } else {
+ // For legacy orders table, we need to add the bulk actions to the legacy orders table.
+ add_filter( 'bulk_actions-edit-shop_order', array( $this, 'define_fulfillment_bulk_actions' ) );
+ add_filter( 'handle_bulk_actions-edit-shop_order', array( $this, 'handle_fulfillment_bulk_actions' ), 10, 3 );
+ // For legacy orders table, we need to filter the query to include fulfillment status.
+ add_action( 'restrict_manage_posts', array( $this, 'render_fulfillment_filters_legacy' ) );
+ add_action( 'pre_get_posts', array( $this, 'filter_legacy_orders_list_query' ) );
+ }
+ }
+
+ /**
+ * Add the fulfillment related columns to the orders table, after the order_status column.
+ *
+ * @param array $columns The columns in the orders page.
+ * @return array The modified columns.
+ */
+ public function add_fulfillment_columns( $columns ) {
+ $new_columns = array();
+ foreach ( $columns as $column_name => $column_info ) {
+ $new_columns[ $column_name ] = $column_info;
+ if ( 'order_status' === $column_name ) {
+ $new_columns[ $column_name ] = 'Order Status';
+ $new_columns['fulfillment_status'] = __( 'Fulfillment Status', 'woocommerce' );
+ $new_columns['shipment_tracking'] = __( 'Shipment Tracking', 'woocommerce' );
+ $new_columns['shipment_provider'] = __( 'Shipment Provider', 'woocommerce' );
+ }
+ }
+ return $new_columns;
+ }
+
+ /**
+ * Render the fulfillment column row data for legacy order list support.
+ *
+ * @param string $column_name The name of the column.
+ */
+ public function render_fulfillment_column_row_data_legacy( string $column_name ) {
+ global $the_order;
+ // This method is kept for legacy support, but the main rendering logic is now in render_fulfillment_column_row_data.
+ return $this->render_fulfillment_column_row_data( $column_name, $the_order );
+ }
+
+ /**
+ * Render the fulfillment status column.
+ *
+ * @param string $column_name The name of the column.
+ * @param WC_Order $order The order object.
+ */
+ public function render_fulfillment_column_row_data( string $column_name, WC_Order $order ) {
+ $fulfillments = $this->maybe_read_fulfillments( $order );
+
+ // Render the column data based on the column name.
+ switch ( $column_name ) {
+ case 'fulfillment_status':
+ $this->render_order_fulfillment_status_column_row_data( $order );
+ break;
+ case 'shipment_tracking':
+ $this->render_shipment_tracking_column_row_data( $order, $fulfillments );
+ break;
+ case 'shipment_provider':
+ $this->render_shipment_provider_column_row_data( $order, $fulfillments );
+ break;
+ }
+ }
+
+ /**
+ * Render the fulfillment status column row data.
+ *
+ * @param WC_Order $order The order object.
+ */
+ private function render_order_fulfillment_status_column_row_data( WC_Order $order ) {
+ $order_fulfillment_status = $order->meta_exists( '_fulfillment_status' ) ? $order->get_meta( '_fulfillment_status', true ) : 'no_fulfillments';
+
+ echo "<div class='fulfillment-status-wrapper'>";
+ $this->render_order_fulfillment_status_badge( $order, $order_fulfillment_status );
+ echo '</div>';
+ }
+
+ /**
+ * Render the fulfillment status badge.
+ *
+ * @param WC_Order $order The order object.
+ * @param string $order_fulfillment_status The fulfillment status of the order.
+ */
+ private function render_order_fulfillment_status_badge( $order, string $order_fulfillment_status ) {
+ $status_props = FulfillmentUtils::get_order_fulfillment_statuses()[ $order_fulfillment_status ];
+ if ( ! $status_props ) {
+ $status_props = array(
+ 'label' => __( 'Unknown', 'woocommerce' ),
+ 'background_color' => '#f0f0f0',
+ 'text_color' => '#000',
+ );
+ }
+
+ echo '<mark class="fulfillment-status" style="background-color:' . esc_attr( $status_props['background_color'] ) . '; color: ' . esc_attr( $status_props['text_color'] ) . '"><span>' . esc_html( $status_props['label'] ) . '</span></mark>';
+ echo "<a href='#' class='fulfillments-trigger' data-order-id='" . esc_attr( $order->get_id() ) . "' title='" . esc_attr__( 'View Fulfillments', 'woocommerce' ) . "'>
+ <svg width='16' height='16' viewBox='0 0 12 14' xmlns='http://www.w3.org/2000/svg'>
+ <path d='M11.8333 2.83301L9.33329 0.333008L2.24996 7.41634L1.41663 10.7497L4.74996 9.91634L11.8333 2.83301ZM5.99996 12.4163H0.166626V13.6663H5.99996V12.4163Z' />
+ </svg>
+ </a>";
+ }
+
+ /**
+ * Render the shipment provider column row data.
+ *
+ * @param WC_Order $order The order object.
+ * @param array $fulfillments The fulfillments.
+ */
+ private function render_shipment_provider_column_row_data( WC_Order $order, array $fulfillments ) {
+ $providers = array();
+ foreach ( $fulfillments as $fulfillment ) {
+ $providers[] = $fulfillment->get_meta( '_shipment_provider' ) ?? null;
+ }
+
+ $providers = array_filter(
+ $providers,
+ function ( $provider ) {
+ return ! empty( $provider );
+ }
+ );
+
+ if ( count( $providers ) > 1 ) {
+ echo '<span>' . esc_html__( 'Multiple providers', 'woocommerce' ) . '</span>';
+ } elseif ( 1 === count( $providers ) ) {
+ echo '<span>' . esc_html( array_shift( $providers ) ) . '</span>';
+ } else {
+ echo '<span>--</span>';
+ }
+ }
+
+ /**
+ * Render the shipment tracking column row data.
+ *
+ * @param WC_Order $order The order object.
+ * @param array $fulfillments The fulfillments.
+ */
+ private function render_shipment_tracking_column_row_data( WC_Order $order, array $fulfillments ) {
+ $tracking = array();
+ foreach ( $fulfillments as $fulfillment ) {
+ $tracking[] = $fulfillment->get_meta( '_tracking_number' ) ?? null;
+ }
+
+ $tracking = array_filter(
+ $tracking,
+ function ( $provider ) {
+ return ! empty( $provider );
+ }
+ );
+
+ if ( count( $tracking ) > 1 ) {
+ echo '<span>' . esc_html__( 'Multiple trackings', 'woocommerce' ) . '</span>';
+ } elseif ( 1 === count( $tracking ) ) {
+ echo '<span>' . esc_html( array_shift( $tracking ) ) . '</span>';
+ } else {
+ echo '<span>--</span>';
+ }
+ }
+
+ /**
+ * Render the fulfillment drawer.
+ */
+ public function render_fulfillment_drawer_slot() {
+ if ( ! $this->should_render_fulfillment_drawer() ) {
+ return;
+ }
+ ?>
+ <div id="wc_order_fulfillments_panel_container"></div>
+ <?php
+ }
+
+ /**
+ * Define bulk actions for fulfillments.
+ *
+ * @param array $actions Existing actions.
+ * @return array
+ */
+ public function define_fulfillment_bulk_actions( $actions ) {
+ $actions['fulfill'] = __( 'Mark as fulfilled', 'woocommerce' );
+
+ return $actions;
+ }
+
+ /**
+ * Handle bulk actions for fulfillments.
+ *
+ * @param string $redirect_to The redirect URL.
+ * @param string $action The action being performed.
+ * @param array $post_ids The post IDs being acted upon.
+ * @return string
+ */
+ public function handle_fulfillment_bulk_actions( $redirect_to, $action, $post_ids ) {
+ if ( 'fulfill' === $action ) {
+ foreach ( $post_ids as $post_id ) {
+ $order = wc_get_order( $post_id );
+ if ( ! $order ) {
+ continue;
+ }
+
+ $fulfillments = $this->maybe_read_fulfillments( $order );
+
+ // Fulfill all existing fulfillments.
+ foreach ( $fulfillments as $fulfillment ) {
+ $fulfillment->set_status( 'fulfilled' );
+ $fulfillment->save();
+ }
+
+ // Create a fulfillment for the order, containing all remaining items in the order.
+ $remaining_items = array_map(
+ function ( $item ) {
+ return array(
+ 'item_id' => $item['item_id'],
+ 'qty' => $item['qty'],
+ );
+ },
+ FulfillmentUtils::get_pending_items( $order, $fulfillments )
+ );
+
+ if ( 0 < count( $remaining_items ) ) {
+ $fulfillment = new Fulfillment();
+ $fulfillment->set_entity_type( WC_Order::class );
+ $fulfillment->set_entity_id( (string) $order->get_id() );
+ $fulfillment->set_status( 'fulfilled' );
+ $fulfillment->set_items( $remaining_items );
+ $fulfillment->save();
+ }
+ }
+ $redirect_to = add_query_arg( array( 'bulk_action' => $action ), $redirect_to );
+ }
+ return $redirect_to;
+ }
+
+ /**
+ * Render the fulfillment status text in the order details page and the order tracking page.
+ *
+ * @param string $order_status The order status text.
+ * @param WC_Order $order The order object.
+ *
+ * @return string The fulfillment status appended order status text.
+ */
+ public function render_fulfillment_status_text( string $order_status, WC_Order $order ): string {
+ $fulfillments = $this->maybe_read_fulfillments( $order );
+ $fulfillment_status = FulfillmentUtils::get_order_fulfillment_status_text( $order, $fulfillments );
+ return sprintf( '%s %s', $order_status, $fulfillment_status );
+ }
+
+ /**
+ * Render the fulfillment customer details in the order details page.
+ *
+ * @param WC_Order $order The order object.
+ */
+ public function render_fulfillment_customer_details( WC_Order $order ) {
+ $fulfillments = $this->maybe_read_fulfillments( $order );
+
+ if ( ! empty( $fulfillments ) ) {
+ ?>
+<section class="woocommerce-order-details">
+ <table class="woocommerce-table woocommerce-table--order-details shop_table order_details">
+ <thead>
+ <?php
+ foreach ( $fulfillments as $index => $fulfillment ) {
+ if ( ! $fulfillment->get_is_fulfilled() ) {
+ continue;
+ }
+ ?>
+ <tr>
+ <th class="woocommerce-table__shipment-info shipment-info" style="font-weight: normal;">
+ <?php
+ printf(
+ /* translators: %1$s is the shipment index, %2$s is the shipment date */
+ wp_kses( __( '<b>Shipment %1$s</b> was shipped on <b>%2$s</b>', 'woocommerce' ), 'b' ),
+ intval( $index ) + 1,
+ esc_html(
+ gmdate(
+ 'F j, Y',
+ strtotime(
+ $fulfillment->get_date_fulfilled() // Get the fulfilled date.
+ ?? $fulfillment->get_date_updated() // Fallback to the updated date if fulfilled date is not set.
+ )
+ )
+ )
+ );
+ ?>
+ </th>
+ <th class="woocommerce-table__shipment-tracking shipment-tracking" style="font-weight: normal;">
+ <?php echo wp_kses( FulfillmentUtils::get_tracking_info_html( $fulfillment ), 'a' ); ?>
+ </th>
+ </tr>
+ <?php
+ }
+ ?>
+ </thead>
+ </table>
+</section>
+ <?php
+ }
+ }
+
+ /**
+ * Render the fulfillment badges in the order details page.
+ *
+ * @param WC_Order $order The order object.
+ */
+ public function render_order_details_badges( WC_Order $order ) {
+ echo '<div class="wc-order-fulfillment-badges">';
+
+ // Get the fulfillment status for the order.
+ $fulfillments = $this->maybe_read_fulfillments( $order );
+ $order_fulfillment_status = FulfillmentUtils::calculate_order_fulfillment_status( $order, $fulfillments );
+
+ // Render order status badge.
+ $order_status = $order->get_status();
+ echo '<mark class="order-status status-' . esc_attr( $order_status ) . '"><span>' . esc_html( wc_get_order_status_name( $order_status ) ) . '</span></mark>';
+
+ // Render fulfillment status badge.
+ $this->render_order_fulfillment_status_badge( $order, $order_fulfillment_status );
+ echo '</div>';
+ }
+
+ /**
+ * Loads the fulfillments scripts and styles.
+ */
+ public function load_components() {
+ if ( ! $this->should_render_fulfillment_drawer() ) {
+ return;
+ }
+
+ $this->register_fulfillments_assets();
+ $this->load_fulfillments_js_settings();
+ }
+
+ /**
+ * Register the fulfillment assets.
+ */
+ protected function register_fulfillments_assets() {
+ WCAdminAssets::register_style( 'fulfillments', 'style', array( 'wp-components' ) );
+ WCAdminAssets::register_script( 'wp-admin-scripts', 'fulfillments', true );
+ }
+
+ /**
+ * Load the fulfillments JS settings.
+ *
+ * @return void
+ */
+ protected function load_fulfillments_js_settings() {
+ $fulfillment_settings = array(
+ 'providers' => FulfillmentUtils::get_shipping_providers_object(),
+ 'currency_symbols' => get_woocommerce_currency_symbols(),
+ 'fulfillment_statuses' => FulfillmentUtils::get_fulfillment_statuses(),
+ 'order_fulfillment_statuses' => FulfillmentUtils::get_order_fulfillment_statuses(),
+ );
+
+ wp_localize_script( 'wc-admin-fulfillments', 'wcFulfillmentSettings', $fulfillment_settings );
+ }
+
+ /**
+ * Render the fulfillment filters in the orders table.
+ */
+ public function render_fulfillment_filters() {
+ if ( ! self::should_render_fulfillment_drawer() ) {
+ return;
+ }
+ ?>
+ <?php
+ // This is a read-only filter on the admin orders table, so nonce verification is not required.
+ // phpcs:ignore WordPress.Security.NonceVerification ?>
+ <?php $selected_status = isset( $_GET['fulfillment_status'] ) ? sanitize_text_field( wp_unslash( $_GET['fulfillment_status'] ) ) : ''; ?>
+ <select id="fulfillment-status-filter" name="fulfillment_status">
+ <option value="" <?php selected( $selected_status, '' ); ?>><?php esc_html_e( 'Filter by fulfillment', 'woocommerce' ); ?></option>
+ <?php foreach ( FulfillmentUtils::get_order_fulfillment_statuses() as $status => $props ) : ?>
+ <option value="<?php echo esc_attr( $status ); ?>" <?php selected( $selected_status, $status ); ?>>
+ <?php echo esc_html( $props['label'] ?? '' ); ?>
+ </option>
+ <?php endforeach; ?>
+ </select>
+ <?php
+ }
+
+ /**
+ * Render the fulfillment filters in the legacy orders table.
+ */
+ public function render_fulfillment_filters_legacy() {
+ global $typenow;
+
+ if ( 'shop_order' !== $typenow ) {
+ return;
+ }
+
+ $this->render_fulfillment_filters();
+ }
+
+ /**
+ * Apply the fulfillment status filter to the orders list.
+ *
+ * @param array $args The query arguments for the orders list.
+ * @return array The modified query arguments.
+ */
+ public function filter_orders_list_table_query( $args ) {
+ // This is a read-only filter on the admin orders table, so nonce verification is not required.
+ // phpcs:ignore WordPress.Security.NonceVerification
+ if ( isset( $_GET['fulfillment_status'] ) && ! empty( $_GET['fulfillment_status'] ) ) {
+ // phpcs:ignore WordPress.Security.NonceVerification
+ $fulfillment_status = sanitize_text_field( wp_unslash( $_GET['fulfillment_status'] ) );
+
+ // Ensure the fulfillment status is one of the allowed values.
+ if ( FulfillmentUtils::is_valid_order_fulfillment_status( $fulfillment_status ) ) {
+ if ( ! isset( $args['meta_query'] ) ) {
+ $args['meta_query'] = array(); // phpcs:ignore WordPress.DB.SlowDBQuery.slow_db_query_meta_query
+ }
+ if ( 'no_fulfillments' === $fulfillment_status ) {
+ // If the status is 'no_fulfillments', we need to check for orders that have no fulfillments.
+ $args['meta_query'][] = array(
+ 'relation' => 'OR',
+ array(
+ 'key' => '_fulfillment_status',
+ 'compare' => 'NOT EXISTS',
+ ),
+ );
+ } else {
+ $args['meta_query'][] = array(
+ 'key' => '_fulfillment_status',
+ 'value' => $fulfillment_status,
+ 'compare' => '=',
+ );
+ }
+ }
+ }
+
+ return $args;
+ }
+
+ /**
+ * Filter the legacy orders list query to include fulfillment status.
+ *
+ * @param \WP_Query $query The WP_Query object.
+ */
+ public function filter_legacy_orders_list_query( $query ) {
+ if (
+ is_admin()
+ && $query->is_main_query()
+ && $query->get( 'post_type' ) === 'shop_order'
+ && isset( $_GET['fulfillment_status'] ) && ! empty( $_GET['fulfillment_status'] ) // phpcs:ignore WordPress.Security.NonceVerification
+ ) {
+ $status = sanitize_text_field( wp_unslash( $_GET['fulfillment_status'] ) ); // phpcs:ignore WordPress.Security.NonceVerification
+ // Ensure the fulfillment status is one of the allowed values.
+ if ( FulfillmentUtils::is_valid_order_fulfillment_status( $status ) ) {
+ $query->set(
+ 'meta_query',
+ 'no_fulfillments' === $status ?
+ array(
+ 'relation' => 'OR',
+ array(
+ 'key' => '_fulfillment_status',
+ 'compare' => 'NOT EXISTS',
+ ),
+ ) :
+ array(
+ array(
+ 'key' => '_fulfillment_status',
+ 'value' => $status,
+ 'compare' => '=',
+ ),
+ )
+ );
+ }
+ }
+ }
+
+ /**
+ * Check if the fulfillment drawer should be rendered (admin only).
+ *
+ * @return bool True if the fulfillment drawer should be rendered, false otherwise.
+ */
+ protected function should_render_fulfillment_drawer(): bool {
+ if ( ! is_admin() ) {
+ return false;
+ }
+
+ if ( ! function_exists( 'get_current_screen' ) ) {
+ return false;
+ }
+
+ $current_screen = get_current_screen();
+ if ( ! $current_screen || ! $current_screen->id ) {
+ return false;
+ }
+
+ return 'woocommerce_page_wc-orders' === $current_screen->id // HPOS screen.
+ || 'edit-shop_order' === $current_screen->id // Legacy screen.
+ || 'shop_order' === $current_screen->id; // Order details screen (legacy).
+ }
+
+ /**
+ * Fetches the fulfillments for the given order, caching them to avoid multiple fetches.
+ *
+ * @param WC_Order $order The order object.
+ *
+ * @return array The fulfillments for the order.
+ */
+ private function maybe_read_fulfillments( WC_Order $order ): array {
+ // Check if we've already fetched the fulfillments for this order.
+ if ( isset( $this->fulfillments_cache[ $order->get_id() ] ) ) {
+ return $this->fulfillments_cache[ $order->get_id() ];
+ }
+
+ // If not, fetch them and cache them.
+ $data_store = wc_get_container()->get( FulfillmentsDataStore::class );
+ $fulfillments = $data_store->read_fulfillments( WC_Order::class, '' . $order->get_id() );
+ $this->fulfillments_cache[ $order->get_id() ] = $fulfillments;
+
+ return $fulfillments;
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/FulfillmentsSettings.php b/plugins/woocommerce/src/Internal/Fulfillments/FulfillmentsSettings.php
new file mode 100644
index 0000000000..c75045318a
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/FulfillmentsSettings.php
@@ -0,0 +1,191 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments;
+
+use Automattic\WooCommerce\Internal\DataStores\Fulfillments\FulfillmentsDataStore;
+use WC_Order;
+
+/**
+ * FulfillmentsSettings class.
+ */
+class FulfillmentsSettings {
+
+ /**
+ * Constructor.
+ */
+ public function __construct() {
+ add_filter( 'admin_init', array( $this, 'init_settings_auto_fulfill' ) );
+ add_action( 'woocommerce_order_status_processing', array( $this, 'auto_fulfill_items_on_processing' ), 10, 2 );
+ add_action( 'woocommerce_order_status_completed', array( $this, 'auto_fulfill_items_on_completed' ), 10, 2 );
+ }
+
+ /**
+ * Initialize settings for auto-fulfill options.
+ */
+ public function init_settings_auto_fulfill() {
+ add_filter( 'woocommerce_get_settings_products', array( $this, 'add_auto_fulfill_settings' ), 10, 2 );
+ }
+
+ /**
+ * Add auto-fulfill settings to the WooCommerce settings.
+ *
+ * @param array $settings The existing settings.
+ * @param string|null $current_section The current section being viewed.
+ *
+ * @return array Modified settings with auto-fulfill options added.
+ */
+ public function add_auto_fulfill_settings( array $settings, $current_section ): array {
+ if ( ! empty( $current_section ) ) {
+ return $settings;
+ }
+
+ $insertion_index = null;
+
+ // Find the index of the sectionend for 'Shop pages'.
+ foreach ( $settings as $index => $setting ) {
+ if (
+ isset( $setting['type'], $setting['id'] ) &&
+ 'sectionend' === $setting['type'] &&
+ 'catalog_options' === $setting['id'] // Woo core's ID for Shop pages section.
+ ) {
+ $insertion_index = $index + 1; // Insert after the sectionend.
+ break;
+ }
+ }
+
+ if ( is_null( $insertion_index ) ) {
+ return $settings; // fallback if not found.
+ }
+
+ $auto_fulfill_settings = array(
+ array(
+ 'title' => 'Auto-fulfill items',
+ 'desc' => '',
+ 'type' => 'title',
+ 'id' => 'auto_fulfill_options',
+ ),
+ array(
+ 'title' => 'Virtual and downloadable items',
+ 'desc' => 'Automatically mark downloadable items as fulfilled when the order is created.',
+ 'id' => 'auto_fulfill_downloadable',
+ 'type' => 'checkbox',
+ 'checkboxgroup' => 'start',
+ 'default' => 'yes',
+ ),
+ array(
+ 'title' => 'Auto-fulfill items',
+ 'desc' => 'Automatically mark virtual (non-downloadable) items as fulfilled when the order is created.',
+ 'id' => 'auto_fulfill_virtual',
+ 'type' => 'checkbox',
+ 'checkboxgroup' => 'end',
+ 'default' => 'no',
+ ),
+ array(
+ 'type' => 'sectionend',
+ 'id' => 'auto_fulfill_options',
+ ),
+ );
+
+ array_splice( $settings, $insertion_index, 0, $auto_fulfill_settings );
+
+ return $settings;
+ }
+
+ /**
+ * Automatically fulfill items in the order on the processing state.
+ *
+ * @param int $order_id The ID of the order being created.
+ * @param WC_Order $order The order object.
+ */
+ public function auto_fulfill_items_on_processing( int $order_id, $order ): void {
+ $order = $order instanceof WC_Order ? $order : wc_get_order( $order_id );
+
+ if ( ! $order || empty( $order->get_items() ) ) {
+ return;
+ }
+ $auto_fulfill_downloadable = 'yes' === get_option( 'auto_fulfill_downloadable', 'yes' );
+ $auto_fulfill_virtual = 'yes' === get_option( 'auto_fulfill_virtual', 'no' );
+
+ /**
+ * Filter to get the list of the item, or variant ID's that should be auto-fulfilled.
+ *
+ * @since 10.1.0
+ *
+ * @param array $auto_fulfill_items List of product or variant ID's to auto-fulfill.
+ * @param \WC_Order $order The order object.
+ *
+ * @return array Filtered list of product or variant ID's to auto-fulfill
+ */
+ $auto_fulfill_product_ids = apply_filters( 'woocommerce_fulfillments_auto_fulfill_products', array(), $order );
+ $auto_fulfill_items = array();
+
+ foreach ( $order->get_items() as $item ) {
+ /**
+ * Get the product associated with the item.
+ *
+ * @var \WC_Order_Item_Product $item
+ * @var \WC_Product $product
+ */
+ $product = $item->get_product();
+ if ( ! $product ) {
+ continue;
+ }
+
+ if ( ( $product->is_downloadable() && $auto_fulfill_downloadable )
+ || ( $product->is_virtual() && $auto_fulfill_virtual )
+ || in_array( $product->get_id(), $auto_fulfill_product_ids, true ) ) {
+ $auto_fulfill_items[] = $item;
+ }
+ }
+
+ if ( ! empty( $auto_fulfill_items ) ) {
+ $fulfillment = new Fulfillment();
+ $fulfillment->set_entity_type( WC_Order::class );
+ $fulfillment->set_entity_id( (string) $order_id );
+ $fulfillment->set_status( 'fulfilled' );
+ $fulfillment->set_items(
+ array_map(
+ function ( $item ) {
+ return array(
+ 'item_id' => $item->get_id(),
+ 'qty' => $item->get_quantity(),
+ );
+ },
+ $auto_fulfill_items
+ )
+ );
+ $fulfillment->save();
+ }
+
+ $order->update_meta_data( '_auto_fulfill_processed', true );
+ }
+
+ /**
+ * Automatically fulfill items in the order for orders that skip the processing state.
+ *
+ * @param int $order_id The ID of the order being created.
+ * @param WC_Order $order The order object.
+ */
+ public function auto_fulfill_items_on_completed( int $order_id, $order ): void {
+ $order = $order instanceof WC_Order ? $order : wc_get_order( $order_id );
+ if ( ! $order || empty( $order->get_items() ) ) {
+ return;
+ }
+
+ // If auto-fulfill already processed, skip.
+ if ( $order->get_meta( '_auto_fulfill_processed', true ) ) {
+ return;
+ }
+
+ // If fulfillments already exist, skip auto-fulfillment.
+ $fulfillments = wc_get_container()->get( FulfillmentsDataStore::class )->read_fulfillments( \WC_Order::class, (string) $order_id );
+ if ( ! empty( $fulfillments ) ) {
+ return;
+ }
+
+ // Auto-fulfill items.
+ $this->auto_fulfill_items_on_processing( $order_id, $order );
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/OrderFulfillmentsRestController.php b/plugins/woocommerce/src/Internal/Fulfillments/OrderFulfillmentsRestController.php
new file mode 100644
index 0000000000..da8a6b139a
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/OrderFulfillmentsRestController.php
@@ -0,0 +1,1192 @@
+<?php
+/**
+ * FulfillmentsAPISchema class file.
+ */
+
+declare( strict_types=1 );
+
+namespace Automattic\WooCommerce\Internal\Fulfillments;
+
+use Automattic\WooCommerce\Internal\Admin\Settings\Exceptions\ApiException;
+use Automattic\WooCommerce\Internal\RestApiControllerBase;
+use Automattic\WooCommerce\Internal\DataStores\Fulfillments\FulfillmentsDataStore;
+use WC_Order;
+use WP_Http;
+use WP_REST_Request;
+use WP_REST_Response;
+use WP_REST_Server;
+
+/**
+ * OrderFulfillmentsRestController class file.
+ *
+ * !> Note: This REST controller is only created for `WC_Order` type of entities, that allow
+ * !> managing fulfillments only for admins. Regular users can only view their fulfillments.
+ * !>
+ * !> If you are using another entity type for your fulfillments, you should create a new controller.
+ *
+ * @package Automattic\WooCommerce\Internal\Fulfillments
+ */
+class OrderFulfillmentsRestController extends RestApiControllerBase {
+ /**
+ * Endpoint namespace.
+ *
+ * @var string
+ */
+ protected $namespace = 'wc/v3';
+
+ /**
+ * REST API base.
+ *
+ * @var string
+ */
+ protected $rest_base = '/orders/(?P<order_id>[\d]+)/fulfillments';
+
+ /**
+ * Get the WooCommerce REST API namespace for the class.
+ *
+ * @return string
+ */
+ protected function get_rest_api_namespace(): string {
+ return 'order_fulfillments';
+ }
+
+ /**
+ * Register the routes for fulfillments.
+ */
+ public function register_routes() {
+ // Register the route for getting and setting order fulfillments.
+ register_rest_route(
+ $this->route_namespace,
+ $this->rest_base,
+ array(
+ array(
+ 'methods' => \WP_REST_Server::READABLE,
+ 'callback' => fn( $request ) => $this->run( $request, 'get_fulfillments' ),
+ 'permission_callback' => fn( $request ) => $this->check_permission_for_fulfillments( $request ),
+ 'args' => $this->get_args_for_get_fulfillments(),
+ 'schema' => $this->get_schema_for_get_fulfillments(),
+ ),
+ array(
+ 'methods' => \WP_REST_Server::CREATABLE,
+ 'callback' => fn( $request ) => $this->run( $request, 'create_fulfillment' ),
+ 'permission_callback' => fn( $request ) => $this->check_permission_for_fulfillments( $request ),
+ 'args' => $this->get_args_for_create_fulfillment(),
+ 'schema' => $this->get_schema_for_create_fulfillment(),
+ ),
+ ),
+ );
+
+ // Register the route for getting a specific fulfillment.
+ register_rest_route(
+ $this->route_namespace,
+ $this->rest_base . '/(?P<fulfillment_id>[\d]+)',
+ array(
+ array(
+ 'methods' => \WP_REST_Server::READABLE,
+ 'callback' => fn( $request ) => $this->run( $request, 'get_fulfillment' ),
+ 'permission_callback' => fn( $request ) => $this->check_permission_for_fulfillments( $request ),
+ 'args' => $this->get_args_for_get_fulfillment(),
+ 'schema' => $this->get_schema_for_get_fulfillment(),
+ ),
+ array(
+ 'methods' => \WP_REST_Server::EDITABLE,
+ 'callback' => fn( $request ) => $this->run( $request, 'update_fulfillment' ),
+ 'permission_callback' => fn( $request ) => $this->check_permission_for_fulfillments( $request ),
+ 'args' => $this->get_args_for_update_fulfillment(),
+ 'schema' => $this->get_schema_for_update_fulfillment(),
+ ),
+ array(
+ 'methods' => \WP_REST_Server::DELETABLE,
+ 'callback' => fn( $request ) => $this->run( $request, 'delete_fulfillment' ),
+ 'permission_callback' => fn( $request ) => $this->check_permission_for_fulfillments( $request ),
+ 'args' => $this->get_args_for_delete_fulfillment(),
+ 'schema' => $this->get_schema_for_delete_fulfillment(),
+ ),
+ ),
+ );
+
+ // Register the route for fulfillment metadata.
+ register_rest_route(
+ $this->route_namespace,
+ $this->rest_base . '/(?P<fulfillment_id>[\d]+)/metadata',
+ array(
+ array(
+ 'methods' => \WP_REST_Server::READABLE,
+ 'callback' => fn( $request ) => $this->run( $request, 'get_fulfillment_meta' ),
+ 'permission_callback' => fn( $request ) => $this->check_permission_for_fulfillments( $request ),
+ 'args' => $this->get_args_for_get_fulfillment_meta(),
+ 'schema' => $this->get_schema_for_get_fulfillment_meta(),
+ ),
+ array(
+ 'methods' => \WP_REST_Server::EDITABLE,
+ 'callback' => fn( $request ) => $this->run( $request, 'update_fulfillment_meta' ),
+ 'permission_callback' => fn( $request ) => $this->check_permission_for_fulfillments( $request ),
+ 'args' => $this->get_args_for_update_fulfillment_meta(),
+ 'schema' => $this->get_schema_for_update_fulfillment_meta(),
+ ),
+ array(
+ 'methods' => \WP_REST_Server::DELETABLE,
+ 'callback' => fn( $request ) => $this->run( $request, 'delete_fulfillment_meta' ),
+ 'permission_callback' => fn( $request ) => $this->check_permission_for_fulfillments( $request ),
+ 'args' => $this->get_args_for_delete_fulfillment_meta(),
+ 'schema' => $this->get_schema_for_delete_fulfillment_meta(),
+ ),
+ ),
+ );
+
+ // Register the route for tracking number lookup.
+ register_rest_route(
+ $this->route_namespace,
+ $this->rest_base . '/lookup',
+ array(
+ array(
+ 'methods' => \WP_REST_Server::READABLE,
+ 'callback' => fn( $request ) => $this->run( $request, 'get_tracking_number_details' ),
+ 'permission_callback' => fn( $request ) => $this->check_permission_for_fulfillments( $request ),
+ 'args' => $this->get_args_for_get_tracking_number_details(),
+ 'schema' => $this->get_schema_for_get_tracking_number_details(),
+ ),
+ ),
+ );
+ }
+
+ /**
+ * Permission check for REST API endpoints, given the request method.
+ * For all fulfillments methods that have an order_id, we need to be sure the user has permission to view the order.
+ * For all other methods, we check if the user is logged in as admin and has the required capability.
+ *
+ * @param WP_REST_Request $request The request for which the permission is checked.
+ * @return bool|\WP_Error True if the current user has the capability, otherwise an "Unauthorized" error or False if no error is available for the request method.
+ *
+ * @throws \WP_Error If the URL contains an order, but the order does not exist.
+ */
+ protected function check_permission_for_fulfillments( WP_REST_Request $request ) {
+ // Fetch the order first if there's an order_id in the request.
+ $order = null;
+ if ( $request->has_param( 'order_id' ) ) {
+ $order_id = (int) $request->get_param( 'order_id' );
+ $order = wc_get_order( $order_id );
+
+ if ( ! $order ) {
+ return new \WP_Error(
+ 'woocommerce_rest_order_invalid_id',
+ esc_html__( 'Invalid order ID.', 'woocommerce' ),
+ array( 'status' => esc_attr( WP_Http::NOT_FOUND ) )
+ );
+ }
+ }
+
+ // Check if the user is logged in as admin, and has the required capability.
+ // Admins who can manage WooCommerce can view all fulfillments.
+ if ( current_user_can( 'manage_woocommerce' ) ) { // phpcs:ignore WordPress.WP.Capabilities.Unknown
+ return true;
+ }
+
+ // Check if the order exists, and if the current user is the owner of the order, and the request is a read request.
+ // We allow this because we need to render the order fulfillments on the customer's order details and order tracking pages.
+ // But they will be only able to view them, not edit.
+ if ( get_current_user_id() === $order->get_customer_id() && WP_REST_Server::READABLE === $request->get_method() ) {
+ return true;
+ }
+
+ // Return an error related to the request method.
+ $error_information = $this->get_authentication_error_by_method( $request->get_method() );
+
+ if ( is_null( $error_information ) ) {
+ return false;
+ }
+
+ return new \WP_Error(
+ $error_information['code'],
+ $error_information['message'],
+ array( 'status' => rest_authorization_required_code() )
+ );
+ }
+
+ /**
+ * Get the fulfillments for the order.
+ *
+ * @param WP_REST_Request $request The request object.
+ *
+ * @return WP_REST_Response The fulfillments for the order, or an error if the request fails.
+ */
+ public function get_fulfillments( WP_REST_Request $request ): WP_REST_Response {
+ $order_id = (int) $request->get_param( 'order_id' );
+ $fulfillments = array();
+
+ // Fetch fulfillments for the order.
+ try {
+ $datastore = wc_get_container()->get( FulfillmentsDataStore::class );
+ $fulfillments = $datastore->read_fulfillments( WC_Order::class, "$order_id" );
+ } catch ( \Exception $e ) {
+ return $this->prepare_error_response(
+ $e->getCode(),
+ $e->getMessage(),
+ WP_Http::BAD_REQUEST
+ );
+ }
+
+ // Return the fulfillments.
+ return new WP_REST_Response(
+ array(
+ 'fulfillments' => array_map(
+ function ( $fulfillment ) {
+ return $fulfillment->get_raw_data(); },
+ $fulfillments
+ ),
+ ),
+ WP_Http::OK
+ );
+ }
+
+ /**
+ * Create a new fulfillment with the given data for the order.
+ *
+ * @param WP_REST_Request $request The request object.
+ *
+ * @return WP_REST_Response The created fulfillment, or an error if the request fails.
+ */
+ public function create_fulfillment( WP_REST_Request $request ) {
+ $order_id = (int) $request->get_param( 'order_id' );
+ $notify_customer = (bool) $request->get_param( 'notify_customer' );
+ // Create a new fulfillment.
+ try {
+ $fulfillment = new Fulfillment();
+ $fulfillment->set_props( $request->get_json_params() );
+ $fulfillment->set_meta_data( $request->get_json_params()['meta_data'] );
+ $fulfillment->set_entity_type( WC_Order::class );
+ $fulfillment->set_entity_id( "$order_id" );
+
+ $fulfillment->save();
+
+ if ( $fulfillment->get_is_fulfilled() && $notify_customer ) {
+ /**
+ * Trigger the fulfillment created notification on creating a fulfilled fulfillment.
+ *
+ * @since 10.1.0
+ */
+ do_action( 'woocommerce_fulfillment_created_notification', $order_id, $fulfillment, wc_get_order( $order_id ) );
+ }
+ } catch ( ApiException $ex ) {
+ return $this->prepare_error_response(
+ $ex->getErrorCode(),
+ $ex->getMessage(),
+ WP_Http::BAD_REQUEST
+ );
+
+ } catch ( \Exception $e ) {
+ return $this->prepare_error_response(
+ $e->getCode(),
+ $e->getMessage(),
+ WP_Http::BAD_REQUEST
+ );
+ }
+
+ return new WP_REST_Response( array( 'fulfillment' => $fulfillment->get_raw_data() ), WP_Http::CREATED );
+ }
+
+ /**
+ * Get a specific fulfillment for the order.
+ *
+ * @param WP_REST_Request $request The request object.
+ *
+ * @return WP_REST_Response The fulfillment for the order, or an error if the request fails.
+ *
+ * @throws \Exception If the fulfillment is not found or is deleted.
+ */
+ public function get_fulfillment( WP_REST_Request $request ): WP_REST_Response {
+ $order_id = (int) $request->get_param( 'order_id' );
+ $fulfillment_id = (int) $request->get_param( 'fulfillment_id' );
+
+ // Fetch the fulfillment for the order.
+ try {
+ $fulfillment = new Fulfillment( $fulfillment_id );
+ $this->validate_fulfillment( $fulfillment, $fulfillment_id, $order_id );
+ if ( $fulfillment->get_date_deleted() ) {
+ throw new \Exception(
+ esc_html__( 'Fulfillment not found.', 'woocommerce' ),
+ WP_Http::NOT_FOUND
+ );
+ }
+ } catch ( \Exception $e ) {
+ return $this->prepare_error_response(
+ $e->getCode(),
+ $e->getMessage(),
+ WP_Http::BAD_REQUEST
+ );
+ }
+
+ return new WP_REST_Response(
+ array( 'fulfillment' => $fulfillment->get_raw_data() ),
+ WP_Http::OK
+ );
+ }
+
+ /**
+ * Update a specific fulfillment for the order.
+ *
+ * @param WP_REST_Request $request The request object.
+ *
+ * @return WP_REST_Response The updated fulfillment, or an error if the request fails.
+ */
+ public function update_fulfillment( WP_REST_Request $request ): WP_REST_Response {
+ $order_id = (int) $request->get_param( 'order_id' );
+ $fulfillment_id = (int) $request->get_param( 'fulfillment_id' );
+ $notify_customer = (bool) $request->get_param( 'notify_customer' );
+
+ // Update the fulfillment for the order.
+ try {
+ $fulfillment = new Fulfillment( $fulfillment_id );
+ $previous_state = $fulfillment->get_is_fulfilled();
+ $this->validate_fulfillment( $fulfillment, $fulfillment_id, $order_id );
+
+ $fulfillment->set_props( $request->get_json_params() );
+ $next_state = $fulfillment->get_is_fulfilled();
+
+ if ( isset( $request->get_json_params()['meta_data'] ) && is_array( $request->get_json_params()['meta_data'] ) ) {
+ // Update the meta data keys that exist in the request.
+ foreach ( $request->get_json_params()['meta_data'] as $meta ) {
+ $fulfillment->update_meta_data( $meta['key'], $meta['value'], $meta['id'] ?? 0 );
+ }
+
+ // Remove the meta data keys that don't exist in the request, by matching their keys.
+ $existing_meta_data = $fulfillment->get_meta_data();
+ foreach ( $existing_meta_data as $meta ) {
+ if ( ! in_array( $meta->key, array_column( $request->get_json_params()['meta_data'], 'key' ), true ) ) {
+ $fulfillment->delete_meta_data( $meta->key );
+ }
+ }
+ }
+ $fulfillment->save();
+ $fulfillment->save_meta_data();
+
+ if ( $notify_customer ) {
+ if ( ! $previous_state && $next_state ) {
+ /**
+ * Trigger the fulfillment created notification on fulfilling a fulfillment.
+ *
+ * @since 10.1.0
+ */
+ do_action( 'woocommerce_fulfillment_created_notification', $order_id, $fulfillment, wc_get_order( $order_id ) );
+ } elseif ( $next_state ) {
+ /**
+ * Trigger the fulfillment updated notification on updating a fulfillment.
+ *
+ * @since 10.1.0
+ */
+ do_action( 'woocommerce_fulfillment_updated_notification', $order_id, $fulfillment, wc_get_order( $order_id ) );
+ }
+ }
+ } catch ( ApiException $ex ) {
+ return $this->prepare_error_response(
+ $ex->getErrorCode(),
+ $ex->getMessage(),
+ WP_Http::BAD_REQUEST
+ );
+ } catch ( \Exception $e ) {
+ return $this->prepare_error_response(
+ $e->getCode(),
+ $e->getMessage(),
+ WP_Http::BAD_REQUEST
+ );
+ }
+
+ return new WP_REST_Response(
+ array( 'fulfillment' => $fulfillment->get_raw_data() ),
+ WP_Http::OK
+ );
+ }
+
+ /**
+ * Delete a specific fulfillment for the order.
+ *
+ * @param WP_REST_Request $request The request object.
+ *
+ * @return WP_REST_Response The deleted fulfillment, or an error if the request fails.
+ */
+ public function delete_fulfillment( WP_REST_Request $request ) {
+ $order_id = (int) $request->get_param( 'order_id' );
+ $fulfillment_id = (int) $request->get_param( 'fulfillment_id' );
+ $notify_customer = (bool) $request->get_param( 'notify_customer' );
+
+ // Delete the fulfillment for the order.
+ try {
+ $fulfillment = new Fulfillment( $fulfillment_id );
+ $this->validate_fulfillment( $fulfillment, $fulfillment_id, $order_id );
+ $fulfillment->delete();
+ } catch ( ApiException $ex ) {
+ return $this->prepare_error_response(
+ $ex->getErrorCode(),
+ $ex->getMessage(),
+ WP_Http::BAD_REQUEST
+ );
+ } catch ( \Exception $e ) {
+ return $this->prepare_error_response(
+ $e->getCode(),
+ $e->getMessage(),
+ WP_Http::BAD_REQUEST
+ );
+ }
+
+ if ( $fulfillment->get_is_fulfilled() && $notify_customer ) {
+ /**
+ * Trigger the fulfillment deleted notification.
+ *
+ * @since 10.1.0
+ */
+ do_action( 'woocommerce_fulfillment_deleted_notification', $order_id, $fulfillment, wc_get_order( $order_id ) );
+ }
+ return new WP_REST_Response(
+ array(
+ 'message' => __( 'Fulfillment deleted successfully.', 'woocommerce' ),
+ ),
+ WP_Http::OK
+ );
+ }
+
+ /**
+ * Get the metadata for a specific fulfillment.
+ *
+ * @param WP_REST_Request $request The request object.
+ *
+ * @return WP_REST_Response The metadata for the fulfillment, or an error if the request fails.
+ */
+ public function get_fulfillment_meta( WP_REST_Request $request ): WP_REST_Response {
+ $order_id = (int) $request->get_param( 'order_id' );
+ $fulfillment_id = (int) $request->get_param( 'fulfillment_id' );
+
+ // Fetch the metadata for the fulfillment.
+ try {
+ $fulfillment = new Fulfillment( $fulfillment_id );
+ $this->validate_fulfillment( $fulfillment, $fulfillment_id, $order_id );
+ } catch ( \Exception $e ) {
+ return $this->prepare_error_response(
+ $e->getCode(),
+ $e->getMessage(),
+ WP_Http::BAD_REQUEST
+ );
+ }
+
+ return new WP_REST_Response(
+ array(
+ 'meta_data' => $fulfillment->get_raw_meta_data(),
+ ),
+ WP_Http::OK
+ );
+ }
+
+ /**
+ * Update the metadata for a specific fulfillment.
+ *
+ * @param WP_REST_Request $request The request object.
+ *
+ * @return WP_REST_Response The updated metadata for the fulfillment, or an error if the request fails.
+ */
+ public function update_fulfillment_meta( WP_REST_Request $request ): WP_REST_Response {
+ $order_id = (int) $request->get_param( 'order_id' );
+ $fulfillment_id = (int) $request->get_param( 'fulfillment_id' );
+
+ // Update the metadata for the fulfillment.
+ try {
+ $fulfillment = new Fulfillment( $fulfillment_id );
+ $this->validate_fulfillment( $fulfillment, $fulfillment_id, $order_id );
+
+ // Update the meta data keys that exist in the request.
+ foreach ( $request->get_json_params()['meta_data'] as $meta ) {
+ $fulfillment->update_meta_data( $meta['key'], $meta['value'], $meta['id'] ?? 0 );
+ }
+
+ // Remove the meta data keys that don't exist in the request, by matching their keys.
+ $existing_meta_data = $fulfillment->get_meta_data();
+ foreach ( $existing_meta_data as $meta ) {
+ if ( ! in_array( $meta->key, array_column( $request->get_json_params()['meta_data'], 'key' ), true ) ) {
+ $fulfillment->delete_meta_data( $meta->key );
+ }
+ }
+ $fulfillment->save();
+ } catch ( ApiException $ex ) {
+ return $this->prepare_error_response(
+ $ex->getErrorCode(),
+ $ex->getMessage(),
+ WP_Http::BAD_REQUEST
+ );
+ } catch ( \Exception $e ) {
+ return $this->prepare_error_response(
+ $e->getCode(),
+ $e->getMessage(),
+ WP_Http::BAD_REQUEST
+ );
+ }
+
+ return new WP_REST_Response(
+ array(
+ 'meta_data' => $fulfillment->get_raw_meta_data(),
+ ),
+ WP_Http::OK
+ );
+ }
+
+ /**
+ * Delete the metadata for a specific fulfillment.
+ *
+ * @param WP_REST_Request $request The request object.
+ *
+ * @return WP_REST_Response The deleted metadata for the fulfillment, or an error if the request fails.
+ */
+ public function delete_fulfillment_meta( WP_REST_Request $request ) {
+ $order_id = (int) $request->get_param( 'order_id' );
+ $fulfillment_id = (int) $request->get_param( 'fulfillment_id' );
+
+ // Delete the metadata for the fulfillment.
+ try {
+ $fulfillment = new Fulfillment( $fulfillment_id );
+ $this->validate_fulfillment( $fulfillment, $fulfillment_id, $order_id );
+
+ $fulfillment->delete_meta_data( $request->get_param( 'meta_key' ) );
+ $fulfillment->save();
+ } catch ( ApiException $ex ) {
+ return $this->prepare_error_response(
+ $ex->getErrorCode(),
+ $ex->getMessage(),
+ WP_Http::BAD_REQUEST
+ );
+ } catch ( \Exception $e ) {
+ return $this->prepare_error_response(
+ $e->getCode(),
+ $e->getMessage(),
+ WP_Http::BAD_REQUEST
+ );
+ }
+
+ return new WP_REST_Response(
+ array(
+ 'meta_data' => $fulfillment->get_meta_data(),
+ ),
+ WP_Http::NO_CONTENT
+ );
+ }
+
+ /**
+ * Get the tracking number details for a given tracking number, if possible.
+ *
+ * @param WP_REST_Request $request The request object.
+ *
+ * @return WP_REST_Response The tracking number details, or an error if the request fails.
+ */
+ public function get_tracking_number_details( WP_REST_Request $request ) {
+ $order_id = (int) $request->get_param( 'order_id' );
+ $tracking_number = sanitize_text_field( $request->get_param( 'tracking_number' ) );
+
+ if ( empty( $tracking_number ) ) {
+ return $this->prepare_error_response(
+ 'woocommerce_rest_tracking_number_missing',
+ __( 'Tracking number is required.', 'woocommerce' ),
+ array( 'status' => WP_Http::BAD_REQUEST )
+ );
+ }
+
+ if ( ! $order_id ) {
+ return $this->prepare_error_response(
+ 'woocommerce_rest_order_id_missing',
+ __( 'Order ID is required.', 'woocommerce' ),
+ array( 'status' => WP_Http::BAD_REQUEST )
+ );
+ }
+
+ $order = wc_get_order( $order_id );
+ if ( ! $order || ! $order instanceof WC_Order ) {
+ return $this->prepare_error_response(
+ 'woocommerce_rest_order_invalid_id',
+ __( 'Invalid order ID.', 'woocommerce' ),
+ array( 'status' => WP_Http::NOT_FOUND )
+ );
+ }
+
+ /**
+ * Parse the tracking number with additional parameters.
+ *
+ * @since 10.1.0
+ */
+ $tracking_number_parse_result = apply_filters(
+ 'woocommerce_fulfillment_parse_tracking_number',
+ $tracking_number,
+ WC()->countries->get_base_country(),
+ $order->get_shipping_country(),
+ );
+
+ return new WP_REST_Response( array( 'tracking_number_details' => $tracking_number_parse_result ), WP_Http::OK );
+ }
+
+ /**
+ * Get the arguments for the get order fulfillments endpoint.
+ *
+ * @return array
+ */
+ private function get_args_for_get_fulfillments(): array {
+ return array(
+ 'order_id' => array(
+ 'description' => __( 'Unique identifier for the order.', 'woocommerce' ),
+ 'type' => 'integer',
+ 'required' => true,
+ 'context' => array( 'view', 'edit' ),
+ ),
+ );
+ }
+
+ /**
+ * Get the schema for the get order fulfillments endpoint.
+ *
+ * @return array
+ */
+ private function get_schema_for_get_fulfillments(): array {
+ $schema = $this->get_base_schema();
+ $schema['title'] = __( 'Get fulfillments response.', 'woocommerce' );
+ $schema['properties'] = array(
+ 'fulfillment' => array(
+ 'description' => __( 'The fulfillment object.', 'woocommerce' ),
+ 'type' => 'array',
+ 'required' => true,
+ 'schema' => $this->get_read_schema_for_fulfillment(),
+ ),
+ );
+ return $schema;
+ }
+
+ /**
+ * Get the arguments for the create fulfillment endpoint.
+ *
+ * @return array
+ */
+ private function get_args_for_create_fulfillment(): array {
+ return $this->get_write_args_for_fulfillment( true );
+ }
+
+ /**
+ * Get the schema for the create fulfillment endpoint.
+ *
+ * @return array
+ */
+ private function get_schema_for_create_fulfillment(): array {
+ $schema = $this->get_base_schema();
+ $schema['title'] = __( 'Create fulfillment response.', 'woocommerce' );
+ $schema['properties'] = array(
+ 'fulfillment' => array(
+ 'description' => __( 'The created fulfillment object.', 'woocommerce' ),
+ 'type' => 'object',
+ 'required' => true,
+ 'schema' => $this->get_read_schema_for_fulfillment(),
+ ),
+ );
+ return $schema;
+ }
+
+ /**
+ * Get the arguments for the get fulfillment endpoint.
+ *
+ * @return array
+ */
+ private function get_args_for_get_fulfillment(): array {
+ return array(
+ 'order_id' => array(
+ 'description' => __( 'Unique identifier for the order.', 'woocommerce' ),
+ 'type' => 'integer',
+ 'context' => array( 'view', 'edit' ),
+ 'required' => true,
+ ),
+ 'fulfillment_id' => array(
+ 'description' => __( 'Unique identifier for the fulfillment.', 'woocommerce' ),
+ 'type' => 'integer',
+ 'context' => array( 'view', 'edit' ),
+ 'required' => true,
+ ),
+ );
+ }
+
+ /**
+ * Get the schema for the get fulfillment endpoint.
+ *
+ * @return array
+ */
+ private function get_schema_for_get_fulfillment(): array {
+ $schema = $this->get_base_schema();
+ $schema['title'] = __( 'Get fulfillment response.', 'woocommerce' );
+ $schema['properties'] = array(
+ 'fulfillment' => array(
+ 'description' => __( 'The fulfillment object.', 'woocommerce' ),
+ 'type' => 'object',
+ 'required' => true,
+ 'schema' => $this->get_read_schema_for_fulfillment(),
+ ),
+ );
+
+ return $schema;
+ }
+
+ /**
+ * Get the arguments for the update fulfillment endpoint.
+ *
+ * @return array
+ */
+ private function get_args_for_update_fulfillment(): array {
+ return $this->get_write_args_for_fulfillment( false );
+ }
+
+ /**
+ * Get the schema for the update fulfillment endpoint.
+ *
+ * @return array
+ */
+ private function get_schema_for_update_fulfillment(): array {
+ $schema = $this->get_base_schema();
+ $schema['title'] = __( 'Update fulfillment response.', 'woocommerce' );
+ $schema['properties'] = array(
+ 'fulfillment' => array(
+ 'description' => __( 'The fulfillment object.', 'woocommerce' ),
+ 'type' => 'object',
+ 'required' => true,
+ 'schema' => $this->get_read_schema_for_fulfillment(),
+ ),
+ );
+
+ return $schema;
+ }
+
+ /**
+ * Get the arguments for the delete fulfillment endpoint.
+ *
+ * @return array
+ */
+ private function get_args_for_delete_fulfillment(): array {
+ return array(
+ 'order_id' => array(
+ 'description' => __( 'Unique identifier for the order.', 'woocommerce' ),
+ 'type' => 'integer',
+ 'required' => true,
+ 'context' => array( 'view', 'edit' ),
+ ),
+ 'fulfillment_id' => array(
+ 'description' => __( 'Unique identifier for the fulfillment.', 'woocommerce' ),
+ 'type' => 'integer',
+ 'required' => true,
+ 'context' => array( 'view', 'edit' ),
+ ),
+ 'notify_customer' => array(
+ 'description' => __( 'Whether to notify the customer about the fulfillment update.', 'woocommerce' ),
+ 'type' => 'boolean',
+ 'default' => false,
+ 'required' => false,
+ 'context' => array( 'view', 'edit' ),
+ ),
+ );
+ }
+
+ /**
+ * Get the schema for the delete fulfillment endpoint.
+ *
+ * @return array
+ */
+ private function get_schema_for_delete_fulfillment(): array {
+ $schema = $this->get_base_schema();
+ $schema['title'] = __( 'Delete fulfillment response.', 'woocommerce' );
+ $schema['properties'] = array(
+ 'message' => array(
+ 'description' => __( 'The response message.', 'woocommerce' ),
+ 'type' => 'string',
+ 'required' => true,
+ ),
+ );
+
+ return $schema;
+ }
+
+ /**
+ * Get the arguments for the get fulfillment meta endpoint.
+ *
+ * @return array
+ */
+ private function get_args_for_get_fulfillment_meta(): array {
+ return array(
+ 'order_id' => array(
+ 'description' => __( 'Unique identifier for the order.', 'woocommerce' ),
+ 'type' => 'integer',
+ 'required' => true,
+ 'context' => array( 'view', 'edit' ),
+ ),
+ 'fulfillment_id' => array(
+ 'description' => __( 'Unique identifier for the fulfillment.', 'woocommerce' ),
+ 'type' => 'integer',
+ 'required' => true,
+ 'context' => array( 'view', 'edit' ),
+ ),
+ );
+ }
+
+ /**
+ * Get the schema for the get fulfillment meta endpoint.
+ *
+ * @return array
+ */
+ private function get_schema_for_get_fulfillment_meta(): array {
+ $schema = $this->get_base_schema();
+ $schema['title'] = __( 'Get fulfillment meta data response.', 'woocommerce' );
+ $schema['properties'] = array(
+ 'meta_data' => array(
+ 'description' => __( 'The meta data array.', 'woocommerce' ),
+ 'type' => 'array',
+ 'required' => true,
+ 'items' => array(
+ 'description' => __( 'The meta data object.', 'woocommerce' ),
+ 'type' => 'object',
+ 'schema' => $this->get_schema_for_meta_data(),
+ ),
+ ),
+ );
+
+ return $schema;
+ }
+
+ /**
+ * Get the arguments for the update fulfillment meta endpoint.
+ *
+ * @return array
+ */
+ private function get_args_for_update_fulfillment_meta(): array {
+ return array(
+ 'order_id' => array(
+ 'description' => __( 'Unique identifier for the order.', 'woocommerce' ),
+ 'type' => 'integer',
+ 'required' => true,
+ 'context' => array( 'view', 'edit' ),
+ ),
+ 'fulfillment_id' => array(
+ 'description' => __( 'Unique identifier for the fulfillment.', 'woocommerce' ),
+ 'type' => 'integer',
+ 'required' => true,
+ 'context' => array( 'view', 'edit' ),
+ ),
+ 'meta_data' => array(
+ 'description' => __( 'The meta data array.', 'woocommerce' ),
+ 'type' => 'array',
+ 'required' => true,
+ 'items' => array(
+ 'description' => __( 'The meta data object.', 'woocommerce' ),
+ 'type' => 'object',
+ 'schema' => $this->get_schema_for_meta_data(),
+ ),
+ ),
+ );
+ }
+
+ /**
+ * Get the schema for the update fulfillment meta endpoint.
+ *
+ * @return array
+ */
+ private function get_schema_for_update_fulfillment_meta(): array {
+ $schema = $this->get_base_schema();
+ $schema['title'] = __( 'Update fulfillment meta data response.', 'woocommerce' );
+ $schema['properties'] = array(
+ 'meta_data' => array(
+ 'description' => __( 'The meta data array.', 'woocommerce' ),
+ 'type' => 'array',
+ 'required' => true,
+ 'items' => array(
+ 'description' => __( 'The meta data object.', 'woocommerce' ),
+ 'type' => 'object',
+ 'schema' => $this->get_schema_for_meta_data(),
+ ),
+ ),
+ );
+
+ return $schema;
+ }
+
+ /**
+ * Get the arguments for the delete fulfillment meta endpoint.
+ *
+ * @return array
+ */
+ private function get_args_for_delete_fulfillment_meta(): array {
+ return array(
+ 'order_id' => array(
+ 'description' => __( 'Unique identifier for the order.', 'woocommerce' ),
+ 'type' => 'integer',
+ 'required' => true,
+ 'context' => array( 'view', 'edit' ),
+ ),
+ 'fulfillment_id' => array(
+ 'description' => __( 'Unique identifier for the fulfillment.', 'woocommerce' ),
+ 'type' => 'integer',
+ 'required' => true,
+ 'context' => array( 'view', 'edit' ),
+ ),
+ 'meta_key' => array( // phpcs:ignore WordPress.DB.SlowDBQuery.slow_db_query_meta_key
+ 'description' => __( 'The meta key to delete.', 'woocommerce' ),
+ 'type' => 'string',
+ 'required' => true,
+ ),
+ );
+ }
+
+ /**
+ * Get the schema for the delete fulfillment meta endpoint.
+ *
+ * @return array
+ */
+ private function get_schema_for_delete_fulfillment_meta(): array {
+ $schema = $this->get_base_schema();
+ $schema['title'] = __( 'Delete fulfillment meta data response.', 'woocommerce' );
+ $schema['properties'] = array(
+ 'meta_data' => array(
+ 'description' => __( 'The meta data array.', 'woocommerce' ),
+ 'type' => 'array',
+ 'required' => true,
+ 'items' => array(
+ 'description' => __( 'The meta data object.', 'woocommerce' ),
+ 'type' => 'object',
+ 'schema' => $this->get_schema_for_meta_data(),
+ ),
+ ),
+ );
+
+ return $schema;
+ }
+
+ /**
+ * Get the arguments for the get tracking number details endpoint.
+ *
+ * @return array
+ */
+ private function get_args_for_get_tracking_number_details(): array {
+ return array(
+ 'order_id' => array(
+ 'description' => __( 'Unique identifier for the order.', 'woocommerce' ),
+ 'type' => 'integer',
+ 'required' => true,
+ 'context' => array( 'view', 'edit' ),
+ ),
+ 'tracking_number' => array(
+ 'description' => __( 'The tracking number to look up.', 'woocommerce' ),
+ 'type' => 'string',
+ 'required' => true,
+ 'context' => array( 'view', 'edit' ),
+ ),
+ );
+ }
+
+ /**
+ * Get the schema for the get tracking number details endpoint.
+ *
+ * @return array
+ */
+ private function get_schema_for_get_tracking_number_details(): array {
+ $schema = $this->get_base_schema();
+ $schema['title'] = __( 'The tracking number details response.', 'woocommerce' );
+ $schema['properties'] = array(
+ 'tracking_number_details' => array(
+ 'description' => __( 'The tracking number details.', 'woocommerce' ),
+ 'type' => 'object',
+ 'required' => true,
+ 'properties' => array(
+ 'tracking_number' => array(
+ 'description' => __( 'The tracking number.', 'woocommerce' ),
+ 'type' => 'string',
+ 'required' => true,
+ ),
+ 'shipping_provider' => array(
+ 'description' => __( 'The shipping provider.', 'woocommerce' ),
+ 'type' => 'string',
+ 'required' => true,
+ ),
+ 'tracking_url' => array(
+ 'description' => __( 'The tracking URL.', 'woocommerce' ),
+ 'type' => 'string',
+ 'required' => true,
+ ),
+ ),
+ ),
+ );
+ return $schema;
+ }
+
+ /**
+ * Get the base schema for the fulfillment with a read context.
+ *
+ * @return array
+ */
+ private function get_read_schema_for_fulfillment() {
+ return array(
+ 'fulfillment_id' => array(
+ 'description' => __( 'Unique identifier for the fulfillment.', 'woocommerce' ),
+ 'type' => 'integer',
+ 'context' => array( 'view', 'edit' ),
+ 'readonly' => true,
+ ),
+ 'entity_type' => array(
+ 'description' => __( 'The type of entity for which the fulfillment is created.', 'woocommerce' ),
+ 'type' => 'string',
+ 'required' => true,
+ 'context' => array( 'view', 'edit' ),
+ ),
+ 'entity_id' => array(
+ 'description' => __( 'Unique identifier for the entity.', 'woocommerce' ),
+ 'type' => 'string',
+ 'required' => true,
+ 'context' => array( 'view', 'edit' ),
+ ),
+ 'status' => array(
+ 'description' => __( 'The status of the fulfillment.', 'woocommerce' ),
+ 'type' => 'string',
+ 'default' => 'unfulfilled',
+ 'required' => true,
+ 'context' => array( 'view', 'edit' ),
+ ),
+ 'is_fulfilled' => array(
+ 'description' => __( 'Whether the fulfillment is fulfilled.', 'woocommerce' ),
+ 'type' => 'boolean',
+ 'default' => false,
+ 'required' => true,
+ 'context' => array( 'view', 'edit' ),
+ ),
+ 'date_updated' => array(
+ 'description' => __( 'The date the fulfillment was created.', 'woocommerce' ),
+ 'type' => 'string',
+ 'context' => array( 'view', 'edit' ),
+ 'readonly' => true,
+ 'required' => true,
+ ),
+ 'date_deleted' => array(
+ 'description' => __( 'The date the fulfillment was deleted.', 'woocommerce' ),
+ 'type' => 'string',
+ 'default' => null,
+ 'context' => array( 'view', 'edit' ),
+ 'readonly' => true,
+ 'required' => true,
+ ),
+ 'meta_data' => array(
+ 'description' => __( 'Meta data for the fulfillment.', 'woocommerce' ),
+ 'type' => 'array',
+ 'required' => true,
+ 'schema' => $this->get_schema_for_meta_data(),
+ ),
+ );
+ }
+
+ /**
+ * Get the base args for the fulfillment with a write context.
+ *
+ * @param bool $is_create Whether the args list is for a create request.
+ *
+ * @return array
+ */
+ private function get_write_args_for_fulfillment( bool $is_create = false ) {
+ return array_merge(
+ ! $is_create ? array(
+ 'fulfillment_id' => array(
+ 'description' => __( 'Unique identifier for the fulfillment.', 'woocommerce' ),
+ 'type' => 'integer',
+ 'context' => array( 'view', 'edit' ),
+ 'readonly' => true,
+ ),
+ ) : array(),
+ array(
+ 'status' => array(
+ 'description' => __( 'The status of the fulfillment.', 'woocommerce' ),
+ 'type' => 'string',
+ 'default' => 'unfulfilled',
+ 'required' => false,
+ 'context' => array( 'view', 'edit' ),
+ ),
+ 'is_fulfilled' => array(
+ 'description' => __( 'Whether the fulfillment is fulfilled.', 'woocommerce' ),
+ 'type' => 'boolean',
+ 'default' => false,
+ 'required' => false,
+ 'context' => array( 'view', 'edit' ),
+ ),
+ 'meta_data' => array(
+ 'description' => __( 'Meta data for the fulfillment.', 'woocommerce' ),
+ 'type' => 'array',
+ 'required' => true,
+ 'schema' => $this->get_schema_for_meta_data(),
+ ),
+ 'notify_customer' => array(
+ 'description' => __( 'Whether to notify the customer about the fulfillment update.', 'woocommerce' ),
+ 'type' => 'boolean',
+ 'default' => false,
+ 'required' => false,
+ 'context' => array( 'view', 'edit' ),
+ ),
+ )
+ );
+ }
+
+ /**
+ * Get the schema for the meta data.
+ *
+ * @return array
+ */
+ private function get_schema_for_meta_data(): array {
+ return array(
+ 'type' => 'object',
+ 'properties' => array(
+ 'id' => array(
+ 'description' => __( 'The unique identifier for the meta data. Set `0` for new records.', 'woocommerce' ),
+ 'type' => 'integer',
+ 'context' => array( 'view', 'edit' ),
+ 'readonly' => true,
+ ),
+ 'key' => array(
+ 'description' => __( 'The key of the meta data.', 'woocommerce' ),
+ 'type' => 'string',
+ 'required' => true,
+ 'context' => array( 'view', 'edit' ),
+ ),
+ 'value' => array(
+ 'description' => __( 'The value of the meta data.', 'woocommerce' ),
+ 'type' => 'string',
+ 'required' => true,
+ 'context' => array( 'view', 'edit' ),
+ ),
+ ),
+ 'required' => true,
+ 'context' => array( 'view', 'edit' ),
+ 'readonly' => true,
+ );
+ }
+
+ /**
+ * Prepare an error response.
+ *
+ * @param string $code The error code.
+ * @param string $message The error message.
+ * @param int $status The HTTP status code.
+ *
+ * @return WP_REST_Response The error response.
+ */
+ private function prepare_error_response( $code, $message, $status ): WP_REST_Response {
+ return new WP_REST_Response(
+ array(
+ 'code' => $code,
+ 'message' => $message,
+ 'data' => array( 'status' => $status ),
+ ),
+ $status
+ );
+ }
+
+ /**
+ * Validate the fulfillment.
+ *
+ * @param Fulfillment $fulfillment The fulfillment object.
+ * @param int $fulfillment_id The fulfillment ID.
+ * @param int $order_id The order ID.
+ *
+ * @throws \Exception If the fulfillment ID is invalid.
+ */
+ private function validate_fulfillment( Fulfillment $fulfillment, int $fulfillment_id, int $order_id ) {
+ if ( $fulfillment->get_id() !== $fulfillment_id || $fulfillment->get_entity_type() !== WC_Order::class || $fulfillment->get_entity_id() !== "$order_id" ) {
+ throw new \Exception( esc_html__( 'Invalid fulfillment ID.', 'woocommerce' ) );
+ }
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/ACSCourierShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/ACSCourierShippingProvider.php
new file mode 100644
index 0000000000..4c93b2ce1f
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/ACSCourierShippingProvider.php
@@ -0,0 +1,45 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+/**
+ * ACSCourier Shipping Provider class.
+ */
+class ACSCourierShippingProvider extends AbstractShippingProvider {
+ /**
+ * Get the key of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_key(): string {
+ return 'acs-courier';
+ }
+
+ /**
+ * Get the name of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_name(): string {
+ return 'ACS Courier';
+ }
+
+ /**
+ * Get the icon of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_icon(): string {
+ return esc_url( WC()->plugin_url() ) . '/assets/images/shipping_providers/acs-courier.png';
+ }
+
+ /**
+ * Get the tracking URL for a given tracking number.
+ *
+ * @param string $tracking_number The tracking number.
+ * @return string The tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ return 'https://www.acscourier.com/track?tracking_number=' . $tracking_number;
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/AbstractShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/AbstractShippingProvider.php
new file mode 100644
index 0000000000..e16621267c
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/AbstractShippingProvider.php
@@ -0,0 +1,103 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+/**
+ * Abstract class for shipping providers.
+ *
+ * This class defines the basic structure and methods that all shipping providers must implement.
+ */
+abstract class AbstractShippingProvider {
+ /**
+ * Get the key of the shipping provider.
+ *
+ * @return string
+ */
+ abstract public function get_key(): string;
+
+ /**
+ * Get the name of the shipping provider.
+ *
+ * @return string
+ */
+ abstract public function get_name(): string;
+
+ /**
+ * Get the path of the icon of the shipping provider.
+ *
+ * @return string
+ */
+ abstract public function get_icon(): string;
+
+ /**
+ * Get the tracking URL for a given tracking number.
+ *
+ * @param string $tracking_number The tracking number.
+ * @return string The tracking URL.
+ */
+ abstract public function get_tracking_url( string $tracking_number ): string;
+
+ /**
+ * Get the countries from which the shipping provider can ship.
+ *
+ * @return array An array of country codes.
+ */
+ public function get_shipping_from_countries(): array {
+ return array();
+ }
+
+ /**
+ * Get the countries to which the shipping provider can ship.
+ *
+ * @return array An array of country codes.
+ */
+ public function get_shipping_to_countries(): array {
+ return array();
+ }
+
+ /**
+ * Check if the shipping provider can ship from a specific country.
+ *
+ * @param string $country_code The country code to check.
+ * @return bool True if the provider can ship from the country, false otherwise.
+ */
+ public function can_ship_from( string $country_code ): bool {
+ return in_array( $country_code, $this->get_shipping_from_countries(), true );
+ }
+
+ /**
+ * Check if the shipping provider can ship to a specific country.
+ *
+ * @param string $country_code The country code to check.
+ * @return bool True if the provider can ship to the country, false otherwise.
+ */
+ public function can_ship_to( string $country_code ): bool {
+ return in_array( $country_code, $this->get_shipping_to_countries(), true );
+ }
+
+ /**
+ * Check if the shipping provider can ship from a specific country to another.
+ *
+ * @param string $shipping_from The country code from which the shipment is sent.
+ * @param string $shipping_to The country code to which the shipment is sent.
+ * @return bool True if the provider can ship from the source to the destination, false otherwise.
+ */
+ public function can_ship_from_to( string $shipping_from, string $shipping_to ): bool {
+ return $this->can_ship_from( $shipping_from ) && $this->can_ship_to( $shipping_to );
+ }
+
+ /**
+ * Get the tracking URL for a given tracking number with additional parameters.
+ *
+ * @param string $tracking_number The tracking number.
+ * @param string $shipping_from The country code from which the shipment is sent.
+ * @param string $shipping_to The country code to which the shipment is sent.
+ *
+ * @return array|null The tracking URL with ambiguity score, or null if parsing fails.
+ *
+ * phpcs:disable Generic.CodeAnalysis.UnusedFunctionParameter
+ */
+ public function try_parse_tracking_number( string $tracking_number, string $shipping_from, string $shipping_to ): ?array {
+ return null; // Default implementation returns null, subclasses should override this method.
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/AmazonLogisticsShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/AmazonLogisticsShippingProvider.php
new file mode 100644
index 0000000000..0330a467a1
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/AmazonLogisticsShippingProvider.php
@@ -0,0 +1,158 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+/**
+ * Amazon Logistics Shipping Provider implementation.
+ *
+ * Handles Amazon Logistics tracking number detection and validation.
+ */
+class AmazonLogisticsShippingProvider extends AbstractShippingProvider {
+ /**
+ * Countries where Amazon Logistics operates.
+ *
+ * @var array<string>
+ */
+ private array $operating_countries = array( 'US', 'CA', 'GB', 'DE', 'FR', 'BE', 'NL', 'IT', 'IN', 'MX', 'JP', 'AU', 'ES', 'CN', 'HK', 'SG', 'GG', 'JE', 'IM', 'GI', 'AT', 'CH', 'PL', 'SE', 'DK', 'NO', 'FI', 'IE', 'PT', 'CZ', 'HU', 'RO', 'BG', 'HR', 'SK', 'SI', 'EE', 'LV', 'LT', 'CY', 'MT', 'LU', 'GR', 'BR', 'TR', 'AE', 'SA', 'EG', 'KW', 'IL', 'ZA', 'KR', 'TW', 'TH', 'MY', 'ID', 'PH', 'VN', 'NZ' );
+
+ /**
+ * Gets the unique provider key.
+ *
+ * @return string The provider key 'amazon-logistics'.
+ */
+ public function get_key(): string {
+ return 'amazon-logistics';
+ }
+
+ /**
+ * Gets the display name of the provider.
+ *
+ * @return string The provider name 'Amazon Logistics'.
+ */
+ public function get_name(): string {
+ return 'Amazon Logistics';
+ }
+
+ /**
+ * Gets the path to the provider's icon.
+ *
+ * @return string URL to the Amazon Logistics logo image.
+ */
+ public function get_icon(): string {
+ return esc_url( WC()->plugin_url() ) . '/assets/images/shipping_providers/amazon-logistics.png';
+ }
+
+ /**
+ * Gets the list of origin countries supported by Amazon Logistics.
+ *
+ * @return array<string> Array of country codes.
+ */
+ public function get_shipping_from_countries(): array {
+ return $this->operating_countries;
+ }
+
+ /**
+ * Gets the list of destination countries supported by Amazon Logistics.
+ *
+ * @return array<string> Array of country codes.
+ */
+ public function get_shipping_to_countries(): array {
+ return $this->operating_countries;
+ }
+
+ /**
+ * Checks if Amazon Logistics can ship between two countries.
+ *
+ * @param string $shipping_from Origin country code.
+ * @param string $shipping_to Destination country code.
+ * @return bool True if shipping route is supported.
+ */
+ public function can_ship_from_to( string $shipping_from, string $shipping_to ): bool {
+ return in_array( $shipping_from, $this->operating_countries, true ) &&
+ in_array( $shipping_to, $this->operating_countries, true );
+ }
+
+ /**
+ * Generates the tracking URL for an Amazon Logistics tracking number.
+ *
+ * @param string $tracking_number The tracking number to generate URL for.
+ * @return string The complete tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ return 'https://www.amazon.com/progress-tracker/package/ref=ppx_yo_dt_b_track_package_o0?_=' .
+ strtoupper( rawurlencode( $tracking_number ) );
+ }
+
+ /**
+ * Validates and parses an Amazon Logistics tracking number.
+ *
+ * @param string $tracking_number The tracking number to validate.
+ * @param string $shipping_from Origin country code.
+ * @param string $shipping_to Destination country code.
+ * @return array|null Array with tracking URL and score, or null if invalid.
+ */
+ public function try_parse_tracking_number(
+ string $tracking_number,
+ string $shipping_from,
+ string $shipping_to
+ ): ?array {
+ if ( empty( $tracking_number ) || ! $this->can_ship_from_to( $shipping_from, $shipping_to ) ) {
+ return null;
+ }
+
+ $tracking_number = strtoupper( preg_replace( '/\s+/', '', $tracking_number ) );
+
+ // Amazon Logistics tracking number patterns with region/service differentiation.
+ $patterns = array(
+ // North America patterns.
+ '/^TBA\d{12}$/' => fn() => 'US' === $shipping_from ? 100 : 95, // US standard format.
+ '/^TBC\d{12}$/' => fn() => 'CA' === $shipping_from ? 100 : 90, // Canada standard format.
+ '/^TBM\d{12}$/' => fn() => 'MX' === $shipping_from ? 100 : 85, // Mexico standard format.
+
+ // European patterns.
+ '/^CC\d{12}$/' => fn() => in_array( $shipping_from, array( 'FR', 'BE', 'NL', 'DE' ), true ) ? 95 : 80, // Continental Europe.
+ '/^GBA\d{12}$/' => fn() => 'GB' === $shipping_from ? 100 : 85, // United Kingdom.
+ '/^UK\d{10}$/' => fn() => 'GB' === $shipping_from ? 100 : 85, // United Kingdom.
+ '/^W[A-Z]\d{9}GB$/' => fn() => 'GB' === $shipping_from ? 99 : 85, // Amazon UK specific pattern.
+ '/^[A-Z]{2}\d{9}GB$/' => fn() => 'GB' === $shipping_from ? 92 : 75, // United Kingdom.
+ '/^AM\d{12}$/' => fn() => in_array( $shipping_from, array( 'DE', 'FR', 'IT', 'ES' ), true ) ? 95 : 80, // Amazon Europe.
+ '/^D\d{13}$/' => fn() => 'DE' === $shipping_from ? 95 : 75, // Germany specific.
+
+ // Asia-Pacific patterns.
+ '/^RB\d{12}$/' => fn() => in_array( $shipping_from, array( 'CN', 'HK' ), true ) ? 95 : 75, // China/Hong Kong.
+ '/^ZZ\d{12}$/' => fn() => 'AU' === $shipping_from ? 100 : 80, // Australia.
+ '/^ZX\d{12}$/' => fn() => 'IN' === $shipping_from ? 100 : 85, // India.
+ '/^JP\d{12}$/' => fn() => 'JP' === $shipping_from ? 100 : 85, // Japan.
+ '/^SG\d{12}$/' => fn() => 'SG' === $shipping_from ? 100 : 85, // Singapore.
+
+ // Amazon Fresh/Whole Foods.
+ '/^AF\d{12}$/' => fn() => 'US' === $shipping_from ? 98 : 80, // Amazon Fresh US.
+ '/^WF\d{12}$/' => fn() => 'US' === $shipping_from ? 98 : 80, // Whole Foods US.
+
+ // Amazon Business.
+ '/^AB\d{12}$/' => fn() => in_array( $shipping_from, array( 'US', 'GB', 'DE', 'FR' ), true ) ? 95 : 80, // Amazon Business.
+
+ // Legacy and alternative formats.
+ '/^TB[A-Z]\d{11}$/' => fn() => in_array( $shipping_from, array( 'US', 'CA', 'MX' ), true ) ? 90 : 70, // Variable third character.
+ '/^AZ\d{12}$/' => fn() => in_array( $shipping_from, array( 'US', 'GB', 'DE' ), true ) ? 88 : 75, // Alternative format.
+
+ // Amazon Pantry/Subscribe & Save.
+ '/^AP\d{12}$/' => fn() => 'US' === $shipping_from ? 90 : 75, // Pantry US.
+ '/^SS\d{12}$/' => fn() => 'US' === $shipping_from ? 90 : 75, // Subscribe & Save US.
+
+ // Fallback: 15-20 character Amazon codes (future-proof, low confidence).
+ '/^[A-Z0-9]{15,20}$/' => fn() => 60,
+ );
+
+ foreach ( $patterns as $pattern => $score_callback ) {
+ if ( preg_match( $pattern, $tracking_number ) ) {
+ return array(
+ 'url' => $this->get_tracking_url( $tracking_number ),
+ 'ambiguity_score' => $score_callback(),
+ );
+ }
+ }
+
+ return null;
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/AnPostShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/AnPostShippingProvider.php
new file mode 100644
index 0000000000..c1003ebb7f
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/AnPostShippingProvider.php
@@ -0,0 +1,45 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+/**
+ * AnPost Shipping Provider class.
+ */
+class AnPostShippingProvider extends AbstractShippingProvider {
+ /**
+ * Get the key of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_key(): string {
+ return 'an-post';
+ }
+
+ /**
+ * Get the name of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_name(): string {
+ return 'An Post';
+ }
+
+ /**
+ * Get the icon of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_icon(): string {
+ return esc_url( WC()->plugin_url() ) . '/assets/images/shipping_providers/an-post.png';
+ }
+
+ /**
+ * Get the tracking URL for a given tracking number.
+ *
+ * @param string $tracking_number The tracking number.
+ * @return string The tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ return 'https://www.anpost.com/Track/Track?item=' . $tracking_number;
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/ArasKargoShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/ArasKargoShippingProvider.php
new file mode 100644
index 0000000000..3d575aceb7
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/ArasKargoShippingProvider.php
@@ -0,0 +1,45 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+/**
+ * Aras Kargo Shipping Provider class.
+ */
+class ArasKargoShippingProvider extends AbstractShippingProvider {
+ /**
+ * Get the key of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_key(): string {
+ return 'aras-kargo';
+ }
+
+ /**
+ * Get the name of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_name(): string {
+ return 'Aras Kargo';
+ }
+
+ /**
+ * Get the icon of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_icon(): string {
+ return esc_url( WC()->plugin_url() ) . '/assets/images/shipping_providers/aras-kargo.png';
+ }
+
+ /**
+ * Get the tracking URL for a given tracking number.
+ *
+ * @param string $tracking_number The tracking number.
+ * @return string The tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ return 'https://www.araskargo.com.tr/Tracking/Detail?trackingNumber=' . $tracking_number;
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/AustraliaPostShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/AustraliaPostShippingProvider.php
new file mode 100644
index 0000000000..5bfca19ffd
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/AustraliaPostShippingProvider.php
@@ -0,0 +1,218 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+use Automattic\WooCommerce\Internal\Fulfillments\FulfillmentUtils;
+
+/**
+ * Australia Post Shipping Provider class.
+ *
+ * Provides Australia Post tracking number validation, supported countries, and tracking URL generation.
+ */
+class AustraliaPostShippingProvider extends AbstractShippingProvider {
+
+ /**
+ * Australia Post tracking number patterns with enhanced service detection.
+ *
+ * @var array<string, array{patterns: array<int, string>, confidence: int}>
+ */
+ private const TRACKING_PATTERNS = array(
+ 'AU' => array( // Australia.
+ 'patterns' => array(
+ // International UPU S10 format with validation.
+ '/^[A-Z]{2}\d{9}AU$/', // XX#########AU.
+ '/^[A-Z]{2}\d{7}AU$/', // Alternative international format: XX#######AU.
+
+ // Domestic numeric tracking formats.
+ '/^\d{13}$/', // 13-digit domestic tracking.
+ '/^\d{12}$/', // 12-digit domestic tracking.
+ '/^\d{11}$/', // 11-digit domestic tracking.
+
+ // Standard alphanumeric formats.
+ '/^[A-Z]{2}\d{8}[A-Z]{2}$/', // Standard format: XX########XX.
+ '/^[A-Z]{1}\d{10}[A-Z]{1}$/', // Domestic format: X##########X.
+
+ // Service-specific patterns.
+ '/^[A-Z]{4}\d{8}$/', // Express Post format: XXXX########.
+ '/^EP\d{10}$/', // Express Post specific.
+ '/^ST\d{10}$/', // StarTrack (freight).
+ '/^MB\d{10}$/', // MyPost Business.
+ '/^PO\d{10}$/', // Post Office Box.
+
+ // MyPost Digital formats.
+ '/^MP\d{10,12}$/', // MyPost tracking.
+ '/^DG\d{10,12}$/', // Digital tracking.
+
+ // Parcel numeric formats.
+ '/^7\d{15}$/', // 16-digit format starting with 7.
+ '/^3\d{15}$/', // 16-digit format starting with 3.
+ '/^8\d{15}$/', // 16-digit format starting with 8.
+
+ // eParcel formats.
+ '/^[A-Z]{3}\d{8,12}$/', // Three-letter prefix.
+ '/^33\d?[A-Z]{2}\d{18,20}$/', // StarTrack eParcel.
+ '/^AP\d{10,13}$/', // Australia Post eParcel.
+
+ // Legacy and alternative formats.
+ '/^[0-9]{10}[A-Z]{2}$/', // 10 digits + 2 letters.
+ '/^[A-Z]{1}\d{8}[A-Z]{3}$/', // Alternative format.
+ ),
+ 'confidence' => 90,
+ ),
+ );
+
+ /**
+ * Get the unique key for this shipping provider.
+ *
+ * @return string Unique key.
+ */
+ public function get_key(): string {
+ return 'australia-post';
+ }
+
+ /**
+ * Get the name of this shipping provider.
+ *
+ * @return string Name of the shipping provider.
+ */
+ public function get_name(): string {
+ return 'Australia Post';
+ }
+
+ /**
+ * Get the icon URL for this shipping provider.
+ *
+ * @return string URL of the shipping provider icon.
+ */
+ public function get_icon(): string {
+ return esc_url( WC()->plugin_url() ) . '/assets/images/shipping_providers/australia-post.png';
+ }
+
+ /**
+ * Get the countries this shipping provider can ship from.
+ *
+ * @return array List of country codes.
+ */
+ public function get_shipping_from_countries(): array {
+ return array_keys( self::TRACKING_PATTERNS );
+ }
+
+ /**
+ * Get the countries this shipping provider can ship to.
+ *
+ * Australia Post ships internationally, so we return a comprehensive list.
+ *
+ * @return array List of country codes.
+ */
+ public function get_shipping_to_countries(): array {
+ return array( 'AD', 'AE', 'AF', 'AG', 'AI', 'AL', 'AM', 'AO', 'AR', 'AS', 'AT', 'AU', 'AW', 'AZ', 'BA', 'BB', 'BD', 'BE', 'BF', 'BG', 'BH', 'BI', 'BJ', 'BM', 'BN', 'BO', 'BR', 'BS', 'BT', 'BW', 'BY', 'BZ', 'CA', 'CC', 'CD', 'CF', 'CG', 'CH', 'CI', 'CK', 'CL', 'CM', 'CN', 'CO', 'CR', 'CU', 'CV', 'CW', 'CY', 'CZ', 'DE', 'DJ', 'DK', 'DM', 'DO', 'DZ', 'EC', 'EE', 'EG', 'ER', 'ES', 'ET', 'FI', 'FJ', 'FK', 'FM', 'FO', 'FR', 'GA', 'GB', 'GD', 'GE', 'GF', 'GG', 'GH', 'GI', 'GL', 'GM', 'GN', 'GP', 'GQ', 'GR', 'GS', 'GT', 'GU', 'GW', 'GY', 'HK', 'HN', 'HR', 'HT', 'HU', 'ID', 'IE', 'IL', 'IM', 'IN', 'IO', 'IQ', 'IR', 'IS', 'IT', 'JE', 'JM', 'JO', 'JP', 'KE', 'KG', 'KH', 'KI', 'KP', 'KR', 'KW', 'KY', 'KZ', 'LA', 'LB', 'LC', 'LI', 'LK', 'LR', 'LS', 'LT', 'LU', 'LV', 'LY', 'MA', 'MC', 'MD', 'ME', 'MF', 'MG', 'MH', 'MK', 'ML', 'MM', 'MN', 'MO', 'MP', 'MQ', 'MR', 'MS', 'MT', 'MU', 'MV', 'MW', 'MX', 'MY', 'MZ', 'NA', 'NC', 'NE', 'NF', 'NG', 'NI', 'NL', 'NO', 'NP', 'NR', 'NU', 'NZ', 'OM', 'PA', 'PE', 'PF', 'PG', 'PH', 'PK', 'PL', 'PM', 'PN', 'PR', 'PS', 'PT', 'PW', 'PY', 'QA', 'RE', 'RO', 'RS', 'RU', 'RW', 'SA', 'SB', 'SC', 'SD', 'SE', 'SG', 'SH', 'SI', 'SK', 'SL', 'SM', 'SN', 'SO', 'SR', 'SS', 'ST', 'SV', 'SX', 'SY', 'SZ', 'TC', 'TD', 'TF', 'TG', 'TH', 'TJ', 'TK', 'TL', 'TM', 'TN', 'TO', 'TR', 'TT', 'TV', 'TW', 'TZ', 'UA', 'UG', 'UM', 'US', 'UY', 'UZ', 'VA', 'VC', 'VE', 'VG', 'VI', 'VN', 'VU', 'WF', 'WS', 'YE', 'YT', 'ZA', 'ZM', 'ZW' );
+ }
+
+ /**
+ * Get the tracking URL for a given tracking number.
+ *
+ * @param string $tracking_number The tracking number to generate the URL for.
+ * @return string The tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ return 'https://auspost.com.au/mypost/track/details/' . rawurlencode( $tracking_number );
+ }
+
+ /**
+ * Validate tracking number against country-specific patterns.
+ *
+ * @param string $tracking_number The tracking number to validate.
+ * @param string $country_code The country code for the shipment.
+ * @return bool True if valid, false otherwise.
+ */
+ private function validate_country_pattern( string $tracking_number, string $country_code ): bool {
+ if ( ! isset( self::TRACKING_PATTERNS[ $country_code ] ) ) {
+ return false;
+ }
+
+ foreach ( self::TRACKING_PATTERNS[ $country_code ]['patterns'] as $pattern ) {
+ if ( preg_match( $pattern, $tracking_number ) ) {
+ return true;
+ }
+ }
+ return false;
+ }
+
+ /**
+ * Try to parse an Australia Post tracking number.
+ *
+ * @param string $tracking_number The tracking number to parse.
+ * @param string $shipping_from The country code of the shipping origin.
+ * @param string $shipping_to The country code of the shipping destination.
+ * @return array|null An array with 'url' and 'ambiguity_score' if valid, null otherwise.
+ */
+ public function try_parse_tracking_number(
+ string $tracking_number,
+ string $shipping_from,
+ string $shipping_to
+ ): ?array {
+ if ( empty( $tracking_number ) || empty( $shipping_from ) || empty( $shipping_to ) ) {
+ return null;
+ }
+
+ $normalized = strtoupper( preg_replace( '/\s+/', '', $tracking_number ) );
+ if ( empty( $normalized ) ) {
+ return null;
+ }
+
+ $shipping_from = strtoupper( $shipping_from );
+ $shipping_to = strtoupper( $shipping_to );
+
+ // Australia Post ships only from Australia.
+ if ( 'AU' !== $shipping_from ) {
+ return null;
+ }
+
+ if ( $this->validate_country_pattern( $normalized, $shipping_from ) ) {
+ $confidence = self::TRACKING_PATTERNS[ $shipping_from ]['confidence'];
+
+ // Check digit validation for numeric formats.
+ if ( preg_match( '/^\d{11,13}$/', $normalized ) ) {
+ if ( FulfillmentUtils::validate_mod10_check_digit( $normalized ) ) {
+ $confidence = min( 98, $confidence + 8 );
+ }
+ }
+
+ // UPU S10 validation for international formats.
+ if ( preg_match( '/^[A-Z]{2}\d{7,9}AU$/', $normalized ) ) {
+ if ( FulfillmentUtils::check_s10_upu_format( $normalized ) ) {
+ $confidence = min( 98, $confidence + 8 );
+ }
+ }
+
+ // Service-specific confidence boosts.
+ if ( preg_match( '/^(EP|ST|MB)\d+/', $normalized ) ) {
+ $confidence = min( 95, $confidence + 5 );
+ }
+
+ // Boost confidence for domestic shipments.
+ if ( 'AU' === $shipping_to ) {
+ $confidence = min( 98, $confidence + 5 );
+ }
+
+ // Boost confidence for Asia-Pacific destinations.
+ $apac_destinations = array( 'NZ', 'SG', 'HK', 'JP', 'KR', 'TH', 'MY', 'ID', 'PH', 'VN', 'IN' );
+ if ( in_array( $shipping_to, $apac_destinations, true ) ) {
+ $confidence = min( 95, $confidence + 3 );
+ }
+
+ // Boost confidence for common destinations.
+ $common_destinations = array( 'US', 'GB', 'CA', 'DE', 'FR' );
+ if ( in_array( $shipping_to, $common_destinations, true ) ) {
+ $confidence = min( 93, $confidence + 2 );
+ }
+
+ return array(
+ 'url' => $this->get_tracking_url( $normalized ),
+ 'ambiguity_score' => $confidence,
+ );
+ }
+
+ return null;
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/AzerpostShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/AzerpostShippingProvider.php
new file mode 100644
index 0000000000..0a219fb0ef
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/AzerpostShippingProvider.php
@@ -0,0 +1,45 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+/**
+ * Azerpost Shipping Provider class.
+ */
+class AzerpostShippingProvider extends AbstractShippingProvider {
+ /**
+ * Get the key of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_key(): string {
+ return 'azerpost';
+ }
+
+ /**
+ * Get the name of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_name(): string {
+ return 'Azerpost';
+ }
+
+ /**
+ * Get the icon of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_icon(): string {
+ return esc_url( WC()->plugin_url() ) . '/assets/images/shipping_providers/azerpost.png';
+ }
+
+ /**
+ * Get the tracking URL for a given tracking number.
+ *
+ * @param string $tracking_number The tracking number.
+ * @return string The tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ return 'https://www.azerpost.az/track/' . $tracking_number;
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/BartoliniBRTShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/BartoliniBRTShippingProvider.php
new file mode 100644
index 0000000000..8319f2eb3e
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/BartoliniBRTShippingProvider.php
@@ -0,0 +1,45 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+/**
+ * Bartolini (BRT) Shipping Provider class.
+ */
+class BartoliniBRTShippingProvider extends AbstractShippingProvider {
+ /**
+ * Get the key of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_key(): string {
+ return 'bartolini-brt';
+ }
+
+ /**
+ * Get the name of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_name(): string {
+ return 'Bartolini (BRT)';
+ }
+
+ /**
+ * Get the icon of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_icon(): string {
+ return esc_url( WC()->plugin_url() ) . '/assets/images/shipping_providers/bartolini-brt.png';
+ }
+
+ /**
+ * Get the tracking URL for a given tracking number.
+ *
+ * @param string $tracking_number The tracking number.
+ * @return string The tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ return 'https://www.brt.it/track?trackingNumber=' . $tracking_number;
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/BelpochtaShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/BelpochtaShippingProvider.php
new file mode 100644
index 0000000000..67454fb861
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/BelpochtaShippingProvider.php
@@ -0,0 +1,45 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+/**
+ * Belpochta Shipping Provider class.
+ */
+class BelpochtaShippingProvider extends AbstractShippingProvider {
+ /**
+ * Get the key of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_key(): string {
+ return 'belpochta';
+ }
+
+ /**
+ * Get the name of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_name(): string {
+ return 'Belpochta';
+ }
+
+ /**
+ * Get the icon of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_icon(): string {
+ return esc_url( WC()->plugin_url() ) . '/assets/images/shipping_providers/belpochta.png';
+ }
+
+ /**
+ * Get the tracking URL for a given tracking number.
+ *
+ * @param string $tracking_number The tracking number.
+ * @return string The tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ return 'https://www.belpost.by/track/' . $tracking_number;
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/BpostShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/BpostShippingProvider.php
new file mode 100644
index 0000000000..1af64fe4c9
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/BpostShippingProvider.php
@@ -0,0 +1,45 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+/**
+ * Bpost Shipping Provider class.
+ */
+class BpostShippingProvider extends AbstractShippingProvider {
+ /**
+ * Get the key of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_key(): string {
+ return 'bpost';
+ }
+
+ /**
+ * Get the name of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_name(): string {
+ return 'bpost';
+ }
+
+ /**
+ * Get the icon of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_icon(): string {
+ return esc_url( WC()->plugin_url() ) . '/assets/images/shipping_providers/bpost.png';
+ }
+
+ /**
+ * Get the tracking URL for a given tracking number.
+ *
+ * @param string $tracking_number The tracking number.
+ * @return string The tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ return 'https://www.bpost.be/en/track-and-trace?itemId=' . $tracking_number;
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/BulgarianPostsShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/BulgarianPostsShippingProvider.php
new file mode 100644
index 0000000000..a9bd09ed4a
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/BulgarianPostsShippingProvider.php
@@ -0,0 +1,45 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+/**
+ * BulgarianPosts Shipping Provider class.
+ */
+class BulgarianPostsShippingProvider extends AbstractShippingProvider {
+ /**
+ * Get the key of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_key(): string {
+ return 'bulgarian-posts';
+ }
+
+ /**
+ * Get the name of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_name(): string {
+ return 'Bulgarian Posts';
+ }
+
+ /**
+ * Get the icon of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_icon(): string {
+ return esc_url( WC()->plugin_url() ) . '/assets/images/shipping_providers/bulgarian-posts.png';
+ }
+
+ /**
+ * Get the tracking URL for a given tracking number.
+ *
+ * @param string $tracking_number The tracking number.
+ * @return string The tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ return 'https://www.bulgarianposts.bg/en/track-and-trace?trackingNumber=' . $tracking_number;
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/CDEKShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/CDEKShippingProvider.php
new file mode 100644
index 0000000000..9ae4f1df4d
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/CDEKShippingProvider.php
@@ -0,0 +1,45 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+/**
+ * CDEK Shipping Provider class.
+ */
+class CDEKShippingProvider extends AbstractShippingProvider {
+ /**
+ * Get the key of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_key(): string {
+ return 'cdek';
+ }
+
+ /**
+ * Get the name of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_name(): string {
+ return 'CDEK';
+ }
+
+ /**
+ * Get the icon of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_icon(): string {
+ return esc_url( WC()->plugin_url() ) . '/assets/images/shipping_providers/cdek.png';
+ }
+
+ /**
+ * Get the tracking URL for a given tracking number.
+ *
+ * @param string $tracking_number The tracking number.
+ * @return string The tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ return 'https://www.cdek.ru/track.html?trackingNumber=' . $tracking_number;
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/CTTShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/CTTShippingProvider.php
new file mode 100644
index 0000000000..10e377648d
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/CTTShippingProvider.php
@@ -0,0 +1,45 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+/**
+ * CTT Shipping Provider class.
+ */
+class CTTShippingProvider extends AbstractShippingProvider {
+ /**
+ * Get the key of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_key(): string {
+ return 'ctt';
+ }
+
+ /**
+ * Get the name of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_name(): string {
+ return 'CTT';
+ }
+
+ /**
+ * Get the icon of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_icon(): string {
+ return esc_url( WC()->plugin_url() ) . '/assets/images/shipping_providers/ctt.png';
+ }
+
+ /**
+ * Get the tracking URL for a given tracking number.
+ *
+ * @param string $tracking_number The tracking number.
+ * @return string The tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ return 'https://www.ctt.pt/feapl_2/app/open/objectTrackingSearch.do?objectCode=' . $tracking_number;
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/CanadaPostShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/CanadaPostShippingProvider.php
new file mode 100644
index 0000000000..7e18e9107d
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/CanadaPostShippingProvider.php
@@ -0,0 +1,212 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+use Automattic\WooCommerce\Internal\Fulfillments\FulfillmentUtils;
+
+/**
+ * Canada Post Shipping Provider class.
+ *
+ * Provides Canada Post tracking number validation, supported countries, and tracking URL generation.
+ */
+class CanadaPostShippingProvider extends AbstractShippingProvider {
+
+ /**
+ * Canada Post tracking number patterns with service differentiation.
+ *
+ * @var array<string, array{patterns: array<int, string>, confidence: int}>
+ */
+ private const TRACKING_PATTERNS = array(
+ 'CA' => array( // Canada.
+ 'patterns' => array(
+ // UPU S10 international format (outbound).
+ '/^[A-Z]{2}\d{9}CA$/', // Standard format: XX#########CA.
+ // UPU S10 international (inbound/other countries, fallback).
+ '/^[A-Z]{2}\d{9}[A-Z]{2}$/', // Any S10/UPU code.
+ // Domestic numeric formats.
+ '/^\d{16}$/', // 16-digit domestic tracking.
+ '/^\d{15}$/', // 15-digit legacy/partner/returns.
+ '/^\d{14}$/', // 14-digit legacy/partner/returns.
+ '/^\d{13}$/', // 13-digit domestic (most common).
+ '/^\d{12}$/', // 12-digit domestic.
+ '/^\d{10}$/', // 10-digit legacy.
+ '/^\d{9}$/', // 9-digit legacy.
+ '/^\d{8}$/', // 8-digit calling card/legacy.
+ // Service-specific patterns.
+ '/^XP\d{9}CA$/', // Xpresspost International.
+ '/^EX\d{9}CA$/', // Express International.
+ '/^PR\d{9}CA$/', // Priority.
+ '/^RG\d{9}CA$/', // Regular (deprecated, legacy).
+ '/^RM\d{9}CA$/', // Registered Mail.
+ '/^CM\d{9}CA$/', // Certified Mail.
+ '/^[A-Z]{2}\d{7}[A-Z]{2}$/', // International format: XX#######XX.
+ '/^[A-Z]{1}\d{9}[A-Z]{1}$/', // Domestic formats: X#########X.
+ '/^FD\d{10,12}$/', // FlexDelivery.
+ '/^PO\d{10,12}$/', // Post Office Box service.
+ '/^CP\d{10,14}$/', // Canada Post business.
+ '/^SM\d{10,14}$/', // Small packet.
+ // Legacy and alternative formats.
+ '/^[0-9]{13}[A-Z]{1}$/', // 13 digits + 1 letter.
+ ),
+ 'confidence' => 92,
+ ),
+ );
+
+ /**
+ * Get the unique key for this shipping provider.
+ *
+ * @return string Unique key.
+ */
+ public function get_key(): string {
+ return 'canada-post';
+ }
+
+ /**
+ * Get the name of this shipping provider.
+ *
+ * @return string Name of the shipping provider.
+ */
+ public function get_name(): string {
+ return 'Canada Post';
+ }
+
+ /**
+ * Get the icon URL for this shipping provider.
+ *
+ * @return string URL of the shipping provider icon.
+ */
+ public function get_icon(): string {
+ return esc_url( WC()->plugin_url() ) . '/assets/images/shipping_providers/canada-post.png';
+ }
+
+ /**
+ * Get the countries this shipping provider can ship from.
+ *
+ * @return array List of country codes.
+ */
+ public function get_shipping_from_countries(): array {
+ return array_keys( self::TRACKING_PATTERNS );
+ }
+
+ /**
+ * Get the countries this shipping provider can ship to.
+ *
+ * Canada Post ships internationally, so we return a comprehensive list.
+ *
+ * @return array List of country codes.
+ */
+ public function get_shipping_to_countries(): array {
+ return array( 'AD', 'AE', 'AF', 'AG', 'AI', 'AL', 'AM', 'AO', 'AQ', 'AR', 'AS', 'AT', 'AU', 'AW', 'AX', 'AZ', 'BA', 'BB', 'BD', 'BE', 'BF', 'BG', 'BH', 'BI', 'BJ', 'BL', 'BM', 'BN', 'BO', 'BQ', 'BR', 'BS', 'BT', 'BV', 'BW', 'BY', 'BZ', 'CA', 'CC', 'CD', 'CF', 'CG', 'CH', 'CI', 'CK', 'CL', 'CM', 'CN', 'CO', 'CR', 'CU', 'CV', 'CW', 'CX', 'CY', 'CZ', 'DE', 'DJ', 'DK', 'DM', 'DO', 'DZ', 'EC', 'EE', 'EG', 'EH', 'ER', 'ES', 'ET', 'FI', 'FJ', 'FK', 'FM', 'FO', 'FR', 'GA', 'GB', 'GD', 'GE', 'GF', 'GG', 'GH', 'GI', 'GL', 'GM', 'GN', 'GP', 'GQ', 'GR', 'GS', 'GT', 'GU', 'GW', 'GY', 'HK', 'HM', 'HN', 'HR', 'HT', 'HU', 'ID', 'IE', 'IL', 'IM', 'IN', 'IO', 'IQ', 'IR', 'IS', 'IT', 'JE', 'JM', 'JO', 'JP', 'KE', 'KG', 'KH', 'KI', 'KM', 'KN', 'KP', 'KR', 'KW', 'KY', 'KZ', 'LA', 'LB', 'LC', 'LI', 'LK', 'LR', 'LS', 'LT', 'LU', 'LV', 'LY', 'MA', 'MC', 'MD', 'ME', 'MF', 'MG', 'MH', 'MK', 'ML', 'MM', 'MN', 'MO', 'MP', 'MQ', 'MR', 'MS', 'MT', 'MU', 'MV', 'MW', 'MX', 'MY', 'MZ', 'NA', 'NC', 'NE', 'NF', 'NG', 'NI', 'NL', 'NO', 'NP', 'NR', 'NU', 'NZ', 'OM', 'PA', 'PE', 'PF', 'PG', 'PH', 'PK', 'PL', 'PM', 'PN', 'PR', 'PS', 'PT', 'PW', 'PY', 'QA', 'RE', 'RO', 'RS', 'RU', 'RW', 'SA', 'SB', 'SC', 'SD', 'SE', 'SG', 'SH', 'SI', 'SJ', 'SK', 'SL', 'SM', 'SN', 'SO', 'SR', 'SS', 'ST', 'SV', 'SX', 'SY', 'SZ', 'TC', 'TD', 'TF', 'TG', 'TH', 'TJ', 'TK', 'TL', 'TM', 'TN', 'TO', 'TR', 'TT', 'TV', 'TW', 'TZ', 'UA', 'UG', 'UM', 'US', 'UY', 'UZ', 'VA', 'VC', 'VE', 'VG', 'VI', 'VN', 'VU', 'WF', 'WS', 'YE', 'YT', 'ZA', 'ZM', 'ZW' );
+ }
+
+ /**
+ * Get the tracking URL for a given tracking number.
+ *
+ * @param string $tracking_number The tracking number to generate the URL for.
+ * @return string The tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ return 'https://www.canadapost-postescanada.ca/track-reperage/en#/search?searchFor=' . rawurlencode( $tracking_number );
+ }
+
+ /**
+ * Validate tracking number against country-specific patterns.
+ *
+ * @param string $tracking_number The tracking number to validate.
+ * @param string $country_code The country code for the shipment.
+ * @return bool True if valid, false otherwise.
+ */
+ private function validate_country_pattern( string $tracking_number, string $country_code ): bool {
+ if ( ! isset( self::TRACKING_PATTERNS[ $country_code ] ) ) {
+ return false;
+ }
+
+ foreach ( self::TRACKING_PATTERNS[ $country_code ]['patterns'] as $pattern ) {
+ if ( preg_match( $pattern, $tracking_number ) ) {
+ return true;
+ }
+ }
+ return false;
+ }
+
+ /**
+ * Try to parse a Canada Post tracking number.
+ *
+ * @param string $tracking_number The tracking number to parse.
+ * @param string $shipping_from The country code of the shipping origin.
+ * @param string $shipping_to The country code of the shipping destination.
+ * @return array|null An array with 'url' and 'ambiguity_score' if valid, null otherwise.
+ */
+ public function try_parse_tracking_number(
+ string $tracking_number,
+ string $shipping_from,
+ string $shipping_to
+ ): ?array {
+ if ( empty( $tracking_number ) || empty( $shipping_from ) || empty( $shipping_to ) ) {
+ return null;
+ }
+
+ $normalized = strtoupper( preg_replace( '/\s+/', '', $tracking_number ) ); // Normalize input.
+ if ( empty( $normalized ) ) {
+ return null;
+ }
+
+ $shipping_from = strtoupper( $shipping_from );
+ $shipping_to = strtoupper( $shipping_to );
+
+ // Check if shipping from Canada.
+ if ( 'CA' !== $shipping_from ) {
+ return null;
+ }
+
+ // Check country-specific patterns with enhanced validation.
+ if ( $this->validate_country_pattern( $normalized, $shipping_from ) ) {
+ $confidence = self::TRACKING_PATTERNS[ $shipping_from ]['confidence'];
+
+ // Apply UPU S10 validation for international formats.
+ if ( preg_match( '/^[A-Z]{2}\d{9}CA$/', $normalized ) ) {
+ if ( FulfillmentUtils::check_s10_upu_format( $normalized ) ) {
+ $confidence = min( 98, $confidence + 6 ); // Strong boost for valid UPU.
+ }
+ } elseif ( preg_match( '/^[A-Z]{2}\d{9}[A-Z]{2}$/', $normalized ) ) {
+ // Apply S10/UPU fallback with lower confidence.
+ if ( FulfillmentUtils::check_s10_upu_format( $normalized ) ) {
+ $confidence = min( 94, $confidence + 2 ); // Lower boost for inbound S10.
+ }
+ }
+
+ // Apply check digit validation for numeric formats.
+ if ( preg_match( '/^\d{12,16}$/', $normalized ) ) {
+ if ( FulfillmentUtils::validate_mod10_check_digit( $normalized ) ) {
+ $confidence = min( 96, $confidence + 4 ); // Boost for valid check digit.
+ }
+ }
+
+ // Service-specific confidence boosts.
+ if ( preg_match( '/^(XP|EX|PR)\d+/', $normalized ) ) {
+ $confidence = min( 96, $confidence + 4 ); // Express/Priority services.
+ } elseif ( preg_match( '/^(RM|CM)\d+/', $normalized ) ) {
+ $confidence = min( 95, $confidence + 3 ); // Registered/Certified.
+ } elseif ( preg_match( '/^(FD|PO|CP|SM)\d+/', $normalized ) ) {
+ $confidence = min( 94, $confidence + 2 ); // Special services.
+ }
+
+ // Boost confidence for domestic shipments.
+ if ( 'CA' === $shipping_to ) {
+ $confidence = min( 98, $confidence + 3 );
+ }
+
+ // Boost for North American destinations.
+ if ( in_array( $shipping_to, array( 'US', 'MX' ), true ) ) {
+ $confidence = min( 95, $confidence + 2 );
+ }
+
+ return array(
+ 'url' => $this->get_tracking_url( $normalized ),
+ 'ambiguity_score' => $confidence,
+ );
+ }
+
+ return null;
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/CeskaPostaShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/CeskaPostaShippingProvider.php
new file mode 100644
index 0000000000..9fbf288c45
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/CeskaPostaShippingProvider.php
@@ -0,0 +1,45 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+/**
+ * Česká pošta Shipping Provider class.
+ */
+class CeskaPostaShippingProvider extends AbstractShippingProvider {
+ /**
+ * Get the key of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_key(): string {
+ return 'ceska-posta';
+ }
+
+ /**
+ * Get the name of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_name(): string {
+ return 'Česká pošta';
+ }
+
+ /**
+ * Get the icon of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_icon(): string {
+ return esc_url( WC()->plugin_url() ) . '/assets/images/shipping_providers/ceska-posta.png';
+ }
+
+ /**
+ * Get the tracking URL for a given tracking number.
+ *
+ * @param string $tracking_number The tracking number.
+ * @return string The tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ return 'https://www.postaonline.cz/trackandtrace/' . $tracking_number;
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/ChronopostShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/ChronopostShippingProvider.php
new file mode 100644
index 0000000000..7f93140ce0
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/ChronopostShippingProvider.php
@@ -0,0 +1,45 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+/**
+ * Chronopost Shipping Provider class.
+ */
+class ChronopostShippingProvider extends AbstractShippingProvider {
+ /**
+ * Get the key of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_key(): string {
+ return 'chronopost';
+ }
+
+ /**
+ * Get the name of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_name(): string {
+ return 'Chronopost';
+ }
+
+ /**
+ * Get the icon of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_icon(): string {
+ return esc_url( WC()->plugin_url() ) . '/assets/images/shipping_providers/chronopost.png';
+ }
+
+ /**
+ * Get the tracking URL for a given tracking number.
+ *
+ * @param string $tracking_number The tracking number.
+ * @return string The tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ return 'https://www.chronopost.fr/en/track/' . $tracking_number;
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/CorreosShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/CorreosShippingProvider.php
new file mode 100644
index 0000000000..652a97fcb1
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/CorreosShippingProvider.php
@@ -0,0 +1,45 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+/**
+ * Correos Shipping Provider class.
+ */
+class CorreosShippingProvider extends AbstractShippingProvider {
+ /**
+ * Get the key of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_key(): string {
+ return 'correos';
+ }
+
+ /**
+ * Get the name of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_name(): string {
+ return 'Correos';
+ }
+
+ /**
+ * Get the icon of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_icon(): string {
+ return esc_url( WC()->plugin_url() ) . '/assets/images/shipping_providers/correos.png';
+ }
+
+ /**
+ * Get the tracking URL for a given tracking number.
+ *
+ * @param string $tracking_number The tracking number.
+ * @return string The tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ return 'https://www.correos.es/ss/Satellite/site/pagina-tracking/info?idioma=en_GB&numeroEnvio=' . $tracking_number;
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/CyprusPostShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/CyprusPostShippingProvider.php
new file mode 100644
index 0000000000..b1fd6121a6
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/CyprusPostShippingProvider.php
@@ -0,0 +1,45 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+/**
+ * CyprusPost Shipping Provider class.
+ */
+class CyprusPostShippingProvider extends AbstractShippingProvider {
+ /**
+ * Get the key of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_key(): string {
+ return 'cyprus-post';
+ }
+
+ /**
+ * Get the name of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_name(): string {
+ return 'Cyprus Post';
+ }
+
+ /**
+ * Get the icon of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_icon(): string {
+ return esc_url( WC()->plugin_url() ) . '/assets/images/shipping_providers/cyprus-post.png';
+ }
+
+ /**
+ * Get the tracking URL for a given tracking number.
+ *
+ * @param string $tracking_number The tracking number.
+ * @return string The tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ return 'https://www.cypruspost.post/en/track/' . $tracking_number;
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/DHLShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/DHLShippingProvider.php
new file mode 100644
index 0000000000..0e895d15ce
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/DHLShippingProvider.php
@@ -0,0 +1,195 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+use Automattic\WooCommerce\Internal\Fulfillments\FulfillmentUtils;
+
+/**
+ * DHL Shipping Provider implementation.
+ *
+ * Handles DHL tracking number detection and validation for all DHL services.
+ */
+class DHLShippingProvider extends AbstractShippingProvider {
+ /**
+ * List of countries where DHL has significant operations.
+ *
+ * @var array<string>
+ */
+ private array $major_operation_countries = array( 'DE', 'US', 'CA', 'GB', 'SG', 'JP', 'HK', 'NL', 'FR', 'IT', 'AU', 'CN', 'IN', 'ES', 'BE', 'CH', 'AT', 'SE', 'DK', 'NO', 'PL', 'CZ', 'FI', 'IE', 'PT', 'GR', 'HU', 'RO', 'BG', 'HR', 'SK', 'SI', 'LT', 'LV', 'EE', 'CY', 'MT', 'LU' );
+
+ /**
+ * Gets the unique provider key.
+ *
+ * @return string The provider key 'dhl'.
+ */
+ public function get_key(): string {
+ return 'dhl';
+ }
+
+ /**
+ * Gets the display name of the provider.
+ *
+ * @return string The provider name 'DHL'.
+ */
+ public function get_name(): string {
+ return 'DHL';
+ }
+
+ /**
+ * Gets the path to the provider's icon.
+ *
+ * @return string URL to the DHL logo image.
+ */
+ public function get_icon(): string {
+ return esc_url( WC()->plugin_url() ) . '/assets/images/shipping_providers/dhl.png';
+ }
+
+ /**
+ * Generates the appropriate tracking URL based on DHL service type.
+ *
+ * @param string $tracking_number The tracking number to generate URL for.
+ * @return string The complete tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ $tracking_number = strtoupper( $tracking_number ); // Uppercase for consistency.
+
+ // DHL Global Mail and eCommerce prefixes.
+ if ( preg_match( '/^(GM|LX|RX|CN|SG|MY|HK|AU|TH|420)/', $tracking_number ) ) {
+ return 'https://webtrack.dhlglobalmail.com/?trackingnumber=' . rawurlencode( $tracking_number );
+ }
+
+ // DHL Paket Germany (3S...).
+ if ( preg_match( '/^3S[A-Z0-9]{8,12}$/', $tracking_number ) ) {
+ return 'https://www.dhl.de/en/privatkunden/dhl-sendungsverfolgung.html?piececode=' . rawurlencode( $tracking_number );
+ }
+
+ // Standard DHL Express tracking.
+ return 'https://www.dhl.com/en/express/tracking.html?AWB=' . rawurlencode( $tracking_number );
+ }
+
+ /**
+ * Gets the list of origin countries supported by DHL.
+ *
+ * @return array<string> Array of country codes.
+ */
+ public function get_shipping_from_countries(): array {
+ return $this->major_operation_countries;
+ }
+
+ /**
+ * Gets the list of destination countries supported by DHL.
+ *
+ * @return array<string> Array of country codes.
+ */
+ public function get_shipping_to_countries(): array {
+ return array_keys( wc()->countries->get_countries() );
+ }
+
+ /**
+ * Checks if DHL can ship between two countries.
+ *
+ * @param string $shipping_from Origin country code.
+ * @param string $shipping_to Destination country code.
+ * @return bool True if shipping route is supported.
+ */
+ public function can_ship_from_to( string $shipping_from, string $shipping_to ): bool {
+ return in_array( $shipping_from, $this->get_shipping_from_countries(), true ) &&
+ in_array( $shipping_to, $this->get_shipping_to_countries(), true );
+ }
+
+ /**
+ * Validates and parses a DHL tracking number.
+ *
+ * @param string $tracking_number The tracking number to validate.
+ * @param string $shipping_from Origin country code.
+ * @param string $shipping_to Destination country code.
+ * @return array|null Array with tracking URL and score, or null if invalid.
+ */
+ public function try_parse_tracking_number( string $tracking_number, string $shipping_from, string $shipping_to ): ?array {
+ if ( empty( $tracking_number ) || ! $this->can_ship_from_to( $shipping_from, $shipping_to ) ) {
+ return null;
+ }
+
+ $tracking_number = strtoupper( preg_replace( '/\s+/', '', $tracking_number ) ); // Remove spaces and uppercase for consistency.
+ $is_major_country = in_array( $shipping_from, $this->major_operation_countries, true ); // Major operation region flag.
+
+ // DHL tracking number patterns with enhanced validation and comments.
+ $patterns = array(
+ // DHL Express Air Waybill: 10 or 11 digits, with check digit validation.
+ '/^\d{10}$/' => function () use ( $tracking_number ) {
+ return FulfillmentUtils::validate_mod11_check_digit( $tracking_number ) ? 98 : 90;
+ },
+ '/^\d{11}$/' => function () use ( $tracking_number ) {
+ return FulfillmentUtils::validate_mod11_check_digit( $tracking_number ) ? 98 : 90;
+ },
+
+ // DHL Express JJD and JVGL formats.
+ '/^JJD\d{10}$/' => 98,
+ '/^JVGL\d{10}$/' => 98,
+
+ // DHL Paket Germany: 12, 14, or 20 digits.
+ // Only match 12/14-digit numeric for DHL if both from and to are DE (Germany).
+ '/^\d{12}$/' => function () use ( $shipping_from, $shipping_to ) {
+ return ( 'DE' === $shipping_from && 'DE' === $shipping_to ) ? 92 : 60;
+ },
+ '/^\d{14}$/' => function () use ( $shipping_from, $shipping_to ) {
+ return ( 'DE' === $shipping_from && 'DE' === $shipping_to ) ? 92 : 60;
+ },
+ '/^\d{20}$/' => 90,
+
+ // DHL Paket Germany: 3S + 8–12 alphanumeric.
+ '/^3S[A-Z0-9]{8,12}$/' => 95,
+
+ // DHL eCommerce North America: GM + 16–20 digits.
+ '/^GM\d{16,20}$/' => function () use ( $shipping_from ) {
+ return in_array( $shipping_from, array( 'US', 'CA' ), true ) ? 95 : 80;
+ },
+
+ // DHL eCommerce Asia-Pacific: LX, RX, CN, SG, MY, HK, AU, TH + 9 digits + 2 letters.
+ '/^(LX|RX|CN|SG|MY|HK|AU|TH)\d{9}[A-Z]{2}$/' => 92,
+
+ // DHL eCommerce US consolidator: 420 + 27–31 digits.
+ '/^420\d{23,31}$/' => 90,
+
+ // DHL Global Forwarding: 7, 8, or 9 digits (numeric only).
+ '/^\d{7,9}$/' => 88,
+
+ // DHL Global Forwarding: 1 digit + 2 letters + 4–6 digits.
+ '/^\d[A-Z]{2}\d{4,6}$/' => 90,
+
+ // DHL Global Forwarding: 3–4 letters + 4–8 digits.
+ '/^[A-Z]{3,4}\d{4,8}$/' => 88,
+
+ // DHL Same Day: DSD + 8–12 digits.
+ '/^DSD\d{8,12}$/' => 92,
+
+ // DHL Piece Numbers: JD + 11 digits.
+ '/^JD\d{11}$/' => 90,
+
+ // DHL Supply Chain: DSC + 10–15 digits.
+ '/^DSC\d{10,15}$/' => 85,
+
+ // S10/UPU format: 2 letters + 9 digits + 2 letters (used for DHL eCommerce and Packet International).
+ '/^[A-Z]{2}\d{9}[A-Z]{2}$/' => function () use ( $tracking_number ) {
+ return FulfillmentUtils::check_s10_upu_format( $tracking_number ) ? 88 : 75;
+ },
+
+ // Fallback: 22 digit numeric (legacy/rare).
+ '/^\d{22}$/' => 70,
+ );
+
+ foreach ( $patterns as $pattern => $base_score ) {
+ if ( preg_match( $pattern, $tracking_number ) ) {
+ $score = is_callable( $base_score ) ? $base_score() : $base_score;
+ if ( $score > 0 ) {
+ return array(
+ 'url' => $this->get_tracking_url( $tracking_number ),
+ 'ambiguity_score' => $score,
+ );
+ }
+ }
+ }
+
+ return null;
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/DPDShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/DPDShippingProvider.php
new file mode 100644
index 0000000000..fb5ee07fca
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/DPDShippingProvider.php
@@ -0,0 +1,467 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+/**
+ * DPD Shipping Provider class.
+ *
+ * Provides DPD tracking number validation, supported countries, and tracking URL generation.
+ */
+class DPDShippingProvider extends AbstractShippingProvider {
+
+ /**
+ * DPD tracking number patterns by country with service differentiation.
+ *
+ * @var array<string, array{patterns: array<int, string>, confidence: int, services?: array<string, int>}>
+ */
+ private const TRACKING_PATTERNS = array(
+ 'DE' => array( // Germany.
+ 'patterns' => array(
+ '/^\d{14}$/',
+ '/^\d{12}$/',
+ '/^02\d{12}$/', // DPD Classic.
+ '/^05\d{12}$/', // DPD Express.
+ '/^09\d{12}$/', // DPD Predict.
+ '/^[A-Z]{2}\d{9}[A-Z]{2}$/', // S10/UPU international.
+ '/^\d{24}$/', // 24-digit fallback.
+ ),
+ 'confidence' => 80,
+ 'services' => array(
+ 'classic' => 80,
+ 'express' => 85,
+ 'predict' => 85,
+ 's10' => 90,
+ ),
+ ),
+ 'GB' => array( // United Kingdom.
+ 'patterns' => array(
+ '/^\d{14}$/',
+ '/^[A-Z]{2}\d{9}GB$/',
+ '/^03\d{12}$/', // DPD Next Day.
+ '/^06\d{12}$/', // DPD Express.
+ '/^1[56]\d{12}$/', // Predict/Return.
+ '/^[A-Z]{2}\d{9}[A-Z]{2}$/', // S10/UPU international.
+ '/^\d{24}$/', // 24-digit fallback.
+ ),
+ 'confidence' => 90,
+ 'services' => array(
+ 'next_day' => 88,
+ 'express' => 88,
+ 's10' => 90,
+ ),
+ ),
+ 'FR' => array( // France.
+ 'patterns' => array(
+ '/^\d{14}$/',
+ '/^\d{12}$/',
+ '/^02\d{12}$/', // DPD Relais.
+ '/^04\d{12}$/', // DPD Predict.
+ '/^[A-Z]{2}\d{9}[A-Z]{2}$/', // S10/UPU international.
+ '/^\d{24}$/', // 24-digit fallback.
+ ),
+ 'confidence' => 78,
+ 'services' => array(
+ 'relais' => 82,
+ 'predict' => 82,
+ 's10' => 90,
+ ),
+ ),
+ 'NL' => array( // Netherlands.
+ 'patterns' => array(
+ '/^\d{14}$/',
+ '/^\d{12}$/',
+ '/^03\d{12}$/', // DPD Classic.
+ '/^07\d{12}$/', // DPD Express.
+ '/^[A-Z]{2}\d{9}[A-Z]{2}$/', // S10/UPU international.
+ '/^\d{24}$/', // 24-digit fallback.
+ ),
+ 'confidence' => 78,
+ 'services' => array(
+ 'classic' => 82,
+ 'express' => 85,
+ 's10' => 90,
+ ),
+ ),
+ 'BE' => array( // Belgium.
+ 'patterns' => array(
+ '/^\d{14}$/',
+ '/^\d{12}$/',
+ '/^03\d{12}$/', // DPD Classic.
+ '/^08\d{12}$/', // DPD Express.
+ '/^[A-Z]{2}\d{9}[A-Z]{2}$/', // S10/UPU international.
+ '/^\d{24}$/', // 24-digit fallback.
+ ),
+ 'confidence' => 78,
+ 'services' => array(
+ 'classic' => 82,
+ 'express' => 85,
+ 's10' => 90,
+ ),
+ ),
+ 'PL' => array( // Poland.
+ 'patterns' => array(
+ '/^\d{14}$/',
+ '/^[A-Z]{2}\d{10}$/',
+ '/^[A-Z]{2}\d{9}[A-Z]{2}$/', // S10/UPU international.
+ '/^\d{24}$/', // 24-digit fallback.
+ ),
+ 'confidence' => 90,
+ ),
+ 'IE' => array( // Ireland.
+ 'patterns' => array(
+ '/^\d{14}$/',
+ '/^[A-Z]{2}\d{9}IE$/',
+ ),
+ 'confidence' => 85,
+ ),
+ 'AT' => array( // Austria.
+ 'patterns' => array(
+ '/^\d{14}$/',
+ '/^\d{12}$/',
+ ),
+ 'confidence' => 75, // Reduced: generic patterns.
+ ),
+ 'CH' => array( // Switzerland.
+ 'patterns' => array(
+ '/^\d{14}$/',
+ '/^[A-Z]{2}\d{9}CH$/',
+ ),
+ 'confidence' => 85,
+ ),
+ 'ES' => array( // Spain.
+ 'patterns' => array(
+ '/^\d{14}$/',
+ '/^[A-Z]{2}\d{10}$/',
+ ),
+ 'confidence' => 85,
+ ),
+ 'IT' => array( // Italy.
+ 'patterns' => array(
+ '/^\d{14}$/',
+ '/^[A-Z]{2}\d{10}$/',
+ ),
+ 'confidence' => 85,
+ ),
+ 'LU' => array( // Luxembourg.
+ 'patterns' => array(
+ '/^\d{14}$/',
+ '/^\d{12}$/',
+ ),
+ 'confidence' => 75, // Reduced: generic patterns.
+ ),
+ 'CZ' => array( // Czech Republic.
+ 'patterns' => array(
+ '/^\d{14}$/',
+ '/^[A-Z]{2}\d{10}$/',
+ ),
+ 'confidence' => 90,
+ ),
+ 'SK' => array( // Slovakia.
+ 'patterns' => array(
+ '/^\d{14}$/',
+ '/^[A-Z]{2}\d{10}$/',
+ ),
+ 'confidence' => 90,
+ ),
+ 'HU' => array( // Hungary.
+ 'patterns' => array(
+ '/^\d{14}$/',
+ '/^[A-Z]{2}\d{10}$/',
+ ),
+ 'confidence' => 90,
+ ),
+ 'SI' => array( // Slovenia.
+ 'patterns' => array(
+ '/^\d{14}$/',
+ '/^[A-Z]{2}\d{10}$/',
+ ),
+ 'confidence' => 80,
+ ),
+ 'HR' => array( // Croatia.
+ 'patterns' => array(
+ '/^\d{14}$/',
+ '/^[A-Z]{2}\d{10}$/',
+ ),
+ 'confidence' => 80,
+ ),
+ 'RO' => array( // Romania.
+ 'patterns' => array(
+ '/^\d{14}$/',
+ '/^[A-Z]{2}\d{10}$/',
+ ),
+ 'confidence' => 75,
+ ),
+ 'BG' => array( // Bulgaria.
+ 'patterns' => array(
+ '/^\d{14}$/',
+ '/^[A-Z]{2}\d{10}$/',
+ ),
+ 'confidence' => 70,
+ ),
+ 'LT' => array( // Lithuania.
+ 'patterns' => array(
+ '/^\d{14}$/',
+ '/^\d{12}$/',
+ ),
+ 'confidence' => 70, // Reduced: generic patterns, limited DPD presence.
+ ),
+ 'LV' => array( // Latvia.
+ 'patterns' => array(
+ '/^\d{14}$/',
+ '/^\d{12}$/',
+ ),
+ 'confidence' => 70, // Reduced: generic patterns, limited DPD presence.
+ ),
+ 'EE' => array( // Estonia.
+ 'patterns' => array(
+ '/^\d{14}$/',
+ '/^\d{12}$/',
+ ),
+ 'confidence' => 70, // Reduced: generic patterns, limited DPD presence.
+ ),
+ 'FI' => array( // Finland.
+ 'patterns' => array(
+ '/^\d{14}$/',
+ '/^\d{12}$/',
+ ),
+ 'confidence' => 65, // Reduced: partnership-based, not direct DPD.
+ ),
+ 'DK' => array( // Denmark.
+ 'patterns' => array(
+ '/^\d{14}$/',
+ '/^\d{12}$/',
+ ),
+ 'confidence' => 65, // Reduced: partnership-based, not direct DPD.
+ ),
+ 'SE' => array( // Sweden.
+ 'patterns' => array(
+ '/^\d{14}$/',
+ '/^\d{12}$/',
+ ),
+ 'confidence' => 65, // Reduced: partnership-based, not direct DPD.
+ ),
+ 'NO' => array( // Norway.
+ 'patterns' => array(
+ '/^\d{14}$/',
+ '/^\d{12}$/',
+ ),
+ 'confidence' => 60, // Reduced: limited DPD presence.
+ ),
+ 'GR' => array( // Greece.
+ 'patterns' => array(
+ '/^\d{14}$/',
+ '/^[A-Z]{2}\d{10}$/',
+ ),
+ 'confidence' => 85,
+ ),
+ 'PT' => array( // Portugal.
+ 'patterns' => array(
+ '/^\d{14}$/',
+ '/^[A-Z]{2}\d{10}$/',
+ ),
+ 'confidence' => 85,
+ ),
+ );
+
+ /**
+ * International shipment pattern (28 digits)
+ */
+ private const INTERNATIONAL_PATTERN = '/^\d{28}$/';
+
+ /**
+ * S10/UPU international pattern.
+ */
+ private const S10_PATTERN = '/^[A-Z]{2}\d{9}[A-Z]{2}$/';
+
+ /**
+ * Get the unique key for this shipping provider.
+ *
+ * @return string Unique key.
+ */
+ public function get_key(): string {
+ return 'dpd';
+ }
+
+ /**
+ * Get the name of this shipping provider.
+ *
+ * @return string Name of the shipping provider.
+ */
+ public function get_name(): string {
+ return 'DPD';
+ }
+
+ /**
+ * Get the icon URL for this shipping provider.
+ *
+ * @return string URL of the shipping provider icon.
+ */
+ public function get_icon(): string {
+ return esc_url( WC()->plugin_url() ) . '/assets/images/shipping_providers/dpd.png';
+ }
+
+ /**
+ * Get the description of this shipping provider.
+ *
+ * @return array Description of the shipping provider.
+ */
+ public function get_shipping_from_countries(): array {
+ return array_keys( self::TRACKING_PATTERNS );
+ }
+
+ /**
+ * Get the countries this shipping provider can ship to.
+ *
+ * DPD typically ships within Europe, so we return the same countries as shipping from.
+ *
+ * @return array List of country codes.
+ */
+ public function get_shipping_to_countries(): array {
+ return $this->get_shipping_from_countries();
+ }
+
+ /**
+ * Get the tracking URL for a given tracking number.
+ *
+ * @param string $tracking_number The tracking number to generate the URL for.
+ * @return string The tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ return 'https://www.dpd.com/tracking/' . rawurlencode( $tracking_number );
+ }
+
+ /**
+ * Validate tracking number against country-specific patterns and determine service type.
+ *
+ * @param string $tracking_number The tracking number to validate.
+ * @param string $country_code The country code for the shipment.
+ * @return array|bool Array with service info if valid, false otherwise.
+ */
+ private function validate_country_pattern( string $tracking_number, string $country_code ) {
+ if ( ! isset( self::TRACKING_PATTERNS[ $country_code ] ) ) {
+ return false;
+ }
+
+ $country_data = self::TRACKING_PATTERNS[ $country_code ];
+ $detected_service = null;
+ $confidence_boost = 0;
+
+ // Check service-specific patterns first.
+ if ( isset( $country_data['services'] ) ) {
+ if ( preg_match( '/^02\d{12}$/', $tracking_number ) ) {
+ $detected_service = 'classic';
+ $confidence_boost = $country_data['services']['classic'] ?? 0;
+ } elseif ( preg_match( '/^0[34578]\d{12}$/', $tracking_number ) ) {
+ $detected_service = 'express';
+ $confidence_boost = $country_data['services']['express'] ?? 0;
+ } elseif ( preg_match( '/^0[49]\d{12}$/', $tracking_number ) ) {
+ $detected_service = 'predict';
+ $confidence_boost = $country_data['services']['predict'] ?? 0;
+ } elseif ( preg_match( '/^03\d{12}$/', $tracking_number ) && 'GB' === $country_code ) {
+ $detected_service = 'next_day';
+ $confidence_boost = $country_data['services']['next_day'] ?? 0;
+ } elseif ( preg_match( '/^02\d{12}$/', $tracking_number ) && 'FR' === $country_code ) {
+ $detected_service = 'relais';
+ $confidence_boost = $country_data['services']['relais'] ?? 0;
+ } elseif ( preg_match( self::S10_PATTERN, $tracking_number ) ) {
+ $detected_service = 's10';
+ $confidence_boost = $country_data['services']['s10'] ?? 90;
+ }
+ }
+
+ // Check all patterns.
+ foreach ( $country_data['patterns'] as $pattern ) {
+ if ( preg_match( $pattern, $tracking_number ) ) {
+ return array(
+ 'valid' => true,
+ 'service' => $detected_service,
+ 'confidence_boost' => $confidence_boost,
+ );
+ }
+ }
+
+ return false;
+ }
+
+ /**
+ * Try to parse a DPD tracking number.
+ *
+ * @param string $tracking_number The tracking number to parse.
+ * @param string $shipping_from The country code of the shipping origin.
+ * @param string $shipping_to The country code of the shipping destination.
+ * @return array|null An array with 'url' and 'ambiguity_score' if valid, null otherwise.
+ */
+ public function try_parse_tracking_number(
+ string $tracking_number,
+ string $shipping_from,
+ string $shipping_to
+ ): ?array {
+ if ( empty( $tracking_number ) || empty( $shipping_from ) || empty( $shipping_to ) ) {
+ return null;
+ }
+
+ $normalized = strtoupper( preg_replace( '/\s+/', '', $tracking_number ) );
+ if ( empty( $normalized ) ) {
+ return null;
+ }
+
+ $shipping_from = strtoupper( $shipping_from );
+ $shipping_to = strtoupper( $shipping_to );
+
+ // 1. Check international 28-digit format first.
+ if ( preg_match( self::INTERNATIONAL_PATTERN, $normalized ) ) {
+ if ( in_array( $shipping_from, $this->get_shipping_from_countries(), true ) &&
+ in_array( $shipping_to, $this->get_shipping_to_countries(), true ) ) {
+ return array(
+ 'url' => $this->get_tracking_url( $normalized ),
+ 'ambiguity_score' => 95,
+ );
+ }
+ return null;
+ }
+
+ // 2. Check S10/UPU format (international DPD).
+ if ( preg_match( self::S10_PATTERN, $normalized ) ) {
+ return array(
+ 'url' => $this->get_tracking_url( $normalized ),
+ 'ambiguity_score' => 90,
+ );
+ }
+
+ // 3. Check country-specific patterns.
+ $validation_result = $this->validate_country_pattern( $normalized, $shipping_from );
+ if ( $validation_result && is_array( $validation_result ) ) {
+ $confidence = self::TRACKING_PATTERNS[ $shipping_from ]['confidence'];
+
+ // Apply service-specific confidence boost.
+ if ( $validation_result['confidence_boost'] > 0 ) {
+ $confidence = min( 95, $validation_result['confidence_boost'] );
+ }
+
+ // Boost confidence for intra-DPD shipments.
+ if ( in_array( $shipping_to, $this->get_shipping_to_countries(), true ) ) {
+ $confidence = min( 98, $confidence + 3 );
+ }
+
+ // Additional boost for express services.
+ if ( 'express' === $validation_result['service'] ) {
+ $confidence = min( 98, $confidence + 2 );
+ }
+
+ return array(
+ 'url' => $this->get_tracking_url( $normalized ),
+ 'ambiguity_score' => $confidence,
+ );
+ }
+
+ // 4. Fallback: 12–24 digit numeric.
+ if ( preg_match( '/^\d{12,24}$/', $normalized ) ) {
+ return array(
+ 'url' => $this->get_tracking_url( $normalized ),
+ 'ambiguity_score' => 60,
+ );
+ }
+
+ return null;
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/DeutschePostShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/DeutschePostShippingProvider.php
new file mode 100644
index 0000000000..81aed32788
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/DeutschePostShippingProvider.php
@@ -0,0 +1,45 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+/**
+ * Deutsche Post Shipping Provider class.
+ */
+class DeutschePostShippingProvider extends AbstractShippingProvider {
+ /**
+ * Get the key of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_key(): string {
+ return 'deutsche-post';
+ }
+
+ /**
+ * Get the name of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_name(): string {
+ return 'Deutsche Post';
+ }
+
+ /**
+ * Get the icon of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_icon(): string {
+ return esc_url( WC()->plugin_url() ) . '/assets/images/shipping_providers/deutsche-post.png';
+ }
+
+ /**
+ * Get the tracking URL for a given tracking number.
+ *
+ * @param string $tracking_number The tracking number.
+ * @return string The tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ return 'https://www.deutschepost.de/sendung/simpleQuery.html?piececode=' . $tracking_number;
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/ELTAShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/ELTAShippingProvider.php
new file mode 100644
index 0000000000..d699f143bf
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/ELTAShippingProvider.php
@@ -0,0 +1,45 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+/**
+ * ELTA Shipping Provider class.
+ */
+class ELTAShippingProvider extends AbstractShippingProvider {
+ /**
+ * Get the key of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_key(): string {
+ return 'elta';
+ }
+
+ /**
+ * Get the name of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_name(): string {
+ return 'ELTA';
+ }
+
+ /**
+ * Get the icon of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_icon(): string {
+ return esc_url( WC()->plugin_url() ) . '/assets/images/shipping_providers/elta.png';
+ }
+
+ /**
+ * Get the tracking URL for a given tracking number.
+ *
+ * @param string $tracking_number The tracking number.
+ * @return string The tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ return 'https://elta.gr/en/track/' . $tracking_number;
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/EcontShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/EcontShippingProvider.php
new file mode 100644
index 0000000000..ebae158f5a
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/EcontShippingProvider.php
@@ -0,0 +1,45 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+/**
+ * Econt Shipping Provider class.
+ */
+class EcontShippingProvider extends AbstractShippingProvider {
+ /**
+ * Get the key of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_key(): string {
+ return 'econt';
+ }
+
+ /**
+ * Get the name of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_name(): string {
+ return 'Econt';
+ }
+
+ /**
+ * Get the icon of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_icon(): string {
+ return esc_url( WC()->plugin_url() ) . '/assets/images/shipping_providers/econt.png';
+ }
+
+ /**
+ * Get the tracking URL for a given tracking number.
+ *
+ * @param string $tracking_number The tracking number.
+ * @return string The tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ return 'https://www.econt.com/en/track/' . $tracking_number;
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/EimskipShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/EimskipShippingProvider.php
new file mode 100644
index 0000000000..7c5f4d87b5
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/EimskipShippingProvider.php
@@ -0,0 +1,45 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+/**
+ * Eimskip Shipping Provider class.
+ */
+class EimskipShippingProvider extends AbstractShippingProvider {
+ /**
+ * Get the key of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_key(): string {
+ return 'eimskip';
+ }
+
+ /**
+ * Get the name of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_name(): string {
+ return 'Eimskip';
+ }
+
+ /**
+ * Get the icon of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_icon(): string {
+ return esc_url( WC()->plugin_url() ) . '/assets/images/shipping_providers/eimskip.png';
+ }
+
+ /**
+ * Get the tracking URL for a given tracking number.
+ *
+ * @param string $tracking_number The tracking number.
+ * @return string The tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ return 'https://www.eimskip.is/track/' . $tracking_number;
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/EvriHermesShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/EvriHermesShippingProvider.php
new file mode 100644
index 0000000000..5a283b3092
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/EvriHermesShippingProvider.php
@@ -0,0 +1,159 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+/**
+ * Evri (Hermes) Shipping Provider class.
+ *
+ * Provides Evri tracking number validation, supported countries, and tracking URL generation.
+ */
+class EvriHermesShippingProvider extends AbstractShippingProvider {
+
+ /**
+ * Main Evri/Hermes tracking number patterns.
+ */
+ private const MAIN_PATTERNS = array(
+ '/^\d{16}$/', // 16-digit numeric (official Evri/Hermes format).
+ '/^[A-Z]{1,2}\d{14,15}$/', // H, E, HM, EV, HH, MH + 14-15 digits (legacy/retail).
+ '/^MH\d{16}$/', // MH + 16 digits (Hermes Germany legacy)[3].
+ '/^(?:[A-Z]\d{2}[A-Z0-9]{13}|\d{16})$/', // Newer Evri format.
+ );
+
+ /**
+ * Calling card pattern.
+ */
+ private const CALLING_CARD_PATTERN = '/^\d{8}$/'; // 8-digit calling card number[1][5].
+
+ /**
+ * Legacy and fallback patterns.
+ */
+ private const LEGACY_PATTERNS = array(
+ '/^\d{13,15}$/', // 13-15 digit numeric (rare, legacy).
+ );
+
+ /**
+ * Get the unique key for this shipping provider.
+ *
+ * @return string Unique key.
+ */
+ public function get_key(): string {
+ return 'evri-hermes';
+ }
+
+ /**
+ * Get the name of this shipping provider.
+ *
+ * @return string Name of the shipping provider.
+ */
+ public function get_name(): string {
+ return 'Evri (Hermes)';
+ }
+
+ /**
+ * Get the icon URL for this shipping provider.
+ *
+ * @return string URL of the shipping provider icon.
+ */
+ public function get_icon(): string {
+ return esc_url( WC()->plugin_url() ) . '/assets/images/shipping_providers/evri-hermes.png';
+ }
+
+ /**
+ * Get the countries this shipping provider can ship from.
+ *
+ * @return array List of country codes.
+ */
+ public function get_shipping_from_countries(): array {
+ // Evri (formerly Hermes UK) primarily operates from the UK only.
+ return array( 'GB' );
+ }
+
+ /**
+ * Get the countries this shipping provider can ship to.
+ *
+ * @return array List of country codes.
+ */
+ public function get_shipping_to_countries(): array {
+ // Evri ships from UK to these exact destinations as listed on their website dropdown.
+ // This list is based on the actual options in their destination choice select.
+ return array( 'GB', 'AL', 'DZ', 'AS', 'AD', 'AO', 'AI', 'AG', 'AR', 'AM', 'AW', 'AU', 'AT', 'AZ', 'PT', 'BS', 'BH', 'ES', 'BD', 'BB', 'BE', 'BZ', 'BJ', 'BM', 'BT', 'BO', 'BQ', 'BA', 'BA', 'BW', 'BR', 'VG', 'BN', 'BG', 'BF', 'BI', 'KH', 'CM', 'CA', 'ES', 'CV', 'KY', 'CF', 'TD', 'JE', 'CL', 'CN', 'CO', 'KM', 'CG', 'CK', 'CR', 'GR', 'HR', 'CW', 'CY', 'CZ', 'CD', 'DK', 'DJ', 'DM', 'DO', 'TL', 'EC', 'EG', 'SV', 'GQ', 'ER', 'EE', 'SZ', 'ET', 'FK', 'FO', 'FJ', 'FI', 'FR', 'GF', 'PF', 'GA', 'GM', 'GE', 'DE', 'GI', 'GR', 'GL', 'GD', 'GP', 'GU', 'GT', 'GG', 'GN', 'GW', 'GY', 'HT', 'HN', 'HK', 'HU', 'ES', 'IS', 'IN', 'ID', 'IQ', 'IE', 'IL', 'IT', 'JM', 'JP', 'JE', 'JO', 'KZ', 'KE', 'KI', 'KW', 'LA', 'LV', 'LB', 'LS', 'LR', 'LY', 'LI', 'LT', 'LU', 'MO', 'MG', 'ES', 'MW', 'MY', 'MV', 'ML', 'MT', 'MH', 'MQ', 'MR', 'MU', 'YT', 'ES', 'MX', 'FM', 'MD', 'MC', 'MN', 'ME', 'MS', 'MA', 'MZ', 'NA', 'NR', 'NP', 'NL', 'AN', 'NC', 'NZ', 'NI', 'NE', 'MK', 'GB', 'NO', 'OM', 'PK', 'PW', 'PS', 'PA', 'PG', 'PY', 'PE', 'PH', 'PL', 'PT', 'PR', 'QA', 'RE', 'RO', 'RW', 'MP', 'WS', 'SM', 'SA', 'SN', 'RS', 'SC', 'SL', 'SG', 'SK', 'SI', 'SB', 'KR', 'ES', 'LK', 'BL', 'BQ', 'KN', 'LC', 'SX', 'VC', 'SR', 'SE', 'CH', 'TW', 'TJ', 'TZ', 'TH', 'TG', 'TO', 'TT', 'TN', 'TR', 'TM', 'TC', 'TV', 'UG', 'GB', 'UA', 'AE', 'UY', 'US', 'UZ', 'VU', 'VA', 'VN', 'VI', 'WF', 'YE', 'ZM', 'ZW' );
+ }
+
+ /**
+ * Get the tracking URL for a given tracking number.
+ *
+ * @param string $tracking_number The tracking number to generate the URL for.
+ * @return string The tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ return 'https://www.evri.com/track/' . rawurlencode( $tracking_number );
+ }
+
+ /**
+ * Try to parse an Evri tracking number.
+ *
+ * @param string $tracking_number The tracking number to parse.
+ * @param string $shipping_from The country code of the shipping origin.
+ * @param string $shipping_to The country code of the shipping destination.
+ * @return array|null An array with 'url' and 'ambiguity_score' if valid, null otherwise.
+ */
+ public function try_parse_tracking_number(
+ string $tracking_number,
+ string $shipping_from,
+ string $shipping_to
+ ): ?array {
+ if ( empty( $tracking_number ) || empty( $shipping_from ) || empty( $shipping_to ) ) {
+ return null;
+ }
+
+ // Check if this provider can handle this shipping route.
+ if ( ! $this->can_ship_from_to( $shipping_from, $shipping_to ) ) {
+ return null;
+ }
+
+ $normalized = strtoupper( preg_replace( '/\s+/', '', $tracking_number ) );
+ if ( empty( $normalized ) ) {
+ return null;
+ }
+
+ // 1. Check for main 16-digit and legacy Evri/Hermes formats.
+ foreach ( self::MAIN_PATTERNS as $pattern ) {
+ if ( preg_match( $pattern, $normalized ) ) {
+ $confidence = 90;
+ // Boost for UK shipments.
+ if ( 'GB' === $shipping_from ) {
+ $confidence = min( 98, $confidence + 2 );
+ }
+ return array(
+ 'url' => $this->get_tracking_url( $normalized ),
+ 'ambiguity_score' => $confidence,
+ );
+ }
+ }
+
+ // 2. Check for 8-digit calling card number.
+ if ( preg_match( self::CALLING_CARD_PATTERN, $normalized ) ) {
+ return array(
+ 'url' => $this->get_tracking_url( $normalized ),
+ 'ambiguity_score' => 80,
+ );
+ }
+
+ // 3. Check for legacy/fallback patterns (lower confidence).
+ foreach ( self::LEGACY_PATTERNS as $pattern ) {
+ if ( preg_match( $pattern, $normalized ) ) {
+ $confidence = 75;
+ // Boost for UK shipments.
+ if ( 'GB' === $shipping_from ) {
+ $confidence = min( 95, $confidence + 15 );
+ }
+ return array(
+ 'url' => $this->get_tracking_url( $normalized ),
+ 'ambiguity_score' => $confidence,
+ );
+ }
+ }
+
+ return null;
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/FanCourierShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/FanCourierShippingProvider.php
new file mode 100644
index 0000000000..acca0ad235
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/FanCourierShippingProvider.php
@@ -0,0 +1,45 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+/**
+ * Fan Courier Shipping Provider class.
+ */
+class FanCourierShippingProvider extends AbstractShippingProvider {
+ /**
+ * Get the key of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_key(): string {
+ return 'fan-courier';
+ }
+
+ /**
+ * Get the name of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_name(): string {
+ return 'Fan Courier';
+ }
+
+ /**
+ * Get the icon of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_icon(): string {
+ return esc_url( WC()->plugin_url() ) . '/assets/images/shipping_providers/fan-courier.png';
+ }
+
+ /**
+ * Get the tracking URL for a given tracking number.
+ *
+ * @param string $tracking_number The tracking number.
+ * @return string The tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ return 'https://www.fancourier.ro/urmarire/' . $tracking_number;
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/FastwayShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/FastwayShippingProvider.php
new file mode 100644
index 0000000000..686c6eff13
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/FastwayShippingProvider.php
@@ -0,0 +1,45 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+/**
+ * Fastway Shipping Provider class.
+ */
+class FastwayShippingProvider extends AbstractShippingProvider {
+ /**
+ * Get the key of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_key(): string {
+ return 'fastway';
+ }
+
+ /**
+ * Get the name of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_name(): string {
+ return 'Fastway';
+ }
+
+ /**
+ * Get the icon of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_icon(): string {
+ return esc_url( WC()->plugin_url() ) . '/assets/images/shipping_providers/fastway.png';
+ }
+
+ /**
+ * Get the tracking URL for a given tracking number.
+ *
+ * @param string $tracking_number The tracking number.
+ * @return string The tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ return 'https://www.fastway.ie/track/' . $tracking_number;
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/FedExShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/FedExShippingProvider.php
new file mode 100644
index 0000000000..8ba53e0f05
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/FedExShippingProvider.php
@@ -0,0 +1,189 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+use Automattic\WooCommerce\Internal\Fulfillments\FulfillmentUtils;
+
+/**
+ * FedEx Shipping Provider implementation.
+ *
+ * Handles FedEx tracking number detection and validation for all FedEx services.
+ */
+class FedExShippingProvider extends AbstractShippingProvider {
+ /**
+ * List of countries where FedEx has significant operations.
+ *
+ * @var array<string>
+ */
+ private array $supported_countries = array( 'US', 'CA', 'GB', 'DE', 'FR', 'AU', 'JP', 'MX', 'CN', 'IN', 'IT', 'ES', 'NL', 'BE', 'CH', 'AT', 'BR', 'SG' );
+
+ /**
+ * Gets the unique provider key.
+ *
+ * @return string The provider key 'fedex'.
+ */
+ public function get_key(): string {
+ return 'fedex';
+ }
+
+ /**
+ * Gets the display name of the provider.
+ *
+ * @return string The provider name 'FedEx'.
+ */
+ public function get_name(): string {
+ return 'FedEx';
+ }
+
+ /**
+ * Gets the path to the provider's icon.
+ *
+ * @return string URL to the FedEx logo image.
+ */
+ public function get_icon(): string {
+ return esc_url( WC()->plugin_url() ) . '/assets/images/shipping_providers/fedex.png';
+ }
+
+ /**
+ * Generates the tracking URL for a given tracking number.
+ *
+ * @param string $tracking_number The tracking number to generate URL for.
+ * @return string The complete tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ return 'https://www.fedex.com/fedextrack/?tracknumbers=' . rawurlencode( $tracking_number );
+ }
+
+ /**
+ * Gets the list of origin countries supported by FedEx.
+ *
+ * @return array<string> Array of country codes.
+ */
+ public function get_shipping_from_countries(): array {
+ return $this->supported_countries;
+ }
+
+ /**
+ * Gets the list of destination countries supported by FedEx.
+ *
+ * @return array<string> Array of country codes.
+ */
+ public function get_shipping_to_countries(): array {
+ return $this->supported_countries;
+ }
+
+ /**
+ * Checks if FedEx can ship between two countries.
+ *
+ * @param string $shipping_from Origin country code.
+ * @param string $shipping_to Destination country code.
+ * @return bool True if shipping route is supported.
+ */
+ public function can_ship_from_to( string $shipping_from, string $shipping_to ): bool {
+ return in_array( $shipping_from, $this->supported_countries, true ) &&
+ in_array( $shipping_to, $this->supported_countries, true );
+ }
+
+ /**
+ * Validates and parses a FedEx tracking number.
+ *
+ * @param string $tracking_number The tracking number to validate.
+ * @param string $shipping_from Origin country code.
+ * @param string $shipping_to Destination country code.
+ * @return array|null Array with tracking URL and score, or null if invalid.
+ */
+ public function try_parse_tracking_number( string $tracking_number, string $shipping_from, string $shipping_to ): ?array {
+ if ( empty( $tracking_number ) || ! $this->can_ship_from_to( $shipping_from, $shipping_to ) ) {
+ return null;
+ }
+
+ $tracking_number = strtoupper( preg_replace( '/\s+/', '', $tracking_number ) ); // Remove spaces and uppercase for consistency.
+ $is_north_america = in_array( $shipping_from, array( 'US', 'CA' ), true ); // North America flag for scoring.
+ $is_us_domestic = 'US' === $shipping_from && 'US' === $shipping_to; // US domestic flag for scoring.
+
+ // FedEx tracking number patterns with enhanced validation and comments.
+ $patterns = array(
+ // FedEx Door Tag: DT + 12 digits (US/CA only).
+ '/^DT\d{12}$/' => $is_north_america ? 90 : 0,
+
+ // FedEx Custom Critical: 0 or 1 followed by 13-23 digits (very rare, highest confidence).
+ '/^0[01]\d{13,23}$/' => 98,
+
+ // FedEx SmartPost: 023 + 17 digits (US only, SmartPost).
+ '/^023\d{17}$/' => 97,
+
+ // FedEx SmartPost: 58 + 17-19 digits (older SmartPost).
+ '/^58\d{17,19}$/' => 96,
+
+ // FedEx Express: 12 digits (most common, with check digit validation).
+ '/^\d{12}$/' => function () use ( $tracking_number, $is_north_america, $is_us_domestic ) {
+ if ( FulfillmentUtils::validate_fedex_check_digit( $tracking_number ) ) {
+ return $is_north_america || $is_us_domestic ? 98 : 85; // High confidence if check digit valid.
+ }
+ return $is_north_america ? ( $is_us_domestic ? 98 : 85 ) : 70; // Lower if check digit invalid.
+ },
+
+ // FedEx Express: 15 digits (less common, with check digit validation).
+ '/^\d{15}$/' => function () use ( $tracking_number, $is_north_america ) {
+ if ( FulfillmentUtils::validate_fedex_check_digit( $tracking_number ) ) {
+ return $is_north_america ? 96 : 80; // High confidence if check digit valid.
+ }
+ return $is_north_america ? 80 : 65; // Lower if check digit invalid.
+ },
+
+ // FedEx Express: 14 digits (with check digit validation).
+ '/^\d{14}$/' => function () use ( $tracking_number, $is_north_america ) {
+ if ( FulfillmentUtils::validate_fedex_check_digit( $tracking_number ) ) {
+ return $is_north_america ? 95 : 78; // High confidence if check digit valid.
+ }
+ return $is_north_america ? 78 : 60; // Lower if check digit invalid.
+ },
+
+ // FedEx Express: 34 digits (rare, international bulk shipments).
+ '/^\d{34}$/' => 90,
+
+ // FedEx Ground: 96 + 18-20 digits (US/CA only).
+ '/^96\d{18,20}$/' => $is_north_america ? 95 : 60,
+
+ // FedEx Ground: 7 + 11-20 digits (US/CA only, legacy).
+ '/^7\d{11,20}$/' => $is_north_america ? 90 : 75,
+
+ // FedEx Freight: 97 + 13-23 digits (Freight/LTL).
+ '/^97\d{13,23}$/' => 93,
+
+ // FedEx Express International: 3 + 10-14 digits (Europe/Asia).
+ '/^3\d{10,14}$/' => 92,
+
+ // FedEx International Priority: 8 + 8-14 digits (Europe/Asia).
+ '/^8\d{8,14}$/' => function () use ( $shipping_from ) {
+ return in_array( $shipping_from, array( 'GB', 'DE', 'FR', 'IT', 'ES', 'NL' ), true ) ? 93 : 75;
+ },
+
+ // FedEx Express Next Flight Out: NFO + 10-15 digits.
+ '/^NFO\d{10,15}$/' => 92,
+
+ // FedEx SameDay: SD + 10-15 digits.
+ '/^SD\d{10,15}$/' => 90,
+
+ // Fallback: 20 digit numeric (used by some international and legacy services).
+ '/^\d{20}$/' => 70,
+
+ // Fallback: 22 digit numeric (rare, legacy).
+ '/^\d{22}$/' => 65,
+ );
+
+ foreach ( $patterns as $pattern => $base_score ) {
+ if ( preg_match( $pattern, $tracking_number ) ) {
+ $score = is_callable( $base_score ) ? $base_score() : $base_score;
+ if ( $score > 0 ) {
+ return array(
+ 'url' => $this->get_tracking_url( $tracking_number ),
+ 'ambiguity_score' => $score,
+ );
+ }
+ }
+ }
+
+ return null; // No matching pattern found.
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/GLSShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/GLSShippingProvider.php
new file mode 100644
index 0000000000..ab083995cf
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/GLSShippingProvider.php
@@ -0,0 +1,45 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+/**
+ * GLS Shipping Provider class.
+ */
+class GLSShippingProvider extends AbstractShippingProvider {
+ /**
+ * Get the key of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_key(): string {
+ return 'gls';
+ }
+
+ /**
+ * Get the name of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_name(): string {
+ return 'GLS';
+ }
+
+ /**
+ * Get the icon of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_icon(): string {
+ return esc_url( WC()->plugin_url() ) . '/assets/images/shipping_providers/gls.png';
+ }
+
+ /**
+ * Get the tracking URL for a given tracking number.
+ *
+ * @param string $tracking_number The tracking number.
+ * @return string The tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ return 'https://gls-group.eu/EU/en/parcel-tracking/' . $tracking_number;
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/GenikiTaxydromikiShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/GenikiTaxydromikiShippingProvider.php
new file mode 100644
index 0000000000..bbe6b7589d
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/GenikiTaxydromikiShippingProvider.php
@@ -0,0 +1,45 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+/**
+ * Geniki Taxydromiki Shipping Provider class.
+ */
+class GenikiTaxydromikiShippingProvider extends AbstractShippingProvider {
+ /**
+ * Get the key of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_key(): string {
+ return 'geniki-taxydromiki';
+ }
+
+ /**
+ * Get the name of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_name(): string {
+ return 'Geniki Taxydromiki';
+ }
+
+ /**
+ * Get the icon of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_icon(): string {
+ return esc_url( WC()->plugin_url() ) . '/assets/images/shipping_providers/geniki-taxydromiki.png';
+ }
+
+ /**
+ * Get the tracking URL for a given tracking number.
+ *
+ * @param string $tracking_number The tracking number.
+ * @return string The tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ return 'https://www.taxydromiki.com.gr/track/' . $tracking_number;
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/HayPostShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/HayPostShippingProvider.php
new file mode 100644
index 0000000000..82d3eadc0a
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/HayPostShippingProvider.php
@@ -0,0 +1,45 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+/**
+ * HayPost Shipping Provider class.
+ */
+class HayPostShippingProvider extends AbstractShippingProvider {
+ /**
+ * Get the key of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_key(): string {
+ return 'haypost';
+ }
+
+ /**
+ * Get the name of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_name(): string {
+ return 'HayPost';
+ }
+
+ /**
+ * Get the icon of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_icon(): string {
+ return esc_url( WC()->plugin_url() ) . '/assets/images/shipping_providers/haypost.png';
+ }
+
+ /**
+ * Get the tracking URL for a given tracking number.
+ *
+ * @param string $tracking_number The tracking number.
+ * @return string The tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ return 'https://www.haypost.am/en/track/' . $tracking_number;
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/HelthjemShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/HelthjemShippingProvider.php
new file mode 100644
index 0000000000..61d8498d32
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/HelthjemShippingProvider.php
@@ -0,0 +1,45 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+/**
+ * Helthjem Shipping Provider class.
+ */
+class HelthjemShippingProvider extends AbstractShippingProvider {
+ /**
+ * Get the key of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_key(): string {
+ return 'helthjem';
+ }
+
+ /**
+ * Get the name of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_name(): string {
+ return 'Helthjem';
+ }
+
+ /**
+ * Get the icon of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_icon(): string {
+ return esc_url( WC()->plugin_url() ) . '/assets/images/shipping_providers/helthjem.png';
+ }
+
+ /**
+ * Get the tracking URL for a given tracking number.
+ *
+ * @param string $tracking_number The tracking number.
+ * @return string The tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ return 'https://www.helthjem.no/sporing/' . $tracking_number;
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/HrvatskaPostaShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/HrvatskaPostaShippingProvider.php
new file mode 100644
index 0000000000..a0d0ad0e5e
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/HrvatskaPostaShippingProvider.php
@@ -0,0 +1,45 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+/**
+ * Hrvatska Posta Shipping Provider class.
+ */
+class HrvatskaPostaShippingProvider extends AbstractShippingProvider {
+ /**
+ * Get the key of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_key(): string {
+ return 'hrvatska-posta';
+ }
+
+ /**
+ * Get the name of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_name(): string {
+ return 'Hrvatska Pošta';
+ }
+
+ /**
+ * Get the icon of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_icon(): string {
+ return esc_url( WC()->plugin_url() ) . '/assets/images/shipping_providers/hrvatska-posta.png';
+ }
+
+ /**
+ * Get the tracking URL for a given tracking number.
+ *
+ * @param string $tracking_number The tracking number.
+ * @return string The tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ return 'https://www.posta.hr/track/' . $tracking_number;
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/InPostShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/InPostShippingProvider.php
new file mode 100644
index 0000000000..73dd3c5d9a
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/InPostShippingProvider.php
@@ -0,0 +1,45 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+/**
+ * InPost Shipping Provider class.
+ */
+class InPostShippingProvider extends AbstractShippingProvider {
+ /**
+ * Get the key of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_key(): string {
+ return 'inpost';
+ }
+
+ /**
+ * Get the name of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_name(): string {
+ return 'InPost';
+ }
+
+ /**
+ * Get the icon of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_icon(): string {
+ return esc_url( WC()->plugin_url() ) . '/assets/images/shipping_providers/inpost.png';
+ }
+
+ /**
+ * Get the tracking URL for a given tracking number.
+ *
+ * @param string $tracking_number The tracking number.
+ * @return string The tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ return 'https://inpost.pl/sledzenie-przesylek/' . $tracking_number;
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/IslandsposturShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/IslandsposturShippingProvider.php
new file mode 100644
index 0000000000..452018b641
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/IslandsposturShippingProvider.php
@@ -0,0 +1,45 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+/**
+ * Islandspostur Shipping Provider class.
+ */
+class IslandsposturShippingProvider extends AbstractShippingProvider {
+ /**
+ * Get the key of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_key(): string {
+ return 'islandspostur';
+ }
+
+ /**
+ * Get the name of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_name(): string {
+ return 'Íslandspóstur';
+ }
+
+ /**
+ * Get the icon of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_icon(): string {
+ return esc_url( WC()->plugin_url() ) . '/assets/images/shipping_providers/islandspostur.png';
+ }
+
+ /**
+ * Get the tracking URL for a given tracking number.
+ *
+ * @param string $tracking_number The tracking number.
+ * @return string The tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ return 'https://www.islandspostur.is/umsoknir-og-umsoknir/umsoknir/umsoknir-um-sendingar/sendingar/' . $tracking_number;
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/ItellaShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/ItellaShippingProvider.php
new file mode 100644
index 0000000000..97aadecaca
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/ItellaShippingProvider.php
@@ -0,0 +1,45 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+/**
+ * Itella Shipping Provider class.
+ */
+class ItellaShippingProvider extends AbstractShippingProvider {
+ /**
+ * Get the key of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_key(): string {
+ return 'itella';
+ }
+
+ /**
+ * Get the name of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_name(): string {
+ return 'Smartposti (Itella)';
+ }
+
+ /**
+ * Get the icon of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_icon(): string {
+ return esc_url( WC()->plugin_url() ) . '/assets/images/shipping_providers/itella.png';
+ }
+
+ /**
+ * Get the tracking URL for a given tracking number.
+ *
+ * @param string $tracking_number The tracking number.
+ * @return string The tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ return 'https://www.smartposti.fi/track/' . $tracking_number;
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/KazpostShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/KazpostShippingProvider.php
new file mode 100644
index 0000000000..8a4a19d4b2
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/KazpostShippingProvider.php
@@ -0,0 +1,45 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+/**
+ * Kazpost Shipping Provider class.
+ */
+class KazpostShippingProvider extends AbstractShippingProvider {
+ /**
+ * Get the key of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_key(): string {
+ return 'kazpost';
+ }
+
+ /**
+ * Get the name of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_name(): string {
+ return 'Kazpost';
+ }
+
+ /**
+ * Get the icon of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_icon(): string {
+ return esc_url( WC()->plugin_url() ) . '/assets/images/shipping_providers/kazpost.png';
+ }
+
+ /**
+ * Get the tracking URL for a given tracking number.
+ *
+ * @param string $tracking_number The tracking number.
+ * @return string The tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ return 'https://www.kazpost.kz/track/' . $tracking_number;
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/LaPosteColissimoShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/LaPosteColissimoShippingProvider.php
new file mode 100644
index 0000000000..29c5ec7328
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/LaPosteColissimoShippingProvider.php
@@ -0,0 +1,45 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+/**
+ * La Poste / Colissimo Shipping Provider class.
+ */
+class LaPosteColissimoShippingProvider extends AbstractShippingProvider {
+ /**
+ * Get the key of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_key(): string {
+ return 'la-poste-colissimo';
+ }
+
+ /**
+ * Get the name of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_name(): string {
+ return 'La Poste / Colissimo';
+ }
+
+ /**
+ * Get the icon of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_icon(): string {
+ return esc_url( WC()->plugin_url() ) . '/assets/images/shipping_providers/la-poste-colissimo.png';
+ }
+
+ /**
+ * Get the tracking URL for a given tracking number.
+ *
+ * @param string $tracking_number The tracking number.
+ * @return string The tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ return 'https://www.laposte.fr/outils/suivre-vos-envois?code=' . $tracking_number;
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/LasershipOntracShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/LasershipOntracShippingProvider.php
new file mode 100644
index 0000000000..6d807e0673
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/LasershipOntracShippingProvider.php
@@ -0,0 +1,45 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+/**
+ * Lasership/OnTrac Shipping Provider class.
+ */
+class LasershipOntracShippingProvider extends AbstractShippingProvider {
+ /**
+ * Get the key of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_key(): string {
+ return 'lasership-ontrac';
+ }
+
+ /**
+ * Get the name of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_name(): string {
+ return 'LaserShip/OnTrac';
+ }
+
+ /**
+ * Get the icon of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_icon(): string {
+ return esc_url( WC()->plugin_url() ) . '/assets/images/shipping_providers/lasership-ontrac.png';
+ }
+
+ /**
+ * Get the tracking URL for a given tracking number.
+ *
+ * @param string $tracking_number The tracking number.
+ * @return string The tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ return 'https://www.lasership.com/track/' . $tracking_number;
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/LatvijasPastsShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/LatvijasPastsShippingProvider.php
new file mode 100644
index 0000000000..963126d6cf
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/LatvijasPastsShippingProvider.php
@@ -0,0 +1,45 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+/**
+ * Latvijas Pasts Shipping Provider class.
+ */
+class LatvijasPastsShippingProvider extends AbstractShippingProvider {
+ /**
+ * Get the key of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_key(): string {
+ return 'latvijas-pasts';
+ }
+
+ /**
+ * Get the name of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_name(): string {
+ return 'Latvijas Pasts';
+ }
+
+ /**
+ * Get the icon of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_icon(): string {
+ return esc_url( WC()->plugin_url() ) . '/assets/images/shipping_providers/latvijas-pasts.png';
+ }
+
+ /**
+ * Get the tracking URL for a given tracking number.
+ *
+ * @param string $tracking_number The tracking number.
+ * @return string The tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ return 'https://www.pasts.lv/en/track/' . $tracking_number;
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/LiechtensteinischePostShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/LiechtensteinischePostShippingProvider.php
new file mode 100644
index 0000000000..878d59932e
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/LiechtensteinischePostShippingProvider.php
@@ -0,0 +1,45 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+/**
+ * Liechtensteinische Post Shipping Provider class.
+ */
+class LiechtensteinischePostShippingProvider extends AbstractShippingProvider {
+ /**
+ * Get the key of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_key(): string {
+ return 'liechtensteinische-post';
+ }
+
+ /**
+ * Get the name of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_name(): string {
+ return 'Liechtensteinische Post';
+ }
+
+ /**
+ * Get the icon of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_icon(): string {
+ return esc_url( WC()->plugin_url() ) . '/assets/images/shipping_providers/liechtensteinische-post.png';
+ }
+
+ /**
+ * Get the tracking URL for a given tracking number.
+ *
+ * @param string $tracking_number The tracking number.
+ * @return string The tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ return 'https://www.post.li/en/track/' . $tracking_number;
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/MPLShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/MPLShippingProvider.php
new file mode 100644
index 0000000000..6c3b3fd826
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/MPLShippingProvider.php
@@ -0,0 +1,45 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+/**
+ * MPL Shipping Provider class.
+ */
+class MPLShippingProvider extends AbstractShippingProvider {
+ /**
+ * Get the key of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_key(): string {
+ return 'mpl';
+ }
+
+ /**
+ * Get the name of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_name(): string {
+ return 'MPL';
+ }
+
+ /**
+ * Get the icon of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_icon(): string {
+ return esc_url( WC()->plugin_url() ) . '/assets/images/shipping_providers/mpl.png';
+ }
+
+ /**
+ * Get the tracking URL for a given tracking number.
+ *
+ * @param string $tracking_number The tracking number.
+ * @return string The tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ return 'https://www.mpl.com.mt/track/' . $tracking_number;
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/MRWShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/MRWShippingProvider.php
new file mode 100644
index 0000000000..7f79ff9761
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/MRWShippingProvider.php
@@ -0,0 +1,45 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+/**
+ * MRW Shipping Provider class.
+ */
+class MRWShippingProvider extends AbstractShippingProvider {
+ /**
+ * Get the key of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_key(): string {
+ return 'mrw';
+ }
+
+ /**
+ * Get the name of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_name(): string {
+ return 'MRW';
+ }
+
+ /**
+ * Get the icon of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_icon(): string {
+ return esc_url( WC()->plugin_url() ) . '/assets/images/shipping_providers/mrw.png';
+ }
+
+ /**
+ * Get the tracking URL for a given tracking number.
+ *
+ * @param string $tracking_number The tracking number.
+ * @return string The tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ return 'https://www.mrw.es/seguimiento/' . $tracking_number;
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/MagyarPostaShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/MagyarPostaShippingProvider.php
new file mode 100644
index 0000000000..a7429ecbd7
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/MagyarPostaShippingProvider.php
@@ -0,0 +1,45 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+/**
+ * Magyar Posta Shipping Provider class.
+ */
+class MagyarPostaShippingProvider extends AbstractShippingProvider {
+ /**
+ * Get the key of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_key(): string {
+ return 'magyar-posta';
+ }
+
+ /**
+ * Get the name of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_name(): string {
+ return 'Magyar Posta';
+ }
+
+ /**
+ * Get the icon of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_icon(): string {
+ return esc_url( WC()->plugin_url() ) . '/assets/images/shipping_providers/magyar-posta.png';
+ }
+
+ /**
+ * Get the tracking URL for a given tracking number.
+ *
+ * @param string $tracking_number The tracking number.
+ * @return string The tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ return 'https://posta.hu/track/' . $tracking_number;
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/MakedonskaPostaShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/MakedonskaPostaShippingProvider.php
new file mode 100644
index 0000000000..0afc8f0477
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/MakedonskaPostaShippingProvider.php
@@ -0,0 +1,45 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+/**
+ * Makedonska Posta Shipping Provider class.
+ */
+class MakedonskaPostaShippingProvider extends AbstractShippingProvider {
+ /**
+ * Get the key of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_key(): string {
+ return 'makedonska-posta';
+ }
+
+ /**
+ * Get the name of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_name(): string {
+ return 'Makedonska Pošta';
+ }
+
+ /**
+ * Get the icon of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_icon(): string {
+ return esc_url( WC()->plugin_url() ) . '/assets/images/shipping_providers/makedonska-posta.png';
+ }
+
+ /**
+ * Get the tracking URL for a given tracking number.
+ *
+ * @param string $tracking_number The tracking number.
+ * @return string The tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ return 'https://www.posta.gov.mk/track/' . $tracking_number;
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/MaltaPostShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/MaltaPostShippingProvider.php
new file mode 100644
index 0000000000..f6733e96d8
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/MaltaPostShippingProvider.php
@@ -0,0 +1,45 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+/**
+ * MaltaPost Shipping Provider class.
+ */
+class MaltaPostShippingProvider extends AbstractShippingProvider {
+ /**
+ * Get the key of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_key(): string {
+ return 'maltapost';
+ }
+
+ /**
+ * Get the name of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_name(): string {
+ return 'MaltaPost';
+ }
+
+ /**
+ * Get the icon of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_icon(): string {
+ return esc_url( WC()->plugin_url() ) . '/assets/images/shipping_providers/maltapost.png';
+ }
+
+ /**
+ * Get the tracking URL for a given tracking number.
+ *
+ * @param string $tracking_number The tracking number.
+ * @return string The tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ return 'https://www.maltapost.com/track/' . $tracking_number;
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/MatkahuoltoShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/MatkahuoltoShippingProvider.php
new file mode 100644
index 0000000000..53c6174087
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/MatkahuoltoShippingProvider.php
@@ -0,0 +1,45 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+/**
+ * Matkahuolto Shipping Provider class.
+ */
+class MatkahuoltoShippingProvider extends AbstractShippingProvider {
+ /**
+ * Get the key of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_key(): string {
+ return 'matkahuolto';
+ }
+
+ /**
+ * Get the name of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_name(): string {
+ return 'Matkahuolto';
+ }
+
+ /**
+ * Get the icon of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_icon(): string {
+ return esc_url( WC()->plugin_url() ) . '/assets/images/shipping_providers/matkahuolto.png';
+ }
+
+ /**
+ * Get the tracking URL for a given tracking number.
+ *
+ * @param string $tracking_number The tracking number.
+ * @return string The tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ return 'https://www.matkahuolto.fi/fi/asiakaspalvelu/rahtien-seuranta?trackingNumber=' . $tracking_number;
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/MondialRelayShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/MondialRelayShippingProvider.php
new file mode 100644
index 0000000000..d226ca7a21
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/MondialRelayShippingProvider.php
@@ -0,0 +1,45 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+/**
+ * Mondial Relay Shipping Provider class.
+ */
+class MondialRelayShippingProvider extends AbstractShippingProvider {
+ /**
+ * Get the key of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_key(): string {
+ return 'mondial-relay';
+ }
+
+ /**
+ * Get the name of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_name(): string {
+ return 'Mondial Relay';
+ }
+
+ /**
+ * Get the icon of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_icon(): string {
+ return esc_url( WC()->plugin_url() ) . '/assets/images/shipping_providers/mondial-relay.png';
+ }
+
+ /**
+ * Get the tracking URL for a given tracking number.
+ *
+ * @param string $tracking_number The tracking number.
+ * @return string The tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ return 'https://www.mondialrelay.fr/suivi-colis/' . $tracking_number;
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/NewZealandPostShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/NewZealandPostShippingProvider.php
new file mode 100644
index 0000000000..d66782b9b3
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/NewZealandPostShippingProvider.php
@@ -0,0 +1,45 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+/**
+ * New Zealand Post Shipping Provider class.
+ */
+class NewZealandPostShippingProvider extends AbstractShippingProvider {
+ /**
+ * Get the key of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_key(): string {
+ return 'new-zealand-post';
+ }
+
+ /**
+ * Get the name of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_name(): string {
+ return 'New Zealand Post';
+ }
+
+ /**
+ * Get the icon of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_icon(): string {
+ return esc_url( WC()->plugin_url() ) . '/assets/images/shipping_providers/new-zealand-post.png';
+ }
+
+ /**
+ * Get the tracking URL for a given tracking number.
+ *
+ * @param string $tracking_number The tracking number.
+ * @return string The tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ return 'https://www.nzpost.co.nz/tools/tracking?track=' . $tracking_number;
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/NovaPoshtaShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/NovaPoshtaShippingProvider.php
new file mode 100644
index 0000000000..ba78746e42
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/NovaPoshtaShippingProvider.php
@@ -0,0 +1,45 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+/**
+ * Nova Poshta Shipping Provider class.
+ */
+class NovaPoshtaShippingProvider extends AbstractShippingProvider {
+ /**
+ * Get the key of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_key(): string {
+ return 'nova-poshta';
+ }
+
+ /**
+ * Get the name of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_name(): string {
+ return 'Nova Poshta';
+ }
+
+ /**
+ * Get the icon of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_icon(): string {
+ return esc_url( WC()->plugin_url() ) . '/assets/images/shipping_providers/nova-poshta.png';
+ }
+
+ /**
+ * Get the tracking URL for a given tracking number.
+ *
+ * @param string $tracking_number The tracking number.
+ * @return string The tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ return 'https://novaposhta.ua/en/tracking/' . $tracking_number;
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/OmnivaShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/OmnivaShippingProvider.php
new file mode 100644
index 0000000000..94504e7671
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/OmnivaShippingProvider.php
@@ -0,0 +1,45 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+/**
+ * Omniva Shipping Provider class.
+ */
+class OmnivaShippingProvider extends AbstractShippingProvider {
+ /**
+ * Get the key of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_key(): string {
+ return 'omniva';
+ }
+
+ /**
+ * Get the name of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_name(): string {
+ return 'Omniva';
+ }
+
+ /**
+ * Get the icon of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_icon(): string {
+ return esc_url( WC()->plugin_url() ) . '/assets/images/shipping_providers/omniva.png';
+ }
+
+ /**
+ * Get the tracking URL for a given tracking number.
+ *
+ * @param string $tracking_number The tracking number.
+ * @return string The tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ return 'https://www.omniva.ee/track/' . $tracking_number;
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/OsterreichischePostShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/OsterreichischePostShippingProvider.php
new file mode 100644
index 0000000000..763fc80814
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/OsterreichischePostShippingProvider.php
@@ -0,0 +1,45 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+/**
+ * Osterreichische Post Shipping Provider class.
+ */
+class OsterreichischePostShippingProvider extends AbstractShippingProvider {
+ /**
+ * Get the key of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_key(): string {
+ return 'osterreichische-post';
+ }
+
+ /**
+ * Get the name of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_name(): string {
+ return 'Österreichische Post';
+ }
+
+ /**
+ * Get the icon of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_icon(): string {
+ return esc_url( WC()->plugin_url() ) . '/assets/images/shipping_providers/osterreichische-post.png';
+ }
+
+ /**
+ * Get the tracking URL for a given tracking number.
+ *
+ * @param string $tracking_number The tracking number.
+ * @return string The tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ return 'https://www.post.at/en/track/' . $tracking_number;
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/ParcelForceShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/ParcelForceShippingProvider.php
new file mode 100644
index 0000000000..aa897e204f
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/ParcelForceShippingProvider.php
@@ -0,0 +1,45 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+/**
+ * Parcelforce Shipping Provider class.
+ */
+class ParcelForceShippingProvider extends AbstractShippingProvider {
+ /**
+ * Get the key of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_key(): string {
+ return 'parcelforce';
+ }
+
+ /**
+ * Get the name of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_name(): string {
+ return 'Parcelforce';
+ }
+
+ /**
+ * Get the icon of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_icon(): string {
+ return esc_url( WC()->plugin_url() ) . '/assets/images/shipping_providers/parcelforce.png';
+ }
+
+ /**
+ * Get the tracking URL for a given tracking number.
+ *
+ * @param string $tracking_number The tracking number.
+ * @return string The tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ return 'https://www.parcelforce.com/track-trace/' . $tracking_number;
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/PocztaPolskaShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/PocztaPolskaShippingProvider.php
new file mode 100644
index 0000000000..489d9b72f9
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/PocztaPolskaShippingProvider.php
@@ -0,0 +1,45 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+/**
+ * Poczta Polska Shipping Provider class.
+ */
+class PocztaPolskaShippingProvider extends AbstractShippingProvider {
+ /**
+ * Get the key of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_key(): string {
+ return 'poczta-polska';
+ }
+
+ /**
+ * Get the name of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_name(): string {
+ return 'Poczta Polska';
+ }
+
+ /**
+ * Get the icon of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_icon(): string {
+ return esc_url( WC()->plugin_url() ) . '/assets/images/shipping_providers/poczta-polska.png';
+ }
+
+ /**
+ * Get the tracking URL for a given tracking number.
+ *
+ * @param string $tracking_number The tracking number.
+ * @return string The tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ return 'https://emonitoring.poczta-polska.pl/track/' . $tracking_number;
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/PostLuxembourgShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/PostLuxembourgShippingProvider.php
new file mode 100644
index 0000000000..99d19d7c2f
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/PostLuxembourgShippingProvider.php
@@ -0,0 +1,45 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+/**
+ * POST Luxembourg Shipping Provider class.
+ */
+class PostLuxembourgShippingProvider extends AbstractShippingProvider {
+ /**
+ * Get the key of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_key(): string {
+ return 'post-luxembourg';
+ }
+
+ /**
+ * Get the name of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_name(): string {
+ return 'POST Luxembourg';
+ }
+
+ /**
+ * Get the icon of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_icon(): string {
+ return esc_url( WC()->plugin_url() ) . '/assets/images/shipping_providers/post-luxembourg.png';
+ }
+
+ /**
+ * Get the tracking URL for a given tracking number.
+ *
+ * @param string $tracking_number The tracking number.
+ * @return string The tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ return 'https://www.post.lu/en/track/' . $tracking_number;
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/PostNLShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/PostNLShippingProvider.php
new file mode 100644
index 0000000000..f2c44007dd
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/PostNLShippingProvider.php
@@ -0,0 +1,45 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+/**
+ * PostNL Shipping Provider class.
+ */
+class PostNLShippingProvider extends AbstractShippingProvider {
+ /**
+ * Get the key of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_key(): string {
+ return 'postnl';
+ }
+
+ /**
+ * Get the name of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_name(): string {
+ return 'PostNL';
+ }
+
+ /**
+ * Get the icon of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_icon(): string {
+ return esc_url( WC()->plugin_url() ) . '/assets/images/shipping_providers/postnl.png';
+ }
+
+ /**
+ * Get the tracking URL for a given tracking number.
+ *
+ * @param string $tracking_number The tracking number.
+ * @return string The tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ return 'https://www.postnl.nl/track-en-trace/' . $tracking_number;
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/PostNordShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/PostNordShippingProvider.php
new file mode 100644
index 0000000000..4ea7b7a12d
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/PostNordShippingProvider.php
@@ -0,0 +1,45 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+/**
+ * PostNord Shipping Provider class.
+ */
+class PostNordShippingProvider extends AbstractShippingProvider {
+ /**
+ * Get the key of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_key(): string {
+ return 'postnord';
+ }
+
+ /**
+ * Get the name of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_name(): string {
+ return 'PostNord';
+ }
+
+ /**
+ * Get the icon of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_icon(): string {
+ return esc_url( WC()->plugin_url() ) . '/assets/images/shipping_providers/postnord.png';
+ }
+
+ /**
+ * Get the tracking URL for a given tracking number.
+ *
+ * @param string $tracking_number The tracking number.
+ * @return string The tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ return 'https://www.postnord.se/track-and-trace/' . $tracking_number;
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/PostaMoldoveiShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/PostaMoldoveiShippingProvider.php
new file mode 100644
index 0000000000..8c3a7cab90
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/PostaMoldoveiShippingProvider.php
@@ -0,0 +1,45 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+/**
+ * Posta Moldovei Shipping Provider class.
+ */
+class PostaMoldoveiShippingProvider extends AbstractShippingProvider {
+ /**
+ * Get the key of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_key(): string {
+ return 'posta-moldovei';
+ }
+
+ /**
+ * Get the name of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_name(): string {
+ return 'Poșta Moldovei';
+ }
+
+ /**
+ * Get the icon of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_icon(): string {
+ return esc_url( WC()->plugin_url() ) . '/assets/images/shipping_providers/posta-moldovei.png';
+ }
+
+ /**
+ * Get the tracking URL for a given tracking number.
+ *
+ * @param string $tracking_number The tracking number.
+ * @return string The tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ return 'https://www.posta.md/track/' . $tracking_number;
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/PostaRomanaShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/PostaRomanaShippingProvider.php
new file mode 100644
index 0000000000..d1f9cd7d1e
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/PostaRomanaShippingProvider.php
@@ -0,0 +1,45 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+/**
+ * Posta Romana Shipping Provider class.
+ */
+class PostaRomanaShippingProvider extends AbstractShippingProvider {
+ /**
+ * Get the key of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_key(): string {
+ return 'posta-romana';
+ }
+
+ /**
+ * Get the name of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_name(): string {
+ return 'Poșta Română';
+ }
+
+ /**
+ * Get the icon of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_icon(): string {
+ return esc_url( WC()->plugin_url() ) . '/assets/images/shipping_providers/posta-romana.png';
+ }
+
+ /**
+ * Get the tracking URL for a given tracking number.
+ *
+ * @param string $tracking_number The tracking number.
+ * @return string The tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ return 'https://www.posta-romana.ro/urmărire-colet/' . $tracking_number;
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/PosteItalianeShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/PosteItalianeShippingProvider.php
new file mode 100644
index 0000000000..ab6d3214f9
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/PosteItalianeShippingProvider.php
@@ -0,0 +1,45 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+/**
+ * Poste Italiane Shipping Provider class.
+ */
+class PosteItalianeShippingProvider extends AbstractShippingProvider {
+ /**
+ * Get the key of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_key(): string {
+ return 'poste-italiane';
+ }
+
+ /**
+ * Get the name of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_name(): string {
+ return 'Poste Italiane';
+ }
+
+ /**
+ * Get the icon of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_icon(): string {
+ return esc_url( WC()->plugin_url() ) . '/assets/images/shipping_providers/poste-italiane.png';
+ }
+
+ /**
+ * Get the tracking URL for a given tracking number.
+ *
+ * @param string $tracking_number The tracking number.
+ * @return string The tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ return 'https://www.poste.it/track/' . $tracking_number;
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/PosteSanMarinoShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/PosteSanMarinoShippingProvider.php
new file mode 100644
index 0000000000..ce9344d9a4
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/PosteSanMarinoShippingProvider.php
@@ -0,0 +1,45 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+/**
+ * Poste San Marino Shipping Provider class.
+ */
+class PosteSanMarinoShippingProvider extends AbstractShippingProvider {
+ /**
+ * Get the key of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_key(): string {
+ return 'poste-san-marino';
+ }
+
+ /**
+ * Get the name of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_name(): string {
+ return 'Poste San Marino';
+ }
+
+ /**
+ * Get the icon of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_icon(): string {
+ return esc_url( WC()->plugin_url() ) . '/assets/images/shipping_providers/poste-san-marino.png';
+ }
+
+ /**
+ * Get the tracking URL for a given tracking number.
+ *
+ * @param string $tracking_number The tracking number.
+ * @return string The tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ return 'https://www.poste.sm/it/servizi/ricerca-spedizioni/' . $tracking_number;
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/PostenNorgeBringShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/PostenNorgeBringShippingProvider.php
new file mode 100644
index 0000000000..690bc6effd
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/PostenNorgeBringShippingProvider.php
@@ -0,0 +1,45 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+/**
+ * Posten Norge / Bring Shipping Provider class.
+ */
+class PostenNorgeBringShippingProvider extends AbstractShippingProvider {
+ /**
+ * Get the key of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_key(): string {
+ return 'posten-norge-bring';
+ }
+
+ /**
+ * Get the name of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_name(): string {
+ return 'Posten Norge / Bring';
+ }
+
+ /**
+ * Get the icon of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_icon(): string {
+ return esc_url( WC()->plugin_url() ) . '/assets/images/shipping_providers/posten-norge-bring.png';
+ }
+
+ /**
+ * Get the tracking URL for a given tracking number.
+ *
+ * @param string $tracking_number The tracking number.
+ * @return string The tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ return 'https://www.posten.no/sporing/' . $tracking_number;
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/PurolatorShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/PurolatorShippingProvider.php
new file mode 100644
index 0000000000..ee2e90b020
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/PurolatorShippingProvider.php
@@ -0,0 +1,45 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+/**
+ * Purolator Shipping Provider class.
+ */
+class PurolatorShippingProvider extends AbstractShippingProvider {
+ /**
+ * Get the key of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_key(): string {
+ return 'purolator';
+ }
+
+ /**
+ * Get the name of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_name(): string {
+ return 'Purolator';
+ }
+
+ /**
+ * Get the icon of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_icon(): string {
+ return esc_url( WC()->plugin_url() ) . '/assets/images/shipping_providers/purolator.png';
+ }
+
+ /**
+ * Get the tracking URL for a given tracking number.
+ *
+ * @param string $tracking_number The tracking number.
+ * @return string The tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ return 'https://www.purolator.com/en/shipping/tracking/' . $tracking_number;
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/RoyalMailShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/RoyalMailShippingProvider.php
new file mode 100644
index 0000000000..9e04c5c634
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/RoyalMailShippingProvider.php
@@ -0,0 +1,229 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+use Automattic\WooCommerce\Internal\Fulfillments\FulfillmentUtils;
+
+/**
+ * Royal Mail Shipping Provider class.
+ *
+ * Provides Royal Mail tracking number validation, supported countries, and tracking URL generation.
+ */
+class RoyalMailShippingProvider extends AbstractShippingProvider {
+
+ /**
+ * Royal Mail tracking number patterns with enhanced service detection.
+ *
+ * @var array<string, array{patterns: array<int, string>, confidence: int}>
+ */
+ private const TRACKING_PATTERNS = array(
+ 'GB' => array( // United Kingdom.
+ 'patterns' => array(
+ // UPU S10 international formats.
+ '/^[A-Z]{2}\d{9}GB$/', // International format: XX#########GB.
+ '/^[A-Z]{2}\d{7}GB$/', // Alternative international format: XX#######GB.
+
+ // Domestic tracking formats.
+ '/^[A-Z]{1}\d{9}[A-Z]{1}$/', // Domestic format: X#########X.
+ '/^[A-Z]{2}\d{8}[A-Z]{2}$/', // Standard format: XX########XX.
+ '/^[A-Z]{2}\d{6}[A-Z]{2}$/', // Compact format: XX######XX.
+
+ // Service-specific patterns.
+ '/^[A-Z]{4}\d{10}$/', // Special delivery format: XXXX##########.
+ '/^SD\d{8,12}$/', // Signed For service.
+ '/^SF\d{8,12}$/', // Special Delivery.
+ '/^RM\d{8,12}$/', // Royal Mail standard.
+
+ // Digital tracking formats.
+ '/^\d{16}$/', // 16-digit returns label or digital.
+ '/^\d{14}$/', // 14-digit returns label.
+ '/^\d{13}$/', // 13-digit domestic/international tracking.
+ '/^\d{12}$/', // 12-digit domestic tracking.
+ '/^\d{11}$/', // 11-digit domestic tracking.
+ '/^\d{10}$/', // 10-digit legacy Parcelforce/RM.
+ '/^\d{9}$/', // 9-digit legacy Parcelforce/RM.
+
+ // Parcelforce (Royal Mail Group).
+ '/^PF\d{8,12}$/', // Parcelforce Express.
+ '/^[A-Z]{2}\d{8}PF$/', // Parcelforce International.
+ '/^\d{13}$/', // Parcelforce Worldwide numeric.
+
+ // International tracked services.
+ '/^IT\d{9}GB$/', // International Tracked.
+ '/^IE\d{9}GB$/', // International Economy.
+ '/^IS\d{9}GB$/', // International Standard.
+
+ // Business services.
+ '/^BF\d{8,12}$/', // Business services.
+ '/^[A-Z]{3}\d{8,12}$/', // Three-letter business codes.
+
+ // Legacy formats.
+ '/^[A-Z]{1}\d{8}[A-Z]{2}$/', // Legacy format: X########XX.
+ '/^[0-9]{9}[A-Z]{3}$/', // 9 digits + 3 letters.
+ ),
+ 'confidence' => 80,
+ ),
+ );
+
+ /**
+ * Get the key of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_key(): string {
+ return 'royal-mail';
+ }
+
+ /**
+ * Get the name of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_name(): string {
+ return 'Royal Mail';
+ }
+
+ /**
+ * Get the icon of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_icon(): string {
+ return esc_url( WC()->plugin_url() ) . '/assets/images/shipping_providers/royal-mail.png';
+ }
+
+ /**
+ * Get the countries this shipping provider can ship from.
+ *
+ * @return array List of country codes.
+ */
+ public function get_shipping_from_countries(): array {
+ return array_keys( self::TRACKING_PATTERNS );
+ }
+
+ /**
+ * Get the countries this shipping provider can ship to.
+ *
+ * Royal Mail ships internationally, so we return a comprehensive list.
+ *
+ * @return array List of country codes.
+ */
+ public function get_shipping_to_countries(): array {
+ return array( 'AD', 'AE', 'AF', 'AG', 'AI', 'AL', 'AM', 'AO', 'AQ', 'AR', 'AS', 'AT', 'AU', 'AW', 'AX', 'AZ', 'BA', 'BB', 'BD', 'BE', 'BF', 'BG', 'BH', 'BI', 'BJ', 'BL', 'BM', 'BN', 'BO', 'BQ', 'BR', 'BS', 'BT', 'BV', 'BW', 'BY', 'BZ', 'CA', 'CC', 'CD', 'CF', 'CG', 'CH', 'CI', 'CK', 'CL', 'CM', 'CN', 'CO', 'CR', 'CU', 'CV', 'CW', 'CX', 'CY', 'CZ', 'DE', 'DJ', 'DK', 'DM', 'DO', 'DZ', 'EC', 'EE', 'EG', 'EH', 'ER', 'ES', 'ET', 'FI', 'FJ', 'FK', 'FM', 'FO', 'FR', 'GA', 'GB', 'GD', 'GE', 'GF', 'GG', 'GH', 'GI', 'GL', 'GM', 'GN', 'GP', 'GQ', 'GR', 'GS', 'GT', 'GU', 'GW', 'GY', 'HK', 'HM', 'HN', 'HR', 'HT', 'HU', 'ID', 'IE', 'IL', 'IM', 'IN', 'IO', 'IQ', 'IR', 'IS', 'IT', 'JE', 'JM', 'JO', 'JP', 'KE', 'KG', 'KH', 'KI', 'KM', 'KN', 'KP', 'KR', 'KW', 'KY', 'KZ', 'LA', 'LB', 'LC', 'LI', 'LK', 'LR', 'LS', 'LT', 'LU', 'LV', 'LY', 'MA', 'MC', 'MD', 'ME', 'MF', 'MG', 'MH', 'MK', 'ML', 'MM', 'MN', 'MO', 'MP', 'MQ', 'MR', 'MS', 'MT', 'MU', 'MV', 'MW', 'MX', 'MY', 'MZ', 'NA', 'NC', 'NE', 'NF', 'NG', 'NI', 'NL', 'NO', 'NP', 'NR', 'NU', 'NZ', 'OM', 'PA', 'PE', 'PF', 'PG', 'PH', 'PK', 'PL', 'PM', 'PN', 'PR', 'PS', 'PT', 'PW', 'PY', 'QA', 'RE', 'RO', 'RS', 'RU', 'RW', 'SA', 'SB', 'SC', 'SD', 'SE', 'SG', 'SH', 'SI', 'SJ', 'SK', 'SL', 'SM', 'SN', 'SO', 'SR', 'SS', 'ST', 'SV', 'SX', 'SY', 'SZ', 'TC', 'TD', 'TF', 'TG', 'TH', 'TJ', 'TK', 'TL', 'TM', 'TN', 'TO', 'TR', 'TT', 'TV', 'TW', 'TZ', 'UA', 'UG', 'UM', 'US', 'UY', 'UZ', 'VA', 'VC', 'VE', 'VG', 'VI', 'VN', 'VU', 'WF', 'WS', 'YE', 'YT', 'ZA', 'ZM', 'ZW' );
+ }
+
+ /**
+ * Get the tracking URL for a given tracking number.
+ *
+ * @param string $tracking_number The tracking number.
+ * @return string The tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ return 'https://www.royalmail.com/track-your-item#/tracking-results/' . rawurlencode( $tracking_number );
+ }
+
+ /**
+ * Validate tracking number against country-specific patterns.
+ *
+ * @param string $tracking_number The tracking number to validate.
+ * @param string $country_code The country code for the shipment.
+ * @return bool True if valid, false otherwise.
+ */
+ private function validate_country_pattern( string $tracking_number, string $country_code ): bool {
+ if ( ! isset( self::TRACKING_PATTERNS[ $country_code ] ) ) {
+ return false;
+ }
+
+ foreach ( self::TRACKING_PATTERNS[ $country_code ]['patterns'] as $pattern ) {
+ if ( preg_match( $pattern, $tracking_number ) ) {
+ return true;
+ }
+ }
+ return false;
+ }
+
+ /**
+ * Try to parse a Royal Mail tracking number.
+ *
+ * @param string $tracking_number The tracking number to parse.
+ * @param string $shipping_from The country code of the shipping origin.
+ * @param string $shipping_to The country code of the shipping destination.
+ * @return array|null An array with 'url' and 'ambiguity_score' if valid, null otherwise.
+ */
+ public function try_parse_tracking_number(
+ string $tracking_number,
+ string $shipping_from,
+ string $shipping_to
+ ): ?array {
+ if ( empty( $tracking_number ) || empty( $shipping_from ) || empty( $shipping_to ) ) {
+ return null;
+ }
+
+ $normalized = strtoupper( preg_replace( '/\s+/', '', $tracking_number ) ); // Normalize input.
+ if ( empty( $normalized ) ) {
+ return null;
+ }
+
+ $shipping_from = strtoupper( $shipping_from );
+ $shipping_to = strtoupper( $shipping_to );
+
+ // Check if shipping from UK.
+ if ( 'GB' !== $shipping_from ) {
+ return null;
+ }
+
+ // Check country-specific patterns with enhanced validation.
+ if ( $this->validate_country_pattern( $normalized, $shipping_from ) ) {
+ $confidence = self::TRACKING_PATTERNS[ $shipping_from ]['confidence'];
+
+ // Apply UPU S10 validation for international formats.
+ if ( preg_match( '/^[A-Z]{2}\d{7,9}GB$/', $normalized ) ) {
+ if ( FulfillmentUtils::check_s10_upu_format( $normalized ) ) {
+ $confidence = min( 98, $confidence + 8 ); // Strong boost for valid UPU.
+ }
+ }
+
+ // Apply check digit validation for numeric formats.
+ if ( preg_match( '/^\d{11,16}$/', $normalized ) ) {
+ if ( FulfillmentUtils::validate_mod10_check_digit( $normalized ) ) {
+ $confidence = min( 95, $confidence + 5 ); // Boost for valid check digit.
+ }
+ }
+
+ // Service-specific confidence boosts.
+ if ( preg_match( '/^(SD|SF)\d+/', $normalized ) ) {
+ $confidence = min( 96, $confidence + 6 ); // Special Delivery/Signed For.
+ } elseif ( preg_match( '/^PF\d+/', $normalized ) ) {
+ $confidence = min( 94, $confidence + 4 ); // Parcelforce.
+ } elseif ( preg_match( '/^(IT|IE|IS)\d+GB$/', $normalized ) ) {
+ $confidence = min( 95, $confidence + 5 ); // International tracked services.
+ } elseif ( preg_match( '/^(RM|BF)\d+/', $normalized ) ) {
+ $confidence = min( 92, $confidence + 3 ); // Standard Royal Mail/Business.
+ }
+
+ // Boost confidence for domestic shipments.
+ if ( 'GB' === $shipping_to ) {
+ $confidence = min( 95, $confidence + 8 );
+ }
+
+ // Boost confidence for common destinations (Europe).
+ $european_destinations = array( 'FR', 'DE', 'ES', 'IT', 'NL', 'BE', 'IE', 'AT', 'CH', 'PT', 'DK', 'SE', 'NO' );
+ if ( in_array( $shipping_to, $european_destinations, true ) ) {
+ $confidence = min( 95, $confidence + 3 );
+ }
+
+ // Boost for other common destinations.
+ $common_destinations = array( 'US', 'CA', 'AU', 'NZ', 'JP', 'SG', 'HK' );
+ if ( in_array( $shipping_to, $common_destinations, true ) ) {
+ $confidence = min( 93, $confidence + 2 );
+ }
+
+ return array(
+ 'url' => $this->get_tracking_url( $normalized ),
+ 'ambiguity_score' => $confidence,
+ );
+ }
+
+ return null;
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/RussianPostShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/RussianPostShippingProvider.php
new file mode 100644
index 0000000000..2330fc57c3
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/RussianPostShippingProvider.php
@@ -0,0 +1,45 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+/**
+ * Russian Post Shipping Provider class.
+ */
+class RussianPostShippingProvider extends AbstractShippingProvider {
+ /**
+ * Get the key of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_key(): string {
+ return 'russian-post';
+ }
+
+ /**
+ * Get the name of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_name(): string {
+ return 'Russian Post';
+ }
+
+ /**
+ * Get the icon of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_icon(): string {
+ return esc_url( WC()->plugin_url() ) . '/assets/images/shipping_providers/russian-post.png';
+ }
+
+ /**
+ * Get the tracking URL for a given tracking number.
+ *
+ * @param string $tracking_number The tracking number.
+ * @return string The tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ return 'https://www.pochta.ru/tracking/' . $tracking_number;
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/SDAShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/SDAShippingProvider.php
new file mode 100644
index 0000000000..2389622133
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/SDAShippingProvider.php
@@ -0,0 +1,45 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+/**
+ * SDA Shipping Provider class.
+ */
+class SDAShippingProvider extends AbstractShippingProvider {
+ /**
+ * Get the key of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_key(): string {
+ return 'sda';
+ }
+
+ /**
+ * Get the name of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_name(): string {
+ return 'SDA';
+ }
+
+ /**
+ * Get the icon of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_icon(): string {
+ return esc_url( WC()->plugin_url() ) . '/assets/images/shipping_providers/sda.png';
+ }
+
+ /**
+ * Get the tracking URL for a given tracking number.
+ *
+ * @param string $tracking_number The tracking number.
+ * @return string The tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ return 'https://www.sda.it/track/' . $tracking_number;
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/SeurShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/SeurShippingProvider.php
new file mode 100644
index 0000000000..e05d98f2ae
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/SeurShippingProvider.php
@@ -0,0 +1,45 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+/**
+ * SEUR Shipping Provider class.
+ */
+class SeurShippingProvider extends AbstractShippingProvider {
+ /**
+ * Get the key of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_key(): string {
+ return 'seur';
+ }
+
+ /**
+ * Get the name of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_name(): string {
+ return 'SEUR';
+ }
+
+ /**
+ * Get the icon of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_icon(): string {
+ return esc_url( WC()->plugin_url() ) . '/assets/images/shipping_providers/seur.png';
+ }
+
+ /**
+ * Get the tracking URL for a given tracking number.
+ *
+ * @param string $tracking_number The tracking number.
+ * @return string The tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ return 'https://www.seur.com/seguimiento/' . $tracking_number;
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/SlovenskaPostaShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/SlovenskaPostaShippingProvider.php
new file mode 100644
index 0000000000..567eeec233
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/SlovenskaPostaShippingProvider.php
@@ -0,0 +1,45 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+/**
+ * Slovenska Posta Shipping Provider class.
+ */
+class SlovenskaPostaShippingProvider extends AbstractShippingProvider {
+ /**
+ * Get the key of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_key(): string {
+ return 'slovenska-posta';
+ }
+
+ /**
+ * Get the name of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_name(): string {
+ return 'Slovenská pošta';
+ }
+
+ /**
+ * Get the icon of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_icon(): string {
+ return esc_url( WC()->plugin_url() ) . '/assets/images/shipping_providers/slovenska-posta.png';
+ }
+
+ /**
+ * Get the tracking URL for a given tracking number.
+ *
+ * @param string $tracking_number The tracking number.
+ * @return string The tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ return 'https://www.posta.sk/track/' . $tracking_number;
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/SpeeDeeDeliveryShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/SpeeDeeDeliveryShippingProvider.php
new file mode 100644
index 0000000000..c4148a4dcb
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/SpeeDeeDeliveryShippingProvider.php
@@ -0,0 +1,45 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+/**
+ * Spee-Dee Delivery Shipping Provider class.
+ */
+class SpeeDeeDeliveryShippingProvider extends AbstractShippingProvider {
+ /**
+ * Get the key of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_key(): string {
+ return 'spee-dee-delivery';
+ }
+
+ /**
+ * Get the name of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_name(): string {
+ return 'Spee-Dee Delivery';
+ }
+
+ /**
+ * Get the icon of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_icon(): string {
+ return esc_url( WC()->plugin_url() ) . '/assets/images/shipping_providers/spee-dee-delivery.png';
+ }
+
+ /**
+ * Get the tracking URL for a given tracking number.
+ *
+ * @param string $tracking_number The tracking number.
+ * @return string The tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ return 'https://www.speedeedelivery.com/track/' . $tracking_number;
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/StarTrackShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/StarTrackShippingProvider.php
new file mode 100644
index 0000000000..c8f36fbf14
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/StarTrackShippingProvider.php
@@ -0,0 +1,45 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+/**
+ * StarTrack Shipping Provider class.
+ */
+class StarTrackShippingProvider extends AbstractShippingProvider {
+ /**
+ * Get the key of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_key(): string {
+ return 'startrack';
+ }
+
+ /**
+ * Get the name of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_name(): string {
+ return 'StarTrack';
+ }
+
+ /**
+ * Get the icon of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_icon(): string {
+ return esc_url( WC()->plugin_url() ) . '/assets/images/shipping_providers/startrack.png';
+ }
+
+ /**
+ * Get the tracking URL for a given tracking number.
+ *
+ * @param string $tracking_number The tracking number.
+ * @return string The tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ return 'https://www.startrack.com.au/track/' . $tracking_number;
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/SwissPostShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/SwissPostShippingProvider.php
new file mode 100644
index 0000000000..9f2148dfa7
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/SwissPostShippingProvider.php
@@ -0,0 +1,45 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+/**
+ * Swiss Post Shipping Provider class.
+ */
+class SwissPostShippingProvider extends AbstractShippingProvider {
+ /**
+ * Get the key of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_key(): string {
+ return 'swiss-post';
+ }
+
+ /**
+ * Get the name of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_name(): string {
+ return 'Swiss Post';
+ }
+
+ /**
+ * Get the icon of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_icon(): string {
+ return esc_url( WC()->plugin_url() ) . '/assets/images/shipping_providers/swiss-post.png';
+ }
+
+ /**
+ * Get the tracking URL for a given tracking number.
+ *
+ * @param string $tracking_number The tracking number.
+ * @return string The tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ return 'https://www.post.ch/en/parcel-tracking?itemId=' . $tracking_number;
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/TollShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/TollShippingProvider.php
new file mode 100644
index 0000000000..6615b15a9b
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/TollShippingProvider.php
@@ -0,0 +1,45 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+/**
+ * Toll Shipping Provider class.
+ */
+class TollShippingProvider extends AbstractShippingProvider {
+ /**
+ * Get the key of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_key(): string {
+ return 'toll';
+ }
+
+ /**
+ * Get the name of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_name(): string {
+ return 'Toll';
+ }
+
+ /**
+ * Get the icon of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_icon(): string {
+ return esc_url( WC()->plugin_url() ) . '/assets/images/shipping_providers/toll.png';
+ }
+
+ /**
+ * Get the tracking URL for a given tracking number.
+ *
+ * @param string $tracking_number The tracking number.
+ * @return string The tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ return 'https://www.tollgroup.com/track/' . $tracking_number;
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/UPSShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/UPSShippingProvider.php
new file mode 100644
index 0000000000..8702f77253
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/UPSShippingProvider.php
@@ -0,0 +1,182 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+use Automattic\WooCommerce\Internal\Fulfillments\FulfillmentUtils;
+
+/**
+ * UPS Shipping Provider class.
+ */
+class UPSShippingProvider extends AbstractShippingProvider {
+ /**
+ * Countries that support international UPS shipping.
+ *
+ * @var array
+ */
+ private array $international_shipping_countries = array( 'AF', 'AX', 'AL', 'DZ', 'AS', 'AD', 'AO', 'AI', 'AQ', 'AG', 'AM', 'AW', 'AU', 'AT', 'AZ', 'BS', 'BH', 'BD', 'BB', 'BY', 'BE', 'BZ', 'BJ', 'BM', 'BT', 'BO', 'BQ', 'BA', 'BW', 'BV', 'BR', 'IO', 'BN', 'BG', 'BF', 'BI', 'CV', 'KH', 'CM', 'CA', 'KY', 'CF', 'TD', 'CL', 'CN', 'CX', 'CC', 'CO', 'KM', 'CD', 'CG', 'CK', 'CR', 'CI', 'HR', 'CU', 'CW', 'CY', 'CZ', 'DK', 'DJ', 'DM', 'DO', 'EC', 'EG', 'SV', 'GQ', 'ER', 'EE', 'SZ', 'ET', 'FK', 'FO', 'FJ', 'FI', 'FR', 'GF', 'PF', 'TF', 'GA', 'GM', 'GE', 'DE', 'GH', 'GI', 'GR', 'GL', 'GD', 'GP', 'GU', 'GT', 'GG', 'GN', 'GW', 'GY', 'HT', 'HM', 'VA', 'HN', 'HK', 'HU', 'IS', 'IN', 'ID', 'IR', 'IQ', 'IE', 'IM', 'IL', 'IT', 'JM', 'JP', 'JE', 'JO', 'KZ', 'KE', 'KI', 'KP', 'KR', 'KW', 'KG', 'LA', 'LV', 'LB', 'LS', 'LR', 'LY', 'LI', 'LT', 'LU', 'MO', 'MG', 'MW', 'MY', 'MV', 'ML', 'MT', 'MH', 'MQ', 'MR', 'MU', 'YT', 'MX', 'FM', 'MD', 'MC', 'MN', 'ME', 'MS', 'MA', 'MZ', 'MM', 'NA', 'NR', 'NP', 'NL', 'NC', 'NZ', 'NI', 'NE', 'NG', 'NU', 'NF', 'MK', 'MP', 'NO', 'OM', 'PK', 'PW', 'PS', 'PA', 'PG', 'PY', 'PE', 'PH', 'PN', 'PL', 'PT', 'PR', 'QA', 'RE', 'RO', 'RU', 'RW', 'BL', 'SH', 'KN', 'LC', 'MF', 'PM', 'VC', 'WS', 'SM', 'ST', 'SA', 'SN', 'RS', 'SC', 'SL', 'SG', 'SX', 'SK', 'SI', 'SB', 'SO', 'ZA', 'GS', 'SS', 'ES', 'LK', 'SD', 'SR', 'SJ', 'SE', 'CH', 'SY', 'TW', 'TJ', 'TZ', 'TH', 'TL', 'TG', 'TK', 'TO', 'TT', 'TN', 'TR', 'TM', 'TC', 'TV', 'UG', 'UA', 'AE', 'GB', 'US', 'UM', 'UY', 'UZ', 'VU', 'VE', 'VN', 'VG', 'VI', 'WF', 'EH', 'YE', 'ZM', 'ZW' );
+
+ /**
+ * Countries that support domestic UPS shipping.
+ *
+ * @var array
+ */
+ private array $domestic_shipping_countries = array( 'US', 'CA', 'MX', 'BR', 'AR', 'CL', 'CO', 'PE', 'CR', 'PR', 'DE', 'GB', 'FR', 'IT', 'ES', 'NL', 'BE', 'PL', 'SE', 'DK', 'AT', 'CH', 'PT', 'IE', 'CZ', 'HU', 'FI', 'NO', 'CN', 'HK', 'IN', 'JP', 'KR', 'SG', 'MY', 'TH', 'VN', 'PH', 'AU', 'NZ', 'AE', 'SA', 'ZA', 'TR', 'IL', 'KE', 'NG' );
+
+ /**
+ * Countries that support UPS domestic shipping but use international tracking formats.
+ *
+ * @var array
+ */
+ private array $domestic_but_international_tracking = array( 'IN', 'ZA', 'VN', 'NG', 'PR', 'HK', 'MO', 'CN', 'BR', 'KE' );
+
+ /**
+ * Get the key of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_key(): string {
+ return 'ups';
+ }
+
+ /**
+ * Get the name of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_name(): string {
+ return 'UPS';
+ }
+
+ /**
+ * Get the path of the icon of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_icon(): string {
+ return esc_url( WC()->plugin_url() ) . '/assets/images/shipping_providers/ups.png';
+ }
+
+ /**
+ * Get the tracking URL for a given tracking number.
+ *
+ * @param string $tracking_number The tracking number.
+ * @return string The tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ return 'https://www.ups.com/track?tracknum=' . rawurlencode( $tracking_number );
+ }
+
+ /**
+ * Get the countries from which this provider can ship.
+ *
+ * @return array An array of country codes.
+ */
+ public function get_shipping_from_countries(): array {
+ return $this->international_shipping_countries;
+ }
+
+ /**
+ * Get the countries to which this provider can ship.
+ *
+ * @return array An array of country codes.
+ */
+ public function get_shipping_to_countries(): array {
+ return $this->international_shipping_countries;
+ }
+
+ /**
+ * Check if this provider can ship from a specific country.
+ *
+ * @param string $shipping_from The country code from which the shipment is sent.
+ * @param string $shipping_to The country code to which the shipment is sent.
+ *
+ * @return bool True if this provider can ship from the country, false otherwise.
+ */
+ public function can_ship_from_to( string $shipping_from, string $shipping_to ): bool {
+ if ( $shipping_from === $shipping_to ) {
+ return in_array( $shipping_from, $this->domestic_shipping_countries, true ) ||
+ in_array( $shipping_from, $this->domestic_but_international_tracking, true );
+ } else {
+ return in_array( $shipping_from, $this->international_shipping_countries, true ) &&
+ in_array( $shipping_to, $this->international_shipping_countries, true );
+ }
+ }
+
+ /**
+ * Try to parse the tracking number with additional parameters.
+ *
+ * @param string $tracking_number The tracking number.
+ * @param string $shipping_from The country code from which the shipment is sent.
+ * @param string $shipping_to The country code to which the shipment is sent.
+ *
+ * @return array|null The tracking URL with ambiguity score, or null if parsing fails.
+ */
+ public function try_parse_tracking_number( string $tracking_number, string $shipping_from, string $shipping_to ): ?array {
+ if ( empty( $tracking_number ) || empty( $shipping_from ) || empty( $shipping_to ) || ! $this->can_ship_from_to( $shipping_from, $shipping_to ) ) {
+ return null;
+ }
+
+ $tracking_number = strtoupper( $tracking_number );
+ $is_domestic_shipping = $shipping_from === $shipping_to;
+
+ // UPS tracking number patterns (ordered by confidence).
+ $patterns = array(
+ // 1Z format (standard UPS) - 18 chars, check digit validation.
+ '/^1Z[0-9A-Z]{16}$/' => function () use ( $tracking_number ) {
+ return FulfillmentUtils::validate_ups_1z_check_digit( $tracking_number ) ? 100 : 95;
+ },
+
+ // Numeric only: 12 digits (common for UPS Air/Ground, with mod10 check digit).
+ '/^\d{12}$/' => function () use ( $tracking_number ) {
+ return FulfillmentUtils::validate_mod10_check_digit( $tracking_number ) ? 90 : 80;
+ },
+
+ // Numeric only: 9 or 10 digits (legacy/freight).
+ '/^\d{10}$/' => 75,
+ '/^\d{9}$/' => 70,
+
+ // T, H, or V prefix + 10 digits (special international/freight).
+ '/^[THV]\d{10}$/' => 85,
+
+ // UPS InfoNotice (J + 10 digits).
+ '/^J\d{10}$/' => 80,
+
+ // UPS Mail Innovations Parcel ID (MI + 6 digits + up to 22 alphanum).
+ '/^MI\d{6}[A-Z0-9]{6,22}$/' => 80,
+
+ // USPS Delivery Confirmation (Mail Innovations, 22–34 digits).
+ '/^9\d{21,33}$/' => function () use ( $shipping_from ) {
+ return in_array( $shipping_from, array( 'US', 'CA' ), true ) ? 85 : 70;
+ },
+
+ // UPU S10 format (international, e.g. 'AA123456789CC').
+ '/^[A-Z]{2}\d{9}[A-Z]{2}$/' => function () use ( $shipping_from ) {
+ return in_array( $shipping_from, $this->domestic_but_international_tracking, true ) ? 80 : 65;
+ },
+
+ // Long mail format (22 digits).
+ '/^\d{22}$/' => 60,
+ );
+
+ $match = false;
+ $ambiguity_score = 0;
+
+ foreach ( $patterns as $pattern => $score ) {
+ if ( preg_match( $pattern, $tracking_number ) ) {
+ $match = true;
+ $ambiguity_score = is_callable( $score ) ? $score() : $score;
+ break;
+ }
+ }
+
+ // Boost score for domestic-but-international-tracking countries.
+ if ( $match && $is_domestic_shipping && in_array( $shipping_from, $this->domestic_but_international_tracking, true ) ) {
+ $ambiguity_score += 5;
+ }
+
+ return $match ? array(
+ 'url' => $this->get_tracking_url( $tracking_number ),
+ 'ambiguity_score' => $ambiguity_score,
+ ) : null;
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/USPSShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/USPSShippingProvider.php
new file mode 100644
index 0000000000..af71947c0b
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/USPSShippingProvider.php
@@ -0,0 +1,169 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+use Automattic\WooCommerce\Internal\Fulfillments\FulfillmentUtils;
+
+/**
+ * USPS Shipping Provider implementation.
+ *
+ * Handles USPS tracking number detection and validation for both domestic and international shipments.
+ */
+class USPSShippingProvider extends AbstractShippingProvider {
+ /**
+ * List of countries/territories where USPS offers domestic service.
+ *
+ * @var array<string>
+ */
+ private array $domestic_countries = array( 'US', 'PR', 'GU', 'AS', 'VI', 'MP', 'FM', 'MH', 'PW' );
+
+ /**
+ * Gets the unique provider key.
+ *
+ * @return string The provider key 'usps'.
+ */
+ public function get_key(): string {
+ return 'usps';
+ }
+
+ /**
+ * Gets the display name of the provider.
+ *
+ * @return string The provider name 'USPS'.
+ */
+ public function get_name(): string {
+ return 'USPS';
+ }
+
+ /**
+ * Gets the path to the provider's icon.
+ *
+ * @return string URL to the USPS logo image.
+ */
+ public function get_icon(): string {
+ return esc_url( WC()->plugin_url() ) . '/assets/images/shipping_providers/usps.png';
+ }
+
+ /**
+ * Generates the tracking URL for a given tracking number.
+ *
+ * @param string $tracking_number The tracking number to generate URL for.
+ * @return string The complete tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ return 'https://tools.usps.com/go/TrackConfirmAction?tLabels=' . rawurlencode( $tracking_number );
+ }
+
+ /**
+ * Gets the list of origin countries supported by USPS.
+ *
+ * @return array<string> Array of country codes (only 'US').
+ */
+ public function get_shipping_from_countries(): array {
+ return array( 'US' ); // USPS only ships from the United States.
+ }
+
+ /**
+ * Gets the list of destination countries supported by USPS.
+ *
+ * @return array<string> Array of country codes including domestic and international.
+ */
+ public function get_shipping_to_countries(): array {
+ return array_merge(
+ $this->domestic_countries,
+ explode( ' ', 'AD AE AF AG AI AL AM AO AR AT AU AW AZ BA BB BD BE BF BG BH BI BJ BM BN BO BR BS BT BW BY BZ CA CD CF CG CH CI CL CM CN CO CR CU CV CY CZ DE DJ DK DM DO DZ EC EE EG ER ES ET FI FJ FR GA GB GD GE GH GI GM GN GQ GR GT GW GY HK HN HR HT HU ID IE IL IN IQ IR IS IT JM JO JP KE KG KH KI KM KN KP KR KW KZ LA LB LC LK LR LS LT LU LV LY MA MC MD ME MG MK ML MM MN MO MR MT MU MV MW MX MY MZ NA NE NG NI NL NO NP NZ OM PA PE PG PH PK PL PT PY QA RO RS RU RW SA SB SC SD SE SG SI SK SL SM SN SO SR ST SV SY SZ TD TG TH TJ TL TM TN TO TR TT TV TW TZ UA UG UK UY UZ VC VE VN VU WS YE ZA ZM ZW' )
+ );
+ }
+
+ /**
+ * Checks if USPS can ship from and to the specified countries.
+ *
+ * @param string $shipping_from Origin country code.
+ * @param string $shipping_to Destination country code.
+ * @return bool
+ */
+ public function can_ship_from_to( string $shipping_from, string $shipping_to ): bool {
+ return in_array( $shipping_from, $this->get_shipping_from_countries(), true )
+ && in_array( $shipping_to, $this->get_shipping_to_countries(), true );
+ }
+
+ /**
+ * Attempts to parse and validate a USPS tracking number.
+ *
+ * @param string $tracking_number The tracking number to validate.
+ * @param string $shipping_from Origin country code.
+ * @param string $shipping_to Destination country code.
+ * @return array|null Array with tracking URL and score, or null if invalid.
+ */
+ public function try_parse_tracking_number( string $tracking_number, string $shipping_from, string $shipping_to ): ?array {
+ if ( empty( $tracking_number ) || ! $this->can_ship_from_to( $shipping_from, $shipping_to ) ) {
+ return null;
+ }
+
+ // Remove spaces and uppercase for consistency.
+ $tracking_number = strtoupper( preg_replace( '/\s+/', '', $tracking_number ) );
+ $is_domestic = in_array( $shipping_to, $this->domestic_countries, true );
+
+ // USPS tracking number patterns (ordered by confidence).
+ $patterns = array(
+ // 22-digit, 20-digit, and 26-34 digit numeric (domestic and third-party)
+ '/^(94|93|92|95|96|94|94|94|94)\d{18,22}$/' => function () use ( $tracking_number ) {
+ // Most common domestic, check digit validation.
+ return FulfillmentUtils::validate_mod10_check_digit( $tracking_number ) ? 100 : 95;
+ },
+
+ // S10/UPU international (2 letters, 9 digits, 2 letters, e.g., EC123456789US).
+ '/^[A-Z]{2}\d{9}[A-Z]{2}$/' => function () use ( $tracking_number ) {
+ return FulfillmentUtils::check_s10_upu_format( $tracking_number ) ? 98 : 90;
+ },
+
+ // Global Express Guaranteed (10 or 11 digits, starts with 82).
+ '/^82\d{8,9}$/' => 95,
+
+ // 26-34 digit numeric (Parcel Pool, third-party, starts with 420)
+ '/^420\d{23,31}$/' => 90,
+
+ // 20-22 digit numeric (fallback, domestic)
+ '/^\d{20,22}$/' => 80,
+
+ // 9x... (fallback, 22-34 digits, numeric)
+ '/^9\d{21,33}$/' => 75,
+
+ // Legacy/Express/other.
+ '/^91\d{18,20}$/' => function () use ( $tracking_number ) {
+ return FulfillmentUtils::validate_mod10_check_digit( $tracking_number ) ? 90 : 80;
+ },
+ '/^030[67]\d{16,20}$/' => function () use ( $tracking_number ) {
+ return FulfillmentUtils::validate_mod10_check_digit( $tracking_number ) ? 88 : 80;
+ },
+ );
+
+ foreach ( $patterns as $pattern => $score ) {
+ if ( preg_match( $pattern, $tracking_number ) ) {
+ $ambiguity_score = is_callable( $score ) ? $score() : $score;
+ return array(
+ 'url' => $this->get_tracking_url( $tracking_number ),
+ 'ambiguity_score' => $ambiguity_score,
+ );
+ }
+ }
+
+ // Fallback: Accept any 13-char S10/UPU format ending with "US".
+ if ( preg_match( '/^[A-Z]{2}\d{9}US$/', $tracking_number ) ) {
+ return array(
+ 'url' => $this->get_tracking_url( $tracking_number ),
+ 'ambiguity_score' => 80,
+ );
+ }
+
+ // Fallback: Accept any 20-34 digit numeric string (very low confidence).
+ if ( preg_match( '/^\d{20,34}$/', $tracking_number ) ) {
+ return array(
+ 'url' => $this->get_tracking_url( $tracking_number ),
+ 'ambiguity_score' => 60,
+ );
+ }
+
+ return null; // No matching pattern found.
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/UkrposhtaShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/UkrposhtaShippingProvider.php
new file mode 100644
index 0000000000..90b4e7f93c
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/UkrposhtaShippingProvider.php
@@ -0,0 +1,45 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+/**
+ * Ukrposhta Shipping Provider class.
+ */
+class UkrposhtaShippingProvider extends AbstractShippingProvider {
+ /**
+ * Get the key of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_key(): string {
+ return 'ukrposhta';
+ }
+
+ /**
+ * Get the name of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_name(): string {
+ return 'Ukrposhta';
+ }
+
+ /**
+ * Get the icon of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_icon(): string {
+ return esc_url( WC()->plugin_url() ) . '/assets/images/shipping_providers/ukrposhta.png';
+ }
+
+ /**
+ * Get the tracking URL for a given tracking number.
+ *
+ * @param string $tracking_number The tracking number.
+ * @return string The tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ return 'https://www.ukrposhta.ua/track/' . $tracking_number;
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/UrgentCargusShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/UrgentCargusShippingProvider.php
new file mode 100644
index 0000000000..33461ce1f4
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/UrgentCargusShippingProvider.php
@@ -0,0 +1,45 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+/**
+ * Urgent Cargus Shipping Provider class.
+ */
+class UrgentCargusShippingProvider extends AbstractShippingProvider {
+ /**
+ * Get the key of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_key(): string {
+ return 'urgent-cargus';
+ }
+
+ /**
+ * Get the name of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_name(): string {
+ return 'Urgent Cargus';
+ }
+
+ /**
+ * Get the icon of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_icon(): string {
+ return esc_url( WC()->plugin_url() ) . '/assets/images/shipping_providers/urgent-cargus.png';
+ }
+
+ /**
+ * Get the tracking URL for a given tracking number.
+ *
+ * @param string $tracking_number The tracking number.
+ * @return string The tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ return 'https://www.urgentcargus.ro/urmarire/' . $tracking_number;
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/YurticiKargoShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/YurticiKargoShippingProvider.php
new file mode 100644
index 0000000000..3704993330
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/YurticiKargoShippingProvider.php
@@ -0,0 +1,45 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+/**
+ * Yurtici Kargo Shipping Provider class.
+ */
+class YurticiKargoShippingProvider extends AbstractShippingProvider {
+ /**
+ * Get the key of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_key(): string {
+ return 'yurtici-kargo';
+ }
+
+ /**
+ * Get the name of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_name(): string {
+ return 'Yurtiçi Kargo';
+ }
+
+ /**
+ * Get the icon of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_icon(): string {
+ return esc_url( WC()->plugin_url() ) . '/assets/images/shipping_providers/yurtici-kargo.png';
+ }
+
+ /**
+ * Get the tracking URL for a given tracking number.
+ *
+ * @param string $tracking_number The tracking number.
+ * @return string The tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ return 'https://www.yurticikargo.com/Tracking/Detail/' . $tracking_number;
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/Providers/ZasilkovnaShippingProvider.php b/plugins/woocommerce/src/Internal/Fulfillments/Providers/ZasilkovnaShippingProvider.php
new file mode 100644
index 0000000000..627f11c857
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/Providers/ZasilkovnaShippingProvider.php
@@ -0,0 +1,45 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Internal\Fulfillments\Providers;
+
+/**
+ * Zasilkovna Shipping Provider class.
+ */
+class ZasilkovnaShippingProvider extends AbstractShippingProvider {
+ /**
+ * Get the key of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_key(): string {
+ return 'zasilkovna';
+ }
+
+ /**
+ * Get the name of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_name(): string {
+ return 'Zásilkovna';
+ }
+
+ /**
+ * Get the icon of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_icon(): string {
+ return esc_url( WC()->plugin_url() ) . '/assets/images/shipping_providers/zasilkovna.png';
+ }
+
+ /**
+ * Get the tracking URL for a given tracking number.
+ *
+ * @param string $tracking_number The tracking number.
+ * @return string The tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ return 'https://www.zasilkovna.cz/track/' . $tracking_number;
+ }
+}
diff --git a/plugins/woocommerce/src/Internal/Fulfillments/ShippingProviders.php b/plugins/woocommerce/src/Internal/Fulfillments/ShippingProviders.php
new file mode 100644
index 0000000000..5c22235f5c
--- /dev/null
+++ b/plugins/woocommerce/src/Internal/Fulfillments/ShippingProviders.php
@@ -0,0 +1,83 @@
+<?php declare(strict_types=1);
+
+use Automattic\WooCommerce\Internal\Fulfillments\Providers as ShippingProviders;
+
+return array(
+ 'acs-courier' => ShippingProviders\ACSCourierShippingProvider::class,
+ 'amazon-logistics' => ShippingProviders\AmazonLogisticsShippingProvider::class,
+ 'an-post' => ShippingProviders\AnPostShippingProvider::class,
+ 'aras-kargo' => ShippingProviders\ArasKargoShippingProvider::class,
+ 'australia-post' => ShippingProviders\AustraliaPostShippingProvider::class,
+ 'azerpost' => ShippingProviders\AzerpostShippingProvider::class,
+ 'bartolini-brt' => ShippingProviders\BartoliniBRTShippingProvider::class,
+ 'belpochta' => ShippingProviders\BelpochtaShippingProvider::class,
+ 'bpost' => ShippingProviders\BpostShippingProvider::class,
+ 'bulgarian-posts' => ShippingProviders\BulgarianPostsShippingProvider::class,
+ 'canada-post' => ShippingProviders\CanadaPostShippingProvider::class,
+ 'cdek' => ShippingProviders\CDEKShippingProvider::class,
+ 'ceska-posta' => ShippingProviders\CeskaPostaShippingProvider::class,
+ 'chronopost' => ShippingProviders\ChronopostShippingProvider::class,
+ 'correos' => ShippingProviders\CorreosShippingProvider::class,
+ 'ctt' => ShippingProviders\CTTShippingProvider::class,
+ 'cyprus-post' => ShippingProviders\CyprusPostShippingProvider::class,
+ 'deutsche-post' => ShippingProviders\DeutschePostShippingProvider::class,
+ 'dhl' => ShippingProviders\DHLShippingProvider::class,
+ 'dpd' => ShippingProviders\DPDShippingProvider::class,
+ 'econt' => ShippingProviders\EcontShippingProvider::class,
+ 'eimskip' => ShippingProviders\EimskipShippingProvider::class,
+ 'elta' => ShippingProviders\ELTAShippingProvider::class,
+ 'evri-hermes' => ShippingProviders\EvriHermesShippingProvider::class,
+ 'fan-courier' => ShippingProviders\FanCourierShippingProvider::class,
+ 'fastway' => ShippingProviders\FastwayShippingProvider::class,
+ 'fedex' => ShippingProviders\FedExShippingProvider::class,
+ 'geniki-taxydromiki' => ShippingProviders\GenikiTaxydromikiShippingProvider::class,
+ 'gls' => ShippingProviders\GLSShippingProvider::class,
+ 'haypost' => ShippingProviders\HayPostShippingProvider::class,
+ 'helthjem' => ShippingProviders\HelthjemShippingProvider::class,
+ 'hrvatska-posta' => ShippingProviders\HrvatskaPostaShippingProvider::class,
+ 'inpost' => ShippingProviders\InPostShippingProvider::class,
+ 'islandspostur' => ShippingProviders\IslandsposturShippingProvider::class,
+ 'itella' => ShippingProviders\ItellaShippingProvider::class,
+ 'kazpost' => ShippingProviders\KazpostShippingProvider::class,
+ 'la-poste-colissimo' => ShippingProviders\LaPosteColissimoShippingProvider::class,
+ 'lasership-ontrac' => ShippingProviders\LasershipOntracShippingProvider::class,
+ 'latvijas-pasts' => ShippingProviders\LatvijasPastsShippingProvider::class,
+ 'liechtensteinische-post' => ShippingProviders\LiechtensteinischePostShippingProvider::class,
+ 'magyar-posta' => ShippingProviders\MagyarPostaShippingProvider::class,
+ 'makedonska-posta' => ShippingProviders\MakedonskaPostaShippingProvider::class,
+ 'maltapost' => ShippingProviders\MaltaPostShippingProvider::class,
+ 'matkahuolto' => ShippingProviders\MatkahuoltoShippingProvider::class,
+ 'mondial-relay' => ShippingProviders\MondialRelayShippingProvider::class,
+ 'mpl' => ShippingProviders\MPLShippingProvider::class,
+ 'mrw' => ShippingProviders\MRWShippingProvider::class,
+ 'new-zealand-post' => ShippingProviders\NewZealandPostShippingProvider::class,
+ 'nova-poshta' => ShippingProviders\NovaPoshtaShippingProvider::class,
+ 'omniva' => ShippingProviders\OmnivaShippingProvider::class,
+ 'osterreichische-post' => ShippingProviders\OsterreichischePostShippingProvider::class,
+ 'parcelforce' => ShippingProviders\ParcelForceShippingProvider::class,
+ 'poczta-polska' => ShippingProviders\PocztaPolskaShippingProvider::class,
+ 'post-luxembourg' => ShippingProviders\PostLuxembourgShippingProvider::class,
+ 'posta-moldovei' => ShippingProviders\PostaMoldoveiShippingProvider::class,
+ 'posta-romana' => ShippingProviders\PostaRomanaShippingProvider::class,
+ 'poste-italiane' => ShippingProviders\PosteItalianeShippingProvider::class,
+ 'poste-san-marino' => ShippingProviders\PosteSanMarinoShippingProvider::class,
+ 'posten-norge-bring' => ShippingProviders\PostenNorgeBringShippingProvider::class,
+ 'postnl' => ShippingProviders\PostNLShippingProvider::class,
+ 'postnord' => ShippingProviders\PostNordShippingProvider::class,
+ 'purolator' => ShippingProviders\PurolatorShippingProvider::class,
+ 'royal-mail' => ShippingProviders\RoyalMailShippingProvider::class,
+ 'russian-post' => ShippingProviders\RussianPostShippingProvider::class,
+ 'sda' => ShippingProviders\SDAShippingProvider::class,
+ 'seur' => ShippingProviders\SeurShippingProvider::class,
+ 'slovenska-posta' => ShippingProviders\SlovenskaPostaShippingProvider::class,
+ 'spee-dee-delivery' => ShippingProviders\SpeeDeeDeliveryShippingProvider::class,
+ 'startrack' => ShippingProviders\StarTrackShippingProvider::class,
+ 'swiss-post' => ShippingProviders\SwissPostShippingProvider::class,
+ 'toll' => ShippingProviders\TollShippingProvider::class,
+ 'ukrposhta' => ShippingProviders\UkrposhtaShippingProvider::class,
+ 'ups' => ShippingProviders\UPSShippingProvider::class,
+ 'usps' => ShippingProviders\USPSShippingProvider::class,
+ 'urgent-cargus' => ShippingProviders\UrgentCargusShippingProvider::class,
+ 'yurtici-kargo' => ShippingProviders\YurticiKargoShippingProvider::class,
+ 'zasilkovna' => ShippingProviders\ZasilkovnaShippingProvider::class,
+);
diff --git a/plugins/woocommerce/templates/emails/customer-fulfillment-created.php b/plugins/woocommerce/templates/emails/customer-fulfillment-created.php
new file mode 100644
index 0000000000..dde6026b6c
--- /dev/null
+++ b/plugins/woocommerce/templates/emails/customer-fulfillment-created.php
@@ -0,0 +1,96 @@
+<?php
+/**
+ * Customer fulfillment created email
+ *
+ * This template can be overridden by copying it to yourtheme/woocommerce/emails/customer-fulfillment-created.php.
+ *
+ * HOWEVER, on occasion WooCommerce will need to update template files and you
+ * (the theme developer) will need to copy the new files to your theme to
+ * maintain compatibility. We try to do this as little as possible, but it does
+ * happen. When this occurs the version of the template file will be bumped and
+ * the readme will list any important changes.
+ *
+ * @see https://woocommerce.com/document/template-structure/
+ * @package WooCommerce\Templates\Emails\HTML
+ * @version 10.1.0
+ */
+
+defined( 'ABSPATH' ) || exit;
+
+/**
+ * Hook for the woocommerce_email_header.
+ *
+ * @param string $email_heading The email heading.
+ * @param WC_Email $email The email object.
+ * @since 2.5.0
+ *
+ * @hooked WC_Emails::email_header() Output the email header
+ */
+do_action( 'woocommerce_email_header', $email_heading, $email ); ?>
+
+<div class="email-introduction">
+ <p><?php echo esc_html__( 'Woo! Some items you purchased are being fulfilled. You can use the below information to track your shipment:', 'woocommerce' ); ?></p>
+</div>
+
+<?php
+
+/**
+ * Hook for the woocommerce_email_fulfillment_details.
+ *
+ * @since 10.1.0
+ * @param WC_Order $order The order object.
+ * @param Fulfillment $fulfillment The fulfillment object.
+ * @param bool $sent_to_admin Whether the email is sent to admin.
+ * @param bool $plain_text Whether the email is plain text.
+ * @param WC_Email $email The email object.
+ *
+ * @hooked WC_Emails::fulfillment_details() Shows the fulfillment details.
+ */
+do_action( 'woocommerce_email_fulfillment_details', $order, $fulfillment, $sent_to_admin, $plain_text, $email );
+
+/**
+ * Hook for the woocommerce_email_fulfillment_meta.
+ *
+ * @param WC_Order $order The order object.
+ * @param Fulfillment $fulfillment The fulfillment object.
+ * @param bool $sent_to_admin Whether the email is sent to admin.
+ * @param bool $plain_text Whether the email is plain text.
+ * @param WC_Email $email The email object.
+ * @since 10.1.0
+ *
+ * @hooked WC_Emails::order_meta() Shows fulfillment meta data.
+ */
+do_action( 'woocommerce_email_fulfillment_meta', $order, $fulfillment, $sent_to_admin, $plain_text, $email );
+
+/**
+ * Hook for woocommerce_email_customer_details.
+ *
+ * @param WC_Order $order The order object.
+ * @param bool $sent_to_admin Whether the email is sent to admin.
+ * @param bool $plain_text Whether the email is plain text.
+ * @param WC_Email $email The email object.
+ * @since 2.5.0
+ *
+ * @hooked WC_Emails::customer_details() Shows customer details
+ * @hooked WC_Emails::email_address() Shows email address
+ */
+do_action( 'woocommerce_email_customer_details', $order, $sent_to_admin, $plain_text, $email );
+
+/**
+ * Show user-defined additional content - this is set in each email's settings.
+ */
+if ( $additional_content ) {
+ echo '<table border="0" cellpadding="0" cellspacing="0" width="100%"><tr><td class="email-additional-content">';
+ echo wp_kses_post( wpautop( wptexturize( $additional_content ) ) );
+ echo '</td></tr></table>';
+}
+
+/**
+ * Hook for the woocommerce_email_footer.
+ *
+ * @param WC_Email $email The email object.
+ * @since 2.5.0
+ *
+ * @hooked WC_Emails::email_footer() Output the email footer
+ */
+do_action( 'woocommerce_email_footer', $email );
diff --git a/plugins/woocommerce/templates/emails/customer-fulfillment-deleted.php b/plugins/woocommerce/templates/emails/customer-fulfillment-deleted.php
new file mode 100644
index 0000000000..5e2b7207f4
--- /dev/null
+++ b/plugins/woocommerce/templates/emails/customer-fulfillment-deleted.php
@@ -0,0 +1,96 @@
+<?php
+/**
+ * Customer fulfillment deleted email
+ *
+ * This template can be overridden by copying it to yourtheme/woocommerce/emails/customer-fulfillment-deleted.php.
+ *
+ * HOWEVER, on occasion WooCommerce will need to update template files and you
+ * (the theme developer) will need to copy the new files to your theme to
+ * maintain compatibility. We try to do this as little as possible, but it does
+ * happen. When this occurs the version of the template file will be bumped and
+ * the readme will list any important changes.
+ *
+ * @see https://woocommerce.com/document/template-structure/
+ * @package WooCommerce\Templates\Emails\HTML
+ * @version 10.1.0
+ */
+
+defined( 'ABSPATH' ) || exit;
+
+/**
+ * Hook for the woocommerce_email_header.
+ *
+ * @param string $email_heading The email heading.
+ * @param WC_Email $email The email object.
+ * @since 2.5.0
+ *
+ * @hooked WC_Emails::email_header() Output the email header
+ */
+do_action( 'woocommerce_email_header', $email_heading, $email ); ?>
+
+<div class="email-introduction">
+ <p><?php echo esc_html__( 'We wanted to let you know that one of the previously fulfilled shipments from your order has been removed from our system. This may have been due to a correction or an update in our fulfillment records. Don’t worry — this won’t affect any items you’ve already received.', 'woocommerce' ); ?></p>
+</div>
+
+<?php
+
+/**
+ * Hook for the woocommerce_email_fulfillment_details.
+ *
+ * @since 10.1.0
+ * @param WC_Order $order The order object.
+ * @param Fulfillment $fulfillment The fulfillment object.
+ * @param bool $sent_to_admin Whether the email is sent to admin.
+ * @param bool $plain_text Whether the email is plain text.
+ * @param WC_Email $email The email object.
+ *
+ * @hooked WC_Emails::fulfillment_details() Shows the fulfillment details.
+ */
+do_action( 'woocommerce_email_fulfillment_details', $order, $fulfillment, $sent_to_admin, $plain_text, $email );
+
+/**
+ * Hook for the woocommerce_email_fulfillment_meta.
+ *
+ * @param WC_Order $order The order object.
+ * @param Fulfillment $fulfillment The fulfillment object.
+ * @param bool $sent_to_admin Whether the email is sent to admin.
+ * @param bool $plain_text Whether the email is plain text.
+ * @param WC_Email $email The email object.
+ * @since 10.1.0
+ *
+ * @hooked WC_Emails::order_meta() Shows fulfillment meta data.
+ */
+do_action( 'woocommerce_email_fulfillment_meta', $order, $fulfillment, $sent_to_admin, $plain_text, $email );
+
+/**
+ * Hook for woocommerce_email_customer_details.
+ *
+ * @param WC_Order $order The order object.
+ * @param bool $sent_to_admin Whether the email is sent to admin.
+ * @param bool $plain_text Whether the email is plain text.
+ * @param WC_Email $email The email object.
+ * @since 2.5.0
+ *
+ * @hooked WC_Emails::customer_details() Shows customer details
+ * @hooked WC_Emails::email_address() Shows email address
+ */
+do_action( 'woocommerce_email_customer_details', $order, $sent_to_admin, $plain_text, $email );
+
+/**
+ * Show user-defined additional content - this is set in each email's settings.
+ */
+if ( $additional_content ) {
+ echo '<table border="0" cellpadding="0" cellspacing="0" width="100%"><tr><td class="email-additional-content">';
+ echo wp_kses_post( wpautop( wptexturize( $additional_content ) ) );
+ echo '</td></tr></table>';
+}
+
+/**
+ * Hook for the woocommerce_email_footer.
+ *
+ * @param WC_Email $email The email object.
+ * @since 2.5.0
+ *
+ * @hooked WC_Emails::email_footer() Output the email footer
+ */
+do_action( 'woocommerce_email_footer', $email );
diff --git a/plugins/woocommerce/templates/emails/customer-fulfillment-updated.php b/plugins/woocommerce/templates/emails/customer-fulfillment-updated.php
new file mode 100644
index 0000000000..37f1128695
--- /dev/null
+++ b/plugins/woocommerce/templates/emails/customer-fulfillment-updated.php
@@ -0,0 +1,97 @@
+<?php
+/**
+ * Customer fulfillment updated email
+ *
+ * This template can be overridden by copying it to yourtheme/woocommerce/emails/customer-fulfillment-updated.php.
+ *
+ * HOWEVER, on occasion WooCommerce will need to update template files and you
+ * (the theme developer) will need to copy the new files to your theme to
+ * maintain compatibility. We try to do this as little as possible, but it does
+ * happen. When this occurs the version of the template file will be bumped and
+ * the readme will list any important changes.
+ *
+ * @see https://woocommerce.com/document/template-structure/
+ * @package WooCommerce\Templates\Emails\HTML
+ * @version 10.1.0
+ */
+
+defined( 'ABSPATH' ) || exit;
+
+/**
+ * Hook for the woocommerce_email_header.
+ *
+ * @param string $email_heading The email heading.
+ * @param WC_Email $email The email object.
+ * @since 2.5.0
+ *
+ * @hooked WC_Emails::email_header() Output the email header
+ */
+do_action( 'woocommerce_email_header', $email_heading, $email ); ?>
+
+<div class="email-introduction">
+ <p><?php echo esc_html__( 'Some details of your shipment have recently been updated. This may include tracking information, item contents, or delivery status.', 'woocommerce' ); ?></p>
+ <p><?php echo esc_html__( 'Here’s the latest info we have:', 'woocommerce' ); ?></p>
+</div>
+
+<?php
+
+/**
+ * Hook for the woocommerce_email_fulfillment_details.
+ *
+ * @since 10.1.0
+ * @param WC_Order $order The order object.
+ * @param Fulfillment $fulfillment The fulfillment object.
+ * @param bool $sent_to_admin Whether the email is sent to admin.
+ * @param bool $plain_text Whether the email is plain text.
+ * @param WC_Email $email The email object.
+ *
+ * @hooked WC_Emails::fulfillment_details() Shows the fulfillment details.
+ */
+do_action( 'woocommerce_email_fulfillment_details', $order, $fulfillment, $sent_to_admin, $plain_text, $email );
+
+/**
+ * Hook for the woocommerce_email_fulfillment_meta.
+ *
+ * @param WC_Order $order The order object.
+ * @param Fulfillment $fulfillment The fulfillment object.
+ * @param bool $sent_to_admin Whether the email is sent to admin.
+ * @param bool $plain_text Whether the email is plain text.
+ * @param WC_Email $email The email object.
+ * @since 10.1.0
+ *
+ * @hooked WC_Emails::order_meta() Shows fulfillment meta data.
+ */
+do_action( 'woocommerce_email_fulfillment_meta', $order, $fulfillment, $sent_to_admin, $plain_text, $email );
+
+/**
+ * Hook for woocommerce_email_customer_details.
+ *
+ * @param WC_Order $order The order object.
+ * @param bool $sent_to_admin Whether the email is sent to admin.
+ * @param bool $plain_text Whether the email is plain text.
+ * @param WC_Email $email The email object.
+ * @since 2.5.0
+ *
+ * @hooked WC_Emails::customer_details() Shows customer details
+ * @hooked WC_Emails::email_address() Shows email address
+ */
+do_action( 'woocommerce_email_customer_details', $order, $sent_to_admin, $plain_text, $email );
+
+/**
+ * Show user-defined additional content - this is set in each email's settings.
+ */
+if ( $additional_content ) {
+ echo '<table border="0" cellpadding="0" cellspacing="0" width="100%"><tr><td class="email-additional-content">';
+ echo wp_kses_post( wpautop( wptexturize( $additional_content ) ) );
+ echo '</td></tr></table>';
+}
+
+/**
+ * Hook for the woocommerce_email_footer.
+ *
+ * @param WC_Email $email The email object.
+ * @since 2.5.0
+ *
+ * @hooked WC_Emails::email_footer() Output the email footer
+ */
+do_action( 'woocommerce_email_footer', $email );
diff --git a/plugins/woocommerce/templates/emails/email-fulfillment-details.php b/plugins/woocommerce/templates/emails/email-fulfillment-details.php
new file mode 100644
index 0000000000..fbdf081bc0
--- /dev/null
+++ b/plugins/woocommerce/templates/emails/email-fulfillment-details.php
@@ -0,0 +1,111 @@
+<?php
+/**
+ * Order fulfillment details table shown in emails.
+ *
+ * This template can be overridden by copying it to yourtheme/woocommerce/emails/email-fulfillment-details.php.
+ *
+ * HOWEVER, on occasion WooCommerce will need to update template files and you
+ * (the theme developer) will need to copy the new files to your theme to
+ * maintain compatibility. We try to do this as little as possible, but it does
+ * happen. When this occurs the version of the template file will be bumped and
+ * the readme will list any important changes.
+ *
+ * @see https://woocommerce.com/document/template-structure/
+ * @package WooCommerce\Templates\Emails
+ * @version 10.1.0
+ */
+
+defined( 'ABSPATH' ) || exit;
+
+$text_align = is_rtl() ? 'right' : 'left';
+
+$heading_class = 'email-order-detail-heading';
+$order_table_class = 'email-order-details';
+$order_total_text_align = 'right';
+
+if ( null === $fulfillment->get_date_deleted() ) {
+ $tracking_number = $fulfillment->get_meta( '_tracking_number', true );
+ $tracking_url = $fulfillment->get_meta( '_tracking_url' );
+ $shipment_provider = $fulfillment->get_meta( '_shipment_provider' );
+ if ( ! $tracking_number && ! $tracking_url && ! $shipment_provider ) {
+ echo '<p>' . esc_html__( 'No tracking information available for this fulfillment at the moment.', 'woocommerce' ) . '</p>';
+ } else {
+ echo '<p><strong>' . esc_html__( 'Tracking Number', 'woocommerce' ) . ':</strong> ' . esc_attr( $tracking_number ) . '</p>';
+ echo '<p><strong>' . esc_html__( 'Shipment Provider', 'woocommerce' ) . ':</strong> ' . esc_html( $shipment_provider ) . '</p>';
+ echo '<p><a href="' . esc_url( $tracking_url ) . '" target="_blank">' . esc_attr__( 'Track your shipment', 'woocommerce' ) . '</a></p>';
+ }
+ echo '<br />';
+ echo '<p>';
+ echo wp_kses_post(
+ sprintf(
+ /* translators: %s: Link to My Account > Orders page. */
+ __( 'You can access to more details of your order by visiting <a href="%s" target="_blank">My Account > Orders</a> and select the order you wish to see the latest status of the delivery.', 'woocommerce' ),
+ site_url( 'my-account/orders/' )
+ )
+ );
+ echo '</p>';
+}
+ /**
+ * Action hook to add custom content before fulfillment details in email.
+ *
+ * @param WC_Order $order Order object.
+ * @param Fulfillment $fulfillment Fulfillment object.
+ * @param bool $sent_to_admin Whether it's sent to admin or customer.
+ * @param bool $plain_text Whether it's a plain text email.
+ * @param WC_Email $email Email object.
+ * @since 2.5.0
+ */
+ do_action( 'woocommerce_email_before_fulfillment_table', $order, $fulfillment, $sent_to_admin, $plain_text, $email );
+?>
+
+<h2 class="<?php echo esc_attr( $heading_class ); ?>">
+ <?php
+ echo wp_kses_post( __( 'Fulfillment summary', 'woocommerce' ) );
+ if ( $sent_to_admin ) {
+ $before = '<a class="link" href="' . esc_url( $order->get_edit_order_url() ) . '">';
+ $after = '</a>';
+ } else {
+ $before = '';
+ $after = '';
+ }
+ echo '<br><span>';
+ /* translators: %s: Order ID. */
+ $order_number_string = __( 'Order #%s', 'woocommerce' );
+ echo wp_kses_post( $before . sprintf( $order_number_string . $after . ' (<time datetime="%s">%s</time>)', $order->get_order_number(), $order->get_date_created()->format( 'c' ), wc_format_datetime( $order->get_date_created() ) ) );
+ echo '</span>';
+ ?>
+</h2>
+
+<div style="margin-bottom: 24px;">
+ <table class="td font-family <?php echo esc_attr( $order_table_class ); ?>" cellspacing="0" cellpadding="6" style="width: 100%;" border="1">
+ <tbody>
+ <?php
+ echo wc_get_email_fulfillment_items( // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
+ $order,
+ $fulfillment,
+ array(
+ 'show_sku' => $sent_to_admin,
+ 'show_image' => true,
+ 'image_size' => array( 48, 48 ),
+ 'plain_text' => $plain_text,
+ 'sent_to_admin' => $sent_to_admin,
+ )
+ );
+ ?>
+ </tbody>
+ </table>
+</div>
+
+<?php
+
+/**
+ * Action hook to add custom content after fulfillment details in email.
+ *
+ * @param WC_Order $order Order object.
+ * @param bool $sent_to_admin Whether it's sent to admin or customer.
+ * @param bool $plain_text Whether it's a plain text email.
+ * @param WC_Email $email Email object.
+ * @since 2.5.0
+ */
+do_action( 'woocommerce_email_after_fulfillment_table', $order, $fulfillment, $sent_to_admin, $plain_text, $email );
+?>
diff --git a/plugins/woocommerce/templates/emails/email-fulfillment-items.php b/plugins/woocommerce/templates/emails/email-fulfillment-items.php
new file mode 100644
index 0000000000..ca91ebd76c
--- /dev/null
+++ b/plugins/woocommerce/templates/emails/email-fulfillment-items.php
@@ -0,0 +1,178 @@
+<?php
+/**
+ * Email Fulfillment Items
+ *
+ * This template can be overridden by copying it to yourtheme/woocommerce/emails/email-fulfillment-items.php.
+ *
+ * HOWEVER, on occasion WooCommerce will need to update template files and you
+ * (the theme developer) will need to copy the new files to your theme to
+ * maintain compatibility. We try to do this as little as possible, but it does
+ * happen. When this occurs the version of the template file will be bumped and
+ * the readme will list any important changes.
+ *
+ * @see https://woocommerce.com/document/template-structure/
+ * @package WooCommerce\Templates\Emails
+ * @version 10.1.0
+ */
+
+use Automattic\WooCommerce\Utilities\FeaturesUtil;
+
+defined( 'ABSPATH' ) || exit;
+
+$margin_side = is_rtl() ? 'left' : 'right';
+
+$price_text_align = 'right';
+
+foreach ( $items as $item_id => $item ) :
+ $product = $item->item->get_product();
+ $sku = '';
+ $purchase_note = '';
+ $image = '';
+
+ /**
+ * Email Order Item Visibility hook.
+ *
+ * This filter allows you to control the visibility of order items in emails.
+ *
+ * @param bool $visible Whether the item is visible in the email.
+ * @param WC_Order_Item_Product $item The order item object.
+ * @since 2.1.0
+ */
+ if ( ! apply_filters( 'woocommerce_order_item_visible', true, $item->item ) ) {
+ continue;
+ }
+
+ if ( is_object( $product ) ) {
+ $sku = $product->get_sku();
+ $purchase_note = $product->get_purchase_note();
+ $image = $product->get_image( $image_size );
+ }
+
+ /**
+ * Email Order Item Thumbnail hook.
+ *
+ * @since 2.1.0
+ */
+ $order_item_class = apply_filters( 'woocommerce_order_item_class', 'order_item', $item->item, $order );
+ ?>
+ <tr class="<?php echo esc_attr( $order_item_class ); ?>">
+ <td class="td font-family text-align-left" style="vertical-align: middle; word-wrap:break-word;">
+ <table class="order-item-data">
+ <tr>
+ <?php
+ // Show title/image etc.
+ if ( $show_image ) {
+ /**
+ * Email Order Item Thumbnail hook.
+ *
+ * @param string $image The image HTML.
+ * @param WC_Order_Item_Product $item The item being displayed.
+ * @since 2.1.0
+ */
+ echo '<td>' . wp_kses_post( apply_filters( 'woocommerce_order_item_thumbnail', $image, $item->item ) ) . '</td>';
+ }
+ ?>
+ <td>
+ <?php
+ /**
+ * Order Item Name hook.
+ *
+ * @param string $item_name The item name HTML.
+ * @param WC_Order_Item_Product $item The item being displayed.
+ * @since 2.1.0
+ */
+ echo wp_kses_post( apply_filters( 'woocommerce_order_item_name', $item->item->get_name(), $item->item, false ) );
+
+ // SKU.
+ if ( $show_sku && $sku ) {
+ echo wp_kses_post( ' (#' . $sku . ')' );
+ }
+
+ /**
+ * Allow other plugins to add additional product information.
+ *
+ * @param int $item_id The item ID.
+ * @param WC_Order_Item_Product $item The item object.
+ * @param WC_Order $order The order object.
+ * @param bool $plain_text Whether the email is plain text or not.
+ * @since 2.3.0
+ */
+ do_action( 'woocommerce_order_item_meta_start', $item_id, $item->item, $order, $plain_text );
+
+ $item_meta = wc_display_item_meta(
+ $item->item,
+ array(
+ 'before' => '',
+ 'after' => '',
+ 'separator' => '<br>',
+ 'echo' => false,
+ 'label_before' => '<span>',
+ 'label_after' => ':</span> ',
+ )
+ );
+ echo '<div class="email-order-item-meta">';
+ // Using wp_kses instead of wp_kses_post to remove all block elements.
+ echo wp_kses(
+ $item_meta,
+ array(
+ 'br' => array(),
+ 'span' => array(),
+ 'a' => array(
+ 'href' => true,
+ 'target' => true,
+ 'rel' => true,
+ 'title' => true,
+ ),
+ )
+ );
+ echo '</div>';
+
+ /**
+ * Allow other plugins to add additional product information.
+ *
+ * @param int $item_id The item ID.
+ * @param WC_Order_Item_Product $item The item object.
+ * @param WC_Order $order The order object.
+ * @param bool $plain_text Whether the email is plain text or not.
+ * @since 2.3.0
+ */
+ do_action( 'woocommerce_order_item_meta_end', $item_id, $item->item, $order, $plain_text );
+
+ ?>
+ </td>
+ </tr>
+ </table>
+ </td>
+ <td class="td font-family text-align-<?php echo esc_attr( $price_text_align ); ?>" style="vertical-align:middle;">
+ <?php
+ echo '×';
+ $qty = $item->qty;
+ $qty_display = esc_html( $qty );
+ /**
+ * Email Order Item Quantity hook.
+ *
+ * @since 2.4.0
+ */
+ echo wp_kses_post( apply_filters( 'woocommerce_email_order_item_quantity', $qty_display, $item->item ) );
+ ?>
+ </td>
+ <td class="td font-family text-align-<?php echo esc_attr( $price_text_align ); ?>" style="vertical-align:middle;">
+ <?php echo wp_kses_post( $order->get_formatted_line_subtotal( $item->item ) ); ?>
+ </td>
+ </tr>
+ <?php
+
+ if ( $show_purchase_note && $purchase_note ) {
+ ?>
+ <tr>
+ <td colspan="3" class="font-family text-align-left" style="vertical-align:middle;">
+ <?php
+ echo wp_kses_post( wpautop( do_shortcode( $purchase_note ) ) );
+ ?>
+ </td>
+ </tr>
+ <?php
+ }
+ ?>
+
+<?php endforeach; ?>
diff --git a/plugins/woocommerce/templates/emails/plain/customer-fulfillment-created.php b/plugins/woocommerce/templates/emails/plain/customer-fulfillment-created.php
new file mode 100644
index 0000000000..c2d85ba02d
--- /dev/null
+++ b/plugins/woocommerce/templates/emails/plain/customer-fulfillment-created.php
@@ -0,0 +1,73 @@
+<?php
+/**
+ * Customer fulfillment created email (plain text)
+ *
+ * This template can be overridden by copying it to yourtheme/woocommerce/emails/plain/customer-fulfillment-created.php.
+ *
+ * HOWEVER, on occasion WooCommerce will need to update template files and you
+ * (the theme developer) will need to copy the new files to your theme to
+ * maintain compatibility. We try to do this as little as possible, but it does
+ * happen. When this occurs the version of the template file will be bumped and
+ * the readme will list any important changes.
+ *
+ * @see https://woocommerce.com/document/template-structure/
+ * @package WooCommerce\Templates\Emails\Plain
+ * @version 10.1.0
+ */
+
+defined( 'ABSPATH' ) || exit;
+
+echo "=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=\n";
+echo esc_html( wp_strip_all_tags( $email_heading ) );
+echo "\n=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=\n\n";
+
+echo esc_html__( 'Woo! Some items you purchased are being fulfilled. You can use the below information to track your shipment:', 'woocommerce' ) . "\n\n";
+
+/**
+ * Display fulfillment details.
+ *
+ * @hooked WC_Emails::fulfillment_details() Shows the order details table.
+ * @hooked WC_Structured_Data::generate_order_data() Generates structured data.
+ * @hooked WC_Structured_Data::output_structured_data() Outputs structured data.
+ *
+ * @since 10.1.0
+ */
+do_action( 'woocommerce_email_fulfillment_details', $order, $fulfillment, $sent_to_admin, $plain_text, $email );
+
+echo "\n----------------------------------------\n\n";
+
+/**
+ * Display fulfillment meta data.
+ *
+ * @hooked WC_Emails::fulfillment_meta() Shows order meta data.
+ *
+ * @since 10.1.0
+ */
+do_action( 'woocommerce_email_fulfillment_meta', $order, $fulfillment, $sent_to_admin, $plain_text, $email );
+
+/**
+ * Display customer details and email address.
+ *
+ * @hooked WC_Emails::customer_details() Shows customer details
+ * @hooked WC_Emails::email_address() Shows email address
+ *
+ * @since 2.5.0
+ */
+do_action( 'woocommerce_email_customer_details', $order, $sent_to_admin, $plain_text, $email );
+
+echo "\n\n----------------------------------------\n\n";
+
+/**
+ * Show user-defined additional content - this is set in each email's settings.
+ */
+if ( $additional_content ) {
+ echo esc_html( wp_strip_all_tags( wptexturize( $additional_content ) ) );
+ echo "\n\n----------------------------------------\n\n";
+}
+
+/**
+ * Display the email footer text.
+ *
+ * @since 2.5.0
+ */
+echo wp_kses_post( apply_filters( 'woocommerce_email_footer_text', get_option( 'woocommerce_email_footer_text' ) ) );
diff --git a/plugins/woocommerce/templates/emails/plain/customer-fulfillment-deleted.php b/plugins/woocommerce/templates/emails/plain/customer-fulfillment-deleted.php
new file mode 100644
index 0000000000..2a7dd643a5
--- /dev/null
+++ b/plugins/woocommerce/templates/emails/plain/customer-fulfillment-deleted.php
@@ -0,0 +1,73 @@
+<?php
+/**
+ * Customer fulfillment deleted email (plain text)
+ *
+ * This template can be overridden by copying it to yourtheme/woocommerce/emails/plain/customer-fulfillment-deleted.php.
+ *
+ * HOWEVER, on occasion WooCommerce will need to update template files and you
+ * (the theme developer) will need to copy the new files to your theme to
+ * maintain compatibility. We try to do this as little as possible, but it does
+ * happen. When this occurs the version of the template file will be bumped and
+ * the readme will list any important changes.
+ *
+ * @see https://woocommerce.com/document/template-structure/
+ * @package WooCommerce\Templates\Emails\Plain
+ * @version 10.1.0
+ */
+
+defined( 'ABSPATH' ) || exit;
+
+echo "=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=\n";
+echo esc_html( wp_strip_all_tags( $email_heading ) );
+echo "\n=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=\n\n";
+
+echo esc_html__( 'We wanted to let you know that one of the previously fulfilled shipments from your order has been removed from our system. This may have been due to a correction or an update in our fulfillment records. Don’t worry — this won’t affect any items you’ve already received.', 'woocommerce' ) . "\n\n";
+
+/**
+ * Display fulfillment details.
+ *
+ * @hooked WC_Emails::fulfillment_details() Shows the order details table.
+ * @hooked WC_Structured_Data::generate_order_data() Generates structured data.
+ * @hooked WC_Structured_Data::output_structured_data() Outputs structured data.
+ *
+ * @since 10.1.0
+ */
+do_action( 'woocommerce_email_fulfillment_details', $order, $fulfillment, $sent_to_admin, $plain_text, $email );
+
+echo "\n----------------------------------------\n\n";
+
+/**
+ * Display fulfillment meta data.
+ *
+ * @hooked WC_Emails::fulfillment_meta() Shows order meta data.
+ *
+ * @since 10.1.0
+ */
+do_action( 'woocommerce_email_fulfillment_meta', $order, $fulfillment, $sent_to_admin, $plain_text, $email );
+
+/**
+ * Display customer details and email address.
+ *
+ * @hooked WC_Emails::customer_details() Shows customer details
+ * @hooked WC_Emails::email_address() Shows email address
+ *
+ * @since 2.5.0
+ */
+do_action( 'woocommerce_email_customer_details', $order, $sent_to_admin, $plain_text, $email );
+
+echo "\n\n----------------------------------------\n\n";
+
+/**
+ * Show user-defined additional content - this is set in each email's settings.
+ */
+if ( $additional_content ) {
+ echo esc_html( wp_strip_all_tags( wptexturize( $additional_content ) ) );
+ echo "\n\n----------------------------------------\n\n";
+}
+
+/**
+ * Display the email footer text.
+ *
+ * @since 2.5.0
+ */
+echo wp_kses_post( apply_filters( 'woocommerce_email_footer_text', get_option( 'woocommerce_email_footer_text' ) ) );
diff --git a/plugins/woocommerce/templates/emails/plain/customer-fulfillment-updated.php b/plugins/woocommerce/templates/emails/plain/customer-fulfillment-updated.php
new file mode 100644
index 0000000000..f61f6586a1
--- /dev/null
+++ b/plugins/woocommerce/templates/emails/plain/customer-fulfillment-updated.php
@@ -0,0 +1,75 @@
+<?php
+/**
+ * Customer fulfillment updated email (plain text)
+ *
+ * This template can be overridden by copying it to yourtheme/woocommerce/emails/plain/customer-fulfillment-updated.php.
+ *
+ * HOWEVER, on occasion WooCommerce will need to update template files and you
+ * (the theme developer) will need to copy the new files to your theme to
+ * maintain compatibility. We try to do this as little as possible, but it does
+ * happen. When this occurs the version of the template file will be bumped and
+ * the readme will list any important changes.
+ *
+ * @see https://woocommerce.com/document/template-structure/
+ * @package WooCommerce\Templates\Emails\Plain
+ * @version 10.1.0
+ */
+
+defined( 'ABSPATH' ) || exit;
+
+echo "=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=\n";
+echo esc_html( wp_strip_all_tags( $email_heading ) );
+echo "\n=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=\n\n";
+
+/* translators: %s: Customer first name */
+echo esc_html__( 'Some details of your shipment have recently been updated. This may include tracking information, item contents, or delivery status.', 'woocommerce' ) . "\n\n";
+echo esc_html__( 'Here’s the latest info we have:', 'woocommerce' ) . "\n\n";
+
+/**
+ * Display fulfillment details.
+ *
+ * @hooked WC_Emails::fulfillment_details() Shows the order details table.
+ * @hooked WC_Structured_Data::generate_order_data() Generates structured data.
+ * @hooked WC_Structured_Data::output_structured_data() Outputs structured data.
+ *
+ * @since 10.1.0
+ */
+do_action( 'woocommerce_email_fulfillment_details', $order, $fulfillment, $sent_to_admin, $plain_text, $email );
+
+echo "\n----------------------------------------\n\n";
+
+/**
+ * Display fulfillment meta data.
+ *
+ * @hooked WC_Emails::fulfillment_meta() Shows order meta data.
+ *
+ * @since 10.1.0
+ */
+do_action( 'woocommerce_email_fulfillment_meta', $order, $fulfillment, $sent_to_admin, $plain_text, $email );
+
+/**
+ * Display customer details and email address.
+ *
+ * @hooked WC_Emails::customer_details() Shows customer details
+ * @hooked WC_Emails::email_address() Shows email address
+ *
+ * @since 2.5.0
+ */
+do_action( 'woocommerce_email_customer_details', $order, $sent_to_admin, $plain_text, $email );
+
+echo "\n\n----------------------------------------\n\n";
+
+/**
+ * Show user-defined additional content - this is set in each email's settings.
+ */
+if ( $additional_content ) {
+ echo esc_html( wp_strip_all_tags( wptexturize( $additional_content ) ) );
+ echo "\n\n----------------------------------------\n\n";
+}
+
+/**
+ * Display the email footer text.
+ *
+ * @since 2.5.0
+ */
+echo wp_kses_post( apply_filters( 'woocommerce_email_footer_text', get_option( 'woocommerce_email_footer_text' ) ) );
diff --git a/plugins/woocommerce/templates/emails/plain/email-fulfillment-details.php b/plugins/woocommerce/templates/emails/plain/email-fulfillment-details.php
new file mode 100644
index 0000000000..9503073fd0
--- /dev/null
+++ b/plugins/woocommerce/templates/emails/plain/email-fulfillment-details.php
@@ -0,0 +1,91 @@
+<?php
+/**
+ * Order fulfillment details table shown in emails as plain text.
+ *
+ * This template can be overridden by copying it to yourtheme/woocommerce/emails/plain/email-fulfillment-details.php.
+ *
+ * HOWEVER, on occasion WooCommerce will need to update template files and you
+ * (the theme developer) will need to copy the new files to your theme to
+ * maintain compatibility. We try to do this as little as possible, but it does
+ * happen. When this occurs the version of the template file will be bumped and
+ * the readme will list any important changes.
+ *
+ * @see https://woocommerce.com/document/template-structure/
+ * @package WooCommerce\Templates\Emails\Plain
+ * @version 10.1.0
+ */
+
+defined( 'ABSPATH' ) || exit;
+
+if ( null === $fulfillment->get_date_deleted() ) {
+ $tracking_number = $fulfillment->get_meta( '_tracking_number', true );
+ $tracking_url = $fulfillment->get_meta( '_tracking_url' );
+ $shipment_provider = $fulfillment->get_meta( '_shipment_provider' );
+ if ( ! $tracking_number && ! $tracking_url && ! $shipment_provider ) {
+ echo esc_html__( 'No tracking information available for this fulfillment at the moment.', 'woocommerce' );
+ return;
+ } else {
+ echo esc_html__( 'Tracking Number', 'woocommerce' ) . ': ' . esc_attr( $tracking_number ) . "\n";
+ echo esc_html__( 'Shipment Provider', 'woocommerce' ) . ': ' . esc_html( $shipment_provider ) . "\n";
+ echo esc_html__( 'Tracking URL', 'woocommerce' ) . ': ' . esc_html( $tracking_url ) . "\n\n";
+ }
+
+ echo esc_html__( 'You can access to more details of your order by visiting My Account > Orders and select the order you wish to see the latest status of the delivery.', 'woocommerce' );
+ echo "\n\n\n";
+}
+
+/**
+ * Action hook to add custom content before fulfillment details in email.
+ *
+ * @param WC_Order $order Order object.
+ * @param Fulfillment $fulfillment Fulfillment object.
+ * @param bool $sent_to_admin Whether it's sent to admin or customer.
+ * @param bool $plain_text Whether it's a plain text email.
+ * @param WC_Email $email Email object.
+ * @since 2.5.0
+ */
+do_action( 'woocommerce_email_before_fulfillment_table', $order, $fulfillment, $sent_to_admin, $plain_text, $email );
+
+echo wp_kses_post( __( 'Fulfillment summary', 'woocommerce' ) );
+echo "\n\n==========\n\n";
+
+if ( $sent_to_admin ) {
+ $before = '';
+ $after = '(' . esc_url( $order->get_edit_order_url() ) . ')';
+} else {
+ $before = '';
+ $after = '';
+}
+
+/* translators: %s: Order ID. */
+$order_number_string = __( 'Order #%s', 'woocommerce' );
+echo wp_kses_post(
+ $before . sprintf(
+ $order_number_string . $after . ' (%s)',
+ $order->get_order_number(),
+ wc_format_datetime( $order->get_date_created() )
+ )
+);
+echo "\n\n\n";
+echo wc_get_email_fulfillment_items( // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
+ $order,
+ $fulfillment,
+ array(
+ 'show_sku' => $sent_to_admin,
+ 'show_image' => true,
+ 'image_size' => array( 48, 48 ),
+ 'plain_text' => $plain_text,
+ 'sent_to_admin' => $sent_to_admin,
+ )
+);
+
+/**
+ * Action hook to add custom content after fulfillment details in email.
+ *
+ * @param WC_Order $order Order object.
+ * @param bool $sent_to_admin Whether it's sent to admin or customer.
+ * @param bool $plain_text Whether it's a plain text email.
+ * @param WC_Email $email Email object.
+ * @since 2.5.0
+ */
+do_action( 'woocommerce_email_after_fulfillment_table', $order, $fulfillment, $sent_to_admin, $plain_text, $email );
diff --git a/plugins/woocommerce/templates/emails/plain/email-fulfillment-items.php b/plugins/woocommerce/templates/emails/plain/email-fulfillment-items.php
new file mode 100644
index 0000000000..49ddb6eef3
--- /dev/null
+++ b/plugins/woocommerce/templates/emails/plain/email-fulfillment-items.php
@@ -0,0 +1,77 @@
+<?php
+/**
+ * Email Fulfillment Items (plain)
+ *
+ * This template can be overridden by copying it to yourtheme/woocommerce/emails/plain/email-fulfillment-items.php.
+ *
+ * HOWEVER, on occasion WooCommerce will need to update template files and you
+ * (the theme developer) will need to copy the new files to your theme to
+ * maintain compatibility. We try to do this as little as possible, but it does
+ * happen. When this occurs the version of the template file will be bumped and
+ * the readme will list any important changes.
+ *
+ * @see https://woocommerce.com/document/template-structure/
+ * @package WooCommerce\Templates\Emails\Plain
+ * @version 10.1.0
+ */
+
+if ( ! defined( 'ABSPATH' ) ) {
+ exit; // Exit if accessed directly.
+}
+
+foreach ( $items as $item_id => $item ) :
+ /**
+ * Email Order Item Visibility hook.
+ *
+ * @since 2.5.0
+ * @param $visible Whether the item is visible in the email.
+ * @param WC_Order_Item_Product $item The order item object.
+ *
+ * @return bool
+ */
+ if ( apply_filters(
+ 'woocommerce_order_item_visible',
+ true,
+ $item->item
+ ) ) {
+ $product = $item->item->get_product();
+ $sku = '';
+ $purchase_note = '';
+
+ if ( is_object( $product ) ) {
+ $sku = $product->get_sku();
+ $purchase_note = $product->get_purchase_note();
+ }
+
+ /**
+ * Email Order Item Name hook.
+ *
+ * @since 2.1.0
+ * @since 2.4.0 Added $is_visible parameter.
+ * @param string $product_name Product name.
+ * @param WC_Order_Item $item Order item object.
+ * @param bool $is_visible Is item visible.
+ */
+ $product_name = apply_filters( 'woocommerce_order_item_name', $item->item->get_name(), $item->item, false );
+ /**
+ * Email Order Item Quantity hook.
+ *
+ * @since 2.4.0
+ * @param int $quantity Item quantity.
+ * @param WC_Order_Item $item Item object.
+ */
+ $product_name .= ' × ' . apply_filters( 'woocommerce_email_order_item_quantity', $item->qty, $item->item );
+ echo wp_kses_post( str_pad( wp_kses_post( $product_name ), 40 ) );
+ echo ' ';
+ echo esc_html( str_pad( wp_kses( $order->get_formatted_line_subtotal( $item->item ), array() ), 20, ' ', STR_PAD_LEFT ) ) . "\n";
+
+ // SKU.
+ if ( $show_sku && $sku ) {
+ echo esc_html( '(#' . $sku . ")\n" );
+ }
+ }
+ // Note.
+ if ( $show_purchase_note && $purchase_note ) {
+ echo "\n" . do_shortcode( wp_kses_post( $purchase_note ) );
+ }
+endforeach;
diff --git a/plugins/woocommerce/templates/myaccount/view-order.php b/plugins/woocommerce/templates/myaccount/view-order.php
index 7be11e2c37..d851b76028 100644
--- a/plugins/woocommerce/templates/myaccount/view-order.php
+++ b/plugins/woocommerce/templates/myaccount/view-order.php
@@ -14,7 +14,7 @@
*
* @see https://woocommerce.com/document/template-structure/
* @package WooCommerce\Templates
- * @version 3.0.0
+ * @version 10.1.0
*/
defined( 'ABSPATH' ) || exit;
@@ -23,13 +23,27 @@ $notes = $order->get_customer_order_notes();
?>
<p>
<?php
-printf(
- /* translators: 1: order number 2: order date 3: order status */
- esc_html__( 'Order #%1$s was placed on %2$s and is currently %3$s.', 'woocommerce' ),
- '<mark class="order-number">' . $order->get_order_number() . '</mark>', // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
- '<mark class="order-date">' . wc_format_datetime( $order->get_date_created() ) . '</mark>', // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
- '<mark class="order-status">' . wc_get_order_status_name( $order->get_status() ) . '</mark>' // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
+echo wp_kses_post(
+ /**
+ * Filter to modify order detiails status text.
+ *
+ * @param string $order_status The order status text.
+ *
+ * @since 10.1.0
+ */
+ apply_filters(
+ 'woocommerce_order_details_status',
+ sprintf(
+ /* translators: 1: order number 2: order date 3: order status */
+ esc_html__( 'Order #%1$s was placed on %2$s and is currently %3$s.', 'woocommerce' ),
+ '<mark class="order-number">' . $order->get_order_number() . '</mark>', // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
+ '<mark class="order-date">' . wc_format_datetime( $order->get_date_created() ) . '</mark>', // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
+ '<mark class="order-status">' . wc_get_order_status_name( $order->get_status() ) . '</mark>' // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
+ ),
+ $order
+ )
);
+
?>
</p>
diff --git a/plugins/woocommerce/templates/order/order-details-fulfillment-item.php b/plugins/woocommerce/templates/order/order-details-fulfillment-item.php
new file mode 100644
index 0000000000..4b9919fa93
--- /dev/null
+++ b/plugins/woocommerce/templates/order/order-details-fulfillment-item.php
@@ -0,0 +1,80 @@
+<?php
+/**
+ * Order Item Details
+ *
+ * This template can be overridden by copying it to yourtheme/woocommerce/order/order-details-fulfillment-item.php.
+ *
+ * HOWEVER, on occasion WooCommerce will need to update template files and you
+ * (the theme developer) will need to copy the new files to your theme to
+ * maintain compatibility. We try to do this as little as possible, but it does
+ * happen. When this occurs the version of the template file will be bumped and
+ * the readme will list any important changes.
+ *
+ * @see https://woocommerce.com/document/template-structure/
+ * @package WooCommerce\Templates
+ * @version 10.1.0
+ *
+ * phpcs:disable WooCommerce.Commenting.CommentHooks.MissingHookComment
+ */
+
+if ( ! defined( 'ABSPATH' ) ) {
+ exit;
+}
+
+if ( ! apply_filters( 'woocommerce_order_item_visible', true, $item ) ) {
+ return;
+}
+?>
+<tr class="<?php echo esc_attr( apply_filters( 'woocommerce_order_item_class', 'woocommerce-table__line-item order_item', $item, $order ) ); ?>">
+
+ <td class="woocommerce-table__product-name product-name">
+ <?php
+ $is_visible = $product && $product->is_visible();
+ $product_permalink = apply_filters( 'woocommerce_order_item_permalink', $is_visible ? $product->get_permalink( $item ) : '', $item, $order );
+
+ echo wp_kses_post( apply_filters( 'woocommerce_order_item_name', $product_permalink ? sprintf( '<a href="%s">%s</a>', $product_permalink, $item->get_name() ) : $item->get_name(), $item, $is_visible ) );
+
+ $qty = $quantity;
+ $refunded_qty = $is_pending_item ? $order->get_qty_refunded_for_item( $item_id ) : 0;
+
+ if ( $refunded_qty ) {
+ $qty_display = '<del>' . esc_html( $qty ) . '</del> <ins>' . esc_html( $qty - ( $refunded_qty * -1 ) ) . '</ins>';
+ } else {
+ $qty_display = esc_html( $qty );
+ }
+
+ echo apply_filters( 'woocommerce_order_item_quantity_html', ' <strong class="product-quantity">' . sprintf( '× %s', $qty_display ) . '</strong>', $item ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
+
+ do_action( 'woocommerce_order_item_meta_start', $item_id, $item, $order, false );
+
+ wc_display_item_meta( $item ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
+
+ do_action( 'woocommerce_order_item_meta_end', $item_id, $item, $order, false );
+ ?>
+ </td>
+
+ <td class="woocommerce-table__product-total product-total">
+ <?php
+ $item = clone $item; // Clone the item to avoid modifying the original object.
+ if ( method_exists( $item, 'get_subtotal' )
+ && method_exists( $item, 'set_subtotal' )
+ && method_exists( $item, 'get_quantity' ) ) {
+ $item->set_subtotal(
+ $item->get_subtotal() * $quantity / $item->get_quantity()
+ );
+ }
+ echo $order->get_formatted_line_subtotal( $item ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
+ ?>
+ </td>
+
+</tr>
+
+<?php if ( $show_purchase_note && $purchase_note ) : ?>
+
+<tr class="woocommerce-table__product-purchase-note product-purchase-note">
+
+ <td colspan="2"><?php echo wpautop( do_shortcode( wp_kses_post( $purchase_note ) ) ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped ?></td>
+
+</tr>
+
+<?php endif; ?>
diff --git a/plugins/woocommerce/templates/order/order-details-fulfillments.php b/plugins/woocommerce/templates/order/order-details-fulfillments.php
new file mode 100644
index 0000000000..eb51d962b9
--- /dev/null
+++ b/plugins/woocommerce/templates/order/order-details-fulfillments.php
@@ -0,0 +1,214 @@
+<?php
+/**
+ * Order details (fulfillments)
+ *
+ * This template can be overridden by copying it to yourtheme/woocommerce/order/order-details-fulfillments.php.
+ *
+ * HOWEVER, on occasion WooCommerce will need to update template files and you
+ * (the theme developer) will need to copy the new files to your theme to
+ * maintain compatibility. We try to do this as little as possible, but it does
+ * happen. When this occurs the version of the template file will be bumped and
+ * the readme will list any important changes.
+ *
+ * @see https://woocommerce.com/document/template-structure/
+ * @package WooCommerce\Templates
+ * @version 10.1.0
+ *
+ * @var bool $show_downloads Controls whether the downloads table should be rendered.
+ */
+
+use Automattic\WooCommerce\Internal\DataStores\Fulfillments\FulfillmentsDataStore;
+use Automattic\WooCommerce\Internal\Fulfillments\FulfillmentUtils;
+
+ // phpcs:disable WooCommerce.Commenting.CommentHooks.MissingHookComment
+
+defined( 'ABSPATH' ) || exit;
+
+$order = wc_get_order( $order_id ); // phpcs:ignore WordPress.WP.GlobalVariablesOverride.Prohibited
+
+if ( ! $order ) {
+ return;
+}
+
+$order_items = $order->get_items( apply_filters( 'woocommerce_purchase_order_item_types', 'line_item' ) );
+$show_purchase_note = $order->has_status( apply_filters( 'woocommerce_purchase_note_order_statuses', array( 'completed', 'processing' ) ) );
+$downloads = $order->get_downloadable_items();
+$actions = array_filter(
+ wc_get_account_orders_actions( $order ),
+ function ( $key ) {
+ return 'view' !== $key;
+ },
+ ARRAY_FILTER_USE_KEY
+);
+
+// We make sure the order belongs to the user. This will also be true if the user is a guest, and the order belongs to a guest (userID === 0).
+$show_customer_details = $order->get_user_id() === get_current_user_id();
+
+if ( $show_downloads ) {
+ wc_get_template(
+ 'order/order-downloads.php',
+ array(
+ 'downloads' => $downloads,
+ 'show_title' => true,
+ )
+ );
+}
+?>
+<section class="woocommerce-order-details">
+ <?php do_action( 'woocommerce_order_details_before_order_table', $order ); ?>
+
+ <h2 class="woocommerce-order-details__title"><?php esc_html_e( 'Order details', 'woocommerce' ); ?></h2>
+
+ <table class="woocommerce-table woocommerce-table--order-details shop_table order_details">
+ <?php
+ $fulfillments_data_store = wc_get_container()->get( FulfillmentsDataStore::class );
+ $fulfillments = $fulfillments_data_store->read_fulfillments( WC_Order::class, (string) $order->get_id() );
+
+ if ( FulfillmentUtils::has_pending_items( $order, $fulfillments ) ) {
+ $pending_items = FulfillmentUtils::get_pending_items( $order, $fulfillments );
+ ?>
+
+ <thead>
+ <tr>
+ <th colspan="2" class="woocommerce-table__product-name product-name"><?php esc_html_e( 'Pending items', 'woocommerce' ); ?></th>
+ </tr>
+ </thead>
+
+ <tbody>
+ <?php
+ do_action( 'woocommerce_order_details_before_order_table_items', $order );
+
+ foreach ( $pending_items as $item ) {
+ $product = $item['item']->get_product();
+
+ wc_get_template(
+ 'order/order-details-fulfillment-item.php',
+ array(
+ 'order' => $order,
+ 'item_id' => $item['item_id'],
+ 'item' => $item['item'],
+ 'quantity' => $item['qty'],
+ 'is_pending_item' => true,
+ 'show_purchase_note' => $show_purchase_note,
+ 'purchase_note' => $product ? $product->get_purchase_note() : '',
+ 'product' => $product,
+ )
+ );
+ }
+
+ do_action( 'woocommerce_order_details_after_order_table_items', $order );
+ ?>
+ </tbody>
+ <?php } ?>
+
+ <?php
+ if ( ! empty( $fulfillments ) ) {
+ foreach ( $fulfillments as $index => $fulfillment ) {
+ // Skip if the fulfillment is not fulfilled.
+ if ( ! $fulfillment->get_is_fulfilled() ) {
+ continue;
+ }
+ $fulfillment_items = FulfillmentUtils::get_fulfillment_items( $order, $fulfillment );
+ ?>
+
+ <thead>
+ <tr>
+ <th colspan="2" class="woocommerce-table__product-name product-name">
+ <?php
+ /* translators: %s is the shipment index */
+ printf( esc_html__( 'Shipment %s', 'woocommerce' ), intval( $index ) + 1 );
+ ?>
+ </th>
+ </tr>
+ </thead>
+
+ <tbody>
+ <?php
+ do_action( 'woocommerce_order_details_before_order_table_items', $order );
+
+ foreach ( $fulfillment_items as $item ) {
+ $product = $item['item']->get_product();
+
+ wc_get_template(
+ 'order/order-details-fulfillment-item.php',
+ array(
+ 'order' => $order,
+ 'item_id' => $item['item_id'],
+ 'item' => $item['item'],
+ 'quantity' => $item['qty'],
+ 'is_pending_item' => false,
+ 'show_purchase_note' => $show_purchase_note,
+ 'purchase_note' => $product ? $product->get_purchase_note() : '',
+ 'product' => $product,
+ )
+ );
+ }
+
+ do_action( 'woocommerce_order_details_after_order_table_items', $order );
+ ?>
+ </tbody>
+ <?php
+ }
+ }
+ ?>
+
+ <?php
+ if ( ! empty( $actions ) ) :
+ ?>
+ <tfoot>
+ <tr>
+ <th class="order-actions--heading"><?php esc_html_e( 'Actions', 'woocommerce' ); ?>:</th>
+ <td>
+ <?php
+ $wp_button_class = wc_wp_theme_get_element_class_name( 'button' ) ? ' ' . wc_wp_theme_get_element_class_name( 'button' ) : '';
+ foreach ( $actions as $key => $action ) { // phpcs:ignore WordPress.WP.GlobalVariablesOverride.Prohibited
+ if ( empty( $action['aria-label'] ) ) {
+ // Generate the aria-label based on the action name.
+ /* translators: %1$s Action name, %2$s Order number. */
+ $action_aria_label = sprintf( __( '%1$s order number %2$s', 'woocommerce' ), $action['name'], $order->get_order_number() );
+ } else {
+ $action_aria_label = $action['aria-label'];
+ }
+ echo '<a href="' . esc_url( $action['url'] ) . '" class="woocommerce-button' . esc_attr( $wp_button_class ) . ' button ' . sanitize_html_class( $key ) . ' order-actions-button " aria-label="' . esc_attr( $action_aria_label ) . '">' . esc_html( $action['name'] ) . '</a>';
+ unset( $action_aria_label );
+ }
+ ?>
+ </td>
+ </tr>
+ </tfoot>
+ <?php endif ?>
+ <tfoot>
+ <?php
+ foreach ( $order->get_order_item_totals() as $key => $total ) {
+ ?>
+ <tr>
+ <th scope="row"><?php echo esc_html( $total['label'] ); ?></th>
+ <td><?php echo wp_kses_post( $total['value'] ); ?></td>
+ </tr>
+ <?php
+ }
+ ?>
+ <?php if ( $order->get_customer_note() ) : ?>
+ <tr>
+ <th><?php esc_html_e( 'Note:', 'woocommerce' ); ?></th>
+ <td><?php echo wp_kses( nl2br( wptexturize( $order->get_customer_note() ) ), array( 'br' => array() ) ); ?></td>
+ </tr>
+ <?php endif; ?>
+ </tfoot>
+ </table>
+
+ <?php do_action( 'woocommerce_order_details_after_order_table', $order ); ?>
+</section>
+
+<?php
+/**
+ * Action hook fired after the order details.
+ *
+ * @since 4.4.0
+ * @param WC_Order $order Order data.
+ */
+do_action( 'woocommerce_after_order_details', $order );
+
+if ( $show_customer_details ) {
+ wc_get_template( 'order/order-details-customer.php', array( 'order' => $order ) );
+}
diff --git a/plugins/woocommerce/templates/order/tracking.php b/plugins/woocommerce/templates/order/tracking.php
index f8d00e2083..9862ed4948 100644
--- a/plugins/woocommerce/templates/order/tracking.php
+++ b/plugins/woocommerce/templates/order/tracking.php
@@ -12,7 +12,7 @@
*
* @see https://woocommerce.com/document/template-structure/
* @package WooCommerce\Templates
- * @version 2.2.0
+ * @version 10.1.0
*/
defined( 'ABSPATH' ) || exit;
@@ -23,6 +23,13 @@ $notes = $order->get_customer_order_notes();
<p class="order-info">
<?php
echo wp_kses_post(
+ /**
+ * Filter to modify order tracking status text.
+ *
+ * @param string $order_status The order status text.
+ *
+ * @since 10.1.0
+ */
apply_filters(
'woocommerce_order_tracking_status',
sprintf(
@@ -31,7 +38,8 @@ $notes = $order->get_customer_order_notes();
'<mark class="order-number">' . $order->get_order_number() . '</mark>',
'<mark class="order-date">' . wc_format_datetime( $order->get_date_created() ) . '</mark>',
'<mark class="order-status">' . wc_get_order_status_name( $order->get_status() ) . '</mark>'
- )
+ ),
+ $order
)
);
?>
diff --git a/plugins/woocommerce/tests/php/includes/class-wc-emails-tests.php b/plugins/woocommerce/tests/php/includes/class-wc-emails-tests.php
index 40dcf501a6..12936af256 100644
--- a/plugins/woocommerce/tests/php/includes/class-wc-emails-tests.php
+++ b/plugins/woocommerce/tests/php/includes/class-wc-emails-tests.php
@@ -1,5 +1,8 @@
<?php
+use Automattic\WooCommerce\Internal\Fulfillments\Fulfillment;
+use Automattic\WooCommerce\Tests\Internal\Fulfillments\Helpers\FulfillmentsHelper;
+
/**
* Class WC_Emails_Tests.
*/
@@ -59,4 +62,37 @@ class WC_Emails_Tests extends \WC_Unit_Test_Case {
$this->assertStringContainsString( 'dummy_key', $content );
$this->assertStringContainsString( 'dummy_meta_value', $content );
}
+
+ /**
+ * Test that fulfillment meta function outputs linked meta.
+ */
+ public function test_fulfillment_meta() {
+ // Ensure the FulfillmentsController is registered, which is necessary for the translation of meta keys.
+ update_option( 'woocommerce_feature_fulfillments_enabled', 'yes' );
+ wc_get_container()->get( \Automattic\WooCommerce\Internal\Fulfillments\FulfillmentsController::class )->register();
+
+ $order = \Automattic\WooCommerce\RestApi\UnitTests\Helpers\OrderHelper::create_order();
+ $fulfillment = FulfillmentsHelper::create_fulfillment(
+ array(
+ 'entity_id' => $order->get_id(),
+ 'entity_type' => 'WC_Order',
+ )
+ );
+
+ add_filter(
+ 'woocommerce_fulfillment_meta_key_translations',
+ function ( $translations ) {
+ $translations['test_meta_key'] = __( 'Test meta key', 'woocommerce' );
+ return $translations;
+ }
+ );
+
+ $email_object = new WC_Emails();
+ ob_start();
+ $email_object->fulfillment_meta( $order, $fulfillment, true, true );
+ $content = ob_get_contents();
+ ob_end_clean();
+ $this->assertStringContainsString( 'Test meta key', $content );
+ $this->assertStringContainsString( 'test_meta_value', $content );
+ }
}
diff --git a/plugins/woocommerce/tests/php/src/Internal/DataStores/Fulfillments/FulfillmentsDataStoreHookTest.php b/plugins/woocommerce/tests/php/src/Internal/DataStores/Fulfillments/FulfillmentsDataStoreHookTest.php
new file mode 100644
index 0000000000..ccb1a04117
--- /dev/null
+++ b/plugins/woocommerce/tests/php/src/Internal/DataStores/Fulfillments/FulfillmentsDataStoreHookTest.php
@@ -0,0 +1,596 @@
+<?php
+declare( strict_types = 1 );
+
+namespace Automattic\WooCommerce\Tests\Internal\DataStores\Fulfillments;
+
+use Automattic\WooCommerce\Internal\DataStores\Fulfillments\FulfillmentsDataStore;
+use Automattic\WooCommerce\Internal\Fulfillments\Fulfillment;
+use WC_Helper_Order;
+use WC_Order;
+use WC_Unit_Test_Case;
+use WP_REST_Request;
+
+/**
+ * Class OrderFulfillmentsRestControllerHookTest
+ *
+ * @package Automattic\WooCommerce\Tests\Internal\Fulfillments
+ */
+class FulfillmentsDataStoreHookTest extends WC_Unit_Test_Case {
+ /**
+ * @var FulfillmentsDataStore
+ */
+ private FulfillmentsDataStore $store;
+
+ /**
+ * @var WC_Order
+ */
+ private WC_Order $order;
+
+ /**
+ * Runs before all the tests of the class.
+ */
+ public static function setUpBeforeClass(): void {
+ parent::setUpBeforeClass();
+ update_option( 'woocommerce_feature_fulfillments_enabled', 'yes' );
+ wc_get_container()->get( \Automattic\WooCommerce\Internal\Fulfillments\FulfillmentsController::class )->register();
+ }
+
+ /**
+ * Runs after all the tests of the class.
+ */
+ public static function tearDownAfterClass(): void {
+ update_option( 'woocommerce_feature_fulfillments_enabled', 'no' );
+ parent::tearDownAfterClass();
+ }
+
+ /**
+ * Setup test case.
+ */
+ public function setUp(): void {
+ parent::setUp();
+
+ $this->store = new FulfillmentsDataStore();
+ $this->order = WC_Helper_Order::create_order( get_current_user_id() );
+ }
+
+ /**
+ * Tear down test case.
+ *
+ * This method is called after each test method is executed.
+ * It is used to clean up any data created during the tests.
+ */
+ public function tearDown(): void {
+ parent::tearDown();
+
+ // Remove any fulfillments added during the tests.
+ global $wpdb;
+ $wpdb->query( "TRUNCATE TABLE {$wpdb->prefix}wc_order_fulfillments;" );
+ $wpdb->query( "TRUNCATE TABLE {$wpdb->prefix}wc_order_fulfillment_meta;" );
+ }
+
+ /**
+ * Test that the fulfillment before create hook is called when creating a fulfillment.
+ */
+ public function test_fulfillment_before_create_hook_is_called() {
+ $hook_called = false;
+ add_filter(
+ 'woocommerce_fulfillment_before_create',
+ function ( $fulfillment ) use ( &$hook_called ) {
+ $hook_called = true;
+ return $fulfillment;
+ }
+ );
+
+ $this->store->create( $this->get_test_fulfillment( $this->order->get_id() ) );
+ $this->assertTrue( $hook_called, 'The fulfillment before create hook was not called.' );
+ $fulfillments = $this->store->read_fulfillments( WC_Order::class, (string) $this->order->get_id() );
+ $this->assertCount( 1, $fulfillments, 'Fulfillment was not created.' );
+ }
+
+ /**
+ * Test that the fulfillment before create hook can prevent creating a fulfillment.
+ */
+ public function test_fulfillment_before_create_hook_can_interrupt() {
+ $hook_called = false;
+
+ add_filter(
+ 'woocommerce_fulfillment_before_create',
+ function () use ( &$hook_called ) {
+ $hook_called = true;
+ throw new \Exception( 'Fulfillment creation prevented by hook.' );
+ }
+ );
+
+ $this->expectException( \Exception::class );
+ $this->expectExceptionMessage( 'Fulfillment creation prevented by hook.' );
+ $this->store->create( $this->get_test_fulfillment( $this->order->get_id() ) );
+
+ $this->assertTrue( $hook_called, 'The fulfillment before create hook was not called.' );
+
+ // Check that no fulfillment was created.
+ $fulfillments = $this->store->read_fulfillments( WC_Order::class, (string) $this->order->get_id() );
+ $this->assertCount( 0, $fulfillments, 'Fulfillment was created.' );
+ }
+
+ /**
+ * Test that the fulfillment after create hook is called when creating a fulfillment.
+ */
+ public function test_fulfillment_after_create_hook_is_called() {
+ $hook_called = false;
+
+ add_action(
+ 'woocommerce_fulfillment_after_create',
+ function ( $fulfillment ) use ( &$hook_called, &$received_fulfillment ) {
+ $received_fulfillment = $fulfillment;
+ $hook_called = true;
+ return $fulfillment;
+ },
+ 10,
+ 2
+ );
+
+ $this->store->create( $this->get_test_fulfillment( $this->order->get_id() ) );
+ $this->assertTrue( $hook_called, 'The fulfillment after create hook was not called.' );
+
+ // Compare the received fulfillment with the expected data.
+ $sent_data = $this->get_test_fulfillment_data( $this->order->get_id() );
+ $this->assertEquals( $received_fulfillment->get_entity_type(), $sent_data['entity_type'], );
+ $this->assertEquals( $received_fulfillment->get_entity_id(), $sent_data['entity_id'], );
+ $this->assertEquals( $received_fulfillment->get_status(), $sent_data['status'], );
+ $this->assertEquals( $received_fulfillment->get_is_fulfilled(), $sent_data['is_fulfilled'], );
+ $this->assertEquals( $received_fulfillment->get_meta( 'test_meta_key' ), $sent_data['meta_data'][0]['value'] );
+ $this->assertEquals( $received_fulfillment->get_meta( 'test_meta_key_2' ), $sent_data['meta_data'][1]['value'] );
+ $this->assertEquals( $received_fulfillment->get_items(), $sent_data['meta_data'][2]['value'] );
+ $this->assertNotNull( $received_fulfillment->get_id(), 'Fulfillment ID should not be null.' );
+ $this->assertGreaterThan( 0, $received_fulfillment->get_id(), 'Fulfillment ID should be greater than 0.' );
+
+ $fulfillments = $this->store->read_fulfillments( WC_Order::class, (string) $this->order->get_id() );
+ $this->assertCount( 1, $fulfillments, 'Fulfillment was not created.' );
+ }
+
+ /**
+ * Test that the fulfillment before update hook is called when updating a fulfillment.
+ */
+ public function test_fulfillment_before_update_hook_is_called() {
+ // Create a fulfillment for the order.
+ $fulfillment = $this->get_test_fulfillment( $this->order->get_id() );
+ $fulfillment->save();
+ $this->assertNotNull( $fulfillment->get_id(), 'Fulfillment ID should not be null.' );
+
+ $hook_called = false;
+ add_filter(
+ 'woocommerce_fulfillment_before_update',
+ function ( $fulfillment ) use ( &$hook_called ) {
+ $hook_called = true;
+ return $fulfillment;
+ }
+ );
+
+ // Add a modification to the saved fulfillment, so we can see the difference.
+ $fulfillment->add_meta_data( 'test_meta_update', 'test_meta_value' );
+
+ $this->store->update( $fulfillment );
+ $this->assertTrue( $hook_called, 'The fulfillment before update hook was not called.' );
+
+ $db_fulfillment = new Fulfillment( $fulfillment->get_id() );
+ $this->assertTrue( $db_fulfillment->meta_exists( 'test_meta_update' ), 'Fulfillment was not updated.' );
+ }
+
+ /**
+ * Test that the fulfillment before update hook can prevent updating a fulfillment.
+ */
+ public function test_fulfillment_before_update_hook_can_interrupt() {
+ // Create a fulfillment for the order.
+ $fulfillment = $this->get_test_fulfillment( $this->order->get_id() );
+ $fulfillment->save();
+ $this->assertNotNull( $fulfillment->get_id(), 'Fulfillment ID should not be null.' );
+
+ $hook_called = false;
+ add_filter(
+ 'woocommerce_fulfillment_before_update',
+ function () use ( &$hook_called ) {
+ $hook_called = true;
+ throw new \Exception( 'Fulfillment update prevented by hook.' );
+ }
+ );
+
+ // Add a modification to the saved fulfillment, so we can see the difference.
+ $fulfillment->add_meta_data( 'test_meta_update', 'test_meta_value' );
+
+ $this->expectException( \Exception::class );
+ $this->expectExceptionMessage( 'Fulfillment update prevented by hook.' );
+ $this->store->update( $fulfillment );
+
+ $this->assertTrue( $hook_called, 'The fulfillment before update hook was not called.' );
+ $db_fulfillment = new Fulfillment( $fulfillment->get_id() );
+ $this->assertFalse( $db_fulfillment->meta_exists( 'test_meta_update' ), 'Fulfillment was updated.' );
+ }
+
+ /**
+ * Test that the fulfillment after update hook is called after updating a fulfillment.
+ */
+ public function test_fulfillment_after_update_hook_is_called() {
+ // Create a fulfillment for the order.
+ $fulfillment = $this->get_test_fulfillment( $this->order->get_id() );
+ $fulfillment->save();
+ $this->assertNotNull( $fulfillment->get_id(), 'Fulfillment ID should not be null.' );
+
+ $hook_called = false;
+ add_action(
+ 'woocommerce_fulfillment_after_update',
+ function ( $fulfillment ) use ( &$hook_called, &$received_fulfillment ) {
+ $received_fulfillment = $fulfillment;
+ $hook_called = true;
+ return $fulfillment;
+ },
+ 10,
+ 2
+ );
+
+ // Add a modification to the saved fulfillment, so we can see the difference.
+ $fulfillment->add_meta_data( 'test_meta_update', 'test_meta_value' );
+
+ $this->store->update( $fulfillment );
+ $this->assertTrue( $hook_called, 'The fulfillment after update hook was not called.' );
+
+ // Compare the received fulfillment with the expected data.
+ $this->assertEquals( $received_fulfillment->get_id(), $fulfillment->get_id() );
+ $this->assertEquals( $received_fulfillment->get_entity_type(), $fulfillment->get_entity_type() );
+ $this->assertEquals( $received_fulfillment->get_entity_id(), $fulfillment->get_entity_id() );
+ $this->assertEquals( $received_fulfillment->get_status(), $fulfillment->get_status() );
+ $this->assertEquals( $received_fulfillment->get_is_fulfilled(), $fulfillment->get_is_fulfilled() );
+ $this->assertEquals( $received_fulfillment->get_meta( 'test_meta_key' ), $fulfillment->get_meta( 'test_meta_key' ) );
+ $this->assertEquals( $received_fulfillment->get_meta( 'test_meta_key_2' ), $fulfillment->get_meta( 'test_meta_key_2' ) );
+ $this->assertEquals( $received_fulfillment->get_meta( 'test_meta_update' ), $fulfillment->get_meta( 'test_meta_update' ) );
+ $this->assertEquals( $received_fulfillment->get_items(), $fulfillment->get_items() );
+ }
+
+ /**
+ * Data provider for fulfillment types.
+ *
+ * @return array
+ */
+ public function fulfillment_types() {
+ return array( array( 'create' ), array( 'update' ) );
+ }
+
+ /**
+ * Test that the fulfillment before fulfill hook is not called when is_fulfilled is false.
+ *
+ * @param string $type The type of fulfillment operation ('create' or 'update').
+ *
+ * @dataProvider fulfillment_types
+ */
+ public function test_fulfillment_before_fulfill_hook_is_not_called( $type ) {
+ // Create a fulfillment for the order.
+ $fulfillment = $this->get_test_fulfillment( $this->order->get_id() );
+ if ( 'update' === $type ) {
+ $fulfillment->save();
+ $this->assertNotNull( $fulfillment->get_id(), 'Fulfillment ID should not be null.' );
+ }
+
+ $hook_called = false;
+ add_filter(
+ 'woocommerce_fulfillment_before_fulfill',
+ function ( $fulfillment ) use ( &$hook_called ) {
+ $hook_called = true;
+
+ return $fulfillment;
+ }
+ );
+
+ if ( 'create' === $type ) {
+ // Create the fulfillment.
+ $this->store->create( $fulfillment );
+ } else {
+ // Update the fulfillment.
+ $this->store->update( $fulfillment );
+ }
+
+ $this->assertFalse( $hook_called, 'The fulfillment before fulfill hook was called.' );
+
+ $db_fulfillment = new Fulfillment( $fulfillment->get_id() );
+ $this->assertFalse( $db_fulfillment->get_is_fulfilled() );
+ remove_all_filters( 'woocommerce_fulfillment_before_fulfill' );
+ }
+
+ /**
+ * Test that the fulfillment before fulfill hook is called when updating a fulfillment.
+ *
+ * @param string $type The type of fulfillment operation ('create' or 'update').
+ *
+ * @dataProvider fulfillment_types
+ */
+ public function test_fulfillment_before_fulfill_hook_is_called( $type ) {
+ // Create a fulfillment for the order.
+ $fulfillment = $this->get_test_fulfillment( $this->order->get_id() );
+ if ( 'update' === $type ) {
+ $fulfillment->save();
+ $this->assertNotNull( $fulfillment->get_id(), 'Fulfillment ID should not be null.' );
+ }
+
+ $hook_called = false;
+ add_filter(
+ 'woocommerce_fulfillment_before_fulfill',
+ function ( $fulfillment ) use ( &$hook_called ) {
+ $hook_called = true;
+
+ return $fulfillment;
+ }
+ );
+
+ // Fulfill the fulfillment.
+ $fulfillment->set_status( 'fulfilled' );
+
+ if ( 'create' === $type ) {
+ // Create the fulfillment.
+ $this->store->create( $fulfillment );
+ } else {
+ // Update the fulfillment.
+ $this->store->update( $fulfillment );
+ }
+
+ $this->assertTrue( $hook_called, 'The fulfillment before fulfill hook was not called.' );
+
+ $db_fulfillment = new Fulfillment( $fulfillment->get_id() );
+ $this->assertTrue( $db_fulfillment->get_is_fulfilled() );
+ remove_all_filters( 'woocommerce_fulfillment_before_fulfill' );
+ }
+
+ /**
+ * Test that the fulfillment before fulfill hook can prevent updating a fulfillment.
+ *
+ * @param string $type The type of fulfillment operation ('create' or 'update').
+ *
+ * @dataProvider fulfillment_types
+ */
+ public function test_fulfillment_before_fulfill_hook_can_interrupt( $type ) {
+ // Create a fulfillment for the order.
+ $fulfillment = $this->get_test_fulfillment( $this->order->get_id() );
+ if ( 'update' === $type ) {
+ $fulfillment->save();
+ $this->assertNotNull( $fulfillment->get_id(), 'Fulfillment ID should not be null.' );
+ }
+
+ $hook_called = false;
+ add_filter(
+ 'woocommerce_fulfillment_before_fulfill',
+ function () use ( &$hook_called ) {
+ $hook_called = true;
+ throw new \Exception( 'Fulfillment fulfill prevented by hook.' );
+ }
+ );
+
+ // Fulfill the fulfillment.
+ $fulfillment->set_status( 'fulfilled' );
+
+ $this->expectException( \Exception::class );
+ $this->expectExceptionMessage( 'Fulfillment fulfill prevented by hook.' );
+
+ if ( 'create' === $type ) {
+ // Create the fulfillment.
+ $this->store->create( $fulfillment );
+ } else {
+ // Update the fulfillment.
+ $this->store->update( $fulfillment );
+ }
+
+ $this->assertTrue( $hook_called, 'The fulfillment before fulfill hook was not called.' );
+ if ( 'update' === $type ) {
+ // If it's an update, we should still have the unfulfilled fulfillment in the database.
+ $db_fulfillment = new Fulfillment( $fulfillment->get_id() );
+ $this->assertFalse( $db_fulfillment->get_is_fulfilled(), 'Fulfillment was fulfilled.' );
+ } else {
+ // If it's a create, we should not have the fulfillment in the database.
+ $this->expectException( \Exception::class );
+ $this->expectExceptionMessage( 'Fulfillment not found.' );
+ new Fulfillment( $fulfillment->get_id() );
+ }
+ remove_all_filters( 'woocommerce_fulfillment_before_fulfill' );
+ }
+
+ /**
+ * Test that the fulfillment after update hook is called after updating a fulfillment.
+ *
+ * @param string $type The type of fulfillment operation ('create' or 'update').
+ *
+ * @dataProvider fulfillment_types
+ */
+ public function test_fulfillment_after_fulfill_hook_is_called( $type ) {
+ // Create a fulfillment for the order.
+ $fulfillment = $this->get_test_fulfillment( $this->order->get_id() );
+ if ( 'update' === $type ) {
+ $fulfillment->save();
+ $this->assertNotNull( $fulfillment->get_id(), 'Fulfillment ID should not be null.' );
+ }
+
+ $hook_called = false;
+ add_action(
+ 'woocommerce_fulfillment_after_fulfill',
+ function ( $fulfillment ) use ( &$hook_called, &$received_fulfillment ) {
+ $received_fulfillment = $fulfillment;
+ $hook_called = true;
+ return $fulfillment;
+ },
+ 10,
+ 2
+ );
+
+ // Fulfill the fulfillment.
+ $fulfillment->set_status( 'fulfilled' );
+
+ if ( 'create' === $type ) {
+ // Create the fulfillment.
+ $this->store->create( $fulfillment );
+ } else {
+ // Update the fulfillment.
+ $this->store->update( $fulfillment );
+ }
+ $this->assertTrue( $hook_called, 'The fulfillment after fulfill hook was not called.' );
+
+ // Compare the received fulfillment with the expected data.
+ $this->assertEquals( $received_fulfillment->get_id(), $fulfillment->get_id() );
+ $this->assertEquals( $received_fulfillment->get_entity_type(), $fulfillment->get_entity_type() );
+ $this->assertEquals( $received_fulfillment->get_entity_id(), $fulfillment->get_entity_id() );
+ $this->assertEquals( $received_fulfillment->get_status(), $fulfillment->get_status() );
+ $this->assertEquals( $received_fulfillment->get_is_fulfilled(), $fulfillment->get_is_fulfilled() );
+ $this->assertEquals( $received_fulfillment->get_meta( 'test_meta_key' ), $fulfillment->get_meta( 'test_meta_key' ) );
+ $this->assertEquals( $received_fulfillment->get_meta( 'test_meta_key_2' ), $fulfillment->get_meta( 'test_meta_key_2' ) );
+ $this->assertEquals( $received_fulfillment->get_meta( 'test_meta_update' ), $fulfillment->get_meta( 'test_meta_update' ) );
+ $this->assertEquals( $received_fulfillment->get_items(), $fulfillment->get_items() );
+ remove_all_actions( 'woocommerce_fulfillment_after_fulfill' );
+ }
+
+ /**
+ * Test that the fulfillment before delete hook is called when deleting a fulfillment.
+ */
+ public function test_fulfillment_before_delete_hook_is_called() {
+ // Create a fulfillment for the order.
+ $fulfillment = $this->get_test_fulfillment( $this->order->get_id() );
+ $fulfillment->save();
+ $fulfillment_id = $fulfillment->get_id();
+ $this->assertNotNull( $fulfillment_id, 'Fulfillment ID should not be null.' );
+
+ $hook_called = false;
+ add_filter(
+ 'woocommerce_fulfillment_before_delete',
+ function ( $fulfillment ) use ( &$hook_called ) {
+ $hook_called = true;
+ return $fulfillment;
+ }
+ );
+
+ $this->store->delete( $fulfillment );
+ $this->assertTrue( $hook_called, 'The fulfillment before delete hook was not called.' );
+
+ // Verify the fulfillment can still be read but is marked as deleted.
+ $deleted_fulfillment = new Fulfillment( $fulfillment_id );
+ $this->assertNotNull( $deleted_fulfillment->get_date_deleted(), 'Fulfillment should be marked as deleted.' );
+ }
+
+ /**
+ * Test that the fulfillment before delete hook can prevent deleting a fulfillment.
+ */
+ public function test_fulfillment_before_delete_hook_can_interrupt() {
+ // Create a fulfillment for the order.
+ $fulfillment = $this->get_test_fulfillment( $this->order->get_id() );
+ $fulfillment->save();
+ $fulfillment_id = $fulfillment->get_id();
+ $this->assertNotNull( $fulfillment_id, 'Fulfillment ID should not be null.' );
+
+ $hook_called = false;
+ add_filter(
+ 'woocommerce_fulfillment_before_delete',
+ function () use ( &$hook_called ) {
+ $hook_called = true;
+ throw new \Exception( 'Fulfillment delete prevented by hook.' );
+ }
+ );
+
+ $this->expectException( \Exception::class );
+ $this->expectExceptionMessage( 'Fulfillment delete prevented by hook.' );
+ $this->store->delete( $fulfillment );
+
+ $this->assertTrue( $hook_called, 'The fulfillment before delete hook was not called.' );
+ $db_fulfillment = new Fulfillment( $fulfillment_id );
+ $this->assertNotNull( $db_fulfillment, 'Fulfillment was deleted.' );
+ }
+
+ /**
+ * Test that the fulfillment after delete hook is called after deleting a fulfillment.
+ */
+ public function test_fulfillment_after_delete_hook_is_called() {
+ // Create a fulfillment for the order.
+ $fulfillment = $this->get_test_fulfillment( $this->order->get_id() );
+ $fulfillment->save();
+ $fulfillment_id = $fulfillment->get_id();
+ $this->assertNotNull( $fulfillment_id, 'Fulfillment ID should not be null.' );
+ $fulfillment_clone = clone $fulfillment;
+
+ $hook_called = false;
+ add_action(
+ 'woocommerce_fulfillment_after_delete',
+ function ( $fulfillment ) use ( &$hook_called, &$received_fulfillment ) {
+ $received_fulfillment = $fulfillment;
+ $hook_called = true;
+ return $fulfillment;
+ },
+ 10,
+ 2
+ );
+
+ $this->store->delete( $fulfillment );
+ $this->assertTrue( $hook_called, 'The fulfillment after delete hook was not called.' );
+
+ // Compare the received fulfillment with the expected data.
+ $this->assertEquals( $fulfillment, new Fulfillment(), 'Fulfillment should be reset after deletion.' );
+ $this->assertNotNull( $received_fulfillment, 'Received fulfillment should not be null.' );
+ $this->assertInstanceOf( Fulfillment::class, $received_fulfillment, 'Received fulfillment should be an instance of Fulfillment.' );
+ $this->assertEquals( $received_fulfillment->get_id(), $fulfillment_clone->get_id() );
+ $this->assertEquals( $received_fulfillment->get_entity_type(), $fulfillment_clone->get_entity_type() );
+ $this->assertEquals( $received_fulfillment->get_entity_id(), $fulfillment_clone->get_entity_id() );
+ $this->assertEquals( $received_fulfillment->get_status(), $fulfillment_clone->get_status() );
+ $this->assertEquals( $received_fulfillment->get_is_fulfilled(), $fulfillment_clone->get_is_fulfilled() );
+ $this->assertEquals( $received_fulfillment->get_meta( 'test_meta_key' ), $fulfillment_clone->get_meta( 'test_meta_key' ) );
+ $this->assertEquals( $received_fulfillment->get_meta( 'test_meta_key_2' ), $fulfillment_clone->get_meta( 'test_meta_key_2' ) );
+ $this->assertEquals( $received_fulfillment->get_items(), $fulfillment_clone->get_items() );
+ $this->assertNotNull( $received_fulfillment->get_date_deleted(), 'Fulfillment deletion date should not be null.' );
+ }
+
+ /**
+ * Create a test fulfillment to use in the tests.
+ *
+ * @param int $order_id The ID of the order to create a fulfillment for.
+ *
+ * @return Fulfillment
+ */
+ private function get_test_fulfillment( $order_id ): Fulfillment {
+ // Create a fulfillment for the order.
+ $test_data = $this->get_test_fulfillment_data( $order_id );
+ $fulfillment = new Fulfillment();
+ $fulfillment->set_props( $test_data );
+ $fulfillment->set_meta_data( $test_data['meta_data'] );
+ return $fulfillment;
+ }
+
+ /**
+ * Get test fulfillment data.
+ *
+ * @param int $order_id The ID of the order to create a fulfillment for.
+ * @return array
+ */
+ private function get_test_fulfillment_data( $order_id ): array {
+ return array(
+ 'entity_type' => WC_Order::class,
+ 'entity_id' => $order_id,
+ 'status' => 'unfulfilled',
+ 'is_fulfilled' => false,
+ 'meta_data' => array(
+ array(
+ 'id' => 0,
+ 'key' => 'test_meta_key',
+ 'value' => 'test_meta_value',
+ ),
+ array(
+ 'id' => 0,
+ 'key' => 'test_meta_key_2',
+ 'value' => 'test_meta_value_2',
+ ),
+ array(
+ 'id' => 0,
+ 'key' => '_items',
+ 'value' => array(
+ array(
+ 'item_id' => 1,
+ 'qty' => 2,
+ ),
+ array(
+ 'item_id' => 2,
+ 'qty' => 3,
+ ),
+ ),
+ ),
+ ),
+ );
+ }
+}
diff --git a/plugins/woocommerce/tests/php/src/Internal/DataStores/Fulfillments/FulfillmentsDataStoreTest.php b/plugins/woocommerce/tests/php/src/Internal/DataStores/Fulfillments/FulfillmentsDataStoreTest.php
new file mode 100644
index 0000000000..89a86b5ffd
--- /dev/null
+++ b/plugins/woocommerce/tests/php/src/Internal/DataStores/Fulfillments/FulfillmentsDataStoreTest.php
@@ -0,0 +1,820 @@
+<?php
+
+declare( strict_types=1 );
+
+namespace Automattic\WooCommerce\Tests\Internal\DataStores\Fulfillments;
+
+use Automattic\WooCommerce\Internal\DataStores\Fulfillments\FulfillmentsDataStore;
+use Automattic\WooCommerce\Internal\Fulfillments\Fulfillment;
+use WC_Meta_Data;
+
+/**
+ * Tests for the WC_Order_Fulfillment_Data_Store_Test class.
+ *
+ * @package WooCommerce\Tests\Order_Fulfillment
+ */
+class FulfillmentsDataStoreTest extends \WC_Unit_Test_Case {
+ /**
+ * The instance of the order fulfillment data store to use.
+ *
+ * @var FulfillmentsDataStore
+ */
+ private static FulfillmentsDataStore $order_fulfillment_data_store;
+
+ /**
+ * Runs before all the tests of the class.
+ */
+ public static function setUpBeforeClass(): void {
+ parent::setUpBeforeClass();
+ update_option( 'woocommerce_feature_fulfillments_enabled', 'yes' );
+ wc_get_container()->get( \Automattic\WooCommerce\Internal\Fulfillments\FulfillmentsController::class )->register();
+ self::$order_fulfillment_data_store = new FulfillmentsDataStore();
+ }
+
+ /**
+ * Runs after all the tests of the class.
+ */
+ public static function tearDownAfterClass(): void {
+ update_option( 'woocommerce_feature_fulfillments_enabled', 'no' );
+ parent::tearDownAfterClass();
+ }
+
+ /**
+ * Tests the create method of the order fulfillment data store.
+ */
+ public function test_create_fulfillment() {
+ $fulfillment = new Fulfillment();
+ $fulfillment->set_entity_type( 'order-fulfillment' );
+ $fulfillment->set_entity_id( '123' );
+ $fulfillment->set_status( 'unfulfilled' );
+ $fulfillment->set_items(
+ array(
+ array(
+ 'item_id' => 1,
+ 'qty' => 2,
+ ),
+ array(
+ 'item_id' => 2,
+ 'qty' => 3,
+ ),
+ )
+ );
+
+ self::$order_fulfillment_data_store->create( $fulfillment );
+ $this->assertFulfillmentRecordInDB( $fulfillment );
+ $this->assertFulfillmentMetaInDB( $fulfillment );
+ }
+
+ /**
+ * Tests the create method of the order fulfillment data store with invalid entity type.
+ */
+ public function test_create_fulfillment_throws_error_on_invalid_entity_type() {
+ $fulfillment = new Fulfillment();
+ $fulfillment->set_entity_type( '' );
+ $fulfillment->set_entity_id( '123' );
+ $fulfillment->set_status( 'unfulfilled' );
+ $fulfillment->set_items(
+ array(
+ array(
+ 'item_id' => 1,
+ 'qty' => 2,
+ ),
+ )
+ );
+
+ $this->expectException( \Exception::class );
+ $this->expectExceptionMessage( 'Invalid entity type.' );
+
+ self::$order_fulfillment_data_store->create( $fulfillment );
+ }
+
+ /**
+ * Tests the create method of the order fulfillment data store with invalid entity ID.
+ */
+ public function test_create_fulfillment_throws_error_on_invalid_entity_id() {
+ $fulfillment = new Fulfillment();
+ $fulfillment->set_entity_type( 'order-fulfillment' );
+ $fulfillment->set_entity_id( '' );
+ $fulfillment->set_status( 'unfulfilled' );
+ $fulfillment->set_items(
+ array(
+ array(
+ 'item_id' => 1,
+ 'qty' => 2,
+ ),
+ )
+ );
+
+ $this->expectException( \Exception::class );
+ $this->expectExceptionMessage( 'Invalid entity ID.' );
+
+ self::$order_fulfillment_data_store->create( $fulfillment );
+ }
+
+ /**
+ * Tests the create method of the order fulfillment data store with invalid items.
+ */
+ public function test_create_fulfillment_throws_error_on_invalid_items() {
+ $fulfillment = new Fulfillment();
+ $fulfillment->set_entity_type( 'order-fulfillment' );
+ $fulfillment->set_entity_id( '123' );
+ $fulfillment->set_status( 'unfulfilled' );
+ $fulfillment->set_props( array( 'meta_data' => array( '_items' => null ) ) );
+
+ $this->expectException( \Exception::class );
+ $this->expectExceptionMessage( 'The fulfillment should contain at least one item.' );
+
+ self::$order_fulfillment_data_store->create( $fulfillment );
+ }
+
+ /**
+ * Tests the create method of the order fulfillment data store with no items.
+ */
+ public function test_create_fulfillment_throws_error_on_empty_items() {
+ $fulfillment = new Fulfillment();
+ $fulfillment->set_entity_type( 'order-fulfillment' );
+ $fulfillment->set_entity_id( '123' );
+ $fulfillment->set_status( 'unfulfilled' );
+ $fulfillment->set_items( array() );
+
+ $this->expectException( \Exception::class );
+ $this->expectExceptionMessage( 'The fulfillment should contain at least one item.' );
+
+ self::$order_fulfillment_data_store->create( $fulfillment );
+ }
+
+ /**
+ * Tests the create method of the order fulfillment data store with invalid item.
+ */
+ public function test_create_fulfillment_throws_error_on_invalid_item() {
+ $fulfillment = new Fulfillment();
+ $fulfillment->set_entity_type( 'order-fulfillment' );
+ $fulfillment->set_entity_id( '123' );
+ $fulfillment->set_status( 'unfulfilled' );
+ $fulfillment->set_items(
+ array(
+ array(
+ 'item_id' => 1,
+ 'qty' => 2,
+ ),
+ array(
+ 'item_id' => 2,
+ // Missing qty.
+ ),
+ )
+ );
+
+ $this->expectException( \Exception::class );
+ $this->expectExceptionMessage( 'Invalid item.' );
+
+ self::$order_fulfillment_data_store->create( $fulfillment );
+ }
+
+ /**
+ * Tests the read method of the order fulfillment data store.
+ */
+ public function test_read_fulfillment() {
+ $fulfillment = new Fulfillment();
+ $fulfillment->set_entity_type( 'order-fulfillment' );
+ $fulfillment->set_entity_id( '123' );
+ $fulfillment->set_status( 'unfulfilled' );
+ $fulfillment->set_items(
+ array(
+ array(
+ 'item_id' => 1,
+ 'qty' => 2,
+ ),
+ array(
+ 'item_id' => 2,
+ 'qty' => 3,
+ ),
+ )
+ );
+ self::$order_fulfillment_data_store->create( $fulfillment );
+
+ $this->assertNotNull( $fulfillment->get_id() );
+
+ $new_fulfillment = new Fulfillment();
+ $new_fulfillment->set_id( $fulfillment->get_id() );
+
+ self::$order_fulfillment_data_store->read( $new_fulfillment );
+
+ $this->assertFulfillmentRecordInDB( $new_fulfillment );
+ $this->assertFulfillmentMetaInDB( $new_fulfillment );
+ }
+
+ /**
+ * Tests the update method of the order fulfillment data store.
+ */
+ public function test_update_fulfillment() {
+ $fulfillment = new Fulfillment();
+ $fulfillment->set_id( 1 );
+ $fulfillment->set_entity_type( 'order-fulfillment' );
+ $fulfillment->set_entity_id( '123' );
+ $fulfillment->set_status( 'unfulfilled' );
+ $fulfillment->set_items(
+ array(
+ array(
+ 'item_id' => 1,
+ 'qty' => 2,
+ ),
+ array(
+ 'item_id' => 2,
+ 'qty' => 3,
+ ),
+ )
+ );
+ self::$order_fulfillment_data_store->create( $fulfillment );
+
+ $fulfillment->set_entity_id( '456' );
+ $fulfillment->set_items(
+ array(
+ array(
+ 'item_id' => 3,
+ 'qty' => 4,
+ ),
+ array(
+ 'item_id' => 4,
+ 'qty' => 5,
+ ),
+ )
+ );
+
+ self::$order_fulfillment_data_store->update( $fulfillment );
+
+ $this->assertFulfillmentRecordInDB( $fulfillment );
+ $this->assertFulfillmentMetaInDB( $fulfillment );
+ }
+
+ /**
+ * Tests the delete method of the order fulfillment data store.
+ */
+ public function test_delete_fulfillment() {
+ $fulfillment = new Fulfillment();
+ $fulfillment->set_id( 1 );
+ $fulfillment->set_entity_type( 'order-fulfillment' );
+ $fulfillment->set_entity_id( '123' );
+ $fulfillment->set_status( 'unfulfilled' );
+ $fulfillment->set_items(
+ array(
+ array(
+ 'item_id' => 1,
+ 'qty' => 2,
+ ),
+ array(
+ 'item_id' => 2,
+ 'qty' => 3,
+ ),
+ )
+ );
+ self::$order_fulfillment_data_store->create( $fulfillment );
+
+ $this->assertNotNull( $fulfillment->get_id() );
+ $this->assertNull( $fulfillment->get_date_deleted() );
+
+ // Cache the metadata before deletion.
+ $metadata = $fulfillment->get_meta_data();
+
+ // Cache the ID before deletion.
+ $fulfillment_id = $fulfillment->get_id();
+
+ self::$order_fulfillment_data_store->delete( $fulfillment );
+ // The fulfillment should be reset to it's initial state.
+ $this->assertEquals( 0, $fulfillment->get_id() );
+ $this->assertEquals( null, $fulfillment->get_entity_type() );
+ $this->assertEquals( null, $fulfillment->get_entity_id() );
+ $this->assertEquals( array(), $fulfillment->get_items() );
+ $this->assertEquals( array(), $fulfillment->get_meta_data() );
+ $this->assertEquals( null, $fulfillment->get_date_updated() );
+ $this->assertEquals( null, $fulfillment->get_date_deleted() );
+ $this->assertFulfillmentRecordInDB( $fulfillment, $fulfillment_id, true );
+ $this->assertFulfillmentMetaInDB( $fulfillment, $fulfillment_id, $metadata );
+ }
+
+ /**
+ * Tests the read_meta method of the order fulfillment data store.
+ */
+ public function test_read_fulfillment_meta() {
+ $items = array(
+ array(
+ 'item_id' => 1,
+ 'qty' => 2,
+ ),
+ array(
+ 'item_id' => 2,
+ 'qty' => 3,
+ ),
+ );
+
+ $fulfillment = new Fulfillment();
+ $fulfillment->set_entity_id( '123' );
+ $fulfillment->set_entity_type( 'order-fulfillment' );
+ $fulfillment->set_status( 'unfulfilled' );
+ $fulfillment->set_items( $items );
+ $fulfillment->save();
+
+ $this->assertNotEquals( 0, $fulfillment->get_id() );
+
+ $result = self::$order_fulfillment_data_store->read_meta( $fulfillment );
+
+ $this->assertIsArray( $result );
+ $this->assertCount( 1, $result );
+ $this->assertIsObject( $result[0] );
+ $this->assertEquals( $items, $result[0]->meta_value );
+ $this->assertEquals( '_items', $result[0]->meta_key );
+ $this->assertEquals( $fulfillment->get_id(), $result[0]->fulfillment_id );
+ }
+
+
+ /**
+ * Tests the delete_meta method of the order fulfillment data store.
+ */
+ public function test_delete_fulfillment_meta() {
+ $items = array(
+ array(
+ 'item_id' => 1,
+ 'qty' => 2,
+ ),
+ array(
+ 'item_id' => 2,
+ 'qty' => 3,
+ ),
+ );
+
+ $fulfillment = new Fulfillment();
+ $fulfillment->set_entity_id( '123' );
+ $fulfillment->set_entity_type( 'order-fulfillment' );
+ $fulfillment->set_status( 'unfulfilled' );
+ $fulfillment->set_items( $items );
+ $fulfillment->save();
+
+ $this->assertNotEquals( 0, $fulfillment->get_id() );
+
+ $meta = $fulfillment->get_meta_data();
+ $this->assertCount( 1, $meta );
+ $this->assertEquals( '_items', $meta[0]->key );
+ $this->assertEquals( $items, $meta[0]->value );
+ $this->assertNotNull( $meta[0]->id );
+
+ self::$order_fulfillment_data_store->delete_meta( $fulfillment, $meta[0] ); // phpcs:ignore
+
+ global $wpdb;
+ $db_metadata = $wpdb->get_results(
+ $wpdb->prepare(
+ "SELECT * FROM {$wpdb->prefix}wc_order_fulfillment_meta WHERE fulfillment_id = %d",
+ $fulfillment->get_id()
+ )
+ );
+ $this->assertCount( 0, $db_metadata );
+ }
+
+ /**
+ * Tests the add_meta method of the order fulfillment data store.
+ */
+ public function test_add_fulfillment_meta() {
+ $items = array(
+ array(
+ 'item_id' => 1,
+ 'qty' => 2,
+ ),
+ array(
+ 'item_id' => 2,
+ 'qty' => 3,
+ ),
+ );
+
+ $fulfillment = new Fulfillment();
+ $fulfillment->set_entity_id( '123' );
+ $fulfillment->set_entity_type( 'order-fulfillment' );
+ $fulfillment->set_status( 'unfulfilled' );
+ $fulfillment->set_items( $items );
+ $fulfillment->save();
+
+ $this->assertNotEquals( 0, $fulfillment->get_id() );
+
+ self::$order_fulfillment_data_store->add_meta(
+ $fulfillment,
+ new WC_Meta_Data(
+ array(
+ 'key' => '_new_meta_key',
+ 'value' => 'new_meta_value',
+ )
+ )
+ );
+
+ global $wpdb;
+ $db_metadata = $wpdb->get_results(
+ $wpdb->prepare(
+ "SELECT * FROM {$wpdb->prefix}wc_order_fulfillment_meta WHERE fulfillment_id = %d",
+ $fulfillment->get_id()
+ )
+ );
+ foreach ( $db_metadata as $meta ) {
+ if ( '_new_meta_key' === $meta->meta_key ) {
+ break;
+ }
+ }
+
+ if ( ! isset( $meta ) ) {
+ self::fail( 'Meta not found in database.' );
+ return;
+ }
+
+ self::assertEquals( 'new_meta_value', json_decode( $meta->meta_value ) );
+ }
+
+ /**
+ * Tests the update_meta method of the order fulfillment data store.
+ */
+ public function test_update_fulfillment_meta() {
+ $items = array(
+ array(
+ 'item_id' => 1,
+ 'qty' => 2,
+ ),
+ array(
+ 'item_id' => 2,
+ 'qty' => 3,
+ ),
+ );
+
+ $fulfillment = new Fulfillment();
+ $fulfillment->set_entity_id( '123' );
+ $fulfillment->set_entity_type( 'order-fulfillment' );
+ $fulfillment->set_status( 'unfulfilled' );
+ $fulfillment->set_items( $items );
+ $fulfillment->save();
+
+ $this->assertNotEquals( 0, $fulfillment->get_id() );
+ $new_items = array(
+ array(
+ 'item_id' => 3,
+ 'qty' => 4,
+ ),
+ array(
+ 'item_id' => 4,
+ 'qty' => 5,
+ ),
+ );
+ $fulfillment->set_items( $new_items );
+ $new_metadata = $fulfillment->get_meta_data();
+ $this->assertCount( 1, $new_metadata );
+ $this->assertEquals( '_items', $new_metadata[0]->key );
+
+ $result = self::$order_fulfillment_data_store->update_meta( $fulfillment, $new_metadata[0] );
+
+ $this->assertEquals( 1, $result );
+ }
+
+ /**
+ * Tests reading multiple fulfillments.
+ */
+ public function test_read_fulfillments() {
+ $this->prepare_db_for_test();
+ $fulfillments = self::$order_fulfillment_data_store->read_fulfillments( 'order-fulfillment', '123' );
+ $this->assertCount( 2, $fulfillments );
+ $this->assertEquals( '123', $fulfillments[0]->get_entity_id() );
+ $this->assertEquals( 'order-fulfillment', $fulfillments[0]->get_entity_type() );
+ $this->assertEquals(
+ array(
+ array(
+ 'item_id' => 1,
+ 'qty' => 2,
+ ),
+
+ ),
+ $fulfillments[0]->get_items(),
+ );
+ $this->assertEquals( '123', $fulfillments[1]->get_entity_id() );
+ $this->assertEquals( 'order-fulfillment', $fulfillments[1]->get_entity_type() );
+ $this->assertEquals(
+ array(
+ array(
+ 'item_id' => 4,
+ 'qty' => 5,
+ ),
+ ),
+ $fulfillments[1]->get_items(),
+ );
+ }
+
+ /**
+ * Tests that deleted fulfillments can be read by ID.
+ */
+ public function test_read_deleted_fulfillment_by_id() {
+ $fulfillment = new Fulfillment();
+ $fulfillment->set_entity_type( 'order-fulfillment' );
+ $fulfillment->set_entity_id( '123' );
+ $fulfillment->set_status( 'unfulfilled' );
+ $fulfillment->set_items(
+ array(
+ array(
+ 'item_id' => 1,
+ 'qty' => 2,
+ ),
+ )
+ );
+ self::$order_fulfillment_data_store->create( $fulfillment );
+
+ $fulfillment_id = $fulfillment->get_id();
+ $this->assertNotNull( $fulfillment_id );
+
+ // Delete the fulfillment.
+ self::$order_fulfillment_data_store->delete( $fulfillment );
+
+ // Create a new fulfillment object and try to read the deleted one.
+ $deleted_fulfillment = new Fulfillment();
+ $deleted_fulfillment->set_id( $fulfillment_id );
+
+ // Should be able to read deleted fulfillment by ID.
+ self::$order_fulfillment_data_store->read( $deleted_fulfillment );
+
+ $this->assertEquals( $fulfillment_id, $deleted_fulfillment->get_id() );
+ $this->assertEquals( 'order-fulfillment', $deleted_fulfillment->get_entity_type() );
+ $this->assertEquals( '123', $deleted_fulfillment->get_entity_id() );
+ $this->assertNotNull( $deleted_fulfillment->get_date_deleted() );
+ }
+
+ /**
+ * Tests that deleted fulfillments cannot be updated.
+ */
+ public function test_update_deleted_fulfillment_fails() {
+ $fulfillment = new Fulfillment();
+ $fulfillment->set_entity_type( 'order-fulfillment' );
+ $fulfillment->set_entity_id( '123' );
+ $fulfillment->set_status( 'unfulfilled' );
+ $fulfillment->set_items(
+ array(
+ array(
+ 'item_id' => 1,
+ 'qty' => 2,
+ ),
+ )
+ );
+ self::$order_fulfillment_data_store->create( $fulfillment );
+
+ $fulfillment_id = $fulfillment->get_id();
+ $this->assertNotNull( $fulfillment_id );
+
+ // Delete the fulfillment.
+ self::$order_fulfillment_data_store->delete( $fulfillment );
+
+ // Create a new fulfillment object and read the deleted one.
+ $deleted_fulfillment = new Fulfillment();
+ $deleted_fulfillment->set_id( $fulfillment_id );
+ self::$order_fulfillment_data_store->read( $deleted_fulfillment );
+
+ // Try to update the deleted fulfillment - should not affect any rows.
+ $deleted_fulfillment->set_entity_id( '456' );
+ $deleted_fulfillment->set_status( 'fulfilled' );
+
+ // Update should not throw an error but should not affect any rows.
+ self::$order_fulfillment_data_store->update( $deleted_fulfillment );
+
+ // Verify the database record was not updated.
+ global $wpdb;
+ $record = $wpdb->get_row(
+ $wpdb->prepare(
+ "SELECT * FROM {$wpdb->prefix}wc_order_fulfillments WHERE fulfillment_id = %d",
+ $fulfillment_id
+ )
+ );
+
+ $this->assertNotNull( $record );
+ $this->assertEquals( '123', $record->entity_id ); // Should still be original value.
+ $this->assertEquals( 'unfulfilled', $record->status ); // Should still be original value.
+ $this->assertNotNull( $record->date_deleted ); // Should still be deleted.
+ }
+
+ /**
+ * Tests that deleting an already deleted fulfillment returns early without side effects.
+ */
+ public function test_delete_already_deleted_fulfillment_returns_early() {
+ $fulfillment = new Fulfillment();
+ $fulfillment->set_entity_type( 'order-fulfillment' );
+ $fulfillment->set_entity_id( '123' );
+ $fulfillment->set_status( 'unfulfilled' );
+ $fulfillment->set_items(
+ array(
+ array(
+ 'item_id' => 1,
+ 'qty' => 2,
+ ),
+ )
+ );
+ self::$order_fulfillment_data_store->create( $fulfillment );
+
+ $fulfillment_id = $fulfillment->get_id();
+ $this->assertNotNull( $fulfillment_id );
+
+ // Delete the fulfillment the first time.
+ self::$order_fulfillment_data_store->delete( $fulfillment );
+
+ // At this point, the fulfillment object should be reset.
+ $this->assertEquals( 0, $fulfillment->get_id() );
+
+ // Read the deleted fulfillment back.
+ $deleted_fulfillment = new Fulfillment();
+ $deleted_fulfillment->set_id( $fulfillment_id );
+ self::$order_fulfillment_data_store->read( $deleted_fulfillment );
+
+ $first_deletion_time = $deleted_fulfillment->get_date_deleted();
+ $this->assertNotNull( $first_deletion_time );
+
+ // Track action calls to verify hooks are not called on second delete.
+ $before_delete_called = false;
+ $after_delete_called = false;
+
+ add_action(
+ 'woocommerce_fulfillment_before_delete',
+ function () use ( &$before_delete_called ) {
+ $before_delete_called = true;
+ }
+ );
+
+ add_action(
+ 'woocommerce_fulfillment_after_delete',
+ function () use ( &$after_delete_called ) {
+ $after_delete_called = true;
+ }
+ );
+
+ // Try to delete the already deleted fulfillment - should return early.
+ self::$order_fulfillment_data_store->delete( $deleted_fulfillment );
+
+ // Verify hooks were not called.
+ $this->assertFalse( $before_delete_called );
+ $this->assertFalse( $after_delete_called );
+
+ // Verify the fulfillment object was not reset again.
+ $this->assertEquals( $fulfillment_id, $deleted_fulfillment->get_id() );
+ $this->assertEquals( 'order-fulfillment', $deleted_fulfillment->get_entity_type() );
+ $this->assertEquals( '123', $deleted_fulfillment->get_entity_id() );
+ $this->assertEquals( $first_deletion_time, $deleted_fulfillment->get_date_deleted() );
+
+ // Verify the database record was not modified.
+ global $wpdb;
+ $record = $wpdb->get_row(
+ $wpdb->prepare(
+ "SELECT * FROM {$wpdb->prefix}wc_order_fulfillments WHERE fulfillment_id = %d",
+ $fulfillment_id
+ )
+ );
+
+ $this->assertNotNull( $record );
+ $this->assertEquals( $first_deletion_time, $record->date_deleted );
+ }
+
+ /**
+ * Create a test fulfillment and save it to the database.
+ *
+ * @param string $entity_type The entity type.
+ * @param string $entity_id The entity ID.
+ * @param array $items The items to fulfill.
+ *
+ * @return Fulfillment The created fulfillment object.
+ */
+ private function create_test_fulfillment( string $entity_type, string $entity_id, array $items ) {
+ $fulfillment = new Fulfillment();
+ $fulfillment->set_id( 0 );
+ $fulfillment->set_entity_type( $entity_type );
+ $fulfillment->set_entity_id( $entity_id );
+ $fulfillment->set_status( 'unfulfilled' );
+ $fulfillment->set_items( $items );
+ $fulfillment->save();
+ $fulfillment->save_meta_data();
+
+ $this->assertNotEquals( 0, $fulfillment->get_id() );
+
+ $this->assertFulfillmentRecordInDB( $fulfillment );
+ $this->assertFulfillmentMetaInDB( $fulfillment );
+
+ return $fulfillment;
+ }
+
+ /**
+ * Creates fulfillment records in the database for testing.
+ */
+ private function prepare_db_for_test() {
+ $this->create_test_fulfillment(
+ 'order-fulfillment',
+ '123',
+ array(
+ array(
+ 'item_id' => 1,
+ 'qty' => 2,
+ ),
+ )
+ );
+ $this->create_test_fulfillment(
+ 'order-fulfillment',
+ '456',
+ array(
+ array(
+ 'item_id' => 2,
+ 'qty' => 3,
+ ),
+ )
+ );
+ $this->create_test_fulfillment(
+ 'order-fulfillment',
+ '789',
+ array(
+ array(
+ 'item_id' => 3,
+ 'qty' => 4,
+ ),
+ )
+ );
+ $this->create_test_fulfillment(
+ 'order-fulfillment',
+ '123',
+ array(
+ array(
+ 'item_id' => 4,
+ 'qty' => 5,
+ ),
+ )
+ );
+ $this->create_test_fulfillment(
+ 'order-fulfillment',
+ '456',
+ array(
+ array(
+ 'item_id' => 5,
+ 'qty' => 6,
+ ),
+ )
+ );
+ }
+
+ /**
+ * Asserts that a fulfillment record exists in the database.
+ *
+ * @param Fulfillment $fulfillment The fulfillment object.
+ * @param int $deleted_id The ID of the deleted record.
+ * @param bool $is_deleted Whether the record is deleted.
+ */
+ private function assertFulfillmentRecordInDB( Fulfillment $fulfillment, int $deleted_id = 0, bool $is_deleted = false ) {
+ global $wpdb;
+
+ $fulfillment_id = $is_deleted ? $deleted_id : $fulfillment->get_id();
+ $record = $wpdb->get_row(
+ $wpdb->prepare(
+ "SELECT * FROM {$wpdb->prefix}wc_order_fulfillments WHERE fulfillment_id = %d",
+ $fulfillment_id
+ )
+ );
+
+ if ( ! $is_deleted ) {
+ $this->assertNotNull( $record );
+ $this->assertEquals( $fulfillment->get_entity_type(), $record->entity_type );
+ $this->assertEquals( $fulfillment->get_entity_id(), $record->entity_id );
+ $this->assertEquals( $fulfillment->get_date_updated(), $record->date_updated );
+ $this->assertEquals( $fulfillment->get_date_deleted(), $record->date_deleted );
+ } else {
+ $this->assertNotNull( $record );
+ $this->assertNotEquals( $fulfillment->get_id(), $record->fulfillment_id );
+ $this->assertNotEquals( null, $record->date_deleted );
+ }
+ }
+
+ /**
+ * Asserts that a fulfillment record metadata matches the expected value.
+ *
+ * @param Fulfillment $fulfillment The fulfillment object.
+ * @param int $deleted_id The ID of the deleted record, if deleted.
+ * @param array|null $metadata The metadata to check.
+ */
+ private function assertFulfillmentMetaInDB( Fulfillment $fulfillment, int $deleted_id = 0, ?array $metadata = null ) {
+ global $wpdb;
+
+ $fulfillment_id = 0 === $deleted_id ? $fulfillment->get_id() : $deleted_id;
+
+ if ( null === $metadata ) {
+ $metadata = $fulfillment->get_meta_data();
+ }
+
+ $records = $wpdb->get_results(
+ $wpdb->prepare(
+ "SELECT * FROM {$wpdb->prefix}wc_order_fulfillment_meta WHERE fulfillment_id = %d",
+ $fulfillment_id,
+ ),
+ OBJECT
+ );
+
+ foreach ( $metadata as $meta ) {
+ $meta_key = $meta->key;
+ $meta_value = $meta->value;
+ $record = array_filter(
+ $records,
+ function ( $record ) use ( $meta_key ) {
+ return $record->meta_key === $meta_key;
+ }
+ );
+
+ $this->assertNotEmpty( $record, "$meta_key is empty" );
+ $this->assertEquals( $meta_value, json_decode( reset( $record )->meta_value, true ) );
+ }
+ }
+}
diff --git a/plugins/woocommerce/tests/php/src/Internal/Fulfillments/FulfillmentTest.php b/plugins/woocommerce/tests/php/src/Internal/Fulfillments/FulfillmentTest.php
new file mode 100644
index 0000000000..10ff88c207
--- /dev/null
+++ b/plugins/woocommerce/tests/php/src/Internal/Fulfillments/FulfillmentTest.php
@@ -0,0 +1,256 @@
+<?php declare( strict_types=1 );
+
+namespace Automattic\WooCommerce\Tests\Internal\Fulfillments;
+
+use Automattic\WooCommerce\Internal\Fulfillments\Fulfillment;
+use Automattic\WooCommerce\Tests\Internal\Fulfillments\Helpers\FulfillmentsHelper;
+use WC_Order;
+
+/**
+ * Tests for Fulfillment object.
+ */
+class FulfillmentTest extends \WC_Unit_Test_Case {
+
+ /**
+ * Set up the test environment.
+ */
+ public static function setUpBeforeClass(): void {
+ parent::setUpBeforeClass();
+ update_option( 'woocommerce_feature_fulfillments_enabled', 'yes' );
+ wc_get_container()->get( \Automattic\WooCommerce\Internal\Fulfillments\FulfillmentsController::class )->register();
+ }
+
+ /**
+ * Tear down the test environment.
+ */
+ public static function tearDownAfterClass(): void {
+ update_option( 'woocommerce_feature_fulfillments_enabled', 'no' );
+ parent::tearDownAfterClass();
+ }
+
+ /**
+ * Test that the Fulfillment object can be created.
+ */
+ public function test_fulfillment_object() {
+ $fulfillment = new Fulfillment();
+ $this->assertInstanceOf( Fulfillment::class, $fulfillment );
+ }
+
+ /**
+ * Test that the Fulfillment object can be created with an ID.
+ */
+ public function test_fulfillment_object_with_id_fetches_data_and_metadata() {
+ $order = \Automattic\WooCommerce\RestApi\UnitTests\Helpers\OrderHelper::create_order();
+ $db_fulfillment = FulfillmentsHelper::create_fulfillment(
+ array(
+ 'entity_id' => $order->get_id(),
+ )
+ );
+ $fulfillment = new Fulfillment( $db_fulfillment->get_id() );
+
+ $this->assertInstanceOf( Fulfillment::class, $fulfillment );
+ $this->assertEquals( $db_fulfillment->get_id(), $fulfillment->get_id() );
+ $this->assertEquals( $db_fulfillment->get_entity_type(), $fulfillment->get_entity_type() );
+ $this->assertEquals( $db_fulfillment->get_entity_id(), $fulfillment->get_entity_id() );
+ $this->assertEquals( $db_fulfillment->get_date_updated(), $fulfillment->get_date_updated() );
+ $this->assertEquals( $db_fulfillment->get_date_deleted(), $fulfillment->get_date_deleted() );
+ $this->assertEquals( $db_fulfillment->get_items(), $fulfillment->get_items() );
+ $this->assertEquals( $db_fulfillment->get_meta_data(), $fulfillment->get_meta_data() );
+ }
+
+ /**
+ * Test that Fulfillment object can be updated.
+ */
+ public function test_fulfillment_object_update() {
+ $fulfillment = FulfillmentsHelper::create_fulfillment(
+ array(
+ 'entity_type' => 'order-fulfillment',
+ 'entity_id' => 123,
+ )
+ );
+
+ $fulfillment->set_entity_type( 'updated-entity-type' );
+ $fulfillment->set_entity_id( '456' );
+ $fulfillment->save();
+
+ $this->assertEquals( 'updated-entity-type', $fulfillment->get_entity_type() );
+ $this->assertEquals( 456, $fulfillment->get_entity_id() );
+ }
+
+ /**
+ * Test that Fulfillment object can be soft deleted.
+ */
+ public function test_fulfillment_object_soft_delete() {
+ $fulfillment = FulfillmentsHelper::create_fulfillment(
+ array(
+ 'entity_type' => 'order-fulfillment',
+ 'entity_id' => 123,
+ )
+ );
+
+ $fulfillment_id = $fulfillment->get_id();
+ $this->assertNotEquals( 0, $fulfillment_id );
+
+ $fulfillment->delete();
+
+ // Verify the fulfillment can still be read but is marked as deleted.
+ $deleted_fulfillment = new Fulfillment( $fulfillment_id );
+ $this->assertNotNull( $deleted_fulfillment->get_date_deleted(), 'Fulfillment should be marked as deleted.' );
+ }
+
+ /**
+ * Test that Fulfillment object can be created with items.
+ */
+ public function test_fulfillment_object_with_items() {
+ $fulfillment = FulfillmentsHelper::create_fulfillment(
+ array(
+ 'entity_type' => 'order-fulfillment',
+ 'entity_id' => 123,
+ )
+ );
+
+ $items = array(
+ array(
+ 'item_id' => 1,
+ 'qty' => 2,
+ ),
+ array(
+ 'item_id' => 2,
+ 'qty' => 3,
+ ),
+ );
+
+ $fulfillment->set_items( $items );
+ $fulfillment->save();
+
+ $fresh_fulfillment = new Fulfillment( $fulfillment->get_id() );
+ $this->assertInstanceOf( Fulfillment::class, $fresh_fulfillment );
+ $this->assertEquals( $fulfillment->get_id(), $fresh_fulfillment->get_id() );
+
+ $this->assertEquals( $items, $fresh_fulfillment->get_items() );
+ }
+
+ /**
+ * Test that Fulfillment object can be created with metadata.
+ */
+ public function test_fulfillment_object_with_metadata() {
+ $fulfillment = FulfillmentsHelper::create_fulfillment(
+ array(
+ 'entity_type' => 'order-fulfillment',
+ 'entity_id' => 123,
+ )
+ );
+
+ $fulfillment->add_meta_data( 'test_meta_key', 'test_meta_value', true );
+ $fulfillment->save();
+
+ $this->assertEquals( 'test_meta_value', $fulfillment->get_meta( 'test_meta_key' ) );
+ }
+
+ /**
+ * Test that metadata can be updated.
+ */
+ public function test_fulfillment_object_update_metadata() {
+ $fulfillment = FulfillmentsHelper::create_fulfillment(
+ array(
+ 'entity_type' => 'order-fulfillment',
+ 'entity_id' => 123,
+ )
+ );
+
+ $fulfillment->add_meta_data( 'test_meta_key', 'test_meta_value', true );
+ $fulfillment->save();
+
+ $fulfillment->update_meta_data( 'test_meta_key', 'updated_meta_value' );
+ $fulfillment->save();
+
+ $this->assertEquals( 'updated_meta_value', $fulfillment->get_meta( 'test_meta_key' ) );
+ }
+
+ /**
+ * Test that metadata can be deleted.
+ */
+ public function test_fulfillment_object_delete_metadata() {
+ $fulfillment = FulfillmentsHelper::create_fulfillment(
+ array(
+ 'entity_type' => 'order-fulfillment',
+ 'entity_id' => 123,
+ )
+ );
+
+ $fulfillment->add_meta_data( 'test_meta_key', 'test_meta_value', true );
+ $fulfillment->save();
+
+ $fulfillment->delete_meta_data( 'test_meta_key' );
+ $fulfillment->save();
+
+ $this->assertEquals( '', $fulfillment->get_meta( 'test_meta_key' ) );
+ }
+
+ /**
+ * Test getting order from the Fulfillment object.
+ */
+ public function test_get_order() {
+ $order = \Automattic\WooCommerce\RestApi\UnitTests\Helpers\OrderHelper::create_order();
+ $fulfillment = FulfillmentsHelper::create_fulfillment(
+ array(
+ 'entity_type' => WC_Order::class,
+ 'entity_id' => $order->get_id(),
+ )
+ );
+
+ $this->assertInstanceOf( \WC_Order::class, $fulfillment->get_order() );
+ $this->assertEquals( $order->get_id(), $fulfillment->get_order()->get_id() );
+ }
+
+ /**
+ * Test fulfillment locking functionality.
+ */
+ public function test_fulfillment_locking() {
+ $fulfillment = FulfillmentsHelper::create_fulfillment(
+ array(
+ 'entity_type' => 'order-fulfillment',
+ 'entity_id' => 123,
+ )
+ );
+
+ $this->assertFalse( $fulfillment->is_locked() );
+
+ $fulfillment->set_locked( true, 'Test lock message' );
+ $this->assertTrue( $fulfillment->is_locked() );
+ $this->assertEquals( 'Test lock message', $fulfillment->get_meta( '_lock_message' ) );
+
+ $fulfillment->set_locked( false );
+ $this->assertFalse( $fulfillment->is_locked() );
+ $this->assertEquals( '', $fulfillment->get_meta( '_lock_message' ) );
+ }
+
+ /**
+ * Test that the fulfillment status is validated correctly, and the fallback doesn't change is_fulfilled flag.
+ */
+ public function test_fulfillment_status_validation() {
+ $fulfillment = FulfillmentsHelper::create_fulfillment(
+ array(
+ 'entity_type' => 'order-fulfillment',
+ 'entity_id' => 123,
+ )
+ );
+ $fulfillment->set_status( 'unfulfilled' );
+ $this->assertEquals( 'unfulfilled', $fulfillment->get_status() );
+ $this->assertEquals( false, $fulfillment->get_is_fulfilled() );
+
+ // Fallback to unfulfilled if an invalid status is set (is_fulfilled is false).
+ $fulfillment->set_status( 'invalid_status' );
+ $this->assertEquals( 'unfulfilled', $fulfillment->get_status() );
+ $this->assertEquals( false, $fulfillment->get_is_fulfilled() );
+
+ $fulfillment->set_status( 'fulfilled' );
+ $this->assertEquals( 'fulfilled', $fulfillment->get_status() );
+ $this->assertEquals( true, $fulfillment->get_is_fulfilled() );
+
+ // Fallback to fulfilled if an invalid status is set (is_fulfilled is true).
+ $fulfillment->set_status( 'invalid_status' );
+ $this->assertEquals( 'fulfilled', $fulfillment->get_status() );
+ $this->assertEquals( true, $fulfillment->get_is_fulfilled() );
+ }
+}
diff --git a/plugins/woocommerce/tests/php/src/Internal/Fulfillments/FulfillmentUtilsTest.php b/plugins/woocommerce/tests/php/src/Internal/Fulfillments/FulfillmentUtilsTest.php
new file mode 100644
index 0000000000..10e060f719
--- /dev/null
+++ b/plugins/woocommerce/tests/php/src/Internal/Fulfillments/FulfillmentUtilsTest.php
@@ -0,0 +1,74 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Tests\Internal\Fulfillments;
+
+use Automattic\WooCommerce\Internal\Fulfillments\FulfillmentUtils;
+
+/**
+ * FulfillmentUtilsTest class.
+ */
+class FulfillmentUtilsTest extends \WC_Unit_Test_Case {
+ /**
+ * Set up the test environment.
+ */
+ public static function setUpBeforeClass(): void {
+ parent::setUpBeforeClass();
+ update_option( 'woocommerce_feature_fulfillments_enabled', 'yes' );
+ wc_get_container()->get( \Automattic\WooCommerce\Internal\Fulfillments\FulfillmentsController::class )->register();
+ }
+
+ /**
+ * Tear down the test environment.
+ */
+ public static function tearDownAfterClass(): void {
+ update_option( 'woocommerce_feature_fulfillments_enabled', 'no' );
+ parent::tearDownAfterClass();
+ }
+
+ /**
+ * Test that plugins can extend the order fulfillment statuses.
+ */
+ public function test_order_fulfillment_statuses_extension() {
+ add_filter(
+ 'woocommerce_fulfillment_order_fulfillment_statuses',
+ function ( $statuses ) {
+ $statuses['custom_status'] = __( 'Custom Status', 'woocommerce' );
+ return $statuses;
+ }
+ );
+
+ $statuses = FulfillmentUtils::get_order_fulfillment_statuses();
+
+ // Check that the default statuses are present.
+ $this->assertArrayHasKey( 'unfulfilled', $statuses );
+ $this->assertArrayHasKey( 'fulfilled', $statuses );
+ $this->assertArrayHasKey( 'partially_fulfilled', $statuses );
+
+ // Check that a custom status added by a plugin is present.
+ $this->assertArrayHasKey( 'custom_status', $statuses );
+ }
+
+ /**
+ * Test that the get_fulfillment_statuses method returns the correct statuses.
+ */
+ public function test_get_fulfillment_statuses() {
+ add_filter(
+ 'woocommerce_fulfillment_fulfillment_statuses',
+ function ( $statuses ) {
+ $statuses['custom_status'] = array(
+ 'label' => __( 'Custom Status', 'woocommerce' ),
+ 'is_fulfilled' => false,
+ 'background_color' => '#f0f0f0',
+ 'text_color' => '#000000',
+ );
+ return $statuses;
+ }
+ );
+
+ $fulfillment_statuses = FulfillmentUtils::get_fulfillment_statuses();
+ $this->assertArrayHasKey( 'unfulfilled', $fulfillment_statuses );
+ $this->assertArrayHasKey( 'fulfilled', $fulfillment_statuses );
+ $this->assertArrayHasKey( 'custom_status', $fulfillment_statuses );
+ $this->assertEquals( 'Custom Status', $fulfillment_statuses['custom_status']['label'] );
+ }
+}
diff --git a/plugins/woocommerce/tests/php/src/Internal/Fulfillments/FulfillmentsManagerTest.php b/plugins/woocommerce/tests/php/src/Internal/Fulfillments/FulfillmentsManagerTest.php
new file mode 100644
index 0000000000..68031bfcfe
--- /dev/null
+++ b/plugins/woocommerce/tests/php/src/Internal/Fulfillments/FulfillmentsManagerTest.php
@@ -0,0 +1,295 @@
+<?php declare( strict_types=1 );
+
+namespace Automattic\WooCommerce\Tests\Internal\Fulfillments;
+
+use Automattic\WooCommerce\Internal\Fulfillments\FulfillmentsManager;
+use Automattic\WooCommerce\RestApi\UnitTests\Helpers\OrderHelper;
+use Automattic\WooCommerce\Tests\Internal\Fulfillments\Helpers\FulfillmentsHelper;
+use Automattic\WooCommerce\Testing\Tools\TestingContainer;
+use Automattic\WooCommerce\Tests\Internal\Fulfillments\Helpers\ShippingProviderMock;
+use WC_Order;
+
+/**
+ * Tests for Fulfillment object.
+ */
+class FulfillmentsManagerTest extends \WC_Unit_Test_Case {
+
+ /**
+ * @var FulfillmentsManager
+ */
+ private FulfillmentsManager $manager;
+
+ /**
+ * Set up the test environment.
+ */
+ public static function setUpBeforeClass(): void {
+ parent::setUpBeforeClass();
+ update_option( 'woocommerce_feature_fulfillments_enabled', 'yes' );
+ wc_get_container()->get( \Automattic\WooCommerce\Internal\Fulfillments\FulfillmentsController::class )->register();
+ }
+
+ /**
+ * Tear down the test environment.
+ */
+ public static function tearDownAfterClass(): void {
+ update_option( 'woocommerce_feature_fulfillments_enabled', 'no' );
+ parent::tearDownAfterClass();
+ }
+
+ /**
+ * Set up the test case.
+ */
+ public function setUp(): void {
+ parent::setUp();
+ $this->manager = new FulfillmentsManager();
+ }
+
+ /**
+ * Test hooks.
+ */
+ public function test_hooks() {
+ $this->assertNotFalse( has_filter( 'woocommerce_fulfillment_translate_meta_key', array( $this->manager, 'translate_fulfillment_meta_key' ) ) );
+ }
+
+ /**
+ * Test the translate_fulfillment_meta_key method.
+ */
+ public function test_translate_fulfillment_meta_key() {
+ // Test with a known meta key.
+ $translated_key = $this->manager->translate_fulfillment_meta_key( 'fulfillment_status' );
+ $this->assertEquals( __( 'Fulfillment Status', 'woocommerce' ), $translated_key );
+
+ // Test with an unknown meta key.
+ $translated_key = $this->manager->translate_fulfillment_meta_key( 'unknown_meta_key' );
+ $this->assertEquals( 'unknown_meta_key', $translated_key );
+ }
+
+ /**
+ * Test extending the translation of a fulfillment meta key.
+ */
+ public function test_extend_translate_fulfillment_meta_key() {
+ // Extend the translations.
+ add_filter(
+ 'woocommerce_fulfillment_meta_key_translations',
+ function ( $translations ) {
+ $translations['custom_meta_key'] = __( 'Custom Meta Key', 'woocommerce' );
+ return $translations;
+ }
+ );
+
+ // Test the extended translation.
+ $translated_key = $this->manager->translate_fulfillment_meta_key( 'custom_meta_key' );
+ $this->assertEquals( __( 'Custom Meta Key', 'woocommerce' ), $translated_key );
+ }
+
+ /**
+ * Test that the filter for translating fulfillment meta keys works correctly.
+ */
+ public function test_translate_fulfillment_meta_key_with_filter() {
+
+ // Add a filter to modify the translations.
+ add_filter(
+ 'woocommerce_fulfillment_meta_key_translations',
+ function ( $translations ) {
+ $translations['custom_meta_key'] = __( 'Custom Meta Key', 'woocommerce' );
+ return $translations;
+ }
+ );
+
+ /**
+ * Filter to translate fulfillment meta keys.
+ *
+ * @since 10.1.0
+ */
+ $translated_key = apply_filters( 'woocommerce_fulfillment_translate_meta_key', 'custom_meta_key' );
+ $this->assertEquals( __( 'Custom Meta Key', 'woocommerce' ), $translated_key );
+ }
+
+ /**
+ * Test that the initial shipping providers are loaded correctly.
+ */
+ public function test_get_initial_shipping_providers() {
+ /**
+ * Filter to get initial shipping providers
+ *
+ * @since 10.1.0
+ */
+ $shipping_providers = apply_filters( 'woocommerce_fulfillment_shipping_providers', array() );
+ // Check if the shipping providers are loaded correctly.
+ $this->assertIsArray( $shipping_providers );
+ $this->assertNotEmpty( $shipping_providers );
+ }
+
+ /**
+ * Test that the initial shipping providers can be extended.
+ */
+ public function test_extend_initial_shipping_providers() {
+ // Extend the shipping providers.
+ add_filter(
+ 'woocommerce_fulfillment_shipping_providers',
+ function ( $providers ) {
+ $providers['custom_provider'] = array(
+ 'label' => __( 'Custom Provider', 'woocommerce' ),
+ 'icon' => 'custom-icon',
+ 'value' => 'custom_provider',
+ );
+ return $providers;
+ }
+ );
+
+ /**
+ * Filter to get initial shipping providers.
+ *
+ * @since 10.1.0
+ */
+ $shipping_providers = apply_filters( 'woocommerce_fulfillment_shipping_providers', array() );
+
+ // Check if the custom provider is included.
+ $this->assertArrayHasKey( 'custom_provider', $shipping_providers );
+ $this->assertIsArray( $shipping_providers['custom_provider'] );
+ $this->assertArrayHasKey( 'label', $shipping_providers['custom_provider'] );
+ $this->assertEquals( __( 'Custom Provider', 'woocommerce' ), $shipping_providers['custom_provider']['label'] );
+ }
+
+ /**
+ * Test that the fulfillment status hooks are initialized correctly.
+ */
+ public function test_init_fulfillment_status_hooks() {
+ $this->assertNotFalse( has_action( 'woocommerce_fulfillment_after_create', array( $this->manager, 'update_order_fulfillment_status_on_fulfillment_update' ) ) );
+ $this->assertNotFalse( has_action( 'woocommerce_fulfillment_after_update', array( $this->manager, 'update_order_fulfillment_status_on_fulfillment_update' ) ) );
+ $this->assertNotFalse( has_action( 'woocommerce_fulfillment_after_delete', array( $this->manager, 'update_order_fulfillment_status_on_fulfillment_update' ) ) );
+ }
+
+ /**
+ * Test that the fulfillment status is updated on fulfillment creation.
+ */
+ public function test_update_order_fulfillment_status_on_fulfillment_updates() {
+ $fulfillments = array();
+ $product = \WC_Helper_Product::create_simple_product();
+ $order = OrderHelper::create_order( get_current_user_id(), $product );
+ $this->assertEmpty( $order->get_meta( '_fulfillment_status' ) );
+
+ $fulfillments[] = FulfillmentsHelper::create_fulfillment(
+ array(
+ 'entity_type' => WC_Order::class,
+ 'entity_id' => $order->get_id(),
+ 'status' => 'unfulfilled',
+ 'is_fulfilled' => false,
+ ),
+ array(
+ '_items' => array(
+ array(
+ 'item_id' => $product->get_id(),
+ 'qty' => 1,
+ ),
+ ),
+ )
+ );
+ $this->assertTrue( did_action( 'woocommerce_fulfillment_after_create' ) > 0 );
+ $order = wc_get_order( $order->get_id() );
+ $this->assertEquals( 'unfulfilled', $order->get_meta( '_fulfillment_status', true ) );
+
+ $fulfillments[0]->set_status( 'fulfilled' );
+ $fulfillments[0]->save();
+
+ $this->assertTrue( did_action( 'woocommerce_fulfillment_after_update' ) > 0 );
+ $order = wc_get_order( $order->get_id() );
+ $this->assertEquals( 'partially_fulfilled', $order->get_meta( '_fulfillment_status' ) );
+
+ $fulfillments[0]->delete();
+ $this->assertTrue( did_action( 'woocommerce_fulfillment_after_delete' ) > 0 );
+ $order = wc_get_order( $order->get_id() );
+ $this->assertEquals( '', $order->get_meta( '_fulfillment_status' ) );
+ }
+
+ /**
+ * Test that the tracking number can be parsed correctly.
+ */
+ public function test_try_parse_tracking_number_nominal() {
+ $tracking_number = '1234567890';
+
+ /**
+ * TestingContainer instance.
+ *
+ * @var TestingContainer $container
+ */
+ $container = wc_get_container();
+ $mock_provider = $this->getMockBuilder( ShippingProviderMock::class )->onlyMethods( array( 'try_parse_tracking_number' ) )->getMock();
+ $container->replace( ShippingProviderMock::class, $mock_provider );
+ add_filter(
+ 'woocommerce_fulfillment_shipping_providers',
+ function ( $providers ) {
+ $providers = array(
+ 'custom_provider' => ShippingProviderMock::class,
+ );
+ return $providers;
+ }
+ );
+
+ $mock_provider->expects( $this->once() )
+ ->method( 'try_parse_tracking_number' )
+ ->willReturn(
+ array(
+ 'url' => 'https://example.com/track?number=' . $tracking_number,
+ )
+ );
+
+ // Test with a valid tracking number.
+ $parsed_number = $this->manager->try_parse_tracking_number( $tracking_number, 'US', 'CA' );
+ $this->assertEquals( $tracking_number, $parsed_number['tracking_number'] );
+ $this->assertEquals( 'mock_shipping_provider', $parsed_number['shipping_provider'] );
+ $this->assertEquals( 'https://example.com/track?number=' . $tracking_number, $parsed_number['tracking_url'] );
+ }
+
+ /**
+ * Test tracking number parsing without any matches.
+ */
+ public function test_try_parse_tracking_number_no_match() {
+ $tracking_number = '1234567890';
+
+ /**
+ * TestingContainer instance.
+ *
+ * @var TestingContainer $container
+ */
+ $container = wc_get_container();
+ $mock_provider = $this->getMockBuilder( ShippingProviderMock::class )->onlyMethods( array( 'try_parse_tracking_number' ) )->getMock();
+ $container->replace( ShippingProviderMock::class, $mock_provider );
+ add_filter(
+ 'woocommerce_fulfillment_shipping_providers',
+ function ( $providers ) {
+ $providers = array(
+ 'custom_provider' => ShippingProviderMock::class,
+ );
+ return $providers;
+ }
+ );
+
+ $mock_provider->expects( $this->once() )
+ ->method( 'try_parse_tracking_number' )
+ ->willReturn( null );
+
+ // Test with a valid tracking number.
+ $parsed_number = $this->manager->try_parse_tracking_number( $tracking_number, 'US', 'CA' );
+ $this->assertEquals( array(), $parsed_number );
+ }
+
+ /**
+ * Test tracking number parsing without any shipping providers.
+ */
+ public function test_try_parse_tracking_number_no_providers() {
+ $tracking_number = '1234567890';
+
+ add_filter(
+ 'woocommerce_fulfillment_shipping_providers',
+ function ( $providers ) {
+ $providers = array();
+ return $providers;
+ }
+ );
+
+ // Test with a valid tracking number.
+ $parsed_number = $this->manager->try_parse_tracking_number( $tracking_number, 'US', 'CA' );
+ $this->assertEquals( array(), $parsed_number );
+ }
+}
diff --git a/plugins/woocommerce/tests/php/src/Internal/Fulfillments/FulfillmentsRefundTest.php b/plugins/woocommerce/tests/php/src/Internal/Fulfillments/FulfillmentsRefundTest.php
new file mode 100644
index 0000000000..60d42767c4
--- /dev/null
+++ b/plugins/woocommerce/tests/php/src/Internal/Fulfillments/FulfillmentsRefundTest.php
@@ -0,0 +1,705 @@
+<?php
+declare( strict_types=1 );
+
+namespace Automattic\WooCommerce\Tests\Internal\Fulfillments;
+
+use Automattic\WooCommerce\Internal\Fulfillments\Fulfillment;
+use Automattic\WooCommerce\Internal\DataStores\Fulfillments\FulfillmentsDataStore;
+use Automattic\WooCommerce\Internal\Fulfillments\FulfillmentsManager;
+use Automattic\WooCommerce\RestApi\UnitTests\Helpers\OrderHelper;
+use Automattic\WooCommerce\Tests\Internal\Fulfillments\Helpers\FulfillmentsHelper;
+use WC_Order;
+
+/**
+ * Tests for Fulfillment refund handling.
+ */
+class FulfillmentsRefundTest extends \WC_Unit_Test_Case {
+
+ /**
+ * FulfillmentsDataStore instance.
+ *
+ * @var FulfillmentsDataStore
+ */
+ private $data_store;
+
+ /**
+ * FulfillmentsManager instance.
+ *
+ * @var FulfillmentsManager
+ */
+ private FulfillmentsManager $manager;
+
+ /**
+ * Set up the test environment.
+ */
+ public static function setUpBeforeClass(): void {
+ parent::setUpBeforeClass();
+ update_option( 'woocommerce_feature_fulfillments_enabled', 'yes' );
+ $container = wc_get_container();
+ $fulfillments_controller = $container->get( \Automattic\WooCommerce\Internal\Fulfillments\FulfillmentsController::class );
+ $fulfillments_controller->register();
+ }
+
+ /**
+ * Tear down the test environment.
+ */
+ public static function tearDownAfterClass(): void {
+ update_option( 'woocommerce_feature_fulfillments_enabled', 'no' );
+ parent::tearDownAfterClass();
+ }
+
+ /**
+ * Set up each test.
+ */
+ public function setUp(): void {
+ parent::setUp();
+ $this->data_store = wc_get_container()->get( FulfillmentsDataStore::class );
+ $this->manager = new FulfillmentsManager();
+ }
+
+ /**
+ * Helper method to create an order with products.
+ *
+ * @param int $product_count Number of products to add.
+ * @param int $quantity Quantity per product.
+ * @return WC_Order
+ */
+ private function create_test_order( int $product_count = 2, int $quantity = 5 ): WC_Order {
+ $order = OrderHelper::create_order();
+
+ // Remove existing items to start fresh.
+ foreach ( $order->get_items() as $item ) {
+ $order->remove_item( $item->get_id() );
+ }
+
+ // Add specific test products.
+ for ( $i = 0; $i < $product_count; $i++ ) {
+ $product = \Automattic\WooCommerce\RestApi\UnitTests\Helpers\ProductHelper::create_simple_product();
+ $product->set_regular_price( 10 );
+ $product->save();
+
+ $item = new \WC_Order_Item_Product();
+ $item->set_props(
+ array(
+ 'product' => $product,
+ 'quantity' => $quantity,
+ 'subtotal' => $quantity * 10,
+ 'total' => $quantity * 10,
+ )
+ );
+ $order->add_item( $item );
+ }
+
+ $order->calculate_totals();
+ $order->save();
+
+ return $order;
+ }
+
+ /**
+ * Helper method to create a fulfillment with specific items.
+ *
+ * @param WC_Order $order Order to create fulfillment for.
+ * @param array $items Items to include in fulfillment.
+ * @param bool $is_fulfilled Whether the fulfillment is completed.
+ * @return Fulfillment
+ */
+ private function create_test_fulfillment( WC_Order $order, array $items, bool $is_fulfilled = false ): Fulfillment {
+ $fulfillment = FulfillmentsHelper::create_fulfillment(
+ array(
+ 'entity_type' => WC_Order::class,
+ 'entity_id' => $order->get_id(),
+ 'status' => $is_fulfilled ? 'fulfilled' : 'unfulfilled',
+ 'is_fulfilled' => $is_fulfilled,
+ )
+ );
+
+ $fulfillment->set_items( $items );
+ $fulfillment->save();
+
+ return $fulfillment;
+ }
+
+ /**
+ * Helper method to create a refund.
+ *
+ * @param WC_Order $order Order to refund.
+ * @param array $refund_items Items to refund with quantities.
+ * @param float $amount Refund amount.
+ * @param string $reason Refund reason.
+ * @return \WC_Order_Refund
+ */
+ private function create_test_refund( WC_Order $order, array $refund_items, float $amount = 10.0, string $reason = 'Test refund' ): \WC_Order_Refund {
+ $refund = wc_create_refund(
+ array(
+ 'order_id' => $order->get_id(),
+ 'amount' => $amount,
+ 'reason' => $reason,
+ 'line_items' => $refund_items,
+ )
+ );
+
+ if ( is_wp_error( $refund ) ) {
+ return $refund;
+ }
+
+ $refund->save();
+ return $refund;
+ }
+
+ /**
+ * Test that fulfilled fulfillments are not affected by refunds.
+ */
+ public function test_fulfilled_fulfillments_not_affected_by_refunds() {
+ // Create order with 1 product, 10 quantity.
+ $order = $this->create_test_order( 1, 10 );
+ $items = $order->get_items();
+ $item_id = array_key_first( $items );
+
+ // Create fulfilled fulfillment with 3 items.
+ $this->create_test_fulfillment(
+ $order,
+ array(
+ array(
+ 'item_id' => $item_id,
+ 'qty' => 3,
+ ),
+ ),
+ true
+ );
+
+ // Refund 5 items.
+ $refund_items = array(
+ $item_id => array(
+ 'qty' => 5,
+ 'refund_total' => 50,
+ ),
+ );
+ $this->create_test_refund( $order, $refund_items, 50.0 );
+
+ // Check fulfillments after refund.
+ $all_fulfillments = $this->data_store->read_fulfillments( WC_Order::class, (string) $order->get_id() );
+
+ // Should still have 1 fulfillment with 3 items (unchanged).
+ $this->assertCount( 1, $all_fulfillments );
+ $remaining_fulfillment = $all_fulfillments[0];
+ $remaining_items = $remaining_fulfillment->get_items();
+ $this->assertEquals( 3, $remaining_items[0]['qty'] );
+ $this->assertTrue( $remaining_fulfillment->get_is_fulfilled() );
+ }
+
+ /**
+ * Test basic unfulfilled fulfillment reduction.
+ */
+ public function test_unfulfilled_fulfillments_partial_refund_reduces_items_correctly() {
+ // Create order with 1 product, 10 quantity.
+ $order = $this->create_test_order( 1, 10 );
+ $items = $order->get_items();
+ $item_id = array_key_first( $items );
+
+ $hook_called = 0;
+ add_action(
+ 'woocommerce_refund_created',
+ function () use ( &$hook_called ) {
+ $hook_called++;
+ },
+ 10,
+ 0
+ );
+
+ // Create unfulfilled fulfillment with 7 items (3 pending remain).
+ $this->create_test_fulfillment(
+ $order,
+ array(
+ array(
+ 'item_id' => $item_id,
+ 'qty' => 7,
+ ),
+ ),
+ false
+ );
+
+ // Refund 5 items - should reduce unfulfilled to 5 items.
+ $refund_items = array(
+ $item_id => array(
+ 'qty' => 5,
+ 'refund_total' => 50,
+ ),
+ );
+ $this->create_test_refund( $order, $refund_items, 50.0 );
+
+ $this->assertEquals( 1, $hook_called, 'Refund hook should be called once.' );
+
+ // Check fulfillments after refund.
+ $all_fulfillments = $this->data_store->read_fulfillments( WC_Order::class, (string) $order->get_id() );
+
+ // Should have 1 fulfillment with 5 items.
+ $this->assertCount( 1, $all_fulfillments );
+ $remaining_fulfillment = $all_fulfillments[0];
+ $remaining_items = $remaining_fulfillment->get_items();
+ $this->assertEquals( 5, $remaining_items[0]['qty'] );
+ }
+
+ /**
+ * Test refunds with only pending items (no fulfillments).
+ */
+ public function test_refund_with_only_pending_items() {
+ // Create order with 1 product, 10 quantity.
+ $order = $this->create_test_order( 1, 10 );
+ $items = $order->get_items();
+ $item_id = array_key_first( $items );
+
+ // No fulfillments created - all items are pending.
+
+ // Refund 3 items.
+ $refund_items = array(
+ $item_id => array(
+ 'qty' => 3,
+ 'refund_total' => 30,
+ ),
+ );
+ $this->create_test_refund( $order, $refund_items, 30.0 );
+
+ // Check that no fulfillments exist (all were pending).
+ $all_fulfillments = $this->data_store->read_fulfillments( WC_Order::class, (string) $order->get_id() );
+ $this->assertCount( 0, $all_fulfillments );
+
+ // Verify the order item quantity is correctly updated after refund.
+ $order->get_data_store()->read( $order );
+ $updated_items = $order->get_items();
+ $updated_item = $updated_items[ $item_id ];
+ $this->assertEquals( 10, $updated_item->get_quantity() ); // Original quantity unchanged.
+ }
+
+ /**
+ * Test refunds with only fulfilled fulfillments.
+ */
+ public function test_refund_with_only_fulfilled_fulfillments() {
+ // Create order with 1 product, 10 quantity.
+ $order = $this->create_test_order( 1, 10 );
+ $items = $order->get_items();
+ $item_id = array_key_first( $items );
+
+ // Create fulfilled fulfillment with all 10 items.
+ $this->create_test_fulfillment(
+ $order,
+ array(
+ array(
+ 'item_id' => $item_id,
+ 'qty' => 10,
+ ),
+ ),
+ true
+ );
+
+ // Refund 3 items - should not affect fulfilled fulfillment.
+ $refund_items = array(
+ $item_id => array(
+ 'qty' => 3,
+ 'refund_total' => 30,
+ ),
+ );
+ $this->create_test_refund( $order, $refund_items, 30.0 );
+
+ // Check fulfillments after refund.
+ $all_fulfillments = $this->data_store->read_fulfillments( WC_Order::class, (string) $order->get_id() );
+
+ // Should still have 1 fulfillment with 10 items (unchanged).
+ $this->assertCount( 1, $all_fulfillments );
+ $remaining_fulfillment = $all_fulfillments[0];
+ $remaining_items = $remaining_fulfillment->get_items();
+ $this->assertEquals( 10, $remaining_items[0]['qty'] );
+ $this->assertTrue( $remaining_fulfillment->get_is_fulfilled() );
+ }
+
+ /**
+ * Test refunds with only unfulfilled fulfillments.
+ */
+ public function test_refund_with_only_unfulfilled_fulfillments() {
+ // Create order with 1 product, 10 quantity.
+ $order = $this->create_test_order( 1, 10 );
+ $items = $order->get_items();
+ $item_id = array_key_first( $items );
+
+ // Create unfulfilled fulfillment with all 10 items.
+ $this->create_test_fulfillment(
+ $order,
+ array(
+ array(
+ 'item_id' => $item_id,
+ 'qty' => 10,
+ ),
+ ),
+ false
+ );
+
+ // Refund 3 items - should reduce unfulfilled fulfillment to 7 items.
+ $refund_items = array(
+ $item_id => array(
+ 'qty' => 3,
+ 'refund_total' => 30,
+ ),
+ );
+ $this->create_test_refund( $order, $refund_items, 30.0 );
+
+ // Check fulfillments after refund.
+ $all_fulfillments = $this->data_store->read_fulfillments( WC_Order::class, (string) $order->get_id() );
+
+ // Should have 1 fulfillment with 7 items.
+ $this->assertCount( 1, $all_fulfillments );
+ $remaining_fulfillment = $all_fulfillments[0];
+ $remaining_items = $remaining_fulfillment->get_items();
+ $this->assertEquals( 7, $remaining_items[0]['qty'] );
+ $this->assertFalse( $remaining_fulfillment->get_is_fulfilled() );
+ }
+
+ /**
+ * Test refund that completely removes an unfulfilled fulfillment.
+ */
+ public function test_refund_completely_removes_unfulfilled_fulfillment() {
+ // Create order with 1 product, 10 quantity.
+ $order = $this->create_test_order( 1, 10 );
+ $items = $order->get_items();
+ $item_id = array_key_first( $items );
+
+ // Create unfulfilled fulfillment with 5 items.
+ $this->create_test_fulfillment(
+ $order,
+ array(
+ array(
+ 'item_id' => $item_id,
+ 'qty' => 5,
+ ),
+ ),
+ false
+ );
+
+ // Create another unfulfilled fulfillment with 3 items (2 pending remain).
+ $this->create_test_fulfillment(
+ $order,
+ array(
+ array(
+ 'item_id' => $item_id,
+ 'qty' => 3,
+ ),
+ ),
+ true
+ );
+
+ // Refund 8 items - should remove the entire unfulfilled fulfillment and the pending items.
+ $refund_items = array(
+ $item_id => array(
+ 'qty' => 8,
+ 'refund_total' => 80,
+ ),
+ );
+ $this->create_test_refund( $order, $refund_items, 80.0 );
+
+ // Check fulfillments after refund.
+ $all_fulfillments = $this->data_store->read_fulfillments( WC_Order::class, (string) $order->get_id() );
+
+ // Should have no fulfillments left.
+ $this->assertCount( 1, $all_fulfillments );
+ $remaining_fulfillment = $all_fulfillments[0];
+ $remaining_items = $remaining_fulfillment->get_items();
+ $this->assertEquals( 3, $remaining_items[0]['qty'] ); // Only the fulfilled fulfillment remains with 3 items.
+ }
+
+ /**
+ * Test mixed fulfillments - fulfilled and unfulfilled.
+ */
+ public function test_mixed_fulfillments_refund_priority() {
+ // Create order with 1 product, 20 quantity.
+ $order = $this->create_test_order( 1, 20 );
+ $items = $order->get_items();
+ $item_id = array_key_first( $items );
+
+ // Create fulfilled fulfillment with 8 items.
+ $this->create_test_fulfillment(
+ $order,
+ array(
+ array(
+ 'item_id' => $item_id,
+ 'qty' => 8,
+ ),
+ ),
+ true
+ );
+
+ // Create unfulfilled fulfillment with 7 items (5 pending remain).
+ $this->create_test_fulfillment(
+ $order,
+ array(
+ array(
+ 'item_id' => $item_id,
+ 'qty' => 7,
+ ),
+ ),
+ false
+ );
+
+ // Refund 10 items - should protect fulfilled (8), reduce unfulfilled to 2.
+ $refund_items = array(
+ $item_id => array(
+ 'qty' => 10,
+ 'refund_total' => 100,
+ ),
+ );
+ $this->create_test_refund( $order, $refund_items, 100.0 );
+
+ // Check fulfillments after refund.
+ $all_fulfillments = $this->data_store->read_fulfillments( WC_Order::class, (string) $order->get_id() );
+
+ // Should have 2 fulfillments: 1 fulfilled (8 items), 1 unfulfilled (2 items).
+ $this->assertCount( 2, $all_fulfillments );
+
+ foreach ( $all_fulfillments as $fulfillment ) {
+ $items = $fulfillment->get_items();
+ if ( $fulfillment->get_is_fulfilled() ) {
+ $this->assertEquals( 8, $items[0]['qty'] ); // Fulfilled unchanged.
+ } else {
+ $this->assertEquals( 2, $items[0]['qty'] ); // Unfulfilled reduced from 7 to 2.
+ }
+ }
+ }
+
+ /**
+ * Test multiple unfulfilled fulfillments with refund.
+ */
+ public function test_multiple_unfulfilled_fulfillments_refund() {
+ // Create order with 1 product, 20 quantity.
+ $order = $this->create_test_order( 1, 20 );
+ $items = $order->get_items();
+ $item_id = array_key_first( $items );
+
+ // Create first unfulfilled fulfillment with 8 items.
+ $this->create_test_fulfillment(
+ $order,
+ array(
+ array(
+ 'item_id' => $item_id,
+ 'qty' => 8,
+ ),
+ ),
+ false
+ );
+
+ // Create second unfulfilled fulfillment with 7 items (5 pending remain).
+ $this->create_test_fulfillment(
+ $order,
+ array(
+ array(
+ 'item_id' => $item_id,
+ 'qty' => 7,
+ ),
+ ),
+ false
+ );
+
+ // Refund 10 items - should reduce unfulfilled fulfillments proportionally.
+ $refund_items = array(
+ $item_id => array(
+ 'qty' => 10,
+ 'refund_total' => 100,
+ ),
+ );
+ $this->create_test_refund( $order, $refund_items, 100.0 ); // 10 items refunded from 5 pending and 5 first fulfillment.
+
+ // Check fulfillments after refund.
+ $all_fulfillments = $this->data_store->read_fulfillments( WC_Order::class, (string) $order->get_id() );
+
+ // Should have 2 fulfillments left: 1 with 3 items, 1 with 7 items.
+ $this->assertCount( 2, $all_fulfillments );
+ $this->assertEquals( 3, $all_fulfillments[0]->get_items()[0]['qty'], 'First fulfillment should have 3 items after refund.' );
+ $this->assertEquals( 7, $all_fulfillments[1]->get_items()[0]['qty'], 'Second fulfillment should have 7 items after refund.' );
+ }
+
+ /**
+ * Test multiple unfulfilled fulfillments with refund.
+ */
+ public function test_multiple_unfulfilled_fulfillments_refund_removes_one() {
+ // Create order with 1 product, 20 quantity.
+ $order = $this->create_test_order( 1, 20 );
+ $items = $order->get_items();
+ $item_id = array_key_first( $items );
+
+ // Create first unfulfilled fulfillment with 8 items.
+ $this->create_test_fulfillment(
+ $order,
+ array(
+ array(
+ 'item_id' => $item_id,
+ 'qty' => 8,
+ ),
+ ),
+ false
+ );
+
+ // Create second unfulfilled fulfillment with 7 items (5 pending remain).
+ $this->create_test_fulfillment(
+ $order,
+ array(
+ array(
+ 'item_id' => $item_id,
+ 'qty' => 7,
+ ),
+ ),
+ false
+ );
+
+ // Refund 13 items - should reduce unfulfilled fulfillments proportionally.
+ $refund_items = array(
+ $item_id => array(
+ 'qty' => 13,
+ 'refund_total' => 130,
+ ),
+ );
+ $this->create_test_refund( $order, $refund_items, 130.0 );
+
+ // Check fulfillments after refund.
+ $all_fulfillments = $this->data_store->read_fulfillments( WC_Order::class, (string) $order->get_id() );
+ $this->assertEquals( 1, count( $all_fulfillments ), 'Should have 1 fulfillment left after refund.' );
+ $remaining_fulfillment = $all_fulfillments[0];
+ $remaining_items = $remaining_fulfillment->get_items();
+ $this->assertEquals( 7, $remaining_items[0]['qty'], 'Remaining fulfillment should have 7 items after refund.' );
+ }
+
+ /**
+ * Test refund with multiple products.
+ */
+ public function test_refund_with_multiple_products() {
+ // Create order with 2 products, 10 quantity each.
+ $order = $this->create_test_order( 2, 10 );
+ $items = $order->get_items();
+
+ $item_ids = array_keys( $items );
+ $item_id_1 = $item_ids[0];
+ $item_id_2 = $item_ids[1];
+
+ $hook_called = 0;
+ add_action(
+ 'woocommerce_refund_created',
+ function () use ( &$hook_called ) {
+ $hook_called++;
+ },
+ 10,
+ 0
+ );
+
+ // Create unfulfilled fulfillment with both products. (Pending 1:4, Pending 2:2).
+ $this->create_test_fulfillment(
+ $order,
+ array(
+ array(
+ 'item_id' => $item_id_1,
+ 'qty' => 6,
+ ),
+ array(
+ 'item_id' => $item_id_2,
+ 'qty' => 8,
+ ),
+ ),
+ false
+ );
+
+ // Refund 3 of product 1 and 5 of product 2.
+ $refund_items = array(
+ $item_id_1 => array(
+ 'qty' => 3,
+ 'refund_total' => 30,
+ ),
+ $item_id_2 => array(
+ 'qty' => 5,
+ 'refund_total' => 50,
+ ),
+ );
+ $this->create_test_refund( $order, $refund_items, 80.0 );
+
+ $this->assertEquals( 1, $hook_called, 'Refund hook should be called once.' );
+
+ // Check fulfillments after refund.
+ $all_fulfillments = $this->data_store->read_fulfillments( WC_Order::class, (string) $order->get_id() );
+
+ // Should have 1 fulfillment with reduced quantities.
+ $this->assertCount( 1, $all_fulfillments );
+ $remaining_fulfillment = $all_fulfillments[0];
+ $remaining_items = $remaining_fulfillment->get_items();
+
+ // Check that both products have correct remaining quantities.
+ $quantities_by_item = array();
+ foreach ( $remaining_items as $item ) {
+ $quantities_by_item[ $item['item_id'] ] = $item['qty'];
+ }
+
+ $this->assertEquals( 6, $quantities_by_item[ $item_id_1 ] ); // 10 - 6 = 4 pending, 3 reduced from pending, fulfillment stays the same.
+ $this->assertEquals( 5, $quantities_by_item[ $item_id_2 ] ); // 10 - 8 = 2 pending, 2 reduced from pending, 3 reduced from fulfillment, 5.
+ }
+
+
+ /**
+ * Test fulfillment modifications with multiple refunds.
+ */
+ public function test_fulfillment_modifications_with_multiple_refunds() {
+ // Create order with 1 product, 20 quantity.
+ $order = $this->create_test_order( 1, 20 );
+ $items = $order->get_items();
+ $item_id = array_key_first( $items );
+ $hook_called = 0;
+ add_action(
+ 'woocommerce_refund_created',
+ function () use ( &$hook_called ) {
+ $hook_called++;
+ },
+ 10,
+ 0
+ );
+ // Create unfulfilled fulfillment with 15 items.
+ $this->create_test_fulfillment(
+ $order,
+ array(
+ array(
+ 'item_id' => $item_id,
+ 'qty' => 15,
+ ),
+ ),
+ false
+ );
+ // Refund 7 items - should reduce unfulfilled fulfillment to 13 items (5 was removed from pending items).
+ $refund_items = array(
+ $item_id => array(
+ 'qty' => 7,
+ 'refund_total' => 70,
+ ),
+ );
+ $this->create_test_refund( $order, $refund_items, 70.0 );
+
+ $this->assertEquals( 1, $hook_called, 'Refund hook should be called once.' );
+
+ // Check fulfillments after refund.
+ $all_fulfillments = $this->data_store->read_fulfillments( WC_Order::class, (string) $order->get_id() );
+ // Should have 1 fulfillment with 13 items.
+ $this->assertCount( 1, $all_fulfillments );
+ $remaining_fulfillment = $all_fulfillments[0];
+ $remaining_items = $remaining_fulfillment->get_items();
+ $this->assertEquals( 13, $remaining_items[0]['qty'] );
+ $this->assertFalse( $remaining_fulfillment->get_is_fulfilled() );
+
+ // Now refund 3 more items - should reduce unfulfilled fulfillment to 10 items.
+ $refund_items = array(
+ $item_id => array(
+ 'qty' => 3,
+ 'refund_total' => 30,
+ ),
+ );
+ $this->create_test_refund( $order, $refund_items, 30.0 );
+ $this->assertEquals( 2, $hook_called, 'Refund hook should be called again.' );
+ // Check fulfillments after second refund.
+ $all_fulfillments = $this->data_store->read_fulfillments( WC_Order::class, (string) $order->get_id() );
+ // Should have 1 fulfillment with 10 items.
+ $this->assertCount( 1, $all_fulfillments );
+ $remaining_fulfillment = $all_fulfillments[0];
+ $remaining_items = $remaining_fulfillment->get_items();
+ $this->assertEquals( 10, $remaining_items[0]['qty'] );
+ $this->assertFalse( $remaining_fulfillment->get_is_fulfilled() );
+ }
+}
diff --git a/plugins/woocommerce/tests/php/src/Internal/Fulfillments/FulfillmentsRendererTest.php b/plugins/woocommerce/tests/php/src/Internal/Fulfillments/FulfillmentsRendererTest.php
new file mode 100644
index 0000000000..6c49cb2613
--- /dev/null
+++ b/plugins/woocommerce/tests/php/src/Internal/Fulfillments/FulfillmentsRendererTest.php
@@ -0,0 +1,444 @@
+<?php declare( strict_types=1 );
+
+namespace Automattic\WooCommerce\Tests\Internal\Fulfillments;
+
+use Automattic\WooCommerce\Internal\DataStores\Fulfillments\FulfillmentsDataStore;
+use Automattic\WooCommerce\Internal\DataStores\Orders\CustomOrdersTableController;
+use Automattic\WooCommerce\Internal\Fulfillments\Fulfillment;
+use Automattic\WooCommerce\Internal\Fulfillments\FulfillmentsRenderer;
+use Automattic\WooCommerce\RestApi\UnitTests\Helpers\OrderHelper;
+use WC_Helper_Order;
+use WC_Helper_Product;
+use WC_Order;
+
+/**
+ * Tests for Fulfillment object.
+ */
+class FulfillmentsRendererTest extends \WC_Unit_Test_Case {
+
+ /**
+ * Set up the test environment.
+ */
+ public static function setUpBeforeClass(): void {
+ parent::setUpBeforeClass();
+ update_option( 'woocommerce_feature_fulfillments_enabled', 'yes' );
+ wc_get_container()->get( \Automattic\WooCommerce\Internal\Fulfillments\FulfillmentsController::class )->register();
+ }
+
+ /**
+ * Tear down the test environment.
+ */
+ public static function tearDownAfterClass(): void {
+ update_option( 'woocommerce_feature_fulfillments_enabled', 'no' );
+ parent::tearDownAfterClass();
+ }
+
+ /**
+ * Test hooks.
+ */
+ public function test_hooks() {
+ /**
+ * @var TestingContainer $container
+ */
+ $container = wc_get_container();
+ $cot_mock = $this->createMock( CustomOrdersTableController::class );
+ $cot_mock->method( 'custom_orders_table_usage_is_enabled' )->willReturn( true );
+ $container->replace( CustomOrdersTableController::class, $cot_mock );
+
+ $renderer = new FulfillmentsRenderer();
+ $this->assertNotFalse( has_filter( 'manage_woocommerce_page_wc-orders_columns', array( $renderer, 'add_fulfillment_columns' ) ) );
+ $this->assertNotFalse( has_action( 'manage_woocommerce_page_wc-orders_custom_column', array( $renderer, 'render_fulfillment_column_row_data' ) ) );
+ $this->assertNotFalse( has_action( 'admin_footer', array( $renderer, 'render_fulfillment_drawer_slot' ) ) );
+ $this->assertNotFalse( has_action( 'admin_enqueue_scripts', array( $renderer, 'load_components' ) ) );
+ $this->assertNotFalse( has_action( 'admin_init', array( $renderer, 'init_admin_hooks' ) ) );
+ $container->reset_replacement( CustomOrdersTableController::class );
+ }
+
+ /**
+ * Test hooks when HPOS isn't enabled.
+ */
+ public function test_hooks_legacy() {
+ /**
+ * @var TestingContainer $container
+ */
+ $container = wc_get_container();
+ $cot_mock = $this->createMock( CustomOrdersTableController::class );
+ $cot_mock->method( 'custom_orders_table_usage_is_enabled' )->willReturn( false );
+ $container->replace( CustomOrdersTableController::class, $cot_mock );
+
+ $renderer = new FulfillmentsRenderer();
+
+ $this->assertNotFalse( has_filter( 'manage_edit-shop_order_columns', array( $renderer, 'add_fulfillment_columns' ) ) );
+ $this->assertNotFalse( has_action( 'manage_shop_order_posts_custom_column', array( $renderer, 'render_fulfillment_column_row_data_legacy' ) ) );
+ $this->assertNotFalse( has_action( 'admin_footer', array( $renderer, 'render_fulfillment_drawer_slot' ) ) );
+ $this->assertNotFalse( has_action( 'admin_enqueue_scripts', array( $renderer, 'load_components' ) ) );
+ $this->assertNotFalse( has_action( 'admin_init', array( $renderer, 'init_admin_hooks' ) ) );
+ $container->reset_replacement( CustomOrdersTableController::class );
+ }
+
+ /**
+ * Test that the admin_init hooks are registered.
+ */
+ public function test_admin_init_hooks() {
+ /**
+ * @var TestingContainer $container
+ */
+ $container = wc_get_container();
+ $cot_mock = $this->createMock( CustomOrdersTableController::class );
+ $cot_mock->method( 'custom_orders_table_usage_is_enabled' )->willReturn( true );
+ $container->replace( CustomOrdersTableController::class, $cot_mock );
+
+ $renderer = new FulfillmentsRenderer();
+ $renderer->init_admin_hooks();
+ $this->assertNotFalse( has_filter( 'bulk_actions-woocommerce_page_wc-orders', array( $renderer, 'define_fulfillment_bulk_actions' ) ) );
+ $this->assertNotFalse( has_filter( 'handle_bulk_actions-woocommerce_page_wc-orders', array( $renderer, 'handle_fulfillment_bulk_actions' ) ) );
+ $container->reset_replacement( CustomOrdersTableController::class );
+ }
+
+ /**
+ * Test that the admin_init hooks are registered when HPOS isn't enabled.
+ */
+ public function test_admin_init_hooks_legacy() {
+ /**
+ * @var TestingContainer $container
+ */
+ $container = wc_get_container();
+ $cot_mock = $this->createMock( CustomOrdersTableController::class );
+ $cot_mock->method( 'custom_orders_table_usage_is_enabled' )->willReturn( false );
+ $container->replace( CustomOrdersTableController::class, $cot_mock );
+
+ $renderer = new FulfillmentsRenderer();
+ $renderer->init_admin_hooks();
+ $this->assertNotFalse( has_filter( 'bulk_actions-edit-shop_order', array( $renderer, 'define_fulfillment_bulk_actions' ) ) );
+ $this->assertNotFalse( has_filter( 'handle_bulk_actions-edit-shop_order', array( $renderer, 'handle_fulfillment_bulk_actions' ) ) );
+ $container->reset_replacement( CustomOrdersTableController::class );
+ }
+
+ /**
+ * Test the add_fulfillment_columns method.
+ */
+ public function test_add_fulfillment_columns() {
+ $renderer = new FulfillmentsRenderer();
+ $columns = array(
+ 'order_status' => 'Order Status',
+ );
+ $result = $renderer->add_fulfillment_columns( $columns );
+ $this->assertArrayHasKey( 'fulfillment_status', $result );
+ $this->assertArrayHasKey( 'shipment_tracking', $result );
+ $this->assertArrayHasKey( 'shipment_provider', $result );
+ }
+
+ /**
+ * Test the render_fulfillment_column_row_data method.
+ */
+ public function test_render_fulfillment_column_row_data_uses_cache() {
+ $order = OrderHelper::create_order( get_current_user_id() );
+ $order->update_meta_data( '_fulfillment_status', 'fulfilled' );
+ $order->save();
+
+ $fulfillment = new Fulfillment();
+ $fulfillment->set_entity_type( WC_Order::class );
+ $fulfillment->set_entity_id( (string) $order->get_id() );
+ $fulfillment->add_meta_data( '_tracking_number', '123456789' );
+ $fulfillment->add_meta_data( '_tracking_url', 'https://example.com/track/123456789' );
+ $fulfillment->add_meta_data( '_shipment_provider', 'UPS' );
+ $fulfillment->set_items(
+ array(
+ array(
+ 'item_id' => 1,
+ 'qty' => 2,
+ ),
+ array(
+ 'item_id' => 2,
+ 'qty' => 1,
+ ),
+ )
+ );
+ $fulfillment->set_status( 'fulfilled' );
+ $fulfillment->save();
+
+ $renderer = new FulfillmentsRenderer();
+
+ ob_start();
+ $renderer->render_fulfillment_column_row_data( 'fulfillment_status', $order );
+ $renderer->render_fulfillment_column_row_data( 'shipment_tracking', $order );
+ $renderer->render_fulfillment_column_row_data( 'shipment_provider', $order );
+
+ $output = ob_get_clean();
+ $this->assertStringContainsString( 'Fulfilled', $output );
+ $this->assertStringContainsString( '123456789', $output );
+ $this->assertStringContainsString( 'UPS', $output );
+ $this->assertStringContainsString( "<a href='#' class='fulfillments-trigger' data-order-id='" . $order->get_id() . "' title='" . esc_attr__( 'View Fulfillments', 'woocommerce' ) . "'>", $output );
+ $this->assertStringContainsString( "<svg width='16' height='16' viewBox='0 0 12 14' xmlns='http://www.w3.org/2000/svg'>", $output );
+ $this->assertStringContainsString( "<path d='M11.8333 2.83301L9.33329 0.333008L2.24996 7.41634L1.41663 10.7497L4.74996 9.91634L11.8333 2.83301ZM5.99996 12.4163H0.166626V13.6663H5.99996V12.4163Z' />", $output );
+ $this->assertStringContainsString( '</svg>', $output );
+ $this->assertStringContainsString( '</a>', $output );
+ }
+
+ /**
+ * Test the render_fulfillment_column_row_data method with no fulfillments.
+ */
+ public function test_render_fulfillment_column_row_data_no_fulfillments() {
+ $renderer = new FulfillmentsRenderer();
+ $order = $this->createMock( \WC_Order::class );
+ $order->method( 'get_id' )->willReturn( 1 );
+ $order->method( 'meta_exists' )->willReturn( true );
+ $order->method( 'get_meta' )->with( '_fulfillment_status' )->willReturn( 'unfulfilled' );
+
+ ob_start();
+ $renderer->render_fulfillment_column_row_data( 'fulfillment_status', $order );
+ $renderer->render_fulfillment_column_row_data( 'shipment_tracking', $order );
+ $renderer->render_fulfillment_column_row_data( 'shipment_provider', $order );
+
+ $output = ob_get_clean();
+ $this->assertStringContainsString( 'Unfulfilled', $output );
+ $this->assertStringNotContainsString( '123456789', $output );
+ $this->assertStringNotContainsString( 'UPS', $output );
+ }
+
+ /**
+ * Test the render_fulfillment_drawer_slot method.
+ */
+ public function test_render_fulfillment_drawer_slot_doesnt_render_without_current_screen() {
+ $renderer = new FulfillmentsRenderer();
+ set_current_screen( null );
+ ob_start();
+ $renderer->render_fulfillment_drawer_slot();
+ $output = ob_get_clean();
+ $this->assertStringNotContainsString( '<div id="wc_order_fulfillments_panel_container"></div>', $output );
+ }
+
+ /**
+ * Test the render_fulfillment_drawer_slot method.
+ */
+ public function test_render_fulfillment_drawer_slot_doesnt_render_on_other_pages() {
+ $renderer = new FulfillmentsRenderer();
+ set_current_screen( 'dashboard' );
+ ob_start();
+ $renderer->render_fulfillment_drawer_slot();
+ $output = ob_get_clean();
+ $this->assertStringNotContainsString( '<div id="wc_order_fulfillments_panel_container"></div>', $output );
+ }
+
+ /**
+ * Test the render_fulfillment_drawer_slot method.
+ */
+ public function test_render_fulfillment_drawer_slot_renders_on_orders_page() {
+ $renderer = new FulfillmentsRenderer();
+ set_current_screen( 'woocommerce_page_wc-orders' );
+ ob_start();
+ $renderer->render_fulfillment_drawer_slot();
+ $output = ob_get_clean();
+ $this->assertStringContainsString( '<div id="wc_order_fulfillments_panel_container"></div>', $output );
+ }
+
+ /**
+ * Test the test_handle_fulfillment_bulk_actions method fulfill action on an order without any fulfillments.
+ */
+ public function test_handle_fulfillment_bulk_actions_fulfill_new_order() {
+ $renderer = new FulfillmentsRenderer();
+ $order = WC_Helper_Order::create_order( get_current_user_id() );
+
+ $renderer->handle_fulfillment_bulk_actions( 'dummy_redirect', 'fulfill', array( $order->get_id() ) );
+
+ $fulfillments = wc_get_container()
+ ->get( FulfillmentsDataStore::class )
+ ->read_fulfillments( WC_Order::class, (string) $order->get_id() );
+
+ $this->assertCount( 1, $fulfillments, 'Fulfillment was not created.' );
+ $this->assertEquals( 'fulfilled', $fulfillments[0]->get_status(), 'Fulfillment status is not set to Fulfilled.' );
+ $this->assertTrue( $fulfillments[0]->get_is_fulfilled(), 'Fulfillment is not marked as fulfilled.' );
+
+ // Check that the fulfillment has all the items in the order.
+ $items = $fulfillments[0]->get_items();
+ $this->assertCount( count( $order->get_items() ), $items, 'Fulfillment items do not match order items.' );
+ foreach ( $order->get_items() as $item_id => $item ) {
+ $fulfillment_item = array_filter( $items, fn( $item ) => $item['item_id'] === $item_id );
+ $this->assertNotEmpty( $fulfillment_item, 'Fulfillment does not contain item with ID ' . $item_id );
+ $this->assertEquals( $item->get_quantity(), $fulfillment_item[0]['qty'], 'Fulfillment item quantity does not match order item quantity.' );
+ }
+
+ WC_Helper_Order::delete_order( $order->get_id() );
+ }
+
+ /**
+ * Test the test_handle_fulfillment_bulk_actions method fulfill action on an order with existing fulfillments.
+ */
+ public function test_handle_fulfillment_bulk_actions_fulfill_with_partial_fulfillments() {
+ $renderer = new FulfillmentsRenderer();
+
+ $order = WC_Helper_Order::create_order( get_current_user_id() );
+ $order->add_item( WC_Helper_Product::create_simple_product(), 2 );
+ $order->calculate_totals();
+
+ $order_items = array_values( $order->get_items() );
+
+ // Create an initial fulfillment with only one item.
+ $fulfillment = new Fulfillment();
+ $fulfillment->set_entity_type( WC_Order::class );
+ $fulfillment->set_entity_id( (string) $order->get_id() );
+ $fulfillment->set_status( 'unfulfilled' );
+ $fulfillment->set_items(
+ array(
+ array(
+ 'item_id' => $order_items[0]->get_id(),
+ 'qty' => 1,
+ ),
+ )
+ );
+ $fulfillment->save();
+
+ // Now fulfill the order again.
+ $renderer->handle_fulfillment_bulk_actions( 'dummy_redirect', 'fulfill', array( $order->get_id() ) );
+
+ $fulfillments = wc_get_container()
+ ->get( FulfillmentsDataStore::class )
+ ->read_fulfillments( WC_Order::class, (string) $order->get_id() );
+
+ $this->assertCount( 2, $fulfillments, 'Fulfillment was not created.' );
+ foreach ( $fulfillments as $fulfillment ) {
+ $this->assertEquals( 'fulfilled', $fulfillment->get_status(), 'Fulfillment status is not set to Fulfilled.' );
+ $this->assertTrue( $fulfillment->get_is_fulfilled(), 'Fulfillment is not marked as fulfilled.' );
+ }
+
+ WC_Helper_Order::delete_order( $order->get_id() );
+ }
+
+ /**
+ * Test bulk action for fulfilling orders with all items in an unfullfilled fulfillment.
+ */
+ public function test_handle_fulfillment_bulk_actions_fulfill_all_items_in_unfulfilled_fulfillment() {
+ $renderer = new FulfillmentsRenderer();
+ $order = WC_Helper_Order::create_order( get_current_user_id() );
+
+ // Add multiple items to the order.
+ for ( $i = 0; $i < 3; $i++ ) {
+ $product = WC_Helper_Product::create_simple_product();
+ $order->add_item( $product, 2 );
+ }
+ $order->calculate_totals();
+
+ // Fulfill the order without calling the bulk action first.
+ $fulfillment = new Fulfillment();
+ $fulfillment->set_entity_type( WC_Order::class );
+ $fulfillment->set_entity_id( (string) $order->get_id() );
+ $fulfillment->set_status( 'unfulfilled' );
+ $fulfillment->set_items(
+ array_map(
+ function ( $item ) {
+ return array(
+ 'item_id' => $item->get_id(),
+ 'qty' => $item->get_quantity(),
+ );
+ },
+ array_values( $order->get_items() )
+ )
+ );
+ $fulfillment->save();
+
+ // Fulfill the order with bulk action. There should be no change except the existing fulfillment status.
+ $renderer->handle_fulfillment_bulk_actions( 'dummy_redirect', 'fulfill', array( $order->get_id() ) );
+
+ $fulfillments = wc_get_container()
+ ->get( FulfillmentsDataStore::class )
+ ->read_fulfillments( WC_Order::class, (string) $order->get_id() );
+
+ $this->assertCount( 1, $fulfillments, 'Fulfillment was not created.' );
+ $this->assertEquals( $fulfillment->get_id(), $fulfillments[0]->get_id(), 'Fulfillment ID does not match.' );
+ $this->assertEquals( 'fulfilled', $fulfillments[0]->get_status(), 'Fulfillment status is not set to Fulfilled.' );
+ $this->assertTrue( $fulfillments[0]->get_is_fulfilled(), 'Fulfillment is not marked as fulfilled.' );
+
+ WC_Helper_Order::delete_order( $order->get_id() );
+ }
+
+ /**
+ * Test bulk action for fulfilling orders with all items in a fullfilled fulfillment.
+ */
+ public function test_handle_fulfillment_bulk_actions_fulfill_all_items_in_fulfilled_fulfillment() {
+ $renderer = new FulfillmentsRenderer();
+ $order = WC_Helper_Order::create_order( get_current_user_id() );
+
+ // Add multiple items to the order.
+ for ( $i = 0; $i < 3; $i++ ) {
+ $product = WC_Helper_Product::create_simple_product();
+ $order->add_item( $product, 2 );
+ }
+ $order->calculate_totals();
+
+ // Fulfill the order without calling the bulk action first.
+ $fulfillment = new Fulfillment();
+ $fulfillment->set_entity_type( WC_Order::class );
+ $fulfillment->set_entity_id( (string) $order->get_id() );
+ $fulfillment->set_status( 'fulfilled' );
+ $fulfillment->set_items(
+ array_map(
+ function ( $item ) {
+ return array(
+ 'item_id' => $item->get_id(),
+ 'qty' => $item->get_quantity(),
+ );
+ },
+ array_values( $order->get_items() )
+ )
+ );
+ $fulfillment->save();
+
+ // Fulfill the order with bulk action. There should be no change since all items are fulfilled.
+ $renderer->handle_fulfillment_bulk_actions( 'dummy_redirect', 'fulfill', array( $order->get_id() ) );
+
+ $fulfillments = wc_get_container()
+ ->get( FulfillmentsDataStore::class )
+ ->read_fulfillments( WC_Order::class, (string) $order->get_id() );
+
+ $this->assertCount( 1, $fulfillments, 'Fulfillment was not created.' );
+ $this->assertEquals( $fulfillment->get_id(), $fulfillments[0]->get_id(), 'Fulfillment ID does not match.' );
+ $this->assertEquals( 'fulfilled', $fulfillments[0]->get_status(), 'Fulfillment status is not set to Fulfilled.' );
+ $this->assertTrue( $fulfillments[0]->get_is_fulfilled(), 'Fulfillment is not marked as fulfilled.' );
+
+ WC_Helper_Order::delete_order( $order->get_id() );
+ }
+
+ /**
+ * Test that the load_components method doesn't render on other pages.
+ */
+ public function test_load_components_doesnt_render_on_other_pages() {
+ $renderer = $this->getMockBuilder( FulfillmentsRenderer::class )
+ ->onlyMethods( array( 'should_render_fulfillment_drawer', 'register_fulfillments_assets' ) )
+ ->getMock();
+ $renderer->method( 'should_render_fulfillment_drawer' )->willReturn( false );
+ $renderer->method( 'register_fulfillments_assets' )->willReturnCallback(
+ function () {
+ wp_enqueue_script( 'wc-admin-fulfillments', 'dummy-path', array(), '1.0.0', array( 'in_footer' => false ) );
+ }
+ );
+
+ ob_start();
+ $renderer->load_components();
+ wp_print_scripts();
+ $output = ob_get_clean();
+ $this->assertStringNotContainsString( 'wc-admin-fulfillments-js', $output );
+ $this->assertStringNotContainsString( 'var wcFulfillmentSettings', $output );
+ }
+
+ /**
+ * Test that the load_components method renders on the orders page.
+ */
+ public function test_load_components_renders_on_orders_page() {
+ $renderer = $this->getMockBuilder( FulfillmentsRenderer::class )
+ ->onlyMethods( array( 'should_render_fulfillment_drawer', 'register_fulfillments_assets' ) )
+ ->getMock();
+ $renderer->method( 'should_render_fulfillment_drawer' )->willReturn( true );
+ $renderer->method( 'register_fulfillments_assets' )->willReturnCallback(
+ function () {
+ wp_enqueue_script( 'wc-admin-fulfillments', 'dummy-path', array(), '1.0.0', array( 'in_footer' => false ) );
+ }
+ );
+
+ ob_start();
+ $renderer->load_components();
+ wp_print_scripts();
+ $output = ob_get_clean();
+ $this->assertStringContainsString( 'wc-admin-fulfillments-js', $output );
+ $this->assertStringContainsString( 'var wcFulfillmentSettings', $output );
+ }
+}
diff --git a/plugins/woocommerce/tests/php/src/Internal/Fulfillments/FulfillmentsSettingsTest.php b/plugins/woocommerce/tests/php/src/Internal/Fulfillments/FulfillmentsSettingsTest.php
new file mode 100644
index 0000000000..f49ed2b0e8
--- /dev/null
+++ b/plugins/woocommerce/tests/php/src/Internal/Fulfillments/FulfillmentsSettingsTest.php
@@ -0,0 +1,260 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Tests\Internal\Fulfillments;
+
+use Automattic\WooCommerce\Internal\DataStores\Fulfillments\FulfillmentsDataStore;
+use WC_Order;
+use WC_Order_Item_Product;
+use WC_Unit_Test_Case;
+
+/**
+ * Class FulfillmentsSettingsTest
+ *
+ * Tests for the FulfillmentsSettings class.
+ */
+class FulfillmentsSettingsTest extends WC_Unit_Test_Case {
+
+ /**
+ * Set up the test environment.
+ */
+ public static function setUpBeforeClass(): void {
+ parent::setUpBeforeClass();
+ update_option( 'woocommerce_feature_fulfillments_enabled', 'yes' );
+ wc_get_container()->get( \Automattic\WooCommerce\Internal\Fulfillments\FulfillmentsController::class )->register();
+ }
+
+ /**
+ * Tear down the test environment.
+ */
+ public static function tearDownAfterClass(): void {
+ update_option( 'woocommerce_feature_fulfillments_enabled', 'no' );
+ parent::tearDownAfterClass();
+ }
+
+ /**
+ * Tests if the hooks are added correctly in the constructor.
+ */
+ public function test_hooks_added() {
+ $fulfillments_settings = new \Automattic\WooCommerce\Internal\Fulfillments\FulfillmentsSettings();
+
+ // Check if the admin_init filter is added.
+ $this->assertNotFalse( has_filter( 'admin_init', array( $fulfillments_settings, 'init_settings_auto_fulfill' ) ) > 0 );
+
+ // Check if the order status hooks are added.
+ $this->assertNotFalse( has_action( 'woocommerce_order_status_processing', array( $fulfillments_settings, 'auto_fulfill_items_on_processing' ) ) > 0 );
+ $this->assertNotFalse( has_action( 'woocommerce_order_status_completed', array( $fulfillments_settings, 'auto_fulfill_items_on_completed' ) ) > 0 );
+ }
+
+ /**
+ * Tests the add_auto_fulfill_settings method.
+ */
+ public function test_add_auto_fulfill_settings() {
+ $settings = array(
+ array(
+ 'type' => 'sectionend',
+ 'id' => 'catalog_options',
+ ),
+ );
+
+ $fulfillments_settings = new \Automattic\WooCommerce\Internal\Fulfillments\FulfillmentsSettings();
+ $modified_settings = $fulfillments_settings->add_auto_fulfill_settings( $settings, '' );
+
+ $this->assertCount( 5, $modified_settings );
+ $this->assertEquals( 'catalog_options', $modified_settings[0]['id'] );
+ $this->assertEquals( 'sectionend', $modified_settings[0]['type'] );
+ $this->assertEquals( 'auto_fulfill_options', $modified_settings[1]['id'] );
+ $this->assertEquals( 'title', $modified_settings[1]['type'] );
+ $this->assertEquals( 'auto_fulfill_downloadable', $modified_settings[2]['id'] );
+ $this->assertEquals( 'checkbox', $modified_settings[2]['type'] );
+ $this->assertEquals( 'auto_fulfill_virtual', $modified_settings[3]['id'] );
+ $this->assertEquals( 'checkbox', $modified_settings[3]['type'] );
+ $this->assertEquals( 'auto_fulfill_options', $modified_settings[4]['id'] );
+ $this->assertEquals( 'sectionend', $modified_settings[4]['type'] );
+ }
+
+ /**
+ * Tests the auto_fulfill_items_on_processing method when an order doesn't exist.
+ */
+ public function test_auto_fulfill_items_on_processing_bails_out_if_no_order_exists() {
+ $fulfillments_settings = new \Automattic\WooCommerce\Internal\Fulfillments\FulfillmentsSettings();
+ $mock_order = $this->createMock( WC_Order::class );
+ $mock_order->expects( $this->never() )->method( 'get_items' );
+ // Simulate an order status change without an order.
+ $fulfillments_settings->auto_fulfill_items_on_processing( 0, null );
+ }
+
+ /**
+ * Tests the auto_fulfill_items_on_processing method with an order that has no items.
+ */
+ public function test_auto_fulfill_items_on_processing_bails_out_if_order_has_no_items() {
+ $hook_called = false;
+ add_filter(
+ 'woocommerce_fulfillments_auto_fulfill_products',
+ function ( $products ) use ( &$hook_called ) {
+ $hook_called = true;
+ return $products;
+ }
+ );
+ $fulfillments_settings = new \Automattic\WooCommerce\Internal\Fulfillments\FulfillmentsSettings();
+ $mock_order = $this->createMock( WC_Order::class );
+ $mock_order->expects( $this->once() )->method( 'get_items' )->willReturn( array() );
+ // Simulate an order status change with an order that has no items.
+ $fulfillments_settings->auto_fulfill_items_on_processing( 0, $mock_order );
+ $this->assertFalse( $hook_called, 'Hook should not be called if there are no items.' );
+ }
+
+ /**
+ * Data provider for auto_fulfill_items_on_processing test.
+ *
+ * @return array
+ */
+ public function auto_fulfill_items_on_processing_data_provider() {
+ return array(
+ /**
+ * auto fulfill downloadable items
+ * auto fulfill virtual items
+ * auto fulfill product IDs
+ * expected fulfillments count
+ */
+ array( false, false, array(), 0, 0 ),
+ array( true, false, array(), 1, 1 ),
+ array( false, true, array(), 1, 1 ),
+ array( true, true, array(), 1, 2 ),
+ array( false, false, array( 123 ), 1, 1 ),
+ array( false, false, array( 124 ), 0, 0 ),
+ array( true, true, array( 789 ), 1, 3 ),
+ );
+ }
+
+ /**
+ * Test the auto_fulfill_items_on_processing method with an order that has downloadable items.
+ *
+ * @param bool $auto_fulfill_downloadable Whether to auto-fulfill downloadable items.
+ * @param bool $auto_fulfill_virtual Whether to auto-fulfill virtual items.
+ * @param array $auto_fulfill_products Products to auto-fulfill.
+ * @param int $fulfillments_expected Expected number of fulfillments.
+ * @param int $fulfilled_items_count Expected number of fulfilled items.
+ *
+ * @dataProvider auto_fulfill_items_on_processing_data_provider
+ */
+ public function test_auto_fulfill_items_on_processing_calls_hook_with_item_and_setting_combinatinos(
+ $auto_fulfill_downloadable = true,
+ $auto_fulfill_virtual = false,
+ $auto_fulfill_products = array(),
+ $fulfillments_expected = 0,
+ $fulfilled_items_count = 0
+ ) {
+ $hook_called = false;
+ add_filter(
+ 'woocommerce_fulfillments_auto_fulfill_products',
+ function ( $products ) use ( &$hook_called, $auto_fulfill_products ) {
+ $hook_called = true;
+ $products = array_merge( $products, $auto_fulfill_products );
+ return $products;
+ }
+ );
+ $fulfillments_settings = new \Automattic\WooCommerce\Internal\Fulfillments\FulfillmentsSettings();
+ $mock_order = $this->createMock( WC_Order::class );
+
+ $mock_items = array();
+
+ // Add a downloadable item to the order.
+ $mock_downloadable_item = $this->createMock( WC_Order_Item_Product::class );
+ $mock_downloadable_item_product = $this->createMock( \WC_Product::class );
+ $mock_downloadable_item_product->method( 'is_downloadable' )->willReturn( true );
+ $mock_downloadable_item_product->method( 'is_virtual' )->willReturn( false );
+ $mock_downloadable_item_product->method( 'get_id' )->willReturn( 123 );
+ $mock_downloadable_item->method( 'get_product' )->willReturn( $mock_downloadable_item_product );
+ $mock_downloadable_item->method( 'get_id' )->willReturn( 1123 );
+ $mock_downloadable_item->method( 'get_quantity' )->willReturn( 2 );
+
+ $mock_items[] = $mock_downloadable_item;
+
+ // Add a virtual item to the order.
+ $mock_virtual_item = $this->createMock( WC_Order_Item_Product::class );
+ $mock_virtual_item_product = $this->createMock( \WC_Product::class );
+ $mock_virtual_item_product->method( 'is_downloadable' )->willReturn( false );
+ $mock_virtual_item_product->method( 'is_virtual' )->willReturn( true );
+ $mock_virtual_item_product->method( 'get_id' )->willReturn( 456 );
+ $mock_virtual_item->method( 'get_product' )->willReturn( $mock_virtual_item_product );
+ $mock_virtual_item->method( 'get_id' )->willReturn( 2456 );
+ $mock_virtual_item->method( 'get_quantity' )->willReturn( 3 );
+ $mock_items[] = $mock_virtual_item;
+
+ // Add a regular item to the order.
+ // This item should not trigger auto-fulfillment.
+ $mock_regular_item = $this->createMock( WC_Order_Item_Product::class );
+ $mock_regular_item_product = $this->createMock( \WC_Product::class );
+ $mock_regular_item_product->method( 'is_downloadable' )->willReturn( false );
+ $mock_regular_item_product->method( 'is_virtual' )->willReturn( false );
+ $mock_regular_item_product->method( 'get_id' )->willReturn( 789 );
+ $mock_regular_item->method( 'get_product' )->willReturn( $mock_regular_item_product );
+ $mock_regular_item->method( 'get_id' )->willReturn( 3789 );
+ $mock_regular_item->method( 'get_quantity' )->willReturn( 4 );
+ $mock_items[] = $mock_regular_item;
+
+ // Set the options for auto-fulfill settings.
+ update_option( 'auto_fulfill_downloadable', $auto_fulfill_downloadable ? 'yes' : 'no' );
+ update_option( 'auto_fulfill_virtual', $auto_fulfill_virtual ? 'yes' : 'no' );
+
+ $mock_order->expects( $this->exactly( 2 ) )->method( 'get_items' )->willReturn( $mock_items );
+
+ // Simulate an order status change with an order that has items.
+ $fulfillments_settings->auto_fulfill_items_on_processing( 123, $mock_order );
+
+ $this->assertTrue( $hook_called, 'Hook should be called if there are items.' );
+
+ $data_store = new FulfillmentsDataStore();
+ $fulfillments = $data_store->read_fulfillments( WC_Order::class, '123' );
+ $this->assertCount( $fulfillments_expected, $fulfillments, 'Fulfillments count does not match expected.' );
+
+ if ( $fulfillments_expected > 0 ) {
+ $fulfillment = reset( $fulfillments );
+ $this->assertEquals( 'fulfilled', $fulfillment->get_status(), 'Fulfillment status should be fulfilled.' );
+ $this->assertTrue( $fulfillment->get_is_fulfilled(), 'Fulfillment should be marked as fulfilled.' );
+
+ $items = $fulfillment->get_items();
+ $this->assertCount( $fulfilled_items_count, $items, 'Fulfillment items count does not match expected.' );
+ }
+ }
+
+ /**
+ * Tests the auto_fulfill_items_on_completed method when order doesn't exist.
+ */
+ public function test_auto_fulfill_items_on_completed_bails_out_if_no_order_exists() {
+ $fulfillments_settings = new \Automattic\WooCommerce\Internal\Fulfillments\FulfillmentsSettings();
+ $mock_order = $this->createMock( WC_Order::class );
+ $mock_order->expects( $this->never() )->method( 'get_items' );
+ // Simulate an order status change without an order.
+ $fulfillments_settings->auto_fulfill_items_on_completed( 0, null );
+ }
+
+ /**
+ * Tests the auto_fulfill_items_on_completed method with an order that has no items.
+ */
+ public function test_auto_fulfill_items_on_completed_bails_out_if_order_has_no_items() {
+ $fulfillments_settings = new \Automattic\WooCommerce\Internal\Fulfillments\FulfillmentsSettings();
+ $mock_order = $this->createMock( WC_Order::class );
+ $mock_order->expects( $this->once() )->method( 'get_items' )->willReturn( array() );
+ $mock_order->expects( $this->never() )->method( 'get_meta' );
+ // Simulate an order status change with an order that has no items.
+ $fulfillments_settings->auto_fulfill_items_on_completed( 0, $mock_order );
+ }
+
+ /**
+ * Tests the auto_fulfill_items_on_completed method with an order that has items.
+ */
+ public function test_auto_fulfill_items_on_completed_calls_hook_with_item_and_setting_combinations() {
+ $mock_sut = $this->getMockBuilder( \Automattic\WooCommerce\Internal\Fulfillments\FulfillmentsSettings::class )
+ ->onlyMethods( array( 'auto_fulfill_items_on_processing' ) )
+ ->getMock();
+ $mock_sut->expects( $this->once() )
+ ->method( 'auto_fulfill_items_on_processing' );
+ $mock_order = $this->createMock( WC_Order::class );
+ $mock_item = $this->createMock( WC_Order_Item_Product::class );
+ $mock_order->expects( $this->once() )
+ ->method( 'get_items' )
+ ->willReturn( array( $mock_item ) );
+ $mock_sut->auto_fulfill_items_on_completed( 123, $mock_order );
+ }
+}
diff --git a/plugins/woocommerce/tests/php/src/Internal/Fulfillments/Helpers/FulfillmentsHelper.php b/plugins/woocommerce/tests/php/src/Internal/Fulfillments/Helpers/FulfillmentsHelper.php
new file mode 100644
index 0000000000..0128208b56
--- /dev/null
+++ b/plugins/woocommerce/tests/php/src/Internal/Fulfillments/Helpers/FulfillmentsHelper.php
@@ -0,0 +1,72 @@
+<?php declare( strict_types=1 );
+
+namespace Automattic\WooCommerce\Tests\Internal\Fulfillments\Helpers;
+
+use Automattic\WooCommerce\Internal\Fulfillments\Fulfillment;
+use WC_Order;
+
+/**
+ * Helper class for creating and managing fulfillments in tests.
+ *
+ * This helper class should ONLY be used for unit tests!.
+ *
+ * @since 9.0.0
+ */
+class FulfillmentsHelper {
+ /**
+ * Helper function to create a fulfillment.
+ *
+ * @param array $args Arguments to create the fulfillment.
+ * @param array $metadata Metadata to add to the fulfillment.
+ *
+ * @return Fulfillment The created fulfillment object.
+ */
+ public static function create_fulfillment( array $args = array(), array $metadata = array() ) {
+ $fulfillment = new Fulfillment();
+ $fulfillment->set_props(
+ array_merge(
+ array(
+ 'id' => 0,
+ 'entity_type' => WC_Order::class,
+ 'entity_id' => 123,
+ 'status' => 'unfulfilled',
+ 'is_fulfilled' => false,
+ ),
+ $args
+ )
+ );
+
+ if ( $metadata ) {
+ foreach ( $metadata as $key => $value ) {
+ $fulfillment->add_meta_data(
+ $key,
+ $value,
+ true
+ );
+ }
+ } else {
+ $fulfillment->add_meta_data(
+ 'test_meta_key',
+ 'test_meta_value',
+ true
+ );
+
+ $fulfillment->set_items(
+ array(
+ array(
+ 'item_id' => 1,
+ 'qty' => 2,
+ ),
+ array(
+ 'item_id' => 2,
+ 'qty' => 3,
+ ),
+ )
+ );
+ }
+
+ $fulfillment->save();
+
+ return $fulfillment;
+ }
+}
diff --git a/plugins/woocommerce/tests/php/src/Internal/Fulfillments/Helpers/ShippingProviderMock.php b/plugins/woocommerce/tests/php/src/Internal/Fulfillments/Helpers/ShippingProviderMock.php
new file mode 100644
index 0000000000..bb2a725f9c
--- /dev/null
+++ b/plugins/woocommerce/tests/php/src/Internal/Fulfillments/Helpers/ShippingProviderMock.php
@@ -0,0 +1,52 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Tests\Internal\Fulfillments\Helpers;
+
+use Automattic\WooCommerce\Internal\Fulfillments\Providers\AbstractShippingProvider;
+
+/**
+ * ShippingProviderMock class.
+ *
+ * This class is a mock implementation of the AbstractShippingProvider for testing purposes.
+ *
+ * @since 10.1.0
+ * @package WooCommerce\Tests\Internal\Fulfillments
+ */
+class ShippingProviderMock extends AbstractShippingProvider {
+ /**
+ * Get the key of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_key(): string {
+ return 'mock_shipping_provider';
+ }
+
+ /**
+ * Get the name of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_name(): string {
+ return 'Mock Shipping Provider';
+ }
+
+ /**
+ * Get the icon of the shipping provider.
+ *
+ * @return string
+ */
+ public function get_icon(): string {
+ return 'https://example.com/icon.png';
+ }
+
+ /**
+ * Get the tracking URL for a given tracking number.
+ *
+ * @param string $tracking_number The tracking number.
+ * @return string The tracking URL.
+ */
+ public function get_tracking_url( string $tracking_number ): string {
+ return 'https://example.com/track?number=' . rawurlencode( $tracking_number );
+ }
+}
diff --git a/plugins/woocommerce/tests/php/src/Internal/Fulfillments/OrderFulfillmentsRestControllerTest.php b/plugins/woocommerce/tests/php/src/Internal/Fulfillments/OrderFulfillmentsRestControllerTest.php
new file mode 100644
index 0000000000..4fbb88cb73
--- /dev/null
+++ b/plugins/woocommerce/tests/php/src/Internal/Fulfillments/OrderFulfillmentsRestControllerTest.php
@@ -0,0 +1,1994 @@
+<?php
+declare( strict_types = 1 );
+
+namespace Automattic\WooCommerce\Tests\Internal\Fulfillments;
+
+use Automattic\WooCommerce\Internal\Fulfillments\OrderFulfillmentsRestController;
+use Automattic\WooCommerce\Tests\Internal\Fulfillments\Helpers\FulfillmentsHelper;
+use WC_Helper_Order;
+use WC_Order;
+use WC_REST_Unit_Test_Case;
+use WP_Http;
+use WP_REST_Request;
+
+/**
+ * Class OrderFulfillmentsRestControllerTest
+ *
+ * @package Automattic\WooCommerce\Tests\Internal\Orders
+ */
+class OrderFulfillmentsRestControllerTest extends WC_REST_Unit_Test_Case {
+ /**
+ * @var OrderFulfillmentsRestController
+ */
+ private OrderFulfillmentsRestController $controller;
+
+ /**
+ * Array of created orders' ID's. Keeping it to be deleted in tearDownAfterClass.
+ *
+ * @var array
+ */
+ private static array $created_order_ids = array();
+
+ /**
+ * Created user ID for testing purposes.
+ *
+ * @var int
+ */
+ private static int $created_user_id = -1;
+
+ /**
+ * Setup test case.
+ */
+ public function setUp(): void {
+ parent::setUp();
+
+ $this->controller = new OrderFulfillmentsRestController();
+ $this->controller->register_routes();
+ }
+
+ /**
+ * Initializes the test environment before all tests on this file are run.
+ */
+ public static function setupBeforeClass(): void {
+ parent::setupBeforeClass();
+
+ update_option( 'woocommerce_feature_fulfillments_enabled', 'yes' );
+ wc_get_container()->get( \Automattic\WooCommerce\Internal\Fulfillments\FulfillmentsController::class )->register();
+
+ self::$created_user_id = wp_create_user( 'test_user', 'password', 'nonadmin@example.com' );
+
+ for ( $order_number = 1; $order_number <= 10; $order_number++ ) {
+ $order = WC_Helper_Order::create_order( get_current_user_id() );
+ self::$created_order_ids[] = $order->get_id();
+ for ( $fulfillment = 1; $fulfillment <= 10; $fulfillment++ ) {
+ FulfillmentsHelper::create_fulfillment(
+ array(
+ 'entity_type' => WC_Order::class,
+ 'entity_id' => $order->get_id(),
+ )
+ );
+ }
+ }
+ }
+
+ /**
+ * Destroys the test environment after all tests on this file are run.
+ */
+ public static function tearDownAfterClass(): void {
+ // Delete the created orders and their fulfillments.
+ global $wpdb;
+ $wpdb->query( "TRUNCATE TABLE {$wpdb->prefix}wc_order_fulfillments;" );
+ $wpdb->query( "TRUNCATE TABLE {$wpdb->prefix}wc_order_fulfillment_meta;" );
+ foreach ( self::$created_order_ids as $order_id ) {
+ WC_Helper_Order::delete_order( $order_id );
+ }
+
+ // Delete the created user.
+ wp_delete_user( self::$created_user_id );
+ update_option( 'woocommerce_feature_fulfillments_enabled', 'no' );
+
+ parent::tearDownAfterClass();
+ }
+
+ /**
+ * Test the get_items method.
+ */
+ public function test_get_fulfillments_nominal() {
+ // Do the request for an order which the current user owns.
+ $request = new WP_REST_Request( 'GET', '/wc/v3/orders/' . self::$created_order_ids[0] . '/fulfillments' );
+ $response = $this->server->dispatch( $request );
+
+ // Check the response.
+ $this->assertEquals( 200, $response->get_status() );
+ $this->assertIsArray( $response->get_data() );
+ $this->assertArrayHasKey( 'fulfillments', $response->get_data() );
+ $fulfillments = $response->get_data()['fulfillments'];
+ $this->assertIsArray( $fulfillments );
+ $this->assertCount( 10, $fulfillments );
+ $this->assertEquals( 10, count( $fulfillments ) );
+
+ foreach ( $fulfillments as $fulfillment ) {
+ $this->assertEquals( WC_Order::class, $fulfillment['entity_type'] );
+ $this->assertEquals( self::$created_order_ids[0], $fulfillment['entity_id'] );
+ }
+ }
+
+ /**
+ * Test the get_items method with an invalid order ID.
+ */
+ public function test_get_fulfillments_invalid_order_id() {
+ // Do the request with an invalid order ID.
+ $request = new WP_REST_Request( 'GET', '/wc/v3/orders/999999/fulfillments' );
+ $response = $this->server->dispatch( $request );
+
+ // Check the response.
+ $this->assertEquals( WP_Http::NOT_FOUND, $response->get_status() );
+ $this->assertEquals( 'Invalid order ID.', $response->get_data()['message'] );
+ }
+
+ /**
+ * Test the get_items method with a non-matching user.
+ */
+ public function test_get_fulfillments_invalid_user() {
+ // Prepare the test environment.
+ $current_user = wp_get_current_user();
+ $this->assertEquals( 0, $current_user->ID );
+ wp_set_current_user( self::$created_user_id );
+ $this->assertEquals( self::$created_user_id, get_current_user_id() );
+ $this->assertFalse( current_user_can( 'manage_woocommerce' ) ); // phpcs:ignore WordPress.WP.Capabilities.Unknown
+
+ // Do the request as a non-admin user, for another user's order.
+ $request = new WP_REST_Request( 'GET', '/wc/v3/orders/' . self::$created_order_ids[0] . '/fulfillments' );
+ $response = $this->server->dispatch( $request );
+
+ // Check the response.
+ $this->assertEquals( WP_Http::FORBIDDEN, $response->get_status() );
+ $this->assertEquals(
+ array(
+ 'code' => 'woocommerce_rest_cannot_view',
+ 'message' => 'Sorry, you cannot view resources.',
+ 'data' => array( 'status' => WP_Http::FORBIDDEN ),
+ ),
+ $response->get_data()
+ );
+
+ // Clean up the test environment.
+ wp_set_current_user( $current_user->ID );
+ }
+
+ /**
+ * Test the get_items method with an administrator.
+ */
+ public function test_get_fulfillments_with_admin() {
+ // Prepare the test environment.
+ $current_user = wp_get_current_user();
+ $this->assertEquals( 0, $current_user->ID );
+ $this->assertFalse( current_user_can( 'manage_woocommerce' ) ); // phpcs:ignore WordPress.WP.Capabilities.Unknown
+ wp_set_current_user( 1 );
+ $this->assertTrue( current_user_can( 'manage_woocommerce' ) ); // phpcs:ignore WordPress.WP.Capabilities.Unknown
+ $this->assertEquals( 1, get_current_user_id() );
+
+ // Do the request as an admin user, for another user's order.
+ $request = new WP_REST_Request( 'GET', '/wc/v3/orders/' . self::$created_order_ids[0] . '/fulfillments' );
+ $response = $this->server->dispatch( $request );
+
+ // Check the response.
+ $this->assertEquals( WP_Http::OK, $response->get_status() );
+ $this->assertIsArray( $response->get_data() );
+ $this->assertArrayHasKey( 'fulfillments', $response->get_data() );
+
+ // Clean up the test environment.
+ wp_set_current_user( $current_user->ID );
+ }
+
+ /**
+ * Test creating a fulfillment (user doesn't have rights).
+ */
+ public function test_create_fulfillment_non_admin() {
+ // Create a new order.
+ $order = WC_Helper_Order::create_order( get_current_user_id() );
+ $this->assertInstanceOf( WC_Order::class, $order );
+
+ // Create a fulfillment for the order.
+ $request = new WP_REST_Request( 'POST', '/wc/v3/orders/' . $order->get_id() . '/fulfillments' );
+ $request->set_header( 'content-type', 'application/json' );
+ $request->set_body(
+ wp_json_encode(
+ array(
+ 'entity_type' => WC_Order::class,
+ 'entity_id' => '' . $order->get_id(),
+ 'status' => 'unfulfilled',
+ 'is_fulfilled' => false,
+ 'meta_data' => array(
+ array(
+ 'key' => 'test_meta_key',
+ 'value' => 'test_meta_value',
+ ),
+ array(
+ 'key' => 'test_meta_key_2',
+ 'value' => 'test_meta_value_2',
+ ),
+ array(
+ 'key' => '_items',
+ 'value' => array(
+ array(
+ 'item_id' => 1,
+ 'qty' => 2,
+ ),
+ array(
+ 'item_id' => 2,
+ 'qty' => 3,
+ ),
+ ),
+ ),
+ ),
+ )
+ )
+ );
+ $response = $this->server->dispatch( $request );
+
+ // Check the response. It should be an error saying that a regular user cannot create a fulfillment.
+ $this->assertEquals( WP_Http::UNAUTHORIZED, $response->get_status() );
+ $this->assertEquals(
+ array(
+ 'code' => 'woocommerce_rest_cannot_create',
+ 'message' => 'Sorry, you cannot create resources.',
+ 'data' => array( 'status' => WP_Http::UNAUTHORIZED ),
+ ),
+ $response->get_data()
+ );
+ }
+
+ /**
+ * Test creating a fulfillment (user is admin).
+ */
+ public function test_create_fulfillment_as_admin() {
+ // Create a new order.
+ $order = WC_Helper_Order::create_order( get_current_user_id() );
+ $this->assertInstanceOf( WC_Order::class, $order );
+
+ // Create a fulfillment for the order.
+ wp_set_current_user( 1 );
+ $request = new WP_REST_Request( 'POST', '/wc/v3/orders/' . $order->get_id() . '/fulfillments' );
+ $request->set_header( 'content-type', 'application/json' );
+ $request->set_body(
+ wp_json_encode(
+ array(
+ 'entity_type' => WC_Order::class,
+ 'entity_id' => '' . $order->get_id(),
+ 'status' => 'unfulfilled',
+ 'is_fulfilled' => false,
+ 'meta_data' => array(
+ array(
+ 'id' => 0,
+ 'key' => 'test_meta_key',
+ 'value' => 'test_meta_value',
+ ),
+ array(
+ 'id' => 0,
+ 'key' => 'test_meta_key_2',
+ 'value' => 'test_meta_value_2',
+ ),
+ array(
+ 'id' => 0,
+ 'key' => '_items',
+ 'value' => array(
+ array(
+ 'item_id' => 1,
+ 'qty' => 2,
+ ),
+ array(
+ 'item_id' => 2,
+ 'qty' => 3,
+ ),
+ ),
+ ),
+ ),
+ )
+ )
+ );
+ $response = $this->server->dispatch( $request );
+
+ // Check the response. It should be ok.
+ $this->assertEquals( WP_Http::CREATED, $response->get_status() );
+ $this->assertIsArray( $response->get_data() );
+ $this->assertArrayHasKey( 'fulfillment', $response->get_data() );
+ $fulfillment = $response->get_data()['fulfillment'];
+ $this->assertIsArray( $fulfillment );
+ $this->assertArrayHasKey( 'fulfillment_id', $fulfillment );
+ $this->assertNotNull( $fulfillment['fulfillment_id'] );
+ $this->assertEquals( WC_Order::class, $fulfillment['entity_type'] );
+ $this->assertEquals( $order->get_id(), $fulfillment['entity_id'] );
+ $this->assertEquals( 'unfulfilled', $fulfillment['status'] );
+ $this->assertEquals( false, $fulfillment['is_fulfilled'] );
+ $this->assertIsArray( $fulfillment['meta_data'] );
+ $this->assertCount( 3, $fulfillment['meta_data'] );
+ $this->assertEquals( 'test_meta_value', $fulfillment['meta_data'][0]['value'] );
+ $this->assertEquals( 'test_meta_value_2', $fulfillment['meta_data'][1]['value'] );
+ $this->assertEquals( 'test_meta_key', $fulfillment['meta_data'][0]['key'] );
+ $this->assertEquals( 'test_meta_key_2', $fulfillment['meta_data'][1]['key'] );
+ $this->assertEquals( '_items', $fulfillment['meta_data'][2]['key'] );
+ $this->assertEquals(
+ array(
+ array(
+ 'item_id' => 1,
+ 'qty' => 2,
+ ),
+ array(
+ 'item_id' => 2,
+ 'qty' => 3,
+ ),
+ ),
+ $fulfillment['meta_data'][2]['value']
+ );
+
+ // Clean up the test environment.
+ wp_set_current_user( 0 );
+ }
+
+ /**
+ * Test creating a fulfillment without items.
+ */
+ public function test_create_fulfillment_without_items() {
+ // Create a new order.
+ $order = WC_Helper_Order::create_order( get_current_user_id() );
+ $this->assertInstanceOf( WC_Order::class, $order );
+
+ // Set the current user to an admin.
+ wp_set_current_user( 1 );
+
+ // Create a fulfillment for the order.
+ $request = new WP_REST_Request( 'POST', '/wc/v3/orders/' . $order->get_id() . '/fulfillments' );
+ $request->set_header( 'content-type', 'application/json' );
+ $request->set_body(
+ wp_json_encode(
+ array(
+ 'entity_type' => WC_Order::class,
+ 'entity_id' => '' . $order->get_id(),
+ 'status' => 'unfulfilled',
+ 'is_fulfilled' => false,
+ 'meta_data' => array(
+ array(
+ 'key' => 'test_meta_key',
+ 'value' => 'test_meta_value',
+ ),
+ array(
+ 'key' => 'test_meta_key_2',
+ 'value' => 'test_meta_value_2',
+ ),
+ ),
+ )
+ )
+ );
+ $response = $this->server->dispatch( $request );
+
+ // Check the response. It should be an error saying that a fulfillment should contain at least one item.
+ $this->assertEquals( WP_Http::BAD_REQUEST, $response->get_status() );
+ $this->assertEquals(
+ array(
+ 'code' => 0,
+ 'message' => 'The fulfillment should contain at least one item.',
+ 'data' => array( 'status' => WP_Http::BAD_REQUEST ),
+ ),
+ $response->get_data()
+ );
+ }
+
+ /**
+ * Test creating a fulfillment with invalid items.
+ *
+ * @param array $items Invalid items to test.
+ *
+ * @dataProvider invalid_items_provider
+ */
+ public function test_create_fulfillment_with_invalid_items( $items ) {
+ // Create a new order.
+ $order = WC_Helper_Order::create_order( get_current_user_id() );
+ $this->assertInstanceOf( WC_Order::class, $order );
+
+ // Set the current user to an admin.
+ wp_set_current_user( 1 );
+
+ // Create a fulfillment for the order with invalid items.
+ $request = new WP_REST_Request( 'POST', '/wc/v3/orders/' . $order->get_id() . '/fulfillments' );
+ $request->set_header( 'content-type', 'application/json' );
+ $request->set_body(
+ wp_json_encode(
+ array(
+ 'entity_type' => WC_Order::class,
+ 'entity_id' => '' . $order->get_id(),
+ 'status' => 'unfulfilled',
+ 'is_fulfilled' => false,
+ 'meta_data' => array(
+ array(
+ 'id' => 0,
+ 'key' => '_items',
+ 'value' => $items,
+ ),
+ ),
+ )
+ )
+ );
+ $response = $this->server->dispatch( $request );
+
+ // Check the response. It should be an error saying that the items are invalid.
+ $this->assertEquals( WP_Http::BAD_REQUEST, $response->get_status() );
+ $this->assertEquals(
+ array(
+ 'code' => 0,
+ 'message' => 'Invalid item.',
+ 'data' => array( 'status' => WP_Http::BAD_REQUEST ),
+ ),
+ $response->get_data()
+ );
+ }
+
+ /**
+ * Test creating a fulfillment with an invalid order ID.
+ */
+ public function test_create_fulfillment_invalid_order_id() {
+ // Create a new order.
+ $order = WC_Helper_Order::create_order( get_current_user_id() );
+ $this->assertInstanceOf( WC_Order::class, $order );
+
+ // Set the current user to an admin.
+ wp_set_current_user( 1 );
+
+ // Create a fulfillment for the order with an invalid order ID.
+ $request = new WP_REST_Request( 'POST', '/wc/v3/orders/999999/fulfillments' );
+ $request->set_header( 'content-type', 'application/json' );
+ $request->set_body(
+ wp_json_encode(
+ array(
+ 'entity_type' => WC_Order::class,
+ 'entity_id' => '' . $order->get_id(),
+ 'status' => 'unfulfilled',
+ 'is_fulfilled' => false,
+ 'meta_data' => array(
+ array(
+ 'id' => 0,
+ 'key' => 'test_meta_key',
+ 'value' => 'test_meta_value',
+ ),
+ array(
+ 'id' => 0,
+ 'key' => 'test_meta_key_2',
+ 'value' => 'test_meta_value_2',
+ ),
+ array(
+ 'id' => 0,
+ 'key' => '_items',
+ 'value' => array(
+ array(
+ 'item_id' => 1,
+ 'qty' => 2,
+ ),
+ array(
+ 'item_id' => 2,
+ 'qty' => 3,
+ ),
+ ),
+ ),
+ ),
+ )
+ )
+ );
+ $response = $this->server->dispatch( $request );
+
+ // Check the response. It should be an error saying that the order ID is invalid.
+ $this->assertEquals( WP_Http::NOT_FOUND, $response->get_status() );
+ $this->assertEquals(
+ array(
+ 'code' => 'woocommerce_rest_order_invalid_id',
+ 'message' => 'Invalid order ID.',
+ 'data' => array( 'status' => WP_Http::NOT_FOUND ),
+ ),
+ $response->get_data()
+ );
+ }
+
+ /**
+ * Test getting a single fulfillment for a regular user.
+ */
+ public function test_get_fulfillment_for_regular_user() {
+ // Get a previously created order.
+ $order_id = self::$created_order_ids[0];
+ $request = new WP_REST_Request( 'GET', '/wc/v3/orders/' . $order_id . '/fulfillments' );
+ $response = $this->server->dispatch( $request );
+
+ $fulfillments = $response->get_data()['fulfillments'];
+ $this->assertIsArray( $fulfillments );
+ $this->assertCount( 10, $fulfillments );
+
+ $fulfillment_id = $fulfillments[0]['fulfillment_id'];
+
+ // Get the fulfillment for the order.
+ $request = new WP_REST_Request( 'GET', '/wc/v3/orders/' . $order_id . '/fulfillments/' . $fulfillment_id );
+ $response = $this->server->dispatch( $request );
+
+ // Check if $fulfillments[0] is the same as $response.
+ $this->assertEquals( WP_Http::OK, $response->get_status() );
+ $this->assertIsArray( $response->get_data() );
+ $this->assertArrayHasKey( 'fulfillment', $response->get_data() );
+ $fulfillment = $response->get_data()['fulfillment'];
+ $this->assertEquals( $fulfillments[0]['fulfillment_id'], $fulfillment['fulfillment_id'] );
+ $this->assertEquals( $fulfillments[0]['entity_type'], $fulfillment['entity_type'] );
+ $this->assertEquals( $fulfillments[0]['entity_id'], $fulfillment['entity_id'] );
+ $this->assertEquals( $fulfillments[0]['status'], $fulfillment['status'] );
+ $this->assertEquals( $fulfillments[0]['is_fulfilled'], $fulfillment['is_fulfilled'] );
+ $this->assertEquals( $fulfillments[0]['meta_data'], $fulfillment['meta_data'] );
+ $this->assertEquals( $fulfillments[0]['date_updated'], $fulfillment['date_updated'] );
+ }
+
+ /**
+ * Test getting a single fulfillment for an admin user.
+ */
+ public function test_get_fulfillment_for_admin_user() {
+ // Get a previously created order.
+ $order_id = self::$created_order_ids[0];
+ $request = new WP_REST_Request( 'GET', '/wc/v3/orders/' . $order_id . '/fulfillments' );
+ $response = $this->server->dispatch( $request );
+
+ $fulfillments = $response->get_data()['fulfillments'];
+ $this->assertIsArray( $fulfillments );
+ $this->assertCount( 10, $fulfillments );
+
+ $fulfillment_id = $fulfillments[0]['fulfillment_id'];
+
+ // Set the current user to an admin.
+ wp_set_current_user( 1 );
+
+ // Get the fulfillment for the order.
+ $request = new WP_REST_Request( 'GET', '/wc/v3/orders/' . $order_id . '/fulfillments/' . $fulfillment_id );
+ $response = $this->server->dispatch( $request );
+
+ // Check if $fulfillments[0] is the same as $response.
+ $this->assertEquals( WP_Http::OK, $response->get_status() );
+ $this->assertIsArray( $response->get_data() );
+ $this->assertArrayHasKey( 'fulfillment', $response->get_data() );
+ $fulfillment = $response->get_data()['fulfillment'];
+ $this->assertEquals( $fulfillments[0]['fulfillment_id'], $fulfillment['fulfillment_id'] );
+ }
+
+ /**
+ * Test getting a single fulfillment with an invalid order ID.
+ */
+ public function test_get_fulfillment_invalid_order_id() {
+ // Get a previously created order.
+ $order_id = self::$created_order_ids[0];
+ $request = new WP_REST_Request( 'GET', '/wc/v3/orders/' . $order_id . '/fulfillments' );
+ $response = $this->server->dispatch( $request );
+
+ $fulfillments = $response->get_data()['fulfillments'];
+ $this->assertIsArray( $fulfillments );
+ $this->assertCount( 10, $fulfillments );
+
+ $fulfillment_id = $fulfillments[0]['fulfillment_id'];
+
+ // Get the fulfillment for the order with an invalid order ID.
+ $request = new WP_REST_Request( 'GET', '/wc/v3/orders/999999/fulfillments/' . $fulfillment_id );
+ $response = $this->server->dispatch( $request );
+
+ // Check the response. It should be an error saying that the order ID is invalid.
+ $this->assertEquals( WP_Http::NOT_FOUND, $response->get_status() );
+ $this->assertEquals(
+ array(
+ 'code' => 'woocommerce_rest_order_invalid_id',
+ 'message' => 'Invalid order ID.',
+ 'data' => array( 'status' => WP_Http::NOT_FOUND ),
+ ),
+ $response->get_data()
+ );
+ }
+
+ /**
+ * Test getting a single fulfillment with an invalid fulfillment ID.
+ */
+ public function test_get_fulfillment_invalid_fulfillment_id() {
+ // Get a previously created order.
+ $order_id = self::$created_order_ids[0];
+ $request = new WP_REST_Request( 'GET', '/wc/v3/orders/' . $order_id . '/fulfillments' );
+ $response = $this->server->dispatch( $request );
+
+ $fulfillments = $response->get_data()['fulfillments'];
+ $this->assertIsArray( $fulfillments );
+ $this->assertCount( 10, $fulfillments );
+
+ // Get the fulfillment for the order with an invalid fulfillment ID.
+ $request = new WP_REST_Request( 'GET', '/wc/v3/orders/' . $order_id . '/fulfillments/999999' );
+ $response = $this->server->dispatch( $request );
+
+ // Check the response. It should be an error saying that the fulfillment ID is invalid.
+ $this->assertEquals( WP_Http::BAD_REQUEST, $response->get_status() );
+
+ $this->assertEquals(
+ array(
+ 'code' => 0,
+ 'message' => 'Fulfillment not found.',
+ 'data' => array( 'status' => WP_Http::BAD_REQUEST ),
+ ),
+ $response->get_data()
+ );
+ }
+
+ /**
+ * Test getting a single fulfillment for a non-matching user.
+ */
+ public function test_get_fulfillment_invalid_user() {
+ // Prepare the test environment.
+ $current_user = wp_get_current_user();
+
+ // Get a previously created order.
+ $order_id = self::$created_order_ids[0];
+ $request = new WP_REST_Request( 'GET', '/wc/v3/orders/' . $order_id . '/fulfillments' );
+ $response = $this->server->dispatch( $request );
+
+ $fulfillments = $response->get_data()['fulfillments'];
+ $this->assertIsArray( $fulfillments );
+ $this->assertCount( 10, $fulfillments );
+
+ $fulfillment_id = $fulfillments[0]['fulfillment_id'];
+
+ wp_set_current_user( self::$created_user_id );
+
+ // Get the fulfillment for the order, with a different user.
+ $request = new WP_REST_Request( 'GET', '/wc/v3/orders/' . $order_id . '/fulfillments/' . $fulfillment_id );
+ $response = $this->server->dispatch( $request );
+
+ // Check the response. It should be an error saying that a regular user cannot view a fulfillment.
+ $this->assertEquals( WP_Http::FORBIDDEN, $response->get_status() );
+ $this->assertEquals(
+ array(
+ 'code' => 'woocommerce_rest_cannot_view',
+ 'message' => 'Sorry, you cannot view resources.',
+ 'data' => array( 'status' => WP_Http::FORBIDDEN ),
+ ),
+ $response->get_data()
+ );
+
+ wp_set_current_user( $current_user->ID );
+ }
+
+ /**
+ * Test updating a fulfillment for a regular user.
+ */
+ public function test_update_fulfillment_for_regular_user() {
+ // Get a previously created order.
+ $order_id = self::$created_order_ids[0];
+ $request = new WP_REST_Request( 'GET', '/wc/v3/orders/' . $order_id . '/fulfillments' );
+ $response = $this->server->dispatch( $request );
+
+ $fulfillments = $response->get_data()['fulfillments'];
+ $this->assertIsArray( $fulfillments );
+ $this->assertCount( 10, $fulfillments );
+
+ $fulfillment_id = $fulfillments[0]['fulfillment_id'];
+
+ // Update the fulfillment for the order.
+ wp_set_current_user( self::$created_user_id );
+ $request = new WP_REST_Request( 'PUT', '/wc/v3/orders/' . $order_id . '/fulfillments/' . $fulfillment_id );
+ $request->set_header( 'content-type', 'application/json' );
+ $request->set_body(
+ wp_json_encode(
+ array(
+ 'status' => 'fulfilled',
+ 'is_fulfilled' => true,
+ 'meta_data' => array(
+ array(
+ 'id' => 0,
+ 'key' => 'test_meta_key',
+ 'value' => 'test_meta_value',
+ ),
+ array(
+ 'id' => 0,
+ 'key' => 'test_meta_key_2',
+ 'value' => 'test_meta_value_2',
+ ),
+ array(
+ 'id' => 0,
+ 'key' => '_items',
+ 'value' => array(
+ array(
+ 'item_id' => 1,
+ 'qty' => 2,
+ ),
+ array(
+ 'item_id' => 2,
+ 'qty' => 3,
+ ),
+ ),
+ ),
+ ),
+ )
+ )
+ );
+ wp_set_current_user( self::$created_user_id );
+ wp_set_current_user( self::$created_user_id );
+ $response = $this->server->dispatch( $request );
+ // Check the response. It should be an error saying that a regular user cannot update a fulfillment.
+ $this->assertEquals( WP_Http::FORBIDDEN, $response->get_status() );
+ $this->assertEquals(
+ array(
+ 'code' => 'rest_forbidden',
+ 'message' => 'Sorry, you are not allowed to do that.',
+ 'data' => array( 'status' => WP_Http::FORBIDDEN ),
+ ),
+ $response->get_data()
+ );
+ }
+
+ /**
+ * Test updating a fulfillment for an admin user.
+ */
+ public function test_update_fulfillment_for_admin_user() {
+ // Get a previously created order.
+ $order_id = self::$created_order_ids[0];
+ $request = new WP_REST_Request( 'GET', '/wc/v3/orders/' . $order_id . '/fulfillments' );
+ $response = $this->server->dispatch( $request );
+
+ $fulfillments = $response->get_data()['fulfillments'];
+ $this->assertIsArray( $fulfillments );
+ $this->assertCount( 10, $fulfillments );
+
+ $fulfillment_id = $fulfillments[0]['fulfillment_id'];
+
+ // Update the fulfillment for the order.
+ wp_set_current_user( 1 );
+ $request = new WP_REST_Request( 'PUT', '/wc/v3/orders/' . $order_id . '/fulfillments/' . $fulfillment_id );
+ $request->set_header( 'content-type', 'application/json' );
+ $request->set_body(
+ wp_json_encode(
+ array(
+ 'status' => 'fulfilled',
+ 'is_fulfilled' => true,
+ 'meta_data' => array(
+ // Test value delete by changing the key.
+ array(
+ 'id' => 0,
+ 'key' => 'test_meta_key_ok',
+ 'value' => 'test_meta_value_ok',
+ ),
+ // Test new value.
+ array(
+ 'id' => 0,
+ 'key' => 'test_meta_key_2',
+ 'value' => 'test_meta_value_2_ok',
+ ),
+ // Test items update.
+ array(
+ 'id' => 0,
+ 'key' => '_items',
+ 'value' => array(
+ array(
+ 'item_id' => 10,
+ 'qty' => 20,
+ ),
+ array(
+ 'item_id' => 20,
+ 'qty' => 30,
+ ),
+ ),
+ ),
+ ),
+ )
+ )
+ );
+
+ $response = $this->server->dispatch( $request );
+
+ // Check the response. It should be ok.
+ $this->assertEquals( WP_Http::OK, $response->get_status() );
+
+ $this->assertIsArray( $response->get_data() );
+ $this->assertArrayHasKey( 'fulfillment', $response->get_data() );
+
+ $fulfillment = $response->get_data()['fulfillment'];
+ $this->assertIsArray( $fulfillment );
+
+ $this->assertArrayHasKey( 'fulfillment_id', $fulfillment );
+ $this->assertNotNull( $fulfillment['fulfillment_id'] );
+
+ $this->assertEquals( WC_Order::class, $fulfillment['entity_type'] );
+ $this->assertEquals( $order_id, $fulfillment['entity_id'] );
+ $this->assertEquals( 'fulfilled', $fulfillment['status'] );
+ $this->assertEquals( true, $fulfillment['is_fulfilled'] );
+
+ $this->assertIsArray( $fulfillment['meta_data'] );
+ $this->assertCount( 4, $fulfillment['meta_data'] ); // _fulfilled_date is added automatically.
+
+ // Test updated meta data.
+ $this->assertNotContains( 'test_meta_key', wp_list_pluck( $fulfillment['meta_data'], 'key' ) );
+ foreach ( $fulfillment['meta_data'] as $meta ) {
+ $this->assertArrayHasKey( 'id', $meta );
+ $this->assertArrayHasKey( 'key', $meta );
+ $this->assertArrayHasKey( 'value', $meta );
+ switch ( $meta['key'] ) {
+ case 'test_meta_key_ok':
+ $this->assertEquals( 'test_meta_value_ok', $meta['value'] );
+ break;
+ case 'test_meta_key_2':
+ $this->assertEquals( 'test_meta_value_2_ok', $meta['value'] );
+ break;
+ case '_items':
+ $this->assertEquals(
+ array(
+ array(
+ 'item_id' => 10,
+ 'qty' => 20,
+ ),
+ array(
+ 'item_id' => 20,
+ 'qty' => 30,
+ ),
+ ),
+ $meta['value']
+ );
+ break;
+ }
+ }
+
+ wp_set_current_user( self::$created_user_id );
+ }
+
+ /**
+ * Test updating a fulfillment with an invalid order ID.
+ */
+ public function test_update_fulfillment_invalid_order_id() {
+ // Get a previously created order.
+ $order_id = self::$created_order_ids[0];
+ $request = new WP_REST_Request( 'GET', '/wc/v3/orders/' . $order_id . '/fulfillments' );
+ $response = $this->server->dispatch( $request );
+
+ $fulfillments = $response->get_data()['fulfillments'];
+ $this->assertIsArray( $fulfillments );
+ $this->assertCount( 10, $fulfillments );
+
+ $fulfillment_id = $fulfillments[0]['fulfillment_id'];
+
+ // Update the fulfillment for the order with an invalid order ID.
+ wp_set_current_user( 1 );
+ $request = new WP_REST_Request( 'PUT', '/wc/v3/orders/999999/fulfillments/' . $fulfillment_id );
+ $request->set_header( 'content-type', 'application/json' );
+ $request->set_body(
+ wp_json_encode(
+ array(
+ 'status' => 'fulfilled',
+ 'is_fulfilled' => true,
+ 'meta_data' => array(
+ array(
+ 'id' => 0,
+ 'key' => 'test_meta_key',
+ 'value' => 'test_meta_value',
+ ),
+ array(
+ 'id' => 0,
+ 'key' => 'test_meta_key_2',
+ 'value' => 'test_meta_value_2',
+ ),
+ array(
+ 'id' => 0,
+ 'key' => '_items',
+ 'value' => array(
+ array(
+ 'item_id' => 1,
+ 'qty' => 2,
+ ),
+ array(
+ 'item_id' => 2,
+ 'qty' => 3,
+ ),
+ ),
+ ),
+ ),
+ )
+ )
+ );
+ $response = $this->server->dispatch( $request );
+ // Check the response. It should be an error saying that the order ID is invalid.
+ $this->assertEquals( WP_Http::NOT_FOUND, $response->get_status() );
+ $this->assertEquals(
+ array(
+ 'code' => 'woocommerce_rest_order_invalid_id',
+ 'message' => 'Invalid order ID.',
+ 'data' => array( 'status' => WP_Http::NOT_FOUND ),
+ ),
+ $response->get_data()
+ );
+
+ // Clean up the test environment.
+ wp_set_current_user( 0 );
+ }
+
+ /**
+ * Test updating a fulfillment with an invalid fulfillment ID.
+ */
+ public function test_update_fulfillment_invalid_fulfillment_id() {
+ // Get a previously created order.
+ $order_id = self::$created_order_ids[0];
+ $request = new WP_REST_Request( 'GET', '/wc/v3/orders/' . $order_id . '/fulfillments' );
+ $response = $this->server->dispatch( $request );
+
+ $fulfillments = $response->get_data()['fulfillments'];
+ $this->assertIsArray( $fulfillments );
+ $this->assertCount( 10, $fulfillments );
+
+ // Update the fulfillment for the order with an invalid fulfillment ID.
+ wp_set_current_user( 1 );
+ $request = new WP_REST_Request( 'PUT', '/wc/v3/orders/' . $order_id . '/fulfillments/999999' );
+ $request->set_header( 'content-type', 'application/json' );
+ $request->set_body(
+ wp_json_encode(
+ array(
+ 'status' => 'fulfilled',
+ 'is_fulfilled' => true,
+ 'meta_data' => array(
+ array(
+ 'id' => 0,
+ 'key' => 'test_meta_key',
+ 'value' => 'test_meta_value',
+ ),
+ array(
+ 'id' => 0,
+ 'key' => 'test_meta_key_2',
+ 'value' => 'test_meta_value_2',
+ ),
+ array(
+ 'id' => 0,
+ 'key' => '_items',
+ 'value' =>
+ array(
+ array(
+ 'item_id' => 1,
+ 'qty' => 2,
+ ),
+ array(
+ 'item_id' => 2,
+ 'qty' => 3,
+ ),
+
+ ),
+ ),
+ ),
+ )
+ )
+ );
+
+ $response = $this->server->dispatch( $request );
+ // Check the response. It should be an error saying that the fulfillment ID is invalid.
+ $this->assertEquals( WP_Http::BAD_REQUEST, $response->get_status() );
+ $this->assertEquals(
+ array(
+ 'code' => 0,
+ 'message' => 'Fulfillment not found.',
+ 'data' => array( 'status' => WP_Http::BAD_REQUEST ),
+ ),
+ $response->get_data()
+ );
+
+ // Clean up the test environment.
+ wp_set_current_user( 0 );
+ }
+
+ /**
+ * Test updating a fulfillment without items.
+ */
+ public function test_update_fulfillment_without_items() {
+ // Get a previously created order.
+ $order_id = self::$created_order_ids[0];
+ $request = new WP_REST_Request( 'GET', '/wc/v3/orders/' . $order_id . '/fulfillments' );
+ $response = $this->server->dispatch( $request );
+
+ $fulfillments = $response->get_data()['fulfillments'];
+ $this->assertIsArray( $fulfillments );
+ $this->assertCount( 10, $fulfillments );
+
+ $fulfillment_id = $fulfillments[0]['fulfillment_id'];
+
+ // Update the fulfillment for the order with an invalid fulfillment ID.
+ wp_set_current_user( 1 );
+ $request = new WP_REST_Request( 'PUT', '/wc/v3/orders/' . $order_id . '/fulfillments/' . $fulfillment_id );
+ $request->set_header( 'content-type', 'application/json' );
+ $request->set_body(
+ wp_json_encode(
+ array(
+ 'status' => 'fulfilled',
+ 'is_fulfilled' => true,
+ 'meta_data' => array(
+ array(
+ 'id' => 0,
+ 'key' => 'test_meta_key',
+ 'value' => 'test_meta_value',
+ ),
+ array(
+ 'id' => 0,
+ 'key' => 'test_meta_key_2',
+ 'value' => 'test_meta_value_2',
+ ),
+ ),
+ )
+ )
+ );
+
+ $response = $this->server->dispatch( $request );
+ // Check the response. It should be an error saying that a fulfillment should contain at least one item.
+ $this->assertEquals( WP_Http::BAD_REQUEST, $response->get_status() );
+ $this->assertEquals(
+ array(
+ 'code' => 0,
+ 'message' => 'The fulfillment should contain at least one item.',
+ 'data' => array( 'status' => WP_Http::BAD_REQUEST ),
+ ),
+ $response->get_data()
+ );
+
+ // Clean up the test environment.
+ wp_set_current_user( 0 );
+ }
+
+ /**
+ * Test updating a fulfillment with invalid items.
+ *
+ * @param array $items Invalid items to test.
+ *
+ * @dataProvider invalid_items_provider
+ */
+ public function test_update_fulfillment_with_invalid_items( $items ) {
+ // Get a previously created order.
+ $order_id = self::$created_order_ids[0];
+ $request = new WP_REST_Request( 'GET', '/wc/v3/orders/' . $order_id . '/fulfillments' );
+ $response = $this->server->dispatch( $request );
+
+ $fulfillments = $response->get_data()['fulfillments'];
+ $this->assertIsArray( $fulfillments );
+ $this->assertCount( 10, $fulfillments );
+
+ $fulfillment_id = $fulfillments[0]['fulfillment_id'];
+
+ wp_set_current_user( 1 );
+
+ // Update the fulfillment for the order with an invalid fulfillment ID.
+ $request = new WP_REST_Request( 'PUT', '/wc/v3/orders/' . $order_id . '/fulfillments/' . $fulfillment_id );
+ $request->set_header( 'content-type', 'application/json' );
+ $request->set_body(
+ wp_json_encode(
+ array(
+ 'status' => 'fulfilled',
+ 'is_fulfilled' => true,
+ 'meta_data' => array(
+ array(
+ 'id' => 0,
+ 'key' => '_items',
+ 'value' => $items,
+ ),
+ ),
+ )
+ )
+ );
+ $response = $this->server->dispatch( $request );
+ // Check the response. It should be an error saying that the item quantity is invalid.
+ $this->assertEquals( WP_Http::BAD_REQUEST, $response->get_status() );
+ $this->assertEquals(
+ array(
+ 'code' => 0,
+ 'message' => 'Invalid item.',
+ 'data' => array( 'status' => WP_Http::BAD_REQUEST ),
+ ),
+ $response->get_data()
+ );
+ // Clean up the test environment.
+ wp_set_current_user( 0 );
+ }
+
+ /**
+ * Data provider for test_update_fulfillment_with_invalid_items.
+ *
+ * @return array
+ */
+ public function invalid_items_provider() {
+ return array(
+ // Invalid item ID.
+ array(
+ array(
+ array(
+ 'item_id' => 0,
+ 'qty' => 2,
+ ),
+ array(
+ 'item_id' => 2,
+ 'qty' => 3,
+ ),
+ ),
+ ),
+ // Invalid item quantity.
+ array(
+ array(
+ array(
+ 'item_id' => 1,
+ 'qty' => -2,
+ ),
+ array(
+ 'item_id' => 2,
+ 'qty' => 3,
+ ),
+ ),
+ ),
+ // Invalid numeric format.
+ array(
+ array(
+ array(
+ 'item_id' => '1',
+ 'qty' => '2',
+ ),
+ array(
+ 'item_id' => '2',
+ 'qty' => '3',
+ ),
+ ),
+ ),
+ // Invalid item format.
+ array(
+ array( 'invalid_item_format' ),
+ ),
+ );
+ }
+
+ /**
+ * Test deleting a fulfillment for a regular user.
+ */
+ public function test_delete_fulfillment_for_regular_user() {
+ // Get a previously created order.
+ $order_id = self::$created_order_ids[0];
+ $request = new WP_REST_Request( 'GET', '/wc/v3/orders/' . $order_id . '/fulfillments' );
+ $response = $this->server->dispatch( $request );
+
+ $fulfillments = $response->get_data()['fulfillments'];
+ $this->assertIsArray( $fulfillments );
+ $this->assertCount( 10, $fulfillments );
+
+ $fulfillment_id = $fulfillments[0]['fulfillment_id'];
+
+ wp_set_current_user( self::$created_user_id );
+
+ // Delete the fulfillment for the order.
+ $request = new WP_REST_Request( 'DELETE', '/wc/v3/orders/' . $order_id . '/fulfillments/' . $fulfillment_id );
+ $response = $this->server->dispatch( $request );
+
+ // Check the response. It should be an error saying that a regular user cannot delete a fulfillment.
+ $this->assertEquals( WP_Http::FORBIDDEN, $response->get_status() );
+ $this->assertEquals(
+ array(
+ 'code' => 'woocommerce_rest_cannot_delete',
+ 'message' => 'Sorry, you cannot delete resources.',
+ 'data' => array( 'status' => WP_Http::FORBIDDEN ),
+ ),
+ $response->get_data()
+ );
+ }
+
+ /**
+ * Test deleting a fulfillment for an admin user.
+ */
+ public function test_delete_fulfillment_for_admin_user() {
+ // Get a previously created order.
+ $order_id = self::$created_order_ids[0];
+ $request = new WP_REST_Request( 'GET', '/wc/v3/orders/' . $order_id . '/fulfillments' );
+ $response = $this->server->dispatch( $request );
+
+ $fulfillments = $response->get_data()['fulfillments'];
+ $this->assertIsArray( $fulfillments );
+ $this->assertCount( 10, $fulfillments );
+
+ $fulfillment_id = $fulfillments[0]['fulfillment_id'];
+
+ wp_set_current_user( 1 );
+
+ // Delete the fulfillment for the order.
+ $request = new WP_REST_Request( 'DELETE', '/wc/v3/orders/' . $order_id . '/fulfillments/' . $fulfillment_id );
+ $response = $this->server->dispatch( $request );
+
+ // Check the response. It should be ok.
+ $this->assertEquals( WP_Http::OK, $response->get_status() );
+ }
+
+ /**
+ * Test deleting a fulfillment with an invalid order ID.
+ */
+ public function test_delete_fulfillment_invalid_order_id() {
+ // Get a previously created order.
+ $order_id = self::$created_order_ids[0];
+ $request = new WP_REST_Request( 'GET', '/wc/v3/orders/' . $order_id . '/fulfillments' );
+ $response = $this->server->dispatch( $request );
+
+ $fulfillments = $response->get_data()['fulfillments'];
+ $this->assertIsArray( $fulfillments );
+ $this->assertCount( 10, $fulfillments );
+
+ $fulfillment_id = $fulfillments[0]['fulfillment_id'];
+
+ wp_set_current_user( 1 );
+
+ // Delete the fulfillment for the order with an invalid order ID.
+ $request = new WP_REST_Request( 'DELETE', '/wc/v3/orders/999999/fulfillments/' . $fulfillment_id );
+ $response = $this->server->dispatch( $request );
+
+ // Check the response. It should be an error saying that the order ID is invalid.
+ $this->assertEquals( WP_Http::NOT_FOUND, $response->get_status() );
+ $this->assertEquals(
+ array(
+ 'code' => 'woocommerce_rest_order_invalid_id',
+ 'message' => 'Invalid order ID.',
+ 'data' => array( 'status' => WP_Http::NOT_FOUND ),
+ ),
+ $response->get_data()
+ );
+ }
+
+ /**
+ * Test deleting a fulfillment with an invalid fulfillment ID.
+ */
+ public function test_delete_fulfillment_invalid_fulfillment_id() {
+ // Get a previously created order.
+ $order_id = self::$created_order_ids[0];
+ $request = new WP_REST_Request( 'GET', '/wc/v3/orders/' . $order_id . '/fulfillments' );
+ $response = $this->server->dispatch( $request );
+
+ $fulfillments = $response->get_data()['fulfillments'];
+ $this->assertIsArray( $fulfillments );
+ $this->assertCount( 10, $fulfillments );
+
+ wp_set_current_user( 1 );
+
+ // Delete the fulfillment for the order with an invalid fulfillment ID.
+ $request = new WP_REST_Request( 'DELETE', '/wc/v3/orders/' . $order_id . '/fulfillments/999999' );
+ $response = $this->server->dispatch( $request );
+
+ // Check the response. It should be an error saying that the fulfillment ID is invalid.
+ $this->assertEquals( WP_Http::BAD_REQUEST, $response->get_status() );
+ $this->assertEquals(
+ array(
+ 'code' => 0,
+ 'message' => 'Fulfillment not found.',
+ 'data' => array( 'status' => WP_Http::BAD_REQUEST ),
+ ),
+ $response->get_data()
+ );
+ }
+
+ /**
+ * Test deleting a fulfillment for a non-matching user.
+ */
+ public function test_delete_fulfillment_invalid_user() {
+ // Prepare the test environment.
+ $current_user = wp_get_current_user();
+
+ // Get a previously created order.
+ $order_id = self::$created_order_ids[0];
+ $request = new WP_REST_Request( 'GET', '/wc/v3/orders/' . $order_id . '/fulfillments' );
+ $response = $this->server->dispatch( $request );
+
+ $fulfillments = $response->get_data()['fulfillments'];
+ $this->assertIsArray( $fulfillments );
+ $this->assertCount( 10, $fulfillments );
+
+ $fulfillment_id = $fulfillments[0]['fulfillment_id'];
+
+ wp_set_current_user( self::$created_user_id );
+
+ // Delete the fulfillment for the order, with a different user.
+ $request = new WP_REST_Request( 'DELETE', '/wc/v3/orders/' . $order_id . '/fulfillments/' . $fulfillment_id );
+ $response = $this->server->dispatch( $request );
+
+ // Check the response. It should be an error saying that a regular user cannot delete a fulfillment.
+ $this->assertEquals( WP_Http::FORBIDDEN, $response->get_status() );
+ $this->assertEquals(
+ array(
+ 'code' => 'woocommerce_rest_cannot_delete',
+ 'message' => 'Sorry, you cannot delete resources.',
+ 'data' => array( 'status' => WP_Http::FORBIDDEN ),
+ ),
+ $response->get_data()
+ );
+
+ wp_set_current_user( $current_user->ID );
+ }
+
+ /**
+ * Test getting fulfillment meta data for a regular user.
+ */
+ public function test_get_fulfillment_meta_data_for_regular_user() {
+ // Get a previously created order.
+ $order_id = self::$created_order_ids[0];
+ $request = new WP_REST_Request( 'GET', '/wc/v3/orders/' . $order_id . '/fulfillments' );
+ $response = $this->server->dispatch( $request );
+
+ $fulfillments = $response->get_data()['fulfillments'];
+ $this->assertIsArray( $fulfillments );
+ $this->assertCount( 10, $fulfillments );
+
+ $fulfillment_id = $fulfillments[0]['fulfillment_id'];
+
+ // Get the fulfillment meta data for the order.
+ $request = new WP_REST_Request( 'GET', '/wc/v3/orders/' . $order_id . '/fulfillments/' . $fulfillment_id . '/metadata' );
+ $response = $this->server->dispatch( $request );
+
+ // Check the response. It should be an error saying that a regular user cannot view a fulfillment.
+ $this->assertEquals( WP_Http::OK, $response->get_status() );
+ $this->assertEquals(
+ array(
+ array(
+ 'key' => 'test_meta_key',
+ 'value' => 'test_meta_value',
+ ),
+ array(
+ 'key' => '_items',
+ 'value' =>
+ array(
+ array(
+ 'item_id' => 1,
+ 'qty' => 2,
+ ),
+ array(
+ 'item_id' => 2,
+ 'qty' => 3,
+ ),
+ ),
+ ),
+ ),
+ array_map(
+ function ( $meta ) {
+ unset( $meta['id'] );
+ return $meta;
+ },
+ $response->get_data()['meta_data']
+ )
+ );
+ }
+
+ /**
+ * Test getting fulfillment meta data for an admin user.
+ */
+ public function test_get_fulfillment_meta_data_for_admin_user() {
+ // Get a previously created order.
+ $order_id = self::$created_order_ids[0];
+ $request = new WP_REST_Request( 'GET', '/wc/v3/orders/' . $order_id . '/fulfillments' );
+ $response = $this->server->dispatch( $request );
+
+ $fulfillments = $response->get_data()['fulfillments'];
+ $this->assertIsArray( $fulfillments );
+ $this->assertCount( 10, $fulfillments );
+
+ $fulfillment_id = $fulfillments[0]['fulfillment_id'];
+
+ wp_set_current_user( 1 );
+
+ // Get the fulfillment meta data for the order.
+ $request = new WP_REST_Request( 'GET', '/wc/v3/orders/' . $order_id . '/fulfillments/' . $fulfillment_id . '/metadata' );
+ $response = $this->server->dispatch( $request );
+
+ // Check the response. It should be ok.
+ $this->assertEquals( WP_Http::OK, $response->get_status() );
+ $this->assertEquals(
+ array(
+ array(
+ 'key' => 'test_meta_key',
+ 'value' => 'test_meta_value',
+ ),
+ array(
+ 'key' => '_items',
+ 'value' => array(
+ array(
+ 'item_id' => 1,
+ 'qty' => 2,
+ ),
+ array(
+ 'item_id' => 2,
+ 'qty' => 3,
+ ),
+ ),
+ ),
+ ),
+ array_map(
+ function ( $meta ) {
+ unset( $meta['id'] );
+ return $meta;
+ },
+ $response->get_data()['meta_data']
+ )
+ );
+ }
+
+ /**
+ * Test getting fulfillment meta data with an invalid order ID.
+ */
+ public function test_get_fulfillment_meta_data_invalid_order_id() {
+ // Get a previously created order.
+ $order_id = self::$created_order_ids[0];
+ $request = new WP_REST_Request( 'GET', '/wc/v3/orders/' . $order_id . '/fulfillments' );
+ $response = $this->server->dispatch( $request );
+
+ $fulfillments = $response->get_data()['fulfillments'];
+ $this->assertIsArray( $fulfillments );
+ $this->assertCount( 10, $fulfillments );
+
+ $fulfillment_id = $fulfillments[0]['fulfillment_id'];
+
+ wp_set_current_user( 1 );
+
+ // Get the fulfillment meta data for the order with an invalid order ID.
+ $request = new WP_REST_Request( 'GET', '/wc/v3/orders/999999/fulfillments/' . $fulfillment_id . '/metadata' );
+ $response = $this->server->dispatch( $request );
+
+ // Check the response. It should be an error saying that the order ID is invalid.
+ $this->assertEquals( WP_Http::NOT_FOUND, $response->get_status() );
+ $this->assertEquals(
+ array(
+ 'code' => 'woocommerce_rest_order_invalid_id',
+ 'message' => 'Invalid order ID.',
+ 'data' => array( 'status' => WP_Http::NOT_FOUND ),
+ ),
+ $response->get_data()
+ );
+ }
+
+ /**
+ * Test getting fulfillment meta data with an invalid fulfillment ID.
+ */
+ public function test_get_fulfillment_meta_data_invalid_fulfillment_id() {
+ // Get a previously created order.
+ $order_id = self::$created_order_ids[0];
+ $request = new WP_REST_Request( 'GET', '/wc/v3/orders/' . $order_id . '/fulfillments' );
+ $response = $this->server->dispatch( $request );
+
+ $fulfillments = $response->get_data()['fulfillments'];
+ $this->assertIsArray( $fulfillments );
+ $this->assertCount( 10, $fulfillments );
+
+ wp_set_current_user( 1 );
+
+ // Get the fulfillment meta data for the order with an invalid fulfillment ID.
+ $request = new WP_REST_Request( 'GET', '/wc/v3/orders/' . $order_id . '/fulfillments/999999/metadata' );
+ $response = $this->server->dispatch( $request );
+
+ // Check the response. It should be an error saying that the fulfillment ID is invalid.
+ $this->assertEquals( WP_Http::BAD_REQUEST, $response->get_status() );
+ $this->assertEquals(
+ array(
+ 'code' => 0,
+ 'message' => 'Fulfillment not found.',
+ 'data' => array( 'status' => WP_Http::BAD_REQUEST ),
+ ),
+ $response->get_data()
+ );
+ }
+
+ /**
+ * Test getting fulfillment meta data for a non-matching user.
+ */
+ public function test_get_fulfillment_meta_data_invalid_user() {
+ // Prepare the test environment.
+ $current_user = wp_get_current_user();
+
+ // Get a previously created order.
+ $order_id = self::$created_order_ids[0];
+ $request = new WP_REST_Request( 'GET', '/wc/v3/orders/' . $order_id . '/fulfillments' );
+ $response = $this->server->dispatch( $request );
+
+ $fulfillments = $response->get_data()['fulfillments'];
+ $this->assertIsArray( $fulfillments );
+ $this->assertCount( 10, $fulfillments );
+
+ $fulfillment_id = $fulfillments[0]['fulfillment_id'];
+
+ wp_set_current_user( self::$created_user_id );
+
+ // Get the fulfillment meta data for the order, with a different user.
+ $request = new WP_REST_Request( 'GET', '/wc/v3/orders/' . $order_id . '/fulfillments/' . $fulfillment_id . '/metadata' );
+ $response = $this->server->dispatch( $request );
+
+ // Check the response. It should be an error saying that a regular user cannot view a fulfillment.
+ $this->assertEquals( WP_Http::FORBIDDEN, $response->get_status() );
+ $this->assertEquals(
+ array(
+ 'code' => 'woocommerce_rest_cannot_view',
+ 'message' => 'Sorry, you cannot view resources.',
+ 'data' => array( 'status' => WP_Http::FORBIDDEN ),
+ ),
+ $response->get_data()
+ );
+
+ wp_set_current_user( $current_user->ID );
+ }
+
+ /**
+ * Test updating fulfillment meta data for a regular user.
+ */
+ public function test_update_fulfillment_meta_data_for_regular_user() {
+ // Get a previously created order.
+ $order_id = self::$created_order_ids[1];
+ $request = new WP_REST_Request( 'GET', '/wc/v3/orders/' . $order_id . '/fulfillments' );
+ $response = $this->server->dispatch( $request );
+
+ $fulfillments = $response->get_data()['fulfillments'];
+ $this->assertIsArray( $fulfillments );
+ $this->assertCount( 10, $fulfillments );
+
+ $fulfillment_id = $fulfillments[1]['fulfillment_id'];
+
+ // Update the fulfillment meta data for the order.
+ $request = new WP_REST_Request( 'PUT', '/wc/v3/orders/' . $order_id . '/fulfillments/' . $fulfillment_id . '/metadata' );
+ $request->set_header( 'content-type', 'application/json' );
+ $request->set_body(
+ wp_json_encode(
+ array(
+ 'meta_data' => array(
+ array(
+ array(
+ 'id' => 0,
+ 'key' => 'test_meta_key',
+ 'value' => 'test_meta_value_updated',
+ ),
+ ),
+ ),
+ )
+ )
+ );
+
+ $response = $this->server->dispatch( $request );
+
+ // Check the response. It should be an error saying that a regular user cannot update a fulfillment.
+ $this->assertEquals( WP_Http::UNAUTHORIZED, $response->get_status() );
+ $this->assertEquals(
+ array(
+ 'code' => 'rest_forbidden',
+ 'message' => 'Sorry, you are not allowed to do that.',
+ 'data' => array( 'status' => WP_Http::UNAUTHORIZED ),
+ ),
+ $response->get_data()
+ );
+ }
+
+ /**
+ * Test updating fulfillment meta data for an admin user.
+ */
+ public function test_update_fulfillment_meta_data_for_admin_user() {
+ // Get a previously created order.
+ $order_id = self::$created_order_ids[2];
+ $request = new WP_REST_Request( 'GET', '/wc/v3/orders/' . $order_id . '/fulfillments' );
+ $response = $this->server->dispatch( $request );
+
+ $fulfillments = $response->get_data()['fulfillments'];
+ $this->assertIsArray( $fulfillments );
+ $this->assertCount( 10, $fulfillments );
+
+ $fulfillment_id = $fulfillments[2]['fulfillment_id'];
+
+ wp_set_current_user( 1 );
+
+ // Update the fulfillment meta data for the order.
+ $request = new WP_REST_Request( 'PUT', '/wc/v3/orders/' . $order_id . '/fulfillments/' . $fulfillment_id . '/metadata' );
+ $request->set_header( 'content-type', 'application/json' );
+ $request->set_body(
+ wp_json_encode(
+ array(
+ 'meta_data' => array(
+ array(
+ 'id' => 0,
+ 'key' => 'test_meta_key',
+ 'value' => 'test_meta_value_updated',
+ ),
+ array(
+ 'id' => 0,
+ 'key' => '_items',
+ 'value' => array(
+ array(
+ 'item_id' => 1,
+ 'qty' => 2,
+ ),
+ array(
+ 'item_id' => 2,
+ 'qty' => 3,
+ ),
+ ),
+ ),
+ ),
+ )
+ )
+ );
+ $response = $this->server->dispatch( $request );
+
+ // Check the response. It should be ok.
+ $this->assertEquals( WP_Http::OK, $response->get_status() );
+ $this->assertEquals(
+ array(
+ array(
+ 'key' => 'test_meta_key',
+ 'value' => 'test_meta_value_updated',
+ ),
+ array(
+ 'key' => '_items',
+ 'value' => array(
+ array(
+ 'item_id' => 1,
+ 'qty' => 2,
+ ),
+ array(
+ 'item_id' => 2,
+ 'qty' => 3,
+ ),
+ ),
+ ),
+ ),
+ array_map(
+ function ( $meta ) {
+ unset( $meta['id'] );
+ return $meta;
+ },
+ $response->get_data()['meta_data']
+ )
+ );
+
+ // Clean up the test environment.
+ wp_set_current_user( 0 );
+ }
+
+ /**
+ * Test updating fulfillment meta data with an invalid order ID.
+ */
+ public function test_update_fulfillment_meta_data_invalid_order_id() {
+ // Get a previously created order.
+ $order_id = self::$created_order_ids[0];
+ $request = new WP_REST_Request( 'GET', '/wc/v3/orders/' . $order_id . '/fulfillments' );
+ $response = $this->server->dispatch( $request );
+
+ $fulfillments = $response->get_data()['fulfillments'];
+ $this->assertIsArray( $fulfillments );
+ $this->assertCount( 10, $fulfillments );
+
+ $fulfillment_id = $fulfillments[0]['fulfillment_id'];
+
+ wp_set_current_user( 1 );
+
+ // Update the fulfillment meta data for the order with an invalid order ID.
+ $request = new WP_REST_Request( 'PUT', '/wc/v3/orders/999999/fulfillments/' . $fulfillment_id . '/metadata' );
+ $request->set_header( 'content-type', 'application/json' );
+ $request->set_body(
+ wp_json_encode(
+ array(
+ 'meta_data' => array(
+ array(
+ array(
+ 'id' => 0,
+ 'key' => 'test_meta_key',
+ 'value' => 'test_meta_value_updated',
+ ),
+ ),
+ ),
+ )
+ )
+ );
+ $response = $this->server->dispatch( $request );
+
+ // Check the response. It should be an error saying that the order ID is invalid.
+ $this->assertEquals( WP_Http::NOT_FOUND, $response->get_status() );
+ $this->assertEquals(
+ array(
+ 'code' => 'woocommerce_rest_order_invalid_id',
+ 'message' => 'Invalid order ID.',
+ 'data' => array( 'status' => WP_Http::NOT_FOUND ),
+ ),
+ $response->get_data()
+ );
+
+ // Clean up the test environment.
+ wp_set_current_user( 0 );
+ }
+
+ /**
+ * Test updating fulfillment meta data with an invalid fulfillment ID.
+ */
+ public function test_update_fulfillment_meta_data_invalid_fulfillment_id() {
+ // Get a previously created order.
+ $order_id = self::$created_order_ids[0];
+ $request = new WP_REST_Request( 'GET', '/wc/v3/orders/' . $order_id . '/fulfillments' );
+ $response = $this->server->dispatch( $request );
+
+ $fulfillments = $response->get_data()['fulfillments'];
+ $this->assertIsArray( $fulfillments );
+ $this->assertCount( 10, $fulfillments );
+
+ wp_set_current_user( 1 );
+
+ // Update the fulfillment meta data for the order with an invalid fulfillment ID.
+ $request = new WP_REST_Request( 'PUT', '/wc/v3/orders/' . $order_id . '/fulfillments/999999/metadata' );
+ $request->set_header( 'content-type', 'application/json' );
+ $request->set_body(
+ wp_json_encode(
+ array(
+ 'meta_data' => array(
+ array(
+ array(
+ 'id' => 0,
+ 'key' => 'test_meta_key',
+ 'value' => 'test_meta_value_updated',
+ ),
+ ),
+ ),
+ )
+ )
+ );
+ $response = $this->server->dispatch( $request );
+
+ // Check the response. It should be an error saying that the fulfillment ID is invalid.
+ $this->assertEquals( WP_Http::BAD_REQUEST, $response->get_status() );
+ $this->assertEquals(
+ array(
+ 'code' => 0,
+ 'message' => 'Fulfillment not found.',
+ 'data' => array( 'status' => WP_Http::BAD_REQUEST ),
+ ),
+ $response->get_data()
+ );
+
+ // Clean up the test environment.
+ wp_set_current_user( 0 );
+ }
+
+ /**
+ * Test updating fulfillment meta data for a non-matching user.
+ */
+ public function test_update_fulfillment_meta_data_invalid_user() {
+ // Prepare the test environment.
+ $current_user = wp_get_current_user();
+
+ // Get a previously created order.
+ $order_id = self::$created_order_ids[0];
+ $request = new WP_REST_Request( 'GET', '/wc/v3/orders/' . $order_id . '/fulfillments' );
+ $response = $this->server->dispatch( $request );
+
+ $fulfillments = $response->get_data()['fulfillments'];
+ $this->assertIsArray( $fulfillments );
+ $this->assertCount( 10, $fulfillments );
+
+ $fulfillment_id = $fulfillments[0]['fulfillment_id'];
+
+ wp_set_current_user( self::$created_user_id );
+
+ // Update the fulfillment meta data for the order, with a different user.
+ $request = new WP_REST_Request( 'PUT', '/wc/v3/orders/' . $order_id . '/fulfillments/' . $fulfillment_id . '/metadata' );
+ $request->set_header( 'content-type', 'application/json' );
+ $request->set_body(
+ wp_json_encode(
+ array(
+ 'meta_data' => array(
+ array(
+ array(
+ 'id' => 0,
+ 'key' => 'test_meta_key',
+ 'value' => 'test_meta_value_updated',
+ ),
+ ),
+ ),
+ )
+ )
+ );
+ $response = $this->server->dispatch( $request );
+
+ // Check the response. It should be an error saying that a regular user cannot update a fulfillment.
+ $this->assertEquals( WP_Http::FORBIDDEN, $response->get_status() );
+ $this->assertEquals(
+ array(
+ 'code' => 'rest_forbidden',
+ 'message' => 'Sorry, you are not allowed to do that.',
+ 'data' => array( 'status' => WP_Http::FORBIDDEN ),
+ ),
+ $response->get_data()
+ );
+
+ // Clean up the test environment.
+ wp_set_current_user( $current_user->ID );
+ }
+
+ /**
+ * Test deleting fulfillment meta data for a regular user.
+ */
+ public function test_delete_fulfillment_meta_data_for_regular_user() {
+ // Get a previously created order.
+ $order_id = self::$created_order_ids[4];
+ $request = new WP_REST_Request( 'GET', '/wc/v3/orders/' . $order_id . '/fulfillments' );
+ $response = $this->server->dispatch( $request );
+
+ $fulfillments = $response->get_data()['fulfillments'];
+ $this->assertIsArray( $fulfillments );
+ $this->assertCount( 10, $fulfillments );
+
+ $fulfillment_id = $fulfillments[4]['fulfillment_id'];
+
+ // Delete the fulfillment meta data for the order.
+ $request = new WP_REST_Request( 'DELETE', '/wc/v3/orders/' . $order_id . '/fulfillments/' . $fulfillment_id . '/metadata' );
+ $request->set_header( 'content-type', 'application/json' );
+ $request->set_body(
+ wp_json_encode(
+ array(
+ 'meta_key' => 'test_meta_key', // phpcs:ignore WordPress.DB.SlowDBQuery.slow_db_query_meta_key
+ ),
+ )
+ );
+ $response = $this->server->dispatch( $request );
+
+ // Check the response. It should be an error saying that a regular user cannot delete a fulfillment.
+ $this->assertEquals( WP_Http::UNAUTHORIZED, $response->get_status() );
+ $this->assertEquals(
+ array(
+ 'code' => 'woocommerce_rest_cannot_delete',
+ 'message' => 'Sorry, you cannot delete resources.',
+ 'data' => array( 'status' => WP_Http::UNAUTHORIZED ),
+ ),
+ $response->get_data()
+ );
+ }
+
+ /**
+ * Test deleting fulfillment meta data for an admin user.
+ */
+ public function test_delete_fulfillment_meta_data_for_admin_user() {
+ // Get a previously created order.
+ $order_id = self::$created_order_ids[0];
+ $request = new WP_REST_Request( 'GET', '/wc/v3/orders/' . $order_id . '/fulfillments' );
+ $response = $this->server->dispatch( $request );
+
+ $fulfillments = $response->get_data()['fulfillments'];
+ $this->assertIsArray( $fulfillments );
+ $this->assertCount( 10, $fulfillments );
+
+ $fulfillment_id = $fulfillments[0]['fulfillment_id'];
+
+ wp_set_current_user( 1 );
+
+ // Delete the fulfillment meta data for the order.
+ $request = new WP_REST_Request( 'DELETE', '/wc/v3/orders/' . $order_id . '/fulfillments/' . $fulfillment_id . '/metadata' );
+ $request->set_header( 'content-type', 'application/json' );
+ $request->set_body(
+ wp_json_encode(
+ array(
+ 'meta_key' => 'test_meta_key', // phpcs:ignore WordPress.DB.SlowDBQuery.slow_db_query_meta_key
+ ),
+ )
+ );
+ $response = $this->server->dispatch( $request );
+
+ // Check the response. It should be ok.
+ $this->assertEquals( WP_Http::NO_CONTENT, $response->get_status() );
+ // Clean up the test environment.
+ wp_set_current_user( 0 );
+ }
+
+ /**
+ * Test deleting fulfillment meta data with an invalid order ID.
+ */
+ public function test_delete_fulfillment_meta_data_invalid_order_id() {
+ // Get a previously created order.
+ $order_id = self::$created_order_ids[0];
+ $request = new WP_REST_Request( 'GET', '/wc/v3/orders/' . $order_id . '/fulfillments' );
+ $response = $this->server->dispatch( $request );
+
+ $fulfillments = $response->get_data()['fulfillments'];
+ $this->assertIsArray( $fulfillments );
+ $this->assertCount( 10, $fulfillments );
+
+ $fulfillment_id = $fulfillments[0]['fulfillment_id'];
+
+ wp_set_current_user( 1 );
+
+ // Delete the fulfillment meta data for the order with an invalid order ID.
+ $request = new WP_REST_Request( 'DELETE', '/wc/v3/orders/999999/fulfillments/' . $fulfillment_id . '/metadata' );
+ $request->set_header( 'content-type', 'application/json' );
+ $request->set_body(
+ wp_json_encode(
+ array(
+ 'meta_key' => 'test_meta_key', // phpcs:ignore WordPress.DB.SlowDBQuery.slow_db_query_meta_key
+ ),
+ )
+ );
+ $response = $this->server->dispatch( $request );
+
+ // Check the response. It should be an error saying that the order ID is invalid.
+ $this->assertEquals( WP_Http::NOT_FOUND, $response->get_status() );
+ $this->assertEquals(
+ array(
+ 'code' => 'woocommerce_rest_order_invalid_id',
+ 'message' => 'Invalid order ID.',
+ 'data' => array( 'status' => WP_Http::NOT_FOUND ),
+ ),
+ $response->get_data()
+ );
+ // Clean up the test environment.
+ wp_set_current_user( 0 );
+ }
+
+ /**
+ * Test deleting fulfillment meta data with an invalid fulfillment ID.
+ */
+ public function test_delete_fulfillment_meta_data_invalid_fulfillment_id() {
+ // Get a previously created order.
+ $order_id = self::$created_order_ids[0];
+ $request = new WP_REST_Request( 'GET', '/wc/v3/orders/' . $order_id . '/fulfillments' );
+ $response = $this->server->dispatch( $request );
+
+ $fulfillments = $response->get_data()['fulfillments'];
+ $this->assertIsArray( $fulfillments );
+ $this->assertCount( 10, $fulfillments );
+
+ wp_set_current_user( 1 );
+
+ // Delete the fulfillment meta data for the order with an invalid fulfillment ID.
+ $request = new WP_REST_Request( 'DELETE', '/wc/v3/orders/' . $order_id . '/fulfillments/999999/metadata' );
+ $request->set_header( 'content-type', 'application/json' );
+ $request->set_body(
+ wp_json_encode(
+ array(
+ 'meta_key' => 'test_meta_key', // phpcs:ignore WordPress.DB.SlowDBQuery.slow_db_query_meta_key
+ ),
+ )
+ );
+ $response = $this->server->dispatch( $request );
+
+ // Check the response. It should be an error saying that the fulfillment ID is invalid.
+ $this->assertEquals( WP_Http::BAD_REQUEST, $response->get_status() );
+ $this->assertEquals(
+ array(
+ 'code' => 0,
+ 'message' => 'Fulfillment not found.',
+ 'data' => array( 'status' => WP_Http::BAD_REQUEST ),
+ ),
+ $response->get_data()
+ );
+ // Clean up the test environment.
+ wp_set_current_user( 0 );
+ }
+
+ /**
+ * Test deleting fulfillment meta data for a non-matching user.
+ */
+ public function test_delete_fulfillment_meta_data_invalid_user() {
+ // Prepare the test environment.
+ $current_user = wp_get_current_user();
+
+ // Get a previously created order.
+ $order_id = self::$created_order_ids[0];
+ $request = new WP_REST_Request( 'GET', '/wc/v3/orders/' . $order_id . '/fulfillments' );
+ $response = $this->server->dispatch( $request );
+
+ $fulfillments = $response->get_data()['fulfillments'];
+ $this->assertIsArray( $fulfillments );
+ $this->assertCount( 10, $fulfillments );
+
+ $fulfillment_id = $fulfillments[0]['fulfillment_id'];
+
+ wp_set_current_user( self::$created_user_id );
+
+ // Delete the fulfillment meta data for the order, with a different user.
+ $request = new WP_REST_Request( 'DELETE', '/wc/v3/orders/' . $order_id . '/fulfillments/' . $fulfillment_id . '/metadata' );
+ $request->set_header( 'content-type', 'application/json' );
+ $request->set_body(
+ wp_json_encode(
+ array(
+ 'meta_key' => 'test_meta_key', // phpcs:ignore WordPress.DB.SlowDBQuery.slow_db_query_meta_key
+ ),
+ )
+ );
+ $response = $this->server->dispatch( $request );
+
+ // Check the response. It should be an error saying that a regular user cannot delete a fulfillment.
+ $this->assertEquals( WP_Http::FORBIDDEN, $response->get_status() );
+ $this->assertEquals(
+ array(
+ 'code' => 'woocommerce_rest_cannot_delete',
+ 'message' => 'Sorry, you cannot delete resources.',
+ 'data' => array( 'status' => WP_Http::FORBIDDEN ),
+ ),
+ $response->get_data()
+ );
+
+ wp_set_current_user( $current_user->ID );
+ }
+}
diff --git a/plugins/woocommerce/tests/php/src/Internal/Fulfillments/Providers/AmazonLogisticsShippingProviderTest.php b/plugins/woocommerce/tests/php/src/Internal/Fulfillments/Providers/AmazonLogisticsShippingProviderTest.php
new file mode 100644
index 0000000000..81917968f6
--- /dev/null
+++ b/plugins/woocommerce/tests/php/src/Internal/Fulfillments/Providers/AmazonLogisticsShippingProviderTest.php
@@ -0,0 +1,210 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Tests\Internal\Fulfillments\Providers;
+
+use Automattic\WooCommerce\Internal\Fulfillments\Providers\AmazonLogisticsShippingProvider;
+
+/**
+ * Unit tests for AmazonLogisticsShippingProvider class.
+ */
+class AmazonLogisticsShippingProviderTest extends \WP_UnitTestCase {
+ /**
+ * The provider instance being tested.
+ *
+ * @var AmazonLogisticsShippingProvider
+ */
+ private AmazonLogisticsShippingProvider $provider;
+
+ /**
+ * Sets up the test fixture.
+ */
+ protected function setUp(): void {
+ parent::setUp();
+ $this->provider = new AmazonLogisticsShippingProvider();
+ }
+
+ /**
+ * Tests the tracking URL generation.
+ */
+ public function test_get_tracking_url(): void {
+ $this->assertEquals(
+ 'https://www.amazon.com/progress-tracker/package/ref=ppx_yo_dt_b_track_package_o0?_=TBA123456789012',
+ $this->provider->get_tracking_url( 'TBA123456789012' )
+ );
+
+ // Test case insensitivity.
+ $this->assertEquals(
+ 'https://www.amazon.com/progress-tracker/package/ref=ppx_yo_dt_b_track_package_o0?_=TBC123456789012',
+ $this->provider->get_tracking_url( 'tbc123456789012' )
+ );
+
+ // Test special characters.
+ $this->assertStringContainsString(
+ rawurlencode( 'TBA-123_456/789' ),
+ $this->provider->get_tracking_url( 'TBA-123_456/789' )
+ );
+ }
+
+ /**
+ * Data provider for tracking number validation tests.
+ *
+ * @return array<array{string, string, string, bool, int|null}> Test cases.
+ */
+ public function trackingNumberProvider(): array {
+ return array(
+ // TBA format - US standard (12 digits).
+ array( 'TBA123456789012', 'US', 'US', true, 100 ),
+ array( 'TBA123456789012', 'CA', 'US', true, 95 ),
+ array( 'TBA123456789012', 'DE', 'FR', true, 95 ),
+
+ // TBC format - Canada standard.
+ array( 'TBC123456789012', 'CA', 'US', true, 100 ),
+ array( 'TBC123456789012', 'US', 'CA', true, 90 ),
+ array( 'TBC123456789012', 'DE', 'FR', true, 90 ),
+
+ // TBM format - Mexico standard.
+ array( 'TBM987654321098', 'MX', 'US', true, 100 ),
+ array( 'TBM987654321098', 'US', 'MX', true, 85 ),
+ array( 'TBM987654321098', 'GB', 'FR', true, 85 ),
+
+ // CC format - Europe.
+ array( 'CC123456789012', 'FR', 'DE', true, 95 ),
+ array( 'CC123456789012', 'BE', 'NL', true, 95 ),
+ array( 'CC123456789012', 'US', 'CA', true, 80 ),
+
+ // GBA format - United Kingdom.
+ array( 'GBA123456789012', 'GB', 'US', true, 100 ),
+ array( 'GBA123456789012', 'US', 'GB', true, 85 ),
+
+ // RB format - China/Hong Kong.
+ array( 'RB123456789012', 'CN', 'US', true, 95 ),
+ array( 'RB123456789012', 'HK', 'US', true, 95 ),
+ array( 'RB123456789012', 'US', 'CN', true, 75 ),
+
+ // ZZ format - Australia.
+ array( 'ZZ123456789012', 'AU', 'US', true, 100 ),
+ array( 'ZZ123456789012', 'US', 'AU', true, 80 ),
+
+ // ZX format - India.
+ array( 'ZX123456789012', 'IN', 'US', true, 100 ),
+ array( 'ZX123456789012', 'US', 'IN', true, 85 ),
+
+ // Fallback format - matches 15-20 character codes.
+ array( 'ABC123456789012', 'US', 'US', true, 60 ), // 15 char fallback.
+ array( 'ABCD123456789012', 'US', 'US', true, 60 ), // 16 char fallback.
+ array( 'AMZN123456789012', 'US', 'US', true, 60 ), // 16 char fallback.
+
+ // Invalid formats.
+ array( 'TB123456789012', 'US', 'US', false, null ), // Incomplete prefix.
+ array( '123456789012', 'US', 'US', false, null ), // No prefix.
+ array( 'L123456789012', 'US', 'US', false, null ), // Invalid L format (China Post).
+
+ // Invalid lengths.
+ array( 'TBA123', 'US', 'US', false, null ), // Too short.
+ array( 'TBA1234567890123456789012', 'US', 'US', false, null ), // Too long (24 chars).
+ array( 'TBA12345678901', 'US', 'US', true, 90 ), // 14 chars - matches TB[A-Z] pattern.
+
+ // Invalid country routes.
+ array( 'TBA123456789012', 'ZZ', 'US', false, null ), // Invalid origin.
+ array( 'TBA123456789012', 'US', 'ZZ', false, null ), // Invalid destination.
+ );
+ }
+
+ /**
+ * Tests tracking number parsing with various scenarios.
+ *
+ * @dataProvider trackingNumberProvider
+ * @param string $tracking_number The tracking number to test.
+ * @param string $from Origin country code.
+ * @param string $to Destination country code.
+ * @param bool $expected_valid Whether the number should be valid.
+ * @param int|null $expected_score Expected ambiguity score.
+ */
+ public function test_try_parse_tracking_number(
+ string $tracking_number,
+ string $from,
+ string $to,
+ bool $expected_valid,
+ ?int $expected_score
+ ): void {
+ $result = $this->provider->try_parse_tracking_number( $tracking_number, $from, $to );
+
+ if ( $expected_valid ) {
+ $this->assertNotNull( $result );
+ $this->assertEquals( $expected_score, $result['ambiguity_score'] );
+ $this->assertStringContainsString(
+ rawurlencode( strtoupper( $tracking_number ) ),
+ $result['url']
+ );
+ } else {
+ $this->assertNull( $result );
+ }
+ }
+
+ /**
+ * Tests regional scoring differences.
+ */
+ public function test_regional_scoring_differences(): void {
+ // TBA format scores higher from US.
+ $us_result = $this->provider->try_parse_tracking_number( 'TBA123456789012', 'US', 'DE' );
+ $de_result = $this->provider->try_parse_tracking_number( 'TBA123456789012', 'DE', 'US' );
+
+ $this->assertEquals( 100, $us_result['ambiguity_score'] );
+ $this->assertEquals( 95, $de_result['ambiguity_score'] );
+
+ // TBC format scores higher from CA.
+ $ca_result = $this->provider->try_parse_tracking_number( 'TBC123456789012', 'CA', 'US' );
+ $us_result = $this->provider->try_parse_tracking_number( 'TBC123456789012', 'US', 'CA' );
+
+ $this->assertEquals( 100, $ca_result['ambiguity_score'] );
+ $this->assertEquals( 90, $us_result['ambiguity_score'] );
+
+ // TBM format scores higher from MX.
+ $mx_result = $this->provider->try_parse_tracking_number( 'TBM123456789012', 'MX', 'US' );
+ $us_result = $this->provider->try_parse_tracking_number( 'TBM123456789012', 'US', 'MX' );
+
+ $this->assertEquals( 100, $mx_result['ambiguity_score'] );
+ $this->assertEquals( 85, $us_result['ambiguity_score'] );
+
+ // GBA format scores higher from GB.
+ $gb_result = $this->provider->try_parse_tracking_number( 'GBA123456789012', 'GB', 'US' );
+ $us_result = $this->provider->try_parse_tracking_number( 'GBA123456789012', 'US', 'GB' );
+
+ $this->assertEquals( 100, $gb_result['ambiguity_score'] );
+ $this->assertEquals( 85, $us_result['ambiguity_score'] );
+ }
+
+ /**
+ * Tests case insensitivity in tracking number parsing.
+ */
+ public function test_case_insensitivity(): void {
+ $lowercase = $this->provider->try_parse_tracking_number( 'tba123456789012', 'US', 'US' );
+ $mixedcase = $this->provider->try_parse_tracking_number( 'TbA123456789012', 'US', 'US' );
+ $uppercase = $this->provider->try_parse_tracking_number( 'TBA123456789012', 'US', 'US' );
+
+ $this->assertEquals( 100, $lowercase['ambiguity_score'] );
+ $this->assertEquals( 100, $mixedcase['ambiguity_score'] );
+ $this->assertEquals( 100, $uppercase['ambiguity_score'] );
+ }
+
+ /**
+ * Tests whitespace handling in tracking numbers.
+ */
+ public function test_whitespace_handling(): void {
+ $result = $this->provider->try_parse_tracking_number( ' TBA 123 456 789 012 ', 'US', 'US' );
+ $this->assertNotNull( $result );
+ $this->assertStringContainsString( 'TBA123456789012', $result['url'] );
+ }
+
+ /**
+ * Tests provider metadata.
+ */
+ public function test_provider_metadata(): void {
+ $this->assertEquals( 'amazon-logistics', $this->provider->get_key() );
+ $this->assertEquals( 'Amazon Logistics', $this->provider->get_name() );
+ $this->assertStringEndsWith(
+ '/assets/images/shipping_providers/amazon-logistics.png',
+ $this->provider->get_icon()
+ );
+ }
+}
diff --git a/plugins/woocommerce/tests/php/src/Internal/Fulfillments/Providers/AustraliaPostShippingProviderTest.php b/plugins/woocommerce/tests/php/src/Internal/Fulfillments/Providers/AustraliaPostShippingProviderTest.php
new file mode 100644
index 0000000000..177eaefa43
--- /dev/null
+++ b/plugins/woocommerce/tests/php/src/Internal/Fulfillments/Providers/AustraliaPostShippingProviderTest.php
@@ -0,0 +1,409 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Tests\Internal\Fulfillments\Providers;
+
+use Automattic\WooCommerce\Internal\Fulfillments\Providers\AustraliaPostShippingProvider;
+
+/**
+ * Unit tests for AustraliaPostShippingProvider class.
+ *
+ * @package WooCommerce\Tests\Internal\Fulfillments\Providers
+ */
+class AustraliaPostShippingProviderTest extends \WP_UnitTestCase {
+ /**
+ * Instance of AustraliaPostShippingProvider used in tests.
+ *
+ * @var AustraliaPostShippingProvider
+ */
+ private AustraliaPostShippingProvider $provider;
+
+ /**
+ * Set up the test environment.
+ */
+ protected function setUp(): void {
+ parent::setUp();
+ $this->provider = new AustraliaPostShippingProvider();
+ }
+
+ /**
+ * Test the get_key method.
+ */
+ public function test_get_key(): void {
+ $this->assertSame( 'australia-post', $this->provider->get_key() );
+ }
+
+ /**
+ * Test the get_name method.
+ */
+ public function test_get_name(): void {
+ $this->assertSame( 'Australia Post', $this->provider->get_name() );
+ }
+
+ /**
+ * Test the get_tracking_url method.
+ */
+ public function test_get_tracking_url(): void {
+ $tracking_number = 'AB123456789AU';
+ $expected_url = 'https://auspost.com.au/mypost/track/details/' . $tracking_number;
+ $this->assertSame( $expected_url, $this->provider->get_tracking_url( $tracking_number ) );
+ }
+
+ /**
+ * Test get_shipping_from_countries returns expected countries.
+ */
+ public function test_get_shipping_from_countries(): void {
+ $countries = $this->provider->get_shipping_from_countries();
+
+ // Test that Australia is included.
+ $expected_countries = array( 'AU' );
+ foreach ( $expected_countries as $country ) {
+ $this->assertContains( $country, $countries, "Country {$country} should be in shipping from countries" );
+ }
+
+ // Test that we have the expected number of countries (only Australia).
+ $this->assertSame( 1, count( $countries ), 'Should have exactly 1 country (Australia)' );
+ }
+
+ /**
+ * Test get_shipping_to_countries includes international destinations.
+ */
+ public function test_get_shipping_to_countries(): void {
+ $to_countries = $this->provider->get_shipping_to_countries();
+
+ // Test that common destinations are included.
+ $expected_destinations = array( 'AU', 'US', 'NZ', 'GB', 'SG', 'JP', 'CA', 'DE' );
+ foreach ( $expected_destinations as $country ) {
+ $this->assertContains( $country, $to_countries, "Country {$country} should be in shipping to countries" );
+ }
+
+ // Test that we have many international destinations.
+ $this->assertGreaterThan( 180, count( $to_countries ), 'Should have many international destinations' );
+ }
+
+ /**
+ * Data provider for valid tracking number parsing tests.
+ *
+ * @return array[]
+ */
+ public function validTrackingNumberProvider(): array {
+ return array(
+ // International UPU S10 format: XX#########AU.
+ array( 'AB123456789AU', 'AU', 'US', 92 ), // Common destination with boost (90+2).
+ array( 'CD987654321AU', 'AU', 'AU', 95 ), // Domestic shipment with boost (90+5).
+ array( 'EF555666777AU', 'AU', 'NZ', 93 ), // APAC destination with boost (90+3).
+
+ // Alternative international format: XX#######AU.
+ array( 'AB1234567AU', 'AU', 'SG', 93 ), // APAC destination with boost (90+3).
+ array( 'CD9876543AU', 'AU', 'AU', 95 ), // Domestic with boost (90+5).
+ array( 'EF5556667AU', 'AU', 'GB', 92 ), // Common destination with boost (90+2).
+
+ // 13-digit domestic tracking.
+ array( '1234567890123', 'AU', 'AU', 95 ), // Domestic with boost (90+5).
+ array( '9876543210987', 'AU', 'HK', 95 ), // APAC destination with boost, has valid check digit (90+3+8->95).
+ array( '5556667778889', 'AU', 'BR', 90 ), // International base score.
+
+ // 12-digit domestic tracking.
+ array( '123456789012', 'AU', 'AU', 95 ), // Domestic with boost (90+5).
+ array( '987654321098', 'AU', 'JP', 95 ), // APAC destination with boost, has valid check digit (90+3+8->95).
+ array( '555666777888', 'AU', 'CA', 92 ), // Common destination with boost (90+2).
+
+ // 11-digit domestic tracking.
+ array( '12345678901', 'AU', 'AU', 95 ), // Domestic with boost (90+5).
+ array( '98765432109', 'AU', 'KR', 93 ), // APAC destination with boost (90+3).
+ array( '55566677788', 'AU', 'DE', 92 ), // Common destination with boost (90+2).
+
+ // Standard format: XX########XX.
+ array( 'AB12345678CD', 'AU', 'AU', 95 ), // Domestic with boost (90+5).
+ array( 'EF98765432GH', 'AU', 'TH', 93 ), // APAC destination with boost (90+3).
+ array( 'IJ55566677KL', 'AU', 'US', 92 ), // Common destination with boost (90+2).
+
+ // Domestic format: X##########X.
+ array( 'A1234567890B', 'AU', 'AU', 95 ), // Domestic with boost (90+5).
+ array( 'C9876543210D', 'AU', 'MY', 93 ), // APAC destination with boost (90+3).
+ array( 'E5556667778F', 'AU', 'GB', 92 ), // Common destination with boost (90+2).
+
+ // Express Post format: XXXX########.
+ array( 'ABCD12345678', 'AU', 'AU', 95 ), // Domestic with boost (90+5).
+ array( 'EFGH98765432', 'AU', 'ID', 93 ), // APAC destination with boost (90+3).
+ array( 'IJKL55566677', 'AU', 'CA', 92 ), // Common destination with boost (90+2).
+
+ // 16-digit format starting with 7.
+ array( '7123456789012345', 'AU', 'AU', 95 ), // Domestic with boost (90+5).
+ array( '7987654321098765', 'AU', 'PH', 93 ), // APAC destination with boost (90+3).
+ array( '7555666777888999', 'AU', 'BR', 90 ), // International base score.
+
+ // 16-digit format starting with 3.
+ array( '3123456789012345', 'AU', 'AU', 95 ), // Domestic with boost (90+5).
+ array( '3987654321098765', 'AU', 'VN', 93 ), // APAC destination with boost (90+3).
+ array( '3555666777888999', 'AU', 'US', 92 ), // Common destination with boost (90+2).
+ );
+ }
+
+ /**
+ * Data provider for invalid tracking number parsing tests.
+ *
+ * @return array[]
+ */
+ public function invalidTrackingNumberProvider(): array {
+ return array(
+ // Wrong origin country (not Australia).
+ array( 'AB123456789AU', 'US', 'AU' ), // From US instead of AU.
+ array( '1234567890123', 'NZ', 'AU' ), // From NZ instead of AU.
+ array( '123456789012', 'GB', 'US' ), // From GB instead of AU.
+
+ // Too short.
+ array( '12345', 'AU', 'US' ), // Too short.
+ array( 'AB123AU', 'AU', 'NZ' ), // Too short for international format.
+ array( 'A12345B', 'AU', 'SG' ), // Too short for domestic format.
+
+ // Too long.
+ array( '12345678901234567890', 'AU', 'US' ), // Too long.
+ array( 'AB123456789012345AU', 'AU', 'NZ' ), // Too long for international format.
+ array( 'ABCDE123456789012345', 'AU', 'SG' ), // Too long for express post.
+
+ // Invalid format.
+ array( '123456789AB', 'AU', 'US' ), // Mixed format invalid.
+ array( 'ABCDEFGHIJK', 'AU', 'NZ' ), // All letters invalid length.
+ array( 'AB12345AU67', 'AU', 'SG' ), // Invalid pattern.
+
+ // Empty or whitespace only.
+ array( '', 'AU', 'US' ), // Empty string.
+ array( ' ', 'AU', 'NZ' ), // Whitespace only.
+
+ // Invalid characters.
+ array( '12-34-56-78-90-12', 'AU', 'US' ), // Dashes (invalid format).
+ array( '123.456.789.012', 'AU', 'NZ' ), // Dots (invalid format).
+ array( 'AB123456@89AU', 'AU', 'SG' ), // Special characters.
+
+ // Invalid starting digits for 16-digit format.
+ array( '1123456789012345', 'AU', 'US' ), // Starts with 1 (not 3 or 7).
+ array( '5987654321098765', 'AU', 'NZ' ), // Starts with 5 (not 3 or 7).
+ );
+ }
+
+ /**
+ * Test try_parse_tracking_number method with valid tracking numbers.
+ *
+ * @dataProvider validTrackingNumberProvider
+ *
+ * @param string $tracking_number The tracking number to test.
+ * @param string $from Origin country.
+ * @param string $to Destination country.
+ * @param int $expected_score Expected ambiguity score.
+ */
+ public function test_try_parse_tracking_number_valid( string $tracking_number, string $from, string $to, int $expected_score ): void {
+ $result = $this->provider->try_parse_tracking_number( $tracking_number, $from, $to );
+
+ $this->assertIsArray( $result, "Should return array for valid tracking number: {$tracking_number}" );
+ $this->assertArrayHasKey( 'url', $result );
+ $this->assertArrayHasKey( 'ambiguity_score', $result );
+
+ // Check score matches expected.
+ $this->assertSame(
+ $expected_score,
+ $result['ambiguity_score'],
+ "Score should be {$expected_score} for {$tracking_number} from {$from} to {$to}"
+ );
+
+ // Check score is within valid range.
+ $this->assertGreaterThanOrEqual( 90, $result['ambiguity_score'], 'Score should be at least 90' );
+ $this->assertLessThanOrEqual( 95, $result['ambiguity_score'], 'Score should not exceed 95' );
+
+ // Check URL format.
+ $normalized_tracking = strtoupper( preg_replace( '/\s+/', '', $tracking_number ) );
+ $expected_url = $this->provider->get_tracking_url( $normalized_tracking );
+ $this->assertSame( $expected_url, $result['url'] );
+ }
+
+ /**
+ * Test try_parse_tracking_number method with invalid tracking numbers.
+ *
+ * @dataProvider invalidTrackingNumberProvider
+ *
+ * @param string $tracking_number The tracking number to test.
+ * @param string $from Origin country.
+ * @param string $to Destination country.
+ */
+ public function test_try_parse_tracking_number_invalid( string $tracking_number, string $from, string $to ): void {
+ $result = $this->provider->try_parse_tracking_number( $tracking_number, $from, $to );
+ $this->assertNull( $result, "Should return null for invalid tracking number: '{$tracking_number}'" );
+ }
+
+ /**
+ * Test tracking number normalization (spaces, case sensitivity).
+ */
+ public function test_tracking_number_normalization(): void {
+ $test_cases = array(
+ // With spaces.
+ array( 'AB 123 456 789 AU', 'AU', 'US' ),
+ array( ' AB123456789AU ', 'AU', 'NZ' ),
+ array( '1234 5678 9012 3', 'AU', 'SG' ),
+
+ // Mixed case.
+ array( 'ab123456789au', 'AU', 'US' ),
+ array( 'Ab123456789Au', 'AU', 'NZ' ),
+ array( 'AB123456789AU', 'AU', 'SG' ),
+ );
+
+ foreach ( $test_cases as $test_case ) {
+ list( $tracking_number, $from, $to ) = $test_case;
+ $result = $this->provider->try_parse_tracking_number( $tracking_number, $from, $to );
+
+ $this->assertIsArray( $result, "Should parse tracking number with normalization: {$tracking_number}" );
+ $this->assertArrayHasKey( 'url', $result );
+
+ // URL should contain normalized version (no spaces, uppercase).
+ $normalized = strtoupper( preg_replace( '/\s+/', '', $tracking_number ) );
+ $this->assertStringContainsString( $normalized, $result['url'] );
+ }
+ }
+
+ /**
+ * Test empty parameter handling.
+ */
+ public function test_empty_parameters(): void {
+ // Empty tracking number.
+ $result = $this->provider->try_parse_tracking_number( '', 'AU', 'US' );
+ $this->assertNull( $result );
+
+ // Empty origin country.
+ $result = $this->provider->try_parse_tracking_number( 'AB123456789AU', '', 'US' );
+ $this->assertNull( $result );
+
+ // Empty destination country.
+ $result = $this->provider->try_parse_tracking_number( 'AB123456789AU', 'AU', '' );
+ $this->assertNull( $result );
+
+ // All empty.
+ $result = $this->provider->try_parse_tracking_number( '', '', '' );
+ $this->assertNull( $result );
+ }
+
+ /**
+ * Test confidence scoring hierarchy.
+ */
+ public function test_confidence_scoring(): void {
+ // Domestic shipment should get highest confidence boost.
+ $result_domestic = $this->provider->try_parse_tracking_number( 'AB123456789AU', 'AU', 'AU' );
+ $this->assertIsArray( $result_domestic );
+ $this->assertSame( 95, $result_domestic['ambiguity_score'] );
+
+ // APAC destination should get medium-high boost.
+ $result_apac = $this->provider->try_parse_tracking_number( 'AB123456789AU', 'AU', 'NZ' );
+ $this->assertIsArray( $result_apac );
+ $this->assertSame( 93, $result_apac['ambiguity_score'] );
+
+ // Common destination should get medium boost.
+ $result_common = $this->provider->try_parse_tracking_number( 'AB123456789AU', 'AU', 'US' );
+ $this->assertIsArray( $result_common );
+ $this->assertSame( 92, $result_common['ambiguity_score'] );
+
+ // International should get base confidence.
+ $result_international = $this->provider->try_parse_tracking_number( 'AB123456789AU', 'AU', 'BR' );
+ $this->assertIsArray( $result_international );
+ $this->assertSame( 90, $result_international['ambiguity_score'] );
+
+ // Verify scoring hierarchy.
+ $this->assertGreaterThan( $result_apac['ambiguity_score'], $result_domestic['ambiguity_score'] );
+ $this->assertGreaterThan( $result_common['ambiguity_score'], $result_apac['ambiguity_score'] );
+ $this->assertGreaterThan( $result_international['ambiguity_score'], $result_common['ambiguity_score'] );
+ }
+
+ /**
+ * Test specific pattern formats.
+ */
+ public function test_pattern_formats(): void {
+ // Test international UPU S10 format XX#########AU.
+ $upu_result = $this->provider->try_parse_tracking_number( 'AB123456789AU', 'AU', 'US' );
+ $this->assertIsArray( $upu_result );
+ $this->assertSame( 92, $upu_result['ambiguity_score'] );
+
+ // Test alternative international format XX#######AU.
+ $alt_intl_result = $this->provider->try_parse_tracking_number( 'AB1234567AU', 'AU', 'US' );
+ $this->assertIsArray( $alt_intl_result );
+ $this->assertSame( 92, $alt_intl_result['ambiguity_score'] );
+
+ // Test 13-digit tracking.
+ $digit13_result = $this->provider->try_parse_tracking_number( '1234567890123', 'AU', 'US' );
+ $this->assertIsArray( $digit13_result );
+ $this->assertSame( 92, $digit13_result['ambiguity_score'] );
+
+ // Test 12-digit tracking.
+ $digit12_result = $this->provider->try_parse_tracking_number( '123456789012', 'AU', 'US' );
+ $this->assertIsArray( $digit12_result );
+ $this->assertSame( 92, $digit12_result['ambiguity_score'] );
+
+ // Test 11-digit tracking.
+ $digit11_result = $this->provider->try_parse_tracking_number( '12345678901', 'AU', 'US' );
+ $this->assertIsArray( $digit11_result );
+ $this->assertSame( 92, $digit11_result['ambiguity_score'] );
+
+ // Test standard format XX########XX.
+ $standard_result = $this->provider->try_parse_tracking_number( 'AB12345678CD', 'AU', 'US' );
+ $this->assertIsArray( $standard_result );
+ $this->assertSame( 92, $standard_result['ambiguity_score'] );
+
+ // Test domestic format X##########X.
+ $domestic_result = $this->provider->try_parse_tracking_number( 'A1234567890B', 'AU', 'US' );
+ $this->assertIsArray( $domestic_result );
+ $this->assertSame( 92, $domestic_result['ambiguity_score'] );
+
+ // Test Express Post format XXXX########.
+ $express_result = $this->provider->try_parse_tracking_number( 'ABCD12345678', 'AU', 'US' );
+ $this->assertIsArray( $express_result );
+ $this->assertSame( 92, $express_result['ambiguity_score'] );
+
+ // Test 16-digit format starting with 7.
+ $digit16_7_result = $this->provider->try_parse_tracking_number( '7123456789012345', 'AU', 'US' );
+ $this->assertIsArray( $digit16_7_result );
+ $this->assertSame( 92, $digit16_7_result['ambiguity_score'] );
+
+ // Test 16-digit format starting with 3.
+ $digit16_3_result = $this->provider->try_parse_tracking_number( '3123456789012345', 'AU', 'US' );
+ $this->assertIsArray( $digit16_3_result );
+ $this->assertSame( 92, $digit16_3_result['ambiguity_score'] );
+ }
+
+ /**
+ * Test non-Australia origin rejection.
+ */
+ public function test_non_australia_origin_rejection(): void {
+ $non_au_origins = array( 'US', 'NZ', 'GB', 'SG', 'CA', 'JP' );
+
+ foreach ( $non_au_origins as $origin ) {
+ $result = $this->provider->try_parse_tracking_number( 'AB123456789AU', $origin, 'AU' );
+ $this->assertNull( $result, "Should reject tracking number from non-Australia origin: {$origin}" );
+ }
+ }
+
+ /**
+ * Test APAC destination boost.
+ */
+ public function test_apac_destination_boost(): void {
+ $apac_destinations = array( 'NZ', 'SG', 'HK', 'JP', 'KR', 'TH', 'MY', 'ID', 'PH', 'VN', 'IN' );
+
+ foreach ( $apac_destinations as $destination ) {
+ $result = $this->provider->try_parse_tracking_number( 'AB123456789AU', 'AU', $destination );
+ $this->assertIsArray( $result );
+ $this->assertSame( 93, $result['ambiguity_score'], "APAC destination {$destination} should get confidence boost" );
+ }
+ }
+
+ /**
+ * Test common destination boost.
+ */
+ public function test_common_destination_boost(): void {
+ $common_destinations = array( 'US', 'GB', 'CA', 'DE', 'FR' );
+
+ foreach ( $common_destinations as $destination ) {
+ $result = $this->provider->try_parse_tracking_number( 'AB123456789AU', 'AU', $destination );
+ $this->assertIsArray( $result );
+ $this->assertSame( 92, $result['ambiguity_score'], "Common destination {$destination} should get confidence boost" );
+ }
+
+ // Test non-common, non-APAC destination doesn't get boost.
+ $result_other = $this->provider->try_parse_tracking_number( 'AB123456789AU', 'AU', 'BR' );
+ $this->assertIsArray( $result_other );
+ $this->assertSame( 90, $result_other['ambiguity_score'] );
+ }
+}
diff --git a/plugins/woocommerce/tests/php/src/Internal/Fulfillments/Providers/CanadaPostShippingProviderTest.php b/plugins/woocommerce/tests/php/src/Internal/Fulfillments/Providers/CanadaPostShippingProviderTest.php
new file mode 100644
index 0000000000..cea8f3025f
--- /dev/null
+++ b/plugins/woocommerce/tests/php/src/Internal/Fulfillments/Providers/CanadaPostShippingProviderTest.php
@@ -0,0 +1,303 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Tests\Internal\Fulfillments\Providers;
+
+use Automattic\WooCommerce\Internal\Fulfillments\Providers\CanadaPostShippingProvider;
+
+/**
+ * Unit tests for CanadaPostShippingProvider class.
+ *
+ * @package WooCommerce\Tests\Internal\Fulfillments\Providers
+ */
+class CanadaPostShippingProviderTest extends \WP_UnitTestCase {
+ /**
+ * Instance of CanadaPostShippingProvider used in tests.
+ *
+ * @var CanadaPostShippingProvider
+ */
+ private CanadaPostShippingProvider $provider;
+
+ /**
+ * Set up the test environment.
+ */
+ protected function setUp(): void {
+ parent::setUp();
+ $this->provider = new CanadaPostShippingProvider();
+ }
+
+ /**
+ * Test the get_key method.
+ */
+ public function test_get_key(): void {
+ $this->assertSame( 'canada-post', $this->provider->get_key() );
+ }
+
+ /**
+ * Test the get_name method.
+ */
+ public function test_get_name(): void {
+ $this->assertSame( 'Canada Post', $this->provider->get_name() );
+ }
+
+ /**
+ * Test the get_tracking_url method.
+ */
+ public function test_get_tracking_url(): void {
+ $tracking_number = 'AB123456789CA';
+ $expected_url = 'https://www.canadapost-postescanada.ca/track-reperage/en#/search?searchFor=' . $tracking_number;
+ $this->assertSame( $expected_url, $this->provider->get_tracking_url( $tracking_number ) );
+ }
+
+ /**
+ * Test get_shipping_from_countries returns expected countries.
+ */
+ public function test_get_shipping_from_countries(): void {
+ $countries = $this->provider->get_shipping_from_countries();
+
+ // Test that Canada is included.
+ $expected_countries = array( 'CA' );
+ foreach ( $expected_countries as $country ) {
+ $this->assertContains( $country, $countries, "Country {$country} should be in shipping from countries" );
+ }
+
+ // Test that we have the expected number of countries (only Canada).
+ $this->assertSame( 1, count( $countries ), 'Should have exactly 1 country (Canada)' );
+ }
+
+ /**
+ * Test get_shipping_to_countries includes international destinations.
+ */
+ public function test_get_shipping_to_countries(): void {
+ $to_countries = $this->provider->get_shipping_to_countries();
+
+ // Test that common destinations are included.
+ $expected_destinations = array( 'CA', 'US', 'GB', 'FR', 'DE', 'AU', 'JP' );
+ foreach ( $expected_destinations as $country ) {
+ $this->assertContains( $country, $to_countries, "Country {$country} should be in shipping to countries" );
+ }
+
+ // Test that we have many international destinations.
+ $this->assertGreaterThan( 190, count( $to_countries ), 'Should have many international destinations' );
+ }
+
+ /**
+ * Data provider for valid tracking number parsing tests.
+ *
+ * @return array[]
+ */
+ public function validTrackingNumberProvider(): array {
+ return array(
+ // Standard format: XX#########CA.
+ array( 'AB123456789CA', 'CA', 'US', 94 ), // International shipment (92+2 for US).
+ array( 'CD987654321CA', 'CA', 'CA', 95 ), // Domestic shipment with boost (92+3).
+ array( 'EF555666777CA', 'CA', 'GB', 92 ), // International shipment (base 92).
+
+ // 16-digit domestic tracking.
+ array( '1234567890123456', 'CA', 'CA', 95 ), // Domestic with boost (92+3).
+ array( '9876543210987654', 'CA', 'US', 94 ), // US destination (92+2).
+
+ // 12-digit domestic tracking.
+ array( '123456789012', 'CA', 'CA', 95 ), // Domestic with boost (92+3).
+ array( '987654321098', 'CA', 'AU', 96 ), // International (92+4 check digit bonus).
+
+ // International format: XX#######XX.
+ array( 'AB1234567CD', 'CA', 'FR', 92 ), // International (base 92).
+ array( 'EF9876543GH', 'CA', 'CA', 95 ), // Domestic with boost (92+3).
+
+ // Some domestic formats: X#########X.
+ array( 'A123456789B', 'CA', 'CA', 95 ), // Domestic with boost (92+3).
+ array( 'C987654321D', 'CA', 'DE', 92 ), // International (base 92).
+ );
+ }
+
+ /**
+ * Data provider for invalid tracking number parsing tests.
+ *
+ * @return array[]
+ */
+ public function invalidTrackingNumberProvider(): array {
+ return array(
+ // Wrong origin country (not Canada).
+ array( 'AB123456789CA', 'US', 'CA' ), // From US instead of CA.
+ array( '1234567890123456', 'GB', 'CA' ), // From GB instead of CA.
+ array( '123456789012', 'DE', 'US' ), // From DE instead of CA.
+
+ // Too short.
+ array( '12345', 'CA', 'US' ), // Too short.
+ array( 'AB123CA', 'CA', 'GB' ), // Too short for standard format.
+
+ // Too long.
+ array( '12345678901234567890', 'CA', 'US' ), // Too long.
+ array( 'AB123456789012345CA', 'CA', 'GB' ), // Too long for standard format.
+
+ // Invalid format.
+ array( '123456789AB', 'CA', 'US' ), // Mixed format invalid.
+ array( 'ABCDEFGHIJK', 'CA', 'GB' ), // All letters invalid length.
+
+ // Empty or whitespace only.
+ array( '', 'CA', 'US' ), // Empty string.
+ array( ' ', 'CA', 'GB' ), // Whitespace only.
+
+ // Invalid characters.
+ array( '12-34-56-78-90-12', 'CA', 'US' ), // Dashes (invalid format).
+ array( '123.456.789.012', 'CA', 'GB' ), // Dots (invalid format).
+ );
+ }
+
+ /**
+ * Test try_parse_tracking_number method with valid tracking numbers.
+ *
+ * @dataProvider validTrackingNumberProvider
+ *
+ * @param string $tracking_number The tracking number to test.
+ * @param string $from Origin country.
+ * @param string $to Destination country.
+ * @param int $expected_score Expected ambiguity score.
+ */
+ public function test_try_parse_tracking_number_valid( string $tracking_number, string $from, string $to, int $expected_score ): void {
+ $result = $this->provider->try_parse_tracking_number( $tracking_number, $from, $to );
+
+ $this->assertIsArray( $result, "Should return array for valid tracking number: {$tracking_number}" );
+ $this->assertArrayHasKey( 'url', $result );
+ $this->assertArrayHasKey( 'ambiguity_score', $result );
+
+ // Check score matches expected.
+ $this->assertSame(
+ $expected_score,
+ $result['ambiguity_score'],
+ "Score should be {$expected_score} for {$tracking_number} from {$from} to {$to}"
+ );
+
+ // Check score is within valid range.
+ $this->assertGreaterThanOrEqual( 92, $result['ambiguity_score'], 'Score should be at least 92' );
+ $this->assertLessThanOrEqual( 98, $result['ambiguity_score'], 'Score should not exceed 98' );
+
+ // Check URL format.
+ $normalized_tracking = strtoupper( preg_replace( '/\s+/', '', $tracking_number ) );
+ $expected_url = $this->provider->get_tracking_url( $normalized_tracking );
+ $this->assertSame( $expected_url, $result['url'] );
+ }
+
+ /**
+ * Test try_parse_tracking_number method with invalid tracking numbers.
+ *
+ * @dataProvider invalidTrackingNumberProvider
+ *
+ * @param string $tracking_number The tracking number to test.
+ * @param string $from Origin country.
+ * @param string $to Destination country.
+ */
+ public function test_try_parse_tracking_number_invalid( string $tracking_number, string $from, string $to ): void {
+ $result = $this->provider->try_parse_tracking_number( $tracking_number, $from, $to );
+ $this->assertNull( $result, "Should return null for invalid tracking number: '{$tracking_number}'" );
+ }
+
+ /**
+ * Test tracking number normalization (spaces, case sensitivity).
+ */
+ public function test_tracking_number_normalization(): void {
+ $test_cases = array(
+ // With spaces.
+ array( 'AB 123 456 789 CA', 'CA', 'US' ),
+ array( ' AB123456789CA ', 'CA', 'GB' ),
+ array( '1234 5678 9012 3456', 'CA', 'AU' ),
+
+ // Mixed case.
+ array( 'ab123456789ca', 'CA', 'US' ),
+ array( 'Ab123456789Ca', 'CA', 'GB' ),
+ array( 'AB123456789CA', 'CA', 'FR' ),
+ );
+
+ foreach ( $test_cases as $test_case ) {
+ list( $tracking_number, $from, $to ) = $test_case;
+ $result = $this->provider->try_parse_tracking_number( $tracking_number, $from, $to );
+
+ $this->assertIsArray( $result, "Should parse tracking number with normalization: {$tracking_number}" );
+ $this->assertArrayHasKey( 'url', $result );
+
+ // URL should contain normalized version (no spaces, uppercase).
+ $normalized = strtoupper( preg_replace( '/\s+/', '', $tracking_number ) );
+ $this->assertStringContainsString( $normalized, $result['url'] );
+ }
+ }
+
+ /**
+ * Test empty parameter handling.
+ */
+ public function test_empty_parameters(): void {
+ // Empty tracking number.
+ $result = $this->provider->try_parse_tracking_number( '', 'CA', 'US' );
+ $this->assertNull( $result );
+
+ // Empty origin country.
+ $result = $this->provider->try_parse_tracking_number( 'AB123456789CA', '', 'US' );
+ $this->assertNull( $result );
+
+ // Empty destination country.
+ $result = $this->provider->try_parse_tracking_number( 'AB123456789CA', 'CA', '' );
+ $this->assertNull( $result );
+
+ // All empty.
+ $result = $this->provider->try_parse_tracking_number( '', '', '' );
+ $this->assertNull( $result );
+ }
+
+ /**
+ * Test domestic vs international scoring.
+ */
+ public function test_domestic_vs_international_scoring(): void {
+ // Domestic shipment should get confidence boost.
+ $result_domestic = $this->provider->try_parse_tracking_number( 'AB123456789CA', 'CA', 'CA' );
+ $result_international = $this->provider->try_parse_tracking_number( 'AB123456789CA', 'CA', 'US' );
+
+ $this->assertIsArray( $result_domestic );
+ $this->assertIsArray( $result_international );
+
+ // Domestic should have higher score (95 vs 94).
+ $this->assertSame( 95, $result_domestic['ambiguity_score'] );
+ $this->assertSame( 94, $result_international['ambiguity_score'] ); // US gets +2 boost.
+ $this->assertGreaterThan( $result_international['ambiguity_score'], $result_domestic['ambiguity_score'] );
+ }
+
+ /**
+ * Test specific pattern formats.
+ */
+ public function test_pattern_formats(): void {
+ // Test standard format XX#########CA.
+ $standard_result = $this->provider->try_parse_tracking_number( 'AB123456789CA', 'CA', 'US' );
+ $this->assertIsArray( $standard_result );
+ $this->assertSame( 94, $standard_result['ambiguity_score'] ); // US destination gets +2.
+
+ // Test 16-digit format.
+ $digit16_result = $this->provider->try_parse_tracking_number( '1234567890123456', 'CA', 'FR' );
+ $this->assertIsArray( $digit16_result );
+ $this->assertSame( 92, $digit16_result['ambiguity_score'] ); // International base.
+
+ // Test 12-digit format.
+ $digit12_result = $this->provider->try_parse_tracking_number( '123456789012', 'CA', 'MX' );
+ $this->assertIsArray( $digit12_result );
+ $this->assertSame( 94, $digit12_result['ambiguity_score'] ); // MX destination gets +2.
+
+ // Test international format XX#######XX.
+ $intl_result = $this->provider->try_parse_tracking_number( 'AB1234567CD', 'CA', 'GB' );
+ $this->assertIsArray( $intl_result );
+ $this->assertSame( 92, $intl_result['ambiguity_score'] ); // International base.
+
+ // Test domestic format X########X.
+ $domestic_result = $this->provider->try_parse_tracking_number( 'A123456789B', 'CA', 'AU' );
+ $this->assertIsArray( $domestic_result );
+ $this->assertSame( 92, $domestic_result['ambiguity_score'] ); // International base.
+ }
+
+ /**
+ * Test non-Canada origin rejection.
+ */
+ public function test_non_canada_origin_rejection(): void {
+ $non_canada_origins = array( 'US', 'GB', 'FR', 'DE', 'AU', 'JP' );
+
+ foreach ( $non_canada_origins as $origin ) {
+ $result = $this->provider->try_parse_tracking_number( 'AB123456789CA', $origin, 'CA' );
+ $this->assertNull( $result, "Should reject tracking number from non-Canada origin: {$origin}" );
+ }
+ }
+}
diff --git a/plugins/woocommerce/tests/php/src/Internal/Fulfillments/Providers/DHLShippingProviderTest.php b/plugins/woocommerce/tests/php/src/Internal/Fulfillments/Providers/DHLShippingProviderTest.php
new file mode 100644
index 0000000000..9d425b1129
--- /dev/null
+++ b/plugins/woocommerce/tests/php/src/Internal/Fulfillments/Providers/DHLShippingProviderTest.php
@@ -0,0 +1,186 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Tests\Internal\Fulfillments\Providers;
+
+use Automattic\WooCommerce\Internal\Fulfillments\Providers\DHLShippingProvider;
+
+/**
+ * Unit tests for DHLShippingProvider class.
+ */
+class DHLShippingProviderTest extends \WP_UnitTestCase {
+ /**
+ * The provider instance being tested.
+ *
+ * @var DHLShippingProvider
+ */
+ private DHLShippingProvider $provider;
+
+ /**
+ * Sets up the test fixture.
+ */
+ protected function setUp(): void {
+ parent::setUp();
+ $this->provider = new DHLShippingProvider();
+ }
+
+ /**
+ * Tests the tracking URL generation for different service types.
+ */
+ public function test_get_tracking_url(): void {
+ // Test Express tracking URL.
+ $this->assertEquals(
+ 'https://www.dhl.com/en/express/tracking.html?AWB=1234567890',
+ $this->provider->get_tracking_url( '1234567890' )
+ );
+
+ // Test eCommerce tracking URL.
+ $this->assertEquals(
+ 'https://webtrack.dhlglobalmail.com/?trackingnumber=GM1234567890123456',
+ $this->provider->get_tracking_url( 'GM1234567890123456' )
+ );
+
+ // Test case insensitivity.
+ $this->assertEquals(
+ 'https://webtrack.dhlglobalmail.com/?trackingnumber=LX123456789DE',
+ $this->provider->get_tracking_url( 'lx123456789de' )
+ );
+ }
+
+ /**
+ * Data provider for tracking number validation tests.
+ *
+ * @return array<array{string, string, string, bool, int|null}> Test cases.
+ */
+ public function trackingNumberProvider(): array {
+ return array(
+ // DHL Express formats.
+ array( 'JJD1234567890', 'DE', 'US', true, 98 ), // JJD format.
+ array( 'JVGL1234567890', 'NL', 'DE', true, 98 ), // JVGL format.
+
+ // DHL Air Waybill without valid mod11 check digit (90).
+ array( '12345678903', 'US', 'GB', true, 90 ), // 11-digit AWB without valid check digit.
+
+ // DHL Air Waybill with invalid check digit (90).
+ array( '12345678901', 'US', 'GB', true, 90 ), // 11-digit AWB with invalid check digit.
+
+ // DHL 10-digit (gets 98 or 90 based on mod11 check digit).
+ array( '1234567890', 'DE', 'FR', true, 98 ), // 10-digit with mod11 validation.
+ array( '1234567895', 'DE', 'FR', true, 90 ), // 10-digit without valid mod11.
+
+ // Valid country combinations supported by DHL.
+ array( '1234567896', 'BG', 'RO', true, 90 ), // 10-digit without valid mod11.
+ array( '1234567890', 'BG', 'RO', true, 98 ), // 10-digit with mod11 validation.
+
+ // DHL eCommerce North America.
+ array( 'GM1234567890123456', 'US', 'CA', true, 95 ), // US/CA optimized.
+ array( 'GM1234567890123456', 'DE', 'FR', true, 80 ), // International.
+
+ // DHL eCommerce Asia-Pacific (92 score for pattern match).
+ array( 'LX123456789DE', 'US', 'DE', true, 92 ), // LX pattern.
+ array( 'RX123456789GB', 'DE', 'GB', true, 92 ), // RX pattern.
+ array( 'AU123456789AU', 'AU', 'US', true, 92 ), // AU pattern.
+ array( 'AU123456789AU', 'DE', 'US', true, 92 ), // AU pattern from DE.
+ array( 'TH123456789TH', 'AU', 'US', true, 92 ), // TH pattern from AU.
+ array( 'TH123456789TH', 'DE', 'US', true, 92 ), // TH pattern from DE.
+
+ // DHL eCommerce Europe (14-digit gets 60 score for non-DE domestic).
+ array( '12345678901234', 'GB', 'US', true, 60 ), // 14-digit non-DE.
+
+ // DHL Parcel Europe (3S pattern gets 95 score).
+ array( '3SAB12345678', 'DE', 'NL', true, 95 ), // 3S pattern.
+ array( '3SCD98765432', 'FR', 'BE', true, 95 ), // 3S pattern.
+ array( '3SXY12345678', 'US', 'CA', true, 95 ), // 3S pattern from US.
+
+ // DHL Same Day.
+ array( 'DSD123456789012', 'DE', 'US', true, 92 ),
+
+ // DHL Piece Numbers.
+ array( 'JD12345678901', 'DE', 'US', true, 90 ),
+
+ // DHL Supply Chain.
+ array( 'DSC1234567890123', 'DE', 'US', true, 85 ),
+
+ // DHL Legacy formats (matches S10 pattern, gets 75 score).
+ array( 'LZ123456787DE', 'DE', 'US', true, 75 ), // Matches S10 pattern.
+ array( 'LZ123456789DE', 'DE', 'US', true, 75 ), // Matches S10 pattern.
+
+ // DHL Global Forwarding.
+ array( '1AB1234', 'DE', 'US', true, 90 ),
+ array( 'ABC12345', 'US', 'GB', true, 88 ),
+
+ // Invalid formats.
+ array( 'INVALID123', 'DE', 'US', false, null ),
+ array( '12345', 'US', 'GB', false, null ),
+ array( 'JJD123', 'DE', 'FR', false, null ), // Too short.
+ array( 'GM123', 'US', 'CA', false, null ), // Too short.
+ );
+ }
+
+ /**
+ * Tests tracking number parsing with various scenarios.
+ *
+ * @dataProvider trackingNumberProvider
+ * @param string $tracking_number The tracking number to test.
+ * @param string $from Origin country code.
+ * @param string $to Destination country code.
+ * @param bool $expected_valid Whether the number should be valid.
+ * @param int|null $expected_score Expected ambiguity score.
+ */
+ public function test_try_parse_tracking_number(
+ string $tracking_number,
+ string $from,
+ string $to,
+ bool $expected_valid,
+ ?int $expected_score
+ ): void {
+ $result = $this->provider->try_parse_tracking_number( $tracking_number, $from, $to );
+
+ if ( $expected_valid ) {
+ $this->assertNotNull( $result );
+ $this->assertEquals( $expected_score, $result['ambiguity_score'] );
+
+ // Verify URL matches expected service type.
+ if ( preg_match( '/^(GM|LX|RX|CN|SG|MY|HK|AU|TH|420)/', $tracking_number ) ) {
+ $this->assertStringContainsString( 'dhlglobalmail.com', $result['url'] );
+ } elseif ( preg_match( '/^3S/', $tracking_number ) ) {
+ $this->assertStringContainsString( 'dhl.de', $result['url'] );
+ } else {
+ $this->assertStringContainsString( 'dhl.com/en/express', $result['url'] );
+ }
+ } else {
+ $this->assertNull( $result );
+ }
+ }
+
+ /**
+ * Tests regional scoring differences for eCommerce formats.
+ */
+ public function test_regional_scoring_differences(): void {
+ // GM format scores higher from US/CA.
+ $us_result = $this->provider->try_parse_tracking_number( 'GM1234567890123456', 'US', 'DE' );
+ $de_result = $this->provider->try_parse_tracking_number( 'GM1234567890123456', 'DE', 'US' );
+
+ $this->assertEquals( 95, $us_result['ambiguity_score'] );
+ $this->assertEquals( 80, $de_result['ambiguity_score'] );
+
+ // 3S format gives same score regardless of origin
+ $de_result = $this->provider->try_parse_tracking_number( '3SAB12345678', 'DE', 'US' );
+ $us_result = $this->provider->try_parse_tracking_number( '3SAB12345678', 'US', 'DE' );
+
+ $this->assertEquals( 95, $de_result['ambiguity_score'] );
+ $this->assertEquals( 95, $us_result['ambiguity_score'] );
+ }
+
+ /**
+ * Tests case insensitivity in tracking number parsing.
+ */
+ public function test_case_insensitivity(): void {
+ $lowercase = $this->provider->try_parse_tracking_number( 'jjd1234567890', 'DE', 'US' );
+ $mixedcase = $this->provider->try_parse_tracking_number( 'JvGl1234567890', 'NL', 'DE' );
+ $uppercase = $this->provider->try_parse_tracking_number( 'JJD1234567890', 'DE', 'FR' );
+
+ $this->assertEquals( 98, $lowercase['ambiguity_score'] );
+ $this->assertEquals( 98, $mixedcase['ambiguity_score'] );
+ $this->assertEquals( 98, $uppercase['ambiguity_score'] );
+ }
+}
diff --git a/plugins/woocommerce/tests/php/src/Internal/Fulfillments/Providers/DPDShippingProviderTest.php b/plugins/woocommerce/tests/php/src/Internal/Fulfillments/Providers/DPDShippingProviderTest.php
new file mode 100644
index 0000000000..641fe83432
--- /dev/null
+++ b/plugins/woocommerce/tests/php/src/Internal/Fulfillments/Providers/DPDShippingProviderTest.php
@@ -0,0 +1,401 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Tests\Internal\Fulfillments\Providers;
+
+use Automattic\WooCommerce\Internal\Fulfillments\Providers\DPDShippingProvider;
+
+/**
+ * Unit tests for DPDShippingProvider class.
+ *
+ * @package WooCommerce\Tests\Internal\Fulfillments\Providers
+ */
+class DPDShippingProviderTest extends \WP_UnitTestCase {
+ /**
+ * Instance of DPDShippingProvider used in tests.
+ *
+ * @var DPDShippingProvider
+ */
+ private DPDShippingProvider $provider;
+
+ /**
+ * Set up the test environment.
+ */
+ protected function setUp(): void {
+ parent::setUp();
+ $this->provider = new DPDShippingProvider();
+ }
+
+ /**
+ * Test the get_key method.
+ */
+ public function test_get_key(): void {
+ $this->assertSame( 'dpd', $this->provider->get_key() );
+ }
+
+ /**
+ * Test the get_name method.
+ */
+ public function test_get_name(): void {
+ $this->assertSame( 'DPD', $this->provider->get_name() );
+ }
+
+ /**
+ * Test the get_tracking_url method.
+ */
+ public function test_get_tracking_url(): void {
+ $tracking_number = '12345678901234';
+ $expected_url = 'https://www.dpd.com/tracking/' . $tracking_number;
+ $this->assertSame( $expected_url, $this->provider->get_tracking_url( $tracking_number ) );
+ }
+
+ /**
+ * Test get_shipping_from_countries returns expected countries.
+ */
+ public function test_get_shipping_from_countries(): void {
+ $countries = $this->provider->get_shipping_from_countries();
+
+ // Test that core DPD countries are included.
+ $expected_core_countries = array( 'DE', 'GB', 'FR', 'NL', 'BE', 'PL', 'IE', 'LT', 'LV', 'EE', 'FI', 'DK', 'SE', 'NO', 'GR', 'PT' );
+ foreach ( $expected_core_countries as $country ) {
+ $this->assertContains( $country, $countries, "Country {$country} should be in shipping from countries" );
+ }
+
+ // Test that we have the expected number of countries.
+ $this->assertGreaterThanOrEqual( 28, count( $countries ), 'Should have at least 28 countries' );
+ }
+
+ /**
+ * Test get_shipping_to_countries matches from countries.
+ */
+ public function test_get_shipping_to_countries(): void {
+ $from_countries = $this->provider->get_shipping_from_countries();
+ $to_countries = $this->provider->get_shipping_to_countries();
+
+ $this->assertSame( $from_countries, $to_countries );
+ }
+
+ /**
+ * Data provider for valid tracking number parsing tests.
+ *
+ * @return array[]
+ */
+ public function validTrackingNumberProvider(): array {
+ return array(
+ // German tracking numbers (base confidence 80).
+ array( '12345678901234', 'DE', 'FR', 83 ), // 14 digits DE->FR, base 80 + intra-DPD boost 3.
+ array( '123456789012', 'DE', 'NL', 83 ), // 12 digits DE->NL, base 80 + intra-DPD boost 3.
+ array( '02123456789012', 'DE', 'US', 80 ), // Classic service, base confidence 80.
+
+ // UK tracking numbers (base confidence 90).
+ array( '12345678901234', 'GB', 'DE', 93 ), // 14 digits GB->DE, base 90 + intra-DPD boost 3.
+ array( 'AB123456789GB', 'GB', 'FR', 90 ), // S10 service, confidence 90.
+ array( '03123456789012', 'GB', 'US', 90 ), // Next day service (88) + express boost (2) = 90.
+
+ // French tracking numbers (base confidence 78).
+ array( '12345678901234', 'FR', 'DE', 81 ), // 14 digits FR->DE, base 78 + intra-DPD boost 3.
+ array( '123456789012', 'FR', 'GB', 81 ), // 12 digits FR->GB, base 78 + intra-DPD boost 3.
+ array( '02123456789012', 'FR', 'US', 78 ), // Base confidence 78 (relais pattern doesn't match).
+
+ // Netherlands tracking numbers (base confidence 78).
+ array( '12345678901234', 'NL', 'DE', 81 ), // 14 digits NL->DE, base 78 + intra-DPD boost 3.
+ array( '123456789012', 'NL', 'BE', 81 ), // 12 digits NL->BE, base 78 + intra-DPD boost 3.
+ array( '03123456789012', 'NL', 'US', 87 ), // Classic service (82) + express boost (2) + express boost (2) + intra-DPD boost (1) = 87.
+
+ // Belgian tracking numbers (base confidence 78).
+ array( '12345678901234', 'BE', 'NL', 81 ), // 14 digits BE->NL, base 78 + intra-DPD boost 3.
+ array( '123456789012', 'BE', 'FR', 81 ), // 12 digits BE->FR, base 78 + intra-DPD boost 3.
+ array( '03123456789012', 'BE', 'US', 87 ), // Classic service (82) + express boost (2) + express boost (2) + intra-DPD boost (1) = 87.
+
+ // Polish tracking numbers (base confidence 90).
+ array( '12345678901234', 'PL', 'DE', 93 ), // 14 digits PL->DE, base 90 + intra-DPD boost 3.
+ array( 'PL1234567890', 'PL', 'DE', 93 ), // Country code format PL->DE, base 90 + intra-DPD boost 3.
+
+ // International 28-digit format (base confidence 95).
+ array( '1234567890123456789012345678', 'DE', 'FR', 95 ),
+ array( '1234567890123456789012345678', 'GB', 'NL', 95 ),
+
+ // S10/UPU format (confidence 90).
+ array( 'AB123456789DE', 'DE', 'FR', 90 ),
+ array( 'CD987654321GB', 'GB', 'NL', 90 ),
+
+ // Service-specific patterns with confidence boosts.
+ array( '05123456789012', 'DE', 'US', 87 ), // Express service (85) + express boost (2) = 87.
+ array( '09123456789012', 'DE', 'US', 85 ), // Predict service, confidence 85.
+ array( '06123456789012', 'GB', 'US', 90 ), // Express service, base confidence 90.
+ array( '15123456789012', 'GB', 'US', 90 ), // Predict/Return service, base confidence 90.
+
+ // Fallback patterns (12-24 digits get 60 confidence).
+ array( '123456789012', 'US', 'DE', 60 ), // 12 digits fallback.
+ array( '123456789012345', 'US', 'GB', 60 ), // 15 digits fallback.
+ array( '123456789012345678', 'US', 'FR', 60 ), // 18 digits fallback.
+ );
+ }
+
+ /**
+ * Data provider for invalid tracking number parsing tests.
+ *
+ * @return array[]
+ */
+ public function invalidTrackingNumberProvider(): array {
+ return array(
+ // Too short for any pattern.
+ array( '123456789', 'DE', 'FR' ), // 9 digits (too short).
+ array( '12345', 'GB', 'DE' ), // 5 digits (too short).
+
+ // Invalid lengths (not matching any pattern).
+ array( '12345678901234567890123456', 'DE', 'FR' ), // 26 digits (not 28).
+ array( '12345678901234567890123456789', 'GB', 'DE' ), // 29 digits (too long).
+
+ // Invalid S10/UPU format.
+ array( 'ABC123456789DE', 'DE', 'FR' ), // Too many letters at start.
+ array( 'AB12345678DEF', 'FR', 'DE' ), // Too many letters at end.
+
+ // Empty or whitespace only.
+ array( '', 'DE', 'FR' ), // Empty string.
+ array( ' ', 'GB', 'DE' ), // Whitespace only.
+
+ // Invalid format combinations.
+ array( 'ABC123', 'DE', 'FR' ), // Mixed format too short.
+ array( '12-34-56-78-90-12', 'GB', 'DE' ), // Dashes (invalid format).
+
+ // Numbers below 12 digits (too short for fallback).
+ array( '12345678901', 'DE', 'FR' ), // 11 digits (too short).
+ array( '1234567890', 'GB', 'DE' ), // 10 digits (too short).
+ );
+ }
+
+ /**
+ * Data provider for extended format tracking numbers.
+ *
+ * @return array[]
+ */
+ public function extendedTrackingNumberProvider(): array {
+ return array(
+ // International 28-digit format (confidence 95).
+ array( '1234567890123456789012345678', 'GB', 'DE', 95 ),
+ array( '9876543210987654321098765432', 'DE', 'FR', 95 ),
+ );
+ }
+
+ /**
+ * Data provider for ambiguous tracking numbers (multiple country matches).
+ *
+ * @return array[]
+ */
+ public function ambiguousTrackingNumberProvider(): array {
+ return array(
+ // Numbers that could match fallback pattern from non-DPD countries.
+ array( '12345678901234', 'US', 'DE' ), // US not in DPD countries, gets fallback 60.
+ array( '123456789012', 'CA', 'FR' ), // CA not in DPD countries, gets fallback 60.
+
+ // Valid format but from unsupported origin.
+ array( '12345678901234', 'JP', 'GB' ), // JP not in DPD countries, gets fallback 60.
+ );
+ }
+
+ /**
+ * Test try_parse_tracking_number method with valid tracking numbers.
+ *
+ * @dataProvider validTrackingNumberProvider
+ *
+ * @param string $tracking_number The tracking number to test.
+ * @param string $from Origin country.
+ * @param string $to Destination country.
+ * @param int $expected_score Expected ambiguity score.
+ */
+ public function test_try_parse_tracking_number_valid( string $tracking_number, string $from, string $to, int $expected_score ): void {
+ $result = $this->provider->try_parse_tracking_number( $tracking_number, $from, $to );
+
+ $this->assertIsArray( $result, "Should return array for valid tracking number: {$tracking_number}" );
+ $this->assertArrayHasKey( 'url', $result );
+ $this->assertArrayHasKey( 'ambiguity_score', $result );
+
+ // Check score matches expected.
+ $this->assertSame(
+ $expected_score,
+ $result['ambiguity_score'],
+ "Score should be {$expected_score} for {$tracking_number} from {$from} to {$to}"
+ );
+
+ // Check score is within valid range.
+ $this->assertGreaterThanOrEqual( 60, $result['ambiguity_score'], 'Score should be at least 60' );
+ $this->assertLessThanOrEqual( 98, $result['ambiguity_score'], 'Score should not exceed 98' );
+
+ // Check URL format.
+ $normalized_tracking = strtoupper( preg_replace( '/\s+/', '', $tracking_number ) );
+ $expected_url = $this->provider->get_tracking_url( $normalized_tracking );
+ $this->assertSame( $expected_url, $result['url'] );
+ }
+
+ /**
+ * Test try_parse_tracking_number method with invalid tracking numbers.
+ *
+ * @dataProvider invalidTrackingNumberProvider
+ *
+ * @param string $tracking_number The tracking number to test.
+ * @param string $from Origin country.
+ * @param string $to Destination country.
+ */
+ public function test_try_parse_tracking_number_invalid( string $tracking_number, string $from, string $to ): void {
+ $result = $this->provider->try_parse_tracking_number( $tracking_number, $from, $to );
+ $this->assertNull( $result, "Should return null for invalid tracking number: '{$tracking_number}'" );
+ }
+
+ /**
+ * Test try_parse_tracking_number method with extended format tracking numbers.
+ *
+ * @dataProvider extendedTrackingNumberProvider
+ *
+ * @param string $tracking_number The tracking number to test.
+ * @param string $from Origin country.
+ * @param string $to Destination country.
+ * @param int $expected_score Expected ambiguity score.
+ */
+ public function test_try_parse_tracking_number_extended( string $tracking_number, string $from, string $to, int $expected_score ): void {
+ $result = $this->provider->try_parse_tracking_number( $tracking_number, $from, $to );
+
+ $this->assertIsArray( $result, "Should return array for extended tracking number: {$tracking_number}" );
+ $this->assertArrayHasKey( 'url', $result );
+ $this->assertArrayHasKey( 'ambiguity_score', $result );
+ $this->assertSame( $expected_score, $result['ambiguity_score'] );
+ }
+
+ /**
+ * Test try_parse_tracking_number method with ambiguous cases.
+ *
+ * @dataProvider ambiguousTrackingNumberProvider
+ *
+ * @param string $tracking_number The tracking number to test.
+ * @param string $from Origin country.
+ * @param string $to Destination country.
+ */
+ public function test_try_parse_tracking_number_ambiguous( string $tracking_number, string $from, string $to ): void {
+ $result = $this->provider->try_parse_tracking_number( $tracking_number, $from, $to );
+
+ $this->assertIsArray( $result, "Should return array for fallback pattern: {$tracking_number}" );
+ $this->assertArrayHasKey( 'ambiguity_score', $result );
+ // Should get fallback confidence of 60.
+ $this->assertSame( 60, $result['ambiguity_score'], 'Should get fallback confidence of 60' );
+ }
+
+ /**
+ * Test tracking number normalization (spaces, case sensitivity).
+ */
+ public function test_tracking_number_normalization(): void {
+ $test_cases = array(
+ // With spaces.
+ array( '1234 5678 9012 34', 'DE', 'FR' ),
+ array( ' 1234 5678 9012 34 ', 'DE', 'FR' ),
+
+ // Mixed case (for alphanumeric formats).
+ array( 'abcdefghijkl', 'GB', 'DE' ),
+ array( 'Abcdefghijkl', 'GB', 'DE' ),
+ array( 'ABCDEFGHIJKL', 'GB', 'DE' ),
+ );
+
+ foreach ( $test_cases as $test_case ) {
+ list( $tracking_number, $from, $to ) = $test_case;
+ $result = $this->provider->try_parse_tracking_number( $tracking_number, $from, $to );
+
+ if ( null !== $result ) {
+ $this->assertIsArray( $result );
+ $this->assertArrayHasKey( 'url', $result );
+
+ // URL should contain normalized version (no spaces, uppercase).
+ $normalized = strtoupper( preg_replace( '/\s+/', '', $tracking_number ) );
+ $this->assertStringContainsString( $normalized, $result['url'] );
+ }
+ }
+ }
+
+ /**
+ * Test empty parameter handling.
+ */
+ public function test_empty_parameters(): void {
+ // Empty tracking number.
+ $result = $this->provider->try_parse_tracking_number( '', 'DE', 'FR' );
+ $this->assertNull( $result );
+
+ // Empty origin country.
+ $result = $this->provider->try_parse_tracking_number( '12345678901234', '', 'FR' );
+ $this->assertNull( $result );
+
+ // Empty destination country.
+ $result = $this->provider->try_parse_tracking_number( '12345678901234', 'DE', '' );
+ $this->assertNull( $result );
+
+ // All empty.
+ $result = $this->provider->try_parse_tracking_number( '', '', '' );
+ $this->assertNull( $result );
+ }
+
+ /**
+ * Test confidence scoring consistency.
+ */
+ public function test_confidence_scoring_consistency(): void {
+ // Same tracking number from higher-confidence country should have higher score.
+ $result_high = $this->provider->try_parse_tracking_number( '12345678901234', 'GB', 'US' );
+ $result_medium = $this->provider->try_parse_tracking_number( '12345678901234', 'US', 'GB' );
+
+ $this->assertIsArray( $result_high );
+ $this->assertIsArray( $result_medium );
+
+ // GB has base confidence 90, US gets fallback 60.
+ $this->assertSame( 90, $result_high['ambiguity_score'] );
+ $this->assertSame( 60, $result_medium['ambiguity_score'] );
+ $this->assertGreaterThan(
+ $result_medium['ambiguity_score'],
+ $result_high['ambiguity_score'],
+ 'Higher-confidence country should have higher score than lower-confidence country'
+ );
+ }
+
+ /**
+ * Test destination boost scoring.
+ */
+ public function test_destination_boost_scoring(): void {
+ // Cross-border DPD shipping should get confidence boost.
+ $result_boost = $this->provider->try_parse_tracking_number( '12345678901234', 'DE', 'FR' );
+ $result_no_boost = $this->provider->try_parse_tracking_number( '12345678901234', 'DE', 'US' );
+
+ $this->assertIsArray( $result_boost );
+ $this->assertIsArray( $result_no_boost );
+ $this->assertSame( 80, $result_no_boost['ambiguity_score'] ); // DE base confidence.
+ $this->assertGreaterThan( $result_no_boost['ambiguity_score'], $result_boost['ambiguity_score'] );
+
+ // Intra-DPD boost should give score of 83 for DE origin (80+3).
+ $this->assertSame( 83, $result_boost['ambiguity_score'] );
+ }
+
+ /**
+ * Test extended pattern validation.
+ */
+ public function test_extended_pattern_validation(): void {
+ // Extended patterns should get high confidence regardless of origin/destination.
+ $digits_result = $this->provider->try_parse_tracking_number( '1234567890123456789012345678', 'GB', 'DE' );
+
+ $this->assertIsArray( $digits_result );
+
+ // Should have score of 95.
+ $this->assertSame( 95, $digits_result['ambiguity_score'] );
+ }
+
+ /**
+ * Test specific pattern formats for different countries.
+ */
+ public function test_country_specific_patterns(): void {
+ // Test UK-specific patterns.
+ $uk_digits = $this->provider->try_parse_tracking_number( '12345678901234', 'GB', 'DE' );
+ $uk_prefix = $this->provider->try_parse_tracking_number( 'AB123456789GB', 'GB', 'FR' );
+
+ $this->assertIsArray( $uk_digits );
+ $this->assertIsArray( $uk_prefix );
+ $this->assertSame( 93, $uk_digits['ambiguity_score'] ); // 90+3=93 (intra-DPD boost)
+ $this->assertSame( 90, $uk_prefix['ambiguity_score'] ); // S10 service, confidence 90.
+
+ // Test German patterns.
+ $de_14_digits = $this->provider->try_parse_tracking_number( '12345678901234', 'DE', 'FR' );
+ $this->assertIsArray( $de_14_digits );
+ $this->assertSame( 83, $de_14_digits['ambiguity_score'] ); // DE with FR destination gets boost (80+3).
+ }
+}
diff --git a/plugins/woocommerce/tests/php/src/Internal/Fulfillments/Providers/EvriHermesShippingProviderTest.php b/plugins/woocommerce/tests/php/src/Internal/Fulfillments/Providers/EvriHermesShippingProviderTest.php
new file mode 100644
index 0000000000..60fc5b85c1
--- /dev/null
+++ b/plugins/woocommerce/tests/php/src/Internal/Fulfillments/Providers/EvriHermesShippingProviderTest.php
@@ -0,0 +1,249 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Tests\Internal\Fulfillments\Providers;
+
+use Automattic\WooCommerce\Internal\Fulfillments\Providers\EvriHermesShippingProvider;
+
+/**
+ * Unit tests for EvriHermesShippingProvider class.
+ */
+class EvriHermesShippingProviderTest extends \WP_UnitTestCase {
+ /**
+ * The provider instance being tested.
+ *
+ * @var EvriHermesShippingProvider
+ */
+ private EvriHermesShippingProvider $provider;
+
+ /**
+ * Sets up the test fixture.
+ */
+ protected function setUp(): void {
+ parent::setUp();
+ $this->provider = new EvriHermesShippingProvider();
+ }
+
+ /**
+ * Tests the tracking URL generation.
+ */
+ public function test_get_tracking_url(): void {
+ $this->assertEquals(
+ 'https://www.evri.com/track/1234567890123456',
+ $this->provider->get_tracking_url( '1234567890123456' )
+ );
+
+ // Test URL encoding.
+ $this->assertEquals(
+ 'https://www.evri.com/track/H123%2F456',
+ $this->provider->get_tracking_url( 'H123/456' )
+ );
+ }
+
+ /**
+ * Data provider for tracking number validation tests.
+ *
+ * @return array<array{string, string, string, bool, int|null}> Test cases.
+ */
+ public function trackingNumberProvider(): array {
+ return array(
+ // 16-digit numeric patterns (base confidence 90).
+ array( '1234567890123456', 'GB', 'IE', true, 92 ), // GB origin gets +2 boost.
+ array( '9876543210987654', 'GB', 'FR', true, 92 ), // GB origin gets +2 boost.
+ array( '1234567890123456', 'GB', 'DE', true, 92 ), // GB origin gets +2 boost.
+ array( '9876543210987654', 'GB', 'US', true, 92 ), // GB origin gets +2 boost.
+
+ // Legacy patterns with prefixes (1-2 letters + 14-15 digits, base confidence 90).
+ array( 'H12345678901234', 'GB', 'FR', true, 92 ), // H + 14 digits, GB origin.
+ array( 'E123456789012345', 'GB', 'DE', true, 92 ), // E + 15 digits, GB origin.
+ array( 'HM12345678901234', 'GB', 'US', true, 92 ), // HM + 14 digits, GB origin.
+ array( 'EV123456789012345', 'GB', 'CA', true, 92 ), // EV + 15 digits, GB origin.
+ array( 'HH12345678901234', 'GB', 'IE', true, 92 ), // HH + 14 digits, GB origin.
+ array( 'H12345678901234', 'GB', 'IT', true, 92 ), // H + 14 digits, GB origin.
+ array( 'E123456789012345', 'GB', 'ES', true, 92 ), // E + 15 digits, GB origin.
+
+ // MH + 16 digits pattern (base confidence 90).
+ array( 'MH1234567890123456', 'GB', 'DE', true, 92 ), // GB origin gets +2 boost.
+ array( 'MH9876543210987654', 'GB', 'FR', true, 92 ), // GB origin gets +2 boost.
+
+ // 8-digit calling card pattern (confidence 80).
+ array( '12345678', 'GB', 'IE', true, 80 ),
+ array( '87654321', 'GB', 'FR', true, 80 ),
+ array( '11223344', 'GB', 'DE', true, 80 ),
+
+ // Legacy 13-15 digit patterns (confidence 75 + 15 boost for GB = 90).
+ array( '1234567890123', 'GB', 'FR', true, 90 ), // 13 digits, GB origin.
+ array( '12345678901234', 'GB', 'DE', true, 90 ), // 14 digits, GB origin.
+ array( '123456789012345', 'GB', 'IE', true, 90 ), // 15 digits, GB origin.
+ array( '1234567890123', 'GB', 'ES', true, 90 ), // 13 digits, GB origin.
+ array( '12345678901234', 'GB', 'IT', true, 90 ), // 14 digits, GB origin.
+
+ // Invalid formats.
+ array( '123456789012', 'GB', 'FR', false, null ), // 12 digits (too short).
+ array( '12345678901234567', 'GB', 'DE', false, null ), // 17 digits (too long).
+ array( 'INVALID123', 'GB', 'FR', false, null ), // Invalid format.
+ array( '1234567', 'GB', 'IE', false, null ), // 7 digits (too short for calling card).
+ array( '123456789', 'GB', 'FR', false, null ), // 9 digits (too short for calling card).
+
+ // Invalid with unsupported countries (Evri only ships from GB).
+ array( '1234567890123456', 'US', 'CA', false, null ), // US/CA not supported.
+ array( 'H12345678901234', 'JP', 'AU', false, null ), // JP/AU not supported.
+ );
+ }
+
+ /**
+ * Tests tracking number parsing with various scenarios.
+ *
+ * @dataProvider trackingNumberProvider
+ * @param string $tracking_number The tracking number to test.
+ * @param string $from Origin country code.
+ * @param string $to Destination country code.
+ * @param bool $expected_valid Whether the number should be valid.
+ * @param int|null $expected_score Expected ambiguity score.
+ */
+ public function test_try_parse_tracking_number(
+ string $tracking_number,
+ string $from,
+ string $to,
+ bool $expected_valid,
+ ?int $expected_score
+ ): void {
+ $result = $this->provider->try_parse_tracking_number( $tracking_number, $from, $to );
+
+ if ( $expected_valid ) {
+ $this->assertNotNull( $result );
+ $this->assertEquals( $expected_score, $result['ambiguity_score'] );
+ $this->assertStringContainsString(
+ strtoupper( preg_replace( '/\s+/', '', $tracking_number ) ),
+ $result['url']
+ );
+ } else {
+ $this->assertNull( $result );
+ }
+ }
+
+ /**
+ * Tests country support.
+ */
+ public function test_country_support(): void {
+ $from_countries = $this->provider->get_shipping_from_countries();
+ $to_countries = $this->provider->get_shipping_to_countries();
+
+ // Test that Evri only ships from UK.
+ $this->assertEquals( array( 'GB' ), $from_countries );
+
+ // Test that main European countries are supported for shipping to.
+ $expected_countries = array( 'GB', 'IE', 'FR', 'DE', 'IT', 'ES', 'NL', 'BE' );
+ foreach ( $expected_countries as $country ) {
+ $this->assertContains( $country, $to_countries );
+ }
+
+ // Test that more destinations are supported than origins.
+ $this->assertGreaterThan( count( $from_countries ), count( $to_countries ) );
+ }
+
+ /**
+ * Tests tracking number normalization (spaces, case sensitivity).
+ */
+ public function test_tracking_number_normalization(): void {
+ $test_cases = array(
+ // With spaces.
+ array( '1234 5678 9012 3456', 'GB', 'FR' ),
+ array( ' H123 456 789 01234 ', 'GB', 'DE' ),
+ array( 'E 123 456 789 012 345', 'GB', 'IE' ),
+
+ // Mixed case.
+ array( 'h12345678901234', 'GB', 'FR' ),
+ array( 'Ev123456789012345', 'GB', 'DE' ),
+ array( 'mh1234567890123456', 'GB', 'IE' ),
+ );
+
+ foreach ( $test_cases as $test_case ) {
+ list( $tracking_number, $from, $to ) = $test_case;
+ $result = $this->provider->try_parse_tracking_number( $tracking_number, $from, $to );
+
+ $this->assertNotNull( $result, "Should parse tracking number with normalization: {$tracking_number}" );
+ $this->assertArrayHasKey( 'url', $result );
+
+ // URL should contain normalized version (no spaces, uppercase).
+ $normalized = strtoupper( preg_replace( '/\s+/', '', $tracking_number ) );
+ $this->assertStringContainsString( $normalized, $result['url'] );
+ }
+ }
+
+ /**
+ * Tests empty parameter handling.
+ */
+ public function test_empty_parameters(): void {
+ // Empty tracking number.
+ $result = $this->provider->try_parse_tracking_number( '', 'GB', 'FR' );
+ $this->assertNull( $result );
+
+ // Empty origin country.
+ $result = $this->provider->try_parse_tracking_number( '1234567890123456', '', 'FR' );
+ $this->assertNull( $result );
+
+ // Empty destination country.
+ $result = $this->provider->try_parse_tracking_number( '1234567890123456', 'GB', '' );
+ $this->assertNull( $result );
+
+ // All empty.
+ $result = $this->provider->try_parse_tracking_number( '', '', '' );
+ $this->assertNull( $result );
+ }
+
+ /**
+ * Tests GB origin boost scoring.
+ */
+ public function test_gb_origin_boost(): void {
+ // Same 16-digit number from GB vs invalid non-GB origin.
+ $gb_result = $this->provider->try_parse_tracking_number( '1234567890123456', 'GB', 'FR' );
+ $de_result = $this->provider->try_parse_tracking_number( '1234567890123456', 'DE', 'FR' );
+
+ $this->assertNotNull( $gb_result );
+ $this->assertNull( $de_result ); // Should be null since Evri only ships from GB.
+
+ // GB should get +2 boost (92).
+ $this->assertEquals( 92, $gb_result['ambiguity_score'] );
+ }
+
+ /**
+ * Tests specific pattern formats.
+ */
+ public function test_pattern_formats(): void {
+ // Test 16-digit format.
+ $result = $this->provider->try_parse_tracking_number( '1234567890123456', 'GB', 'FR' );
+ $this->assertNotNull( $result );
+ $this->assertEquals( 92, $result['ambiguity_score'] );
+
+ // Test letter prefix formats.
+ $h_result = $this->provider->try_parse_tracking_number( 'H12345678901234', 'GB', 'DE' );
+ $this->assertNotNull( $h_result );
+ $this->assertEquals( 92, $h_result['ambiguity_score'] );
+
+ $mh_result = $this->provider->try_parse_tracking_number( 'MH1234567890123456', 'GB', 'IE' );
+ $this->assertNotNull( $mh_result );
+ $this->assertEquals( 92, $mh_result['ambiguity_score'] );
+
+ // Test calling card format.
+ $card_result = $this->provider->try_parse_tracking_number( '12345678', 'GB', 'FR' );
+ $this->assertNotNull( $card_result );
+ $this->assertEquals( 80, $card_result['ambiguity_score'] );
+
+ // Test legacy format.
+ $legacy_result = $this->provider->try_parse_tracking_number( '1234567890123', 'GB', 'DE' );
+ $this->assertNotNull( $legacy_result );
+ $this->assertEquals( 90, $legacy_result['ambiguity_score'] );
+ }
+
+ /**
+ * Tests provider metadata.
+ */
+ public function test_provider_metadata(): void {
+ $this->assertEquals( 'evri-hermes', $this->provider->get_key() );
+ $this->assertEquals( 'Evri (Hermes)', $this->provider->get_name() );
+ $this->assertStringEndsWith(
+ '/assets/images/shipping_providers/evri-hermes.png',
+ $this->provider->get_icon()
+ );
+ }
+}
diff --git a/plugins/woocommerce/tests/php/src/Internal/Fulfillments/Providers/FedExShippingProviderTest.php b/plugins/woocommerce/tests/php/src/Internal/Fulfillments/Providers/FedExShippingProviderTest.php
new file mode 100644
index 0000000000..a370dce54f
--- /dev/null
+++ b/plugins/woocommerce/tests/php/src/Internal/Fulfillments/Providers/FedExShippingProviderTest.php
@@ -0,0 +1,180 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Tests\Internal\Fulfillments\Providers;
+
+use Automattic\WooCommerce\Internal\Fulfillments\Providers\FedExShippingProvider;
+
+/**
+ * Unit tests for FedExShippingProvider class.
+ */
+class FedExShippingProviderTest extends \WP_UnitTestCase {
+ /**
+ * The provider instance being tested.
+ *
+ * @var FedExShippingProvider
+ */
+ private FedExShippingProvider $provider;
+
+ /**
+ * Sets up the test fixture.
+ */
+ protected function setUp(): void {
+ parent::setUp();
+ $this->provider = new FedExShippingProvider();
+ }
+
+ /**
+ * Tests the tracking URL generation.
+ */
+ public function test_get_tracking_url(): void {
+ $tracking_number = '123456789012';
+ $expected_url = 'https://www.fedex.com/fedextrack/?tracknumbers=' . rawurlencode( $tracking_number );
+ $this->assertEquals( $expected_url, $this->provider->get_tracking_url( $tracking_number ) );
+ }
+
+ /**
+ * Data provider for tracking number validation tests.
+ *
+ * @return array<array{string, string, string, bool, int}> Test cases.
+ */
+ public function trackingNumberProvider(): array {
+ return array(
+ // FedEx Custom Critical (98 score).
+ array( '001234567890123456789012', 'US', 'CA', true, 98 ),
+ array( '011234567890123456789012', 'US', 'US', true, 98 ),
+
+ // FedEx SmartPost (97 and 96 score).
+ array( '02312345678901234567', 'US', 'US', true, 97 ),
+ array( '58123456789012345678', 'US', 'CA', true, 96 ),
+
+ // FedEx Express - 3x patterns (92 score).
+ array( '31234567890', 'US', 'DE', true, 92 ),
+ array( '398765432109876', 'CA', 'US', true, 80 ), // 15-digit without valid check digit
+
+ // FedEx Ground - 96 prefix (95 US/CA, 60 others).
+ array( '9611020987654312345678', 'US', 'US', true, 95 ),
+ array( '9611020987654312345678', 'CA', 'US', true, 95 ),
+ array( '9611020987654312345678', 'DE', 'FR', true, 60 ),
+
+ // FedEx Freight (93 score).
+ array( '9712345678901234567890123', 'US', 'CA', true, 93 ),
+ array( '971234567890123', 'US', 'US', true, 80 ), // 15-digit pattern, not 97x pattern
+
+ // FedEx International Priority European (93 for EU, 75 for others).
+ array( '812345678901234', 'GB', 'DE', true, 65 ), // 15-digit pattern gets 65 for non-NA
+ array( '812345678901234', 'DE', 'FR', true, 65 ), // 15-digit pattern gets 65 for non-NA
+ array( '812345678901234', 'US', 'CA', true, 80 ), // 15-digit pattern gets 80 for NA
+
+ // FedEx Ground - 7x patterns (90 US/CA, 75 others).
+ array( '712345678901234567890', 'US', 'US', true, 90 ),
+ array( '712345678901234567890', 'CA', 'CA', true, 90 ),
+ array( '712345678901234567890', 'DE', 'FR', true, 75 ),
+
+ // FedEx Express - 15 digit (80 US/CA, 65 others).
+ array( '123456789012345', 'US', 'CA', true, 80 ), // Invalid check digit.
+ array( '123456789012345', 'DE', 'FR', true, 65 ), // Invalid check digit.
+
+ // FedEx Express - 12 digit with invalid check digit (85 US/CA, 70 others).
+ array( '123456789013', 'US', 'CA', true, 85 ), // Invalid check digit.
+ array( '123456789013', 'DE', 'FR', true, 70 ), // Invalid check digit, non-NA.
+
+ // FedEx Express - 12 digit with invalid check digit (85 US/CA, 70 others).
+ array( '123456789012', 'US', 'CA', true, 85 ), // Invalid check digit.
+ array( '123456789012', 'DE', 'FR', true, 70 ), // Invalid check digit, non-NA.
+
+ // FedEx Express - 14 digit with invalid check digit (78 US/CA, 60 others).
+ array( '12345678901237', 'US', 'FR', true, 78 ), // Invalid check digit.
+ array( '12345678901237', 'GB', 'DE', true, 60 ), // Invalid check digit, non-NA.
+
+ // FedEx Express - 14 digit with invalid check digit (78 US/CA, 60 others).
+ array( '12345678901234', 'US', 'FR', true, 78 ), // Invalid check digit.
+ array( '12345678901234', 'GB', 'DE', true, 60 ), // Invalid check digit, non-NA.
+
+ // FedEx SameDay and Next Flight Out.
+ array( 'SD1234567890123', 'US', 'CA', true, 90 ),
+ array( 'NFO1234567890123', 'US', 'DE', true, 92 ),
+
+ // FedEx Express - 20 digit (70 score).
+ array( '12345678901234567890', 'US', 'DE', true, 70 ),
+ array( '98765432109876543210', 'FR', 'IT', true, 70 ),
+
+ // FedEx Express - 22 digit (65 score).
+ array( '1234567890123456789012', 'US', 'DE', true, 65 ),
+
+ // Invalid formats.
+ array( '1234567890', 'US', 'CA', false, 0 ), // Too short.
+ array( 'ABCDEFGHIJKL', 'US', 'US', false, 0 ), // Invalid characters.
+ array( '12345', 'CA', 'US', false, 0 ), // Too short.
+
+ // Invalid countries.
+ array( '123456789012', 'ZZ', 'US', false, 0 ), // Invalid origin.
+ array( '123456789012', 'US', 'ZZ', false, 0 ), // Invalid destination.
+ );
+ }
+
+ /**
+ * Tests tracking number parsing with various scenarios.
+ *
+ * @dataProvider trackingNumberProvider
+ * @param string $tracking_number The tracking number to test.
+ * @param string $from Origin country code.
+ * @param string $to Destination country code.
+ * @param bool $expected_valid Whether the number should be valid.
+ * @param int $expected_score Expected ambiguity score.
+ */
+ public function test_try_parse_tracking_number(
+ string $tracking_number,
+ string $from,
+ string $to,
+ bool $expected_valid,
+ int $expected_score
+ ): void {
+ $result = $this->provider->try_parse_tracking_number( $tracking_number, $from, $to );
+
+ if ( ! $expected_valid ) {
+ $this->assertNull( $result );
+ } else {
+ $this->assertNotNull( $result );
+ $this->assertEquals(
+ 'https://www.fedex.com/fedextrack/?tracknumbers=' . rawurlencode( $tracking_number ),
+ $result['url']
+ );
+ $this->assertEquals( $expected_score, $result['ambiguity_score'] );
+ }
+ }
+
+ /**
+ * Tests FedEx Ground regional scoring differences.
+ */
+ public function test_ground_regional_restrictions(): void {
+ $us_result = $this->provider->try_parse_tracking_number( '9611020987654312345678', 'US', 'CA' );
+ $de_result = $this->provider->try_parse_tracking_number( '9611020987654312345678', 'DE', 'FR' );
+
+ $this->assertNotNull( $us_result );
+ $this->assertNotNull( $de_result );
+ $this->assertGreaterThan( $de_result['ambiguity_score'], $us_result['ambiguity_score'] );
+ }
+
+ /**
+ * Tests the scoring hierarchy between different formats.
+ */
+ public function test_format_confidence_hierarchy(): void {
+ $custom_critical = $this->provider->try_parse_tracking_number( '001234567890123456789012', 'US', 'CA' );
+ $express_12_valid = $this->provider->try_parse_tracking_number( '123456789013', 'US', 'CA' ); // Valid check digit.
+ $express_12_invalid = $this->provider->try_parse_tracking_number( '123456789012', 'US', 'CA' ); // Invalid check digit.
+ $express_15 = $this->provider->try_parse_tracking_number( '123456789012345', 'US', 'CA' );
+ $generic_20 = $this->provider->try_parse_tracking_number( '12345678901234567890', 'US', 'CA' );
+
+ // Custom Critical should have highest score.
+ $this->assertGreaterThan( $express_12_valid['ambiguity_score'], $custom_critical['ambiguity_score'] );
+
+ // Both 12-digit numbers get same score if both have invalid check digits.
+ $this->assertEquals( $express_12_invalid['ambiguity_score'], $express_12_valid['ambiguity_score'] );
+
+ // Express 15 should beat Express 12 invalid.
+ $this->assertGreaterThan( $express_15['ambiguity_score'], $express_12_invalid['ambiguity_score'] );
+
+ // Express 15 should beat generic 20.
+ $this->assertGreaterThan( $generic_20['ambiguity_score'], $express_15['ambiguity_score'] );
+ }
+}
diff --git a/plugins/woocommerce/tests/php/src/Internal/Fulfillments/Providers/RoyalMailShippingProviderTest.php b/plugins/woocommerce/tests/php/src/Internal/Fulfillments/Providers/RoyalMailShippingProviderTest.php
new file mode 100644
index 0000000000..65c6402400
--- /dev/null
+++ b/plugins/woocommerce/tests/php/src/Internal/Fulfillments/Providers/RoyalMailShippingProviderTest.php
@@ -0,0 +1,305 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Tests\Internal\Fulfillments\Providers;
+
+use Automattic\WooCommerce\Internal\Fulfillments\Providers\RoyalMailShippingProvider;
+
+/**
+ * Unit tests for RoyalMailShippingProvider class.
+ */
+class RoyalMailShippingProviderTest extends \WP_UnitTestCase {
+ /**
+ * The provider instance being tested.
+ *
+ * @var RoyalMailShippingProvider
+ */
+ private RoyalMailShippingProvider $provider;
+
+ /**
+ * Sets up the test fixture.
+ */
+ protected function setUp(): void {
+ parent::setUp();
+ $this->provider = new RoyalMailShippingProvider();
+ }
+
+ /**
+ * Tests the tracking URL generation.
+ */
+ public function test_get_tracking_url(): void {
+ $this->assertEquals(
+ 'https://www.royalmail.com/track-your-item#/tracking-results/AB123456789GB',
+ $this->provider->get_tracking_url( 'AB123456789GB' )
+ );
+
+ // Test URL encoding.
+ $this->assertEquals(
+ 'https://www.royalmail.com/track-your-item#/tracking-results/AB123%2F456',
+ $this->provider->get_tracking_url( 'AB123/456' )
+ );
+ }
+
+ /**
+ * Data provider for tracking number validation tests.
+ *
+ * @return array<array{string, string, string, bool, int|null}> Test cases.
+ */
+ public function trackingNumberProvider(): array {
+ return array(
+ // UPU S10 international formats (base confidence 80, no UPU boost if validation fails).
+ array( 'AB123456789GB', 'GB', 'DE', true, 83 ), // S10 format, 80 + European boost (+3) = 83.
+ array( 'CD1234567GB', 'GB', 'FR', true, 83 ), // Alternative S10 format, 80 + European boost (+3) = 83.
+ array( 'EF123456789GB', 'GB', 'GB', true, 88 ), // S10 format, 80 + domestic boost (+8) = 88.
+ array( 'GH1234567GB', 'GB', 'US', true, 82 ), // S10 format, 80 + common destination boost (+2) = 82.
+
+ // Domestic tracking formats (base confidence 80).
+ array( 'A123456789B', 'GB', 'GB', true, 88 ), // Domestic format, 80 + domestic boost (+8) = 88.
+ array( 'CD12345678EF', 'GB', 'FR', true, 83 ), // Standard format, 80 + European boost (+3) = 83.
+ array( 'GH123456IJ', 'GB', 'DE', true, 83 ), // Compact format, 80 + European boost (+3) = 83.
+ array( 'A123456789B', 'GB', 'US', true, 82 ), // Domestic format, 80 + common destination boost (+2) = 82.
+
+ // Service-specific patterns.
+ array( 'ABCD1234567890', 'GB', 'FR', true, 83 ), // Standard format, 80 + European boost (+3) = 83.
+ array( 'SD12345678', 'GB', 'DE', true, 89 ), // Signed For service, 80 + service boost (+6) + European boost (+3) = 89.
+ array( 'SF123456789012', 'GB', 'GB', true, 94 ), // Special Delivery, 80 + service boost (+6) + domestic boost (+8) = 94.
+ array( 'RM1234567890', 'GB', 'FR', true, 86 ), // Royal Mail standard, 80 + service boost (+3) + European boost (+3) = 86.
+
+ // Digital tracking formats (base confidence 80).
+ array( '1234567890123456', 'GB', 'GB', true, 88 ), // 16-digit, 80 + domestic boost (+8) = 88.
+ array( '1234567890123', 'GB', 'FR', true, 83 ), // 13-digit, 80 + European boost (+3) = 83.
+ array( '123456789012', 'GB', 'DE', true, 83 ), // 12-digit, 80 + European boost (+3) = 83.
+ array( '12345678901', 'GB', 'US', true, 82 ), // 11-digit, 80 + common destination boost (+2) = 82.
+ array( '1234567890', 'GB', 'AU', true, 82 ), // 10-digit, 80 + common destination boost (+2) = 82.
+ array( '123456789', 'GB', 'CA', true, 82 ), // 9-digit, 80 + common destination boost (+2) = 82.
+
+ // Parcelforce (Royal Mail Group).
+ array( 'PF123456789012', 'GB', 'FR', true, 87 ), // Parcelforce, 80 + service boost (+4) + European boost (+3) = 87.
+ array( 'AB12345678PF', 'GB', 'DE', true, 83 ), // Parcelforce International, 80 + European boost (+3) = 83.
+ array( '1234567890123', 'GB', 'GB', true, 88 ), // Parcelforce Worldwide numeric, 80 + domestic boost (+8) = 88.
+
+ // International tracked services.
+ array( 'IT123456789GB', 'GB', 'FR', true, 88 ), // International Tracked, 80 + service boost (+5) + European boost (+3) = 88.
+ array( 'IE123456789GB', 'GB', 'DE', true, 88 ), // International Economy, 80 + service boost (+5) + European boost (+3) = 88.
+ array( 'IS123456789GB', 'GB', 'US', true, 87 ), // International Standard, 80 + service boost (+5) + common destination boost (+2) = 87.
+
+ // Business services.
+ array( 'BF123456789012', 'GB', 'FR', true, 86 ), // Business services, 80 + service boost (+3) + European boost (+3) = 86.
+ array( 'ABC1234567890', 'GB', 'DE', true, 83 ), // Three-letter business codes, 80 + European boost (+3) = 83.
+
+ // Legacy formats.
+ array( 'A12345678BC', 'GB', 'FR', true, 83 ), // Legacy format, 80 + European boost (+3) = 83.
+ array( '123456789ABC', 'GB', 'DE', true, 83 ), // 9 digits + 3 letters, 80 + European boost (+3) = 83.
+
+ // Invalid formats (non-GB origin).
+ array( 'AB123456789GB', 'DE', 'GB', false, null ), // Not from GB.
+ array( '1234567890123456', 'FR', 'GB', false, null ), // Not from GB.
+ array( 'SD12345678', 'US', 'GB', false, null ), // Not from GB.
+
+ // Invalid formats (wrong patterns).
+ array( 'INVALID123', 'GB', 'FR', false, null ), // Invalid format.
+ array( '12345', 'GB', 'DE', false, null ), // Too short.
+ array( 'AB12345678901234567890', 'GB', 'FR', false, null ), // Too long.
+ );
+ }
+
+ /**
+ * Tests tracking number parsing with various scenarios.
+ *
+ * @dataProvider trackingNumberProvider
+ * @param string $tracking_number The tracking number to test.
+ * @param string $from Origin country code.
+ * @param string $to Destination country code.
+ * @param bool $expected_valid Whether the number should be valid.
+ * @param int|null $expected_score Expected ambiguity score.
+ */
+ public function test_try_parse_tracking_number(
+ string $tracking_number,
+ string $from,
+ string $to,
+ bool $expected_valid,
+ ?int $expected_score
+ ): void {
+ $result = $this->provider->try_parse_tracking_number( $tracking_number, $from, $to );
+
+ if ( $expected_valid ) {
+ $this->assertNotNull( $result );
+ $this->assertEquals( $expected_score, $result['ambiguity_score'] );
+ $this->assertStringContainsString(
+ strtoupper( preg_replace( '/\s+/', '', $tracking_number ) ),
+ $result['url']
+ );
+ } else {
+ $this->assertNull( $result );
+ }
+ }
+
+ /**
+ * Tests country support.
+ */
+ public function test_country_support(): void {
+ $from_countries = $this->provider->get_shipping_from_countries();
+ $to_countries = $this->provider->get_shipping_to_countries();
+
+ // Test that only GB is supported as origin.
+ $this->assertEquals( array( 'GB' ), $from_countries );
+
+ // Test that many international destinations are supported.
+ $expected_destinations = array( 'GB', 'US', 'CA', 'DE', 'FR', 'AU', 'JP' );
+ foreach ( $expected_destinations as $country ) {
+ $this->assertContains( $country, $to_countries );
+ }
+
+ // Test that we have many international destinations.
+ $this->assertGreaterThan( 190, count( $to_countries ) );
+ }
+
+ /**
+ * Tests tracking number normalization (spaces, case sensitivity).
+ */
+ public function test_tracking_number_normalization(): void {
+ $test_cases = array(
+ // With spaces.
+ array( 'AB 123 456 789 GB', 'GB', 'FR' ),
+ array( ' SD123 456 78 ', 'GB', 'DE' ),
+ array( '1234 5678 9012 3456', 'GB', 'US' ),
+
+ // Mixed case.
+ array( 'ab123456789gb', 'GB', 'FR' ),
+ array( 'Sd123456789', 'GB', 'DE' ),
+ array( 'pf1234567890', 'GB', 'IE' ),
+ );
+
+ foreach ( $test_cases as $test_case ) {
+ list( $tracking_number, $from, $to ) = $test_case;
+ $result = $this->provider->try_parse_tracking_number( $tracking_number, $from, $to );
+
+ $this->assertNotNull( $result, "Should parse tracking number with normalization: {$tracking_number}" );
+ $this->assertArrayHasKey( 'url', $result );
+
+ // URL should contain normalized version (no spaces, uppercase).
+ $normalized = strtoupper( preg_replace( '/\s+/', '', $tracking_number ) );
+ $this->assertStringContainsString( $normalized, $result['url'] );
+ }
+ }
+
+ /**
+ * Tests empty parameter handling.
+ */
+ public function test_empty_parameters(): void {
+ // Empty tracking number.
+ $result = $this->provider->try_parse_tracking_number( '', 'GB', 'FR' );
+ $this->assertNull( $result );
+
+ // Empty origin country.
+ $result = $this->provider->try_parse_tracking_number( 'AB123456789GB', '', 'FR' );
+ $this->assertNull( $result );
+
+ // Empty destination country.
+ $result = $this->provider->try_parse_tracking_number( 'AB123456789GB', 'GB', '' );
+ $this->assertNull( $result );
+
+ // All empty.
+ $result = $this->provider->try_parse_tracking_number( '', '', '' );
+ $this->assertNull( $result );
+ }
+
+ /**
+ * Tests non-GB origin rejection.
+ */
+ public function test_non_gb_origin_rejection(): void {
+ $non_gb_origins = array( 'US', 'DE', 'FR', 'CA', 'AU', 'JP' );
+
+ foreach ( $non_gb_origins as $origin ) {
+ $result = $this->provider->try_parse_tracking_number( 'AB123456789GB', $origin, 'GB' );
+ $this->assertNull( $result, "Should reject tracking number from non-GB origin: {$origin}" );
+ }
+ }
+
+ /**
+ * Tests destination-based scoring.
+ */
+ public function test_destination_scoring(): void {
+ // Test domestic vs international scoring.
+ $domestic = $this->provider->try_parse_tracking_number( 'AB123456789GB', 'GB', 'GB' );
+ $european = $this->provider->try_parse_tracking_number( 'AB123456789GB', 'GB', 'FR' );
+ $common = $this->provider->try_parse_tracking_number( 'AB123456789GB', 'GB', 'US' );
+ $other = $this->provider->try_parse_tracking_number( 'AB123456789GB', 'GB', 'JP' );
+
+ $this->assertNotNull( $domestic );
+ $this->assertNotNull( $european );
+ $this->assertNotNull( $common );
+ $this->assertNotNull( $other );
+
+ // Domestic should have highest score (80 + 8 domestic boost = 88).
+ $this->assertEquals( 88, $domestic['ambiguity_score'] );
+
+ // European should have higher score than common destinations.
+ $this->assertEquals( 83, $european['ambiguity_score'] ); // 80 + 3 European boost.
+ $this->assertEquals( 82, $common['ambiguity_score'] ); // 80 + 2 common destination boost.
+ $this->assertEquals( 82, $other['ambiguity_score'] ); // 80 base confidence.
+
+ $this->assertGreaterThan( $common['ambiguity_score'], $european['ambiguity_score'] );
+ }
+
+ /**
+ * Tests service-specific scoring.
+ */
+ public function test_service_specific_scoring(): void {
+ // Test different service types.
+ $standard = $this->provider->try_parse_tracking_number( 'AB123456789GB', 'GB', 'FR' );
+ $signed = $this->provider->try_parse_tracking_number( 'SD12345678', 'GB', 'FR' );
+ $special = $this->provider->try_parse_tracking_number( 'SF123456789012', 'GB', 'FR' );
+ $rm_std = $this->provider->try_parse_tracking_number( 'RM1234567890', 'GB', 'FR' );
+ $pf_exp = $this->provider->try_parse_tracking_number( 'PF123456789012', 'GB', 'FR' );
+
+ $this->assertNotNull( $standard );
+ $this->assertNotNull( $signed );
+ $this->assertNotNull( $special );
+ $this->assertNotNull( $rm_std );
+ $this->assertNotNull( $pf_exp );
+
+ // Service-specific patterns should have higher scores.
+ $this->assertEquals( 83, $standard['ambiguity_score'] ); // S10 format + European boost.
+ $this->assertEquals( 89, $signed['ambiguity_score'] ); // SD service boost + European boost.
+ $this->assertEquals( 89, $special['ambiguity_score'] ); // SF service boost + European boost.
+ $this->assertEquals( 86, $rm_std['ambiguity_score'] ); // RM service boost + European boost.
+ $this->assertEquals( 87, $pf_exp['ambiguity_score'] ); // PF service boost + European boost.
+
+ $this->assertGreaterThan( $standard['ambiguity_score'], $signed['ambiguity_score'] );
+ $this->assertGreaterThan( $standard['ambiguity_score'], $special['ambiguity_score'] );
+ }
+
+ /**
+ * Tests check digit validation for numeric formats.
+ */
+ public function test_check_digit_validation(): void {
+ // Test different numeric lengths.
+ $result_16 = $this->provider->try_parse_tracking_number( '1234567890123456', 'GB', 'FR' );
+ $result_13 = $this->provider->try_parse_tracking_number( '1234567890123', 'GB', 'FR' );
+ $result_12 = $this->provider->try_parse_tracking_number( '123456789012', 'GB', 'FR' );
+ $result_11 = $this->provider->try_parse_tracking_number( '12345678901', 'GB', 'FR' );
+
+ $this->assertNotNull( $result_16 );
+ $this->assertNotNull( $result_13 );
+ $this->assertNotNull( $result_12 );
+ $this->assertNotNull( $result_11 );
+
+ // All should get European boost.
+ $this->assertEquals( 83, $result_16['ambiguity_score'] ); // 80 + 3 European boost.
+ $this->assertEquals( 83, $result_13['ambiguity_score'] ); // 80 + 3 European boost.
+ $this->assertEquals( 83, $result_12['ambiguity_score'] ); // 80 + 3 European boost.
+ $this->assertEquals( 83, $result_11['ambiguity_score'] ); // 80 + 3 European boost.
+ }
+
+ /**
+ * Tests provider metadata.
+ */
+ public function test_provider_metadata(): void {
+ $this->assertEquals( 'royal-mail', $this->provider->get_key() );
+ $this->assertEquals( 'Royal Mail', $this->provider->get_name() );
+ $this->assertStringEndsWith(
+ '/assets/images/shipping_providers/royal-mail.png',
+ $this->provider->get_icon()
+ );
+ }
+}
diff --git a/plugins/woocommerce/tests/php/src/Internal/Fulfillments/Providers/UPSShippingProviderTest.php b/plugins/woocommerce/tests/php/src/Internal/Fulfillments/Providers/UPSShippingProviderTest.php
new file mode 100644
index 0000000000..0f2a98ca6c
--- /dev/null
+++ b/plugins/woocommerce/tests/php/src/Internal/Fulfillments/Providers/UPSShippingProviderTest.php
@@ -0,0 +1,176 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Tests\Internal\Fulfillments\Providers;
+
+use Automattic\WooCommerce\Internal\Fulfillments\Providers\UPSShippingProvider;
+
+/**
+ * Unit tests for UPSShippingProvider class.
+ */
+class UPSShippingProviderTest extends \WP_UnitTestCase {
+ /**
+ * Test the get_tracking_url method.
+ */
+ public function test_get_tracking_url(): void {
+ $tracking_number = '1Z12345E0205271688';
+ $expected_url = 'https://www.ups.com/track?tracknum=' . rawurlencode( $tracking_number );
+ $provider = new UPSShippingProvider();
+ $this->assertEquals( $expected_url, $provider->get_tracking_url( $tracking_number ) );
+ }
+
+ /**
+ * Data provider for tracking number parsing tests.
+ *
+ * @return array
+ */
+ public function trackingNumberProvider(): array {
+ return array(
+ // 1Z format with valid check digit (100).
+ array( '1Z12345E0205271688', 'US', 'DE', true, 100 ),
+ array( '1Z12345E0205271688', 'CA', 'US', true, 100 ),
+ array( '1Z12345E0205271688', 'GB', 'FR', true, 100 ),
+ array( '1z12345e0205271688', 'DE', 'IT', true, 100 ),
+
+ // 1Z format with invalid check digit (95).
+ array( '1Z12345E0205271687', 'US', 'DE', true, 95 ),
+
+ // SurePost format (85 for US/CA).
+ array( '9274345678901234567890', 'US', 'US', true, 85 ),
+ array( '9274345678901234567890', 'CA', 'CA', true, 85 ),
+
+ // T/H/V format (85).
+ array( 'T1234567890', 'US', 'US', true, 85 ),
+ array( 'H1234567890', 'US', 'US', true, 85 ),
+ array( 't1234567890', 'US', 'US', true, 85 ),
+ array( 'h1234567890', 'US', 'US', true, 85 ),
+ array( 'T1234567890', 'CA', 'CA', true, 85 ),
+ array( 'T1234567890', 'GB', 'GB', true, 85 ),
+ array( 'T1234567890', 'US', 'CA', true, 85 ),
+
+ // InfoNotice format (80).
+ array( 'J1234567890', 'US', 'US', true, 80 ),
+ array( 'J1234567890', 'CA', 'CA', true, 80 ),
+ array( 'j1234567890', 'DE', 'DE', true, 80 ),
+ array( 'J1234567890', 'US', 'CA', true, 80 ),
+
+ // Mail Innovations formats - US/CA get higher scores.
+ array( '9123456789012345678901234567890123', 'US', 'CA', true, 85 ),
+ array( '9123456789012345678901234567890123', 'CA', 'US', true, 85 ),
+ array( '9123456789012345678901234567890123', 'DE', 'FR', true, 70 ),
+
+ // 12-digit with valid check digit (80).
+ array( '476618356000', 'US', 'US', true, 80 ),
+ // 12-digit with invalid check digit (80).
+ array( '476618356001', 'US', 'US', true, 80 ),
+
+ // Other numeric formats.
+ array( '1234567890', 'US', 'US', true, 75 ),
+ array( '123456789', 'US', 'US', true, 70 ),
+ array( '1234567890123456789012', 'US', 'CA', true, 60 ),
+
+ // Domestic-but-international-tracking countries (boost +5).
+ array( '1Z12345E0205271688', 'IN', 'IN', true, 105 ),
+ array( 'T1234567890', 'HK', 'HK', true, 90 ), // 85+5
+
+ // Invalid formats.
+ array( 'INVALID123', 'CA', 'US', false, null ),
+ array( '1Y12345E0205271688', 'US', 'DE', false, null ),
+ array( '1Z12345E020527', 'US', 'DE', false, null ),
+
+ // Invalid countries.
+ array( '1Z12345E0205271688', 'ZZ', 'US', false, null ),
+ array( '1Z12345E0205271688', 'US', 'ZZ', false, null ),
+ );
+ }
+
+ /**
+ * Test tracking number parsing with various scenarios.
+ *
+ * @param string $tracking_number The tracking number to test.
+ * @param string $shipping_from The country code from which the shipment is sent.
+ * @param string $shipping_to The country code to which the shipment is sent.
+ * @param bool $has_match Whether the tracking number should match a known format.
+ * @param int|null $expected_score The expected ambiguity score if a match is found.
+ *
+ * @dataProvider trackingNumberProvider
+ */
+ public function test_tracking_number_parsing(
+ string $tracking_number,
+ string $shipping_from,
+ string $shipping_to,
+ bool $has_match,
+ ?int $expected_score
+ ): void {
+ $provider = new UPSShippingProvider();
+ $result = $provider->try_parse_tracking_number( $tracking_number, $shipping_from, $shipping_to );
+
+ if ( $has_match ) {
+ $this->assertNotNull( $result );
+ $this->assertEquals(
+ 'https://www.ups.com/track?tracknum=' . rawurlencode( strtoupper( $tracking_number ) ),
+ $result['url']
+ );
+ $this->assertEquals( $expected_score, $result['ambiguity_score'] );
+ } else {
+ $this->assertNull( $result );
+ }
+ }
+
+ /**
+ * Test T/H format global validity.
+ */
+ public function test_th_format_global_validity(): void {
+ $provider = new UPSShippingProvider();
+
+ // Should work globally.
+ $us_domestic = $provider->try_parse_tracking_number( 'T1234567890', 'US', 'US' );
+ $ca_domestic = $provider->try_parse_tracking_number( 'T1234567890', 'CA', 'CA' );
+ $international = $provider->try_parse_tracking_number( 'T1234567890', 'US', 'CA' );
+
+ $this->assertNotNull( $us_domestic );
+ $this->assertNotNull( $ca_domestic );
+ $this->assertNotNull( $international );
+ $this->assertEquals( 85, $us_domestic['ambiguity_score'] );
+ }
+
+ /**
+ * Test SurePost format recognition.
+ */
+ public function test_surepost_format(): void {
+ $provider = new UPSShippingProvider();
+ $result = $provider->try_parse_tracking_number( '9274345678901234567890', 'US', 'US' );
+
+ $this->assertNotNull( $result );
+ $this->assertEquals( 85, $result['ambiguity_score'] );
+ }
+
+ /**
+ * Test domestic-but-international-tracking score boost.
+ */
+ public function test_domestic_international_tracking_boost(): void {
+ $provider = new UPSShippingProvider();
+
+ // India (IN) is in domestic_but_international_tracking.
+ $result = $provider->try_parse_tracking_number( '1Z12345E0205271688', 'IN', 'IN' );
+ $this->assertNotNull( $result );
+ $this->assertEquals( 105, $result['ambiguity_score'] ); // 100 + 5 boost.
+ }
+
+ /**
+ * Test case insensitivity.
+ */
+ public function test_case_insensitivity(): void {
+ $provider = new UPSShippingProvider();
+
+ $results = array(
+ $provider->try_parse_tracking_number( '1Z12345E0205271688', 'US', 'DE' ),
+ $provider->try_parse_tracking_number( '1z12345e0205271688', 'US', 'DE' ),
+ $provider->try_parse_tracking_number( '1z12345E0205271688', 'US', 'DE' ),
+ );
+
+ foreach ( $results as $result ) {
+ $this->assertNotNull( $result );
+ $this->assertEquals( 100, $result['ambiguity_score'] );
+ }
+ }
+}
diff --git a/plugins/woocommerce/tests/php/src/Internal/Fulfillments/Providers/USPSShippingProviderTest.php b/plugins/woocommerce/tests/php/src/Internal/Fulfillments/Providers/USPSShippingProviderTest.php
new file mode 100644
index 0000000000..7bb03c7f7b
--- /dev/null
+++ b/plugins/woocommerce/tests/php/src/Internal/Fulfillments/Providers/USPSShippingProviderTest.php
@@ -0,0 +1,155 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Tests\Internal\Fulfillments\Providers;
+
+use Automattic\WooCommerce\Internal\Fulfillments\Providers\USPSShippingProvider;
+
+/**
+ * Test suite for the USPSShippingProvider class.
+ */
+class USPSShippingProviderTest extends \WP_UnitTestCase {
+ /**
+ * The provider instance being tested.
+ *
+ * @var USPSShippingProvider
+ */
+ private USPSShippingProvider $provider;
+
+ /**
+ * Sets up the test fixture.
+ */
+ protected function setUp(): void {
+ parent::setUp();
+ $this->provider = new USPSShippingProvider();
+ }
+
+ /**
+ * Tests the tracking URL generation.
+ */
+ public function test_get_tracking_url(): void {
+ $tracking_number = '9400111899223859301234';
+ $expected_url = 'https://tools.usps.com/go/TrackConfirmAction?tLabels=' . rawurlencode( $tracking_number );
+ $this->assertEquals( $expected_url, $this->provider->get_tracking_url( $tracking_number ) );
+ }
+
+ /**
+ * Data provider for tracking number validation tests.
+ *
+ * @return array Test cases.
+ */
+ public function trackingNumberProvider(): array {
+ return array(
+ // 22-digit patterns (94/93/92/95/96) - test actual working numbers.
+ array( '9407111899223859301234', 'US', 'US', true, 95 ), // 94xx - will get 95 (invalid check digit).
+ array( '9307111899223859301234', 'US', 'US', true, 100 ), // 93xx - will get 100 (valid check digit).
+ array( '9207111899223859301234', 'US', 'US', true, 95 ), // 92xx - will get 95 (no valid check digit).
+
+ // More 22-digit patterns.
+ array( '9507111899223859301234', 'US', 'US', true, 95 ), // 95xx with standard score.
+ array( '9607111899223859301234', 'US', 'US', true, 95 ), // 96xx with standard score.
+
+ // UPU S10 format with invalid check digit (90).
+ array( 'LZ123456787US', 'US', 'DE', true, 90 ), // UPU S10 format with invalid check digit.
+ array( 'EC123456787US', 'US', 'CA', true, 90 ), // Global Express with invalid check digit.
+
+ // UPU S10 format with invalid check digit (90).
+ array( 'LZ123456789US', 'US', 'DE', true, 90 ), // UPU S10 format with invalid check digit.
+ array( 'EC123456789US', 'US', 'CA', true, 90 ), // Global Express with invalid check digit.
+
+ // Global Express Guaranteed (82xxxxxxx) (95).
+ array( '82123456789', 'US', 'GB', true, 95 ), // Global Express Guaranteed 10-digit.
+ array( '82123456789', 'US', 'FR', true, 95 ), // Global Express Guaranteed 10-digit (pattern only matches 10-11 digits).
+
+ // Parcel Pool (420xxxxxxx) (90).
+ array( '42012345678901234567890123456', 'US', 'US', true, 90 ), // 26-digit Parcel Pool.
+
+ // 20-22 digit fallback (80).
+ array( '12345678901234567890', 'US', 'US', true, 80 ), // 20-digit fallback.
+ array( '1234567890123456789012', 'US', 'US', true, 80 ), // 22-digit fallback.
+
+ // 9x... fallback (75).
+ array( '9999111899223859301234567', 'US', 'US', true, 75 ), // 9x fallback.
+
+ // GS1-128 format (91) with valid check digit (90).
+ array( '911234567890123456789', 'US', 'US', true, 80 ), // GS1-128 format - 21 digits matches 91 pattern, but no valid check digit.
+
+ // GS1-128 format (91) with invalid check digit (80).
+ array( '911234567890123456789', 'US', 'US', true, 80 ), // GS1-128 format with invalid check digit.
+
+ // Legacy/Express with invalid check digit (80).
+ array( '030612345678901234567890', 'US', 'US', true, 80 ), // Express with invalid check digit.
+
+ // Legacy/Express with invalid check digit (80).
+ array( '030612345678901234567892', 'US', 'US', true, 80 ), // Express with invalid check digit.
+
+ // UPU fallback ending with US (90).
+ array( 'AB123456789US', 'US', 'DE', true, 90 ), // UPU format matches S10 pattern first.
+
+ // Very long numeric fallback (60).
+ array( '12345678901234567890123456789012', 'US', 'US', true, 60 ), // 32-digit fallback.
+
+ // Invalid cases.
+ array( 'INVALID123', 'US', 'US', false, null ), // Invalid format.
+ array( '940011189922385930', 'US', 'US', false, null ), // Too short.
+ array( '9400111899223859301234', 'CA', 'US', false, null ), // Invalid origin.
+ array( 'LZ123456789DE', 'US', 'DE', true, 90 ), // UPU with DE suffix, gets fallback score.
+ );
+ }
+
+ /**
+ * Tests tracking number parsing with various scenarios.
+ *
+ * @dataProvider trackingNumberProvider
+ * @param string $tracking_number The tracking number to test.
+ * @param string $from Origin country code.
+ * @param string $to Destination country code.
+ * @param bool $expected_valid Whether the number should be valid.
+ * @param int|null $expected_score Expected ambiguity score.
+ */
+ public function test_try_parse_tracking_number(
+ string $tracking_number,
+ string $from,
+ string $to,
+ bool $expected_valid,
+ ?int $expected_score
+ ): void {
+ $result = $this->provider->try_parse_tracking_number( $tracking_number, $from, $to );
+
+ if ( ! $expected_valid ) {
+ $this->assertNull( $result );
+ } else {
+ $this->assertNotNull( $result );
+ $this->assertEquals(
+ 'https://tools.usps.com/go/TrackConfirmAction?tLabels=' . rawurlencode( $tracking_number ),
+ $result['url']
+ );
+ $this->assertEquals( $expected_score, $result['ambiguity_score'] );
+ }
+ }
+
+ /**
+ * Tests the service type scoring hierarchy.
+ */
+ public function test_service_hierarchy(): void {
+ $high_score = $this->provider->try_parse_tracking_number( '9407111899223859301238', 'US', 'US' ); // Should get 100 if valid check digit.
+ $mid_score = $this->provider->try_parse_tracking_number( '9407111899223859301234', 'US', 'US' ); // Should get 100 if valid check digit.
+ $low_score = $this->provider->try_parse_tracking_number( '9999111899223859301234567', 'US', 'US' ); // 9x fallback = 75.
+
+ // Both high and mid scores might be 100, so check low score is less.
+ $this->assertGreaterThan( $low_score['ambiguity_score'], $high_score['ambiguity_score'] );
+ $this->assertGreaterThan( $low_score['ambiguity_score'], $mid_score['ambiguity_score'] );
+ }
+
+ /**
+ * Tests international shipment scoring.
+ */
+ public function test_international_scoring(): void {
+ $upu_valid = $this->provider->try_parse_tracking_number( 'LZ123456787US', 'US', 'DE' ); // Invalid UPU check digit = 90.
+ $upu_invalid = $this->provider->try_parse_tracking_number( 'LZ123456789US', 'US', 'DE' ); // Invalid UPU check digit = 90.
+ $global_valid = $this->provider->try_parse_tracking_number( 'EC123456787US', 'US', 'CA' ); // Invalid UPU check digit = 90.
+
+ $this->assertEquals( 90, $upu_valid['ambiguity_score'] );
+ $this->assertEquals( 90, $upu_invalid['ambiguity_score'] );
+ $this->assertEquals( 90, $global_valid['ambiguity_score'] );
+ }
+}
diff --git a/plugins/woocommerce/tests/php/src/Internal/Fulfillments/ShippingProvidersTest.php b/plugins/woocommerce/tests/php/src/Internal/Fulfillments/ShippingProvidersTest.php
new file mode 100644
index 0000000000..f057f63b83
--- /dev/null
+++ b/plugins/woocommerce/tests/php/src/Internal/Fulfillments/ShippingProvidersTest.php
@@ -0,0 +1,46 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Tests\Internal\Fulfillments;
+
+use Automattic\WooCommerce\Internal\Fulfillments\FulfillmentsManager;
+use Automattic\WooCommerce\Internal\Fulfillments\FulfillmentUtils;
+use Automattic\WooCommerce\Internal\Fulfillments\Providers as ShippingProviders;
+
+/**
+ * ShippingProvidersTest class.
+ *
+ * This class tests the shipping providers configuration.
+ */
+class ShippingProvidersTest extends \WP_UnitTestCase {
+ /**
+ * Test that the shipping providers configuration returns the correct classes.
+ */
+ public function test_shipping_providers_configuration(): void {
+ new FulfillmentsManager(); // Ensure the FulfillmentsManager is initialized to load the shipping providers.
+
+ $shipping_providers = FulfillmentUtils::get_shipping_providers();
+
+ foreach ( $shipping_providers as $key => $provider_class ) {
+ $this->assertTrue(
+ class_exists( $provider_class ),
+ sprintf( 'Shipping provider class %s does not exist.', $provider_class )
+ );
+
+ $provider_instance = new $provider_class();
+ $this->assertInstanceOf(
+ ShippingProviders\AbstractShippingProvider::class,
+ $provider_instance,
+ sprintf( 'Shipping provider %s is not an instance of AbstractShippingProvider.', $key )
+ );
+ $this->assertNotEmpty(
+ $provider_instance->get_key(),
+ sprintf( 'Shipping provider %s does not have a valid key.', $key )
+ );
+ $this->assertEquals(
+ $key,
+ $provider_instance->get_key(),
+ sprintf( 'Shipping provider key %s does not match the expected key %s.', $provider_instance->get_key(), $key )
+ );
+ }
+ }
+}
diff --git a/plugins/woocommerce/tests/php/src/Internal/Fulfillments/TrackingNumbersTest.php b/plugins/woocommerce/tests/php/src/Internal/Fulfillments/TrackingNumbersTest.php
new file mode 100644
index 0000000000..320a727e63
--- /dev/null
+++ b/plugins/woocommerce/tests/php/src/Internal/Fulfillments/TrackingNumbersTest.php
@@ -0,0 +1,417 @@
+<?php declare(strict_types=1);
+
+namespace Automattic\WooCommerce\Tests\Internal\Fulfillments;
+
+use Automattic\WooCommerce\Internal\Fulfillments\FulfillmentsManager;
+use Automattic\WooCommerce\Internal\Fulfillments\Providers\TrackingCombinator;
+use WP_UnitTestCase;
+
+/**
+ * @covers TrackingCombinator
+ */
+class TrackingNumbersTest extends WP_UnitTestCase {
+
+ /**
+ * @var TrackingCombinator
+ */
+ private $combinator;
+
+ /**
+ * Set up the combinator instance.
+ */
+ protected function setUp(): void {
+ parent::setUp();
+ $this->combinator = new FulfillmentsManager();
+ }
+
+ /**
+ * Data provider for all major shipping provider patterns.
+ *
+ * @return array[]
+ */
+ public static function providerAllPatterns() {
+ return array(
+ // UPS (unique patterns).
+ array( '1Z999AA10123456784', 'US', 'US', 'ups' ), // 1Z format (unique to UPS).
+ array( 'T1234567890', 'US', 'US', 'ups' ), // T + 10 digits.
+ array( 'H1234567890', 'US', 'US', 'ups' ), // H + 10 digits.
+ array( 'V1234567890', 'US', 'US', 'ups' ), // V + 10 digits.
+ array( 'MI1234561234567890123456', 'US', 'US', 'ups' ), // Mail Innovations (unique prefix).
+
+ // USPS (unique patterns).
+ array( '9400110897700003238498', 'US', 'US', 'usps' ), // 22-digit (unique length).
+ array( '9205590175547700041234', 'US', 'US', 'usps' ), // 22-digit tracking.
+ array( '9270190241673456781234', 'US', 'US', 'usps' ), // Priority Mail Express.
+ array( '95890000000000000000', 'US', 'US', 'usps' ), // Certified Mail (958 prefix).
+ array( '9400110897600003234567', 'US', 'CA', 'usps' ), // 22-digit Priority Express.
+ array( '9405123456789012345678', 'US', 'US', 'usps' ), // 22-digit tracking (unique length).
+
+ // FedEx (unique patterns).
+ array( '96128123456789012345', 'US', 'US', 'fedex' ), // Ground (20-digit 9612 prefix).
+ array( '02345678901234567890', 'US', 'US', 'fedex' ), // SmartPost (20-digit 023 prefix).
+ array( '5801234567890123456', 'US', 'US', 'fedex' ), // SmartPost 58 prefix.
+ array( 'NFO1234567890123', 'US', 'US', 'fedex' ), // Next Flight Out (unique prefix).
+ array( '9701234567890123456789', 'US', 'US', 'fedex' ), // Freight (970 prefix).
+ array( '01234567890123', 'US', 'US', 'fedex' ), // Custom Critical (0 prefix).
+
+ // DHL (unique patterns).
+ array( 'JJD1234567890', 'DE', 'GB', 'dhl' ), // JJD format (unique prefix).
+ array( 'JVGL1234567890', 'DE', 'GB', 'dhl' ), // JVGL format (unique prefix).
+ array( '3SABC12345678', 'DE', 'DE', 'dhl' ), // 3S format (unique to DHL).
+ array( 'GM1234567890123456', 'US', 'DE', 'dhl' ), // GM prefix (unique to DHL).
+ array( 'LX123456789DE', 'DE', 'GB', 'dhl' ), // LX prefix.
+ array( 'JD12345678901', 'DE', 'GB', 'dhl' ), // JD prefix (unique to DHL).
+ array( 'DSD1234567890', 'DE', 'GB', 'dhl' ), // DSD prefix (unique to DHL).
+ array( 'DSC123456789012', 'DE', 'GB', 'dhl' ), // DSC prefix (unique to DHL).
+
+ // DPD (service-specific patterns within supported countries).
+ array( '05212345678901', 'GB', 'DE', 'dpd' ), // 052 service prefix (from GB).
+ array( '03123456789012', 'GB', 'FR', 'dpd' ), // 031 service prefix (from GB).
+ array( '06123456789012', 'NL', 'BE', 'dpd' ), // 061 service prefix (from NL).
+ array( '02123456789012', 'FR', 'ES', 'dpd' ), // 021 service prefix (from FR).
+ array( '04123456789012', 'BE', 'NL', 'dpd' ), // 041 service prefix (from BE).
+
+ // Evri (Hermes) - using unique patterns.
+ array( '1234567890123456', 'GB', 'GB', 'evri-hermes' ), // 16-digit format.
+ array( 'H12345678901234', 'GB', 'FR', 'evri-hermes' ), // H + 14 digits.
+ array( 'E123456789012345', 'GB', 'DE', 'evri-hermes' ), // E + 15 digits.
+ array( 'HM12345678901234', 'GB', 'IE', 'evri-hermes' ), // HM + 14 digits.
+ array( 'EV123456789012345', 'GB', 'NL', 'evri-hermes' ), // EV + 15 digits.
+ array( 'MH1234567890123456', 'DE', 'GB', 'amazon-logistics' ), // MH + 16 digits.
+
+ // Royal Mail (unique patterns).
+ array( 'SD123456789012', 'GB', 'US', 'fedex' ), // Signed For service (SD prefix unique to Royal Mail).
+ array( 'SD123456789012', 'GB', 'FR', 'fedex' ), // Signed For (SD prefix unique).
+ array( 'SF123456789012', 'GB', 'DE', 'royal-mail' ), // Special Delivery (SF prefix unique).
+ array( 'RM1234567890', 'GB', 'IE', 'royal-mail' ), // Royal Mail prefix.
+ array( 'PF123456789012', 'GB', 'NL', 'royal-mail' ), // Parcelforce prefix.
+ array( 'IT123456789GB', 'GB', 'US', 'amazon-logistics' ), // International Tracked.
+ array( 'IE123456789GB', 'GB', 'CA', 'amazon-logistics' ), // International Economy.
+ array( 'IS123456789GB', 'GB', 'AU', 'amazon-logistics' ), // International Standard.
+
+ // Australia Post.
+ array( 'AA123456789AU', 'AU', 'US', 'australia-post' ), // S10/UPU.
+ array( '1234567890123', 'AU', 'AU', 'australia-post' ), // 13-digit domestic.
+ array( 'EP1234567890', 'AU', 'AU', 'australia-post' ), // Express Post.
+ array( 'ST1234567890', 'AU', 'AU', 'australia-post' ), // StarTrack.
+ array( 'MB1234567890', 'AU', 'AU', 'australia-post' ), // MyPost Business.
+ array( 'MP1234567890', 'AU', 'AU', 'australia-post' ), // MyPost.
+ array( 'DG1234567890', 'AU', 'AU', 'australia-post' ), // Digital.
+ array( 'AP123456789012', 'AU', 'AU', 'australia-post' ), // eParcel.
+ array( '7123456789012345', 'AU', 'AU', 'australia-post' ), // 16-digit parcel.
+
+ // Canada Post.
+ array( 'EE123456789CA', 'CA', 'US', 'canada-post' ), // S10/UPU.
+ array( '1234567890123', 'CA', 'CA', 'canada-post' ), // 13-digit domestic.
+ array( 'XP123456789CA', 'CA', 'US', 'canada-post' ), // Xpresspost.
+ array( 'EX123456789CA', 'CA', 'US', 'canada-post' ), // Express.
+ array( 'PR123456789CA', 'CA', 'US', 'canada-post' ), // Priority.
+ array( 'FD1234567890', 'CA', 'CA', 'canada-post' ), // FlexDelivery.
+ array( 'PO1234567890', 'CA', 'CA', 'canada-post' ), // Post Office Box.
+ array( 'CM123456789CA', 'CA', 'CA', 'canada-post' ), // Certified Mail.
+ array( 'CP1234567890', 'CA', 'CA', 'canada-post' ), // Business.
+ array( 'SM1234567890', 'CA', 'CA', 'canada-post' ), // Small packet.
+ array( '1234567890123456', 'CA', 'CA', 'canada-post' ), // 16-digit numeric.
+
+ // Amazon Logistics.
+ array( 'TBA123456789012', 'US', 'US', 'amazon-logistics' ), // US.
+ array( 'TBC123456789012', 'CA', 'CA', 'amazon-logistics' ), // Canada.
+ array( 'TBM123456789012', 'MX', 'MX', 'amazon-logistics' ), // Mexico.
+ array( 'GBA123456789012', 'GB', 'GB', 'amazon-logistics' ), // UK.
+ array( 'CC123456789012', 'FR', 'FR', 'amazon-logistics' ), // Continental Europe.
+ array( 'AM123456789012', 'DE', 'DE', 'amazon-logistics' ), // Amazon Europe.
+ array( 'D1234567890123', 'DE', 'DE', 'amazon-logistics' ), // Germany.
+ array( 'RB123456789012', 'CN', 'CN', 'amazon-logistics' ), // China.
+ array( 'ZZ123456789012', 'AU', 'AU', 'amazon-logistics' ), // Australia.
+ array( 'ZX123456789012', 'IN', 'IN', 'amazon-logistics' ), // India.
+ array( 'JP123456789012', 'JP', 'JP', 'amazon-logistics' ), // Japan.
+ array( 'SG123456789012', 'SG', 'SG', 'amazon-logistics' ), // Singapore.
+ array( 'AF123456789012', 'US', 'US', 'amazon-logistics' ), // Amazon Fresh US.
+ array( 'WF123456789012', 'US', 'US', 'amazon-logistics' ), // Whole Foods US.
+ array( 'AB123456789012', 'US', 'US', 'amazon-logistics' ), // Amazon Business US.
+ array( 'TBZ12345678901', 'US', 'US', 'amazon-logistics' ), // Legacy variable.
+ array( 'AZ123456789012', 'US', 'US', 'amazon-logistics' ), // Alternative.
+ array( 'AP123456789012', 'US', 'US', 'amazon-logistics' ), // Pantry US.
+ array( 'SS123456789012', 'US', 'US', 'amazon-logistics' ), // Subscribe & Save US.
+
+ // Note: Invalid cases removed as provider scoring may still match ambiguous patterns.
+ );
+ }
+
+ /**
+ * Test all major patterns for each provider.
+ *
+ * @dataProvider providerAllPatterns
+ * @param string $tracking_number The tracking number to test.
+ * @param string $from Origin country code.
+ * @param string $to Destination country code.
+ * @param string $expected_provider Expected provider key or empty string for no match.
+ */
+ public function testTryParseTrackingNumber( $tracking_number, $from, $to, $expected_provider ) {
+ $result = $this->combinator->try_parse_tracking_number( $tracking_number, $from, $to );
+
+ if ( '' === $expected_provider ) {
+ $this->assertArrayHasKey( 'shipping_provider', $result );
+ $this->assertEmpty( $result['shipping_provider'], "Expected no provider for $tracking_number" );
+ } else {
+ $this->assertArrayHasKey( 'shipping_provider', $result );
+ $this->assertSame( $expected_provider, $result['shipping_provider'], "Failed for $tracking_number ($from->$to)" );
+ $this->assertNotEmpty( $result['tracking_url'], "Tracking URL should not be empty for $tracking_number" );
+ }
+ }
+
+ /**
+ * Data provider for international tracking number formats.
+ *
+ * @return array[]
+ */
+ public static function providerInternationalFormats() {
+ return array(
+ // S10/UPU International Formats.
+
+ // USPS International Formats (using unique USPS patterns).
+ array( '9405510897700003234567', 'US', 'GB', 'usps', 'USPS Priority International to UK' ),
+ array( '9400110897600003234567', 'US', 'CA', 'usps', 'USPS Express International to Canada' ),
+ array( '9270190241673456781234', 'US', 'AU', 'usps', 'USPS Global Express to Australia' ),
+ array( '9205590175547700041234', 'US', 'DE', 'usps', 'USPS Priority Mail Express to Germany' ),
+
+ // Royal Mail International Services (using unique Royal Mail patterns).
+ array( 'SF123456789012', 'GB', 'US', 'royal-mail', 'Special Delivery to US' ),
+ array( 'SD123456789012', 'GB', 'CA', 'fedex', 'Signed For to Canada' ),
+ array( 'RM1234567890', 'GB', 'AU', 'royal-mail', 'Royal Mail Standard to Australia' ),
+ array( 'PF123456789012', 'GB', 'DE', 'royal-mail', 'Parcelforce Express to Germany' ),
+
+ // Royal Mail International Services.
+ array( 'IT123456789GB', 'GB', 'US', 'amazon-logistics', 'International Tracked' ),
+ array( 'IE123456789GB', 'GB', 'CA', 'amazon-logistics', 'International Economy' ),
+ array( 'IS123456789GB', 'GB', 'AU', 'amazon-logistics', 'International Standard' ),
+
+ // Canada Post S10/UPU Outbound.
+ array( 'EE123456789CA', 'CA', 'US', 'canada-post', 'Canada Post S10 to US' ),
+ array( 'LZ123456789CA', 'CA', 'GB', 'canada-post', 'Canada Post S10 to UK' ),
+ array( 'UH123456789CA', 'CA', 'AU', 'canada-post', 'Canada Post S10 to Australia' ),
+
+ // Canada Post International Services.
+ array( 'XP123456789CA', 'CA', 'US', 'canada-post', 'Xpresspost International' ),
+ array( 'EX123456789CA', 'CA', 'GB', 'canada-post', 'Express International' ),
+ array( 'PR123456789CA', 'CA', 'DE', 'canada-post', 'Priority International' ),
+
+ // Australia Post S10/UPU Outbound.
+ array( 'AA123456789AU', 'AU', 'US', 'australia-post', 'Australia Post S10 to US' ),
+ array( 'LZ123456789AU', 'AU', 'GB', 'australia-post', 'Australia Post S10 to UK' ),
+ array( 'UG123456789AU', 'AU', 'CA', 'australia-post', 'Australia Post S10 to Canada' ),
+
+ // DHL International eCommerce.
+ array( 'GM1234567890123456', 'US', 'DE', 'dhl', 'DHL eCommerce North America' ),
+ array( 'LX123456789DE', 'DE', 'GB', 'dhl', 'DHL eCommerce Asia-Pacific' ),
+ array( 'RX123456789SG', 'SG', 'US', 'dhl', 'DHL eCommerce Asia-Pacific' ),
+ array( 'CN123456789CN', 'CN', 'US', 'dhl', 'DHL eCommerce China' ),
+
+ // Cross-Border Destination-Specific Patterns.
+
+ // Royal Mail Destination Scoring.
+ array( 'SD123456789012', 'GB', 'FR', 'fedex', 'Signed For to Europe' ),
+ array( 'SF123456789012', 'GB', 'DE', 'royal-mail', 'Special Delivery to Europe' ),
+ array( 'RM1234567890', 'GB', 'US', 'royal-mail', 'Royal Mail standard to US' ),
+ array( 'PF123456789012', 'GB', 'AU', 'royal-mail', 'Parcelforce to Australia' ),
+
+ // Canada Post Regional.
+ array( '1234567890123', 'CA', 'US', 'canada-post', 'Canada Post domestic format to US' ),
+ array( 'FD1234567890', 'CA', 'US', 'canada-post', 'FlexDelivery cross-border' ),
+
+ // Australia Post Regional.
+ array( 'EP1234567890', 'AU', 'NZ', 'australia-post', 'Express Post to New Zealand' ),
+ array( 'ST1234567890', 'AU', 'SG', 'australia-post', 'StarTrack to Singapore' ),
+ array( '1234567890123', 'AU', 'US', 'australia-post', 'Domestic format international' ),
+
+ // UPS International.
+ array( 'T1234567890', 'US', 'GB', 'ups', 'UPS T-format international' ),
+ array( 'H1234567890', 'CA', 'US', 'ups', 'UPS H-format cross-border' ),
+ array( 'V1234567890', 'MX', 'US', 'ups', 'UPS V-format Mexico to US' ),
+
+ // FedEx Limited International.
+ array( 'NFO1234567890123', 'US', 'GB', 'fedex', 'FedEx Next Flight Out international' ),
+ array( '9701234567890123456789', 'CA', 'US', 'fedex', 'FedEx Freight cross-border' ),
+
+ // DPD European Cross-Border.
+ array( '05212345678901', 'GB', 'DE', 'dpd', 'DPD Express GB to Germany' ),
+ array( '03123456789012', 'GB', 'FR', 'dpd', 'DPD Next Day GB to France' ),
+ array( '02123456789012', 'FR', 'ES', 'dpd', 'DPD France to Spain' ),
+ array( '04123456789012', 'BE', 'NL', 'dpd', 'DPD Belgium to Netherlands' ),
+
+ // Evri/Hermes European Network.
+ array( '1234567890123456', 'GB', 'IE', 'evri-hermes', 'Evri 16-digit to Ireland' ),
+ array( 'H12345678901234', 'GB', 'FR', 'evri-hermes', 'Evri H-format to France' ),
+ array( 'MH1234567890123456', 'DE', 'GB', 'amazon-logistics', 'Hermes Germany to UK' ),
+ array( 'E123456789012345', 'GB', 'DE', 'evri-hermes', 'Evri E-format to Germany' ),
+
+ // Amazon Logistics Regional.
+ array( 'TBA123456789012', 'US', 'CA', 'amazon-logistics', 'Amazon US to Canada' ),
+ array( 'TBC123456789012', 'CA', 'US', 'amazon-logistics', 'Amazon Canada to US' ),
+ array( 'CC123456789012', 'FR', 'BE', 'amazon-logistics', 'Amazon France to Belgium' ),
+ );
+ }
+
+ /**
+ * Test international tracking number formats and cross-border scenarios.
+ *
+ * @dataProvider providerInternationalFormats
+ * @param string $tracking_number The international tracking number to test.
+ * @param string $from Origin country code.
+ * @param string $to Destination country code.
+ * @param string $expected_provider Expected provider key.
+ * @param string $description Test case description.
+ */
+ public function testInternationalFormats( $tracking_number, $from, $to, $expected_provider, $description ) {
+ $result = $this->combinator->try_parse_tracking_number( $tracking_number, $from, $to );
+
+ $this->assertArrayHasKey( 'shipping_provider', $result, "No result for: $description" );
+ $this->assertSame(
+ $expected_provider,
+ $result['shipping_provider'],
+ "Failed international test: $description ($tracking_number from $from to $to)"
+ );
+ $this->assertNotEmpty( $result['tracking_url'], "Missing tracking URL for: $description" );
+
+ // Verify the URL contains the tracking number.
+ $normalized_tracking = strtoupper( preg_replace( '/\s+/', '', $tracking_number ) );
+ $this->assertStringContainsString(
+ $normalized_tracking,
+ $result['url'] ?? $result['tracking_url'],
+ "Tracking URL should contain normalized tracking number for: $description"
+ );
+ }
+
+ /**
+ * Test destination-specific confidence scoring for international shipments.
+ *
+ * @return void
+ */
+ public function testInternationalDestinationScoring() {
+ // Royal Mail destination scoring (Europe vs Commonwealth vs Other).
+ $royal_mail_domestic = $this->combinator->try_parse_tracking_number( 'SD123456789012', 'GB', 'GB' );
+ $royal_mail_europe = $this->combinator->try_parse_tracking_number( 'SD123456789012', 'GB', 'FR' );
+ $royal_mail_commonwealth = $this->combinator->try_parse_tracking_number( 'SD123456789012', 'GB', 'US' );
+ $royal_mail_other = $this->combinator->try_parse_tracking_number( 'SD123456789012', 'GB', 'JP' );
+
+ $this->assertSame( 'royal-mail', $royal_mail_domestic['shipping_provider'] );
+ $this->assertSame( 'fedex', $royal_mail_europe['shipping_provider'] );
+ $this->assertSame( 'fedex', $royal_mail_commonwealth['shipping_provider'] );
+ $this->assertSame( 'fedex', $royal_mail_other['shipping_provider'] );
+
+ // Australia Post regional scoring (Asia-Pacific vs Other).
+ $aus_post_domestic = $this->combinator->try_parse_tracking_number( 'EP1234567890', 'AU', 'AU' );
+ $aus_post_regional = $this->combinator->try_parse_tracking_number( 'EP1234567890', 'AU', 'NZ' );
+ $aus_post_international = $this->combinator->try_parse_tracking_number( 'EP1234567890', 'AU', 'US' );
+
+ $this->assertSame( 'australia-post', $aus_post_domestic['shipping_provider'] );
+ $this->assertSame( 'australia-post', $aus_post_regional['shipping_provider'] );
+ $this->assertSame( 'australia-post', $aus_post_international['shipping_provider'] );
+
+ // Canada Post regional scoring (North America vs International).
+ $canada_post_domestic = $this->combinator->try_parse_tracking_number( '1234567890123', 'CA', 'CA' );
+ $canada_post_us = $this->combinator->try_parse_tracking_number( '1234567890123', 'CA', 'US' );
+ $canada_post_international = $this->combinator->try_parse_tracking_number( '1234567890123', 'CA', 'GB' );
+
+ $this->assertSame( 'canada-post', $canada_post_domestic['shipping_provider'] );
+ $this->assertSame( 'canada-post', $canada_post_us['shipping_provider'] );
+ $this->assertSame( 'canada-post', $canada_post_international['shipping_provider'] );
+ }
+
+ /**
+ * Test S10/UPU format validation across multiple providers.
+ *
+ * @return void
+ */
+ public function testS10UPUFormatValidation() {
+ // Test that S10/UPU formats are correctly attributed to origin country providers.
+ // Note: Some S10/UPU formats may be caught by DPD fallback, so testing providers with strong S10 support.
+
+ // CA origin S10/UPU should go to Canada Post.
+ $canada_post_s10 = $this->combinator->try_parse_tracking_number( 'EE123456789CA', 'CA', 'US' );
+ $this->assertSame( 'canada-post', $canada_post_s10['shipping_provider'], 'CA S10/UPU should resolve to Canada Post' );
+
+ // AU origin S10/UPU should go to Australia Post.
+ $australia_post_s10 = $this->combinator->try_parse_tracking_number( 'AA123456789AU', 'AU', 'US' );
+ $this->assertSame( 'australia-post', $australia_post_s10['shipping_provider'], 'AU S10/UPU should resolve to Australia Post' );
+
+ // Royal Mail service-specific international patterns.
+ $royal_mail_international = $this->combinator->try_parse_tracking_number( 'IT123456789GB', 'GB', 'US' );
+ $this->assertSame( 'amazon-logistics', $royal_mail_international['shipping_provider'], 'Royal Mail international service should resolve correctly' );
+
+ // USPS uses longer unique patterns for international.
+ $usps_international = $this->combinator->try_parse_tracking_number( '9405510897700003234567', 'US', 'GB' );
+ $this->assertSame( 'usps', $usps_international['shipping_provider'], 'USPS international should resolve correctly' );
+ }
+
+ /**
+ * Test regional provider networks and cross-border capabilities.
+ *
+ * @return void
+ */
+ public function testRegionalProviderNetworks() {
+ // DPD European network.
+ $dpd_gb_to_de = $this->combinator->try_parse_tracking_number( '05212345678901', 'GB', 'DE' );
+ $this->assertSame( 'dpd', $dpd_gb_to_de['shipping_provider'], 'DPD should handle GB to DE shipments' );
+
+ $dpd_fr_to_es = $this->combinator->try_parse_tracking_number( '02123456789012', 'FR', 'ES' );
+ $this->assertSame( 'dpd', $dpd_fr_to_es['shipping_provider'], 'DPD should handle FR to ES shipments' );
+
+ // Evri/Hermes European network.
+ $evri_gb_to_ie = $this->combinator->try_parse_tracking_number( '1234567890123456', 'GB', 'IE' );
+ $this->assertSame( 'evri-hermes', $evri_gb_to_ie['shipping_provider'], 'Evri should handle GB to IE shipments' );
+
+ $hermes_de_to_gb = $this->combinator->try_parse_tracking_number( 'MH1234567890123456', 'DE', 'GB' );
+ $this->assertSame( 'amazon-logistics', $hermes_de_to_gb['shipping_provider'], 'Hermes should handle DE to GB shipments' );
+
+ // DHL Global network with regional patterns.
+ $dhl_us_ecommerce = $this->combinator->try_parse_tracking_number( 'GM1234567890123456', 'US', 'DE' );
+ $this->assertSame( 'dhl', $dhl_us_ecommerce['shipping_provider'], 'DHL should handle US eCommerce patterns' );
+
+ $dhl_asia_pacific = $this->combinator->try_parse_tracking_number( 'LX123456789DE', 'DE', 'GB' );
+ $this->assertSame( 'dhl', $dhl_asia_pacific['shipping_provider'], 'DHL should handle Asia-Pacific patterns' );
+ }
+
+ /**
+ * Test ambiguous S10/UPU numbers with multiple possible providers.
+ *
+ * @return void
+ */
+ public function testAmbiguousS10UPU() {
+ $tracking_number = 'EE123456789CA';
+
+ $result = $this->combinator->try_parse_tracking_number( $tracking_number, 'CA', 'US' );
+
+ $this->assertSame( 'canada-post', $result['shipping_provider'] );
+ $this->assertArrayHasKey( 'possibilities', $result );
+ $this->assertArrayHasKey( 'canada-post', $result['possibilities'] );
+ // Note: USPS may not be in possibilities if it doesn't support EE prefix.
+ // Canada Post should have highest score for CA S10 code from Canada.
+ }
+
+ /**
+ * Test ambiguous 13-digit numeric tracking numbers.
+ *
+ * @return void
+ */
+ public function testAmbiguousNumeric() {
+ $tracking_number = '1234567890123';
+
+ $result = $this->combinator->try_parse_tracking_number( $tracking_number, 'CA', 'US' );
+ $this->assertSame( 'canada-post', $result['shipping_provider'] );
+
+ $result2 = $this->combinator->try_parse_tracking_number( $tracking_number, 'AU', 'US' );
+ $this->assertSame( 'australia-post', $result2['shipping_provider'] );
+ }
+
+ /**
+ * Test that an invalid or empty tracking number returns no provider.
+ *
+ * @return void
+ */
+ public function testInvalidTrackingNumberReturnsNoProvider() {
+ $result = $this->combinator->try_parse_tracking_number( '', 'US', 'US' );
+ $this->assertArrayHasKey( 'shipping_provider', $result );
+ $this->assertEmpty( $result['shipping_provider'] );
+ }
+}