MAPAGKUKUNAN NG API

Koleksyon at Pananalapi

Invoice, idempotent na koleksyon, balanse ng account, end-of-day reconciliation at e-Fatura. Ang pera ay itinatago sa numeric(14,2); ang balanse ng account ay hinahango, hindi isinusulat nang manu-mano.

Maagang Access Buong API

Mga Endpoint

12 endpoint

Ang mga endpoint na nauukol sa mapagkukunang ito. Bawat endpoint ay limitado sa datos ng klinikang naka-ugnay sa API key; ang mga write endpoint ay sumusuporta sa Idempotency-Key header.

POST /v1/invoices Gumagawa ng invoice admin · sekretarya · doktor

GET /v1/invoices Inililista ang mga invoice admin

GET /v1/invoices/{id} Kinukuha ang detalye ng invoice Lahat ng awtorisadong role

POST /v1/invoices/{id}/void Kinakansela ang invoice (reverse entry) admin

POST /v1/invoices/{id}/einvoice Ipinapadala ang invoice bilang e-Fatura (GİB) admin

GET /v1/einvoices Inililista ang mga tala ng e-Fatura admin

POST /v1/payments Nagtatala ng koleksyon (idempotent) admin · sekretarya · doktor

GET /v1/patients/{id}/balance Kinukuha ang balanse ng account ng pasyente Lahat ng awtorisadong role

GET /v1/patients/{id}/ledger Inililista ang mga galaw ng account ng pasyente Lahat ng awtorisadong role

GET /v1/cash/day Kinukuha ang buod ng end-of-day na kaha admin · sekretarya

GET /v1/cari Inililista ang mga balanse ng account admin · sekretarya

GET /v1/billing/summary Kinukuha ang buod ng pananalapi/koleksyon admin · sekretarya

Halimbawang Paggamit

Magtala ng koleksyon (idempotent)

Request

curl -X POST https://api.udentiva.com/v1/payments \
  -H "Authorization: Bearer udk_live_xxx" \
  -H "Idempotency-Key: pay-7c3f..." \
  -H "Content-Type: application/json" \
  -d '{"patient_id":"c0ffee00-...","amount":"1500.00","method":"card"}'

Sagot

HTTP/1.1 201 Created
{
  "id": "pmt-9001",
  "amount": "1500.00",
  "method": "card",
  "created_at": "2026-06-24T09:15:00Z"
}

# Aynı Idempotency-Key ile tekrar → aynı kayıt döner, ikinci tahsilat OLUŞMAZ.

Seguridad sa mapagkukunang ito

Ang seguridad ay hindi isang feature, kundi ang arkitektura mismo. Ang mga garantiyang may bisa sa mapagkukunang ito:

Idempotent na koleksyon: salamat sa Idempotency-Key + server lock, kahit sa network retry ay hindi maitatala nang dalawang beses ang parehong bayad (walang double na koleksyon).

Ang pera ay palaging numeric(14,2); hindi ginagawa ang aritmetika sa halagang galing sa kliyente, ang pag-round ay iisang punto sa server.

Pagkansela/refund = reverse entry (void/refund); ang row ay hindi pisikal na binubura. Ang balanse ng account ay hinahango bilang Σinvoice − Σbayad.

Ang multi-entity na operasyon (invoice + item + bayad) ay atomiko sa iisang transaction: alinman sa lahat o wala.

Buong modelo ng seguridad →

Format ng Error

Ang mga error ay ibinabalik sa isang tugmang envelope; ang code ay para sa makina, ang mensahe ay para sa user. Ang panloob na error/stack ay hindi kailanman tumatagas.

{
  "error": {
    "code": "validation_failed",
    "message": "Di-wastong field: email"
  }
}

Iba pang Mapagkukunan

Mga Pasyente Pag-iiskedyul & Kalendaryo Odontogram & Paggamot Stock Imaging Laboratoryo Lead & CRM Health Tourism Pag-uulat & BI Webhooks Paglipat ng Datos (Export API)

Gusto ninyo ba ng maagang access?

Maging una kayong makaalam kapag bukas na ang API.

Makipag-ugnayan