Add B2B connections

Application Administrators can add and update Opus B2B connections via XTT Link Actions (JavaScript snippets), which allows the exchange of files between TraceLink and customer's external ERP system, e.g. NetSuite®, Microsoft Dynamics (MS Dynamics), JD Edwards ERP application. Application Administrators must create an XTT Link Actions Catalog Item before creating the B2B connection via XTT Link Actions.

Contact the TraceLink implementation team for assistance in performing the one-time task of creating and associating an XTT Link Actions Catalog Item with the B2B connection.

Opus B2B connections do not affect existing Track & Trace Services (TTS) B2B connections. TTS apps that are available to Opus Platform users via Opus iFrame can continue to use their existing TTS B2B connections. Apps built on the Opus Platform cannot use TTS B2B connections and must create a new Opus B2B connection via XTT Link Actions.

Add and update B2B connections

Currently, TraceLink only supports connecting to NetSuite and Enterprise Resource Planning, Microsoft Dynamics Customer Relationship Management systems, and JD Edwards ERP application.

Add and configure a NetSuite B2B connection

Select the Main Menu icon.
Select Extensible Tracelink Transfer Link Actions.
Select B2B Connections in the side menu.
Select NetSuite.
Select the Add icon. The New NetSuite Connection page displays.
In the General section, fill in the following information:
- Connection Name field – Required. The unique name of the B2B connection.
  All letters in the Connection Name must be in uppercase.
- Authentication Type drop-down – The type of authentication used to protect the company against unauthorized access to data.
  Currently, only the OAuth2 authentication type is supported.
- Token URL field – Required. The specific endpoint provided by the NetSuite Server where XTT Link Actions exchanges an authorization grant for an access token.
- JWT Issuer field – Required. The ID of the entity issuing the JSON Web Token (JWT).
- Client Identifier field – Required. The unique identifier assigned to XTT Link Actions, enabling recognition and authentication during interactions with NetSuite.
- Client Secret field – The confidential key used by XTT Link Actions to authenticate with NetSuite within the secure OAuth 2.0 framework.
- Connection URL field – The entry point for XTT Link Actions to communicate with NetSuite.
- SuiteQL Url field – The endpoint used by XTT Link Actions to execute SuiteQL queries, enabling the querying and extraction of NetSuite records in a structured, efficient manner.
- Date Format field – The date format set by the NetSuite administrator during system setup.
- Time Format field – The time format set by the NetSuite administrator during system setup.
- Date Time Format field – The date and time format set by the NetSuite administrator during system setup.
Click the Add icon in the Inbound Link Actions section to configure inbound link actions.
Fill the following fields in the Add Inbound Entry side panel:
- B2B Transaction Type field – Required. The type of document exchanged, (e.g. Purchase Order).
- Catalog Access Type drop-down – Required. The access type of XTT Link Actions catalog,(e.g. Marketplace, Company).
- Link Action Version field – The version of the link action.
- Polling Interval (Min) field – Required. The frequency at which XTT Link Actions polls data from the NetSuite application.
Click Apply to save the configuration.
Click the Add icon in the Outbound Link Actions section to configure outbound link actions.
Fill the following fields in the Add Outbound Entry side panel:
- B2B Transaction Type field – Required. The type of document exchanged, e.g. Purchase Order.
- Catalog Access Type drop-down – Required. The access type of XTT Link Actions catalog,(e.g. Marketplace, Company).
- Link Action Version field – Required. The version of the link action.
- Number of Retries field – Required. The number of retries XTT Link Actions attempts after a failure to send the B2B message to the NetSuite application.
Click Apply to save the configuration.
Click the Save icon.

Tips

Contact the TraceLink Support for assistance in associating a link action from the Catalog Manager with the B2B connection.

Add and configure an MS Dynamics B2B connection

Select the Main Menu icon.
Select Extensible Tracelink Transfer Link Actions.
Select B2B Connections in the side menu.
Select MS Dynamics.
Select the Add icon. The New MS Dynamics Connection page displays.
In the General section, fill in the following information:
- Connection Name field – Required. The unique name of the B2B connection.
  All letters in the Connection Name must be in uppercase.
- Authentication Type drop-down – The type of authentication used to protect the company against unauthorized access to data.
  Currently, only the OAuth2 authentication type is supported.
- Token URL field – Required. The specific endpoint provided by the MS Dynamics Server where XTT Link Actions exchanges an authorization grant for an access token. The value of <Tenant ID> in the Token URL must be same as the Tenant ID value, e.g. https://login.microsoftonline.com/<Tenant ID>/oauth2/v2.0/token.
- JWT Issuer field – Required. The ID of the entity issuing the JSON Web Token (JWT).
- JWT Scope field – Refers to the scope claim in the JWT that specifies the permissions or operations the token allows XTT Link Actions to perform.
- JWT Subject field – A unique identifier that authenticates XTT Link Actions.
- JWT Audience field – Refers to the intended recipient of the token of the MS Dynamics server.
- JWT Signing Algorithm field – Refers to the cryptographic algorithm used to sign a JWT's header and determines the token's integrity and authenticity.
- Key Identifier field – Refers to the Key ID claim that indicates which key was used to sign the JWT. The Key ID allows XTT Link Actions to quickly identify and retrieve the correct key for signature validation.
- Client Identifier field – Required. The unique identifier assigned to XTT Link Actions, enabling recognition and authentication during interactions with MS Dynamics.
- Client Secret field – The confidential key used by XTT Link Actions to authenticate with MS Dynamics within the secure OAuth 2.0 framework.
- URL field – The URL that connects with the instance of MS Dynamics ERP system.
- Tenant ID field – The global unique identifier that identifies the instance of the MS Dynamics ERP in the Microsoft cloud.
Click the Add icon in the JWT Custom Header Attributes section to configure non-standard attributes fields included in the header section of a JSON Web Token (JWT).
Fill the following fields in the JWT Custom Header Attributes side panel:
- Name field – Name of the customized attribute.
- Value field – The corresponding value of the customized attribute.
Click Apply to save the configuration.
Click the Add icon in the JWT Custom Request Params section to configure additional, non-standard parameters included in the JWT request.
Fill the following fields in the JWT Custom Request Params side panel:
- Name field – Name of the customized attribute.
- Value field – The corresponding value of the customized attribute.
Click Apply to save the configuration.
Click the Add icon in the JWT Custom Claims section to configure additional claims to the JWT.
Fill the following fields in the JWT Custom Claims side panel:
- Name field – Name of the customized attribute.
- Value field – The corresponding value of the customized attribute.
Click Apply to save the configuration.
Click the Add icon in the Inbound Link Actions section to configure inbound link actions.
Fill the following fields in the Add Inbound Entry side panel:
- B2B Transaction Type field – Required. The type of document exchanged, (e.g. Purchase Order).
- Catalog Access Type drop-down – Required. The access type of XTT Link Actions catalog,(e.g. Marketplace, Company).
- Link Action Version field – The version of the link action.
- Polling Interval (Min) field – Required. The frequency at which XTT Link Actions polls data from the MS Dynamics application.
Click Apply to save the configuration.
Click the Add icon in the Outbound Link Actions section to configure outbound link actions.
Fill the following fields in the Add Outbound Entry side panel:
- B2B Transaction Type field – Required. The type of document exchanged, e.g. Purchase Order.
- Catalog Access Type drop-down – Required. The access type of XTT Link Actions catalog,(e.g. Marketplace, Company).
- Link Action Version field – Required. The version of the link action.
- Number of Retries field – Required. The number of retries XTT Link Actions attempts after a failure to send the B2B message to the MS Dynamics application.
Click Apply to save the configuration.
Click the Save icon.

Tips

Contact the TraceLink Support for assistance in associating a link action from the Catalog Manager with the B2B connection.

Add and configure a JD Edwards B2B connection

Select the Main Menu icon.
Select Extensible Tracelink Transfer Link Actions.
Select B2B Connections in the side menu.
Select JD Edwards.
Select the Add icon. The New JD Edwards Connection page displays.
In the General section, fill in the following information:
- Connection Name field – Required. The unique name of the B2B connection.
  All letters in the Connection Name must be in uppercase.
- Authentication Type drop-down – The type of authentication used to protect the company against unauthorized access to data.
  Currently, only the OAuth2 authentication type is supported.
- Token URL field – Required. The specific endpoint provided by the JD Edwards Server where XTT Link Actions exchanges an authorization grant for an access token.
- JWT Issuer field – Required. The ID of the entity issuing the JSON Web Token (JWT).
- JWT Scope field – Refers to the scope claim in the JWT that specifies the permissions or operations the token allows XTT Link Actions to perform.
- JWT Subject field – A unique identifier that authenticates XTT Link Actions.
- JWT Audience field – Refers to the intended recipient of the token of the JD Edwards server.
- JWT Signing Algorithm field – Refers to the cryptographic algorithm used to sign a JWT's header and determines the token's integrity and authenticity.
- Key Identifier field – Refers to the Key ID claim that indicates which key was used to sign the JWT. The Key ID allows XTT Link Actions to quickly identify and retrieve the correct key for signature validation.
- Client Identifier field – Required. The unique identifier assigned to XTT Link Actions, enabling recognition and authentication during interactions with JD Edwards.
- Client Secret field – The confidential key used by XTT Link Actions to authenticate with JD Edwards within the secure OAuth 2.0 framework.
- URL field – The URL that connects with the instance of JD Edwards ERP system.
Click the Add icon in the JWT Custom Header Attributes section to configure non-standard attributes fields included in the header section of a JSON Web Token (JWT).
Fill the following fields in the JWT Custom Header Attributes side panel:
- Name field – Name of the customized attribute.
- Value field – The corresponding value of the customized attribute.
Click Apply to save the configuration.
Click the Add icon in the JWT Custom Request Params section to configure additional, non-standard parameters included in the JWT request.
Fill the following fields in the JWT Custom Request Params side panel:
- Name field – Name of the customized attribute.
- Value field – The corresponding value of the customized attribute.
Click Apply to save the configuration.
Click the Add icon in the JWT Custom Claims section to configure additional claims to the JWT.
Fill the following fields in the JWT Custom Claims side panel:
- Name field – Name of the customized attribute.
- Value field – The corresponding value of the customized attribute.
Click Apply to save the configuration.
Click the Add icon in the Inbound Link Actions section to configure inbound link actions.
Fill the following fields in the Add Inbound Entry side panel:
- B2B Transaction Type field – Required. The type of document exchanged, (e.g. Purchase Order).
- Catalog Access Type drop-down – Required. The access type of XTT Link Actions catalog,(e.g. Marketplace, Company).
- Link Action Version field – The version of the link action.
- Polling Interval (Min) field – Required. The frequency at which XTT Link Actions polls data from the JD Edwards application.
Click Apply to save the configuration.
Click the Add icon in the Outbound Link Actions section to configure outbound link actions.
Fill the following fields in the Add Outbound Entry side panel:
- B2B Transaction Type field – Required. The type of document exchanged, e.g. Purchase Order.
- Catalog Access Type drop-down – Required. The access type of XTT Link Actions catalog,(e.g. Marketplace, Company).
- Link Action Version field – Required. The version of the link action.
- Number of Retries field – Required. The number of retries XTT Link Actions attempts after a failure to send the B2B message to the JD Edwards application.
Click Apply to save the configuration.
Click the Save icon.

Tips

Contact the TraceLink Support for assistance in associating a link action from the Catalog Manager with the B2B connection.

View B2B connections

View a list of NetSuite B2B connections

Select the Main Menu icon .
Select Extensible Tracelink Transfer Link Actions.
Select B2B Connection in the side menu.
Select NetSuite.
See the information that displays for each B2B connection
- Connection Name – The name given to a NetSuite connection.
- Authentication Type – The type of authentication used to protect the company against unauthorized access to data.
- Date Created – The date and time the NetSuite connection is created.
- Last Updated – The date and time the NetSuite connection is updated.
- Created By – The name of the Application Administrator who created the NetSuite connection.
- Updated By – The name of the Application Administrator who updated the NetSuite connection.

View a NetSuite connection

Select the Main Menu icon .
Select Extensible Tracelink Transfer Link Actions.
Select B2B Connection in the side menu.
Select NetSuite.
Select the link for the connection name from the results table. Select Apply.
The View / Edit NetSuite Connection Details screen displays.

View a list of MS Dynamics B2B connections

Select the Main Menu icon .
Select Extensible Tracelink Transfer Link Actions.
Select B2B Connection in the side menu.
Select MS Dynamics.
See the information that displays for each B2B connection:
- Connection Name – The name given to a MS Dynamics connection.
- Authentication Type – The type of authentication used to protect the company against unauthorized access to data.
- Date Created – The date and time the MS Dynamics connection is created.
- Last Updated – The date and time the MS Dynamics connection is updated.
- Created By – The name of the Application Administrator who created the MS Dynamics connection.
- Updated By – The name of the Application Administrator who updated the MS Dynamics connection.

View an MS Dynamics connection

Select the Main Menu icon .
Select Extensible Tracelink Transfer Link Actions.
Select B2B Connection in the side menu.
Select MS Dynamics.
Select the link for the connection name from the results table.
Select Apply.

The View / Edit MS Dynamics Connection Details screen displays.

The following fields are editable while viewing the General section:

In the General section, fill in the following fields:
- Connection Name field – Required. The unique name of the B2B connection.
  All letters in the Connection Name must be in uppercase.
- Authentication Type drop-down – The type of authentication used to protect the company against unauthorized access to data.
  Currently, only the OAuth2 authentication type is supported.
- Token URL field – Required. The specific endpoint provided by the MS Dynamics Server where XTT Link Actions exchanges an authorization grant for an access token. The value of <Tenant ID> in the Token URL must be same as the Tenant ID value. E.g. https://login.microsoftonline.com/<Tenant ID>/oauth2/v2.0/token.
- JWT Issuer field – Required. The ID of the entity issuing the JSON Web Token (JWT).
- JWT Scope field – Refers to the scope claim in the JWT that specifies the permissions or operations the token allows XTT Link Actions to perform.
- JWT Subject field – A unique identifier that authenticates XTT Link Actions.
- JWT Audience field – Refers to the intended recipient of the token of the MS Dynamics server.
- JWT Signing Algorithm field – Refers to the cryptographic algorithm used to sign a JWT's header and determines the token's integrity and authenticity.
- Key Identifier field – Refers to the Key ID claim that indicates which key was used to sign the JWT. The Key ID allows XTT Link Actions to quickly identify and retrieve the correct key for signature validation.
- Client Identifier field – Required. The unique identifier assigned to XTT Link Actions, enabling recognition and authentication during interactions with MS Dynamics.
- Client Secret field – The confidential key used by XTT Link Actions to authenticate with MS Dynamics within the secure OAuth 2.0 framework.
- URL field – The URL that connects with the instance of MS Dynamics ERP system.
- Tenant ID field – The global unique identifier that identifies the instance of the MS Dynamics ERP in the Microsoft cloud.

View a list of JD Edwards B2B connections

Select the Main Menu icon .
Select Extensible Tracelink Transfer Link Actions.
Select B2B Connection in the side menu.
Select JD Edwards.
See the information that displays for each B2B connection:
- Connection Name – The name given to a JD Edwards connection.
- Authentication Type – The type of authentication used to protect the company against unauthorized access to data.
- Date Created – The date and time the JD Edwards connection is created.
- Last Updated – The date and time the JD Edwards connection is updated.
- Created By – The name of the Application Administrator who created the JD Edwards connection.
- Updated By – The name of the Application Administrator who updated the JD Edwards connection.

View a JD Edwards connection

Select the Main Menu icon .
Select Extensible Tracelink Transfer Link Actions.
Select B2B Connection in the side menu.
Select JD Edwards.
Select the link for the connection name from the results table.
Select Apply.

The View / Edit JD Edwards Connection Details screen displays.