With version 705 and above, you can take advantage of the updates made to the GetOrders API call to manage your orders using the Trading API.
You can get your orders based on one of these filters:
|Filter||Use Case||Filter Sample|
|Order creation time||Get the information about an order only for the first time when it is created. No subsequent updates are required.||
|Order modification time||Get all updates about an order such as updates to payment & shipping status||<ModTimeFrom>2011-01-01T01:00:00.000Z</ModTimeFrom>
|OrderID||Get information about specific orders||<OrderIDArray>
Here are the recommended steps for getting the transaction information and managing your orders:
When you are in the process of downloading your orders, ensure that you do not make any updates such as marking items as paid or shipped using the website or CompleteSale. Please see the following KB article for more details:
Transactions missing in GetSellerTransactions response
How can I match up my eBay transactions with my PayPal transactions?
In the ExternalTransaction container, the ExternalTransactionID field is the the PayPal TransactionID. You can use this to sync up with the PayPal IPNs, APIs or reports. You need to ensure that you have set the DetailLevel field to ReturnAll when you make the request.
See this KB article for more details:
Linking eBay and PayPal Transactions
Can the composition of an order change?
As long as an order is not in the Completed state, its composition can change.
Here are a few examples:
· Buyer Purchases 2 items from the same seller - ItemID1, ItemID2
· Seller creates an order OrderID1 containing ItemID1 & ItemID2, so that buyer can combine payments of both the items
· Buyer chooses to pay for items individually
· OrderID1 becomes defunct
· Buyer Purchases 3 items from the same seller - ItemID1, ItemID2, ItemID3
· Seller creates an order OrderID1 containing ItemID1, ItemID2 & ItemID3, so that buyer can combine payments of both the items
· Buyer completes checkout and pays for ItemID1 & ItemID2
· OrderID1 becomes defunct, new Order OrderID 2 is created for ItemID1 & ItemID2
· Since OrderID2 is in a Completed state, buyer or seller cannot add ItemID 3 to it.
· Buyer Pays for ItemID 3. This becomes a separate order OrderID3.