Expenses

Spesen und Freigaben

MarktplatzFinanzenVersion 0.1.0manifest

Wofür sie gedacht ist ​

Employees file expense claims that move through draft, submitted, approved and paid. Paying needs its own permission and a human approval; receipts are referenced by note, not stored.

Was das Paket leistet und was nicht ​

Employee expense claims with a draft, submitted, approved and paid flow. Paying is a separate permission and needs a human approval; receipts are referenced by note, not stored.

Modelle ​

expenses_expense ​

An amount an employee spent for the business and wants reimbursed

Lesegruppe: expenses.user. Schreibgruppe: expenses.user.

FeldArtDatenklassePersonenbezogene DatenGruppeAgenten sehenBeschreibung
descriptiontextnoneneinexpenses.userim KlartextWhat the money was spent on
employeetextinternaljaexpenses.usermaskiertName of the person claiming the expense
spent_ondatenoneneinexpenses.userim KlartextDate of the purchase (YYYY-MM-DD)
categoryselect (travel, meals, lodging, supplies, software, other)noneneinexpenses.userim KlartextExpense category: travel, meals, lodging, supplies, software, other
amountmoneyfinancialjaexpenses.userzurückgehaltenAmount owed to the employee (minor currency units, e.g. cents)
currencytextnoneneinexpenses.userim KlartextISO 4217 currency code, for example EUR
receipt_notelongtextnoneneinexpenses.userim KlartextWhere the receipt is kept and what it shows
paid_ondatefinancialjaexpenses.financezurückgehaltenDate the employee was reimbursed (YYYY-MM-DD)
payment_referencetextfinancialjaexpenses.financezurückgehaltenBank transfer reference of the reimbursement
stateselect (draft, submitted, approved, paid, refused)noneneinexpenses.userim KlartextClaim status: draft, submitted, approved, paid, refused

Workflows ​

expenses_expense ​

AktionBewegtWer sie ausführen darfFreigabe
expenses_expense.submitstate: draft → submittedexpenses.usernein
expenses_expense.approvestate: submitted → approvedexpenses.managernein
expenses_expense.paystate: approved → paidexpenses.financeja
expenses_expense.refusestate: submitted → refusedexpenses.managernein

Berechtigungsgruppen ​

Von dieser App verwendete Gruppen:

  • expenses.finance
  • expenses.manager
  • expenses.user

Freigabeschritte ​

Schritte, die ein Agent nur vorschlagen kann:

  • expenses_expense.pay

Was Agenten tun können und was nicht ​

Ein Agent kann Datensätze dieser App lesen, durchsuchen, anlegen und aktualisieren sowie Aktionen ausführen, die keine Freigabe brauchen, und zwar innerhalb der Berechtigungsgruppen seines Tokens.

Diese Schritte kann er nur vorschlagen, und eine Person muss sie freigeben: expenses_expense.pay, expenses_expense.delete.

Personenbezogene Daten werden als Platzhalter maskiert: expenses_expense.employee.

Diese Felder werden Agenten vollständig vorenthalten: expenses_expense.amount, expenses_expense.paid_on, expenses_expense.payment_reference.

Abhängigkeiten ​

Keine.

Installation ​

Installieren Sie sie in der App Customize (Marktplatz) oder über die Kommandozeile:

bash
obop modules install-from expenses

Erfordert eine Datenbank und Administratorrechte.

Selbst bauen ​

Der Modulleitfaden zeigt, wie Apps wie diese geschrieben werden