Backend API berbasis Laravel 12 untuk kebutuhan integrasi SIMRS, BPJS, dan SATUSEHAT.

Project ini ditujukan sebagai fondasi yang bisa dipakai ulang oleh programmer Indonesia untuk membangun bridging layanan kesehatan yang rapi, konsisten, dan mudah dikembangkan.

Repositori ini tidak hanya ditujukan untuk kebutuhan satu implementasi internal, tetapi diarahkan menjadi:

• base project integrasi BPJS
• base project integrasi SATUSEHAT
• referensi arsitektur backend bridging untuk SIMRS
• starter kit pengembangan API layanan kesehatan di Indonesia

Saat ini project masih berfokus pada lapisan API backend, dengan ruang pengembangan untuk:

• integrasi BPJS VClaim
• integrasi BPJS Antrean/Antrol
• integrasi SATUSEHAT
• standardisasi format response
• dokumentasi implementasi integrasi
• fondasi modular untuk pertumbuhan project skala besar

• Integrasi BPJS VClaim
• Referensi master BPJS
• Monitoring kunjungan dan klaim BPJS
• Pengelolaan SEP
• Pengelolaan Surat Kontrol dan SPRI
• Endpoint dasar Antrol
• Generate dan cache token SATUSEHAT
• Kirim Encounter ke SATUSEHAT
• Format response API konsisten
• Dukungan environment terpisah untuk kredensial integrasi

• PHP 8.2
• Laravel 12
• Laravel Sanctum
• Spatie Laravel Permission
• Vite
• SQLite / MySQL

simrs-api/
├── app/
│   ├── Helpers/
│   ├── Http/Controllers/Api/
│   │   ├── Antrol/
│   │   ├── Bpjs/
│   │   └── SatuSehat/
│   ├── Models/
│   └── Services/
│       ├── Antrian/
│       ├── Bpjs/
│       └── SatuSehat/
├── config/
├── database/
├── docs/
├── routes/
├── tests/
├── .env.example
├── artisan
├── composer.json
└── package.json

Struktur ini masih mengikuti pola standar Laravel, sehingga mudah dipahami, tetapi juga sudah mulai dipisahkan berdasarkan domain integrasi.

Base URL lokal:

http://127.0.0.1:8000/api/v1

GET /api/v1

GET    /api/v1/bpjs/peserta
GET    /api/v1/bpjs/sep
GET    /api/v1/bpjs/sep-riwayat
POST   /api/v1/bpjs/sep
PUT    /api/v1/bpjs/sep
DELETE /api/v1/bpjs/sep

GET    /api/v1/bpjs/monitoring-kunjungan
GET    /api/v1/bpjs/monitoring-klaim

GET    /api/v1/bpjs/referensi/poli
GET    /api/v1/bpjs/referensi/diagnosa
GET    /api/v1/bpjs/referensi/faskes
GET    /api/v1/bpjs/referensi/dokter-dpjp
GET    /api/v1/bpjs/referensi/provinsi
GET    /api/v1/bpjs/referensi/kabupaten
GET    /api/v1/bpjs/referensi/kecamatan
GET    /api/v1/bpjs/referensi/prosedur

POST   /api/v1/bpjs/surat-kontrol/insert
POST   /api/v1/bpjs/surat-kontrol/update
POST   /api/v1/bpjs/spri/insert
POST   /api/v1/bpjs/spri/update

GET /api/v1/antrol/antrean

GET  /api/v1/satu-sehat/token
POST /api/v1/satu-sehat/encounter/send

Success response:

{
  "metaData": {
    "code": "200",
    "message": "Sukses"
  },
  "response": {}
}

Error response:

{
  "metaData": {
    "code": "400",
    "message": "Pesan error"
  },
  "response": {}
}

git clone https://github.com/ahmadfauzirahman99/simrs-api.git
cd simrs-api

git checkout pmaster

composer install

npm install

cp .env.example .env
php artisan key:generate

php artisan migrate

Mode cepat:

composer run dev

Mode manual:

php artisan serve
npm run dev

Contoh dasar:

APP_NAME="SIMRS API"
APP_ENV=local
APP_KEY=
APP_DEBUG=true
APP_URL=http://localhost

DB_CONNECTION=sqlite

BPJS_V3_API_VER=3
BPJS_V3_BASE_URL=https://apijkn-dev.bpjs-kesehatan.go.id/vclaim-rest
BPJS_V3_CONS_ID=your_cons_id
BPJS_V3_SECRET_KEY=your_secret_key
BPJS_V3_USER_KEY=your_user_key

SATUSEHAT_ENV=DEV

SATUSEHAT_AUTH_DEV=https://api-satusehat-dev.dto.kemkes.go.id/oauth2/v1
SATUSEHAT_FHIR_DEV=https://api-satusehat-dev.dto.kemkes.go.id/fhir-r4/v1
SATUSEHAT_CLIENTID_DEV=your_client_id_dev
SATUSEHAT_CLIENTSECRET_DEV=your_client_secret_dev
SATUSEHAT_ORGID_DEV=your_org_id_dev

SATUSEHAT_AUTH_PROD=https://api-satusehat.kemkes.go.id/oauth2/v1
SATUSEHAT_FHIR_PROD=https://api-satusehat.kemkes.go.id/fhir-r4/v1
SATUSEHAT_CLIENTID_PROD=your_client_id_prod
SATUSEHAT_CLIENTSECRET_PROD=your_client_secret_prod
SATUSEHAT_ORGID_PROD=your_org_id_prod

Project ini diarahkan untuk menjadi fondasi jangka panjang. Target pengembangan berikutnya:

• modularisasi domain BPJS, SATUSEHAT, dan shared components
• dokumentasi endpoint yang lebih lengkap dan mudah diikuti
• penguatan testing
• logging dan observability integrasi eksternal
• contoh implementasi alur bridging dari SIMRS/HIS
• penambahan resource FHIR lain selain Encounter

Blueprint arsitektur pengembangan tersedia di:

• docs/architecture-blueprint.md

• docs/api-documentation.md
• docs/satusehat.md
• docs/postman/000001 - SIMRS NEW API.postman_collection.json

README ini sekarang difokuskan sebagai pintu masuk project. Dokumentasi endpoint yang lebih detail akan lebih baik jika dipisah per domain agar repo tetap mudah dipelajari.

Ahmad Fauzi Rahman

Backend Developer
SIMRS Developer
Healthcare Technology Enthusiast

Project ini menggunakan lisensi MIT.

Selama copyright notice dan lisensi tetap disertakan, project ini bebas digunakan untuk:

• penggunaan pribadi
• penggunaan komersial
• modifikasi source code
• distribusi ulang
• integrasi dengan sistem lain