How Can I Communicate Pre-Order Availability via XML?

Julie (Beatport) -

Pre-Order

Beatport now offers pre-order purchases for releases/tracks, at the discretion of the label and/or distributor. Offering content for pre-order is optional and changes to existing schema are not necessary if pre-order is not being offered for your content.

A pre-order start date indicates the date on which customers may begin previewing and ordering content prior to its official release.  Customers who pre-order content will not receive the actual assets until the original release date.

Beatport does not have the ability to suppress audio previews during the pre-order period.  If you do not want audio previews enabled do not enable your content for pre-order. 

Pre-order availability can be communicated via XML.*  Our XML schema is available here.

Pre-order can now also be enabled by default at the label level.  Please see the following article for more information:  https://beatportops.zendesk.com/hc/en-us/articles/115011610848-Can-my-content-be-set-up-for-pre-order-by-default-

In order to enable pre-order, simply include the following pre-order tag at the track level, prior to the closing track tag (</track).  The placement of this field within the XML is crucial as it must be placed immediately before the closing track tag or the XML will fail to validate upon ingestion.  

      <preOrderStartDate>yyyy-mm-dd</preOrderStartDate>
    </track>

For more information and XML examples please see below.

 *Pre-order fields do not currently exist in the 'Baseware Remote' application.  If packaging content using the 'Baseware Remote' application one must extract the XML from the delivery package and manually add this field, otherwise you may request this be set manually post-delivery by emailing a request to contentsupport@beatport.com.


Releases

A release will include a pre-order tag on the store if at least one track within the release is available for pre-order, however only those tracks for which a pre-order start date is indicated in the XML will appear on the release and be available for purchase during the pre-order period.

In order to ensure a full release is available for pre-order all tracks must indicate a pre-order start date in the XML.

Tracks

Tracks may each have the following optional field present:

preOrderStartDate: an optional field to indicate when a track is available for sale prior to the original release date.  The date/field may be omitted, which would imply that the track will not be available for pre-order and will not become available for sale prior to the original release date (aka sales start date).   The preOrderStartDate must not be later than the originalReleaseDate of the same track.

**This field must be placed immediately before the track closing tag (</track)**

      <preOrderStartDate>yyyy-mm-dd</preOrderStartDate>
    </track>

 

Examples

Full Release Pre-Order

The following is an example of a release in which both tracks are available for pre-order two weeks prior to the sales start date of January 14, 2017:


<?xml version="1.0" encoding="UTF-8"?>
<release>
  <album_action>insert</album_action>
  <aggregatorName>ABC Distribution</aggregatorName>
  <labelName>Beatport Records</labelName>
  <UPC_EAN>123456789012</UPC_EAN>
  <catalogNumber>BTPRT001</catalogNumber>
  <coverArtFilename>BTPRT001.jpg</coverArtFilename>
  <releaseTitle>First In Line</releaseTitle>
  <releaseDescription>A fine release.</releaseDescription>
  <tracks>
    <track>
      <albumOnly>0</albumOnly>
      <trackNumber>1</trackNumber>
      <ISRC>USBPT1700001</ISRC>
      <trackPublisher>Copyright Control</trackPublisher>
      <trackTitle>First In Line</trackTitle>
      <trackMixVersion>Chill Remix</trackMixVersion>
      <originalReleaseDate>2017-01-14</originalReleaseDate>
      <beatportExclusive>
        <exclusivePeriod>0</exclusivePeriod>
      </beatportExclusive>
      <trackArtists>
        <artistName>DJ Beatbot</artistName>
      </trackArtists>
      <trackAudioFile>
        <audioFilename>BTPRT001_1.wav</audioFilename>
        <digestType>MD5</digestType>
        <digestValue>000111000111000fffaaabbbcccdddeee</digestValue>
      </trackAudioFile>
      <countriesAvailable>
        <country>WW</country>
      </countriesAvailable>
      <sourceTrackId>123123123</sourceTrackId>
      <trackGenre>Electronica / Downtempo</trackGenre>
      <songwriters>
        <songwriter>
          <name>DJ Beatbot</name>
          <type>composer</type>
        </songwriter>
      </songwriters>
      <preOrderStartDate>2017-01-01</preOrderStartDate>
    </track>
    <track>
      <albumOnly>0</albumOnly>
      <trackNumber>2</trackNumber>
      <ISRC>USBPT1700002</ISRC>
      <trackPublisher>Copyright Control</trackPublisher>
      <trackTitle>First In Line</trackTitle>
      <trackMixVersion>Club Mix</trackMixVersion>
      <originalReleaseDate>2017-01-14</originalReleaseDate>
      <beatportExclusive>
        <exclusivePeriod>0</exclusivePeriod>
      </beatportExclusive>
      <trackArtists>
        <artistName>DJ Beatbot</artistName>
      </trackArtists>
      <trackAudioFile>
        <audioFilename>BTPRT001_2.wav</audioFilename>
        <digestType>MD5</digestType>
        <digestValue>fff111000111000fffaaabbbcccdddeee</digestValue>
      </trackAudioFile>
      <countriesAvailable>
        <country>WW</country>
      </countriesAvailable>
      <sourceTrackId>123123120</sourceTrackId>
      <trackGenre>Big Room | Electro House</trackGenre>
      <songwriters>
        <songwriter>
          <name>DJ Beatbot</name>
          <type>composer</type>
        </songwriter>
      </songwriters>
      <preOrderStartDate>2017-01-01</preOrderStartDate>
    </track>
  </tracks>
</release>


Partial Release Pre-Order

The following is an example of a release in which the first track is available for pre-order two weeks prior to the sales start date of January 14, 2017 but the second track is not available for pre-order and will only become available on the sales start date of January 14, 2017:

<?xml version="1.0" encoding="UTF-8"?>
<release>
  <album_action>insert</album_action>
  <aggregatorName>ABC Distribution</aggregatorName>
  <labelName>Beatport Records</labelName>
  <UPC_EAN>123456789012</UPC_EAN>
  <catalogNumber>BTPRT001</catalogNumber>
  <coverArtFilename>BTPRT001.jpg</coverArtFilename>
  <releaseTitle>First In Line</releaseTitle>
  <releaseDescription>A fine release.</releaseDescription>
  <tracks>
    <track>
      <albumOnly>0</albumOnly>
      <trackNumber>1</trackNumber>
      <ISRC>USBPT1700001</ISRC>
      <trackPublisher>Copyright Control</trackPublisher>
      <trackTitle>First In Line</trackTitle>
      <trackMixVersion>Chill Remix</trackMixVersion>
      <originalReleaseDate>2017-01-14</originalReleaseDate>
      <beatportExclusive>
        <exclusivePeriod>0</exclusivePeriod>
      </beatportExclusive>
      <trackArtists>
        <artistName>DJ Beatbot</artistName>
      </trackArtists>
      <trackAudioFile>
        <audioFilename>BTPRT001_1.wav</audioFilename>
        <digestType>MD5</digestType>
        <digestValue>000111000111000fffaaabbbcccdddeee</digestValue>
      </trackAudioFile>
      <countriesAvailable>
        <country>WW</country>
      </countriesAvailable>
      <sourceTrackId>123123123</sourceTrackId>
      <trackGenre>Electronica / Downtempo</trackGenre>
      <songwriters>
        <songwriter>
          <name>DJ Beatbot</name>
          <type>composer</type>
        </songwriter>
      </songwriters>
      <preOrderStartDate>2017-01-01</preOrderStartDate>
    </track>
    <track>
      <albumOnly>0</albumOnly>
      <trackNumber>2</trackNumber>
      <ISRC>USBPT1700002</ISRC>
      <trackPublisher>Copyright Control</trackPublisher>
      <trackTitle>First In Line</trackTitle>
      <trackMixVersion>Club Mix</trackMixVersion>
      <originalReleaseDate>2017-01-14</originalReleaseDate>
      <beatportExclusive>
        <exclusivePeriod>0</exclusivePeriod>
      </beatportExclusive>
      <trackArtists>
        <artistName>DJ Beatbot</artistName>
      </trackArtists>
      <trackAudioFile>
        <audioFilename>BTPRT001_2.wav</audioFilename>
        <digestType>MD5</digestType>
        <digestValue>fff111000111000fffaaabbbcccdddeee</digestValue>
      </trackAudioFile>
      <countriesAvailable>
        <country>WW</country>
      </countriesAvailable>
      <sourceTrackId>123123120</sourceTrackId>
      <trackGenre>Big Room | Electro House</trackGenre>
      <songwriters>
        <songwriter>
          <name>DJ Beatbot</name>
          <type>composer</type>
        </songwriter>
      </songwriters>
    </track>
  </tracks>
</release>

 

Please direct any questions regarding implementation of the pre-order field to submissions@beatport.com

 

Have more questions? Submit a request

1 Comments

Please sign in to leave a comment.
Powered by Zendesk