---
title: "Order"
description: "订单"
doc_type: graphql
doc_category: storefront
doc_version: v20270301
source_url:
  html: 'https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common-objects/objects/order'
  md: 'https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common-objects/objects/order.md'
---
# Order

订单

- **API Version:** v20270301
- **API Type:** Storefront
- **API Protocol:** GraphQL
- **Operation Type:** Object

## Type Signature

`Order`

## Fields

* `billingAddress`

  [OrderShippingAddress](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common-objects/objects/order-shipping-address.md)

  账单地址

* `buyerNote`

  [String](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common/scalars/string.md)

  买家备注

* `cancelReason`

  [String](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common/scalars/string.md)

  取消订单的备注原因

* `canceledAt`

  [Date](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common/scalars/date.md)

  取消订单的时间，当订单未取消是返回null

* `customer`

  [Customer](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/customers/objects/customer.md)

  用户

* `email`

  [String](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common/scalars/string.md)

  订单联系邮箱

* `financialStatus`

  [OrderFinancialStatus](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common-objects/enums/order-financial-status.md)

  订单的支付状态

* `fulfillmentStatus`

  [OrderFulfillmentStatus](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common-objects/enums/order-fulfillment-status.md)

  订单的发货状态

* `id`

  [ID!](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common/scalars/id.md)

  订单号，全局唯一ID

* `lineItems`

  [[OrderLineItem]](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common-objects/objects/order-line-item.md)

  订单关联的商品列表

* `name`

  [String](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common/scalars/string.md)

  商家自定义订单号，从1001开始。不同店铺可以相同，同一个店铺也不唯一

* `phone`

  [String](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common/scalars/string.md)

  手机号

* `processedAt`

  [Date](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common/scalars/date.md)

  订单成单时间（导入订单时订单的实际业务时间）

* `shippingAddress`

  [OrderShippingAddress](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common-objects/objects/order-shipping-address.md)

  顾客的收货地址

* `shippingDiscountAllocations`

  [[OrderDiscountAllocation]](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common-objects/objects/order-discount-allocation.md)

  订单运费折扣信息

* `statusUrl`

  [URI](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common/scalars/uri.md)

  订单状态页访问url

* `subtotalPrice`

  [Money](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common-objects/objects/money.md)

  商品金额累计，不含运费税费

* `successfulFulfillments`

  [[Fulfillment]](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common-objects/objects/fulfillment.md)

  订单关联的发货成功状态的发货单

* `totalDuties`

  [Money](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common-objects/objects/money.md)

  订单的总关税，包含编辑的订单商品

* `totalPrice`

  [Money](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common-objects/objects/money.md)

  订单总价，包含了商品金额、运费、税费 以及优惠折扣

* `totalShippingPrice`

  [Money](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common-objects/objects/money.md)

  订单总运费，包含运费折扣

* `totalTax`

  [Money](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common-objects/objects/money.md)

  订单的总税费，包含编辑的订单商品

## Schema Definition

```graphql
type Order { 
	billingAddress: OrderShippingAddress
	buyerNote: String
	cancelReason: String
	canceledAt: Date
	customer: Customer
	email: String
	financialStatus: OrderFinancialStatus
	fulfillmentStatus: OrderFulfillmentStatus
	id: ID!
	lineItems: [OrderLineItem]
	name: String
	phone: String
	processedAt: Date
	shippingAddress: OrderShippingAddress
	shippingDiscountAllocations: [OrderDiscountAllocation]
	statusUrl: URI
	subtotalPrice: Money
	successfulFulfillments: [Fulfillment]
	totalDuties: Money
	totalPrice: Money
	totalShippingPrice: Money
	totalTax: Money 
}
```

## Field from

* [Query](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common-objects/queries/proxy-node-order.md).proxyNodeOrder

  当前接口即将下线，新增接入将无法直接使用。如需申请使用权限，请通过工单系统联系平台。

* [OrderConnection](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common-objects/objects/order-connection.md).nodes

  nodes列表信息

* [OrderEdge](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common-objects/objects/order-edge.md).node

  The item at the end of OrderEdge.

## Error Handling

关于更多通用错误码说明，参考：[状态码和错误码](https://developer.shopline.com/zh-hans-cn/docs/apps/api-instructions-for-use/storefront-api/overview.md#status-and-error-codes)。