訂單確認

通知新蛋標記您已下載過的訂單。您可以在獲取訂單資訊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