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.

  2. On the left-side menu, click Tools > Cart Item Catalogs.

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

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

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

  6. (Optional) In Connected Applications, select the Applications you want to connect to the catalog.

    note

    • After you connect a catalog to an Application, you cannot disconnect it.

    • A single catalog can be connected to several Applications but a single Application can only be connected to one catalog.

  7. 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.

Displaying cart item catalogs​

  1. On the leftmost menu, click Account.
  2. On the left-side menu, click Tools > Cart Item Catalogs.

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

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

Cart item catalog overview​

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

  1. On the leftmost menu, click Account.
  2. Click Tools > Cart Item Catalogs.
  3. 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.
  • Description: Description of the cart item catalog.
  • Connected Applications: Applications the cart item catalog is connected to.

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.

tip

Use the search bar at the top of the list to search for items in the catalog by product or SKU.

Editing a cart item catalog​

To edit a cart item catalog:

  1. On the leftmost menu, click Account.

  2. Click Tools > Cart Item Catalogs and select the cart item catalog you want to edit.

  3. At the top right of the page, click Settings.

  4. Edit the Catalog name or Description.

  5. In Connected Applications, select the Applications that you want to connect to your catalog.

    note

    After you connect a catalog to an Application, you cannot disconnect it.

  6. Click Save Changes.