Integration Guide

Trigger Gingetsu Orbit bills, receipts, & reports via Email + WhatsApp

✨ PDF & Multi-Channel Engine: Set "channel": "BOTH" (or "EMAIL" / "WHATSAPP") on /api/v1/send, or call /api/v1/pdf to download the rendered PDF directly.

1. Gingetsu Commercial Invoice

Gingetsu Technical Invoice (Email + WhatsApp)
curl -X POST http://localhost:3000/api/v1/send \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "type": "gingetsu_invoice",
    "channel": "BOTH",
    "clientId": "client_id_here",
    "payloadData": { 
      "email": "customer@example.com",
      "phone": "+628123456789",
      "clientName": "ACME Corp",
      "clientContact": "John Doe",
      "bankName": "Bank Central Asia (BCA)",
      "bankAccount": "8720-xxxx-xxxx",
      "items": [
        {
          "name": "[ MODULE 1 ] Cloud Setup",
          "desc": "Initial server provisioning and VPC setup.",
          "qty": "1.0",
          "price": "Rp 10.000.000",
          "amount": "Rp 10.000.000"
        }
      ],
      "subtotal": "Rp 10.000.000",
      "taxAmount": "Rp 1.100.000",
      "totalAmount": "Rp 11.100.000"
    }
  }'

2. Gingetsu Commercial Receipt

Gingetsu Technical Receipt (Email + WhatsApp)
curl -X POST http://localhost:3000/api/v1/send \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "type": "gingetsu_receipt",
    "channel": "BOTH",
    "clientId": "client_id_here",
    "payloadData": { 
      "email": "customer@example.com",
      "phone": "+628123456789",
      "clientName": "ACME Corp",
      "clientContact": "John Doe",
      "receiptNo": "RCPT-2607-042",
      "issueDate": "July 19, 2026",
      "paidDate": "July 20, 2026",
      "items": [
        {
          "name": "[ MODULE 1 ] Cloud Setup",
          "desc": "Initial server provisioning",
          "qty": "1.0",
          "price": "Rp 10.000.000",
          "amount": "Rp 10.000.000"
        }
      ],
      "subtotal": "Rp 10.000.000",
      "totalPaid": "Rp 10.000.000"
    }
  }'

3. Automated POS Reports

Cafe/Resto Revenue Report
curl -X POST http://localhost:3000/api/v1/send \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "type": "resto_report",
    "clientId": "client_id_here",
    "payloadData": { 
      "email": "manager@store.com",
      "storeName": "Gingetsu Cafe HQ",
      "period": "July 2026",
      "metrics": {
        "grossSales": "Rp 20.600.000",
        "netSales": "Rp 20.600.000",
        "netProfit": "Rp 15.400.000",
        "totalOrders": 2850,
        "itemsSold": 4200,
        "avgOrderValue": "Rp 7.228"
      },
      "topProducts": [
        { "name": "AIR PUTIH", "sold": 450, "percentage": 100 }
      ],
      "peakHour": "19:00 (450 orders)"
    }
  }'