amzn / selling-partner-api-models

This repository contains OpenAPI models for developers to use when developing software to call Selling Partner APIs.
Apache License 2.0
585 stars 730 forks source link

[BUG] Documentation - getOrderBuyerInfo depreciation date and expected GetOrders behaviour #2249

Closed IgniteMosquito closed 1 year ago

IgniteMosquito commented 2 years ago

Based on this documentation: https://developer-docs.amazon.com/sp-api/docs/orders-api-v0-reference#getorderbuyerinfo, the endpoint should be depreciated last month. Although, I see it is still live, and the getOrders endpoint (BuyerInfo object) is null, while getOrderBuyerInfo gives us the data. To be clear, we do not have PII, but we can still retrieve the @marketplace.amazon.xxx buyer email from the "soon-to-be-depreciated" endpoint.

Do you know if there are any changes in dates? We want to build the final integration, but we also don't want to use something that will be depreciated.

Apologies if it has been mentioned somewhere, but I wasn't able to find any related issue.

bpyzikvc commented 2 years ago

@IgniteMosquito A depricated endpoint means that it will still work but will no longer be supported or updated. You COULD continue to use it but I would suggest taking advantage of the newest update for Get Orders that returns buyer info in the same call. What you need to do to make the buyerinfo object not null is to use a restricted data token generated with the following info.

'{ "restrictedResources": [ { "method": "GET", "path": "/orders/v0/orders", "dataElements": ["buyerInfo", "shippingAddress"] }, { "method": "GET", "path": "/orders/v0/orders/{orderId}/orderItems", "dataElements": ["buyerInfo"] } ] }'

If you use a restricted data token in place of the access token for get orders and get order items you will get the same amount of info that used to take 5 full api calls. Good luck!

github-actions[bot] commented 1 year ago

This is a very old issue that is probably not getting as much attention as it deserves. We encourage you to check if this is still an issue after the latest release and if you find that this is still a problem, please feel free to open a new issue and make a reference to this one.

github-actions[bot] commented 1 year ago

closed for inactivity