Skip to content

Introduction

Purpose

This document defines the comprehensive technical specification for submitting clinical visit data from external Electronic Medical Record (EMR) systems to the National Payment Certification Agency (NPCA) Digital Payment Certification System. It establishes standardized, secure, and interoperable data exchange protocols to support Cambodia's healthcare digitization initiatives and ensure accurate reimbursement processing for healthcare services.

The specification enables healthcare facilities to seamlessly integrate their existing EMR systems with the national healthcare payment infrastructure, supporting both Health Equity Fund (HEF) and National Social Security Fund (NSSF) beneficiaries.

System Overview

The NPCA EMR Clinical Data Submission API serves as the central gateway for healthcare data exchange in Cambodia's digital health ecosystem. It facilitates:

  • Clinical Data Integration: Standardized submission of patient encounters, diagnoses, treatments, and outcomes
  • Payment Processing: Automated verification and processing of healthcare service claims
  • Quality Assurance: Real-time validation and error handling for data integrity
  • Interoperability: Seamless communication between diverse EMR systems and the national platform

Scope

This specification comprehensively covers:

Authentication and Security

  • OAuth 2.0 Bearer Token authentication with refresh token support
  • HTTPS/TLS 1.2+ encryption for all communications
  • System-level and facility-level authorization controls
  • Secure credential management and token lifecycle

Data Submission Framework

  • Complete patient visit lifecycle from admission to discharge
  • Multi-encounter support (OPD, IPD, Emergency, Surgery)
  • Real-time and batch submission capabilities
  • Comprehensive error handling and retry mechanisms

Clinical Data Coverage

  • Patient Demographics: Following NCDD standards with address hierarchies
  • Clinical Encounters: Triage, vital signs, physical examinations, SOAP notes
  • Diagnostic Information: ICD-10 compliant diagnosis coding
  • Treatment Records: Prescriptions, procedures, laboratory results, imaging
  • Administrative Data: Visit types, admission/discharge information, referrals

Financial and Billing Integration

  • Payment Type Classification: HEF (Poor, Informal Worker, At Risk) and NSSF (Employee, Public Servant, Self-Employed)
  • Service Billing: Itemized service charges and medication costs
  • Beneficiary Verification: Real-time beneficiary status validation
  • Claims Processing: Automated claim generation and status tracking

Response and Processing Management

  • Synchronous acknowledgment with processing status
  • Asynchronous processing with status polling capabilities
  • Comprehensive error reporting with field-level validation
  • Processing status tracking and audit trails

Intended Audience

Primary Users

  • EMR Vendors: System developers implementing integration with NPCA platform
  • Healthcare IT Teams: Technical staff at hospitals and clinics managing EMR systems
  • Integration Developers: Backend developers specializing in healthcare API integrations
  • System Architects: Technical leaders designing healthcare information systems

Secondary Users

  • Quality Assurance Teams: Testing specialists ensuring data integrity and interoperability
  • Healthcare Administrators: Facility managers overseeing digital health implementations
  • NPCA Technical Teams: Platform maintainers and support personnel
  • Compliance Officers: Staff ensuring adherence to healthcare data standards

Implementation Standards

Technical Protocols

  • API Architecture: RESTful JSON over HTTPS with OpenAPI 3.0 specification
  • Authentication: OAuth 2.0 Password Grant with Bearer Token authorization
  • Data Format: JSON with UTF-8 encoding
  • Transport Security: TLS 1.2 or higher with certificate validation

Healthcare Standards Compliance

  • Diagnostic Coding: ICD-10 (International Classification of Diseases, 10th Revision)
    • Category and subcategory codes for primary and secondary diagnoses
    • Support for differential and discharge diagnoses
  • Date/Time Format: ISO 8601 with Cambodia timezone (+07:00)
    • Example: 2025-03-17T09:30:00.000+07:00
  • Demographic Standards: National Committee for Demography and Development (NCDD)
    • Administrative divisions: Province, District, Commune, Village codes
    • Reference data available at: https://data.mef.gov.kh/

Data Quality Requirements

  • Patient Identification: Unique patient codes with cross-system validation
  • Visit Tracking: Unique visit codes per healthcare facility
  • Encounter Linking: Hierarchical encounter relationships (parent-child)
  • Temporal Consistency: Chronological validation of admission, treatment, and discharge times
  • Clinical Validation: Medical logic validation for vital signs, medications, and procedures

Regulatory and Compliance Framework

National Healthcare Standards

  • Alignment with Cambodia's Digital Health Strategy
  • Compliance with general data governance policies and personal data privacy
  • Support for Universal Health Coverage (UHC) initiatives

Data Privacy and Security

  • Patient data protection following national healthcare privacy regulations
  • Secure data transmission and storage requirements
  • Audit logging for all data access and modifications
  • Coverage-based access control for system users

Payment System Integration

  • HEF Integration: Health Equity Fund beneficiary validation
  • NSSF Integration: National Social Security Fund member validation
  • Claims Validation: Real-time verification of service data quality

Getting Started

Prerequisites

  1. System Registration: Obtain system credentials from NPCA technical team
  2. Facility Authorization: Register healthcare facility codes and permissions
  3. Technical Setup: Configure secure network connectivity and certificate management
  4. Testing Environment: Access to demo environment for integration testing

Implementation Phases

  1. Authentication Setup: Implement OAuth 2.0 token management
  2. Beneficiary Integration: Connect beneficiary search and validation
  3. Clinical Data Mapping: Map local EMR data to NPCA standard format
  4. Submission Testing: Validate data submission with sample cases
  5. Production Deployment: Go-live with monitoring and support

This specification provides the foundation for successful integration with Cambodia's national healthcare payment system, ensuring accurate, secure, and efficient processing of clinical data for improved healthcare delivery and financial management.