AuctionGenieTM 4.1.4


© 2001-2008 Luxcentral Enterprises
All rights reserved

Published by:

Luxcentral Enterprises
7319 Beau Road
Sechelt, BC V0N 3A8
Canada
Email: auctiongenie@luxcentral.com
Web: http://auctiongenie.luxcentral.com/


AuctionGenie is a program that manages selling, buying, tracking, and related activities for items listed on the eBay online trading web site at http://www.ebay.com/. You can use it to create and post your own listings (including eBay Store listings), place bids, track the status of items you're interested in (even those for which you have not yet placed bids), prepare transaction reports, send 'dback, and manage post-closing transactions such as payment and delivery.

AuctionGenie can be licensed for a term of one year (renewable) and licensees are entitled to use all updates published during the year. Updates are very important because they provide enhancements that are often needed when eBay modifies existing functionality or adds new features. Go to the AuctionGenie home page at http://auctiongenie.luxcentral.com/ for information on the licensing fee, how to pay it, and how to register your copy of AuctionGenie.

Note that AuctionGenie submits listings to the United States eBay web site located at www.ebay.com.


Table of Contents


System Requirements and Helper Applications

AuctionGenie works with Mac OS X and three helper applications — a web browser, an email client, and an FTP client. This software must be installed and properly configured prior to running AuctionGenie.

International Considerations

By default, the AuctionGenie databases are designed to accept the standard date and decimal number input formats used in the United States:

If you run AuctionGenie in a Mac OS X environment where different input formats are in effect, you will see a dialog similar to the one below.

Locale
The dialog for choosing system settings for data entry.

Click Yes to use your familiar system settings for date and decimal number entry. In Germany, for example, this normally means you would enter 30.11.2006 for November 30, 2006 and enter 10156,43 (or 10.156,43) for ten thousand one hundred fifty six and 43 hundredths.

At present, the only alternative numeric format supported is one where the comma is used as a decimal point. You cannot use a format where the space character acts as the decimal point.

Alternatively, you can set whether or not to use system settings for data entry by checking or unchecking the Use system formats item that appears in the Format menu of the eBay Bidding and Selling databases when you are running Mac OS X in a non-U.S. locale.

Downloading AuctionGenie

You can download the AuctionGenie software to your Macintosh computer from the following location:

UniversalUniversal application: http://auctiongenie.luxcentral.com/download.html
[version 4.1.4 — Requires Mac OS X v. 10.1 or later — 11.7 MB]

The file you download is called AuctionGenieX.zip and is compressed to minimize the download time. To use it, you must first decompress the file by double-clicking it. On recent versions of Mac OS X, this launches Archive Utility to perform the decompression. On earlier versions, you may need a program called StuffIt Expander, or equivalent. You can download a free copy of the most current version of Stuffit Expander directly from Smith Micro at http://my.smithmicro.com/mac/stuffitexpander/

Updates to AuctionGenie are made available from time to time. To check whether a software update is available, use the Check for AuctionGenie Update... command in the Help menu of the application. It will advise you on whether an update is available and, if so, allow you to go to a download page to get it. See Appendix 13 for information on transitioning to a new version of AuctionGenie.

Running AuctionGenie

Once you've decompressed the downloaded AuctionGenie software, a folder called AuctionGenie Home is created on your hard disk. Inside this folder are the following files and folders:
If you are currently using an older version of AuctionGenie, see Appendix 13 for instructions on how to move your existing data files to this new version of AuctionGenie.

You can rename the AuctionGenie Home folder and move it to any location on your hard disk, but don't remove or rename any of the files or folders inside it. To make it more convenient to launch AuctionGenie, you may want to create an alias to the program file (using the Make Alias command in the File menu of the Finder desktop) and place it on the desktop. You can also drag the program file icon directly to the Dock.

Configuring AuctionGenie

When you run AuctionGenie for the very first time, you are asked to complete a Preferences form. The information you enter on this form is needed to allow AuctionGenie to automatically place bids on eBay, submit new auctions listings, upload picture files for items you're selling, and to tailor its behavior just for you.

AuctionGenie Preferences
The AuctionGenie Preferences form.

The AuctionGenie Preferences form is divided into nine sections:

Click the Save button when you have completed the Preferences form. You can change the values at any time by choosing the Preferences command from the AuctionGenie menu.

eBay Authorization

Before you can use AuctionGenie to communicate with eBay, you must authorize AuctionGenie to access your eBay account on www.ebay.com. When you run AuctionGenie the first time, an eBay Authorization dialog appears which you can use to do this. (You can also bring up this dialog at any time by choosing the eBay Authorization... command from the AuctionGenie menu. You might want to do this if you change your eBay User ID.)

eBay Authorization
The eBay Authorization dialog.

To provide authorization to eBay, follow these four steps:

  1. Enter your eBay User ID in the field provided in the dialog, then click the eBay Sign In button. This brings up the eBay Sign In page in your browser.
  2. Type in your eBay User ID and Password on the eBay Sign In page, then click the Sign In Securely button.
  3. Another page will appear in your browser asking you to authorize eBay to share your eBay transaction information with AuctionGenie. Click the Agree and Continue button to confirm the authorization.
  4. Return to the dialog in AuctionGenie and click the Confirm Authorization button.
Authorization typically lasts for approximately 18 months, though it can be cancelled by you at any time (from your My eBay page) or, on rare occasions, by eBay management. When authorization is about to expire, or has expired, you will again see the eBay Authorization dialog when you start up AuctionGenie.

Quick Guide to Using AuctionGenie

Following this section is a detailed reference to using all the capabilities of AuctionGenie. The purpose of this section, however, is to provide a quick overview of how to use AuctionGenie for the most common buying and selling actions. Begin by firing up your internet connection and launching AuctionGenie.

Using AuctionGenie

The main AuctionGenie window is a master control panel for your local eBay Bidding and Selling databases. It is organized into four tabbed panels: Buying, Wins, Selling, and Post-Sales. To activate a panel, click its tab.

The Buying panel deals with auctions you are bidding on that are still in progress whereas the Wins panel manages activities relating to closed auctions that you're monitoring. The Selling panel deals with auctions involving items that you are selling; the Post-Sales panel manages activities relating to closed auctions. Each panel hosts a group of command buttons that you use to perform a related set of common operations.

Choose the AuctionGenie Reference Manual item in the AuctionGenie Help menu to show the reference manual (this document) in your web browser. Choose eBay Auction Category Numbers to show the list of available auction category numbers and their corresponding names. The eBay Auction Category Chooser item shows a hierarchical list of categories that you can quickly browse through to locate a category of interest. Since eBay changes its categories from time to time, you should periodically use the Check for Auction Category Numbers Update... command in the Help menu to update AuctionGenie's category file. Because of the large number of categories, an update takes several minutes to complete even with a high-speed internet connection, so be patient.

Buying Panel. The command buttons in this panel let you add auctions to the bidding database (by entering Auction ID numbers directly, by extracting information automatically from a browser that's showing an eBay auction listing page, or by importing from the eBay system all auctions you've previously bid on), display a list of open auctions, and update bidding statistics. (If you want to place a bid, you must do so directly from the item's listing page on the eBay site.)

Buying Panel
The AuctionGenie Buying panel.

The command buttons in the Buying panel are as follows:

Wins Panel. The command buttons in this panel let you perform a variety of activities on closed auctions, such as viewing lists of auctions won, lost, not yet paid for, not yet received, etc. You can also create and send feedback on sellers as well as create transaction status reports for delivery to sellers via email.

After you win an auction it is important that you promptly add key information to its record in the eBay Bidding database. This allows you to track the auction properly through completion and ensures that the lists shown by many of the commands in the Wins panel are accurate. The information you need to add includes the seller's contact information, the date when you received the seller's notification to pay, the date when you sent payment, the amount you paid, and the date when you received the item. Enter this information while in the Detail view of the auction record. (See The eBay Bidding Database section below for a description of the bidding database view modes.)

Wins Panel
The AuctionGenie Wins panel.

The command buttons in the Wins panel are as follows:

Selling Panel. The command buttons in this panel let you show open auctions, create new auctions, show new auctions not yet listed, submit auctions to eBay for listing, update bidding statistics, and relist auctions that did not sell.

Selling Panel
The AuctionGenie Selling panel.

The command buttons in the Selling panel are as follows:

Post-Sales Panel. The command buttons in this panel let you perform a variety of activities on closed auctions, such as viewing lists of winning bidders, auctions not sold, and auctions not yet paid for. You can also create and send feedback on buyers as well as create transaction status reports for delivery to buyers via email.

After an auction successfully concludes it is important that you promptly add key information to its record in the eBay Selling database. This allows you to track the auction properly through completion and ensures that the lists shown by many of the commands in the Post-Sales panel are accurate. The information you need to add includes the buyer's contact information, the date when you received the buyer's confirmation, the date you received payment, the amount paid, and the date when you shipped the item. Enter this information while in the Detail view of the auction record. (See The eBay Selling Database section below for a description of the view modes.) Note that AuctionGenie automatically enters the date when you notify new winning bidders to pay using the Notify New Winning Bidders command, so there's no need to enter it manually.

It is also a good idea soon after an auction closes to delete its associated picture files from your FTP site, especially if you have limited space on your site. You can use an FTP client program such as Fetch, Interarchy, or Transmit to do this or, if you're using AOL, AOL's FTP utilities (keyword FTP).

Post-Sales Panel
The AuctionGenie Post-Sales panel.

The command buttons in the Post-Sales panel are as follows:

The eBay Bidding Database

Viewing. The eBay Bidding database organizes the data for all the auctions you've added to it from the Buying panel. The database supports three primary views you can use to inspect each auction. One is the List view where several auctions are shown in the database window at once but with only one line of information per auction. A second is the Gallery view which is a list of auctions that shows the auction title, description, and thumbnail picture as well as price and bidding information for each auction. The third is the Detail view where only one auction is shown in the window, but all information tracked for the auction is shown.

Two other views, the Print view and the Reports view, are also available. You can switch between views using the icon buttons that appear at the top of most database windows.

Print View

The Print view can be used to print mailing labels, a transaction record, and a standard cover letter directed to the seller of an auction item you've won. You can enclose this letter with your check when you send payment to the seller. See the section Printing Mailing Labels, Packing Lists, Cover Letters, and Transaction Records, below, for more information on Print view.

Reports View

The Reports view lets you prepare a report that summarizes lists of transactions. There are five different report types: Auction Items Won, Auction Items Not Won, Auctions Still Open, All Auctions, and Current Found Set of Items.

There are three different report styles: Sorted by Close Date with monthly subtotals, Sorted by Close Date with no subtotals, and Sorted by Category. All three styles include grand totals for number of transactions, average response time, amount payable, amount paid, and mailing costs. The first style also includes monthly subtotals.

You can choose one of the following transaction periods for the report: Any time, Year-to-date, Current month, Current quarter, Last month, Last quarter, Last year, and Last year-to-date.

Note that the report style and period selections are ignored if the report type is Current Found Set of Items because all the items in the current found set are used in their current order for this report type. If you want the items to be sorted in the report, you must sort them explicitly before generating the report. For the three report styles supported, specify a sort order that begins with closeMonth, closeDate, or auctionCategory, respectively. See the discussion of how to use the Sort command of the database near the end of this section.

After you select the report type, the period, and the report style, click the Print Report button to print the report or the Show Report button to preview it on the screen. When you preview a report, move from page to page in the document by clicking on the top and bottom portions of the card catalog icon on the left side of the window. To return to the Reports view, click the Continue button on the left side of the database window.

List View
The List view of the eBay Bidding database.

List View

The fields included in the List view, from left to right, are:

Note that you can sort the records shown in List view by any field by clicking the name of the field at the top of the window. Reverse the order of the sort by holding down the Command key.

Gallery View
The Gallery view of the eBay Bidding database.

Gallery View

Gallery view is another type of list view that shows, for each item, a thumbnail picture, title, description, start price, current bid, high bidder, close price, close time, and the time remaining until the auction closes. You can also enter the amount of your next bid here.

Note that the time remaining is initially calculated when you first enter Gallery view and is not automatically updated; to update the time remaining values, click the refresh icon to the left of the field.

Three icons to the left of the picture allow you to view the official eBay listing page for the item (link icon), go to Detail view for the item in the eBay Bidding database (magnifying glass icon), or delete the item from the eBay Bidding database (red x icon). You can click the thumbnail picture to bring up a larger view of the picture.

Detail/Item View
The Item Info panel of the Detail view of the eBay Bidding database.

Detail View

The fields in the Detail view are organized into three main panels: Item Info, Result, and Seller Info. The fields, from left to right and top to bottom, are: Item Info Panel:
Detail/Result View
The Result panel of the Detail view of the eBay Bidding database.

Result Panel:

Note that the response time, the number of days between the date you sent payment and the date when you received the item from the buyer, is shown at the bottom of this panel. This value is automatically filled in by AuctionGenie when both of these dates have been entered. Also at the bottom of the panel is the eBay User ID of the seller.

Also shown at the bottom of the panel is the Bidding History for the auction — this is a list of who bid what amount at what time (only the highest bid made by each bidder is shown). This field is automatically filled in by AuctionGenie when the auction closes. Click the Bidding History field label to bring up eBay's complete bidding history page for the item in your web browser.

Two buttons at the very bottom of the panel allow you to print mailing labels or a cover letter relating to the transaction. For more information, see the Printing Mailing Labels, Packing Lists, Cover Letters, and Transaction Records section below.

Detail/Seller View
The Seller Info panel of the Detail view of the eBay Bidding database.

Seller Info Panel:

At the bottom of this panel is a Show Seller Auctions Page button you can click to view in your web browser a list of all the seller's eBay auctions. (Hold down the Command key when you click to include closed auctions in the list.) Another button, Show Seller Feedback Page, lets you view the seller's eBay feedback page.

Three other buttons allow you to print mailing labels, a cover letter, and a transaction record relating to the transaction. For more information, see the Printing Mailing Labels, Packing Lists, Cover Letters, and Transaction Records section below.

At the very bottom of the panel is a list of other items sold by this seller which you have saved in the eBay Bidding database. If you were the winning bidder for a particular item, a ✓ appears on the right side of the item's line. Click on an item's line to go directly to the corresponding record in the database.

Note the Copy Address button opposite the seller's last name field. Click it to copy the entire mailing address to the clipboard.


You will probably use the List view most often because it provides a convenient snapshot of all your auction activity (or at least that portion that hasn't scrolled out of view). The Detail view is needed to access information not included in the List view and is most often used to enter and view the name and address of the seller for auctions you've won as well as post-auction information such as dates of payment and delivery. The easiest way to get to the Detail view for a particular auction is to start in List view, select the auction by clicking in any of its fields, then switch to Detail view.
Navigating. Moving from one auction record to another in the bidding database is straightforward. In List view, simply scroll until the line containing the auction of interest is visible, then click in any field on the line. (A small black bar in the left margin indicates the current record.) In Detail view, click the bottom portion of the card catalog icon in the top-left corner of the window to move forward one record; click the top portion to move to the previous record. Once you've moved to a record of interest, you can edit it by clicking the mouse in the field you want to change; you can also use the Tab key to move between fields.

Note that once you have selected an auction in the bidding database, you can display its eBay auction listing page in your web browser by clicking the link icon next to the Auction ID number.

Searching. Use the Find Mode command in the View menu to search the bidding database for a group of auctions that satisfy particular criteria. When you enter the command, a blank search form appears. Simply enter what you're looking for in the appropriate fields (switch to a different view if necessary), then click the Find button on the left side of the database window.

Here are some useful searching tips:

After a search, you may want to omit some auctions from the set of found auctions because you don't want to include them in a follow-up operation such as printing or sending transaction status reports. To temporarily omit an auction, click in any field for the auction, then choose the Omit Record command in the Records menu. It is important to realize that omitting is not the same as deleting; an omitted auction is still in the database, a deleted one is gone forever.

Searching, by its nature, restricts the set of auctions being shown to those that match the search criteria (the found set). To restore the set to all the auctions, use the Show All Records command from the Records menu.

Note that if you go to Find mode and then decide not to perform a search, you can return to viewing the auction records by choosing the Browse Mode command from the View menu.

Sort
The Sort Records dialog.

Sorting. To sort the found set of records, first select the Sort command from the Records menu. In the Sort Records dialog that appears, click the Clear All button to remove the current sort order. To specify a field to be sorted, click its name in the Field List, then click the Move button to move it to the Sort Order list. (Repeat for other fields, as desired.) Click the Sort button to perform the sort. (See Appendix 1 for the meanings of the most common fields in the database.)

Records are sorted by the first field in the Sort Order list. Records with the same value in this field are sorted by the second field specified, and so on. You can change the order of the fields in the Sort Order list by dragging the double arrow to the left of the field name up and down the list.

Deleting. Deleting auctions from the database is necessary from time to time in order to purge obsolete records that waste space on your hard drive and slow AuctionGenie operations. The general recommendation is to retain all open auctions and all those auctions where you were the winning bidder, but to delete others soon after they close. Of course, you may want to keep even losing auctions around if they serve some useful purpose such as making it easier to monitor price trends.

Deleting an auction is very easy, but remember that it's an action that cannot be reversed. To delete an auction, click the Delete Auction icon button at the top of the window in Detail view or the red x on the auction's line in List view. (Thrill-seekers can hold down the Command key to avoid the confirmation dialog.)

Printing. Use the Print command in the File menu of the bidding database to print an individual auction record or all the auction records currently being browsed. If you print when List view is active, you probably want to print all the auction records, so choose AuctionGenie DB in the third popup menu in the Print dialog, then click the Records being browsed radio button in the bottom portion of the Print dialog before clicking the Print button. If you're in Detail view, you probably want to print just the one auction you're looking at, so click Current record instead. Note that you should click the Print icon at the top of the window in Detail view, or the similar icon on an auction's line in List view, to perform three specialty printing operations for a particular auction — printing mailing labels, a transaction record, and a standard packing list (or a cover letter, for the Bidding database).

Using the Auctions Menu. The Auctions menu includes several commands you can use to show various groups of auctions. They are similar in function to many of the command buttons found on the Bidding and Wins panels of the AuctionGenie Panel. There are also commands to show in your web browser the eBay Auction Listing page for the currently selected auction, your My eBay page, and your eBay Feedback page. In List view, two rows of "Show" buttons near the top of the window can also be used to display common groups of auctions.

The eBay Selling Database

Viewing. The eBay Selling database organizes the data for all the auctions you've added to it from the Selling panel. The database supports two primary views you can use to inspect each auction. One is the List view where several auctions are shown in the database window at once but with only one line of information per auction. The other is the Detail view where only one auction is shown in the window, but all information tracked for the auction is shown.

Three other views, the Print view, the Report view, and the Defaults view, are also available. You can switch between views using the icon buttons that appear at the top of most database windows.

Print View

The Print view can be used to print mailing labels, a transaction record, and a standard packing list directed to the successful bidder in your auction. You can include this packing list when you ship the item to the buyer. See the section Printing Mailing Labels, Packing Lists, Cover Letters, and Transaction Records, below, for more information on Print view.

Reports View

The Reports view lets you prepare a report that summarizes lists of transactions. There are five different report types: Auction Items Sold, Auction Items Not Sold, Auctions Still Open, All Auctions, and Current Found Set of Items.

There are three different report styles: Sorted by Close Date with monthly subtotals, Sorted by Close Date with no subtotals, and Sorted by Category. All three styles include grand totals for number of transactions, average response time, amount receivable, amount received, and mailing costs. The first style also includes monthly subtotals.

You can choose one of the following transaction periods for the report: Any time, Year-to-date, Current month, Current quarter, Last month, Last quarter, Last year, and Last year-to-date.

Note that the report style and period selections are ignored if the report type is Current Found Set of Items because all the items in the current found set are used in their current order for this report type. If you want the items to be sorted in the report, you must sort them explicitly before generating the report. For the three report styles supported, specify a sort order that begins with closeMonth, closeDate, or auctionCategory, respectively. See the discussion of how to use the Sort command of the database near the end of the previous section.

After you select the report type, the period, and the report style, click the Print Report button to print the report or the Show Report button to preview it on the screen. When you preview a report, move from page to page in the document by clicking on the click the top and bottom portions of the card catalog icon on the left side of the window. To return to the Reports view, click the Continue button on the left side of the database window.

Defaults View

The Defaults view is handy for specifying the standard or default values to be used for fields in the Item Info panel of an auction record whenever you create a new auction record in the eBay Selling database. New records are created with the Create New Auction command in the Selling panel or the New Auction icon button at the top of the database window in List view.

List View
The List view of the eBay Selling database.

List View

The fields included in the List view, from left to right, are:

Note that you can sort the records shown in List view by any field by clicking the name of the field at the top of the window. Reverse the order of the sort by holding down the Command key.

Detail/Item View
The Item Info panel of the Detail view of the eBay Selling database.

Detail View

The fields in the Detail view are organized into four tabbed panels: Item Info, Result, Buyer Info, and Inventory. To go to a panel, click the name of its tab. The fields, from left to right and top to bottom, are: Item Info Panel (to be completed when you create a new auction; as noted above, the initial values for fields in this panel are those specified in the Defaults view):