On this page:
Table of Contents | ||||||||
---|---|---|---|---|---|---|---|---|
|
...
Please note; if you would like the API response to send the label directly to your printer, you will need to have the OmniParcel Print Agent installed on the PC where the printer is located. To download the OmniParcel Print Agent go to visit our Print Agent Installation Guide.
3.2 Parameters Required
Parameter | Mandatory | Type | Description | ||
---|---|---|---|---|---|
Origin | N | Multiple fields | |||
Destination | Y | Multiple fields | |||
DeliveryInstructions | N | String(120 Characters) | For special instructions for delivery to appear on label
| ||
SendTrackingEmail | N | Boolean (true/false) | Should a track and trace email be required to be sent
| ||
Packages | Y | Multiple fields | |||
Commodities | Y | Multiple fields | |||
issignaturerequired | N | Boolean (true/false) | If “true”, Signature on Delivery is required. If “false”, no signature on delivery is required | ||
DeliveryReference (CustomerRef) | Y | String (1000 characters) | Shipment reference number (commonly used for the online order number) | ||
Reference2 | N | String (500 characters) | Additional Shipment Reference | ||
Reference3 | N | String (500 characters) | Additional Shipment Reference | ||
PrintToPrinter | N | Boolean (true/false) | If “true” system will send job to installed Print Agent.
| ||
Outputs | Y | Requested label size and format. Response will be provided in JSON string array. Refer to Output Information | |||
Carrier | N | String(50 Characters) | Where multiple carrier options are available, a carrier can be pre-nominated. E.g “Omni Parcel”. | ||
Service | C | String (max length defined by available services) | Where multiple service options are available, a service must be pre-nominated. Eg. “eCommerce Standard Tracked“ “eCommerce Express Tracked“ “Domestic Express“ “Domestic Standard“ “Domestic Large Parcel” | ||
ShipType | N | String (10 characters) | Use “INBOUND” for returns, Not required for normal outbound shipments (Used by OmniReturns only) | ||
DutiesAndTaxesByReceiver | Y* | Boolean (true/false) | True = DDU (Duties and Taxes will need to be paid by recipient) False = DDP (Duties and Taxes will need to be paid by the sender)
| ||
ProductCategory | N | String (50 characters) | Parent category, e.g. stationary, fashion, beauty products, shoes etc | ||
SendLabel | N | String (1 Character) | “Y” Or “N” – if “Y” then email with the label attached will be sent to end customer (used by OmniReturns only) | ||
LabelBranding | N | Object (see “description) | public class CustomBranding
public string LogoFilename { get; set; }
| ||
IncludeLineDetails | N | Boolean (true/false) | If “True” OmniParcel will return all relevant tracking numbers in the “Items” tag under “Consignments” If “False” OmniParcel will return the consignment number only See sample request below for more information
| ||
InvoiceData | N | String (no max limit) | For passing the commercial invoice to OmniParcel | ||
CODValue | N | Decimal (18,4) | COD Value (Cash on delivery amount). Only used for some carriers | ||
CostCentreId | N | String | Cost Centre id # if known | ||
CostCentreName | N | String | Name of Cost Centre or code if known | ||
TaxCollected | C | Boolean (true/false) | Required by some carriers and when shipping to some countries | ||
AmountCollected | C | Decimal (18,2) | The tax amount that has been collected. Required by some carriers and when shipping to some countries. Please note that this is on consignment level, not commodity level | ||
TaxIDs | C | Multiple fields |
...