提交進貨請求
基於獲取進貨計畫建議返回的資訊,提交一個新的進貨請求。
相關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 |
| ActionCode | 是 | Integer | 操作代碼
|
| ShipFromAddress1 | 否 | String | 發貨地址 1
若為空,將使用商家的原位址 |
| ShipFromAddress2 | 否 | String | 發貨地址 2
若為空,將使用商家的原位址 |
| ShipFromCity | 否 | String | 發貨城市
若為空,將使用商家的原位址 |
| ShipFromState | 否 | String | 發貨州
若為空,將使用商家的原位址 |
| ShipFromZipcode | 否 | String | 發貨地郵編
若為空,將使用商家的原位址 |
| ShipFromCountry | 否 | String | 發貨國家 若為空,將使用商家的原位址 |
| ShipFromPhoneNumber | 否 | String | 發貨地本地電話 |
| ShipToWarehouseCode | 是 | String | 新蛋倉庫的編碼 有效值:
|
| ShippingMethodCode | 是 | Integer | 發貨運送方式, 有效值:
|
| ShippingCarrierCode | 是 | Integer | 運輸商 如果 ShippingMethodCode = 1:
如果 ShippingMethodCode = 2, 只能使用:99. Other |
| OtherCarrierName | 是 (若 Shipping CarrierCode = 99) | String | 如果 ShippingCarrierCode = 99,填寫你將會使用的運輸商 |
| TrackingNumber | 否 | String | 貨運追蹤號碼 |
| PackageWeight | 是 (若 Shipping CarrierCode = 105) | Decimal | 包裹重量,更多資訊參考:貨件重量和尺寸限制 |
| PackageLength | 是(若 Shipping CarrierCode = 105) | Decimal | 包裹長度,更多資訊參考:貨件重量和尺寸限制 |
| PackageHeight | 是(若 Shipping CarrierCode = 105) | Decimal | 包裹高度,更多資訊參考:貨件重量和尺寸限制 |
| PackageWidth | 是(若 Shipping CarrierCode = 105) | Decimal | 包裹寬度,更多資訊參考:貨件重量和尺寸限制 |
| SellerPartNumber | 是 | String | 商家自訂的商品編號 |
| Quantity | 是 | Integer | 商品數量 |
| NumberofPackage | 否 | Integer | 包裹數 如果為空,將返回 1 |
| ORM-D | 否 | Integer |
若為空,則默認為 0.
|
| MSDSURL | 是(若ORM-d=1) | String | 請指定材料安全資料表的本地存放路徑輸入當前商品的材料安全資料表 URL。所有 URL 必須直接指向原始文件。文件必須為:(pdf、jpg、jpeg、png、doc、docx、xls或xlsx);
|
Schema: SubmitInboundShipmentRequest_Create.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>1</ActionCode>
<ShipFromPhoneNumber>123456789</ShipFromPhoneNumber>
<ShipToWarehouseCode>08</ShipToWarehouseCode>
<ShippingMethodCode>1</ShippingMethodCode>
<ShippingCarrierCode>99</ShippingCarrierCode>
<OtherCarrierName>newegg</OtherCarrierName>
<PackageList>
<Package>
<TrackingNumber>SBNAPI-123456789</TrackingNumber>
<PackageWeight>10.00</PackageWeight>
<PackageLength>8.00</PackageLength>
<PackageHeight>7.00</PackageHeight>
<PackageWidth>7.00</PackageWidth>
</Package>
</PackageList>
<ItemList>
<Item>
<SellerPartNumber>SS0120130516683100755</SellerPartNumber>
<Quantity>4</Quantity>
<NumberofPackage>2</NumberofPackage>
<ORM-D>1</ORM-D>
<MSDSURL>http://tesipaddress/MSDS/testMSDS.pdf</MSDSURL>
</Item>
</ItemList>
</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": 1,
"ShipFromPhoneNumber": "123456789",
"ShipFromAddress1": "11708 Rowland St.",
"ShipFromAddress2": "12708 Rowland St.",
"ShipFromCity": "NY",
"ShipFromState": "CA",
"ShipFromZipcode": "123456",
"ShipFromCountry": "USA",
"ShipToWarehouseCode": "14",
"ShippingMethodCode": 1,
"ShippingCarrierCode": 105,
"OtherCarrierName": "SF",
"PackageList": {
"Package": [
{
"TrackingNumber": "123456789",
"PackageWeight": 10,
"PackageLength": 8,
"PackageHeight": 7,
"PackageWidth": 6
},
{
"TrackingNumber": "987654321",
"PackageWeight": 10,
"PackageLength": 8,
"PackageHeight": 7,
"PackageWidth": 6
}
]
},
"ItemList": {
"Item": [
{
"SellerPartNumber": "SS0120130516683100755",
"Quantity": 40,
"NumberofPackage": 2,
"ORM-D": 1,
"MSDSURL": "http://tesipaddress/MSDS/testMSDS.pdf"
}
]
}
}
}
}
回覆文件主體
| 屬性 | 格式 | 描述 |
| IsSuccess | String | 用來確認獲取請求狀態的操作是否成功
|
| 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 | Duplicate sellerPartNumber [{0}].
重複的Seller Part# |
| SBN016 | Newegg Partnered Carrier service (ShippingCarrierCode: 105) is not available for 3PL sellers.
新蛋合作運輸商服務(ShippingCarrierCode:105)不適用於3PL賣家 |
| SBN018 | The field:[MSDSURL] is required when ORM-D = 1. For more detail, please contact datafeeds@newegg.com.
當 ORM-D=1 時,欄位[MSDSURL]必填。獲取更多資訊,請聯繫 datafeeds@newegg.com |
| SBN020 | Invalid MSDS file type, we only support: {0}
無效的MSDS文件類型,我們只支持{0} |
| CT069 | Seller Part #: {0}, Newegg Item #: {1}, cannot be Shipped by Newegg. Please contact datafeeds@newegg.com if you have any question for this error.
Seller Part #: {0}, Newegg Item #: {1} 不能使用新蛋配送。如果您對此錯誤資訊有其他問題,請聯繫 datafeeds@newegg.com |
| SBN019 | Seller Part # :{0} can not be submit send inventory
Seller Part # :{0}不能提交發送庫存 |
| SBN021 | This function is not available at this moment because your credit card information is missing, please go to Account Setting –> Financial Information -> Credit Card Settings to submit your credit card information then try again.
由於您的信用卡資訊缺少,此功能暫時不可用。請前往帳戶設置->財務資訊->信用卡設置中提交您的信用卡資訊,然後重試。 |
| SBN022 | This function is temporarily disabled because Newegg can’t charge your credit card for the service fee, please go to Account Setting -> Financial Information -> Credit Card Settings to update your credit card information then try again.
因新蛋無法向您的信用卡收取服務費,該功能暫時停用。請前往帳戶設置->財務資訊->信用卡設置中提交您的信用卡資訊,然後重試。 |
| SBN023 | This function is temporarily disabled, because credit card authorization failed, Newegg can’t charge your credit card for the service fee, please go to Account Setting -> Financial Information -> Credit Card Settings to update your credit card information then try again.
因信用卡授權失敗,新蛋無法向您的信用卡收取服務費,該功能暫時停用。請前往帳戶設置->財務資訊->信用卡設置中提交您的信用卡資訊,然後重試。 |
示例: Json, Response
<?xml version="1.0" encoding="utf-8"?>
<Errors>
<Error>
<Code>SBN002</Code>
<Message>Invalid Seller Part # :XYZ.</Message>
</Error>
</Errors>
Example: Json, Response
[
{
"Code": "SBN002",
"Message": "Invalid Seller Part # :XYZ."
}
]
更新日期:01/27/2021