ordercloud-api / oc-documentation

MIT License
2 stars 63 forks source link

Walk through description of /me/orders incorrect #504

Open dsolovay opened 1 year ago

dsolovay commented 1 year ago

https://ordercloud.io/learn/buyer-perspective/adding-line-items desribes the /v1/me/orders endpoint as being able to retrieve the ID of a just created order. In my experience, it will only return an order that has been submitted. (I've tested this twice.) The guide should be updated to suggest people note the order ID after the create empty order step, as it will be needed in the subsequent steps.

This language is no longer accurate:

If you don't remember it, fear not - buyer users can view their orders using the My Orders resource. This will provide a list of orders that have the currently authenticated user as the FromUser.

The discussion of /v1/me/orders in the API documentation should also be updated to clarify that only "Open" orders are retrievable.

crhistianramirez commented 1 year ago

@dsolovay thanks for bringing light to this, there was a change to the API introduced with premium order search and it seems some of these tutorials weren't updated.

It is actually possible to retrieve unsubmitted orders but it requires an additional filter. See number 1 in limitation in gotchas