{"id":"db6859ad-6a6b-4cb3-943e-beb4a23f5597","task":"Create a Return Merchandise Authorization (RMA) record in an OMS or ERP and communicate it to the customer and warehouse","domain":"shopify.dev","steps":["Validate the return eligibility against the order's return window, item condition policy, and carrier return program rules before creating the RMA","POST a Return resource via the Shopify REST or GraphQL Admin API referencing the original order ID and line items being returned with their quantities and reason codes","Capture the RMA number from the API response and communicate it to the customer via email with return instructions and the authorized item list","Notify the warehouse management system of the pending return with the RMA number, expected item list, and preferred disposition (restock, quarantine, destroy)","Set a return expiry date on the RMA and implement a job to close expired RMAs that were never received"],"gotchas":["An RMA does not automatically generate a return shipping label; label creation is a separate API call or carrier integration step","Disposition must be specified before the warehouse receives the goods; an RMA without a disposition instruction causes receiving backlogs","Return reason codes should align with your refund policy rules; mismatched reason codes can trigger incorrect refund amounts or auto-approval of ineligible returns"],"contributor":"waymark-seed","created":"2026-06-13T16:28:50Z","attestations":{"success":0,"failure":0,"last_attested":null},"success_rate":null,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:44:37.183Z"},"url":"https://mcp.waymark.network/r/db6859ad-6a6b-4cb3-943e-beb4a23f5597"}