Step-by-step recipes

import express from "express";

const app = express();
app.use(express.json());

const API = "https://your-healthfix-site/api/v1";
const headers = {
  Authorization: "Bearer " + process.env.HEALTHFIX_API_KEY,
  "Content-Type": "application/json",
};

async function hf(path, init = {}) {
  const res = await fetch(API + path, { ...init, headers });
  const body = await res.json();
  if (!res.ok) throw Object.assign(new Error(body.error.message), { status: res.status });
  return body.data;
}

// The website form posts: { name, phone, gender, doctorId, startsAt }
// startsAt looks like "2026-10-01T10:30:00+05:30"
app.post("/book", async (req, res) => {
  const { name, phone, gender, doctorId, startsAt } = req.body;
  try {
    // 1. Returning patient? Search by phone.
    const matches = await hf("/patients?q=" + encodeURIComponent(phone) + "&limit=5");
    let patient = matches.find((p) => p.phone.endsWith(phone.slice(-10)));

    // 2. New patient: register them.
    if (!patient) {
      patient = await hf("/patients", {
        method: "POST",
        body: JSON.stringify({ full_name: name, gender, phone }),
      });
    }

    // 3. Book the appointment.
    const appt = await hf("/appointments", {
      method: "POST",
      body: JSON.stringify({
        patient_id: patient.id,
        doctor_id: doctorId,
        scheduled_at: startsAt,
        duration_min: 15,
        reason: "Booked on website",
      }),
    });
    res.json({ ok: true, appointmentId: appt.id });
  } catch (err) {
    if (err.status === 409) return res.status(409).json({ ok: false, message: "That time was just taken. Please pick another." });
    res.status(500).json({ ok: false, message: "Booking failed. Please call the clinic." });
  }
});

app.listen(3000);

function importToday() {
  const key = PropertiesService.getScriptProperties().getProperty("HEALTHFIX_API_KEY");
  const tz = "Asia/Kolkata"; // your clinic's time zone
  const day = Utilities.formatDate(new Date(), tz, "yyyy-MM-dd");
  const from = day + "T00:00:00+05:30";
  const to = Utilities.formatDate(new Date(Date.now() + 864e5), tz, "yyyy-MM-dd") + "T00:00:00+05:30";

  const url = "https://your-healthfix-site/api/v1/appointments?from=" + encodeURIComponent(from) + "&to=" + encodeURIComponent(to);
  const res = UrlFetchApp.fetch(url, { headers: { Authorization: "Bearer " + key }, muteHttpExceptions: true });
  const body = JSON.parse(res.getContentText());
  if (res.getResponseCode() !== 200) throw new Error(body.error.message);

  const rows = body.data.map((a) => [
    Utilities.formatDate(new Date(a.scheduled_at), tz, "HH:mm"),
    a.patient_name, a.patient_code, a.patient_phone, a.doctor_name, a.status, a.reason || "",
  ]);
  const sheet = SpreadsheetApp.getActiveSheet();
  sheet.clear();
  sheet.appendRow(["Time", "Patient", "ID", "Phone", "Doctor", "Status", "Reason"]);
  if (rows.length) sheet.getRange(2, 1, rows.length, rows[0].length).setValues(rows);
}

async function nextAppointmentReply(senderPhone) {
  const phone = senderPhone.replace(/\D/g, "").slice(-10);
  const [patient] = await hf("/patients?q=" + phone + "&limit=1");
  if (!patient || !patient.phone.endsWith(phone)) return "We couldn't find your record. Please call the clinic.";

  const visits = await hf(`/patients/${patient.id}/appointments`);
  const next = visits
    .filter((a) => new Date(a.scheduled_at) > new Date() && a.status !== "cancelled")
    .sort((a, b) => a.scheduled_at.localeCompare(b.scheduled_at))[0];
  if (!next) return `Hi ${patient.full_name}, you have no upcoming appointments.`;

  const when = new Date(next.scheduled_at).toLocaleString("en-IN", {
    timeZone: "Asia/Kolkata", weekday: "long", day: "numeric", month: "short", hour: "numeric", minute: "2-digit",
  });
  return `Hi ${patient.full_name}, your appointment with ${next.doctor_name} is on ${when}.`;
}
// hf() is the small helper from the website booking recipe above.

import os, datetime, requests

API = "https://your-healthfix-site/api/v1"
HEADERS = {"Authorization": "Bearer " + os.environ["HEALTHFIX_API_KEY"]}
today = datetime.date.today().isoformat()

summary = requests.get(f"{API}/billing/summary", params={"from": today, "to": today},
                       headers=HEADERS, timeout=30).json()["data"]

lines = [f"Collections for {today}: {summary['collected']:.0f}"]
lines += [f"  {m['method']}: {m['amount']:.0f} ({m['count']} payments)" for m in summary["by_method"]]
lines.append(f"Outstanding dues: {summary['outstanding']:.0f} across {summary['outstanding_count']} invoices")
print("\n".join(lines))  # send by email, Slack or push into your accounting tool