Newgistics
Account Number and Services
When you add a new Newgistics carrier account (Add Carrier > Carrier > Newgistics), Parcel displays the screen to enter the Newgistics account number. On this screen, you also select the Newgistics services with which you will ship packages from this location.
To configure the Newgistics account number and services, complete these steps...
-
In the Account Number field, type the Newgistics account number for this location.
-
In Carrier Code field, type a name for the carrier as you want it to appear on the Web Admin (Configuration) Tool screen. For example, if you are setting up more than one Newgistics account for this location, you might want to label these NWGST-1, NWGST-2, etc.
-
In the Display Name field, type the name of the carrier as you want it to appear in the drop-down list on the Warehouse screen.
-
In the Services section, select the services that you will use to ship Newgistics packages from this location by selecting the service, and then click ADD to move the selected service from the left-hand column to the right-hand column. To select and move all of the services at once, click ADD ALL.
You can also use the Move Up and Move Down (up arrow and down arrow) on the right to change the order of the services in the list of following services. Services appear in the configured order on the Services drop-down list on the Warehouse screen.
Name on Service drop-down list
Brief description
Bound Printed Matter
Bound Printed Matter (BPM) service is for permanently-bound sheets of advertising, promotional, directory or editorial material such as catalogs and phone books.
BPM Parcels
Bound Printed Matter (BPM) service is for permanently-bound sheets of advertising, promotional, directory or editorial material such as catalogs and phone books.
BPM Irregular Parcels
Bound Printed Matter (BPM) service is for permanently-bound sheets of advertising, promotional, directory or editorial material such as catalogs and phone books.
BPM Flats
Bound Printed Matter (BPM) service is for permanently-bound sheets of advertising, promotional, directory or editorial material such as catalogs and phone books.
First Class Package Service
First Class Mail for packages (parcels).
First Class Letters
First Class Mail for letters.
First Class Flats
First Class Mail for large envelopes.
Media Mail
Media Mail is for books, sound recordings, recorded video tapes, printed music, and recorded computer-readable media (such as CDs, DVDs, and diskettes).
Parcel Post
Small and large packages, thick envelopes and tubes containing gifts and merchandise can be sent using Parcel Post.
Parcel Select
Designed for large- and medium-sized shippers looking for an economical ground delivery service; provides discounts for mailing sorted parcels closer to their ultimate destination.
Std Mail Letter Automation
Discounted postage rates are available for automation-compatible mail if it meets specific standards so it can be scanned and processed by automated mail processing equipment at the Post Office. The automation standards involve size, shape, materials, readability, and correct bar coding.
Std Mail Letter Non-Auto
Letters containing mailable items not required to be sent using First-Class Mail can be sent using Standard Mail. Standard Mail Letter is typically used for advertisements and flyers.
Std Mail Flat Automation
A mail flat is an assembly for mailing a (usually commercial) article meeting USPS mail flat standards for uniformity and flexibility for automated mail processing. A flat is generally rectangular within a USPS specified dimensions; for example, a plastic-wrapped standard-sized magazine mailed to subscribers.
Discounted postage rates are available for automation-compatible flats if they meet specific standards so that they can be scanned and processed by USPS automated processing equipment. USPS automation standards involve size, shape, materials, readability, and correct bar coding. For more information, see the USPS Web site.Std Mail Flat Non-Auto
This type of mail meets the USPS specifications for flats (see previous row) but cannot be processed by USPS automated processing equipment.
Priority Mail Parcels
Priority Mail is for delivery of documents and packages in an average of 2 to 3 days.
Prty Mail Lg Flat-Rate Box
Priority Mail is for delivery of documents and packages in an average of 2 to 3 days.
Prty Mail Lg Flat-Rate Box APO/FPO
Priority Mail is for delivery of documents and packages in an average of 2 to 3 days.
Prty Mail Small Flat-Rate Box
Priority Mail is for delivery of documents and packages in an average of 2 to 3 days.
Priority Mail Flat Box
Priority Mail is for delivery of documents and packages in an average of 2 to 3 days.
Priority Mail Flat Envelope
Priority Mail is for delivery of documents and packages in an average of 2 to 3 days.
Parcel Return Service
The Newgistics implementation of the USPS Parcel Return Service includes the SmartLabel® system involving a special barcode that enables Newgistics to deliver the return directly to the shipper including an alert.
Note: The Newgistics Parcel Return Service is zero-rated. Parcel processes a Rate request for this service but returns $0.00 for the rate.Parcel Select Lightweight Irregular
Parcel Select Lightweight Irregular pieces must weigh less than 16 ounces.
Parcel Select Lightweight Machinable
Parcel Select Lightweight machinable pieces must weigh less than 16 ounces.
Standard Mail Marketing Parcel
Marketing Parcels have a maximum size of 12 x 9 x 2 inches.
Note: Newgistics operates in conjunction with the US Postal Service, which makes the actual deliveries of shipments. The services listed in the previous table are a subset of USPS services. For more information on Newgistics services including service codes and detailed descriptions, see Newgistics > Overview.
-
When you are done configuring this page, click SAVE in the lower-right corner of the page to save the settings. Otherwise, click CANCEL to cancel the settings.
To continue configuring Newgistics, complete the following sections:
-
Account Defaults
-
Import Files
-
USPS Fees
Account Defaults
Overview
Use the following tabs on the Newgistics Account Defaults screen to configure the default information to use with this Newgistics account.
Tabs
-
Address
-
Account
-
First Leg Shipment
-
Communication
-
Report Server
-
Tracking
-
Parcel Return Service
Address Tab
Use the Address tab on the Newgistics Account Defaults screen to enter the default "Ship From" information for this Newgistics account.
Note: The fields on this tab are automatically populated with the address information entered for the location under which the Newgistics carrier is added. Use this screen to provide any additional address information that may be need or to change this information as required.
In this box... |
Do this... |
Name |
Type the "Ship From" company name. |
Attention |
Type the name of the contact person at the "Ship From" address. This is the "Attention" name to be displayed on this Newgistics carrier label. |
Address 1 |
Type the "Ship From" street address. |
Address 2 |
Type any additional street address information for the "Ship From" address such as suite or floor number. |
Address 3 |
Type any additional street address information for the "Ship From" address such as suite or floor number. |
City |
Type name of the "Ship From" city. |
State |
Type the two-letter USPS abbreviation for the "Ship From" state. (Newgistics supports only US origins); for example: MA |
Zip |
Type the "Ship From" ZIP code. |
Country Code |
If it is not already the default, select "United States" from the drop-down list, since this is the only country of origin that Newgistics supports. |
Phone |
Type the nine-digit "Ship From" phone number (no spaces or dashes). |
Click SAVE in the lower-right corner of the screen to save the changes or click CANCEL to revert to previous values.
Account Tab
Use the Account tab on the Newgistics Account Defaults screen to enter the account information for this Newgistics account.
In this box... |
Do this... |
Mailer ID |
Type the Mailer ID assigned to you by the US Post Office. |
Location ID |
This field is read-only. It displays the location ID entered when you set up the location under which this carrier is configured. Note that this value is the same as the Shipper ID. Parcel automatically populates this field with the location ID. |
Client ID |
Type the Client ID assigned to this account by Newgistics. |
Origin Facility ID |
Type the Origin Facility ID assigned to this account by Newgistics. |
Induction Facility ID |
Type the Induction Facility ID assigned to this account by Newgistics.
|
Rate Origin Code |
This field is read-only. It displays the origin ZIP code for Parcel to use for rating purposes. Parcel automatically populates this field with the ZIP code entered for the shipper's location under which this Newgistics carrier is configured.
|
Dimensional Factor |
Type any USPS-negotiated Dimensional Factor to be applied to package volume for Priority Mail only if different from the default of 194; otherwise, do not edit this field and accept the default. Parcel uses the dimensional factor to calculate rates. |
Balloon Weight |
Type any USPS-negotiated weight in pounds for the balloon rate only if different from
the default of 20; otherwise, do not edit this field and accept the default. Parcel uses this value to rate shipments by a Newgistics carrier.
|
Fuel Surcharge % |
This field is read-only. It displays the fuel surcharge as a percent for Parcel to apply to a package; for example: 20.00 for 20%.
|
Customer Charge |
Depending on the Customer Charge Type (see preceding row), type any customer charge to be added to a shipment (in addition to other accessorials such as Freight Charge) as follows:
|
Customer Charge Type |
From the drop-down list, specify whether customer charge is to be taken as a fixed amount or a percentage amount:
|
Print Documents on Close |
Select (check) this check box to specify default automatic printing of documents when a Newgistics shipment is closed.
|
No. of Copies for Documents |
Type the default number of copies of documents to be printed if the Print Documents on Close check box (previous row) is selected.
|
Click SAVE in the lower-right corner of the screen to save the changes or click CANCEL to revert to previous values.
First Leg Shipment Tab
Use the First Leg Shipment tab on the Newgistics Account Defaults screen to enter information about the First Leg Carrier (see below), Bill of Lading (BOL), and minimum surcharge information for use with this Newgistics carrier account.
Notes:
-
All fields on this tab are optional. You need to fill in these fields only if the first leg of the shipment is being handled by Newgistics via contract with a third-party carrier. If the shipper is providing transport of the shipment to the Newgistics hub, then leave the fields on this tab blank.
-
Unless otherwise noted, all settings apply only to this Newgistics carrier account at this location.
-
The settings in this table are default settings for these values. The following settings can be overwritten on the popup dialog that Parcel displays when you Close a Newgistics shipment: - Freight Carrier (First Leg Carrier) - Class (Commodity Class) - Handling Unit - Print Handling Type Labels.
Note: For more information on closing a Newgistics shipment, see the section Newgistics > Processing a Newgistics Shipment.
Freight Carrier section (First Leg)
For more information on this, see Newgistics > Overview.
In this box... |
Do this... |
Freight Carrier |
If:
|
Freight Service |
Type the name of the freight service for the first leg of the shipment. |
Bill of Lading Settings section
In this box... |
Do this... |
Class |
Type the default National Motor Freight Classification (NMFC) Freight Class that you want Parcel to print on the Bill of Lading for the First Leg shipment.
|
Handling |
Type the default Handling Unit that you want Parcel to print on the Bill of Lading for the First Leg shipment. (See Note in previous row.)
|
Print Handling Type labels |
Select (check) this check box to enable the automatic printing of Handling Unit Labels when you Close a Newgistics shipment.
|
Minimums Surcharge section
Caution: You must leave the fields in this section blank unless Newgistics has provided you with these values.
In this box... |
Do this... |
Piece Count |
Type the piece count for the first leg surcharge if and only if this information is provided by Newgistics. |
Total Weight |
Type the total minimum weight to which the first leg surcharge is to be applied if and only if this information is provided by Newgistics. |
Surcharge Amount |
Type the first leg surcharge amount if applicable. |
Third Party Billing
Use these fields if Newgistics is handling the first leg of the shipment by contract with a third-party carrier. Newgistics provides the information described in the following table.
Name |
Type the Third Party company name. |
Address |
Type the Third Party street address. |
City |
Type name of the city where the Third Party is located. |
State |
Type the two-letter USPS abbreviation for the Third Party state. (Newgistics contracts only US carriers); for example: MA |
Zip |
Type the Third Party ZIP code. |
Special Inst. |
Type any special instructions required for the Third Party Billing section on the Bill of Lading. |
Click SAVE in the lower-right corner of the screen to save the changes or click CANCEL to revert to previous values.
Communication Tab
Use this screen to enter the information that allows Parcel to access the Newgistics SFTP servers for uploads and downloads the files.
In this box... |
Do this... |
SFTP Server |
Type the name of the Newgistics SFTP server where you want Parcel to upload and download the files.
|
SFTP Port |
Type the port number of the Newgistics SFTP server where you want Parcel to upload and download the files or accept the default value: 22 (recommended). |
SFTP User ID |
Type the user id for your account on the Newgistics SFTP server where you want Parcel to upload and download the files. |
SFTP Password |
Type the login Password for the SFTP server where you want Parcel to upload and download the files. |
SFTP Upload Directory |
Type the directory on the Newgistics SFTP server where you want Parcel to upload the files.
|
SFTP Download Directory |
Type the local directory where you want Parcel to download the files. |
Click SAVE in the lower-right corner of the screen to save the changes or click CANCEL to revert to previous values.
Sending/Receiving Files via SFTP
All the necessary files for setting up and using a Newgistics carrier are available on the Newgistics SFTP server: Testftp.newgistics.com
When you click the link, the Newgistics SFTP server displays a login dialog. After login with the user name and password provided by Newgistics, you are in the home directory (<Home_directory>) under which the necessary file folders are located as follows:
-
Download file - <Home_directory>/read\ShipSys
-
Upload files - <Home_directory>/write\Manifests
The following table lists and describes Newgistics file prefixes:
Prefix |
Description |
PS |
Package Status |
Notes:
-
You can arrange with Newgistics for automated downloading of files.
-
Files are archived and removed from the SFTP site after two months.
Report Server Tab
Use the Reports tab on the Newgistics Account Defaults screen to enter settings related to the Jasper reporting tool.
Caution: If a field on this tab contains a default value, it is strongly recommended that you accept the default and do not try to enter a different value. If you think you need
to change any of the default settings, contact Customer Support first at: 1.866.649.1900.
In this box... |
Do this... |
Location |
Accept the default. This is the path to the directory where the Jasper report service is started. The current service deployment directory is fixed. Unless the service will be moved to another directory, the service should be started from the default location, which is: ..\Java |
Report Format |
Accept the default. This is the file format of the Newgistics reports. Currently, only PDF is supported. |
Requestor |
Accept the default: "Parcel" (without quotation marks) is the default Requestor. |
Server Name |
If the current service name appears as the default, accept the default. Otherwise, type the Jasper report service name. Unless the service will be recompiled with a new service name, the default service name should be used to start the report service. |
Server Level |
Leave this field blank or else type "debug" or "trace" (either without quotation marks) to log transactions taking place on the Server side. This sets the report service (Server side) debug logging level. Blank means normal, which means no debug logging. |
Server Wait Time |
The number of seconds to wait for the Jasper report service to start before sending an XML request. |
Print Report |
Select this check box to automatically send the report to the printer that is set in the printer map.
|
Enable Debugging |
Select this check box to create the debug request and response files. (See the following rows. These files contain the transactions that occur on the client side). The debug files are useful in troubleshooting any problems. |
Debug Request Filename |
Type the path (to store) and the file name of the XML debug requests.
|
Debug Response Filename |
Type the path (to store) and the file name of the XML debug responses.
|
Click SAVE in the lower-right corner of the screen to save any changes you make or click CANCEL to revert to the original values.
Tracking Tab
Use the tracking tab to specify a tracking number range and the date on which the tracking range goes into effect.
Note: Packages shipped via Newgistics can be tracked by:
-
Full delivery confirmation barcode - For example: 420100249102133270106313393487
-
USPS Package Identification Code (PIC) - For example: 9102133270106313393487
-
Client reference number (tracking number) - For example: 1435686945344
Values entered on this screen provide the client reference number.
In this box... |
Do this... |
Start Tracking Number |
Type the first (lowest) tracking number in the tracking number range for Parcel to use to generate tracking numbers for Newgistics packages. |
End Tracking Number |
Type the last (highest) tracking number in the tracking number range for Parcel to use to generate tracking numbers for Newgistics packages. |
Click SAVE in the lower-right corner of the screen to save the changes or click CANCEL to revert to previous values.
Parcel Return Service Tab
Use the Parcel Return Service tab to specify values for the Newgsitics Parcel Return Service according to the following tables:
Top section
In this box... |
Do this... |
Mailer ID |
Type the Mailer ID assigned to you by Newgistics for Returns shipments. |
Mailer Sort Code |
From the drop-down list, select the Default Mailer Sort Code for Returns shipments for this Newgistics carrier. For more information on Mailer Sort Codes and for Help on entering Mailer Sort Codes for this list to display, see the following
section Mailer Sort Codes
.
|
Client Service Flag |
From the drop-down list, select one of the following values for the Default Client Service Flag:
|
Merchant ID |
Type the four-character alphanumeric identifier ("Merchant ID") assigned to you by Newgistics. |
Start Tracking Number |
Type the Start Tracking Number for the USPS Barcode generated on the SmartLabel or accept the default (1). |
End Tracking Number |
Type the End Tracking Number for USPS Barcode generated on SmartLabel or accept the default (9999999999). |
Returns Label Template |
Type the filename of the Label Template to be used for Parcel Return Service shipments.
|
SmartLabel Client Data section
In this box... |
Do this... |
Client Data Version |
Type the Client Data Version registered with Newgistics to identify client data. For your initial SmartLabel implementation, this value is set to 1. In subsequent revisions to the SmartLabel barcode, the field is incremented. |
Client Data Name |
Type the Client Data Name registered with Newgistics to identify what the client data represents.
|
Generate Client Data |
Select (check) this check box to enable Parcel to generate a ClientData sequence number when no SmartLabel Client Data is provided on the Warehouse Options screen for the package. (You can provide Client Data on a package-by-package basis by entering it in the SmartLabel Client Data field on the Warehouse Options screen.) If you select this check box, Parcel automatically generates this value for each package but does not display this value on the Options screen. If you select this check box, but then enter a value on the Options screen, Parcel uses the value you entered.
|
Start ClientData Number |
Type the start of the range for Client Data sequence numbering. |
End ClientData Number |
Type the end of the range for Client Data sequence numbering. |
ClientData Data Size |
Type the number of zeroes to be prepended (added to left side) of each Client Data sequence number; for example: if you type 12 in this box and the generated Client Data sequence number is 1234, the final sequence number appears as 0000000000001234. |
Click SAVE in the lower-right corner of the screen to save any changes you make or click CANCEL to revert to the original values.
Time in Transit Tab
Use the Time In Transit tab on the Newgisitcs Account Defaults page to enter settings related to time in transit (TINT) for this Newgistics Carrier account.
In this box... |
Do this... |
Calculate Transit Time |
To specify calculation of transit times, select (check) this check box. Parcel uses the data that you import using the Import Time in Transit Files screen for transit time calculations.
|
Click SAVE in the lower-right corner of the screen to save any changes you made or click CANCEL to cancel changes and revert to original values.
Note: For information on configuring Time in Transit calculations, see the following Help topics:
-
Overview of TINT Calculation
-
Time in Transit Files
-
Importing Time in Transit Files
Import Files
Rating is performed for Newgistics services on a per package basis. All clients negotiate their rates with Newgistics. Parcel automatically downloads the necessary files from the Newgistics FTP server. You can then import these files using the Import Files screen.
Notes:
-
For more information on downloading Newgistics files, see the section: Communication Tab.
-
Newgistics rate tables are effective dated.
To import the Newgistics rating files, on the Import Files screen, click IMPORT. This process may take up to five minutes.
Note on rating with Newgistics carriers
In addition to zone/weight rating, Newgistics has additional package level and trailer level fees. These are surcharges for LTL shipments:
Package Level Fees
The following package-level fees may apply to a shipment:
-
Fuel Surcharge - Based on a fuel surcharge that is set monthly by Newgistics. The fuel surcharge percentage is applied on a per piece basis.
-
Delivery Confirmation - Charges are applied when the service is available for the mail class and has a specified additional charge.
-
Signature Fee - Signature confirmation charges are applied as specified in the USPS Rate Fold.
-
Special Handling - These are per piece charges.
-
Miscellaneous Fees - These are per piece charges.
-
Balloon Rate - This follows US Postal Specifications but Newgistics also negotiates this rate with clients.
-
Non Machinable Fee - This follows US Postal Specifications but Newgistics also negotiates this rate with clients.
Trailer Level Fees
The following trailer-level fees may apply to a shipment:
-
Minimum Weight Surcharge - Shipment does not meet minimum weight criterion for an LTL shipment.
-
Minimum Volume Surcharge - Shipment does not meet minimum volume criterion for an LTL shipment.
USPS Fees
Parcel automatically imports a set of files that populate this screen with a table of standard USPS surcharge for services and handling fees assessed in addition to Newgistics fees.
Caution: All the information in this able is read-only and is provided for informational purposes only and is updated by Newgistics via Parcel to coincide
with rate adjustments announced by the US Postal Service. The table on this screen is editable but you should make modifications to it only under exceptional circumstances and after consultation with Newgistics. If you should need to edit this table (for example, to implement a necessary immediate update of USPS rates), you can do so manually according to the following procedure.
The fields in this table have the following values:
Field... |
Description... |
Start Date |
The date on which the USPS fee goes into effect. |
End Date |
The final date after which the USPS fee is no longer in effect. |
Fee Key |
The key for Parcel to add to the carrier database; for example: PSEL_Delivery_Confirmation (for Parcel Select Delivery Confirmation) |
Fee Value |
The fixed dollar amount for the fee for the period from Start Date to End Date during which it is in effect. |
Mailer Sort Codes
Newgistics uses the Mailer Sort Code to identify certain characteristics of the return for processing purposes. The specifics of this usage are negotiated between the customer and Newgistics. Newgistics assigns one or more Mailer Sort codes to each customer.
Notes:
-
If the customer is assigned more than one Mailer Sort Code, Newgistics provides instructions on which code to use under what circumstances.
-
Each Mailer Sort Code for the Parcel Return Service consists of 3-5 characters. The Mailer Sort Code prints in reverse type (white characters on black background) in the lower right corner of the Newgistics SmartLabel and determines which Disposition Rule Set to use.
Use this screen to enter the following information for the Mailer Sort codes for this account as follows.
To add a Mailer Sort Code Record
-
Click ADD icon at the top of the screen. The Add Record dialog is displayed.
-
Complete the boxes as follows:
In this box...
Do this...
Mailer Sort Code
Type the Mailer Sort Code assigned by Newgistics. Parcel displays this value in the drop-down lists for Mailer Sort Code on the Parcel Return Service tab of the Newgistics Account Default screen and on the Warehouse Options screen Package Options area for a Newgistics shipment using the Parcel Return Service.
Note: For information on specifying Mailer Sort Codes with Newgistics shipments, see Newgistics > Processing a Shipment .Disposition Rule Set
Type the two-digit code of the customer-specific Disposition Rule Set name provided by Newgistics and associated with the Mailer Sort Code. The Disposition Rule Set determines how the package is sorted (its "disposition").
Description
Type the Client Description for the Mailer Sort Code.
Note: Newgistics does not provide this description. This field enables users to associate their own descriptions with Mailer Sort Codes. -
Click SAVE to save the new record. Otherwise, click CANCEL to cancel the new record.
To edit a Mailer Sort Code Record
-
Click the EDIT icon in the left column in the row containing the record that you want to edit.
-
A dialog box appears. Edit the fields as needed.
-
Click SAVE at the bottom of the dialog box to save the changes or click CANCEL to cancel your changes..
To delete a Mailer Sort Code Name Record
-
Click DELETE icon in the left column in the row containing the record that you want to delete.
-
A confirmation dialog box appears. Click OK to delete the record. Or click Cancel to keep the record.