Fenix <> SFCC Implementation Guide - 1.0

Get the Fenix SFCC Cartridge Code

The Fenix onboarding team will share the cartridges zip along with documentation. Please get in touch with fixdsupport@fenixcommerce.ai

Upload the cartridges

Upload the cartridges The 'fenix_sfra_changes', 'int_fenix_sfra', 'int_fenix_core' & 'bm_fenix' from the received zip from Fenix onboarding team to the current code version along with all other cartridges.

Configuration

Site Cartridge path

Add the ‘fenix_sfra_changes’, ‘int_fenix_sfra’ & ‘int_fenix_core’ cartridges to the Storefront Cartridge path at the following location:

BM Cartridge path

Add the ‘bm_fenix’ Cartridge to the Business Manager Cartridge path. To use the Jobs in the link cartridge, the Business Manager cartridge path needs to be updated to include this cartridge name ‘bm_fenix’. This is done at the following location.

Metadata Import

To use the Fenix Intelligent Delivery Platform, we need to import the site metadata. This is done at the following location:

Steps are below:

• From the cartridge zip received, zip the folder “Fenix_Intelligent_Delivery_Platform“ under metadata folder to create a zip file “Fenix_Intelligent_Delivery_Platform.zip“

• In BM, navigate to Administration > Site Development > Site Import & Export.

• Under “Import”, click Choose File.

• Select and Upload “Fenix_Intelligent_Delivery_Platform.zip” from the Metadata directory in the Link Cartridge.

• Click Upload.

• Now select the radio button next to “Fenix_Intelligent_Delivery_Platform.zip”.

• Click Import to validate the import file.

• Click “OK” to confirm the Import.

Assign values to Site Preferences

After selecting the site, you assign the value to the site preference. This is done at the following location:

Find the Site Preference Grouping titled “Fenix_Communications” and assign values to the text fields that was provided by Fenix. All the required site preferences are below:

Services, Profiles, and Credentials for pre and post purchase integration

Services created during the setup process

Service credentials configuration

• Assign Values To “FenixIntelligentDelivery.get.http” Service

  • From Path: Administration >  Operations > Services

  • Go to Tab “Credentials”.

  • Click FenixIntelligentDelivery.get.cred to edit the credentials.

  • Give the following parameters:

    • Name: FenixIntelligentDelivery.get.cred

    • URL: <<End point URL of Fenix>>

    • User: empty

    • Password: empty

  • Click Apply.

• Assign Values To “FenixIntelligentDelivery.push.sftp” Service Credentials

  • From Path : Administration > Operations > Services

  • Go to Tab “Credentials.”

  • Click FenixIntelligentDelivery.push.cred to edit the credentials.

  • Give the following parameters:

    • Name: FenixIntelligentDelivery.get.cred

    • URL: <<Fenix Provided Endpoint URL>>

    • User: <<Fenix Provided User Name>>

    • Password: << Fenix Provided Password >>

• Similarly, do the same exercise for Service Credentials if the site is enabled for post-purchase Fenix integration.

  • “FenixIntelligentDelivery.push.auth.cred”

  • “FenixIntelligentDelivery.push.orders.cred”

  • “FenixIntelligentDelivery.push.fulfillment.cred”

Here

Fenix Intelligent Delivery Export Job

Assign values to Job steps. Follow these steps to assign value to Export Job Definition. This is done at the following location.

• Click Job Steps.

• For “Site Specific Catalog Export” & “Site Specific Inventory Export”.

  • Click Organization.

  • Select scope - Specific Sites and select storefront to export.

  • Click Assign.

  • Do this for both Catalog and Inventory

• Click Job Step “Sites Upload Feeds“

  • Update “ProductDir” to Fenix Provided Directory.

  • Update “InventoryDir” to Fenix Provided Directory.

  • Click Assign.

• Click Run Now or setup a “Schedule” to connect.

Fenix Intelligent Order Export Job

Order can be sent to Fenix systems at the time of order placement. For this, a hook needs to be implemented as below.

{
      "name": "app.post.auth",
      "script": "./cartridge/scripts/hooks/fenix/sendOrder.js"
}

This hook is already called in SFRA out of the box in the file CheckoutServices.js. For any failed order export to Fenix or clients who do not want to send the orders at the time of order placement, the following job will be responsible for sending those orders to the Fenix database.

Assign values to Job steps. Follow these steps to assign value to Export Job Definition. This is done at the following location.

Click Run Now or setup a “Schedule” to connect.

Fenix Intelligent Fulfillment Export Job

For sending the fulfillment details to the Fenix database, the following hook must be implemented in all the custom events, and flows must be implemented where the order/shipment objects are updated.

var sendFulfilmentResult = hooksHelper('app.fenix.send.fulfilment', 'sendFulfilment', order, finalShipment, null);

Where order represents the SFCC order object, and finalShipment represents the updated shipment.

For manually triggering this flow, i.e., testing the flow for sending fulfillment data, Job “Fenix Intelligent - Send Fulfillment - Test Job” is added to the meta folder where the order id and shipment id are passed to the job step.

Assign values to Job steps. Follow these steps to assign value to Export Job Definition. This is done at the following location.

Click Run Now or setup a “Schedule” to connect.