Unable to Retrieve Shipping Label Costs and Specific Order Earnings via API

[propabilia]

Hello fellow eBay Developers,

I'm reaching out for assistance or guidance regarding an issue I've encountered with the eBay APIs. I'm currently trying to access detailed costs associated with specific orders, particularly the costs of shipping labels and the total earnings for individual orders. The main goal of this endeavor is to either get the label cost or the final Order earnings value in Order details.

I've explored various APIs including the Fulfillment API, Finance API, and others, under the scopes:

• https://api.ebay.com/oauth/api_scope/sell.fulfillment.readonly
• https://api.ebay.com/oauth/api_scope/sell.finances

Despite this, I seem unable to locate any API endpoint that provides the specific data for shipping label costs or a detailed breakdown of order earnings (including such costs). Here’s what I’ve tried:

• Fulfillment API: Checked for any shipping-related costs associated with the order details.
• Finance API: Looked for transaction details hoping to find shipping costs included.

Unfortunately, neither approach has yielded the specific costs related to shipping labels. I suspect this data might not be directly available through the APIs, but I wanted to confirm:

1. Is there any API or combination of APIs that I might have overlooked that could provide this data?
2. Are shipping label costs and specific order earnings details typically accessible through eBay APIs, or are they only available via the eBay Seller Hub?
3. If currently unavailable through the API, are there plans to include this kind of data in future API updates?

Any insights, suggestions, or guidance on how I might be able to retrieve this information would be greatly appreciated. Also, if anyone has devised workarounds, I’d be keen to hear about their approaches.

Thank you for your help!

Cheers,

Max

[developer_support@ebay]

Hi @propabilia,

You can execute the getTransactions call of Finances API to get the details on shipping label transactions.

[propabilia]

Hi developer_support@ebay ,

When executing the getTransactions call of Finances API, the vast majority of orders that have been shipped do not have shipping label information.

I execute this call:

https://apiz.ebay.com/sell/finances/v1/transaction?filter=orderId:{{{order_id}}}

This returns a dictionary of the transaction information relating to that order id. However, the shipping label information is missing. Sometimes, it shows up as 'SHIPPING_LABEL'. Usually, the field is not there.

Whenever I previously attempted to filter by SHIPPING_LABEL, it often was not present, returning an empty field.

Cheers,

Max

[my_hidden_treasure_trove_llc]

Hello

There is one serious problem with this API if you use the Bulk Shipping option to buy your shipping labels for multiple orders at once.   Presently, this API will show you the *combined* value of the UPS shipping labels that you purchased for multiple orders (if you purchased multiple UPS shipping labels).  This might be the case for other carriers too.  

I recently did this with two orders where the shipping labels were $6.13 and $6.49 respectively, but this API is showing the shipping amount I paid on each order as $12.62. This is incorrect as this is the *combined* shipping amount for two orders where the shipping label for both of them was purchased at the same time using the Bulk Shipping option.  Your API needs to show this as the $6.13 and $6.49 respectively on the appropriate orders.

This page will show you the proper breakouts, but I can't find the API that it's using to pull this sublevel of detail.  It's fine if we have to call another API to get this sublevel breakdown, but I don't see any other way.  I replaced my actual real life Transaction ID with MY_TRANSACTION_ID in the link, but you could  do a Find/Replace looking for that string and putting in a real life one.  

https://www.ebay.com/mes/transactiondetails?sh=true&transactionId=MY_TRANSACTION_ID&type=SHIPPING_LA...

Is there some way that we can get access to this API to pull the proper level of subdetails?  Even this page is an excellent resource for this information, but again we can't figure out the API that's feeding it.  You can literally just take what's feeding this page and give it to us an API end link and solve this issue for everyone once and for all.  Would probably take less than a day.  This has been a problem on this platform for years and no one can figure it out.  

https://www.ebay.com/ship/labels/seller-hub

[propabilia]

Hi developer_support@ebay ,

Whenever I call the getTransactions call, I receive a list of shipping label costs. However, these do not line up with the most recently sold and shipped items. It seems that the item only appears in this list once it has been completely delivered.

This is very awkward since the shipping label cost is readily available as soon as I purchase the label. Is there any other way around this? I want to match my latest orders to these labels but since they haven't delivered yet or for other reasons a lot of the entries are missing.

[thunderandrainsales]

Did you ever find a solution or workaround to this? I am running into the same problem.

[campvek]

I am trying to figure out the same thing....Anybody have an update?

[jeche_10]

Thanks for sharing such great information, I highly appreciate aarp-membership your hard-working skills as the post you published have some great information which is quite beneficial for me.

[bccardsllc]

Man, I have been trying to solve this issue all weekend and it has been a nightmare. Came across this thread and realized it is a common issue for everyone and the API is lacking for what most of us need when it comes to retrieving shipping label costs bought through eBay. The 'GetOrders' endpoint of the eBay Trading API has a 'ActualShippingCost' field which if you pass your savings on the labels along to the buyer, any order that the buyer paid for shipping will be returned correctly. The issue I am having is if I offer free shipping, then there is an issue that the 'ActualShippingCost' field for whatever reason is returned as zero, throwing off the net sale calculations I have for that order. I have tried making calls to the Finance API to retrieve all sorts of shipping information and have had no luck. If anyone has an answer to this solution please share.

[my_hidden_treasure_trove_llc]

Sadly no, there is still no solution to this.  I thought it was just me that found their API to be confusing and limited but it seems like others are experiencing these issues too.   This data clearly exists in their system because when you click on the order details, it'll show you the shipping cost that you paid even if doing free shipping.   They just don't open up this aspect of their system with their API for some reason and it's baffling.