Liferay Connector to TradeCentric (formerly PunchOut2Go)

Subscription

Liferay provides a TradeCentric (formerly PunchOut2Go) connector that integrates Liferay with a user’s existing TradeCentric infrastructure. You can download this connector from the Liferay Marketplace.

Deploy the TradeCentric Connector

After downloading the connector, copy the LPKG into the ${liferay.home}/deploy folder.

Verify that the following messages appear in the application server console:

2024-05-29 12:33:04.573 INFO  [com.liferay.portal.kernel.deploy.auto.AutoDeployScanner][AutoDeployDir:212] Processing Liferay Commerce Connector to PunchOut2Go.lpkg
2024-05-29 12:33:13.767 INFO  [fileinstall-directory-watcher][BundleStartStopLogger:68] STARTED com.liferay.headless.commerce.punchout.api_13.1.6 [1456]
2024-05-29 12:33:13.768 INFO  [fileinstall-directory-watcher][BundleStartStopLogger:68] STARTED com.liferay.commerce.punchout.oauth2.provider.api_5.0.8 [1455]
2024-05-29 12:33:13.772 INFO  [fileinstall-directory-watcher][BundleStartStopLogger:68] STARTED com.liferay.commerce.punchout.api_5.0.12 [1454]
2024-05-29 12:33:13.856 INFO  [fileinstall-directory-watcher][BundleStartStopLogger:68] STARTED Liferay Commerce Connector to PunchOut2Go - API_4.0.1 [1453]
2024-05-29 12:33:13.962 INFO  [fileinstall-directory-watcher][BundleStartStopLogger:68] STARTED Liferay Commerce Connector to PunchOut2Go - Impl_4.0.1 [1457]
2024-05-29 12:33:13.969 INFO  [Start Level: Equinox Container: df30fc55-e8a2-4942-ae22-c6b3b5e81c12][BundleStartStopLogger:68] STARTED com.liferay.commerce.punchout.portal.security.auto.login_4.0.28 [1459]
2024-05-29 12:33:13.970 INFO  [fileinstall-directory-watcher][BundleStartStopLogger:68] STARTED com.liferay.commerce.punchout.service_4.0.20 [1460]
2024-05-29 12:33:13.985 INFO  [fileinstall-directory-watcher][BundleStartStopLogger:68] STARTED com.liferay.commerce.punchout.oauth2.provider.rest_4.0.15 [1458]
2024-05-29 12:33:13.986 INFO  [Start Level: Equinox Container: df30fc55-e8a2-4942-ae22-c6b3b5e81c12][BundleStartStopLogger:68] STARTED com.liferay.commerce.punchout.web_4.0.25 [1461]
2024-05-29 12:33:14.050 INFO  [fileinstall-directory-watcher][BundleStartStopLogger:68] STARTED com.liferay.headless.commerce.punchout.impl_4.0.51 [1462]

The connector is now active and ready for configuration.

Configure the Connector

You can configure the TradeCentric connector for each channel. During configuration, you must have the URL of the store’s catalog page.

Open the Global Menu () and navigate to Commerce → Channels.
Select a channel and go to Punch Out.
Switch the toggle to Enabled.
Enter the Punch Out Start URL.
Click Save when finished.

Users must enable the punch out access token for the buyer’s procurement system to enable access to the Liferay instance.

Open the Global Menu () and navigate to Control Panel → System Settings.
Click API Authentication under Security.
Click Auto Login Punch Out Access Token in the left menu.
Check the Enabled checkbox.
Click Update.

Punch Out Access Token Provider Configuration

After enabling the punch out access token, users can configure the punch out access token provider.

Open the Global Menu () and navigate to Control Panel → System Settings.
Click OAuth2 under Security. The Punch Out Access Token Provider Configuration is open by default.
- Access Token Duration:
- Access Token Size:
Click Save.

Create a Punch Out Buyer Role

It is best practice to have a role for vendors using punch out. To learn more about Commerce roles, see Commerce Roles. For more information about roles and permissions in Liferay DXP, see Understanding Roles and Permissions

Navigate to the Control Panel → Users → Roles.
Click the Site Roles tab.
Click the Add Site Role button.
Enter the following:
- Name: Punch Out Vendor.
Click Save.
Click Define Permissions.
Expand the Site Administration in the left menu.
Navigate to Applications → Open Carts.
Check the following boxes (at the minimum):
- Check Out Open Orders
- View Open Orders
Click Save