Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Fulfillment app docs #2251

Merged
merged 46 commits into from
Nov 9, 2023
Merged
Show file tree
Hide file tree
Changes from 31 commits
Commits
Show all changes
46 commits
Select commit Hold shift + click to select a range
c3fdb69
add overview
andriitserkovnyi Sep 21, 2023
f76fba4
bo
andriitserkovnyi Sep 21, 2023
4cbb931
bo
andriitserkovnyi Sep 25, 2023
79ab24e
Update fulfillment-app-feature-overview.md
andriitserkovnyi Sep 25, 2023
7cbf387
Merge branch 'master' into fulfillment-app
andriitserkovnyi Oct 3, 2023
f420fb7
Update fulfillment-app-feature-overview.md
andriitserkovnyi Oct 3, 2023
ad9d90d
feature-overview
andriitserkovnyi Oct 3, 2023
2bf5d3f
Merge branch 'master' into fulfillment-app
andriitserkovnyi Oct 16, 2023
c2fbd93
Update fulfillment-app-feature-overview.md
andriitserkovnyi Oct 16, 2023
91e83bf
Update fulfillment-app-feature-overview.md
andriitserkovnyi Oct 16, 2023
c20b6c7
Update fulfillment-app-feature-overview.md
andriitserkovnyi Oct 17, 2023
811c4d2
Update fulfillment-app-fulfill-orders.md
andriitserkovnyi Oct 18, 2023
aeec7ff
Merge branch 'master' into fulfillment-app
andriitserkovnyi Oct 20, 2023
3fc1827
fulfill-orders
andriitserkovnyi Oct 20, 2023
909775d
Merge branch 'master' into fulfillment-app
andriitserkovnyi Oct 23, 2023
87da008
fulfill-orders
andriitserkovnyi Oct 23, 2023
eb9fbb1
move docs
andriitserkovnyi Oct 24, 2023
f7ab56e
Update fulfillment-app-feature-overview.md
andriitserkovnyi Oct 26, 2023
5742650
Merge branch 'master' into fulfillment-app
andriitserkovnyi Oct 26, 2023
1c0e492
copy bo guide
andriitserkovnyi Oct 27, 2023
8097c0c
Update change-the-state-of-order-items.md
andriitserkovnyi Oct 27, 2023
6f5fe75
Merge branch 'master' into fulfillment-app
andriitserkovnyi Oct 30, 2023
f9179e2
Merge branch 'master' into fulfillment-app
andriitserkovnyi Oct 30, 2023
c3f7fdc
related
andriitserkovnyi Oct 30, 2023
fe50c1e
Merge branch 'master' into fulfillment-app
andriitserkovnyi Oct 31, 2023
234d225
move-push-notification
andriitserkovnyi Oct 31, 2023
5b5323f
Merge branch 'master' into fulfillment-app
andriitserkovnyi Nov 2, 2023
c34b6f4
Update change-the-state-of-order-items.md
andriitserkovnyi Nov 2, 2023
74eeb58
Update change-the-state-of-order-items.md
andriitserkovnyi Nov 2, 2023
a57669e
add statuses
andriitserkovnyi Nov 3, 2023
802803f
statuses
andriitserkovnyi Nov 3, 2023
d917380
move docs
andriitserkovnyi Nov 3, 2023
86ed948
sidebar
andriitserkovnyi Nov 3, 2023
2dd47c7
Merge branch 'master' into fulfillment-app
andriitserkovnyi Nov 3, 2023
18f7190
Update install-the-warehouse-picking-feature.md
andriitserkovnyi Nov 6, 2023
2d0ddaa
installation guides
andriitserkovnyi Nov 6, 2023
f5b4cb0
Merge branch 'master' into fulfillment-app
andriitserkovnyi Nov 6, 2023
bf52df7
Update install-the-warehouse-user-management-feature.md
andriitserkovnyi Nov 6, 2023
d4c6f4a
links
andriitserkovnyi Nov 7, 2023
09ce55a
Merge branch 'master' into fulfillment-app
andriitserkovnyi Nov 7, 2023
23e9c68
links
andriitserkovnyi Nov 7, 2023
cff0d99
names
andriitserkovnyi Nov 7, 2023
10a0e7d
Update docs-release-notes.md
andriitserkovnyi Nov 7, 2023
41541ea
Merge branch 'master' into fulfillment-app
andriitserkovnyi Nov 8, 2023
9406034
Merge branch 'master' into fulfillment-app
andriitserkovnyi Nov 9, 2023
1ea693d
Update docs-updates.md
andriitserkovnyi Nov 9, 2023
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 2 additions & 1 deletion CODEOWNERS
Original file line number Diff line number Diff line change
Expand Up @@ -8,4 +8,5 @@ docs/scos/dev/front-end-development/*/oryx/building-applications/oryx-localizati
/docs/scos/dev/front-end-development/*/oryx/building-applications/styling/oryx-icon-system.md @supproduction @tobi-or-not-tobi @andriitserkovnyi
/docs/scos/dev/front-end-development/*/oryx/building-applications/styling/oryx-design-tokens.md @tolerants @tobi-or-not-tobi @andriitserkovnyi
/docs/scos/dev/set-up-spryker-locally/* @andriitserkovnyi
/docs/pbc/all/dynamic-multistore/*/base-shop/dynamic-multistore-feature-overview.md @andriichekanov @a-sabaa @VadymSachenko
/docs/pbc/all/dynamic-multistore/*/base-shop/dynamic-multistore-feature-overview.md @andriichekanov @a-sabaa
/docs/pbc/all/warehouse-management-system/*/unified-commerce/ @andriispryker @andriitserkovnyi
25 changes: 8 additions & 17 deletions _data/sidebars/pbc_all_sidebar.yml
Original file line number Diff line number Diff line change
Expand Up @@ -3069,23 +3069,6 @@ entries:
url: /docs/pbc/all/product-relationship-management/third-party-integrations/8select.html
- title: trbo
url: /docs/pbc/all/product-relationship-management/third-party-integrations/trbo.html
- title: Push Notification
url: /docs/pbc/all/push-notification/unified-commerce/push-notification-feature-overview.html
include_versions:
- "202311.0"
nested:
- title: Unified Commerce
include_versions:
- "202311.0"
nested:
- title: Install and upgarde
nested:
- title: Install features
nested:
- title: Push Notification
url: /docs/pbc/all/push-notification/unified-commerce/install-and-upgrade/install-the-push-notification-feature.html
include_versions:
- "202311.0"
- title: Ratings and Reviews
url: /docs/pbc/all/ratings-reviews/ratings-and-reviews.html
nested:
Expand Down Expand Up @@ -3818,6 +3801,14 @@ entries:
nested:
- title: Install features
nested:
- title: Warehouse Picking
url: /docs/pbc/all/warehouse-picking//unified-commerce/install-and-upgrade/install-the-warehouse-picking-feature.html
include_versions:
- "202311.0"
- title: Warehouse Picking + Product
url: /docs/pbc/all/warehouse-picking/unified-commerce/install-and-upgrade/install-the-warehouse-picking-product-feature.html
include_versions:
- "202311.0"
- title: Warehouse User Management
url: /docs/pbc/all/warehouse-management-system//unified-commerce/install-and-upgrade/install-the-warehouse-user-management-feature.html
include_versions:
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ Install the required features:
| Order Management + Inventory Management | {{page.version}} | [Order Management and Inventory Management feature](/docs/scos/dev/feature-integration-guides/{{page.version}}/install-the-order-management-and-inventory-management-feature.html) |
| Shipment | {{page.version}} | [Install the Shipment feature](/docs/scos/dev/feature-integration-guides/{{page.version}}/shipment-feature-integration.html) |
| Push Notification | {{page.version}} | [Install the Push Notification feature](/docs/scos/dev/feature-integration-guides/{{page.version}}/install-the-push-notification-feature.html) |
| Spryker Core Back Office | {{page.version}} | [Install the Spryker Core Backoffice feature](/docs/scos/dev/feature-integration-guides/{{page.version}}/install-the-spryker-core-back-office-feature.html) |
| Spryker Core Back Office | {{page.version}} | [Install the Spryker Core Back Office feature](/docs/scos/dev/feature-integration-guides/{{page.version}}/install-the-spryker-core-back-office-feature.html) |

### 1) Install the required modules using Composer

Expand Down Expand Up @@ -255,7 +255,7 @@ class GlueBackendApiApplicationAuthorizationConnectorConfig extends SprykerGlueB
{% info_block warningBox "Verification" %}

Make sure that the OMS transition diagram shows the expected transitions:
1. In the Back Office of your demo store, navigate to **Administration&nbsp;<span aria-label="and then">></span> OMS**.
1. In the Back Office of your demo store, navigate to **Administration&nbsp;<span aria-label="and then">></span> OMS**.
2. To see the diagram, click the `DummyPayment01` process.
3. Make sure that the OMS transition diagram shows a possible transition from `waiting` to `picking list generation scheduled` and from `picking finished` to `exported`.

Expand Down Expand Up @@ -702,4 +702,4 @@ Make sure that push notification generation work for the picking list feature:
4. Wait until the order item status became **Ready for picking**.
5. Check the `spy_push_notification` database table to ensure that a push notification has been created.

{% endinfo_block %}
{% endinfo_block %}
Original file line number Diff line number Diff line change
Expand Up @@ -137,16 +137,6 @@ You can set different states for your order by clicking the action buttons. The
| Refund | Click this button in case of a refund. |
| Return | Click this button if the customer returns you either all or several items from the order. |

Marketplace order states flow:

* **New**—the initial order state.
* **Canceled**—the state of the order after it is canceled by the customer on the Storefront or by a Back Office user.
* **Sent to Merchant**—the state of the order when the payment is made and the marketplace order was successfully split into the merchant orders. The corresponding merchant got notified about the new order.
* When you select **Pay**, the order state becomes *Paid*. After a while, the status of the order changes to *Sent to Merchant*.
* When you select **Cancel**, the order state becomes *Canceled*.
* When you select **Close**, the order state becomes *Closed*.
* If the customer returns the ordered items: when you select **Return**, the state becomes *Waiting for return*. The merchant needs to execute the return in the Merchant Portal.
* Once the return is executed for the merchant order in the Merchant Portal, the state becomes *Refunded*.

**Tips & tricks**
<br>To change the state of all the items inside a shipment at once, in the **Trigger all matching states of order inside this shipment** section of the corresponding shipment, click **the next available state**.
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,73 @@
---
title: Change the state of order items
description: Learn how to change the state of order items in the Back Office.
last_updated: Aug 10, 2021
template: back-office-user-guide-template
originalLink: https://documentation.spryker.com/2021080/docs/managing-orders
originalArticleId: 6d125a8a-63ca-4ddc-bb74-1526aa1fe44b
redirect_from:
- /docs/scos/user/back-office-user-guides/202204.0/sales/orders/managing-orders.html
- /docs/scos/user/back-office-user-guides/202307.0/sales/orders/changing-the-state-of-order-items.html
related:
- title: Order Management feature overview
link: docs/scos/user/features/page.version/order-management-feature-overview/order-management-feature-overview.html
---

This article describes how to change the state of order items.

## Prerequisites

To start managing orders, go to **Sales&nbsp;<span aria-label="and then">></span> Orders**.

The instructions assume that there is an existing order with the **Payment pending** status.

Review the [reference information](#reference-information-changing-the-state-of-order-items) before you start, or look up the necessary information as you go through the process.

## Changing the state of all the items in an order

1. On the **Orders** page, click **View** next to the order containing the items you want to change the state of.
This opens the **Order Overview** page.
2. In the **TRIGGER ALL MATCHING STATES INSIDE THIS ORDER** pane, click **Pay**.

The page refreshes with the success message displayed. You can check the new state of the items in the order in the **ORDER ITEMS** pane.
3. Repeat step 2 until the items are in the needed state.

## Changing the state of items in a shipment

1. On the **Orders** page, click **View** next to the order containing the shipment you want to change the state of.
This opens the **Order Overview** page.
2. In the **ORDER ITEMS** pane, in the desired shipment, select the checkboxes next to the products you want to change the state of. If you want to change the state of all the items in the shipment, don't select any checkboxes.
3. In the **TRIGGER ALL MATCHING STATES OF ORDER INSIDE THIS SHIPMENT** pane, click **Pay**.
The page refreshes with the success message displayed.
4. Repeat step 2-3 until you get the needed status.


## Changing the state of an item

1. On the **Orders** page, click **View** next to the order containing the item you want to change the state of.
This opens the **Order Overview** page.
2. In the **ORDER ITEMS** pane, next to the needed item, click **Pay**.
The page refreshes with the success message displayed.
3. Repeat step 2 until you get the needed order state.

## Reference information: Changing the state of order items

The following table describes the states you can select for order items.

| ORDER STATUS | DESCRIPTION |
| --- | --- |
| Pay | Select this state once you receive the payment for the order from your customer. |
| Cancel | Select this state to cancel the order on the customer’s behalf. |
| Skip Timeout | Select this status to end the time period during which the customer can cancel the order. |
| Generate invoice | Select this state to generate the invoice and send it to the customer. If invoice BCC is configured for your project, the copy of the invoice will be sent to the specified email address as well. You can trigger the invoice-generate only for the whole order. Even if you selected just some of the order items, the invoice is generated for the whole order.|
| Picking list generation schedule | Select this state to generate a picklist. Available with the [Fulfillment App feature](/docs/pbc/all/warehouse-management-system/202311.0/unified-commerce/fulfillment-app-feature-overview.html). |
| Prepare for picking | Makes the picklist available in the Fulfillment App. Available with the [Fulfillment App feature](/docs/pbc/all/warehouse-management-system/202311.0/unified-commerce/fulfillment-app-feature-overview.html). |
| Ship | Select this state once the order is shipped.|
| Stock-update | Select this state when you update the number of available products of products in **Products&nbsp;<span aria-label="and then">></span> Availability**. |
| Close| Select this state when your customer has successfully received the ordered items and is satisfied with their quality.|
| Return | Select this state if the customer returns you either all or several items from the order. |
| Refund | Select this state in case of a refund.|

### State names

The order statuses you set here do not always have the same wording on the Storefront. For details on how you can display custom names for statuses on the Storefront, see [HowTo - Display custom names for order item states on the Storefront](/docs/pbc/all/order-management-system/{{page.version}}/base-shop/display-custom-names-for-order-item-states-on-the-storefront.html).
Loading
Loading