Repository navigation
Validation Rule Numbers
Bahasa / Language: English · Bahasa Indonesia
Source: Dokumen Kamus Rule Number (Error Code).xlsx, sheet V2.0 — 657 entries.
Reference: https://satusehat.kemkes.go.id/platform/docs/id/api-catalogue/validasi/list-response/
A rule number is the only stable handle on a rejection: the HTTP status is almost always 400 and the message text changes between releases.
{ "resourceType": "OperationOutcome", "issue": [{ "severity": "error", "code": "duplicate", "details": { "text": "Found duplicate resource: Encounter" } }] }
Fix: check whether the resource already exists before posting.
{ "details": { "text": "Code not found: 'xxx' in system: http://terminology.hl7.org/CodeSystem/v3-ActCode (RuleNumber: 10001)" } }
Fix: use a code system or value set from SATUSEHAT / HL7 FHIR.
YYYY-MM-DDThh:mm:ss+00:00. UTC required: WIB minus 7 h, WITA minus 8 h, WIT minus 9 h.
{ "details": { "text": "Field 'identifier' is required (RuleNumber: 10303)" } }
{ "details": { "text": "Reference 'Encounter/xxx' could not be resolved (RuleNumber: 10401)" } }
{ "details": { "text": "NIK is not valid: 3312345678901234 (RuleNumber: 10101)" } }
Fix: a valid 16-digit NIK; the last digit is a mod-11 checksum.
{ "details": { "text": "IHS Number not found: xxx (RuleNumber: 10402)" } }
| Range | Category |
|---|---|
| 10xxx | Patient — NIK, identifier, demographics |
| 11xxx | Practitioner — practitioner ID, specialty |
| 12xxx | Organization — ID, type, structure |
| 13xxx | Location — ID, status, managing organisation |
| 14xxx | Encounter — class, status, patient reference |
| 15xxx | Observation — code, value, effective date |
| 16xxx | Condition — code, clinical status |
| 17xxx | Procedure — KPTL code, status, performer |
| 18xxx | MedicationRequest — KFA code, dosage |
| 20xxx | Bundle — reference resolution, entry order |
| 30xxx | Terminology — code validation against a value set |
| Rule | Path | Meaning | Fix |
|---|---|---|---|
| 10101 | Patient.identifier | Invalid NIK checksum | A valid 16-digit NIK |
| 10103 | Patient.identifier | Missing NIK identifier | Add the system https://fhir.kemkes.go.id/id/nik
|
| 10201 | Practitioner.identifier | Invalid practitioner ID | A valid practitioner ID |
| 10301 | Organization.identifier | Missing organisation ID | Add the organisation identifier |
| 10401 | [resource].encounter | Encounter not found | Create the Encounter first |
| 10402 | [resource].subject | Patient IHS not found | GET the Patient for a valid IHS |
| 10501 | Observation.code | Code not in the value set | Use SATUSEHAT terminology |
| 10601 | Condition.code | ICD-10 not found | A valid ICD-10 code |
| 10701 | Procedure.code | KPTL not found | A valid KPTL code |
| 10801 | Medication.code | KFA not found | A valid KFA code |
| 20001 | Bundle.entry | Reference resolution failed | Send the referenced resource in the same Bundle |
from satusehat_integration import SSValidationError
error = SSValidationError.from_response(response) # or SSValidationError(issues)
error.get_rule_numbers() # [10101]
error.get_rule_info(10101) # {"code": ..., "description": ...} when the map knows it
error.get_affected_paths() # ["Patient.identifier[0].value"]
error.is_duplicate()
error.is_date_time_error()The rule map ships inside the package (satusehat_integration/ssresponse/ss_validation_error.py), so a
caller never has to download the Ministry's spreadsheet.
Sumber: Dokumen Kamus Rule Number (Error Code).xlsx, sheet V2.0 — 657 entri.
Rujukan: https://satusehat.kemkes.go.id/platform/docs/id/api-catalogue/validasi/list-response/
Nomor aturan adalah satu-satunya pegangan stabil pada penolakan: status HTTP hampir selalu 400 dan teks pesannya berubah antar-rilis.
{ "resourceType": "OperationOutcome", "issue": [{ "severity": "error", "code": "duplicate", "details": { "text": "Found duplicate resource: Encounter" } }] }
Perbaikan: periksa apakah resource sudah ada sebelum mengirim.
{ "details": { "text": "Code not found: 'xxx' in system: http://terminology.hl7.org/CodeSystem/v3-ActCode (RuleNumber: 10001)" } }
Perbaikan: pakai code system atau value set dari SATUSEHAT / HL7 FHIR.
YYYY-MM-DDThh:mm:ss+00:00. Wajib UTC: WIB dikurangi 7 jam, WITA 8 jam, WIT 9 jam.
{ "details": { "text": "Field 'identifier' is required (RuleNumber: 10303)" } }
{ "details": { "text": "Reference 'Encounter/xxx' could not be resolved (RuleNumber: 10401)" } }
{ "details": { "text": "NIK is not valid: 3312345678901234 (RuleNumber: 10101)" } }
Perbaikan: NIK 16 digit yang sah; digit terakhir checksum mod-11.
{ "details": { "text": "IHS Number not found: xxx (RuleNumber: 10402)" } }
| Rentang | Kategori |
|---|---|
| 10xxx | Patient — NIK, identifier, demografi |
| 11xxx | Practitioner — ID tenaga kesehatan, spesialisasi |
| 12xxx | Organization — ID, tipe, struktur |
| 13xxx | Location — ID, status, organisasi pengelola |
| 14xxx | Encounter — class, status, referensi pasien |
| 15xxx | Observation — kode, nilai, tanggal efektif |
| 16xxx | Condition — kode, status klinis |
| 17xxx | Procedure — kode KPTL, status, pelaksana |
| 18xxx | MedicationRequest — kode KFA, dosis |
| 20xxx | Bundle — resolusi referensi, urutan entri |
| 30xxx | Terminology — validasi kode terhadap value set |
| Aturan | Path | Arti | Perbaikan |
|---|---|---|---|
| 10101 | Patient.identifier | Checksum NIK tidak sah | NIK 16 digit yang sah |
| 10103 | Patient.identifier | Identifier NIK tidak ada | Tambahkan system https://fhir.kemkes.go.id/id/nik
|
| 10201 | Practitioner.identifier | ID tenaga kesehatan tidak sah | ID yang sah |
| 10301 | Organization.identifier | ID organisasi tidak ada | Tambahkan identifier organisasi |
| 10401 | [resource].encounter | Encounter tidak ditemukan | Buat Encounter lebih dulu |
| 10402 | [resource].subject | IHS pasien tidak ditemukan | GET Patient untuk IHS yang sah |
| 10501 | Observation.code | Kode tidak ada di value set | Pakai terminologi SATUSEHAT |
| 10601 | Condition.code | ICD-10 tidak ditemukan | Kode ICD-10 yang sah |
| 10701 | Procedure.code | KPTL tidak ditemukan | Kode KPTL yang sah |
| 10801 | Medication.code | KFA tidak ditemukan | Kode KFA yang sah |
| 20001 | Bundle.entry | Resolusi referensi gagal | Kirim resource terkait dalam Bundle yang sama |
from satusehat_integration import SSValidationError
error = SSValidationError.from_response(response) # atau SSValidationError(issues)
error.get_rule_numbers() # [10101]
error.get_rule_info(10101) # {"code": ..., "description": ...} bila peta mengenalnya
error.get_affected_paths() # ["Patient.identifier[0].value"]
error.is_duplicate()
error.is_date_time_error()Peta aturan ikut terpasang di dalam paket
(satusehat_integration/ssresponse/ss_validation_error.py), jadi pemanggil tidak perlu mengunduh
spreadsheet Kementerian.