Fulfillment - admin-graphql - OBJECT

Version: 2024-10

Description:

Represents a fulfillment. In Shopify, a fulfillment represents a shipment of one or more items in an order. When an order has been completely fulfilled, it means that all the items that are included in the order have been sent to the customer. There can be more than one fulfillment for an order.

Access Scopes

`read_orders` access scope, `read_marketplace_orders` access scope, `read_assigned_fulfillment_orders` access scope, `read_merchant_managed_fulfillment_orders` access scope, `read_third_party_fulfillment_orders` access scope or `read_marketplace_fulfillment_orders` access scope.

Fields

  • createdAt: DateTime! - The date and time when the fulfillment was created.
  • deliveredAt: DateTime - The date that this fulfillment was delivered.
  • displayStatus: FulfillmentDisplayStatus - Human readable display status for this fulfillment.
  • estimatedDeliveryAt: DateTime - The estimated date that this fulfillment will arrive.
  • id: ID! - A globally-unique ID.
  • inTransitAt: DateTime - The date and time when the fulfillment went into transit.
  • legacyResourceId: UnsignedInt64! - The ID of the corresponding resource in the REST Admin API.
  • location: Location - The location that the fulfillment was processed at.
  • name: String! - Human readable reference identifier for this fulfillment.
  • order: Order! - The order for which the fulfillment was created.
  • originAddress: FulfillmentOriginAddress - The address at which the fulfillment occurred. This field is intended for tax purposes, as a full address is required for tax providers to accurately calculate taxes. Typically this is the address of the warehouse or fulfillment center. To retrieve a fulfillment location's address, use the `assignedLocation` field on the [`FulfillmentOrder`](/docs/api/admin-graphql/latest/objects/FulfillmentOrder) object instead.
  • requiresShipping: Boolean! - Whether any of the line items in the fulfillment require shipping.
  • service: FulfillmentService - Fulfillment service associated with the fulfillment.
  • status: FulfillmentStatus! - The status of the fulfillment.
  • totalQuantity: Int! - Sum of all line item quantities for the fulfillment.
  • trackingInfo: FulfillmentTrackingInfo! - Tracking information associated with the fulfillment, such as the tracking company, tracking number, and tracking URL.
  • updatedAt: DateTime! - The date and time when the fulfillment was last modified.

Connections

  • events: FulfillmentEventConnection!
  • fulfillmentLineItems: FulfillmentLineItemConnection!
  • fulfillmentOrders: FulfillmentOrderConnection!

Related queries

  • fulfillment Returns a Fulfillment resource by ID.

Related mutations

  • fulfillmentCancel Cancels a fulfillment.
  • fulfillmentCreate Creates a fulfillment for one or many fulfillment orders. The fulfillment orders are associated with the same order and are assigned to the same location.
  • fulfillmentCreateV2 Creates a fulfillment for one or many fulfillment orders. The fulfillment orders are associated with the same order and are assigned to the same location.
  • fulfillmentTrackingInfoUpdate Updates tracking information for a fulfillment.
  • fulfillmentTrackingInfoUpdateV2 Updates tracking information for a fulfillment.

Related Unions

Examples