Search The Knowledge Base


Browse By Category

Can NRGship for UPS and NRGship Pro for UPS be integrated with web sites or desktop applications?
User Opinions (11 votes)
100% thumbs up 0% thumbs down

How would you rate this answer?
Helpful
Not helpful
NRGship for UPS and NRGship Pro for UPS can be easily integrated to a web based applications or even a Mac application via the nrgship:// URL type.

Following is an example of a sample URL. You must have NRG's UPS Shipping Software installed for this to work.

Clicking on the link will populate all shipping data in the application, but a label will not be generated:

nrgups://newShipment/?Service=UPS Ground;ShipTo_Name=Mike Smith;ShipTo_AddressLine1=4100 S Avon;ShipTo_City=New Berlin;ShipTo_StateProvinceCode=WI;ShipTo_PostalCode=53151;ShipTo_EmailAddress=user@domain.com

You may also want to review our URL Generator tool so you can see how easy it is to create custom URLs with little coding.

How To Make Your Own Shipping URL
Simply construct a URL that starts with nrgups://newShipment/? and append any of the elements from the list below.

Be sure to URL encode any values (like spaces or line feeds). For example, you can use a function like rawurlencode() in PHP.

When a user clicks on a URL link, the NRGship app will activate and populate the screen with the information contained in the URL without the need to copy and paste. Also note the automation commands to capture the weight or automatically ship.

The elements below can be used to specify default values for a new shipment.

ShipTo_Name
ShipTo_AttentionName
ShipTo_AddressLine1
ShipTo_AddressLine2
ShipTo_AddressLine3
ShipTo_City
ShipTo_StateProvinceCode
ShipTo_PostalCode
ShipTo_Country
ShipTo_PhoneNumber
ShipTo_ResidentialAddress [1 if true]
ShipTo_EmailAddress

Service [see below for valid service types]
SaturdayDelivery [1 if true]

BillToRadio [My UPS Account, Receiver, Consignee, Third Party - Credit Card is NOT an option]
BillToUPSAccountNumber
BillToPostalCode

Package_Packaging [See below for valid packaging types]
Package_Weight
Package_Dim_Length
Package_Dim_Height
Package_Dim_Width
Package_InvoiceNumber
Package_ReferenceNumber
Package_InsuredValue
Package_AddlHandling [1 if true]
Package_CODAmount
Package_CODCashiersCheckMoneyOrderOnly [1 if true]
Package_DeliveryConfirmationType [Blank, No Signature, Signature Required, Adult Signature Required]
Package_ShipperRelease [1 if true]
Package_VerbalConfirmation [1 if true]

ReturnService [See below for valid return types]

In addition, there are two more commands which can be used for shipping automation. 

Append ";autoShip=true" to the URL to invoke automatic shipping
Append ";autoWeight=true" to automatically capture the weight off a digital scale

Service Types
UPS Ground
UPS Next Day Air
UPS 2nd Day Air
UPS 3 Day Select
UPS Next Day Air Saver
UPS Next Day Air Early AM
UPS 2nd Day Air AM

Packaging Types
Package
Envelope
Tube
Pak
Box - Large
Box - Medium
Box - Small

Return Types (NRGship Pro only)
UPS Print Return Label
UPS Electronic Return Label
UPS Print and Mail Return Label
UPS Returns Plus (Call Tag) - 1 Attempt
UPS Returns Plus (Call Tag) - 3 Attempts


Related Articles
No Related Articles Were Found
Attachments
No Attachments Related to This Article

Continue