Kepler Ops Documentation & Learning Center

Welcome to the Kepler Operations Intelligence Hub. Kepler provides real-time exception detection, automated sync reconciliation, and financial leak calculation across E-Commerce, 3PL Logistics, Ocean Freight, and Accounting systems.

🛡️ Zero-PII Retention & Read-Only Observer Guarantee

Kepler is engineered with strict DPDP and GDPR compliance. Uploaded CSVs are evaluated in ephemeral memory on our server with zero database persistence. Customer names, emails, and phone numbers are never stored, logged, or saved. Kepler never alters or mutates live orders, inventory counts, or financial databases.

📖 Plain-English Seller Learning Guide: Where Is Your Money Leaking?

Most D2C e-commerce merchants lose 5% to 15% of their monthly profits to invisible operational glitches. Here is what they mean in plain English without technical jargon:

1. Cancelled Orders Dispatched by Couriers (Dead Freight)

What happens: A buyer places an order on Shopify and cancels 30 minutes later. You refund their money. But your courier app already printed a shipping label and picks up the box anyway. The courier delivers the parcel, so the buyer gets their refund AND your product for free, plus you pay ₹150 courier charges.

⚡ Kepler Fix: Real-time webhook observer halts the courier manifest within 500ms before pickup.

2. Volumetric Weight Overcharges

What happens: You sell a lightweight 200g t-shirt. The courier scanner mistakenly logs the plastic polybag as 1.5 kg (cubic volume) and deducts ₹140 from your wallet instead of ₹65.

⚡ Kepler Fix: Compares courier invoice weights against your product catalog dimensions and generates a 1-click dispute spreadsheet.

3. Fake COD Phone Numbers & Serial RTO

What happens: Pranksters place Cash on Delivery orders with fake numbers like 9999999999. You ship the box, the delivery fails, and you pay non-refundable shipping fees.

⚡ Kepler Fix: Identifies fake phone numbers and address anomalies before you spend money printing shipping labels.

4. Trapped Prepaid Settlements

What happens: A customer pays ₹3,000 on your website. Shopify marks it "Paid". But due to a gateway settlement hold (Razorpay/Cashfree/Stripe), the money never reaches your bank account.

⚡ Kepler Fix: Cross-matches Shopify orders with bank UTR settlements and alerts on any unsettled funds $>5 ext{ days}$.

5. Discount Stacking (Negative Margin Orders)

What happens: A customer stacks a 15% Welcome coupon + 10% Influencer code + 5% Prepaid discount. Your profit margin was 20%, but the customer got 30% off — meaning you lose money on every unit sold.

⚡ Kepler Fix: Reconciles net checkout revenue against product cost + shipping and flags loss-making orders.

6. Wrong State GST Head (Tax Audit Penalty)

What happens: Your store is in Maharashtra and ships to Delhi. Indian law requires charging IGST. If your software mistakenly charges CGST+SGST, you face tax penalties and interest.

⚡ Kepler Fix: Verifies 2-digit Place of Supply (POS) state codes on every order to ensure 100% tax compliance.

7. Fake Courier Delivery Denials (NDRs)

What happens: A delivery executive marks "Customer refused delivery" without calling or visiting. You pay non-refundable two-way RTO shipping fees.

⚡ Kepler Fix: Verifies delivery attempts with buyer via WhatsApp and files dispute tickets before automatic RTO returns.

8. Multi-Warehouse Split-Shipment Double Freight

What happens: A customer orders 2 items. Shopify splits the order into 2 boxes from separate hubs, doubling your shipping cost to ₹155 instead of ₹70.

⚡ Kepler Fix: Detects consolidated stock in primary hubs and halts multi-location order splits before label generation.

9. Silent Subscription Churn (Expired Cards)

What happens: A recurring subscriber credit card expires. Retries fail quietly, and the subscription cancels without customer engagement.

⚡ Kepler Fix: Proactively alerts 30 days before card expiry and triggers 1-click WhatsApp payment update links.

10. Chronic High-RTO Blacklisted Pincodes

What happens: You ship a COD parcel to a remote cluster with a 70% return history. You pay ₹180 courier freight with zero chance of delivery.

⚡ Kepler Fix: Checks postal codes against historical delivery success rates and mandates Prepaid or advance deposits.

🚀 3-Minute Quickstart Guide

You can audit your store in two distinct ways: through instant CSV diagnostics or automated 24/7 HTTPS webhooks.

Option A: Instant CSV Diagnostic Audit (5 Seconds)

In your Shopify Admin, go to Orders → Export → CSV for Excel.
Open the dashboard at https://www.getkeplerops.com.
Drag & drop your CSV file to immediately calculate financial leakage and export a 1-page PDF report.

Option B: 24/7 Automated Real-Time Webhooks (60 Seconds)

In Shopify Admin, go to Settings → Notifications → Webhooks.
Click Create Webhook → Event: Order cancellation → Format: JSON.
Enter your tenant webhook URL:
https://www.getkeplerops.com/v1/webhooks/shopify/{YOUR_TENANT_ID}/order-cancelled
Click Save. Our gateway verifies HMAC SHA-256 signatures and fires instant WhatsApp/Slack alerts when cancelled orders are still manifested with couriers.

🚚 Courier Volumetric Weight Surcharge Audit (W7)

Couriers like Shiprocket, Delhivery, and Bluedart calculate freight using volumetric weight: (L × W × H) / 5000. When courier scans overestimate box dimensions, merchants suffer silent ₹45–₹120 overcharges per parcel.

Audit Calculation Formula:

Volumetric Weight (g) = (Length_cm × Width_cm × Height_cm / 5000) × 1000 Billable Slab = Max(Catalog Dead Weight, Volumetric Weight) Excess Overcharge = (Billed Weight - Billable Slab) / 500g × ₹45 Surcharge

Upload your weekly courier billing CSV to the dashboard or call our REST API at POST /v1/audits/weight-reconciler to generate a line-item dispute sheet before the 7-day courier dispute deadline expires.

🚢 Global Container Demurrage & Port Detention (W10)

Import/Export containers at major ports (Nhava Sheva JNPT, Chennai, Mundra) are allocated 14 free days. Past this window, shipping lines levy $150–$250/day in port demurrage.

Watchdog Alerts:

🔴 CRITICAL OVERSTAY: Fired when free time is exceeded, calculating exact accrued USD penalties.
🟡 COUNTDOWN WARNING: Fired when $le 3$ free days remain with incomplete customs documentation.

💻 Developer REST API Reference

Query store health and evaluate exceptions programmatically using your merchant API key.

⚡ Interactive API Sandbox Available

Test live payloads, inspect instant verdicts, and generate authenticated cURL commands in your browser.

Open API Sandbox →

1. Query Tenant Profile & Status:

curl -H "X-API-Key: kpl_live_orgchaos_7f8a9b0c1d2e" https://www.getkeplerops.com/v1/tenants/me

2. Evaluate Courier Weight Overcharge (W7):

curl -X POST https://www.getkeplerops.com/v1/audits/weight-reconciler -H "Content-Type: application/json" -d '{ "billedWeightGrams": 1500, "lengthCm": 25, "widthCm": 20, "heightCm": 3, "billedFreightInr": 140 }'

3. Evaluate Container Demurrage (W10):

curl -X POST https://www.getkeplerops.com/v1/audits/freight-demurrage -H "Content-Type: application/json" -d '{ "containerNumber": "MSCU8918290", "gateInDate": "2026-08-01T00:00:00.000Z", "freeDaysAllowance": 14, "dailyDemurrageRateUsd": 150 }'

4. Evaluate Purchase Order Rate Variance & Short Receipts (W31 - PROCUREMENT_OPS):

curl -X POST https://www.getkeplerops.com/v1/audits/supplier-po -H "Content-Type: application/json" -d '{ "poNumber": "PO-2026-8801", "invoiceNumber": "INV-APX-4421", "vendorName": "Apex Textiles Ltd", "poUnitPrice": 300, "invoicedUnitPrice": 330, "orderedQty": 500, "invoicedQty": 500, "grnReceivedQty": 500 }'

5. Evaluate Quick-Commerce Dark Store Expiry & Shrinkage (W32 - QUICK_COMMERCE_OPS):

curl -X POST https://www.getkeplerops.com/v1/audits/dark-store-inventory -H "Content-Type: application/json" -d '{ "darkStoreId": "DS-BLNK-MUM-01", "sku": "GREEK-YOGURT-BERRY", "batchNumber": "BAT-2026-AUG-01", "daysToExpiry": 8, "systemVirtualQty": 100, "physicalAuditQty": 100, "unitCostInr": 85, "dailySalesVelocity": 2.5 }'

6. Evaluate AI Token Budget & Cost Runaway Spikes (W33 - AI_OPS):

curl -X POST https://www.getkeplerops.com/v1/audits/ai-cost -H "Content-Type: application/json" -d '{ "traceId": "TRC-OPENAI-9901", "provider": "OpenAI", "configuredModel": "gpt-4o", "actualModelServed": "gpt-4o", "totalTokens": 5000, "inferenceCostUSD": 0.05, "hourlyBaselineSpendUSD": 10.0, "currentHourlySpendUSD": 45.0 }'

7. Evaluate Biometric Punch Impossible Travel & Overtime Leakage (W34 - HR_PAYROLL_OPS):

curl -X POST https://www.getkeplerops.com/v1/audits/payroll-punch -H "Content-Type: application/json" -d '{ "employeeId": "EMP-9041", "employeeName": "Rahul Sharma", "actualHoursWorked": 8.5, "overtimeHoursBilled": 0.5, "hourlyBaseRateINR": 180, "distanceKm": 30, "travelMinutes": 10 }'

8. Evaluate SaaS Shadow License & Deprovisioning (W35 - SAAS_OPS):

curl -X POST https://www.getkeplerops.com/v1/audits/saas-license -H "Content-Type: application/json" -d '{ "seatId": "SEAT-GH-8801", "appName": "GitHub Enterprise", "userEmail": "vikas.nair@examplecorp.com", "employeeStatus": "DEPARTED", "monthlyCostUSD": 21.0, "daysSinceLastActivity": 60 }'

9. Evaluate Cloud FinOps Infrastructure Waste (W36 - CLOUD_FINOPS):

curl -X POST https://www.getkeplerops.com/v1/audits/cloud-finops -H "Content-Type: application/json" -d '{ "resourceId": "vol-0a88192bf881023c1", "provider": "AWS", "resourceType": "EBS_VOLUME", "resourceName": "prod-kafka-data-old-disk", "state": "AVAILABLE_UNATTACHED", "monthlyCostUSD": 40.0, "daysDetachedOrIdle": 28 }'

10. Evaluate CI/CD Pipeline Spend & Stuck Runners (W37 - DEVOPS_OPS):

curl -X POST https://www.getkeplerops.com/v1/audits/devops-ci -H "Content-Type: application/json" -d '{ "runId": "RUN-GH-8901", "repoName": "backend-core-monorepo", "workflowName": "End-to-End Integration Matrix", "runnerTier": "LINUX_X86_16CORE", "minuteRateUSD": 0.032, "durationMinutes": 120, "status": "TIMED_OUT" }'

11. Evaluate Customer Support VIP SLA Breaches (W38 - CUSTOMER_SUPPORT_OPS):

curl -X POST https://www.getkeplerops.com/v1/audits/support-sla -H "Content-Type: application/json" -d '{ "ticketId": "TICK-ZD-9901", "customerName": "Global Cloud Systems", "customerTier": "ENTERPRISE", "customerLtvUSD": 35000.0, "priority": "URGENT", "firstResponseWaitingHours": 6.5, "targetSlaHours": 2.0 }'

12. Evaluate Integration Webhooks & Automation Health (W39 - AUTOMATION_OPS):

curl -X POST https://www.getkeplerops.com/v1/audits/automation-webhook -H "Content-Type: application/json" -d '{ "executionId": "EXEC-MK-10291", "platform": "MAKE_COM", "workflowName": "Stripe Closed-Won to HubSpot Deal", "sourceSystem": "Stripe", "destinationSystem": "HubSpot", "status": "AUTH_ERROR", "httpStatusCode": 401, "payloadValueUSD": 8400.0 }'

13. Evaluate Security & Compliance Hygiene (W40 - SECURITY_COMPLIANCE_OPS):

curl -X POST https://www.getkeplerops.com/v1/audits/security-compliance -H "Content-Type: application/json" -d '{ "resourceId": "SEC-KEY-9910", "resourceType": "API_KEY", "resourceName": "Razorpay Live Payment Webhook Secret", "provider": "RAZORPAY", "environment": "PRODUCTION", "daysToExpiration": 3 }'

14. Evaluate Data Platform & Kafka Streaming Lag (W41 - DATA_PLATFORM_OPS):

curl -X POST https://www.getkeplerops.com/v1/audits/data-platform -H "Content-Type: application/json" -d '{ "pipelineId": "PIPE-KFK-0921", "pipelineName": "Orders Stream to Realtime Fraud Scorer", "pipelineType": "EVENT_STREAM", "sourceSystem": "Apache Kafka", "destinationSystem": "Fraud Scoring Service", "consumerLagMessages": 84200 }'

15. Evaluate Mobile App Store Health & Crashlytics (W42 - APP_STORE_OPS):

curl -X POST https://www.getkeplerops.com/v1/audits/app-store -H "Content-Type: application/json" -d '{ "appId": "com.quickmart.consumer", "appName": "QuickMart 10-Min Grocery", "platform": "IOS", "appVersion": "v4.8.2", "dailyActiveUsers": 500000, "crashRatePercent": 3.4 }'

16. Evaluate Fintech AML & Transaction Risk (W43 - FINTECH_RISK_OPS):

curl -X POST https://www.getkeplerops.com/v1/audits/fintech-risk -H "Content-Type: application/json" -d '{ "accountId": "ACC-KYC-8821", "accountHolderMasked": "A****t K****r", "kycTier": "TIER_1_MIN_KYC", "monthlyVolumeINR": 380000, "inflowAmountINR": 50000 }'

17. Evaluate Vendor Contracts & Spend Governance (W44 - PROCUREMENT_OPS):

curl -X POST https://www.getkeplerops.com/v1/audits/procurement-contracts -H "Content-Type: application/json" -d '{ "contractId": "CTR-DD-8812", "vendorName": "Datadog Enterprise APM", "annualContractValueUSD": 72000.0, "autoRenewEnabled": true, "daysUntilNoticeDeadline": 6 }'

18. Evaluate Growth AdTech & Paid Campaigns (W45 - GROWTH_ADTECH_OPS):

curl -X POST https://www.getkeplerops.com/v1/audits/growth-adtech -H "Content-Type: application/json" -d '{ "campaignId": "CMP-GGL-8812", "campaignName": "US Search - High Intent Enterprise ERP", "platform": "GOOGLE_ADS", "dailySpendUSD": 1200.0, "hourlyClicks": 140, "hourlyConversions": 0, "baselineConversionRatePercent": 3.8, "landingPageHttpStatus": 404 }'

19. Evaluate Healthcare Encounters & Billing Claims (W46 - HEALTHCARE_OPS):

curl -X POST https://www.getkeplerops.com/v1/audits/healthcare -H "Content-Type: application/json" -d '{ "encounterId": "ENC-EHR-8812", "providerName": "Dr. Sarah Jenkins, MD - Cardiology", "patientMaskedId": "PT-9941 (M****e L****s)", "hasOverlappingBooking": true, "claimAmountUSD": 350.0 }'

20. Evaluate Telecom Leased Lines & SIM Fleet (W47 - TELECOM_OPS):

curl -X POST https://www.getkeplerops.com/v1/audits/telecom -H "Content-Type: application/json" -d '{ "assetId": "CKT-LMN-8812", "assetName": "Austin Branch Primary DIA 1Gbps", "assetType": "DEDICATED_CIRCUIT", "carrierName": "Lumen Technologies", "monthlyBilledMrcUSD": 1850.0, "inventoryStatus": "DECOMMISSIONED" }'

21. Evaluate Commercial Real Estate & Facilities (W48 - PROPTECH_FACILITIES_OPS):

curl -X POST https://www.getkeplerops.com/v1/audits/proptech -H "Content-Type: application/json" -d '{ "propertyId": "PROP-SEA-8812", "propertyName": "Seattle Regional HQ - Floor 14", "monthlyBaseRentUSD": 45000.0, "daysUntilExpiration": 12, "hasExecutedExtension": false }'

22. Evaluate EdTech LMS Student Cohorts & Certifications (W49 - EDTECH_OPS):

curl -X POST https://www.getkeplerops.com/v1/audits/edtech -H "Content-Type: application/json" -d '{ "enrollmentId": "ENR-ED-8812", "studentMaskedId": "STU-9921 (R****t S****h)", "courseName": "Full-Stack Cloud Engineering Bootcamp", "tuitionPaidUSD": 2400.0, "hasLmsAccess": false }'

23. Evaluate Law Firm Matters & Trust Accounts (W50 - LEGALTECH_OPS):

curl -X POST https://www.getkeplerops.com/v1/audits/legaltech -H "Content-Type: application/json" -d '{ "matterId": "MAT-PI-8812", "matterName": "Johnson v. Pacific Intermodal Logistics", "practiceArea": "PERSONAL_INJURY", "clientMaskedName": "A****o J*****n", "responsibleAttorney": "Marcus Sterling, Esq.", "hasFiledComplaint": false, "daysUntilSolDeadline": 8, "matterValueUSD": 450000.0 }'

24. Evaluate Entertainment, Media Rights & Live Ticketing (W51 - ENTERTAINMENT_OPS):

curl -X POST https://www.getkeplerops.com/v1/audits/entertainment -H "Content-Type: application/json" -d '{ "assetId": "EVT-TIX-8812", "titleOrEventName": "Neon Horizon World Tour - LA Arena", "category": "LIVE_EVENT", "distributorOrPlatform": "Ticketmaster / AXS", "commercialValueUSD": 750.0, "hasDoubleSeatAllocation": true }'

25. Evaluate Automotive Telematics & EV Charging (W52 - MOBILITY_FLEET_OPS):

curl -X POST https://www.getkeplerops.com/v1/audits/mobility -H "Content-Type: application/json" -d '{ "assetId": "CHG-DCFC-902", "assetNameOrVin": "Stall-DCFC-02 (Westfield EV Superhub)", "assetType": "EV_CHARGER", "operatorOrFleetName": "VoltCharge Networks LLC", "assetValueUSD": 75000.0, "offlineDurationHours": 8.5 }'

🔑 API Access Tiers: Free Public Sandbox vs Paid Store License

Kepler provides a clear, zero-confusion separation between free developer prototyping and full commercial unmasking:

⚡ Free Public Sandbox ($0)

Available to all developers and merchants worldwide with zero API keys:

Single-record diagnostic testing on https://www.getkeplerops.com/playground
Atomic POST probe evaluation on all 60+ REST endpoints & 103 MCP Tools (/v1/audits/*)
Drag & drop CSV diagnostic loss calculation on /audit with top sample leaks
Zero-PII ephemeral memory scanning with zero data persistence

👑 Paid Store License ($49 Lifetime)

Unlocks full commercial profit recovery and automation pipelines:

100% Unmasked 500+ Row CSV Exception Ledger (unlocks all masked rows)
Pre-Written Carrier Dispute Claim Letters (Delhivery, Shiprocket, BlueDart, FedEx) — part of this paid license; a free single-parcel template is at /templates/courier-weight-dispute-letter
Executive PDF Loss Reports with charts for leadership and account managers
24/7 Automated Webhook Receivers (X-Audit-Key / X-API-Key authorization)
Instant license delivery via Gumroad ($49 Lifetime Store Pass)

Passing License Keys in Programmatic Requests

To access unmasked outputs and bulk reconciliation via API, pass your Gumroad License Key in the HTTP headers:

curl -X POST https://www.getkeplerops.com/v1/audits/csv-scan -H "X-Audit-Key: YOUR_GUMROAD_LICENSE_KEY" -H "Content-Type: text/csv" --data-binary @shopify_orders_2026.csv

🤖 Model Context Protocol (MCP) Server Suite (80 Flagship Tools)

Kepler provides a full native Model Context Protocol (MCP) server that empowers AI assistants like Claude Desktop, Cursor, Copilot, and ChatGPT to execute deterministic operational audits directly inside your IDE or AI workspace.

📦 Standard MCP JSON Configuration (Add to claude_desktop_config.json or .cursor/mcp.json):

{ "mcpServers": { "kepler-ops": { "command": "npx", "args": ["-y", "@kepler-ops/mcp-server"], "env": { "KEPLER_API_KEY": "YOUR_GUMROAD_OR_ENTERPRISE_KEY" } } } }

Key MCP Audit Tools Included:

audit_fba_reimbursements: Audits Amazon FBA inbound short-receipts, overdue customer returns (>45d), and FC damaged inventory.
audit_eway_bills: Audits active truck transit GPS timestamps vs statutory validity hours to prevent Section 129 GST penalties.
audit_zone_dispatches: Audits multi-node warehouse allocations to eliminate National Zone E freight surcharges and generate STN manifests.
audit_promo_exploits: Traps unreturned promotional free gifts on partial order cancellations.
audit_split_shipments: Detects multi-location split fulfillment margin erosion and orphan low-value boxes.
audit_weight_discrepancies: Traps carrier deadweight vs volumetric weight overcharges.

Need Custom Setup or Pilot Assistance?

If you need assistance configuring custom webhooks, ERP connectors, or private cloud deployment:

Message Pritesh on LinkedIn →Email Engineering Support →