Skip to main content

Managing cart item catalogs

Cart item catalogs allow you to synchronize your entire inventory with Talon.One.

Feature access

Only admins have full access to this feature. Application admins can only view cart item catalogs connected to Applications of which they are an admin.

Each item in a cart item catalog has three built-in attributes:

  • Product: Product the item belongs to. This is an optional attribute. A product is a group of SKUs.
  • SKU: Stock keeping unit of the item in the catalog. This is a mandatory attribute. Each cart item in the catalog must have a unique SKU.
  • Price: Price of the item. This is an optional attribute.

Grouping SKUs as products​

Grouping SKUs with similar properties as products enhances their visibility and identification. It also enables you to aggregate your data. If an SKU is not grouped, you can group it by adding the product attribute to the item with that SKU in a catalog programmatically using the Sync cart item catalog endpoint.

You can also ungroup an SKU by removing the product attribute from an item in the catalog using the same endpoint.

Adding custom attributes​

As well as grouping SKUs as products, you can add custom attributes with associated entity cart item to your catalog. These custom cart item attributes provide additional information such as the location or size of each item. They also allow you to filter the items in your catalog when editing or removing them programmatically.

The following are then available as picklist values in all the Applications connected to the catalog:

  • The Product and SKU of item built-in attributes of catalog items.
  • The values of the catalog's custom cart item attributes with type string and list of strings, for example, Color of item.
important
  • You can connect a maximum of 100 custom cart item attributes to a single catalog.
  • For rule evaluation, if built-in and custom cart item attributes are not present in the customer session, they are loaded from the cart item catalog connected to the Application.

The following example shows you a catalog that has cart items with product, SKU, price, and other custom attributes:

The catalog structure

Creating a cart item catalog​

To create a cart item catalog:

  1. On the leftmost menu, click Account > Tools > Cart Item Catalogs.

  2. At the top right of the page, click Create Catalog.

  3. In Catalog name, type a name for your catalog.

  4. In Description, type a description for the catalog.

  5. (Optional) In Connected Applications, select the Applications you want to connect to the catalog. You can also do this later while editing the catalog.

    note

    A catalog can be connected to several Applications but an Application can only be connected to one catalog. As a result, some Applications may not be available to be selected.

    To see a list of cart item catalogs and their connected Applications, click Existing Connections.

  6. Click Create Catalog.

important

A catalog can be updated only programmatically via the Sync cart item catalog endpoint. You can add, edit, or remove one or more items from your catalog via this endpoint.

Listing cart item catalogs​

On the leftmost menu, click Account > Tools > Cart Item Catalogs.

This page displays all the available cart item catalogs and contains the following information for each of them:

ColumnDescription
NameName of the cart item catalog.
IDUnique number identifying the cart item catalog. It can be used for integration purposes.
ApplicationsNumber of Applications connected to the cart item catalog.

Displaying a cart item catalog​

To view the details and contents of a cart item catalog:

  1. On the leftmost menu, click Account > Tools > Cart Item Catalogs.
  2. Click the name of the cart item catalog you want to display.

This page displays the following information about the catalog:

  • Catalog name: Name of the cart item catalog.
  • Catalog ID: Unique number identifying the cart item catalog. It can be used for integration purposes.
  • Connected Applications: Applications the cart item catalog is connected to.
  • Description: Description of the cart item catalog.

The page also contains a table with additional information about each item in the catalog:

ColumnDescription
ProductProduct the item belongs to.
SKUSKU of the item.
PricePrice of the item.

Any other custom cart item attributes that you have connected to this catalog, such as brand, weight, or color, also appear in this table as separate columns.

Editing a cart item catalog​

To edit a cart item catalog:

  1. On the leftmost menu, click Account > Tools > Cart Item Catalogs.
  2. To the right of the catalog you want to edit, click .
  3. Edit the Catalog name or Description.
  4. In Connected Applications, select the Applications that you want to connect to or disconnect from your catalog.
  5. Click Save.

Deleting a cart item catalog​

Limited access
You may not have access to this feature. For details, contact your Customer Success Manager.
caution

Deleting a cart item catalog permanently deletes the values of its built-in and custom attributes. This may impact campaigns that reference these attributes. To ensure that your campaigns are not impacted, remove the referenced attributes before deleting the catalog.

To delete a cart item catalog:

  1. On the leftmost menu, click Account > Tools > Cart Item Catalogs.
  2. To the right of the catalog you want to delete, click .
  3. In the pop-up that appears, enter the catalog name and select the checkbox.
  4. Click Delete Catalog.

Listing the connected Applications of a catalog​

To list the connected Applications of a cart item catalog:

  1. On the leftmost menu, click Account > Tools > Cart Item Catalogs.
  2. Click the name of the cart item catalog you want to display.
  3. In Connected Applications, click the number of connected Applications.