{"openapi":"3.0.0","paths":{"/":{"get":{"operationId":"AppController_getHello","parameters":[],"responses":{"200":{"description":""}},"tags":["Health"]}},"/health":{"get":{"operationId":"AppController_health","parameters":[],"responses":{"200":{"description":""}},"tags":["Health"]}},"/payu/checkout-pro-return":{"get":{"operationId":"AppController_payuCheckoutProReturn_get","parameters":[],"responses":{"200":{"description":""}},"tags":["Health"]},"post":{"operationId":"AppController_payuCheckoutProReturn_post","parameters":[],"responses":{"200":{"description":""}},"tags":["Health"]},"put":{"operationId":"AppController_payuCheckoutProReturn_put","parameters":[],"responses":{"200":{"description":""}},"tags":["Health"]},"delete":{"operationId":"AppController_payuCheckoutProReturn_delete","parameters":[],"responses":{"200":{"description":""}},"tags":["Health"]},"patch":{"operationId":"AppController_payuCheckoutProReturn_patch","parameters":[],"responses":{"200":{"description":""}},"tags":["Health"]},"options":{"operationId":"AppController_payuCheckoutProReturn_options","parameters":[],"responses":{"200":{"description":""}},"tags":["Health"]},"head":{"operationId":"AppController_payuCheckoutProReturn_head","parameters":[],"responses":{"200":{"description":""}},"tags":["Health"]}},"/auth/send-otp":{"post":{"operationId":"AuthController_sendOtp","summary":"Send OTP to mobile number","deprecated":true,"description":"Legacy customer path. Prefer POST /auth/customer/send-otp.","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SendOtpDto"}}}},"responses":{"201":{"description":""}},"tags":["Authentication"]}},"/auth/verify-otp":{"post":{"operationId":"AuthController_verifyOtp","summary":"[Legacy] Verify OTP and login (Customer)","deprecated":true,"description":"Prefer POST /auth/customer/verify-otp.","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyOtpDto"}}}},"responses":{"200":{"description":""}},"tags":["Authentication"]}},"/auth/seller/send-otp":{"post":{"operationId":"AuthController_sellerSendOtp","summary":"Send OTP (Seller)","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SendOtpDto"}}}},"responses":{"201":{"description":""}},"tags":["Authentication"]}},"/auth/seller/verify-otp":{"post":{"operationId":"AuthController_sellerVerifyOtp","summary":"Verify OTP and login (Seller)","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyOtpDto"}}}},"responses":{"200":{"description":""}},"tags":["Authentication"]}},"/auth/seller/login-pin":{"post":{"operationId":"AuthController_sellerLoginPin","summary":"Login with 4-digit PIN (Seller, optional alternative to OTP)","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SellerLoginPinDto"}}}},"responses":{"200":{"description":""}},"tags":["Authentication"]}},"/auth/seller/login-options":{"post":{"operationId":"AuthController_sellerLoginOptions","summary":"Seller login UI hints (PIN allowed only after first OTP sign-in)","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SellerLoginOptionsDto"}}}},"responses":{"200":{"description":""}},"tags":["Authentication"]}},"/auth/seller/portal-access/exchange":{"post":{"operationId":"AuthController_exchangeSellerPortalGrant","summary":"Exchange one-time admin seller portal access token","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SellerPortalGrantExchangeDto"}}}},"responses":{"200":{"description":""}},"tags":["Authentication"]}},"/auth/customer/send-otp":{"post":{"operationId":"AuthController_customerSendOtp","summary":"Send OTP (Customer)","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SendOtpDto"}}}},"responses":{"201":{"description":""}},"tags":["Authentication"]}},"/auth/customer/verify-otp":{"post":{"operationId":"AuthController_customerVerifyOtp","summary":"Verify OTP and login (Customer)","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyOtpDto"}}}},"responses":{"200":{"description":""}},"tags":["Authentication"]}},"/auth/refresh":{"post":{"operationId":"AuthController_refreshToken","summary":"Refresh access token","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RefreshTokenDto"}}}},"responses":{"200":{"description":""}},"tags":["Authentication"]}},"/auth/admin/login":{"post":{"operationId":"AuthController_adminLoginNew","summary":"Admin login (AdminUser)","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminLoginDto"}}}},"responses":{"200":{"description":""}},"tags":["Authentication"]}},"/auth/admin/seller-portal-access/{sellerId}":{"post":{"operationId":"AuthController_createAdminSellerPortalGrant","summary":"Create one-time seller portal access link for admin support","parameters":[],"responses":{"200":{"description":""}},"tags":["Authentication"],"security":[{"bearer":[]}]}},"/auth/admin-login":{"post":{"operationId":"AuthController_adminLogin","summary":"[Legacy] Admin login with email and password","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminLoginDto"}}}},"responses":{"200":{"description":""}},"tags":["Authentication"]}},"/auth/me":{"get":{"operationId":"AuthController_getProfile","summary":"Get current user profile","parameters":[],"responses":{"200":{"description":""}},"tags":["Authentication"],"security":[{"bearer":[]}]}},"/notifications/test":{"post":{"operationId":"NotificationsController_sendTest","summary":"Send a test notification to a token (for debugging)","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TestNotificationDto"}}}},"responses":{"201":{"description":""}},"tags":["notifications"],"security":[{"bearer":[]}]}},"/notifications/register-device":{"post":{"operationId":"NotificationsController_registerDevice","summary":"Register FCM token for an app install (no auth)","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegisterDeviceDto"}}}},"responses":{"204":{"description":""}},"tags":["notifications"]}},"/notifications/register-token":{"post":{"operationId":"NotificationsController_registerToken","summary":"Register FCM token for push notifications","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegisterTokenDto"}}}},"responses":{"204":{"description":""}},"tags":["notifications"],"security":[{"bearer":[]}]}},"/notifications/unregister-token":{"post":{"operationId":"NotificationsController_unregisterToken","summary":"Unregister FCM token (e.g. on logout)","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegisterTokenDto"}}}},"responses":{"204":{"description":""}},"tags":["notifications"],"security":[{"bearer":[]}]}},"/admin/notifications/templates":{"get":{"operationId":"AdminNotificationsController_listTemplates","summary":"List notification templates for admin compose (includes SMS/WA/email catalogs)","parameters":[{"name":"party","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Admin Notifications"],"security":[{"bearer":[]}]}},"/admin/notifications/routes":{"get":{"operationId":"AdminNotificationsController_listRoutes","summary":"List tap/open destinations for push (app + web)","parameters":[{"name":"party","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Admin Notifications"],"security":[{"bearer":[]}]}},"/admin/notifications/whatsapp-templates":{"get":{"operationId":"AdminNotificationsController_listWhatsappTemplates","summary":"WhatsApp Meta template catalog with Fast2SMS message_id status","parameters":[],"responses":{"200":{"description":""}},"tags":["Admin Notifications"],"security":[{"bearer":[]}]}},"/admin/notifications/sms-templates":{"get":{"operationId":"AdminNotificationsController_listSmsTemplates","summary":"List SMS DLT templates (registry)","parameters":[{"name":"status","required":true,"in":"query","schema":{"type":"string"}},{"name":"party","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Admin Notifications"],"security":[{"bearer":[]}]},"post":{"operationId":"AdminNotificationsController_createSmsTemplate","summary":"Create a draft SMS DLT template","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateSmsDltTemplateDto"}}}},"responses":{"201":{"description":""}},"tags":["Admin Notifications"],"security":[{"bearer":[]}]}},"/admin/notifications/sms-templates/{id}":{"patch":{"operationId":"AdminNotificationsController_updateSmsTemplate","summary":"Update an SMS DLT template (body change resets to draft)","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateSmsDltTemplateDto"}}}},"responses":{"200":{"description":""}},"tags":["Admin Notifications"],"security":[{"bearer":[]}]}},"/admin/notifications/sms-templates/{id}/verify":{"post":{"operationId":"AdminNotificationsController_verifySmsTemplate","summary":"Mark SMS template as DLT-approved / verified","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifySmsDltTemplateDto"}}}},"responses":{"201":{"description":""}},"tags":["Admin Notifications"],"security":[{"bearer":[]}]}},"/admin/notifications/sms-templates/{id}/reject":{"post":{"operationId":"AdminNotificationsController_rejectSmsTemplate","summary":"Reject an SMS DLT template","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RejectSmsDltTemplateDto"}}}},"responses":{"201":{"description":""}},"tags":["Admin Notifications"],"security":[{"bearer":[]}]}},"/admin/notifications/logs":{"get":{"operationId":"AdminNotificationsController_listLogs","summary":"Recent notification delivery logs","parameters":[{"name":"party","required":true,"in":"query","schema":{"type":"string"}},{"name":"event","required":true,"in":"query","schema":{"type":"string"}},{"name":"recipientId","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Admin Notifications"],"security":[{"bearer":[]}]}},"/admin/notifications/recipient-push-status":{"get":{"operationId":"AdminNotificationsController_getRecipientPushStatus","summary":"Check if a user/seller has active FCM tokens for push","parameters":[{"name":"party","required":true,"in":"query","schema":{"type":"string"}},{"name":"recipientId","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Admin Notifications"],"security":[{"bearer":[]}]}},"/admin/notifications/send":{"post":{"operationId":"AdminNotificationsController_send","summary":"Send SMS/WhatsApp/email/push to one user or seller","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminSendNotificationDto"}}}},"responses":{"201":{"description":""}},"tags":["Admin Notifications"],"security":[{"bearer":[]}]}},"/admin/notifications/broadcast":{"post":{"operationId":"AdminNotificationsController_broadcast","summary":"Send the same notification to multiple recipients (admin only)","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminBroadcastNotificationDto"}}}},"responses":{"201":{"description":""}},"tags":["Admin Notifications"],"security":[{"bearer":[]}]}},"/settings":{"get":{"operationId":"SettingsController_getSettings","summary":"Get site settings","parameters":[],"responses":{"200":{"description":""}},"tags":["Settings"]},"put":{"operationId":"SettingsController_updateSettings","summary":"Update site settings (Admin)","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateSettingsDto"}}}},"responses":{"200":{"description":""}},"tags":["Settings"],"security":[{"bearer":[]}]}},"/app-updates":{"get":{"operationId":"AppUpdatesController_getMobilePolicy","summary":"Mobile app version policy for customer, seller, and seller POS apps (public)","parameters":[],"responses":{"200":{"description":""}},"tags":["App updates"]}},"/admin/monetization/platform":{"get":{"operationId":"AdminMonetizationController_getPlatform","summary":"Get platform monetization settings","parameters":[],"responses":{"200":{"description":""}},"tags":["Admin Monetization"],"security":[{"bearer":[]}]},"put":{"operationId":"AdminMonetizationController_updatePlatform","summary":"Update platform monetization settings","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdatePlatformMonetizationDto"}}}},"responses":{"200":{"description":""}},"tags":["Admin Monetization"],"security":[{"bearer":[]}]}},"/admin/monetization/seller/{sellerId}/commission":{"get":{"operationId":"AdminMonetizationController_getSellerCommission","summary":"Get seller commission config","parameters":[{"name":"sellerId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Admin Monetization"],"security":[{"bearer":[]}]},"put":{"operationId":"AdminMonetizationController_updateSellerCommission","summary":"Override seller commission","parameters":[{"name":"sellerId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateSellerCommissionDto"}}}},"responses":{"200":{"description":""}},"tags":["Admin Monetization"],"security":[{"bearer":[]}]}},"/admin/monetization/seller/{sellerId}/trial":{"put":{"operationId":"AdminMonetizationController_extendTrial","summary":"Extend or set trial for seller","parameters":[{"name":"sellerId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateSellerTrialDto"}}}},"responses":{"200":{"description":""}},"tags":["Admin Monetization"],"security":[{"bearer":[]}]}},"/admin/monetization/seller/{sellerId}/subscription":{"put":{"operationId":"AdminMonetizationController_assignSubscription","summary":"Assign subscription to seller","parameters":[{"name":"sellerId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssignSellerSubscriptionDto"}}}},"responses":{"200":{"description":""}},"tags":["Admin Monetization"],"security":[{"bearer":[]}]}},"/admin/monetization/referrals":{"get":{"operationId":"AdminMonetizationController_listReferrals","summary":"List all referrals","parameters":[],"responses":{"200":{"description":""}},"tags":["Admin Monetization"],"security":[{"bearer":[]}]}},"/admin/monetization/referrals/{id}/approve":{"put":{"operationId":"AdminMonetizationController_approveReferral","summary":"Approve referral reward","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Admin Monetization"],"security":[{"bearer":[]}]}},"/admin/monetization/referrals/{id}/reject":{"put":{"operationId":"AdminMonetizationController_rejectReferral","summary":"Reject referral reward","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Admin Monetization"],"security":[{"bearer":[]}]}},"/admin/monetization/coupons":{"get":{"operationId":"AdminMonetizationController_listCoupons","summary":"List subscription coupons","parameters":[],"responses":{"200":{"description":""}},"tags":["Admin Monetization"],"security":[{"bearer":[]}]},"post":{"operationId":"AdminMonetizationController_createCoupon","summary":"Create subscription coupon","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateSubscriptionCouponDto"}}}},"responses":{"201":{"description":""}},"tags":["Admin Monetization"],"security":[{"bearer":[]}]}},"/admin/monetization/coupons/{id}":{"put":{"operationId":"AdminMonetizationController_updateCoupon","summary":"Update subscription coupon","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateSubscriptionCouponDto"}}}},"responses":{"200":{"description":""}},"tags":["Admin Monetization"],"security":[{"bearer":[]}]},"get":{"operationId":"AdminMonetizationController_getCoupon","summary":"Get subscription coupon","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Admin Monetization"],"security":[{"bearer":[]}]}},"/payments/create-order":{"post":{"operationId":"PaymentsController_createOrder","summary":"Create payment gateway order","deprecated":true,"description":"Customer checkout uses POST /orders then POST /orders/:orderId/verify-payment. Prefer that flow unless you have a legacy client.","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatePaymentOrderDto"}}}},"responses":{"201":{"description":""}},"tags":["Payments"],"security":[{"bearer":[]}]}},"/payments/public-config":{"get":{"operationId":"PaymentsController_getPublicConfig","summary":"Get public payment gateway configuration","description":"Safe flags for storefront checkout preflight (active gateway, which providers are configured).","parameters":[],"responses":{"200":{"description":""}},"tags":["Payments"]}},"/payments/status/{orderId}":{"get":{"operationId":"PaymentsController_getStatus","summary":"Get payment status","deprecated":true,"description":"Prefer order + verify-payment flow or GET /orders/:orderId for customer apps.","parameters":[{"name":"orderId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Payments"],"security":[{"bearer":[]}]}},"/payments/all":{"get":{"operationId":"PaymentsController_getAllPayments","summary":"Get all payments (Admin)","parameters":[{"name":"page","required":true,"in":"query","schema":{"type":"number"}},{"name":"limit","required":true,"in":"query","schema":{"type":"number"}},{"name":"status","required":true,"in":"query","schema":{"type":"string"}},{"name":"orderId","required":true,"in":"query","schema":{"type":"string"}},{"name":"search","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Payments"],"security":[{"bearer":[]}]}},"/payments/razorpay/{razorpayPaymentId}":{"get":{"operationId":"PaymentsController_fetchPaymentFromRazorpay","summary":"Fetch payment details from Razorpay (Admin)","parameters":[{"name":"razorpayPaymentId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Payments"],"security":[{"bearer":[]}]}},"/payments/{paymentId}":{"get":{"operationId":"PaymentsController_getPaymentById","summary":"Get payment by ID (Admin)","parameters":[{"name":"paymentId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Payments"],"security":[{"bearer":[]}]}},"/payments/verify/config":{"get":{"operationId":"PaymentsController_verifyConfiguration","summary":"Verify Razorpay configuration (Admin)","parameters":[],"responses":{"200":{"description":""}},"tags":["Payments"],"security":[{"bearer":[]}]}},"/finance/admin/settlements/run":{"post":{"operationId":"FinanceAdminController_createRun","summary":"Create settlement run","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateSettlementRunDto"}}}},"responses":{"201":{"description":""}},"tags":["Finance Admin"],"security":[{"bearer":[]}]}},"/finance/admin/settlements/runs":{"get":{"operationId":"FinanceAdminController_listRuns","parameters":[{"name":"sellerId","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Finance Admin"],"security":[{"bearer":[]}]}},"/finance/admin/settlements/runs/{runId}":{"get":{"operationId":"FinanceAdminController_getRun","parameters":[{"name":"runId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Finance Admin"],"security":[{"bearer":[]}]}},"/finance/admin/settlements/runs/{runId}/statement":{"post":{"operationId":"FinanceAdminController_statement","parameters":[{"name":"runId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"201":{"description":""}},"tags":["Finance Admin"],"security":[{"bearer":[]}]}},"/finance/admin/settlements/runs/{runId}/commission-invoice":{"post":{"operationId":"FinanceAdminController_commissionInvoice","parameters":[{"name":"runId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"201":{"description":""}},"tags":["Finance Admin"],"security":[{"bearer":[]}]}},"/finance/admin/settlements/runs/{runId}/export":{"get":{"operationId":"FinanceAdminController_exportRun","parameters":[{"name":"runId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Finance Admin"],"security":[{"bearer":[]}]}},"/finance/admin/reconciliation/import":{"post":{"operationId":"FinanceAdminController_importReconciliation","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImportReconciliationDto"}}}},"responses":{"201":{"description":""}},"tags":["Finance Admin"],"security":[{"bearer":[]}]}},"/finance/admin/cod/remittance":{"post":{"operationId":"FinanceAdminController_codRemittance","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CodRemittanceDto"}}}},"responses":{"201":{"description":""}},"tags":["Finance Admin"],"security":[{"bearer":[]}]}},"/finance/admin/reconciliation/exceptions":{"get":{"operationId":"FinanceAdminController_reconciliationExceptions","parameters":[],"responses":{"200":{"description":""}},"tags":["Finance Admin"],"security":[{"bearer":[]}]}},"/finance/admin/holds":{"post":{"operationId":"FinanceAdminController_createHold","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateFinanceHoldDto"}}}},"responses":{"201":{"description":""}},"tags":["Finance Admin"],"security":[{"bearer":[]}]}},"/finance/admin/holds/{holdId}/release":{"post":{"operationId":"FinanceAdminController_releaseHold","parameters":[{"name":"holdId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReleaseFinanceHoldDto"}}}},"responses":{"201":{"description":""}},"tags":["Finance Admin"],"security":[{"bearer":[]}]}},"/finance/admin/clawbacks":{"get":{"operationId":"FinanceAdminController_clawbacks","parameters":[{"name":"sellerId","required":true,"in":"query","schema":{"type":"string"}},{"name":"status","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Finance Admin"],"security":[{"bearer":[]}]}},"/finance/admin/clawbacks/{clawbackId}":{"get":{"operationId":"FinanceAdminController_clawbackDetail","parameters":[{"name":"clawbackId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Finance Admin"],"security":[{"bearer":[]}]}},"/finance/admin/adjustments/manual":{"post":{"operationId":"FinanceAdminController_manualAdjustment","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ManualFinanceAdjustmentDto"}}}},"responses":{"201":{"description":""}},"tags":["Finance Admin"],"security":[{"bearer":[]}]}},"/finance/admin/documents/sequence/preview":{"get":{"operationId":"FinanceAdminController_previewDocNumber","parameters":[{"name":"documentType","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Finance Admin"],"security":[{"bearer":[]}]}},"/finance/admin/settlement-eligibility/debug":{"get":{"operationId":"FinanceAdminController_eligibilityDebug","parameters":[{"name":"orderId","required":true,"in":"query","schema":{"type":"string"}},{"name":"shipmentId","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Finance Admin"],"security":[{"bearer":[]}]}},"/finance/admin/tcs-summary":{"get":{"operationId":"FinanceAdminController_tcsSummary","parameters":[{"name":"sellerId","required":true,"in":"query","schema":{"type":"string"}},{"name":"year","required":true,"in":"query","schema":{"type":"number"}},{"name":"month","required":true,"in":"query","schema":{"type":"number"}}],"responses":{"200":{"description":""}},"tags":["Finance Admin"],"security":[{"bearer":[]}]}},"/finance/admin/commission-snapshots/backfill":{"post":{"operationId":"FinanceAdminController_commissionBackfill","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommissionBackfillDto"}}}},"responses":{"201":{"description":""}},"tags":["Finance Admin"],"security":[{"bearer":[]}]}},"/finance/admin/coa/init":{"post":{"operationId":"FinanceAdminController_initCoa","parameters":[],"responses":{"201":{"description":""}},"tags":["Finance Admin"],"security":[{"bearer":[]}]}},"/finance/admin/coa":{"get":{"operationId":"FinanceAdminController_coa","parameters":[{"name":"includeInactive","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Finance Admin"],"security":[{"bearer":[]}]}},"/finance/admin/coa/upsert":{"post":{"operationId":"FinanceAdminController_upsertCoa","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpsertChartOfAccountDto"}}}},"responses":{"201":{"description":""}},"tags":["Finance Admin"],"security":[{"bearer":[]}]}},"/finance/admin/posting-matrix":{"get":{"operationId":"FinanceAdminController_postingMatrix","parameters":[],"responses":{"200":{"description":""}},"tags":["Finance Admin"],"security":[{"bearer":[]}]}},"/finance/admin/posting-matrix/preview":{"post":{"operationId":"FinanceAdminController_postingMatrixEventPreview","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostingMatrixPreviewDto"}}}},"responses":{"201":{"description":""}},"tags":["Finance Admin"],"security":[{"bearer":[]}]}},"/finance/admin/bank/accounts/upsert":{"post":{"operationId":"FinanceAdminController_bankAccount","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpsertBankAccountDto"}}}},"responses":{"201":{"description":""}},"tags":["Finance Admin"],"security":[{"bearer":[]}]}},"/finance/admin/bank/import":{"post":{"operationId":"FinanceAdminController_bankImport","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BankImportRowsDto"}}}},"responses":{"201":{"description":""}},"tags":["Finance Admin"],"security":[{"bearer":[]}]}},"/finance/admin/bank/import/file/preview":{"post":{"operationId":"FinanceAdminController_bankImportPreview","parameters":[],"responses":{"201":{"description":""}},"tags":["Finance Admin"],"security":[{"bearer":[]}]}},"/finance/admin/bank/import/file":{"post":{"operationId":"FinanceAdminController_bankImportFile","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BankImportFileDto"}}}},"responses":{"201":{"description":""}},"tags":["Finance Admin"],"security":[{"bearer":[]}]}},"/finance/admin/bank/reconciliation/summary":{"get":{"operationId":"FinanceAdminController_bankSummary","parameters":[],"responses":{"200":{"description":""}},"tags":["Finance Admin"],"security":[{"bearer":[]}]}},"/finance/admin/bank/imports":{"get":{"operationId":"FinanceAdminController_bankImports","parameters":[],"responses":{"200":{"description":""}},"tags":["Finance Admin"],"security":[{"bearer":[]}]}},"/finance/admin/bank/imports/{importId}":{"get":{"operationId":"FinanceAdminController_bankImportDetail","parameters":[{"name":"importId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Finance Admin"],"security":[{"bearer":[]}]}},"/finance/admin/bank/reconciliation/exceptions":{"get":{"operationId":"FinanceAdminController_bankExceptions","parameters":[],"responses":{"200":{"description":""}},"tags":["Finance Admin"],"security":[{"bearer":[]}]}},"/finance/admin/bank/reconciliation/manual-match":{"post":{"operationId":"FinanceAdminController_bankManualMatch","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BankManualMatchDto"}}}},"responses":{"201":{"description":""}},"tags":["Finance Admin"],"security":[{"bearer":[]}]}},"/finance/admin/bank/reconciliation/exceptions/{exceptionId}/explain":{"post":{"operationId":"FinanceAdminController_bankExplain","parameters":[{"name":"exceptionId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BankExplainExceptionDto"}}}},"responses":{"201":{"description":""}},"tags":["Finance Admin"],"security":[{"bearer":[]}]}},"/finance/admin/period-close/preview":{"get":{"operationId":"FinanceAdminController_periodPreview","parameters":[{"name":"periodKey","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Finance Admin"],"security":[{"bearer":[]}]}},"/finance/admin/period-close/soft-lock":{"post":{"operationId":"FinanceAdminController_periodSoftLock","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PeriodActionDto"}}}},"responses":{"201":{"description":""}},"tags":["Finance Admin"],"security":[{"bearer":[]}]}},"/finance/admin/period-close/close":{"post":{"operationId":"FinanceAdminController_periodClose","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PeriodActionDto"}}}},"responses":{"201":{"description":""}},"tags":["Finance Admin"],"security":[{"bearer":[]}]}},"/finance/admin/period-close/reopen":{"post":{"operationId":"FinanceAdminController_periodReopen","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PeriodActionDto"}}}},"responses":{"201":{"description":""}},"tags":["Finance Admin"],"security":[{"bearer":[]}]}},"/finance/admin/period-close/logs":{"get":{"operationId":"FinanceAdminController_periodLogs","parameters":[{"name":"periodKey","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Finance Admin"],"security":[{"bearer":[]}]}},"/finance/admin/reports/revenue":{"get":{"operationId":"FinanceAdminController_reportRevenue","parameters":[{"name":"from","required":true,"in":"query","schema":{"type":"string"}},{"name":"to","required":true,"in":"query","schema":{"type":"string"}},{"name":"sellerId","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Finance Admin"],"security":[{"bearer":[]}]}},"/finance/admin/reports/seller-payable":{"get":{"operationId":"FinanceAdminController_reportSellerPayable","parameters":[{"name":"from","required":true,"in":"query","schema":{"type":"string"}},{"name":"to","required":true,"in":"query","schema":{"type":"string"}},{"name":"sellerId","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Finance Admin"],"security":[{"bearer":[]}]}},"/finance/admin/reports/payout":{"get":{"operationId":"FinanceAdminController_reportPayout","parameters":[{"name":"from","required":true,"in":"query","schema":{"type":"string"}},{"name":"to","required":true,"in":"query","schema":{"type":"string"}},{"name":"sellerId","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Finance Admin"],"security":[{"bearer":[]}]}},"/finance/admin/reports/clawback-outstanding":{"get":{"operationId":"FinanceAdminController_reportClawback","parameters":[{"name":"sellerId","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Finance Admin"],"security":[{"bearer":[]}]}},"/finance/admin/reports/reconciliation-exceptions":{"get":{"operationId":"FinanceAdminController_reportReconciliationExceptions","parameters":[],"responses":{"200":{"description":""}},"tags":["Finance Admin"],"security":[{"bearer":[]}]}},"/finance/admin/reports/gst-commission":{"get":{"operationId":"FinanceAdminController_reportGstCommission","parameters":[{"name":"from","required":true,"in":"query","schema":{"type":"string"}},{"name":"to","required":true,"in":"query","schema":{"type":"string"}},{"name":"sellerId","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Finance Admin"],"security":[{"bearer":[]}]}},"/finance/admin/reports/tcs-summary":{"get":{"operationId":"FinanceAdminController_reportTcs","parameters":[{"name":"from","required":true,"in":"query","schema":{"type":"string"}},{"name":"to","required":true,"in":"query","schema":{"type":"string"}},{"name":"sellerId","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Finance Admin"],"security":[{"bearer":[]}]}},"/finance/admin/alerts":{"get":{"operationId":"FinanceAdminController_alerts","parameters":[{"name":"status","required":true,"in":"query","schema":{"type":"string"}},{"name":"severity","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Finance Admin"],"security":[{"bearer":[]}]}},"/finance/admin/alerts/{alertId}/status":{"post":{"operationId":"FinanceAdminController_alertStatus","parameters":[{"name":"alertId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateFinanceAlertStatusDto"}}}},"responses":{"201":{"description":""}},"tags":["Finance Admin"],"security":[{"bearer":[]}]}},"/finance/admin/ops/diagnostics-summary":{"get":{"operationId":"FinanceAdminController_opsDiagnosticsSummary","parameters":[],"responses":{"200":{"description":""}},"tags":["Finance Admin"],"security":[{"bearer":[]}]}},"/finance/admin/exports/platform-journal":{"get":{"operationId":"FinanceAdminController_platformJournalExport","parameters":[{"name":"from","required":true,"in":"query","schema":{"type":"string"}},{"name":"to","required":true,"in":"query","schema":{"type":"string"}},{"name":"sellerId","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Finance Admin"],"security":[{"bearer":[]}]}},"/finance/admin/tally/mappings":{"get":{"operationId":"FinanceAdminController_tallyMappings","parameters":[],"responses":{"200":{"description":""}},"tags":["Finance Admin"],"security":[{"bearer":[]}]}},"/finance/admin/tally/mappings/upsert":{"post":{"operationId":"FinanceAdminController_upsertTallyMappings","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpsertTallyMappingDto"}}}},"responses":{"201":{"description":""}},"tags":["Finance Admin"],"security":[{"bearer":[]}]}},"/finance/admin/tally/mappings/diagnostics":{"get":{"operationId":"FinanceAdminController_tallyDiag","parameters":[],"responses":{"200":{"description":""}},"tags":["Finance Admin"],"security":[{"bearer":[]}]}},"/finance/admin/tally/export/diagnostics":{"get":{"operationId":"FinanceAdminController_tallyExportDiagnostics","parameters":[{"name":"from","required":true,"in":"query","schema":{"type":"string"}},{"name":"to","required":true,"in":"query","schema":{"type":"string"}},{"name":"sellerId","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Finance Admin"],"security":[{"bearer":[]}]}},"/finance/admin/tally/export/preview":{"get":{"operationId":"FinanceAdminController_tallyExportPreview","parameters":[{"name":"from","required":true,"in":"query","schema":{"type":"string"}},{"name":"to","required":true,"in":"query","schema":{"type":"string"}},{"name":"sellerId","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Finance Admin"],"security":[{"bearer":[]}]}},"/finance/admin/documents/{invoiceId}/pdf/regenerate":{"post":{"operationId":"FinanceAdminController_regeneratePdf","parameters":[{"name":"invoiceId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegeneratePdfDto"}}}},"responses":{"201":{"description":""}},"tags":["Finance Admin"],"security":[{"bearer":[]}]}},"/seller/finance/settlements":{"get":{"operationId":"FinanceSellerController_list","summary":"List seller settlement runs","parameters":[],"responses":{"200":{"description":""}},"tags":["Finance Seller"],"security":[{"bearer":[]}]}},"/seller/finance/settlements/{runId}":{"get":{"operationId":"FinanceSellerController_detail","summary":"Settlement run detail for seller","parameters":[{"name":"runId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Finance Seller"],"security":[{"bearer":[]}]}},"/seller/finance/settlements/{runId}/export":{"get":{"operationId":"FinanceSellerController_exportRun","summary":"Seller settlement export CSV/Tally scaffold","parameters":[{"name":"runId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Finance Seller"],"security":[{"bearer":[]}]}},"/seller/finance/clawbacks":{"get":{"operationId":"FinanceSellerController_clawbacks","summary":"Seller clawback history","parameters":[{"name":"status","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Finance Seller"],"security":[{"bearer":[]}]}},"/seller/finance/tcs-summary":{"get":{"operationId":"FinanceSellerController_tcsSummary","summary":"Seller monthly TCS summary","parameters":[{"name":"year","required":true,"in":"query","schema":{"type":"number"}},{"name":"month","required":true,"in":"query","schema":{"type":"number"}}],"responses":{"200":{"description":""}},"tags":["Finance Seller"],"security":[{"bearer":[]}]}},"/seller/finance/overview":{"get":{"operationId":"FinanceSellerController_overview","summary":"Seller finance overview summary for dashboard cards/tables","parameters":[{"name":"from","required":true,"in":"query","schema":{"type":"string"}},{"name":"to","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Finance Seller"],"security":[{"bearer":[]}]}},"/seller/finance/timeline":{"get":{"operationId":"FinanceSellerController_timeline","summary":"Seller settlement timeline","parameters":[{"name":"from","required":true,"in":"query","schema":{"type":"string"}},{"name":"to","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Finance Seller"],"security":[{"bearer":[]}]}},"/seller/finance/documents":{"get":{"operationId":"FinanceSellerController_documents","summary":"Seller downloadable document summary","parameters":[{"name":"from","required":true,"in":"query","schema":{"type":"string"}},{"name":"to","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Finance Seller"],"security":[{"bearer":[]}]}},"/users/profile":{"get":{"operationId":"UsersController_getProfile","summary":"Get current user profile","parameters":[],"responses":{"200":{"description":""}},"tags":["Users"],"security":[{"bearer":[]}]},"put":{"operationId":"UsersController_updateProfile","summary":"Update user profile","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateProfileDto"}}}},"responses":{"200":{"description":""}},"tags":["Users"],"security":[{"bearer":[]}]}},"/users/addresses":{"post":{"operationId":"UsersController_addAddress","summary":"Add address","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddressDto"}}}},"responses":{"201":{"description":""}},"tags":["Users"],"security":[{"bearer":[]}]}},"/users/addresses/{index}":{"put":{"operationId":"UsersController_updateAddress","summary":"Update address","parameters":[{"name":"index","required":true,"in":"path","schema":{"type":"number"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddressDto"}}}},"responses":{"200":{"description":""}},"tags":["Users"],"security":[{"bearer":[]}]},"delete":{"operationId":"UsersController_deleteAddress","summary":"Delete address","parameters":[{"name":"index","required":true,"in":"path","schema":{"type":"number"}}],"responses":{"200":{"description":""}},"tags":["Users"],"security":[{"bearer":[]}]}},"/users":{"get":{"operationId":"UsersController_getAllUsers","summary":"Get all users (Admin)","parameters":[{"name":"page","required":true,"in":"query","schema":{"type":"number"}},{"name":"limit","required":true,"in":"query","schema":{"type":"number"}},{"name":"search","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Users"],"security":[{"bearer":[]}]}},"/users/{id}/block":{"put":{"operationId":"UsersController_blockUser","summary":"Block user (Admin)","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReasonDto"}}}},"responses":{"200":{"description":""}},"tags":["Users"],"security":[{"bearer":[]}]}},"/users/{id}/unblock":{"put":{"operationId":"UsersController_unblockUser","summary":"Unblock user (Admin)","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Users"],"security":[{"bearer":[]}]}},"/users/{id}/revoke-jwt":{"put":{"operationId":"UsersController_revokeUserJwt","summary":"Revoke user JWT sessions (Admin)","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReasonDto"}}}},"responses":{"200":{"description":""}},"tags":["Users"],"security":[{"bearer":[]}]}},"/users/{id}/block-devices":{"put":{"operationId":"UsersController_blockUserDevices","summary":"Block user devices and sessions (Admin)","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReasonDto"}}}},"responses":{"200":{"description":""}},"tags":["Users"],"security":[{"bearer":[]}]}},"/users/{id}/unblock-devices":{"put":{"operationId":"UsersController_unblockUserDevices","summary":"Unblock user device access (Admin)","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Users"],"security":[{"bearer":[]}]}},"/users/{id}/soft-delete":{"put":{"operationId":"UsersController_softDeleteUser","summary":"Soft delete user (Admin)","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReasonDto"}}}},"responses":{"200":{"description":""}},"tags":["Users"],"security":[{"bearer":[]}]}},"/users/{id}/hard-delete":{"delete":{"operationId":"UsersController_hardDeleteUser","summary":"Hard delete user and related data (Admin)","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Users"],"security":[{"bearer":[]}]}},"/users/{id}/details":{"get":{"operationId":"UsersController_getUserDetails","summary":"Get comprehensive user details with activity tracking (Admin)","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Users"],"security":[{"bearer":[]}]}},"/products":{"post":{"operationId":"ProductsController_create","summary":"Create a new product (Admin)","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateProductDto"}}}},"responses":{"201":{"description":""}},"tags":["Products"],"security":[{"bearer":[]}]},"get":{"operationId":"ProductsController_findAll","summary":"Get all products with filters","parameters":[{"name":"categoryId","required":false,"in":"query","schema":{"type":"string"}},{"name":"subCategoryId","required":false,"in":"query","description":"Filter by a sub-category (child category)","schema":{"type":"string"}},{"name":"minPrice","required":false,"in":"query","schema":{"type":"number"}},{"name":"maxPrice","required":false,"in":"query","schema":{"type":"number"}},{"name":"brand","required":false,"in":"query","schema":{"type":"string"}},{"name":"size","required":false,"in":"query","schema":{"type":"string"}},{"name":"color","required":false,"in":"query","schema":{"type":"string"}},{"name":"fabric","required":false,"in":"query","schema":{"type":"string"}},{"name":"search","required":false,"in":"query","schema":{"type":"string"}},{"name":"sellerId","required":false,"in":"query","description":"Filter by seller ID","schema":{"type":"string"}},{"name":"productIds","required":false,"in":"query","description":"Comma-separated product ObjectIds (curated list). When set, category/subcategory filters are ignored.","schema":{"type":"string"}},{"name":"isTrending","required":false,"in":"query","schema":{"type":"boolean"}},{"name":"isNewArrival","required":false,"in":"query","schema":{"type":"boolean"}},{"name":"isEditorsPick","required":false,"in":"query","schema":{"type":"boolean"}},{"name":"onSale","required":false,"in":"query","description":"Filter products that are on sale (compareAtPrice set)","schema":{"type":"boolean"}},{"name":"sortBy","required":false,"in":"query","schema":{"enum":["price_low","price_high","popularity","newest","views","discount_desc"],"type":"string"}},{"name":"includeInactive","required":false,"in":"query","description":"Include inactive products (for admin)","schema":{"type":"boolean"}},{"name":"page","required":false,"in":"query","schema":{"default":1,"type":"number"}},{"name":"limit","required":false,"in":"query","schema":{"default":20,"type":"number"}}],"responses":{"200":{"description":""}},"tags":["Products"]}},"/products/autocomplete":{"get":{"operationId":"ProductsController_getAutocomplete","summary":"Get search autocomplete suggestions","parameters":[{"name":"q","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Products"]}},"/products/search-history":{"get":{"operationId":"ProductsController_getSearchHistory","summary":"Get user search history (Authenticated)","parameters":[],"responses":{"200":{"description":""}},"tags":["Products"],"security":[{"bearer":[]}]}},"/products/trending":{"get":{"operationId":"ProductsController_getTrending","summary":"Get trending products","parameters":[{"name":"page","required":true,"in":"query","schema":{"type":"string"}},{"name":"limit","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Products"]}},"/products/new-arrivals":{"get":{"operationId":"ProductsController_getNewArrivals","summary":"Get new arrival products","parameters":[{"name":"page","required":true,"in":"query","schema":{"type":"string"}},{"name":"limit","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Products"]}},"/products/editors-pick":{"get":{"operationId":"ProductsController_getEditorsPick","summary":"Get editor's pick products","parameters":[{"name":"page","required":true,"in":"query","schema":{"type":"string"}},{"name":"limit","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Products"]}},"/products/by-ids":{"get":{"operationId":"ProductsController_getByIds","summary":"Get products by IDs (preserve order)","parameters":[{"name":"ids","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Products"]}},"/products/by-ids-admin":{"get":{"operationId":"ProductsController_getByIdsAdmin","summary":"Get products by IDs (Admin, include inactive)","parameters":[{"name":"ids","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Products"],"security":[{"bearer":[]}]}},"/products/similar/{id}":{"get":{"operationId":"ProductsController_getSimilar","summary":"Get similar products","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"limit","required":true,"in":"query","schema":{"type":"number"}}],"responses":{"200":{"description":""}},"tags":["Products"]}},"/products/slug/{slug}":{"get":{"operationId":"ProductsController_findBySlug","summary":"Get product by slug","parameters":[{"name":"slug","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Products"]}},"/products/{id}":{"get":{"operationId":"ProductsController_findOne","summary":"Get product by ID","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"includeInactive","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Products"]},"patch":{"operationId":"ProductsController_update","summary":"Update product (Admin)","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateProductDto"}}}},"responses":{"200":{"description":""}},"tags":["Products"],"security":[{"bearer":[]}]},"delete":{"operationId":"ProductsController_remove","summary":"Delete product (Admin)","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Products"],"security":[{"bearer":[]}]}},"/products/bulk":{"delete":{"operationId":"ProductsController_removeMany","summary":"Delete multiple products (Admin)","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkDeleteProductsDto"}}}},"responses":{"200":{"description":""}},"tags":["Products"],"security":[{"bearer":[]}]}},"/s3/presigned-url":{"post":{"operationId":"S3Controller_generatePresignedUrl","summary":"Generate presigned URL for direct S3 upload","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GeneratePresignedUrlDto"}}}},"responses":{"201":{"description":""}},"tags":["S3 Upload"],"security":[{"bearer":[]}]}},"/s3/presigned-url/customer":{"post":{"operationId":"S3Controller_generatePresignedUrlCustomer","summary":"Generate presigned URL for direct S3 upload (signed-in customer)","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GeneratePresignedUrlDto"}}}},"responses":{"201":{"description":""}},"tags":["S3 Upload"],"security":[{"bearer":[]}]}},"/s3/upload":{"post":{"operationId":"S3Controller_uploadAdmin","summary":"Upload file to S3 via backend (Admin)","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UploadToS3Dto"}}}},"responses":{"201":{"description":""}},"tags":["S3 Upload"],"security":[{"bearer":[]}]}},"/s3/presigned-url/seller":{"post":{"operationId":"S3Controller_generatePresignedUrlSeller","summary":"Generate presigned URL for direct S3 upload (Seller)","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GeneratePresignedUrlDto"}}}},"responses":{"201":{"description":""}},"tags":["S3 Upload"],"security":[{"bearer":[]}]}},"/s3/upload/seller":{"post":{"operationId":"S3Controller_uploadSeller","summary":"Upload file to S3 via backend (Seller)","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UploadToS3Dto"}}}},"responses":{"201":{"description":""}},"tags":["S3 Upload"],"security":[{"bearer":[]}]}},"/s3/gallery":{"get":{"operationId":"S3Controller_getGallery","summary":"Get all images from S3 bucket","parameters":[{"name":"prefix","required":true,"in":"query","schema":{"type":"string"}},{"name":"maxKeys","required":true,"in":"query","schema":{"type":"number"}}],"responses":{"200":{"description":""}},"tags":["S3 Upload"],"security":[{"bearer":[]}]}},"/s3/gallery/bulk":{"delete":{"operationId":"S3Controller_deleteImagesBulk","summary":"Delete multiple images from S3","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkDeleteKeysDto"}}}},"responses":{"200":{"description":""}},"tags":["S3 Upload"],"security":[{"bearer":[]}]}},"/s3/gallery/{key}":{"delete":{"operationId":"S3Controller_deleteImage","summary":"Delete an image from S3","parameters":[{"name":"key","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["S3 Upload"],"security":[{"bearer":[]}]}},"/categories":{"post":{"operationId":"CategoriesController_create","summary":"Create category (Admin)","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateCategoryDto"}}}},"responses":{"201":{"description":""}},"tags":["Categories"],"security":[{"bearer":[]}]},"get":{"operationId":"CategoriesController_findAll","summary":"Get marketplace categories (admin-managed, excludes seller storefront categories)","parameters":[{"name":"search","required":true,"in":"query","schema":{"type":"string"}},{"name":"includeInactive","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Categories"]}},"/categories/slug/{slug}":{"get":{"operationId":"CategoriesController_findBySlug","summary":"Get category by slug","parameters":[{"name":"slug","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Categories"]}},"/categories/{id}":{"get":{"operationId":"CategoriesController_findOne","summary":"Get category by ID","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Categories"]},"put":{"operationId":"CategoriesController_update","summary":"Update category (Admin)","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateCategoryDto"}}}},"responses":{"200":{"description":""}},"tags":["Categories"],"security":[{"bearer":[]}]},"delete":{"operationId":"CategoriesController_remove","summary":"Delete category (Admin)","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Categories"],"security":[{"bearer":[]}]}},"/orders":{"post":{"operationId":"OrdersController_createOrder","summary":"Create new order","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateOrderDto"}}}},"responses":{"201":{"description":""}},"tags":["Orders"],"security":[{"bearer":[]}]},"get":{"operationId":"OrdersController_getMyOrders","summary":"Get user orders","parameters":[{"name":"page","required":true,"in":"query","schema":{"type":"number"}},{"name":"limit","required":true,"in":"query","schema":{"type":"number"}},{"name":"status","required":true,"in":"query","schema":{"type":"string"}},{"name":"q","required":true,"in":"query","schema":{"type":"string"}},{"name":"orderId","required":true,"in":"query","schema":{"type":"string"}},{"name":"mobile","required":true,"in":"query","schema":{"type":"string"}},{"name":"from","required":true,"in":"query","schema":{"type":"string"}},{"name":"to","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Orders"],"security":[{"bearer":[]}]}},"/orders/{orderId}/verify-payment":{"post":{"operationId":"OrdersController_verifyPayment","summary":"Verify payment and confirm order","parameters":[{"name":"orderId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyPaymentDto"}}}},"responses":{"201":{"description":""}},"tags":["Orders"],"security":[{"bearer":[]}]}},"/orders/{orderId}/refresh-prepaid-session":{"post":{"operationId":"OrdersController_refreshPrepaidSession","summary":"Refresh prepaid gateway session (e.g. new PayU txnid) or complete order if payment already captured","parameters":[{"name":"orderId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RefreshPrepaidSessionDto"}}}},"responses":{"201":{"description":""}},"tags":["Orders"],"security":[{"bearer":[]}]}},"/orders/{orderId}/payu/checkout-pro-hash":{"post":{"operationId":"OrdersController_payuCheckoutProHash","summary":"PayU Checkout Pro (mobile SDK) dynamic hash — app-only; website checkout continues to use hosted POST","parameters":[{"name":"orderId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PayuCheckoutProHashDto"}}}},"responses":{"201":{"description":""}},"tags":["Orders"],"security":[{"bearer":[]}]}},"/orders/all":{"get":{"operationId":"OrdersController_getAllOrders","summary":"Get all orders (Admin)","parameters":[{"name":"page","required":true,"in":"query","schema":{"type":"number"}},{"name":"limit","required":true,"in":"query","schema":{"type":"number"}},{"name":"status","required":true,"in":"query","schema":{"type":"string"}},{"name":"q","required":true,"in":"query","schema":{"type":"string"}},{"name":"orderId","required":true,"in":"query","schema":{"type":"string"}},{"name":"mobile","required":true,"in":"query","schema":{"type":"string"}},{"name":"from","required":true,"in":"query","schema":{"type":"string"}},{"name":"to","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Orders"],"security":[{"bearer":[]}]}},"/orders/{orderId}/confirm":{"get":{"operationId":"OrdersController_getOrderConfirm","summary":"Get order confirmation (public, verify by mobile)","parameters":[{"name":"orderId","required":true,"in":"path","schema":{"type":"string"}},{"name":"mobile","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Orders"]}},"/orders/{orderId}/tracking/confirm":{"get":{"operationId":"OrdersController_getOrderTrackingConfirm","summary":"Get order tracking (public, verify by mobile)","parameters":[{"name":"orderId","required":true,"in":"path","schema":{"type":"string"}},{"name":"mobile","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Orders"]}},"/orders/{orderId}":{"get":{"operationId":"OrdersController_getOrder","summary":"Get order by ID","parameters":[{"name":"orderId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Orders"],"security":[{"bearer":[]}]}},"/orders/{orderId}/tracking":{"get":{"operationId":"OrdersController_getTracking","summary":"Get order tracking","parameters":[{"name":"orderId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Orders"],"security":[{"bearer":[]}]}},"/orders/{orderId}/status":{"put":{"operationId":"OrdersController_updateStatus","summary":"Update order status (Admin)","parameters":[{"name":"orderId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateOrderStatusDto"}}}},"responses":{"200":{"description":""}},"tags":["Orders"],"security":[{"bearer":[]}]}},"/delivery/test-rate-api":{"get":{"operationId":"DeliveryController_testRateApi","summary":"Test Delhivery rate API - verify if shipping cost API is working","parameters":[{"name":"origin","required":true,"in":"query","schema":{"type":"string"}},{"name":"destination","required":true,"in":"query","schema":{"type":"string"}},{"name":"weight","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Delivery"],"security":[{"bearer":[]}]}},"/delivery/public/serviceability/{pincode}":{"get":{"operationId":"DeliveryController_publicCheckServiceability","summary":"Public: Check Delhivery serviceability + expected delivery date","parameters":[{"name":"pincode","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Delivery"]}},"/delivery/public/shipping-estimate":{"get":{"operationId":"DeliveryController_publicShippingEstimate","summary":"Public: Estimate Delhivery freight for landing calculator","parameters":[{"name":"origin","required":true,"in":"query","schema":{"type":"string"}},{"name":"destination","required":true,"in":"query","schema":{"type":"string"}},{"name":"weight","required":true,"in":"query","schema":{"type":"string"}},{"name":"length","required":true,"in":"query","schema":{"type":"string"}},{"name":"width","required":true,"in":"query","schema":{"type":"string"}},{"name":"height","required":true,"in":"query","schema":{"type":"string"}},{"name":"paymentMode","required":true,"in":"query","schema":{"type":"string"}},{"name":"orderTotal","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Delivery"]}},"/delivery/partners":{"post":{"operationId":"DeliveryController_createPartner","summary":"Create delivery partner (Admin)","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateDeliveryPartnerDto"}}}},"responses":{"201":{"description":""}},"tags":["Delivery"],"security":[{"bearer":[]}]},"get":{"operationId":"DeliveryController_getAllPartners","summary":"Get all delivery partners","parameters":[],"responses":{"200":{"description":""}},"tags":["Delivery"],"security":[{"bearer":[]}]}},"/delivery/partners/{id}":{"put":{"operationId":"DeliveryController_updatePartner","summary":"Update delivery partner (Admin)","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateDeliveryPartnerDto"}}}},"responses":{"200":{"description":""}},"tags":["Delivery"],"security":[{"bearer":[]}]}},"/delivery/calculate-cost/{orderId}":{"post":{"operationId":"DeliveryController_calculateCost","summary":"Calculate shipping cost for order","parameters":[{"name":"orderId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DimensionedActionDto"}}}},"responses":{"201":{"description":""}},"tags":["Delivery"],"security":[{"bearer":[]}]}},"/delivery/assign/{orderId}":{"post":{"operationId":"DeliveryController_assignPartner","summary":"Assign delivery partner to order with weight and dimensions","parameters":[{"name":"orderId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DimensionedActionDto"}}}},"responses":{"201":{"description":""}},"tags":["Delivery"],"security":[{"bearer":[]}]}},"/delivery/tracking/{orderId}":{"get":{"operationId":"DeliveryController_getTrackingStatus","summary":"Get tracking status for an order","parameters":[{"name":"orderId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Delivery"],"security":[{"bearer":[]}]}},"/delivery/tracking/waybill/{trackingId}":{"get":{"operationId":"DeliveryController_checkTrackingByWaybill","summary":"Check tracking status by AWB/Tracking ID","parameters":[{"name":"trackingId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Delivery"],"security":[{"bearer":[]}]}},"/delivery/webhook/{partnerId}":{"post":{"operationId":"DeliveryController_handleWebhook","summary":"Delivery partner webhook","parameters":[{"name":"partnerId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"201":{"description":""}},"tags":["Delivery"]}},"/delivery/serviceability/{pincode}":{"get":{"operationId":"DeliveryController_checkServiceability","summary":"Check pincode serviceability for Delhivery","parameters":[{"name":"pincode","required":true,"in":"path","schema":{"type":"string"}},{"name":"partnerId","required":true,"in":"query","schema":{"type":"string"}},{"name":"prepaid","required":true,"in":"query","schema":{"type":"string"}},{"name":"cash","required":true,"in":"query","schema":{"type":"string"}},{"name":"pickup","required":true,"in":"query","schema":{"type":"string"}},{"name":"delivery","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Delivery"],"security":[{"bearer":[]}]}},"/delivery/manifest":{"post":{"operationId":"DeliveryController_generateManifest","summary":"Generate manifest for Delhivery shipments","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenerateManifestDto"}}}},"responses":{"201":{"description":""}},"tags":["Delivery"],"security":[{"bearer":[]}]}},"/delivery/label/{trackingId}":{"get":{"operationId":"DeliveryController_generateLabel","summary":"Generate packing slip/label for shipment","parameters":[{"name":"trackingId","required":true,"in":"path","schema":{"type":"string"}},{"name":"partnerId","required":true,"in":"query","schema":{"type":"string"}},{"name":"format","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Delivery"],"security":[{"bearer":[]}]}},"/delivery/pickup":{"post":{"operationId":"DeliveryController_schedulePickup","summary":"Schedule pickup for Delhivery","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SchedulePickupDto"}}}},"responses":{"201":{"description":""}},"tags":["Delivery"],"security":[{"bearer":[]}]}},"/delivery/cancel/{trackingId}":{"post":{"operationId":"DeliveryController_cancelShipment","summary":"Cancel Delhivery shipment","parameters":[{"name":"trackingId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CancelShipmentDto"}}}},"responses":{"201":{"description":""}},"tags":["Delivery"],"security":[{"bearer":[]}]}},"/payouts/ledger":{"get":{"operationId":"PayoutsController_getLedger","summary":"Get seller ledger","parameters":[{"name":"page","required":true,"in":"query","schema":{"type":"string"}},{"name":"limit","required":true,"in":"query","schema":{"type":"string"}},{"name":"type","required":true,"in":"query","schema":{"type":"string"}},{"name":"from","required":true,"in":"query","schema":{"type":"string"}},{"name":"to","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Payouts"],"security":[{"bearer":[]}]}},"/payouts/list":{"get":{"operationId":"PayoutsController_getPayouts","summary":"Get seller payouts","parameters":[{"name":"page","required":true,"in":"query","schema":{"type":"string"}},{"name":"limit","required":true,"in":"query","schema":{"type":"string"}},{"name":"status","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Payouts"],"security":[{"bearer":[]}]}},"/payouts/overview":{"get":{"operationId":"PayoutsController_getOverview","summary":"Get seller settlement overview","parameters":[],"responses":{"200":{"description":""}},"tags":["Payouts"],"security":[{"bearer":[]}]}},"/payouts/request":{"post":{"operationId":"PayoutsController_requestPayout","summary":"Request manual payout (Seller)","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RequestPayoutDto"}}}},"responses":{"201":{"description":""}},"tags":["Payouts"],"security":[{"bearer":[]}]}},"/payouts/admin/list":{"get":{"operationId":"PayoutsController_getAdminPayouts","summary":"Get all payouts (Admin)","parameters":[{"name":"page","required":true,"in":"query","schema":{"type":"string"}},{"name":"limit","required":true,"in":"query","schema":{"type":"string"}},{"name":"status","required":true,"in":"query","schema":{"type":"string"}},{"name":"sellerId","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Payouts"],"security":[{"bearer":[]}]}},"/payouts/admin/summary":{"get":{"operationId":"PayoutsController_getAdminSummary","summary":"Get payout summary (Admin)","parameters":[],"responses":{"200":{"description":""}},"tags":["Payouts"],"security":[{"bearer":[]}]}},"/payouts/admin/seller/{sellerId}/settlement-breakdown":{"get":{"operationId":"PayoutsController_getAdminSellerSettlementBreakdown","summary":"Per-seller settlement ledger: commission tier, return/COD holds, payout eligibility (Admin)","parameters":[{"name":"sellerId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Payouts"],"security":[{"bearer":[]}]}},"/payouts/process":{"post":{"operationId":"PayoutsController_processBatch","summary":"Process payout batch (Admin)","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProcessPayoutBatchDto"}}}},"responses":{"201":{"description":""}},"tags":["Payouts"],"security":[{"bearer":[]}]}},"/payouts/{payoutId}/status":{"post":{"operationId":"PayoutsController_updateStatus","summary":"Update payout status (Admin)","parameters":[{"name":"payoutId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdatePayoutStatusDto"}}}},"responses":{"201":{"description":""}},"tags":["Payouts"],"security":[{"bearer":[]}]}},"/cart":{"get":{"operationId":"CartController_getCart","summary":"Get user cart","parameters":[],"responses":{"200":{"description":""}},"tags":["Cart"],"security":[{"bearer":[]}]}},"/cart/add":{"post":{"operationId":"CartController_addToCart","summary":"Add item to cart","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddToCartDto"}}}},"responses":{"201":{"description":""}},"tags":["Cart"],"security":[{"bearer":[]}]}},"/cart/items/{index}":{"put":{"operationId":"CartController_updateItem","summary":"Update cart item quantity","parameters":[{"name":"index","required":true,"in":"path","schema":{"type":"number"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateCartItemDto"}}}},"responses":{"200":{"description":""}},"tags":["Cart"],"security":[{"bearer":[]}]},"delete":{"operationId":"CartController_removeItem","summary":"Remove item from cart","parameters":[{"name":"index","required":true,"in":"path","schema":{"type":"number"}}],"responses":{"200":{"description":""}},"tags":["Cart"],"security":[{"bearer":[]}]}},"/cart/coupon":{"post":{"operationId":"CartController_applyCoupon","summary":"Apply coupon to cart","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApplyCouponDto"}}}},"responses":{"201":{"description":""}},"tags":["Cart"],"security":[{"bearer":[]}]},"delete":{"operationId":"CartController_removeCoupon","summary":"Remove coupon from cart","parameters":[],"responses":{"200":{"description":""}},"tags":["Cart"],"security":[{"bearer":[]}]}},"/cart/coupon/auto":{"post":{"operationId":"CartController_autoApplyCoupon","summary":"Auto-apply best eligible coupon to cart","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AutoApplyCouponDto"}}}},"responses":{"201":{"description":""}},"tags":["Cart"],"security":[{"bearer":[]}]}},"/cart/clear":{"delete":{"operationId":"CartController_clearCart","summary":"Clear cart","parameters":[],"responses":{"200":{"description":""}},"tags":["Cart"],"security":[{"bearer":[]}]}},"/cart/shipping-estimate":{"post":{"operationId":"CartController_estimateShipping","summary":"Estimate shipping cost for cart to destination pincode","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShippingEstimateDto"}}}},"responses":{"201":{"description":""}},"tags":["Cart"],"security":[{"bearer":[]}]}},"/cart/shipping-estimate-buy-now":{"post":{"operationId":"CartController_estimateShippingBuyNow","summary":"Estimate shipping cost for buy-now item (cart-independent)","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BuyNowShippingEstimateDto"}}}},"responses":{"201":{"description":""}},"tags":["Cart"],"security":[{"bearer":[]}]}},"/coupons/validate":{"post":{"operationId":"CouponsController_validateCoupon","summary":"Validate coupon code","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidateCouponDto"}}}},"responses":{"201":{"description":""}},"tags":["Coupons"],"security":[{"bearer":[]}]}},"/coupons/available":{"post":{"operationId":"CouponsController_listAvailableCoupons","summary":"List active coupons and eligibility for current user","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListAvailableCouponsDto"}}}},"responses":{"201":{"description":""}},"tags":["Coupons"],"security":[{"bearer":[]}]}},"/coupons":{"get":{"operationId":"CouponsController_getAllCoupons","summary":"Get all coupons (Admin)","parameters":[],"responses":{"200":{"description":""}},"tags":["Coupons"],"security":[{"bearer":[]}]},"post":{"operationId":"CouponsController_createCoupon","summary":"Create coupon (Admin)","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateCouponDto"}}}},"responses":{"201":{"description":""}},"tags":["Coupons"],"security":[{"bearer":[]}]}},"/coupons/{id}":{"put":{"operationId":"CouponsController_updateCoupon","summary":"Update coupon (Admin)","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateCouponDto"}}}},"responses":{"200":{"description":""}},"tags":["Coupons"],"security":[{"bearer":[]}]},"delete":{"operationId":"CouponsController_deleteCoupon","summary":"Delete coupon (Admin)","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Coupons"],"security":[{"bearer":[]}]}},"/shipments/create/{orderId}":{"post":{"operationId":"ShipmentsController_createShipments","summary":"Create shipments for order (one per seller)","parameters":[{"name":"orderId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateShipmentsDto"}}}},"responses":{"201":{"description":""}},"tags":["Shipments"],"security":[{"bearer":[]}]}},"/shipments/order/{orderId}":{"get":{"operationId":"ShipmentsController_getShipmentsByOrder","summary":"Get shipments for an order (Admin)","parameters":[{"name":"orderId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Shipments"],"security":[{"bearer":[]}]}},"/shipments/tracking/{orderId}":{"get":{"operationId":"ShipmentsController_getOrderTracking","summary":"Get order tracking with shipment details (Admin)","parameters":[{"name":"orderId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Shipments"],"security":[{"bearer":[]}]}},"/shipments/{shipmentId}":{"get":{"operationId":"ShipmentsController_getShipment","summary":"Get shipment by ID (Admin)","parameters":[{"name":"shipmentId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Shipments"],"security":[{"bearer":[]}]}},"/refunds":{"post":{"operationId":"RefundsController_initiateRefund","summary":"Initiate refund (Admin)","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InitiateRefundDto"}}}},"responses":{"201":{"description":""}},"tags":["Refunds"],"security":[{"bearer":[]}]},"get":{"operationId":"RefundsController_getAllRefunds","summary":"Get all refunds (Admin)","parameters":[{"name":"page","required":true,"in":"query","schema":{"type":"number"}},{"name":"limit","required":true,"in":"query","schema":{"type":"number"}},{"name":"status","required":true,"in":"query","schema":{"type":"string"}},{"name":"search","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Refunds"],"security":[{"bearer":[]}]}},"/refunds/return/{returnId}":{"post":{"operationId":"RefundsController_initiateRefundForReturn","summary":"Initiate refund for approved return (Admin)","parameters":[{"name":"returnId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InitiateReturnRefundDto"}}}},"responses":{"201":{"description":""}},"tags":["Refunds"],"security":[{"bearer":[]}]}},"/refunds/return/{returnId}/seller":{"post":{"operationId":"RefundsController_initiateRefundForReturnBySeller","summary":"Initiate refund for approved return (Seller)","parameters":[{"name":"returnId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InitiateReturnRefundDto"}}}},"responses":{"201":{"description":""}},"tags":["Refunds"],"security":[{"bearer":[]}]}},"/refunds/{refundId}/status":{"post":{"operationId":"RefundsController_updateRefundStatus","summary":"Manually complete or fail a refund (Admin)","parameters":[{"name":"refundId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateRefundStatusDto"}}}},"responses":{"201":{"description":""}},"tags":["Refunds"],"security":[{"bearer":[]}]}},"/refunds/{refundId}/status/seller":{"post":{"operationId":"RefundsController_updateRefundStatusBySeller","summary":"Seller manually complete or fail a COD/manual refund","parameters":[{"name":"refundId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateRefundStatusDto"}}}},"responses":{"201":{"description":""}},"tags":["Refunds"],"security":[{"bearer":[]}]}},"/refunds/webhook":{"post":{"operationId":"RefundsController_handleWebhook","summary":"RazorpayX refund webhook","parameters":[],"responses":{"201":{"description":""}},"tags":["Refunds"]}},"/refunds/me":{"get":{"operationId":"RefundsController_listMyRefunds","summary":"List my refunds (customer)","parameters":[],"responses":{"200":{"description":""}},"tags":["Refunds"],"security":[{"bearer":[]}]}},"/refunds/order/{orderId}":{"get":{"operationId":"RefundsController_getRefundByOrder","summary":"Get refund by order ID","parameters":[{"name":"orderId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Refunds"],"security":[{"bearer":[]}]}},"/cms/pages/{slug}":{"get":{"operationId":"CmsController_getPage","summary":"Get CMS page by slug","parameters":[{"name":"slug","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["CMS"]},"put":{"operationId":"CmsController_updatePage","summary":"Update CMS page (Admin)","parameters":[{"name":"slug","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdatePageDto"}}}},"responses":{"200":{"description":""}},"tags":["CMS"],"security":[{"bearer":[]}]},"delete":{"operationId":"CmsController_deletePage","summary":"Delete CMS page (Admin)","parameters":[{"name":"slug","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["CMS"],"security":[{"bearer":[]}]}},"/cms/pages":{"get":{"operationId":"CmsController_getAllPages","summary":"Get all CMS pages (Admin)","parameters":[],"responses":{"200":{"description":""}},"tags":["CMS"],"security":[{"bearer":[]}]},"post":{"operationId":"CmsController_createPage","summary":"Create CMS page (Admin)","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatePageDto"}}}},"responses":{"201":{"description":""}},"tags":["CMS"],"security":[{"bearer":[]}]}},"/cms/collections/{slug}":{"get":{"operationId":"CmsController_getCollection","summary":"Get collection by slug","parameters":[{"name":"slug","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["CMS"]},"put":{"operationId":"CmsController_updateCollection","summary":"Update collection (Admin)","parameters":[{"name":"slug","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateCollectionDto"}}}},"responses":{"200":{"description":""}},"tags":["CMS"],"security":[{"bearer":[]}]},"delete":{"operationId":"CmsController_deleteCollection","summary":"Delete collection (Admin)","parameters":[{"name":"slug","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["CMS"],"security":[{"bearer":[]}]}},"/cms/collections":{"get":{"operationId":"CmsController_getAllCollections","summary":"Get all collections (Admin)","parameters":[],"responses":{"200":{"description":""}},"tags":["CMS"],"security":[{"bearer":[]}]},"post":{"operationId":"CmsController_createCollection","summary":"Create collection (Admin)","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateCollectionDto"}}}},"responses":{"201":{"description":""}},"tags":["CMS"],"security":[{"bearer":[]}]}},"/cms/banners":{"get":{"operationId":"CmsController_getBanners","summary":"Get banners","parameters":[{"name":"position","required":true,"in":"query","schema":{"type":"string"}},{"name":"categoryId","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["CMS"]},"post":{"operationId":"CmsController_createBanner","summary":"Create banner (Admin)","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateBannerDto"}}}},"responses":{"201":{"description":""}},"tags":["CMS"],"security":[{"bearer":[]}]}},"/cms/banners/all":{"get":{"operationId":"CmsController_getAllBanners","summary":"Get all banners (Admin)","parameters":[],"responses":{"200":{"description":""}},"tags":["CMS"],"security":[{"bearer":[]}]}},"/cms/banners/{id}":{"put":{"operationId":"CmsController_updateBanner","summary":"Update banner (Admin)","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateBannerDto"}}}},"responses":{"200":{"description":""}},"tags":["CMS"],"security":[{"bearer":[]}]},"delete":{"operationId":"CmsController_deleteBanner","summary":"Delete banner (Admin)","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["CMS"],"security":[{"bearer":[]}]}},"/cms/banners/{id}/click":{"post":{"operationId":"CmsController_trackClick","summary":"Track banner click","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"201":{"description":""}},"tags":["CMS"]}},"/wishlist":{"get":{"operationId":"WishlistController_getWishlist","summary":"Get user wishlist","parameters":[],"responses":{"200":{"description":""}},"tags":["Wishlist"],"security":[{"bearer":[]}]},"post":{"operationId":"WishlistController_addToWishlist","summary":"Add to wishlist","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddWishlistDto"}}}},"responses":{"201":{"description":""}},"tags":["Wishlist"],"security":[{"bearer":[]}]}},"/wishlist/product/{productId}":{"delete":{"operationId":"WishlistController_removeFromWishlistByProduct","summary":"Remove from wishlist by product ID","parameters":[{"name":"productId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WishlistVariantBodyDto"}}}},"responses":{"200":{"description":""}},"tags":["Wishlist"],"security":[{"bearer":[]}]}},"/wishlist/{id}":{"delete":{"operationId":"WishlistController_removeFromWishlist","summary":"Remove from wishlist by wishlist ID","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Wishlist"],"security":[{"bearer":[]}]}},"/wishlist/check/{productId}":{"get":{"operationId":"WishlistController_checkWishlist","summary":"Check if product is in wishlist","parameters":[{"name":"productId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WishlistVariantDto"}}}},"responses":{"200":{"description":""}},"tags":["Wishlist"],"security":[{"bearer":[]}]}},"/analytics/track":{"post":{"operationId":"AnalyticsController_trackEvent","summary":"Track analytics event","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrackEventDto"}}}},"responses":{"201":{"description":""}},"tags":["Analytics"]}},"/analytics/events":{"get":{"operationId":"AnalyticsController_listEvents","summary":"List analytics events (Admin)","parameters":[],"responses":{"200":{"description":""}},"tags":["Analytics"],"security":[{"bearer":[]}]}},"/analytics/events/summary":{"get":{"operationId":"AnalyticsController_getEventSummary","summary":"Event summary for visualizations (Admin)","parameters":[{"name":"startDate","required":true,"in":"query","schema":{"type":"string"}},{"name":"endDate","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Analytics"],"security":[{"bearer":[]}]}},"/analytics/dashboard":{"get":{"operationId":"AnalyticsController_getDashboardStats","summary":"Get dashboard statistics (Admin)","parameters":[],"responses":{"200":{"description":""}},"tags":["Analytics"],"security":[{"bearer":[]}]}},"/analytics/sales-report":{"get":{"operationId":"AnalyticsController_getSalesReport","summary":"Get sales report (Admin)","parameters":[],"responses":{"200":{"description":""}},"tags":["Analytics"],"security":[{"bearer":[]}]}},"/analytics/product/{productId}":{"get":{"operationId":"AnalyticsController_getProductPerformance","summary":"Get product performance (Admin)","parameters":[{"name":"productId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Analytics"],"security":[{"bearer":[]}]}},"/analytics/sellers/top-performers":{"get":{"operationId":"AnalyticsController_getTopSellersByRevenue","summary":"Top sellers by revenue (Admin)","parameters":[],"responses":{"200":{"description":""}},"tags":["Analytics"],"security":[{"bearer":[]}]}},"/analytics/sellers/top-traffic":{"get":{"operationId":"AnalyticsController_getTopSellersByTraffic","summary":"Top sellers by product views / traffic (Admin)","parameters":[],"responses":{"200":{"description":""}},"tags":["Analytics"],"security":[{"bearer":[]}]}},"/admin/analytics/overview":{"get":{"operationId":"AdminAnalyticsController_getOverview","parameters":[],"responses":{"200":{"description":""}}}},"/admin/analytics/sellers":{"get":{"operationId":"AdminAnalyticsController_getSellers","parameters":[],"responses":{"200":{"description":""}}}},"/admin/analytics/customers":{"get":{"operationId":"AdminAnalyticsController_getCustomers","parameters":[],"responses":{"200":{"description":""}}}},"/admin/analytics/orders":{"get":{"operationId":"AdminAnalyticsController_getOrders","parameters":[],"responses":{"200":{"description":""}}}},"/admin/analytics/finance":{"get":{"operationId":"AdminAnalyticsController_getFinance","parameters":[],"responses":{"200":{"description":""}}}},"/admin/analytics/subscriptions":{"get":{"operationId":"AdminAnalyticsController_getSubscriptions","parameters":[],"responses":{"200":{"description":""}}}},"/admin/analytics/referrals":{"get":{"operationId":"AdminAnalyticsController_getReferrals","parameters":[],"responses":{"200":{"description":""}}}},"/admin/analytics/returns-refunds":{"get":{"operationId":"AdminAnalyticsController_getReturnsRefunds","parameters":[],"responses":{"200":{"description":""}}}},"/contact":{"post":{"operationId":"ContactController_submitContact","summary":"Submit contact form","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateContactDto"}}}},"responses":{"201":{"description":""}},"tags":["Contact"]},"get":{"operationId":"ContactController_getAllContacts","summary":"Get all contact submissions (Admin)","parameters":[{"name":"page","required":true,"in":"query","schema":{"type":"string"}},{"name":"limit","required":true,"in":"query","schema":{"type":"string"}},{"name":"search","required":true,"in":"query","schema":{"type":"string"}},{"name":"isRead","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Contact"],"security":[{"bearer":[]}]}},"/contact/unread-count":{"get":{"operationId":"ContactController_getUnreadCount","summary":"Get unread contact count (Admin)","parameters":[],"responses":{"200":{"description":""}},"tags":["Contact"],"security":[{"bearer":[]}]}},"/contact/my-submissions":{"get":{"operationId":"ContactController_getMySubmissions","summary":"Get my contact submissions (User)","parameters":[],"responses":{"200":{"description":""}},"tags":["Contact"],"security":[{"bearer":[]}]}},"/contact/{id}":{"get":{"operationId":"ContactController_getContactById","summary":"Get contact by ID (Admin)","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Contact"],"security":[{"bearer":[]}]},"delete":{"operationId":"ContactController_deleteContact","summary":"Delete contact submission (Admin)","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Contact"],"security":[{"bearer":[]}]}},"/contact/{id}/read":{"put":{"operationId":"ContactController_markAsRead","summary":"Mark contact as read (Admin)","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Contact"],"security":[{"bearer":[]}]}},"/contact/{id}/unread":{"put":{"operationId":"ContactController_markAsUnread","summary":"Mark contact as unread (Admin)","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Contact"],"security":[{"bearer":[]}]}},"/contact/{id}/reply":{"put":{"operationId":"ContactController_addReply","summary":"Add reply to contact (Admin)","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReplyContactDto"}}}},"responses":{"200":{"description":""}},"tags":["Contact"],"security":[{"bearer":[]}]}},"/newsletter/subscribe":{"post":{"operationId":"NewsletterController_subscribe","summary":"Subscribe to newsletter","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmailDto"}}}},"responses":{"201":{"description":""}},"tags":["Newsletter"]}},"/newsletter/unsubscribe":{"post":{"operationId":"NewsletterController_unsubscribe","summary":"Unsubscribe from newsletter","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmailDto"}}}},"responses":{"201":{"description":""}},"tags":["Newsletter"]}},"/newsletter/subscribers":{"get":{"operationId":"NewsletterController_getAllSubscribers","summary":"Get all newsletter subscribers (Admin)","parameters":[],"responses":{"200":{"description":""}},"tags":["Newsletter"],"security":[{"bearer":[]}]}},"/newsletter/count":{"get":{"operationId":"NewsletterController_getSubscriberCount","summary":"Get newsletter subscriber count (Admin)","parameters":[],"responses":{"200":{"description":""}},"tags":["Newsletter"],"security":[{"bearer":[]}]}},"/reviews":{"post":{"operationId":"ReviewsController_createReview","summary":"Create a product review","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateReviewDto"}}}},"responses":{"201":{"description":""}},"tags":["Reviews"],"security":[{"bearer":[]}]},"get":{"operationId":"ReviewsController_getAllReviews","summary":"Get all reviews (Admin)","parameters":[{"name":"page","required":true,"in":"query","schema":{"type":"number"}},{"name":"limit","required":true,"in":"query","schema":{"type":"number"}}],"responses":{"200":{"description":""}},"tags":["Reviews"],"security":[{"bearer":[]}]}},"/reviews/{id}":{"put":{"operationId":"ReviewsController_updateReview","summary":"Update a review","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateReviewDto"}}}},"responses":{"200":{"description":""}},"tags":["Reviews"],"security":[{"bearer":[]}]},"delete":{"operationId":"ReviewsController_deleteReview","summary":"Delete a review","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Reviews"],"security":[{"bearer":[]}]}},"/reviews/product/{productId}":{"get":{"operationId":"ReviewsController_getProductReviews","summary":"Get reviews for a product","parameters":[{"name":"productId","required":true,"in":"path","schema":{"type":"string"}},{"name":"page","required":true,"in":"query","schema":{"type":"number"}},{"name":"limit","required":true,"in":"query","schema":{"type":"number"}}],"responses":{"200":{"description":""}},"tags":["Reviews"]}},"/reviews/product/{productId}/user":{"get":{"operationId":"ReviewsController_getUserReview","summary":"Get user review for a product","parameters":[{"name":"productId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Reviews"],"security":[{"bearer":[]}]}},"/reviews/can-review/{productId}":{"get":{"operationId":"ReviewsController_canUserReview","summary":"Check if user can review a product","parameters":[{"name":"productId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Reviews"],"security":[{"bearer":[]}]}},"/reviews/{id}/approve":{"put":{"operationId":"ReviewsController_approveReview","summary":"Approve a review (Admin)","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Reviews"],"security":[{"bearer":[]}]}},"/reviews/{id}/reject":{"put":{"operationId":"ReviewsController_rejectReview","summary":"Reject a review (Admin)","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Reviews"],"security":[{"bearer":[]}]}},"/seller/public/by-host":{"get":{"operationId":"SellerController_getPublicSellerByHost","summary":"Resolve active seller username from storefront hostname (public)","parameters":[{"name":"host","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Seller"]}},"/seller/public/caddy/ask":{"get":{"operationId":"SellerController_caddyOnDemandAsk","summary":"Caddy on-demand TLS gate (internal): 200 if the domain is registered to a seller, 403 otherwise","parameters":[{"name":"domain","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Seller"]}},"/seller/public/{idOrUsername}":{"get":{"operationId":"SellerController_getPublicSeller","summary":"Get seller by ID or username (Public, active only)","parameters":[{"name":"idOrUsername","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Seller"]}},"/seller/public/{idOrUsername}/storefront":{"get":{"operationId":"SellerController_getPublicStorefront","summary":"Merged storefront config for buyer seller page (does not change marketplace home)","parameters":[{"name":"idOrUsername","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Seller"]}},"/seller/public/{idOrUsername}/catalog-categories":{"get":{"operationId":"SellerController_getPublicCatalogCategories","summary":"Categories for this seller’s catalog only (no global taxonomy dump)","parameters":[{"name":"idOrUsername","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Seller"]}},"/seller/public/{idOrUsername}/products-by-ids":{"get":{"operationId":"SellerController_getPublicSellerProductsByIds","summary":"Active products by id for this seller only (storefront sections)","parameters":[{"name":"idOrUsername","required":true,"in":"path","schema":{"type":"string"}},{"name":"ids","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Seller"]}},"/seller/storefront":{"patch":{"operationId":"SellerController_patchStorefront","summary":"Update buyer storefront config (seller page only)","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateSellerStorefrontDto"}}}},"responses":{"200":{"description":""}},"tags":["Seller"],"security":[{"bearer":[]}]}},"/seller/custom-domain":{"get":{"operationId":"SellerController_getCustomDomain","summary":"Custom domain connection status and DNS instructions","parameters":[],"responses":{"200":{"description":""}},"tags":["Seller"],"security":[{"bearer":[]}]},"post":{"operationId":"SellerController_connectCustomDomain","summary":"Connect a custom domain (routed via our Caddy reverse proxy)","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConnectCustomDomainDto"}}}},"responses":{"201":{"description":""}},"tags":["Seller"],"security":[{"bearer":[]}]},"delete":{"operationId":"SellerController_disconnectCustomDomain","summary":"Disconnect custom domain","parameters":[],"responses":{"200":{"description":""}},"tags":["Seller"],"security":[{"bearer":[]}]}},"/seller/custom-domain/verify":{"post":{"operationId":"SellerController_verifyCustomDomain","summary":"Re-check DNS resolution for custom domain","parameters":[],"responses":{"201":{"description":""}},"tags":["Seller"],"security":[{"bearer":[]}]}},"/seller/public":{"get":{"operationId":"SellerController_publicSellers","summary":"List sellers (Public)","parameters":[{"name":"limit","required":true,"in":"query","schema":{"type":"number"}},{"name":"status","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Seller"]}},"/seller/apply":{"post":{"operationId":"SellerController_apply","summary":"Apply / update seller business details","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SellerApplyDto"}}}},"responses":{"201":{"description":""}},"tags":["Seller"],"security":[{"bearer":[]}]}},"/seller/pickup-location":{"post":{"operationId":"SellerController_createOrUpdatePickupLocation","summary":"Create or update pickup location for Delhivery","deprecated":true,"description":"Superseded by POST/PUT /seller/pickup-addresses. Kept for backward compatibility only.","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PickupLocationDto"}}}},"responses":{"201":{"description":""}},"tags":["Seller"],"security":[{"bearer":[]}]},"get":{"operationId":"SellerController_getPickupLocation","summary":"Get my pickup location","deprecated":true,"description":"Superseded by GET /seller/pickup-addresses. Kept for backward compatibility only.","parameters":[],"responses":{"200":{"description":""}},"tags":["Seller"],"security":[{"bearer":[]}]}},"/seller/pickup-addresses":{"get":{"operationId":"SellerController_listPickupAddresses","summary":"List my pickup addresses","parameters":[],"responses":{"200":{"description":""}},"tags":["Seller"],"security":[{"bearer":[]}]},"post":{"operationId":"SellerController_createPickupAddress","summary":"Create a pickup address","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PickupLocationDto"}}}},"responses":{"201":{"description":""}},"tags":["Seller"],"security":[{"bearer":[]}]}},"/seller/pickup-addresses/{addressId}":{"put":{"operationId":"SellerController_updatePickupAddress","summary":"Update a pickup address","parameters":[{"name":"addressId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PickupLocationDto"}}}},"responses":{"200":{"description":""}},"tags":["Seller"],"security":[{"bearer":[]}]},"delete":{"operationId":"SellerController_deactivatePickupAddress","summary":"Deactivate a pickup address","parameters":[{"name":"addressId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Seller"],"security":[{"bearer":[]}]}},"/seller/pickup-addresses/{addressId}/default":{"post":{"operationId":"SellerController_setDefaultPickupAddress","summary":"Set default pickup address","parameters":[{"name":"addressId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"201":{"description":""}},"tags":["Seller"],"security":[{"bearer":[]}]}},"/seller/shipments":{"get":{"operationId":"SellerController_listShipments","summary":"List my shipments","parameters":[{"name":"page","required":true,"in":"query","schema":{"type":"number"}},{"name":"limit","required":true,"in":"query","schema":{"type":"number"}},{"name":"status","required":true,"in":"query","schema":{"type":"string"}},{"name":"search","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Seller"],"security":[{"bearer":[]}]}},"/seller/returns":{"get":{"operationId":"SellerController_listReturns","summary":"List returns for my store","parameters":[{"name":"page","required":true,"in":"query","schema":{"type":"number"}},{"name":"limit","required":true,"in":"query","schema":{"type":"number"}},{"name":"status","required":true,"in":"query","schema":{"type":"string"}},{"name":"search","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Seller"],"security":[{"bearer":[]}]}},"/seller/activation":{"get":{"operationId":"SellerController_activation","summary":"Canonical seller launch status derived from existing persistence (store, KYC, products, payout, branding, domain, Meta, Counter)","parameters":[],"responses":{"200":{"description":""}},"tags":["Seller"],"security":[{"bearer":[]}]}},"/seller/me":{"get":{"operationId":"SellerController_me","summary":"Get my seller account","parameters":[],"responses":{"200":{"description":""}},"tags":["Seller"],"security":[{"bearer":[]}]}},"/seller/username-available":{"get":{"operationId":"SellerController_usernameAvailable","summary":"Check whether a store username is available","parameters":[{"name":"username","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Seller"],"security":[{"bearer":[]}]}},"/seller/onboarding/choose-standard":{"post":{"operationId":"SellerController_onboardingChooseStandard","summary":"Select Standard (no subscription) — 5% platform fee tier","parameters":[],"responses":{"201":{"description":""}},"tags":["Seller"],"security":[{"bearer":[]}]}},"/seller/onboarding/pickup-address":{"post":{"operationId":"SellerController_onboardingPickupAddress","summary":"Save pickup address during onboarding (pending sellers can use this before activation)","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PickupLocationDto"}}}},"responses":{"201":{"description":""}},"tags":["Seller"],"security":[{"bearer":[]}]}},"/seller/onboarding/kyc-documents":{"post":{"operationId":"SellerController_onboardingKycDocuments","summary":"Upload KYC references (URLs after S3 upload): Aadhaar, PAN, trade licence — required before admin approval","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SellerKycDocumentsDto"}}}},"responses":{"201":{"description":""}},"tags":["Seller"],"security":[{"bearer":[]}]}},"/seller/verify-contact-phone/send-otp":{"post":{"operationId":"SellerController_sendContactPhoneVerificationOtp","summary":"Send OTP to verify pickup contact phone (same code resent while valid)","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SellerContactPhoneOtpDto"}}}},"responses":{"201":{"description":""}},"tags":["Seller"],"security":[{"bearer":[]}]}},"/seller/verify-contact-phone/verify":{"post":{"operationId":"SellerController_verifyContactPhoneVerificationOtp","summary":"Verify pickup contact phone OTP","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifySellerContactPhoneOtpDto"}}}},"responses":{"200":{"description":""}},"tags":["Seller"],"security":[{"bearer":[]}]}},"/seller/bank-details":{"post":{"operationId":"SellerController_saveBankDetails","summary":"Create or update seller payout bank details","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateBankDetailsDto"}}}},"responses":{"201":{"description":""}},"tags":["Seller"],"security":[{"bearer":[]}]}},"/seller/products":{"get":{"operationId":"SellerController_listProducts","summary":"List my products","parameters":[{"name":"page","required":true,"in":"query","schema":{"type":"number"}},{"name":"limit","required":true,"in":"query","schema":{"type":"number"}},{"name":"search","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Seller"],"security":[{"bearer":[]}]},"post":{"operationId":"SellerController_createProduct","summary":"Create product (pending sellers may catalogue; selling stays locked until approval)","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateProductDto"}}}},"responses":{"201":{"description":""}},"tags":["Seller"],"security":[{"bearer":[]}]}},"/seller/categories":{"get":{"operationId":"SellerController_listCategories","summary":"List categories available to this seller","parameters":[],"responses":{"200":{"description":""}},"tags":["Seller"],"security":[{"bearer":[]}]},"post":{"operationId":"SellerController_createCategory","summary":"Create category owned by seller","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateCategoryDto"}}}},"responses":{"201":{"description":""}},"tags":["Seller"],"security":[{"bearer":[]}]}},"/seller/categories/{id}":{"patch":{"operationId":"SellerController_updateCategory","summary":"Update seller-owned category","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateCategoryDto"}}}},"responses":{"200":{"description":""}},"tags":["Seller"],"security":[{"bearer":[]}]},"delete":{"operationId":"SellerController_deleteCategory","summary":"Delete seller-owned category","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Seller"],"security":[{"bearer":[]}]}},"/seller/products/bulk-import/template":{"get":{"operationId":"SellerController_downloadBulkImportTemplate","summary":"Download XLSX template for bulk product import","parameters":[],"responses":{"200":{"description":""}},"tags":["Seller"],"security":[{"bearer":[]}]}},"/seller/products/bulk-import/jobs":{"get":{"operationId":"SellerController_listBulkImportJobs","summary":"List bulk import job history","parameters":[{"name":"page","required":true,"in":"query","schema":{"type":"string"}},{"name":"limit","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Seller"],"security":[{"bearer":[]}]}},"/seller/products/bulk-import/jobs/active":{"get":{"operationId":"SellerController_getActiveBulkImportJob","summary":"Get active bulk import job for live feed","parameters":[],"responses":{"200":{"description":""}},"tags":["Seller"],"security":[{"bearer":[]}]}},"/seller/products/bulk-import/jobs/{jobId}":{"get":{"operationId":"SellerController_getBulkImportJob","summary":"Get bulk import job status","parameters":[{"name":"jobId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Seller"],"security":[{"bearer":[]}]}},"/seller/products/bulk-import/jobs/{jobId}/cancel":{"post":{"operationId":"SellerController_cancelBulkImportJob","summary":"Cancel a running bulk import job","parameters":[{"name":"jobId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"201":{"description":""}},"tags":["Seller"],"security":[{"bearer":[]}]}},"/seller/products/bulk-import/jobs/{jobId}/resume":{"post":{"operationId":"SellerController_resumeBulkImportJob","summary":"Resume interrupted bulk import from last checkpoint","parameters":[{"name":"jobId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"201":{"description":""}},"tags":["Seller"],"security":[{"bearer":[]}]}},"/seller/products/bulk-import/jobs/{jobId}/failed-export":{"get":{"operationId":"SellerController_downloadFailedImportProducts","summary":"Download Excel report of failed products with missing/invalid fields","parameters":[{"name":"jobId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Seller"],"security":[{"bearer":[]}]}},"/seller/products/bulk-import/preview":{"post":{"operationId":"SellerController_previewBulkImport","summary":"Pre-flight validation of bulk import XLSX (no job started)","parameters":[],"responses":{"201":{"description":""}},"tags":["Seller"],"security":[{"bearer":[]}]}},"/seller/products/bulk-import":{"post":{"operationId":"SellerController_bulkImportProducts","summary":"Start background bulk import from XLSX file","parameters":[],"responses":{"201":{"description":""}},"tags":["Seller"],"security":[{"bearer":[]}]}},"/seller/products/{id}":{"get":{"operationId":"SellerController_getProduct","summary":"Get my product by id","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Seller"],"security":[{"bearer":[]}]},"patch":{"operationId":"SellerController_updateProduct","summary":"Update product (pending sellers may edit catalogue; selling stays locked until approval)","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateProductDto"}}}},"responses":{"200":{"description":""}},"tags":["Seller"],"security":[{"bearer":[]}]},"delete":{"operationId":"SellerController_deleteProduct","summary":"Delete product (Seller, not blocked)","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Seller"],"security":[{"bearer":[]}]}},"/seller/products/{id}/inventory":{"patch":{"operationId":"SellerController_updateInventory","summary":"Bulk update product inventory","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateInventoryDto"}}}},"responses":{"200":{"description":""}},"tags":["Seller"],"security":[{"bearer":[]}]}},"/seller/customers":{"get":{"operationId":"SellerController_listOnlineCustomers","summary":"Online storefront customers (buyers who ordered from you)","parameters":[{"name":"page","required":true,"in":"query","schema":{"type":"number"}},{"name":"limit","required":true,"in":"query","schema":{"type":"number"}},{"name":"q","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Seller"],"security":[{"bearer":[]}]}},"/seller/customers/{userId}/orders":{"get":{"operationId":"SellerController_listOnlineCustomerOrders","summary":"Orders from one online customer","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"page","required":true,"in":"query","schema":{"type":"number"}},{"name":"limit","required":true,"in":"query","schema":{"type":"number"}}],"responses":{"200":{"description":""}},"tags":["Seller"],"security":[{"bearer":[]}]}},"/seller/orders":{"get":{"operationId":"SellerController_listOrders","summary":"List orders containing seller items","parameters":[{"name":"page","required":true,"in":"query","schema":{"type":"number"}},{"name":"limit","required":true,"in":"query","schema":{"type":"number"}},{"name":"status","required":true,"in":"query","schema":{"type":"string"}},{"name":"from","required":true,"in":"query","schema":{"type":"string"}},{"name":"to","required":true,"in":"query","schema":{"type":"string"}},{"name":"orderId","required":true,"in":"query","schema":{"type":"string"}},{"name":"search","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Seller"],"security":[{"bearer":[]}]}},"/seller/orders/{orderId}":{"get":{"operationId":"SellerController_getOrder","summary":"Get order detail (seller items only)","parameters":[{"name":"orderId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Seller"],"security":[{"bearer":[]}]}},"/seller/orders/{orderId}/carrier-tracking":{"get":{"operationId":"SellerController_getOrderCarrierTracking","summary":"Delhivery shipment status for seller (platform API — no Delhivery merchant login)","parameters":[{"name":"orderId","required":true,"in":"path","schema":{"type":"string"}},{"name":"waybill","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Seller"],"security":[{"bearer":[]}]}},"/seller/orders/{orderId}/shipping-label":{"get":{"operationId":"SellerController_getOrderShippingLabel","summary":"Delhivery shipping label (PDF/URL/HTML) or printable packing slip for this order","parameters":[{"name":"orderId","required":true,"in":"path","schema":{"type":"string"}},{"name":"prefer","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Seller"],"security":[{"bearer":[]}]}},"/seller/delivery/partners":{"get":{"operationId":"SellerController_getDeliveryPartners","summary":"List delivery partners for shipping (Delhivery, Shiprocket, etc.)","parameters":[],"responses":{"200":{"description":""}},"tags":["Seller"],"security":[{"bearer":[]}]}},"/seller/orders/{orderId}/ship":{"post":{"operationId":"SellerController_shipOrder","summary":"Ship order via Delhivery or other delivery partner","parameters":[{"name":"orderId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SellerShipOrderDto"}}}},"responses":{"201":{"description":""}},"tags":["Seller"],"security":[{"bearer":[]}]}},"/seller/delivery/schedule-pickup":{"post":{"operationId":"SellerController_scheduleSellerPickup","summary":"Schedule a Delhivery pickup from your pickup location for your ready AWBs","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SellerSchedulePickupDto"}}}},"responses":{"201":{"description":""}},"tags":["Seller"],"security":[{"bearer":[]}]}},"/seller/delivery/manifest":{"post":{"operationId":"SellerController_generateSellerManifest","summary":"Generate a Delhivery manifest for your AWBs","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SellerGenerateManifestDto"}}}},"responses":{"201":{"description":""}},"tags":["Seller"],"security":[{"bearer":[]}]}},"/seller/billing/overview":{"get":{"operationId":"SellerController_billingOverview","summary":"Billing overview and earnings","parameters":[],"responses":{"200":{"description":""}},"tags":["Seller"],"security":[{"bearer":[]}]}},"/seller/billing/monetization":{"get":{"operationId":"SellerController_monetizationInfo","summary":"Commission model, subscription, trial, referral link, coupons","parameters":[],"responses":{"200":{"description":""}},"tags":["Seller"],"security":[{"bearer":[]}]}},"/seller/coupons":{"get":{"operationId":"SellerController_listCoupons","summary":"List my seller coupons","parameters":[],"responses":{"200":{"description":""}},"tags":["Seller"],"security":[{"bearer":[]}]},"post":{"operationId":"SellerController_createCoupon","summary":"Create seller coupon (seller scope only)","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateCouponDto"}}}},"responses":{"201":{"description":""}},"tags":["Seller"],"security":[{"bearer":[]}]}},"/seller/coupons/{id}":{"put":{"operationId":"SellerController_updateCoupon","summary":"Update seller coupon (owner only)","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateCouponDto"}}}},"responses":{"200":{"description":""}},"tags":["Seller"],"security":[{"bearer":[]}]},"delete":{"operationId":"SellerController_deleteCoupon","summary":"Delete seller coupon (owner only)","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Seller"],"security":[{"bearer":[]}]}},"/seller/billing/transactions":{"get":{"operationId":"SellerController_billingTransactions","summary":"Billing transaction history","parameters":[{"name":"page","required":true,"in":"query","schema":{"type":"number"}},{"name":"limit","required":true,"in":"query","schema":{"type":"number"}},{"name":"from","required":true,"in":"query","schema":{"type":"string"}},{"name":"to","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Seller"],"security":[{"bearer":[]}]}},"/seller/billing/simple-ledger":{"get":{"operationId":"SellerController_simpleLedger","summary":"Simple order-grouped ledger with totals (credits, debits, commission)","parameters":[],"responses":{"200":{"description":""}},"tags":["Seller"],"security":[{"bearer":[]}]}},"/seller/inventory/low-stock":{"get":{"operationId":"SellerController_lowStock","summary":"Products with low stock","parameters":[{"name":"threshold","required":true,"in":"query","schema":{"type":"number"}}],"responses":{"200":{"description":""}},"tags":["Seller"],"security":[{"bearer":[]}]}},"/seller/home/summary":{"get":{"operationId":"SellerController_homeSummary","summary":"Home summary: pending forward Delhivery assignment count and lifetime paid sales (seller line items)","parameters":[],"responses":{"200":{"description":""}},"tags":["Seller"],"security":[{"bearer":[]}]}},"/seller/analytics/dashboard":{"get":{"operationId":"SellerController_dashboard","summary":"Seller dashboard analytics","parameters":[],"responses":{"200":{"description":""}},"tags":["Seller"],"security":[{"bearer":[]}]}},"/seller/intelligence/dashboard":{"get":{"operationId":"SellerController_intelligenceDashboard","summary":"Consolidated seller dashboard intelligence (metrics, payout summary, signals, work queue)","parameters":[],"responses":{"200":{"description":""}},"tags":["Seller"],"security":[{"bearer":[]}]}},"/seller/intelligence/orders/{orderId}":{"get":{"operationId":"SellerController_orderIntelligence","summary":"Per-order intelligence (payout, fulfilment, buyer, risk) for order detail screens","parameters":[{"name":"orderId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Seller"],"security":[{"bearer":[]}]}},"/seller/analytics/sales-report":{"get":{"operationId":"SellerController_salesReport","summary":"Seller sales report (time series)","parameters":[],"responses":{"200":{"description":""}},"tags":["Seller"],"security":[{"bearer":[]}]}},"/seller/analytics/product/{productId}":{"get":{"operationId":"SellerController_productPerformance","summary":"Seller product performance (totals)","parameters":[{"name":"productId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Seller"],"security":[{"bearer":[]}]}},"/seller/analytics/product/{productId}/report":{"get":{"operationId":"SellerController_productAnalyticsReport","summary":"Single product analytics time series","parameters":[{"name":"productId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Seller"],"security":[{"bearer":[]}]}},"/seller/analytics/price-history":{"get":{"operationId":"SellerController_priceHistory","summary":"Price change history","parameters":[],"responses":{"200":{"description":""}},"tags":["Seller"],"security":[{"bearer":[]}]}},"/seller/analytics/views-report":{"get":{"operationId":"SellerController_viewsReport","summary":"Product views time series","parameters":[],"responses":{"200":{"description":""}},"tags":["Seller"],"security":[{"bearer":[]}]}},"/seller/analytics/add-to-cart-report":{"get":{"operationId":"SellerController_addToCartReport","summary":"Add to cart time series","parameters":[],"responses":{"200":{"description":""}},"tags":["Seller"],"security":[{"bearer":[]}]}},"/seller/analytics/wishlist-report":{"get":{"operationId":"SellerController_wishlistReport","summary":"Add to favourite (wishlist) time series","parameters":[],"responses":{"200":{"description":""}},"tags":["Seller"],"security":[{"bearer":[]}]}},"/seller/analytics/funnel":{"get":{"operationId":"SellerController_funnel","summary":"Conversion funnel (views → cart → purchase)","parameters":[],"responses":{"200":{"description":""}},"tags":["Seller"],"security":[{"bearer":[]}]}},"/seller/ndr-disputes":{"get":{"operationId":"SellerOpsController_listDisputes","summary":"List seller NDR/disputes","parameters":[],"responses":{"200":{"description":""}},"tags":["Seller Operations"],"security":[{"bearer":[]}]}},"/seller/ndr-disputes/{disputeId}/respond":{"post":{"operationId":"SellerOpsController_respondDispute","summary":"Respond to seller dispute/NDR","parameters":[{"name":"disputeId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RespondDisputeDto"}}}},"responses":{"201":{"description":""}},"tags":["Seller Operations"],"security":[{"bearer":[]}]}},"/seller/support/tickets":{"get":{"operationId":"SellerOpsController_listSupportTickets","summary":"List seller support tickets","parameters":[],"responses":{"200":{"description":""}},"tags":["Seller Operations"],"security":[{"bearer":[]}]},"post":{"operationId":"SellerOpsController_createSupportTicket","summary":"Create seller support ticket","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateSupportTicketDto"}}}},"responses":{"201":{"description":""}},"tags":["Seller Operations"],"security":[{"bearer":[]}]}},"/seller/support/tickets/{ticketId}":{"get":{"operationId":"SellerOpsController_getSupportTicket","summary":"Get seller support ticket by ticketId","parameters":[{"name":"ticketId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Seller Operations"],"security":[{"bearer":[]}]}},"/seller/support/tickets/{ticketId}/messages":{"post":{"operationId":"SellerOpsController_addSupportMessage","summary":"Add message to support ticket","parameters":[{"name":"ticketId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddSupportMessageDto"}}}},"responses":{"201":{"description":""}},"tags":["Seller Operations"],"security":[{"bearer":[]}]}},"/seller/notifications/preferences":{"get":{"operationId":"SellerOpsController_getNotificationPreferences","summary":"Get seller notification preferences","parameters":[],"responses":{"200":{"description":""}},"tags":["Seller Operations"],"security":[{"bearer":[]}]},"put":{"operationId":"SellerOpsController_updateNotificationPreferences","summary":"Update seller notification preferences","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateNotificationPreferencesDto"}}}},"responses":{"200":{"description":""}},"tags":["Seller Operations"],"security":[{"bearer":[]}]}},"/admin/seller-ops/disputes":{"get":{"operationId":"AdminSellerOpsController_listDisputes","summary":"List seller disputes (Admin)","parameters":[{"name":"status","required":true,"in":"query","schema":{"type":"string"}},{"name":"sellerId","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Admin Seller Operations"],"security":[{"bearer":[]}]}},"/admin/seller-ops/disputes/{disputeId}/status":{"post":{"operationId":"AdminSellerOpsController_updateDisputeStatus","summary":"Update dispute status (Admin)","parameters":[{"name":"disputeId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateDisputeStatusDto"}}}},"responses":{"201":{"description":""}},"tags":["Admin Seller Operations"],"security":[{"bearer":[]}]}},"/admin/seller-ops/support/tickets":{"get":{"operationId":"AdminSellerOpsController_listSupportTickets","summary":"List seller support tickets (Admin)","parameters":[{"name":"status","required":true,"in":"query","schema":{"type":"string"}},{"name":"sellerId","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Admin Seller Operations"],"security":[{"bearer":[]}]}},"/admin/seller-ops/support/tickets/{ticketId}/status":{"post":{"operationId":"AdminSellerOpsController_updateSupportTicketStatus","summary":"Update support ticket status (Admin)","parameters":[{"name":"ticketId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateSupportTicketStatusDto"}}}},"responses":{"201":{"description":""}},"tags":["Admin Seller Operations"],"security":[{"bearer":[]}]}},"/admin/seller-ops/support/tickets/{ticketId}/messages":{"post":{"operationId":"AdminSellerOpsController_replySupportTicket","summary":"Reply to support ticket and notify seller","parameters":[{"name":"ticketId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminSupportTicketMessageDto"}}}},"responses":{"201":{"description":""}},"tags":["Admin Seller Operations"],"security":[{"bearer":[]}]}},"/admin/sellers":{"get":{"operationId":"AdminSellersController_list","summary":"List seller profiles (Admin)","parameters":[{"name":"page","required":true,"in":"query","schema":{"type":"number"}},{"name":"limit","required":true,"in":"query","schema":{"type":"number"}},{"name":"status","required":true,"in":"query","schema":{"type":"string"}},{"name":"q","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Admin Sellers"],"security":[{"bearer":[]}]}},"/admin/sellers/{sellerId}/simple-ledger":{"get":{"operationId":"AdminSellersController_getSellerSimpleLedger","summary":"Seller simple ledger (same payload as seller portal) — Admin","parameters":[{"name":"sellerId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Admin Sellers"],"security":[{"bearer":[]}]}},"/admin/sellers/{sellerId}":{"get":{"operationId":"AdminSellersController_getOne","summary":"Get seller full details + stats (Admin)","parameters":[{"name":"sellerId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Admin Sellers"],"security":[{"bearer":[]}]}},"/admin/sellers/{sellerId}/pickup-addresses/{addressId}/verify":{"put":{"operationId":"AdminSellersController_verifyPickupAddress","summary":"Verify or unverify a seller pickup address (Admin)","parameters":[{"name":"sellerId","required":true,"in":"path","schema":{"type":"string"}},{"name":"addressId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyPickupAddressDto"}}}},"responses":{"200":{"description":""}},"tags":["Admin Sellers"],"security":[{"bearer":[]}]}},"/admin/sellers/pickup-addresses/sync-delhivery":{"put":{"operationId":"AdminSellersController_bulkSyncPickupAddresses","summary":"Bulk sync seller pickup addresses to Delhivery and auto-verify","parameters":[{"name":"limit","required":true,"in":"query","schema":{"type":"number"}},{"name":"onlyUnverified","required":true,"in":"query","schema":{"type":"string"}},{"name":"includeInactiveSellers","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Admin Sellers"],"security":[{"bearer":[]}]}},"/admin/sellers/{userId}/approve":{"put":{"operationId":"AdminSellersController_approve","summary":"Approve seller (set active)","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Admin Sellers"],"security":[{"bearer":[]}]}},"/admin/sellers/{userId}/block":{"put":{"operationId":"AdminSellersController_block","summary":"Block seller (read-only, cannot sell)","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminSellerActionDto"}}}},"responses":{"200":{"description":""}},"tags":["Admin Sellers"],"security":[{"bearer":[]}]}},"/admin/sellers/{userId}/unblock":{"put":{"operationId":"AdminSellersController_unblock","summary":"Unblock seller (set active)","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Admin Sellers"],"security":[{"bearer":[]}]}},"/admin/sellers/{userId}/suspend":{"put":{"operationId":"AdminSellersController_suspend","summary":"Suspend seller (immediate closure)","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminSellerActionDto"}}}},"responses":{"200":{"description":""}},"tags":["Admin Sellers"],"security":[{"bearer":[]}]}},"/admin/sellers/{userId}/soft-delete":{"put":{"operationId":"AdminSellersController_softDelete","summary":"Soft delete seller (disable seller and deactivate products)","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminSellerActionDto"}}}},"responses":{"200":{"description":""}},"tags":["Admin Sellers"],"security":[{"bearer":[]}]}},"/admin/sellers/{userId}/hard-delete":{"delete":{"operationId":"AdminSellersController_hardDelete","summary":"Hard delete seller (remove seller, products, media, seller-scoped finance/ops data, and orders that only had line items for this seller)","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminSellerActionDto"}}}},"responses":{"200":{"description":""}},"tags":["Admin Sellers"],"security":[{"bearer":[]}]}},"/seller/subscription/plans":{"get":{"operationId":"SellerSubscriptionController_getPlans","summary":"Get subscription plans and current status","parameters":[],"responses":{"200":{"description":""}},"tags":["Seller Subscription"],"security":[{"bearer":[]}]}},"/seller/subscription/validate-coupon":{"post":{"operationId":"SellerSubscriptionController_validateCoupon","summary":"Validate coupon and get discounted price","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidateSubscriptionCouponDto"}}}},"responses":{"201":{"description":""}},"tags":["Seller Subscription"],"security":[{"bearer":[]}]}},"/seller/subscription/create-payment":{"post":{"operationId":"SellerSubscriptionController_createPayment","summary":"Create payment session for subscription (Razorpay / Cashfree / PayU per admin settings)","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateSubscriptionPaymentDto"}}}},"responses":{"201":{"description":""}},"tags":["Seller Subscription"],"security":[{"bearer":[]}]}},"/seller/subscription/verify-payment":{"post":{"operationId":"SellerSubscriptionController_verifyPayment","summary":"Verify payment and activate subscription","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifySubscriptionPaymentDto"}}}},"responses":{"201":{"description":""}},"tags":["Seller Subscription"],"security":[{"bearer":[]}]}},"/seller/subscription/cancel":{"post":{"operationId":"SellerSubscriptionController_cancel","summary":"Cancel active Pro/Elite subscription (switch to Standard immediately)","parameters":[],"responses":{"201":{"description":""}},"tags":["Seller Subscription"],"security":[{"bearer":[]}]}},"/seller/subscription/{subscriptionPaymentId}/payu/checkout-pro-hash":{"post":{"operationId":"SellerSubscriptionController_payuCheckoutProHash","summary":"PayU Checkout Pro (seller mobile app) dynamic hash — hosted web checkout unchanged","parameters":[{"name":"subscriptionPaymentId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PayuCheckoutProHashDto"}}}},"responses":{"201":{"description":""}},"tags":["Seller Subscription"],"security":[{"bearer":[]}]}},"/returns/request":{"post":{"operationId":"ReturnsController_requestReturn","summary":"Request return (Customer)","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RequestReturnDto"}}}},"responses":{"201":{"description":""}},"tags":["Returns"],"security":[{"bearer":[]}]}},"/returns/order/{orderId}":{"get":{"operationId":"ReturnsController_getReturnsForOrder","summary":"Get returns for order","parameters":[{"name":"orderId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Returns"],"security":[{"bearer":[]}]}},"/returns/me":{"get":{"operationId":"ReturnsController_listMyReturns","summary":"List my return requests (customer)","parameters":[],"responses":{"200":{"description":""}},"tags":["Returns"],"security":[{"bearer":[]}]}},"/returns/{returnId}":{"get":{"operationId":"ReturnsController_getReturn","summary":"Get return by ID","parameters":[{"name":"returnId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Returns"],"security":[{"bearer":[]}]}},"/returns":{"get":{"operationId":"ReturnsController_getAllReturns","summary":"List returns (Admin)","parameters":[{"name":"status","required":true,"in":"query","schema":{"type":"string"}},{"name":"page","required":true,"in":"query","schema":{"type":"number"}},{"name":"limit","required":true,"in":"query","schema":{"type":"number"}}],"responses":{"200":{"description":""}},"tags":["Returns"],"security":[{"bearer":[]}]}},"/returns/{returnId}/seller-approve":{"post":{"operationId":"ReturnsController_sellerApprove","summary":"Seller approve or reject return","parameters":[{"name":"returnId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SellerApproveReturnDto"}}}},"responses":{"201":{"description":""}},"tags":["Returns"],"security":[{"bearer":[]}]}},"/returns/{returnId}/mark-delivered":{"post":{"operationId":"ReturnsController_markDelivered","summary":"Mark return as delivered to seller (Admin)","parameters":[{"name":"returnId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"201":{"description":""}},"tags":["Returns"],"security":[{"bearer":[]}]}},"/webhooks/delhivery/tracking":{"post":{"operationId":"WebhooksController_delhiveryTracking","summary":"Delhivery tracking webhook","parameters":[],"responses":{"200":{"description":""}},"tags":["Webhooks"]}},"/webhooks/payu/payment":{"post":{"operationId":"WebhooksController_payUPayment","summary":"PayU payment webhook","parameters":[],"responses":{"201":{"description":""}},"tags":["Webhooks"]}},"/webhook/delhivery/tracking":{"post":{"operationId":"WebhookDelhiveryAliasController_delhiveryTracking","summary":"Delhivery tracking webhook (alias of /api/webhooks/delhivery/tracking)","parameters":[],"responses":{"200":{"description":""}},"tags":["Webhooks"]}},"/home":{"get":{"operationId":"HomeController_getHome","summary":"Get landing page data (aggregated)","parameters":[{"name":"productsLimit","required":true,"in":"query","schema":{"type":"string"}},{"name":"sellersLimit","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Home"]}},"/mobile/bootstrap":{"get":{"operationId":"MobileController_getBootstrap","summary":"Mobile bootstrap payload (home + counts + app updates)","parameters":[{"name":"productsLimit","required":true,"in":"query","schema":{"type":"string"}},{"name":"sellersLimit","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Mobile"]}},"/seller/instagram/status":{"get":{"operationId":"SellerInstagramController_status","summary":"Instagram connection + automation summary","parameters":[],"responses":{"200":{"description":""}},"tags":["Seller Instagram"],"security":[{"bearer":[]}]}},"/seller/instagram/oauth/start":{"post":{"operationId":"SellerInstagramController_oauthStart","summary":"Start Meta OAuth: open returned authUrl in the browser","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InstagramOAuthStartDto"}}}},"responses":{"201":{"description":""}},"tags":["Seller Instagram"],"security":[{"bearer":[]}]}},"/seller/instagram/disconnect":{"post":{"operationId":"SellerInstagramController_disconnect","summary":"Disconnect Instagram (tokens cleared)","parameters":[],"responses":{"201":{"description":""}},"tags":["Seller Instagram"],"security":[{"bearer":[]}]}},"/seller/instagram/media":{"get":{"operationId":"SellerInstagramController_listMedia","summary":"List recent Instagram posts/reels (media IDs) for the connected account","description":"Uses Meta Graph API. Paginate with `after` from the previous response `paging.nextAfter`. Stories are not included on this edge.","parameters":[{"name":"limit","required":true,"in":"query","schema":{"type":"string"}},{"name":"after","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Seller Instagram"],"security":[{"bearer":[]}]}},"/seller/instagram/facebook-posts":{"get":{"operationId":"SellerInstagramController_listFacebookPosts","summary":"List recent posts published by the connected Facebook Page (post IDs for comment scoping)","description":"Uses `GET /{page-id}/published_posts`. IDs align with webhook `post_id` for Page feed comments. Paginate with `after` from `paging.nextAfter`.","parameters":[{"name":"limit","required":true,"in":"query","schema":{"type":"string"}},{"name":"after","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Seller Instagram"],"security":[{"bearer":[]}]}},"/seller/instagram/activity":{"get":{"operationId":"SellerInstagramController_listActivity","summary":"Recent auto-reply activity (post, product, link, message, keyword)","parameters":[{"name":"limit","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Seller Instagram"],"security":[{"bearer":[]}]}},"/seller/instagram/rules":{"get":{"operationId":"SellerInstagramController_listRules","summary":"List keyword automation rules","parameters":[],"responses":{"200":{"description":""}},"tags":["Seller Instagram"],"security":[{"bearer":[]}]},"post":{"operationId":"SellerInstagramController_createRule","summary":"Create keyword rule (comment contains keyword → private reply)","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateInstagramAutomationRuleDto"}}}},"responses":{"201":{"description":""}},"tags":["Seller Instagram"],"security":[{"bearer":[]}]}},"/seller/instagram/rules/{ruleId}":{"patch":{"operationId":"SellerInstagramController_updateRule","summary":"Update automation rule","parameters":[{"name":"ruleId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateInstagramAutomationRuleDto"}}}},"responses":{"200":{"description":""}},"tags":["Seller Instagram"],"security":[{"bearer":[]}]},"delete":{"operationId":"SellerInstagramController_deleteRule","summary":"Delete automation rule","parameters":[{"name":"ruleId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Seller Instagram"],"security":[{"bearer":[]}]}},"/seller/integrations/meta/status":{"get":{"operationId":"SellerMetaAdsController_status","summary":"Meta Ads connection health for the authenticated shop","parameters":[],"responses":{"200":{"description":""}},"tags":["Seller Meta Ads"],"security":[{"bearer":[]}]}},"/seller/integrations/meta/oauth/start":{"post":{"operationId":"SellerMetaAdsController_oauthStart","summary":"Start Meta Login for Business (server-side). Open authUrl in the browser.","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MetaAdsOAuthStartDto"}}}},"responses":{"201":{"description":""}},"tags":["Seller Meta Ads"],"security":[{"bearer":[]}]}},"/seller/integrations/meta/assets":{"get":{"operationId":"SellerMetaAdsController_assetsList","summary":"Discover Businesses, Ad Accounts, and Pixels/Datasets for this shop","parameters":[],"responses":{"200":{"description":""}},"tags":["Seller Meta Ads"],"security":[{"bearer":[]}]},"post":{"operationId":"SellerMetaAdsController_selectAssets","summary":"Save selected Meta Business / Ad Account / Pixel for this shop","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SelectMetaAssetsDto"}}}},"responses":{"201":{"description":""}},"tags":["Seller Meta Ads"],"security":[{"bearer":[]}]}},"/seller/integrations/meta/disconnect":{"post":{"operationId":"SellerMetaAdsController_disconnect","summary":"Disconnect Meta for this shop. Historical analytics are retained.","parameters":[],"responses":{"201":{"description":""}},"tags":["Seller Meta Ads"],"security":[{"bearer":[]}]}},"/seller/integrations/meta/sync":{"post":{"operationId":"SellerMetaAdsController_syncNow","summary":"Manually refresh Meta insights for this shop (rate limited)","parameters":[],"responses":{"201":{"description":""}},"tags":["Seller Meta Ads"],"security":[{"bearer":[]}]}},"/seller/integrations/meta/analytics":{"get":{"operationId":"SellerMetaAdsController_analytics","summary":"Normalized marketing analytics for this shop (Meta + Indi Andaz)","parameters":[{"name":"period","required":false,"in":"query","schema":{"enum":["today","yesterday","last_7","last_30","custom"],"type":"string"}},{"name":"startDate","required":false,"in":"query","description":"YYYY-MM-DD (IST)","schema":{"type":"string"}},{"name":"endDate","required":false,"in":"query","description":"YYYY-MM-DD (IST)","schema":{"type":"string"}},{"name":"search","required":false,"in":"query","schema":{"type":"string"}},{"name":"sortBy","required":false,"in":"query","schema":{"type":"string"}},{"name":"sortDir","required":false,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Seller Meta Ads"],"security":[{"bearer":[]}]}},"/recommendations":{"post":{"operationId":"RecommendationsController_getRecommendations","summary":"Personalized product recommendations for landing page","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecommendationsBodyDto"}}}},"responses":{"201":{"description":""}},"tags":["Recommendations"]}},"/recommendations/region":{"get":{"operationId":"RecommendationsController_detectRegion","summary":"Detect visitor region from IP (GDPR-safe default)","parameters":[],"responses":{"200":{"description":""}},"tags":["Recommendations"]}},"/recommendations/events":{"post":{"operationId":"RecommendationsController_logEvent","summary":"Log a single recommendation / behavior event","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LogRecommendationEventDto"}}}},"responses":{"201":{"description":""}},"tags":["Recommendations"]}},"/recommendations/events/batch":{"post":{"operationId":"RecommendationsController_logEventBatch","summary":"Log up to 10 recommendation events in one request (sendBeacon-friendly)","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchRecommendationEventsDto"}}}},"responses":{"201":{"description":""}},"tags":["Recommendations"]}},"/recommendations/stats":{"get":{"operationId":"RecommendationsController_getStats","summary":"Cache hit/miss stats and Redis health (admin only)","parameters":[],"responses":{"200":{"description":""}},"tags":["Recommendations"]}},"/hsn-sac":{"get":{"operationId":"HsnSacController_findAll","summary":"List HSN/SAC master records (Admin)","parameters":[{"name":"page","required":true,"in":"query","schema":{"type":"string"}},{"name":"limit","required":true,"in":"query","schema":{"type":"string"}},{"name":"search","required":true,"in":"query","schema":{"type":"string"}},{"name":"type","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["HSN/SAC"],"security":[{"bearer":[]}]},"post":{"operationId":"HsnSacController_create","summary":"Create HSN/SAC record (Admin)","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateHsnSacDto"}}}},"responses":{"201":{"description":""}},"tags":["HSN/SAC"],"security":[{"bearer":[]}]}},"/hsn-sac/{id}":{"get":{"operationId":"HsnSacController_findOne","summary":"Get HSN/SAC record by ID (Admin)","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["HSN/SAC"],"security":[{"bearer":[]}]},"put":{"operationId":"HsnSacController_update","summary":"Update HSN/SAC record (Admin)","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateHsnSacDto"}}}},"responses":{"200":{"description":""}},"tags":["HSN/SAC"],"security":[{"bearer":[]}]},"delete":{"operationId":"HsnSacController_remove","summary":"Delete HSN/SAC record (Admin only)","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["HSN/SAC"],"security":[{"bearer":[]}]}},"/seller/tax-hsn/search":{"get":{"operationId":"SellerHsnController_search","summary":"Search HSN/SAC master (seller)","parameters":[{"name":"q","required":true,"in":"query","schema":{"type":"string"}},{"name":"type","required":true,"in":"query","schema":{"type":"string"}},{"name":"page","required":true,"in":"query","schema":{"type":"string"}},{"name":"limit","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Seller HSN"],"security":[{"bearer":[]}]}},"/seller/tax-hsn":{"get":{"operationId":"SellerHsnController_list","summary":"List saved HSN codes","parameters":[],"responses":{"200":{"description":""}},"tags":["Seller HSN"],"security":[{"bearer":[]}]},"post":{"operationId":"SellerHsnController_save","summary":"Save HSN code to seller library","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaveSellerHsnDto"}}}},"responses":{"201":{"description":""}},"tags":["Seller HSN"],"security":[{"bearer":[]}]}},"/seller/tax-hsn/{id}":{"get":{"operationId":"SellerHsnController_getOne","summary":"Get one saved HSN","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Seller HSN"],"security":[{"bearer":[]}]},"put":{"operationId":"SellerHsnController_update","summary":"Update saved HSN (code from master, default flag)","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateSellerHsnDto"}}}},"responses":{"200":{"description":""}},"tags":["Seller HSN"],"security":[{"bearer":[]}]},"delete":{"operationId":"SellerHsnController_remove","summary":"Remove saved HSN","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Seller HSN"],"security":[{"bearer":[]}]}},"/seller/tax-hsn/{id}/refresh":{"post":{"operationId":"SellerHsnController_refresh","summary":"Refresh GST rate and description from master","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"201":{"description":""}},"tags":["Seller HSN"],"security":[{"bearer":[]}]}},"/seller/tax-hsn/{id}/default":{"put":{"operationId":"SellerHsnController_setDefault","summary":"Set default HSN","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Seller HSN"],"security":[{"bearer":[]}]}},"/seller/pricing/preview":{"get":{"operationId":"SellerPricingController_preview","summary":"Live buyer price vs seller net payout preview","parameters":[{"name":"price","required":true,"in":"query","schema":{"type":"string"}},{"name":"gstRate","required":true,"in":"query","schema":{"type":"string"}},{"name":"freeDelivery","required":true,"in":"query","schema":{"type":"string"}},{"name":"deliveryCharge","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Seller Pricing"],"security":[{"bearer":[]}]}},"/seller/store/products":{"get":{"operationId":"StorePosController_listProducts","parameters":[{"name":"q","required":true,"in":"query","schema":{"type":"string"}},{"name":"updatedSince","required":true,"in":"query","schema":{"type":"string"}},{"name":"page","required":true,"in":"query","schema":{"type":"string"}},{"name":"limit","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Store POS"],"security":[{"bearer":[]}]},"post":{"operationId":"StorePosController_createProduct","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateStoreProductDto"}}}},"responses":{"201":{"description":""}},"tags":["Store POS"],"security":[{"bearer":[]}]}},"/seller/store/products/search":{"get":{"operationId":"StorePosController_searchProducts","summary":"Search store + online catalog for POS","parameters":[{"name":"q","required":true,"in":"query","schema":{"type":"string"}},{"name":"page","required":true,"in":"query","schema":{"type":"string"}},{"name":"storeLimit","required":true,"in":"query","schema":{"type":"string"}},{"name":"onlineLimit","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Store POS"],"security":[{"bearer":[]}]}},"/seller/store/products/by-barcode/{code}":{"get":{"operationId":"StorePosController_lookupBarcode","summary":"Lookup product by barcode or SKU (scanner)","parameters":[{"name":"code","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Store POS"],"security":[{"bearer":[]}]}},"/seller/store/products/{id}/stock":{"post":{"operationId":"StorePosController_adjustStock","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdjustStockDto"}}}},"responses":{"201":{"description":""}},"tags":["Store POS"],"security":[{"bearer":[]}]}},"/seller/store/products/{id}/barcode":{"post":{"operationId":"StorePosController_assignBarcode","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"201":{"description":""}},"tags":["Store POS"],"security":[{"bearer":[]}]}},"/seller/store/pos/settings":{"get":{"operationId":"StorePosController_getPosSettings","parameters":[],"responses":{"200":{"description":""}},"tags":["Store POS"],"security":[{"bearer":[]}]},"put":{"operationId":"StorePosController_updatePosSettings","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdatePosSettingsDto"}}}},"responses":{"200":{"description":""}},"tags":["Store POS"],"security":[{"bearer":[]}]}},"/seller/store/pos/dashboard":{"get":{"operationId":"StorePosController_posDashboard","parameters":[{"name":"period","required":true,"in":"query","schema":{"type":"string"}},{"name":"from","required":true,"in":"query","schema":{"type":"string"}},{"name":"to","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Store POS"],"security":[{"bearer":[]}]}},"/seller/store/products/import-all":{"post":{"operationId":"StorePosController_importAll","parameters":[],"responses":{"201":{"description":""}},"tags":["Store POS"],"security":[{"bearer":[]}]}},"/seller/store/products/from-online/{productId}":{"post":{"operationId":"StorePosController_importOne","parameters":[{"name":"productId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"201":{"description":""}},"tags":["Store POS"],"security":[{"bearer":[]}]}},"/seller/store/products/{id}":{"put":{"operationId":"StorePosController_updateProduct","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateStoreProductDto"}}}},"responses":{"200":{"description":""}},"tags":["Store POS"],"security":[{"bearer":[]}]}},"/seller/store/products/{id}/insights":{"get":{"operationId":"StorePosController_getProductInsights","summary":"Product stock, supplier breakdown, purchase & sales history","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Store POS"],"security":[{"bearer":[]}]}},"/seller/store/customers":{"get":{"operationId":"StorePosController_listCustomers","summary":"List store customers with purchase stats","parameters":[{"name":"q","required":true,"in":"query","schema":{"type":"string"}},{"name":"page","required":true,"in":"query","schema":{"type":"string"}},{"name":"limit","required":true,"in":"query","schema":{"type":"string"}},{"name":"hasCredit","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Store POS"],"security":[{"bearer":[]}]},"post":{"operationId":"StorePosController_createCustomer","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateStoreCustomerDto"}}}},"responses":{"201":{"description":""}},"tags":["Store POS"],"security":[{"bearer":[]}]}},"/seller/store/customers/{id}":{"get":{"operationId":"StorePosController_getCustomer","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Store POS"],"security":[{"bearer":[]}]},"put":{"operationId":"StorePosController_updateCustomer","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateStoreCustomerDto"}}}},"responses":{"200":{"description":""}},"tags":["Store POS"],"security":[{"bearer":[]}]}},"/seller/store/customers/{id}/khata":{"get":{"operationId":"StorePosController_getCustomerKhata","summary":"Customer udhar khata ledger","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Store POS"],"security":[{"bearer":[]}]}},"/seller/store/customers/{id}/khata/payment":{"post":{"operationId":"StorePosController_collectKhataPayment","summary":"Collect udhar payment from customer","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectKhataPaymentDto"}}}},"responses":{"201":{"description":""}},"tags":["Store POS"],"security":[{"bearer":[]}]}},"/seller/store/offers":{"get":{"operationId":"StorePosController_listOffers","parameters":[],"responses":{"200":{"description":""}},"tags":["Store POS"],"security":[{"bearer":[]}]},"post":{"operationId":"StorePosController_createOffer","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateStoreOfferDto"}}}},"responses":{"201":{"description":""}},"tags":["Store POS"],"security":[{"bearer":[]}]}},"/seller/store/offers/active":{"get":{"operationId":"StorePosController_activeOffers","summary":"Currently active festival / promotional offers","parameters":[],"responses":{"200":{"description":""}},"tags":["Store POS"],"security":[{"bearer":[]}]}},"/seller/store/offers/{id}":{"put":{"operationId":"StorePosController_updateOffer","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateStoreOfferDto"}}}},"responses":{"200":{"description":""}},"tags":["Store POS"],"security":[{"bearer":[]}]},"delete":{"operationId":"StorePosController_deleteOffer","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Store POS"],"security":[{"bearer":[]}]}},"/seller/store/bills":{"get":{"operationId":"StorePosController_listBills","parameters":[{"name":"from","required":true,"in":"query","schema":{"type":"string"}},{"name":"to","required":true,"in":"query","schema":{"type":"string"}},{"name":"status","required":true,"in":"query","schema":{"type":"string"}},{"name":"q","required":true,"in":"query","schema":{"type":"string"}},{"name":"page","required":true,"in":"query","schema":{"type":"string"}},{"name":"limit","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Store POS"],"security":[{"bearer":[]}]},"post":{"operationId":"StorePosController_createBill","parameters":[{"name":"idempotency-key","required":true,"in":"header","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateStoreBillDto"}}}},"responses":{"201":{"description":""}},"tags":["Store POS"],"security":[{"bearer":[]}]}},"/seller/store/bills/lookup":{"get":{"operationId":"StorePosController_lookupBill","summary":"Resolve bill from QR code, bill number, or share URL","parameters":[{"name":"code","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Store POS"],"security":[{"bearer":[]}]}},"/seller/store/bills/{id}":{"get":{"operationId":"StorePosController_getBill","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Store POS"],"security":[{"bearer":[]}]},"put":{"operationId":"StorePosController_updateBill","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateStoreBillDto"}}}},"responses":{"200":{"description":""}},"tags":["Store POS"],"security":[{"bearer":[]}]},"delete":{"operationId":"StorePosController_deleteBill","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Store POS"],"security":[{"bearer":[]}]}},"/seller/store/bills/{id}/pdf":{"get":{"operationId":"StorePosController_billPdf","summary":"Download store bill PDF (a4 | thermal80 | thermal58)","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"format","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Store POS"],"security":[{"bearer":[]}]}},"/seller/store/bills/{id}/confirm":{"post":{"operationId":"StorePosController_confirmBill","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"idempotency-key","required":true,"in":"header","schema":{"type":"string"}}],"responses":{"201":{"description":""}},"tags":["Store POS"],"security":[{"bearer":[]}]}},"/seller/store/bills/{id}/resend-whatsapp":{"post":{"operationId":"StorePosController_resendWhatsapp","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"201":{"description":""}},"tags":["Store POS"],"security":[{"bearer":[]}]}},"/seller/store/bills/{id}/share-link":{"get":{"operationId":"StorePosController_getBillShareLink","summary":"Public buyer-facing link for a confirmed bill","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Store POS"],"security":[{"bearer":[]}]}},"/seller/store/bills/{id}/send":{"post":{"operationId":"StorePosController_sendBill","summary":"Send a confirmed bill via WhatsApp, SMS or email","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SendBillDto"}}}},"responses":{"201":{"description":""}},"tags":["Store POS"],"security":[{"bearer":[]}]}},"/seller/store/returns":{"post":{"operationId":"StorePosController_createReturn","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateStoreReturnDto"}}}},"responses":{"201":{"description":""}},"tags":["Store POS"],"security":[{"bearer":[]}]}},"/seller/store/ledger":{"get":{"operationId":"StorePosController_ledger","summary":"Unified ledger (online + store)","parameters":[{"name":"source","required":true,"in":"query","schema":{"type":"string"}},{"name":"from","required":true,"in":"query","schema":{"type":"string"}},{"name":"to","required":true,"in":"query","schema":{"type":"string"}},{"name":"q","required":true,"in":"query","schema":{"type":"string"}},{"name":"page","required":true,"in":"query","schema":{"type":"string"}},{"name":"limit","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Store POS"],"security":[{"bearer":[]}]}},"/seller/store/suppliers":{"get":{"operationId":"StorePosController_listSuppliers","summary":"List store suppliers / vendors","parameters":[{"name":"q","required":true,"in":"query","schema":{"type":"string"}},{"name":"page","required":true,"in":"query","schema":{"type":"string"}},{"name":"limit","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Store POS"],"security":[{"bearer":[]}]},"post":{"operationId":"StorePosController_createSupplier","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateStoreSupplierDto"}}}},"responses":{"201":{"description":""}},"tags":["Store POS"],"security":[{"bearer":[]}]}},"/seller/store/suppliers/{id}":{"get":{"operationId":"StorePosController_getSupplier","summary":"Supplier detail with stock received & purchase history","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Store POS"],"security":[{"bearer":[]}]},"put":{"operationId":"StorePosController_updateSupplier","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateStoreSupplierDto"}}}},"responses":{"200":{"description":""}},"tags":["Store POS"],"security":[{"bearer":[]}]},"delete":{"operationId":"StorePosController_deleteSupplier","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Store POS"],"security":[{"bearer":[]}]}},"/seller/store/suppliers/{id}/stock":{"get":{"operationId":"StorePosController_getSupplierStock","summary":"Stock received from a supplier, product-wise","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Store POS"],"security":[{"bearer":[]}]}},"/seller/store/purchases":{"get":{"operationId":"StorePosController_listPurchases","summary":"List stock purchase / GRN entries","parameters":[{"name":"from","required":true,"in":"query","schema":{"type":"string"}},{"name":"to","required":true,"in":"query","schema":{"type":"string"}},{"name":"supplierId","required":true,"in":"query","schema":{"type":"string"}},{"name":"q","required":true,"in":"query","schema":{"type":"string"}},{"name":"page","required":true,"in":"query","schema":{"type":"string"}},{"name":"limit","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Store POS"],"security":[{"bearer":[]}]},"post":{"operationId":"StorePosController_createPurchase","summary":"Record inbound stock from a supplier","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateStorePurchaseDto"}}}},"responses":{"201":{"description":""}},"tags":["Store POS"],"security":[{"bearer":[]}]}},"/seller/store/purchases/{id}":{"get":{"operationId":"StorePosController_getPurchase","summary":"Stock purchase / GRN detail","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Store POS"],"security":[{"bearer":[]}]}},"/public/store-bills/{usernameOrId}/{billNumber}":{"get":{"operationId":"StoreBillPublicController_getPublicBill","summary":"Public bill view by seller username + bill number (requires ?t= share token)","parameters":[{"name":"usernameOrId","required":true,"in":"path","schema":{"type":"string"}},{"name":"billNumber","required":true,"in":"path","schema":{"type":"string"}},{"name":"t","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Store POS"]}},"/admin/store/bills":{"get":{"operationId":"StorePosAdminController_listBills","summary":"List store bills (read-only, all sellers)","parameters":[{"name":"sellerId","required":true,"in":"query","schema":{"type":"string"}},{"name":"page","required":true,"in":"query","schema":{"type":"string"}},{"name":"limit","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Admin Store"],"security":[{"bearer":[]}]}},"/admin/store/bills/{id}":{"get":{"operationId":"StorePosAdminController_getBill","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Admin Store"],"security":[{"bearer":[]}]}},"/orders/{orderId}/invoice":{"get":{"operationId":"OrderInvoicesController_buyerInvoice","summary":"Buyer tax invoice (no commission)","parameters":[{"name":"orderId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Order Invoices"],"security":[{"bearer":[]}]}},"/orders/{orderId}/invoice/pdf":{"get":{"operationId":"OrderInvoicesController_buyerInvoicePdf","summary":"Download buyer copy PDF","parameters":[{"name":"orderId","required":true,"in":"path","schema":{"type":"string"}},{"name":"format","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Order Invoices"],"security":[{"bearer":[]}]}},"/seller/orders/{orderId}/invoice/seller-copy":{"get":{"operationId":"OrderInvoicesController_sellerInvoice","summary":"Seller copy invoice with commission","parameters":[{"name":"orderId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Order Invoices"],"security":[{"bearer":[]}]}},"/seller/orders/{orderId}/invoice/seller-copy/pdf":{"get":{"operationId":"OrderInvoicesController_sellerInvoicePdf","parameters":[{"name":"orderId","required":true,"in":"path","schema":{"type":"string"}},{"name":"format","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Order Invoices"],"security":[{"bearer":[]}]}},"/admin/orders/{orderId}/invoice/seller-copy":{"get":{"operationId":"OrderInvoicesController_adminSellerInvoice","parameters":[{"name":"orderId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Order Invoices"],"security":[{"bearer":[]}]}},"/admin/spec/commission-history":{"get":{"operationId":"SpecAdminController_commissionHistory","summary":"Platform commission rate change log","parameters":[{"name":"page","required":true,"in":"query","schema":{"type":"string"}},{"name":"limit","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Admin Spec v3"],"security":[{"bearer":[]}]}},"/admin/spec/delhivery-webhooks":{"get":{"operationId":"SpecAdminController_webhookLogs","summary":"Delhivery webhook / scan event log","parameters":[{"name":"orderId","required":true,"in":"query","schema":{"type":"string"}},{"name":"page","required":true,"in":"query","schema":{"type":"string"}},{"name":"limit","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Admin Spec v3"],"security":[{"bearer":[]}]}},"/admin/spec/whatsapp-delivery":{"get":{"operationId":"SpecAdminController_whatsappStatus","summary":"Store bill WhatsApp delivery status","parameters":[{"name":"sellerId","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Admin Spec v3"],"security":[{"bearer":[]}]}},"/mcp":{"post":{"operationId":"McpController_handlePost","parameters":[],"responses":{"201":{"description":""}}},"get":{"operationId":"McpController_indicateAuth","parameters":[],"responses":{"401":{"description":""}}},"delete":{"operationId":"McpController_rejectDelete","parameters":[],"responses":{"405":{"description":""}}}},"/mcp/oauth/authorize":{"get":{"operationId":"McpOAuthController_authorize","parameters":[],"responses":{"200":{"description":""}}}},"/mcp/oauth/login/options":{"post":{"operationId":"McpOAuthController_loginOptions","parameters":[],"responses":{"200":{"description":""}}}},"/mcp/oauth/login/otp/send":{"post":{"operationId":"McpOAuthController_sendOtp","parameters":[],"responses":{"200":{"description":""}}}},"/mcp/oauth/login/otp":{"post":{"operationId":"McpOAuthController_loginOtp","parameters":[],"responses":{"200":{"description":""}}}},"/mcp/oauth/login/pin":{"post":{"operationId":"McpOAuthController_loginPin","parameters":[],"responses":{"200":{"description":""}}}},"/mcp/oauth/consent":{"post":{"operationId":"McpOAuthController_consent","parameters":[],"responses":{"200":{"description":""}}}},"/mcp/oauth/token":{"post":{"operationId":"McpOAuthController_token","parameters":[],"responses":{"200":{"description":""}}}},"/mcp/oauth/revoke":{"post":{"operationId":"McpOAuthController_revoke","parameters":[],"responses":{"200":{"description":""}}}},"/mcp/oauth/register":{"post":{"operationId":"McpOAuthController_register","parameters":[],"responses":{"201":{"description":""}}}},"/.well-known/oauth-protected-resource":{"get":{"operationId":"McpWellKnownController_protectedResource","parameters":[],"responses":{"200":{"description":""}}}},"/.well-known/oauth-protected-resource/api/mcp":{"get":{"operationId":"McpWellKnownController_protectedResource","parameters":[],"responses":{"200":{"description":""}}}},"/.well-known/oauth-protected-resource/mcp":{"get":{"operationId":"McpWellKnownController_protectedResource","parameters":[],"responses":{"200":{"description":""}}}},"/.well-known/oauth-authorization-server":{"get":{"operationId":"McpWellKnownController_authorizationServer","parameters":[],"responses":{"200":{"description":""}}}},"/.well-known/oauth-authorization-server/api/mcp":{"get":{"operationId":"McpWellKnownController_authorizationServer","parameters":[],"responses":{"200":{"description":""}}}},"/.well-known/oauth-authorization-server/mcp":{"get":{"operationId":"McpWellKnownController_authorizationServer","parameters":[],"responses":{"200":{"description":""}}}},"/seller/mcp/connections":{"get":{"operationId":"McpConnectionsController_list","summary":"List AI connections for the authenticated seller","parameters":[],"responses":{"200":{"description":""}},"tags":["Seller MCP"],"security":[{"bearer":[]}]}},"/seller/mcp/connections/{id}":{"delete":{"operationId":"McpConnectionsController_revoke","summary":"Revoke an AI connection. Access tokens stop working immediately.","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Seller MCP"],"security":[{"bearer":[]}]}},"/openapi.json":{"get":{"operationId":"OpenApiController_serve","summary":"OpenAPI 3 document generated from live NestJS controllers and DTOs","parameters":[],"responses":{"200":{"description":""}},"tags":["OpenAPI"]}}},"info":{"title":"Indi Andaz API","description":"HTTP API for Indi Andaz — consumer marketplace, Seller Portal, Partner App, Counter App, and related clients.\n\nCanonical production base: https://prilix.indiandaz.com/api\n\nSeller marketing site (not this API): https://seller.indiandaz.com\n\nPublic documentation: https://seller.indiandaz.com/developers\n\nAuthenticated routes use HTTP Bearer JWT from /auth/* login endpoints.\n\nDo not send passwords, OTP codes, or tokens in issue reports.","version":"1.0","contact":{"name":"Indi Andaz","url":"https://seller.indiandaz.com","email":"grievance@indiandaz.com"}},"tags":[],"servers":[{"url":"https://prilix.indiandaz.com/api","description":"Production"},{"url":"http://localhost:3000/api","description":"Local development"}],"components":{"securitySchemes":{"bearer":{"scheme":"bearer","bearerFormat":"JWT","type":"http","description":"Access token from seller, customer, or admin authentication."}},"schemas":{"SendOtpDto":{"type":"object","properties":{"mobile":{"type":"string","example":"7029654065"}},"required":["mobile"]},"VerifyOtpDto":{"type":"object","properties":{"mobile":{"type":"string","example":"7029654065"},"code":{"type":"string","example":"123456"},"referralCode":{"type":"string","example":"REFABC123","description":"Referral code (seller signup only)"}},"required":["mobile","code"]},"SellerLoginPinDto":{"type":"object","properties":{"mobile":{"type":"string","example":"9876543210"},"pin":{"type":"string","example":"1234"}},"required":["mobile","pin"]},"SellerLoginOptionsDto":{"type":"object","properties":{"mobile":{"type":"string","example":"9876543210"}},"required":["mobile"]},"SellerPortalGrantExchangeDto":{"type":"object","properties":{"token":{"type":"string","example":"b193a2c61a744fb3f6fc5c2c31176175c2ed4c4b2b08b3d0d2a9be48ba0b6019"}},"required":["token"]},"RefreshTokenDto":{"type":"object","properties":{"refreshToken":{"type":"string"}},"required":["refreshToken"]},"AdminLoginDto":{"type":"object","properties":{"email":{"type":"string","example":"admin@example.com"},"password":{"type":"string","example":"password123"}},"required":["email","password"]},"TestNotificationDto":{"type":"object","properties":{"token":{"type":"string"}},"required":["token"]},"DeviceClientMetaDto":{"type":"object","properties":{"appVersion":{"type":"string","example":"1.0.0"},"buildNumber":{"type":"string","example":"42"},"packageName":{"type":"string","example":"com.example.app"},"osVersion":{"type":"string"},"locale":{"type":"string","example":"en_IN"},"timeZoneOffsetMinutes":{"type":"number","description":"Minutes east of UTC (e.g. 330 for IST)"},"timeZoneName":{"type":"string","example":"IST"}}},"RegisterDeviceDto":{"type":"object","properties":{"token":{"type":"string"},"installationId":{"type":"string"},"app":{"type":"string","enum":["customer","seller"]},"platform":{"type":"string","enum":["web","android","ios"]},"clientMeta":{"$ref":"#/components/schemas/DeviceClientMetaDto"}},"required":["token","installationId","app"]},"RegisterTokenDto":{"type":"object","properties":{"token":{"type":"string"},"platform":{"type":"string","enum":["web","android","ios"]},"installationId":{"type":"string","description":"Stable per-device id; links pre-login token rows to the user on login"},"clientMeta":{"$ref":"#/components/schemas/DeviceClientMetaDto"}},"required":["token"]},"CreateSmsDltTemplateDto":{"type":"object","properties":{"code":{"type":"string","example":"admin-direct-user"},"event":{"type":"string","example":"admin.user_direct"},"label":{"type":"string"},"party":{"type":"string","enum":["user","seller","both"]},"category":{"type":"string","enum":["transactional","otp","marketing","admin"]},"senderId":{"type":"string"},"bodyTemplate":{"type":"string","description":"Exact DLT body with {1} placeholders"},"variableKeys":{"type":"array","items":{"type":"string"}},"dltContentId":{"type":"string"},"notes":{"type":"string"}},"required":["code","label","party","category","bodyTemplate"]},"UpdateSmsDltTemplateDto":{"type":"object","properties":{"event":{"type":"string"},"label":{"type":"string"},"party":{"type":"string","enum":["user","seller","both"]},"category":{"type":"string","enum":["transactional","otp","marketing","admin"]},"senderId":{"type":"string"},"bodyTemplate":{"type":"string"},"variableKeys":{"type":"array","items":{"type":"string"}},"dltContentId":{"type":"string"},"notes":{"type":"string"}}},"VerifySmsDltTemplateDto":{"type":"object","properties":{"dltContentId":{"type":"string","description":"Optional DLT portal content ID"},"notes":{"type":"string"}}},"RejectSmsDltTemplateDto":{"type":"object","properties":{"notes":{"type":"string"}}},"AdminSendNotificationDto":{"type":"object","properties":{"party":{"type":"string","enum":["user","seller"]},"recipientId":{"type":"string","description":"MongoDB user/seller id"},"contact":{"type":"object","description":"Override phone/email when recipient is guest or contact form"},"channels":{"type":"array","items":{"type":"string","enum":["push","email","whatsapp","sms"]}},"mode":{"type":"string","enum":["custom","template"]},"title":{"type":"string","maxLength":120},"message":{"type":"string","maxLength":500},"routeDestination":{"type":"string","description":"Predefined route destination id (see GET /admin/notifications/routes)"},"link":{"type":"string"},"imageUrl":{"type":"string","description":"Image URL for push notifications (FCM rich image)"},"templateEvent":{"type":"string","enum":["seller.new_order","seller.order_cancelled","seller.payment_received","seller.low_stock","seller.payout_processed","seller.return_requested","seller.return_received","seller.account_suspended","seller.account_blocked","seller.cod_remittance","seller.support_ticket_created","seller.support_ticket_reply","seller.support_ticket_escalated","seller.support_ticket_resolved","seller.support_ticket_closed","user.order_placed","user.payment_success","user.payment_failed","user.order_shipped","user.out_for_delivery","user.order_delivered","user.order_cancelled","user.refund_initiated","user.refund_credited","user.return_approved_pickup","user.return_rejected","user.return_pickup_scheduled","user.return_in_transit","user.return_received_by_seller","user.return_refund_complete","user.marketing_sale","user.marketing_cart","user.marketing_offer","user.marketing_new_arrivals","user.marketing_back_in_stock","user.welcome","user.store_bill","seller.welcome","user.otp","seller.otp","admin.user_direct","admin.seller_direct","admin.seller_signup_alert"]},"variables":{"type":"object"},"source":{"type":"string","description":"Stored in notification logs for audit"},"smsTemplateCode":{"type":"string","description":"SMS DLT template code (required when sms channel is selected). Must be approved in the registry."},"whatsappTemplateEvent":{"type":"string","description":"WhatsApp template event / file stem (required when whatsapp channel is selected and mode is custom, or to override)."}},"required":["party","channels","mode"]},"AdminBroadcastNotificationDto":{"type":"object","properties":{"party":{"type":"string","enum":["user","seller"]},"recipientId":{"type":"string","description":"MongoDB user/seller id"},"contact":{"type":"object","description":"Override phone/email when recipient is guest or contact form"},"channels":{"type":"array","items":{"type":"string","enum":["push","email","whatsapp","sms"]}},"mode":{"type":"string","enum":["custom","template"]},"title":{"type":"string","maxLength":120},"message":{"type":"string","maxLength":500},"routeDestination":{"type":"string","description":"Predefined route destination id (see GET /admin/notifications/routes)"},"link":{"type":"string"},"imageUrl":{"type":"string","description":"Image URL for push notifications (FCM rich image)"},"templateEvent":{"type":"string","enum":["seller.new_order","seller.order_cancelled","seller.payment_received","seller.low_stock","seller.payout_processed","seller.return_requested","seller.return_received","seller.account_suspended","seller.account_blocked","seller.cod_remittance","seller.support_ticket_created","seller.support_ticket_reply","seller.support_ticket_escalated","seller.support_ticket_resolved","seller.support_ticket_closed","user.order_placed","user.payment_success","user.payment_failed","user.order_shipped","user.out_for_delivery","user.order_delivered","user.order_cancelled","user.refund_initiated","user.refund_credited","user.return_approved_pickup","user.return_rejected","user.return_pickup_scheduled","user.return_in_transit","user.return_received_by_seller","user.return_refund_complete","user.marketing_sale","user.marketing_cart","user.marketing_offer","user.marketing_new_arrivals","user.marketing_back_in_stock","user.welcome","user.store_bill","seller.welcome","user.otp","seller.otp","admin.user_direct","admin.seller_direct","admin.seller_signup_alert"]},"variables":{"type":"object"},"source":{"type":"string","description":"Stored in notification logs for audit"},"smsTemplateCode":{"type":"string","description":"SMS DLT template code (required when sms channel is selected). Must be approved in the registry."},"whatsappTemplateEvent":{"type":"string","description":"WhatsApp template event / file stem (required when whatsapp channel is selected and mode is custom, or to override)."},"recipientIds":{"type":"array","items":{"type":"string"}}},"required":["party","channels","mode","recipientIds"]},"SocialMediaDto":{"type":"object","properties":{"facebook":{"type":"string"},"instagram":{"type":"string"},"twitter":{"type":"string"},"youtube":{"type":"string"},"linkedin":{"type":"string"},"pinterest":{"type":"string"},"tiktok":{"type":"string"}}},"LandingFestiveDto":{"type":"object","properties":{"enabled":{"type":"boolean"},"title":{"type":"string"},"subtitle":{"type":"string"},"image":{"type":"string"},"link":{"type":"string"},"badgeText":{"type":"string"},"startsAt":{"type":"string"},"endsAt":{"type":"string"},"productIds":{"type":"array","items":{"type":"string"}}}},"LandingSalesDto":{"type":"object","properties":{"enabled":{"type":"boolean"},"title":{"type":"string"},"subtitle":{"type":"string"},"image":{"type":"string"},"link":{"type":"string"},"limit":{"type":"number"},"sortBy":{"type":"string","enum":["price_low","price_high","popularity","newest"]},"productIds":{"type":"array","items":{"type":"string"}}}},"LandingUnder500Dto":{"type":"object","properties":{"enabled":{"type":"boolean"},"title":{"type":"string"},"subtitle":{"type":"string"},"image":{"type":"string"},"maxPrice":{"type":"number"},"limit":{"type":"number"},"sortBy":{"type":"string","enum":["price_low","price_high","popularity","newest"]},"productIds":{"type":"array","items":{"type":"string"}}}},"LandingSectionsDto":{"type":"object","properties":{"festive":{"$ref":"#/components/schemas/LandingFestiveDto"},"sales":{"$ref":"#/components/schemas/LandingSalesDto"},"under500":{"$ref":"#/components/schemas/LandingUnder500Dto"}}},"PlatformWarehouseDto":{"type":"object","properties":{"name":{"type":"string"},"address":{"type":"string"},"pincode":{"type":"string"},"city":{"type":"string"},"state":{"type":"string"},"contactName":{"type":"string"},"contactPhone":{"type":"string"}}},"PaymentGatewayContextDto":{"type":"object","properties":{"active":{"type":"string","enum":["razorpay","cashfree","payu"]},"fallbackGateway":{"type":"string","enum":["razorpay","cashfree","payu"]},"autoFallbackEnabled":{"type":"boolean"},"razorpayEnabled":{"type":"boolean"},"cashfreeEnabled":{"type":"boolean"},"payuEnabled":{"type":"boolean"}}},"PaymentGatewaySellerPayoutDto":{"type":"object","properties":{"primaryProvider":{"type":"string","enum":["manual","razorpay","cashfree","payu"]},"razorpayEnabled":{"type":"boolean"},"cashfreeEnabled":{"type":"boolean"},"payuEnabled":{"type":"boolean"}}},"PaymentGatewayDto":{"type":"object","properties":{"active":{"type":"string","enum":["razorpay","cashfree","payu"]},"fallbackGateway":{"type":"string","enum":["razorpay","cashfree","payu"]},"manualOverride":{"type":"boolean"},"autoFallbackEnabled":{"type":"boolean"},"razorpayEnabled":{"type":"boolean"},"cashfreeEnabled":{"type":"boolean"},"payuEnabled":{"type":"boolean"},"payIn":{"$ref":"#/components/schemas/PaymentGatewayContextDto"},"sellerSubscription":{"$ref":"#/components/schemas/PaymentGatewayContextDto"},"sellerPayout":{"$ref":"#/components/schemas/PaymentGatewaySellerPayoutDto"}}},"SettlementDto":{"type":"object","properties":{"minPayoutAmount":{"type":"number"},"codBufferDays":{"type":"number"},"returnWindowBufferDays":{"type":"number"},"autoPayoutEnabled":{"type":"boolean"}}},"TaxationDto":{"type":"object","properties":{"settlementBasisVersion":{"type":"string"},"defaultCommissionGstRate":{"type":"number"},"defaultProductGstRate":{"type":"number"},"defaultTaxInclusive":{"type":"boolean"},"roundingMode":{"type":"string","enum":["round","floor","ceil"]},"roundingPrecision":{"type":"number"},"tcsEnabled":{"type":"boolean"},"tcsRate":{"type":"number"},"tcsComputationMode":{"type":"string","enum":["net_taxable","gross_taxable"]},"tcsEffectiveDate":{"type":"string"}}},"FinanceSettingsDto":{"type":"object","properties":{"invoicePrefix":{"type":"string"},"creditNotePrefix":{"type":"string"},"settlementPrefix":{"type":"string"},"allowEarlySettlement":{"type":"boolean"},"strictPayoutEligibility":{"type":"boolean"}}},"MobileAppPolicyDto":{"type":"object","properties":{"minimumVersion":{"type":"string"},"latestVersion":{"type":"string"},"softUpdatesEnabled":{"type":"boolean"},"message":{"type":"string"},"forceMessage":{"type":"string"},"iosStoreUrl":{"type":"string"},"androidStoreUrl":{"type":"string"}}},"MobileAppUpdatesDto":{"type":"object","properties":{"customer":{"$ref":"#/components/schemas/MobileAppPolicyDto"},"seller":{"$ref":"#/components/schemas/MobileAppPolicyDto"},"sellerPos":{"$ref":"#/components/schemas/MobileAppPolicyDto"}}},"WhatsappMessageIdDto":{"type":"object","properties":{"name":{"type":"string"},"messageId":{"type":"string"}}},"WhatsappSettingsDto":{"type":"object","properties":{"phoneNumberId":{"type":"string"},"brandImageUrl":{"type":"string"},"sellerBrandImageUrl":{"type":"string"},"adminSellerSignupAlertWhatsapp":{"type":"string"},"defaultMessageId":{"type":"string"},"templateMessageIds":{"type":"object"},"messageIds":{"type":"array","items":{"$ref":"#/components/schemas/WhatsappMessageIdDto"}}}},"SellerIntegrationsDto":{"type":"object","properties":{"instagramEnabled":{"type":"boolean"}}},"SellerPosPurchaseFromUsProductDto":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"},"imageUrl":{"type":"string"},"buyUrl":{"type":"string"},"priceLabel":{"type":"string"}}},"SellerPosPurchaseFromUsDto":{"type":"object","properties":{"enabled":{"type":"boolean"},"title":{"type":"string"},"subtitle":{"type":"string"},"products":{"type":"array","items":{"$ref":"#/components/schemas/SellerPosPurchaseFromUsProductDto"}}}},"LegalDto":{"type":"object","properties":{"brandName":{"type":"string"},"legalEntity":{"type":"string"},"entityType":{"type":"string"},"ownerName":{"type":"string"},"grievanceOfficerName":{"type":"string"},"grievanceEmail":{"type":"string"},"msmeNote":{"type":"string"},"grievanceResponseDays":{"type":"number"},"lastUpdated":{"type":"string"},"jurisdiction":{"type":"string"},"paymentProcessor":{"type":"string"},"paymentProcessorPrivacyUrl":{"type":"string"},"paymentProcessorTermsUrl":{"type":"string"},"deliveryPartner":{"type":"string"},"metaDataPolicyUrl":{"type":"string"},"platformCommissionPercent":{"type":"number"},"sellerPayoutCycle":{"type":"string"},"sellerDispatchSlaDays":{"type":"number"},"shippingChargesDescription":{"type":"string"},"codAvailable":{"type":"boolean"},"freeShippingThresholdNote":{"type":"string"},"codPolicyDescription":{"type":"string"},"buyerSiteUrl":{"type":"string"}}},"UpdateSettingsDto":{"type":"object","properties":{"siteEmail":{"type":"string"},"phoneNumber":{"type":"string"},"contactLocation":{"type":"string"},"businessAddress":{"type":"string"},"workingAddress":{"type":"string"},"gstin":{"type":"string"},"gstinNote":{"type":"string"},"poweredBy":{"type":"string"},"socialMedia":{"$ref":"#/components/schemas/SocialMediaDto"},"landingSections":{"$ref":"#/components/schemas/LandingSectionsDto"},"platformWarehouse":{"$ref":"#/components/schemas/PlatformWarehouseDto"},"paymentGateway":{"$ref":"#/components/schemas/PaymentGatewayDto"},"settlement":{"$ref":"#/components/schemas/SettlementDto"},"taxation":{"$ref":"#/components/schemas/TaxationDto"},"finance":{"$ref":"#/components/schemas/FinanceSettingsDto"},"mobileAppUpdates":{"$ref":"#/components/schemas/MobileAppUpdatesDto"},"whatsapp":{"$ref":"#/components/schemas/WhatsappSettingsDto"},"sellerIntegrations":{"$ref":"#/components/schemas/SellerIntegrationsDto"},"sellerPosPurchaseFromUs":{"$ref":"#/components/schemas/SellerPosPurchaseFromUsDto"},"legal":{"$ref":"#/components/schemas/LegalDto"}}},"UpdatePlatformMonetizationDto":{"type":"object","properties":{"defaultCommissionType":{"type":"string","enum":["percentage","flat","subscription"]},"defaultCommissionPercentage":{"type":"number"},"defaultCommissionFlatFee":{"type":"number"},"subscriptionEnabled":{"type":"boolean"},"defaultSubscriptionMonthlyPrice":{"type":"number"},"defaultSubscriptionYearlyPrice":{"type":"number"},"standardPlatformFeePercentage":{"type":"number"},"proPlatformFeePercentage":{"type":"number"},"elitePlatformFeePercentage":{"type":"number"},"proMonthlyPrice":{"type":"number"},"proYearlyPrice":{"type":"number"},"eliteMonthlyPrice":{"type":"number"},"eliteYearlyPrice":{"type":"number"},"subscriptionAnnualDiscountPercent":{"type":"number"},"subscriptionPerProductCommission":{"type":"number"},"defaultTrialDays":{"type":"number"},"referralRewardAmount":{"type":"number"},"referralLimitPerSeller":{"type":"number"},"subscriptionTierFeatures":{"type":"object","description":"tier -> feature bullet list"}}},"UpdateSellerCommissionDto":{"type":"object","properties":{"type":{"type":"string","enum":["percentage","flat","subscription"]},"percentage":{"type":"number"},"flatFee":{"type":"number"}}},"UpdateSellerTrialDto":{"type":"object","properties":{"trialDays":{"type":"number"},"trialEndAt":{"type":"string"},"trialDisabled":{"type":"boolean"}}},"AssignSellerSubscriptionDto":{"type":"object","properties":{"planId":{"type":"string"},"endsAt":{"type":"string"},"specialOfferNote":{"type":"string"},"setCommissionType":{"type":"boolean"},"sellerPlatformFeeProfile":{"type":"string","enum":["standard","pro","elite"]}}},"CreateSubscriptionCouponDto":{"type":"object","properties":{"code":{"type":"string"},"type":{"type":"string","enum":["flat","percentage"]},"flatAmount":{"type":"number"},"percentage":{"type":"number"},"freeMonths":{"type":"number"},"validityStart":{"type":"string"},"validityEnd":{"type":"string"},"usageLimit":{"type":"number"},"applicablePlanIds":{"type":"array","items":{"type":"string"}},"sellerId":{"type":"string"},"isActive":{"type":"boolean"}},"required":["code"]},"UpdateSubscriptionCouponDto":{"type":"object","properties":{"code":{"type":"string"},"type":{"type":"string","enum":["flat","percentage"]},"flatAmount":{"type":"number"},"percentage":{"type":"number"},"freeMonths":{"type":"number"},"validityStart":{"type":"string"},"validityEnd":{"type":"string"},"usageLimit":{"type":"number"},"applicablePlanIds":{"type":"array","items":{"type":"string"}},"sellerId":{"type":"string"},"isActive":{"type":"boolean"}}},"CreatePaymentOrderDto":{"type":"object","properties":{"amount":{"type":"number","description":"Order amount in INR"},"orderId":{"type":"string","description":"Platform order id"}},"required":["amount","orderId"]},"CreateSettlementRunDto":{"type":"object","properties":{"sellerId":{"type":"string"},"periodStart":{"type":"string"},"periodEnd":{"type":"string"},"note":{"type":"string"}},"required":["sellerId","periodStart","periodEnd"]},"ImportReconciliationDto":{"type":"object","properties":{"rows":{"type":"array","items":{"type":"object"}}}},"CodRemittanceDto":{"type":"object","properties":{"shipmentId":{"type":"string"},"remittanceReference":{"type":"string"},"remittanceDate":{"type":"string"},"codAmountRemittedToPlatform":{"type":"number"},"note":{"type":"string"}},"required":["shipmentId","remittanceReference","codAmountRemittedToPlatform"]},"CreateFinanceHoldDto":{"type":"object","properties":{"scopeType":{"type":"string","enum":["seller","order","shipment","fulfillment","settlement_line"]},"scopeId":{"type":"string"},"holdType":{"type":"string","enum":["manual_hold","refund_dispute","reconciliation_mismatch","cod_not_reconciled","risk_review"]},"reason":{"type":"string"}},"required":["scopeType","scopeId","holdType","reason"]},"ReleaseFinanceHoldDto":{"type":"object","properties":{"reason":{"type":"string"}},"required":["reason"]},"ManualFinanceAdjustmentDto":{"type":"object","properties":{"sellerId":{"type":"string"},"amount":{"type":"number"},"reason":{"type":"string"},"orderId":{"type":"string"}},"required":["sellerId","amount","reason"]},"CommissionBackfillDto":{"type":"object","properties":{"limit":{"type":"number"}}},"UpsertChartOfAccountDto":{"type":"object","properties":{"accountCode":{"type":"string"},"accountName":{"type":"string"},"accountType":{"type":"string","enum":["asset","liability","income","expense","equity","control"]},"parentAccountCode":{"type":"string"},"normalBalance":{"type":"string","enum":["debit","credit"]},"isSystem":{"type":"boolean"},"isActive":{"type":"boolean"},"currency":{"type":"string"},"gstRelevant":{"type":"boolean"},"tallyLedgerName":{"type":"string"},"metadata":{"type":"object"}},"required":["accountCode"]},"PostingMatrixPreviewDto":{"type":"object","properties":{"entryType":{"type":"string"},"payload":{"type":"object"}},"required":["entryType"]},"UpsertBankAccountDto":{"type":"object","properties":{"accountCode":{"type":"string"},"bankName":{"type":"string"},"accountNumberMasked":{"type":"string"},"ifsc":{"type":"string"},"currency":{"type":"string"},"isActive":{"type":"boolean"},"metadata":{"type":"object"}},"required":["accountCode"]},"BankImportRowsDto":{"type":"object","properties":{"bankAccountCode":{"type":"string"},"fileName":{"type":"string"},"rows":{"type":"array","items":{"type":"object"}}},"required":["bankAccountCode","fileName"]},"BankImportFileDto":{"type":"object","properties":{"bankAccountCode":{"type":"string"}},"required":["bankAccountCode"]},"BankManualMatchDto":{"type":"object","properties":{"bankLineId":{"type":"string"},"expectedType":{"type":"string"},"expectedRefId":{"type":"string"},"note":{"type":"string"}},"required":["bankLineId","expectedType","expectedRefId"]},"BankExplainExceptionDto":{"type":"object","properties":{"note":{"type":"string"}},"required":["note"]},"PeriodActionDto":{"type":"object","properties":{"periodKey":{"type":"string"},"reason":{"type":"string"}},"required":["periodKey","reason"]},"UpdateFinanceAlertStatusDto":{"type":"object","properties":{"status":{"type":"string","enum":["acknowledged","resolved"]},"reason":{"type":"string"}},"required":["status"]},"UpsertTallyMappingDto":{"type":"object","properties":{"accountCode":{"type":"string"},"tallyLedgerName":{"type":"string"},"voucherType":{"type":"string"},"taxLedgerName":{"type":"string"},"narrationTemplate":{"type":"string"},"isActive":{"type":"boolean"}},"required":["accountCode","tallyLedgerName"]},"RegeneratePdfDto":{"type":"object","properties":{"forceRegenerate":{"type":"boolean"}}},"UpdateProfileDto":{"type":"object","properties":{"name":{"type":"string","example":"Priya Sharma"},"email":{"type":"string","example":"priya@example.com"},"profilePicture":{"type":"string"}}},"AddressDto":{"type":"object","properties":{"type":{"type":"string","enum":["home","work","other"],"default":"home"},"name":{"type":"string","example":"Priya Sharma"},"mobile":{"type":"string","example":"9876543210"},"pincode":{"type":"string","example":"400001"},"address":{"type":"string"},"city":{"type":"string"},"state":{"type":"string"},"landmark":{"type":"string"},"isDefault":{"type":"boolean"}},"required":["name","mobile","pincode","address","city","state"]},"ReasonDto":{"type":"object","properties":{"reason":{"type":"string","maxLength":1000}}},"CreateProductDto":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"},"categoryId":{"type":"string"},"subCategoryIds":{"type":"array","items":{"type":"string"}},"brand":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"basePrice":{"type":"number"},"totalInventory":{"type":"number","description":"Total inventory for non-variant products"},"compareAtPrice":{"type":"number"},"variants":{"type":"array","items":{"type":"string"}},"images":{"type":"array","items":{"type":"string"}},"video":{"type":"string"},"isTrending":{"type":"boolean","default":false},"isNewArrival":{"type":"boolean","default":false},"isEditorsPick":{"type":"boolean","default":false},"isActive":{"type":"boolean","default":true,"description":"Whether the product is visible/active"},"seo":{"type":"object"},"specifications":{"type":"object"},"isReturnable":{"type":"boolean","default":true},"returnWindowDays":{"type":"number","default":7},"allowReturnForDamagedOnly":{"type":"boolean","default":false},"codAvailable":{"type":"boolean","default":true,"description":"Whether COD is available for this product"},"freeDelivery":{"type":"boolean","default":false,"description":"Buyer sees free delivery; carrier cost debited from seller ledger"},"weight":{"type":"number","description":"Weight in grams (for shipping)"},"length":{"type":"number","description":"Length in cm (for shipping)"},"width":{"type":"number","description":"Width in cm (for shipping)"},"height":{"type":"number","description":"Height in cm (for shipping)"},"hsnCode":{"type":"string","description":"HSN/SAC code for GST invoicing"},"gstRate":{"type":"number","description":"GST rate % (e.g. 5, 12, 18). Ignored for exempt/non-GST categories at checkout."},"taxInclusive":{"type":"boolean","default":true,"description":"Whether base/variant list prices include GST"},"taxCategory":{"type":"string","enum":["taxable","exempt","zero_rated","non_gst"],"default":"taxable"}},"required":["name","description","categoryId","basePrice"]},"UpdateProductDto":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"},"categoryId":{"type":"string"},"subCategoryIds":{"type":"array","items":{"type":"string"}},"brand":{"type":"string"},"basePrice":{"type":"number"},"totalInventory":{"type":"number","description":"Total inventory for non-variant products"},"compareAtPrice":{"type":"number"},"isActive":{"type":"boolean"},"isTrending":{"type":"boolean"},"isNewArrival":{"type":"boolean"},"isEditorsPick":{"type":"boolean"},"images":{"type":"array","items":{"type":"string"}},"video":{"type":"string"},"variants":{"type":"array","items":{"type":"string"}},"seo":{"type":"object"},"isReturnable":{"type":"boolean"},"returnWindowDays":{"type":"number"},"allowReturnForDamagedOnly":{"type":"boolean"},"codAvailable":{"type":"boolean","description":"Whether COD is available for this product"},"freeDelivery":{"type":"boolean","default":false,"description":"Buyer sees free delivery; carrier cost debited from seller ledger"},"weight":{"type":"number","description":"Weight in grams (for shipping)"},"length":{"type":"number","description":"Length in cm (for shipping)"},"width":{"type":"number","description":"Width in cm (for shipping)"},"height":{"type":"number","description":"Height in cm (for shipping)"},"hsnCode":{"type":"string","description":"HSN/SAC code for GST invoicing"},"gstRate":{"type":"number","description":"GST rate % (e.g. 5, 12, 18). Ignored for exempt/non-GST categories at checkout."},"taxInclusive":{"type":"boolean","description":"Whether base/variant list prices include GST"},"taxCategory":{"type":"string","enum":["taxable","exempt","zero_rated","non_gst"]}}},"BulkDeleteProductsDto":{"type":"object","properties":{"ids":{"description":"Product ObjectIds to delete","type":"array","items":{"type":"string"}}},"required":["ids"]},"GeneratePresignedUrlDto":{"type":"object","properties":{"folder":{"type":"string","example":"products","description":"Optional folder/prefix for organizing uploads (e.g. products, categories, banners, seller-products)."},"filename":{"type":"string","example":"product-image.jpg"},"originalName":{"type":"string","example":"IMG_1234.JPG","description":"Original filename from the user device. Stored as S3 object metadata for later inspection."},"size":{"type":"number","example":245832,"description":"File size in bytes. Stored as S3 object metadata for later inspection."},"lastModified":{"type":"number","example":1700000000000,"description":"File lastModified (epoch ms) from the browser File object. Stored as S3 object metadata."},"contentType":{"type":"string","example":"image/jpeg"},"expiresIn":{"type":"number","example":3600}},"required":["filename","contentType"]},"UploadToS3Dto":{"type":"object","properties":{"folder":{"type":"string","example":"seller-products","description":"Optional folder/prefix for organizing uploads (e.g. products, categories, banners, seller-products)."},"filename":{"type":"string","example":"product-image.webp","description":"Target filename (used to build the final S3 object key)."},"originalName":{"type":"string","example":"IMG_1234.JPG","description":"Original filename from the user device (stored as object metadata)."},"size":{"type":"number","example":245832,"description":"File size in bytes (stored as object metadata)."},"lastModified":{"type":"number","example":1700000000000,"description":"File lastModified (epoch ms) from the browser File object (stored as object metadata)."},"contentType":{"type":"string","example":"image/webp","description":"Optional content type. If omitted, the uploaded file mimetype is used."}},"required":["filename"]},"BulkDeleteKeysDto":{"type":"object","properties":{"keys":{"description":"S3 object keys (URL-encoded) to delete","type":"array","items":{"type":"string"}}},"required":["keys"]},"CreateCategoryDto":{"type":"object","properties":{"name":{"type":"string"},"slug":{"type":"string","description":"URL slug; auto-generated from name when omitted"},"description":{"type":"string"},"image":{"type":"string"},"imageAlt":{"type":"string","description":"SEO/accessibility alt text for category image"},"parentId":{"type":"string"},"order":{"type":"number","default":0},"isActive":{"type":"boolean","default":true},"seo":{"type":"object"}},"required":["name"]},"UpdateCategoryDto":{"type":"object","properties":{"name":{"type":"string"},"slug":{"type":"string","description":"URL slug; auto-generated from name when omitted on update"},"description":{"type":"string"},"image":{"type":"string"},"parentId":{"type":"string"},"imageAlt":{"type":"string","description":"SEO/accessibility alt text for category image"},"isActive":{"type":"boolean"},"order":{"type":"number"},"seo":{"type":"object"}}},"OrderItemVariantDto":{"type":"object","properties":{"sku":{"type":"string"},"color":{"type":"string"},"size":{"type":"string"},"fabric":{"type":"string"}},"required":["sku"]},"OrderItemDto":{"type":"object","properties":{"productId":{"type":"string"},"variant":{"$ref":"#/components/schemas/OrderItemVariantDto"},"name":{"type":"string"},"image":{"type":"string"},"price":{"type":"number"},"quantity":{"type":"number"},"total":{"type":"number"}},"required":["productId","variant","name","image","price","quantity","total"]},"ShippingAddressDto":{"type":"object","properties":{"name":{"type":"string"},"mobile":{"type":"string"},"pincode":{"type":"string"},"address":{"type":"string"},"city":{"type":"string"},"state":{"type":"string"},"landmark":{"type":"string"}},"required":["name","mobile","pincode","address","city","state"]},"CheckoutSubsetDto":{"type":"object","properties":{"productId":{"type":"string","description":"Product id (matches cart line)"},"variant":{"$ref":"#/components/schemas/OrderItemVariantDto"},"quantity":{"type":"number","description":"Quantity to checkout for this line (buy now)"}},"required":["productId","variant","quantity"]},"CreateOrderDto":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/OrderItemDto"}},"shippingAddress":{"$ref":"#/components/schemas/ShippingAddressDto"},"workingAddress":{"$ref":"#/components/schemas/ShippingAddressDto"},"subtotal":{"type":"number","default":0},"shippingCharges":{"type":"number","default":0},"discount":{"type":"number","default":0},"couponId":{"type":"string"},"couponCode":{"type":"string"},"total":{"type":"number","default":0},"paymentMode":{"type":"string","enum":["prepaid","cod"],"default":"prepaid"},"checkoutSubset":{"description":"Checkout only this cart line at the given quantity (buy now). Other cart items stay in cart.","allOf":[{"$ref":"#/components/schemas/CheckoutSubsetDto"}]},"buyerType":{"type":"string","enum":["b2c","b2b"],"default":"b2c"},"buyerGstin":{"type":"string"},"buyerStateCode":{"type":"string"},"isBusinessPurchase":{"type":"boolean"},"checkoutClient":{"type":"string","enum":["web","mobile_app"],"description":"When mobile_app, PayU surl/furl use PAYU_MOBILE_RETURN_BASE_URL (or indiandaz://payu-callback) so Checkout Pro Custom Browser can return to the app instead of loading the website checkout in WebView."},"acquisition":{"type":"object","description":"First-party marketing attribution (UTMs, fbclid). No PII."}},"required":["items","shippingAddress","subtotal","shippingCharges","discount","total"]},"VerifyPaymentDto":{"type":"object","properties":{"razorpay_payment_id":{"type":"string"},"razorpay_order_id":{"type":"string"},"razorpay_signature":{"type":"string"},"cf_payment_id":{"type":"string"}}},"RefreshPrepaidSessionDto":{"type":"object","properties":{"checkoutClient":{"type":"string","enum":["web","mobile_app"]}}},"PayuCheckoutProHashDto":{"type":"object","properties":{"hashString":{"type":"string","description":"Pipe-separated string from PayU Checkout Pro SDK (no salt yet)"},"hashName":{"type":"string","example":"get_checkout_details"},"hashType":{"type":"string","enum":["V1","V2"],"description":"V2 uses HMAC-SHA256(salt, hashString)"},"postSalt":{"type":"string","description":"Used for split-payment style hashes when the SDK sends it"}},"required":["hashString","hashName"]},"UpdateOrderStatusDto":{"type":"object","properties":{"status":{"type":"string","enum":["pending","confirmed","processing","shipped","out_for_delivery","delivered","cancelled","returned","refunded"]},"notes":{"type":"string"},"trackingId":{"type":"string"},"deliveryPartnerId":{"type":"string"}},"required":["status"]},"CreateDeliveryPartnerDto":{"type":"object","properties":{"name":{"type":"string"},"provider":{"type":"string","enum":["delhivery","shiprocket","custom"]},"apiKey":{"type":"string"},"apiSecret":{"type":"string"},"baseUrl":{"type":"string"},"stagingUrl":{"type":"string"},"productionUrl":{"type":"string"},"environment":{"type":"string","enum":["staging","production"]},"webhookUrl":{"type":"string"},"webhookSecret":{"type":"string"},"isActive":{"type":"boolean"},"config":{"type":"object"}}},"UpdateDeliveryPartnerDto":{"type":"object","properties":{"name":{"type":"string"},"provider":{"type":"string","enum":["delhivery","shiprocket","custom"]},"apiKey":{"type":"string"},"apiSecret":{"type":"string"},"baseUrl":{"type":"string"},"stagingUrl":{"type":"string"},"productionUrl":{"type":"string"},"environment":{"type":"string","enum":["staging","production"]},"webhookUrl":{"type":"string"},"webhookSecret":{"type":"string"},"isActive":{"type":"boolean"},"config":{"type":"object"}}},"DimensionedActionDto":{"type":"object","properties":{"partnerId":{"type":"string"},"weight":{"type":"number","description":"Weight in grams"},"height":{"type":"number","description":"Height in cm"},"width":{"type":"number","description":"Width in cm"},"length":{"type":"number","description":"Length in cm"}},"required":["partnerId"]},"GenerateManifestDto":{"type":"object","properties":{"partnerId":{"type":"string"},"waybills":{"type":"array","items":{"type":"string"}}},"required":["partnerId"]},"PickupLocationDto":{"type":"object","properties":{"addressId":{"type":"string","description":"Stable pickup address ID for updates"},"label":{"type":"string","description":"Friendly seller-facing label"},"name":{"type":"string","description":"Unique name for Delhivery. Auto-generated as {username}_pickup when omitted."},"address":{"type":"string"},"pincode":{"type":"string"},"city":{"type":"string"},"district":{"type":"string","description":"Administrative district (India)"},"state":{"type":"string"},"contactName":{"type":"string"},"contactPhone":{"type":"string"},"isDefault":{"type":"boolean"},"isActive":{"type":"boolean"}},"required":["address","pincode","city","state","contactName","contactPhone"]},"SchedulePickupDto":{"type":"object","properties":{"partnerId":{"type":"string"},"pickupDate":{"type":"string"},"pickupTime":{"type":"string"},"location":{"$ref":"#/components/schemas/PickupLocationDto"},"waybills":{"type":"array","items":{"type":"string"}}},"required":["partnerId","pickupDate","location"]},"CancelShipmentDto":{"type":"object","properties":{"partnerId":{"type":"string"},"reason":{"type":"string"}},"required":["partnerId"]},"RequestPayoutDto":{"type":"object","properties":{"amount":{"type":"number"}}},"ProcessPayoutBatchDto":{"type":"object","properties":{"sellerId":{"type":"string"}}},"UpdatePayoutStatusDto":{"type":"object","properties":{"status":{"type":"string","enum":["payout_processing","payout_success","payout_failed"]},"note":{"type":"string"},"utr":{"type":"string"}}},"CartVariantDto":{"type":"object","properties":{"sku":{"type":"string"},"color":{"type":"string"},"size":{"type":"string"},"fabric":{"type":"string"}},"required":["sku"]},"AddToCartDto":{"type":"object","properties":{"productId":{"type":"string"},"variant":{"$ref":"#/components/schemas/CartVariantDto"},"quantity":{"type":"number","default":1},"price":{"type":"number"},"image":{"type":"string"}},"required":["productId","variant"]},"UpdateCartItemDto":{"type":"object","properties":{"quantity":{"type":"number","description":"Set to 0 to remove the item"}},"required":["quantity"]},"CartLocationDto":{"type":"object","properties":{"latitude":{"type":"number"},"longitude":{"type":"number"},"city":{"type":"string"},"state":{"type":"string"},"pincode":{"type":"string"}}},"ApplyCouponDto":{"type":"object","properties":{"couponCode":{"type":"string","example":"WELCOME10"},"location":{"$ref":"#/components/schemas/CartLocationDto"}},"required":["couponCode"]},"AutoApplyCouponDto":{"type":"object","properties":{"location":{"$ref":"#/components/schemas/CartLocationDto"}}},"ShippingSubsetVariantDto":{"type":"object","properties":{"sku":{"type":"string"},"color":{"type":"string"},"size":{"type":"string"},"fabric":{"type":"string"}},"required":["sku"]},"ShippingCheckoutSubsetDto":{"type":"object","properties":{"productId":{"type":"string"},"variant":{"$ref":"#/components/schemas/ShippingSubsetVariantDto"},"quantity":{"type":"number"}},"required":["productId","variant","quantity"]},"ShippingEstimateDto":{"type":"object","properties":{"destinationPincode":{"type":"string","description":"6-digit destination pincode"},"paymentMode":{"type":"string","description":"Payment mode affects shipping (COD has extra charges)","enum":["prepaid","cod"]},"orderTotal":{"type":"number","description":"Order subtotal for COD fee calculation"},"checkoutSubset":{"description":"When set, estimate shipping for this cart line only (buy-now checkout)","allOf":[{"$ref":"#/components/schemas/ShippingCheckoutSubsetDto"}]}},"required":["destinationPincode"]},"BuyNowShippingEstimateDto":{"type":"object","properties":{"productId":{"type":"string"},"variant":{"$ref":"#/components/schemas/CartVariantDto"},"quantity":{"type":"number"},"destinationPincode":{"type":"string","description":"6-digit destination pincode"},"paymentMode":{"type":"string","enum":["prepaid","cod"]},"orderTotal":{"type":"number"}},"required":["productId","variant","quantity","destinationPincode"]},"CouponLocationDto":{"type":"object","properties":{"latitude":{"type":"number"},"longitude":{"type":"number"},"city":{"type":"string"},"state":{"type":"string"},"pincode":{"type":"string"}}},"CouponContextDto":{"type":"object","properties":{"productIds":{"type":"array","items":{"type":"string"}},"sellerIds":{"type":"array","items":{"type":"string"}},"sellerOrderAmounts":{"type":"object","description":"sellerId -> order amount for that seller"}}},"ValidateCouponDto":{"type":"object","properties":{"code":{"type":"string","example":"WELCOME10"},"orderAmount":{"type":"number"},"location":{"$ref":"#/components/schemas/CouponLocationDto"},"couponContext":{"$ref":"#/components/schemas/CouponContextDto"}},"required":["code","orderAmount"]},"ListAvailableCouponsDto":{"type":"object","properties":{"orderAmount":{"type":"number","default":0},"location":{"$ref":"#/components/schemas/CouponLocationDto"},"couponContext":{"$ref":"#/components/schemas/CouponContextDto"}}},"CreateCouponDto":{"type":"object","properties":{"code":{"type":"string","example":"WELCOME10"},"type":{"type":"string","enum":["percentage","flat"]},"value":{"type":"number"},"description":{"type":"string","maxLength":5000},"images":{"type":"array","items":{"type":"string"}},"minimumOrder":{"type":"number","default":0},"maximumDiscount":{"type":"number"},"usageLimit":{"type":"number"},"validFrom":{"format":"date-time","type":"string"},"validUntil":{"format":"date-time","type":"string"},"isActive":{"type":"boolean","default":true},"applicableCategories":{"type":"array","items":{"type":"string"}},"applicableProducts":{"type":"array","items":{"type":"string"}},"applicableUsers":{"type":"array","items":{"type":"string"}},"applicableCities":{"type":"array","items":{"type":"string"}},"applicableStates":{"type":"array","items":{"type":"string"}},"applicablePincodes":{"type":"array","items":{"type":"string"}},"scope":{"type":"string","enum":["platform","seller"],"default":"platform"},"sellerId":{"type":"string"}},"required":["code","type","value","validFrom","validUntil"]},"UpdateCouponDto":{"type":"object","properties":{"code":{"type":"string","example":"WELCOME10"},"type":{"type":"string","enum":["percentage","flat"]},"value":{"type":"number"},"description":{"type":"string","maxLength":5000},"images":{"type":"array","items":{"type":"string"}},"minimumOrder":{"type":"number"},"maximumDiscount":{"type":"number"},"usageLimit":{"type":"number"},"validFrom":{"format":"date-time","type":"string"},"validUntil":{"format":"date-time","type":"string"},"isActive":{"type":"boolean"},"applicableCategories":{"type":"array","items":{"type":"string"}},"applicableProducts":{"type":"array","items":{"type":"string"}},"applicableUsers":{"type":"array","items":{"type":"string"}},"applicableCities":{"type":"array","items":{"type":"string"}},"applicableStates":{"type":"array","items":{"type":"string"}},"applicablePincodes":{"type":"array","items":{"type":"string"}},"scope":{"type":"string","enum":["platform","seller"]},"sellerId":{"type":"string"}}},"CreateShipmentsDto":{"type":"object","properties":{"partnerId":{"type":"string"},"sellerId":{"type":"string"},"weight":{"type":"number"},"height":{"type":"number"},"width":{"type":"number"},"length":{"type":"number"}}},"InitiateRefundDto":{"type":"object","properties":{"orderId":{"type":"string"},"amount":{"type":"number"},"reason":{"type":"string"}},"required":["orderId","amount","reason"]},"InitiateReturnRefundDto":{"type":"object","properties":{"amount":{"type":"number"}}},"UpdateRefundStatusDto":{"type":"object","properties":{"status":{"type":"string","enum":["completed","failed"]},"note":{"type":"string"}},"required":["status"]},"SeoDto":{"type":"object","properties":{"title":{"type":"string"},"description":{"type":"string"},"keywords":{"type":"string"}}},"CreatePageDto":{"type":"object","properties":{"slug":{"type":"string","example":"about-us"},"title":{"type":"string","example":"About Us"},"content":{"type":"string","example":"<p>Content</p>"},"seo":{"$ref":"#/components/schemas/SeoDto"},"isActive":{"type":"boolean"}}},"UpdatePageDto":{"type":"object","properties":{"slug":{"type":"string","example":"about-us"},"title":{"type":"string","example":"About Us"},"content":{"type":"string","example":"<p>Content</p>"},"seo":{"$ref":"#/components/schemas/SeoDto"},"isActive":{"type":"boolean"}}},"CreateCollectionDto":{"type":"object","properties":{"slug":{"type":"string","example":"summer-sale"},"title":{"type":"string","example":"Summer Sale"},"description":{"type":"string"},"image":{"type":"string"},"productIds":{"type":"array","items":{"type":"string"}},"seo":{"$ref":"#/components/schemas/SeoDto"},"isActive":{"type":"boolean"}}},"UpdateCollectionDto":{"type":"object","properties":{"slug":{"type":"string","example":"summer-sale"},"title":{"type":"string","example":"Summer Sale"},"description":{"type":"string"},"image":{"type":"string"},"productIds":{"type":"array","items":{"type":"string"}},"seo":{"$ref":"#/components/schemas/SeoDto"},"isActive":{"type":"boolean"}}},"CreateBannerDto":{"type":"object","properties":{"title":{"type":"string","example":"Big Summer Sale"},"subtitle":{"type":"string"},"image":{"type":"string"},"imageAlt":{"type":"string"},"mobileImage":{"type":"string"},"mobileImageAlt":{"type":"string"},"link":{"type":"string"},"position":{"type":"string","enum":["home","category","product"]},"categoryId":{"type":"string"},"order":{"type":"number"},"isActive":{"type":"boolean"},"ctaText":{"type":"string"},"expiresAt":{"format":"date-time","type":"string"}}},"UpdateBannerDto":{"type":"object","properties":{"title":{"type":"string","example":"Big Summer Sale"},"subtitle":{"type":"string"},"image":{"type":"string"},"imageAlt":{"type":"string"},"mobileImage":{"type":"string"},"mobileImageAlt":{"type":"string"},"link":{"type":"string"},"position":{"type":"string","enum":["home","category","product"]},"categoryId":{"type":"string"},"order":{"type":"number"},"isActive":{"type":"boolean"},"ctaText":{"type":"string"},"expiresAt":{"format":"date-time","type":"string"}}},"WishlistVariantDto":{"type":"object","properties":{"sku":{"type":"string"},"color":{"type":"string"},"size":{"type":"string"},"fabric":{"type":"string"}},"required":["sku"]},"AddWishlistDto":{"type":"object","properties":{"productId":{"type":"string"},"variant":{"$ref":"#/components/schemas/WishlistVariantDto"}},"required":["productId"]},"WishlistVariantBodyDto":{"type":"object","properties":{"variant":{"$ref":"#/components/schemas/WishlistVariantDto"}}},"TrackEventDto":{"type":"object","properties":{}},"CreateContactDto":{"type":"object","properties":{"name":{"type":"string","example":"Priya Sharma"},"email":{"type":"string","example":"priya@example.com"},"mobile":{"type":"string","example":"9876543210"},"subject":{"type":"string","example":"Order inquiry"},"message":{"type":"string","example":"I need help with my recent order."},"website":{"type":"string","description":"Leave empty (anti-spam honeypot)"}},"required":["name","email","subject","message"]},"ReplyContactDto":{"type":"object","properties":{"replyMessage":{"type":"string","example":"Thanks for reaching out — we will help shortly."}},"required":["replyMessage"]},"EmailDto":{"type":"object","properties":{"email":{"type":"string","example":"shopper@example.com"}},"required":["email"]},"CreateReviewDto":{"type":"object","properties":{"productId":{"type":"string"},"orderId":{"type":"string"},"rating":{"type":"number","minimum":1,"maximum":5},"body":{"type":"string","maxLength":2000},"images":{"description":"Up to 3 image URLs","type":"array","items":{"type":"string"}}},"required":["productId","orderId","rating"]},"UpdateReviewDto":{"type":"object","properties":{"rating":{"type":"number","minimum":1,"maximum":5},"body":{"type":"string","maxLength":2000},"images":{"description":"Up to 3 image URLs","type":"array","items":{"type":"string"}}}},"UpdateSellerStorefrontDto":{"type":"object","properties":{"header":{"type":"object"},"announcement":{"type":"object"},"navigation":{"type":"object"},"floatingActions":{"type":"object"},"layout":{"description":"Ordered blocks: banner | custom_section","type":"array","items":{"type":"string"}},"theme":{"type":"object"},"categories":{"type":"object","description":"Category browse UI: showcase | chips | both | hidden"},"features":{"type":"object","description":"Optional storefront feature flags (e.g. recommendations)"}}},"ConnectCustomDomainDto":{"type":"object","properties":{"domain":{"type":"string","example":"dkd.com","description":"Apex domain without protocol or path"}},"required":["domain"]},"SellerApplyDto":{"type":"object","properties":{"username":{"type":"string","description":"Unique username for store URL (3-32 chars, lowercase, letters, numbers, underscore)"},"storeName":{"type":"string"},"profilePhoto":{"type":"string","description":"Profile/logo photo URL"},"bannerPhoto":{"type":"string","description":"Banner photo URL"},"storeAddress":{"type":"object"},"gstin":{"type":"string","description":"15-character GSTIN for tax invoices"},"stateCode":{"type":"string","description":"2-digit GST state code (e.g. 27 for Maharashtra)"},"loginPin":{"type":"string","description":"4-digit PIN for future seller login without OTP (must match loginPinConfirm)"},"loginPinConfirm":{"type":"string","description":"Must match loginPin"},"pageCustomization":{"type":"object","description":"Store page customization (colors, layout, welcome text)"}}},"SellerKycOtherDocDto":{"type":"object","properties":{"url":{"type":"string","description":"Public URL of the uploaded file"},"label":{"type":"string","example":"GST certificate"}},"required":["url"]},"SellerKycDocumentsDto":{"type":"object","properties":{"aadhaarUrl":{"type":"string","description":"Aadhaar document (image/PDF URL after upload)"},"panUrl":{"type":"string","description":"PAN card document URL"},"tradeLicenseUrl":{"type":"string","description":"Trade licence or other government-registered business document URL"},"other":{"type":"array","items":{"$ref":"#/components/schemas/SellerKycOtherDocDto"}},"submit":{"type":"boolean","description":"When true, mark the KYC bundle as submitted for admin review. Requires Aadhaar, PAN, and business proof to already exist."}}},"SellerContactPhoneOtpDto":{"type":"object","properties":{"phone":{"type":"string","example":"9876543210"}},"required":["phone"]},"VerifySellerContactPhoneOtpDto":{"type":"object","properties":{"phone":{"type":"string","example":"9876543210"},"code":{"type":"string","example":"123456"}},"required":["phone","code"]},"UpdateBankDetailsDto":{"type":"object","properties":{"accountNumber":{"type":"string","description":"Bank account number (digits only)"},"ifsc":{"type":"string","description":"IFSC code"},"accountHolderName":{"type":"string","description":"Account holder full name"},"bankName":{"type":"string","description":"Bank name"},"upiId":{"type":"string","description":"UPI ID (optional alternative payout rail)"}}},"InventoryUpdateItemDto":{"type":"object","properties":{"sku":{"type":"string"},"inventory":{"type":"number"}},"required":["sku","inventory"]},"UpdateInventoryDto":{"type":"object","properties":{"updates":{"type":"array","items":{"$ref":"#/components/schemas/InventoryUpdateItemDto"}}},"required":["updates"]},"SellerShipOrderDto":{"type":"object","properties":{"partnerId":{"type":"string"},"weight":{"type":"number","description":"Weight in grams"},"height":{"type":"number","description":"Height in cm"},"width":{"type":"number","description":"Width in cm"},"length":{"type":"number","description":"Length in cm"}},"required":["partnerId"]},"SellerSchedulePickupDto":{"type":"object","properties":{"pickupDate":{"type":"string"},"pickupTime":{"type":"string"},"waybills":{"type":"array","items":{"type":"string"}}}},"SellerGenerateManifestDto":{"type":"object","properties":{"waybills":{"type":"array","items":{"type":"string"}}}},"RespondDisputeDto":{"type":"object","properties":{"action":{"type":"string"},"note":{"type":"string"}},"required":["action"]},"CreateSupportTicketDto":{"type":"object","properties":{"subject":{"type":"string"},"message":{"type":"string"}},"required":["subject","message"]},"AddSupportMessageDto":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]},"UpdateNotificationPreferencesDto":{"type":"object","properties":{"mode":{"type":"string","enum":["urgent","daily","all"]},"channels":{"type":"object"},"categories":{"type":"object"}}},"UpdateDisputeStatusDto":{"type":"object","properties":{"status":{"type":"string","enum":["open","in_review","resolved","rejected"]},"note":{"type":"string"}},"required":["status"]},"UpdateSupportTicketStatusDto":{"type":"object","properties":{"status":{"type":"string","enum":["open","in_progress","resolved","closed"]},"note":{"type":"string"},"escalationState":{"type":"string","enum":["none","requested","escalated"]}},"required":["status"]},"AdminSupportTicketMessageDto":{"type":"object","properties":{"message":{"type":"string"},"status":{"type":"string","enum":["open","in_progress","resolved","closed"]},"notifyChannels":{"type":"array","items":{"type":"string","enum":["push","email","whatsapp","sms"]}},"notify":{"type":"boolean"}},"required":["message"]},"VerifyPickupAddressDto":{"type":"object","properties":{"isVerified":{"type":"boolean"}},"required":["isVerified"]},"AdminSellerActionDto":{"type":"object","properties":{"reason":{"type":"string"}}},"ValidateSubscriptionCouponDto":{"type":"object","properties":{"planId":{"type":"string"},"couponCode":{"type":"string"}},"required":["planId","couponCode"]},"CreateSubscriptionPaymentDto":{"type":"object","properties":{"planId":{"type":"string"},"couponCode":{"type":"string"}},"required":["planId"]},"VerifySubscriptionPaymentDto":{"type":"object","properties":{"subscriptionPaymentId":{"type":"string"},"razorpay_payment_id":{"type":"string"},"razorpay_order_id":{"type":"string"},"razorpay_signature":{"type":"string"},"cashfree_payment_id":{"type":"string"}},"required":["subscriptionPaymentId"]},"ReturnItemDto":{"type":"object","properties":{"orderItemIndex":{"type":"number"},"quantity":{"type":"number"},"reason":{"type":"string","enum":["damaged","wrong_item","not_as_described","other"]},"reasonDetail":{"type":"string","maxLength":1000},"images":{"type":"array","items":{"type":"string"}}},"required":["orderItemIndex","quantity","reason"]},"RequestReturnDto":{"type":"object","properties":{"orderId":{"type":"string"},"shipmentId":{"type":"string"},"items":{"type":"array","items":{"$ref":"#/components/schemas/ReturnItemDto"}}},"required":["orderId","shipmentId","items"]},"ReturnQualityCheckDto":{"type":"object","properties":{"passed":{"type":"boolean"},"receivedSku":{"type":"string"},"receivedQuantity":{"type":"number"},"condition":{"type":"string","enum":["resalable","used","damaged","different_item","empty_box","incomplete"]},"packagingComplete":{"type":"boolean"},"accessoriesComplete":{"type":"boolean"},"mediaEvidence":{"type":"array","items":{"type":"string"}},"notes":{"type":"string","maxLength":2000},"checkedAt":{"type":"string"}},"required":["passed","receivedSku","receivedQuantity","condition","packagingComplete","accessoriesComplete","mediaEvidence"]},"SellerApproveReturnDto":{"type":"object","properties":{"approved":{"type":"boolean"},"note":{"type":"string","maxLength":2000},"evidenceUrls":{"type":"array","items":{"type":"string"}},"qualityCheck":{"$ref":"#/components/schemas/ReturnQualityCheckDto"}},"required":["approved"]},"InstagramOAuthStartDto":{"type":"object","properties":{}},"CreateInstagramAutomationRuleDto":{"type":"object","properties":{}},"UpdateInstagramAutomationRuleDto":{"type":"object","properties":{}},"MetaAdsOAuthStartDto":{"type":"object","properties":{"successRedirect":{"type":"string"},"failureRedirect":{"type":"string"}}},"SelectMetaAssetsDto":{"type":"object","properties":{"businessId":{"type":"string"},"adAccountId":{"type":"string"},"pixelId":{"type":"string"},"datasetId":{"type":"string"}},"required":["adAccountId"]},"RecommendationsBodyDto":{"type":"object","properties":{}},"LogRecommendationEventDto":{"type":"object","properties":{}},"BatchRecommendationEventsDto":{"type":"object","properties":{}},"CreateHsnSacDto":{"type":"object","properties":{"type":{"type":"string","enum":["HSN","SAC"]},"code":{"type":"string"},"description":{"type":"string"},"gstRate":{"type":"number","default":0},"cgst":{"type":"number"},"sgst":{"type":"number"},"igst":{"type":"number"}},"required":["type","code","description"]},"UpdateHsnSacDto":{"type":"object","properties":{"type":{"type":"string","enum":["HSN","SAC"]},"code":{"type":"string"},"description":{"type":"string"},"gstRate":{"type":"number"},"cgst":{"type":"number"},"sgst":{"type":"number"},"igst":{"type":"number"}}},"SaveSellerHsnDto":{"type":"object","properties":{"hsnCode":{"type":"string","example":"6109"},"masterId":{"type":"string"},"isDefault":{"type":"boolean"}},"required":["hsnCode"]},"UpdateSellerHsnDto":{"type":"object","properties":{"hsnCode":{"type":"string","example":"6109"},"masterId":{"type":"string"},"isDefault":{"type":"boolean"}}},"AdjustStockDto":{"type":"object","properties":{"mode":{"type":"string","enum":["set","add","subtract"]},"quantity":{"type":"number","description":"May be decimal for kg/meter units"},"note":{"type":"string"}},"required":["mode","quantity"]},"UpdatePosSettingsDto":{"type":"object","properties":{"receiptPrinter":{"type":"string"},"receiptFormat":{"type":"string"},"autoPrintOnConfirm":{"type":"boolean"},"labelPrinter":{"type":"string"},"scannerMode":{"type":"string"},"networkPrinterHost":{"type":"string"},"networkPrinterPort":{"type":"number"},"lowStockThreshold":{"type":"number"},"receiptFooter":{"type":"string"},"openDrawerPulse":{"type":"boolean"},"syncChannel":{"type":"string"},"syncChannelLocked":{"type":"boolean"},"storeUpiId":{"type":"string"},"showGstOnBills":{"type":"boolean"},"inventorySyncMode":{"type":"string"}}},"CreateStoreProductDto":{"type":"object","properties":{"name":{"type":"string"},"localName":{"type":"string"},"image":{"type":"string"},"sku":{"type":"string"},"barcode":{"type":"string"},"hsnCode":{"type":"string"},"gstRate":{"type":"number"},"sellingPrice":{"type":"number"},"wholesalePrice":{"type":"number"},"mrp":{"type":"number"},"costPrice":{"type":"number"},"stockQuantity":{"type":"number"},"unitOfMeasure":{"type":"string"},"warrantyMonths":{"type":"number"},"category":{"type":"string"},"isActive":{"type":"boolean"}},"required":["name","gstRate","sellingPrice"]},"UpdateStoreProductDto":{"type":"object","properties":{"name":{"type":"string"},"localName":{"type":"string"},"image":{"type":"string"},"sku":{"type":"string"},"barcode":{"type":"string"},"hsnCode":{"type":"string"},"gstRate":{"type":"number"},"sellingPrice":{"type":"number"},"wholesalePrice":{"type":"number"},"mrp":{"type":"number"},"costPrice":{"type":"number"},"stockQuantity":{"type":"number"},"unitOfMeasure":{"type":"string"},"warrantyMonths":{"type":"number"},"category":{"type":"string"},"isActive":{"type":"boolean"}}},"UpdateStoreCustomerDto":{"type":"object","properties":{"name":{"type":"string"},"phone":{"type":"string"},"email":{"type":"string"},"address":{"type":"string"},"gstin":{"type":"string"},"creditBalance":{"type":"number"}}},"CreateStoreCustomerDto":{"type":"object","properties":{"name":{"type":"string"},"phone":{"type":"string"},"email":{"type":"string"},"address":{"type":"string"},"gstin":{"type":"string"},"creditBalance":{"type":"number"}},"required":["name"]},"CollectKhataPaymentDto":{"type":"object","properties":{"amount":{"type":"number"},"note":{"type":"string"},"paymentMode":{"type":"string"}},"required":["amount"]},"CreateStoreOfferDto":{"type":"object","properties":{"name":{"type":"string"},"localName":{"type":"string"},"discountPercent":{"type":"number"},"discountAmount":{"type":"number"},"scope":{"type":"string","enum":["all","category","products"]},"category":{"type":"string"},"productIds":{"type":"array","items":{"type":"string"}},"startsAt":{"format":"date-time","type":"string"},"endsAt":{"format":"date-time","type":"string"},"isActive":{"type":"boolean"}},"required":["name","startsAt","endsAt"]},"UpdateStoreOfferDto":{"type":"object","properties":{"name":{"type":"string"},"localName":{"type":"string"},"discountPercent":{"type":"number"},"discountAmount":{"type":"number"},"scope":{"type":"string","enum":["all","category","products"]},"category":{"type":"string"},"productIds":{"type":"array","items":{"type":"string"}},"startsAt":{"format":"date-time","type":"string"},"endsAt":{"format":"date-time","type":"string"},"isActive":{"type":"boolean"}}},"StoreBillLineInputDto":{"type":"object","properties":{"storeProductId":{"type":"string"},"name":{"type":"string"},"image":{"type":"string"},"hsnCode":{"type":"string"},"gstRate":{"type":"number"},"quantity":{"type":"number"},"unitOfMeasure":{"type":"string"},"unitPrice":{"type":"number"},"priceTier":{"type":"string","enum":["retail","wholesale"]},"localName":{"type":"string"},"offerLabel":{"type":"string"},"warrantyMonths":{"type":"number"},"discountPercent":{"type":"number"},"discountAmount":{"type":"number"}},"required":["name","quantity"]},"StoreBillPaymentSplitDto":{"type":"object","properties":{"mode":{"type":"string"},"amount":{"type":"number"}}},"StoreBillTotalsDto":{"type":"object","properties":{"taxableValue":{"type":"number"},"cgstAmount":{"type":"number"},"sgstAmount":{"type":"number"},"grandTotal":{"type":"number"}}},"CreateStoreBillDto":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/StoreBillLineInputDto"}},"paymentMode":{"type":"string","enum":["cash","upi","card","split","credit"]},"paymentSplits":{"type":"array","items":{"$ref":"#/components/schemas/StoreBillPaymentSplitDto"}},"customerId":{"type":"string"},"walkInName":{"type":"string"},"walkInPhone":{"type":"string"},"tableNumber":{"type":"number"},"tableLabel":{"type":"string"},"billDiscountPercent":{"type":"number"},"billDiscountAmount":{"type":"number"},"appliedOfferId":{"type":"string"},"appliedOfferLabel":{"type":"string"},"cashTendered":{"type":"number"},"changeGiven":{"type":"number"},"totals":{"$ref":"#/components/schemas/StoreBillTotalsDto"},"idempotencyKey":{"type":"string"}},"required":["items"]},"UpdateStoreBillDto":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/StoreBillLineInputDto"}},"paymentMode":{"type":"string","enum":["cash","upi","card","split","credit"]},"paymentSplits":{"type":"array","items":{"$ref":"#/components/schemas/StoreBillPaymentSplitDto"}},"customerId":{"type":"string"},"walkInName":{"type":"string"},"walkInPhone":{"type":"string"},"tableNumber":{"type":"number"},"tableLabel":{"type":"string"},"billDiscountPercent":{"type":"number"},"billDiscountAmount":{"type":"number"},"appliedOfferId":{"type":"string"},"appliedOfferLabel":{"type":"string"},"cashTendered":{"type":"number"},"changeGiven":{"type":"number"},"totals":{"$ref":"#/components/schemas/StoreBillTotalsDto"}}},"SendBillDto":{"type":"object","properties":{"channel":{"type":"string","enum":["whatsapp","sms","email"]},"to":{"type":"string"}},"required":["channel"]},"StoreReturnItemDto":{"type":"object","properties":{"storeProductId":{"type":"string"},"name":{"type":"string"},"quantity":{"type":"number"},"refundAmount":{"type":"number"}},"required":["name","quantity","refundAmount"]},"CreateStoreReturnDto":{"type":"object","properties":{"originalBillId":{"type":"string"},"items":{"type":"array","items":{"$ref":"#/components/schemas/StoreReturnItemDto"}},"reason":{"type":"string"},"refundMode":{"type":"string","enum":["cash","upi","store_credit"]}},"required":["originalBillId","items","reason","refundMode"]},"CreateStoreSupplierDto":{"type":"object","properties":{"name":{"type":"string"},"contactPerson":{"type":"string"},"phone":{"type":"string"},"email":{"type":"string"},"gstin":{"type":"string"},"address":{"type":"string"},"notes":{"type":"string"},"isActive":{"type":"boolean"}},"required":["name"]},"UpdateStoreSupplierDto":{"type":"object","properties":{"name":{"type":"string"},"contactPerson":{"type":"string"},"phone":{"type":"string"},"email":{"type":"string"},"gstin":{"type":"string"},"address":{"type":"string"},"notes":{"type":"string"},"isActive":{"type":"boolean"}}},"StorePurchaseLineInputDto":{"type":"object","properties":{"storeProductId":{"type":"string"},"name":{"type":"string"},"hsnCode":{"type":"string"},"gstRate":{"type":"number"},"quantity":{"type":"number"},"unitOfMeasure":{"type":"string"},"unitCost":{"type":"number"},"lineTotal":{"type":"number"}},"required":["name","quantity","unitCost"]},"CreateStorePurchaseDto":{"type":"object","properties":{"supplierId":{"type":"string"},"supplierName":{"type":"string"},"items":{"type":"array","items":{"$ref":"#/components/schemas/StorePurchaseLineInputDto"}},"subtotal":{"type":"number"},"taxAmount":{"type":"number"},"grandTotal":{"type":"number"},"invoiceRef":{"type":"string"},"note":{"type":"string"},"status":{"type":"string","enum":["draft","confirmed"]}},"required":["items"]}}},"externalDocs":{"description":"Seller API documentation","url":"https://seller.indiandaz.com/developers"}}