{
  "info": {
    "_postman_id": "30f6b6ed-1720-4f8a-9306-857641ff1736",
    "name": "sparehub_store_reports",
    "description": "Store-only reports collection.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "variable": [
    { "key": "baseUrl", "value": "http://127.0.0.1:8000/api" },
    { "key": "store_token", "value": "" },
    { "key": "from", "value": "2026-04-01" },
    { "key": "to", "value": "2026-04-30" },
    { "key": "limit", "value": "10" }
  ],
  "auth": { "type": "noauth" },
  "item": [
    {
      "name": "Store Reports",
      "description": "Requires store token with permission reports.view",
      "item": [
        {
          "name": "GET Reports Summary",
          "request": {
            "auth": {
              "type": "bearer",
              "bearer": [{ "key": "token", "value": "{{store_token}}", "type": "string" }]
            },
            "method": "GET",
            "header": [{ "key": "Accept", "value": "application/json" }],
            "url": {
              "raw": "{{baseUrl}}/store/reports/summary?from={{from}}&to={{to}}",
              "host": ["{{baseUrl}}"],
              "path": ["store", "reports", "summary"],
              "query": [
                { "key": "from", "value": "{{from}}", "description": "optional, date" },
                { "key": "to", "value": "{{to}}", "description": "optional, date >= from" }
              ]
            },
            "description": "Returns cards including orders_count, total_sales, discounts, acceptance_rate, sold products, top sold products."
          }
        },
        {
          "name": "GET Reports Orders",
          "request": {
            "auth": {
              "type": "bearer",
              "bearer": [{ "key": "token", "value": "{{store_token}}", "type": "string" }]
            },
            "method": "GET",
            "header": [{ "key": "Accept", "value": "application/json" }],
            "url": {
              "raw": "{{baseUrl}}/store/reports/orders?from={{from}}&to={{to}}",
              "host": ["{{baseUrl}}"],
              "path": ["store", "reports", "orders"],
              "query": [
                { "key": "from", "value": "{{from}}", "description": "optional, date" },
                { "key": "to", "value": "{{to}}", "description": "optional, date >= from" }
              ]
            },
            "description": "Orders table: user_name, user_mobile, order_number, products_in_order, bill_details, user_rate."
          }
        },
        {
          "name": "GET Top Sold Products",
          "request": {
            "auth": {
              "type": "bearer",
              "bearer": [{ "key": "token", "value": "{{store_token}}", "type": "string" }]
            },
            "method": "GET",
            "header": [{ "key": "Accept", "value": "application/json" }],
            "url": {
              "raw": "{{baseUrl}}/store/reports/top-sold-products?from={{from}}&to={{to}}&limit={{limit}}",
              "host": ["{{baseUrl}}"],
              "path": ["store", "reports", "top-sold-products"],
              "query": [
                { "key": "from", "value": "{{from}}", "description": "optional, date" },
                { "key": "to", "value": "{{to}}", "description": "optional, date >= from" },
                { "key": "limit", "value": "{{limit}}", "description": "optional, 1..100" }
              ]
            },
            "description": "Top sold products list for current store only."
          }
        },
        {
          "name": "GET Reports Export (CSV)",
          "request": {
            "auth": {
              "type": "bearer",
              "bearer": [{ "key": "token", "value": "{{store_token}}", "type": "string" }]
            },
            "method": "GET",
            "header": [{ "key": "Accept", "value": "text/csv" }],
            "url": {
              "raw": "{{baseUrl}}/store/reports/export?from={{from}}&to={{to}}",
              "host": ["{{baseUrl}}"],
              "path": ["store", "reports", "export"],
              "query": [
                { "key": "from", "value": "{{from}}", "description": "optional, date" },
                { "key": "to", "value": "{{to}}", "description": "optional, date >= from" }
              ]
            },
            "description": "Downloads CSV for report orders."
          }
        }
      ]
    }
  ]
}