Shipping Label Estimate Request for Newegg Orders

Submit a request for an estimation of the shipping cost for the order using Newegg Shipping Label Service.

Please note: This request is for estimation only. Please submit a shipping label request to ship orders.

Resource URL

Newegg.com: https://api.newegg.com/marketplace/shippingservice/shippinglabel/estimateshippinglabel?sellerid={sellerid}
Neweggbusiness.com: https://api.newegg.com/marketplace/b2b/shippingservice/shippinglabel/estimateshippinglabel?sellerid={sellerid}
Newegg.ca: https://api.newegg.com/marketplace/can/shippingservice/shippinglabel/estimateshippinglabel?sellerid={sellerid}

Note: Please make sure your request URL is all in lower case (except for Seller ID) and cannot contain any blank spaces or line breaks.

Parameters

Resource Information

Request Body

Schema: ShippingLabelEstimateRequest.xsd

Example: XML, Request

POST https://api.newegg.com/marketplace/shippingservice/shippinglabel/estimateshippinglabel?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml

<NeweggAPIRequest>
    <OperationType>EstimateShippingLabel</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>

Example: Json, Request

POST https://api.newegg.com/marketplace/shippingservice/shippinglabel/estimateshippinglabel?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json

{
  "NeweggAPIRequest": {
    "OperationType": "EstimateShippingLabel",
    "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"
                }
              }
            }
          ]
        }
      }
    }
  }
}

Response Body

Schema: ShippingLabelEstimateResponse.xsd

Example: XML, Response

<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
    <IsSuccess>true</IsSuccess>
    <OperationType>EstimateShippingLabelResponse</OperationType>
    <SellerID>A006</SellerID>
    <ResponseBody>
        <Shipment>
            <OrderNumber>2135751360</OrderNumber>
            <EstimatedDate>12/25/2015</EstimatedDate>
            <PackageList>
                <Package>
                    <PackageWeight>5</PackageWeight>
                    <PackageLength>5.00</PackageLength>
                    <PackageHeight>4.00</PackageHeight>
                    <PackageWidth>3.00</PackageWidth>
                    <SignatureOptions>Regular</SignatureOptions>
                    <ProcessResult>Success</ProcessResult>
                    <ErrorMessage/>
                    <EstimatedRate>
                        <EstimatedShipWeight>6.5</EstimatedShipWeight>
                        <EstimatedArriveBy>12/29/2015</EstimatedArriveBy>
                        <EstimatedShippingAmount>21.94</EstimatedShippingAmount>
                        <EstimatedSignatureOptions>4.25</EstimatedSignatureOptions>
                        <EstimatedTotal>26.19</EstimatedTotal>
                    </EstimatedRate>
                </Package>
                <Package>
                    <PackageWeight>1.5</PackageWeight>
                    <PackageLength>2.00</PackageLength>
                    <PackageHeight>3.00</PackageHeight>
                    <PackageWidth>4.00</PackageWidth>
                    <ProcessResult>Success</ProcessResult>
                    <ErrorMessage/>
                    <EstimatedRate>
                        <EstimatedShipWeight>6.5</EstimatedShipWeight>
                        <EstimatedArriveBy>12/29/2015</EstimatedArriveBy>
                        <EstimatedShippingAmount>15.50</EstimatedShippingAmount>
                        <EstimatedSignatureOptions>0.00</EstimatedSignatureOptions>
                        <EstimatedTotal>15.50</EstimatedTotal>
                    </EstimatedRate>
                </Package>
            </PackageList>
        </Shipment>
    </ResponseBody>
</NeweggAPIResponse>

Example: Json, Response

{
  "NeweggAPIResponse": {
    "IsSuccess": "true",
    "OperationType": "EstimateShippingLabelResponse",
    "SellerID": "A006",
    "ResponseBody": {
      "Shipment": {
        "OrderNumber": "2135751360",
        "EstimatedDate": "12/25/2015",
        "PackageList": {
          "Package": [
            {
              "PackageWeight": "5",
              "PackageLength": "5.00",
              "PackageHeight": "4.00",
              "PackageWidth": "3.00",
              "SignatureOptions": "Regular",
              "ProcessResult": "Success",
              "EstimatedRate": {
                "EstimatedShipWeight": "6.5",
                "EstimatedArriveBy": "12/29/2015",
                "EstimatedShippingAmount": "21.94",
                "EstimatedSignatureOptions": "4.25",
                "EstimatedTotal": "26.19"
              }
            },
            {
              "PackageWeight": "1.5",
              "PackageLength": "2.00",
              "PackageHeight": "3.00",
              "PackageWidth": "4.00",
              "ProcessResult": "Success",
              "EstimatedRate": {
                "EstimatedShipWeight": "6.5",
                "EstimatedArriveBy": "12/29/2015",
                "EstimatedShippingAmount": "15.50",
                "EstimatedSignatureOptions": "0.00",
                "EstimatedTotal": "15.50"
              }
            }
          ]
        }
      }
    }
  }
}

Request Failure Errors

For common HTTP error responses, please refer to Failed Response Error Code List.

Example: 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>

Example: Json, Response

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

Last updated: January 13, 2020