Subscriptions

Återkommande fakturering

MarknadsplatsKunderVersion 0.1.0manifest

Vad den är till för ​

Define recurring plans and track customer subscriptions with trial, active, past due and cancelled states, including the next invoice date. It does not create invoices by itself.

Vad paketet gör och inte gör ​

Recurring plans and customer subscriptions with a trial, active, past due and cancelled flow. It records the next invoice date; it does not create invoices on its own.

Modeller ​

subscriptions_plan ​

A recurring offer customers can subscribe to

Läsgrupp: subscriptions.user. Skrivgrupp: subscriptions.manager.

FältTypDataklassPersonuppgiftGruppAgenter serBeskrivning
nametextnonenejsubscriptions.useri klartextPlan name, for example Team yearly
codetextnonenejsubscriptions.useri klartextShort code of the plan
intervalselect (monthly, quarterly, yearly)nonenejsubscriptions.useri klartextHow often the customer is billed: monthly, quarterly, yearly
pricemoneynonenejsubscriptions.useri klartextStandard price per billing interval (minor currency units, e.g. cents)
trial_daysnumbernonenejsubscriptions.useri klartextLength of the free trial in days
activeboolnonenejsubscriptions.useri klartextWhether new customers can pick the plan

subscriptions_subscription ​

A customer's recurring subscription to a plan

Läsgrupp: subscriptions.user. Skrivgrupp: subscriptions.manager.

FältTypDataklassPersonuppgiftGruppAgenter serBeskrivning
customer_idref → partynonenejsubscriptions.useri klartextThe customer who subscribed
plan_idref → subscriptions_plannonenejsubscriptions.useri klartextThe plan subscribed to
started_ondatenonenejsubscriptions.useri klartextDate the subscription began (YYYY-MM-DD)
trial_ends_ondatenonenejsubscriptions.useri klartextDate the free trial ends (YYYY-MM-DD)
next_invoice_ondatenonenejsubscriptions.useri klartextDate the next invoice is due (YYYY-MM-DD)
recurring_amountmoneynonenejsubscriptions.useri klartextAmount billed each interval after discounts (minor currency units, e.g. cents)
currencytextnonenejsubscriptions.useri klartextISO 4217 currency code, for example EUR
seatsnumbernonenejsubscriptions.useri klartextNumber of licences or users covered
cancel_reasonlongtextnonenejsubscriptions.useri klartextWhy the customer cancelled
stateselect (trial, active, past_due, cancelled)nonenejsubscriptions.useri klartextSubscription status: trial, active, past_due, cancelled

Arbetsflöden ​

subscriptions_subscription ​

ÅtgärdFlyttarVem får köra denGodkännande
subscriptions_subscription.activatestate: trial → activesubscriptions.managernej
subscriptions_subscription.mark_past_duestate: active → past_duesubscriptions.managernej
subscriptions_subscription.recoverstate: past_due → activesubscriptions.managernej
subscriptions_subscription.cancel_trialstate: trial → cancelledsubscriptions.managerja
subscriptions_subscription.cancelstate: active → cancelledsubscriptions.managerja
subscriptions_subscription.cancel_overduestate: past_due → cancelledsubscriptions.managerja

Behörighetsgrupper ​

Grupper som den här appen använder:

  • subscriptions.manager
  • subscriptions.user

Steg som kräver godkännande ​

Steg som en agent bara kan föreslå:

  • subscriptions_subscription.cancel_trial
  • subscriptions_subscription.cancel
  • subscriptions_subscription.cancel_overdue

Vad agenter kan och inte kan göra ​

En agent kan läsa, söka, skapa och uppdatera poster i den här appen, och köra de åtgärder som inte kräver godkännande, inom behörighetsgrupperna för sin token.

Den kan bara föreslå de här stegen, och en person måste godkänna dem: subscriptions_subscription.cancel_trial, subscriptions_subscription.cancel, subscriptions_subscription.cancel_overdue, subscriptions_plan.delete, subscriptions_subscription.delete.

Beroenden ​

  • base

Installera ​

Installera den från appen Customize (Marknadsplats), eller från kommandoraden:

bash
obop modules install-from subscriptions

Kräver en databas och administratörsbehörighet.

Bygg din egen ​

Modulguiden visar hur appar som den här skrivs