Skip to main content

Managing cart item catalogs

Cart item catalogs allow you to synchronize your entire inventory with Talon.One and can be updated as needed.

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 catalog has 3 built-in attributes:

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

The SKUs of the items in the catalog are available as picklist values in the cart item filters of all the Applications connected to the catalog.

You can also add custom cart item attributes to your catalog to provide additional information such as the location or size of each item. Adding custom attributes to your catalog allows you to filter the cart items in it. Using these filters, you can edit or delete multiple cart items in the catalog.

important
  • You can connect a maximum of 100 custom cart item attributes to a single catalog.
  • The values of the catalog's custom cart item attributes with type string and list of strings are available as picklist values in all the Applications connected to the catalog.
  • For rule evaluation, if cart item attributes are not present in the customer session, they are loaded from the cart item catalog connected to the Application.

For example, a catalog that has cart items with product, SKU, price, and other custom attributes may look like this:

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 which catalogs are connected to which 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​

To list all the cart item catalogs:

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

This page displays all the available cart item catalogs. It 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.

    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 which catalogs are connected to which Applications, click Existing Connections.

  5. Click Save.

Deleting a cart item catalog​

caution

Deleting a cart item catalog permanently deletes the values of its built-in and custom attributes. Campaigns that reference these attributes can be impacted.

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.