| Table of Contents | ||||
|---|---|---|---|---|
|
Delivery Estimates
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:
| Tip |
|---|
Administration > Sites > Manage Sites > <<Site Name>> - Settings |
...
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.
| Tip |
|---|
Administration > Sites > Manage Sites > Manage the Business Manager Site |
...
Metadata
To use the Fenix Intelligent Delivery Platform, we need to create and import the site metadata. This is done at the following location:
| Tip |
|---|
Administration > Site Development > Site Import & Export |
...
Site Imports
| Info |
|---|
Upload Fenix Intelligent Delivery Platform Meta File
|
...
| Info |
|---|
Assign Value to Site PreferenceAfter selecting the site, you assign the value to the site preference. This is done at the following location:
|
Setup Site Specific Preferences
Site Preferences created during the setup process:
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 |
| 8 | Fenix Store Name | String | Fenix store name used for post purchase order API and fulfillment API |
| 9 | Fenix Username | String | Fenix store username used for generating post purchase auth token |
| 10 | Fenix Password | String | Fenix store password used for post purchase auth token |
| 11 | Fenix X-Api-Key | String | Fenix store X-Api-Key used for post purchase APIs - generating auth token, order and fulfillment API. |
| 12 | Fenix X-Identity | String | Fenix store X-Identoty used for post purchase order API and fulfillment API |
Service Profile and Service Creds
| Info |
|---|
Assign Values To “FenixIntelligentDelivery.get” Service Credentials
Name: FenixIntelligentDelivery.get.cred URL: <<End point URL of Fenix>> User: empty Password: empty
|
...
Similarly, do the same exercise for Service Credentials
“FenixIntelligentDelivery.push.auth.cred”,
“FenixIntelligentDelivery.push.orders.cred”
“FenixIntelligentDelivery.push.fulfillment.cred”
if the site is enabled for post-purchase Fenix integration.
| Panel | ||||||
|---|---|---|---|---|---|---|
| ||||||
Note {order_id} is dynamic order id in the URLs and {fulfillment_id} is dynamic shipment/fulfillment id in the URLs. Example below: https://platform.api.fenixcommerce.com/sfcccartridge/fenixppdenterpriseinbound/api/v1/orders/{order_id}/fulfillment/{fulfillment_id}/created |
FenixIntelligentDelivery.push.orders.cred
...
FenixIntelligentDelivery.push.fulfillment.cred
...
FenixIntelligentDelivery.push.fulfillment.cred
Assign Values To “FenixIntelligentDelivery.push” Service Credentials
| Info |
|---|
From Path : Administration > Operations > Services |
Go to Tab “Credentials.”
Click
...
Password: << Fenix Provided Password >>
...
Services, Profiles, and Credentials Setup
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 |
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.
| Tip |
|---|
Administration > Operations > Jobs : Fenix Intelligent Delivery Export |
...
| Tip |
|---|
Click Organization. Click Store Front to export. Click Assign.
|
...
| Tip |
|---|
|
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.
...
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.
| Tip |
|---|
Administration > Operations > Jobs : Fenix Intelligent - Send Orders |
...
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.
...
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:
...