订单确认

通知新蛋标记您已下载过的订单。您可以在获取订单信息API中通过订单下载过滤排除已下载过得订单。

相关URL

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

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

参数

名称 是否必填？ 描述
sellerid 是 您在新蛋商城的商家编号

相关请求信息

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

请求文件主体

属性 是否必填 格式 描述
IssueUser 否 String 您注册成为新蛋卖家账户的邮箱地址
OperationType 是 String 固定值：OrderConfirmationRequest
OrderNumber 是 Integer 您希望标记为已下载的订单编号

Schema: OrderConfirmRequest.xsd

示例：XML，Request

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

<NeweggAPIRequest>
    <OperationType>OrderConfirmationRequest</OperationType>
    <RequestBody>
        <DownloadedOrderList>
            <OrderNumber>159243598</OrderNumber>
        </DownloadedOrderList>
    </RequestBody>
</NeweggAPIRequest>

示例：Json，Request

{
    "OperationType": "OrderConfirmationRequest",
    "RequestBody": {
        "DownloadedOrderList": {
            "OrderNumber": [
                "159243598"
            ]
        }
    }
}

回复文件主体

属性 格式 描述
IsSuccess String 用于确认订单确认的操作是否成功

返回值：True或者False
OperationType String 固定值：OrderConfirmationResponse
SellerID String 你的商家编号
ResponseDate String 回复时间（太平洋标准时间）
RequestDate String 请求时间（太平洋标准时间）
OrderNumber Integer 您希望标记为已下载的订单编号
Memo String 附加信息。当前将返回空值null

Schema: OrderConfirmResponse.xsd

示例：XML，Response

<?xml version=”1.0” encoding=”utf-8”?>
<NeweggAPIResponse>
    <IsSuccess>true</IsSuccess>
    <OperationType>OrderConfirmationResponse</OperationType>
    <SellerID>A006</SellerID>
    <ResponseDate>2/22/2012 16:37:20</ResponseDate>
    <ResponseBody>
        <RequestDate>2/22/2012 16:37:20</RequestDate>
        <DownloadedOrderList>
            <OrderNumber>159243598</OrderNumber>
        </DownloadedOrderList>
    </ResponseBody>
</NeweggAPIResponse>

示例：Json，Response

{
    "NeweggAPIResponse": {
        "IsSuccess": "true",
        "OperationType": "OrderConfirmationResponse",
        "SellerID": "A006",
        "ResponseDate": "2/22/2012 16:38:53",
        "ResponseBody": {
            "RequestDate": "2/22/2012 16:38:53",
            "DownloadedOrderList": {
                "OrderNumber": "159243598"
            }
        }
    }
}

请求失败错误信息

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

示例：XML，Response

<?xml version="1.0" encoding="utf-8"?>
<Errors>
    <Error>
        <Code>CE001</Code>
        <Message>SellerID cannot be null or empty</Message>
    </Error>
</Errors>

示例：Json，Response

[
    {
        "Code": "CE001",
        "Message": "SellerID cannot be null or empty"
    }
]

更新日期：10/15/2018