提交作废入货请求

向新蛋提交作废已存在的入货请求。

相关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
ShipmentID String 已存在的入货编码
ActionCode Integer 操作代码:
2. Void 作废

Schema: SubmitInboundShipmentRequest_Void.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>2</ActionCode>
            <ShipmentID>2771551</ShipmentID>
        </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": 2,
            "ShipmentID": 2771551
        }
    }
}

回复文件主体

属性 格式 描述
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 The field:[MSDSURL] is required when ORM-D = 1. For more detail, please contact datafeeds@newegg.com.

当 ORM-D=1 时,字段[MSDSURL]必填。获取更多信息,请联系 datafeeds@newegg.com

示例: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."
    }
]

更新日期:10/15/2018