Windows application to retrieve eBay transactions

Windows application to retrieve eBay transactions using the .NET SDK.

Summary

This tool is a windows application written in C#, that helps you retrieve transactions via the API.  It makes a call to GetSellerTransactions to get the transactions that were last modified in the user specified time range.  Further, it makes calls to GetOrders if the transactions are a part of an order and updates the transaction information accordingly.

Utility of this tool:

• This tool demonstrates how to get updated information about your transactions and make the necessary API calls
• Mark the Paid & Shipped status for a transaction via the CompleteSale API call, so that the status show up in MyeBay page on the site

You can use this as a reference sample for writing your own transaction management application and add a database component to persist the transactions.  You can also add the functionality to leave feedback and keep track of feedback received / pending, via your database.

Detail Description

Requirements to run this tool:

• .NET Framework 2.0
• Operating System:  Windows XP
  (This tool was built and tested on Windows XP.  It may work with the other versions of Windows, such as Windows 2000 & Windows 2003.)

Optional

• Visual J# .NET Redistributable Package 2.0  to enable compression
  
  This application uses the .NET SDK, which has the ability to compress API requests and responses.  The SDK uses the J# redistributable for compression.  Compression can significantly reduce the time for executing an API call. Compression is turned off by default for this application so that 64 bit machines can run this application.  At the time of writing this article, there is no package available for 64 bit machines. 
  If you are running on a 32 bit machines, then it is strongly recommended that you turn compression on. 
  
  To turn compression on you need to do the following:
      Open the App.Config file in the application installation folder.
      Change value of the key for EnableCompression to true
   

To view the source code / modify code:

• This tool was written using Visual C# 2005 Express Edition .  You can use it to view or modify the code

Installation:
Unzip the contents of the zip file eBayTransaction.zip into one directory

How to use this tool:

• Double click on the executable in the installed folder\bin\Debug\eBayTransactions.exe to start the application.
   
• Step1:  Set your credentials
  • Select the Sandbox or the Production environment for which you want to get the transactions
  • Enter your keys for the environment that you selected.
  • Enter the token for the environment you selected
  • Enable logging if you wish to view the raw SOAP Request and Responses.  You will find the log file in \bin\Debug\Log.txt. 
    This is very useful for debugging.
  • Click Test Setup to verify that you have entered the correct credentials for the selected environment
  • Optionally, you can save the credentials so that it will be pre-populated for you when you run the application the next time
    
             figure 1
   
• Step2:  Get Transactions
  • Set the last modified time date range:
    All transactions that were last modified in this time ranage, will be retrieved. 
    You can either select this time to indicate that it is in GMT or Local Time.  If it is local time, then depending on your time zone, appropriate number of hours will be added to convert it to equivalent GMT.  e.g.  if you in PST, then 7 hours will  be added to the selected time value.

           The application makes calls to GetSellerTransactions with the selected time range. 
           If there are transactions that are part of an order, then it makes call to GetOrders with the OrderIDs and updates the transaction information.
            

  • Optionally, you can save the transaction information as a CSV file.
    

            figure 2
   

• Step 3:   Update Transactions to mark them as Paid & Shipped
  • Select the transactions that you want to mark as Paid & Shipped on the MyeBay page.

    This page shows you all the transactions for which the checkout is complete and have not been marked as paid or shipped.
    You can select the transactions for which to make a call to CompleteSale and mark the transactions as Paid & Shipped by clicking the Update Transaction Status button.

  
  figure 3

• Error - Keys are invalid:
  • Ensure that you have selected the correct environment and have input the keys correctly.
  • Sandbox keys will not work in production and vice versa.
     
• I do not see my transaction when the application gets transactions from eBay:
  • The last modified date for the transaction is not in the range that you specified.  Try changing the date range. 
     
• Could not load file or assembly 'vjslib, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a' or one of its dependencies. The system cannot find the file specified.
  • You do not have Visual J# .NET Redistributable Package 2.0  installed.

Version Info

The tool was was based on the versions specified below:

• Documentation:  Completing the Sale
• Knowledge Base:  Articles related to GetSellerTransactions
                               Articles related to GetOrders

How well did this answer your question?

Answers others found helpful

• Implementing Compression for the Trading API : When and How
• Does the Windows SDK support UTF-8?
• Transactions missing in GetSellerTranasctions or Orders missing in GetOrders response
• .NET SDK error - Could not load file or assembly
• LMS: FeeSettlementReport one time set-up process