获取订单状态

按现有订单的指定订单号获取订单状态。

相关URL

Newegg.com: https://api.newegg.com/marketplace/ordermgmt/orderstatus/orders/{ordernumber}?sellerid={sellerid}&version={version}
Neweggbusiness.com: https://api.newegg.com/marketplace/b2b/ordermgmt/orderstatus/orders/{ordernumber}?sellerid={sellerid}&version={version}
Newegg.ca: https://api.newegg.com/marketplace/can/ordermgmt/orderstatus/orders/{ordernumber}?sellerid={sellerid}&version={version}

注：请确保您的请求URL全都是小写（除Seller ID）并且不能包含任何空格或者换行符。

参数

名称 是否必填？ 描述
sellerid 是 您在新蛋商城的商家编号
ordernumber 是 订单编号
version 否 可用版本号：304

相关请求信息

HTTP方式 是否需要认证 请求格式 回复格式 频率限制
GET 需要 XML,Json XML,Json 500 请求/小时

请求文件主体

示例：XML，Request

GET https://api.newegg.com/marketplace/ordermgmt/orderstatus/orders/{ordernumber}?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml

示例：Json，Request

GET https://api.newegg.com/marketplace/ordermgmt/orderstatus/orders/{ordernumber}?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json

回复文件主体

属性 格式 描述
OrderNumber String 符合您搜索条件的订单编号。
OrderStatusCode Integer 订单状态的有效值：

  • 0.  Unshipped（未发货）
  • 1.  PartiallyShipped（部分发货）
  • 2.  Shipped（已全部发货）
  • 3.  Invoiced（交易完成）
  • 4.  Void（作废订单）
OrderStatusName String 状态描述：

  • Unshipped（未发货）：订单状态代码 0
  • PartiallyShipped（部分发货）：订单状态代码 1
  • Shipped（已全部发货）：订单状态代码 2
  • Invoiced（交易完成）：订单状态代码 3
  • Void （作废订单）：订单状态代码 4
SellerID String 您的商家编号
OrderDownloaded String
  • False：订单还未被下载
  • True：订单已被下载

当订单已发货，这个字段将自动变为”True”
SalesChannel Integer 订单的销售渠道:

  • 0. Newegg order （新蛋订单）
  • 1. Multi-channel order（多渠道订单）
  • 2. Replacement order （换货订单）
  • 3. NWS order（Newegg.com only）

只可用版本号：304
FulfillmentOption Integer 订单运送选项:

  • 0. Ship by Seller（商家配送）
  • 1. Ship by Newegg（新蛋配送）

只可用版本号：304

Schema: GetOrderStatusResponse.xsd

示例：XML，Response

<?xml version="1.0" encoding="utf-8"?>
<QueryOrderStatusInfo>
    <OrderNumber>159243598</OrderNumber>
    <SellerID>A006</SellerID>
    <OrderStatusCode>1</OrderStatusCode>
    <OrderStatusName>PartiallyShipped</OrderStatusName>
    <OrderDownloaded>true</OrderDownloaded>
    <SalesChannel>0</SalesChannel>
    <FulfillmentOption>0</FulfillmentOption>
</QueryOrderStatusInfo>

示例：Json，Response

{
    "OrderDownloaded": true,
    "OrderNumber": "159243598",
    "OrderStatusCode": 1,
    "OrderStatusName": "PartiallyShipped",
    "SellerID": "A006",
    "SalesChannel": 0,
    "FulfillmentOption": 0
}

请求失败错误信息

常规HTTP错误回复，请参考回复失败错误代码列表。

错误代码 描述
SO002 Order Number should be an integer (ranging from 1 to 2147483647)

订单编号应为整数 (区间为 1 到 2147483647)
SO003 No data found or this order does not belong to this seller

找不到数据或此订单不属于此商家

示例：XML，Response

<?xml version="1.0" encoding="utf-8"?>
<Errors>
    <Error>
        <Code>SO002</Code>
        <Message>Order Number should be an integer (ranging from 1 to 2147483647)</Message>
    </Error>
</Errors>

示例：Json，Response

[
    {
        "Code": "SO002",
        "Message": "Order Number should be an integer (ranging from 1 to 2147483647)"
    }
]

更新日期：10/28/2021