XML Import Format
From GarageSaleWiki
Starting with version 3.3 GarageSale supports importing XML files in the format specified below. You can create files in this format to import listings from other sources into GarageSale. Use the 'Import Templates' command from the 'File' menu to import XML files.
File Layout
A single XML file can contain multiple listings descriptions. See below for the support item fields. Most fields are optional. If a listing property is not specified in the XML file, the default value you specified in GarageSale's preferences will be used instead.
Sample XML File
Here is a very simple sample XML file:
<items>
<item>
<title>My Listing Title</title>
<description><![CDATA[ My <b> great </b> stuff. ]]></description>
<startingBid>2.99</startingBid>
<imageURL isGalleryImage="true">http://www.iwascoding.com/GarageSale/ListingDesigns/images/Packs/Pack24/Spooky.jpg</imageURL>
<imageURL>http://www.iwascoding.com/GarageSale/ListingDesigns/images/Packs/Pack24/VintageCollage.jpg</imageURL>
<domesticShippingService serviceFee="12.00" serviceAdditionalFee="2.00">UPS Ground</domesticShippingService>
<internationalShippingService serviceFee="22.00">UPS Worldwide Express</internationalShippingService>
<siteName>eBay USA</siteName>
<design>Be A Star</design>
<layout>thumb gallery</layout>
</item>
</items>
Supported Item Attributes
buyItNowPrice
Provide this field if you want your listing to carry a Buy It Now price. Not providing a starting bid for the same listing will make this a fixed price auction.
category
The id of the primary eBay category you want to post your item in.
category2
The id of the secondary eBay category you want to post your item in.
convertDescriptionToHTML
A boolean value ('true' or 'false') specifying wether GarageSale should convert the item's text formating to HTML when posting the listing to eBay.
description
The item's description.
design
The name of the GarageSale auction design you want to use.
domesticShippingService
The name of an domestic shipping service. You can add a maximum of 3 services including the services specified in GarageSale's preferences.
Field Attributes
serviceFee
The name of an domestic shipping service. You can add a maximum of 3 services including the services specified in GarageSale's preferences.
serviceAdditionalFee
The name of an domestic shipping service. You can add a maximum of 3 services including the services specified in GarageSale's preferences.
duration
The duration of the auction in days (e.g. 1,3,5,7 or 10).
imageURL
(Can be specified multiple times for an item.)
An URL to an existing image file on your server. The specified URL will be added to your GarageSale template as an URL-based image and added to your auction when it is launched. Requires GarageSale 3.4 or later.
Field Attributes
isGalleryImage
An URL to an existing image file on your server. The specified URL will be added to your GarageSale template as an URL-based image and added to your auction when it is launched. Requires GarageSale 3.4 or later.
internationalShippingService
The name of an international shipping service. You can add a maximum of 3 services including the services specified in GarageSale's preferences.
Field Attributes
serviceFee
The name of an international shipping service. You can add a maximum of 3 services including the services specified in GarageSale's preferences.
serviceAdditionalFee
The name of an international shipping service. You can add a maximum of 3 services including the services specified in GarageSale's preferences.
layout
The name of the layout of the design you want to use.
listAsStoreInventory
A boolean value ('true' or 'false') specifying wether you want to list your item as inventory item in your store. The 'listInStore' field has to be enabled, too, in order to use this option.
listInStore
A boolean value ('true' or 'false') specifying wether you want to associate the listing with a certain category in your eBay store.
location
The location of your item.
packageDepth
The item's package depth in inches.
packageLength
The item's package length in inches.
packageOunces
The ounces of the item's shipping weigth. Use the packagePounds field to specify the pounds part of the weight.
packagePounds
The pounds part of the item's shipping weigth. Use the packageOunces field to specify the ounces part of the weight.
packageWidth
The item's package width in inches.
paymentInstructions
Optional payment instructions
privateAuction
A boolean value ('true' or 'false') specifying wether you want to list your item as private auction.
quantity
The item quantity you are selling. If ommitted, a quantity of 1 is assumed.
reservePrice
The listing's reservice price.
siteName
The name of the eBay site you want to use for the listing. Site name have to be specified as displayed in GarageSale's Prefrences (English Version).
SKU
A user specified item number that will be posted to eBay.
startingBid
The listing's starting price. Specify this value if you want to list your items as regular option.
storeCategory2Name
The name of a secondary store category the items should be associated with. The specified category has to be downloaded in GarageSale.
storeCategoryName
The name of the store category the items should be associated with. The specified category has to be downloaded in GarageSale.
subTitle
The listing's subtitle.
title
The listing's title. This field is required.
zipCode
The ZIP code of the item's location. Required if you want to enable location based search for your listing.
