FedExAddress Control

Properties   Methods   Events   Config Settings   Errors  

Allows you to validate or complete recipient addresses.

Syntax

FedExAddress

Remarks

Via this control you can perform the following:

• Complete incomplete recipient addresses.
• Correct invalid recipient addresses.
• Determine whether an address is business or residential to increase the accuracy of courtesy rate quotes. This applies to U.S. and Canada addresses only.
• Confirm the validity and completeness of addresses in many countries in these regions: U.S., Canada, Latin America, Europe, the Middle East, and Asia Pacific.
• Provide street level matches.
• Find information on the nearest FedEx location(s).

Having correct addresses on the shipping labels will eliminate delivery delays and additional service fees (occurring when a shipment is re-routed).

For address verification, use the ValidateAddress method. This provides street level matches, but it does not currently verify suite or apartment numbers. It checks if the street exists in the city and state/province or postal code entered, and if the street number is within a valid range for the street entered. Upon successful reply, it either provides an exact match or possible alternatives (multiple address results) when an exact match cannot be found based on the input values, or informs you if no possible alternatives can be found.

For U.S. addresses, the following information is the minimum required to check an address:

• Street Address
• City and State/Province or Postal Code

To search for the nearest FedEx location(s), use the FindLocations method. You can search by address, geographic coordinates, or phone number.

To narrow down the search, you can specify the type of locations you are looking for (such as Authorized Ship Center, FedEx Self-Service, FedEx Staffed and/or) and any special service those locations offer (such as Accepts Cash, Saturday service, Packaging supplies, Latest Express drop-off, etc.).

If the request completes successfully, FedEx server will return a set of matches that satisfies the search criteria. You will be able to retrieve FedEx location Ids, addresses, available services they offer, operations hours on weekdays and/or weekends.

The set of locations retrieved is limited to a maximum of ten locations returned within a 50-mile radius.

To use this control, you must have an FedExAuthorizationToken, which is used to authorize your application API requests with FedEx resources.

You can obtain the FedExAuthorizationToken using the OAuth component. You'll need to provide the Client ID and Client Secret, which you can get from FedEx when you create your Project on the FedEx Developer portal.

FedEx allows this service to be used in production environment only after passing the certification. Customers need to be certified first in order to have the Advanced (such as Address Validation) services activated. After the certification is granted, you will receive the production credentials. Once they move to production, Address Validation is a feature that has to be activated upon the customer's request.

Property List

The following is the full list of the properties of the control with short descriptions. Click on the links for further details.

Method List

The following is the full list of the methods of the control with short descriptions. Click on the links for further details.

Event List

The following is the full list of the events fired by the control with short descriptions. Click on the links for further details.

Config Settings

The following is a list of config settings for the control with short descriptions. Click on the links for further details.

Address1 Property (FedExAddress Control)

Street name.

Syntax

fedexaddresscontrol.Address1[=string]

Default Value

""

Remarks

Street name. In a ship request, this is required to be provided for both sender and recipient. In all other requests, it is required for a valid physical address. For UPS Address1 should not exceed 35 characters.

Data Type

String

Address2 Property (FedExAddress Control)

A specific detail on the address (such as building, suite, apartment, floor number etc.

Syntax

fedexaddresscontrol.Address2[=string]

Default Value

""

Remarks

A specific detail on the address (such as building, suite, apartment, floor number etc.). This is optional. For UPS Address2 should not exceed 35 characters.

Data Type

String

AddressFlags Property (FedExAddress Control)

Various flags that denote information about the address.

Syntax

fedexaddresscontrol.AddressFlags[=integer]

Default Value

0

Remarks

Various flags that denote information about the address.

Data Type

Integer

City Property (FedExAddress Control)

Name of city, town, etc.

Syntax

fedexaddresscontrol.City[=string]

Default Value

""

Remarks

Name of city, town, etc. In a ship request, this is required to be provided for both sender and recipient.

Data Type

String

CountryCode Property (FedExAddress Control)

Country code.

Syntax

fedexaddresscontrol.CountryCode[=string]

Default Value

"US"

Remarks

Country code. This identifies a country. In a ship request, this is required to be provided for both sender and recipient. Maximum length: 2.

Here is a list of country names and their codes. Code is the value that has to be provided in all requests sent where country code is to be entered. Note that with USPS you can also specify the full country name here.

* Not supported by USPS

** Has multiple values, the values used for USPS are below

Data Type

String

State Property (FedExAddress Control)

State or province code.

Syntax

fedexaddresscontrol.State[=string]

Default Value

""

Remarks

State or province code. This is the identifying abbreviation for US state, Canada province, etc. In a ship request, this is required to be provided for both sender and recipient (where applicable). Format and presence of this field will vary, depending on country.

Data Type

String

ZipCode Property (FedExAddress Control)

Postal code.

Syntax

fedexaddresscontrol.ZipCode[=string]

Default Value

""

Remarks

Postal code. This is identification of a region (usually small) for mail/package delivery. Format and presence of this field will vary, depending on country.

In a ship request, this is required to be provided for both sender and recipient. In all other requests, this element is required if both City and State are not present.

Valid characters: A-Z; 0-9; a-z. Maximum length: 16.

Data Type

String

Company Property (FedExAddress Control)

Name of the company that resides at the address to be validated.

Syntax

fedexaddresscontrol.Company[=string]

Default Value

""

Remarks

To narrow down the search for address candidates, you can include the Company in the address validation request (when the ValidateAddress is called). Providing a company name may improve your results since some addresses have specific company names assigned to them.

Data Type

String

ConstraintFilters Property (FedExAddress Control)

The following flags are defined (specified in hexadecimal notation).

Syntax

fedexaddresscontrol.ConstraintFilters[=integer]

Default Value

0

Remarks

The following flags are defined (specified in hexadecimal notation). They can be or-ed together to include multiple filters:

Data Type

Integer

ConstraintLocationAttributes Property (FedExAddress Control)

This indicates the services you would like to search for at a particular location.

Syntax

fedexaddresscontrol.ConstraintLocationAttributes[=integer]

Default Value

0

Remarks

This indicates the services you would like to search for at a particular location.

The following flags are defined (specified in hexadecimal notation). They can be or-ed together to include multiple attributes:

Data Type

Integer

ConstraintLocationContentOptions Property (FedExAddress Control)

This sets what content you would like to have returned with the location data.

Syntax

fedexaddresscontrol.ConstraintLocationContentOptions[=integer]

Default Value

0

Remarks

This sets what content you would like to have returned with the location data.

The following flags are defined (specified in hexadecimal notation). They can be or-ed together to include multiple attributes:

Data Type

Integer

ConstraintLocationTypeFlags Property (FedExAddress Control)

This indicates the type(s) of FedEx location you would like to search for.

Syntax

fedexaddresscontrol.ConstraintLocationTypeFlags[=integer]

Default Value

0

Remarks

This indicates the type(s) of FedEx location you would like to search for.

The following flags are defined (specified in hexadecimal notation). They can be or-ed together to include multiple location types:

Data Type

Integer

ConstraintRedirectToHoldType Property (FedExAddress Control)

Specify the type of service supported by a FedEx location for redirect to hold.

Syntax

fedexaddresscontrol.ConstraintRedirectToHoldType[=integer]

Default Value

0

Remarks

Specify the type of service supported by a FedEx location for redirect to hold.

Possible values are:

Data Type

Integer

ConstraintResultsRequested Property (FedExAddress Control)

The number of results requested.

Syntax

fedexaddresscontrol.ConstraintResultsRequested[=integer]

Default Value

1

Remarks

The number of results requested.

Data Type

Integer

ConstraintResultsToSkip Property (FedExAddress Control)

The number of results to skip.

Syntax

fedexaddresscontrol.ConstraintResultsToSkip[=integer]

Default Value

0

Remarks

The number of results to skip.

Data Type

Integer

ConstraintSearchRadius Property (FedExAddress Control)

This contains the search radius to be used when FindLocations is called.

Syntax

fedexaddresscontrol.ConstraintSearchRadius[=string]

Default Value

""

Remarks

This contains the search radius to be used when FindLocations is called.

Data Type

String

FedExAccountNumber Property (FedExAddress Control)

The account number associated with the shipment.

Syntax

fedexaddresscontrol.FedExAccountNumber[=string]

Default Value

""

Remarks

The account number associated with the shipment.

The FedExAccountNumber is not to be shared with others outside your organization, nor is it to be packaged, distributed, or sold to any other person or entity.

Data Type

String

FedExAuthorizationToken Property (FedExAddress Control)

Authorization Token used to authenticate the request.

Syntax

fedexaddresscontrol.FedExAuthorizationToken[=string]

Default Value

""

Remarks

Authorization Token used to authenticate the request.

This field should be set to the value of a bearer token obtained through OAuth 2.0. For more information on getting a bearer token, see the documentation for the OAuth component.

Data Type

String

FedExLanguageCode Property (FedExAddress Control)

Two-letter code for the language (e.

Syntax

fedexaddresscontrol.FedExLanguageCode[=string]

Default Value

"en"

Remarks

Two-letter code for the language (e.g. en, fr, etc.).

This field allows you to assign the language code. Default value is en.

Data Type

String

FedExLocaleCode Property (FedExAddress Control)

Two-letter code for the region (e.

Syntax

fedexaddresscontrol.FedExLocaleCode[=string]

Default Value

"US"

Remarks

Two-letter code for the region (e.g. US, CA, etc.).

Some languages require a locale code to further identify the language. Default value is US.

Data Type

String

FedExServer Property (FedExAddress Control)

URL for the FedEx Server where the requests are sent.

Syntax

fedexaddresscontrol.FedExServer[=string]

Default Value

""

Remarks

URL for the FedEx Server where the requests are sent. This will overwrite the internal values that the component uses.

Normally, you do not need to set this property. By default, the component will send the request to the preset production end-point. In order to send request to the test environment, you must set the TESTMODE config to true like: component.Config("TESTMODE=true").

Data Type

String

FirewallAutoDetect Property (FedExAddress Control)

This property tells the control whether or not to automatically detect and use firewall system settings, if available.

Syntax

fedexaddresscontrol.FirewallAutoDetect[=boolean]

Default Value

False

Remarks

This property tells the control whether or not to automatically detect and use firewall system settings, if available.

Data Type

Boolean

FirewallType Property (FedExAddress Control)

This property determines the type of firewall to connect through.

Syntax

fedexaddresscontrol.FirewallType[=integer]

Possible Values

fwNone(0), 
fwTunnel(1), 
fwSOCKS4(2), 
fwSOCKS5(3), 
fwSOCKS4A(10)

Default Value

0

Remarks

This property determines the type of firewall to connect through. The applicable values are as follows:

Data Type

Integer

FirewallHost Property (FedExAddress Control)

This property contains the name or IP address of firewall (optional).

Syntax

fedexaddresscontrol.FirewallHost[=string]

Default Value

""

Remarks

This property contains the name or IP address of firewall (optional). If a FirewallHost is given, the requested connections will be authenticated through the specified firewall when connecting.

If this property is set to a Domain Name, a DNS request is initiated. Upon successful termination of the request, this property is set to the corresponding address. If the search is not successful, the control fails with an error.

Data Type

String

FirewallPassword Property (FedExAddress Control)

This property contains a password if authentication is to be used when connecting through the firewall.

Syntax

fedexaddresscontrol.FirewallPassword[=string]

Default Value

""

Remarks

This property contains a password if authentication is to be used when connecting through the firewall. If FirewallHost is specified, the FirewallUser and FirewallPassword properties are used to connect and authenticate to the given firewall. If the authentication fails, the control fails with an error.

Data Type

String

FirewallPort Property (FedExAddress Control)

This property contains the transmission control protocol (TCP) port for the firewall Host .

Syntax

fedexaddresscontrol.FirewallPort[=integer]

Default Value

0

Remarks

This property contains the transmission control protocol (TCP) port for the firewall FirewallHost. See the description of the FirewallHost property for details.

Note: This property is set automatically when FirewallType is set to a valid value. See the description of the FirewallType property for details.

Data Type

Integer

FirewallUser Property (FedExAddress Control)

This property contains a user name if authentication is to be used connecting through a firewall.

Syntax

fedexaddresscontrol.FirewallUser[=string]

Default Value

""

Remarks

This property contains a user name if authentication is to be used connecting through a firewall. If the FirewallHost is specified, this property and FirewallPassword properties are used to connect and authenticate to the given Firewall. If the authentication fails, the control fails with an error.

Data Type

String

GeographicCoordinates Property (FedExAddress Control)

Specifies the geographic coordinates by which nearby FedEx locations are to be found.

Syntax

fedexaddresscontrol.GeographicCoordinates[=string]

Default Value

""

Remarks

This property is optional, unless SearchCriteria is set to sctGeographicCoordinates.

The latitude and longitude should be specified in decimal format and separated by a comma. For example 35.912366,-78.939459

Data Type

String

LocationCount Property (FedExAddress Control)

The number of records in the Location arrays.

Syntax

fedexaddresscontrol.LocationCount[=integer]

Default Value

0

Remarks

This property controls the size of the following arrays:

• LocationAcceptedCurrency
• LocationAttributes
• LocationCarrierCount
• LocationCarrierIndex
• LocationCarrierLatestDropoffCount
• LocationCarrierLatestDropoffDayOfWeek
• LocationCarrierLatestDropoffIndex
• LocationCarrierLatestDropoffOperationTime
• LocationCarrierType
• LocationCity
• LocationCompanyName
• LocationCountryCode
• LocationDistance
• LocationEmail
• LocationEntityId
• LocationFax
• LocationGeographicCoordinates
• LocationHolidayCount
• LocationHolidayDate
• LocationHolidayIndex
• LocationHolidayName
• LocationId
• LocationMapURL
• LocationPersonName
• LocationPhone
• LocationSpecialInstructions
• LocationState
• LocationStoreHoursCount
• LocationStoreHoursDayOfWeek
• LocationStoreHoursExceptionalHours
• LocationStoreHoursExceptionalHoursType
• LocationStoreHoursIndex
• LocationStoreHoursOperationalHours
• LocationStoreHoursOperationalHoursType
• LocationStoreNumber
• LocationStreetAddress
• LocationType
• LocationZipCode

The array indices start at 0 and end at LocationCount - 1.

This property is not available at design time.

Data Type

Integer

LocationAcceptedCurrency Property (FedExAddress Control)

The currency that is accepted at this FedEx location.

Syntax

fedexaddresscontrol.LocationAcceptedCurrency(LocationIndex)

Default Value

""

Remarks

The currency that is accepted at this FedEx location. This is populated when FindLocations is called.

The LocationIndex parameter specifies the index of the item in the array. The size of the array is controlled by the LocationCount property.

This property is read-only and not available at design time.

Data Type

String

LocationAttributes Property (FedExAddress Control)

This specifies what type of services this FedEx location provides.

Syntax

fedexaddresscontrol.LocationAttributes(LocationIndex)

Default Value

0

Remarks

This specifies what type of services this FedEx location provides. This is populated when FindLocations is called.

The following flags are defined (specified in hexadecimal notation). They can be or-ed together to include multiple attributes:

The LocationIndex parameter specifies the index of the item in the array. The size of the array is controlled by the LocationCount property.

This property is read-only and not available at design time.

Data Type

Integer

LocationCarrierCount Property (FedExAddress Control)

This contains the number of Carriers returned for the current location.

Syntax

fedexaddresscontrol.LocationCarrierCount(LocationIndex)

Default Value

0

Remarks

This contains the number of Carriers returned for the current location. This is populated after a call to FindLocations.

The LocationIndex parameter specifies the index of the item in the array. The size of the array is controlled by the LocationCount property.

This property is read-only and not available at design time.

Data Type

Integer

LocationCarrierIndex Property (FedExAddress Control)

This contains the current index for the array of carriers that were returned for the current location.

Syntax

fedexaddresscontrol.LocationCarrierIndex(LocationIndex)[=integer]

Default Value

0

Remarks

This contains the current index for the array of carriers that were returned for the current location.

The LocationIndex parameter specifies the index of the item in the array. The size of the array is controlled by the LocationCount property.

This property is not available at design time.

Data Type

Integer

LocationCarrierLatestDropoffCount Property (FedExAddress Control)

This contains the total number of normal latest dropoff times that were returned for the carrier specified by CarrierIndex .

Syntax

fedexaddresscontrol.LocationCarrierLatestDropoffCount(LocationIndex)

Default Value

0

Remarks

This contains the total number of normal latest dropoff times that were returned for the carrier specified by LocationCarrierIndex.

The LocationIndex parameter specifies the index of the item in the array. The size of the array is controlled by the LocationCount property.

This property is read-only and not available at design time.

Data Type

Integer

LocationCarrierLatestDropoffDayOfWeek Property (FedExAddress Control)

This contains the day of the week for the current normal latest dropoff.

Syntax

fedexaddresscontrol.LocationCarrierLatestDropoffDayOfWeek(LocationIndex)

Default Value

""

Remarks

This contains the day of the week for the current normal latest dropoff. This is populated when LocationCarrierLatestDropoffIndex is set.

The LocationIndex parameter specifies the index of the item in the array. The size of the array is controlled by the LocationCount property.

This property is read-only and not available at design time.

Data Type

String

LocationCarrierLatestDropoffIndex Property (FedExAddress Control)

This specifies the index for the normal latest dropoff time for the carrier specified by CarrierIndex .

Syntax

fedexaddresscontrol.LocationCarrierLatestDropoffIndex(LocationIndex)[=integer]

Default Value

0

Remarks

This specifies the index for the normal latest dropoff time for the carrier specified by LocationCarrierIndex. When LocationCarrierIndex is set, this gets set to 0.

The LocationIndex parameter specifies the index of the item in the array. The size of the array is controlled by the LocationCount property.

This property is not available at design time.

Data Type

Integer

LocationCarrierLatestDropoffOperationTime Property (FedExAddress Control)

This contains the current carrier's normal dropoff time for the specified day.

Syntax

fedexaddresscontrol.LocationCarrierLatestDropoffOperationTime(LocationIndex)

Default Value

""

Remarks

This contains the current carrier's normal dropoff time for the specified day. This is populated when LocationCarrierLatestDropoffIndex is set.

The LocationIndex parameter specifies the index of the item in the array. The size of the array is controlled by the LocationCount property.

This property is read-only and not available at design time.

Data Type

String

LocationCarrierType Property (FedExAddress Control)

This contains the type of carrier the current carrier is.

Syntax

fedexaddresscontrol.LocationCarrierType(LocationIndex)

Possible Values

lctFDXC(0), 
lctFDXE(1), 
lctFDXG(2), 
lctFXCC(3), 
lctFXFR(4), 
lctFXSP(5)

Default Value

0

Remarks

This contains the type of carrier the current carrier is. This is populated when LocationCarrierIndex is set.

The possible values are as follows:

The LocationIndex parameter specifies the index of the item in the array. The size of the array is controlled by the LocationCount property.

This property is read-only and not available at design time.

Data Type

Integer

LocationCity Property (FedExAddress Control)

Name of the city that the current location is in.

Syntax

fedexaddresscontrol.LocationCity(LocationIndex)

Default Value

""

Remarks

Name of the city that the current location is in.

The LocationIndex parameter specifies the index of the item in the array. The size of the array is controlled by the LocationCount property.

This property is read-only and not available at design time.

Data Type

String

LocationCompanyName Property (FedExAddress Control)

The name of the business at this FedEx location.

Syntax

fedexaddresscontrol.LocationCompanyName(LocationIndex)

Default Value

""

Remarks

The name of the business at this FedEx location. This is populated when FindLocations is called.

The LocationIndex parameter specifies the index of the item in the array. The size of the array is controlled by the LocationCount property.

This property is read-only and not available at design time.

Data Type

String

LocationCountryCode Property (FedExAddress Control)

This contains the country code for the current location.

Syntax

fedexaddresscontrol.LocationCountryCode(LocationIndex)

Default Value

""

Remarks

This contains the country code for the current location. This is populated when FindLocations is called.

The LocationIndex parameter specifies the index of the item in the array. The size of the array is controlled by the LocationCount property.

This property is read-only and not available at design time.

Data Type

String

LocationDistance Property (FedExAddress Control)

Specifies the distance between the FedEx locations and the address specified.

Syntax

fedexaddresscontrol.LocationDistance(LocationIndex)

Default Value

""

Remarks

Specifies the distance between the FedEx locations and the address specified. For example: 1.7 MI. This is populated when FindLocations is called.

The LocationIndex parameter specifies the index of the item in the array. The size of the array is controlled by the LocationCount property.

This property is read-only and not available at design time.

Data Type

String

LocationEmail Property (FedExAddress Control)

The email address provided for the current location.

Syntax

fedexaddresscontrol.LocationEmail(LocationIndex)

Default Value

""

Remarks

The email address provided for the current location. This is populated when FindLocations is called.

The LocationIndex parameter specifies the index of the item in the array. The size of the array is controlled by the LocationCount property.

This property is read-only and not available at design time.

Data Type

String

LocationEntityId Property (FedExAddress Control)

The entity ID for the current location.

Syntax

fedexaddresscontrol.LocationEntityId(LocationIndex)

Default Value

""

Remarks

The entity ID for the current location. This is populated when FindLocations is called.

The LocationIndex parameter specifies the index of the item in the array. The size of the array is controlled by the LocationCount property.

This property is read-only and not available at design time.

Data Type

String

LocationFax Property (FedExAddress Control)

This contains the fax number for the current location.

Syntax

fedexaddresscontrol.LocationFax(LocationIndex)

Default Value

""

Remarks

This contains the fax number for the current location. This is populated when FindLocations is called.

The LocationIndex parameter specifies the index of the item in the array. The size of the array is controlled by the LocationCount property.

This property is read-only and not available at design time.

Data Type

String

LocationGeographicCoordinates Property (FedExAddress Control)

This contains the geographic coordinates of the current location.

Syntax

fedexaddresscontrol.LocationGeographicCoordinates(LocationIndex)

Default Value

""

Remarks

This contains the geographic coordinates of the current location. This is populated when FindLocations is called.

The latitude and longitude will be specified in decimal format and separated by a comma. For example 35.912366,-78.939459

The LocationIndex parameter specifies the index of the item in the array. The size of the array is controlled by the LocationCount property.

This property is read-only and not available at design time.

Data Type

String

LocationHolidayCount Property (FedExAddress Control)

This contains the number of holidays that the current FedEx location observes.

Syntax

fedexaddresscontrol.LocationHolidayCount(LocationIndex)

Default Value

0

Remarks

This contains the number of holidays that the current FedEx location observes.

The LocationIndex parameter specifies the index of the item in the array. The size of the array is controlled by the LocationCount property.

This property is read-only and not available at design time.

Data Type

Integer

LocationHolidayDate Property (FedExAddress Control)

This is the date of the holiday specified by HolidayIndex .

Syntax

fedexaddresscontrol.LocationHolidayDate(LocationIndex)

Default Value

""

Remarks

This is the date of the holiday specified by LocationHolidayIndex.

The LocationIndex parameter specifies the index of the item in the array. The size of the array is controlled by the LocationCount property.

This property is read-only and not available at design time.

Data Type

String

LocationHolidayIndex Property (FedExAddress Control)

This contains the index of the current holiday the FedEx location observes.

Syntax

fedexaddresscontrol.LocationHolidayIndex(LocationIndex)[=integer]

Default Value

0

Remarks

This contains the index of the current holiday the FedEx location observes.

The LocationIndex parameter specifies the index of the item in the array. The size of the array is controlled by the LocationCount property.

This property is not available at design time.

Data Type

Integer

LocationHolidayName Property (FedExAddress Control)

This contains the name of the holiday specified by HolidayIndex .

Syntax

fedexaddresscontrol.LocationHolidayName(LocationIndex)

Default Value

""

Remarks

This contains the name of the holiday specified by LocationHolidayIndex.

The LocationIndex parameter specifies the index of the item in the array. The size of the array is controlled by the LocationCount property.

This property is read-only and not available at design time.

Data Type

String

LocationId Property (FedExAddress Control)

Business identifier that can be used by IRV attendant to look directions to this FedEx location.

Syntax

fedexaddresscontrol.LocationId(LocationIndex)

Default Value

""

Remarks

Business identifier that can be used by IRV attendant to look directions to this FedEx location. This is populated when FindLocations is called.

The LocationIndex parameter specifies the index of the item in the array. The size of the array is controlled by the LocationCount property.

This property is read-only and not available at design time.

Data Type

String

LocationMapURL Property (FedExAddress Control)

This contains the URL to the google map showing the location.

Syntax

fedexaddresscontrol.LocationMapURL(LocationIndex)

Default Value

""

Remarks

This contains the URL to the google map showing the location.

The LocationIndex parameter specifies the index of the item in the array. The size of the array is controlled by the LocationCount property.

This property is read-only and not available at design time.

Data Type

String

LocationPersonName Property (FedExAddress Control)

The name of the person listed as the contact for the current location.

Syntax

fedexaddresscontrol.LocationPersonName(LocationIndex)

Default Value

""

Remarks

The name of the person listed as the contact for the current location. This is populated after a call to FindLocations.

The LocationIndex parameter specifies the index of the item in the array. The size of the array is controlled by the LocationCount property.

This property is read-only and not available at design time.

Data Type

String

LocationPhone Property (FedExAddress Control)

The phone number for the current location.

Syntax

fedexaddresscontrol.LocationPhone(LocationIndex)

Default Value

""

Remarks

The phone number for the current location. This is populated after a call to FindLocations.

The LocationIndex parameter specifies the index of the item in the array. The size of the array is controlled by the LocationCount property.

This property is read-only and not available at design time.

Data Type

String

LocationSpecialInstructions Property (FedExAddress Control)

This contains any special instructions provided for the current location.

Syntax

fedexaddresscontrol.LocationSpecialInstructions(LocationIndex)

Default Value

""

Remarks

This contains any special instructions provided for the current location. This is populated after a call to FindLocations.

The LocationIndex parameter specifies the index of the item in the array. The size of the array is controlled by the LocationCount property.

This property is read-only and not available at design time.

Data Type

String

LocationState Property (FedExAddress Control)

State or province code of the current location.

Syntax

fedexaddresscontrol.LocationState(LocationIndex)

Default Value

""

Remarks

State or province code of the current location. This is populated after a call to FindLocations.

The LocationIndex parameter specifies the index of the item in the array. The size of the array is controlled by the LocationCount property.

This property is read-only and not available at design time.

Data Type

String

LocationStoreHoursCount Property (FedExAddress Control)

This contains the number of store hours that were returned for the current location.

Syntax

fedexaddresscontrol.LocationStoreHoursCount(LocationIndex)

Default Value

0

Remarks

This contains the number of store hours that were returned for the current location. This is populated after a call to FindLocations.

The LocationIndex parameter specifies the index of the item in the array. The size of the array is controlled by the LocationCount property.

This property is read-only and not available at design time.

Data Type

Integer

LocationStoreHoursDayOfWeek Property (FedExAddress Control)

This contains the day of the week for which the store hours are being specified.

Syntax

fedexaddresscontrol.LocationStoreHoursDayOfWeek(LocationIndex)

Default Value

""

Remarks

This contains the day of the week for which the store hours are being specified. This is populated when LocationStoreHoursIndex is set.

The LocationIndex parameter specifies the index of the item in the array. The size of the array is controlled by the LocationCount property.

This property is read-only and not available at design time.

Data Type

String

LocationStoreHoursExceptionalHours Property (FedExAddress Control)

This contains the list of operating hours for the location that are an exception from the normal hours of operation.

Syntax

fedexaddresscontrol.LocationStoreHoursExceptionalHours(LocationIndex)

Default Value

""

Remarks

This contains the list of operating hours for the location that are an exception from the normal hours of operation. This is populated when LocationStoreHoursIndex is set.

The format will be a 24 hour time format "HH:mm-HH:mm". For instance "09:00-16:00". If the location closes during the middle of the day so that it opens and closes twice in one day the sets will be separated by a comma. For instance "09:00-16:00,19:00-23:00" means the location is open from 9 a.m. to 4 p.m. and open again from 7 p.m. to 11 p.m.

The LocationIndex parameter specifies the index of the item in the array. The size of the array is controlled by the LocationCount property.

This property is read-only and not available at design time.

Data Type

String

LocationStoreHoursExceptionalHoursType Property (FedExAddress Control)

Indicates the type of exceptional hours.

Syntax

fedexaddresscontrol.LocationStoreHoursExceptionalHoursType(LocationIndex)

Default Value

""

Remarks

Indicates the type of exceptional hours. Possible returned values are: "CLOSED_ALL_DAY", "OPEN_ALL_DAY", "OPEN_BY_HOURS". This is populated when LocationStoreHoursIndex is set.

The LocationIndex parameter specifies the index of the item in the array. The size of the array is controlled by the LocationCount property.

This property is read-only and not available at design time.

Data Type

String

LocationStoreHoursIndex Property (FedExAddress Control)

This specifies the current index for the array containing the current location's store hours.

Syntax

fedexaddresscontrol.LocationStoreHoursIndex(LocationIndex)[=integer]

Default Value

0

Remarks

This specifies the current index for the array containing the current location's store hours.

The LocationIndex parameter specifies the index of the item in the array. The size of the array is controlled by the LocationCount property.

This property is not available at design time.

Data Type

Integer

LocationStoreHoursOperationalHours Property (FedExAddress Control)

This contains the list of normal operating hours for the location.

Syntax

fedexaddresscontrol.LocationStoreHoursOperationalHours(LocationIndex)

Default Value

""

Remarks

This contains the list of normal operating hours for the location. This is populated when LocationStoreHoursIndex is set.

The format will be a 24 hour time format "HH:mm-HH:mm". For instance "09:00-16:00". If the location closes during the middle of the day so that it opens and closes twice in one day the sets will be separated by a comma. For instance "09:00-16:00,19:00-23:00" means the location is open from 9 a.m. to 4 p.m. and open again from 7 p.m. to 11 p.m.

The LocationIndex parameter specifies the index of the item in the array. The size of the array is controlled by the LocationCount property.

This property is read-only and not available at design time.

Data Type

String

LocationStoreHoursOperationalHoursType Property (FedExAddress Control)

Indicates the type of operational hours.

Syntax

fedexaddresscontrol.LocationStoreHoursOperationalHoursType(LocationIndex)

Default Value

""

Remarks

Indicates the type of operational hours. Possible returned values are: "CLOSED_ALL_DAY", "OPEN_ALL_DAY", "OPEN_BY_HOURS". This is populated when LocationStoreHoursIndex is set.

The LocationIndex parameter specifies the index of the item in the array. The size of the array is controlled by the LocationCount property.

This property is read-only and not available at design time.

Data Type

String

LocationStoreNumber Property (FedExAddress Control)

The store number for the current location.

Syntax

fedexaddresscontrol.LocationStoreNumber(LocationIndex)

Default Value

0

Remarks

The store number for the current location. This is populated after a call to FindLocations.

The LocationIndex parameter specifies the index of the item in the array. The size of the array is controlled by the LocationCount property.

This property is read-only and not available at design time.

Data Type

Integer

LocationStreetAddress Property (FedExAddress Control)

Street address or intersection of this FedEx location.

Syntax

fedexaddresscontrol.LocationStreetAddress(LocationIndex)

Default Value

""

Remarks

Street address or intersection of this FedEx location. This is populated after a call to FindLocations.

The LocationIndex parameter specifies the index of the item in the array. The size of the array is controlled by the LocationCount property.

This property is read-only and not available at design time.

Data Type

String

LocationType Property (FedExAddress Control)

The type of this FedEx location.

Syntax

fedexaddresscontrol.LocationType(LocationIndex)[=integer]

Possible Values

fltAuthorizedShipCenter(0), 
fltExpressStation(1), 
fltFreightServiceCenter(2), 
fltGroundTerminal(3), 
fltHomeDeliveryStation(4), 
fltFedExOffice(5), 
fltSelfServiceStation(6), 
fltSmartPostHub(7), 
fltFedExFacility(8), 
fltFedExOnsite(9), 
fltFedExShipSite(10)

Default Value

0

Remarks

The type of this FedEx location. This is populated after a call to FindLocations.

Possible values are as follows:

The LocationIndex parameter specifies the index of the item in the array. The size of the array is controlled by the LocationCount property.

This property is not available at design time.

Data Type

Integer

LocationZipCode Property (FedExAddress Control)

The postal code for the current location.

Syntax

fedexaddresscontrol.LocationZipCode(LocationIndex)

Default Value

""

Remarks

The postal code for the current location. This is populated after a call to FindLocations.

The LocationIndex parameter specifies the index of the item in the array. The size of the array is controlled by the LocationCount property.

This property is read-only and not available at design time.

Data Type

String

MatchCount Property (FedExAddress Control)

The number of records in the Match arrays.

Syntax

fedexaddresscontrol.MatchCount

Default Value

0

Remarks

This property controls the size of the following arrays:

• MatchAddress1
• MatchAddress2
• MatchChangeType
• MatchCity
• MatchCompany
• MatchCountryCode
• MatchCustomerMessage
• MatchQuality
• MatchResidentialStatus
• MatchState
• MatchZipCode

The array indices start at 0 and end at MatchCount - 1.

This property is read-only and not available at design time.

Data Type

Integer

MatchAddress1 Property (FedExAddress Control)

Address line 1 of an address candidate in the list of matches (if any).

Syntax

fedexaddresscontrol.MatchAddress1(MatchIdx)

Default Value

""

Remarks

Address line 1 of an address candidate in the list of matches (if any).

This may be returned in the server response when the ValidateAddress method is called and if the connection to the server is successful (no errors returned).

The MatchIdx parameter specifies the index of the item in the array. The size of the array is controlled by the MatchCount property.

This property is read-only and not available at design time.

Data Type

String

MatchAddress2 Property (FedExAddress Control)

Address line 2 of an address candidate in the list of matches (if any).

Syntax

fedexaddresscontrol.MatchAddress2(MatchIdx)

Default Value

""

Remarks

Address line 2 of an address candidate in the list of matches (if any).

This may be returned in the server response when the ValidateAddress method is called and if the connection to the server is successful (no errors returned).

The MatchIdx parameter specifies the index of the item in the array. The size of the array is controlled by the MatchCount property.

This property is read-only and not available at design time.

Data Type

String

MatchChangeType Property (FedExAddress Control)

Changes made to the Address (during validation process) compared to this address candidate.

Syntax

fedexaddresscontrol.MatchChangeType(MatchIdx)

Default Value

""

Remarks

Changes made to the Address (during validation process) compared to this address candidate. This is a comma-separated string collection. Possible returned values are

• APARTMENT_NUMBER_NOT_FOUND
• APARTMENT_NUMBER_REQUIRED
• NORMALIZED
• REMOVED_DATA
• BOX_NUMBER_REQUIRED
• NO_CHANGES
• MODIFIED_TO_ACHIEVE_MATCH
• STREET_RANGE_MATCH
• BOX_NUMBER_MATCH
• RR_OR_HC_MATCH
• CITY_MATCH
• POSTAL_CODE_MATCH
• RR_OR_HC_BOX_NUMBER_NEEDED
• FORMATTED_FOR_COUNTRY
• APO_OR_FPO_MATCH
• GENERAL_DELIVERY_MATCH
• FIELD_TRUNCATED
• UNABLE_TO_APPEND_NON_ADDRESS_DATA
• INSUFFICIENT_DATA
• HOUSE_OR_BOX_NUMBER_NOT_FOUND
• POSTAL_CODE_NOT_FOUND
• INVALID_COUNTRY
• SERVICE_UNAVAILABLE_FOR_ADDRESS

This is only valid for FedEx.

This may be returned in the server response when the ValidateAddress method is called and if the connection to the server is successful (no errors returned).

The MatchIdx parameter specifies the index of the item in the array. The size of the array is controlled by the MatchCount property.

This property is read-only and not available at design time.

Data Type

String

MatchCity Property (FedExAddress Control)

City name of an address candidate in the list of matches (if any).

Syntax

fedexaddresscontrol.MatchCity(MatchIdx)

Default Value

""

Remarks

City name of an address candidate in the list of matches (if any).

This may be returned in the server response when the ValidateAddress method is called and if the connection to the server is successful (no errors returned).

The MatchIdx parameter specifies the index of the item in the array. The size of the array is controlled by the MatchCount property.

This property is read-only and not available at design time.

Data Type

String

MatchCompany Property (FedExAddress Control)

Name of the company that resides at an address candidate in the list of matches (if any).

Syntax

fedexaddresscontrol.MatchCompany(MatchIdx)

Default Value

""

Remarks

Name of the company that resides at an address candidate in the list of matches (if any).

This may be returned in the server response when the ValidateAddress method is called and if the connection to the server is successful (no errors returned).

The MatchIdx parameter specifies the index of the item in the array. The size of the array is controlled by the MatchCount property.

This property is read-only and not available at design time.

Data Type

String

MatchCountryCode Property (FedExAddress Control)

Country code of an address candidate in the list of matches (if any).

Syntax

fedexaddresscontrol.MatchCountryCode(MatchIdx)

Default Value

""

Remarks

Country code of an address candidate in the list of matches (if any).

This may be returned in the server response when the ValidateAddress method is called and if the connection to the server is successful (no errors returned).

The MatchIdx parameter specifies the index of the item in the array. The size of the array is controlled by the MatchCount property.

This property is read-only and not available at design time.

Data Type

String

MatchCustomerMessage Property (FedExAddress Control)

Messages pertaining to the resolved address indicating if any additional information is required.

Syntax

fedexaddresscontrol.MatchCustomerMessage(MatchIdx)

Default Value

""

Remarks

Messages pertaining to the resolved address indicating if any additional information is required. This is a comma-separated string collection. Possible returned values are

This is only valid for FedEx.

This may be returned in the server response when the ValidateAddress method is called and if the connection to the server is successful (no errors returned).

The MatchIdx parameter specifies the index of the item in the array. The size of the array is controlled by the MatchCount property.

This property is read-only and not available at design time.

Data Type

String

MatchQuality Property (FedExAddress Control)

Quality factor an address candidate in the list of matches (if any).

Syntax

fedexaddresscontrol.MatchQuality(MatchIdx)

Default Value

""

Remarks

Quality factor an address candidate in the list of matches (if any).

Each address is returned with an assigned quality value that indicates how closely the address candidate matches the search criteria. This is used to rate the submitted address. If the MatchQuality is too low, the control returns the "Address Not Validated" message.

In FedEx, possible values range from 0 to 100, with 100 being the highest and zero indicating failure.

In UPS, this is applicable for a non street-level address validation and/or classification (i.e., when the Address1 is not set in the request). Possible values are:

This may be returned in the server response when the ValidateAddress method is called and if the connection to the server is successful (no errors returned).

The MatchIdx parameter specifies the index of the item in the array. The size of the array is controlled by the MatchCount property.

This property is read-only and not available at design time.

Data Type

String

MatchResidentialStatus Property (FedExAddress Control)

Residential status of an address candidate in the list of matches (if any).

Syntax

fedexaddresscontrol.MatchResidentialStatus(MatchIdx)

Default Value

""

Remarks

Residential status of an address candidate in the list of matches (if any). Possible returned values are:

• MIXED
• UNKNOWN
• BUSINESS
• RESIDENTIAL

This may be returned in the server response when the ValidateAddress method is called and if the connection to the server is successful (no errors returned).

The MatchIdx parameter specifies the index of the item in the array. The size of the array is controlled by the MatchCount property.

This property is read-only and not available at design time.

Data Type

String

MatchState Property (FedExAddress Control)

State or province code of an address candidate in the list of matches (if any).

Syntax

fedexaddresscontrol.MatchState(MatchIdx)

Default Value

""

Remarks

State or province code of an address candidate in the list of matches (if any).

This may be returned in the server response when the ValidateAddress method is called and if the connection to the server is successful (no errors returned).

The MatchIdx parameter specifies the index of the item in the array. The size of the array is controlled by the MatchCount property.

This property is read-only and not available at design time.

Data Type

String

MatchZipCode Property (FedExAddress Control)

Postal Code of an address candidate in the list of matches (if any).

Syntax

fedexaddresscontrol.MatchZipCode(MatchIdx)

Default Value

""

Remarks

Postal Code of an address candidate in the list of matches (if any).

This may be returned in the server response when the ValidateAddress method is called and if the connection to the server is successful (no errors returned).

The MatchIdx parameter specifies the index of the item in the array. The size of the array is controlled by the MatchCount property.

This property is read-only and not available at design time.

Data Type

String

MaxResults Property (FedExAddress Control)

The maximum number of results to be returned.

Syntax

fedexaddresscontrol.MaxResults[=integer]

Default Value

10

Remarks

This specifies the maximum number of results to be returned. The default value is 10.

The maximum value for this property is 50.

Data Type

Integer

Phone Property (FedExAddress Control)

Phone number for which nearby FedEx locations are to be found.

Syntax

fedexaddresscontrol.Phone[=string]

Default Value

""

Remarks

This property is optional, unless SearchCriteria is set to sctPhoneNumber.

Data Type

String

ProxyAuthScheme Property (FedExAddress Control)

This property is used to tell the control which type of authorization to perform when connecting to the proxy.

Syntax

fedexaddresscontrol.ProxyAuthScheme[=integer]

Possible Values

authBasic(0), 
authDigest(1), 
authProprietary(2), 
authNone(3), 
authNtlm(4), 
authNegotiate(5)

Default Value

0

Remarks

This property is used to tell the control which type of authorization to perform when connecting to the proxy. This is used only when the ProxyUser and ProxyPassword properties are set.

ProxyAuthScheme should be set to authNone (3) when no authentication is expected.

By default, ProxyAuthScheme is authBasic (0), and if the ProxyUser and ProxyPassword properties are set, the component will attempt basic authentication.

If ProxyAuthScheme is set to authDigest (1), digest authentication will be attempted instead.

If ProxyAuthScheme is set to authProprietary (2), then the authorization token will not be generated by the control. Look at the configuration file for the control being used to find more information about manually setting this token.

If ProxyAuthScheme is set to authNtlm (4), NTLM authentication will be used.

For security reasons, setting this property will clear the values of ProxyUser and ProxyPassword.

Data Type

Integer

ProxyAutoDetect Property (FedExAddress Control)

This property tells the control whether or not to automatically detect and use proxy system settings, if available.

Syntax

fedexaddresscontrol.ProxyAutoDetect[=boolean]

Default Value

False

Remarks

This property tells the control whether or not to automatically detect and use proxy system settings, if available. The default value is .

Data Type

Boolean

ProxyPassword Property (FedExAddress Control)

This property contains a password if authentication is to be used for the proxy.

Syntax

fedexaddresscontrol.ProxyPassword[=string]

Default Value

""

Remarks

This property contains a password if authentication is to be used for the proxy.

If ProxyAuthScheme is set to Basic Authentication, the ProxyUser and ProxyPassword are Base64 encoded and the proxy authentication token will be generated in the form Basic [encoded-user-password].

If ProxyAuthScheme is set to Digest Authentication, the ProxyUser and ProxyPassword properties are used to respond to the Digest Authentication challenge from the server.

If ProxyAuthScheme is set to NTLM Authentication, the ProxyUser and ProxyPassword properties are used to authenticate through NTLM negotiation.

Data Type

String

ProxyPort Property (FedExAddress Control)

This property contains the Transmission Control Protocol (TCP) port for the proxy Server (default 80).

Syntax

fedexaddresscontrol.ProxyPort[=integer]

Default Value

80

Remarks

This property contains the Transmission Control Protocol (TCP) port for the proxy ProxyServer (default 80). See the description of the ProxyServer property for details.

Data Type

Integer

ProxyServer Property (FedExAddress Control)

If a proxy Server is given, then the HTTP request is sent to the proxy instead of the server otherwise specified.

Syntax

fedexaddresscontrol.ProxyServer[=string]

Default Value

""

Remarks

If a proxy ProxyServer is given, then the HTTP request is sent to the proxy instead of the server otherwise specified.

If the ProxyServer property is set to a domain name, a DNS request is initiated. Upon successful termination of the request, the ProxyServer property is set to the corresponding address. If the search is not successful, an error is returned.

Data Type

String

ProxySSL Property (FedExAddress Control)

This property determines when to use a Secure Sockets Layer (SSL) for the connection to the proxy.

Syntax

fedexaddresscontrol.ProxySSL[=integer]

Possible Values

psAutomatic(0), 
psAlways(1), 
psNever(2), 
psTunnel(3)

Default Value

0

Remarks

This property determines when to use a Secure Sockets Layer (SSL) for the connection to the proxy. The applicable values are as follows:

Data Type

Integer

ProxyUser Property (FedExAddress Control)

This property contains a username if authentication is to be used for the proxy.

Syntax

fedexaddresscontrol.ProxyUser[=string]

Default Value

""

Remarks

This property contains a username if authentication is to be used for the proxy.

If ProxyAuthScheme is set to Basic Authentication, the ProxyUser and ProxyPassword properties are Base64 encoded and the proxy authentication token will be generated in the form Basic [encoded-user-password].

If ProxyAuthScheme is set to Digest Authentication, the ProxyUser and ProxyPassword properties are used to respond to the Digest Authentication challenge from the server.

If ProxyAuthScheme is set to NTLM Authentication, the ProxyUser and ProxyPassword properties are used to authenticate through NTLM negotiation.

Data Type

String

SearchCriteria Property (FedExAddress Control)

The criteria to be used to find FedEx Locations.

Syntax

fedexaddresscontrol.SearchCriteria[=integer]

Possible Values

sctAddress(0), 
sctGeographicCoordinates(1), 
sctPhoneNumber(2)

Default Value

0

Remarks

This specifies what criteria is to be used to search for FedEx locations when FindLocations is called.

If sctAddress is specified, the Address, must be set. Likewise, if sctGeographicCoordinates is specified, GeographicCoordinates must be set and if sctPhoneNumber is specified PhoneNumber must be set.

Data Type

Integer

SortCriteria Property (FedExAddress Control)

The criteria to be used to sort the results.

Syntax

fedexaddresscontrol.SortCriteria[=integer]

Possible Values

scDistance(0), 
scLatestExpressDropoffTime(1), 
scLatestGroundDropoffTime(2), 
scLocationType(3)

Default Value

0

Remarks

This specifies what criteria will be used to sort the results that are returned from FedEx when FindLocations is called.

Data Type

Integer

SSLAcceptServerCertEncoded Property (FedExAddress Control)

This is the certificate (PEM/Base64 encoded).

Syntax

fedexaddresscontrol.SSLAcceptServerCertEncoded[=string]

Default Value

""

Remarks

This is the certificate (PEM/Base64 encoded). This property is used to assign a specific certificate. The SSLAcceptServerCertStore and SSLAcceptServerCertSubject properties also may be used to specify a certificate.

When SSLAcceptServerCertEncoded is set, a search is initiated in the current SSLAcceptServerCertStore for the private key of the certificate. If the key is found, SSLAcceptServerCertSubject is updated to reflect the full subject of the selected certificate; otherwise, SSLAcceptServerCertSubject is set to an empty string.

To read or write binary data to the property, a Variant (Byte Array) version is provided in .SSLAcceptServerCertEncodedB.

This property is not available at design time.

Data Type

Binary String

SSLCertEncoded Property (FedExAddress Control)

This is the certificate (PEM/Base64 encoded).

Syntax

fedexaddresscontrol.SSLCertEncoded[=string]

Default Value

""

Remarks

This is the certificate (PEM/Base64 encoded). This property is used to assign a specific certificate. The SSLCertStore and SSLCertSubject properties also may be used to specify a certificate.

When SSLCertEncoded is set, a search is initiated in the current SSLCertStore for the private key of the certificate. If the key is found, SSLCertSubject is updated to reflect the full subject of the selected certificate; otherwise, SSLCertSubject is set to an empty string.

To read or write binary data to the property, a Variant (Byte Array) version is provided in .SSLCertEncodedB.

This property is not available at design time.

Data Type

Binary String

SSLCertStore Property (FedExAddress Control)

This is the name of the certificate store for the client certificate.

Syntax

fedexaddresscontrol.SSLCertStore[=string]

Default Value

"MY"

Remarks

This is the name of the certificate store for the client certificate.

The SSLCertStoreType property denotes the type of the certificate store specified by SSLCertStore. If the store is password protected, specify the password in SSLCertStorePassword.

SSLCertStore is used in conjunction with the SSLCertSubject property to specify client certificates. If SSLCertStore has a value, and SSLCertSubject or SSLCertEncoded is set, a search for a certificate is initiated. Please see the SSLCertSubject property for details.

Designations of certificate stores are platform dependent.

The following designations are the most common User and Machine certificate stores in Windows:

When the certificate store type is PFXFile, this property must be set to the name of the file. When the type is PFXBlob, the property must be set to the binary contents of a PFX file (i.e., PKCS#12 certificate store).

To read or write binary data to the property, a Variant (Byte Array) version is provided in .SSLCertStoreB.

Data Type

Binary String

SSLCertStorePassword Property (FedExAddress Control)

If the type of certificate store requires a password, this property is used to specify the password needed to open the certificate store.

Syntax

fedexaddresscontrol.SSLCertStorePassword[=string]

Default Value

""

Remarks

If the type of certificate store requires a password, this property is used to specify the password needed to open the certificate store.

Data Type

String

SSLCertStoreType Property (FedExAddress Control)

This is the type of certificate store for this certificate.

Syntax

fedexaddresscontrol.SSLCertStoreType[=integer]

Possible Values

cstUser(0), 
cstMachine(1), 
cstPFXFile(2), 
cstPFXBlob(3), 
cstJKSFile(4), 
cstJKSBlob(5), 
cstPEMKeyFile(6), 
cstPEMKeyBlob(7), 
cstPublicKeyFile(8), 
cstPublicKeyBlob(9), 
cstSSHPublicKeyBlob(10), 
cstP7BFile(11), 
cstP7BBlob(12), 
cstSSHPublicKeyFile(13), 
cstPPKFile(14), 
cstPPKBlob(15), 
cstXMLFile(16), 
cstXMLBlob(17), 
cstJWKFile(18), 
cstJWKBlob(19), 
cstSecurityKey(20), 
cstBCFKSFile(21), 
cstBCFKSBlob(22), 
cstPKCS11(23), 
cstAuto(99)

Default Value

0

Remarks

This is the type of certificate store for this certificate.

The control supports both public and private keys in a variety of formats. When the cstAuto value is used, the control will automatically determine the type. This property can take one of the following values:

Data Type

Integer

SSLCertSubject Property (FedExAddress Control)

This is the subject of the certificate used for client authentication.

Syntax

fedexaddresscontrol.SSLCertSubject[=string]

Default Value

""

Remarks

This is the subject of the certificate used for client authentication.

This property must be set after all other certificate properties are set. When this property is set, a search is performed in the current certificate store to locate a certificate with a matching subject.

If a matching certificate is found, the property is set to the full subject of the matching certificate.

If an exact match is not found, the store is searched for subjects containing the value of the property.

If a match is still not found, the property is set to an empty string, and no certificate is selected.

The special value "*" picks a random certificate in the certificate store.

The certificate subject is a comma-separated list of distinguished name fields and values. For instance, "CN=www.server.com, OU=test, C=US, E=support@nsoftware.com". Common fields and their meanings are as follows:

If a field value contains a comma, it must be quoted.

Data Type

String

SSLProvider Property (FedExAddress Control)

This specifies the SSL/TLS implementation to use.

Syntax

fedexaddresscontrol.SSLProvider[=integer]

Possible Values

sslpAutomatic(0), 
sslpPlatform(1), 
sslpInternal(2)

Default Value

0

Remarks

This property specifies the SSL/TLS implementation to use. In most cases the default value of 0 (Automatic) is recommended and should not be changed. When set to 0 (Automatic) the control will select whether to use the platform implementation or the internal implementation depending on the operating system as well as the TLS version being used.

Possible values are:

In most cases using the default value (Automatic) is recommended. The control will select a provider depending on the current platform.

When Automatic is selected the platform implementation is used by default. When TLS 1.3 is enabled via SSLEnabledProtocols the internal implementation is used.

Data Type

Integer

SSLServerCertEncoded Property (FedExAddress Control)

This is the certificate (PEM/Base64 encoded).

Syntax

fedexaddresscontrol.SSLServerCertEncoded

Default Value

""

Remarks

This is the certificate (PEM/Base64 encoded). This property is used to assign a specific certificate. The SSLServerCertStore and SSLServerCertSubject properties also may be used to specify a certificate.

When SSLServerCertEncoded is set, a search is initiated in the current SSLServerCertStore for the private key of the certificate. If the key is found, SSLServerCertSubject is updated to reflect the full subject of the selected certificate; otherwise, SSLServerCertSubject is set to an empty string.

To read or write binary data to the property, a Variant (Byte Array) version is provided in .SSLServerCertEncodedB.

This property is read-only and not available at design time.

Data Type

Binary String

Timeout Property (FedExAddress Control)

A timeout for the control.

Syntax

fedexaddresscontrol.Timeout[=integer]

Default Value

60

Remarks

If the Timeout property is set to 0, all operations will run uninterrupted until successful completion or an error condition is encountered.

If Timeout is set to a positive value, the control will wait for the operation to complete before returning control.

The control will use DoEvents to enter an efficient wait loop during any potential waiting period, making sure that all system events are processed immediately as they arrive. This ensures that the host application does not "freeze" and remains responsive.

If Timeout expires, and the operation is not yet complete, the control fails with an error.

Please note that by default, all timeouts are inactivity timeouts, i.e. the timeout period is extended by Timeout seconds when any amount of data is successfully sent or received.

The default value for the Timeout property is 60 seconds.

Data Type

Integer

TotalLocationsFound Property (FedExAddress Control)

Specifies the total number of locations found.

Syntax

fedexaddresscontrol.TotalLocationsFound[=integer]

Default Value

0

Remarks

This specifies the total number of locations found based on the criteria provided when FindLocations is called.

Data Type

Integer

Config Method (FedExAddress Control)

Sets or retrieves a configuration setting.

Syntax

fedexaddresscontrol.Config ConfigurationString

Remarks

Config is a generic method available in every control. It is used to set and retrieve configuration settings for the control.

These settings are similar in functionality to properties, but they are rarely used. In order to avoid "polluting" the property namespace of the control, access to these internal properties is provided through the Config method.

To set a configuration setting named PROPERTY, you must call Config("PROPERTY=VALUE"), where VALUE is the value of the setting expressed as a string. For boolean values, use the strings "True", "False", "0", "1", "Yes", or "No" (case does not matter).

To read (query) the value of a configuration setting, you must call Config("PROPERTY"). The value will be returned as a string.

FindLocations Method (FedExAddress Control)

Finds FedEx location(s) based on the input data.

Syntax

fedexaddresscontrol.FindLocations 

Remarks

FedEx drop-off locations can be searched by phone number or address. On each request, the following properties can be passed in the request (the optional ones are used to narrow down the search and the conditional ones depend on other property values):

• FedExServer (optional)
• FedExAccountNumber (optional)
• Phone (required if searched by phone number)
• Address (required if searched by address)
• ConstraintLocationTypeFlags (optional)

If there are any locations returned, the following properties will be filled:

• Location*

Reset Method (FedExAddress Control)

Resets the internal state of the control and all properties to their default values.

Syntax

fedexaddresscontrol.Reset 

Remarks

The Reset method does not have any parameters and does not return any value.

ValidateAddress Method (FedExAddress Control)

Returns the corrected and standardized address information or a list of candidates.

Syntax

fedexaddresscontrol.ValidateAddress 

Remarks

This method is used to verify and correct the address specified by the Address.

Any of the following input combinations are valid:

• City, State and ZipCode
• City
• ZipCode
• City and State
• City and ZipCode
• State and ZipCode

Error Event (FedExAddress Control)

Information about errors during data delivery.

Syntax

Sub fedexaddresscontrol_Error(ErrorCode As Integer, Description As String)

Remarks

The Error event is fired in case of exceptional conditions during message processing.

ErrorCode contains an error code and Description contains a textual description of the error. For a list of valid error codes and their descriptions, please refer to the Error Codes section.

Notification Event (FedExAddress Control)

Notification returned by the server upon successful request (if applicable).

Syntax

Sub fedexaddresscontrol_Notification(Message As String)

Remarks

When sending a request, the server may return with a successful reply or an error. However, even when a transaction is successful, a warning or a note might still be returned by the server. In such cases, the Notification event is fired.

Notifications returned through this event are non-fatal and shipments will still be processes, labels will still be printable, rates are still returned, etc. These notifications should be treated as informational only.

SSLServerAuthentication Event (FedExAddress Control)

Fired after the server presents its certificate to the client.

Syntax

Sub fedexaddresscontrol_SSLServerAuthentication(CertEncoded As String, CertSubject As String, CertIssuer As String, Status As String, Accept As Boolean)

Remarks

During this event, the client can decide whether or not to continue with the connection process. The Accept parameter is a recommendation on whether to continue or close the connection. This is just a suggestion: application software must use its own logic to determine whether or not to continue.

When Accept is False, Status shows why the verification failed (otherwise, Status contains the string OK). If it is decided to continue, you can override and accept the certificate by setting the Accept parameter to True.

SSLStatus Event (FedExAddress Control)

Fired when secure connection progress messages are available.

Syntax

Sub fedexaddresscontrol_SSLStatus(Message As String)

Remarks

The event is fired for informational and logging purposes only. This event tracks the progress of the connection.

Config Settings (FedExAddress Control)

FedExAddress Config Settings

HTTP Config Settings

TCPClient Config Settings

SSL Config Settings

-----BEGIN CERTIFICATE-----
MIIEKzCCAxOgAwIBAgIRANTET4LIkxdH6P+CFIiHvTowDQYJKoZIhvcNAQELBQAw
...
eWHV5OW1K53o/atv59sOiW5K3crjFhsBOd5Q+cJJnU+SWinPKtANXMht+EDvYY2w
F0I1XhM+pKj7FjDr+XNj
-----END CERTIFICATE-----
\r \n
-----BEGIN CERTIFICATE-----
MIIEFjCCAv6gAwIBAgIQetu1SMxpnENAnnOz1P+PtTANBgkqhkiG9w0BAQUFADBp
..
d8q23djXZbVYiIfE9ebr4g3152BlVCHZ2GyPdjhIuLeH21VbT/dyEHHA
-----END CERTIFICATE-----

-----BEGIN CERTIFICATE-----
MIIEKzCCAxOgAwIBAgIRANTET4LIkxdH6P+CFIiHvTowDQYJKoZIhvcNAQELBQAw
...
eWHV5OW1K53o/atv59sOiW5K3crjFhsBOd5Q+cJJnU+SWinPKtANXMht+EDvYY2w
F0I1XhM+pKj7FjDr+XNj
-----END CERTIFICATE-----
\r \n
-----BEGIN CERTIFICATE-----
MIIEFjCCAv6gAwIBAgIQetu1SMxpnENAnnOz1P+PtTANBgkqhkiG9w0BAQUFADBp
..
d8q23djXZbVYiIfE9ebr4g3152BlVCHZ2GyPdjhIuLeH21VbT/dyEHHA
-----END CERTIFICATE-----

Socket Config Settings

Base Config Settings

Trappable Errors (FedExAddress Control)

FedExAddress Errors

The control may also return one of the following error codes, which are inherited from other controls.