Cell Name | Definition | Data type | M/O/C | Example |
1 | RecordType
| The type of the Record which shall always contain the value SR03.02. | Fixed string | M | SR03.02 |
2 | SummaryRecordId
| The identifier, which shall be specific to the DSR message, of the summary Record for which this sales and/or usage Record provides details. This identifier shall be used in the sales and/or usage data Records to indicate to which summary Record they provide details. | String | M | 34 |
3 | DspResourceId
| The proprietary identifier of the release assigned to it by the licensee. | String | M | 12345678 |
4 | ResourceISRC
| The International Standard Recording Code (ISRC) as defined in ISO 3901 identifying the sound recording(s) that makes up the resource. An ISRC comprises four parts: two characters, followed by three alphanumeric characters, then two digits and five digits. A value in the ResourceISRC Cell is mandatory if available to the licensee. This field is important for licensors for their processing and would ideally be mandatory in this part of the DSR standard. However, as there are rare cases where licensees genuinely do not have this data, the Cell is conditional. | Multiple Strings | C | USS1Z1412345 |
5 | ResourceTitle
| The title of the resource as displayed to end users. | String | M | Eight Days a Week |
6 | ResourceSubTitle
| A string which is supplementary to, but not contained within, a ResourceTitle. | String | O | Live Version |
7 | Resource DisplayArtistName
| The name of the main or principal artist of the resource. A value in the ResourceDisplayArtistName Cell is mandatory if available to the licensee. It may be omitted if not available, especially in the case of user generated content services. Information on DisplayArtistNames and DisplayArtists can be found on the DDEX knowledge base (kb.ddex.net). | String | C | The Beatles |
8 (up-dated) | Resource DisplayArtistPartyId
| The identifier(s) of the party(ies) identified in the ResourceDisplayArtist Cell. The order of the values in the ResourceDisplayArtistPartyId and ResourceDisplayArtist Cells shall be the same so that the licensor is able to link names and identifiers correctly. A value in the ResourceDisplayArtistPartyId Cell is mandatory if available to the licensee. Information on DisplayArtistNames and DisplayArtists can be found on the DDEX knowledge base (kb.ddex.net). | Multiple Party Identifiers | C | ISNI::0000000081266409 |
9 | ResourceDuration
| The duration of the sound recording contained in the resource using the ISO 8601 format, PT[[hhH]mmM]ssS format, where lower case characters indicate variables and upper case characters are part of the string. For example, one hour, two minutes and three seconds would be PT1H2M3S. The seconds section ss may include fractions. For example, one minute and 30.5 seconds would be PT1M30.5S. A value in the ResourceDuration Cell is mandatory if available to the licensee. | Duration | C | PT1H2M3S |
10 | ResourceType
| A description of the nature of the content of the resource. | AVS: ResourceType | M | SoundRecording |
11 (up-dated) | MusicalWorkTitle
| The title of the musical work as displayed to end users. A value in the MusicalWorkTitle Cell is mandatory if it differs from the value in the ResourceTitle Cell. | String | C | Yellow Submarine |
12 | DspMusicalWorkId
| The proprietary identifier of the musical work assigned to it by the licensee. | String | M | 12345678 |
13 | MusicalWorkISWC
| The International Standard Musical Work Code (ISWC) as defined in ISO 15707 identifying the musical work embodied in the sound recording. An ISWC comprises three parts: the letter 'T', followed by nine digits and then one check digit. ISWCs have no dashes. A value in the MusicalWorkISWC Cell is mandatory if available to the licensee. This field is important for licensors for their processing and would ideally be mandatory in this part of the DSR standard. However, as there are rare cases where licensees genuinely do not have this data, the Cell is conditional. | String | C | T0030749586 |
14 | MusicalWork ComposerAuthorName
| The name of composer(s) and/or author(s) of the musical work embodied in the resource. A value in the MusicalWork ComposerAuthorName Cell is mandatory if available to the licensee. This field is important for licensor for their processing and would ideally be mandatory in this part of the DSR standard. However, as there are rare cases where licensees genuinely do not have this data, the Cell is conditional. The order of the values in the MusicalWork ComposerAuthorName and MusicalWork ComposerAuthorPartyId Cells shall be the same so that the licensor is able to link names and identifiers correctly. | Multiple Strings | C | Johann Sebastian Bach |
15 | MusicalWork ComposerAuthorPartyId
| The identifier(s) of the party(ies) identified in the MusicalWork ComposerAuthorName Cell. A maximum of one value in the MusicalWork ComposerAuthorPartyId Cell can be provided for each value in the MusicalWork ComposerAuthorName Cell. The order of the values in the MusicalWorkComposerAuthorPartyId and MusicalWorkComposerAuthorName Cells shall be the same so that the licensor is able to link names and identifiers correctly. | Multiple Party Identifiers | O | ISNI::0000000081266409 |
16 | MusicalWork ArrangerName
| The name of any arranger(s) of the musical work embodied in the resource. A value in the MusicalWork ArrangerName Cell is mandatory if available to the licensee. This field is important for licensors for their processing and would ideally be mandatory in this part of the DSR standard. However, as there are rare cases where licensees genuinely do not have this data, the Cell is conditional. The order of the values in the MusicalWork ArrangerName and MusicalWork ArrangerPartyId Cells shall be the same so that the licensor is able to link names and identifiers correctly. | Multiple Strings | C | August Wilhelmj |
17 | MusicalWork ArrangerPartyId
| The identifier(s) of the party(ies) identified in the MusicalWork ArrangerName Cell. A maximum of one value in the MusicalWork ArrangerPartyId Cell can be provided for each value in the MusicalWork ArrangerName Cell. The order of the values in the MusicalWorkArrangerPartyId and MusicalWorkArrangerName Cells shall be the same so that the licensor is able to link names and identifiers correctly. | Multiple Party Identifiers | O | ISNI::0000000081266409 |
18 | MusicalWork PublisherName
| The name of the music publisher(s) of the musical work embodied in the resource. A value in the MusicalWork PublisherName Cell is mandatory if available to the licensee. This field is important for licensors for their processing and would ideally be mandatory in this part of the DSR standard. However, as there are rare cases where licensees genuinely do not have this data, the Cell as conditional. The order of the values in the MusicalWork PublisherName and MusicalWork PublisherPartyId Cells shall be the same so that the licensor is able to link names and identifiers correctly. | Multiple Strings | C | UMP |
19 | MusicalWork PublisherPartyId
| The identifier(s) of the party(ies) identified in the MusicalWorkPublisherName Cell. A maximum of one value in the MusicalWork PublisherPartyId Cell can be provided for each value in the MusicalWork PublisherName Cell. The order of the values in the MusicalWork PublisherPartyId and MusicalWork PublisherName Cells shall be the same so that the licensor is able to link names and identifiers correctly. | Multiple Party Identifiers | O | ISNI::00000000111111111 |
20 | MusicalWork ContributorName
| The name of any other contributor(s) to the musical work embodied in the resource. This Cell shall only be used if the licensee does not know whether the contributor is a composer and/or author or an arranger, or if the contributor played a role other than as a composer and/or author or arranger. A value in the MusicalWork ContributorName Cell is mandatory if available to the licensee unless the contributor has already been included as a composer and/or author, arranger or music publisher. This field is important for licensor for their processing and would ideally be mandatory in this part of the DSR standard. However, as there are rare cases where licensees genuinely do not have this data, the Cell is conditional. The order of the values in the MusicalWork ContributorName and MusicalWork ContributorPartyId Cells shall be the same so that the licensor is able to link names and identifiers correctly. | Multiple Strings | C | UMP |
21 | MusicalWork ContributorPartyId
| The identifier(s) of the party(ies) identified in the MusicalWorkContributorName Cell. A maximum of one value in the MusicalWork ContributorPartyId Cell can be provided for each value in the MusicalWork Contributor Cell. The order of the values in the MusicalWork ContributorPartyId and MusicalWork ContributorName Cells shall be the same so that the licensor is able to link names and identifiers correctly. | Multiple Party Identifiers | O | ISNI::0000000081266409 |
22 | DspReleaseId
| The proprietary identifier of the release assigned to it by the licensee. A value in the DspReleaseId Cell is mandatory if the sales and/or usage data is provided in respect of a resource that has been distributed in the context of a release. A value in the DspReleaseId Cell is mandatory if the sales and/or usage data contained in the Sale/Usage Report is in respect of a release for which the licensee has data. | String | C | 1234567 |
23 | Proprietary ReleaseId
| Any proprietary identifier of the release preceded by a namespace identifier in the syntax ns::id. | Multiple Strings | O | myns::4534|ns2::4345 |
24 | Release CatalogNumber
| The catalogue number of the release assigned to it, usually by the record company issuing the release. | String | O | 123456 |
25 | ReleaseIcpn
| The International Code Product Number (ICPN) used as proxy for identification of the release. An ICPN comprises 12 or 13 digits, depending on whether it is an European Artcile Number (EAN) which has 13 digits or a Universal Product Code which has 12 digits. It is also permitted for ICPNs to contain 14 digits. A value in the ReleaseIcpn Cell is mandatory if available to the licensee. This field is important for licensors for their processing and would ideally be mandatory in this part of the DSR standard. However, as there are rare cases where licensees genuinely do not have this data, the Cell is conditional. | String | C | 12345678904321 |
26 | Release DisplayArtistName
| The name of the main or principal artist of the release. A value in the Release DisplayArtistName Cell is mandatory if available to the licensee. Information on DisplayArtistNames and DisplayArtists can be found on the DDEX knowledge base (kb.ddex.net). | String | C | Coldplay vs. Swedish House Mafia |
27 (up-dated) | Release DisplayArtist PartyId
| The identifier(s) of the party(ies) identified in the ReleaseDisplayArtist Cell. The order of the values in the Release DisplayArtistPartyId and ReleaseDisplayArtist Cells shall be the same so that the licensor is able to links names and identifiers correctly. Information on DisplayArtistNames and DisplayArtists can be found on the DDEX knowledge base (kb.ddex.net). | Multiple Party Identifiers | O | ISNI::000000011551 394X|ISN::0000000121510091 |
28 | ReleaseTitle
| The title of the release as displayed to end users. | String | M | Beatles for Sale |
29 | ReleaseSubTitle
| A string which is supplementary to, but not contained within, a ReleaseTitle | String | O | Live Version |
30 | ReleaseLabelName
| The name of the record company (or distributor) that provided the release to the licensee. | String | O | Apple Records |
31 | ReleasePLine
| The identifier, known as a PLine, that identifies the owner of the rights in the resources on the release. | String | O | ℗1970 Apple Records |
32 | SalesTransactionId
| The proprietary identifier of the sales and/or usage Record, which is allocated by the licensee, and which enables any communication about a DSR message to reference directly back to an individual sales and/or usage Record. The SalesTransactionId taken together with the MessageId in the HEAD Record shall be globally and perpetually unique. The SalesTransactionId may change if the DSR message has to be re-generated. | String | M | 34456 |
33 | Usages
| The number of sales and/or usages to all end users of all the releases or resources available across the licensee’s service, for the sales context defined in the summary record referenced through the SummaryRecordId Cell, during the reporting period, including any sales adjustments. Sales adjustments include for example, file failures. All values in the Usages Cell which point to the same summary Record are aggregated into the value of the TotalUsages Cell in that summary Record. The exact definition of the term Usages may be determined by the bilateral agreement between the licensee and the licensor. | Decimal | M | 1000 |
| NetRevenue
| The revenue generated by the licensee for the distribution of releases or resources or musical works. The value in the NetRevenue Cell is calculated after taking in account any data provided in the RightShare or RightsType Cells. The exact definition of what constitutes NetRevenue is determined by the bilateral agreement between the licensee and the licensor or by applicable law or regulation, any of which may include financial adjustments, for example purchased file failures. | Decimal | C | 10545.12 |
35 (up-dated) | ValidityPeriodStart
| The start date, provided by the licensor, of the validity period for the values in the RightsControllerName and RightSharePercentage Cells in the RC01 Record. The ValidityPeriodStart value may be earlier or later than the UsageStartDate of the period covered by the DSR message. This enables, licensors to report to the licensee changes to the identity of the RightsController within the UsageStartDate and UsageEndDate covered by the DSR message. | Date | C | 2015-06-01 |
36 (up-dated) | ValidityPeriodEnd
| The end date, provided by the licensor, of the validity period for the values in the RightsControllerName and RightSharePercentage Cells in the RC01 Record. The ValidityPeriodEnd value may be earlier or later than the UsageEndDate of the period covered by the DSR message. This enables, licensors to report to the licensee changes to the identity of the rights controller within the UsageStartDate and UsageEndDate covered by the DSR message. | Date | C | 2015-06-15 |
37 (up-dated) | ContentCategory
| A string categorising the nature of the content of the resource which is the subject of the sales and/or usage Record. The detailed definitions of the values in the ContentCategory Cell are determined by the bilateral agreement between the licensee and the licensor. | String | O | Music |
38 (up-dated) | RightsControllerName
| The name of the owner or administrator that is believed by the licensee to own or administer a RightShare in the musical work that is the subject of the Record. If an SR Record references more than one rights controller, the licensee and the licensor shall agree a mutually acceptable keywords (e.g. "all" or "conflict") to convey the required data. Clearly, the licensee and the licensor must take care to use keywords that do not conflict with actual RightsControllerName(s). | String | M | SACEM |
39 | RightsController PartyId
| The identifier(s) of the party identified in the RightsControllerName Cell. | Multiple Party Identifier | C | ISNI::0000000081266409 |
40 | RightsController MusicalWorkId
| The proprietary identifier given to the musical work embodied in the resource by the rights controller | String | O | 12gc |
41 | RightSharePercentage
| The percentage that is believed by the licensee to be claimed by the the owner(s) or administrator(s) of the musical work embodied in the resource that is the subject of the Record for the value contained in the RightsType Cell. It is mandatory for the value of the RightSharePercentage Cell to be provided as a decimal between 0 and 100. It is mandatory for values for the RightSharePercentage Cell and for the RightsType Cell to be provided together. | Decimal | C | 33.33 |
42 | RightsType
| A description of the type of right that has been exploited by the licensee in providing the service to end users and for which the RightSharePercentage is reported. It is mandatory for values in the RightsType Cell and for the RightSharePercentage Cell to be provided together. | AVS: Rights Coverage | C | MechanicalRight |
43 | AllocatedRevenue
| The amount of the revenue generated by the licensee, as reported in the NetRevenue Cell, that is allocated by the licensee with reference to the values in the RightSharePercentage and RightsType Cells to the rights controller or licensor, as determined by the bilateral agreement between the licensee and the licensor, in the CurrencyOfTransaction. The AllocatedRevenue is the basis of all further calculations. | Decimal | C | 34567 |
44 | AllocatedAmount
| The amount as calculated by the licensee, in respect of the value in the AllocatedRevenue Cell, with reference to the values in the RightSharePercentage and RightsType Cells that is nominally due to be paid to the rights controller or licensor, as determined by the bilateral agreement between the licensee and the licensor, in the CurrencyOfTransaction. The AllocatedAmount is typically calculated with reference to the AllocatedRevenue. The precise mechanism for calculating the AllocatedAmount is determined by the bilateral agreement between the licensee and the licensor. | Decimal | C | 2560.77 |
45 | AllocatedUsages
| The number of usages allocated by the licensee, in respect of the value in the Usages Cell, with reference to the values in the RightSharePercentage and RightsType Cells to the rights controller or licensor, as determined by the bilateral agreement between the licensee and the licensor. The precise mechanism for calculating the AllocatedUsages is determined by the bilateral agreement between the licensee and the licensor. | Decimal | C | 10.5 |
46 | Deprecated Cell (AllocatedNetUsage) |
47 (new) | Resource DisplayArtist
| The name of the display artist(s) of the resource that make up the value in the Resource DisplayArtistName Cell. The order of the values in the Resource DisplayArtist and Resource DisplayArtistPartyId Cells shall be the same so that the licensor is able to link names and identifiers correctly. Information on DisplayArtistNames and DisplayArtists can be found on the DDEX knowledge base (kb.ddex.net). | Multiple Strings | O | Coldplay|Swedish House Mafia |
48 (new) | Release DisplayArtist
| The name of the display artist(s) of the release that make up the value(s) in the ReleaseDisplayArtistName. The order of the values in the ReleaseDisplayArtist and ReleaseDisplayArtistPartyId Cells shall be the same so that the licensor is able to link names and identifiers correctly. Information on DisplayArtistNames and DisplayArtists can be found on the DDEX knowledge base (kb.ddex.net). | Multiple Strings | O | Coldplay|Swedish House Mafia |