格物开放 API结算与订单

REST API · 接口参考

REST API 参考 · 消费者购物

结算与订单

下单前用结算预览拿权威价、运费与可售状态。下单与付款走下面的「平台收银台」：用户付款后平台自动下单，建出的订单在这里查订单、物流、确认收货。

#结算预览：权威价、运费、可售状态

POST/v1/lm/checkout/render

鉴权用户态

出现在消费者 · 下单与支付

按本地价计算，不需要地址。

请求体application/json

字段	类型	必填	说明
`items`	object[]	是
`items[].productId`	string	是	商品接口返回的 id
`items[].skuId`	string	否	商品详情 skus[].skuId
`items[].qty`	integer	否	默认 `1`。≥ 1

返回字段

字段	类型	说明
`ok`	boolean
`render`	object
`render.totalFee`	number
`render.postFee`	number
`render.payable`	number
`render.lines`	object[]
`render.lines[].productId`	string
`render.lines[].skuId`	string
`render.lines[].itemName`	string
`render.lines[].itemPic`	string
`render.lines[].skuText`	string
`render.lines[].itemPrice`	number
`render.lines[].quantity`	integer

错误

400 EMPTY / PRODUCT_NOT_FOUND / SKU_UNAVAILABLE

调用示例

1curl -X POST "https://api.gowu.net/v1/lm/checkout/render" \2  -H "x-app-key: $GOWU_APP_KEY" \3  -H "x-timestamp: $TS" \4  -H "x-nonce: $NONCE" \5  -H "x-sign-version: 2" \6  -H "x-signature: $SIG" \7  -H "x-open-user: u-001" \8  -H "content-type: application/json" \9  -d '{"items":[{"productId":"…","skuId":"…","qty":1}]}'

返回示例

1{2  "ok": true,3  "render": {4    "totalFee": 0,5    "postFee": 0,6    "payable": 0,7    "lines": [8      {9        "productId": "string",10        "skuId": "string",11        "itemName": "string",12        "itemPic": "string",13        "skuText": "string",14        "itemPrice": 0,15        "quantity": 016      }17    ]18  }19}

#订单列表

GET/v1/lm/orders

鉴权用户态

查询参数

字段	类型	必填	说明
`limit`	integer	否	默认 `50`。≥ 1，≤ 200

返回字段39 个，点击展开

字段	类型	说明
`items`	object[]
`items[].id`	string
`items[].outerPurchaseOrderId`	string	= 你传的 idempotencyKey
`items[].purchaseOrderId`	string	上游采购单号；还在创建中时为空
`items[].lmStatus`	string	可选值：`PENDING` / `CREATING` / `CREATED` / `FAILED`
`items[].displayStatus`	string
`items[].totalFee`	number
`items[].postFee`	number
`items[].payable`	number
`items[].items`	object[]
`items[].items[].productId`	string
`items[].items[].skuId`	string
`items[].items[].title`	string
`items[].items[].skuText`	string
`items[].items[].imageUrl`	string
`items[].items[].price`	number
`items[].items[].qty`	integer
`items[].items[].lineTotal`	number
`items[].receiver`	object
`items[].remark`	string
`items[].message`	string
`items[].createdAt`	string
`items[].orders`	object[]	子订单（详情接口返回）。确认收货、物流、售后都按子订单号 orderId
`items[].orders[].orderId`	string	子订单号
`items[].orders[].orderStatus`	string	1 待支付 / 2 已支付 / 4 已退款关闭 / 6 交易成功 / 8 已关闭
`items[].orders[].logisticsStatus`	string
`items[].orders[].refundStatus`	string
`items[].orders[].displayStatus`	string
`items[].orders[].orderAmount`	number
`items[].orders[].lines`	object[]
`items[].orders[].lines[].orderLineId`	string	订单行 id，售后用
`items[].orders[].lines[].productId`	string
`items[].orders[].lines[].productTitle`	string
`items[].orders[].lines[].skuId`	string
`items[].orders[].lines[].skuTitle`	string
`items[].orders[].lines[].quantity`	integer
`items[].orders[].lines[].payFee`	number
`items[].orders[].closedReason`	string
`items[].orders[].createdAt`	string

调用示例

1curl -X GET "https://api.gowu.net/v1/lm/orders" \2  -H "x-app-key: $GOWU_APP_KEY" \3  -H "x-timestamp: $TS" \4  -H "x-nonce: $NONCE" \5  -H "x-sign-version: 2" \6  -H "x-signature: $SIG" \7  -H "x-open-user: u-001"

返回示例

1{2  "items": [3    {4      "id": "string",5      "outerPurchaseOrderId": "string",6      "purchaseOrderId": "string",7      "lmStatus": "PENDING",8      "displayStatus": "string",9      "totalFee": 0,10      "postFee": 0,11      "payable": 0,12      "items": [13        {}14      ],15      "receiver": null,16      "remark": "string",17      "message": "string",18      "createdAt": "string",19      "orders": [20        {}21      ]22    }23  ]24}

#订单详情 / 确认收货

GETPOST/v1/lm/orders/{id}

鉴权用户态

GET

订单详情

返回子订单 orders。

路径参数

字段	类型	必填	说明
`id`	string	是	采购单 id、上游采购单号或你的 idempotencyKey 都可以

返回字段38 个，点击展开 · 采购单。一张采购单可能拆成多张子订单（orders）

字段	类型	说明
`id`	string
`outerPurchaseOrderId`	string	= 你传的 idempotencyKey
`purchaseOrderId`	string	上游采购单号；还在创建中时为空
`lmStatus`	string	可选值：`PENDING` / `CREATING` / `CREATED` / `FAILED`
`displayStatus`	string
`totalFee`	number
`postFee`	number
`payable`	number
`items`	object[]
`items[].productId`	string
`items[].skuId`	string
`items[].title`	string
`items[].skuText`	string
`items[].imageUrl`	string
`items[].price`	number
`items[].qty`	integer
`items[].lineTotal`	number
`receiver`	object
`remark`	string
`message`	string
`createdAt`	string
`orders`	object[]	子订单（详情接口返回）。确认收货、物流、售后都按子订单号 orderId
`orders[].orderId`	string	子订单号
`orders[].orderStatus`	string	1 待支付 / 2 已支付 / 4 已退款关闭 / 6 交易成功 / 8 已关闭
`orders[].logisticsStatus`	string
`orders[].refundStatus`	string
`orders[].displayStatus`	string
`orders[].orderAmount`	number
`orders[].lines`	object[]
`orders[].lines[].orderLineId`	string	订单行 id，售后用
`orders[].lines[].productId`	string
`orders[].lines[].productTitle`	string
`orders[].lines[].skuId`	string
`orders[].lines[].skuTitle`	string
`orders[].lines[].quantity`	integer
`orders[].lines[].payFee`	number
`orders[].closedReason`	string
`orders[].createdAt`	string

错误

404 资源不存在，或不归属你的 appKey / 当前用户

POST

确认收货

按子订单确认收货：action=receive，orderId 传子订单号（query 或 body）。失败返回 400 { ok: false, message }。

路径参数

字段	类型	必填	说明
`id`	string	是	采购单 id、上游采购单号或你的 idempotencyKey 都可以

查询参数

字段	类型	必填	说明
`action`	string	否	可选值：`receive`
`orderId`	string	否	子订单号

请求体application/json

字段	类型	必填	说明
`action`	string	否	可选值：`receive`
`orderId`	string	否

返回字段

字段	类型	说明
`ok`	boolean
`message`	string

错误

400 见 message

调用示例

1curl -X GET "https://api.gowu.net/v1/lm/orders/{id}" \2  -H "x-app-key: $GOWU_APP_KEY" \3  -H "x-timestamp: $TS" \4  -H "x-nonce: $NONCE" \5  -H "x-sign-version: 2" \6  -H "x-signature: $SIG" \7  -H "x-open-user: u-001"

返回示例

1{2  "id": "string",3  "outerPurchaseOrderId": "string",4  "purchaseOrderId": "string",5  "lmStatus": "PENDING",6  "displayStatus": "string",7  "totalFee": 0,8  "postFee": 0,9  "payable": 0,10  "items": [11    {12      "productId": "string",13      "skuId": "string",14      "title": "string",15      "skuText": "string",16      "imageUrl": "string",17      "price": 0,18      "qty": 0,19      "lineTotal": 020    }21  ],22  "receiver": null,23  "remark": "string",24  "message": "string",25  "createdAt": "string",26  "orders": [27    {28      "orderId": "string",29      "orderStatus": "string",30      "logisticsStatus": "string",31      "refundStatus": "string",32      "displayStatus": "string",33      "orderAmount": 0,34      "lines": [35        {}36      ],37      "closedReason": "string",38      "createdAt": "string"39    }40  ]41}

#子订单物流轨迹

GET/v1/lm/orders/{id}/logistics

鉴权用户态

路径参数为子订单号。上游查询失败时仍返回 200，success: false。

路径参数

字段	类型	必填	说明
`id`	string	是	子订单号 orderId

返回字段

字段	类型	说明
`success`	boolean
`message`	string
`packages`	object[]
`packages[].mailNo`	string	运单号
`packages[].companyName`	string
`packages[].goods`	object[]
`packages[].goods[].name`	string
`packages[].goods[].skuTitle`	string
`packages[].goods[].quantity`	integer
`packages[].traces`	object[]
`packages[].traces[].time`	string
`packages[].traces[].desc`	string

错误

404 资源不存在，或不归属你的 appKey / 当前用户

调用示例

1curl -X GET "https://api.gowu.net/v1/lm/orders/{id}/logistics" \2  -H "x-app-key: $GOWU_APP_KEY" \3  -H "x-timestamp: $TS" \4  -H "x-nonce: $NONCE" \5  -H "x-sign-version: 2" \6  -H "x-signature: $SIG" \7  -H "x-open-user: u-001"

返回示例

1{2  "success": true,3  "message": "string",4  "packages": [5    {6      "mailNo": "string",7      "companyName": "string",8      "goods": [9        {}10      ],11      "traces": [12        {}13      ]14    }15  ]16}