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
- Example:
- 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
- System Registration: Obtain system credentials from NPCA technical team
- Facility Authorization: Register healthcare facility codes and permissions
- Technical Setup: Configure secure network connectivity and certificate management
- Testing Environment: Access to demo environment for integration testing
Implementation Phases
- Authentication Setup: Implement OAuth 2.0 token management
- Beneficiary Integration: Connect beneficiary search and validation
- Clinical Data Mapping: Map local EMR data to NPCA standard format
- Submission Testing: Validate data submission with sample cases
- 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.