Skip to main content

Managing cart item catalogs

Important

Admin feature

caution

This feature is currently in development. Items in cart item catalogs cannot be accessed in any campaign yet.

Cart item catalogs contain a number of cart items with unique SKUs. They allow you to synchronize your entire inventory with Talon.One and can be updated as needed.

You can only update their content programmatically.

Adding cart item attributes to a catalog allows you to filter the items in it by SKU, color or product category and be able to, for example, remove specific items from the catalog.

tip
  • Cart item attributes in cart item catalogs are loaded from the database for rule evaluation if they are not present in the customer session. This increases performance.

  • The values of the catalog's cart item attributes are available as picklist values in all the Applications connected to the catalog.

Important
  • You can only use one cart item catalog per Application, but a catalog can be connected to several Applications.

  • Catalogs cannot currently be deleted.

Creating cart item catalogs

  1. Click Account in the left-most menu.

  2. Click Dev Tools > Cart Item Catalogs.

  3. Click Create Catalog at the top right of the page.

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

  5. In Description, type a description of what the catalog represents.

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

    note

    If you have created other cart item catalogs in your account, you can see which Applications are connected to them. You cannot connect your catalog to those Applications.

    Important

    Once the catalog is connected to a new Application, it cannot be disconnected from it as it affects the Application's cart item filters.

  7. Click Create Catalog.

A notification appears, indicating that a cart item catalog has been successfully created.

Displaying cart item catalogs

  1. Click Account in the left-most menu.
  2. Click Dev Tools > Cart Item Catalogs.

This page displays the available custom 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.

Displaying the details and content of a catalog

  1. Click Account in the left-most menu.
  2. Click Dev Tools > Cart Item Catalogs.
  3. Click the name of the cart item catalog whose details and content you want to display.

This page displays the following information about the catalog:

  • Catalog name

  • Catalog ID

  • Last update: Date and time when the cart item catalog was last edited or synchronized.

  • Catalog description

  • Connected Applications: The Applications the cart item catalog is connected to and their type. Click the name of an Application to access it.

    note

    Click Connect more to edit the catalog.

  • A list of cart items contained in the catalog. It displays the following information about each of the items:

    ColumnDescription
    Product SKUSKU of the cart item. It must be unique for the same catalog.
    PricePrice of the cart item.

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

    tip

    Use the search bar at the top of the list to search for specific cart items by their SKU.

Editing cart item catalogs

You can modify some characteristics of a cart item catalog after it has been created. For example, you can make it available in new Applications or change its name.

  1. Click Account in the left-most menu.

  2. Click Dev Tools > Cart Item Catalogs.

  3. Click the name of the cart item catalog you want to edit.

  4. Click Settings at the top right of the page or below the Connected Applications field.

  5. Edit the required details.

    Important

    Once the catalog is connected to a new Application, it cannot be disconnected from it as it affects the Application's cart item filters.

  6. Click Save Changes.

A notification appears, indicating that a cart item catalog has been successfully updated.

Synchronizing cart item catalogs

You can programmatically synchronize a cart item catalog with your ERP. Use the Sync cart item catalog endpoint to add or remove items from the catalog, or to edit their attributes.