Documentation Summary

Tharstern Integration

Sending Orders

When an order is processed in Storefront, its details are sent to the Tharstern system as an XML message through the Tharstern web service. The XML message formats are explained in Order Services XML Examples.

When an order is placed and approved (becomes ready to produce), it is assigned a unique Tharstern reference number in the ‘TharsternOrderID’ order field and the ordered items are assigned unique reference numbers in the (normally hidden) ‘TharsternDocumentID’ printing field. This allows you to match Storefront orders to their Tharstern counterparts by adding them to the custom columns in the order and item reports in Storefront.

The extension also sends to Tharstern a URL for each rendered artwork as configured in ‘Miscellaneous’ section of Configuration (‘Final Output Location’ field). Tharstern system will then make a request to download the artwork.

The Tharstern Storefront integration extension supports item discounts that are managed by the ‘Services: Discount Code’ extension.

Should the ordering process fail there is a ‘Resend’ feature for both the order and the items as described in Resend Behaviour.

If the document in the order is based on a product of type ‘Print Product’ or ‘User Uploaded PDF Product’ with final output being copied to output folder, the extension sends a URL to the rendered artwork as a part of the order to Tharstern. ‘Final Output Location’ setting from the Configuration page is used in this process.