提交入货请求
基于获取入货计划建议返回的信息,提交一个新的入货请求。
相关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.
因信用卡授权失败,新蛋无法向您的信用卡收取服务费,该功能暂时禁用。请前往账户设置->财务信息->信用卡设置中提交您的信用卡信息,然后重试。 |
示例: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." } ]
更新日期:01/27/2021