API

property	type	description	default
active	boolean	Is the article active.	-
barcodes	string[]	Optional barcode mainly to be used in barmode in the frontend.	-
created	integer	Timestamp of the article creation	-
id	integer	Unique id, gets allocated by the storage backend.	-
inventory	integer	Stock of the article	-
inventory_override	Inventory	Inventory boundary override for this article.	-
labels	string[]	Optional labels for sorting in the frontend.	-
name	string	Article name, only one article with the same name can be active at the same time.	-
prices	Price[]	Versioned price information for the article	-
usage_count	integer	How often has the article been bought.	-

Boundaries

Describes all configured limits for actions and objects.

property	type	description	default
account_lower	integer	Set the lower balance limit for accounts in cents. No value equals i32::MIN.	-10000
account_upper	integer	Set the upper balance limit for accounts in cents. No value equals i32::MAX.	20000
inventory	Inventory	Sets the type of override for inventory boundaries	-
transaction	integer	Set the (positive/negative) monetary transaction limit. None equals i32::MAX/i32::MIN.	10000

Capabilities

Describes all toggleable features for the instance.

property	type	description	default
articles	boolean	Toggles the article system. Also disables `compensations` if disabled.	true
compensations	boolean	Allows to rebalance articles without money transfer. `articles` has to be enabled for the feature to work.	true
custom_purchase_price	boolean	Toggles the possibility to set a custom price when filling up articles.	true
frontend	boolean	Toggles the builtin frontend. Frontend related information will still be available through the api.	true
inventory	boolean	Toggles the inventory system.	true
inventory_override	boolean	Toggles the ability to optionally set per article inventory boundaries.	true
user_transactions	boolean	Toggles the possibility for users to directly send money between them.	true

Compensation

External representation of a compensation. Compensations are used to allow changing the inventory of an Article without affecting a user.

property	type	description	default
amount	integer	Amount of articles that are compensated	-
article	integer	Article the compensation applies to	-
created	integer	Timestamp of the compensations creation	-
id	integer	Unique id	-
reason	CompensationReason	Reason the compensation has to be done	-

CompensationReason

Reason the compensation has to be done

bar: Bar transaction used to pay article

shrinkage: Compensate for missing articles noticed during inventory taking

enlargement: An article is bought without a user taking credit

buy: An article is bought without a user taking credit (e.g. cash payments)

error: Compensation for error in prior compensation

string “bar”|“shrinkage”|“enlargement”|“buy”|“error”

CreateArticle

Representing needed values to crate/update a new Article. When updating, all values have to be filled out with their new values, even when not changing them.

property	type	description	default
active	boolean		-
barcodes	string[]	Optional barcode mainly to be used in barmode in the frontend.	-
cost	integer	Cost of the article in cents.	-
inventory_override	Inventory	Inventory boundary override for this article.	-
labels	string[]	Optional labels to tag an article	-
name	string	Article name, only one article with the same name can be active at the same time.	-
purchase_price	integer	The amount of money a user receives when filling up the article. If unset, defaults to cost. Can be overridden by the user if `custom_purchase_price` in Capabilities is `true`.	-

CreateCompensation

Representing values needed to create a new Compensation.

property	type	description	default
amount	integer	Amount of articles that are compensated	-
reason	CompensationReason	Reason the compensation has to be done	-

CreateTransaction

Representing the possible information for creating a new Transaction.

property	type	description	default
amount	integer	If `article` given functions as article amount, if not as cents. Negative article amount means filling up the article.	-
article	string	Optional article, if given changes how the `amount` works.	-
comment	string	Optional comment to the transaction. Can be shown in frontend.	-
purchase_override	PurchaseOverride	User override for `purchase_price` of an Article. Only allowed if `custom_purchase_price` in Capabilities is `true` in the Settings.	-
recipient	string	Set if users send money between them.	-
user	string	Main user affected by the transaction.	-

CreateUser

Struct representing the needed possible values for a Users creation. All other values are calculated/generated. When updating all values have to be filled out.

property	type	description	default
email	string	Optional email of the user.	-
name	string	Username	-

Currency

Available currencies, used for the frontend.

string “euro”

Frontend

Config usable for a frontend

property	type	description	default
auto_open_articles	boolean	Should the article section on a users page be automatically opened.	true
cash_info	string	Info shown on cash payment site	register cash payments
deposit	integer[]	Values that should be set in the deposit section on a users page.	[100, 200, 500, 1000, 2000]
dispense	integer[]	Values that should be set in the dispense section on a users page.	[100, 200, 500, 1000, 2000]
random_sounds	number	Percentage of the random sounds being used, from 0 to 1.	0.019999999552965164

Inventory

Sets the type of override for inventory boundaries

One of:

string “infinite” or:

property	type	description	default
bound	InventoryBound	Custom override. If a value isn’t set, it counts as i32::MAX/i32::MIN.	-

InventoryBound

Upper and lower bounds for bound in Inventory.

property	type	description	default
lower	integer	Lower inventory limit, unset equals to i32::MIN.	-
upper	integer	Upper inventory limit, unset equals to i32::MAX.	-

Price

Versioned price information for Articles

property	type	description	default
cost	integer	Cost of the article	-
created	integer	Timestamp of the creation of this price version	-
purchase_price	integer	The amount of money a user receives when filling up the article. If unset, defaults to cost. Can be overridden by the user if `custom_purchase_price` in the Capabilities is `true`.	-
version	integer	Version of the Price information	-

PurchaseOverride

Struct used for overriding the set purchase price of an article when filling.

property	type	description	default
unit	integer	Unit of the override, as in amount of the product costing `value`.	-
value	integer	Value of the override	-

Settings

Representing the backend config with the necessary info for a frontend or user

property	type	description	default
boundaries	Boundaries	Boundaries for accounts, transactions and the inventory.	-
capabilities	Capabilities	Which features are enabled for the instance.	-
currency	Currency	Used Currency for the instance. Mainly used for frontend.	euro
frontend	Frontend	Default options for the frontend. Frontend options are passed one to one to the frontend and are otherwise ignored by the backend.	-
undo_timeout	integer	Set the timeout a transaction can be undone in seconds. If no value is set users are always allowed to undo. If set to `0`, undo is disabled.	600
user_timeout	integer	Time a user will be set as active after their last interaction (transaction/edit).	86000

Transaction

Struct representing everything about a single transaction.

property	type	description	default
amount	integer	If `article` given functions as article amount, if not as cents. Negative article amount means filling up the article.	-
article	integer	Optional article, if given changes how the `amount` works. Requires `price_version` to be set	-
comment	string	Optional comment to the transaction. Can be shown in frontend.	-
created	integer	Timestamp of the transactions creation	-
deleted	boolean	Has the transaction been undone.	-
id	integer	Unique id, gets allocated by the storage backend.	-
isdeletable	boolean	Shows if the transaction can be undone by a user.	-
price_version	integer	Version of the article price, has to be set if article is set.	-
purchase_override	PurchaseOverride	User override for `purchase_price` of an Article. Only allowed if `custom_purchase_price` in Capabilities is `true` in the Settings.	-
recipient	integer	Set if users send money between them.	-
user	integer	Main user affected by the transaction.	-

User

Everything about an user in storage and while working with it.

property	type	description	default
active	boolean	Has the user been active over a certain time, set in the Settings with `user_timeout`.	-
balance	integer	Current balance of the user in cent	-
created	integer	Timestamp of the users creation	-
deleted	boolean	Has the user been deleted? Deletion is only reversible with direct database access.	-
email	string	Optional email of the user.	-
id	integer	Unique id, gets allocated by the storage backend.	-
modified	integer	Timestamp of the last modification to the user (transaction/edit)	-
name	string	Username	-

Keyboard shortcuts

StrichRListe Documentation