Others

Setup EPMS

17min

Overview & Purpose:

A print MIS stands as the support system for any printing solution. Understanding this OnPrintShop strongly recommends you integrate EPMS with your web store. EPMS consists of different production modules such as Inventory Control, Finished Goods Inventory, Purchasing, Job Costing, Shop Floor Data Collection, Scheduling, and Shipping. These modules enhance decision-making powers, increase productivity, and give a smooth workflow.

How to integrate:

Follow the below systematic guideline to setup EPMS in your OnPrintShop Web store -

1. Create an EPMS account

  • Visit the EPMS site and create a new account.

2. Configuration in Admin Panel

On your Admin Panel, go to the Store configurations >> External Service Settings >> Accounting tab >> EPMS >> ‘‘Edit’ Option:

Document image

  • Enter the EPMS Username and password.
  • URL: The URL you will receive from the EPMS side.
  • Order No. All the orders post the order number entered here, will be synced between the platforms. For example, if you have entered 100 here then, all the orders after order number 100 will be synced.
  • Customer Account: The name entered here will be considered for assigning new customers to this account.
  • Restrict FinGoodCode: If you want to restrict the FinGoodCode within the order product then you can enable this setting.
  • Job Description: If you want to add some description with the order job, then you mention that here. When this space is left blank, then the system will take the default job description set (OnPrintShop Order #ordernumber).
  • Sync PO Number: Enable this setting, if you want to sync the order PO number between the platforms.
  • Refer from: In this setting, you need to select the location from which the userdefined fields (extra fields) will be considered i.e. from the mapping section or the option.
    • When you select to refer to the fields from the option, you need to have product options created in the OnPrintShop system.
    • From the Admin Panel >> Products >> Product Options screen, click on the Add button.
    • For the options created in the EPMS, you need to create the same option here with an internal title for reference. To map the options, you have to enter the option key as "e_rush".
    • Similar to the option key, the attribute key will have "e_rush" as a prefix and the attribute value after that for the sync.
Document image

  • Once synced, the data will be shared within the component tag of the XML Schema: <component> <Rush>2</Rush>
    • Here, there will be the open and close tags for the option with the attribute selected in the order product.
  • Along with this, you can also push Post Press Process information by entering the details such as Process Code, and Repetitions in the Product Information field of the Product Settings section.
  • Customer Billing Info: If you want to sync the customer's billing information into EPMS order fields, then enable this setting.
  • Sync Order Status: Select the order statuses for which you want to enable the automatic synchronization from OnPrintShop to EPMS.

Kindly note that this setting is applicable only when the auto-synchronization mode is ON.

  • Update Order Status: Select the order statuses for which you would like to allow the status updates from EPMS to OnPrintShop.
  • Stock Management: Enable this option to manage EPMS stock. Once enable it and click on the save button, the Material Code Mapping button will appear under the Sync Summary section.
  • Log/Stock Status Update Info: Enable this setting, if you want to log the details of stock sync and order status updates.

3. Order Level Field Mapping

Now, let's move forward and map the OnprintShop fields with the EPMS tags.

Create Extra Fields/Store Fields:

  • For Default Store customer, create extra fields from the Admin Panel >> Customers >> Website Customers >> Extra fields >> Create
  • For the store customer, create store fields from the Admin Panel >> Store Management >> Store Profile >> Add. For example, if you want to map "CustAccount" to the extra field OR in the Store Profile then enter the field name as "CustAccount". The field name should match the EPMS Tags.

Note: Make sure the "Field name" in Extra Field OR Store Profile is the same as the EPMS Tags.

Map Fields

To map the fields, go to the Admin Panel >> Store configurations >> External Service Settings >> EPMS >> ‘Action’ Dropdown >> ‘Edit’ Option

  • Map the created field with EPMS Tags:
Document image


4. Product-level Default values

You can also define product-specific field’s default values in EPMS. For this, go to the Admin Panel >> Store configurations >> External Service Settings >> EPMS >> ‘Action’ Dropdown >> ‘Edit’ Option >> Sync Summary >> Product Mapping >> Select User Type and Specific product:

Document image


5. Material Code Mapping

For mapping, the "Material Code" generated on the EPMS side will be used to establish a connection between Onprintshop and EPMS.

The Material code can be defined based on the product sizes and the Sizes can be managed from the 'Edit Designer Option' action in the product listing.

For the automatic Order Status update and Stock update, the automation setup should be enabled from the technical side.

To enable the automation, kindly contact OnPrintShop technical support.

To add the material code, click on the Material Code Mapping button under the Sync Summary section:

Document image


Clicking on the Material Code Mapping button will redirect you to the Manage Material Coding page:

Document image

  • To add a material code, choose the product from the select option for which a material code needs to be added. (Note: Only products with enabled stock will be listed in the product select option.)
  • After selecting the product, the table below will list all the sizes associated with the selected product. Enter the material code in the input field corresponding to the size, and click the save button to save the material code for that particular size to the selected product.
  • If you want to add Material Code for the Size with Product Option combination instead of just the product size, you just need to enable the "Refer from SKU" setting and the system will consider the SKU mentioned under the Products SKU section.

When enabling the Refer from SKU option, ensure that the details are saved. After saving, the system will delete all the existing material codes for the selected product. Additionally, ensure that the stock is added according to the configuration you are using (e.g., Only Size, Refer from SKU).

  • Admin can also delete the material code for a specific product from the Delete action button (i.e. Will delete all the material code associated with that product.)
  • This material code will be utilized as a mapping reference between EPMS and Onprintshop.

For updating Stock in OnPrintShop using Material Code

  • Utilize the API "GetInventoryStatus" to retrieve the stock information for a specific product size using its mapped material code.
  • Iterate through each material code to retrieve its stock information from the API response.
  • Upon obtaining the stock details, update the stock information in the OnPrintShop to reflect the current stock accurately.

For updating Order Status in OnPrintShop

  • Utilize the API "GetSummaryJobStatus" to retrieve the EPMS job status of the sent job number.
  • Fetch all orders except those marked as complete from the OnPrintShop.
  • Validate the status of each retrieved order in the EPMS, cross-referencing with OnPrintShop data.
  • Update the order status in the OnPrintShop with the current status fetched from the EPMS, maintaining consistency across systems.

Note: We will only update the order status in OnPrintShop if the current OnPrintShop order status differs from the EPMS order status. If they are the same, no update will be made in OnPrintShop.

For Updating Tracking Numberin OPS :

  • Utilize the API "GetJobShippingStatus" to retrieve the tracking number information.
  • Send an EPMS job number in the request and receive the tracking number in response.
  • The response will include shipment/package details; extract the tracking number from the first package.
  • Update the tracking number in OnPrintShop for the order associated with the sent job number. The tracking number will be updated alongside the order status in OnPrintShop. It will only be updated if received from EPMS.

Note: The tracking number will be updated alongside the order status in OnPrintShop. It will only be updated if received from EPMS.

6. Create a Remote Folder for all Files

Before we sync the orders, the system needs a folder location where the order's print-ready files can be transferred.

For this, you need to configure an FTP folder location from the OPS Admin Panel >> Order >> Export/API Orders >> Export/API Settings >> Hot Folder Settings tab:

Document image


Once you have entered all the details, you can test the connection using the Test Connection button.

7. Get Order Sync and Log report

You can manually synchronize the orders from OnPrintShop to the EPMS system.

For this, go to the Admin Panel >> Store configurations >> External Service Settings >> EPMS >> ‘Action’ Dropdown >> ‘Edit’ Option:

Document image

  • Click on the Click Here to Sync Manually button.

To automatically synchronize the orders, contact the technical team and they will help you in enabling automated sync.

You can check the logs by clicking on the Epms Log button from the Admin Panel >> Store Configurations >> External Service Settings >> EPMS >> 'Action' Dropdown >> 'Edit' Option screen.