X-Cart:EBay Integration - Revision history

Aim: Attention! The article is outdated.

2022-11-18T08:33:15Z

Attention! The article is outdated.

Mouse at 14:01, 22 July 2020

2020-07-22T14:01:27Z

Dohtur at 13:36, 26 May 2016

2016-05-26T13:36:08Z

Seyfin: /* Setting your business policies */

2016-04-19T09:07:49Z

‎Setting your business policies

Dohtur: /* System requirements */

2016-04-07T08:01:01Z

‎System requirements

Dohtur: /* System requirements */

2016-04-07T07:59:15Z

‎System requirements

Dohtur: /* Configuring eBay options for products and categories */

2016-03-27T15:24:01Z

‎Configuring eBay options for products and categories

Dohtur: Dohtur moved page Draft:EBay Integration to X-Cart:EBay Integration without leaving a redirect

2016-03-15T22:18:01Z

Dohtur moved page Draft:EBay Integration to X-Cart:EBay Integration without leaving a redirect

Dohtur: /* Viewing and managing your product listings on eBay */

2016-03-14T17:55:39Z

‎Viewing and managing your product listings on eBay

Dohtur: /* Exporting products to eBay */

2016-03-14T11:27:45Z

‎Exporting products to eBay

← Older revision		Revision as of 08:33, 18 November 2022
Line 1:		Line 1:
	{{XC version\|version=4.7.3\|color=#FFB62F\|comment={{{1\|or above}}}}}		{{XC version\|version=4.7.3\|color=#FFB62F\|comment={{{1\|or above}}}}}

		+	{{Note1\| <b>Attention!</b> The article is outdated.}}
	==Overview==		==Overview==

@@ Line 3: / Line 3: @@
 ==Overview==
-The [http://www.x-cart.com/extensions/modules/ebay-integration.html eBay Integration] module for X-Cart 4 creates a new sales channel for your business by automatically integrating your existing X-Cart store with eBay. The integration allows you get your products listed on eBay in as little as a few minutes using the product titles, images, descriptions, prices, inventory levels, variants and attributes from your X-Cart store. It also allows you to import your eBay orders back into X-Cart and manage all your sales from the X-Cart Admin area so the order information on eBay is updated in real time. The data can be synchronized between the two systems either manually or automatically according to your preferred schedule. The information of your eBay buyers such as names and addresses is also imported from eBay and becomes available in your X-Cart store's Admin back end as customer profiles.
+The [https://www.x-cart.com/extensions/modules/ebay-integration.html eBay Integration] module for X-Cart 4 creates a new sales channel for your business by automatically integrating your existing X-Cart store with eBay. The integration allows you get your products listed on eBay in as little as a few minutes using the product titles, images, descriptions, prices, inventory levels, variants and attributes from your X-Cart store. It also allows you to import your eBay orders back into X-Cart and manage all your sales from the X-Cart Admin area so the order information on eBay is updated in real time. The data can be synchronized between the two systems either manually or automatically according to your preferred schedule. The information of your eBay buyers such as names and addresses is also imported from eBay and becomes available in your X-Cart store's Admin back end as customer profiles.
 Your store can be connected to any single eBay marketplace site, including the sites for United States, Canada (English or French), UK, Australia, Austria, Belgium (French), France, Germany, Italy, Belgium (Dutch), Netherlands, Spain, Switzerland, Hong Kong, India, Ireland, Malaysia, Philippines, Poland and Singapore.
 The integration is provided as a service. Subscription plans for merchants of any size are available.
@@ Line 65: / Line 65: @@
 ===Obtaining an eBay user token===
-To configure your eBay Integration, the first thing you should do is create a new [http://developer.ebay.com/devzone/guides/ebayfeatures/Basics/Tokens-About.html user token] (also known as "Auth Token) that will allow eBay Integration to connect to your eBay account:
+To configure your eBay Integration, the first thing you should do is create a new [https://developer.ebay.com/devzone/guides/ebayfeatures/Basics/Tokens-About.html user token] (also known as "Auth Token) that will allow eBay Integration to connect to your eBay account:
 # In your store's Admin area, go to eBay Configuration page ('''Settings''' > '''eBay Configuration''') and make sure it is open at the '''Get User Token''' tab.<br />[[File:xc4_ebay_get_user_token.png |border]]<br />
 # Adjust the following settings:
@@ Line 71: / Line 71: @@
 #* '''eBay Motors''': Enable this option to sell on eBay Motors. Note that the previous setting ('''Select eBay Site''') determines the country of the eBay Motors site where you will be able to sell.
 #* '''Select mode''': Specify the mode in which your store will be interacting with eBay: select Test to use the eBay Sandbox or Live to use the production environment.<br />
-# Click the '''Create new token''' button:<br />[[File:xc4_ebay_create_new_token.png |border]]<br />This launches the user sign-in and consent process: you will be redirected to the eBay site where you will need to log in to the eBay account for which you need the token and grant the application the permission to access your account on your behalf.<br />[[File:ebay_login.png|border]]<br />After signing in, provide your consent to share your eBay data by clicking "I agree":<br />[[File:ebay_app_access_grant.png|border]]<br />'''Important''': If you are creating a Sandbox user token, enter the credentials for a [https://developer.ebay.com/DevZone/sandboxuser/default.aspx Sandbox User]. If it is a token for Production, use the credentials for a user created on the [http://www.ebay.com/ Production eBay site] (the one you will use to sell items on eBay). Remember that User IDs for Sandbox users begin with "TESTUSER_".<br />Once application access has been granted, eBay will generate a new token, and you will be automatically redirected back to X-Cart. On the '''Get User Token''' screen, you should now be able to see the '''User Token''' field populated with your token value. Below this field you should be able to see information about the current status of your token ('''Token Status''') and token expiration date ('''Token Expiration'''):<br />[[File:xc4_ebay_user_token.png|border]]<br />When your token is about to expire, you will be notified and provided with a button to create a new one.
+# Click the '''Create new token''' button:<br />[[File:xc4_ebay_create_new_token.png |border]]<br />This launches the user sign-in and consent process: you will be redirected to the eBay site where you will need to log in to the eBay account for which you need the token and grant the application the permission to access your account on your behalf.<br />[[File:ebay_login.png|border]]<br />After signing in, provide your consent to share your eBay data by clicking "I agree":<br />[[File:ebay_app_access_grant.png|border]]<br />'''Important''': If you are creating a Sandbox user token, enter the credentials for a [https://developer.ebay.com/DevZone/sandboxuser/default.aspx Sandbox User]. If it is a token for Production, use the credentials for a user created on the [https://www.ebay.com/ Production eBay site] (the one you will use to sell items on eBay). Remember that User IDs for Sandbox users begin with "TESTUSER_".<br />Once application access has been granted, eBay will generate a new token, and you will be automatically redirected back to X-Cart. On the '''Get User Token''' screen, you should now be able to see the '''User Token''' field populated with your token value. Below this field you should be able to see information about the current status of your token ('''Token Status''') and token expiration date ('''Token Expiration'''):<br />[[File:xc4_ebay_user_token.png|border]]<br />When your token is about to expire, you will be notified and provided with a button to create a new one.
 # Now that your token has been generated, click '''Next''' to save your changes and head over to the next step of configuring your eBay Integration: [[#Setting your business policies |Setting your business policies]].<br />[[File:xc4_ebay_get_user_token_next.png|border]]<br /><br />
 ===Setting your business policies===
 Once you have created an eBay user token to connect your X-Cart store to your eBay seller account, you can set business policies for your eBay listings. Business policies typically include information on how buyers can pay you; the shipping services you offer, and shipping costs; whether you accept returns, any return conditions, etc. All eBay listings must include this information. To provide information on your business policies for the listings that will be created from the products you sell via your X-Cart store, follow the steps below:
-# If you haven't yet done so, configure your business policies in your eBay account (More information is available [http://pages.ebay.com/help/sell/business-policies.html here]; [http://pages.ebay.ca/sellerinformation/news/springupdate2013/businesspolicies.html see also]).
+# If you haven't yet done so, configure your business policies in your eBay account (More information is available [https://pages.ebay.com/help/sell/business-policies.html here]; [https://pages.ebay.ca/sellerinformation/news/springupdate2013/businesspolicies.html see also]).
 # In X-Cart Admin, after creating your eBay token in the '''Get User Token''' section of the eBay Configuration page ('''Settings''' > '''eBay Configuration'''), click '''Next''' to go to the '''Business policies''' section:<br />[[File:xc4_ebay_get_user_token_next.png |border]]<br />If you have configured your business policies earlier, it is possible to simply click the '''Business policies''' tab:<br />[[File:xc4_ebay_business_policies.png |border]]<br />
 # Use the drop-down policy selectors to set the business policies you would like to use for your eBay listings:
@@ Line 99: / Line 99: @@
 #* After setting the default eBay categories for your products in the '''Categories''' section, click '''Next''':<br />[[File:xc4_ebay_categories_next.png|border]]<br />If you have configured your eBay General Settings previously, you can simply click the '''General Settings''' tab:<br />[[File:xc4_ebay_general_settings.png |border]]<br />
 # Adjust the settings in the Product options section:<br />[[File:xc4_ebay_general_settings1.png |border]]<br />The settings in this section will apply to all the products in your X-Cart store, for which similar settings have not been set [[#Configuring_eBay_options_for_products_and_categories | at the level of categories or individual products]].<br />
-#* '''Listing duration''': Select a duration for your store's eBay listings. Ebay help on listing duration is available [http://pages.ebay.com/help/sell/duration.html here].
+#* '''Listing duration''': Select a duration for your store's eBay listings. Ebay help on listing duration is available [https://pages.ebay.com/help/sell/duration.html here].
 #* '''Product condition''': Select the condition of the products you are going to export to eBay. Click the <u>Condition help</u> link for help on item condition for your category.
 #* '''Product price modifier''': If necessary, the price of items sold via eBay can be made higher or lower than the price of these items in your X-Cart store. The price difference can be implemented by setting a product price modifier.<br />For example, to add a $1 per item processing fee for eBay orders, you should set the price modifier as "[1.00] + [ $ ]":<br />[[File:xc4_ebay_general_settings2.png |border]]<br />This way all your items sold on eBay will be $1 more expensive than the items in your X-Cart store.<br />To reduce the price of items sold on eBay by 10% of their price in your X-Cart store, you should set the price modifier as "[-10.00] + [ % ]":<br />[[File:xc4_ebay_general_settings3.png |border]]<br />(Note the minus sign before "10.00"; it shows that the price of items on eBay will be lower than the original item price in the X-Cart store).<br />The price modifier defined in the eBay Integration General Settings applies to your entire X-Cart store (i.e. all the products that will be exported to eBay). If you need a price modifier only for some of the products, you should set the modifier at the level of specific [[#Configuring eBay options for products and categories|products or categories]].
@@ Line 125: / Line 125: @@
 #* '''Additional eBay Category''': Set the additional eBay category for the products from the selected X-Cart category and the subcategories of this category.
 #* '''Product price modifier''': If the price of the products in the selected X-Cart category and its subcategories needs to be different from the price of these products on eBay, set a price modifier.
-#* If you have set up [http://pages.ebay.com/help/sell/store-categories.html Store categories] to better organize your eBay listings, specify which of these Store categories the products from the selected X-Cart category and its subcategories need to be exported to. The button '''Update Store Categories List''' allows you to reload information about your eBay Store categories in X-Cart.
+#* If you have set up [https://pages.ebay.com/help/sell/store-categories.html Store categories] to better organize your eBay listings, specify which of these Store categories the products from the selected X-Cart category and its subcategories need to be exported to. The button '''Update Store Categories List''' allows you to reload information about your eBay Store categories in X-Cart.
 # Once you are done configuring the eBay options for the selected category, click '''Apply changes''' to save your changes.<br />[[File:xc4_ebay_category_ebayoptions4.png|border]]<br />The eBay options for the category will be saved.<br /><br />
 To set eBay options for a product:
@@ Line 136: / Line 136: @@
 #* '''Main eBay Category''': Set the main eBay category for the product.
 #* '''Additional eBay Category''': Set the additional eBay category for the product.
-#* If you have set up [http://pages.ebay.com/help/sell/store-categories.html Store categories] to better organize your eBay listings, specify which of these Store categories the product needs to be exported to. The button '''Update Store Categories List''' allows you to reload information about your eBay Store categories in X-Cart.
+#* If you have set up [https://pages.ebay.com/help/sell/store-categories.html Store categories] to better organize your eBay listings, specify which of these Store categories the product needs to be exported to. The button '''Update Store Categories List''' allows you to reload information about your eBay Store categories in X-Cart.
-#* '''Listing duration''': Set a duration for the eBay listing that will be based on this product. Ebay help on listing duration is available [http://pages.ebay.com/help/sell/duration.html here].
+#* '''Listing duration''': Set a duration for the eBay listing that will be based on this product. Ebay help on listing duration is available [https://pages.ebay.com/help/sell/duration.html here].
 #* '''Product condition''': Select the condition of the product (will be used for the respective eBay listing). Click the <u>Condition help</u> link for help on item condition for your selected category.
 #* '''Product price modifier''': If the price of the product on eBay needs to be different from the price of this product in your X-Cart store, set a price modifier.

← Older revision		Revision as of 13:36, 26 May 2016
Line 198:		Line 198:
	# Click the '''Upload orders''' button to launch the upload process.<br />While the upload is in progress, you may see a page like the following:<br />[[File:xc4_ebay_uploading_orders.png\|border]]<br />If you've had any orders on eBay during the specified period, in a few moments you should get a list of eBay orders uploaded to your X-Cart store. For example, on our demo installation, we had just one order from eBay during the past 6 hours, so the list of uploaded orders contains only one item:<br />[[File:xc4_ebay_orders.png\|border]]<br />		# Click the '''Upload orders''' button to launch the upload process.<br />While the upload is in progress, you may see a page like the following:<br />[[File:xc4_ebay_uploading_orders.png\|border]]<br />If you've had any orders on eBay during the specified period, in a few moments you should get a list of eBay orders uploaded to your X-Cart store. For example, on our demo installation, we had just one order from eBay during the past 6 hours, so the list of uploaded orders contains only one item:<br />[[File:xc4_ebay_orders.png\|border]]<br />
	In your X-Cart store's general list of orders, orders created on eBay are marked with the "EBAY" icon so you can easily tell them from the rest of the orders in your store.<br />[[File:xc4_ebay_order_icons.png]]		In your X-Cart store's general list of orders, orders created on eBay are marked with the "EBAY" icon so you can easily tell them from the rest of the orders in your store.<br />[[File:xc4_ebay_order_icons.png]]
		+
		+	[[Category:X-Cart user manual]]
		+	[[Category:X-Cart modules]]

@@ Line 76: / Line 76: @@
 ===Setting your business policies===
 Once you have created an eBay user token to connect your X-Cart store to your eBay seller account, you can set business policies for your eBay listings. Business policies typically include information on how buyers can pay you; the shipping services you offer, and shipping costs; whether you accept returns, any return conditions, etc. All eBay listings must include this information. To provide information on your business policies for the listings that will be created from the products you sell via your X-Cart store, follow the steps below:
-# If you haven't yet done so, configure your business policies in your eBay account (More information is available [http://pages.ebay.com/help/sell/business-policies.html here]).
+# If you haven't yet done so, configure your business policies in your eBay account (More information is available [http://pages.ebay.com/help/sell/business-policies.html here]; [http://pages.ebay.ca/sellerinformation/news/springupdate2013/businesspolicies.html see also]).
 # In X-Cart Admin, after creating your eBay token in the '''Get User Token''' section of the eBay Configuration page ('''Settings''' > '''eBay Configuration'''), click '''Next''' to go to the '''Business policies''' section:<br />[[File:xc4_ebay_get_user_token_next.png |border]]<br />If you have configured your business policies earlier, it is possible to simply click the '''Business policies''' tab:<br />[[File:xc4_ebay_business_policies.png |border]]<br />
 # Use the drop-down policy selectors to set the business policies you would like to use for your eBay listings:

@@ Line 12: / Line 12: @@
 To be able to successfully install and use the eBay Integration module, you must have the following components installed on your server:
 :* a working copy of X-Cart;<br />(The eBay Integration module is currently supported by X-Cart versions 4.7.3 and later. Upon request, we may be able to provide a module version compatible with earlier X-Cart versions.)
-:* an SSL certificate.<br />(An SSL certificate is required because the module needs to establish a secure https connection to our service to get a token. Without an SSL certificate, such a connection will not be possible, so you will get an error like the following: "Apr 01 12:23:49 XLite [warning] Curl SSL certificate problem: certificate has expired (60)".)
+:* an SSL certificate.<br />(An SSL certificate is required because the module needs to establish a secure https connection to our service to get a token. Without an SSL certificate, such a connection will not be possible, so you will get an error saying that you have a problem with your SSL certificate.)
 <br /><br />

@@ Line 10: / Line 10: @@
 ==System requirements==
-To be able to successfully install and use the eBay Integration module, you must have a working copy of X-Cart installed on your server. The eBay Integration module is currently supported by X-Cart versions 4.7.3 and later. Upon request we may be able to provide a module version compatible with earlier X-Cart versions.
+To be able to successfully install and use the eBay Integration module, you must have the following components installed on your server:
 <br /><br />

@@ Line 142: / Line 142: @@
 #* '''eBay item ID''': Leave this field be; it will be populated with an item ID value automatically after the product is exported to eBay.
 # Once you are done configuring the eBay options for the selected product, click '''Apply changes''' to save your changes.<br />[[File:xc4_ebay_product_ebayoptions4.png|border]]<br />The eBay options for the product will be saved.<br /><br />
 ==Using the module==

← Older revision	Revision as of 22:18, 15 March 2016
(No difference)

← Older revision		Revision as of 17:55, 14 March 2016
Line 167:		Line 167:

	===Viewing and managing your product listings on eBay===		===Viewing and managing your product listings on eBay===
		+	In your X-Cart store's Admin area, products that have been successfully exported to eBay are marked with the "EBAY" icons when seen in a product list:<br />[[File:xc4_ebay_product_icons.png\|border]]<br />This way you can easily tell them from the rest of your store's products. By clicking a product's "EBAY" icon, you can access the page of the respective product listing on eBay.<br /><br />
	Each of the products from your X-Cart store that is exported to eBay gets a unique eBay item ID. Once a product has been successfully exported to eBay, its eBay item ID is passed to X-Cart and stored in the '''eBay item ID''' field on the product details page in X-Cart Admin (in the eBay product options section). Below this field a link is provided that allows you to access the page of the respective listing on eBay (See the line that says "Current Item"):<br />[[File:xc4_ebay_item_id.png\|border]]<br />		Each of the products from your X-Cart store that is exported to eBay gets a unique eBay item ID. Once a product has been successfully exported to eBay, its eBay item ID is passed to X-Cart and stored in the '''eBay item ID''' field on the product details page in X-Cart Admin (in the eBay product options section). Below this field a link is provided that allows you to access the page of the respective listing on eBay (See the line that says "Current Item"):<br />[[File:xc4_ebay_item_id.png\|border]]<br />

@@ Line 152: / Line 152: @@
 #* ''Export of items'' - Select this to export all the information pertaining to the products;
 #* ''Export of inventories'' - Select this to update the product quantities in your eBay listings (only inventory data will be exported);
-#* ''Export of imags'' - Select this to update only the images of the products;
+#* ''Export of images'' - Select this to update only the images of the products;
 #* ''End of items'' - Select this to end the existing eBay listings.<br />[[File:xc4_ebay_export_productset1.png|border]]<br />
 # Depending on whether you need to export all the products that have been found or just the products you have selected, click either '''for selected''' or '''for all found''':<br />[[File:xc4_ebay_export_productset2.png|border]]<br />The products will be exported to eBay:<br />[[File:xc4_ebay_export_productset3.png|border]]<br />