Which eBay Fields are Supported by ChannelApe

Additional Fields Recognized by eBay

eBay Additional Field

  • ebay_description_url
    • Supports ftp, http, and https URLs
      • http and https urls are expected to respond to a HEAD request with a 2xx response status code otherwise they are considered invalid URLs.
      • If an issue occurs while downloading the description it is considered an invalid URL.
      • If the downloaded file is empty the URL is considered invalid.
    • Item description defaults to ChannelApe product description if no “ebay_descritpion_url” additional field key is present or of the url is considered invalid.
  • ebay_payment_policy_id
    • If the additional field value is set to a valid payment policy for the channel’s marketplace, then the eBay Item will be created or updated with that payment policy.
    • Item payment policy defaults to default non-motor vehicle payment policy for channel’s marketplace if no matching policy ID is found for the user and marketplace.
  • ebay_shipping_policy_id
    • If the additional field value is set to a valid shipping policy for the channel’s marketplace, then the eBay Item will be created or updated with that shipping policy.
    • Item shipping policy defaults to default non-motor vehicle shipping policy for channel’s marketplace if no matching policy ID is found for the user and marketplace.
  • ebay_return_policy_id
    • If the additional field value is set to a valid return policy for the channel’s marketplace, then the eBay Item will be created or updated with that return policy.
    • Item return policy defaults to default non-motor vehicle return policy for channel’s marketplace if no matching policy ID is found for the user and marketplace.
  • ebay_global_shipping
    • Global shipping can only be specified on item creation.
    • Item Global shipping defaults to true if no valid value is specified
    • If additional field value is set to “true”,”on”, “y”, “t” or “yes” ( case insensitive) then global shipping will be set to true. “false”, “off”, “n”,”f”, or “no” (case insensitive) will set global shipping to false.
  • ebay_best_offer_enabled
    • If additional field value is set to “true”,”on”, “y”, “t” or “yes” ( case insensitive) then best offer will be set to true. “false”, “off”, “n”,”f”, or “no” (case insensitive) will set best offer to false
    • Not all categories support best offer. You can check to see if a category supports best offer by trying to manually list an item in that category. If you do not see an option for best offer then the current category does not support it.
    • Best offer enabled defaults to false if no valid value is specified.
  • ebay_shipping_package
    • Supports all values listed on this page.
    • Updating shipping package of existing eBay Items requires the Weight update field to be enabled on the channel.
    • Shipping package has no default value.
  • ebay_store_category_id
    • If the additional field value is set to a valid Store Category ID, then the listing will be placed in that primary custom category.
    • Even though eBay Store sellers can create up to three levels of custom categories for their stores, the API only supports root level categories.
    • Invalid values will cause this ID to default to 0 (Other custom category)
  • ebay_store_category_2_id
    • If the additional field value is set to a valid Store Category ID, then the listing will be placed in that secondary custom category.
    • Since the API only supports root level categories at this time, this secondary category additional field is really just provided in case the API adds support for nested levels.
    • Invalid values will cause this ID to default to 0 (Other custom category)
  • ebay_item_option_*
    • If a valid ebay item option pair is present in the additional fields, then it will be added as an item specific on the item level.
    • Suffixes can be alphanumeric but must be unique among the rest of the additional fields.
    • Values cannot be blank.
    • ebay_item_option_key_*
      • Examples: “ebay_item_option_key_1”, “ebay_item_option_key_2”, “ebay_item_option_item_key_womens_size”, “ebay_item_option_key_style”
    • ebay_item_option_value_*
      • Examples: “ebay_item_option_value_1”, “ebay_item_option_value_2”, “ebay_item_option_value_womens_size”, “ebay_item_option_value_style”
  • ebay_option_*
    • If a valid ebay option pair is present in the additional fields, then only eBay options will be used as item specifics on the variance level. Otherwise only ChannelApe variant options will be used.
    • Suffixes can be alphanumeric but must be unique among the rest of the additional fields.
    • Values cannot be blank.
    • ebay_option_key_*
      • Examples: “ebay_option_key_1”, “ebay_option_key_2”, “ebay_option_key_womens_size”, “ebay_option_key_style”
    • ebay_option_value_*
      • Examples: “ebay_option_value_1”, “ebay_option_value_2”, “ebay_option_value_womens_size”, “ebay_option_value_style”
  • mpn
    • If this additional field is set this value will be used for the item specific MPN
    • Else SKU will be used if not set
  • ebay_category_id
    • If the additional field value is set then the value will be set as the Item Category ID.
    • Item category ID defaults to ChannelApe product primary category then secondary category if no “ebay_category_id” additional field value is present.
  • ebay_condition_id
    • Supports all values on this page.
    • Item Condition ID defaults to ChannelApe variant condition if no “ebay_condition_id” additional field is present or if the value is not a valid number.
  • ebay_condition_description
    • If the additional field value is set to a non-empty value, then Item Condition Description is set to the value.
    • No default value.

Since additional fields are stored on the ChannelApe Variant and not the ChannelApe product, eBay Item level fields mentioned above are updated by taking the values stored in the additional fields of the first ChannelApe variant associated with that ChannelApe product.

Default values are set in eBay Trading API Channel during Item creation if valid value is not found in additional fields. If no valid value is found in additional fields during eBay Item update in eBay Trading API Channel, then default value is used for update.

Additional fields are only used when creating eBay Items and updating eBay items previously created by ChannelApe.

Tagged: