forked from CGM_Public/pretix_original
8123effa65
* Data model * little crud * SubEventItemForm etc * Drop SubEventItem.active, quota editor * Fix failing tests * First frontend stuff * Addons form stuff * Quota calculation * net price display on EventIndex * Add tests, solve some bugs * Correct quota selection in more places, consolidate pricing logic * Fix failing quota tests * Fix TypeError * Add tests for checkout * Fixed a bug in QuotaForm * Prevent immutable cart if a quota was removed from an item * Add tests for pricing * Handle waiting list * Filter in check-in list * Fixed import lost in rebase * Fix waiting list widget * Voucher management * Voucher redemption * Fix broken tests * Add subevents to OrderChangeManager * Create a subevent during event creation * Fix bulk voucher creation * Introduce subevent.active * Copy from for subevents * Show active in list * ICal download for subevents * Check start and end of presale * Failing tests / show cart logic * Test * Rebase migrations * REST API integration of sub-events * Integrate quota calculation into the traditional quota form * Make subevent argument to add_position optional * Log-display foo * pretixdroid and subevents * Filter by subevent * Add more tests * Some mor tests * Rebase fixes * More tests * Relative dates * Restrict selection in relative datetime widgets * Filter subevent list * Re-label has_subevents * Rebase fixes, subevents in calendar view * Performance and caching issues * Refactor calendar templates * Permission tests * Calendar fixes and month selection * subevent selection * Rename subevents to dates * Add tests for calendar views
165 lines
8.2 KiB
ReStructuredText
165 lines
8.2 KiB
ReStructuredText
Vouchers
|
||
========
|
||
|
||
Resource description
|
||
--------------------
|
||
|
||
The voucher resource contains the following public fields:
|
||
|
||
.. rst-class:: rest-resource-table
|
||
|
||
===================================== ========================== =======================================================
|
||
Field Type Description
|
||
===================================== ========================== =======================================================
|
||
id integer Internal ID of the voucher
|
||
code string The voucher code that is required to redeem the voucher
|
||
max_usages integer The maximum number of times this voucher can be
|
||
redeemed (default: 1).
|
||
redeemed integer The number of times this voucher already has been
|
||
redeemed.
|
||
valid_until datetime The voucher expiration date (or ``null``).
|
||
block_quota boolean If ``True``, quota is blocked for this voucher.
|
||
allow_ignore_quota boolean If ``True``, this voucher can be redeemed even if a
|
||
product is sold out and even if quota is not blocked
|
||
for this voucher.
|
||
price_mode string Determines how this voucher affects product prices.
|
||
Possible values:
|
||
|
||
* ``none`` – No effect on price
|
||
* ``set`` – The product price is set to the given ``value``
|
||
* ``subtract`` – The product price is determined by the original price *minus* the given ``value``
|
||
* ``percent`` – The product price is determined by the original price reduced by the percentage given in ``value``
|
||
value decimal (string) The value (see ``price_mode``)
|
||
item integer An ID of an item this voucher is restricted to (or ``null``)
|
||
variation integer An ID of a variation this voucher is restricted to (or ``null``)
|
||
quota integer An ID of a quota this voucher is restricted to (or
|
||
``null``). This is an exclusive alternative to
|
||
``item`` and ``variation``: A voucher can be
|
||
attached either to a specific product or to all
|
||
products within one quota or it can be available
|
||
for all items without restriction.
|
||
tag string A string that is used for grouping vouchers
|
||
comment string An internal comment on the voucher
|
||
subevent integer ID of the date inside an event series this voucher belongs to (or ``null``).
|
||
===================================== ========================== =======================================================
|
||
|
||
|
||
Endpoints
|
||
---------
|
||
|
||
.. http:get:: /api/v1/organizers/(organizer)/events/(event)/vouchers/
|
||
|
||
Returns a list of all vouchers within a given event.
|
||
|
||
**Example request**:
|
||
|
||
.. sourcecode:: http
|
||
|
||
GET /api/v1/organizers/bigevents/events/sampleconf/vouchers/ HTTP/1.1
|
||
Host: pretix.eu
|
||
Accept: application/json, text/javascript
|
||
|
||
**Example response**:
|
||
|
||
.. sourcecode:: http
|
||
|
||
HTTP/1.1 200 OK
|
||
Vary: Accept
|
||
Content-Type: text/javascript
|
||
|
||
{
|
||
"count": 1,
|
||
"next": null,
|
||
"previous": null,
|
||
"results": [
|
||
{
|
||
"id": 1,
|
||
"code": "43K6LKM37FBVR2YG",
|
||
"max_usages": 1,
|
||
"redeemed": 0,
|
||
"valid_until": null,
|
||
"block_quota": false,
|
||
"allow_ignore_quota": false,
|
||
"price_mode": "set",
|
||
"value": "12.00",
|
||
"item": 1,
|
||
"variation": null,
|
||
"quota": null,
|
||
"tag": "testvoucher",
|
||
"comment": "",
|
||
"subevent": null
|
||
}
|
||
]
|
||
}
|
||
|
||
:query integer page: The page number in case of a multi-page result set, default is 1
|
||
:query string code: Only show the voucher with the given voucher code.
|
||
:query integer max_usages: Only show vouchers with the given maximal number of usages.
|
||
:query integer redeemed: Only show vouchers with the given number of redemptions. Note that this doesn't tell you if
|
||
the voucher can still be redeemed, as this also depends on ``max_usages``. See the
|
||
``active`` query parameter as well.
|
||
:query boolean block_quota: If set to ``true`` or ``false``, only vouchers with this value in the field
|
||
``block_quota`` will be shown.
|
||
:query boolean allow_ignore_quota: If set to ``true`` or ``false``, only vouchers with this value in the field
|
||
``allow_ignore_quota`` will be shown.
|
||
:query string price_mode: If set, only vouchers with this value in the field ``price_mode`` will be shown (see
|
||
above).
|
||
:query string value: If set, only vouchers with this value in the field ``value`` will be shown.
|
||
:query integer item: If set, only vouchers attached to the item with the given ID will be shown.
|
||
:query integer variation: If set, only vouchers attached to the variation with the given ID will be shown.
|
||
:query integer quota: If set, only vouchers attached to the quota with the given ID will be shown.
|
||
:query string tag: If set, only vouchers with the given tag will be shown.
|
||
:query integer subevent: Only return vouchers of the sub-event with the given ID
|
||
:query string ordering: Manually set the ordering of results. Valid fields to be used are ``id``, ``code``,
|
||
``max_usages``, ``valid_until``, and ``value``. Default: ``id``
|
||
:param organizer: The ``slug`` field of the organizer to fetch
|
||
:param event: The ``slug`` field of the event to fetch
|
||
:statuscode 200: no error
|
||
:statuscode 401: Authentication failure
|
||
:statuscode 403: The requested organizer/event does not exist **or** you have no permission to view this resource.
|
||
|
||
.. http:get:: /api/v1/organizers/(organizer)/events/(event)/vouchers/(id)/
|
||
|
||
Returns information on one voucher, identified by its internal ID.
|
||
|
||
**Example request**:
|
||
|
||
.. sourcecode:: http
|
||
|
||
GET /api/v1/organizers/bigevents/events/sampleconf/vouchers/1/ HTTP/1.1
|
||
Host: pretix.eu
|
||
Accept: application/json, text/javascript
|
||
|
||
**Example response**:
|
||
|
||
.. sourcecode:: http
|
||
|
||
HTTP/1.1 200 OK
|
||
Vary: Accept
|
||
Content-Type: text/javascript
|
||
|
||
{
|
||
"id": 1,
|
||
"code": "43K6LKM37FBVR2YG",
|
||
"max_usages": 1,
|
||
"redeemed": 0,
|
||
"valid_until": null,
|
||
"block_quota": false,
|
||
"allow_ignore_quota": false,
|
||
"price_mode": "set",
|
||
"value": "12.00",
|
||
"item": 1,
|
||
"variation": null,
|
||
"quota": null,
|
||
"tag": "testvoucher",
|
||
"comment": "",
|
||
"subevent": null
|
||
}
|
||
|
||
:param organizer: The ``slug`` field of the organizer to fetch
|
||
:param event: The ``slug`` field of the event to fetch
|
||
:param id: The ``id`` field of the voucher to fetch
|
||
:statuscode 200: no error
|
||
:statuscode 401: Authentication failure
|
||
:statuscode 403: The requested organizer/event does not exist **or** you have no permission to view this resource.
|