Zenkraft Settings and Advanced Guide
This guide will show you the new Zenkraft Settings (v1.114 and below or v1.129 and above) or Bringg Settings (v1.118-v1.128) pages and what the Advanced settings are.
Zenkraft Settings/Bringg Settings
From v1.114 we re-designed our Zenkraft Settings/Bringg Settings pages to provide a more seamless customer experience when it comes to setting up and customizing the Multi-Carrier application, or even contacting our Support team. Once changes are made on the individual pages you can save them at the top.
NOTE: that many of the below listed functionalities can be found in the previous versions as well.
General Settings
These are general settings related to the application, like updating your license or creating a test shipping preference.
My Account
You can view your current license usage and update it, for example if you purchase more user or carrier licenses.
Demo Mode
Demo mode allows you to interact with the shipping carrier's test servers. You can turn demo mode on or off using this toggle.
Test Preferences
By clicking this button once you can create a US-based test shipping preference.
Create Test Shipment Records
By clicking this button once you can create 5 sample shipments for a specific carrier.
Custom Address Source Templates
This section provides a link to our custom address source templates and our custom address source setup guide.
Tracking Settings
You can set up or modify your tracking schedules and create you branded tracking profiles.
Scheduled Tracking
For more information please refer to our scheduled tracking guide.
Branded Tracking
For more information please refer to our branded tracking guide.
Printing Settings
You can set up your printers and scales here. For more information please refer to our printing guide.
Permission Settings
You can create permission settings here. For more information refer to our permissions guide.
Other Settings
These settings were previously stored in our Custom Settings > Zenkraft General Settings or Zenkraft Other Settings. Each setting has a detailed description next to it explaining what it does.
App Config
These are settings related to the configuration and functionality of the application.
Name | Description |
---|---|
Allow Editing of Product Items | This allows you to set the products for a domestic shipment, which then allows you to create a packing slip. It also shows the products in the packages as calculated by the boxing algorithm.. |
Show Products section for domestic shipments | Set the checkbox to true to only download the first signature image that FedEx provides |
Convert non-ascii characters to ascii | Some carriers are unable to display non-ascii characters on the labels, so this setting replaces those characters with ascii versions. |
Delete Checkpoints After Delivery | Setting that allows the checkpoint records to be deleted once the shipment has been delivered. This helps you save space on the org. |
Record Printing History | Record every time a shipping label is sent to the printers. |
Record Shipping Checkpoints | Record shipping checkpoints to give you finer control of the different stages the shipment goes through. This will consume more of your Salesforce data storage limits. |
Number of Days to Track Shipments | If you are a high volume shipper, you might only want to track shipments as far back as 30 days. |
Force Update Last Track Time | Set the last track update date and time on the shipment even if no tracking number or new tracking stage was found. |
Split Street Line 1 by comma | If you have your street address all on 1 line separated by a comma. You can set this to true so that our application will automatically split that address line into 2 lines so that it doesn't hit carrier limit of 35 characters. |
Update Shipment Fields From Tracking | This allows the shipment object to update the fields such the recipient and sender address fields (except for street as its not provided by the carriers). |
Use Files | Set this to true if you are utilizing Salesforce Files as opposed to Notes and Attachments. |
Boxing Algorithm - Ignore Declared Value | Set this to true to ignore the calculated value generated by our boxing algorithm for the package declared value section. |
Pick and Pack - Enable Barcode Partial Search | Set this to true to enable barcode partial search. |
Pick and Pack - Disable Pack buttons | Set this to true to disable pack buttons if only barcode scanner should be used. |
Pick and Pack - Disable Package Declared Value | Set this to true to disable the Declared Value field. |
Split Long Recipient Street | Set this to true if you would like us to automatically try to convert a long recipient address line into two address lines. |
Split Long Sender Street | Set this to true if you would like us to automatically try to convert a long sender address line into two address lines. |
Quoting - Do not auto validate residential address | Set this to true if you do not want us to automatically set the flag if the address is residential when utilizing our quoting component. |
Boxing Algorithm - Utilize Heroku | Utilize the Boxing Algorithm via our API. Only use this if you experience issues with the boxing algorithm. Please note that this is generally slower. |
Printing - Force Duplex | If you have a PDF that you are printing that contains more than 1 page, and your printer is printing on both side you can set this to true so that we are forcing your printer to utilize 2 pages instead of printing on both sides. |
Printing - Disable Printer Tray Validation | Set this to true if you want to disable validation of Printer Tray on the Printer page. |
Number of Commercial Document Prints | Set the number of documents you want to print if they are a commercial invoice. This setting can be manged via the Manage Printers section. |
Printing - Chunk Size | Sending X labels to be printed at once. |
Printing - Delay in Milliseconds | Wait between sending X number of labels at a time. |
Printing - Mass printing, show printers | Allow the user to choose which printer to print all items with. |
Allow Guest User Access | Set this to true if your community users are having issues accessing some of the shipment objects. |
Enable editing of our Shipment object | Allows you to edit the shipment object without hitting the ModKey constraint. |
CAS - Allow View All Objects | Please turn this on for B2B and Lightning B2B to complete the Custom Address Source setup. |
Tracking - Ignore Tracking Signature Image | Set the checkbox to true to ignore the Signature. |
Tracking Page UI - use text not datetime | Set field to use for the date, so it is stored in text format. |
Manifest Success field | Checkbox to mark as checked once the shipment has been manifested successfully. (if required by the carrier). |
Email Signature - Disable | Disable the email signature from being used for sending out emails via the Email Label button and Invocable methods. |
Use Code 128 barcode | Use Code 128 barcode instead of Code 39. |
Field Set Api Name | Customize recipient search columns on wizard, please specify name of field set under Custom Object |
Enable Draft Shipment (Beta) | Allows you to save/edit the shipment as Draft |
API
These are settings related to the configuration of the API.
Carrier Specific
These are carrier specific settings.
Name | Description |
---|---|
FedEx - Force Shipment Validation | FedEx stops you shipping if there is an issue with the shipment, set this to true to force the shipment validation to be used. |
FedEx - Ignore Address Validation for Rate | FedEx stops you from rating if the address is invalid. Set this to true to force the rating to continue. |
UPS - Ignore Address Validation | UPS stops you from shipping if the address is not found on their side. Check this box to ignore this validation. |
FedEx - List Rates Only | If you don't want FedEx to show the negotiated rates then make sure this is checked. |
FedEx - Specify Account Number for Tracking | Once set to true, this ensures that we utilize the FedEx account number to track against shipments. This helps to stop duplicate shipments. |
USPS - Tracking | Set this to true if you have set up USPS Webtools and you have a user id. |
USPS - Web API UserID | Enter your USPS Webtools user id here. |
FedEx - Save POD | Set the checkbox to true to save the Proof Of Delivery. |
FedEx - Save Signature only once | Set the checkbox to true to only download the first signature image that FedEx provides. |
FedEx - Do Not Download CI | Set this checkbox value to true to not download the FedEx generated Commercial Invoice. |
FedEx - Only save master tracking | Set this to true if you do not want any child shipment records from a Multi Package Shipment to be created. |
Maximum Number of Packages to allow for each carrier | Set the number of packages you want to allow your users to create on a shipment. |
Commerce Cloud
These are commerce cloud related settings.
General Custom Settings
NOTE: valid for v1.113 and below.
Go to Setup > Custom Settings and choose the Manage next to Zenkraft General Settings,
then click on Edit.
Below is the description for each of the options.
Name | Description |
---|---|
Allow Edit of Used Custom Item | Allows you to edit the custom items objects for reuse with other shipments. |
Allow Guest User Access | If your community users are having issues accessing some of the shipment objects, turning this on should help. |
Boxing Algorithm - Show Products | This shows the results of our Boxing Algorithm calculation of which products go into which boxes. |
Convert non ascii characters for labels | Some carriers are unable to display non-ascii characters on the labels, so this setting replaces those characters with ascii versions. |
Debug ZK API Calls | This allows our support team to help investigate any issues with shipping. |
Delete Checkpoints After Delivered | Setting that allows the checkpoint records to be deleted once the shipment has been created. This helps you save space on the org. |
Disable Rate/Ship for Invalid Address | FedEx and UPS stop you from rating/shipping if the address is invalid. Check this box to force the rating/shipping to continue |
Enable Zk Api | Most carriers require this to be checked. |
Ignore Address Validation | FedEx and UPS stop you from rating/shipping if the address is invalid. Check this box to force the rating/shipping to continue |
Ignore Max Job Limit for Scheduled Track | This should be checked to enable scheduled tracking to be setup. |
Number of Commercial Document Prints | Set the number of documents you want to print if they are a commercial invoice. This setting can be manged via the Manage Printers section. |
Only Allow Validated Shipments (FedEx) | FedEx stops you shipping if the address is invalid. Check this box to force the shipment creation to continue. |
Only Show FedEx List Rates | If you don't want FedEx to use the negotiated rates then make sure this is checked. |
Record Print Histories | Record every time a shipping label is sent to the printers. |
Record Shipping Checkpoints | Record shipping checkpoints, to give you finer control of the different stages the shipment goes through. This will consume more of your salesforce data storage limits. |
Run Demo Mode | Set this to true if you are using demo accounts. |
Scheduled tracking - number of days | If you are a high volume shipper, you might only want to track shipments as far back as 30 days. |
Split Street Line 1 by comma | If you have your address street all on 1 line separated by a comma. You can set this to true so that our application will automatically split that address line into 2 lines so that it doesn't hit carrier limits of 35 characters. |
Update Shipment Fields From Tracking | This allows the shipment object to update the fields such the recipient and sender address fields (except for street as its not provided by the carriers.) |
UPS Generate Custom HazMat Document | Once set to true and you are creating HazMat shipments we utilize our in built HazMat document generator that includes all the headings. |
Use Account Number for Tracking (FedEx) | Once set to true, this ensures that we utilize the FedEx account number to track against shipments. This helps to stop duplicate shipments. |
Use Files | Set this to true if you are utilizing Salesforce Fields as opposed to Notes and Attachments |
USPS Tracking | Set this to true if you have set up USPS Webtools and you have a user id. |
USPS Web API UserID | Enter your USPS Webtools user id here |
Other Custom Settings
NOTE: valid for v1.113 and below.
Go to Setup > Custom Settings and choose the Manage next to Zenkraft Other Settings,
then click on New/Edit.
Below is the description for each of the options.
Name | Description |
---|---|
FEDEX_SAVE_POD | Set the checkbox to true to save the Proof Of Delivery |
GET_TRACKING_SIGNATURE_ONCE_ONLY | Set the checkbox to true to only download the first signature image that FedEx provides |
IGNORE_BOXING_DECLARED_VALUE | Set the checkbox to true to ignore the calculated value generated by our boxing algorithm for the package declared value section. |
SFCC_BASE_URL | Set the Base URL of your Salesforce Commerce Cloud here. |
SFCC_CLIENT_ID | Set the Client ID of your Salesforce Commerce Cloud here |
SFCC_CLIENT_PASSWORD | Set the Client Password of your Salesforce Commerce Cloud here |
SFCC_USER_PASSWORD | Set the User Password of your Salesforce Commerce Cloud here |
SFCC_USERNAME | Set the User Name of your Salesforce Commerce Cloud here |
SPLIT_LONG_RECIPIENT_STREET | Set this to true if you would like us to automatically try to convert a long recipient address line into two address lines. |
FEDEX_DO_NOT_DONWLOAD_CI | Set this checkbox value to true to not download the FedEx generated Commercial Invoice |
SPLIT_LONG_SENDER_STREET | Set this to true if you would like us to automatically try to convert a long sender address line into two address lines. |
UPS_TRACKING_SAVE_ONLY_MASTER_PACKAGE | Set this to true if you want |
ZK_DISABLE_AUTO_SET_RESIDENTIAL_QUOTE | When utilizing our quoting component, if you won't want us to automatically set if the address is residential, set this checkbox to true. |
ZKAPI_BOXING | Utilize the Boxing Algorithm via our API. Only use this if you experience issues with the boxing algorithm. |
FORCE_DUPLEX_TO_ONE_SIDED | If you have a PDF that you are printing that contains more than 1 page, and your printer is printing on both side you can set this to true so that we are forcing your printer to utilize 2 pages instead of printing on both sides. |
USE_BILADDR | If you have for example a GB UPS account, but you need to return items to NL, if your UPS account supports this, you can specify the {Preference ID}--USE_BILADDR and then mark teh checkbox as true. |
CAS_VIEW_OBJECTS | In our later versions the "View all objects" checkbox is not enabled by default. Create this checkbox value to enable. |