1

RecordType

The type of the Record which shall always contain the value SR01.02.

Fixed string

M

SR01.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 resource assigned to it by the licensee.

String

M

12345678

4 (up-dated)

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.

Strng

O

Live Version

7 (up-dated)

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 Resource DisplayArtistPartyId and Resource DisplayArtistName Cells shall be the same so that the licensor is able to link names and identifiers correctly.

A value in the Resource DisplayArtistPartyId Cell is mandatory if available to the licensee.

Information on DisplayArtistNames and DisplayArtists can be found on the DDEXknowledge base (kb.ddex.net).

Multiple Party Identifiers

C

ISNI::0000000081266409

9

Resource Duration

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: Resource Type

M

SoundRecording

11

Proprietary MusicalWorkId

Any proprietary identifier(s) of the musical work. To identify the assignee the identifier is preceded by a namespace identifier in the syntax ns::id.

Multiple Strings

O

myns::4534

12

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

13

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

14

MusicalWork ComposerAuthorPartyId

The identifier(s) of the party(ies) identified in the MusicalWorkComposerAuthorName 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 MusicalWork ComposerAuthorPartyId and MusicalWork ComposerAuthorName Cells shall be the same so that the licensor is able to link names and identifiers correctly.

Multiple Party Identifiers

O

ISNI::0000000081266409

15

MusicalWork ArrangerName

The name of any arranger(s) of the musical work embodied in the resource.

A value in the MusicalWorkArrangerName 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 MusicalWorkArrangerName and  MusicalWorkArrangerPartyId Cells shall be the same so that the licensor is able to link names and identifiers correctly.

Multiple Strings

C

August Wilhelmj

16

MusicalWork ArrangerPartyId

The identifier(s) of the party(ies) identified in the MusicalWorkArrangerName Cell. 

A maximum of one value in the MusicalWorkArrangerPartyId Cell can be provided for each value in the MusicalWorkArrangerName 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

17

MusicalWork PublisherName

The name of the music publisher(s) of the musical work embodied in the resource.

A value in the MusicalWorkPublisherName 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 MusicalWorkPublisherName and MusicalWorkPublisherPartyId Cells shall be the same so that the licensor is able to link names and identifiers correctly.

Multiple Strings

C

UMP

18

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

19

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

20

MusicalWork ContributorPartyId

The identifier(s) of the party(ies) identified in the MusicalWork ContributorName 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

21

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

22

Proprietary ReleaseId

Any proprietary identifier(s) of the release. To identify the assignee the identifier is preceded by a namespace identifier in the syntax ns::id.

Multiple Strings

O

myns::4534|ns2::4345

23

ReleaseCatalogNumber

The catalogue number of the release assigned to it, usually by the record company issuing the release.

String

O

123456

24

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 Article 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

25 (up-dated)

Release DisplayArtistName

The name of the main or principal artist of the release.

A value in the ReleaseDisplayArtistName 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

26

Release DisplayArtistPartyId

The identifier(s) of the party(ies) identified in the ReleaseDisplayArtist Cell.

The order of the values in the ReleaseDisplayArtistPartyId 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

27

ReleaseTitle

The title of the release as displayed to end users. 

String

M

Beatles for Sale

28

ReleaseSubTitle

A string which is supplementary to, but not contained within, a ReleaseTitle

String

O

Live Version

29

ReleaseType

A description of the manner in which a record company has authorised a licensee to offer the releases to end users.

AVS: Release Type_DSR

O

Album

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

Release DataProviderName

The name of the entity that provided the release data to the licensee. 

If the licensee generated the release data provided in this Record, the ReleaseDataProviderName Cell shall contain the name of the licensee.

String

O

UMG

33

NumberOf TransactedResources

The number of sales and/or usage of the resource(s) identified in the ResourceTitle Cell. 

If multiple resources were sold or used in the form of a 10-track release, then the value in the NumberOfTransactedResources Cell shall be 10. 

If a single resource is sold or used (that is, not in the form of a release), the value in the NumberOfTransactedResources Cell shall be 1.

Integer

M

12

34

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

35

IsRoyaltyBearing

A flag indicating whether the licensee is contractually obliged to pay royalties to the licensor for the sales and/or usage being reported in the Record.

Boolean

M

true

36

SalesUpgrade

A flag indicating whether the sales and/or usage data applies to an upgraded release where the value is true, or, not where the value is false.

Boolean

M

false

37 (up-date)

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

38

Returns

The number of sales and/or usage of the releases or resources that were returned with refunds where relevant by all end users.

A value may be added to the Returns Cell  as a result of a reversal of a sales and/or usage during the period of reporting contained in a DSR message or because of an earlier error in a DSR message previously provided to a licensor by a licensee. 

If no Returns are to be reported, the value for the Cell shall be 0.

Decimal

M

2

39

PriceEndUserPaid ExcSalesTax

A price paid by end users, excluding sales tax for each individual sale and/or usage in the CurrencyOfTransaction. This may be a nominal price. 

A value in the PriceEndUserPaidExcSalesTax Cell is mandatory if the value for the CommercialModel Cell is PayAsYouGoModel.

Decimal

C

100.34

40

Calculated PriceEndUserPaid ForResource ExcSalesTax

The calculated price the end user paid for each resource contained in the release transacted and being reported in this Record. The CalculatedPrice EndUserPaidForResource ExcSalesTax multiplied by the number of resources contained in the transacted release should equal the PriceEndUserPaid ExcSalesTax.

A value in the CalculatedPrice EndUserPaidForResource ExcSalesTax Cell is mandatory if required by the bilateral agreement between the licensor and the licensee.

Decimal

C

0.64

41

PromotionalActivity

The description of the type of any promotional activity.

The detailed definitions of the values used in the PromotionalActivity Cell are determine by the bilateral agreement between the licensee and the licensor.  

A value for PromotionalActivity Cell is mandatory if a specific promotional activity has been taking place during the period of the sales and/or usage data contained in a DSR message.

String

O

Valentines Day Special

42

ReleaseDate

The date when the release was first made available, whether for physical or electronic/online distribution.

Date

O

1969-08-26

43

UseType

A description of the way in which an end user uses a service.

The value in the UseType Cell also enables the communication of which type of device an end user has used to access the service. This is achieved by using the UseType value UseAsDevice.

A value in the UseType Cell is mandatory if there is no UseType on the relevant sales and/or usage data Record(s).

AVS: UseType_DSR

C

PermanentDowload

44 (new)

Resource DisplayArtist

The name of the display artist(s) of the resource that make up the value in the ResourceDisplayArtistName.

The order of the values in the ResourceDisplayArtist and ResourceDisplayArtistPartyId 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

45 (new)

Release DisplayArtist

The name of the display artist(s) of the release that make up the value 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