新蛋订单货运标签请求
使用新蛋货运标签服务确认/运送订单。
注:请前往新蛋Seller Portal > 新蛋配送 > 注册新蛋货运标签服务 激活该服务。
相关URL
Newegg.com: https://api.newegg.com/marketplace/shippingservice/shippinglabel/createshippinglabel?sellerid={sellerid} Neweggbusiness.com: https://api.newegg.com/marketplace/b2b/shippingservice/shippinglabel/createshippinglabel?sellerid={sellerid} Newegg.ca: https://api.newegg.com/marketplace/can/shippingservice/shippinglabel/createshippinglabel?sellerid={sellerid}
注:请确保您的请求URL全都是小写(除Seller ID)并且不能包含任何空格或者换行符。
参数
名称 | 是否必填? | 描述 |
sellerid | 是 | 您在新蛋商城的商家编号 |
相关请求信息
HTTP方式 | 是否需要认证? | 请求格式 | 回复格式 | 频率限制 |
POST | 需要 | XML,Json | XML,Json | 1000 请求/小时 |
请求文件主体
属性 | 是否必填? | 格式 | 描述 | ||||||||||||||||||||
OperationType | 是 | String | 固定值:CreateShippingLabel | ||||||||||||||||||||
SellerID | 是 | String | 您的商家编号 | ||||||||||||||||||||
OrderNumber | 是 | Integer | 订单编号 | ||||||||||||||||||||
ShippingCarrierCode | 是 | Integer | 可用的物流公司编码:
100 – 新蛋合作承运人- UPS |
||||||||||||||||||||
ShippingServiceCode | 否 | Integer | 可用的运输服务代码: 对Newegg.com,Neweggbusiness.com: ShippingCarrierCode = 100: 101 – UPS Ground 102 – UPS 3 Day Select 103 – UPS 2nd Day Air 104 – UPS Next Day Air Saver 105 – UPS Next Day Air 对Newegg.ca: 注意:如果该字段为空,系统会根据顾客下单时选择的运送方式自动分配一个默认值。默认的运送服务映射表如下所示:
对 Newegg.ca:
*可选承运人服务 |
||||||||||||||||||||
ShipFromFirstName | 是 | String | 发货人名 | ||||||||||||||||||||
ShipFromLastName | 是 | String | 发货人姓 | ||||||||||||||||||||
ShipFromPhoneNumber | 是 | String | 发货人联系电话 | ||||||||||||||||||||
ShipFromAddress1 | 是 | String | 收货地址1
运费是按照该地址计算,请填写正确信息。 |
||||||||||||||||||||
ShipFromAddress2 | 否 | String | 收货地址2
运费是按照该地址计算,请填写正确信息。 |
||||||||||||||||||||
ShipFromCityName | 是 | String | 发货地所在城市
运费是按照该地址计算,请填写正确信息。 |
||||||||||||||||||||
ShipFromStateCode | 是 | String | 发货地所在州: 如CA, FL 等
运费是按照该地址计算,请填写正确信息。 |
||||||||||||||||||||
ShpFromZipCode | 是 | String | 发货地邮编:如91748,91773等
运费是按照该地址计算,请填写正确信息。 |
||||||||||||||||||||
ShipFromCountryCode | 是 | String | 发货地所在国家的三位国家代码
|
||||||||||||||||||||
PackageWeight | 是 | Decimal | 包裹重量
|
||||||||||||||||||||
PackageLength | 是 | Decimal | 包裹长度
|
||||||||||||||||||||
PackageHeight | 是 | Decimal | 包裹高度
|
||||||||||||||||||||
PackageWidth | 是 | Decimal | 包裹宽度
|
||||||||||||||||||||
SignatureOptions | 否 | String | 选项:
|
||||||||||||||||||||
SellerPartNumber | 是 | String | 商品的Seller Part# | ||||||||||||||||||||
Quantity | 是 | Integer | 商品数量 |
Schema: ShippingNewLabelSubmitRequest.xsd
示例:XML,Request
POST https://api.newegg.com/marketplace/shippingservice/shippinglabel/createshippinglabel?sellerid={sellerid} Authorization: 720ddc067f4d115bd544aff46bc75634 SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D Content-Type: application/xml Accept: application/xml <NeweggAPIRequest> <OperationType>CreateShippingLabel</OperationType> <SellerID>A006</SellerID> <RequestBody> <Shipment> <OrderNumber>2135751360</OrderNumber> <ShippingCarrierCode>100</ShippingCarrierCode> <ShippingServiceCode>101</ShippingServiceCode> <ShipFromFirstName>John</ShipFromFirstName> <ShipFromLastName>Doe</ShipFromLastName> <ShipFromPhoneNumber>6266171420</ShipFromPhoneNumber> <ShipFromAddress1>18045 Rowland Street</ShipFromAddress1> <ShipFromAddress2/> <ShipFromCityName>City Of Industry</ShipFromCityName> <ShipFromStateCode>CA</ShipFromStateCode> <ShipFromZipCode>91748</ShipFromZipCode> <ShipFromCountryCode>USA</ShipFromCountryCode> <PackageList> <Package> <PackageWeight>5</PackageWeight> <PackageLength>5.00</PackageLength> <PackageHeight>4.00</PackageHeight> <PackageWidth>3.00</PackageWidth> <SignatureOptions>Regular</SignatureOptions> <ItemList> <Item> <SellerPartNumber>201307220000101</SellerPartNumber> <Quantity>4</Quantity> </Item> <Item> <SellerPartNumber>SARATEST0118</SellerPartNumber> <Quantity>1</Quantity> </Item> </ItemList> </Package> <Package> <PackageWeight>1.5</PackageWeight> <PackageLength>2.00</PackageLength> <PackageHeight>3.00</PackageHeight> <PackageWidth>4.00</PackageWidth> <ItemList> <Item> <SellerPartNumber>201307220000102</SellerPartNumber> <Quantity>3</Quantity> </Item> </ItemList> </Package> </PackageList> </Shipment> </RequestBody> </NeweggAPIRequest>
示例:Json,Request
POST https://api.newegg.com/marketplace/shippingservice/shippinglabel/createshippinglabel?sellerid={sellerid} Authorization: 720ddc067f4d115bd544aff46bc75634 SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D Content-Type: application/json Accept: application/json { "NeweggAPIRequest": { "OperationType": "CreateShippingLabel", "SellerID": "A006", "RequestBody": { "Shipment": { "OrderNumber": "2135751360", "ShippingCarrierCode": "100", "ShippingServiceCode": "101", "ShipFromFirstName": "John", "ShipFromLastName": "Doe", "ShipFromPhoneNumber": "6266171420", "ShipFromAddress1": "18045 Rowland Street", "ShipFromCityName": "City Of Industry", "ShipFromStateCode": "CA", "ShipFromZipCode": "91748", "ShipFromCountryCode": "USA", "PackageList": { "Package": [ { "PackageWeight": "5", "PackageLength": "5.00", "PackageHeight": "4.00", "PackageWidth": "3.00", "SignatureOptions": "Regular", "ItemList": { "Item": [ { "SellerPartNumber": "201307220000101", "Quantity": "4" }, { "SellerPartNumber": "SARATEST0118", "Quantity": "1" } ] } }, { "PackageWeight": "1.5", "PackageLength": "2.00", "PackageHeight": "3.00", "PackageWidth": "4.00", "ItemList": { "Item": { "SellerPartNumber": "201307220000102", "Quantity": "3" } } } ] } } } } }
回复文件主体
属性 | 格式 | 描述 |
IsSuccess | String | 用来确认获取请求状态的操作是否成功 True:成功 False:失败 |
OperationType | String | 固定值:CreateShippingLabelResponse |
SellerID | String | 商家编号 |
OrderNumber | Integer | 需要操作的订单号 |
ShipDate | String | 确认发货请求的日期(太平洋标准时间) |
TrackingNumber | String | 发货包裹的追踪号 |
ProcessResult | String | 请求失败或者成功 |
ErrorMessage | String | 进程失败的详细信息 |
SignatureOptions | String |
|
LabelUrl | String | 下载货运标签的链接 |
PackageListUrl | String | 下载包裹列表的链接 |
ShipWeight | Decimal | 包裹重量 |
ArriveBy | String | 合作承认人将交付货物的日期 |
ShippingAmount | Decimal | 合作承运人将收取的货件费用 |
SignatureOptions | Decimal | 合作承运人将收取所需签名的费用 |
Total | Decimal | 承运人将收取的总金额:货件费 + 签名费 |
SellerPartNumber | String | 卖家的商品编号 |
Quantity | Integer | 商品的发货数量 |
Schema: ShippingNewLabelSubmitResponse.xsd
示例:XML,Response
<?xml version="1.0" encoding="utf-8"?> <NeweggAPIResponse> <IsSuccess>true</IsSuccess> <OperationType>CreateShippingLabelResponse</OperationType> <SellerID>A006</SellerID> <ResponseBody> <Shipment> <OrderNumber>2135751360</OrderNumber> <ShipDate>12/25/2015</ShipDate> <PackageList> <Package> <TrackingNumber>1Z8V016A0377769652</TrackingNumber> <ProcessResult>Success</ProcessResult> <ErrorMessage/> <SignatureOptions>Regular</SignatureOptions> <LabelUrl>http://images10.newegg.com/SBNInbound/UPSShippingLabel/dc395051-a1ba-4c7e-99c9-94025bc7577e.pdf</LabelUrl> <PackingListUrl>http://images10.newegg.com/SBNInbound/UPSShippingLabel/dc395051-a1ba-4c7e-99c9-94025bc7577e.pdf</PackingListUrl> <Rate> <ShipWeight>6.5</ShipWeight> <ArriveBy>12/29/2015</ArriveBy> <ShippingAmount>21.94</ShippingAmount> <SignatureOptions>4.25</SignatureOptions> <Total>26.19</Total> </Rate> <ItemList> <Item> <SellerPartNumber>201307220000101</SellerPartNumber> <Quantity>4</Quantity> </Item> <Item> <SellerPartNumber>SARATEST0118</SellerPartNumber> <Quantity>1</Quantity> </Item> </ItemList> </Package> </PackageList> </Shipment> </ResponseBody> </NeweggAPIResponse>
示例:Json,Response
{ "NeweggAPIResponse": { "IsSuccess": "true", "OperationType": "CreateShippingLabelResponse", "SellerID": "A006", "ResponseBody": { "Shipment": { "OrderNumber": "2135751360", "ShipDate": "12/25/2015", "PackageList": { "Package": { "TrackingNumber": "1Z8V016A0377769652", "ProcessResult": "Success", "SignatureOptions": "Regular", "LabelUrl": "http://images10.newegg.com/SBNInbound/UPSShippingLabel/dc395051-a1ba-4c7e-99c9-94025bc7577e.pdf", "PackingListUrl": "http://images10.newegg.com/SBNInbound/UPSShippingLabel/dc395051-a1ba-4c7e-99c9-94025bc7577e.pdf", "Rate": { "ShipWeight": "6.5", "ArriveBy": "12/29/2015", "ShippingAmount": "21.94", "SignatureOptions": "4.25", "Total": "26.19" }, "ItemList": { "Item": [ { "SellerPartNumber": "201307220000101", "Quantity": "4" }, { "SellerPartNumber": "SARATEST0118", "Quantity": "1" } ] } } } } } } }
请求失败错误信息
常规HTTP错误回复,请参考回复失败错误代码列表。
错误代码 | 描述 |
SL001 | Your request cannot be processed. The tem(s):{0} in order: [Order #] has been shipped or voided.
你的请求无法处理。[Order #]已经被运送或被作废 |
SL002 | No data found or this order does not belong to this seller.
无法找到该订单或该订单不属于这个商家 |
SL003 | Only unshipped orders can submit a shipping request. The order status is currently {order status}.
只有未运送的订单可以提交运送请求。当前订单状态为{order status} |
SL004 | Only shipped by seller orders can submit a shipping request.
只有商家配送的请求可以提交运送请求 |
SL005 | Seller Part #: {sellerpart#} must be shipped for its entire quantity on the order.
商品{seller part#}必须按订单中全部数量运送 |
SL006 | The field: [PackageWeight or PackageLength or PackageHeight or PackageWidth] is required when using Newegg Partnered Carrier service (ShippingCarrierCode: 100). For more detail, please review Newegg API Development Guide.
使用新蛋合作物流公司服务(ShippingCarrierCode: 100)必须填写字段:[包装重量,包装长度,包装高度,包装宽度]。更多信息请浏览新蛋 API 开发者手册。 |
SL007 | The value in the field: PackageWeight cannot exceed {Maximum package weight limit by Newegg Partnered Carrier} lbs. ({Maximum package weight limit by Newegg Partnered Carrier}kg) when using Newegg Partnered Carrier service (ShippingCarrierCode: {ShippingCarrierCode}). For more detail, please review Newegg API Development Guide.
在使用新蛋合作物流服务(ShippingCarrierCode: {ShippingCarrierCode})时,包装重量超过{新蛋合作物流服务允许的最大重量限制}lbs。更多信息请浏览新蛋 API 开发者手册。 |
SL008 | The value in the field: PackageLength cannot exceed {Maximum package length limit by Newegg Partnered Carrier} inches ({Maximum package length limit by Newegg Partnered Carrier} cm) when using Newegg Partnered Carrier service (ShippingCarrierCode: {ShippingCarrierCode}). For more detail, please review Newegg API Development Guide.
在使用新蛋合作物流服务(ShippingCarrierCode: {ShippingCarrierCode})时,包装长度超过{新蛋合作物流服务 允许的最大长度限制}inches。更多信息请浏览新蛋 API 开发者手册。 |
SL009 | Package size cannot exceed {Maximum package cubic size limit by Newegg Partnered Carrier}inches ({Maximum package cubic size limit by Newegg Partnered Carrier} cm) in (Package Length + 2x Package Width + 2x Package Height) when using Newegg Partnered Carrier service (ShippingCarrierCode: {ShippingCarrierCode}). For more detail, please review Newegg API Development Guide.
在使用新蛋合作物流服务(ShippingCarrierCode: {ShippingCarrierCode})时,包装尺寸(包装长度 + 2x 包装宽度 + 2x 包装高度)不能超过{新蛋合作物流服务允许的最大包装立方大小}inches。更多信息请浏览新蛋 API 开发者手册。 |
SL010 | Cannot submit the request because seller part number(s):{sellerpart#} does NOT belong to this order.
无法提交请求因为商品{sellerpart#}不属于这个商家。 |
SL015 | Cannot submit the request because currently only supports USA domestic transportation.Please revise the Ship From or Ship To information and try again.
无法提交该请求因为当前只支持美国国内运输。请修改发货地或收件人信息之后再次提交请求。 |
SL027 | Invalid request. You are not able to use Newegg Shipping Label Service before sign up. Please visit Newegg Seller Portal > Add-on Services > Newegg Shipping Label Service to sign up.
无效请求。在注册成功之前不能使用新蛋货运标签服务。请登陆 Seller Portal,进入 Add-on Services > Newegg Shipping Label Service 进行注册。 |
SL030 | Invalid request. The ShippingServiceCode :{ shipping service code} you specified is not a recognized value for ShippingCarrierCode :{ shipping carrier code}. Please review Newegg API Development Guide or schema for correct information.
无效请求。你指定的运送服务编号{ shipping service code}对于物流公司{ shipping carrier code}无法识别。请浏览新蛋 API 开发者手册或源码文件获取正确信息。 |
示例:XML,Response
<?xml version="1.0" encoding="utf-8"?> <Errors> <Error> <Code>SL001</Code> <Message>Order Number should be an integer (ranging from 1 to 2147483647)</Message> </Error> </Errors>
示例:Json,Response
[ { "Code": "SL001", "Message": "Order Number should be an integer (ranging from 1 to 2147483647)" } ]
更新日期:03/15/2021