運送訂單

運送訂單功能允許您更新訂單中一個或全部商品的運送資訊。當一個訂單被完全運送，即訂單中所有商品都已運送，那麼這個訂單就處理完成了。

請參考以下案例瞭解可接受的運送訂單請求：

訂單XYZ有5個商品A，一個商品B

• 場景1單個包裹：包裹1，包含5個商品A和一個商品B，且使用一個運送單號
• 場景2 單個包裹：包裹1，包含5個商品A且使用一個運送單號
  • 這將被視為部分發貨訂單
  • 商品B應該在訂單自動失效前通過包裹2發貨，如果未發貨，新蛋將從訂單中刪除商品B，並僅為訂單中的商品A開具發票

• 場景3 多個包裹：包裹1包含5個商品A， 使用一個運送單號；包裹2包含1個商品B，使用一個運送單號
• 場景4多個包裹：包裹1包含2個商品A， 使用一個運送單號；包裹2包含3個商品A，使用一個運送單號；包裹3包含1個商品B，使用一個運送單號
• 新蛋不接受這樣提交部分運送的請求：僅有一個包裹只包含2個商品A，使用一個運送單號
  • 新蛋系統會報錯並提示商品A 的訂購總數量與發貨數量不匹配。

相關URL

Newegg.com: https://api.newegg.com/marketplace/ordermgmt/orderstatus/orders/{ordernumber}?sellerid={sellerid}&version={version}
Neweggbusiness.com: https://api.newegg.com/marketplace/b2b/ordermgmt/orderstatus/orders/{ordernumber}?sellerid={sellerid}&version={version}
Newegg.ca: https://api.newegg.com/marketplace/can/ordermgmt/orderstatus/orders/{ordernumber}?sellerid={sellerid}&version={version}

註：請確保您的請求URL全都是小寫（除Seller ID）並且不能包含任何空格或者分行符號。

參數

相關請求資訊

請求文件主體

Schema: ShipmentRequest.xsd

示例：XML, Request

註：<VALUE>必須附上<![CDATA[]]>，細節部分請看下面示例

PUT https://api.newegg.com/marketplace/can/ordermgmt/orderstatus/orders/{ordernumber}?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml

<UpdateOrderStatus>
    <Action>2</Action>
    <Value>
        <![CDATA[
<Shipment><Header><SellerID>A006</SellerID><SONumber>159243598</SONumber></Header><PackageList><Package><TrackingNumber>lztestA0060001</TrackingNumber><ShipCarrier>Other Carrier</ShipCarrier><ShipService>Other Service</ShipService><ItemList><Item><SellerPartNumber>A006ZX-35833</SellerPartNumber><ShippedQty>1</ShippedQty></Item></ItemList></Package></PackageList></Shipment>
]]>
    </Value>
</UpdateOrderStatus>

示例：Json, Request

PUT https://api.newegg.com/marketplace/can/ordermgmt/orderstatus/orders/{ordernumber}?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/Json
Accept: application/Json

{
    "Action": "2",
    "Value": {
        "Shipment": {
            "Header": {
                "SellerID": "A006",
                "SONumber": "159243598"
            },
            "PackageList": {
                "Package": [
                    {
                        "TrackingNumber": "alistestonly1",
                        "ShipCarrier": "Purolator",
                        "ShipService": "3-5",
                        "ItemList": {
                            "Item": {
                                "SellerPartNumber": "A3WG11002378965412586",
                                "ShippedQty": "1"
                            }
                        }
                    },
                    {
                        "TrackingNumber": "alistestonly2",
                        "ShipCarrier": "Purolator",
                        "ShipService": "3-5",
                        "ItemList": {
                            "Item": [
                                {
                                    "SellerPartNumber": "A3WG11002378965412583",
                                    "ShippedQty": "1"
                                },
                                {
                                    "SellerPartNumber": "A3WG11002378965412584",
                                    "ShippedQty": "1"
                                }
                            ]
                        }
                    }
                ]
            }
        }
    }
}

回覆文件主體

Schema: ShipmentResponse.xsd

示例：XML, Response

<?xml version="1.0" encoding="utf-8"?>
<UpdateOrderStatusInfo>
    <IsSuccess>true</IsSuccess>
    <PackageProcessingSummary>
        <TotalPackageCount>1</TotalPackageCount>
        <SuccessCount>1</SuccessCount>
        <FailCount>0</FailCount>
    </PackageProcessingSummary>
    <Result>
        <OrderNumber>159243598</OrderNumber>
        <SellerID>A006</SellerID>
        <OrderStatus>Shipped</OrderStatus>
        <Shipment>
            <PackageList>
                <Package>
                    <TrackingNumber>lztestA0060001</TrackingNumber>
                    <ShipDate>2012-02-10T15:30:01</ShipDate>
                    <ProcessStatus>true</ProcessStatus>
                    <ProcessResult>Success</ProcessResult>
                    <ItemList>
                        <ItemDes>
                            <NeweggItemNumber>9SIA0060845543</NeweggItemNumber>
                            <SellerPartNumber>A006ZX-35833</SellerPartNumber>
                            <ShippedQty>1</ShippedQty>
                        </ItemDes>
                    </ItemList>
                </Package>
            </PackageList>
        </Shipment>
    </Result>
</UpdateOrderStatusInfo>

示例：Json, Response

{
    "IsSuccess": true,
    "PackageProcessingSummary": {
        "FailCount": 0,
        "SuccessCount": 1,
        "TotalPackageCount": 1
    },
    "Result": {
        "OrderNumber": "159243598",
        "OrderStatus": "Shipped",
        "SellerID": "A006",
        "Shipment": {
            "PackageList": [
                {
                    "ItemList": [
                        {
                            "NeweggItemNumber": "9SIA0060845543",
                            "SellerPartNumber": "A006ZX-35833",
                            "ShippedQty": 1
                        }
                    ],
                    "ProcessResult": "Success",
                    "ProcessStatus": true,
                    "ShipDate": "2012-02-10T15:30:01",
                    "TrackingNumber": "lztestA0060001"
                }
            ]
        }
    }
}

請求失敗錯誤資訊

常規HTTP錯誤回應，請參考回覆失敗錯誤代碼清單。

示例：XML, Response

<?xml version="1.0" encoding="utf-8"?>
<Errors>
    <Error>
        <Code>SO002</Code>
        <Message>Order Number should be an integer (ranging from 1 to 2147483647)</Message>
    </Error>
</Errors>

示例：Json, Response

[
    {
        "Code": "SO002",
        "Message": "Order Number should be an integer (ranging from 1 to 2147483647)"
    }
]

更新日期：10/15/2018