README

Library Laravel untuk integrasi SATUSEHAT Kemenkes RI. Generate FHIR-ready JSON sesuai profil SATUSEHAT Documentation.

Mengapa Package Ini?

• Open-source (MIT license), gratis dipakai termasuk untuk komersial
• Mendukung 19 FHIR resource (Patient, Encounter, Bundle, dst)
• OAuth2 token caching otomatis via Laravel Cache
• Multi-tenant via Tenant trait
• KYC Centang Biru
• Sandbox mode dengan ID pasien dan nakes development
• Tested di Laravel 8 sampai 12

Quick Start

1. Install via Composer

composer require yudistira/satusehat-api

2. Publish Config dan Migration

php artisan vendor:publish --provider="Satusehat\Integration\SatusehatIntegrationServiceProvider"
php artisan migrate

3. Set Environment Variables

Daftarkan aplikasi Anda di portal SATUSEHAT menu Pengembang > Aplikasi, lalu tambahkan kredensial berikut ke file .env:

4. Contoh: Buat Resource Patient

use Satusehat\Integration\FHIR\Patient;

$patient = new Patient();
$patient->addIdentifier('nik', '3174012345678901');
$patient->setName('Budi Setiawan');
$patient->setGender('male');
$patient->setBirthDate('1990-01-15');

$json = $patient->json();

5. Contoh: Kirim Bundle Kunjungan (Encounter + Diagnosis)

use Satusehat\Integration\FHIR\Bundle;
use Satusehat\Integration\FHIR\Encounter;
use Satusehat\Integration\FHIR\Condition;

$encounter = new Encounter();
// ... isi data encounter

$diagnosis = new Condition();
// ... isi data diagnosis

$bundle = new Bundle();
$bundle->addEncounter($encounter);
$bundle->addCondition($diagnosis);

$response = $bundle->post();

Dokumentasi lengkap per resource ada di folder docs/.

FHIR Resources Tersedia (19)

Patient, Practitioner, Encounter, Condition, Observation, Procedure, Medication, MedicationRequest, MedicationDispense, AllergyIntolerance, ClinicalImpression, Composition, DiagnosticReport, ServiceRequest, Specimen, CarePlan, Location, Organization, Bundle

Persyaratan

• PHP 7.4 atau 8.0+
• Laravel 8 / 9 / 10 / 11 / 12
• Akun developer SATUSEHAT (daftar di sini)

Roadmap

• Dokumentasi lengkap per resource di /docs
• Contoh project Laravel end-to-end
• Test coverage untuk semua FHIR resource
• Migration helper dari format legacy

Need Help?

Package ini gratis dan open-source. Kalau Anda butuh:

• Custom integration SATUSEHAT untuk SaaS klinik atau RS
• Konsultasi compliance SATUSEHAT
• Bridging BPJS (VClaim, PCare, Antrean) - lihat bpjs-api

Email: yudistira.sd2@gmail.com

Contributing

Kontribusi welcome. Lihat CONTRIBUTING.md.

Bug report dan feature request via Issues.

Credits

• Original work: ivanwilliammd/satusehat-integration by Dr. dr. Ivan William Harsono, MTI
• Maintained dan updated for latest SATUSEHAT API by @yudistirasd

License

MIT License. Bebas dipakai termasuk untuk komersial.

Maintained by Yudistira SD - Laravel developer Indonesia. Spesialis integrasi healthcare API (SATUSEHAT, BPJS) untuk SaaS klinik.