Paid vs Billed Amount Consistency

consistencycritical

Validates financial consistency in remittance data: paid amount must be >= 0 and <= billed amount, allowed amount must be >= 0, and the sum of paid_amount + patient_responsibility + adjustment_amount should approximately equal the billed_amount within a configurable tolerance. This ensures the remittance balances and prevents overpayments or missing adjustments.

v1.0.0by dqhub197 downloads4.5 (19)

paidbilledamountremittanceclaimshealthcarex12-835hipaaerafinancialreconciliation

Try This Rule

Parameters

column_namestringrequired

The column containing email addresses

thresholdfloatdefault: 0.99

Minimum fraction of valid emails (0.0 to 1.0)

Compliance Mapping

HIPAA45 CFR 162.1602

X12X12 835 Transaction Set - CLP/SVC Segments (Claim/Service Payment Information)

CAQH CORECAQH CORE 382 ERA Claim Payment Balancing Rule

Install

soda

checks for {{table_name}}:
  - invalid_percent({{column_name}}) < {{(1 - threshold) * 100}}:
      valid regex: '^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$'

dbt

{% test valid_email(model, column_name) %}
select {{ column_name }}
from {{ model }}
where {{ column_name }} not regexp '^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,}$'
{% endtest %}

sql

SELECT COUNT(*) as total,
  SUM(CASE WHEN {{column_name}} REGEXP
    '^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,}$'
    THEN 1 ELSE 0 END) as valid
FROM {{table_name}}

Great Expectations

{
  "expectation_type": "expect_column_values_to_match_regex",
  "kwargs": {
    "column": "{{column_name}}",
    "regex": "^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,}$",
    "mostly": {{threshold}}
  }
}

spark

from pyspark.sql.functions import col
pattern = r'^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$'
invalid = df.filter(~col("{{column_name}}").rlike(pattern)).count()

Test Data

Passing Examples

id	value
1	alice@example.com
2	bob.smith@company.co.uk
3	charlie+tag@domain.org

Failing Examples

id	value
1	not-an-email
2	@missing-local.com
3	spaces in@email.com

CLI

Terminal

npx dqhub install paid-vs-billed-consistency --format soda --table YOUR_TABLE
npx dqhub install paid-vs-billed-consistency --format dbt --model YOUR_MODEL
npx dqhub install paid-vs-billed-consistency --format sql --dialect snowflake