Liferay Commerce 2.1 Connector to PunchOut2Go

Subscription

Liferay provides a PunchOut2Go connector that integrates with a user’s existing PunchOut2Go infrastructure. You can download this connector from the Liferay Help Center as an LPKG file.

Important

The PunchOut2Go connector requires Liferay Commerce 2.1.2 and Liferay DXP 7.1 FP18+ or 7.2 FP6+.

Deploy the PunchOut2Go Connector

Before deploying the PunchOut2Go connector, ensure you’ve already deployed Liferay Commerce to your Liferay server to avoid conflicts.

  1. Download the Commerce Connector to PunchOut2Go from the Liferay Help Center.

  2. Copy the PunchOut2Go Connector LPKG into the ${liferay.home}/deploy folder.

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

    2020-07-24 22:10:01.924 INFO  [fileinstall-/../../liferay-portal-7.1.10.1-sp1/osgi/marketplace][LPKGArtifactInstaller:209] The portal instance needs to be restarted to complete the installation of file:/../../liferay-portal-7.1.10.1-sp1/osgi/marketplace/Liferay%20Commerce%20Connector%20to%20PunchOut2Go%20-%20API.lpkg
    2020-07-24 22:10:01.926 INFO  [fileinstall-../../liferay-portal-7.1.10.1-sp1/osgi/marketplace][LPKGArtifactInstaller:209] The portal instance needs to be restarted to complete the installation of file:/../../liferay-portal-7.1.10.1-sp1/osgi/marketplace/Liferay%20Commerce%20Connector%20to%20PunchOut2Go%20-%20Impl.lpkg`
    
  4. Restart the application server.

Once the server finishes restarting, the connector is active and ready for configuration.

Configure the Connector

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

  1. Navigate to the Control PanelCommerceChannels.

  2. Select a channel and go to Punch Out.

  3. Switch the toggle to Enabled.

  4. Enter the Punch Out Start URL.

  5. Click Save when finished.

Enable Auto Login Punch Out Access Token

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

  1. Navigate to the Control PanelConfigurationSystem Settings.

  2. Click API Authentication under Security.

    Select API Authentication to configure the access token.

  3. Click Auto Login Punch Out Access Token in the left menu.

  4. Check the Enabled checkbox.

    Enable the auto login access token.

  5. Click the Update button.

Punch Out Access Token Provider Configuration

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

  1. Navigate to the Control PanelConfigurationSystem Settings.

  2. Click OAuth2 under Security. The Punch Out Access Token Provider Configuration is open by default.

    • Access Token Duration: Sets the validity of the token

    • Access Token Size: Sets the size of the token

    Configure the validity and size of the access token.

  3. 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

  1. Navigate to Control PanelUsersRoles.

  2. Go to Site Roles and click Add Site Role.

  3. Enter the name as Punch Out Vendor.

  4. Click Save.

  5. Click Define Permissions.

  6. Expand the Site Administration in the left menu.

  7. Navigate to ApplicationsOpen Carts.

  8. Check the following permissions at the very least:

    • Check Out Open Orders

    • View Open Orders

    Permissions for a punch out role.

  9. Click Save.

This creates the new punch out role with the required bare minimum permissions. Assign this role to buyers that punch out.

Verify Redirect to Buyer’s Procurement System

After deploying and configuring the connector, users are redirected to the appropriate procurement system when they click Submit.

Punch out redirects after submitting an order.

Capabilities

Product

Contact Us

Connect

Powered by Liferay
© 2024 Liferay Inc. All Rights Reserved • Privacy Policy