[Does a Fulfillment support one more multiple tracking numbers?

[EugeneKim]

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:

Which is correct?

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

Thank you!

[traderkrut]

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.

[stickfigure]

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

[traderkrut]

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.

[cottton]

Atm there is no PUT method on REST 

/fulfillments/{$fulfillmentId}.json

or

/fulfillments/{$fulfillmentId}/update_tracking.json

Not in documentation, and a PUT request returns [406][Not Acceptable].

Both tested with "tracking_numbers" and "numbers" -array.

Tested POST /fulfillments/{$fulfillmentId}/update_tracking.json -

no error, but it just removes any tracking previously added and does not add any number (seems buggy).

This is a problem.

If you sell an item that is bulky, so you send out 2 parcels because the 2nd one is "small",

then you have 2 tracking numbers ...

and can add only one.

sAdFaCe