提交作廢進貨請求

向新蛋提交作廢已存在的進貨請求。

相關URL

Newegg.com: https://api.newegg.com/marketplace/sbnmgmt/inboundshipment/shipmentrequest?sellerid={sellerid}
Neweggbusiness.com: https://api.newegg.com/marketplace/b2b/sbnmgmt/inboundshipment/shipmentrequest?sellerid={sellerid}

註：請確保您的請求URL全都是小寫（除Seller ID）並且不能包含任何空格或者分行符號。

參數

名稱 是否必填？ 描述
sellerid 是 您在新蛋商城的商家編號

相關請求資訊

HTTP方式 是否需要認證？ 請求格式 回復格式 頻率限制
POST 需要 XML,Json XML,Json 100 請求/分鐘/商家

請求文件主體

屬性 是否必填？ 格式 描述
OperationType 是 String 固定值：SubmitShipmentRequest
ShipmentID 是 String 已存在的進貨編碼
ActionCode 是 Integer 操作代碼：
2. Void 作廢

Schema: SubmitInboundShipmentRequest_Void.xsd

示例：XML, Request

PUT https://api.newegg.com/marketplace/sbnmgmt/inboundshipment/shipmentrequest?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml

<NeweggAPIRequest>
    <OperationType>SubmitShipmentRequest</OperationType>
    <RequestBody>
        <Shipment>
            <ActionCode>2</ActionCode>
            <ShipmentID>2771551</ShipmentID>
        </Shipment>
    </RequestBody>
</NeweggAPIRequest>

示例：Json, Request

PUT https://api.newegg.com/marketplace/sbnmgmt/inboundshipment/shipmentrequest?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json

{
    "OperationType": "SubmitShipmentRequest",
    "RequestBody": {
        "Shipment": {
            "ActionCode": 2,
            "ShipmentID": 2771551
        }
    }
}

回覆文件主體

屬性 格式 描述
IsSuccess String 用來確認獲取請求狀態的操作是否成功
True：成功
False：失敗
OperationType String 固定值: SubmitShipmentResponse
SellerID String 商家編號
RequestID String 請求編號
RequestDate String 請求提交時間
RequestStatus String 請求的狀態：
SUBMITTED 已提交

Schema: SubmitInboundShipmentResponse.xsd

示例: XML, Response

<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
    <IsSuccess>true</IsSuccess>
    <OperationType>SubmitShipmentResponse</OperationType>
    <SellerID>A006</SellerID>
    <ResponseBody>
        <RequestID>2PQCX3SPZ3QBF</RequestID>
        <RequestDate>06/06/2013 10:21:00</RequestDate>
        <RequestStatus>SUBMITTED</RequestStatus>
    </ResponseBody>
</NeweggAPIResponse>

示例: Json, Response

{
    "IsSuccess": true,
    "OperationType": "SubmitShipmentResponse",
    "SellerID": "A006",
    "ResponseBody": {
        "RequestID": "Z2OTIV1AVVBJ",
        "RequestDate": "07/11/2013 17:24:46",
        "RequestStatus": "SUBMITTED"
    }
}

請求失敗錯誤資訊

常規HTTP錯誤回應，請參考回覆失敗錯誤代碼清單。

錯誤代碼 描述
SBN001 Delivery to the Newegg warehouse: {ShipToWarehouseCode} of Seller Part # {SellerPart#} is not available. Please submit a Get Inbound Shipment Plan request to receive the information of available option(s).

將 Seller Part #為{SellerPart#}的商品運送到新蛋倉庫的倉庫代碼{ShipToWarehouseCode}不可用。請提交一個獲取進貨計畫的請求來接收有效選項的資訊
SBN002 Invalid Seller Part # :{sellerpart#}.

無效的 Seller Part # :{sellerpart#}.
SBN003 Seller Part # :{sellerpart#} is marked as Shipped by Seller now, please convert this item to Shipped by Newegg and try again.

Seller Part # 為{sellerpart#}的商品當前被標記為商家配送，請將此商品轉換為新蛋配送後再試。
SBN004 Invalid Shipment ID:{ShipmentID}

無效的運單編號:{ShipmentID}
SBN005 Cannot void Shipment: [ShipmentID]. Shipment using Newegg Partnered Carrier service cannot be void 48 hours after pre-paid shipping label created.

不能作廢貨運單: [ShipmentID]。在預付費貨運標籤被創建48小時後，使用新蛋合作運輸商服務的貨運單不能被作廢
SBN006 Cannot void Shipment: [ShipmentID]. Shipment cannot be void because it is marked as [Received or Partially Received or Manually closed or Voided].

不能作廢貨運單:  [ShipmentID].由於被標記為[已接收、部分接收或已手動關閉、已手動作廢]，此貨運單不能被作廢
SBN007 The field: [PackageWeight or PackageLength or PackageHeight or PackageWidth ] is required when using Newegg Partnered Carrier service (ShippingCarrierCode:105). For more detail, please review Newegg API Development Guide, SBN section.

當使用新蛋合作運輸商服務(ShippingCarrierCode:105)時，欄位: [PackageWeight or PackageLength or PackageHeight or PackageWidth ]必填。更多資訊請參考新蛋商城API開發手冊，SBN部分
SBN008 The value in the field: PackageWeight cannot exceed 150 lbs. (70 kg) when using Newegg Partnered Carrier service (ShippingCarrierCode:105). For more detail, please review Newegg API Development Guide, SBN section.

當使用新蛋合作運輸商服務(ShippingCarrierCode:105)時,PackageWeight 欄位的值不能超過150磅 (70kg)。 更多資訊請參考新蛋商城 API開發手冊，SBN 部分
SBN009 The value in the field: PackageLength cannot exceed 108 inches (270 cm) when using Newegg Partnered Carrier service (ShippingCarrierCode:105). For more detail, please review Newegg API Development Guide, SBN section.

當使用新蛋合作運輸商服務(ShippingCarrierCode:105)時,PackageLength 欄位的值不能超過180英寸 (270cm)。 更多資訊請參考新蛋商城 API 開發手冊，SBN 部分
SBN010 Package size cannot exceed 165 inches (419 cm) in (Package Length + 2x Package Width + 2x Package Height) when using Newegg Partnered Carrier service (ShippingCarrierCode:105). For more detail, please review Newegg API Development Guide, SBN section.

當使用新蛋合作運輸商服務(ShippingCarrierCode:105)時,Package size 欄位的值不能超過165英寸 (419cm)( Package Length + 2x Package Width + 2x Package Height)。 更多資訊請參考新蛋商城 API 開 發手冊，SBN 部分
SBN011 The field: OtherCarrierName is required when Shipping Carrier is Other (ShippingCarrierCode: 99). For more detail, please review Newegg API Development Guide, SBN section.

當 Shipping Carrier=Other (ShippingCarrierCode: 99)，OtherCarrierName 欄位必填。更多資訊請參考新蛋商城 API開發手冊，SBN 部分
SBN012 The value in the field of ShippingCarrier can only be Other (ShippingCarrierCode: 99) when the ShippingMethodCode= 2. For more detail, please review Newegg API Development Guide, SBN section.

當 ShippingMethodCode= 2，ShippingCarrier 欄位的值只能為 Other (ShippingCarrierCode: 99) 。更多資訊請參考新蛋商城 API開發手冊，SBN 部分
SBN013 Newegg Partnered Carrier service (ShippingCarrierCode: 105) is not available for international sellers.

新蛋合作運輸商服務(ShippingCarrierCode:105)對於國際商家不可用
SBN014 Package Dimension Weight cannot exceed 150 lbs.(70kg) in (Package Length x Package Width x Package Height/166) when using Newegg Partnered Carrier service (ShippingCarrierCode:105). For more detail, please review Newegg API Development Guide, SBN section.

當使用新蛋合作運輸商服務(ShippingCarrierCode:105)時,Package Dimension Weight 欄位的值不能超過 150 磅(70kg) (Package Length x Package Width x Package Height/166)。 更多資訊請參考新蛋商城 API 開發手冊，SBN 部分
SBN015 The field:[MSDSURL] is required when ORM-D = 1. For more detail, please contact datafeeds@newegg.com.

當 ORM-D=1 時，欄位[MSDSURL]必填。獲取更多資訊，請聯繫 datafeeds@newegg.com

示例: XML, Response

<?xml version="1.0" encoding="utf-8"?>
<Errors>
    <Error>
        <Code>SBN002</Code>
        <Message>Invalid Seller Part # :XYZ.</Message>
    </Error>
</Errors>

示例: Json, Response

[
    {
        "Code": "SBN002",
        "Message": "Invalid Seller Part # :XYZ."
    }
]

更新日期：10/15/2018