8.1 File Naming Convention

All files that make up a Sales Report Message shall be named in accordance with the following syntax:

DSR_MessageRecipient_MessageSender_ServiceDescription_MessageNotificationPeriod_TerritoryOfUseOrSale_xofy_MessageCreatedDateTime.ext

With:

MessageRecipient

The Party Name or DDEX Party ID (DPID) of the Message Recipient.

The MessageRecipient may be omitted if the Sales Report Message is sent to more than one recipient. This information shall be the same as the information conveyed in the file Header (HEAD). Note: DDEX Party IDs do not contain special characters.

MessageSender

The Party Name or DDEX Party ID (DPID) of the MessageSender.

This information shall be the same as the information conveyed in the appropriate Record. Note: DDEX Party IDs do not contain special characters.

ServiceDescription

A description of the service name (e.g. a service tier) to be reported on. Multiple tiers can be communicated by separating them with dashes.

This information shall be the same as the information conveyed in the file Header (HEAD).

Message-
Notification-
Period

The reporting Period covered by the Message in accordance with ISO 8601:2004. The only allowed syntaxes are:

  • yyyy for a year

  • yyyy-mm for a month

  • yyyy-mm-dd for a day

  • yyyy-Qq for a quarter

  • yyyy-Www for a week (starting on a Monday)

  • yyyy-mm-dd--yyyy-mm-dd with the two dates being the start and end date of the period (note the twodashes between the two dates).

TerritoryOf-
UseOrSale

The territory for which the Usage, Revenue or Sale transactions in this message are reported.

The TerritoryOfUseOrSale shall be provided as a single ISO Territory Code if one territory is to be communicated. Otherwise, the MessageSender and MessageRecipient(s) shall agree a value acceptable to both/all.

xofy

The file counter.

For example, the 7th file of a 9-file Sales Report Message would be 7of9. This element may be omitted when the Sales Report Message is contained in a single file.

MessageCreated-DateTime

The date and time on which the Message was created (the only allowed format is the full basic ISO 8601:2004 format without a time zone designator: yyyyymmddThhmmss). The time zone is assumed to be the one of the MessageSender’s  location.

ext

The file extension, to be “.tsv.
When the file is compressed, for example with gzip, the extension should indicate this and may be .tsv.gz.

The following constraints apply:

  1. None of the file name elements may contain an underscore character.

  2. None of the file name elements may contain an space character.

  3. When a file name element is to be omitted, the two underscore characters to the left and right follow each other immediately.

  4. Other file naming conventions may be agreed on a bilateral basis (specifically for testing).

Search