Infört från och med version 25.585
Lista priser
Listar priser för angiven produkt. Vid produkter av typ paket så listas delarnas priser individuellt. Resurser tas ej i beaktande.
Anrop
...
List prices
Lists prices for specified product. For packages the price is listed individually per item. Resources are not used. When possible, consider using API3 instead, which has better support for calculating prices for an individual customer.
Call
HTTP GET to /prices
Filter
namnobligatoriskexempelvärdeförklaringVärdemängdDatatypData type | Default |
---|
productid |
jaobligatoriskRequired | ID | - |
businessunitids |
nejendast priser som gäller för dessa anläggningarOnly prices for specified business units | ID- |
listaAllanejdate | ja/nej (se förklaringenbart för personer som har denna prislista. Om pricelistid=0 så erhålls enbart standardpriset i svaret. | ID | Alla prislistor | ja/nej (se förklaringOnly for people with specified price list. When pricelistid=0 the default price will be returned. Note that when setting pricelist, only that pricelist and the product's package pricelist is used. This may or may not include the default pricelist, which might be required to check with an additional request.
| ID | All price lists |
date | Yes/No (see description) | date=2014-11-13 |
priser som gäller denna dag. Om date anges så måste även time anges. | Datum | Idag | time | The prices valid for the specified date. If the date is specified the time must also be specified. | Date | Today |
time | Yes/No (see description) | time=12:00 |
priser som gäller denna tid. Om time anges så måste även date anges. | Tid | Nu |
...
The prices valid for the specified time. If the time is specfied the date must also be specified. | Time | Now |
Example:
Code Block |
---|
GET:APIURL/prices.xml?apikey=338934897438&productid=14&date=2014-11-13&time=12:00
|
...
Responses for alla product types except packages
ExempelFörklaring | | prices-taggen omsluter priser
|
| The prices tag encloses the prices. |
price |
| | representerar ett pris |
|
| Represents a price. |
pricelistid | ID | <pricelistid>7</pricelistid> |
priset avser personer med denna prislistaThe price is valid for persons with specified price list. |
businessunitid | ID | <businessunitid>1</businessunitid> |
priset gäller för denna anläggningThe price is valid for this business unit. |
priceincvat |
NummerInteger | <priceincvat>25000</priceincvat> |
belopp inkl momsPrice including VAT in cents |
priceexvat |
NummerInteger | <priceexvat>20000</priceexvat> |
belopp exkl momsPrice excluding VAT in cents. |
starttime |
Tidpunkt | | tidpunkt då priset är giltigt från | endtime | Tidpunkt | | tidpunkt då priset är giltigt tillTime |
| Time from when the price is valid. |
endtime | Time |
| Time from when the price no longer is valid. |
forinternet | Boolean | <forinternet>true</forinternet> |
priset gäller endast internetbokningarThe price is only valid for Internet bookings |
schedule |
| id><name>efterid><name>after lunch</name></schedule> |
Representerar ett schema. Priset gäller vissa tider på dagenRepresents a schedule. The price is only valid during certain times throughout the day. |
Code Block |
---|
|
<prices>
<price>
<pricelistid>7</pricelistid>
<businessunitid>134</businessunitid>
<priceincvat>25000</priceincvat>
<priceexvat>20000</priceexvat>
<schedule>
<id>3</id>
<name>efter<name>after lunch</name>
</schedule>
<starttime>
<timepoint>
<timestamp>1102082400</timestamp>
<datetime>2012-05-18 12:00</datetime>
<date>2012-05-18</date>
<time>12:00</time>
</timepoint>
</starttime>
<endtime>
<timepoint>
<timestamp>1102082400</timestamp>
<datetime>2012-06-18 12:00</datetime>
<date>2012-06-18</date>
<time>12:00</time>
</timepoint>
</endtime>
<forinternet>true</forinternet>
</price>
<price>
<pricelistid>8</pricelistid>
<businessunitid>134</businessunitid>
<priceincvat>25000</priceincvat>
<priceexvat>20000</priceexvat>
<starttime>
<timepoint>
<timestamp>1102082400</timestamp>
<datetime>2007-01-01 00:00</datetime>
<date>2007-01-01</date>
<time>00:00</time>
</timepoint>
</starttime>
<starttime><timepoint><date>2007-01-01</date><time>00:00</time></timepoint></starttime>
<forinternet>true</forinternet>
</price>
<price>
<businessunitid>134</businessunitid>
<priceincvat>25000</priceincvat>
<priceexvat>20000</priceexvat>
<forinternet>true</forinternet>
</price>
</prices>
|
...
Responses if product type is package
ExempelFörklaringDescription |
---|
packageparts | <packageparts> |
| av paketdelarindividual items |
packagepart | <packagepart> |
Paketdel | Produktens id<name>Lager <name>Package 1</name> | Sträng |
Produktens namnProduct name |
perpackage | <perpackage>true</perpackage> | Boolean |
En per antal eller en för hela bokningenOne item for each or one item for the entire booking. * |
day | <day>1</day> | Nummer |
Vilken dag paketdelen infaller på The specified day that the individual item is scheduled on (1 = |
startdagenstart day) |
relativetime | <relativetime>01:00</relativetime> | Tid |
Relativ startid utifrån paketets startRelative start time form the start of the package ** |
fixedtime | <fixedtime>14:00</fixedtime> | Tid |
Fast tid för paketdelenFixed time for the individual item ** |
prices | se ovan |
| prices-taggen omsluter priser. Som ovanstående för icke-paket-produkter | * Om true så ska det vara lika många av paketdelen som av paketet annars endast 1 för hela paketet.
** Endast en av dessa är satta.
...
| The prices tag encloses the actual price. As per above for non package product types. |
* If set to true there must be as many individual items as there are packages. If false only one item is used irregardless of number of packages. (i.e. one conference room is booked but 15 mugs of coffee)
** Only one of these may be set.
Code Block |
---|
|
<packageparts>
<packagepart>
<productid>32</productid>
<productname>Massage</productname>
<perpackage>true</perpackage>
<day>1</day>
<relativetime>00:00</relativetime>
<fixedtime></fixedtime>
<prices>
<price>
<priceincvat>425,00</priceincvat>
<priceexvat>340,00</priceexvat>
<forinternet>true</forinternet>
<pricelistid>1</pricelistid>
<starttime><timepoint><timestamp>1167606000</timestamp><datetime>2007-01-01 00:00</datetime><date>2007-01-01</date><time>00:00</time></timepoint></starttime>
</price>
</prices>
</packagepart>
<packagepart>
<productid>32</productid>
<productname>Massage</productname>
<perpackage>true</perpackage>
<day>1</day>
<relativetime>01:00</relativetime>
<fixedtime></fixedtime>
<prices>
<price>
<priceincvat>425,00</priceincvat>
<priceexvat>340,00</priceexvat>
<forinternet>true</forinternet>
<pricelistid>1</pricelistid>
<starttime><timepoint><timestamp>1167606000</timestamp><datetime>2007-01-01 00:00</datetime><date>2007-01-01</date><time>00:00</time></timepoint></starttime>
</price>
</prices>
</packagepart>
</packageparts> |
...