Introducing aggregation preferences for ERA enrollments
ERAs & transaction enrollment
You can now set an aggregation preference – NPI or tax ID (TIN) – on ERA transaction enrollment requests. The preference tells the payer how you’d like them to group payment information in ERAs.
Selecting the right aggregation preference means ERAs arrive grouped the way your billing system expects. Without it, mismatched grouping can require manual reconciliation to match payments to providers or practices.
What is ERA aggregation?
An Electronic Remittance Advice (ERA) contains payment and adjudication information for one or more claims. Providers use ERAs for payment reconciliation, where they match claims to their payments.
Payers group the information inside an ERA and route ERAs based on one of two identifiers in the related claims:
Tax identification number (TIN) – A 9-digit tax ID, either a Social Security Number (SSN) or Employer Identification Number (EIN).
National Provider Identifier (NPI) – A 10-digit ID assigned to individual providers and organizations.
TIN vs. NPI-based aggregation
TINs are sometimes shared across multiple billing providers within the same organization. For example, a clinic may submit claims for several doctors using a single TIN.
NPIs always uniquely identify a single provider entity, either an individual provider or an organization. For example, a doctor employed by multiple clinics may use the same NPI to submit claims across multiple TINs.
Most payers default to TIN-based aggregation. For more background, see How payers route ERAs.
How aggregation preferences work
Aggregation preferences are a request to the payer, not a guarantee. The payer, not Stedi, controls how ERAs are grouped and routed.
Checking payer support
Not all payers support both aggregation types. You can check which types a payer supports using the Payers API or the Stedi Payer Network before submitting an enrollment request.
In the Stedi Payer Network:

In Payers API responses, the supportedAggregationPreferences field lists the supported types. The field is omitted when Stedi has yet to determine a payer's supported aggregation types.
{ "payer": { "enrollment": { "transactionEnrollmentProcesses": { "claimPayment": { "supportedAggregationPreferences": ["NPI", "TIN"], // Payer supports ERA aggregation by NPI and TIN ... } } }, ... } }
{ "payer": { "enrollment": { "transactionEnrollmentProcesses": { "claimPayment": { "supportedAggregationPreferences": ["NPI", "TIN"], // Payer supports ERA aggregation by NPI and TIN ... } } }, ... } }
{ "payer": { "enrollment": { "transactionEnrollmentProcesses": { "claimPayment": { "supportedAggregationPreferences": ["NPI", "TIN"], // Payer supports ERA aggregation by NPI and TIN ... } } }, ... } }
Enrollments API
Setting aggregation preferences
You can now pass the optional aggregationPreference object in Create Enrollment API requests. In almost all cases, the NPI or TIN should belong to the provider being enrolled.
To request NPI-based aggregation, provide an NPI in the aggregationPreference.npi property. For example, in a Create Enrollment API request body:
{ "transactions": { "claimPayment": { "enroll": true // ERA enrollment } }, "aggregationPreference": { "npi": "1234567890" // Aggregate by the provided NPI }, ... }
{ "transactions": { "claimPayment": { "enroll": true // ERA enrollment } }, "aggregationPreference": { "npi": "1234567890" // Aggregate by the provided NPI }, ... }
{ "transactions": { "claimPayment": { "enroll": true // ERA enrollment } }, "aggregationPreference": { "npi": "1234567890" // Aggregate by the provided NPI }, ... }
To request TIN-based aggregation, use the aggregationPreference.taxId property:
{ "transactions": { "claimPayment": { "enroll": true // ERA enrollment } }, "aggregationPreference": { "taxId": "999888777" // Aggregate by the provided tax ID (TIN) }, ... }
{ "transactions": { "claimPayment": { "enroll": true // ERA enrollment } }, "aggregationPreference": { "taxId": "999888777" // Aggregate by the provided tax ID (TIN) }, ... }
{ "transactions": { "claimPayment": { "enroll": true // ERA enrollment } }, "aggregationPreference": { "taxId": "999888777" // Aggregate by the provided tax ID (TIN) }, ... }
The aggregationPreference object is only supported for ERA transaction enrollments.
Updating existing enrollments
You can update the aggregationPreference object using an Update Enrollment API request if the enrollment is in the DRAFT status.
Payer support for aggregation preference
Before accepting an enrollment request, Stedi checks whether the payer supports the provided aggregationPreference. If not, Stedi rejects the request with an error.
If you omit the aggregationPreference field, the payer’s default aggregation method is used.
Viewing aggregation preferences
The Retrieve Enrollment API and List Enrollment API responses now return the submitted aggregationPreference object in enrollment records. For example, in a Retrieve Enrollment API response:
{ "id": "db6675c5-7be7-4af9-8c68-a54a336d2911", "aggregationPreference": { "npi": "1234567890" }, ... }
{ "id": "db6675c5-7be7-4af9-8c68-a54a336d2911", "aggregationPreference": { "npi": "1234567890" }, ... }
{ "id": "db6675c5-7be7-4af9-8c68-a54a336d2911", "aggregationPreference": { "npi": "1234567890" }, ... }
The object is omitted for enrollments created before this feature was available.
Stedi portal
You can now use the optional TIN or NPI selectors to indicate an aggregation preference when creating an ERA enrollment request in the Stedi portal. By default, the TIN and NPI values in the selectors belong to the provider being enrolled.

Each ERA enrollment’s details page shows the aggregation preference.

Availability
Transaction enrollment is free on all Stedi plans.
To learn more, check out our transaction enrollment docs.
You can now set an aggregation preference – NPI or tax ID (TIN) – on ERA transaction enrollment requests. The preference tells the payer how you’d like them to group payment information in ERAs.
Selecting the right aggregation preference means ERAs arrive grouped the way your billing system expects. Without it, mismatched grouping can require manual reconciliation to match payments to providers or practices.
What is ERA aggregation?
An Electronic Remittance Advice (ERA) contains payment and adjudication information for one or more claims. Providers use ERAs for payment reconciliation, where they match claims to their payments.
Payers group the information inside an ERA and route ERAs based on one of two identifiers in the related claims:
Tax identification number (TIN) – A 9-digit tax ID, either a Social Security Number (SSN) or Employer Identification Number (EIN).
National Provider Identifier (NPI) – A 10-digit ID assigned to individual providers and organizations.
TIN vs. NPI-based aggregation
TINs are sometimes shared across multiple billing providers within the same organization. For example, a clinic may submit claims for several doctors using a single TIN.
NPIs always uniquely identify a single provider entity, either an individual provider or an organization. For example, a doctor employed by multiple clinics may use the same NPI to submit claims across multiple TINs.
Most payers default to TIN-based aggregation. For more background, see How payers route ERAs.
How aggregation preferences work
Aggregation preferences are a request to the payer, not a guarantee. The payer, not Stedi, controls how ERAs are grouped and routed.
Checking payer support
Not all payers support both aggregation types. You can check which types a payer supports using the Payers API or the Stedi Payer Network before submitting an enrollment request.
In the Stedi Payer Network:

In Payers API responses, the supportedAggregationPreferences field lists the supported types. The field is omitted when Stedi has yet to determine a payer's supported aggregation types.
{ "payer": { "enrollment": { "transactionEnrollmentProcesses": { "claimPayment": { "supportedAggregationPreferences": ["NPI", "TIN"], // Payer supports ERA aggregation by NPI and TIN ... } } }, ... } }
Enrollments API
Setting aggregation preferences
You can now pass the optional aggregationPreference object in Create Enrollment API requests. In almost all cases, the NPI or TIN should belong to the provider being enrolled.
To request NPI-based aggregation, provide an NPI in the aggregationPreference.npi property. For example, in a Create Enrollment API request body:
{ "transactions": { "claimPayment": { "enroll": true // ERA enrollment } }, "aggregationPreference": { "npi": "1234567890" // Aggregate by the provided NPI }, ... }
To request TIN-based aggregation, use the aggregationPreference.taxId property:
{ "transactions": { "claimPayment": { "enroll": true // ERA enrollment } }, "aggregationPreference": { "taxId": "999888777" // Aggregate by the provided tax ID (TIN) }, ... }
The aggregationPreference object is only supported for ERA transaction enrollments.
Updating existing enrollments
You can update the aggregationPreference object using an Update Enrollment API request if the enrollment is in the DRAFT status.
Payer support for aggregation preference
Before accepting an enrollment request, Stedi checks whether the payer supports the provided aggregationPreference. If not, Stedi rejects the request with an error.
If you omit the aggregationPreference field, the payer’s default aggregation method is used.
Viewing aggregation preferences
The Retrieve Enrollment API and List Enrollment API responses now return the submitted aggregationPreference object in enrollment records. For example, in a Retrieve Enrollment API response:
{ "id": "db6675c5-7be7-4af9-8c68-a54a336d2911", "aggregationPreference": { "npi": "1234567890" }, ... }
The object is omitted for enrollments created before this feature was available.
Stedi portal
You can now use the optional TIN or NPI selectors to indicate an aggregation preference when creating an ERA enrollment request in the Stedi portal. By default, the TIN and NPI values in the selectors belong to the provider being enrolled.

Each ERA enrollment’s details page shows the aggregation preference.

Availability
Transaction enrollment is free on all Stedi plans.
To learn more, check out our transaction enrollment docs.
Get started with Stedi
Get started with Stedi
Automate healthcare transactions with developer-friendly APIs that support thousands of payers. Contact us to learn more and speak to the team.
Get updates on what’s new at Stedi
Get updates on what’s new at Stedi
Get updates on what’s new at Stedi
Product
Developers
Resources
Backed by
Stedi and the S design mark are registered trademarks of Stedi, Inc. All names, logos, and brands of third parties listed on our site are trademarks of their respective owners (including “X12”, which is a trademark of X12 Incorporated). Stedi, Inc. and its products and services are not endorsed by, sponsored by, or affiliated with these third parties. Our use of these names, logos, and brands is for identification purposes only, and does not imply any such endorsement, sponsorship, or affiliation.
Product
Developers
Resources
Get updates on what’s new at Stedi
Backed by
Stedi and the S design mark are registered trademarks of Stedi, Inc. All names, logos, and brands of third parties listed on our site are trademarks of their respective owners (including “X12”, which is a trademark of X12 Incorporated). Stedi, Inc. and its products and services are not endorsed by, sponsored by, or affiliated with these third parties. Our use of these names, logos, and brands is for identification purposes only, and does not imply any such endorsement, sponsorship, or affiliation.
Product
Developers
Resources
Backed by
Stedi and the S design mark are registered trademarks of Stedi, Inc. All names, logos, and brands of third parties listed on our site are trademarks of their respective owners (including “X12”, which is a trademark of X12 Incorporated). Stedi, Inc. and its products and services are not endorsed by, sponsored by, or affiliated with these third parties. Our use of these names, logos, and brands is for identification purposes only, and does not imply any such endorsement, sponsorship, or affiliation.
