Zenkraft Desktop printing only supports PDF and thermal (ZPL/EPL) label types

Table of Contents

  1. Download the Zenkraft Mac app 
  2. Mac terminal 
  3. Add printers 
  4. Add class 
  5. View or create a preference
  6. Manage printers
  7. Set default printers 
  8. Printing
  9. Troubleshooting

1. Download the Zenkraft Mac app

To get your Zebra Printer installed please connect the printer to the Mac and make sure the printer is turned on.

Then follow these steps below:

2. Mac terminal

   1. Open your Mac "terminal" application – you can find this under Applications > Utilities > Terminal

   2. Enter these commands (press Enter/Return) after each line. It will ask for your computer login username and password (not the salesforce printing password that we supply), that's normal. It's easiest to copy and paste so that no mistakes are made:

   3. Open Safari or a browser of your choice, and navigate to http://localhost:631 or enter http://localhost:631 into the Address Bar (you might need your computer login username and password info again).

3. Add printers

  1. Click the Printers tab

   2. If an Eltron or Zebra thermal printer is installed, delete the driver, and continue with the next step.

   3. Click the Administration tab and then click the Add Printer button

   4. Select your thermal printer from the "Local Printers" section and click the Continue button

   5. Remove pre-populated field content (if any), and complete the fields

   6. Enter a printer "Name". For example: "ZebraPrinter" for a Zebra ZP-450 or S4M, "UPSPrinter" for a UPS Thermal LP2844, "EltronPrinter" for an Eltron Thermal 2844

   7. Enter a "Description". For example: Zebra Thermal Printer, UPS Thermal Printer, Eltron Thermal Printer

   8. Enter a "Location". For example: Office, Amy’s iMac

   9. Document the location for future reference and select Continue

   10. Click the Select Another Make/Manufacturer button

   11. Allow the page to refresh and continue to the next step

   12. Select Raw as the "Make" and click the Continue button

   13. Click the Add Printer button

   14. Select Set Default Options button

   15. Click the Administration tab. For most users this is all that's needed. If you are      still having problems then you need to continue with these steps below.

4. Add class

   1. Click the Add Class button and remove pre-populated content (if any), and complete the fields.

   2. Enter a Class "Name" (Do not enter the Printer name used in a previous step. The Printer and Class name are case sensitive.) For example: "ZebraClass" for a Zebra ZP-450

   3. Enter a Class "Description". For example: Zebra Thermal Printer

   4. Enter a Class "Location". For example: Office, Amy’s iMac

   5. Select the printer from the Member’s list

   6. Click the Add Class button. A confirmation window will briefly appear, followed by the "Administration" window.

You have made it through. Well done! If you are still having problems then please message us via the live chat icon at the bottom right of this page or go to our contact us page to write us an email for more help.

5. View or create a preference

  1. Open the Shipmate Preference and click "Manage Printers"
  2. These links will take you directly to the "Manage Printers" page in Salesforce:

If you are unable to see this button then click "Edit Layout" to drag the "Manage Printers" button onto the page layout.

You are also able to access the "Manage Printers" button from Shipments View.

If this button is not available then you need to add the button to the search layout, which you can get to by going into Setup > Create > Objects > FedEx/UPS/USPS Shipment and then edit the Search Layouts > Shipment List View.

You can then add the Manage Printers button to the layout.

These links will take you directly to the respective "Shipment" object page in Salesforce:

6. Manage printers

  1. On "Manage Printers" you will see the Zenkraft Shipmate client username and password has already been generated. These are the credentials that users who need to print should will need to input onto their desktop app.
    Note: "Manage Printers" can be accessed through the Shipments tab.
  2. Open Zenkraft Shipmate application and sign in using username and password found in the previous steps.

7. Set default printers

After you successfully sign in, all printers from your computer will be available for selection on the Manage Printers page. From here you will be able to set the default printer for Thermal Shipping Labels, Non Thermal Shipping Labels, Shipping Documents. You can do this on a global, preference or user level.

  1. Thermal Printing Tab: any shipping labels that are created in ZPL or EPL format will be printed using these defaults.
  2. Non Thermal Printing: any shipping labels that are in JPEG/PNG/PDF/GIF (non thermal) will be printed using these defaults.
  3. Other Documents e.g. international documents, bills and anything else will be printed according to these defaults.

Each of these sections includes a Global, Preference and User level.

If you have a default it will override the Preference default. Selecting a preference default will override the global default.

Please let your network administrators know that the Zenkraft Print App needs to be able to connect out via port 6123.

8. Printing

Once this is all set up, you are now able to print directly from Salesforce by using the Print Labels and Documents button

If this button is missing from your Shipment object view then you need to go into Setup > Create > Object > Fedex / UPS / USPS Shipment > Page Layouts > Edit

and drag the button onto your page layout

These links will take you directly to the respective "Shipment" object page in Salesforce:

You are now able to print directly from salesforce by clicking on the Print Labels and Documents button

9. Troubleshooting

If you come across this error message when in your Mange Printers page, then there has been an upgrade issue, but its easily fixable.

Firstly, go to the FedEx/UPS/USPS app that is currently has credentials stored.

and paste these credentials into the printnode site.

After logging in, please click on the API tab at the top

and copy the API Key value.

The next step is to go into your Salesforce org, and click on Setup > Develop > Visualforce Pages and look for the Label called PrintServiceAdministration, and click on the little icon to the left hand side of it. Please be sure that you are editing the correct one. The Namespace Prefix tells you which app (FedEx/UPS/USPS) you are making the modification for.

These links will take you directly to the respective "Shipment" object page in Salesforce:

You will then be able to add the API Key you copied previously into this input field here

Click "Save" and your error message will now have disappeared from the Manage Printers page

Did this answer your question?