1

RecordType

The type of the Record which shall always contain the value SR08.01.

Fixed string

M

SR08.01

2

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

A13HG65

Release Data

3

GRid

The Global Release Identifier for the release allocated to it by the licensor.

A GRid comprises four parts: the xs:string 'A1', followed by five alphanumeric characters, ten alphanumeric characters and one alphanumeric character.

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

DDEX will enforce the syntax [a-zA-Z0-9]{18} using XML Schema in the future.

String

C

A1AAAAA1234567890X

4

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

5

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

M

1234567

6

LabelReleaseId

The proprietary identifier of the release assigned to it by the licensor which is provided to the licensee in a NewReleaseMessage or similar.

String

C

ABC

7

Proprietary ReleaseId

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

Multiple String::String

O

myns::4534|ns2::4345

8

ContextReleaseGRid

The GRid identifying another release from which the release that is being reported was taken. 

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

String

C

A1AAAAA1234567890X

9 (up-dated)

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

10

ReleaseTitle

The title of the release as displayed to end users.

A value in the ReleaseTitle Cell is mandatory if a resource has been distributed in the context of a Release.

String

C

Beatles for Sale

11

ReleaseSubTitle

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

String

O

Live Version

12

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

Coldplay vs. Swedish House Mafia

13

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

Resource Data

14

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.

String

C

USS1Z1412345

15

ResourceISAN

The International Standard Audiovisual Number (ISAN) as defined in ISO 15706 identifying the audiovisual work that makes up the resource.

An ISAN comprises four blocks of four hexadecimal characters followed by a check character followed, optionally by two further blocks of four hexadecimal characters, followed by a further check character. 

A value for the ResourceISAN 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

0000-0001-8947-0000-8-0000-0000-D

16

DspResourceId

The proprietary identifier of the resource assigned to it by the licensee. 

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

17

LabelResourceId

The proprietary identifier of the resource assigned to it by the licensor which is provided to the licensee in a NewReleaseMessage or similar.

String

C

12345678

18

Proprietary ResourceId

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

Multiple String::String

O

myns::4534|ns2::4345

19

ContextGrid

The Global Release Identifier identifying another release from which the resource that is being reported was taken.

The Global Release Identifier for the release allocated to it by the licensor.

A GRid comprises four parts: the xs:string 'A1', followed by five alphanumeric characters, ten alphanumeric characters and one alphanumeric character.

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

DDEX will enforce the syntax [a-zA-Z0-9]{18} using XML Schema in the future.

String

C

A1AAAAA1234567890X

20 (up-dated)

ResourceType

A description of the nature of the content of the resource.

AVS: Resource Type

M

SoundRecording

21 (up-dated)

ResourceTitle

The title of the resource as displayed to end users.

String

M

Roll over Beethoven

22

ResourceSubTitle

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

String

O

Live Version

23

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

Queen

24

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. 

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

Multiple Party Identifiers

O

ISNI::0000000081266409

Sales Data

25

SummaryRecordId

The identifier of the summary Record which shall be specific to the Sale/Usage Report. This identifier shall be used in the sales and/or usage data Records to indicate to which summary Record they provide details.

String

M

1224

26

SalesTransactionDate

The date of the transaction in the sales and/or usage data that is being reported in this Record.

The values in the remaining Cells of the Record relate to the sales and/or usage for this date.

Date

M

2017-06-01

27

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

28

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

12

29 (up-dated)

NetUsage

The number of Usages less the number of Returns in the reporting period.

Decimal

M

126.2

30

WholesalePriceIn CurrencyOfTransaction

The wholesale price of the releases or resources in the sub-period in the CurrencyOfTransaction. 

A value in the WholesalePriceInCurrencyOfTransaction Cell does not need to be provided in streaming models.

Deceimal

C

9.99

31

WholesalePrice InCurrencyOfReporting

The wholesale price of the releases or resources in the period in the CurrencyOfReporting. 

A value in the WholesalePriceInCurrencyOfReporting Cell does not need to be provided in streaming models.

Decimal

C

8.43

32

SuggestedEndUserPrice InCurrencyOfTransaction

The wholesale price of the releases or resources in the period in the CurrencyOfTransaction. 

A value in the SuggestedEndUserPrice InCurrencyOfTransaction Cell does not need to be provided in streaming models.

Decimal

C

15.0

33

SuggestedEndUserPrice InCurrencyOfReporting

A price agreed between the licensee and the licensor for the use of the releases or resources in the sub-period in the CurrencyOfReporting. 

A value in the SuggestedEndUserPrice InCurrencyOfReporting Cell does not need to be provided in streaming models.

Decimal

C

12.35

34

PriceType

A description of the type of amounts paid by end users.

The values used in the PriceType Cell are determined by the bilateral agreement between the licensee and the licensor. 

A value in either the PriceType or PriceRangeType Cell is mandatory, but not in both Cells.

String

C

X55

35

PriceRangeType

A description of the price ranges applied by the licensee for the use by end users of the releases or resources, in the sub-period. 

The values used in the PriceRangeType Cell are determined by the bilateral agreement between the licensee and the licensor.

A value in either the PriceRangeType or PriceTypeCell is mandatory, but not in both Cells.

String

C

Budget

36

PriceEndUserPaid ExcSalesTax InCurrencyOfTransaction

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 InCurrencyOfTransaction Cell does not need to be provided in streaming models.

Decimal

C

1.22

37

PriceEndUserPaid ExcSalesTax InCurrencyOfReporting

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

A value in the PriceEndUserPaiExcSalesTax InCurrencyOfReporting Cell does not need to be provided in streaming models.

Decimal

C

1.67

38

DeductionType

A description of the type of deduction that the licensee applies to its revenue before allocating revenue to the licensor in the CurrencyOfReporting. 

A value in the DeductionType Cell does not need to be provided in streaming models. 

The order of the values in the DeductionType, DeductionsInCurrencyOfTransaction and Deductions InCurrencyOfReporting Cells shall be the same so that the licensor is able to link the data items together.

Multiple Strings

C

AsPerContract

39

Deductions InCurrencyOfTransaction

The amount of the deductions that the licensee makes in the CurrencyOfTransaction to its revenue before allocating revenue to the licensor in the CurrencyOfReporting 

A value in the Deductions InCurrencyOfTransaction Cell is mandatory for each value in the DeductionTypeCell.

A value in the Deductions InCurrencyOfTransaction Cell does not need to be provided in streaming models

The order of the values in the DeductionType, Deductions InCurrencyOfTransaction and Deductions InCurrencyOfReporting Cells shall be the same so that the licensor is able to link the data items together.

Multiple Decimals

C

1452.24|12372.66

40

Deductions InCurrencyOfReporting

The deductions that the licensee applies to revenue before calculating the revenue allocated to the licensor in the CurrencyOfReporting. 

A value in the DeductionsInCurrencyOfReportingCell is mandatory for each value in the DeductionType Cell.

A value in the Deductions InCurrencyOfReporting Cell does not need to be provided in streaming models

The order of the values in the DeductionType, Deductions InCurrencyOfTransaction and Deductions InCurrencyOfReporting Cells shall be the same so that the licensor is able to link the data items together.

Multiple Decimals

C

1452.24|12372.66

41

RightSharePercentage

The percentage applied to revenue by the licensee to calculate AllocatedNetRevenue owed to the licensor. 

This data is especially useful for DJ Mixes.

A value in the RightSharePercentage Cell is mandatory if (i) the percentage is not 100% and (ii) the data is available.

Decimal

C

100

42

CalculatedUnitPrice InCurrencyOfTransaction

The amount calculated to be allocated to a single sales and/or usage transaction in the CurrencyOfTransaction. 

The value in the Calculated UnitPriceIn CurrencyOfTransaction Cell may be calculated from the values in any of the WholesalePrice InCurrencyOfTransaction, PriceType or PriceRangeType Cells. The exact mechanism of calculation is determined by the bilateral agreement between licensee and licensor.

Decimal

M

543.54

43

CalculatedUnitPrice InCurrencyOfReporting

The amount calculated to be allocated to a single sales and/or usage transaction in the CurrencyOfReporting. 

The value in the CalculatedUnitPrice InCurrencyOfReporting Cell may be calculated from the values in any of the WholesalePrice InCurrencyOfTransaction, PriceType or, PriceRangeType Cells. The exact mechanism of calculation is determined by the bilateral agreement between licensee and licensor.

Decimal

M

23.12

44

AllocatedRevenue InCurrencyOfTransaction

The amount of revenue allocated to the licensor by the licensee for the use of the licensor’s releases and/or resources, reported in the CurrencyOfTransaction. 

The value in the AllocatedRevenueIn CurrencyOfTransaction Cell would typically be the product of the values in the CalculatedUnitPriceInCurrencyOfTransaction and AllocatedUsages Cells.

Decimal

M

1.67

45

AllocatedRevenue InCurrencyOfReporting

The amount of revenue allocated to the licensor by the licensee for the use of the licensor’s releases or resources, reported in the CurrencyOfReporting. 

The value in the  AllocatedRevenue InCurrencyOfReporting Cell would typically be the product of the values in the CalculatedUnitPrice InCurrencyOfReporting and AllocatedUsages Cells.

Decimal

M

1.67

46

AllocatedNetRevenue InCurrencyOfTransaction

The amount of the net revenue generated by the licensee that is allocated to the licensor for the use of the licensor’s releases or resources, reported in the CurrencyOfTransaction.

Decimal

M

1.67

47

AllocatedNetRevenue InCurrencyOfReporting

The amount of the net revenue generated by the licensee that is allocated to the licensor for the use of the licensor’s releases or resources, reported in the CurrencyOfReporting.

Decimal

M

1.67

48

CopyrightObligation WithDSP

A flag that indicates whether the obligation to report sales and/or usages to the owner(s) or administrator(s) of the musical works embodied in the sound recordings that make up the releases or resources lies with the licensee (true) or not (false). 

Boolean

M

true

Release Data (addition)

49 (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

Resource Data (addition)

50 (new)

Resource DisplayArtist

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

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

Sales Data (addition)

50 (new)

AllocatedUsages

The number of sales and/or usage from the TotalUsages allocated to the rights controller or licensor, as determined by the bilateral agreement between the licensee and the licensor, by the licensee.

Decimal

C

10.5