1.2 Click Tharstern "Settings" Button
This is where you will enter in the Tharstern API credentials. There are two buttons, Settings, and Management. Settings is where you will enter the API credentials Tharstern has given you.
1.3 Enter Tharstern API Key
Enter the Tharstern API Key, both for the test environment (if applicable) and for the live environment. This is also where you can map the order status you want used in Tharstern.
1.4 Add a Script to Pressero Website(s) that will use Tharstern Integration
In Pressero Admin > Sites select the store that will be connected to Tharstern. In Settings > SEO / HTML tab, select the "HTML content for bottom of <head> section", copy and paste this code (repeat for each store that will use Tharstern):
<!-- THARSTERN INTEGRATION --> <meta http-equiv="Access-Control-Allow-Origin" content="https://external.ams.pressero.com/" /> <script type="text/javascript" src="https://external.ams.pressero.com/integrations/Tharstern.js"></script> <link href="https://external.ams.pressero.com/integrations/Tharstern.css" rel="stylesheet"> <!-- END THARSTERN INTEGRATION -->
1.5 Import the Tharstern Products into Pressero
After setting up the API in the Aleyant External Services Settings area, click the Management button. This is where you will control the Tharstern product import. The import will take some minutes. This process is data intensive, there is a lot going on.
After setting up the API credentials and the Pressero HEADER code, the Management area (below) is used to import Tharstern products into Pressero.
The import will bring in the Tharstern product name, the item #, price and inventory level. These are mapped to the corresponding Pressero data fields. Item # is mapped to both the private and public product number fields in Pressero.
1.6 Test the Integration
Place some test orders in Pressero.
2. Other configuration parameters that are created by Aleyant and should not be modified
A webhook is an API that powers one-way data sharing triggered by events. This integration will create a webhook in your Pressero account that will send order data to Tharstern, so their system can update inventory and order information.
A plugin pricing engine will be created in Pressero that will dynamically collect Tharstern prices for each product.
Webinar
Aleyant & Tharstern co-hosted a webinar about the integration. You can see it here:
https://www.tharstern.com/tharsterntv-partner-integrations?wchannelid=5jx3zw9f5o&wmediaid=36thu697ke
NOTES/FAQs
Import Time.
About how long does importing products take?
A: The time involved depends on many factors including connection speed, amount of data, etc.
Batch Import.
Can we batch import multiple products into one category, or must they be done one at a time?
A: Yes. A batch of 50 products maximum can be selected per import page.
Import Interruption.
What happens if there is an interruption during the import?
A: If it happens, some products will have been imported and others will not. When selecting the site where you want to import the products, if there are products that have already been imported on that site, their SKU will be shown crossed out and in red. Also, the imported products will be displayed in the Pressero admin > Sites (select) > Catalog > Products the imported product.
ORDERS
Order Information Passed From Pressero to Tharstern.
How is product order information passed to Tharstern from Pressero?
A: Because Pressero allows subscribers to have products both from Tharstern and other sources (ie: maintained only in Pressero), each item ordered passes as an individual order into Tharstern. Our Aleyant ProServices team is currently* working on creating a webhook to combine all Tharstern products ordered into one order in Tharstern.
*as of Nov 23, 2022
What information passes to Tharstern when an order containing a Tharstern product is ordered?
A: Please see the
JSON below.
Pressero Order History.
We are concerned about losing order history. When a product is imported/mapped from Tharstern, will the current products in Pressero be updated, replaced, or a new product be created?
A: A new product is created during the Tharstern import.
- Imported products will not replace or update those already in Pressero.
- Imported products will not use the order history of any existing Pressero products.
However, instead of using the import process existing Pressero products can be manually converted to Tharstern products to preserve the prior order history.
Tharstern Importation. The import process will create a new product in the Pressero admin > Sites > Catalog > Products section. The process will automatically
- Name the product
- Enter the Tharstern Item # in the General tab > Part Number field
- Enter the Tharstern Item # in the General tab > Public Part Number field
- Assign the Tharstern pricing engine in the Pricing tab and enter the MIS Product ID for the pricing engine.
Pressero Conversion. If you want to preserve the order history of products already in Pressero, you need to manually convert them rather than import. To manually convert an existing Pressero product into a Tharstern product you must do all the above manually instead.
- Open the Pressero product in Pressero admin > Sites > Catalog > Products section.
- You can keep the product Name as-is in the General tab.
- Enter the Tharstern Item # in the General tab > Part Number field.
- The Item # must be formatted as "ExternalUserID-TharsternProductID". Aleyant support will provide you with your ExternalUserID, Tharstern will supply the TharsternProductID. Combine them with a dash as shown above. Example, 117-12345 where 117 is the ExternalUserID we gave you and 12345 is the TharsternProductID.
- Enter the Tharstern Item # in the General tab > Public Part Number field OR use the customer’s SKU instead. The Public Part Number can also be blank.
- Assign the Tharstern pricing engine in the Pricing tab. Select the “Tharstern” pricing engine from the list and put as MIS Product ID "ExternalUserID-TharsternProductID-SiteDomain" The same Tharstern pricing engine will be used by all Tharstern products. The Tharstern pricing engine gets the price from Tharstern in real time based on the Tharstern Item # in the Pressero Part Number field.
Keep Pressero Public Part Number.
Our customers use the Pressero Public Part Number for their SKU. When a Tharstern product is imported into Pressero, can we override the Tharstern Item # for that field?
A: No. If you need to use their SKU either edit the number after import or use the Conversion option above instead of doing an Import.
Override Imported Tharstern Public Part Number.
Can we manually override the Tharstern Item# in Pressero's Public Part Number field afterwards, restoring the SKU?
A: Yes, you can later manually edit the Pressero Public Part Number field to use the customer’s SKU, or use Conversion process above instead of an import. The Pressero Public Part Number and Private Part Number are not required to be the same. The Public Part Number can be anything including blank.
Initial Order Status.
Can a specific status be set when an order is sent to Tharstern?
A: Yes, use the "Settings" area to set this.
Orders Waiting Approval.
Will orders waiting for approval in Pressero be sent to Tharstern?
A: No. Until approved they are technically "Pending" rather than "Orders". Once they are approved "Orders" they are sent to Tharstern based on the Workflow status you selected in the integration settings. That might be “Order Received”, “Order Completed” or a custom Workflow you created in Pressero admin > Preferences > Workflow.
For example, if you set the Tharstern integration Workflow to “Order Received”, when the order arrives in Pressero it will be transferred to Tharstern since all new Pressero orders start at “Order Received” Workflow status.
Example two, if you create a custom Workflow called, say “Tharstern Xfr” and set the Tharstern integration Workflow to “Tharstern Xfr”, when the order arrives in Pressero it will not be transferred until you set its status in Orders to “Tharstern Xfr”.
Artwork.
Is artwork from an order sent to Tharstern as well as the order data?
A: Yes.
Assets.
Are Pressero Assets from an order sent to Tharstern as well as the order data?
A: Not at this time.
Shipping Weight.
How will shipping integration and shipping weights work in Pressero for prices coming from Tharstern?
A: The shipping price is calculated by Pressero based on a product weight Tharstern passes to Pressero.
Tharstern Updates after Pressero Order Export.
After import, if we later change the product name, description, category, % increase over price, or the file upload checkbox in Tharstern, will they be updated in Pressero?
A: No, none will be updated in Pressero if they are changed in Tharstern after being imported. Once a product has been imported, its management must be done from the Pressero admin. The price is the only thing that will be retrieved dynamically from the Tharstern API. Any price change in Tharstern will be instantly reflected in Pressero
Order Status Changes in Tharstern.
Are order status changes in Tharstern sent to the Pressero order history?
A: No.
Does tracking information in Tharstern get sent to Pressero?
A: No. Tharstern does not have that feature set in it's API functions. Most users utilize the Tharstern system to send updated tracking information to their clients, so they don't need to be sent from Pressero as a duplicated effort.
Order Changes in Pressero.
When an order is edited or changed in Pressero, is that change sent to Tharstern?
A: No.
For the Techies.
What does the JSON look like that is sent from Pressero to Tharstern?
A: API function '/orders/submit'
"Orders":[{"CompanyID":"ALEY001","UniqueSubmitOrderID":"6994-1","InvoiceCustomer":{"Code":"2eef0af0-280e-4c03-a735-4fc04f7909d7","Name":"Name and Last Name (none)","Address":{"AddressLine1":"19 West Main Street","AddressLine2":null,"AddressLine3":null,"City":"Middlefield","Region":"PA","Country":"United States","Postcode":"17057","Telephone":"(650) 557-1289","Fax":null},"Contact":"Name and Last Name","ContactEmail":null},"DeliveryCustomer":{"Code":"2eef0af0-280e-4c03-a735-4fc04f7909d7","Name":"Name and Last Name ()","Address":{"AddressLine1":"19 West Main Street","AddressLine2":null,"AddressLine3":null,"City":"Middlefield","Region":"PA","Country":"United States","Postcode":"17057","Telephone":"(650) 557-1289","Fax":null},"Contact":"Name and Last Name","ContactEmail":null},"RequiredDate":"2021-11-15T00:00:00","OrderDate":"2021-11-15T13:41:13.5","Shipping":{"Value":{"Net":10,"Tax":0,"TaxDetails":{"Rate":0}}},"Items":[{"StockItemID":"2284","StockItemCode":"","Description":"McDonalds Store Opening Kit","Quantity":1,"Value":{"Net":25,"Tax":0},"RequiredDate":"2021-11-15T00:00:00","Ref1":"","Ref2":"28406876-c50c-4d16-b386-8f2824f19cef","DeliveryAddress":{"Name":"Name and Last Name ()","Address":{"AddressLine1":"19 West Main Street","AddressLine2":null,"AddressLine3":null,"City":"Middlefield","Region":"PA","Country":"United States","Postcode":"17057","Telephone":"(650) 557-1289","Fax":null},"Contact":"Name and Last Name","ContactEmail":null},"ChiliDocumentID":"string","Metadata":[],"Assets":{"Items":[{"Filename":"transparent","IsContent":true,"Content_URL":"https:\/\/s3-eu-west-1.amazonaws.com\/orderingplatform-ams\/subscribers\/28406876-c50c-4d16-b386-8f2824f19cef\/orders\/6994\/1\/transparent.png?timestamp=1636983673860","Visibility":{"IDC":true,"E4Print":true,"PrintManagement":true,"JobWatch":true,"Portal":true}}]}}]}]}
Questions?
Contact Aleyant's Professional Service Department by logging a support ticket, and choosing Professional Services in the Department dropdown.
Questions about Tharstern setup should be directed to your Tharstern support representative.