Skip to content

Conversation

@theRealThagomizer
Copy link
Contributor

Hi, Felicia! This page is meant to be a companion piece to the "Subscriptions with deliveries" tutorial that I wrote last month. It distills the pertinent information into a succinct flow with fewer jokes. My intention is also to come back at some point in the future and add some images. For now, it makes thorough use of in-line links to direct the reader to relevant workflows in the Subscriptions and Deliveries apps.

This 19.0 PR can be FWP up to master.

@robodoo
Copy link
Collaborator

robodoo commented Nov 18, 2025

Pull request status dashboard

@C3POdoo C3POdoo requested a review from a team November 18, 2025 19:42
Copy link
Contributor

@Felicious Felicious left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hi @theRealThagomizer !

The overall structure looks solid, and the flow is easy to follow. I do have a few suggestions to strengthen the draft, mainly around adding more concrete, step-by-step guidance and clarifying how the software behaves in practice.

Right now, the explanations are clear, but they don’t yet give readers enough directional detail—things like where to navigate in the interface, which buttons to select, or how to reach the specific configuration points. Including those explicit steps will make the instructions easier to follow and ensure users can reproduce the workflow in Odoo without ambiguity! :D

You mentioned planning to insert screenshots later, but capturing the steps directly in Odoo as you revise the text will help surface exactly which actions need to be documented. The images will naturally fall out of that process as well 😄

Could you update the draft with more navigational detail? Once that's pushed I'll take another look!

Comment on lines 9 to 10
Setting up the database
=======================
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This title works, but to maintain consistency with other docs, how about simply "Configuration"?

Creating a subscription delivery product
========================================

While the process for creating a deliverable subscription product is generally the same as
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Let's also include navigational instructions to go to the product form.

"To create a deliverable subscription product, navigate to :menuselection:Subscriptions app --> Products --> Products (something like that). Click an existing product or create a new one, and on the product form, set the Product Type to Goods.

Subscriptions and subscription products are compatible with deliveries. With some minor
configuration, it is possible to offer customers subscriptions of regularly delivered physical goods
such as a meal delivery box or magazine.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Let's also add a paragraph describing an overview of what this looks like in Odoo. Something like:

"In Odoo, this means that after billing a customer for a monthly subscription of coffee beans, Odoo automatically generates a delivery order every month in the Inventory app to ensure the product gets delivered to the customers."

(please reword!!!)

few extra considerations. Since the product is intended to be delivered to customers, the
:guilabel:`Product Type` must be set to `Goods`. If the product is not intended to be offered for
direct sale to customers, it is not necessary to set a :guilabel:`Sales Price`.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think we're missing some information here! How do people configure the monthly recurrance period?

Choosing a delivery method
==========================

In the **Inventory** app, navigate to :menuselection:`Configuration header --> Delivery Methods`. By
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
In the **Inventory** app, navigate to :menuselection:`Configuration header --> Delivery Methods`. By
Navigate to :menuselection:`Inventory app --> Configuration --> Delivery Methods`. By

Comment on lines 33 to 34
Choosing a delivery method
==========================
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

kinda a nitpick but I'm thinking we could use h3 here instead, since this is part of the configuration

Suggested change
Choosing a delivery method
==========================
Choosing a delivery method
-----------------------------

(I don't think I have the correct number of hypens! pls help

Validating delivery orders
==========================

Once the sales order for a subscription delivery product has been finalized, a :guilabel:`Delivery`
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

How do I get to the delivery order? clicking the delivery smart button ? Adding that specification would be helpful (:

@theRealThagomizer theRealThagomizer force-pushed the 19.0-subscriptions-deliveries-thjud branch from 383b7e4 to dbb026a Compare November 19, 2025 20:34
Co-authored-by: Felicia Kuan <feku@odoo.com>
@theRealThagomizer theRealThagomizer force-pushed the 19.0-subscriptions-deliveries-thjud branch from dbb026a to d4966e3 Compare November 19, 2025 20:41
Copy link
Contributor

@Felicious Felicious left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM @theRealThagomizer !!

@robodoo delegate+

addition to managing inventory, allows for adding shipping information to quotations and
automatically creating delivery orders when invoices are created.

After installing both **Subscriptions** and **Inventory**, enter the **Settings** app, search for
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

if we're telling the reader to go somewhere, we use menuselection

Suggested change
After installing both **Subscriptions** and **Inventory**, enter the **Settings** app, search for
After installing both **Subscriptions** and **Inventory**, enter the :menuselection:`Settings` app, search for

Validating delivery orders
==========================

Once the sales order for a subscription delivery product has been finalized, a :guilabel:`Delivery`
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Once the sales order for a subscription delivery product has been finalized, a :guilabel:`Delivery`
Once the sales order for a subscription delivery product has been confirmed, a :guilabel:`Delivery`

finalized is a good synonym, but let's stick to the product's terminology as much as possible so there's no doubt what we're referring to

smart button appears that opens the delivery order for the sale. After clicking through, if there is
enough stock to fulfill the delivery order, it appears as being in the :guilabel:`Ready` stage. If
there is not enough stock to fulfill the order, it appears as being :guilabel:`In Progress` instead.
Once the delivery order is in the Ready stage, click :guilabel:`Validate` to advance the stage to
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Once the delivery order is in the Ready stage, click :guilabel:`Validate` to advance the stage to
Once the delivery order is in the :guilabel:`Ready` stage, click :guilabel:`Validate` to advance the stage to

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants