Docs/Calcifer.OrderMint
🛒
Business System

Calcifer.OrderMint

The social commerce management system that turns Facebook Messenger chaos into structured, trackable business operations — with invoicing, ledger management, and real-time reporting built in.

# Overview

OrderMint was born from a real problem: thousands of small businesses across South and Southeast Asia run their entire operations through Facebook Messenger — taking orders via chat, tracking payments manually, and losing data in the process.

OrderMint transforms that chaos into structure. It captures orders from social channels, generates invoices, maintains double-entry ledgers, tracks inventory, and generates reports — all from conversations that were previously just text on a screen.

💡 Why This Matters

For many small businesses, the jump from "selling on Facebook" to "running a real business" feels impossible. OrderMint bridges that gap — giving informal businesses formal tools without requiring them to change how they already work.

# Order Processing Pipeline

The order pipeline is the core workflow engine. It tracks every order from initial message through confirmation, fulfillment, and delivery — with status updates at every stage.

1

Message Received

A customer sends a message via Facebook Messenger, Instagram, or WhatsApp. The system detects order intent using keyword matching or AI parsing.

2

Order Created

The message is parsed into a structured order — product, quantity, customer info, delivery details. The operator confirms or adjusts.

3

Invoice Generated

An invoice is automatically generated with line items, tax calculations, and payment instructions. Sent back to the customer for confirmation.

4

Payment Tracked

Payment is recorded against the invoice. The ledger updates automatically. Multiple payment methods supported (bank transfer, mobile wallet, COD).

5

Fulfillment & Delivery

Order moves to fulfillment queue. Delivery status is tracked. Customer is notified at each stage through their original messaging channel.

# Integrations

OrderMint is designed to plug into the channels where your business already operates. No need to force customers onto a new platform — meet them where they are.

💬

Facebook Messenger

live

Direct integration with Facebook Page Messenger. Auto-detection of order messages, customer identification, and automated responses.

📸

Instagram DMs

live

Process orders from Instagram Direct Messages. Product image recognition and story-to-order conversion.

📱

WhatsApp Business

planned

WhatsApp Business API integration for markets where WhatsApp is the primary commerce channel.

🔗

Custom Webhooks

live

Connect OrderMint to any external system via webhooks. Trigger actions on order events, payment confirmations, and status changes.

# Reporting Engine

Real-time insights without manual spreadsheets. The reporting engine aggregates order data, revenue metrics, customer behavior, and fulfillment performance into actionable dashboards.

📈

Revenue Dashboard

Daily, weekly, and monthly revenue tracking with trend analysis. Compare periods, identify growth patterns, and forecast performance.

👥

Customer Analytics

Track repeat customers, average order value, customer lifetime value, and purchase frequency across all channels.

📦

Fulfillment Metrics

Monitor order-to-delivery time, fulfillment success rate, and bottleneck identification in your supply chain.

💰

Financial Ledger

Complete double-entry bookkeeping with receivables, payables, and real-time balance sheets. Audit-ready from day one.

# Invoice & Ledger System

Every order generates a structured invoice. Every payment updates the ledger. The double-entry bookkeeping system ensures your financial data is always accurate and audit-ready — even if you started with nothing but DMs.

Invoice Generation Flow
Order Confirmed
  → Invoice Generated (INV-2026-00142)
    → Line items populated from order details
    → Tax calculated based on region
    → PDF generated & stored
  → Payment Recorded
    → Ledger updated (debit: receivables, credit: revenue)
    → Balance recalculated
  → Receipt sent to customer via Messenger

# Webhook Configuration

OrderMint supports webhooks for key business events — allowing you to integrate with external systems, trigger notifications, or sync data with your existing tools.

POST /api/webhooks/configureEXAMPLE
{
  "url": "https://your-server.com/webhook",
  "events": [
    "order.created",
    "order.confirmed",
    "payment.received",
    "invoice.generated"
  ],
  "secret": "whsec_your_signing_secret",
  "active": true
}

Turn conversations into commerce.

OrderMint gives informal businesses formal tools — without changing how they already work.