Articles in this section

Use HTML templates for eBay listing descriptions

Rameez Zari
Updated

With HTML templates, you can give your eBay listings a consistent, branded description, and fill each listing with its own product details from NetSuite. A template contains placeholders, and before a listing is created or updated on eBay, the eBay - NetSuite integration app replaces each placeholder with the item's value from NetSuite. This article explains how to prepare the saved searches, write the template, apply it to items, and deploy the template script. Celigo doesn't provide HTML templates; you create your own.

Prerequisites: Create the HTML template file you want to use for your listings.

How placeholders work

A placeholder is a custom label, or a NetSuite field ID, in double curly braces, such as {{SKU}}. The integration app takes the values from a NetSuite saved search, so each placeholder must match a column's custom label in that saved search. If a column has no custom label, use the NetSuite field ID as the placeholder.

  • Placeholders can't contain spaces or special characters, such as (), @, quotation marks, or ;.
  • For image columns, start the custom label with __IMAGE in uppercase, such as __IMAGECustLabel. Images aren't rendered without this prefix. CustLabel__IMAGE and __imageCustLabel don't work.
  • The template stays the same, but each item that uses it shows its own values.
  • For a matrix item, only the parent item's details and images appear on eBay. Child item details are ignored. After you change field values that the template uses, save the parent item twice to update the description.
  1. In NetSuite, search for Celigo eBay Item Html Template Export Search in the global search, and open the saved search. The locked version is a template: save your changes under a new name, or use an existing saved search of your own instead.
  2. Select Edit this Search, and change the Search Title, such as eBay HTML and NetSuite Item Export Search.
  3. On the Results subtab, add each NetSuite field the template needs, with a custom label where needed.
  4. Select Save As to save the new saved search.

Write the template

Use the custom labels from your saved searches as placeholders in the template. For example:

<div id="sku">{{SKU}}</div> <div id="title">{{Title}}</div> <div id="description">{{Description}}</div> <div id="price">{{Price}}</div> <div id="categoryid">{{CategoryID}}</div> <div id="upc">{{UPC}}</div> <div id="brand">{{Brand}}</div> <div id="sampleimage">{{__IMAGEsampleimage}}</div>

Apply the template to an item

  1. In NetSuite, go to Lists > Accounting > Items, and edit the item.
  2. On the eTail subtab, select + next to EBAY HTML TEMPLATE LISTING.
  3. Select + next to HTML TEMPLATE, and select your template file.
  4. Enter the NAME, select the TEST SAVED SEARCH, and optionally enter the internal ID of a custom field in RENDERED HTML TEMPLATE ITEM FIELD to store the rendered description. If you leave it blank, the description is stored in EBAY RENDERED HTML TEMPLATE, which comes with the bundle.
  5. Select Save.
  6. On the eTail subtab, select the template in EBAY HTML TEMPLATE LISTING, and then save the item.

NetSuite renders the description and stores it in EBAY RENDERED HTML TEMPLATE, or in the custom field you entered. Any errors appear in EBAY HTML TEMPLATE PROCESSING ERRORS.

Send the rendered description to eBay

Change the item export saved search so that the listing description comes from the rendered template.

  1. In NetSuite, search for Celigo eBay Item Export Search, and open the saved search. The locked version is a template: save your changes under a new name, or use an existing saved search of your own instead.
  2. Select Edit this Search.
  3. On the Results subtab, replace the Description column with EBAY RENDERED HTML TEMPLATE, or with the rich text field that stores your rendered description.
  4. Save the saved search.

Deploy the template script

  1. In NetSuite, go to Customization > Scripting > Scripts.
  2. Find the Celigo eBay item Html Template script, and select Deployments.
  3. Select Show Undeployed, and then select DEPLOYED for each record type you use.
  4. Optional: to mark items for eBay with your own check box instead of the ETAIL CHANNEL field, enter the check box's internal ID in EBAY CRITERIA ITEM FIELD ID.
  5. Select Submit.

Use your own fields for the template and description

By default, the integration app uses two fields on the item record: EBAY HTML TEMPLATE LISTING for the template and EBAY RENDERED HTML TEMPLATE for the rendered description. You can use any two custom rich text item fields instead.

  1. In NetSuite, go to Customization > Scripting > Scripts, find the Celigo eBay item Html Template user event script, and select Deployments.
  2. Select Edit for the record type.

  3. On the Parameters subtab, enter your fields:

    • RAW HTML TEMPLATE: The field that holds the template, instead of EBAY HTML TEMPLATE LISTING.
    • RENDERED HTML TEMPLATE: The field ID of the rich text field that stores the rendered description, instead of EBAY RENDERED HTML TEMPLATE.
  4. Save the deployment.