Site Genesis Implementatiom-1.0
- 1 Get the Fenix SFCC Cartridges
- 2 Upload the cartridges
- 3 Configuration
- 3.1 Site Cartridge path
- 3.2 BM Cartridge path
- 3.3 Metadata Import
- 3.4 Assign values to Site Preferences
- 3.5 Services, Profiles, and Credentials for pre and post purchase integration
- 3.6 Service credentials configuration
- 3.7 Fenix Intelligent Delivery Export Job
- 3.8 Fenix Intelligent Order Export Job
- 3.9 Fenix Intelligent Fulfillment Export Job
Get the Fenix SFCC Cartridges
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_sg_changes', 'int_fenix_core', 'int_fenix_controllers' & '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_sg_changes’, ‘int_fenix_core’ & ‘int_fenix_controllers’ cartridges to the Storefront Cartridge path at the following location:
Administration > Sites > Manage Sites > <<Site Name>> - Settings
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.
Administration > Sites > Manage Sites > Manage the Business Manager Site
Metadata Import
To use the Fenix Intelligent Delivery Platform, we need to import the site metadata. This is done at the following location:
Administration > Site Development > Site Import & Export
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:
Name | Type | Description | |
---|---|---|---|
1 | Fenix Enabled | Boolean | Enable / Disable all features of the Fenix Intelligent Delivery Platform |
2 | Fenix Debugging Enabled | Boolean | Enable / Disable debug features of the Fenix Intelligent Delivery Platform |
3 | Fenix Tenant Id | String | Customer Identification token provided by Fenix Communications. e.g. 768b656c974245d2a427abe356bb4bf1 |
4 | Fenix Show Ship Id | String | Business Manager Shipping ID forced to display on the Checkout shipping page. This is used for a Ground shipping method that does not have a Fenix Intelligent Delivery Platform Delivery Estimate.
|
5 | Fenix Hide Ship Id | String | Business Manager Shipping ID forced to hide on the Checkout shipping page. This is used for a Ground shipping method that does not have a Fenix Intelligent Delivery Platform Delivery Estimate.
|
6 | Fenix Inventory Threshold | Number | Threshold Used For All Products In The Inventory Feed |
7 | Fenix Inventory Location | String | Inventory Location Used For All Products In The Inventory Feed. This should be populated with the inventory list Id assigned to site. |
8 | Fenix Inventory List Ids | Set of strings | Provide all the inventory list ids of which we want to send the inventory records of products to Fenix. |
9 | Fenix Store Name | String | Fenix store name used for post purchase order API and fulfillment API |
10 | Fenix Username | String | Fenix store username used for generating post purchase auth token |
11 | Fenix Password | String | Fenix store password used for post purchase auth token |
12 | Fenix X-Api-Key | String | Fenix store X-Api-Key used for post purchase APIs - generating auth token, order and fulfillment API. |
13 | Fenix X-Identity | String | Fenix store X-Identoty used for post purchase order API and fulfillment API |
14 | Consume Fenix Shipping Cost | Boolean | Enabling this will consume the shipping cost for each shipping method from Fenix response |
15 | Show Shipping Description In New Line(Checkout) | Boolean | This will enable the display of shipping method name and description in different lines. |
Services, Profiles, and Credentials for pre and post purchase integration
Services created during the setup process
Name | Type | Description |
FenixIntelligentDelivery.get.http | Service | Service Used to “Get” Delivery Estimate From the Fenix Intelligent Delivery Platform. |
FenixIntelligentDelivery.get.prof | Profile | Profile Configuration For “Get” Service |
FenixIntelligentDelivery.get.cred | Credentials | Credentials needed to connect to the “Get” Service |
FenixIntelligentDelivery.push.sftp | Service | Service Used to “Push” Product and Inventory Feeds to the Fenix Intelligent Delivery Platform.
|
FenixIntelligentDelivery.push.prof | Profile | Profile Configuration For “Push” Service |
FenixIntelligentDelivery.push.cred | Credentials | Credentials needed to connect to the “Push” Service |
FenixIntelligentDelivery.push.auth.http | Service | Service used for generating auth token for post purchase APIs |
FenixIntelligentDelivery.push.auth.cred | Credentials | Credentials needed to connect to the auth token Service |
FenixIntelligentDelivery.push.orders.http
| Service | Service used for sending order data to Fenix systems |
FenixIntelligentDelivery.push.orders.cred | Credentials | Credentials needed to connect to the Order Service |
FenixIntelligentDelivery.push.fulfillment.http | Service | Service used for sending shipment/fulfillment data to Fenix systems |
FenixIntelligentDelivery.push.fulfillment.cred | Credentials | Credentials needed to connect to the Fulfillment Service |
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 is implemented as below.
{
"name": "app.post.auth",
"script": "./cartridge/scripts/hooks/fenix/sendOrder.js"
}
This hook is called by the following job. This job will be responsible for sending 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”
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 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”