Menu
Feedback
Known issues
Special characters in invoiceNumber cause post-purchase flow to fail
Order Management
ID: 953285
Fixed
Published on11/14/2025
Last updated on11/14/2025
2 min read

Summary

During the invoice flow, the Orders system allows you to enter values in the “invoiceNumber” field (via UI or API) that contain special characters, either at the beginning, middle or end, for example: “#123456”, “123/456” or “123456/”.

However, the SNO system responsible for registering the invoice is unable to process these values correctly, which can impact various post-purchase flows. This can result in errors or failures in the execution of processes such as:

  • Tracking updates;
  • Changing the order status to “Invoiced”;
  • Communication with the GiftCardHub system;
  • And any other flow that depends on the “invoiceNumber” field.

Simulation

1- Invoice an order by entering the following example invoice number: "#123456"; (special characters at the beginning, middle of the number or at the end)

2- Note that the order will not be updated to invoiced status

3- In the case of flows involving a seller, in the Get Order of the seller's order it will be possible to see the saved invoice, but even then the marketplace order will not be updated to invoiced, as the system will not be able to pass on the invoice.

Workaround

Orders with invoices that contain special characters cannot be adjusted afterward. To avoid disruptions during the order flow we recommend using only alphanumeric characters in the invoiceNumber field.

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