Understanding DirectScale IDs

Learning Experience Team

March 30, 2021 20:40

The DirectScale Platform has two Associate-related IDs: the DirectScale ID and Customer ID. Besides just identifying Associates, you can use these IDs for writing queries or custom code.

DirectScale ID

The DirectScale ID is an internal ID used by Corporate for all backend functions that are tied to any particular Associate in the Database.

This ID may also be referred to as:

Associate ID
Distributor ID

This ID is the recordnumber of the CRM_Distributors table and appears on the Associate’s Detail page.

Customer ID

The Customer ID is an external ID Associates know as their own. This ID is typically used in the Web Office and eCommerce Shop.

This ID may also be referred to as the Back Office ID.

In the public API there is a parameter called customerId, this parameter doesn’t refer to this ID type, but rather the DirectScale ID. If you are looking to call this ID use the backofficeId parameter.

This ID can also be viewed on the Associate’s Detail page.

For more information, see: Building Customer IDs to learn how to customize Customer ID generation.

Correctly Referencing IDs that are Configured to Match

If you’ve configured your DirectScale ID and Customer ID to match and you are writing a query or custom code, you can’t interchange the IDs. The DirectScale ID is more commonly referenced in these instances, but there are specific queries that deliberately request the Customer ID.