AuctionInc Shipping Rates API 
API Appendix

Error Codes
Service Classes
Carrier Codes
Carrier Service Codes
Carrier Entry Points
Country Codes
Split Codes


A. Error Codes

Code

Severity

Description

111

Critical

Inadequate destination address information for rating

500

Critical

Invalid or expired Account Id or Integrator Id

501

Critical

Unsupported HTTP method used, only POST is supported

502

Critical

Invalid URL specified in request

505

Critical

Unexpected Error

510

Critical

Missing, malformed or invalid XML data provided

511

Critical

Unknown Web Service Method Specified

512

Critical

Unsupported Compatibility Level specified for method

513

Critical

XS method Not Supported

550

Critical

Service is down for maintenance

560

Critical

Invalid Account Id

561

Critical

Inactive Account Id

710

Notice

Item or Package exceeds carrier service maximum weight



B. Service Classes

The ServiceClass element is used to restrict shipping rates to a particular class of service (future enhancement).

Service Class

Description

1

Next Day Air service

2

2nd Day Air service

3

3 Day services

4

Air Standard

5

Surface Standard

G

Ground



C. Carrier Codes

Code

Carrier Name

DHL

DHL

FEDEX

Federal Express

UPS

United Parcel Service

USPS

United States Postal Service

PU

Pickup at Seller's Location (ShipRate Response only, SS calls)

DELV

Local Delivery (ShipRate Response only, SS calls)

FF

Fixed Fee (ShipRate Response only)

FS

Free Shipping (ShipRate Response only, SS calls)

MF

Mixed Fee (ShipRate Response only)

NOCHG

No Charge (ShipRate Response only)



D. Carrier Service Codes

Carrier Code

Service Code

Service Name

Service Class

DHL

DHLES

Domestic Economy Select 

G

 

DHLEXA

Domestic Express 9 AM 

1

 

DHLEXM

Domestic Express 10:30 AM 

1

 

DHLEXP

Domestic Express 12 PM 

1

 

DHLDE

Domestic Express (6 PM) 

1

 

International

 

DHLWPE

Worldwide Priority Express 

3

 

DHL9AM

Express 9 A.M.

1

 

DHL10AM

Express 10:30 A.M.

1

 

DHL12PM

Express 12 P.M.

1

FEDEX

FDX2D

2 Day

2

 

FDX2DAM

2 Day AM

2

 

FDXES

Express Saver

3

 

FDXFO

First Overnight

1

 

FDXPO

Priority Overnight

1

 

FDXPOS

Priority Overnight Saturday Delivery

1

 

FDXSO

Standard Overnight

1

 

FDXGND

Ground

G

 

FDXHD

Home Delivery

G

 

International

 

 

FDXIGND

International Ground

5

 

FDXIE

International Economy

4

 

FDXIF

International First

2

 

FDXIP

International Priority

3

UPS

UPSNDA

Next Day Air

1

 

UPSNDE

Next Day Air Early AM

1

 

UPSNDAS

Next Day Air Saturday Delivery

1

 

UPSNDS

Next Day Air Saver

1


UPS2DE

2 Day Air AM
(commercial destinations only)

2

 

UPS2ND

2nd Day Air

2

 

UPS3DS

3 Day Select

3

 

UPSGND

Ground

G


International



UPSCAN

Standard

5


UPSWEX

Worldwide Express

2


UPSWSV

Worldwide Saver

3


UPSWEP

Worldwide Expedited

4

USPS

USPFC

First-Class Mail

G

 

USPEXP

Priority Express (1/2)-Day

1


USPBPM

Bound/Printed-- Inactive
(retired 12-31-2010)

G

 

USPLIB

Library

G

 

USPMM

Media Mail

G

 

USPPM

Priority (1/2/3)-Day

2

 

USPPP

Retail Ground (renamed from Standard Post)

G


International

 

 

USPFCI

First Class International

5

 

USPPMI

Priority Mail International

3

 

USPEMI

Priority Express Mail International

2

 

USPGXG

Global Express Guaranteed

1

PU

PU

Pickup at Seller's Location
(ShipRate Response only, SS calls) 


DELV

DELV

Local Delivery
(ShipRate Response only, SS calls) 


FF

FIXEDFEE

Fixed Fee
(ShipRate Response only) 


FS

FS

Free Shipping
(ShipRate Response only, SS calls) 
(based on Shipping Promotions)


MF

MIXED

Mixed Service Rate
(ShipRate Response only) 


NOCHG

NOCHG

No Charge
(ShipRate Response only) 
(CalcMethod = "N" for all items)




E. Carrier Entry Point Codes

The Carrier Entry Points indicate the method that packages are received by the carriers. Carriers charge various fees
based on the method and certain carrier rates fluctuate as well. Using the proper Entry Point is critical to determining
the correct shipping rates.

Carrier Code

Entry Point Code

Description

DHL

D

Drop Off

P

Daily Pickup

T1

One Time Pickup / Web

T2

One Time Pickup /  Phone

FEDEX

B

Business Service Center

C1

Request Courier Same Day Phone

C2

Request Courier Future Day Phone

C3

Request Courier Same Day Electronic

C4

Request Courier Future Day Electronic

D

Drop Box

R

Regular Pickup

S

Station

UPS

D

Drop-off

O5

On Call/Pickup Residential Same Day
["O" is alpha, not numeric]

O6

On Call/Pickup Residential Future Day
["O" is alpha, not numeric]

O7

On Call/Pickup Commercial Same Day
["O" is alpha, not numeric]

O8

On Call/Pickup Commerical Future Day
["O" is alpha, not numeric]

P

Daily Pickup
(UPS Account started before 01-02-11)

Q

Daily Pickup
(UPS Account started after 01-02-11)
(ie, "Standard" rates)

R

Retail Location

USPS

R

Retail Rates

C

Commercial Base Rates (When Available)
(returns retail rate for any requested services not eligible for commercial base rate)

O

Commercial Base Rates Only
(will not return services that are not eligible for commercial base rate)

P

Commercial Plus Rates



F. Country Codes

The two character country codes are based on the two character ISO 3166 Code List.

Country Name

Code

Afghanistan AF
Albania AL
Algeria DZ
American Samoa AS
andorra AD
Angola AO
Anguilla AI
Antarctica AQ
Antigua and Barbuda AG
Argentina AR
Armenia AM
Aruba AW
Ascension AC
Australia AU
Austria AT
Azerbaijan AZ
Bahamas BS
Bahrain BH
Bangladesh BD
Barbados BB
Belarus BY
Belgium BE
Belize BZ
Benin BJ
Bermuda BM
Bhutan BT
Bolivia BO
Bonaire BQ
Bosnia-Herzegowina BA
Botswana BW
Bouvet Island BV
Brazil BR
British Indian Ocean Territory IO
Brunei Darussalam BN
Bulgaria BG
Burkina Faso BF
Burundi BI
Cambodia KH
Cameroon CM
Canada CA
Cape Verde CV
Cayman Islands KY
Central African Republic CF
Chad TD
Chile CL
China CN
Christmas Island (Australia) CX
Cocos Island CC
Colombia CO
Comoros KM
Democratic Republic of the Congo CD
Cook Islands CK
Costa Rica CR
Cote D'ivoire CI
Croatia HR
Cuba CU
Curacao CW
Cyprus CY
Czech Republic CZ
Denmark DK
Djibouti DJ
Dominica DM
Dominican Republic DO
Ecuador EC
Egypt EG
El Salvador SV
Equatorial Guinea GQ
Eritrea ER
Estonia EE
Ethiopia ET
Falkland Islands FK
Faroe Islands FO
Fiji FJ
Finland FI
France FR
French Guiana GF
French Polynesia PF
Gabon GA
Gambia GM
Georgia, Republic of GE
Germany DE
Ghana GH
Gibraltar GI
Great Britain & Northern Ireland GB
Greece GR
Greenland GL
Grenada GD
Guadeloupe GP
Guam GU
Guatemala GT
Guinea GN
Guinea-bissau GW
Guernsey GG
Guyana GY
Haiti HT
Heard and Mc Donald Islands HM
Honduras HN
Hong Kong HK
Hungary HU
Iceland IS
India IN
Indonesia ID
Iran IR
Iraq IQ
Ireland IE
Israel IL
Italy IT
Jamaica JM
Japan JP
Jordan JO
Kazakhstan KZ
Kenya KE
Kiribati KI
Korea, Democratic Peoples Republic of (North Korea) KP
Korea, Republic of (South Korea) KR
Kuwait KW
Kyrgyzstan KG
Lao People's Democratic Republic LA
Latvia LV
Lebanon LB
Lesotho LS
Liberia LR
Libya LY
Liechtenstein LI
Lithuania LT
Luxembourg LU
Macau MO
Macedonia, Republic of MK
Madagascar MG
Malawi MW
Malaysia MY
Maldives MV
Mali ML
Malta MT
Marshall Islands MH
Martinique MQ
Mauritania MR
Mauritius MU
Mayotte YT
Mexico MX
Micronesia, Federated States Of FM
Moldova MD
Monaco MC
Mongolia MN
Montenegro ME
Montserrat MS
Morocco MA
Mozambique MZ
Myanmar MM
Namibia NA
Nauru NR
Nepal NP
Netherlands NL
New Caledonia NC
New Zealand NZ
Nicaragua NI
Niger NE
Nigeria NG
Niue NU
Norfolk Island NF
Northern Mariana Islands MP
Norway NO
Oman OM
Pakistan PK
Palau PW
Panama PA
Papua New Guinea PG
Paraguay PY
Peru PE
Philippines PH
Pitcairn Island PN
Poland PL
Portugal PT
Puerto Rico PR
Qatar QA
Reunion RE
Romania RO
Russia RU
Rwanda RW
Saint Christopher (St. Kitts) and Nevis KN
Saint Lucia LC
St. Martin & Sint Maarten SX
Saint Vincent and The Grenadines VC
Samoa WS
San Marino SM
Sao Tome and Principe ST
Saudi Arabia SA
Senegal SN
Serbia RS
Seychelles SC
Sierra Leone SL
Singapore SG
Slovak Republic SK
Slovenia SI
Solomon Islands SB
Somalia SO
South Africa ZA
South Georgia GS
Spain ES
Sri Lanka LK
Saint Helena SH
Saint Pierre and Miquelon PM
Sudan SD
Suriname SR
Svalbard and Jan Mayen Islands SJ
Swaziland SZ
Sweden SE
Switzerland CH
Syrian Arab Republic SY
Taiwan TW
Tajikistan TJ
Tanzania TZ
Thailand TH
Timor Leste TL
Togo TG
Tokelau TK
Tonga TO
Trinidad and Tobago TT
Tristan da Cunha TA
Tunisia TN
Turkey TR
Turkmenistan TM
Turks and Caicos Islands TC
Tuvalu TV
Uganda UG
Ukraine UA
United Arab Emirates AE
United States US
Uruguay UY
Uzbekistan UZ
Vanuatu VU
Vatican City VA
Venezuela VE
Vietnam VN
Virgin Islands (british) VG
Virgin Islands (u.s.) VI
Wallis and Futuna Islands WF
Western Sahara EH
Yemen YE
Zambia ZM
Zimbabwe ZW


G. Split Codes

Code

Description

SW Service Maximum Weight as established by carrier
SV Service Maximum Volume as established by carrier
CW Configured Maximum Weight as set by seller in API(PkgMaxWeight)
CV Configured Maximum Volume as set by seller in API
(PkgMaxLength * PkgMaxWidth * PkgMaxHeight)
CD Configured Maximum Dimension as set by seller in API
(PkgMaxLength or PkgMaxWidth or PkgMaxHeight)