Pushing Products to eBay Channel Mapping

ChannelApe supports creating, updating, and deleting items on eBay from ChannelApe. In order to be able to modify items on eBay, you must install and configure the eBay Channel integration.

Pushing ChannelApe products to eBay varies greatly depending on whether you have the Disable Variants permission enabled for your channel. When variants are disabled, we ignore any product groupings you have in ChannelApe and instead create each Item on eBay without any variations. The tables below will explain the differences in greater detail.

eBay Channel Settings

eBay Product Push Settings control ChannelApe’s ability to add and revise items on eBay. It also allows you to set whether you would like to use variations and how long the item should be listed for on eBay.

Pushing Products with Variations Enabled

Adding and revising eBay Items with Disable Variants unchecked.

Note in the table below, First ChannelApe Variant refers to the first variant found for the current ChannelApe product.

Item

eBay Item Field Value Notes
InventoryTrackingMethod SKU Necessary for ChannelApe to update an item after it is created using the ChannelApe product ID.
ListingType FixedPriceItem ChannelApe only supports fixed price items at this time.
ListingDuration Channel Setting Listing Duration Code Defaults to Days_30 but can be set to any value found here. Please note that some values only work in certain categories and marketplaces.
SKU ChannelApe Product ID ID of the current ChannelApe product.
Title ChannelApe Product Title Max length is 80 characters. Titles greater than 80 characters will be truncated to 77 characters with “…” appended to the end.
Description ChannelApe Product Description OR First ChannelApe Variant ebay_description_url Additional Field ebay_description_url additional field supports ftp, http, and https URL values.

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

PictureDetails First ChannelApe Product Image
ItemSpecifics ChannelApe Product AND First ChannelApe Variant ebay_item_option_* Additional Fields
  • Brand – ChannelApe Product Vendor
    • Only included when Items are being created OR Items are being revised with the Channel Settings Vendor Update Field enabled
  • Other values are set via First ChannelApe Variant ebay_item_option_* Additional Fields
    • 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”
ShippingPackageDetails ChannelApe First Variant Grams AND First ChannelApe Variant ebay_shipping_package Additional Field
  • Weight Major / Weight Minor – ChannelApe First Variant Grams
    • Grams are converted to pounds and ounces
  • ShippingPackage – First ChannelApe Variant ebay_shipping_package Additional Field
    • 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.
ShippingDetails ChannelApe First Variant ebay_global_shipping Additional Field
  • If the 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.
  • Global shipping can only be specified on Item creation.
  • Item global shipping defaults to true if no valid value is specified.
PostalCode eBay User RegistrationAddress PostalCode
Country eBay User RegistrationAddress Country
ConditionId ChannelApe First Variant Condition OR ChannelApe First Variant ebay_condition_id Additional Field
  • 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.
ConditionDescription ChannelApe First Variant ebay_condition_description Additional Field
  • If the additional field value is set to a non-empty value, then Item Condition Description is set to the value.
  • No default value.
PrimaryCategory ChannelApe First Variant Primary Category OR ChannelApe First Variant Second Category OR ChannelApe First Variant ebay_category_id Additional Field
  • 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.
SellerProfiles eBay Default Seller Profiles for Current Marketplace OR ChannelApe First Variant ebay_*_policy_id Additional Fields
  • 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.
BestOfferDetails ChannelApe First Variant ebay_best_offer_enabled Additional Field
  • If the additional field value is set to 'true''on''y''t' or 'yes' (case insensitive) then best offer enabled will be set to true'false''off''n''f' or 'no' (case insensitive) will set best offer enabled 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.
StoreFront ChannelApe First Variant ebay_store_category_* Additional Fields
  • 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)
Variations ChannelApe Variants See below Variations table.

Variations

eBay Variation Field Value Notes
SKU ChannelApe Variant SKU
StartPrice ChannelApe Variant Retail Price OR ChannelApe Variant Wholesale Price
  • If Channel Settings Price Field is set to Retail Price – ChannelApe Variant Retail Price
  • If Channel Settings Price Field is set to Wholesale Price – ChannelApe Variant Wholesale Price
Quantity ChannelApe Variant Quantity
UPC ChannelApe Variant UPC
VariationSpecifics ChannelApe Options OR ChannelApe Variant ebay_options_* Additional Fields

ChannelApe Variant SKU OR ChannelApe Variant mpn Additional Field

  • 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
Picture ChannelApe Variant First Image First image for ChannelApe variant.

Pushing Products with Variations Disabled

Adding and revising eBay Items with Disable Variants checked.

Item

eBay Item Field Value Notes
InventoryTrackingMethod SKU Necessary for ChannelApe to update an item after it is created using the ChannelApe variant SKU.
ListingType FixedPriceItem ChannelApe only supports fixed price items at this time.
ListingDuration Channel Setting Listing Duration Code Defaults to Days_30 but can be set to any value found here. Please note that some values only work in certain categories and marketplaces.
SKU ChannelApe Variant SKU SKU of the current ChannelApe variant.
StartPrice ChannelApe Variant Retail Price OR ChannelApe Variant Wholesale Price
  • If Channel Settings Price Field is set to Retail Price – ChannelApe Variant Retail Price
  • If Channel Settings Price Field is set to Wholesale Price – ChannelApe Variant Wholesale Price
Quantity ChannelApe Variant Quantity
UPC ChannelApe Variant UPC UPC of the current ChannelApe variant.
Title ChannelApe Variant Title Max length is 80 characters. Titles greater than 80 characters will be truncated to 77 characters with “…” appended to the end.
Description ChannelApe Variant Description OR ChannelApe Variant ebay_description_url Additional Field ebay_description_url additional field supports ftp, http, and https URL values.

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

PictureDetails ChannelApe Variant Images All images for ChannelApe variant.
ItemSpecifics ChannelApe Variant Vendor AND ChannelApe Variant SKU AND ChannelApe Variant ebay_item_option_* Additional Fields
  • Brand – ChannelApe Variant Vendor
    • Only included when Items are being created OR Items are being revised with the Channel Settings Vendor Update Field enabled
  • 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
  • Other values are set via ChannelApe Variant ebay_item_option_* Additional Fields
    • 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”
ShippingPackageDetails ChannelApe Variant Grams AND ChannelApe Variant ebay_shipping_package Additional Field
  • Weight Major / Weight Minor – ChannelApe Variant Grams
    • Grams are converted to pounds and ounces
  • ShippingPackage – ChannelApe Variant ebay_shipping_package Additional Field
    • 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.
ShippingDetails ChannelApe Variant ebay_global_shipping Additional Field
  • If the 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.
  • Global shipping can only be specified on Item creation.
  • Item global shipping defaults to true if no valid value is specified.
PostalCode eBay User RegistrationAddress PostalCode
Country eBay User RegistrationAddress Country
ConditionId ChannelApe Variant Condition OR ChannelApe Variant ebay_condition_id Additional Field
  • 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.
ConditionDescription ChannelApe Variant ebay_condition_description Additional Field
  • If the additional field value is set to a non-empty value, then Item Condition Description is set to the value.
  • No default value.
PrimaryCategory ChannelApe Variant Primary Category OR ChannelApe Variant Second Category OR ChannelApe Variant ebay_category_id Additional Field
  • 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.
SellerProfiles eBay Default Seller Profiles for Current Marketplace OR ChannelApe Variant ebay_*_policy_id Additional Fields
  • 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.
BestOfferDetails ChannelApe Variant ebay_best_offer_enabled Additional Field
  • If the additional field value is set to 'true''on''y''t' or 'yes' (case insensitive) then best offer enabled will be set to true'false''off''n''f' or 'no' (case insensitive) will set best offer enabled 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.
StoreFront ChannelApe Variant ebay_store_category_* Additional Fields
  • 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)

Good `Til Cancel Listings

Good `Til Cancel listings don’t expire. They stay up until your product is sold or you explicitly take it down. ChannelApe will continue maintaining updates to your GTC item for the life of the listing.