GetPackageLabel Method

Generates a shipping label for the specified package.

Syntax

canadapostship.getPackageLabel(packageIndex, [callback])

Callback

The 'callback' parameter specifies a function which will be called when the operation completes (or an error is encountered). If the 'callback' parameter is not specified, then the method will block and will not return until the operation completes (or an error is encountered).

The callback for this method is defined as:

function(err){ }

'err' is the error that occurred. If there was no error, then 'err' is 'null'.

'err' has 2 properties which hold detailed information:

err.code
err.message

Remarks

When this method is called, the following properties must have been set:

• CanadaPostAccount (required)
• GroupId (required if CanadaPostContractId is set)
• Packages (required)
• PaymentMethod (required if CanadaPostContractId is set)
• RecipientContact (required)
• RecipientAddress (required)
• SenderContact (required)
• SenderAddress (required)
• ServiceType (required)
• ShipmentSpecialServices (optional)

To print out the PackageShippingLabel, you can save it to the PackageShippingLabelFile file in LabelImageType format.

In order to print a label and manifest to be tendered to a Canada Post driver, you must:

1. Assign each shipment a GroupId and then call GetPackageLabel for each package in the shipment.
2. Call TransmitShipments with the GroupId for the shipment.
3. Call GetManifest for each manifest in ManifestDetails.

Note that this only applies when submitting a contract shipment (ie. CanadaPostContractId is set).