API reference

Billing

Tagihan, pembayaran, deposit, paket, dan master tarif kasir; hanya baca (modul cashier).

OpenAPI 3.1 · version 1.1.0 · 127 operations · 30 webhook events

Download YAML Download JSON Getting started

Base URLhttps://api.medivana.cloud/api/v1

Endpoint descriptions come from the OpenAPI specification and are written in Indonesian.

GET/billing/invoices

Daftar tagihan pasien

Cabang aktif, terbaru dulu. Status: draft → finalized → partially_paid → paid, atau void. Item daftar tanpa lines, discounts, payments.

Scopes: invoices:read
RBAC permissions: cashier.bill · cashier.close · cashier.pay · cashier.void · invoice.read
Module: cashier

Parameters

Parameters GET /billing/invoices
Name	In	Type	Description
X-Branch-ID	header	string (uuid)	Cabang aktif (opsional). Nilai di luar cabang klien diabaikan.
patient_id	query	string (uuid)
encounter_id	query	string (uuid)
payer_id	query	string (uuid)
status	query	string	Dipisah koma
from	query	string (date)
to	query	string (date)
limit	query	integer
cursor	query	string	Nilai `next_cursor` dari halaman sebelumnya

Code examples

curlJavaScriptPython

curl -X GET "https://api.medivana.cloud/api/v1/billing/invoices" \
  -H "Authorization: Bearer $MEDIVANA_TOKEN"

const res = await fetch("https://api.medivana.cloud/api/v1/billing/invoices", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.MEDIVANA_TOKEN}`,
  },
});
if (!res.ok) throw new Error(`HTTP ${res.status}: ${await res.text()}`);
const data = await res.json();

import os
import requests

resp = requests.get(
    "https://api.medivana.cloud/api/v1/billing/invoices",
    headers={"Authorization": f"Bearer {os.environ['MEDIVANA_TOKEN']}"},
    timeout=30,
)
resp.raise_for_status()
data = resp.json()

Responses

200Tagihanapplication/json

{
  "items": [
    {
      "id": "3f0c2a10-5b7e-4c1d-9a2e-00000001b001",
      "branch_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000000b1",
      "patient_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000a0001",
      "patient_name": "Pasien Contoh",
      "patient_mrn": "RM-000123",
      "encounter_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000e0001",
      "payer_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000f0001",
      "payer_name": "Pasien Umum",
      "payer_kind": "umum",
      "number": "INV-202610-00042",
      "status": "paid",
      "subtotal": 195000,
      "discount": 0,
      "total": 195000,
      "patient_amount": 195000,
      "payer_amount": 0,
      "paid_amount": 195000,
      "outstanding": 0,
      "payer_outstanding": 0,
      "finalized_at": "2026-10-29T11:02:00+07:00",
      "paid_at": "2026-10-29T11:03:10+07:00",
      "created_at": "2026-10-29T10:58:00+07:00",
      "version": 3
    }
  ]
}

Schema 200

Schema 200
Name	Type	Description
itemsrequired	array<object>
items[].id	string (uuid)
items[].branch_id	string (uuid)
items[].patient_id	string (uuid)
items[].patient_name	string
items[].patient_mrn	string
items[].encounter_id	string (uuid) \| null
items[].payer_id	string (uuid)
items[].payer_name	string
items[].payer_kind	umum \| bpjs \| insurance \| company
items[].number	string \| null
items[].status	draft \| finalized \| partially_paid \| paid \| void
items[].subtotal	number
items[].discount	number
items[].total	number
items[].patient_amount	number
items[].payer_amount	number
items[].package_amount	number
items[].paid_amount	number
items[].credit_patient_amount	number
items[].credit_payer_amount	number
items[].payer_paid_amount	number
items[].payer_adjusted_amount	number
items[].outstanding	number
items[].payer_outstanding	number
items[].notes	string \| null
items[].finalized_at	string (date-time) \| null
items[].paid_at	string (date-time) \| null
items[].voided_at	string (date-time) \| null
items[].void_reason	string \| null
items[].created_at	string (date-time)
items[].version	integer
items[].lines	array<object>
items[].lines[].id	string (uuid)
items[].lines[].line_no	integer
items[].lines[].charge_id	string (uuid) \| null
items[].lines[].service_id	string (uuid) \| null
items[].lines[].item_id	string (uuid) \| null
items[].lines[].practitioner_id	string (uuid) \| null
items[].lines[].revenue_key	string
items[].lines[].category	string
items[].lines[].description	string
items[].lines[].quantity	number
items[].lines[].unit_price	number
items[].lines[].gross	number
items[].lines[].discount	number
items[].lines[].total	number
items[].lines[].payer_share	number
items[].lines[].patient_share	number
items[].lines[].coverage	payer \| excluded \| none \| package
items[].discounts	array<object>
items[].payments	array<object>
items[].payments[].id	string (uuid)
items[].payments[].branch_id	string (uuid)
items[].payments[].invoice_id	string (uuid)
items[].payments[].patient_id	string (uuid)
items[].payments[].number	string
items[].payments[].method	cash \| debit \| credit \| qris \| transfer \| deposit
items[].payments[].amount	number
items[].payments[].tendered	number \| null
items[].payments[].change_amount	number
items[].payments[].reference	string \| null
items[].payments[].status	pending \| completed \| refunded \| expired \| failed
items[].payments[].paid_at	string (date-time) \| null
items[].payments[].cash_session_id	string (uuid) \| null
items[].payments[].gateway_provider	string \| null
items[].payments[].external_id	string \| null
items[].payments[].settlement_id	string (uuid) \| null
items[].payments[].refunded_at	string (date-time) \| null
items[].payments[].refund_reason	string \| null
items[].payments[].created_at	string (date-time)
next_cursor	string

Errors

401unauthorizedToken tidak ada, tidak valid, kedaluwarsa, atau dicabut
402module-lockedModul tidak aktif di paket organisasi
403forbiddenScope token tidak memberi izin (forbidden), atau langganan klinik baca-saja untuk operasi tulis (read-only)
429rate-limitedBatas laju klien (rate_limit_per_min) terlampaui; coba lagi pada menit berikutnya

GET/billing/invoices/{id}

Detail tagihan dengan baris, diskon, dan pembayaran

outstanding = sisa bagian pasien; payer_outstanding = sisa piutang penjamin. coverage baris: payer, excluded, none, package.

Scopes: invoices:read
RBAC permissions: cashier.bill · cashier.close · cashier.pay · cashier.void · invoice.read
Module: cashier

Parameters

Parameters GET /billing/invoices/{id}
Name	In	Type	Description
idrequired	path	string (uuid)

Code examples

curlJavaScriptPython

curl -X GET "https://api.medivana.cloud/api/v1/billing/invoices/3f0c2a10-5b7e-4c1d-9a2e-000000000001" \
  -H "Authorization: Bearer $MEDIVANA_TOKEN"

const res = await fetch("https://api.medivana.cloud/api/v1/billing/invoices/3f0c2a10-5b7e-4c1d-9a2e-000000000001", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.MEDIVANA_TOKEN}`,
  },
});
if (!res.ok) throw new Error(`HTTP ${res.status}: ${await res.text()}`);
const data = await res.json();

import os
import requests

resp = requests.get(
    "https://api.medivana.cloud/api/v1/billing/invoices/3f0c2a10-5b7e-4c1d-9a2e-000000000001",
    headers={"Authorization": f"Bearer {os.environ['MEDIVANA_TOKEN']}"},
    timeout=30,
)
resp.raise_for_status()
data = resp.json()

Responses

200Tagihanapplication/json

{
  "id": "3f0c2a10-5b7e-4c1d-9a2e-00000001b001",
  "branch_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000000b1",
  "patient_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000a0001",
  "patient_name": "Pasien Contoh",
  "patient_mrn": "RM-000123",
  "encounter_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000e0001",
  "payer_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000f0001",
  "payer_name": "Pasien Umum",
  "payer_kind": "umum",
  "number": "INV-202610-00042",
  "status": "paid",
  "subtotal": 195000,
  "discount": 0,
  "total": 195000,
  "patient_amount": 195000,
  "payer_amount": 0,
  "package_amount": 0,
  "paid_amount": 195000,
  "outstanding": 0,
  "payer_outstanding": 0,
  "finalized_at": "2026-10-29T11:02:00+07:00",
  "paid_at": "2026-10-29T11:03:10+07:00",
  "created_at": "2026-10-29T10:58:00+07:00",
  "version": 3,
  "lines": [
    {
      "id": "3f0c2a10-5b7e-4c1d-9a2e-00000001b011",
      "line_no": 1,
      "charge_id": "3f0c2a10-5b7e-4c1d-9a2e-000000009001",
      "service_id": "3f0c2a10-5b7e-4c1d-9a2e-00000001f002",
      "item_id": null,
      "revenue_key": "rev_consultation",
      "category": "konsultasi",
      "description": "Konsultasi dokter umum",
      "quantity": 1,
      "unit_price": 50000,
      "gross": 50000,
      "discount": 0,
      "total": 50000,
      "payer_share": 0,
      "patient_share": 50000,
      "coverage": "none"
    },
    {
      "id": "3f0c2a10-5b7e-4c1d-9a2e-00000001b012",
      "line_no": 2,
      "charge_id": "3f0c2a10-5b7e-4c1d-9a2e-000000009002",
      "service_id": null,
      "item_id": "3f0c2a10-5b7e-4c1d-9a2e-000000001701",
      "revenue_key": "rev_drug",
      "category": "obat",
      "description": "Amoksisilin 500 mg",
      "quantity": 15,
      "unit_price": 3000,
      "gross": 45000,
      "discount": 0,
      "total": 45000,
      "payer_share": 0,
      "patient_share": 45000,
      "coverage": "none"
    }
  ],
  "discounts": [],
  "payments": [
    {
      "id": "3f0c2a10-5b7e-4c1d-9a2e-00000001b101",
      "number": "PAY-202610-00003",
      "method": "qris",
      "amount": 195000,
      "status": "completed",
      "paid_at": "2026-10-29T11:03:10+07:00"
    }
  ]
}

Schema 200

Schema 200
Name	Type	Description
id	string (uuid)
branch_id	string (uuid)
patient_id	string (uuid)
patient_name	string
patient_mrn	string
encounter_id	string (uuid) \| null
payer_id	string (uuid)
payer_name	string
payer_kind	umum \| bpjs \| insurance \| company
number	string \| null
status	draft \| finalized \| partially_paid \| paid \| void
subtotal	number
discount	number
total	number
patient_amount	number
payer_amount	number
package_amount	number
paid_amount	number
credit_patient_amount	number
credit_payer_amount	number
payer_paid_amount	number
payer_adjusted_amount	number
outstanding	number
payer_outstanding	number
notes	string \| null
finalized_at	string (date-time) \| null
paid_at	string (date-time) \| null
voided_at	string (date-time) \| null
void_reason	string \| null
created_at	string (date-time)
version	integer
lines	array<object>
lines[].id	string (uuid)
lines[].line_no	integer
lines[].charge_id	string (uuid) \| null
lines[].service_id	string (uuid) \| null
lines[].item_id	string (uuid) \| null
lines[].practitioner_id	string (uuid) \| null
lines[].revenue_key	string
lines[].category	string
lines[].description	string
lines[].quantity	number
lines[].unit_price	number
lines[].gross	number
lines[].discount	number
lines[].total	number
lines[].payer_share	number
lines[].patient_share	number
lines[].coverage	payer \| excluded \| none \| package
discounts	array<object>
payments	array<object>
payments[].id	string (uuid)
payments[].branch_id	string (uuid)
payments[].invoice_id	string (uuid)
payments[].patient_id	string (uuid)
payments[].number	string
payments[].method	cash \| debit \| credit \| qris \| transfer \| deposit
payments[].amount	number
payments[].tendered	number \| null
payments[].change_amount	number
payments[].reference	string \| null
payments[].status	pending \| completed \| refunded \| expired \| failed
payments[].paid_at	string (date-time) \| null
payments[].cash_session_id	string (uuid) \| null
payments[].gateway_provider	string \| null
payments[].external_id	string \| null
payments[].settlement_id	string (uuid) \| null
payments[].refunded_at	string (date-time) \| null
payments[].refund_reason	string \| null
payments[].created_at	string (date-time)

Errors

401unauthorizedToken tidak ada, tidak valid, kedaluwarsa, atau dicabut
402module-lockedModul tidak aktif di paket organisasi
403forbiddenScope token tidak memberi izin (forbidden), atau langganan klinik baca-saja untuk operasi tulis (read-only)
404not-foundData tidak ada, milik organisasi lain, atau di luar cakupan cabang klien
429rate-limitedBatas laju klien (rate_limit_per_min) terlampaui; coba lagi pada menit berikutnya

GET/billing/invoices/{id}/receipt

Kuitansi tagihan (HTML siap cetak)

Thermal 58/80 mm atau A5. Bahasa dari lang, lalu preferensi pasien, lalu default organisasi.

Scopes: invoices:read
RBAC permissions: cashier.bill · cashier.close · cashier.pay · cashier.void · invoice.read
Module: cashier

Parameters

Parameters GET /billing/invoices/{id}/receipt
Name	In	Type	Description
idrequired	path	string (uuid)
format	query	58 \| 80 \| a5
lang	query	id \| en	Bahasa dokumen cetak; default bahasa pasien lalu default organisasi.

Code examples

curlJavaScriptPython

curl -X GET "https://api.medivana.cloud/api/v1/billing/invoices/3f0c2a10-5b7e-4c1d-9a2e-000000000001/receipt" \
  -H "Authorization: Bearer $MEDIVANA_TOKEN"

const res = await fetch("https://api.medivana.cloud/api/v1/billing/invoices/3f0c2a10-5b7e-4c1d-9a2e-000000000001/receipt", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.MEDIVANA_TOKEN}`,
  },
});
if (!res.ok) throw new Error(`HTTP ${res.status}: ${await res.text()}`);
const html = await res.text();

import os
import requests

resp = requests.get(
    "https://api.medivana.cloud/api/v1/billing/invoices/3f0c2a10-5b7e-4c1d-9a2e-000000000001/receipt",
    headers={"Authorization": f"Bearer {os.environ['MEDIVANA_TOKEN']}"},
    timeout=30,
)
resp.raise_for_status()
html = resp.text

Responses

200Dokumen HTMLtext/html

Errors

401unauthorizedToken tidak ada, tidak valid, kedaluwarsa, atau dicabut
402module-lockedModul tidak aktif di paket organisasi
403forbiddenScope token tidak memberi izin (forbidden), atau langganan klinik baca-saja untuk operasi tulis (read-only)
404not-foundData tidak ada, milik organisasi lain, atau di luar cakupan cabang klien
429rate-limitedBatas laju klien (rate_limit_per_min) terlampaui; coba lagi pada menit berikutnya

GET/billing/payments

Daftar pembayaran

Status: pending, completed, refunded, expired, failed. unsettled=true = pembayaran non-tunai yang belum cair ke bank.

Scopes: invoices:read
RBAC permissions: cashier.bill · cashier.close · cashier.pay · cashier.void · invoice.read
Module: cashier

Parameters

Parameters GET /billing/payments
Name	In	Type	Description
X-Branch-ID	header	string (uuid)	Cabang aktif (opsional). Nilai di luar cabang klien diabaikan.
invoice_id	query	string (uuid)
date	query	string (date)
method	query	string	Dipisah koma: cash, debit, credit, qris, transfer, deposit
unsettled	query	boolean

Code examples

curlJavaScriptPython

curl -X GET "https://api.medivana.cloud/api/v1/billing/payments" \
  -H "Authorization: Bearer $MEDIVANA_TOKEN"

const res = await fetch("https://api.medivana.cloud/api/v1/billing/payments", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.MEDIVANA_TOKEN}`,
  },
});
if (!res.ok) throw new Error(`HTTP ${res.status}: ${await res.text()}`);
const data = await res.json();

import os
import requests

resp = requests.get(
    "https://api.medivana.cloud/api/v1/billing/payments",
    headers={"Authorization": f"Bearer {os.environ['MEDIVANA_TOKEN']}"},
    timeout=30,
)
resp.raise_for_status()
data = resp.json()

Responses

200Pembayaranapplication/json

{
  "items": [
    {
      "id": "3f0c2a10-5b7e-4c1d-9a2e-00000001b101",
      "branch_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000000b1",
      "invoice_id": "3f0c2a10-5b7e-4c1d-9a2e-00000001b001",
      "patient_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000a0001",
      "number": "PAY-202610-00003",
      "method": "qris",
      "amount": 195000,
      "tendered": null,
      "change_amount": 0,
      "reference": null,
      "status": "completed",
      "paid_at": "2026-10-29T11:03:10+07:00",
      "cash_session_id": null,
      "gateway_provider": null,
      "external_id": null,
      "settlement_id": null,
      "refunded_at": null,
      "refund_reason": null,
      "created_at": "2026-10-29T11:03:00+07:00"
    }
  ]
}

Schema 200

Schema 200
Name	Type	Description
itemsrequired	array<object>
items[].id	string (uuid)
items[].branch_id	string (uuid)
items[].invoice_id	string (uuid)
items[].patient_id	string (uuid)
items[].number	string
items[].method	cash \| debit \| credit \| qris \| transfer \| deposit
items[].amount	number
items[].tendered	number \| null
items[].change_amount	number
items[].reference	string \| null
items[].status	pending \| completed \| refunded \| expired \| failed
items[].paid_at	string (date-time) \| null
items[].cash_session_id	string (uuid) \| null
items[].gateway_provider	string \| null
items[].external_id	string \| null
items[].settlement_id	string (uuid) \| null
items[].refunded_at	string (date-time) \| null
items[].refund_reason	string \| null
items[].created_at	string (date-time)

Errors

401unauthorizedToken tidak ada, tidak valid, kedaluwarsa, atau dicabut
402module-lockedModul tidak aktif di paket organisasi
403forbiddenScope token tidak memberi izin (forbidden), atau langganan klinik baca-saja untuk operasi tulis (read-only)
429rate-limitedBatas laju klien (rate_limit_per_min) terlampaui; coba lagi pada menit berikutnya

GET/billing/payments/{id}

Detail pembayaran

Scopes: invoices:read
RBAC permissions: cashier.bill · cashier.close · cashier.pay · cashier.void · invoice.read
Module: cashier

Parameters

Parameters GET /billing/payments/{id}
Name	In	Type	Description
idrequired	path	string (uuid)

Code examples

curlJavaScriptPython

curl -X GET "https://api.medivana.cloud/api/v1/billing/payments/3f0c2a10-5b7e-4c1d-9a2e-000000000001" \
  -H "Authorization: Bearer $MEDIVANA_TOKEN"

const res = await fetch("https://api.medivana.cloud/api/v1/billing/payments/3f0c2a10-5b7e-4c1d-9a2e-000000000001", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.MEDIVANA_TOKEN}`,
  },
});
if (!res.ok) throw new Error(`HTTP ${res.status}: ${await res.text()}`);
const data = await res.json();

import os
import requests

resp = requests.get(
    "https://api.medivana.cloud/api/v1/billing/payments/3f0c2a10-5b7e-4c1d-9a2e-000000000001",
    headers={"Authorization": f"Bearer {os.environ['MEDIVANA_TOKEN']}"},
    timeout=30,
)
resp.raise_for_status()
data = resp.json()

Responses

200Pembayaranapplication/json

{
  "id": "3f0c2a10-5b7e-4c1d-9a2e-000000000001",
  "branch_id": "3f0c2a10-5b7e-4c1d-9a2e-000000000001",
  "invoice_id": "3f0c2a10-5b7e-4c1d-9a2e-000000000001",
  "patient_id": "3f0c2a10-5b7e-4c1d-9a2e-000000000001",
  "number": "string",
  "method": "cash",
  "amount": 0,
  "tendered": 0,
  "change_amount": 0,
  "reference": "string",
  "status": "pending",
  "paid_at": "2026-11-02T08:00:00+07:00",
  "cash_session_id": "3f0c2a10-5b7e-4c1d-9a2e-000000000001",
  "gateway_provider": "string",
  "external_id": "string",
  "settlement_id": "3f0c2a10-5b7e-4c1d-9a2e-000000000001",
  "refunded_at": "2026-11-02T08:00:00+07:00",
  "refund_reason": "string",
  "created_at": "2026-11-02T08:00:00+07:00"
}

Schema 200

Schema 200
Name	Type	Description
id	string (uuid)
branch_id	string (uuid)
invoice_id	string (uuid)
patient_id	string (uuid)
number	string
method	cash \| debit \| credit \| qris \| transfer \| deposit
amount	number
tendered	number \| null
change_amount	number
reference	string \| null
status	pending \| completed \| refunded \| expired \| failed
paid_at	string (date-time) \| null
cash_session_id	string (uuid) \| null
gateway_provider	string \| null
external_id	string \| null
settlement_id	string (uuid) \| null
refunded_at	string (date-time) \| null
refund_reason	string \| null
created_at	string (date-time)

Errors

401unauthorizedToken tidak ada, tidak valid, kedaluwarsa, atau dicabut
402module-lockedModul tidak aktif di paket organisasi
403forbiddenScope token tidak memberi izin (forbidden), atau langganan klinik baca-saja untuk operasi tulis (read-only)
404not-foundData tidak ada, milik organisasi lain, atau di luar cakupan cabang klien
429rate-limitedBatas laju klien (rate_limit_per_min) terlampaui; coba lagi pada menit berikutnya

GET/billing/charges

Charge layanan dan barang pasien

Charge dibuat modul klinis (pendaftaran, tindakan, obat, penunjang) lalu ditagihkan kasir. Status pending, billed, cancelled.

Scopes: invoices:read
RBAC permissions: cashier.bill · cashier.close · cashier.pay · cashier.void · invoice.read
Module: cashier

Parameters

Parameters GET /billing/charges
Name	In	Type	Description
X-Branch-ID	header	string (uuid)	Cabang aktif (opsional). Nilai di luar cabang klien diabaikan.
patient_id	query	string (uuid)
encounter_id	query	string (uuid)
status	query	pending \| billed \| cancelled

Code examples

curlJavaScriptPython

curl -X GET "https://api.medivana.cloud/api/v1/billing/charges" \
  -H "Authorization: Bearer $MEDIVANA_TOKEN"

const res = await fetch("https://api.medivana.cloud/api/v1/billing/charges", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.MEDIVANA_TOKEN}`,
  },
});
if (!res.ok) throw new Error(`HTTP ${res.status}: ${await res.text()}`);
const data = await res.json();

import os
import requests

resp = requests.get(
    "https://api.medivana.cloud/api/v1/billing/charges",
    headers={"Authorization": f"Bearer {os.environ['MEDIVANA_TOKEN']}"},
    timeout=30,
)
resp.raise_for_status()
data = resp.json()

Responses

200Chargeapplication/json

{
  "items": [
    {
      "id": "3f0c2a10-5b7e-4c1d-9a2e-000000009001",
      "patient_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000a0001",
      "encounter_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000e0001",
      "source_type": "encounter",
      "source_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000e0001",
      "service_id": "3f0c2a10-5b7e-4c1d-9a2e-00000001f002",
      "item_id": null,
      "description": "Konsultasi dokter umum",
      "quantity": 1,
      "unit_price": null,
      "revenue_key": "rev_consultation",
      "practitioner_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000d0001",
      "status": "pending",
      "invoice_id": null,
      "created_at": "2026-10-29T10:45:00+07:00"
    }
  ]
}

Schema 200

Schema 200
Name	Type	Description
itemsrequired	array<object>
items[].id	string (uuid)
items[].patient_id	string (uuid)
items[].encounter_id	string (uuid) \| null
items[].source_type	string
items[].source_id	string
items[].service_id	string (uuid) \| null
items[].item_id	string (uuid) \| null
items[].description	string
items[].quantity	number
items[].unit_price	number \| null	null = harga dari daftar tarif saat ditagih
items[].revenue_key	string
items[].practitioner_id	string (uuid) \| null
items[].status	pending \| billed \| cancelled
items[].invoice_id	string (uuid) \| null
items[].created_at	string (date-time)

Errors

401unauthorizedToken tidak ada, tidak valid, kedaluwarsa, atau dicabut
402module-lockedModul tidak aktif di paket organisasi
403forbiddenScope token tidak memberi izin (forbidden), atau langganan klinik baca-saja untuk operasi tulis (read-only)
429rate-limitedBatas laju klien (rate_limit_per_min) terlampaui; coba lagi pada menit berikutnya

GET/billing/deposits

Saldo dan mutasi deposit pasien

Scopes: invoices:read
RBAC permissions: cashier.bill · cashier.close · cashier.pay · cashier.void · invoice.read
Module: cashier

Parameters

Parameters GET /billing/deposits
Name	In	Type	Description
patient_idrequired	query	string (uuid)

Code examples

curlJavaScriptPython

curl -X GET "https://api.medivana.cloud/api/v1/billing/deposits?patient_id=3f0c2a10-5b7e-4c1d-9a2e-000000000001" \
  -H "Authorization: Bearer $MEDIVANA_TOKEN"

const res = await fetch("https://api.medivana.cloud/api/v1/billing/deposits?patient_id=3f0c2a10-5b7e-4c1d-9a2e-000000000001", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.MEDIVANA_TOKEN}`,
  },
});
if (!res.ok) throw new Error(`HTTP ${res.status}: ${await res.text()}`);
const data = await res.json();

import os
import requests

resp = requests.get(
    "https://api.medivana.cloud/api/v1/billing/deposits?patient_id=3f0c2a10-5b7e-4c1d-9a2e-000000000001",
    headers={"Authorization": f"Bearer {os.environ['MEDIVANA_TOKEN']}"},
    timeout=30,
)
resp.raise_for_status()
data = resp.json()

Responses

200Depositapplication/json

{
  "patient_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000a0001",
  "balance": 300000,
  "items": [
    {
      "id": "3f0c2a10-5b7e-4c1d-9a2e-00000001b201",
      "number": "DEP-202610-00007",
      "kind": "topup",
      "amount": 500000,
      "balance_after": 500000,
      "method": "transfer",
      "invoice_id": null,
      "payment_id": null,
      "reference": "TRF-0001",
      "notes": null,
      "created_at": "2026-10-20T09:00:00+07:00"
    }
  ]
}

Schema 200

Schema 200
Name	Type	Description
patient_id	string (uuid)
balance	number
items	array<object>
items[].id	string (uuid)
items[].number	string
items[].kind	topup \| usage \| refund \| credit \| usage_reversal
items[].amount	number	Positif masuk, negatif keluar
items[].balance_after	number
items[].method	string \| null
items[].invoice_id	string (uuid) \| null
items[].payment_id	string (uuid) \| null
items[].reference	string \| null
items[].notes	string \| null
items[].created_at	string (date-time)

Errors

401unauthorizedToken tidak ada, tidak valid, kedaluwarsa, atau dicabut
402module-lockedModul tidak aktif di paket organisasi
403forbiddenScope token tidak memberi izin (forbidden), atau langganan klinik baca-saja untuk operasi tulis (read-only)
422validationValidasi gagal; rincian per field di errors
429rate-limitedBatas laju klien (rate_limit_per_min) terlampaui; coba lagi pada menit berikutnya

GET/billing/packages

Paket prabayar yang dijual klinik

Scopes: invoices:read
RBAC permissions: cashier.bill · cashier.close · cashier.pay · cashier.void · invoice.read
Module: cashier

Code examples

curlJavaScriptPython

curl -X GET "https://api.medivana.cloud/api/v1/billing/packages" \
  -H "Authorization: Bearer $MEDIVANA_TOKEN"

const res = await fetch("https://api.medivana.cloud/api/v1/billing/packages", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.MEDIVANA_TOKEN}`,
  },
});
if (!res.ok) throw new Error(`HTTP ${res.status}: ${await res.text()}`);
const data = await res.json();

import os
import requests

resp = requests.get(
    "https://api.medivana.cloud/api/v1/billing/packages",
    headers={"Authorization": f"Bearer {os.environ['MEDIVANA_TOKEN']}"},
    timeout=30,
)
resp.raise_for_status()
data = resp.json()

Responses

200Paketapplication/json

{
  "items": [
    {
      "id": "3f0c2a10-5b7e-4c1d-9a2e-00000001b301",
      "code": "PKT-FISIO-8",
      "name": "Paket Fisioterapi 8 Sesi",
      "description": null,
      "service_ids": [
        "3f0c2a10-5b7e-4c1d-9a2e-00000001f003"
      ],
      "sessions": 8,
      "price": 1000000,
      "valid_days": 180,
      "is_active": true
    }
  ]
}

Schema 200

Schema 200
Name	Type	Description
itemsrequired	array<object>
items[].id	string (uuid)
items[].code	string
items[].name	string
items[].description	string \| null
items[].service_ids	array<string (uuid)>
items[].sessions	integer
items[].price	number
items[].valid_days	integer \| null
items[].is_active	boolean

Errors

401unauthorizedToken tidak ada, tidak valid, kedaluwarsa, atau dicabut
402module-lockedModul tidak aktif di paket organisasi
403forbiddenScope token tidak memberi izin (forbidden), atau langganan klinik baca-saja untuk operasi tulis (read-only)
429rate-limitedBatas laju klien (rate_limit_per_min) terlampaui; coba lagi pada menit berikutnya

GET/billing/patient-packages

Paket prabayar milik pasien

Scopes: invoices:read
RBAC permissions: cashier.bill · cashier.close · cashier.pay · cashier.void · invoice.read
Module: cashier

Parameters

Parameters GET /billing/patient-packages
Name	In	Type	Description
patient_id	query	string (uuid)
status	query	active \| used \| expired \| void

Code examples

curlJavaScriptPython

curl -X GET "https://api.medivana.cloud/api/v1/billing/patient-packages" \
  -H "Authorization: Bearer $MEDIVANA_TOKEN"

const res = await fetch("https://api.medivana.cloud/api/v1/billing/patient-packages", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.MEDIVANA_TOKEN}`,
  },
});
if (!res.ok) throw new Error(`HTTP ${res.status}: ${await res.text()}`);
const data = await res.json();

import os
import requests

resp = requests.get(
    "https://api.medivana.cloud/api/v1/billing/patient-packages",
    headers={"Authorization": f"Bearer {os.environ['MEDIVANA_TOKEN']}"},
    timeout=30,
)
resp.raise_for_status()
data = resp.json()

Responses

200Paket pasienapplication/json

{
  "items": [
    {
      "id": "3f0c2a10-5b7e-4c1d-9a2e-00000001b401",
      "branch_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000000b1",
      "patient_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000a0001",
      "package_id": "3f0c2a10-5b7e-4c1d-9a2e-00000001b301",
      "package_name": "Paket Fisioterapi 8 Sesi",
      "number": "PKG-202610-00002",
      "service_ids": [
        "3f0c2a10-5b7e-4c1d-9a2e-00000001f003"
      ],
      "sessions_total": 8,
      "sessions_used": 2,
      "price": 1000000,
      "remaining_value": 750000,
      "payment_methods": [
        "transfer"
      ],
      "status": "active",
      "sold_at": "2026-10-01T10:00:00+07:00",
      "expires_at": "2027-03-30T23:59:59+07:00"
    }
  ]
}

Schema 200

Schema 200
Name	Type	Description
itemsrequired	array<object>
items[].id	string (uuid)
items[].branch_id	string (uuid)
items[].patient_id	string (uuid)
items[].package_id	string (uuid)
items[].package_name	string
items[].number	string
items[].service_ids	array<string (uuid)>
items[].sessions_total	integer
items[].sessions_used	integer
items[].price	number
items[].remaining_value	number
items[].payment_methods	array<string>
items[].status	string
items[].sold_at	string (date-time)
items[].expires_at	string (date-time) \| null

Errors

401unauthorizedToken tidak ada, tidak valid, kedaluwarsa, atau dicabut
402module-lockedModul tidak aktif di paket organisasi
403forbiddenScope token tidak memberi izin (forbidden), atau langganan klinik baca-saja untuk operasi tulis (read-only)
429rate-limitedBatas laju klien (rate_limit_per_min) terlampaui; coba lagi pada menit berikutnya

GET/billing/services

Master layanan dan tarif dasar

Scopes: invoices:read
RBAC permissions: cashier.bill · cashier.close · cashier.pay · cashier.void · invoice.read
Module: cashier

Parameters

Parameters GET /billing/services
Name	In	Type	Description
q	query	string
category	query	string (9 nilai)

Code examples

curlJavaScriptPython

curl -X GET "https://api.medivana.cloud/api/v1/billing/services" \
  -H "Authorization: Bearer $MEDIVANA_TOKEN"

const res = await fetch("https://api.medivana.cloud/api/v1/billing/services", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.MEDIVANA_TOKEN}`,
  },
});
if (!res.ok) throw new Error(`HTTP ${res.status}: ${await res.text()}`);
const data = await res.json();

import os
import requests

resp = requests.get(
    "https://api.medivana.cloud/api/v1/billing/services",
    headers={"Authorization": f"Bearer {os.environ['MEDIVANA_TOKEN']}"},
    timeout=30,
)
resp.raise_for_status()
data = resp.json()

Responses

200Layananapplication/json

{
  "items": [
    {
      "id": "3f0c2a10-5b7e-4c1d-9a2e-00000001f002",
      "code": "KONS-UMUM",
      "name": "Konsultasi dokter umum",
      "category": "konsultasi",
      "revenue_key": "rev_consultation",
      "base_price": 50000,
      "icd9cm_code": null,
      "loinc_code": null,
      "specialty": "umum",
      "fee_eligible": true,
      "is_active": true,
      "version": 1
    }
  ]
}

Schema 200

Schema 200
Name	Type	Description
itemsrequired	array<object>
items[].id	string (uuid)
items[].code	string
items[].name	string
items[].category	string
items[].revenue_key	string
items[].base_price	number
items[].icd9cm_code	string \| null
items[].loinc_code	string \| null
items[].specialty	string \| null
items[].fee_eligible	boolean
items[].is_active	boolean
items[].version	integer

Errors

401unauthorizedToken tidak ada, tidak valid, kedaluwarsa, atau dicabut
402module-lockedModul tidak aktif di paket organisasi
403forbiddenScope token tidak memberi izin (forbidden), atau langganan klinik baca-saja untuk operasi tulis (read-only)
429rate-limitedBatas laju klien (rate_limit_per_min) terlampaui; coba lagi pada menit berikutnya

GET/billing/payers

Penjamin dan aturan tanggungan

coverage_bp = porsi ditanggung (basis poin, 10000 = 100%); max_per_invoice = plafon per tagihan; excluded_categories = kategori yang ditanggung pasien.

Scopes: invoices:read
RBAC permissions: cashier.bill · cashier.close · cashier.pay · cashier.void · invoice.read
Module: cashier

Code examples

curlJavaScriptPython

curl -X GET "https://api.medivana.cloud/api/v1/billing/payers" \
  -H "Authorization: Bearer $MEDIVANA_TOKEN"

const res = await fetch("https://api.medivana.cloud/api/v1/billing/payers", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.MEDIVANA_TOKEN}`,
  },
});
if (!res.ok) throw new Error(`HTTP ${res.status}: ${await res.text()}`);
const data = await res.json();

import os
import requests

resp = requests.get(
    "https://api.medivana.cloud/api/v1/billing/payers",
    headers={"Authorization": f"Bearer {os.environ['MEDIVANA_TOKEN']}"},
    timeout=30,
)
resp.raise_for_status()
data = resp.json()

Responses

200Penjaminapplication/json

{
  "items": [
    {
      "id": "3f0c2a10-5b7e-4c1d-9a2e-0000000f0003",
      "code": "ASR1",
      "name": "Asuransi Contoh",
      "kind": "insurance",
      "payment_terms_days": 30,
      "coverage_bp": 8000,
      "max_per_invoice": 300000,
      "excluded_categories": [
        "retail",
        "treatment"
      ],
      "is_active": true,
      "version": 1
    }
  ]
}

Schema 200

Schema 200
Name	Type	Description
itemsrequired	array<object>
items[].id	string (uuid)
items[].code	string
items[].name	string
items[].kind	umum \| bpjs \| insurance \| company
items[].payment_terms_days	integer \| null
items[].coverage_bp	integer
items[].max_per_invoice	number \| null
items[].excluded_categories	array<string>
items[].is_active	boolean
items[].version	integer

Errors

401unauthorizedToken tidak ada, tidak valid, kedaluwarsa, atau dicabut
402module-lockedModul tidak aktif di paket organisasi
403forbiddenScope token tidak memberi izin (forbidden), atau langganan klinik baca-saja untuk operasi tulis (read-only)
429rate-limitedBatas laju klien (rate_limit_per_min) terlampaui; coba lagi pada menit berikutnya

GET/billing/price-lists

Daftar tarif per penjamin

Scopes: invoices:read
RBAC permissions: cashier.bill · cashier.close · cashier.pay · cashier.void · invoice.read
Module: cashier

Code examples

curlJavaScriptPython

curl -X GET "https://api.medivana.cloud/api/v1/billing/price-lists" \
  -H "Authorization: Bearer $MEDIVANA_TOKEN"

const res = await fetch("https://api.medivana.cloud/api/v1/billing/price-lists", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.MEDIVANA_TOKEN}`,
  },
});
if (!res.ok) throw new Error(`HTTP ${res.status}: ${await res.text()}`);
const data = await res.json();

import os
import requests

resp = requests.get(
    "https://api.medivana.cloud/api/v1/billing/price-lists",
    headers={"Authorization": f"Bearer {os.environ['MEDIVANA_TOKEN']}"},
    timeout=30,
)
resp.raise_for_status()
data = resp.json()

Responses

200Daftar tarifapplication/json

{
  "items": [
    {
      "id": "3f0c2a10-5b7e-4c1d-9a2e-00000001b501",
      "code": "UMUM",
      "name": "Tarif Umum",
      "payer_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000f0001",
      "branch_id": null,
      "valid_from": null,
      "valid_to": null,
      "is_active": true
    }
  ]
}

Schema 200

Schema 200
Name	Type	Description
itemsrequired	array<object>
items[].id	string (uuid)
items[].code	string
items[].name	string
items[].payer_id	string (uuid)
items[].branch_id	string (uuid) \| null
items[].valid_from	string (date) \| null
items[].valid_to	string (date) \| null
items[].is_active	boolean

Errors

401unauthorizedToken tidak ada, tidak valid, kedaluwarsa, atau dicabut
402module-lockedModul tidak aktif di paket organisasi
403forbiddenScope token tidak memberi izin (forbidden), atau langganan klinik baca-saja untuk operasi tulis (read-only)
429rate-limitedBatas laju klien (rate_limit_per_min) terlampaui; coba lagi pada menit berikutnya

GET/billing/price-lists/{id}/items

Harga dalam satu daftar tarif

Scopes: invoices:read
RBAC permissions: cashier.bill · cashier.close · cashier.pay · cashier.void · invoice.read
Module: cashier

Parameters

Parameters GET /billing/price-lists/{id}/items
Name	In	Type	Description
idrequired	path	string (uuid)

Code examples

curlJavaScriptPython

curl -X GET "https://api.medivana.cloud/api/v1/billing/price-lists/3f0c2a10-5b7e-4c1d-9a2e-000000000001/items" \
  -H "Authorization: Bearer $MEDIVANA_TOKEN"

const res = await fetch("https://api.medivana.cloud/api/v1/billing/price-lists/3f0c2a10-5b7e-4c1d-9a2e-000000000001/items", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.MEDIVANA_TOKEN}`,
  },
});
if (!res.ok) throw new Error(`HTTP ${res.status}: ${await res.text()}`);
const data = await res.json();

import os
import requests

resp = requests.get(
    "https://api.medivana.cloud/api/v1/billing/price-lists/3f0c2a10-5b7e-4c1d-9a2e-000000000001/items",
    headers={"Authorization": f"Bearer {os.environ['MEDIVANA_TOKEN']}"},
    timeout=30,
)
resp.raise_for_status()
data = resp.json()

Responses

200Hargaapplication/json

{
  "items": [
    {
      "service_id": "3f0c2a10-5b7e-4c1d-9a2e-00000001f002",
      "item_id": null,
      "code": "KONS-UMUM",
      "name": "Konsultasi dokter umum",
      "price": 60000,
      "base_price": 50000
    }
  ]
}

Schema 200

Schema 200
Name	Type	Description
itemsrequired	array<object>
items[].service_id	string (uuid) \| null
items[].item_id	string (uuid) \| null
items[].code	string
items[].name	string
items[].price	number
items[].base_price	number

Errors

401unauthorizedToken tidak ada, tidak valid, kedaluwarsa, atau dicabut
402module-lockedModul tidak aktif di paket organisasi
403forbiddenScope token tidak memberi izin (forbidden), atau langganan klinik baca-saja untuk operasi tulis (read-only)
404not-foundData tidak ada, milik organisasi lain, atau di luar cakupan cabang klien
429rate-limitedBatas laju klien (rate_limit_per_min) terlampaui; coba lagi pada menit berikutnya

GET/billing/prices/resolve

Harga efektif layanan/barang untuk penjamin

Urutan: daftar tarif penjamin cabang → penjamin semua cabang → tarif default cabang → semua cabang → harga dasar.

Scopes: invoices:read
RBAC permissions: cashier.bill · cashier.close · cashier.pay · cashier.void · invoice.read
Module: cashier

Parameters

Parameters GET /billing/prices/resolve
Name	In	Type	Description
X-Branch-ID	header	string (uuid)	Cabang aktif (opsional). Nilai di luar cabang klien diabaikan.
payer_id	query	string (uuid)
service_id	query	string (uuid)
item_id	query	string (uuid)

Code examples

curlJavaScriptPython

curl -X GET "https://api.medivana.cloud/api/v1/billing/prices/resolve" \
  -H "Authorization: Bearer $MEDIVANA_TOKEN"

const res = await fetch("https://api.medivana.cloud/api/v1/billing/prices/resolve", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.MEDIVANA_TOKEN}`,
  },
});
if (!res.ok) throw new Error(`HTTP ${res.status}: ${await res.text()}`);
const data = await res.json();

import os
import requests

resp = requests.get(
    "https://api.medivana.cloud/api/v1/billing/prices/resolve",
    headers={"Authorization": f"Bearer {os.environ['MEDIVANA_TOKEN']}"},
    timeout=30,
)
resp.raise_for_status()
data = resp.json()

Responses

200Hargaapplication/json

{
  "price": 45000,
  "source": "price_list:ASR1",
  "payer_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000f0003"
}

Schema 200

Schema 200
Name	Type	Description
price	number
source	string	`price_list:<kode>`, `base_price`, atau `sale_price`
payer_id	string (uuid) \| null

Errors

401unauthorizedToken tidak ada, tidak valid, kedaluwarsa, atau dicabut
402module-lockedModul tidak aktif di paket organisasi
403forbiddenScope token tidak memberi izin (forbidden), atau langganan klinik baca-saja untuk operasi tulis (read-only)
404not-foundData tidak ada, milik organisasi lain, atau di luar cakupan cabang klien
422validationValidasi gagal; rincian per field di errors
429rate-limitedBatas laju klien (rate_limit_per_min) terlampaui; coba lagi pada menit berikutnya

GET/billing/settings

Pengaturan kasir (PPN, persetujuan diskon)

Scopes: invoices:read
RBAC permissions: cashier.bill · cashier.close · cashier.pay · cashier.void · invoice.read
Module: cashier

Code examples

curlJavaScriptPython

curl -X GET "https://api.medivana.cloud/api/v1/billing/settings" \
  -H "Authorization: Bearer $MEDIVANA_TOKEN"

const res = await fetch("https://api.medivana.cloud/api/v1/billing/settings", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.MEDIVANA_TOKEN}`,
  },
});
if (!res.ok) throw new Error(`HTTP ${res.status}: ${await res.text()}`);
const data = await res.json();

import os
import requests

resp = requests.get(
    "https://api.medivana.cloud/api/v1/billing/settings",
    headers={"Authorization": f"Bearer {os.environ['MEDIVANA_TOKEN']}"},
    timeout=30,
)
resp.raise_for_status()
data = resp.json()

Responses

200Pengaturanapplication/json

{
  "is_pkp": false,
  "ppn_rate_bp": 1100,
  "discount_approval_bp": 1000,
  "discount_approval_amount": 100000,
  "require_cash_session": true,
  "receipt_footer": "Semoga lekas sembuh",
  "version": 1
}

Schema 200

Schema 200
Name	Type	Description
is_pkp	boolean
ppn_rate_bp	integer
discount_approval_bp	integer
discount_approval_amount	number
require_cash_session	boolean
receipt_footer	string \| null
version	integer

Errors

401unauthorizedToken tidak ada, tidak valid, kedaluwarsa, atau dicabut
402module-lockedModul tidak aktif di paket organisasi
403forbiddenScope token tidak memberi izin (forbidden), atau langganan klinik baca-saja untuk operasi tulis (read-only)
429rate-limitedBatas laju klien (rate_limit_per_min) terlampaui; coba lagi pada menit berikutnya

GET/billing/cash-sessions

Sesi kas kasir

Scopes: invoices:read
RBAC permissions: cashier.bill · cashier.close · cashier.pay · cashier.void · invoice.read
Module: cashier

Parameters

Parameters GET /billing/cash-sessions
Name	In	Type	Description
X-Branch-ID	header	string (uuid)	Cabang aktif (opsional). Nilai di luar cabang klien diabaikan.
date	query	string (date)
status	query	open \| closed

Code examples

curlJavaScriptPython

curl -X GET "https://api.medivana.cloud/api/v1/billing/cash-sessions" \
  -H "Authorization: Bearer $MEDIVANA_TOKEN"

const res = await fetch("https://api.medivana.cloud/api/v1/billing/cash-sessions", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.MEDIVANA_TOKEN}`,
  },
});
if (!res.ok) throw new Error(`HTTP ${res.status}: ${await res.text()}`);
const data = await res.json();

import os
import requests

resp = requests.get(
    "https://api.medivana.cloud/api/v1/billing/cash-sessions",
    headers={"Authorization": f"Bearer {os.environ['MEDIVANA_TOKEN']}"},
    timeout=30,
)
resp.raise_for_status()
data = resp.json()

Responses

200Sesi kasapplication/json

{
  "items": [
    {
      "id": "3f0c2a10-5b7e-4c1d-9a2e-00000001b601",
      "branch_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000000b1",
      "user_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000d2001",
      "user_name": "Kasir Contoh",
      "number": "KAS-202610-00001",
      "status": "closed",
      "opened_at": "2026-10-29T07:30:00+07:00",
      "opening_float": 200000,
      "cash_in": 100000,
      "cash_out": 0,
      "expected_cash": 300000,
      "closed_at": "2026-10-29T16:00:00+07:00",
      "counted_cash": 299000,
      "difference": -1000,
      "notes": null,
      "version": 2
    }
  ]
}

Schema 200

Schema 200
Name	Type	Description
itemsrequired	array<object>
items[].id	string (uuid)
items[].branch_id	string (uuid)
items[].user_id	string (uuid)
items[].user_name	string
items[].number	string
items[].status	open \| closed
items[].opened_at	string (date-time)
items[].opening_float	number
items[].cash_in	number
items[].cash_out	number
items[].expected_cash	number
items[].closed_at	string (date-time) \| null
items[].counted_cash	number \| null
items[].difference	number \| null
items[].notes	string \| null
items[].version	integer

Errors

401unauthorizedToken tidak ada, tidak valid, kedaluwarsa, atau dicabut
402module-lockedModul tidak aktif di paket organisasi
403forbiddenScope token tidak memberi izin (forbidden), atau langganan klinik baca-saja untuk operasi tulis (read-only)
429rate-limitedBatas laju klien (rate_limit_per_min) terlampaui; coba lagi pada menit berikutnya

GET/billing/cash-sessions/current

Sesi kas terbuka milik pemanggil

Sesi kas dibuka per pengguna kasir. Identitas klien API tidak pernah membuka sesi kas, jadi untuk token API endpoint ini selalu 404; gunakan GET /billing/cash-sessions?status=open.

Scopes: invoices:read
RBAC permissions: cashier.bill · cashier.close · cashier.pay · cashier.void · invoice.read
Module: cashier

Code examples

curlJavaScriptPython

curl -X GET "https://api.medivana.cloud/api/v1/billing/cash-sessions/current" \
  -H "Authorization: Bearer $MEDIVANA_TOKEN"

const res = await fetch("https://api.medivana.cloud/api/v1/billing/cash-sessions/current", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.MEDIVANA_TOKEN}`,
  },
});
if (!res.ok) throw new Error(`HTTP ${res.status}: ${await res.text()}`);
const data = await res.json();

import os
import requests

resp = requests.get(
    "https://api.medivana.cloud/api/v1/billing/cash-sessions/current",
    headers={"Authorization": f"Bearer {os.environ['MEDIVANA_TOKEN']}"},
    timeout=30,
)
resp.raise_for_status()
data = resp.json()

Responses

200Sesi kas terbukaapplication/json

{
  "id": "3f0c2a10-5b7e-4c1d-9a2e-000000000001",
  "branch_id": "3f0c2a10-5b7e-4c1d-9a2e-000000000001",
  "user_id": "3f0c2a10-5b7e-4c1d-9a2e-000000000001",
  "user_name": "string",
  "number": "string",
  "status": "open",
  "opened_at": "2026-11-02T08:00:00+07:00",
  "opening_float": 0,
  "cash_in": 0,
  "cash_out": 0,
  "expected_cash": 0,
  "closed_at": "2026-11-02T08:00:00+07:00",
  "counted_cash": 0,
  "difference": 0,
  "notes": "string",
  "version": 0
}

Schema 200

Schema 200
Name	Type	Description
id	string (uuid)
branch_id	string (uuid)
user_id	string (uuid)
user_name	string
number	string
status	open \| closed
opened_at	string (date-time)
opening_float	number
cash_in	number
cash_out	number
expected_cash	number
closed_at	string (date-time) \| null
counted_cash	number \| null
difference	number \| null
notes	string \| null
version	integer

Errors

401unauthorizedToken tidak ada, tidak valid, kedaluwarsa, atau dicabut
402module-lockedModul tidak aktif di paket organisasi
403forbiddenScope token tidak memberi izin (forbidden), atau langganan klinik baca-saja untuk operasi tulis (read-only)
404not-foundData tidak ada, milik organisasi lain, atau di luar cakupan cabang klien
429rate-limitedBatas laju klien (rate_limit_per_min) terlampaui; coba lagi pada menit berikutnya

GET/billing/settlements

Pencairan QRIS/kartu/gateway ke bank

Scopes: invoices:read
RBAC permissions: cashier.bill · cashier.close · cashier.pay · cashier.void · invoice.read
Module: cashier

Parameters

Parameters GET /billing/settlements
Name	In	Type	Description
X-Branch-ID	header	string (uuid)	Cabang aktif (opsional). Nilai di luar cabang klien diabaikan.

Code examples

curlJavaScriptPython

curl -X GET "https://api.medivana.cloud/api/v1/billing/settlements" \
  -H "Authorization: Bearer $MEDIVANA_TOKEN"

const res = await fetch("https://api.medivana.cloud/api/v1/billing/settlements", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.MEDIVANA_TOKEN}`,
  },
});
if (!res.ok) throw new Error(`HTTP ${res.status}: ${await res.text()}`);
const data = await res.json();

import os
import requests

resp = requests.get(
    "https://api.medivana.cloud/api/v1/billing/settlements",
    headers={"Authorization": f"Bearer {os.environ['MEDIVANA_TOKEN']}"},
    timeout=30,
)
resp.raise_for_status()
data = resp.json()

Responses

200Settlementapplication/json

{
  "items": [
    {
      "id": "3f0c2a10-5b7e-4c1d-9a2e-00000001b701",
      "branch_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000000b1",
      "number": "STL-202610-00004",
      "channel": "gateway",
      "gross": 1250000,
      "mdr": 8750,
      "net": 1241250,
      "settled_at": "2026-10-30",
      "reference": "SETTLEMENT-CONTOH-01",
      "created_at": "2026-10-30T08:00:00+07:00"
    }
  ]
}

Schema 200

Schema 200
Name	Type	Description
itemsrequired	array<object>
items[].id	string (uuid)
items[].branch_id	string (uuid)
items[].number	string
items[].channel	string
items[].gross	number
items[].mdr	number
items[].net	number
items[].settled_at	string (date)
items[].reference	string \| null
items[].created_at	string (date-time)

Errors

401unauthorizedToken tidak ada, tidak valid, kedaluwarsa, atau dicabut
402module-lockedModul tidak aktif di paket organisasi
403forbiddenScope token tidak memberi izin (forbidden), atau langganan klinik baca-saja untuk operasi tulis (read-only)
429rate-limitedBatas laju klien (rate_limit_per_min) terlampaui; coba lagi pada menit berikutnya

GET/billing/reports/ar-aging

Umur piutang pasien

Per pasien, umur dihitung sejak tagihan final.

Scopes: invoices:read
RBAC permissions: cashier.bill · cashier.close · cashier.pay · cashier.void · invoice.read
Module: cashier

Parameters

Parameters GET /billing/reports/ar-aging
Name	In	Type	Description
X-Branch-ID	header	string (uuid)	Cabang aktif (opsional). Nilai di luar cabang klien diabaikan.
as_of	query	string (date)	Default hari ini

Code examples

curlJavaScriptPython

curl -X GET "https://api.medivana.cloud/api/v1/billing/reports/ar-aging" \
  -H "Authorization: Bearer $MEDIVANA_TOKEN"

const res = await fetch("https://api.medivana.cloud/api/v1/billing/reports/ar-aging", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.MEDIVANA_TOKEN}`,
  },
});
if (!res.ok) throw new Error(`HTTP ${res.status}: ${await res.text()}`);
const data = await res.json();

import os
import requests

resp = requests.get(
    "https://api.medivana.cloud/api/v1/billing/reports/ar-aging",
    headers={"Authorization": f"Bearer {os.environ['MEDIVANA_TOKEN']}"},
    timeout=30,
)
resp.raise_for_status()
data = resp.json()

Responses

200Agingapplication/json

{
  "as_of": "2026-10-31",
  "items": [
    {
      "patient_id": "3f0c2a10-5b7e-4c1d-9a2e-0000000a0001",
      "patient_name": "Pasien Contoh",
      "patient_mrn": "RM-000123",
      "invoices": 1,
      "days_0_30": 45000,
      "days_31_60": 0,
      "days_61_90": 0,
      "days_over_90": 0,
      "total": 45000
    }
  ],
  "totals": {
    "days_0_30": 45000,
    "days_31_60": 0,
    "days_61_90": 0,
    "days_over_90": 0,
    "total": 45000
  }
}

Schema 200

Schema 200
Name	Type	Description
as_of	string (date)
items	array<object>
items[].patient_id	string (uuid)
items[].patient_name	string
items[].patient_mrn	string
items[].invoices	integer
items[].days_0_30	number
items[].days_31_60	number
items[].days_61_90	number
items[].days_over_90	number
items[].total	number
totals	object

Errors

401unauthorizedToken tidak ada, tidak valid, kedaluwarsa, atau dicabut
402module-lockedModul tidak aktif di paket organisasi
403forbiddenScope token tidak memberi izin (forbidden), atau langganan klinik baca-saja untuk operasi tulis (read-only)
429rate-limitedBatas laju klien (rate_limit_per_min) terlampaui; coba lagi pada menit berikutnya