CDM 2.0 Samples

This article provides a CDM v2.0 sample for a variety of use cases. An Excel file with all three samples can be downloaded here.

Claiming round 1 (using CD01)

The message exchange starts with the works making 19 claims in CD01 records. The following data points should be noted:

  • The message provides data in the ClaimsAmounts profile in version 2.0 (CDMH.01 cells Profile and ProfileVersion, respectively); and

  • All royalty amounts claimed can be found by looking the TotalClaimedAmount of the CS01 record as well as summing up all ClaimedAmounts of all CD01.01 records. Both come up with €101.781 (the currency is provided in the CurrencyOfInvoicing of the CS01 record).

Screenshot 2026-09-16 at 16.47.53.png

Claiming round 1 (using CR01).

Instead of using CD01 records, the rights controller could also use CR01 records as shown below. In this approach each claim, and claim amount is split into three values: the current claim/amount, the previously claimed percentage/amount and the difference between these two. Therefore, instead of six cells in CD01 (ShareClaimedMech, ShareClaimedPerf, ShareClaimedBlended, ClaimedAmountMech, ClaimedAmountPerf and ClaimedAmount), CR01 will have 18 cells.

Screenshot 2026-09-16 at 16.50.26.png

Please note that no values are provided for the previous claim percentage and the difference (also called the “delta”) between the old and the new claim - there was, after all, no previous claim and, therefore, providing old claim information is not needed.

Contrary to communicating claims, the message sender should however provide previously provided royalty amounts (with a value of 0) as well as a delta (with the same value as the newly claimed amount) when communicating new claims using CR01. The reason for this will become clear when looking at the CDM message for the second claiming round.

Claiming round 2

Regardless of whether round one is communicated using CD01 or CR01, any updates have to be made in round two using CR01.

In the sample message shown below the following updates are shown:

  1. An increase of a claim percentage leading to an increase of the claimed royalty amount;

  1. A decrease of a claim percentage leading to a decrease of the claimed royalty amount;

  1. An increase of the tariff value (here: the minimum) without a claim change leading nevertheless to an increase of the claimed royalty amount;

  1. A decrease of the tariff value (here: the minimum) without a claim change leading nevertheless to a decrease of the claimed royalty amount;

  1. A full withdrawal of a claim and its corresponding royalty amount; and

  1. A new musical work claimed.

Screenshot 2026-09-16 at 16.51.32.png

Claims CL10122 and CL10126 represent Use Cases 1 and 2  – a change of the claimed percentages.

The recipient can detect that this is an updated claim as (i) there is a value in the CorrectedClaimId cell and (ii) the message sender provided current, old and delta figures for the claim percentages.

In Claim CL10122 the claims for mechanical, performance and the blend are decreased from 100% to 50% with the result of a negative change in the royalty amount claimed, indicating a refund if necessary.

In Claim CL10126 the claims for mechanical, performance and the blend are increased from 50% to 80% with the result of a positive change in the royalty amount claimed.

Claim CL10123 is a special case of a change to the claimed percentage. It is representing Use Case 5 – a complete withdrawal of the claim (from 100% to 0%) – with a complete reversal of the royalty amount claimed.

Claims CL10105 and CL10106 represent Use Cases 3 and 4 – a change of the tariff parameter from 0.01 to 0.005 and from 0.01 to 0.02, respectively. No changes to the claim percentages are being reported.

The recipient can detect that this is an updated claim as (i) there is a value in the CorrectedClaimId cell and (ii) the message sender provided current, old and delta figures for the claim percentages. In this case, however the old and new claim percenters are always the same, and the delta is always zero; only the royalty amounts claimed are changed.

Claims CL10113, CL10115, CL10117, CL10118 and CL10127 represent Use Case 6 – completely new claims.

The recipient can detect that these are new claims as (i) there is no value in the CorrectedClaimId cell and (ii) the message sender did not provide current, old and delta figures for the claim percentages.

As indicated above, the royalty amounts are always communicated as three values: the amount claimed now, the amount claimed previously (which can be zero if the claim is new) and the delta between these two.

The benefit of adding a previous amount and delta, even for new cases, is that the delta always communicates the impact on any royalties claimed by the works licensor. This is the preferred approach and is signalled by communicating the value Delta in the cell ClaimImpact of each CR01 record.

If should be noted that the standard also supports an approach where new claims are communicated without any data in the previous and delta cells. In that case the cell ClaimImpact of each CR01 record should be set to Claim and the message recipient would need to look into either the ClaimedAmountDelta cell (for updated claims) or the ClaimedAmount cell (for new claims) to assess the impact of the claim.

Search