ShipStation is implementing a proactive upgrade to accommodate larger order IDs, ensuring continued service and scalability. This update will move our systems from 32-bit to 64-bit. If you use the ShipStation API and do not operate on a system that accommodates integers larger than 32-bit, this upgrade could potentially disrupt your workflow.
We recommend you prepare in advance for this upgrade and make any necessary changes to your system to avoid disruption.
You may be impacted by this upgrade if your stores include the following:
-
A custom-built integration using ShipStation's API
-
Order IDs from a custom-built integration that are stored in a database
-
Use of a programming language that requires explicit handling of data types
ShipStation is unable to provide assistance with any modifications to your system. However, you can take the following steps to ensure that your workflow is not disrupted by this upgrade.
When your software interacts with the ShipStation API, it might use a specific number format that is limited to 32-bit integers. Some programming languages can handle any size number, but others need you to specify the size. Most programming languages automatically handle different sizes of numbers and you won't need to do anything. However, we recommend checking your programming language, code, or database storage to avoid disruption.
Here's how to check:
-
Review Your Program Language: Some languages need you to specify if you are dealing with bigger numbers.
-
Java, C#, and Go potentially need adjustments because they use specific settings for larger numbers.
-
Python and JavaScript can typically manage any number size and are not likely to need adjusting.
-
-
Check Your Code: If you look at your software's code and see a part where data from ShipStation is being organized (known as "deserializing into a model") and it mentions 32-bit integers, your software uses 32-bit integers.
-
Verify Database Storage: For databases storing these numbers, you need to make sure the place where the numbers are stored (called a column) can handle large numbers. The correct type of column is called "bigint."
The following resources can help you learn how to update your database: