See what our clients say about working with Bonami Software across 200+ projects for 18+ industries. EXPLORE NOW!
We don't just build software. We deliver results. EXPLORE NOW!
See why businesses choose Bonami Software for reliable, scalable solutions. EXPLORE NOW!
We turn ideas into scalable products with proven delivery across 18+ industries. EXPLORE NOW!
See what our clients say about working with Bonami Software across 200+ projects for 18+ industries. EXPLORE NOW!
We don't just build software. We deliver results. EXPLORE NOW!
See why businesses choose Bonami Software for reliable, scalable solutions. EXPLORE NOW!
We turn ideas into scalable products with proven delivery across 18+ industries. EXPLORE NOW!

NPHIES Integration Company in Saudi Arabia

Rejected claims and failed conformance testing are what NPHIES projects actually run aground on. We build the integration that clears both — HL7 FHIR R4, National ID and Iqama matching, eligibility, prior authorization and the full conformance package, alongside the HIS or EMR you already run.

BrowserStack
Persistent
Yatra
Kellton
Jade Global
Optum
PokerBaazi
Walmart
Turing
BrowserStack
Persistent
Yatra
Kellton
Jade Global
Optum
PokerBaazi
Walmart
Turing

Book Your Free Demo

See it working on your own workflows. We reply within 24 hours.

  • Your idea is 100% protected by our NDA
BrowserStack
Persistent
Yatra
Kellton
Jade Global
Optum
PokerBaazi
Walmart
Turing
BrowserStack
Persistent
Yatra
Kellton
Jade Global
Optum
PokerBaazi
Walmart
Turing

Award-Winning NPHIES Integration

100 Fastest Growth Companies
Global Spring Winner
Top App Development Company
AWS Partner Network
Google Cloud Partner
Highly Rated on Trustpilot
Verified Agency
Top App Development Company
ASSOCHAM Member
100 Fastest Growth Companies
Global Spring Winner
Top App Development Company
AWS Partner Network
Google Cloud Partner
Highly Rated on Trustpilot
Verified Agency
Top App Development Company
ASSOCHAM Member

The NPHIES Problems That Actually Cost You Money

Most NPHIES content explains the regulation. That is rarely why a provider picks up the phone. These are the four situations that bring hospitals, clinic groups and health-software vendors to us, and what we do about each.

1 | 4
4
01

Claims Get Rejected and Cash Flow Stalls

The Issue

A claim that fails NPHIES validation does not get paid. Rejections cluster around identifier mismatches, codes never mapped to the Saudi-adapted systems, missing prior authorization references and eligibility that was never checked. Every rework cycle is days of delayed reimbursement.

Our Fix

We treat first-pass acceptance as a design goal. Identifiers, code mappings and authorization references are validated inside your system before submission, and every rejection is categorised by root cause so the same failure stops recurring.

Claims Get Rejected and Cash Flow Stalls
02

Conformance Testing Stalls the Project

The Issue

Conformance is where NPHIES timelines slip. Teams build against the Implementation Guides, submit, then fail on profile constraints, required extensions, terminology bindings and identifier formats. Each failed cycle means a rebuild and another wait in a queue you do not control.

Our Fix

We validate against the Implementation Guides continuously during the build rather than as a gate at the end. Sandbox testing exercises real message flows early, so the official submission confirms what we already know.

Conformance Testing Stalls the Project
03

Your Existing HIS or EMR Was Not Built for This

The Issue

Most providers already run a hospital information system or EMR holding years of patient data, often with a pre-FHIR schema, local code sets and records keyed on internal identifiers rather than National ID. Replacing it to satisfy NPHIES is rarely realistic.

Our Fix

We build the NPHIES layer alongside your existing system: reading your current data model, mapping local codes to ICD-10-CM, LOINC and the SFDA drug database, and emitting conformant FHIR R4. Your HIS vendor does not have to cooperate.

Your Existing HIS or EMR Was Not Built for This
04

Go-Live Is Not the Finish Line

The Issue

NPHIES is a live platform, not a one-off certification. Implementation Guides are versioned, payer behaviour changes and code systems get revised, so a connection that passed conformance can start failing quietly once the project team moves on.

Our Fix

We instrument the connection so problems surface as alerts rather than as a quarterly revenue surprise: rejection monitoring by category, error-rate alerting, and a defined scope for Implementation Guide updates and support response.

Go-Live Is Not the Finish Line

What NPHIES Integration Covers

Operated by the MoH and built on HL7 FHIR R4, NPHIES is the national hub for electronic claims, prior authorization and clinical data exchange.

Electronic Claims Submission

Providers submit FHIR claim resources and insurers return adjudication decisions through NPHIES, overseen by the Council of Health Insurance (CHI), formerly the CCHI.

Prior Authorization

Electronic prior authorization for procedures, medications, and services needing insurer approval — no paper workflows.

Patient Health Record Exchange

Clinical records shared between facilities toward a unified national record — encounters, ICD-10-CM diagnoses, and LOINC results.

National Patient Identifier

National ID for citizens and Iqama for residents are the primary identifiers; mismatches get data rejected or misattributed.

Drug & Formulary Integration

Systems map local medication data to the national drug and formulary codes maintained by the Saudi FDA.

FHIR Conformance & Certification

Built on HL7 FHIR R4 with Saudi-specific profiles, NPHIES requires conformance testing of all profiles before production.

NPHIES Connectivity Is a Ministry of Health Requirement for Every Saudi Facility

Hover to explore the regulations and steps behind NPHIES integration.

The NPHIES Integration Process

From MoH registration to live production.

What We Actually Do on an NPHIES Integration

NPHIES being mandatory is not an argument for choosing us. This is the work itself.

Talk to an NPHIES Engineer
Conformance-First
We validate against the NPHIES Implementation Guides throughout the build, not at the end. Profiles, extensions and terminology bindings are checked as resources are developed, so the official conformance submission confirms what sandbox testing already showed.
Terminology Mapping
Your local code sets get mapped to the national standards NPHIES expects -- ICD-10-CM diagnoses, LOINC laboratory results, CPT and Saudi-specific procedure codes, and the Saudi FDA drug database. This is the unglamorous work that decides whether claims are accepted.
Identity Reconciliation
National ID for citizens and Iqama for residents have to be attached correctly or records are rejected or misfiled. We build the matching and exception handling for records where the identifier is missing, malformed or contradicts the payer record.
Denial Instrumentation
Every rejection is categorised by root cause and surfaced, so recurring failures get fixed at the source instead of being re-keyed by billing staff. First-pass acceptance is treated as a design target, not a number you read about afterwards.
Works With Your HIS
The NPHIES layer is built alongside your existing hospital information system or EMR rather than replacing it. We read from your current data model and emit conformant FHIR R4, which means your clinical staff keep the system they already use and your HIS vendor does not have to cooperate.
Named Support Scope
Implementation Guides are versioned and payer behaviour shifts, so a certified connection can degrade quietly. Post go-live monitoring, alerting and Implementation Guide updates are a defined scope with response expectations rather than an informal arrangement.

Claim Rejections, Eligibility and Your Revenue Cycle

Compliance gets you connected. Whether you get paid on the first submission is a separate engineering problem. This is the part of NPHIES that shows up in your cash flow.

Rejections

Why NPHIES Claims Get Rejected

Rejections cluster around a predictable set of root causes rather than being random.

  • Identifier mismatches
  • Unmapped diagnosis codes
  • Missing prior auth reference
  • Eligibility not verified
  • Invalid FHIR structure
  • Bundling and duplicate errors
Eligibility

Eligibility Verification

Checking coverage before the encounter prevents the rejection rather than handling it.

  • Real-time coverage checks
  • Benefit and limit detail
  • Pre-visit verification
  • Coverage change detection
  • Self-pay identification
  • Response caching
Denial Management

Denial Management and Remediation

Categorising rejections by cause turns rework into a fixable pipeline instead of a queue of one-off corrections.

  • Root-cause categorisation
  • Correction and resubmission queue
  • Recurring-failure alerts
  • Payer-specific patterns
  • Appeal documentation trail
  • First-pass rate tracking
Prior Auth

Prior Authorization Turnaround

Electronic authorization removes the paper loop that delays both treatment and payment.

  • Electronic PA submission
  • Status tracking
  • Approval reference capture
  • Linking PA to the claim
  • Expiry monitoring
  • Denial reason capture
Reconciliation

Remittance and Reconciliation

Matching adjudication responses and payments back to the original claim.

  • Adjudication response handling
  • Payment matching
  • Partial payment detection
  • Underpayment flagging
  • Write-off classification
  • Ageing visibility
Monitoring

Post Go-Live Monitoring

A certified connection can degrade quietly as Implementation Guides and payer behaviour change.

  • Submission volume tracking
  • Error-rate alerting
  • Implementation Guide updates
  • Payer behaviour changes
  • Audit trail retention
  • Defined support response

Technology Stack

The NPHIES Integration Stack We Build With

The FHIR engines, code systems, claims tooling and KSA-resident infrastructure we build NPHIES connectivity on.

Production FHIR engines and the standards NPHIES connectivity is built around.

  • HL7 FHIR R4
  • HAPI FHIR
  • NPHIES Implementation Guide
  • HL7 v2
  • CDA / C-CDA
Healthcare Systems in Saudi Arabia Cannot Operate Without NPHIES Integration.

FHIR submission, claims, prior authorization and National ID/Iqama matching — built in and carried through testing, certification and go-live.

Book a NPHIES Consult
AI Readiness

Award-Winning AI Development & Consulting

2025

100 Fastest Growth Companies

2025

Global Spring Winner

2025

Top App Development Company

2024

AWS Partner Network

2024

Google Cloud Partner

2025

Highly Rated on Trustpilot

2024

Verified Agency

2024

Top App Development Company

2024

ASSOCHAM Member

Frequently Asked Questions

[ 1 ]

How long does NPHIES conformance testing and certification take?

Plan in phases rather than as a single number. Registration and onboarding with the Ministry of Health is largely administrative. The build and terminology mapping is the longest phase and scales with how far your current data model sits from FHIR R4 and how many local code sets need mapping. Sandbox testing and the conformance submission then depend partly on a review queue outside your control. For a provider with a working HIS and a contained scope, a few months end to end is a realistic expectation; a large multi-facility group with legacy systems and many integrations should plan for longer. The single biggest variable is how many conformance cycles you need, which is why we validate continuously during the build instead of treating testing as a gate at the end.

[ 2 ]

What happens if we fail NPHIES conformance testing?

Failing is not fatal, but it costs time. You receive the validation errors, correct them, and resubmit, which means another wait in the review queue. Failures usually come from profile constraints, missing required extensions, terminology bindings that do not match the national code systems, or identifier formatting rather than from anything conceptually wrong with the build. The way to avoid repeat cycles is to validate resources against the published Implementation Guides continuously as they are developed and to exercise real message flows in the sandbox early, so the official submission confirms what you already know.

[ 3 ]

Can you integrate NPHIES with our existing HIS or EMR?

Yes, and that is the more common engagement. We build the NPHIES layer alongside your existing hospital information system or EMR rather than replacing it: reading from your current data model, mapping your local codes to ICD-10-CM, LOINC, CPT with Saudi-specific procedure codes and the Saudi FDA drug database, reconciling patient identity to National ID or Iqama, and emitting conformant FHIR R4. Your clinical staff keep the system they know. This approach also does not require your HIS vendor to extend their product, which matters when the vendor is unwilling or the version is old.

[ 4 ]

Are you an NPHIES certified vendor?

It is worth being precise about how NPHIES certification works, because the phrase is used loosely. Conformance certification is granted for a specific system connecting to NPHIES, held by the provider or the software vendor whose system was tested — it is not a general accreditation a services firm holds independently of any implementation. What we do is build your integration to the Implementation Guides and take it through registration, sandbox testing, the conformance submission and production go-live, so the certification that results is attached to your system. If a vendor tells you they are certified in the abstract, ask which system was certified and when.

[ 5 ]

Why do NPHIES claims get rejected, and can you reduce our denial rate?

Rejections cluster around a predictable set of causes: National ID or Iqama mismatches against the payer record, diagnosis and procedure codes never mapped to the Saudi-adapted code systems, missing prior authorization references, eligibility not verified before the encounter, and FHIR resources that are structurally valid but semantically wrong. Because the causes are predictable, they are addressable. We validate identifiers, code mappings and authorization references inside your system before submission, categorise every rejection by root cause so recurring failures get fixed at the source rather than re-keyed by billing staff, and build the correction path into the workflow as a queue. What that yields depends on your current baseline and payer mix, so we would rather measure your rejection categories first than quote you a percentage.

[ 6 ]

What does NPHIES integration cost and how do you engage?

Cost tracks the size of the integration surface rather than a per-facility price. The main drivers are how far your existing data model is from FHIR R4, how many local code systems need mapping, how many facilities and downstream systems are in scope, and whether you need ongoing support after go-live. We scope in two steps: a paid discovery on your actual systems that produces an integration inventory and a conformance plan, then a fixed or phased build against that plan. We do not publish a headline price because a number given before seeing your HIS and code sets would be a guess, and the discovery output is useful to you even if you build with someone else.

[ 7 ]

Do you provide support after go-live?

Yes, and we treat it as a defined scope rather than an informal understanding. NPHIES is a live platform: Implementation Guides are versioned and updated, payer behaviour changes, and code systems get revised, so a connection that passed conformance can start failing quietly. Post go-live scope covers submission and rejection monitoring by category, alerting when error rates shift, handling Implementation Guide revisions as they are published, and named response expectations. The common failure mode we see is a provider who certified successfully, moved the team off, and discovered months later that rejection volume had crept up because nobody owned the integration.

[ 8 ]

Is NPHIES integration required for all healthcare facilities in Saudi Arabia?

Yes. NPHIES connectivity is mandated for licensed public and private facilities, and new facilities need a connectivity plan as part of obtaining an operating licence. NPHIES is operated under the Ministry of Health, and the health insurance side is regulated by the Council of Health Insurance (CHI), which was formerly the Council of Cooperative Health Insurance (CCHI) — you will still see the old abbreviation in older documentation. All provider-to-insurer claims flow through the platform, so integration determines whether you get reimbursed as well as whether you are compliant.

[ 9 ]

What coding systems does NPHIES use for clinical data?

NPHIES uses Saudi-adapted coding: ICD-10-CM for diagnoses, LOINC for laboratory results, Saudi FDA drug codes for medications, and CPT plus Saudi-specific procedure codes. Systems must map internal codes to these national standards, and unmapped or stale mappings are one of the most common rejection causes, which is why terminology mapping is treated as a first-class part of the build rather than a data cleanup task at the end.

Global presence

Three offices. One team.

Hi, I'm ARIA. Ask me anything about Bonami's AI agents.