# Subscription Article

With the B2Bsellers product subscriptions plugin, the shop operator has the option of offering his customers interval deliveries in the form of subscriptions. For this purpose, the shop operator decides which products are eligible for subscription and which discount should be granted for a subscription.

Costumers and buyers have thereby the advantage of being able to trigger recurring orders automatically.

### **Features** <a href="#features" id="features"></a>

* Individual products can be configured to subscription products by the shop operator.

  Custom field on product: b2b\_subscription\_enabled
* Each subscription product can be given its own discount value to convince the buyer to order a subscription.
* Subscriptions can be managed by the buyer in the B2B platform
  * View all subscriptions
  * Change delivery intervals
  * Delete subscription
* Subscribed products can only be paid with the payment methods "invoice" and "prepayment" (third-party providers such as PayPal are not supported).

### **Planned features** <a href="#planned-features" id="planned-features"></a>

* Subscriptions cannot later be changed by customers/purchasers, but must be terminated. Considering the termination period, etc.
* Show subscription products exclusively as interval products.

  Thus, it can be decided separately for each product whether a one-time delivery can be accepted at all.
* Display of subscriptions in the Shopware admin area

On the current roadma&#x70;**,** it is not planned to allow subscription orders via payment service providers like PayPal. If you wish to do so, please contact us.

### **Enable subscription per product** <a href="#enable-subscription-per-product" id="enable-subscription-per-product"></a>

1. Navigate to "Catalogues" -->"Products" in the administration and open the product you want to enable as a subscription product.
2. Navigate to the Specifications tab
3. Scroll down to the menu item "Additional fields".
4. Activate "Allow subscription option".
5. Enter the discount (in percent) which the customer should receive through this subscription.

<figure><img src="/files/aVmFhFI5hAFYP9f3zFC8" alt=""><figcaption><p>Activate subscription per product</p></figcaption></figure>

### **Functions/extensions in the frontend** <a href="#functions-extensions-in-the-frontend" id="functions-extensions-in-the-frontend"></a>

#### *In the product overview* <a href="#in-the-product-overview" id="in-the-product-overview"></a>

By activating the subscription function, customers/buyers have the option of selecting a subscription in addition to the one-off delivery.

The associated savings through a discount are displayed next to the selection button. If customers/buyers choose the subscription, they will be given a further selection option to set the delivery interval.

<figure><img src="/files/WmCGGapkOLmV5ZyFzUrP" alt=""><figcaption><p>Extensions in the frontend - product overview</p></figcaption></figure>

#### *In the shopping cart* <a href="#in-the-shopping-cart" id="in-the-shopping-cart"></a>

Products for which a subscription has been taken out are marked with a subscription badge in the shopping cart. Hence, it is for costumers/buyers directly recognizable that it is a subscription product.

<figure><img src="/files/HfpncDdjHGdC0cAlAwFv" alt=""><figcaption><p>Extensions in the frontend - Shopping Cart</p></figcaption></figure>

#### Subscription management in the B2B platform <a href="#subscription-management-in-the-b2b-platform" id="subscription-management-in-the-b2b-platform"></a>

Under "My products" is provided the menu item "Subscriptions".

Here customers/buyers can view their completed subscriptions and the following details:

* Article name
* Current unit price (the original price is displayed next to it)
* Quantity (per delivery)
* Created on
* Delivery interval with the option to change it
* Billing address
* Delivery address
* Next delivery

In addition, the subscription can be deleted here.

<figure><img src="/files/YXzG4vrgpvA4j1TpfJxW" alt=""><figcaption><p>Management of the subscription in the B2B platform</p></figcaption></figure>

### **Technical information:** <a href="#technical-information" id="technical-information"></a>

*Data structure:*

| b2b\_subscription\_enabled  | Is this product a subscription product?                      |
| --------------------------- | ------------------------------------------------------------ |
| b2b\_subscription\_discount | Discount rate if the buyer decides for recurring deliveries. |

Database table in which all subscriptions are stored: b2b\_product\_subscription

Automatic execution of the order

Through a Shell-command 'php bin/console b2b:product-subscription:order' all subscription orders that have to be executed for the executed day will be executed.

A cronjob should be set up that automatically executes this command 1x per day.

## Consumer View Differences

If consumer view is enabled in the admin, prices can be hidden. This looks as follows:

| Consumer View Disabled (Standard)                                                                   | Consumer View Enabled (Prices Hidden)                                                              |
| --------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- |
| <p><img src="/files/yfaY77l35W3zrwHx5YwU" alt="" data-size="original"> </p><p>One Time Purchase</p> | <p><img src="/files/WlL1VuS8uhv3jzqxjmV4" alt="" data-size="original"></p><p>One Time Purchase</p> |
| <p><img src="/files/S3h6s39YpYa0By06sk22" alt="" data-size="original"> </p><p>Subscription</p>      | <p><img src="/files/mIukEtNfehu9KcbAjTx5" alt="" data-size="original"></p><p>Subscription </p>     |

### Entities <a href="#entities" id="entities"></a>

* [PAGEProductSubscription](https://docs.b2b-sellers.com/b2b-platform/api-references/entities/productsubscription)
* [PAGEProductSubscriptionOrder](https://docs.b2b-sellers.com/b2b-platform/api-references/entities/productsubscriptionorder)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.b2b-sellers.com/b2b-platform/user-documentation/admin-settings-configuration/subscription-article.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
