GeteBayDetails returns CustomCode for the new USPS shipping services

GeteBayDetails is returning CustomCode for the new USPS shipping services. Why is this happening?

Summary

If you make a call to GeteBayDetails with a version of 455 or less, you will get back CustomCode for the new USPS shipping services.  Till 455, the shipping services were a code type and from 457 onwards it was converted to token (essentially string).  In order to maintain backwards compatibility with applications that are on older versions, the new shipping services are returned as CustomCode, so that applications that are still using the old code type do not break.  In order to get the new shipping services, you need to make the call to GeteBayDetails with version 457 or higher. 
 

<?xml version="1.0" encoding="utf-8"?>

<GeteBayDetailsRequest xmlns="urn:ebay:apis:eBLBaseComponents">

  <Version>511</Version>

  <RequesterCredentials>

    <eBayAuthToken>*****</eBayAuthToken>

  </RequesterCredentials>

  <DetailName>ShippingServiceDetails</DetailName>

</GeteBayDetailsRequest>

This is the response with the new shipping services:

<?xml version="1.0" encoding="utf-8"?>

<GeteBayDetailsResponse xmlns="urn:ebay:apis:eBLBaseComponents">

  <Timestamp>2007-05-09T21:47:11.485Z</Timestamp>

  <Ack>Success</Ack>

  <Version>511</Version>

  <Build>e511_core_Bundled_4606190_R1</Build>

  <ShippingServiceDetails>

    <Description>US Postal Service Priority Mail</Description>

    <ShippingService>USPSPriority</ShippingService>

    <ShippingServiceID>7</ShippingServiceID>

    <ShippingTimeMax>3</ShippingTimeMax>

    <ShippingTimeMin>2</ShippingTimeMin>

  </ShippingServiceDetails>

  <ShippingServiceDetails>

    <Description>US Postal Service Express Mail</Description>

    <ExpeditedService>true</ExpeditedService>

    <ShippingService>USPSExpressMail</ShippingService>

    <ShippingServiceID>11</ShippingServiceID>

    <ShippingTimeMax>1</ShippingTimeMax>

    <ShippingTimeMin>0</ShippingTimeMin>

  </ShippingServiceDetails>

  <ShippingServiceDetails>

    <Description>US Postal Service Parcel Post</Description>

    <ShippingService>USPSParcel</ShippingService>

    <ShippingServiceID>8</ShippingServiceID>

    <ShippingTimeMax>9</ShippingTimeMax>

    <ShippingTimeMin>2</ShippingTimeMin>

  </ShippingServiceDetails>

  <ShippingServiceDetails>

    <Description>US Postal Service Media Mail</Description>

    <ShippingService>USPSMedia</ShippingService>

    <ShippingServiceID>9</ShippingServiceID>

    <ShippingTimeMax>9</ShippingTimeMax>

    <ShippingTimeMin>2</ShippingTimeMin>

  </ShippingServiceDetails>

  <ShippingServiceDetails>

    <Description>US Postal Service First Class Mail</Description>

    <ShippingService>USPSFirstClass</ShippingService>

    <ShippingServiceID>10</ShippingServiceID>

    <ShippingTimeMax>5</ShippingTimeMax>

    <ShippingTimeMin>2</ShippingTimeMin>

  </ShippingServiceDetails>

  <ShippingServiceDetails>

    <Description>UPS Ground</Description>

    <ShippingService>UPSGround</ShippingService>

    <ShippingServiceID>3</ShippingServiceID>

    <ShippingTimeMax>6</ShippingTimeMax>

    <ShippingTimeMin>1</ShippingTimeMin>

  </ShippingServiceDetails>

  <ShippingServiceDetails>

    <Description>UPS 3 Day Select</Description>

    <ShippingService>UPS3rdDay</ShippingService>

    <ShippingServiceID>4</ShippingServiceID>

    <ShippingTimeMax>3</ShippingTimeMax>

    <ShippingTimeMin>1</ShippingTimeMin>

  </ShippingServiceDetails>

  <ShippingServiceDetails>

    <Description>UPS 2nd Day Air</Description>

    <ShippingService>UPS2ndDay</ShippingService>

    <ShippingServiceID>5</ShippingServiceID>

    <ShippingTimeMax>2</ShippingTimeMax>

    <ShippingTimeMin>1</ShippingTimeMin>

  </ShippingServiceDetails>

  <ShippingServiceDetails>

    <Description>UPS Next Day Air Saver</Description>

    <ExpeditedService>true</ExpeditedService>

    <ShippingService>UPSNextDay</ShippingService>

    <ShippingServiceID>6</ShippingServiceID>

    <ShippingTimeMax>1</ShippingTimeMax>

    <ShippingTimeMin>1</ShippingTimeMin>

  </ShippingServiceDetails>

  <ShippingServiceDetails>

    <Description>UPS Next Day Air</Description>

    <ExpeditedService>true</ExpeditedService>

    <ShippingService>UPSNextDayAir</ShippingService>

    <ShippingServiceID>12</ShippingServiceID>

    <ShippingTimeMax>1</ShippingTimeMax>

    <ShippingTimeMin>1</ShippingTimeMin>

  </ShippingServiceDetails>

  <ShippingServiceDetails>

    <Description>Standard Flat Rate Shipping Service</Description>

    <ShippingService>ShippingMethodStandard</ShippingService>

    <ShippingServiceID>1</ShippingServiceID>

  </ShippingServiceDetails>

  <ShippingServiceDetails>

    <Description>Expedited Flat Rate Shipping Service</Description>

    <ShippingService>ShippingMethodExpress</ShippingService>

    <ShippingServiceID>2</ShippingServiceID>

  </ShippingServiceDetails>

  <ShippingServiceDetails>

    <Description>Overnight Flat Rate Shipping Service</Description>

    <ExpeditedService>true</ExpeditedService>

    <ShippingService>ShippingMethodOvernight</ShippingService>

    <ShippingServiceID>18</ShippingServiceID>

    <ShippingTimeMax>1</ShippingTimeMax>

    <ShippingTimeMin>1</ShippingTimeMin>

  </ShippingServiceDetails>

  <ShippingServiceDetails>

    <Description>Other (see description)</Description>

    <ShippingService>Other</ShippingService>

    <ShippingServiceID>14</ShippingServiceID>

  </ShippingServiceDetails>

  <ShippingServiceDetails>

    <Description>Local Delivery/Pickup</Description>

    <ShippingService>LocalDelivery</ShippingService>

    <ShippingServiceID>15</ShippingServiceID>

  </ShippingServiceDetails>

  <ShippingServiceDetails>

    <Description>USPS Global Express Mail</Description>

    <InternationalService>true</InternationalService>

    <ShippingService>USPSGlobalExpress</ShippingService>

    <ShippingServiceID>50003</ShippingServiceID>

    <ShippingTimeMax>5</ShippingTimeMax>

    <ShippingTimeMin>3</ShippingTimeMin>

  </ShippingServiceDetails>

  <ShippingServiceDetails>

    <Description>USPS Global Priority Mail</Description>

    <InternationalService>true</InternationalService>

    <ShippingService>USPSGlobalPriority</ShippingService>

    <ShippingServiceID>50005</ShippingServiceID>

    <ShippingTimeMax>6</ShippingTimeMax>

    <ShippingTimeMin>4</ShippingTimeMin>

  </ShippingServiceDetails>

  <ShippingServiceDetails>

    <Description>USPS Economy Letter Post</Description>

    <InternationalService>true</InternationalService>

    <ShippingService>USPSEconomyLetter</ShippingService>

    <ShippingServiceID>50007</ShippingServiceID>

    <ShippingTimeMax>42</ShippingTimeMax>

    <ShippingTimeMin>28</ShippingTimeMin>

  </ShippingServiceDetails>

  <ShippingServiceDetails>

    <Description>USPS Economy Parcel Post</Description>

    <InternationalService>true</InternationalService>

    <ShippingService>USPSEconomyParcel</ShippingService>

    <ShippingServiceID>50006</ShippingServiceID>

    <ShippingTimeMax>42</ShippingTimeMax>

    <ShippingTimeMin>28</ShippingTimeMin>

  </ShippingServiceDetails>

  <ShippingServiceDetails>

    <Description>USPS Airmail Letter Post</Description>

    <InternationalService>true</InternationalService>

    <ShippingService>USPSAirmailLetter</ShippingService>

    <ShippingServiceID>50008</ShippingServiceID>

    <ShippingTimeMax>10</ShippingTimeMax>

    <ShippingTimeMin>4</ShippingTimeMin>

  </ShippingServiceDetails>

  <ShippingServiceDetails>

    <Description>USPS Airmail Parcel Post</Description>

    <InternationalService>true</InternationalService>

    <ShippingService>USPSAirmailParcel</ShippingService>

    <ShippingServiceID>50009</ShippingServiceID>

    <ShippingTimeMax>10</ShippingTimeMax>

    <ShippingTimeMin>4</ShippingTimeMin>

  </ShippingServiceDetails>

  <ShippingServiceDetails>

    <Description>UPS Worldwide Express Plus</Description>

    <InternationalService>true</InternationalService>

    <ShippingService>UPSWorldWideExpressPlus</ShippingService>

    <ShippingServiceID>50010</ShippingServiceID>

    <ShippingTimeMax>2</ShippingTimeMax>

    <ShippingTimeMin>1</ShippingTimeMin>

  </ShippingServiceDetails>

  <ShippingServiceDetails>

    <Description>UPS Worldwide Express</Description>

    <InternationalService>true</InternationalService>

    <ShippingService>UPSWorldWideExpress</ShippingService>

    <ShippingServiceID>50011</ShippingServiceID>

    <ShippingTimeMax>2</ShippingTimeMax>

    <ShippingTimeMin>1</ShippingTimeMin>

  </ShippingServiceDetails>

  <ShippingServiceDetails>

    <Description>UPS Worldwide Expedited</Description>

    <InternationalService>true</InternationalService>

    <ShippingService>UPSWorldWideExpedited</ShippingService>

    <ShippingServiceID>50012</ShippingServiceID>

    <ShippingTimeMax>5</ShippingTimeMax>

    <ShippingTimeMin>2</ShippingTimeMin>

  </ShippingServiceDetails>

  <ShippingServiceDetails>

    <Description>UPS Standard To Canada</Description>

    <InternationalService>true</InternationalService>

    <ShippingService>UPSStandardToCanada</ShippingService>

    <ShippingServiceID>50013</ShippingServiceID>

  </ShippingServiceDetails>

  <ShippingServiceDetails>

    <Description>Standard Int'l Flat Rate Shipping</Description>

    <InternationalService>true</InternationalService>

    <ShippingService>StandardInternational</ShippingService>

    <ShippingServiceID>50001</ShippingServiceID>

  </ShippingServiceDetails>

  <ShippingServiceDetails>

    <Description>Expedited Int'l Flat Rate Shipping</Description>

    <InternationalService>true</InternationalService>

    <ShippingService>ExpeditedInternational</ShippingService>

    <ShippingServiceID>50002</ShippingServiceID>

  </ShippingServiceDetails>

  <ShippingServiceDetails>

    <Description>Other Int'l Shipping (see description)</Description>

    <InternationalService>true</InternationalService>

    <ShippingService>OtherInternational</ShippingService>

    <ShippingServiceID>50014</ShippingServiceID>

  </ShippingServiceDetails>

  <ShippingServiceDetails>

    <Description>USPS First Class Mail International</Description>

    <InternationalService>true</InternationalService>

    <ShippingService>USPSFirstClassMailInternational</ShippingService>

    <ShippingServiceID>50022</ShippingServiceID>

  </ShippingServiceDetails>

  <ShippingServiceDetails>

    <Description>USPS Priority Mail International</Description>

    <InternationalService>true</InternationalService>

    <ShippingService>USPSPriorityMailInternational</ShippingService>

    <ShippingServiceID>50023</ShippingServiceID>

  </ShippingServiceDetails>

  <ShippingServiceDetails>

    <Description>USPS Express Mail International</Description>

    <InternationalService>true</InternationalService>

    <ShippingService>USPSExpressMailInternational</ShippingService>

    <ShippingServiceID>50024</ShippingServiceID>

  </ShippingServiceDetails>

</GeteBayDetailsResponse>

Version Info

The code example above was based on the versions specified below:

• Documentation:     GeteBayDetails
• Knowledge Base:  Error 2191224 - Shipping Service will be no longer available after May 6, 2007
  

How well did this answer your question?

Answers others found helpful

• RestockingFeeValueOption and Return Preferences
• Error: eBay does not understand the Picture URL that you provided.
• Implementing Compression for the Trading API : When and How
• Improper Words error
• Does the Windows SDK support UTF-8?