Contents x
    What is the Bento Data Model?
    • 13 May 2024
    • 3 Minutes to read
    • Contributors
    • Print
    • Dark
      Light
    Contents

    What is the Bento Data Model?

    • Updated on 13 May 2024
    • 3 Minutes to read
    • Contributors
    • Print
    • Dark
      Light
    Article summary

    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.

    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 set up and your customer has purchased an individual Subscription Contract, pending orders will be generated for that contract. Orders are generated from a subscription contract's products, prices, and delivery cadences, which all come together to create each single 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?
    What's Next