Steps on how to connect Acumatica with Commercium

This help article will guide you through the steps required to connect Acumatica with Commercium, including how to register a client application using the Authorization Code Flow and how to configure the required Web Service Endpoint.

Step 1: Registering a Client Application Using Authorization Code Flow

1. Visit the Acumatica website, then go to the System tab and click Integration. Next, navigate to Configure > Connected Applications.

2. In the Client Name field, enter the name you wish to assign to your application.
Leave the Client ID field empty, Acumatica will generate this ID automatically when you save the form.

3. For the OAuth 2.0 Flow, choose Authorization Code from the dropdown list.

4. Open the Secrets tab and follow these steps for each client secret you want to create:

• Click Add Shared Secret on the tab toolbar. A dialog box will appear.
  
  

• In the Description field, provide a meaningful name for the secret.
  
  

• (Optional) Set an expiration date/time in the Expires On (UTC) field.
  
  

• Copy the Value that is displayed; this is the only time the secret will be visible.
  This secret is required for your client application to authenticate with Acumatica ERP.
  
  

• Click OK to save and close the dialog.
  

5. Navigate to the Redirect URIs tab and do the following for each URI:

• Click Add Row.
  

• In the new row under Redirect URI, enter the exact callback URL where Acumatica should redirect after authorization.
  Make sure the URI is absolute and doesn’t include any fragment (i.e., no # part).
  Use this redirect URI:
  https://commercium.constacloud.com/handle-oauth-callback-restricted

6. Click Save on the form toolbar.

Acumatica will now generate a Client ID in the appropriate field.
Your application must use this Client ID together with the Client Secret for authentication.

Step 2: Configure Web Service Endpoint

Once API tokens are set up, complete the following configuration:

1. From the Integration menu, go to Web Service Endpoints.

2. Find the default version 23 web service.

4. A pop-up window will appear for creating a new web service endpoint. Fill in the details as follows:

• Endpoint Name: Commercium
• Endpoint Version: 23.200.001

Step 3: Access Your Commercium Account

• If you already have an account with Commercium, sign in using your login credentials.

• If you’re not yet registered, contact our support team at [email protected] for help getting started.

Step 4: Go to Integrations

• After logging in, head over to the Integrations on your Commercium dashboard and select the Available Integrations option.

• From the available choices, select Connect Acumatica.

• Channel Name – Enter a name for this connection in the Channel Name field.

• ERP instance Domain – Enter your ERP instance Domain

• Client-ID – Enter your Client ID
• Client Secret – Enter your Client Secret
• EPR Tenant Name – Enter your EPR Tenant Name
• Endpoint Version – Enter your Endpoint Version
• Click Connect – After filling in all the fields correctly, click the green Connect button located at the bottom-right corner.

Confirmation – If your credentials are correct and the connection is successful, a confirmation message will appear, and your account will be successfully linked.

Once the connection is successfully established, you will be directed to the Settings page.

Choose the appropriate identifier for your products, such as SKU, Barcode, or another field, depending on how your catalog is structured.

Within the Settings, enable the Order Sync option.

• Notify on Unlinked Item/Order – Enable this option to receive email alerts if an order or product fails to match or encounters an error during sync.

• Skip Unpaid Orders – When this setting is enabled, any orders from the marketplace that haven't been paid for will not be pulled into Shopify.

• Order Notes Format – You can choose to include the marketplace’s order ID in the order notes. Click the ‘+’ icon to add the ID, and optionally include a prefix or suffix.

• Order Number Format – Similar to the notes, you may configure how the order number appears by inserting the marketplace ID and adding any prefix/suffix as needed.

• Order Import Start Time – Define the timestamp (UTC) from which you want orders to start syncing into Shopify. You can set this to the present time or a few hours earlier, based on your preference.

Enable Shipment Sync in the Settings.

• You can link Shopify shipping methods with those used in the marketplace. To set up multiple mappings, use the ‘+’ button.
• Once mappings are complete, click Save Shipment, and then make sure to save all your changes by clicking Save at the top or bottom of the page.

Enable Inventory Sync within the Settings panel.

• Safety Stock Level – Specify a buffer stock quantity that will be retained in Shopify. This number will be subtracted from your total inventory and the remaining quantity will be pushed to the Marketplace. This helps you prevent overselling while keeping full stock visibility in Shopify.

Switch on Price Sync from the Settings.

• Any price changes made to your Shopify products will be automatically reflected in the Marketplace for the matched listings.

Activate Product Sync in the Settings.

• Default Inventory for Non-Tracked Products – Input a default stock quantity for items that aren’t inventory-managed in Shopify. This ensures that these products still appear with stock in the Marketplace, which requires inventory levels even for made-to-order or custom products.

If you have any questions or need further assistance, please don't hesitate to contact us at [email protected].