提交進貨請求

基於獲取進貨計畫建議返回的資訊,提交一個新的進貨請求。

相關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 操作代碼

  • 1.Create 創建
ShipFromAddress1 String 發貨地址 1

若為空,將使用商家的原位址

ShipFromAddress2 String 發貨地址 2

若為空,將使用商家的原位址

ShipFromCity String 發貨城市

若為空,將使用商家的原位址

ShipFromState String 發貨州

若為空,將使用商家的原位址

ShipFromZipcode String 發貨地郵編

若為空,將使用商家的原位址

ShipFromCountry String 發貨國家
若為空,將使用商家的原位址
ShipFromPhoneNumber String 發貨地本地電話
ShipToWarehouseCode String 新蛋倉庫的編碼
有效值:

  • 06: Tennessee Bulk Warehouse 田納西大型倉庫
  • 07: California Small Warehouse 加利福尼亞小型倉庫
  • 08: California Bulk Item Warehouse 加利福尼亞大型倉庫
  • 10: New Jersey Bulk Warehouse 新澤西大型倉庫
  • 14: New Jersey Small Warehouse 新澤西小型倉庫
ShippingMethodCode Integer 發貨運送方式,
有效值:

  • 1. 小包裹運送(單個盒子:包括單個盒子的包裝單位和單獨的標籤)
  • 2. 拼箱裝載(零擔,託盤,裝運至少 150 磅:裝運時將小包裹合併在貨盤上)
ShippingCarrierCode Integer 運輸商
如果 ShippingMethodCode = 1:

  • 101. DHL
  • 102. FedEx
  • 103. UPS
  • 104. USPS
  • 105. 新蛋合作承運商-UPS,更多資訊請參考新蛋合作承運商-UPS
  • 99.Other

如果 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
  • 1: Yes
  • 0: No

若為空,則默認為 0.
ORM-D 是美國郵遞系統或海運中廣泛使用的一個 標誌,專用於標識在美國本土運輸的其他管制材 料。貼有此標籤的包裹含有限定數量的有害物 質,因此須通過控制包裹的運輸方式、數量和外 包裝來限定此類物品的運輸危險。 如果適用請勾選 ORM-D。 必須為 ORM-D 商品上傳材料安全資料表。 ORM-D 商品舉例:

  • Aerosol cans  噴霧罐
  • Automotive batteries  汽車電池
  • Perfumes  香水
  • Small arms ammunition  輕武器彈藥
  • Gunpowder (black powder) 火藥(黑火藥)
  • Some photographic chemicals  一些相片用化學藥品
  • Lighters  打火機
  • Beer  啤酒
  • Drain openers  下水道疏通劑
MSDSURL 是(若ORM-d=1) String 請指定材料安全資料表的本地存放路徑輸入當前商品的材料安全資料表 URL。所有 URL 必須直接指向原始文件。文件必須為:(pdf、jpg、jpeg、png、doc、docx、xls或xlsx);

  • 字母數位字串; 最多 2000 字元。
  • 文件大小最大為 10MB。所有大於 10MB的文件都不會被處理

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 用來確認獲取請求狀態的操作是否成功

  • 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 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