• Integration - HP Site Flow

PRESSERO > *Integration information & Supported Services

HP SiteFlow

 

Features:

  • Order Synchronization
  • Manual Order Status Synchronization: Requires to access the Site Settings page and click on the Synchronize button
  • Orders Status Synchronization With Webhooks: You can Enable Site Flow to update orders status on Pressero using Site Flow Webhooks Service 

To Enable HP SiteFlow, you need to enable the Pressero connector on your HP PrintOS account, for information on how to enable this connector, please contact PrintOS support team, after that you will need the following information to configure on Pressero:

  • Access Key: You can get this information on PrintOS user account information -> Partner Keys, find the API with permission to CreateAndQuery
  • Secret: You can get this information on PrintOS user account information -> Partner Keys, find the API with permission to CreateAndQuery
  • Destination: This is the Customer ID on PrintOS, to get this information try to create an order on HP SiteFlow and get the customerID that will be shown there
  • Server: Staging, for test, and Production
  • Non-Integrated Shipping Name: When using Non-Integrated Shipping Methods this will be the Carrier that name that will be used with HP Site Flow

After settings these parameters the integration will be available to be activated on the site settings, for more information on how the synchronization works, please check the Embedded Services configuration KB article.

 

 

HP SiteFlow requires a few parameters to be configured at product level and shipping.

 

How to Get Destination ID:

 

The destination is the customer name on HP Site Flow, to get this name, on HP Site Flow, click on the Orders Tab and then on the + button.

 

 

The application will then show the order creation UI and there the customer name will be visible.

 

 

Product

 

It's required that you make a mapping on Pressero, this mapping is made by associating the product Product Code (SKU) from HP SiteFlow to the Pressero Product Integration ID, this information must be exactly as shown on SiteFlow site since the integration is case sensitive.

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

HP SiteFlow has a Component requirement, on Pressero this translates to the upload fields, so if the product on HP SiteFlow requires the upload of Components you must create upload fields on the product and set the tag as the component name on HP SiteFlow.

 

On the following image we show an HP SiteFlow product, Book and the configuration on Pressero:

 
Screen Shot 2017-09-29 at 18.39.43.png

 

 

 

 

 

 

 

 

Screen Shot 2017-09-29 at 18.41.48.png

The Integration ID and upload fields should match the string shown on the HP SiteFlow, including the case.

 

Shipping

 

Another requirement by HP SiteFlow is the Shipping method used by order if the shipping method is not present on HP SiteFlow the order will be rejected, so to avoid problems, check the shipping methods available on SiteFlow and see if the name matches the ones available on Pressero. To check this information, on HP SiteFlow click on Shipping -> On the left menu select Shipping Methods.

 

Screen Shot 2017-09-29 at 18.47.42.png

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

The Shipping method on Pressero should match the name on the Service column on SiteFlow, otherwise, the order will be rejected by SiteFlow.

 

Screen Shot 2017-09-29 at 18.49.58.png

 

Here is an example where we have shipping method on Pressero that matches the Ground service on SiteFlow.

 

Pushing Order

 

So, when the user places an order on Pressero and everything is ok, that means:

  1. The order is Paid (or is open terms)​
  2. All items are approved​
  3. No Items are denied​
  4. No items are marked as Cancelled​
  5. All eDoc files are OK​​
The order will then be pushed to the HP Site Flow server and the user will be able to see the integration details on the Order Item details page, Embedded Service Tab.
 

 

 

To get the latest order status from the HP server, go to the site settings, embedded service tab, select the integration, check the Synchronize Order Status check box and then click on Synchronize, Pressero will then fetch the data from HP servers and update the order status and shipping information automatically.

 

To set the item as shipped on Site Flow, click shipment group information on the order details page, click on cogs icon and set the item as shipped.

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Webhook Status Synchronization

 

To use webhooks with site flow you have to get the postback url from Pressero, this url is provided after you create the Embedded Service item.

 

 

With this URL you can now use the Site Triggers, triggers are notifications that Site Flow can send back to Pressero, to create trigger access Site Flow Setup page and click on Trigger on the Left Menu.
 
We recommend the creation of 5 triggers:
  1. Order Cancelled
  2. Order Errored
  3. Order Print Ready
  4. Component Printed
  5. Shipment Shipped

For each trigger, you’ll need a specific template, that we provide here https://drive.google.com/open?id=1e1ukkp4tH9_-pEGTBJ4uN_dl8tVLVrex

 

After configuring the templates you can then set the Trigger, using the create trigger option:

 

 

When using triggers, Site Flow will send notifications to Pressero, reducing the need for manual status synchronization.

 

Attributes:

 

For HP Siteflow we make available a set of attributes that allow configuration with HP Application:

  • siteflow_printoverqty -> Will be used for handling the quantity, it means that if you want the quantity to have an increment you can set this attribute to a value greater than 0, when Pressero loads this attribute it will: Quantity + PrintOverQty, but if the PrintOverQuantiy is greater than Quantity the application will use the PrintOverQuantity as them item quantity;
  • siteflow_binding -> Will map the value to the Binding property at item level at HP Site Flow;
  • siteflow_folding -> Will map the value to the Folding property at item level at HP Site Flow;
  • siteflow_weight -> This will be the master information for weight, but this information is used at component level configuration, but can be overwritten when using the component code attribute;
  • siteflow_substrate -> This will be the master substrate information, but this information is used at the component level but can be overwritten when using the component code attribute;
  • siteflow_productionfile-> This will indicate that Pressero should send the production file to Site Flow and that the site flow component should be mapped to this production file attribute value; (ex.: siteflow_productionfile = cover will configure the edoc file as a component with the code = cover)
  • siteflow_asset_*-> This will indicate that Pressero should send the asset associated to the product as a component to Site Flow. When Pressero finds that a product has an attribute that contains the name “siteflow_asset_” it will try to find a file that contains the attribute value in its name, if there’s a file that matches the search criteria Pressero will add it as a component and set the component code as the attribute value. Ex.:
  • siteflow_substrate_*code*-> This will overwrite the siteflow_substrate attribute from item level to a specific component level, setting a specific substrate for this component code; (Where *code* should be the component code this file will be associated to, ex.: sitflow_substrate_cover = Coated)
  • siteflow_weight_*code*-> This will overwrite the siteflow_weight attribute from item level to a specific component level, setting a specific weight for this component code; (Where *code* should be the component code this file will be associated to, ex.: sitflow_weight_cover =200)