# PO# Field Not Available?

**URL:** <https://community.shiphero.com/t/po-field-not-available/3732>\
**Category:** GraphQL API\
**Created:** [June 29, 2026, 6:56pm UTC](https://community.shiphero.com/t/po-field-not-available/3732 "2026-06-29T18:56:00Z")\
**Posts on this page:** 5\
**Page:** 1

<div class="post-metadata">

**Author:** ![Alli](https://avatars.discourse-cdn.com/v4/letter/a/f1d935/32.png) [@Alli](https://community.shiphero.com/u/Alli)\
**Post date:** [June 29, 2026, 6:56pm UTC](https://community.shiphero.com/t/po-field-not-available/3732/1 "2026-06-29T18:56:00Z")

</div>

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! 😊

---

<div class="post-metadata">

**Author:** ![jjconti](https://avatars.discourse-cdn.com/v4/letter/j/bcef8e/32.png) [@jjconti](https://community.shiphero.com/u/jjconti)\
**Post date:** [June 30, 2026, 5:51pm UTC](https://community.shiphero.com/t/po-field-not-available/3732/2 "2026-06-30T17:51:42Z")

</div>

Hi Alli,

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.

---

<div class="post-metadata">

**Author:** ![Alli](https://avatars.discourse-cdn.com/v4/letter/a/f1d935/32.png) [@Alli](https://community.shiphero.com/u/Alli)\
**Post date:** [June 30, 2026, 7:10pm UTC](https://community.shiphero.com/t/po-field-not-available/3732/3 "2026-06-30T19:10:50Z")

</div>

Aloha!

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?

---

<div class="post-metadata">

**Author:** ![jjconti](https://avatars.discourse-cdn.com/v4/letter/j/bcef8e/32.png) [@jjconti](https://community.shiphero.com/u/jjconti)\
**Post date:** [June 30, 2026, 8:46pm UTC](https://community.shiphero.com/t/po-field-not-available/3732/4 "2026-06-30T20:46:07Z")

</div>

Yes, you can use the order\_create mutation where order\_number is one of the fields: [Examples – Developer Resources | ShipHero](https://developer.shiphero.com/examples/#ordercreate)

Or if you want to create a wholesale order: [Wholesale Orders – Developer Resources | ShipHero](https://developer.shiphero.com/flows/wholesale/#creating-wholesale-orders)

---

<div class="post-metadata">

**Author:** ![system](https://us1.discourse-cdn.com/flex020/uploads/shiphero/original/2X/8/83f2a5ec5d7908b156cb6999baa4c753fadfa85d.svg) [@system](https://community.shiphero.com/u/system)\
**Post date:** [September 28, 2026, 8:46pm UTC](https://community.shiphero.com/t/po-field-not-available/3732/5 "2026-09-28T20:46:19Z")

</div>

This topic was automatically closed 90 days after the last reply. New replies are no longer allowed.
