Fenix <> SFCC Implementation Guide - 1.0

Delivery Estimates

Fenix SFCC Cartridge Code

• The Fenix onboarding team will share the cartridge zip. Please get in touch with fixdsupport@fenixcommerce.ai

Setup

Include Link Cartridge

• The ‘int_fenix_sfra,’ ‘int_fenix_core’ & ‘bm_fenix’ Cartridges need to be uploaded to the current code version along with all other cartridges.

Configuration

Cartridge path

• Add the ‘fenix_sfra_changes’, ‘int_fenix_sfra’ & ‘int_fenix_core’ Cartridges to the Storefront Cartridge path

  • To use the link cartridge, the site cartridge path needs to be updated to include this cartridge names ‘fenix_sfra_changes’, ‘int_fenix_sfra’ & ‘int_fenix_core’. This is done at the following location:

• 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

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

Site Imports

Setup Site Specific Preferences

• Site Preferences created during the setup process:

Service Profile and Service Creds

• Similarly, do the same exercise for Service Credentials

  1. “FenixIntelligentDelivery.push.auth.cred”,

  2. “FenixIntelligentDelivery.push.orders.cred”

  3. “FenixIntelligentDelivery.push.fulfillment.cred”

if the site is enabled for post-purchase Fenix integration.

FenixIntelligentDelivery.push.orders.cred

FenixIntelligentDelivery.push.fulfillment.cred

FenixIntelligentDelivery.push.fulfillment.cred

Assign Values To “FenixIntelligentDelivery.push” Service Credentials

1. Go to Tab “Credentials.”

2. Click

FenixIntelligentDelivery.push.cred to edit the credentials.

1. Give the following parameters:

Name: FenixIntelligentDelivery.get.cred

URL: <<Fenix Provided Endpoint URL>>

User: <<Fenix Provided User Name>>

Password: << Fenix Provided Password >>

Services, Profiles, and Credentials Setup

Services created during the setup process

Fenix Intelligent Delivery Export Job

To use Salesforce B2C box Service Framework, you’ll need to configure the Export Job.

• Assign Values To Job Steps

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

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 final shipment 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.

Next