Referensi

Katalog kode galat

Kode dikelompokkan menurut asalnya: GW_ dari gateway kami, BPJS_ diteruskan dari BPJS, SS_ dari SatuSehat. Yang penting bukan kodenya, melainkan tindakan yang seharusnya diambil.

KodePenyebabTindakan
GW_VALIDATIONPayload ditolak sebelum upstream dipanggil — field wajib kosong, format waktu tanpa offset, atau kode ICD-10 yang tidak berbentuk kode.Perbaiki payload
GW_IDEMPOTENCY_KEY_REUSEDKunci idempotensi dipakai ulang dengan body berbeda.Perbaiki kode
GW_SEP_DUPLICATESudah ada SEP untuk peserta, tanggal, dan jenis pelayanan yang sama.Ambil SEP lama
GW_RATE_LIMITEDKuota per menit terlampaui. Header Retry-After menyebutkan jedanya.Coba lagi
GW_IP_NOT_ALLOWEDAlamat pemanggil tidak ada di allowlist tenant. Sering muncul saat egress SIMRS dual-stack dan hanya IPv4 yang didaftarkan.Daftarkan IP
GW_UPSTREAM_CIRCUIT_OPENCircuit breaker terbuka karena upstream tidak sehat. Kunjungan yang sudah diterima tetap diantrekan.Tunggu
GW_DECRYPT_FAILEDRespons BPJS tidak dapat didekripsi — hampir selalu kredensial atau environment yang keliru.Hubungi kami
BPJS_VCLAIM_201Contoh jawaban bisnis BPJS: peserta tidak ditemukan. Kode BPJS_ selalu berbentuk BPJS_<LAYANAN>_<kode>, selalu 422, dan membawa metaData asli di error.upstream.Perbaiki data
SS_VALIDATIONResource ditolak SatuSehat: kode diagnosa, satuan, atau rentang nilai tidak valid.Perbaiki payload
SS_LOCATION_UNRESOLVEDKode poli belum terdaftar sebagai Location di organisasi rumah sakit.Daftarkan poli
SS_NOT_ENTITLEDKredensial tidak berhak atas path tersebut di host itu. Menyegarkan token tidak menolong — ini soal entitlement, bukan kedaluwarsa.Hubungi kami

Setiap respons galat membawa error.request_id, dan nilai yang sama ada di header X-Request-Id. Sertakan nilai itu saat menghubungi dukungan — dengan request_id kami dapat menampilkan seluruh rantai tanpa Anda perlu menjelaskan ulang.

Bentuk envelope galat
{
  "success": false,
  "error": {
    "code": "SS_VALIDATION",
    "http_status": 422,
    "message": "…",
    "request_id": "req_01J9F3K2M7QX1041"
  }
}