[Does a Fulfillment support one more multiple tracking numbers?

The 2020-01 Fulfillment API documentation says that each fulfillment only supports a single tracking number:

 

Each fulfillment supports a single tracking number. If you need to use multiple tracking numbers, then you should create separate fulfillments.

Listed in fulfillment properties is the `tracking_numbers` property which is clearly an array. The description suggests that multiple tracking numbers are supported in a single fulfillment instance:

 

Screen Shot 2020-04-11 at 6.52.26 PM.png

 

Which is correct?

 

Some clarity and an update to the documentation would be great.

 

Thank you!

TrackPack

Gain shipment visibility, increase customer confidence and optimize your customer support using TrackPack's Email / SMS shipping notifications and order tracking page generator.
traderkrut
Shopify Partner
8 1 1

Came here to post the same thing. It seems to be the case for both `tracking_numbers` and, correspondingly, `tracking_urls`.

Even more confusing - the GraphQL Fulfillment object contains a `tracking_info` field that uses the singular `number` and `url`:
https://shopify.dev/docs/admin-api/graphql/reference/object/fulfillment/fulfillmenttrackinginfo?api[...

I haven't tested this recently, but I believe I've been able to add multiple tracking numbers and URLs to a single fulfillment via the REST API.

So, are the singular properties merely a recommendation at this point? If so, the GraphQL values must be simply grabbing the first item from a list and crossing fingers there aren't any more?

Would love some clarification on this as well.

0 Likes
stickfigure
Shopify Partner
37 2 4

Bumping this. How can I add another tracking number to a fulfillment?

0 Likes
traderkrut
Shopify Partner
8 1 1

I haven't tested this since last year, but I am fairly certain that you can have multiple tracking numbers on a fulfillment, or "add a tracking number to a fulfillment", by supplying them all as an array under "tracking_numbers" via either of the Fulfillment update REST endpoints:

PUT /admin/api/2020-01/orders/{order_id}/fulfillments/{fulfillment_id}.json

POST /admin/api/2020-01/fulfillments/{fulfillment_id}/update_tracking.json

It's a bit confusing, as the examples only show the ability to update "tracking_number" (singular), but "tracking_numbers" is still listed as a Fulfillment property and I'm fairly certain you can provide a list under a "tracking_numbers" key.

For what it's worth, Shopify's documentation for the Fulfillment resource also says:

Each fulfillment supports a single tracking number. If you need to use multiple tracking numbers, then you should create separate fulfillments.

In my opinion, it seems that "multiple tracking numbers per fulfillment" is a softly-deprecated behavior that Shopify still allows for legacy support, but they discourage it now. It would be great if they would address this specifically.

0 Likes