Menu
Feedback
Start here

Troubleshooting

Troubleshooting
The order doesn't progress after the status "Ready for handling"
Published on2/3/2025
Last updated on2/3/2025
2 min read

The Ready for handling status occurs in the order flow right after the cancellation window is closed. At this point, VTEX should receive information from the ERP system indicating that the order has been integrated and the item stock has been updated, allowing the flow to proceed to the Handling shipment status.

Until VTEX receives this confirmation, the order remains in the Ready for handling status.

Solution

The first required action is to contact the person in charge of your ERP integration and confirm that the order has been released via the Start handling order endpoint. Once this is confirmed, follow the steps below:

  1. In the VTEX Admin, go to Orders > All Orders, or type All Orders in the search bar at the top of the page.
  2. Go to the desired order.
  3. On the order details page, check if the order status has changed to Handling shipment.

If the order remains in the status Ready for handling, request more information by opening a ticket with VTEX Support.

Updating the order manually (optional)

The merchant can manually update the order status to Handling shipment via Admin VTEX, if desired. However, to perform this action, they must have a role with OMS - Full access permission.

By manually updating the status and confirming the start of handling, the seller assumes responsibility for reserving items, gensuring there is sufficient stock, and that the sold items are deducted from the inventory. Manually updated orders can't be integrated into the ERP system later.

If the order remains in the status Ready for handling after the manual update attempt, request more information by opening a ticket with VTEX Support.

In addition to the error scenario related to the ERP system, there may be situations in which two different statuses are displayed for the same order: one in the list on the All Orders page and another on the respective order details page. For more information about this scenario, see the known issue Status in the order list is different from the current order status.

Contributors
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
Was this helpful?
Yes
No
Suggest Edits (GitHub)
Contributors
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
On this page
Still got questions?
Ask the community
Find solutions and share ideas in the VTEX Community
Join our community
Request VTEX support
For personalized assistance, contact our experts
Open a support ticket
GitHubDeveloper PortalCommunityFeedback