AuctionInc Shipping Rates API
Methods Summary


SS Method Request
XS Method Request
Version History


Ship Rate API Methods

The principal methods provided by the AuctionInc API to compute packaging and comparative shipping rates.

Method

Current Version

Description





GetItemShipRateSS

2.3

Packages one or more items into the optimal packaging configurations and returns comparative shipping rates. Typically used with shopping cart applications.

The GetItemShipRateSS method relies on shipping preferences that are configured at the AuctionInc website for one seller. 

This method is appropriate for applications where the API access key will be representative of only one seller.




GetItemShipRateXS

2.4

The GetItemShipRateXS method is similar to the GetItemShipRateSS method except that the shipping preferences are passed in the XML instead of residing at the AuctionInc website. Some configuration options of the shipping rate engine are not available (see method specification for details), but, as opposed to SS calls,  unlimited sellers are supported.

This method is used for applications where the API access key is representative of multiple sellers, each using independent sets of shipping preferences for the shipping calculations.



Utility API Methods

Method

Current
Version

Description

GetTime

1.0

Use GetTime to retrieve the DateTime value from the Paid Shipping API web service.

Example:
<GetTime version="1.0">
</GetTime>




Methods Detail


GetItemShipRateSS Method

(Single Seller)

The GetItemShipRateSS method is used for a single seller to package one or more items into appropriate packages and calculate shipping rates for each package.  The method is used in conjunction with AuctionInc account saved seller preferences.  This method supports one seller only (although it does support drop-shipping items from multiple locations for this seller).

Current Version: 2.3 (Version column in XML Schema indicates the version at which the element was introduced)

Header Schema

Element Name

Data Type

Max Size

Current
Version

Description

AccountId

 xs:string

 

128

1.0

Your valid AuctionInc API Account ID.

(Required)

RefCode

 xs:string

 

32

2.1

Reference code you can use for tracking various call categories.

(Optional)

Example:

<Header>
    <AccountId>Your valid account ID</AccountId>
</Header>


Request Body Schema

The GetItemShipRateSS Request schema is the XML that is used in the request message that appears in the Body element.

Element Name

Data Type

Max Size

Version

Description

Version

xs:string

8

2.3

Attribute that indicates the version of the API method that the caller can support.

Current method version: 2.3

Currently both method call and response have no deprecated elements.  Your inclusion of any elements added in versions later than your indicated supported version will take precedence.  This will change at such time when future versions are incompatible with earlier versions.

DetailLevel

xs:string

1

1.0

The Detail Level determines the detail of the rate data returned by AuctionInc. Higher levels include data from lower levels.

Level 1:  Summary rates per service
Level 2:  Rate component data per service
Level 3:  Package detail per service

(note:  not all carriers support the same details)

(Optional, default=1)

Currency

xs:string

3

1.0

The currency for monetary values in both the API call and the response.

(Optional, default=USD)

DestinationAddress

DestinationAddress Schema

 

 

One DestinationAddress indicating to where the shipment will be delivered. See DestinationAddress Schema

(Required)

ItemList

 Item Collection


 

List of one or more Item schemas that represent the items that will be packaged and rated.

(Required)

Example of GetItemShipRateSS XML Request:

<?xml version="1.0" encoding="utf-8"?>
<Envelope>
    <Header>
        <AccountId>your-account-key </AccountId>
    </Header>
    <Body>
        <GetItemShipRateSS version="2.3">
            <DetailLevel>1</DetailLevel>
            <Currency>USD</Currency>
            <DestinationAddress>
                <ResidentialDelivery>true</ResidentialDelivery>
                <CountryCode>US</CountryCode>
                <PostalCode>90210</PostalCode>
                <StateOrProvinceCode>CA</StateOrProvinceCode>
            </DestinationAddress>
            <ItemList>
                <Item>
                    <RefCode>keyboard-101</RefCode>
                    <Quantity>2</Quantity>
                    <CalcMethod Code="C">
                        <CarrierCalcProps>
                            <Length>8</Length>
                            <Width>5</Width>
                            <Height>2.5</Height>
                            <DimUOM>IN</DimUOM>
                            <Weight>4</Weight>
                            <WeightUOM>LBS</WeightUOM>
                            <DeclaredValue>59.95</DeclaredValue>
                            <PackMethod>T</PackMethod>
                        </CarrierCalcProps>
                    </CalcMethod>
                </Item>
                <Item>
                    <RefCode>monitor</RefCode>
                    <Quantity>1</Quantity>
                    <CalcMethod Code="C">
                        <CarrierCalcProps>
                            <Length>6</Length>
                            <Width>4</Width>
                            <Height>3</Height>
                            <DimUOM>IN</DimUOM>
                            <Weight>4.5</Weight>
                            <WeightUOM>LBS</WeightUOM>
                            <DeclaredValue>218.50</DeclaredValue>
                            <PackMethod>T</PackMethod>
                            <OriginCode>FL-WHS</OriginCode>
                        </CarrierCalcProps>
                    </CalcMethod>
                </Item>
            </ItemList>
        </GetItemShipRateSS>
    </Body>
</Envelope>

GetItemShipRateXS Method

(Unlimited Sellers)

The GetItemShipRateXS method supports multiple sellers for packaging one or more items into appropriate packages and calculating shipping rates for each package.  The method is similar to the GetItemShipRateSS method except instead of using the saved shipping preferences of a single seller, the seller shipping preferences are provided in the XML of the call.  This difference allows the XS call to support unlimited sellers.  The ShipRateXS Method is appropriate for cart integrators and other projects where multiple sellers are involved.

Current Version: 2.4 (Version column in XML Schema indicates the version at which the element was introduced)

GetItemShipRateXS calls do not support some features which are only available thru the AuctionInc saved seller preferences 
(and thus through GetItemShipRateSS calls) as indicated in the following list.   These are primarily features which involve a simple modification of the shiprates returned by AuctionInc; the integrator may elect to support some of these, such as the additon of a handling charge, directly thru collection and application of the appropriate setting to the calculated rates.

Not Calculated Through XS Calls

  • Shipping Rate Discount Promotions
  • Packaging Weight Factoring
  • Insurance Thresholds
  • Handling Fees
  • Supplemental Handling Fee Codes
  • Fixed Fee Codes

Header Schema

Element Name

Data Type

Max Size

Version

Description

AccountId

 xs:string

 

128

1.0

Your valid AuctionInc API Account ID.

(Required)

RefCode

 xs:string

 

32

2.1

Reference code you can use for tracking customer usage or other call categories.  Our API Statistics report allows grouping by this value.

(Optional)

Example:

<Header>
    <AccountId>Your valid account ID</AccountId>
    <RefCode>1234</RefCode>
</Header>

Request Body Schema

The GetItemShipRateXS Request schema is the XML that is used in the request message that appears in the Body element.

Element Name

Data Type

Max Size

Version

Description

Version

xs:string

8

2.4

Attribute that indicates the version of the API method that the caller can support.

Current method version: 2.4

Currently both method call and response have no deprecated elements.  Your inclusion of any elements added in versions later than your indicated supported version will take precedence.  This will change at such time when future versions are incompatible with earlier versions.

DetailLevel

xs:string

1

1.0

The Detail Level determines the detail of the rate data returned by AuctionInc. Higher levels include data from lower levels.

Level 1:  Summary rates per service
Level 2:  Rate component data per service
Level 3:  Package detail per service

(note:  not all carriers support the same details)

(Optional, default=1)

Currency

xs:string

3

1.0

The currency for monetary values in both the API call and in the response.

(Optional, default=USD)

CarrierList

Carrier schema


 

List of one or more Carrier schema that details the carrier and services to be rated.

(Required)

OriginAddressList

Origin Address Collection


 

The address(es) that the item(s) in the shipment are originating from.
(Required)

DestinationAddress

Destination Address Collection


 

The address to which the the shipment is to be delivered.
(Required)

ItemList

Item Collection


 

List of one or more Item schemas that represent the items that will be packaged and rated.

(Required)

Example of GetItemShipRateXS XML Request:

<?xml version="1.0" encoding="utf-8"?>
<Envelope>
    <Header>
        <AccountId>your-account-key </AccountId>
        <RefCode>12345</RefCode>
    </Header>
    <Body>
        <GetItemShipRateXS version="2.3">
            <DetailLevel>3</DetailLevel>
            <Currency>USD</Currency>
            <CarrierList>
                <Carrier code="UPS">
                    <EntryPoint>D</EntryPoint>
                    <ServiceList>
                        <Service code="UPSGND">
                            <PkgMaxWeight>45</PkgMaxWeight>
                            <PkgMaxLength>10</PkgMaxLength>
                            <PkgMaxWidth>10</PkgMaxWidth>
                            <PkgMaxHeight>8</PkgMaxHeight>
                        </Service>
                        <Service code="UPSNDA">
                            <PkgMaxWeight>45</PkgMaxWeight>
                            <PkgMaxLength>10</PkgMaxLength>
                            <PkgMaxWidth>10</PkgMaxWidth>
                            <PkgMaxHeight>8</PkgMaxHeight>
                        </Service>
                    </ServiceList>
                </Carrier>
                <Carrier code="DHL">
                    <EntryPoint>P</EntryPoint>
                    <AccessKey>12345678</AccessKey>
                    <PostalCode>01610</PostalCode>
                    <ServiceList>
                        <Service code="DHLGND" />
                        <Service code="DHLNDA" />
                    </ServiceList>
                </Carrier>
                <Carrier code="USPS">
                    </EntryPoint>
                    <FlatRatePackaging>PKG</FlatRatePackaging>
                    <ServiceList>
                        <Service code="USPPM" />
                        <Service code="USPMM">
                            <OnDemand>true</OnDemand>
                        </Service>
                    </ServiceList>
                </Carrier>
            </CarrierList>
            <OriginAddressList>
                <OriginAddress>
                    </OriginCode>
                    <CountryCode>US</CountryCode>
                    <PostalCode>01610</PostalCode>
                    <StateOrProvinceCode>MA</StateOrProvinceCode>
                </OriginAddress>
                <OriginAddress>
                    <OriginCode>CA-WHS</OriginCode>
                    <CountryCode>US</CountryCode>
                    <PostalCode>90210</PostalCode>
                    <StateOrProvinceCode>CA</StateOrProvinceCode>
                </OriginAddress>
            </OriginAddressList>
            <DestinationAddress>
                <ResidentialDelivery>true</ResidentialDelivery>
                <CountryCode>US</CountryCode>
                <PostalCode>90210</PostalCode>
                <StateOrProvinceCode>CA</StateOrProvinceCode>
            </DestinationAddress>
            <ItemList>
                <Item>
                    <RefCode>keyboard-101</RefCode>
                    <Quantity>2</Quantity>
                    <CalcMethod code="C">
                        <CarrierCalcProps>
                            <Length>2</Length>
                            <Width>10</Width>
                            <Height>2.5</Height>
                            <DimUOM>IN</DimUOM>
                            <Weight>4</Weight>
                            <WeightUOM>LBS</WeightUOM>
                            <DeclaredValue>59.95</DeclaredValue>
                            <PackMethod>T</PackMethod>
                        </CarrierCalcProps>
                    </CalcMethod>
                </Item>
                <Item>
                    <RefCode>mouse</RefCode>
                    <Quantity>1</Quantity>
                    <CalcMethod code="C">
                        <CarrierCalcProps>
                            <Length>2</Length>
                            <Width>2</Width>
                            <Height>2.5</Height>
                            <DimUOM>IN</DimUOM>
                            <Weight>.5</Weight>
                            <WeightUOM>LBS</WeightUOM>
                            <DeclaredValue>29.95</DeclaredValue>
                            <PackMethod>T</PackMethod>
                            <OriginCode>CA-WHS</OriginCode>
                        </CarrierCalcProps>
                    </CalcMethod>
                </Item>
            </ItemList>
        </GetItemShipRateXS>
    </Body>
</Envelope>

GetItemShipRate (SS & XS)  Response

ItemShipRate Schema

Element Name

Data Type

Max Size

Version

Description

Currency

xs:string

3

1.0

Currency associated to the monetary elements in the results.

ErrorList

Error Collection


 

The presence of this element indicates that the API call failed and will contain one or more Error Schema datasets that identify the cause of the error(s).  See Appendix A.

ShipRateList

ShipRate Collection


 

A collection of ShipRate elements that represent each carrier service that was rated by method. The data returned varies depending on the Detail Level of the request.

Example of ErrorList Response:

<ErrorList>
    <Error>
        <Code>111</Code>
        <Message>Inadequate destination address information for rating</Message>
        <Severity>CRITICAL</Severity>
    </Error>
</ErrorList>

Example of GetItemShipRate Response (Detail Level = 1):

<?xml version="1.0" encoding="utf-8"?>
<Envelope>
    <Header>
        <Date>2014-04-22 17:31:41 GMT</Date>
    </Header>
    <Body>
        <ItemShipRate>
            <Currency>USD</Currency>
            <ShipRateList>
                <ShipRate>
                    <Valid>true</Valid>
                    <CarrierCode>UPS</CarrierCode>
                    <ServiceCode>UPSGND</ServiceCode>
                    <ServiceName>UPS Ground</ServiceName>
                    <CalcMethod>C</CalcMethod>
                    <Rate>82.62</Rate>
                </ShipRate>
                <ShipRate>
                    <Valid>true</Valid>
                    <CarrierCode>FEDEX</CarrierCode>
                    <ServiceCode>FDXHD</ServiceCode>
                    <ServiceName>FedEx Home Delivery</ServiceName>
                    <CalcMethod>C</CalcMethod>
                    <Rate>125.30</Rate>
                </ShipRate>
                <ShipRate>
                    <Valid>true</Valid>
                    <CarrierCode>USPS</CarrierCode>
                    <ServiceCode>USPPM</ServiceCode>
                    <ServiceName>USPS Priority</ServiceName>
                    <CalcMethod>C</CalcMethod>
                    <Rate>182.73</Rate>
                </ShipRate>
                <ShipRate>
                    <Valid>true</Valid>
                    <CarrierCode>UPS</CarrierCode>
                    <ServiceCode>UPS3DS</ServiceCode>
                    <ServiceName>UPS 3 Day Select</ServiceName>
                    <CalcMethod>C</CalcMethod>
                    <Rate>277.66</Rate>
                </ShipRate>
            </ShipRateList>
        </ItemShipRate>
    </Body>
</Envelope>

Example of GetItemShipRate Response (Detail Level = 2):

<?xml version="1.0" encoding="utf-8"?>
<Envelope>
    <Header>
        <Date>2014-04-22 17:31:41 GMT</Date>
    </Header>
    <Body>
        <ItemShipRate>
            <Currency>USD</Currency>
            <ShipRateList>
                <ShipRate>
                    <Valid>true</Valid>
                    <CarrierCode>UPS</CarrierCode>
                    <ServiceCode>UPSGND</ServiceCode>
                    <ServiceName>UPS Ground</ServiceName>
                    <CalcMethod>C</CalcMethod>
                    <Rate>82.62</Rate>
                    <CarrierRate>63.10</CarrierRate>
                    <Surcharges>8.50</Surcharges>
                    <FuelSurcharges>4.42</FuelSurcharges>
                    <HandlingFees>1.00</HandlingFees>
                    <DeclaredValue>614.90</DeclaredValue>
                    <InsuranceCharges>5.60</InsuranceCharges>
                    <Weight>95.00</Weight>
                    <PackageCount>1</PackageCount>
                </ShipRate>
                <ShipRate>
                    <Valid>true</Valid>
                    <CarrierCode>FEDEX</CarrierCode>
                    <ServiceCode>FDXHD</ServiceCode>
                    <ServiceName>FedEx Home Delivery</ServiceName>
                    <CalcMethod>C</CalcMethod>
                    <Rate>125.30</Rate>
                    <CarrierRate>106.58</CarrierRate>
                    <Surcharges>5.10</Surcharges>
                    <FuelSurcharges>7.82</FuelSurcharges>
                    <HandlingFees>1.00</HandlingFees>
                    <DeclaredValue>614.90</DeclaredValue>
                    <InsuranceCharges>4.80</InsuranceCharges>
                    <Weight>95.00</Weight>
                    <PackageCount>2</PackageCount>
                </ShipRate>
                <ShipRate>
                    <Valid>true</Valid>
                    <CarrierCode>USPS</CarrierCode>
                    <ServiceCode>USPPM</ServiceCode>
                    <ServiceName>USPS Priority</ServiceName>
                    <CalcMethod>C</CalcMethod>
                    <Rate>182.73</Rate>
                    <CarrierRate>171.23</CarrierRate>
                    <Surcharges>0.00</Surcharges>
                    <FuelSurcharges>0.00</FuelSurcharges>
                    <HandlingFees>1.00</HandlingFees>
                    <DeclaredValue>614.90</DeclaredValue>
                    <InsuranceCharges>10.50</InsuranceCharges>
                    <Weight>95.00</Weight>
                    <PackageCount>2</PackageCount>
                    <FlatRateCode>NONE</FlatRateCode>
                </ShipRate>
                <ShipRate>
                    <Valid>true</Valid>
                    <CarrierCode>UPS</CarrierCode>
                    <ServiceCode>UPS3DS</ServiceCode>
                    <ServiceName>UPS 3 Day Select</ServiceName>
                    <CalcMethod>C</CalcMethod>
                    <Rate>277.66</Rate>
                    <CarrierRate>226.95</CarrierRate>
                    <Surcharges>8.50</Surcharges>
                    <FuelSurcharges>22.70</FuelSurcharges>
                    <HandlingFees>13.91</HandlingFees>
                    <DeclaredValue>614.90</DeclaredValue>
                    <InsuranceCharges>5.60</InsuranceCharges>
                    <Weight>95.00</Weight>
                    <PackageCount>1</PackageCount>
                </ShipRate>
            </ShipRateList>
        </ItemShipRate>
    </Body>
</Envelope>

Example of GetItemShipRate Response (Detail Level = 3):

<?xml version="1.0" encoding="utf-8"?>
<Envelope>
    <Header>
        <Date>2014-04-22 17:31:41 GMT</Date>
    </Header>
    <Body>
        <ItemShipRate>
            <Currency>USD</Currency>
            <ShipRateList>
                <ShipRate>
                    <Valid>true</Valid>
                    <CarrierCode>UPS</CarrierCode>
                    <ServiceCode>UPSGND</ServiceCode>
                    <ServiceName>UPS Ground</ServiceName>
                    <CalcMethod>C</CalcMethod>
                    <Rate>82.62</Rate>
                    <CarrierRate>63.10</CarrierRate>
                    <Surcharges>8.50</Surcharges>
                    <FuelSurcharges>4.42</FuelSurcharges>
                    <HandlingFees>1.00</HandlingFees>
                    <DeclaredValue>614.90</DeclaredValue>
                    <InsuranceCharges>5.60</InsuranceCharges>
                    <Weight>95.00</Weight>
                    <PackageCount>1</PackageCount>
                    <PackageDetail>
                        <Package>
                            <Quantity>1</Quantity>
                            <PackMethod>T</PackMethod>
                            <Origin>01609</Origin>
                            <DeclaredValue>614.90</DeclaredValue>
                            <Weight>95</Weight>
                            <Length>22</Length>
                            <Width>14</Width>
                            <Height>8.34</Height>
                            <OversizeCode>NONE</OversizeCode>
                            <CarrierRate>63.10</CarrierRate>
                            <Surcharge>8.50</Surcharge>
                            <FuelSurcharge>4.42</FuelSurcharge>
                            <Insurance>5.60</Insurance>
                            <Handling>0.00</Handling>
                            <ShipRate>81.62</ShipRate>
                            <PkgItem>
                                <RefCode>keyboard-101-e</RefCode>
                                <Qty>2</Qty>
                                <Weight>40.00</Weight>
                            </PkgItem>
                            <PkgItem>
                                <RefCode>lcd-19</RefCode>
                                <Qty>1</Qty>
                                <Weight>15.00</Weight>
                            </PkgItem>
                        </Package>
                    </PackageDetail>
                </ShipRate>
                <ShipRate>
                    <Valid>true</Valid>
                    <CarrierCode>FEDEX</CarrierCode>
                    <ServiceCode>FDXHD</ServiceCode>
                    <ServiceName>FedEx Home Delivery</ServiceName>
                    <CalcMethod>C</CalcMethod>
                    <Rate>125.30</Rate>
                    <CarrierRate>106.58</CarrierRate>
                    <Surcharges>5.10</Surcharges>
                    <FuelSurcharges>7.82</FuelSurcharges>
                    <HandlingFees>1.00</HandlingFees>
                    <DeclaredValue>614.90</DeclaredValue>
                    <InsuranceCharges>4.80</InsuranceCharges>
                    <Weight>95.00</Weight>
                    <PackageCount>2</PackageCount>
                    <PackageDetail>
                        <Package>
                            <Quantity>1</Quantity>
                            <PackMethod>T</PackMethod>
                            <Origin>01609</Origin>
                            <DeclaredValue>554.95</DeclaredValue>
                            <Weight>55</Weight>
                            <Length>22</Length>
                            <Width>14</Width>
                            <Height>6.56</Height>
                            <OversizeCode>NONE</OversizeCode>
                            <SplitCode>SW</SplitCode>
                            <CarrierRate>58.90</CarrierRate>
                            <Surcharge>2.55</Surcharge>
                            <FuelSurcharge>4.30</FuelSurcharge>
                            <Insurance>4.80</Insurance>
                            <Handling>0.00</Handling>
                            <ShipRate>70.55</ShipRate>
                            <PkgItem>
                                <RefCode>keyboard-101-e</RefCode>
                                <Qty>1</Qty>
                                <Weight>40.00</Weight>
                            </PkgItem>
                            <PkgItem>
                                <RefCode>lcd-19</RefCode>
                                <Qty>1</Qty>
                                <Weight>15.00</Weight>
                            </PkgItem>
                        </Package>
                        <Package>
                            <Quantity>1</Quantity>
                            <PackMethod>T</PackMethod>
                            <Origin>01609</Origin>
                            <DeclaredValue>59.95</DeclaredValue>
                            <Weight>40</Weight>
                            <Length>22</Length>
                            <Width>10</Width>
                            <Height>2.5</Height>
                            <OversizeCode>NONE</OversizeCode>
                            <CarrierRate>47.68</CarrierRate>
                            <Surcharge>2.55</Surcharge>
                            <FuelSurcharge>3.52</FuelSurcharge>
                            <Insurance>0.00</Insurance>
                            <Handling>0.00</Handling>
                            <ShipRate>53.75</ShipRate>
                            <PkgItem>
                                <RefCode>keyboard-101-e</RefCode>
                                <Qty>1</Qty>
                                <Weight>40.00</Weight>
                            </PkgItem>
                        </Package>
                    </PackageDetail>
                </ShipRate>
                <ShipRate>
                    <Valid>true</Valid>
                    <CarrierCode>USPS</CarrierCode>
                    <ServiceCode>USPPM</ServiceCode>
                    <ServiceName>USPS Priority</ServiceName>
                    <CalcMethod>C</CalcMethod>
                    <Rate>182.73</Rate>
                    <CarrierRate>171.23</CarrierRate>
                    <Surcharges>0.00</Surcharges>
                    <FuelSurcharges>0.00</FuelSurcharges>
                    <HandlingFees>1.00</HandlingFees>
                    <DeclaredValue>614.90</DeclaredValue>
                    <InsuranceCharges>10.50</InsuranceCharges>
                    <Weight>95.00</Weight>
                    <PackageCount>2</PackageCount>
                    <FlatRateCode>NONE</FlatRateCode>
                    <PackageDetail>
                        <Package>
                            <Quantity>1</Quantity>
                            <PackMethod>T</PackMethod>
                            <Origin>01609</Origin>
                            <DeclaredValue>554.95</DeclaredValue>
                            <Weight>55</Weight>
                            <Length>22</Length>
                            <Width>14</Width>
                            <Height>6.56</Height>
                            <OversizeCode>LargePkg</OversizeCode>
                            <FlatRateCode>NONE</FlatRateCode>
                            <SplitCode>SW</SplitCode>
                            <CarrierRate>93.27</CarrierRate>
                            <Surcharge>0.00</Surcharge>
                            <FuelSurcharge>0.00</FuelSurcharge>
                            <Insurance>8.15</Insurance>
                            <Handling>0.00</Handling>
                            <ShipRate>101.42</ShipRate>
                            <PkgItem>
                                <RefCode>keyboard-101-e</RefCode>
                                <Qty>1</Qty>
                                <Weight>40.00</Weight>
                            </PkgItem>
                            <PkgItem>
                                <RefCode>lcd-19</RefCode>
                                <Qty>1</Qty>
                                <Weight>15.00</Weight>
                            </PkgItem>
                        </Package>
                        <Package>
                            <Quantity>1</Quantity>
                            <PackMethod>T</PackMethod>
                            <Origin>01609</Origin>
                            <DeclaredValue>59.95</DeclaredValue>
                            <Weight>40</Weight>
                            <Length>22</Length>
                            <Width>10</Width>
                            <Height>2.5</Height>
                            <OversizeCode>LargePkg</OversizeCode>
                            <FlatRateCode>NONE</FlatRateCode>
                            <CarrierRate>77.96</CarrierRate>
                            <Surcharge>0.00</Surcharge>
                            <FuelSurcharge>0.00</FuelSurcharge>
                            <Insurance>0.00</Insurance>
                            <Handling>0.00</Handling>
                            <ShipRate>77.96</ShipRate>
                            <PkgItem>
                                <RefCode>keyboard-101-e</RefCode>
                                <Qty>1</Qty>
                                <Weight>40.00</Weight>
                            </PkgItem>
                        </Package>
                    </PackageDetail>
                </ShipRate>
                <ShipRate>
                    <Valid>true</Valid>
                    <CarrierCode>UPS</CarrierCode>
                    <ServiceCode>UPS3DS</ServiceCode>
                    <ServiceName>UPS 3 Day Select</ServiceName>
                    <CalcMethod>C</CalcMethod>
                    <Rate>277.66</Rate>
                    <CarrierRate>226.95</CarrierRate>
                    <Surcharges>8.50</Surcharges>
                    <FuelSurcharges>22.70</FuelSurcharges>
                    <HandlingFees>13.91</HandlingFees>
                    <DeclaredValue>614.90</DeclaredValue>
                    <InsuranceCharges>5.60</InsuranceCharges>
                    <Weight>95.00</Weight>
                    <PackageCount>1</PackageCount>
                    <PackageDetail>
                        <Package>
                            <Quantity>1</Quantity>
                            <PackMethod>T</PackMethod>
                            <Origin>01609</Origin>
                            <DeclaredValue>614.90</DeclaredValue>
                            <Weight>95</Weight>
                            <Length>22</Length>
                            <Width>14</Width>
                            <Height>8.34</Height>
                            <OversizeCode>NONE</OversizeCode>
                            <CarrierRate>226.95</CarrierRate>
                            <Surcharge>8.50</Surcharge>
                            <FuelSurcharge>22.70</FuelSurcharge>
                            <Insurance>gt;5.60</Insurance>
                            <Handling>12.91</Handling>
                            <ShipRate>276.66</ShipRate>
                            <PkgItem>
                                <RefCode>keyboard-101-e</RefCode>
                                <Qty>2</Qty>
                                <Weight>40.00</Weight>
                            </PkgItem>
                            <PkgItem>
                                <RefCode>lcd-19</RefCode>
                                <Qty>1</Qty>
                                <Weight>15.00</Weight>
                            </PkgItem>
                        </Package>
                    </PackageDetail>
                </ShipRate>
            </ShipRateList>
        </ItemShipRate>
    </Body>
</Envelope>

Version History

As we have made great effort to make API enhancements backwards compatible, versioning has not been strictly enforced and primarily serves as an upgrade history.
 

Version

Date

Description

1.0

2006

Initial release.

2.0

2007

- OnDemand services (CarrierCalcProps, Service schema for XS calls)
- SpecialServices (CarrierCalcProps)
- OriginCode (CarrierCalcProps)
- SuppHandlingFee & SuppHandlingCode (CarrierCalcProps)
- FeeCode (FixedCalcProps)
- DetailLevel 2 (ShipRateResponse)

2.1

2008

- FlatRatePackaging (Carrier schema for XS calls)
- FlatRateCode (ShipRateResponse, DetailLevel 2)
- PkgMaxWeight (Service schema for XS calls)
- OriginCode (FixedCalcProps, XS calls)
- DetailLevel 3 (ShipRateResponse)

2.2

Oct 2011

- FixedRate (ShipRateResponse, DetailLevel 2)
- CarrierService (ShipRateResponse, DetailLevel 3)

2.3

Sept 2012

- PkgMaxLength/Width/Height (Service schema for XS calls)
- SplitCode (ShipRateResponse, Package schema: version required)

2.4

March 2015

- AcctCountryCode (Carrier schema for XS calls, DHL account data)