ESS:Prices

From ESS
Jump to: navigation, search
Format ESS
Ess-feed-icon.png
.ess, .xml
application/ess+xml
version 0.9

"Prices" definition

An event is comprised of several attributes, one of the most important is to define the cost to attend the event. Event prices can be fixed or varied. Event prices are represented in ESS through two <item> element "type" attributes. This types represent every situations, price can take several aspects: "standalone" and "recurrent" :


standalone price event icon recurrent price event icon

STANDALONE PRICE

RECURRENT PRICE

Price is required only once.

Subscription every day, week, month or year.



Some price parameters should be specified to define if the prices are "fixed", "free", "invitation", "donation", "remunerated" or "prepaid" to attend the event.


fi price event icon invitation event icon free event icon be remunerated for this event icon

FIXED PRICE EVENT

EVENT WITH INVITATION

FREE EVENT

BE REMUNERATE FOR THE EVENT

Specific fixed price is defined.

Invitation is required to participate.

No fees are required to participate.

Receive money to attend the event.




ESS <prices> structure

ESS documents are composed by various main XML elements. ESS processors must consider each and every element's description as valid and applicable to each and every other XML element within the same ESS document. If it is not the case, it depends on another <ess> feed to describe this event parameter.
Example: every <prices> items must be valid and applicable to every <dates> and <places> items within the same <ess> feed.

<prices> XML element (ess:prices) must be defined within ESS Documents, it is a mandatory ESS XML element.
This section describes the interaction between ESS events and prices. <prices> (ess:prices) XML element must be composed by, at least, one <item> (ess:item) XML element.
Several <item> elements can be defined in <prices> XML structure to represent all event prices.




Prices <item @attibutes>


Name Description Type Required
type The "type" attribute can take two values: "standalone" or "recurrent" to represent if the event has a simple price or value. In the case of a type="recurrent", the "unit" attibute must be defined. ESS Processors should consider that "standalone" is the default attribute if it is not specified. String TRUE
mode The "mode" attribute can take six values: "fixed", "free", "invitation", "donation", "remunerated" or "prepaid" to represent the payment mode to attend the event. ESS Processors should consider that "fixed" is the default attribute if it is not specified. String TRUE
unit The "unit" attribute applies only if type="recurrent" is specified. The "unit" attribute can take five values: "hour", "day", "week", "month" or "year". ESS processors should consider unit="hour" as the default "unit" attribute if it is not specified. String TRUE
FALSE
limit The "limit" attribute applies only if type="recurrent" is specified. The "limit" attribute is optional and defines the number of times the recurrent event <item> will happen. If the "limit" attribute is not specified or if limit="0" ESS Processors should consider the <item> as infinite. Number FALSE
interval The "interval" attribute applies only if type="recurrent" is specified. The "interval" attribute is optional and defines the number of times the recurrent event <item> have to be repeated according to the unit="xxx" attribute value. If the "interval" attribute is not specified ESS Processors should be considered the <item> with a interval="1". Number FALSE
selected_day The "selected_day" attribute applies only if type="recurrent" is specified. The "selected_day" attribute can take eight values: "number", "monday", "tuesday", "wednesday", "thursday", "friday", "saturday" or "sunday". The "selected_day" attribute only applied if unit="week" or unit="month". The "selected_day" attribute is optional and defines the number of "unit" attribute that have to be repeated. Several values can be specified with a coma separation. String FALSE
selected_week The "selected_week" attribute applies only if type="recurrent" is specified. The "selected_week" attribute can take five values: "first", "second", "third", "fourth" or "last". The "selected_week" attribute only applies if unit="month". The "selected_week" attribute is optional and defines the section of the month that have to be repeated. Several values can be specified with a coma separation. String FALSE
priority The "priority" attribute refers to the order and the preference applied to each <item> XML element. ESS processors should consider the natural XML position as the priority if this attribute is not defined. Number FALSE



Prices <item> child elements


Name Description Type Required
<name> Language-sensitive price name. Should not be longer then 64 chars String TRUE
<value> Defines event price value. This number applies to the <currency> value. Number TRUE
<currency> Defines the 3 char currency (e.g. USD, EUR...). the <currency> XML element is mandatory only if <value> is superior to zero. Number ISO4217 TRUE
FALSE
<start> Defines an event's recurring price starting Date. Only applicable if type="recurrent". ESS processors should consider the <published> Date as default value if the <start> XML element is not specified. Date FALSE
<duration> Defines the duration in seconds when the price (entrance) will be available starting from the <start> XML element. Default value should be 0 for an infinite availability. Number FALSE
<description> This optional XML element contains the ticket specific description. Using HTML tags inside this XML element is possible but should be limited to the minimum necessary because ESS processors could use this information in an environment that can not read HTML. String FALSE
<quantity> Defines the quantity of places, tickets, reservations or invitations available for this event. Default value should be 0 for an infinite availability. Number FALSE
<minimum> Defines the minimum number of places, tickets, reservations or invitations that can be take per user to access to this event. Default value should be 1. Number FALSE
<maximum> Defines the maximum number of places, tickets, reservations or invitations that can be take per user to access to this event. Default value should be 0 for an infinite availability. Number FALSE
<uri> Defines an URL where users can validate their access to the event: payment page or webservice, invitation form, free event subscription. URI RFC3986 FALSE




ESS price sample

DTD description http://essfeed.org/history/0.9

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE ess PUBLIC "-//ESS//DTD" "http://essfeed.org/history/0.9/index.dtd">
<ess xmlns="http://essfeed.org/history/0.9" version="0.9" lang="en">
   ...
   <prices>
 
      <!-- 1 |  Simple one-shot event -->
      <item type="standalone" mode="fixed">
         <name>Fixed price event</name>
         <value>25</value>
         <currency>USD</currency>
      </item>
 
      <!-- 2 |  Be payed for the event  -->
      <item type="standalone" mode="remunerated">
         <name>Receive money to attend this event</name>
         <value>25</value>
         <currency>USD</currency>
      </item>
 
      <!-- 3 |  Free event -->
      <item type="standalone" mode="free">
         <name>Free event</name>
      </item>
 
      <!-- 4 |  Event with invitation -->
      <item type="standalone" mode="invitation">
         <name>Event for invited person only</name>
         <uri>http://sample.org/subscribe/invitation.html</uri>
      </item>
 
      <!-- 5 |  Event with monthly billing of a fixed price (without limit in time) -->
      <item type="recurrent" unit="month" mode="fixed">
         <name>Monthly billing</name>
         <value>10</value>
         <currency>USD</currency>
         <uri>http://sample.org/payment.asp?FID=123456789</uri>
         <start>2012-05-25T10:45:00Z</start>
      </item>
 
      <!-- 6 |  Event with bimestrial billing of a fixed price (without limit in time) 
                the bill is applicable the last monday every two months
       -->
      <item type="recurrent" mode="fixed" unit="month" limit="2" selected_day="monday" selected_week="last">
         <name>Bimestrial billing</name>
         <value>10</value>
         <currency>USD</currency>
         <uri>http://sample.org/payment.asp?FID=123456789</uri>
         <start>2012-05-28T10:45:00+0800</start>
      </item>
 
      <!-- 7 |  Event with prepaid entrances available during 7 days (604800 seconds) -->
      <item type="prepaid" mode="fixed">
         <name>Prepaid Entrance ONLY</name>
         <value>10</value>
         <currency>USD</currency>
         <uri>http://sample.org/payment.asp?FID=123456789</uri>
         <start>2012-03-25T10:45:00+06:00</start>
         <duration>604800</duration>
      </item>
   </prices>
   ...
</ess>



Discussions

ESS Forum Discussion > Prices

Could not find wordpress article with a title like home






External documentation

Ietf logo.png

ESS standard under RFC validation process: RFC ESS Draft

  • RFC 3076 : Canonical XML Version 1.0
  • RFC 3339 : Date and Time on the Internet: Timestamps
  • RFC 3987 : Internationalized Resource Identifiers (IRIs)
  • ISO 4217 : ISO 4217 Currency Codes

IF EVENTS MATTER TO YOU

Spread the news about ESS
Personal tools
Actions
Standard


Developers


Communication