Upcoming change to ReferenceId attribute in Reconciliation files

On this page4 sections

1. What's changing
2. Why this change is happening
3. Partner impact
4. Required partner action

Impacted audience

Cloud Solution Provider (CSP) direct bill partners and distributors.

Effective April 15, 2026, the ReferenceId attribute in Billed Reconciliation and Unbilled Reconciliation files will be updated to use a structured JSON format.

What's changing

• The ReferenceId value will be updated to the following structured JSON format:

{ "osId": "ab12Cdef-GiJ3-ab12-Cdef-ab12CdefGiJ3", "id": "ab12CdefGiJ3", "v": 2 }

This change applies to:

• Billed Reconciliation files
• Unbilled Reconciliation files

Why this change is happening

This update standardizes the ReferenceId to include both an identifier and version information, improving consistency and reliability when correlating reconciliation records across billing systems.

Partner impact

• Partners who parse or process ReferenceId as a string must update their logic to handle the JSON structure.
• No other reconciliation file schemas or attributes are impacted.
• Download locations and access methods remain unchanged.

Required partner action

• Review and update any reconciliation processing or reporting solutions to support the new ReferenceId JSON format before April 15, 2026.