Hi everyone,
We’re a 3PL on ShipHero with several warehouses, and we print shipping labels through the Experimental API (label_quote / label_print). Printing works for some orders but fails for others, and we’d like to hear how other 3PLs handle this.
What we see
- label_quote / label_print with our 3PL API user: “Line item does not belong to warehouse” (code 3)
- label_print with tote_id: “Tote does not belong to warehouse” (code 3)
- label_print with the client’s own API token: “Line item has no pending shipment line item in warehouse” (code 3)
- The same orders print fine in the ShipHero web app.
What we learned so far (with ShipHero Support)
- label_quote and label_print run in the Default Warehouse of the user who owns the API token. PrintLabelInput / LabelQuoteInput have no warehouse field, and “Allowed Warehouses” don’t count for the API. We tested this: a user with every warehouse allowed is still refused outside its Default Warehouse.
- So for several warehouses you need one API user (and token) per warehouse, each with its own Default Warehouse, and you send each order to the token of the warehouse it’s allocated to. Developer users can’t have a Default Warehouse set in Users & Roles, so we use normal users with tokens from the “Public API tokens” page. This works: a user with Default Warehouse = our Fresno warehouse printed an order allocated there.
- The harder case: one client’s store integration creates orders without a warehouse on the line items. Because that client account has its own warehouse, the lines are stored on the client’s warehouse, while the order is allocated to ours. label_print checks the warehouse stored on each line as well as the allocation, so these orders can’t be printed through the API with any token, ours or the client’s. Support confirmed this, reported it to engineering, and suggested printing those orders in the web app for now.
Questions for the community
- Has anyone run into the line-item warehouse vs allocation mismatch on 3PL orders, and found a reliable way to fix existing orders (order_change_warehouse, order_update_line_items or anything else) so they print through the API?
- Can a 3PL client account be set up so new lines default to the 3PL’s warehouse instead of the client’s own warehouse?
- How do you manage one API user per warehouse in practice (token renewal, credits per user, naming)?
- Has anyone printed through shipment_create with labels bought outside ShipHero as a fallback, and how did it affect inventory and totes?
- Any news on choosing the warehouse in label_print, or an ETA for the line-item warehouse check fix?
Thanks in advance for any experience you can share!