diff --git a/docs/Prices.md b/docs/Prices.md new file mode 100644 index 0000000..d75d39c --- /dev/null +++ b/docs/Prices.md @@ -0,0 +1,89 @@ +[**◀ Home**](index.md) + +# Prices + +This provides an overview and documentation for the [prices](https://swissrets.ch/docs/noNamespace/complexType/prices.html) tag. + +## Explanation + +Prices defined in a property are essential. Because of it's inherit complexity and to make sure the values are understood correctly please refer to this guide as to what actually means what. + +## Fixed price (buy) + +Property for sale with a fixed price. +* **extra**: TODO: Good question? Is this similar to yearlyOperationAndMaintenanceCosts? +* **wirPercentage**: The percententage of the gross price which has to paid in WIR Franc electronic currency. + +```xml + + active + + + 850000 + 25000 + 5 + + + +``` + +## Auction + +Property for sale within an auction. Bidders can consequently increase the current standing of the auction price. The last bidder usually wins. + +The element `` has the following distinctions: + +* **start:**: The time the property is up for auction and for sale. +* **expiration:**: The time when the property can not be auctioned any longer and gets disabled. +* **minimalIncrease:**: To a amount that is required for each bid to increase. +* **value:**: The starting price + +```xml + + active + + 745 + + +``` + +## Bidding process + +Property for sale within a bidding war. Here anyone can bid a sum that is larger or equal to the asking price. The bidder with the largest commitment usually wins. + +The element `` has the following distinctions: + +* **start:**: The time that bidding can commence. +* **bindingStart**: The start where offers become legally binding. +* **expiration:**: The time when the property gets removed from the bidding War. +* **value:**: The minimal asking price + +```xml + + active + + 745 + + +``` + +## Property for rent. + +* **gross**: The total price (net + extra) +* **net**: The cost minus extra costs (gross - extra) +* **extra**: the difference between gross and net (gross - net) + +Usually only two are required and the third can be calculated based on the other two. But the XML generator can choose to provide all three. + +```xml + + active + + + 8500 + 7500 + 1000 + + + +``` diff --git a/docs/index.md b/docs/index.md index d9c5a5f..a47a330 100644 --- a/docs/index.md +++ b/docs/index.md @@ -25,6 +25,7 @@ Schema location declaration for validation. 1. Details - [Attachments](./Attachments.md) - images, documents, links - [Availability](Availability.md) - lifecycle states + - [Prices](Prices.md) - Some clarifications for pricings (buy, rent, auction, bidding) - [Categories](Categories.md) - categorization - [Characteristics](./Characteristics.md) - facts and features - [Applicables](./Characteristics.md#type-applicable) diff --git a/schema/schema.xsd b/schema/schema.xsd index 80695a3..8601fa8 100644 --- a/schema/schema.xsd +++ b/schema/schema.xsd @@ -730,6 +730,21 @@ + + + + + + + + + Starting price for a bidding war. + + + + + +