USPSRates Component

Properties   Methods   Events   Configuration Settings   Errors  

Determines domestic and international postage rates based on weight, size, class of mail, and origin/destination information.

Syntax

nsoftware.InShip.Uspsrates

Remarks

This component provides automated online access to domestic and international rate information. These domestic rates are for: Express Mail, First-Class Mail, and Priority Mail, as well as single-piece rates for all four Package Services: Parcel Post, Bound Printed Matter, Library Mail, and Media Mail. The international rates are for International Priority Mail, International Express Mail (EMS), and International First Class Mail, along with service standards for each class of service.

To use this component to receive rate information for domestic shipments, simply set the Weight, ZipCode, ZipCode, and Size. Then simply call GetRates.

You may also optionally supply dimensions of the package with Length, Width, and Height, and filter the results returned by ServiceType and PackagingType.

In response to this request, the USPS Server will return a list of postage services available for mailing your package. You can access these services through the ListNetCharge, ServiceType, and ServiceTypeDescription fields. The number of PostalZones between the ZipCode and ZipCode will also be returned, along with any Restrictions for mailing to APO/FPO addresses.

To use this component to receive rate information for international shipments, simply set the Weight, PackagingType, and CountryCode, and then call GetRates.

For International rates, the following properties may be returned:

• ServiceType
• ServiceTypeDescription
• Commitments
• MaxDimensions
• MaxWeight
• ListNetCharge
• InsuranceCost
• InsuranceComment
• IndemnityCoverage

Please note that in most cases international packages may need a Customs Declaration form, and packages may also be subject to mailing restrictions unique to the destination country. To assist you with this important information, the International Rates component will return all the necessary mailing Restrictions, Prohibitions, and Observations, names of required CustomsForms, as well as delivery AreasServed.

To use this component, you must have a USPS account. You should also have already obtained a UserId and Password uniquely assigned to your account by USPS.

This component also includes Endicia support to obtain rates through their web services. To use this service, you must have an Endicia AccountNumber. You should also have already obtained a UserId and Password uniquely assigned to your account by Endicia. The PostageProvider property must be set to ppEndicia to tell the component to use the Endicia protocol.