Skip to content

Validation Rule Numbers

Ivan William Harsono edited this page Nov 17, 2026 · 2 revisions

Validation rule numbers

Bahasa / Language: English · Bahasa Indonesia


English

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.

Common response patterns

1. Duplicate resource

{ "resourceType": "OperationOutcome", "issue": [{ "severity": "error", "code": "duplicate", "details": { "text": "Found duplicate resource: Encounter" } }] }

Fix: check whether the resource already exists before posting.

2. Code not found

{ "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.

3. Invalid date-time

YYYY-MM-DDThh:mm:ss+00:00. UTC required: WIB minus 7 h, WITA minus 8 h, WIT minus 9 h.

4. Missing required field

{ "details": { "text": "Field 'identifier' is required (RuleNumber: 10303)" } }

5. Invalid reference

{ "details": { "text": "Reference 'Encounter/xxx' could not be resolved (RuleNumber: 10401)" } }

6. Invalid NIK

{ "details": { "text": "NIK is not valid: 3312345678901234 (RuleNumber: 10101)" } }

Fix: a valid 16-digit NIK; the last digit is a mod-11 checksum.

7. Invalid IHS number

{ "details": { "text": "IHS Number not found: xxx (RuleNumber: 10402)" } }

Ranges

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

Frequently seen numbers

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

Reading them in code

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.


Bahasa Indonesia

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.

Pola respons yang sering muncul

1. Resource duplikat

{ "resourceType": "OperationOutcome", "issue": [{ "severity": "error", "code": "duplicate", "details": { "text": "Found duplicate resource: Encounter" } }] }

Perbaikan: periksa apakah resource sudah ada sebelum mengirim.

2. Kode tidak ditemukan

{ "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.

3. Format tanggal-waktu salah

YYYY-MM-DDThh:mm:ss+00:00. Wajib UTC: WIB dikurangi 7 jam, WITA 8 jam, WIT 9 jam.

4. Field wajib tidak ada

{ "details": { "text": "Field 'identifier' is required (RuleNumber: 10303)" } }

5. Referensi tidak sah

{ "details": { "text": "Reference 'Encounter/xxx' could not be resolved (RuleNumber: 10401)" } }

6. NIK tidak sah

{ "details": { "text": "NIK is not valid: 3312345678901234 (RuleNumber: 10101)" } }

Perbaikan: NIK 16 digit yang sah; digit terakhir checksum mod-11.

7. IHS number tidak sah

{ "details": { "text": "IHS Number not found: xxx (RuleNumber: 10402)" } }

Rentang

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

Nomor yang sering dijumpai

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

Membacanya di kode

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.

Clone this wiki locally