.png){kind=logo}
What is the Bento Data Model?
- 04 Oct 2024
- 3 Minutes to read
- Contributors
- Print
- DarkLight
What is the Bento Data Model?
- Updated on 04 Oct 2024
- 3 Minutes to read
- Contributors
- Print
- DarkLight
Article summary
Did you find this summary helpful?
Thank you for your feedback
What is the Bento Data Model
In this section, we will break down our product to give you an insight into how we have modelled our subscription service.
Below is a high-level diagram of our model.
.png "image(41).png")
This next section goes into more detail about the features within each domain.
Subscription types:
This is where you store all the settings you are planning to offer for a specific subscription type. Essentially, subscription types serve as templates for what subscription your customers will buy. When a customer purchases a new subscription on your website, this will generate a new subscription contract based on the subscription type.
Below we'll talk you through each component of a Subscription Type and give an example of what it can be used for:
Subscription Component | Description |
Delivery Cadence: Days, Weeks, Months, Years | The selection of options for how often orders will be sent to customers. |
Anchor Date | This fixes the sub so that a plan runs on a set date for each time period. |
Billing cadence | Here you can choose how often a customer can choose to be billed. |
Pricing Calculator | There are multiple engines to choose from depending on your pricing structure. |
Line Items | The products you want to add to the subscription type. |
Subscription Phases | Allows you to control the price, products, and delivery cadence across multiple phases in the lifecycle of a subscription. One common exampl |
Subscription Contract:
Once a customer has taken out a subscription a Contract will be generated from the parent Subscription Type. A Contract has every feature listed above that has been enabled alongside the features below:
Contract Component | Description |
Status: Active, Inactive, Suspended, Cancelled, Ended | Depending on the criteria, a customer's account can manually or automatically change status. |
Override next box number | If you have a playlist subscription, you can use this feature to change the playlist position a customer is currently on. |
End sub at next payment | You can choose to prevent billing at the next attempted payment. This is useful when a customer has a gift subscription as this stops them from being charged at the end. |
Update address/billing | You can view & update the delivery address and billing method on the sub-contract. |
Discount code | Apply promos for this subscription contract. |
Orders:
Once your Subscription Type has been established and your customer has acquired an individual Subscription Contract, pending orders will be generated for that contract. Orders are created based on the products, prices, and delivery cadences associated with a subscription contract, which collectively contribute to the formation of each individual order.
Component | Description |
Order Date | You can update a specific order's delivery date or re-anchor the whole subscription from the order page for convenience. |
Contents | You can add/remove products, change quantities, and control if products will be added to the order's price. |
Order Generation | You can choose how many orders in advance are generated on our app. This allows you to see & edit upcoming orders. |
Order Status | Pending -> Committed/ Cancelled |
Billing Status | Pending -> Successful/ Failed / Delegated(Shopify only) |
Order Actions | Description |
Skip Order | If a customer wants to skip an order this can also be done with a click of a button. |
Bill Now/Rebill/Refund | All these actions can be done with a click of a button. Rebill after a failed order. |
Promotions:
Promotions enable you to offer discounted prices to a customer with set conditions. Below are the key components of Bento promotions.
Promos Component | Description |
Promo Value | This can be a percentage (%) or value (£/$) based discount. |
Promo Rule | Rules are where the flexibility lives! This is where you can choose what conditions need to be true for your promotion to be applied. |
Promo Code | This is the code that a customer will add to their account for the promotion to be applied. |
Box Rules:
Box rules enable you to add items to orders based on conditions set within the box rule.
Box Rules Component | Description |
Product | Select any product synced with Bento and set the quantity. |
Rule | Select which Sub Type and Order(s) you want this product applied to. |
COMING SOON - Product Information Management (PIM):
Our PIM allows you to store, view and manage key product information.
Was this article helpful?