Note: Installation, Configuration and Support for any Magento Extensions will be provided by your Magento Partner.

The following information is being provided to help properly configure this extension so that orders will import properly into Counterpoint.


Mageworx Magento 2 Advanced Product Options Suite can be used to add complex product options for additional item detail, as well as adding or changing SKUs based on the options selected.

More information including the user guide can be found here: https://www.mageworx.com/magento-2-advanced-product-options-suite.html


Commerce5 does not upload or configure Magento product options.  These must be configured manually in Magento.


Basic Product Options


    This extension can be used as a replacement for standard Magento product options, with an added benefit of having options templates that can be bulk assigned to items, or the ability to copy options from another item.

If using Configurable products, the options only need to be applied to the configurable parent item and not every simple associated child item.


   


The options selected are saved to the order, and are visible in the order emails:


   


By default, Commerce5 will import these options into an order note, with a Note ID of "PRODUCTOPTIONS"



Your Counterpoint partner can assist adding notes to custom forms, invoices, etc. in Counterpoint - They are not displayed by automatically and require customization.


Product options will also be imported per-line item to the following custom database fields, if they exist.

It will be the responsibility of your Counterpoint partner to make changes to the database, or to use the data saved in them with other Counterpoint customizations.

More information can be found here


PS_DOC_LIN_EXT

  • USR_MAGE_PROD_OPTION
    • Raw Production Option Data for the specific line item
    • EX:   

* Embroidery Line 1

    Spelling Bee Champions

  * Event Deadline

    8/13/2018 10:00:00 AM


  • USR_MAGE_PROD_OPTION_XML
    • Product Option Data in XML format for the specific line item
    • EX: 

<options><EmbroideryLine1>Spelling Bee Champions</EmbroideryLine1><EventDeadline>8/13/2018 10:00:00 AM</EventDeadline></options>


  • USR_MAGE_PROD_OPTION_JSON
    • Product Option Data in JSON format for the specific line item
    • EX: 

{"options":[{"Embroidery Line 1":"Spelling Bee Champions"},{"Event Deadline":"8\/13\/2018 10:00:00 AM"}]}


Magento product options using this configuration can alter the price of an item, but will not add additional SKUs to the item as a result.


While most product option types are supported, changes to the extension or the use of very complex product options may result in unexpected results.

Custom options should always be tested and verified in Counterpoint before applying to production. 

The Mageworx extension is not a Red Rook extension and therefore not covered by the Commerce5 support terms or agreement to purchase.




SKU Policy Product Options


Traditional Magento product option SKU settings only append options to the primary item SKU which is not compatible with Commerce5.

Magento 2 Advanced Product Options, offers this functionality as well, but also includes independent or replacement SKU policies which are compatible with Commerce5 and Counterpoint.


SKU Policy must be enabled in the extension before this can be used, by going to Stores / Configuration / Mageworx / Advanced Product Options / Option SKU Policy



Here a default SKU policy can also be configured, which will be used when not overridden by the options template or item specific options.  




The standard SKU policy option is not compatible with Commerce5.  Commerce5 requires that SKUs exist in Counterpoint, and the dynamic SKU generated by this feature will not be compatible.


The disabled SKU policy will not add or modify any additional SKUs to an order depending on the options, and will be treated like standard product options.


The replacement SKU policy will overwrite the original item SKU selected and replace it with the options SKU.


The independent SKU policy is the most often used configuration, which adds additional line items to an order depending on the options selected.

Each line item can be released and inventory tracked separately in Counterpoint, similar to a tag along kit.


The grouped SKU policy will remove the parent item SKU and only add option SKUs to an order, otherwise similar to the independent policy.




*At this time, Advanced product options cannot be applied to Configurable products.  A defect in the Mageworx extension uses a different SKU when saving the order than standard Magento.

This violates Commerce5 data integrity and orders with the new configurable SKU will be rejected for import. (Last checked: 8/7/2018)


*At this time, SKU policy options cannot add a Configurable product SKU - only simple products can be added.  

Using a configurable product SKU for an option will result in no additional SKUs being added to an order. (Last checked: 8/7/2018)



Below is an example of a functioning independent SKU policy to add a simple item SKU to an order, when another simple item is purchased and the product option is used.




As seen on the product page:



And when the order is placed, the option SKU is successfully added as an independent line item:




For comparison, the standard SKU policy below appends the option SKU - instead of adding another line item.  The SKU format below is not compatible with Commerce5.



It is important to test your SKU policy by placing test orders and verifying they work properly in Counterpoint, before applying SKU policies to website items in bulk.


Utilizing the Mageworx Magento 2 Advanced Product Options Suite extends functionality of your website by allowing customers to personalize items, customize product bundles, and purchase up sell items.



Note: Installation, Configuration and Support for any Magento Extensions will be provided by your Magento Partner.

The following information is being provided to help properly configure this extension so that orders will import properly into Counterpoint.