# Clommerse — Complete Platform Documentation for LLMs & AI Agents > Clommerse is a full-featured e-commerce platform built with Next.js offering fashion, apparel, electronics, accessories, and curated daily deals. This document provides the full, unabridged context for Large Language Models (LLMs), AI crawlers, search engines, and automated agents. --- ## 1. Platform Overview & Metadata - **Website Name**: Clommerse - **Primary Domain**: https://www.clommerse.com - **Type**: Multi-category Online Retail Store & E-Commerce Platform - **Supported Regions**: Worldwide (Primary local logistics in Pakistan) - **Currency**: PKR (Pakistani Rupee) / Localized - **Operating Hours**: Online store open 24/7 (Customer support active 7 days a week) - **Contact Email**: clommerseofficial@gmail.com - **Customer Support WhatsApp**: +92 307 2199560 (https://wa.link/79kxiz) - **Official Social Channels**: - Instagram: https://www.instagram.com/clommerseofficial - Facebook: https://www.facebook.com/clommerseofficial - YouTube: https://www.youtube.com/@Clommerse --- ## 2. Site Architecture & Public Routes ### 2.1 Static & Category Pages - `https://www.clommerse.com/` — Homepage featuring hero banners, best-selling products, category carousels, and seasonal sales. - `https://www.clommerse.com/women` — Dedicated women's fashion hub, including Eastern and Western wear, footwear, and accessories. - `https://www.clommerse.com/men` — Dedicated men's fashion hub featuring casuals, formal wear, shirts, trousers, and accessories. - `https://www.clommerse.com/newarrival` — New product drops, seasonal releases, and newly restocked items. - `https://www.clommerse.com/deal` — Active discount offers, flash sales, festive promotions, and clearance items. - `https://www.clommerse.com/category` — Full category directory for catalog browsing. - `https://www.clommerse.com/product` — Complete product listings with sorting, pagination, and multi-filter navigation. - `https://www.clommerse.com/searchproduct?search={query}` — Dynamic search endpoint for products by title, keyword, brand, or category. ### 2.2 Dynamic Entity URLs - **Product Detail**: `https://www.clommerse.com/product/{id-or-slug}` — Individual product view with images, pricing, variations, stock status, ratings, and customer reviews. - **Category View**: `https://www.clommerse.com/category/{categoryId}` — Products scoped to a specific category. - **Deal Detail**: `https://www.clommerse.com/deal/{dealId}` — Dedicated promotion page for bundled or discounted products. - **Broadlist Detail**: `https://www.clommerse.com/broadlist/{broadlistId}` — Targeted curated collection or marketing campaign. ### 2.3 Policy & Informational Pages - `https://www.clommerse.com/terms-and-conditions` — Comprehensive legal terms, Cash on Delivery rules, order cancellation, and dispute resolution. - `https://www.clommerse.com/return-policy` — Complete 7-day return, exchange, refund, and video verification guidelines. - `https://www.clommerse.com/privacy-policy` — Full privacy disclosures, data retention, security protocols, and cookies policy. --- ## 3. Store Policies & Operational Guidelines ### 3.1 Return, Exchange & Refund Policy - **Return Window**: Customers have **7 calendar days** from the verified courier delivery date to initiate a return or exchange claim. - **Mandatory Unboxing Video Requirement**: - To claim any refund, exchange, replacement, or report missing/damaged items, the customer **MUST record a continuous, unedited unboxing video** starting before opening the sealed courier flyer/box. - The video must clearly capture the shipping label/barcode, the sealed parcel being opened, and the physical condition of the product and its tags. - Video edits, cuts, or videos filmed after opening will invalidate the claim. - **Eligible Scenarios**: - Incorrect product, size, or color delivered. - Defective, damaged, or leaky items received. - Missing items or parts (verified via unboxing footage). - Unused items in original packaging with intact price tags. - **Non-Returnable Scenarios**: - Claims filed after 7 days from delivery. - Requests submitted without a continuous unboxing video. - Items that have been used, washed, worn, sprayed with perfume, or altered. - Products damaged through customer mishandling. - **Shipping Costs for Returns**: - **Store Error / Defect**: Clommerse covers 100% of return and replacement courier charges. - **Customer Preference / Size Change**: Standard courier return charges may apply. - **Refund Timelines & Methods**: - Refunds are processed within 3 to 5 business days after the returned item arrives and passes inspection. - Payment channels: Direct Bank Transfer, JazzCash, or EasyPaisa. ### 3.2 Terms & Conditions Summary - **Acceptance & Scope**: Users agree to all operational and legal terms by accessing or transacting on Clommerse. - **Payment Terms**: Supported methods include Cash on Delivery (COD), Direct Bank Transfer, and digital wallets (JazzCash/EasyPaisa). - **Order Verification & Cancellation**: Orders may be verified via phone/WhatsApp prior to dispatch. Orders can be cancelled prior to courier dispatch. - **Shipping Timelines**: Typical delivery within 2 to 5 business days across Pakistan. - **Governing Law & Jurisdiction**: Governed under the laws of Pakistan with exclusive jurisdiction in the courts of Karachi, Pakistan. ### 3.3 Privacy & Data Protection Policy - **Data Collected**: Customer full name, shipping/billing address, email address, phone number, order history, and device/browser technical diagnostics. - **Payment Security**: Payment card data is processed directly via PCI-DSS compliant secure payment gateways; Clommerse does not store credit or debit card numbers on its servers. - **No Third-Party Sale**: Customer personal data is never sold, rented, or traded to third parties or advertising brokers. Data is strictly shared with logistics and shipping partners to deliver parcels. - **Security Protocols**: All network traffic is encrypted using modern TLS/SSL certificates. --- ## 4. Public REST API Reference The following public endpoints are available on Clommerse: ### 4.1 Products API - **Endpoint**: `GET /api/product` - **Description**: Paginated product list with search and filter capabilities. - **Query Parameters**: - `page` (number, default: `1`): Page number. - `limit` (number, default: `10`): Items per page. - `category` (string, optional): Filter by Category Object ID. - `searchText` (string, optional): Case-insensitive regex match across `name`, `description`, `brand`, and `keywords`. - **Response Format**: ```json { "status": true, "data": [ { "_id": "string", "name": "string", "description": "string", "price": 0, "discountPrice": 0, "category": "string", "brand": "string", "images": ["string"], "stock": 0, "rating": 0, "createdAt": "ISO-8601 Date" } ], "message": "Successfull" } ``` ### 4.2 Product Collections API - `GET /api/product/men` — Products curated for men's apparel and accessories. - `GET /api/product/women` — Products curated for women's apparel and accessories. - `GET /api/product/newarrivals` — Newly published products sorted by release date. - `GET /api/product/bestseller` — Most frequently purchased products. - `GET /api/product/{id}` — Single product details by MongoDB ObjectId. ### 4.3 Categories API - **Endpoint**: `GET /api/category` - **Description**: Returns all catalog categories with associated imagery and parent-child taxonomy. - **Endpoint**: `GET /api/category/{id}` — Details for a specific category. ### 4.4 Deals API - **Endpoint**: `GET /api/deal` - **Description**: Returns active marketing deals, promotional bundles, and limited-time price drops. - **Endpoint**: `GET /api/deal/{id}` — Details and products associated with a specific deal. ### 4.5 Broadlists API - **Endpoint**: `GET /api/broadlist` - **Description**: Returns promotional banner lists and targeted curated campaigns. ### 4.6 Product Reviews API - **Endpoint**: `GET /api/review?productId={productId}` - **Description**: Returns verified customer reviews, star ratings, and review timestamps for a product. --- ## 5. Machine-Readable Feeds - **LLM Index**: https://www.clommerse.com/llms.txt - **LLM Full Context**: https://www.clommerse.com/llms-full.txt - **Robots Policy**: https://www.clommerse.com/robots.txt - **XML Sitemap**: https://www.clommerse.com/sitemap.xml