API РЕСУРСЫ

Төлем және Қаржы

Шот-фактура, идемпотенттік инкассо, ағымдағы (cari) баланс, күн соңы салыстыруы және e-Fatura. Ақша numeric(14,2) арқылы сақталады; ағымдағы баланс туындатылады, қолмен жазылмайды.

Ерте Қатынау Барлық API

Ұштар

12 ұш

Бұл ресурсқа тиесілі ұштар. Әр ұш API кілті байланысты клиника дерегімен шектелген; жазу ұштары Idempotency-Key тақырыпшасын қолдайды.

POST /v1/invoices Шот-фактура жасайды admin · хатшы · дәрігер

GET /v1/invoices Шот-фактураларды тізімдейді admin

GET /v1/invoices/{id} Шот-фактура толығын алады Барлық өкілетті рөлдер

POST /v1/invoices/{id}/void Шот-фактураны жояды (кері жазба) admin

POST /v1/invoices/{id}/einvoice Шот-фактураны e-Fatura ретінде жібереді (GİB) admin

GET /v1/einvoices e-Fatura жазбаларын тізімдейді admin

POST /v1/payments Инкассо тіркейді (идемпотенттік) admin · хатшы · дәрігер

GET /v1/patients/{id}/balance Науқастың ағымдағы (cari) балансын алады Барлық өкілетті рөлдер

GET /v1/patients/{id}/ledger Науқастың ағымдағы (cari) қозғалыстарын тізімдейді Барлық өкілетті рөлдер

GET /v1/cash/day Күн соңы касса қорытындысын алады admin · хатшы

GET /v1/cari Ағымдағы (cari) баланстарды тізімдейді admin · хатшы

GET /v1/billing/summary Қаржы/инкассо қорытындысын алады admin · хатшы

Қолдану Мысалы

Инкассо тіркеу (идемпотенттік)

Сұраныс

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"}'

Жауап

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.

Бұл ресурстағы қауіпсіздік

Қауіпсіздік — мүмкіндік емес, сәулеттің өзі. Бұл ресурста қолданылатын кепілдіктер:

Идемпотенттік инкассо: Idempotency-Key + сервер құлпының арқасында желі қайталануында да бір төлем екі рет жазылмайды (қосарланған инкассо жоқ).

Ақша әрқашан numeric(14,2); клиенттен келген сомамен арифметика жасалмайды, дөңгелектеу серверде бір нүктеде.

Күшін жою/қайтару = кері жазба (void/refund); жол физикалық түрде жойылмайды. Ағымдағы (cari) баланс Σшот-фактура − Σтөлем түрінде туындатылады.

Көп-нысанды операция (шот-фактура + баб + төлем) бір transaction-да атомарлы: не бәрі, не ешқайсысы.

Бүкіл қауіпсіздік моделі →

Қате Форматы

Қателер тұрақты конвертпен қайтарылады; код машинаға, хабар қолданушыға арналған. Ішкі қате/стек ешқашан сызылмайды.

{
  "error": {
    "code": "validation_failed",
    "message": "Жарамсыз өріс: электрондық пошта"
  }
}

Басқа Ресурстар

Науқастар Қабылдау & Күнтізбе Одонтограмма & Емдеу Қор Бейнелеу Зертхана Lead & CRM Медициналық туризм Есеп беру & BI Webhooks Деректерді Тасымалдау (Export API)

Ерте қатынау қалайсыз ба?

API ашылғанда алдымен сіз хабардар болыңыз.

Байланысу