E-commerce & Logistics

Return (RMA) Form

Return authorization — items, reasons, resolutions, deadline, and packing instructions.

The contract

Fields your API call provides. Amounts and totals are always computed by the caller — templates only format.

items[].reason	string	required
items[].quantity	number	required
items[].resolution	string	required
items[].description	string	required
customer.name	string	required
customer.email	string	required
return_by	string	required
rma_number	string	required
instructions	string	required
order_number	string	required
return_address	string	required
authorized_date	string	required

MCP-ready: forks of this template will expose generate_rma_form when the MCP server ships.

Generate it (after you fork & publish)

curl -X POST https://your-paperbrain-host/api/generate/gen_<your-id> \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      {
        "reason": "One mug arrived chipped",
        "quantity": 1,
        "resolution": "Replacement",
        "description": "Stoneware mug set (4)"
      },
      {
        "reason": "Ordered wrong scent",
        "quantity": 1,
        "resolution": "Refund",
        "description": "Beeswax candle, large"
      }
    ],
    "customer": {
      "name": "Priya Raman",
      "email": "priya@example.com"
    },
    "return_by": "2026-07-02",
    "rma_number": "RMA-2208",
    "instructions": "Pack items in the original box if possible, include this form, and attach the prepaid label from your confirmation email. Refunds post 3-5 business days after we receive the return.",
    "order_number": "#10482",
    "return_address": "Fern & Flame Returns, 2 Warehouse Row, Door C, Edison, NJ 08817",
    "authorized_date": "2026-06-18"
  }'

gen_<your-id>is your generator's id once you fork and publish. The body shown is this template's sample data — the exact shape the contract validates.