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.

🛡️ 100% Zero-PII & Read-Only Observer Guarantee

Kepler is engineered with strict DPDP and GDPR compliance. Customer names, emails, and phone numbers are processed client-side in local browser memory. 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 in-browser 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.

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 }'

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 →