ShipStation Replacement Labels
Keep tracking numbers right when you void and replace a label, or ship another carton, in ShipStation.
When you void a label in ShipStation and create a replacement, or ship another carton for an order that already shipped, ShipStation sends Zoey the new tracking number. These settings tell Zoey what to do with it, so your customer always has a tracking number that works.
Use it to:
- Replace a voided tracking number with the new one on the same shipment
- Add tracking numbers for extra cartons and reships
- Choose whether customers get an email when a tracking number is added
Replacing voided labels needs ShipStation API Keys. Zoey uses the V1 API Key and Secret to check which of the order's labels were voided in ShipStation. Without them, Zoey adds every new tracking number to the shipment, and the voided number stays on the order.
Turn On Replacement Labels
- In the Zoey Admin, go to Integrations > ShipStation and click Manage Connection.
- In ShipStation API Keys, set Enable REST API Features to Yes and enter your V1 API Key and Secret. See ShipStation API Keys.
- In Replacement Labels, choose the settings below.
- Click Save.
Settings
| Setting | Default | What it does |
|---|---|---|
| Replace Voided Labels | Yes | If one of the order's tracking numbers was voided in ShipStation, Zoey replaces it with the new number on the same shipment and adds an Order History comment. The shipment email goes to the customer if ShipStation was set to notify them. |
| When the Replacement Has Different Items | Replace tracking only and add a comment to review | Replace tracking only and add a comment to review swaps the tracking number and adds a comment so you can check the items. Nothing else changes. Void the shipment and create a new one with the new items voids the Zoey shipment and creates a new one with the items on the new label. |
| Add Tracking from Extra Labels | Yes | If no voided label matches, for example a second carton, a reship or no API Keys, Zoey adds the new number to the latest shipment and adds an Order History comment. |
| Email Customer for Extra Labels | No | When set to Yes, the customer gets the shipment email with the added tracking number. |
If Replace Voided Labels and Add Tracking from Extra Labels are both set to No, Zoey ignores new tracking numbers for items that already shipped.
What You See on the Order
Each new tracking number adds a comment to the order's Order History, for example:
ShipStation sent another label (1Z999AA10123456784) for items that already shipped. The tracking number was added to shipment SH100000001.
Replacement labels never change quantities, invoices or payments. Split shipments work as before.
Voiding a Label Without a Replacement
ShipStation doesn't tell Zoey when you void a label. Zoey only finds out when a replacement label arrives. If you void a label and don't create a new one, void the shipment in Zoey yourself.
Updated about 2 hours ago
