Development of Reseller/Marketer Selling Module (updated)

1. Module Goal (Business Objective) This module enables sellers to expand their sales channels through marketers or resellers in a flexible, automated, and fully controllable way, while ensuring transparent profit calculation and settlements for all parties. The module allows the seller to: • Enable selling via marketers: o For all products o For one or multiple categories o For specific products • Set a fixed reseller cost that includes: o Base product price o All reselling-related costs o Applied at:  Product level  Category level  Single product level • Allow marketers to freely set the final selling price • Automate order, shipping, and payment management With guaranteed: • Accurate seller profit calculation • Clear marketer profit calculation • Platform commission calculation • Organized and transparent monthly settlements Mobile App Update Requirement: • The existing Flutter mobile applications for Android and iOS must be updated to include all features described in this module. • The mobile apps must fully replicate the functionality of the web platform, including: o Role-based access (Seller, Marketer, Admin) o Pricing, commission, and profit calculations o Order creation, execution, and settlements o Notifications and status updates (order, shipping, payment) o Bulk order processing and Excel uploads 2. System Roles A. Seller The seller is the main decision-maker in this module. Capabilities include: • Enable or disable selling via marketers • Define which products or categories are allowed for resale • Set the minimum selling price calculated as: Minimum Price = Base Price + Reseller Cost • Define reseller cost as: o Percentage of the product price o Fixed additional amount • Prepare and ship orders • Receive earnings • Manage marketers: o Temporarily block a marketer o Restrict a marketer from selling specific products B. Marketer The marketer resells the seller’s products directly to customers. Capabilities include: • View products available for resale • See: o Reseller cost per product o Minimum allowed selling price o Expected profit before order creation • Create direct sales orders without a traditional checkout process • Specify: o Final selling price o Customer details o Courier company o Delivery type • Receive profits directly into their wallet C. Platform (Admin) The platform supervises and ensures system stability. Responsibilities include: • Manage subscriptions and commissions • Rank marketers • Detect marketers with high cancellation rates • Collect platform commission from sellers • Execute monthly settlements Mobile App Update Requirement: • The mobile apps must reflect all seller, marketer, and admin capabilities with the same logic and restrictions as the web system. 3. Pricing Logic Inputs Defined by Seller • Base Price • Investment profit percentage • Fixed additional amount Example: Item Value Base Price 2000 DZD Investment Percentage 10% = 200 DZD Fixed Amount 200 DZD Reseller Cost Calculation: 2000 + 200 + 200 = 2400 DZD Notes: • Price visible only to marketer • Cannot be modified • Represents minimum allowed selling price • Reseller cost should include platform commission if deducted from seller • Enhancement: system calculates seller’s estimated net profit Bulk Orders by Marketers • Submit up to 10 orders for the same product at once • Excel upload feature • System validates prices against reseller cost Example Sale: Party Amount Seller 2400 DZD Marketer 1600 DZD Platform Commission deducted from seller Special Cases • Selling at reseller cost: marketer profit = 0 (allowed only if seller permits) • Selling below reseller cost: programmatically blocked • Pricing changes after order creation: order price remains fixed Stored Order Values • Base Price • Reseller Cost • Final Price • Marketer Profit • Platform Commission These values are locked during the delivery period. Mobile App Update Requirement: • All pricing logic, calculations, and validations must be fully implemented in the Flutter apps, identical to the web platform. 4. Workflow Step 1: Seller Setup • Enable reseller selling • Select products: all, specific categories, or specific products • Set pricing rules (percentage + fixed amount) Step 2: Marketer Interface • Page: Products for Reselling • Displays product details, minimum selling price, and reseller cost Step 3: Order Creation Marketer enters: • Customer name, phone, state/city, address • Courier company, delivery type • Final selling price System automatically creates: • Order • Customer record • Shipment (Pending) Order status: Pending Approval options: • Manual approval by seller or admin • Automatic approval After approval, status changes to Approved / In Progress. Step 4: Order Execution • Export to Google Sheets / Excel • API export to shipping providers (e.g., [login to view URL]) • Order, shipping, and payment updates Seller actions: • View orders • Print delivery notes • Prepare shipments • Hand orders to courier Step 5: Payment & Settlement Once order reaches configured status (Delivered, Paid, or Manually confirmed): • Seller receives reseller cost • Marketer receives profit in wallet • Payment logic follows same structure as web platform Mobile App Update Requirement: • Mobile apps must handle the full order creation, tracking, execution, and wallet settlement workflow, including notifications, approvals, and status updates, exactly as the web platform. 5. Platform Commission & Subscriptions Admin Panel Settings: • Platform commission configuration: percentage + fixed amount per reseller order or fixed monthly subscription • Settings placed under normal sales configuration Seller responsibilities: • Monthly settlements • Automatic monthly reports Mobile App Update Requirement: • Mobile apps must allow sellers and admin to view commissions, reports, and settlements in real time, synchronized with web backend. 6. Restrictions & Advanced Settings Optional Settings: • Maximum daily orders per marketer Reseller Selling Includes: • Seller’s own products • In-house stock products Excludes: • Products from other sellers without explicit permission Order Status Mapping: • Pending • Confirmed • Shipped • Delivered • Delivered – Paid • Returned • Cancelled Advanced Controls: • Define who bears cost of cancelled or failed deliveries • Define profit distribution trigger (Delivered / Paid / Manual confirmation) • Delay marketer profit by X days (anti-fraud) • Allow or prevent selling out-of-stock products Mobile App Update Requirement: • All restrictions, advanced controls, and order statuses must be fully visible and enforceable on the mobile apps, identical to the web platform. References: Active eCommerce CMS [login to view URL] Active eCommerce Flutter App [login to view URL] Active eCommerce Seller App [login to view URL] Note: The shared files “Q&A” and “Project Updates – Feature Enhancements ” are an essential part of the project specification. They complement this job description and must be fully considered and implemented as part of the project requirements.

ID do Projeto: 40164192