新蛋订单货运标签请求

使用新蛋货运标签服务确认/运送订单。

注:请前往新蛋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:
ShippingCarrierCode = 100:
111 – UPS Standard
112 – UPS Express
113 – UPS Expedited
114 – UPS Express Saver*

注意:如果该字段为空,系统会根据顾客下单时选择的运送方式自动分配一个默认值。默认的运送服务映射表如下所示:
如果 ShippingCarrierCode = 100:
对 Newegg.com,Neweggbusiness.com:

新蛋订单运送方式 默认映射服务
Standard Shipping(5-7 business days) UPS Ground
Expedited Shipping(3-5 business days) UPS 3 Day Select
Two-Day Shipping UPS 2nd Day Air
One-Day Shipping UPS Next Day Air Saver

对 Newegg.ca:

新蛋订单运送方式 默认映射服务
Standard Shipping(5-7 business days) UPS Ground
Expedited Shipping(3-5 business days) UPS Ground
Two-Day Shipping UPS Expedited
One-Day Shipping UPS Express Saver

*可选承运人服务

ShipFromFirstName String 发货人名
ShipFromLastName String 发货人姓
ShipFromPhoneNumber String 发货人联系电话
ShipFromAddress1 String 收货地址1

运费是按照该地址计算,请填写正确信息。

ShipFromAddress2 String 收货地址2

运费是按照该地址计算,请填写正确信息。

ShipFromCityName String 发货地所在城市

运费是按照该地址计算,请填写正确信息。

ShipFromStateCode String 发货地所在州: 如CA, FL 等

运费是按照该地址计算,请填写正确信息。

ShpFromZipCode String 发货地邮编:如91748,91773等

运费是按照该地址计算,请填写正确信息。

ShipFromCountryCode String 发货地所在国家的三位国家代码

  • Newegg.com,Neweggbuseinss.com:USA
  • Newegg.ca:CAN
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