Configuring the AgileElite shipment server

Certain configurations must be performed on the AgileElite shipment server.

Such configurations pertain to the following:

Organization and location

An organization is an entity that ships packages. The AgileElite shipment server setup requires at least one organization to be added to the AgileElite shipment server.

A location refers to an organization's address. Every organization must have at least one location associated with it. The address will be overridden by the transactional requests sent by the Sterling Pierbridge Adaptor. The will not use the details pertaining to the organization that has been added to the AgileElite shipment server.

Carrier

The carriers that are supported by the Sterling Pierbridge Adaptor are listed in Table 1. These carriers should be enabled on the AgileElite shipment server. The AgileElite shipment server uses the ConnectShip server to integrate with the UPS and USPS carriers. Ensure that these carries are enabled in the ConnectShip server too.

User

The AgileElite shipment server uses the Windows user as the AgileElite shipment server user. The transactional requests sent by the Sterling Pierbridge Adaptor are sent with respect to this Windows user that exists on the AgileElite shipment server. Therefore, when configuring a user, ensure that the Windows User Name is exactly the same as the ShipperAccountNumber on the Sterling Selling and Fulfillment Foundation. The Sterling Selling and Fulfillment Foundation sets the ShipperAccountNumber Parcel Carrier Adapters XML attribute with the Shipping Account in the Parcel Carrier Preference for ShipNode and Enterprise. Similarly, a user must be configured on the AgileElite shipment server with the same User Name as that of the default Rate Request User provided in the <INSTALL_DIR>/properties/yfs.properties_ycs_ext file.

After a user is configured, necessary permissions must be granted to the user in order to allow the user to perform relevant shipping activities. For activities such as shipping a container, if the bill payer is not specified in the request sent by the Sterling Pierbridge Adaptor, the bill payer value that is configured in the Default Bill Payer field in the Permissions tab of the AgileElite shipment server becomes the default value.

Accounts

The AgileElite shipment server connects internally with the ConnectShip server and the FedEx server in order to ship packages using various carriers. Ensure that the necessary security credentials and account information are configured for the carriers on the AgileElite shipment server. Also ensure that the user has the required permission to ship the packages using the carriers configured on the AgileElite shipment server.

Device

When configuring the device (in this case, a printer for printing labels) and providing a description of the printer on the AgileElite shipment server, ensure that you enter the complete path to the printer on the network. This path must match the printer alias of the printer configured on the Sterling Selling and Fulfillment Foundation.

Output

In order to configure the formatting of shipping labels and other documents, provide the required permissions for the AgileElite shipment server users to allow them to print labels, return labels, and documents. All AgileElite shipment server users should be granted permission to use all the printers that are configured using the Device tab. If a user wants to save labels as images, configure the PrinterType field as Client on the AgileElite shipment server, under the Outputs tab. When this configuration is completed, the URL of the labels will be returned as output in response to the ship transaction. This URL will be in encoded format.

Notes

When the Save label as images option is set in the Sterling Selling and Fulfillment Foundation, a user must manually configure the PrinterType field as Client on the AgileElite shipment server. Also, in the AgileElite shipment server, select Images from the Format drop-down list by navigation to Outputs > Config.

When a user wants to print a label using a specific printer, and if that printer is incorrectly configured in the Outputs tab of the AgileElite shipment server, by default, the label is printed using the first available printer configured in the Outputs tab.

It is recommended that in the Outputs tab of the AgileElite shipment server, you select only the specific user or user group from the User/Group drop-down list to whom you want to grant permission to perform certain configurations, and not all users.