获取入货列表
获取指定请求编号或某时间段的入货列表。
相关URL
Newegg.com: https://api.newegg.com/marketplace/sbnmgmt/inboundshipment/shipmentlist?sellerid={sellerid} Neweggbusiness.com: https://api.newegg.com/marketplace/b2b/sbnmgmt/inboundshipment/shipmentlist?sellerid={sellerid}
注:请确保您的请求URL全都是小写(除Seller ID)并且不能包含任何空格或者换行符。
参数
名称 | 是否必填? | 描述 |
sellerid | 是 | 您在新蛋商城的商家编号 |
相关请求信息
HTTP方式 | 是否需要认证? | 请求格式 | 回复格式 | 频率限制 |
PUT | 需要 | XML,Json | XML,Json | 500 请求/小时 |
请求文件主体
属性 | 是否必填? | 格式 | 描述 |
OperationType | 是 | String | 固定值:GetShipmentListRequest |
PageIndex | 是 | Integer | 当前页索引,默认为 1 |
PageSize | 是 | Integer | 一页中的记录数(最大值为每页 100 条记录) |
KeywordsType | 否 | Integer | 有效值: 0. All (Default) 所有(默认) 1. Shipment ID 运单号 2. Newegg Item Number 新蛋商品编号 3. Seller Part Number 商家商品编号 |
KeywordsValue | 否 | String | 指定类型的关键词 |
Status | 否 | Integer | 有效值: 0. All (Default) 所有(默认) 1. Preparing 准备中 2. Shipped 已发货 3. Received 已接收 4. Partially Received 部分接收 5. Manually closed 已手动关闭 6. Voided 已作废 |
LastUpdateDateFrom | 否 | String | 最新更新时间起始时间(太平洋标准时间)。请参考可接受时间格式
注:最新更新时间起始时间和截止时间都为空时,系统将使用最近30天代替 |
LastUpdateDateTo | 否 | String | 最新更新时间截止时间(太平洋标准时间)。请参考可接受时间格式 |
Schema: GetShipmentListRequest.xsd
示例:XML,Request
PUT https://api.newegg.com/marketplace/sbnmgmt/inboundshipment/shipmentlist?sellerid={sellerid} Authorization: 720ddc067f4d115bd544aff46bc75634 SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D Content-Type: application/xml Accept: application/xml <NeweggAPIRequest> <OperationType>GetShipmentListRequest</OperationType> <RequestBody> <PageInfo> <PageIndex>1</PageIndex> <PageSize>10</PageSize> </PageInfo> <KeywordsType>1</KeywordsType> <KeywordsValue>2740139</KeywordsValue> <Status>0</Status> <LastUpdateDateFrom>06/01/2013</LastUpdateDateFrom> <LastUpdateDateTo>06/07/2013</LastUpdateDateTo> </RequestBody> </NeweggAPIRequest>
示例:Json,Request
GET https://api.newegg.com/marketplace/sbnmgmt/inboundshipment/shipmentlist?sellerid={sellerid} Authorization: 720ddc067f4d115bd544aff46bc75634 SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D Content-Type: application/json Accept: application/json { "OperationType": "GetShipmentListRequest", "RequestBody": { "PageInfo": { "PageIndex": 1, "PageSize": 10 }, "KeywordsType": 1, "KeywordsValue": "2740139", "Status": 0, "LastUpdateDateFrom": "01/01/2013", "LastUpdateDateTo": "07/07/2013" } }
回复文件主体
属性 | 格式 | 描述 |
IsSuccess | String | 用来确认获取请求状态的操作是否成功: True:成功 False:失败 |
OperationType | String | 固定值:GetShipmentListResponse |
SellerID | String | 商家编号 |
ShipmentID | String | 运单号 |
Status | String | 运单状态: Creating – shipment is creating at backend. 创建中 – 运单正在后台创建 Preparing – user can work on shipment. 准备中 – 用户可进行货运 Ready to ship – shipment is ready to ship. 准备发货 – 运单准备发货 Shipped – shipment has been shipped out. 已发货 – 运单已运出 Partially Received – warehouse received a part of shipment. 部分接收 – 仓库已接收部分运单商品 Received – warehouse received whole shipment already. 全部接收 – 仓库已接收全部运单商品 Void – shipment has been voided. 已作废 – 运单已作废 Manually closed – shipment is manually closed which is over 3 month and still unreceived. 已手动关闭 – 超过3个月并仍未收到货运单已手动关闭 |
CreateDate | String | 运单创建时间 |
LastEditDate | String | 最后编辑时间 |
ShipFrom | String | 发货人。默认值:商家店铺名称 |
ShipToWarehouseCode | String | 当前可用美国新蛋仓库代码: 06. -Tennesse Bulk Warehouse 田纳西大型仓库 07. -California Small Warehouse 加利福尼亚小型仓库 08. -California Bulk Item Warehouse 加利福尼亚大型仓库 10. -New Jersy Bulk Warehouse 新泽西大型仓库 14. -New Jersy Small Warehouse 新泽西小型仓库 |
ShipToAddress1 | String | 收货地址 1 |
ShipToAddress2 | String | 收货地址 2 |
ShipToCityName | String | 收货地所在城市 |
ShipToStateCode | String | 收货州代码 |
ShipToZipCode | String | 收货地邮编 |
ShipToCountryCode | String | 收货国家代码 |
ShippingMethodCode | Integer | 此运单指定的运送方式: 1. 小包裹运送(单个盒子:包括单个盒子的包装单位和单独的标签) 2. 拼箱装载(零担,托盘,装运至少150磅:装运时将小包裹合并在货盘上) |
ShippingCarrierCode | Integer | 此运单运输商。 如果 ShippingMethodCode = 1: 101.DHL 102.FedEx 103.UPS 104.USPS 105.新蛋合作承运商 – UPS 99.Other 如果 ShippingMethodCode = 2: 99.Other |
OtherCarrierName | String | 如果 ShippingCarrierCode = 99,填写你所提供的运输商名称 |
TrackingNumber | String | 包裹的追踪号码 |
PackageWeight | Decimal | 包裹重量 |
PackageLength | Decimal | 包裹长度 |
PackageHeight | Decimal | 包裹高度 |
PackageWidth | Decimal | 包裹宽度 |
SellerPartNumber | String | 商家商品编号 |
Quantity | Integer | 商品数量 |
NumberofPackage | Integer | 包裹标签数量 |
Schema: GetShipmentListResponse.xsd
示例:XML,Response
<?xml version="1.0" encoding="utf-8"?> <NeweggAPIResponse> <IsSuccess>true</IsSuccess> <OperationType>GetShipmentListResponse</OperationType> <SellerID>A006</SellerID> <ResponseBody> <ShipmentList> <Shipment> <ShipmentID>2740139</ShipmentID> <Status>Ready to ship</Status> <CreateDate>06/06/2013 17:02:31</CreateDate> <LastEditDate>06/07/2013 11:31:00</LastEditDate> <ShipFrom>Test_MKTPLS'K_</ShipFrom> <ShipToWarehouseCode>14</ShipToWarehouseCode> <ShipToAddress1>45 Patrick Ave., Dock 9-17</ShipToAddress1> <ShipToCityName>Edison</ShipToCityName> <ShipToStateCode>NJ</ShipToStateCode> <ShipToZipCode>08837</ShipToZipCode> <ShipToCountryCode>USA</ShipToCountryCode> <ShippingMethodCode>1</ShippingMethodCode> <ShippingCarrierCode>99</ShippingCarrierCode> <OtherCarrierName>1</OtherCarrierName> <PackageList> <Package> <TrackingNumber>1</TrackingNumber> <PackageWeight>0</PackageWeight> <PackageLength>0</PackageLength> <PackageHeight>0</PackageHeight> <PackageWidth>0</PackageWidth> </Package> </PackageList> <ItemList> <Item> <SellerPartNumber>Ss0120121228065937386</SellerPartNumber> <Quantity>36</Quantity> <NumberofPackage>2</NumberofPackage> </Item> <Item> <SellerPartNumber>SS0120130516683100755</SellerPartNumber> <Quantity>9</Quantity> <NumberofPackage>3</NumberofPackage> </Item> </ItemList> </Shipment> </ShipmentList> </ResponseBody> </NeweggAPIResponse>
示例:Json,Response
{ "IsSuccess": true, "OperationType": "GetShipmentListResponse", "SellerID": "A006", "ResponseBody": { "ShipmentList": [ { "ShipmentID": "2740139", "Status": "Ready to ship", "CreateDate": "06/06/2013 17:02:31", "LastEditDate": "06/07/2013 11:31:00", "ShipFrom": "Test_MKTPLS'K_", "ShipToWarehouseCode": "14", "ShipToAddress1": "45 Patrick Ave., Dock 9-17", "ShipToCityName": "Edison", "ShipToStateCode": "NJ", "ShipToZipCode": "08837", "ShipToCountryCode": "USA", "ShippingMethodCode": 0, "ShippingCarrierCode": 99, "OtherCarrierName": "1", "PackageList": [ { "TrackingNumber": "1", "PackageWeight": 0, "PackageLength": 0, "PackageHeight": 0, "PackageWidth": 0 } ], "ItemList": [ { "SellerPartNumber": "Ss0120121228065937386", "Quantity": 36, "NumberofPackage": 2 }, { "SellerPartNumber": "SS0120130516683100755", "Quantity": 9, "NumberofPackage": 3 } ] } ] } }
请求失败错误信息
常规HTTP错误回复,请参考回复失败错误代码列表。
更新日期:10/15/2018