Product List Object Import/Export

Use the productlist.xsd schema file to import and export product lists.

Granularity: selected product list

The import/export directory for product lists is customer.

The productlist.xsd supports the following elements:

  • Optional mode in product-list element
  • Optional child element items in product-list element
  • Optional child element list-id in product-list element
  • Optional type attribute in registrant element
  • Optional child element type in event element
  • address-id attribute in shipping-address and post-event-shipping-address elements

Import Product Lists

These are some reasons why you would want to import product lists:
  • To import data (wish lists etc) from a legacy platform.
  • To feed gift registries created offline (in-store with a scanner) to allow gift purchase by people that don't have convenient access to a store.
  • To update registries as items are purchased on/offline.

Product list import supports the DELETE, UPDATE, REPLACE, and MERGE modes. Anonymous product lists (without an owner) are skipped during import. The child element address-id of the Address element is sufficient for import - address values are not updated, but an existing address that matches the address-id is sufficient to create the assignment to the list.

  • The product list has a list-id configured:
    • Existing product lists are updated in the MERGE and UPDATE modes.
    • Existing product lists are recreated in the REPLACE mode.
    • Existing product lists aren't imported in the REPLACE and MERGE modes with the configured ID.
  • The product list doesn't have a list-id configured:
    • Product lists are created in the REPLACE and MERGE modes with a random ID.

Export Product Lists

The product list export includes custom attributes for product list items and the customer email address.

Business Manager Location

Customers > Import & Export

Pipelets

ImportProductLists

Granularity: passed product lists.