Edits history of script submission #23759 for ' List Fulfillment Orders (shopify)'

  • bunnative
    One script reply has been approved by the moderators
    Ap­pro­ved
    //native
    
    /**
     * List Fulfillment Orders
     * List fulfillment orders across the shop (filtered with Shopify's search syntax, e.g. `status:open`), or the fulfillment orders of one order when order_id is set. Each one shows its status, holds, supported actions and line item ids (the first 10). Returns one page; pass pageInfo.endCursor as after for the next. Needs the read_merchant_managed_fulfillment_orders scope (plus read_assigned/read_third_party for other locations).
     */
    export async function main(
      auth: RT.Shopify,
      order_id: string | undefined,
      query: string | undefined,
      include_closed: boolean | undefined,
      sort_key: "UPDATED_AT" | "ID" | undefined,
      reverse: boolean | undefined,
      first: number | undefined,
      after: string | undefined
    ) {
      const response = await fetch(
        `https://${auth.store_name}.myshopify.com/admin/api/2026-10/graphql.json`,
        {
          method: "POST",
          headers: {
            "X-Shopify-Access-Token": auth.token,
            "Content-Type": "application/json",
            Accept: "application/json",
          },
          body: JSON.stringify(
            order_id
              ? {
                  query: `query ($id: ID!, $first: Int!, $after: String, $query: String, $reverse: Boolean) { order(id: $id) { fulfillmentOrders(first: $first, after: $after, query: $query, reverse: $reverse) { nodes { id status requestStatus orderId orderName createdAt updatedAt fulfillAt fulfillBy assignedLocation { name location { id } } fulfillmentHolds { id reason reasonNotes handle } supportedActions { action } lineItems(first: 10) { nodes { id sku productTitle variantTitle totalQuantity remainingQuantity lineItem { id } } } } pageInfo { hasNextPage endCursor } } } }`,
                  variables: {
                    id: order_id.startsWith("gid://")
                      ? order_id
                      : `gid://shopify/Order/${order_id}`,
                    first: first || 50,
                    after: after || undefined,
                    query: query || undefined,
                    reverse: reverse || undefined,
                  },
                }
              : {
                  query: `query ($first: Int!, $after: String, $query: String, $includeClosed: Boolean, $sortKey: FulfillmentOrderSortKeys, $reverse: Boolean) { fulfillmentOrders(first: $first, after: $after, query: $query, includeClosed: $includeClosed, sortKey: $sortKey, reverse: $reverse) { nodes { id status requestStatus orderId orderName createdAt updatedAt fulfillAt fulfillBy assignedLocation { name location { id } } fulfillmentHolds { id reason reasonNotes handle } supportedActions { action } lineItems(first: 10) { nodes { id sku productTitle variantTitle totalQuantity remainingQuantity lineItem { id } } } } pageInfo { hasNextPage endCursor } } }`,
                  variables: {
                    first: first || 50,
                    after: after || undefined,
                    query: query || undefined,
                    includeClosed: include_closed || undefined,
                    sortKey: sort_key || undefined,
                    reverse: reverse || undefined,
                  },
                }
          ),
        }
      )
    
      if (!response.ok) {
        throw new Error(`${response.status} ${await response.text()}`)
      }
    
      const { data, errors } = await response.json()
      if (errors) {
        throw new Error(JSON.stringify(errors))
      }
    
      if (order_id) {
        if (!data.order) {
          throw new Error(`Order ${order_id} not found`)
        }
        return data.order.fulfillmentOrders
      }
    
      return data.fulfillmentOrders
    }
    

    Submitted by hugo989 3 hours ago