Menu
Feedback
Start here

Troubleshooting

Troubleshooting
The order doesn't progress after the status "Handling shipping"
Published on2/7/2025
Last updated on2/7/2025
2 min read

The status Handling shipping occurs in the order flow shortly after the seller starts handling the items. At this point, VTEX must receive the order's invoice details, updating the flow with the Invoiced or Canceled status.

You can't cancel orders that have already been partially invoiced. If the customer wants to replace or remove items, they can change the order.

An order remaining in the status Handling shipping longer than expected may be due to the invoices not being registered on VTEX.

Solution

Checking invoices in ERP integrations

The first action required is to contact the person responsible for your ERP integration and check whether the single invoice or all partial invoices have already been registered via the Order invoice notification endpoint.

After this confirmation, follow the steps below to check if the status has changed:

  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 changed to Invoiced.

If the order still has the status Handling shipping, check if there's any inconsistency in the communication with the marketplace. Learn more in The order was billed in the ERP but remains in the "Handling shipping" status. What to do?.

Adding invoices manually (optional)

Merchants can add invoices to the VTEX Admin via manual order invoicing. This action allows the order status to be updated from Handling shipping to Invoiced.

To ensure that the order is invoiced correctly, the following requirements must be met:

  • The invoice total must be equal to the sum of the item prices in the order and their respective shipping costs. If the invoice amount is lower than the total, you must add a partial invoice for the remaining amount.
  • Each invoice issued, whether total or partial, must have a unique number.
  • When you need to issue more than one invoice for an order, their combined total must equal the order's total amount.
  • The total order amount will be updated if items are changed or removed.

If the order remains in the Invoiced status after manually adding invoices, open a ticket with Suporte VTEX for further assistance.

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