Frequently Asked Questions

tip

Help with Shopify store configuration.

Locations

Order fulfillment requests are not going to the desired location:

• Check the location has shipping rates defined for the order's destination.
• Check that another location hasn't been given shipping order routing priority.
• Check the location has product inventory allocated for all products being ordered.

More detail about setting up your location fulfillments in Shopify.

Products

SKU matching:

The Shopify app expects products contained in the fulfillment order to have matching products for the client partner in Consignly, matching Shopify SKUs with Consignly product codes. This match can be case insensitive, but otherwise must be an exact match e.g. widget001 can be matched with WIDGET001.

Inventory management:

Automatic syncing of Shopify inventory stock-on-hand quantities from Consignly can be turned on at the location level. Syncing typically happens hourly.

Shipping Notifications

Automatic shipping notifications are not being sent to the customer:

Missing or incomplete tracking details for Consignly consignments are the most likely cause of missing shipping notifications.

Tracking details should be added to a consignment in Consignly before updating its status to In Transit, or other subsequent statuses. If tracking details are added after the status has been updated, there's a possibility that the Shopify order will have been updated before the optional tracking details were made available.

If a tracking url is not provided with the tracking number in Consignly, then Shopify only sends notifications when the carrier name provided is an exact match to one of the Shopify supported tracking companies. Using a carrier name which exactly matches a name used by Shopify should resolve the issue.

Shopify Orders

Shopify order updates:

Shopify orders are updated automatically. The Consignly consignment is checked for updates every 15 / 60 mins, depending on your plan.

If the consignment status changes to:

• In Transit, Complete or Closed, the Shopify fulfillment request will be updated as fulfilled. The order will also be updated with the transport company and tracking number if available.
• Void, the Shopify fulfillment request will be rejected.

Additional fulfilled item attributes captured from Consignly:

When a consignment is fulfilled, Consignly can return more detail about what was actually picked than Shopify's fulfillment record can hold. The app captures the following against each picked product on the consignment:

• Batch
• Best before date
• Expiry date
• Packaging date
• Production date
• Sell by date
• Items - the serial numbers picked

They are saved to the Fulfilled Item Attributes / fulfilled_item_attributes metafield attached to the order.

The value is an array, and the app appends to it rather than overwriting it. An order that is split across several fulfillment orders - for example when it is fulfilled from more than one location, or partially fulfilled over time - accumulates one entry per fulfillment, in the order the fulfillments completed. Each entry records its fulfillmentOrderId and the Consignly consignmentNumber that produced it.

Example metafield values:

An order fulfilled by a single consignment, where the first product was picked as two serialized items with batch and date attributes, and the second product has no additional attributes recorded:

[
  {
    "fulfillmentOrderId": "gid://shopify/FulfillmentOrder/1234500000001",
    "consignmentNumber": "ACME-000051-OUT",
    "itemAttributes": [
      {
        "sku": "WIDGET-001",
        "pickedQuantity": 2,
        "batch": "B-2026-014",
        "bestBeforeDate": "2027-01-01",
        "expiryDate": "2027-02-02",
        "packagingDate": "2026-06-15",
        "productionDate": "2026-06-14",
        "sellByDate": "2026-12-01",
        "items": [
          { "pickedQuantity": 1, "serial": "SN-0001" },
          { "pickedQuantity": 1, "serial": "SN-0002" }
        ]
      },
      {
        "sku": "WIDGET-005",
        "pickedQuantity": 1
      }
    ]
  }
]

The same order after a second fulfillment order - the remaining items, shipped later on a second consignment - is completed:

[
  {
    "fulfillmentOrderId": "gid://shopify/FulfillmentOrder/1234500000001",
    "consignmentNumber": "ACME-000051-OUT",
    "itemAttributes": [
      {
        "sku": "WIDGET-001",
        "pickedQuantity": 2,
        "batch": "B-2026-014",
        "bestBeforeDate": "2027-01-01",
        "expiryDate": "2027-02-02",
        "packagingDate": "2026-06-15",
        "productionDate": "2026-06-14",
        "sellByDate": "2026-12-01",
        "items": [
          { "pickedQuantity": 1, "serial": "SN-0001" },
          { "pickedQuantity": 1, "serial": "SN-0002" }
        ]
      },
      {
        "sku": "WIDGET-005",
        "pickedQuantity": 1
      }
    ]
  },
  {
    "fulfillmentOrderId": "gid://shopify/FulfillmentOrder/1234500000002",
    "consignmentNumber": "ACME-000052-OUT",
    "itemAttributes": [
      {
        "sku": "WIDGET-002",
        "pickedQuantity": 4,
        "batch": "B-2026-019"
      }
    ]
  }
]

tip

Use Sidekick, Shopify's AI assistant, to view these metafield details from an order or help create a Shopify Flow app workflow to use these details in a business process. You can also reference the metafield in Liquid.