The order flow describes the status, possibilities, and actions throughout the life cycle of an order. With the flow, retailers can also track the mapped order status on the platform.

This article will present the following information:

• The different types of order flows available on the platform: marketplace flow, seller flow, chain flow, and complete flow.
• A table with all the order statuses available on the Admin and via API.
• Scenarios in which orders are canceled.

Learn how to track an order flow in the article Order tracking.

There are four possible order flows on the VTEX platform:

• Marketplace flow: The order flow visible to the store responsible for the sale only.
• Seller flow: The order flow visible to the store responsible for handling the order.
• Complete flow: The order flow visible to the store responsible for the order's sale and delivery. In this case, the store acts both as a seller and marketplace.
• Chain flow: The order flow visible to the store that acts as an intermediary between the marketplace and the seller. This flow is similar to the marketplace flow. However, the payment is made only in the marketplace, not in the store that acts as a chain. This flow occurs in Multilevel Omnichannel Inventory sales scenarios.

For incomplete orders, check out the article How incomplete orders work to understand their flow and cancellation.

The marketplace flow is integrated with the seller flow. When an order delivered by an external seller (which is not the main seller) is finalized, this is the flow visible to the marketplace:

1. Starts with the status Waiting for seller confirmation and automatically switches to the status Payment pending. Since the marketplace is responsible for receiving payment, there are two possible upcoming statuses:
   • If the marketplace receives the payment: The status changes to Payment approved.
   • If the marketplace does not receive the payment: The order cancellation process is initiated, and the status changes to Canceling.
2. Once the payment has been approved and the grace period for cancellation (stage visible to the seller) has expired, the marketplace must wait for the seller to start handling the order. This is an active action indicating that the seller has started preparing the order packages. If the seller does not perform this action, the order remains in the status Ready for handling.
3. Once the seller confirms the order handling, the marketplace order status can remain as Verifying invoice if there are any errors. Check out the most common reasons for the order to remain in this status. Remember that if the order is only partially invoiced, its status may go back to Payment approved, and the retailer must add the invoices correctly. The total sum of the invoices must equal the total order value.
4. After confirming the order handling, the order is prepared for shipping by the seller.
5. When the seller adds the invoices correctly, the status changes to Invoiced. This status means that the purchase transaction has been successfully completed, and you can no longer change the order status. The payment is settled when the order is at this status.
6. The seller must complete the fulfillment process.

Learn how to identify orders from marketplaces in the article Viewing marketplace orders in All Orders.

This is the order flow visible to the store responsible for shipping the order products. In this case, the order was placed through another store (online marketplace), and the seller flow starts once the order is confirmed.

1. When the seller receives the order, its initial status is Order accepted.
2. Then the order status automatically changes to Waiting for fulfillment authorization. This is a waiting status for the marketplace to indicate that the order payment has been confirmed.

The platform allows you to manually change the status Waiting for fulfillment authorization by clicking Authorize fulfillment. However, when the seller does that manually, it does not necessarily mean that the marketplace has authorized the order fulfillment, which can lead to a mismatch of information. So use this option with caution. We recommend using it only if the marketplace has authorized the order fulfillment.

3. The status automatically changes to Cancellation window. The order will remain at this status until the cancellation window is closed.

The Cancellation window allows the customer to cancel the purchase without the store's approval, within a period of time previously configured by the store. After this period, the store must authorize the customer's cancellation request.

4. At this stage, there are two possible statuses:
   • Order not canceled: If the cancellation window period expires and the customer does not request the purchase cancellation, the status changes to Ready for handling. This status indicates to the seller that they can begin handling the order for delivery.
   • Canceled order: If the customer has requested the order cancellation within the grace period, the order status will change to Canceling.
5. The order will remain in the status Ready for handling until the seller changes it by confirming they have started the order handling. The seller can confirm it manually in the Admin, or via ERP API integration using the Start handling order request.

By confirming the order handling, the seller takes responsibility for reserving the order items. From that moment on, if there are any updates in the inventory, the VTEX platform dismisses these SKUs' reservation. Therefore, update the inventory only after the order has been invoiced. By doing so, you avoid inventory discrepancies in the integration with your store's backoffice.

6. Once the order is handled, it is time to invoice it. You have to add the invoice to the platform to move to the next stage. In case there are any errors, the order status can remain at Verifying invoice. Check out the most common reasons for the order to remain in this status. Remember that if the order is only partially invoiced, its status may go back to 'Payment approved', and the retailer must add the invoices (the sum of which corresponds to the total value of the order).
7. The last status of this flow is Invoiced. After that, the seller must deliver the order.

Please note that:

• The order can be canceled at various stages of the order flow, either by the customer or the store. In this case, once requested, the cancellation process occurs automatically, as well as the order refund to the customer. The cancellation process is finished when the order status is Canceled.
• Sellers have the autonomy to manually change the order status when the order is Waiting for fulfillment authorization. In this case, the seller assumes the responsibility of delivering the order without the marketplace confirmation and without receiving the order payment. If the order status has been changed manually, it is the seller's responsibility to check whether the order is ready for handling and the payment has been confirmed.

The complete order flow is visible to the store that sells and delivers the order. It is composed of the marketplace flow followed by the seller flow.

1. The initial stage of the order flow is Waiting for seller confirmation, to indicate the seller has received the order.
2. The order automatically moves to the Payment pending status.
3. The system waits for the payment confirmation and changes the status to one of the following:
   • The order payment is approved: The order status changes to Payment approved and then Cancellation window. This status delimits the customer's grace period to cancel the purchase without the store's approval. The order will remain in this status until the end of the period configured.
   • The payment of the order is not approved: The platform initiates the cancellation process. This happens automatically as the order status goes from Payment denied to Canceling. Once the platform completes the cancellation, the status changes to Canceled, which is the last stage of the flow. With the payment approved and the cancellation window expired, the order status changes to Ready for handling.
4. This status shows the retailer that the payment has been confirmed, and they can start handling the order. The store must confirm the order handling has started for the order to advance in the flow. This confirmation can be done manually in the Admin or via an ERP API using the Start handling order request.

By confirming the order handling, the seller takes responsibility for reserving the order items. From that moment on, if there are any updates in the inventory, the VTEX platform dismisses these SKUs' reservation. Therefore, update their inventory only after the order has been invoiced. By doing so, you avoid inventory discrepancies in the integration with your store's backoffice.

5. Once the order handling starts, the order status changes to Handling shipping and the next step is to invoice the order. The system waits for the invoice with status Verifying invoice. You must add the invoice that corresponds to the total value of the order.
6. Once this is done, the order status changes to the last status, which is Invoiced and the store must ship the order.

The retailer can cancel orders only before they have been Invoiced. Once invoiced, the customer can return items, but no longer change the order. Check out the articles How to cancel orders and Order cancellation requested by the customer to learn more about order cancellation from a store and customer perspectives.

Orders can be canceled for several reasons. Each type of cancellation is indicated by a different stage in the order flow:

• Incomplete orders: When the order is incomplete, the order flow cannot start. This prevents the seller from handling items and, consequently, no reservation of the inventory is made.
• Customer cancellation request: The customer cancels the order within the grace period or requests the order cancellation to the store. The order items are not reserved when the cancellation occurs within the grace period. However, the items will be reserved if the cancellation occurs after the order has been handled (after the Start handling status).
• Order cancellation by the store: When the seller or marketplace cancels the order.

Once there is a request to cancel an order, the platform processes the order cancellation automatically. The payment refund to the customer depends on the stage the payment is at and the payment method used.

Orders with partial invoices cannot be canceled. If the customer wants to replace or remove items from the order, it is possible to change the order.

Learn more about cancellation and refunds in the articles Why was my cancelled order charged in the customer's invoice?, and Refund or cancellation.

While the cancellation is being processed, the order status remains at Canceling. The order status changes to Canceled when the cancellation is complete.

Note that when the cancellation occurs before the store starts handling the order, the items have the reservation cancelled in inventory. However, if the cancellation is made after this stage, the items will already be reserved in the inventory. So the store must update the number of items in stock. This will make the order SKUs available for sale again.

Learn more about order cancellation in the article Why was my order cancelled?.

The order flow seen by the intermediate store in a Multilevel Omnichannel Inventory is similar to the marketplace order flow, except for receiving the payment for orders. In the Payment pending stage, instead of the chain receiving payment directly from the gateway, the marketplace informs the chain it has received the payment confirmation.

• Incomplete orders: All orders are considered incomplete at the beginning of the flow. Orders are completed at the last stage of the purchase. If the order does not proceed to the last stage, there may have been an issue during payment (external to VTEX) or missing data.
• Orders can be changed until they start to be invoiced. Learn more about changing and replacing items in the articles Order replacement and Changing items from a completed order.
• If the customer requests an order cancellation and the retailer denies it, the order can proceed to the Payment pending status.
• For order flows at the stage Ready for handling, the store must actively confirm the information for the order to advance in the flow.
• The number of items in stock is updated automatically. Learn more about product reservation and inventory updates in the article How the reservation works.

Here is a table with more details about each order status. The table is divided into the following columns:

• Status (Orders management): Status identified in the Admin.
• Status (API): Status identification via API.
• Viewed by: The flow in which the status is visible (marketplace, seller, chain, and complete).
• Meaning: The detailed status meaning.

Note that the complete order flow (visible to the stores responsible for selling and delivering orders) matches the marketplace and seller flows. Some statuses are visible via API, but not in the order flow in All Orders module.

Admin status	API status	My account status	Viewed by	Meaning
-	null	-	Marketplace, seller, chain and complete flow	Incomplete orders. The system can still launch the flow, or the order status is CancellationData, which means an error occurred.
-	order-created*	-	Marketplace, chain and complete flow	Order created. The order data is being processed. This is the first status of an order, and indicates that the system has the necessary information to process it.
Order accepted	order-accepted	-	Seller	The seller received the order.
Canceling	cancel*	-	Marketplace, seller, chain and complete flow	The order is being canceled. At this stage, the platform notifies the Payments module about the cancellation. The order will remain in this status until the Payments module completes the cancellation process.
-	on-order-completed	-	Marketplace, chain and complete flow	The purchase has been processed at checkout. The order data is complete.
-	on-order-completed-ffm	-	Seller	The purchase has been processed at checkout. The order data is complete.
Payment denied	-	Canceled	Marketplace, complete flow and chain flow	The payment was denied.
Payment approved	payment-approved	Payment approved	Marketplace, chain and complete flow	The order payment has been approved.
Payment pending	payment-pending	Approving payment	Marketplace, chain and complete flow	Waiting status for payment confirmation in the Payments module. Regardless of whether the payment has been confirmed or not, this step is mandatory.
Cancellation requested	request-cancel	-	Marketplace and complete flow	The customer requested the order cancellation.
Canceled	canceled	Canceled	Marketplace, seller, chain and complete flow	The order has been canceled, therefore, it was not completed. The payment transaction in the Payments module is canceled at this point.
Window to change payment	window-to-change-payment	-	Marketplace	Time period the payment can be changed.
Window to change seller	window-to-change-seller	-	Marketplace	Time period the seller can be changed.
Waiting for seller confirmation	waiting-for-authorization	Order placed	Marketplace, complete flow and chain flow	Waiting for the seller's authorization to proceed with the order flow.
-	waiting-for-fulfillment	-	Seller	Waits for order's fulfillment. Status exclusive for stores that have a Warehouse Management System (WMS). When the marketplace does not authorize the seller to fulfill the order within 30 days, this order is automatically canceled by the platform.
-	waiting-ffmt-authorization	-	Seller	Awaiting the marketplace authorization.
Waiting for fulfillment authorization	waiting-for-manual-authorization	-	Seller	It is a waiting status, in which the seller waits for the marketplace to authorize the order flow to continue.
Authorize fulfillment	authorize-fulfillment	-	Seller and complete flow	Internal process for approving the order handling. In this status, the platform confirms the item reservation. If not authorized within 30 days, the order is automatically canceled by the platform.
Cancellation window	window-to-cancel	Handling order	Seller and complete flow	Status of the customer order cancellation time frame. After payment approval, the customer has 30 minutes (default) to cancel the order. During this period, the platform refunds the order automatically. Learn more in Settings.
-	ready-for-invoicing	-	Marketplace and complete flow	The order is ready to be invoiced only for stores that have picking and packing in the fulfillment process.
Verifying invoice	invoice*	Handling order	Marketplace, chain and complete flow	The platform is verifying the invoice. If the order remains at this stage, there may have been a problem settling the payment or adding the invoice. Learn more in Why is the order in the "Verifying invoice" status?.
Invoiced	invoiced	In transit to carrier	Marketplace, seller, chain and complete flow	The flow was completed successfully and the order was delivered to the carrier. If the transaction was made via credit card, the payment settlement occurs at this point.
Invoiced	invoiced (after using the Update order tracking endpoint)	Delivering order	Marketplace, seller, chain and complete flow	The flow was completed successfully and the order is being delivered. If the transaction was made via credit card, the payment settlement occurs at this point.
Invoiced	invoiced (after sending true in the field isDelivered of the Update order tracking endpoint)	Order shipped	Marketplace, seller, chain and complete flow	The flow was completed successfully and the order is being delivered. If the transaction was made via credit card, the payment settlement occurs at this point.
Ready for handling	ready-for-handling	Handling order	Seller	Status that indicates that you need to start order handling, prepare the invoice, and track the order. The platform reserves the item. Usually handled by an ERP integration.
Start handling	start-handling*	-	Seller and complete flow	Authorization status to continue the order handling flow. Used when authorized manually. If there is ERP integration, this status waits for ERP confirmation.
Cancellation requested	cancellation-requested	-	Seller	Cancellation requested.
-	waiting-for-mkt-authorization	-	Chain	Waiting for the marketplace authorization to send the authorization to the seller.
-	waiting-seller-handling	-	Marketplace	Marketplace from the main account waiting for the handling process to start (Multilevel Omnichannel Inventory). White label seller sees authorize-fulfillment.
Handling shipping	handling	Handling order	Seller and complete flow	In this status, the order items are reserved. The order remains at this status until it receives an invoice notification, usually from the ERP.
Approve payment	-	-	Marketplace and complete flow	Indicated by the system. The flow does not stop at this status unless there is an error.
Waiting for the seller decision	-	-	Marketplace and complete flow	Waiting for the seller to decide if the order will be canceled.
Request cancellation	-	-	Marketplace and complete flow	Status initiating cancellation flow. Possible cancellations: by the store or by the customer.

The statuses marked with asterisks (*) in the table do not allow modification or cancellation because the platform changes them automatically.