FedExTrack Component

Properties   Methods   Events   Config Settings   Errors  

Provides tracking information, SPOD, and notification for a given tracking number or other shipment identifier.

Syntax

TibxFedExTrack

Remarks

This component provides Tracking, Signature Proof of Delivery (SPOD), and Notification services:

• Tracking Service: to obtain real-time tracking information for FedEx Express, FedEx Ground, FedEx Home Delivery, FedEx Express Freight, and FedEx Custom Critical shipments.
• Signature Proof of Delivery (SPOD): to request a proof of delivery letter that includes a graphic image of your recipient's signature after your shipment has been delivered.
• Notification to have FedEx automatically notify you and/or your customer and/or another third party by e-mail, fax, or wireless of significant shipment events, such as clearance delays, delivery attempts, releases, consolidated proofs of delivery, and pre-alerts.

The available options for Tracking service are:

Track by Tracking Number

On Single Piece Shipments, the tracking number represents the package's tracking number. This option applies to Express, Ground, Freight and Custom Critical shipments. You can track any package shipped by FedEx using TrackShipment method by providing this number as the value of idValue parameter. No extra qualifiers (date range, etc.) are required in such case, but are recommended. It is also recommended that you provide the Carrier Code to ensure the desired results for your request. This component handles tracking numbers individually, not in batch.

On Multiple Package Shipments (MPS), the tracking number represents either the master tracking number or one of the associated sequential tracking numbers for child packages. This option is available for: Express and Ground (Domestic and International) multiple-package shipments, Express and Ground (Domestic and International) C.O.D. multiple-package shipments.

Tracking by the master tracking number returns tracking data for all child tracking numbers associated with the master.

Tracking by the child tracking number returns tracking data on the specific shipment associated with that tracking number.

Track by other identifier

This identifier can be a:

• Reference Number This option applies to Express, Ground, Freight, and Custom Critical shipments. You can track packages by a reference number entered during the shipping transaction. Track by Reference Number can use any of the following sources: Shipper/Customer Reference, Invoice Number, Purchase Order (PO), Department, Part Number, Returns Material Authorization (RMA), Transportation Control Number (TCN), Bill of Lading (BOL).
• Door Tag Number This option is available for Express and Ground U.S. and Canadian shipments. This option allows you to track by a FedEx Door Tag number. A Door Tag is left at the recipient's shipping address if the recipient is not there to receive the package. A Door Tag number is linked at FedEx with the package's original tracking number. This tracking functionality allows you to track using only the Door Tag number without requiring the associated tracking number. No additional search elements are required to track by Door Tag. You may request tracking scan information for any packages shipped by FedEx by providing a valid Door Tag Number.

To track by identifiers other than tracking number, the TrackShipment method should be called by providing an idValue and the IdentifierType, as well as other required values described in detail in this method description depending on the identifier type.

When the track request has been made for an identifier of type other than Tracking Number, either the ShipperAccountNumber or the CountryCode and ZipCode (where applicable) are required to be provided in the request.

Upon successful request, the user will receive the current shipment status with a detailed tracking activity.

To confirm a shipment has been received and signed for, you can call the GetProofOfDelivery or SaveProofOfDelivery methods. With this feature, you can request a letter that includes a graphic of the recipient's signature for FedEx Express and FedEx Ground shipments. The SPOD is returned in PDF format and may be printed, browsed, or e-mailed. There is no charge for Signature Proof of Delivery.

You can use Tracking service to check the status of your shipment at any time during delivery and up to 18 months after delivery. You can use SPOD service to obtain an image of the recipient's signature (if the signature is available) once the shipment has been delivered.

SPOD is available for FedEx Express and FedEx Ground shipments, that were delivered to destinations worldwide (where available), up to 18 months from the ship date. This includes the signature image and associated shipment data.

If the ShipperAccountNumber is not provided in the SPOD request, the SPOD letter that you will obtain will contain summary information only. The letter will show only the city, state/province, and country information for the shipper and recipient.

If the ShipperAccountNumber is provided in the SPOD request, and if this account number matches the shipper or payer of the shipment, the SPOD letter will contain detailed SPOD information, and you will be able to view complete contact name, company name, street address, city, state/province, postal code, and country information for both the shipper and recipient (if available).

In the scenarios above, the signature image and additional recipient information may not be available for display in all countries and will be indicated on the SPOD where applicable.

Signatures can take up to five days to process. Even if no signature is available, you can receive the available proof of delivery information. You can also check again later for the signature. If no signature is available after seven business days, call 1.800.GoFedEx. Note that the signature may be unavailable if it was released (the sender or recipient signed a signature release agreement).

SPOD requests cannot be batch processed. If you need multiple SPOD documents, you must create multiple request transactions.

To use this component, you must have a FedEx AccountNumber. You should also have already obtained a ClientId and ClientSecret; uniquely assigned to your account by FedEx.

Property List

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

Method List

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

Event List

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

Config Settings

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

CarrierCodeDescription Property (FedExTrack Component)

FedEx carrier code description used for shipment.

Syntax

property CarrierCodeDescription: String read get_CarrierCodeDescription;

Default Value

''

Remarks

Specifies the particular carrier used to ship the packages being tracked.

Upon successful request, this is always returned when the TrackShipment and RequestEmailNotification methods are called.

This property is read-only.

EstimatedPickupDate Property (FedExTrack Component)

Estimated package pickup date for shipments that haven't been picked up yet.

Syntax

property EstimatedPickupDate: String read get_EstimatedPickupDate;

Default Value

''

Remarks

This property is returned in the server response only if applicable.

Format: YYYY-MM-DD.

This property is read-only.

FedExAccount Property (FedExTrack Component)

Login information for FedEx.

Syntax

property FedExAccount: TibxFedExAccount read get_FedExAccount write set_FedExAccount;

Remarks

This property must be set when connecting to FedEx server. It contains server and login information.

Firewall Property (FedExTrack Component)

A set of properties related to firewall access.

Syntax

property Firewall: TibxFirewall read get_Firewall write set_Firewall;

Remarks

This is a Firewall-type property, which contains fields describing the firewall through which the component will attempt to connect.

IdentifierType Property (FedExTrack Component)

Type of shipment identifier by which the shipment is to be tracked.

Syntax

property IdentifierType: TibxFIdentifierTypes read get_IdentifierType write set_IdentifierType;

TibxFIdentifierTypes = (
  fitTrackingNumberOrDoorTag,
  fitBillOfLading,
  fitCODReturnTrackingNumber,
  fitCustomerAuthorizationNumber,
  fitCustomerReference,
  fitDepartment,
  fitFreeFormReference,
  fitGroundShipmentId,
  fitGroundMPS,
  fitInvoiceNumber,
  fitPartnerCarrierNumber,
  fitPartNumber,
  fitPONumber,
  fitRMANumber,
  fitTrackingControlNumber,
  fitShipperReference,
  fitStandardMPS
);

Default Value

fitTrackingNumberOrDoorTag

Remarks

This is required if the track request will be made for an identifier other than Tracking Number.

Possible values are as follows:

To limit the number of tracking replies for a specific reference, you can enter a date range (ShipDateStart and ShipDateEnd) for this search.

When the track request has been made for an identifier of type other than Tracking Number, either the ShipperAccountNumber or the CountryCode and ZipCode (where applicable) are required to be provided in the request.

Notify Property (FedExTrack Component)

Collection of recipients to get notified.

Syntax

property Notify: TibxNotifyDetailList read get_Notify write set_Notify;

Remarks

The Notify property is required to be provided in requests for:

• shipment status (notification(s) to be sent via e-mail) - when the RequestEmailNotification method is called.

In the first scenario, When a request will be made for e-mail notifications:

For each idx = 0 to NotifyCount - 1, this must be set to an instance of the NotifyDetail type, which will contain specific information about the recipient to be notified via email, before calling the RequestEmailNotification method. See the NotifyDetail type for more information.

Each recipient to receive an e-mail notification has an Email (required), RecipientType (optional), and NotificationFlags (optional) tied to it.

For instance, if the e-mail recipients' list consists of one recipient:

component.Email(0) = "test@test.com" component.RecipientType(0) = RT_SHIPPER

This property is not available at design time.

PackageCount Property (FedExTrack Component)

The number of packages returned for a given tracking number or any other shipment identifier.

Syntax

property PackageCount: Integer read get_PackageCount;

Default Value

1

Remarks

This property contains the number of packages returned from the FedEx Server after calling the TrackShipment.

This property is read-only.

PackageDeliveryAncAction Property (FedExTrack Component)

Delivery ancillary action recommended for customer to resolve the delivery issue for the package at PackageIndex .

Syntax

property PackageDeliveryAncAction: String read get_PackageDeliveryAncAction;

Default Value

''

Remarks

This property may be returned in server response when the TrackShipment method is called.

This property is read-only.

PackageDeliveryAncActionDesc Property (FedExTrack Component)

Delivery ancillary action description. Field which holds recommended action description to resolve delivery issue for the package at PackageIndex .

Syntax

property PackageDeliveryAncActionDesc: String read get_PackageDeliveryAncActionDesc;

Default Value

''

Remarks

This property may be returned in server response when the TrackShipment method is called.

Example: "Customer not Available or Business Closed"

This property is read-only.

PackageDeliveryAncReasonDesc Property (FedExTrack Component)

Delivery ancillary reason description. Field which holds reason description associated to the status of the package at PackageIndex .

Syntax

property PackageDeliveryAncReasonDesc: String read get_PackageDeliveryAncReasonDesc;

Default Value

''

Remarks

This property may be returned in server response when the TrackShipment method is called.

Example: "Customer not Available or Business Closed"

This property is read-only.

PackageDeliveryDate Property (FedExTrack Component)

Actual date when the package at PackageIndex was delivered at destination (if applicable).

Syntax

property PackageDeliveryDate: String read get_PackageDeliveryDate;

Default Value

''

Remarks

When the TrackShipment method is called, PackageDeliveryDate is returned in the response only if the package has been delivered.

Format: YYYY-MM-DD.

This property is read-only.

PackageDeliveryEstimate Property (FedExTrack Component)

Projected delivery date for the package at PackageIndex based on the ship date, service and destination address.

Syntax

property PackageDeliveryEstimate: String read get_PackageDeliveryEstimate;

Default Value

''

Remarks

When the TrackShipment method is called, the PackageDeliveryEstimate is populated only if delivery has not already occurred.

Format: YYYY-MM-DD.

This property is read-only.

PackageDeliveryLocation Property (FedExTrack Component)

Relative location at which package at PackageIndex was left (if package delivered).

Syntax

property PackageDeliveryLocation: String read get_PackageDeliveryLocation;

Default Value

''

Remarks

When the TrackShipment method is called, PackageDeliveryLocation is returned in the response only if this package has been delivered.

This might be such as Front Desk, Back Door, etc. It is applicable for Express services only.

This property is read-only.

PackageDeliveryStatus Property (FedExTrack Component)

Delivery status description of the package at PackageIndex .

Syntax

property PackageDeliveryStatus: String read get_PackageDeliveryStatus;

Default Value

''

Remarks

This is applicable for Express services only. Maximum length: 25.

This property is read-only.

PackageErrorMessage Property (FedExTrack Component)

The error message corresponding to the PackageIndex .

Syntax

property PackageErrorMessage: String read get_PackageErrorMessage;

Default Value

''

Remarks

This property may be returned in server response when the TrackShipment method is called.

This property is read-only.

PackageIndex Property (FedExTrack Component)

The package index in a shipment being tracked.

Syntax

property PackageIndex: Integer read get_PackageIndex write set_PackageIndex;

Default Value

0

Remarks

This property contains the index of a package contained in the shipment.

The PackageCount will contain the number of packages included in a shipment and the PackageIndex will contain the package index in the list of packages.

To retrieve all attributes corresponding to a package, the PackageIndex should be set from 0 to PackageCount - 1.

PackagePackagingType Property (FedExTrack Component)

Description of packaging type of the package at PackageIndex .

Syntax

property PackagePackagingType: String read get_PackagePackagingType;

Default Value

''

Remarks

This is returned for Express services only. Possible values are: 'FedEx Envelope', 'FedEx Box', etc.

This property is read-only.

PackageReceivedBy Property (FedExTrack Component)

The name of the person who received the package at delivery (if applicable) corresponding to the PackageIndex .

Syntax

property PackageReceivedBy: String read get_PackageReceivedBy;

Default Value

''

Remarks

This corresponds to the package at PackageIndex and is returned only if this package has already been delivered. To retrieve this property, the PackageIndex should be set from 0 to PackageCount - 1.

This property is read-only.

PackageReferences Property (FedExTrack Component)

References (other than tracking number) assigned to the package at PackageIndex by either shipper or customer.

Syntax

property PackageReferences: String read get_PackageReferences;

Default Value

''

Remarks

This should be inspected after a call to the TrackShipment method. When populated, it is a string in this format: "Reference Type: Reference Value" pairs (separated by ';' if more than one reference is found).

Reference Type can be any of the following values:

This property is read-only.

PackageServiceTypeDescription Property (FedExTrack Component)

String describing the service type used to ship the package at PackageIndex being tracked.

Syntax

property PackageServiceTypeDescription: String read get_PackageServiceTypeDescription;

Default Value

''

Remarks

This might be one of FedEx available services, such as 'Priority Pack', 'Standard Overnight', etc.

This property is read-only.

PackageSignedBy Property (FedExTrack Component)

Signature of person who signed for package at PackageIndex .

Syntax

property PackageSignedBy: String read get_PackageSignedBy;

Default Value

''

Remarks

This corresponds to the package at PackageIndex and is returned only if this package has already been delivered. If the signature confirmation is not selected when the shipping label was generated, the PackageSignedBy might also be a relative location at which package was left, such as Front Desk or Back Door.

This property is read-only.

PackageTrackingNumber Property (FedExTrack Component)

Tracking number for the package at PackageIndex .

Syntax

property PackageTrackingNumber: String read get_PackageTrackingNumber;

Default Value

''

Remarks

This indicates tracking number assigned by FedEx when the shipping label was generated. Maximum length: 20.

Note: Door Tag will never be returned in the response.

This property is read-only.

PackageWeight Property (FedExTrack Component)

Weight of the package at PackageIndex .

Syntax

property PackageWeight: String read get_PackageWeight;

Default Value

''

Remarks

This corresponds to the package at PackageIndex position in the list of packages contained in the shipment.

This property is read-only.

Proxy Property (FedExTrack Component)

A set of properties related to proxy access.

Syntax

property Proxy: TibxProxy read get_Proxy write set_Proxy;

Remarks

This property contains fields describing the proxy through which the component will attempt to connect.

RecipientAddress Property (FedExTrack Component)

Identifies the recipient's address to which the shipment is destined.

Syntax

property RecipientAddress: TibxAddressDetail read get_RecipientAddress write set_RecipientAddress;

Remarks

If you choose to track by IdentifierType other than Tracking Number, when calling TrackShipment method, you must either provide the ShipperAccountNumber for the packages to be tracked, or the ZipCode (if the CountryCode supports postal codes) and CountryCode to further identify the packages you want to track. Otherwise the CountryCode and ZipCode are optional, but recommended to be provided in the track request to narrow the search.

The RecipientAddress is returned when the TrackShipment or RequestEmailNotification methods are called.

This is set to an instance of the AddressDetail type, which will contain recipient's address info. See the AddressDetail type for more information.

Upon successful request, this is always returned when the TrackShipment and RequestEmailNotification methods are called.

SenderAddress Property (FedExTrack Component)

Identifies the sender's address.

Syntax

property SenderAddress: TibxAddressDetail read get_SenderAddress;

Remarks

The SenderAddress is returned in the server response when TrackShipment is called.

This is set to an instance of the AddressDetail type, , which will contain sender's address info. See the AddressDetail type for more information.

This property is read-only.

SenderContact Property (FedExTrack Component)

Identifies the sender that requests an email notification.

Syntax

property SenderContact: TibxContactDetail read get_SenderContact write set_SenderContact;

Remarks

The SenderContact is required to be provided in requests made for:

• shipment status (notification(s) to be sent via e-mail) - when the RequestEmailNotification method is called.

This must be set to an instance of the ContactDetail type, which will contain specific contact information about the sender of requests for e-mail notification(s). See the ContactDetail type for more information.

ShipDate Property (FedExTrack Component)

The date on which the package was tendered to FedEx.

Syntax

property ShipDate: String read get_ShipDate write set_ShipDate;

Default Value

''

Remarks

Upon successful request, this is always returned when the TrackShipment and RequestEmailNotification methods are called.

Format: YYYY-MM-DD.

ShipDateEnd Property (FedExTrack Component)

End of ship date range used to narrow search.

Syntax

property ShipDateEnd: String read get_ShipDateEnd write set_ShipDateEnd;

Default Value

''

Remarks

This property value is optional to be entered in a track request (when the TrackShipment is called), but recommended as limits the results to this range. If not provided, results may vary. In this case, FedEx will default to a range that may not be useful for the search. If provided, ShipDateStart is required.

This is required though to be provided in an email notification request (when the RequestEmailNotification method is called).

Format: YYYY-MM-DD.

ShipDateStart Property (FedExTrack Component)

Start of ship date range used to narrow search.

Syntax

property ShipDateStart: String read get_ShipDateStart write set_ShipDateStart;

Default Value

''

Remarks

This property value is optional to be entered in a track request (when the TrackShipment is called), but recommended as limits the results to this range. If not provided, results may vary. In this case, FedEx will default to a range that may not be useful for the search. If provided, ShipDateEnd is required.

This is required though to be provided in a email notification request (when the RequestEmailNotification method is called).

Format: YYYY-MM-DD.

ShipperAccountNumber Property (FedExTrack Component)

Account number associated with shipment.

Syntax

property ShipperAccountNumber: String read get_ShipperAccountNumber write set_ShipperAccountNumber;

Default Value

''

Remarks

This indicates the account number associated with shipment (as opposed to the AccountNumber, which is that of the party sending the request).

This property is optional and applicable in 2 types of track services:

• Tracking request made for an identifier of IdentifierType other than Tracking Number; or
• Signature Proof of Delivery (SPOD) request;

In tracking request: When providing the ShipperAccountNumber, the server will return all packages matching the search criteria and associated with this account. If account is not specified, then the CountryCode and ZipCode (applicable countries) are required. The Reply data may be restricted if ShipperAccountNumber is not provided.

In the SPOD request transaction: To view detailed SPOD information, include the 9-digit ShipperAccountNumber when the GetProofOfDelivery or SaveProofOfDelivery methods are called. If this is not provided, or if it does not match the shipper's or payor's FedEx account number, then summary SPOD information will be provided. Otherwise, the detailed SPOD (sender's and recipient's address details) will be included in the SPOD.

SSLAcceptServerCertEncoded Property (FedExTrack Component)

This is the certificate (PEM/Base64 encoded).

Syntax

property SSLAcceptServerCertEncoded: String read get_SSLAcceptServerCertEncoded write set_SSLAcceptServerCertEncoded;
property SSLAcceptServerCertEncodedB: TBytes read get_SSLAcceptServerCertEncodedB write set_SSLAcceptServerCertEncodedB;

Default Value

''

Remarks

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

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

This property is not available at design time.

SSLCertEncoded Property (FedExTrack Component)

This is the certificate (PEM/Base64 encoded).

Syntax

property SSLCertEncoded: String read get_SSLCertEncoded write set_SSLCertEncoded;
property SSLCertEncodedB: TBytes read get_SSLCertEncodedB write set_SSLCertEncodedB;

Default Value

''

Remarks

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

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

This property is not available at design time.

SSLCertStore Property (FedExTrack Component)

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

Syntax

property SSLCertStore: String read get_SSLCertStore write set_SSLCertStore;
property SSLCertStoreB: TBytes read get_SSLCertStoreB write set_SSLCertStoreB;

Default Value

'MY'

Remarks

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

The StoreType property denotes the type of the certificate store specified by Store. If the store is password protected, specify the password in StorePassword.

Store is used in conjunction with the Subject property to specify client certificates. If Store has a value, and Subject or Encoded is set, a search for a certificate is initiated. Please see the Subject 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).

SSLCertStorePassword Property (FedExTrack Component)

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

Syntax

property SSLCertStorePassword: String read get_SSLCertStorePassword write set_SSLCertStorePassword;

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.

SSLCertStoreType Property (FedExTrack Component)

This is the type of certificate store for this certificate.

Syntax

property SSLCertStoreType: TibxCertStoreTypes read get_SSLCertStoreType write set_SSLCertStoreType;

TibxCertStoreTypes = (
  cstUser,
  cstMachine,
  cstPFXFile,
  cstPFXBlob,
  cstJKSFile,
  cstJKSBlob,
  cstPEMKeyFile,
  cstPEMKeyBlob,
  cstPublicKeyFile,
  cstPublicKeyBlob,
  cstSSHPublicKeyBlob,
  cstP7BFile,
  cstP7BBlob,
  cstSSHPublicKeyFile,
  cstPPKFile,
  cstPPKBlob,
  cstXMLFile,
  cstXMLBlob,
  cstJWKFile,
  cstJWKBlob,
  cstSecurityKey,
  cstBCFKSFile,
  cstBCFKSBlob,
  cstPKCS11,
  cstAuto
);

Default Value

cstUser

Remarks

This is the type of certificate store for this certificate.

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

SSLCertSubject Property (FedExTrack Component)

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

Syntax

property SSLCertSubject: String read get_SSLCertSubject write set_SSLCertSubject;

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.

SSLProvider Property (FedExTrack Component)

This specifies the SSL/TLS implementation to use.

Syntax

property SSLProvider: TibxTSSLProviders read get_SSLProvider write set_SSLProvider;

TibxTSSLProviders = (
  sslpAutomatic,
  sslpPlatform,
  sslpInternal
);

Default Value

sslpAutomatic

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 component 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 component will select a provider depending on the current platform.

When Automatic is selected, on Windows the component will use the platform implementation. On Linux/macOS the component will use the internal implementation. When TLS 1.3 is enabled via SSLEnabledProtocols the internal implementation is used on all platforms.

SSLServerCertEncoded Property (FedExTrack Component)

This is the certificate (PEM/Base64 encoded).

Syntax

property SSLServerCertEncoded: String read get_SSLServerCertEncoded;
property SSLServerCertEncodedB: TBytes read get_SSLServerCertEncodedB;

Default Value

''

Remarks

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

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

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

Timeout Property (FedExTrack Component)

A timeout for the component.

Syntax

property Timeout: Integer read get_Timeout write set_Timeout;

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 component will wait for the operation to complete before returning control.

The component 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 component raises an exception.

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.

TotalWeight Property (FedExTrack Component)

Total shipment weight.

Syntax

property TotalWeight: String read get_TotalWeight;

Default Value

''

Remarks

This property is returned when the TrackShipment method is called.

This property is read-only.

TrackEvents Property (FedExTrack Component)

Collection of tracking details for all scanning events that occur during the shipping process of the package at PackageIndex .

Syntax

property TrackEvents: TibxTrackDetailList read get_TrackEvents;

Remarks

It should be inspected after a call to the TrackShipment method (for each idx = 0 to TrackEventCount - 1).

Each tracking event has a Date, Time, Address1, Address2, City, State, CountryCode, Exception, and Status tied to it.

For instance, if the response contains only one tracking event:

m_date = component.Date(0) m_time = component.Time(0) m_status = component.Status(0) m_city = component.City(0) m_state = component.State(0) m_country = component.CountryCode(0)

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

Config Method (FedExTrack Component)

Sets or retrieves a configuration setting.

Syntax

function Config(ConfigurationString: String): String;

Remarks

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

These settings are similar in functionality to properties, but they are rarely used. In order to avoid "polluting" the property namespace of the component, 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.

GetProofOfDelivery Method (FedExTrack Component)

Request Signature Proof of Delivery (SPOD) for a specified trackingNumber .

Syntax

function GetProofOfDelivery(trackingNumber: String): TBytes;

Remarks

The trackingNumber parameter identifies the shipment the SPOD will be requested for. Via this method, you can receive the SPOD (when applicable) in .pdf format.

The following properties can be set when this method is called:

• AuthorizationToken (required)
• Server (optional)
• AccountNumber (required)
• ShipDate (required)
• ShipperAccountNumber (optional)

This method will return the image of the SPOD. This is the decoded binary image file of the Signature Proof of Delivery (SPOD), stored in memory.

SPOD is available for FedEx Express and FedEx Ground shipments, that were delivered to destinations worldwide (where available), up to 18 months from the ship date. This includes the signature image and associated shipment data.

If the ShipperAccountNumber is not provided in the SPOD request, the SPOD letter that you will obtain will contain summary information only. The letter will show only the city, state/province, and country information for the shipper and recipient.

If the ShipperAccountNumber is provided in the SPOD request, and if this account number matches the shipper or payer of the shipment, the SPOD letter will contain detailed SPOD information, and you will be able to view complete contact name, company name, street address, city, state/province, postal code, and country information for both the shipper and recipient (if available).

In the scenarios above, the signature image and additional recipient information may not be available for display in all countries and will be indicated on the SPOD where applicable.

Signatures can take up to five days to process. Even if no signature is available, you can receive the available proof of delivery information. You can also check again later for the signature. If no signature is available after seven business days, call 1.800.GoFedEx. Note that the signature may be unavailable if it was released (the sender or recipient signed a signature release agreement).

SPOD requests cannot be batch processed. If you need multiple SPOD documents, you must create multiple request transactions.

RequestEmailNotification Method (FedExTrack Component)

Request email notification for a specified trackingNumber to a specified Recipients list.

Syntax

procedure RequestEmailNotification(trackingNumber: String);

Remarks

The trackingNumber parameter identifies the shipment the notification will be requested for. Via this method, you send notification of package state to up to four e-mail addresses.

The following properties can be set when this method is called:

• AuthorizationToken (required)
• Server (optional)
• AccountNumber (required)
• ShipDateStart (required)
• ShipDateEnd (required)
• SenderContact (by specifying FirstName, LastName, and Email - required)
• Notify (required)
• Message (optional)

Notification allows you to request that e-mail exception and delivery notifications be sent to you, your recipient, and up to 2 other e-mail addresses (by specifying the Notify). A personal message can also be included via the Message property.

FedEx services offering this feature are FedEx Express (FDXE), FedEx Ground (FDXG), FedEx Cargo (FDXC), FedEx Custom Critical (FXCC), and FedEx Freight (FXFR). FedEx SmartPost shipments are not included in this feature.

There are three notification options:

• Shipment notification. In this case, the ntOnShipment flag should be set in the NotificationFlags property for that recipient;
• Exception notification (such as if an exception occurs during scanning and the package may be delayed, for example, or if an address correction is required. In this case, the ntOnException flag should be set in the NotificationFlags property for that recipient; or
• Delivery notification. In this case, the ntOnDelivery flag should be set in the NotificationFlags property for that recipient;

You must choose between these delivery types: wireless (to a cell phone), text only e-mail, and HTML e-mail by setting the NotificationFlags to any of the desired options.

A personal message, which can be included in the request via the Message, up to 120 characters) is allowed for e-mail notifications only. This is not applicable for wireless notifications.

If there is a problem with the trackingNumber, or recipients' information, the response will raise an error that pertains to that element. For more details on errors codes and descriptions, please refer to the Error Codes section.

Reset Method (FedExTrack Component)

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

Syntax

procedure Reset();

Remarks

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

SaveProofOfDelivery Method (FedExTrack Component)

Request Signature Proof of Delivery (SPOD) for a specified trackingNumber .

Syntax

procedure SaveProofOfDelivery(trackingNumber: String; filename: String);

Remarks

The trackingNumber parameter identifies the shipment the SPOD will be requested for. Via this method, you can receive the SPOD (when applicable) in .pdf format.

The following properties can be set when this method is called:

• AuthorizationToken (required)
• Server (optional)
• AccountNumber (required)
• ShipDate (required)
• ShipperAccountNumber (optional)

The filename parameter describes the location on disk to write the returned image of the SPOD to. This filename should have the .pdf extension.

If the filename exists, you can choose to overwrite it or not by setting the Overwrite config setting. The default value of this config is True.

SPOD is available for FedEx Express and FedEx Ground shipments, that were delivered to destinations worldwide (where available), up to 18 months from the ship date. This includes the signature image and associated shipment data.

If the ShipperAccountNumber is not provided in the SPOD request, the SPOD letter that you will obtain will contain summary information only. The letter will show only the city, state/province, and country information for the shipper and recipient.

If the ShipperAccountNumber is provided in the SPOD request, and if this account number matches the shipper or payer of the shipment, the SPOD letter will contain detailed SPOD information, and you will be able to view complete contact name, company name, street address, city, state/province, postal code, and country information for both the shipper and recipient (if available).

In the scenarios above, the signature image and additional recipient information may not be available for display in all countries and will be indicated on the SPOD where applicable.

Signatures can take up to five days to process. Even if no signature is available, you can receive the available proof of delivery information. You can also check again later for the signature. If no signature is available after seven business days, call 1.800.GoFedEx. Note that the signature may be unavailable if it was released (the sender or recipient signed a signature release agreement).

SPOD requests cannot be batch processed. If you need multiple SPOD documents, you must create multiple request transactions.

TrackShipment Method (FedExTrack Component)

Returns tracking data for requested idValue of IdentifierType type.

Syntax

procedure TrackShipment(idValue: String);

Remarks

The idValue parameter identifies the shipment. This identifier can be of IdentifierType type. Some identifiers apply to a single package (such as Package Tracking Number), while others apply to multiple packages or shipments of which they are part of. The idValue must be alphanumeric.

FedEx uses shipment identification numbers and types to identify and trace every shipment as it goes through the FedEx system to its destination. You can use this shipment identification number and type to track, locate, and verify arrival of a shipment.

When sending a tracking request to the FedEx Server, there is information that the server requires before it will process the request. The following properties can be sent in the request in order to track by tracking number or by any other identifier:

• AuthorizationToken (required)
• Server (optional)
• AccountNumber (required)
• ShipDateStart (optional)
• ShipDateEnd (optional)
• ShipperAccountNumber (optional)
• CountryCode (optional)
• ZipCode (optional)

A successful query returns all of the packages within a shipment. For example, if a shipment contained four packages, the query response would show all four packages.

If FedEx system doesn't locate any data for the requested identifier, the transaction will be considered successful and the Warning will contain the 'No data...' message. The full server reply will be saved to RawResponse.

The following properties may be populated upon method return:

• CarrierCodeDescription
• ShipDate
• PackageTrackingNumber
• PackageServiceTypeDescription
• PackagePackagingType
• PackageDeliveryStatus
• PackageDeliveryEstimate
• PackageDeliveryDate
• PackageDeliveryLocation
• PackageErrorMessage
• PackageSignedBy
• SenderAddress
• RecipientAddress
• TotalWeight and WeightUnit;
• Tracking details for each tracking event, which can be inspected via TrackEvents collection. This information consists of: Address1, Address2, City, State, CountryCode, ZipCode, Date, Time, Status and Exception.

If there is a problem with a specific identifier within the request, the response will raise an error that pertains to the specific idValue of a IdentifierType type.

For more details on errors codes and descriptions, please refer to the Error Codes section.

Error Event (FedExTrack Component)

Information about errors during data delivery.

Syntax

type TErrorEvent = procedure (
  Sender: TObject;
  ErrorCode: Integer;
  const Description: String
) of Object;

property OnError: TErrorEvent read FOnError write FOnError;

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 (FedExTrack Component)

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

Syntax

type TNotificationEvent = procedure (
  Sender: TObject;
  const Message: String
) of Object;

property OnNotification: TNotificationEvent read FOnNotification write FOnNotification;

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 (FedExTrack Component)

Fired after the server presents its certificate to the client.

Syntax

type TSSLServerAuthenticationEvent = procedure (
  Sender: TObject;
  CertEncoded: String;
  CertEncodedB: TBytes;
  const CertSubject: String;
  const CertIssuer: String;
  const Status: String;
  var Accept: Boolean
) of Object;

property OnSSLServerAuthentication: TSSLServerAuthenticationEvent read FOnSSLServerAuthentication write FOnSSLServerAuthentication;

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 (FedExTrack Component)

Fired when secure connection progress messages are available.

Syntax

type TSSLStatusEvent = procedure (
  Sender: TObject;
  const Message: String
) of Object;

property OnSSLStatus: TSSLStatusEvent read FOnSSLStatus write FOnSSLStatus;

Remarks

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

AddressDetail Type

Represents the address details of a sender or recipient.

Remarks

This type contains descriptive data of physical location of a sender or recipient.

Example: Setting the fields of a sender SenderAddress addr = new SenderAddress addr.Address1 = "100 Somewhere St." addr.Address2 = "Ste 100" addr.City = "Raleigh" addr.State = "NC" addr.ZipCode = "27154" addr.CountryCode = "US"

The properties contained by this type are listed below.

Fields

Constructors

constructor Create();

ContactDetail Type

Represents the contact information.

Remarks

This type contains descriptive data identifying the point-of-contact person (such as sender, recipient, broker, etc.).

Example: Setting the fields of the sender ContactDetail senderContact = new ContactDetail senderContact.Company = "Anything Anywhere" senderContact.FirstName = "John" senderContact.LastName = "Doe" senderContact.Phone = "1234567890" senderContact.Email = "test@test.com"

The fields contained by this type are listed below.

Fields

Constructors

constructor Create();

constructor Create(valFirstName: String; valLastName: String; valPhone: String);

constructor Create(valFirstName: String; valLastName: String; valPhone: String; valEmail: String);

constructor Create(valFirstName: String; valLastName: String; valPhone: String; valEmail: String; valCompany: String);

FedExAccount Type

Represents the details of a FedEx account.

Remarks

This type contains data describing the FedEx server and login information.

Example: Setting the fields of an account FedExAccount account = new FedExAccount account.AccountNumber = "1234567" account.AuthorizationToken = "bearer_token_value" account.Server = "https://test.fedex.com"

The properties contained by this type are listed below.

Fields

Constructors

constructor Create();

Firewall Type

The firewall the component will connect through.

Remarks

When connecting through a firewall, this type is used to specify different properties of the firewall, such as the firewall Host and the FirewallType.

Fields

Constructors

constructor Create();

NotifyDetail Type

Represents a single recipient to be notified via email.

Remarks

This type contains specific information about a recipient to be notified via email on shipment, exception and/or delivery status.

The fields contained by this type are listed below.

Fields

Constructors

constructor Create();

constructor Create(valNotificationFlags: Integer; valEmail: String; valMessage: String);

constructor Create(valNotificationFlags: Integer; valEmail: String);

constructor Create(valNotificationFlags: Integer; valRecipientType: Integer; valEmail: String);

constructor Create(valName: String);

Proxy Type

The proxy the component will connect to.

Remarks

When connecting through a proxy, this type is used to specify different properties of the proxy, such as the Server and the AuthScheme.

Fields

Constructors

constructor Create();

constructor Create(valServer: String; valPort: Integer);

constructor Create(valServer: String; valPort: Integer; valUser: String; valPassword: String);

TrackDetail Type

Indicates the tracking details.

Remarks

This type contains the results of a tracking search made after a call to the TrackShipment method. The fields contained by this type are listed below.

Fields

Config Settings (FedExTrack Component)

FedExTrack 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 (FedExTrack Component)

FedExTrack Errors

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