fulfillmentOrders

The paginated list of all fulfillment orders. The returned fulfillment orders are filtered according to the fulfillment order access scopes granted to the app.

Use it in a workflow

Add a step and choose the Shopify connector.
Pick the fulfillmentOrders action (under Fulfillment).
Fill in the fields below, then reference the result from later steps as {{fulfillmentorders.response.data}}.

Query

This is the query the action sends by default. Edit it in the step's Query field to change which fields come back.

graphql

query FulfillmentOrders($includeClosed: Boolean, $first: Int, $after: String, $last: Int, $before: String, $reverse: Boolean, $sortKey: FulfillmentOrderSortKeys, $query: String) {
  fulfillmentOrders(
    includeClosed: $includeClosed
    first: $first
    after: $after
    last: $last
    before: $before
    reverse: $reverse
    sortKey: $sortKey
    query: $query
  ) {
    edges {
      cursor
      node {
        assignedLocation
        channelId
        createdAt
        deliveryMethod
        destination
        fulfillAt
        fulfillBy
        fulfillmentHolds
        id
        internationalDuties
        order
        orderId
        orderName
        orderProcessedAt
        remainingLineItemsWeight
        requestStatus
        status
        supportedActions
        updatedAt
      }
    }
    nodes {
      assignedLocation {
        address1
        address2
        city
        countryCode
        location
        name
        phone
        province
        zip
      }
      channelId
      createdAt
      deliveryMethod {
        additionalInformation
        brandedPromise
        id
        maxDeliveryDateTime
        methodType
        minDeliveryDateTime
        presentedName
        serviceCode
        sourceReference
      }
      destination {
        address1
        address2
        city
        company
        countryCode
        email
        firstName
        id
        lastName
        location
        phone
        province
        zip
      }
      fulfillAt
      fulfillBy
      fulfillmentHolds {
        displayReason
        handle
        heldByApp
        heldByRequestingApp
        id
        reason
        reasonNotes
      }
      id
      internationalDuties {
        incoterm
      }
      order {
        additionalFees
        alerts
        app
        attribution
        billingAddress
        billingAddressMatchesShippingAddress
        canMarkAsPaid
        canNotifyCustomer
        cancelReason
        cancellation
        cancelledAt
        capturable
        cartDiscountAmount
        cartDiscountAmountSet
        cartToken
        channel
        channelInformation
        checkoutToken
        clientIp
        closed
        closedAt
        confirmationNumber
        confirmed
        createdAt
        currencyCode
        currentCartDiscountAmountSet
        currentShippingPriceSet
        currentSubtotalLineItemsQuantity
        currentSubtotalPriceSet
        currentTaxLines
        currentTotalAdditionalFeesSet
        currentTotalDiscountsSet
        currentTotalDutiesSet
        currentTotalPriceSet
        currentTotalTaxSet
        currentTotalWeight
        customAttributes
        customer
        customerAcceptsMarketing
        customerJourney
        customerJourneySummary
        customerLocale
        discountCode
        discountCodes
        displayAddress
        displayFinancialStatus
        displayFulfillmentStatus
        disputes
        dutiesIncluded
        edited
        email
        estimatedTaxes
        fulfillable
        fulfillmentsCount
        fullyPaid
        hasTimelineComment
        id
        landingPageDisplayText
        landingPageUrl
        legacyResourceId
        merchantBusinessEntity
        merchantEditable
        merchantEditableErrors
        merchantOfRecordApp
        name
        netPayment
        netPaymentSet
        note
        number
        originalTotalAdditionalFeesSet
        originalTotalDutiesSet
        originalTotalPriceSet
        paymentCollectionDetails
        paymentGatewayNames
        paymentTerms
        phone
        physicalLocation
        poNumber
        presentmentCurrencyCode
        processedAt
        productNetwork
        publication
        purchasingEntity
        referralCode
        referrerDisplayText
        referrerUrl
        refundDiscrepancySet
        refundable
        registeredSourceUrl
        requiresShipping
        restockable
        retailLocation
        returnStatus
        risk
        riskLevel
        shippingAddress
        shippingLine
        shopifyProtect
        sourceIdentifier
        sourceName
        staffMember
        subtotalLineItemsQuantity
        subtotalPrice
        subtotalPriceSet
        tags
        taxExempt
        taxLines
        taxesIncluded
        test
        totalCapturable
        totalCapturableSet
        totalCashRoundingAdjustment
        totalDiscounts
        totalDiscountsSet
        totalOutstandingSet
        totalPrice
        totalPriceSet
        totalReceived
        totalReceivedSet
        totalRefunded
        totalRefundedSet
        totalRefundedShippingSet
        totalShippingPrice
        totalShippingPriceSet
        totalTax
        totalTaxSet
        totalTipReceived
        totalTipReceivedSet
        totalWeight
        transactionsCount
        unpaid
        updatedAt
      }
      orderId
      orderName
      orderProcessedAt
      remainingLineItemsWeight {
        unit
        value
      }
      requestStatus
      status
      supportedActions {
        action
        externalUrl
      }
      updatedAt
    }
    pageInfo {
      endCursor
      hasNextPage
      hasPreviousPage
      startCursor
    }
  }
}

Variables

Pass these as a JSON object in the step's Variables field.

includeClosedboolean

Whether to include closed fulfillment orders.

firstnumber

The first `n` elements from the [paginated list](https://shopify.dev/api/usage/pagination-graphql).

afterstring

The elements that come after the specified [cursor](https://shopify.dev/api/usage/pagination-graphql).

lastnumber

The last `n` elements from the [paginated list](https://shopify.dev/api/usage/pagination-graphql).

beforestring

The elements that come before the specified [cursor](https://shopify.dev/api/usage/pagination-graphql).

reverseboolean

Reverse the order of the underlying list.

sortKeystring

Sort the underlying list using a key. If your query is slow or returns an error, then [try specifying a sort key that matches the field used in the search](https://shopify.dev/api/usage/pagination-graphql#search-performance-considerations).

One ofIDUPDATED_AT

querystring

A filter made up of terms, connectives, modifiers, and comparators. | name | type | description | acceptable_values | default_value | example_use | | ---- | ---- | ---- | ---- | ---- | ---- | | default | string | Filter by a case-insensitive search of multiple fields in a document. | | | - `query=Bob Norman`<br/> - `query=title:green hoodie` | | assigned_location_id | id | | id | id | Filter by `id` range. | | | - `id:1234`<br/> - `id:>=1234`<br/> - `id:<=1234` | | status | string | | updated_at | time | You can apply one or more filters to a query. Learn more about [Shopify API search syntax](https://shopify.dev/api/usage/search-syntax).

json

{
  "includeClosed": false,
  "first": 0,
  "after": "string",
  "last": 0,
  "before": "string",
  "reverse": false,
  "sortKey": "ID",
  "query": "string"
}

Response

Read the result with {{fulfillmentorders.response.data.data.fulfillmentOrders}}. If the API returns errors, the step fails and they are at {{fulfillmentorders.response.data.errors}}.

edgesarray<object>

cursorobject

nodeobject

nodesarray<object>

assignedLocationobject

channelIdobject

createdAtobject

deliveryMethodobject

destinationobject

fulfillAtobject

fulfillByobject

fulfillmentHoldsobject

idobject

internationalDutiesobject

orderobject

orderIdobject

orderNameobject

orderProcessedAtobject

remainingLineItemsWeightobject

requestStatusobject

statusobject

supportedActionsobject

updatedAtobject

pageInfoobject

endCursorstring

hasNextPageboolean

hasPreviousPageboolean

startCursorstring

Need more? See the Shopify guide for connection setup and behaviour shared by every action.

Was this page helpful?