Order Returns Lifecycle via API

Hey guys!

I am implementing an app for my own store and I want to get some feedback on the approach I am considering.

I have implemented code to generate orders via API, as well as Fulfilling them. Now I am designing the flow for Order Returns. My plan so far is to create an Order Return via returnCreate mutation (returnCreate - GraphQL Admin) and that seems pretty straight forward. However, when it comes to updating the quantity of the items received I am not sure how to do it. I found the returnProcess mutation in the 2025-07 api release candidate version (returnProcess - GraphQL Admin).

  • Would this work and are there any common issues or nuances I should consider?

  • How do I go about closing the return once all items are received using the returnClose mutation (returnClose - GraphQL Admin)?

  • Also if only some items are received and the remaining are just not expected to be received should I remove them using the returnLineItemRemoveFromReturn mutation and them closing the return?

Sorry about the multiple questions!
Thanks!