Hello!
We use Shopify Plus B2B integrated directly with ShipHero. When our team creates wholesale orders in Shopify, we manually enter our customer’s PO# into Shopify’s PO field.
Our challenge is that ShipHero only imports the Shopify order number (e.g. WHOLESALE-1090), not the customer’s PO#.
For our business, the PO# is the true reference number. We need to be able to:
Search orders by PO# within ShipHero.
Display the PO# prominently on shipping labels and packing slips.
Ideally have the PO# function as a primary order identifier rather than a note or gift message.
I’ve been told this isn’t supported through the standard Shopify integration and would require using the GraphQL API or a custom integration. However, I haven’t been been able to determine whether ShipHero has an existing field that can function as a true customer PO field.
Has anyone successfully implemented this?
Specifically:
Which ShipHero field did you map the Shopify PO# to?
Is it searchable within the ShipHero UI?
Can it be printed on shipping labels and packing slips?
Or is this simply a limitation of ShipHero’s current data model?
We’re trying to avoid using the gift note or notes fields since that would require entering the PO# twice (once in Shopify’s PO field and again in a notes field) and still wouldn’t allow it to function as a true order identifier.
Any guidance or recommendations would be greatly appreciated. Thank you!
At the moment, the standard Shopify integration does not map Shopify’s PO field into a dedicated ShipHero Order field. ShipHero imports Shopify’s order name/number as the ShipHero order_number, and Shopify’s order ID as partner_order_id.
If the PO# needs to behave as the primary searchable identifier, the practical custom integration approach would be to create the ShipHero order with the customer PO# as order_number, while keeping the Shopify order ID in partner_order_id. That would make the PO# show up anywhere ShipHero uses the order number, but it also means the ShipHero order number would no longer be the Shopify order name like WHOLESALE-1090.
For the direct Shopify integration, the closest workarounds are to copy the PO# into a tag or into a Shopify note attribute such as packing-note/gift-note using Shopify Flow, if available. ShipHero can import those into searchable/displayable note fields, but they are not true order identifiers.
So in short: today this is a limitation of the current Shopify integration/data model rather than a supported native PO# mapping.
Thank you so much for the detailed explanation. This is very helpful and makes a lot more sense.
Just so I am making sure I am 100% understanding the above correctly - Can you please confirm if ShipHero API allow a custom integration to set the order_number field when creating an order?
