Tax Report

Per-store tax amounts derived from platform commission for a date range.

Endpoint

GET /v1/products/audit/tax-report/

Authentication

Required (Admin role).

Query Parameters

Parameter	Type	Required	Description
start_date	string	No	Inclusive start date YYYY-MM-DD (default: 2000-01-01)
end_date	string	No	Inclusive end date YYYY-MM-DD (default: today)
store_id	int	No	Filter by store

Response (200)

{
  "period": {
    "start_date": "2025-12-01",
    "end_date": "2025-12-20"
  },
  "data": [
    {
      "store_id": 12,
      "store_name": "Electro World",
      "platform_profit": 1125.08,
      "tax_due": 202.51,
      "tax_paid": 0,
      "tax_unpaid": 202.51,
      "records": 42
    }
  ]
}

Notes: - Tax is calculated from platform profit using the global tax percent. - Paid/unpaid values are placeholders until tax settlement tracking is added. - Dates are inclusive; end_date works through December 20 (and beyond).