Skip to content

NPCA EMR StandardClinical Data Integration Specification

The official technical specification for healthcare facilities to submit standardized patient visits, clinical encounters, and diagnoses to Cambodia's Digital Payment Certification System.

Submission Lifecycle

The Four-Stage Integration Pipeline

A deterministic workflow connecting your Electronic Medical Record system to the NPCA Payment Certification platform.

Stage 1

Authenticate

Obtain a short-lived Bearer access token using facility credentials via OAuth 2.0 password grant.

POST /oauth/token
Stage 2

Verify Beneficiary

Validate patient entitlement status against HEF or NSSF central registries before admission.

POST /api/v1/beneficiaries/search
Stage 3

Submit Encounter

Transmit outpatient (OPD) or inpatient (IPD) clinical records including vital signs and diagnoses.

POST /api/v1/external/visits
Stage 4

Audit Submission

Audit by calling the processed endpoint to verify whether the submission succeeded or failed, as the initial status is acceptance only.

GET /api/v1/external/visits/processed
Implementation Rules

Standard Data Protocols

All submitted records must conform to official healthcare coding standards and temporal constraints.

ISO 8601 Cambodia Timezone

All encounter timestamps must include the explicit +07:00 offset (for example, 2026-03-15T08:30:00.000+07:00).

NCDD Geographic Hierarchies

Patient addresses must follow official administrative codes for province, district, commune, and village.

ICD-10 Diagnostic Classification

Primary and secondary diagnoses must use valid WHO ICD-10 category and subcategory code strings.

POST /api/v1/external/visits
{
  "health_facility_code": "HF-010204",
  "patient_code": "PT029206",
  "code": "VIS071315",
  "visit_type": "OPD",
  "admitted_at": "2026-03-15T08:30:00.000+07:00",
  "patient": {
    "surname": "សុខ",
    "name": "វិបុល",
    "sex": "M",
    "spid": "1234567890",
    "address": { "commune": "120801" }
  },
  "triages": [
    { "code": "TR062209", "chief_complaint": "Abdominal pain" }
  ],
  "vital_signs": [
    { "observations": [{ "name": "Heart Rate", "value": 78 }] }
  ]
}

Ready to Integrate Your Healthcare Facility?

Access the complete technical specification, explore the interactive endpoint documentation, or download the official offline Excel workbooks.