Label Specification
This section details the Orchestro standard label design format and specifications for its use.
Standard Label Use
All parcels sent to the Orchestro platform must use this standard label for proper routing and rating. Labels are available through the Orchestro platform.
Standard Label Certification
Carrier Partners, calling the API and generating labels must submit test samples to the Orchestro label team for certification prior to physical parcel shipping. This is to ensure proper implementation of the standard label format.
Submit samples to partner.integration@orchestro.ai with Label Certification in the subject line. Carrier’s integration team can also assist in the certification process.
Standard Label Design
The Orchestro standard label is designed to ensure interoperability across the network. Barcodes and tracking IDs are required to be recognized and understood by all participating carriers.
This label features a GS1-128 1D barcode for the Orchestro universal tracking ID, along with a 2D data matrix barcode that encodes specific details about the parcel. The label is designed to accommodate a default routing as well as a dynamic routing using an embedded URL to optimize parcel movement even after label is printed and parcel is in transit.
Requirement
The Orchestro standard label will have a human readable section and a coded section. In addition to the already generated 1D barcode, it will have a 2D data matrix barcode. This label is inter-operable, and all carriers will be using this.
Human Readable Section
The basic info about the parcel that is needed without having to scan any code:
- Ship FROM: Name and address
- Ship TO: Name and address
- Service Type
- Sort code that affects the routing of the parcel
- References fields: Shipper can use to cross reference against internal documents like sales orders.
Label Design Example
Figure 1
Figure 2
Details of Label Contents
The following table details out the parts of the label as indicated in figure 2.
| Ref | Name | Required | Sample Value | Description |
|---|---|---|---|---|
| 1 | Ship From | Yes | John Doe Acme Inc 1633 77th St Unit 1 Brooklyn NY 11214 USA | Origin address of the parcel |
| 2 | Ship To | Yes | Jane Doe AB LLC. 123 East 236th STREET Unit 1 Bronx, NY 10470 | Destination address of the parcel |
| 3 | Service Type | Yes | GRD | Type of service booked by customer |
| 4 | Destination Sort Hub Code | Yes | KEARNY | Hub nearest to the destination ZIP |
| 5 | ID barcode | Yes | GS1 128 barcode storing Orchestro tracking ID and connector code | |
| 6 | Tracking ID | Yes | P9VY1TFS | Tracking ID: Eight-character, base 34 alphanumeric starting with ‘P’ for parcel |
| 7 | Reference Fields | No | Fragile | Space for additional info carrier might want to add |
Details of Data Matrix Barcode
This barcode is tab delimited, UPS and USPS compliant. It enables all carriers to seamlessly work with two of the largest parcel carriers in the country. If you are printing labels directly from ZPL, beware that any process that alters whitespace can remove or alter the tabs in the barcode, breaking the label for anyone relying on the data matrix for processing. Orchestro will certify your labels to ensure the data matrix is functioning as intended.
Key: A=Alphanumeric, N=Numeric, F=Fixed Size, V=Variable Size
| Field Name | A/N | F/V | Size | Sample Value | Required | Comments |
|---|---|---|---|---|---|---|
| Sort Code | A | F | 10 | KEARNY | Yes | Defines the region code which is a function of Airport code |
| Orchestro Tracking Code | A | F | 8 | P9VY1TFS | Yes | An eight-character alpha-numeric code starting with ‘P’ for parcel and ‘C’ for container, followed by 7 alphanumeric characters excluding ‘O’ and ‘I’ |
| Destination Address Line 1 | A | V | 35 | 123 East 236th STREET | Yes | Street Address Line (not intended for contact name or company name) |
| Destination Address Line 2 | A | F | 2 | Unit 1 | Conditional | Field is populated when address includes an extended address line (such as a suite) |
| Destination City | A | V | 9 | Bronx | Yes | City Name |
| Destination State / Province | A | F | 2 | NY | Conditional | Field is populated for US and Canada destinations only |
| Destination Postal Code | A | V | 9 | 10470 | Yes | No space for or dashes are allowed |
| Destination Country Code | N | F | 3 | US | Yes | Use the ISO country code |
ZPL Format
^XA
^CF0,20
^FO640,30^FDOrchestro^FS
^CFA,20 ^FO50,40^FDJohn Doe^FS
^FO50,65^FDAcme Inc^FS
^FO50,90^FD1633 77th St^FS
^FO50,115^FDUnit 1^FS
^FO50,140^FDBrooklyn NY 11214^FS
^FO50,165^FDUSA^FS
^CF0,33
^FO45,200^FDSHIP TO:^FS
^FO170,200^FDJane Doe^FS
^FO170,245^FDAB LLC.^FS
^FO170,290^FD123 East 236th^FS
^FO170,335^FDUnit 1^FS
^FO170,380^FDBronx NY 10470^FS
^FO170,425^FDUS^FS
^FO10,470^GB790,5,5^FS
^CFA,60
^FO60,490^FDGRD^FS
^FO50,50 ^CFA,60
^FO530,483^GB264,65,35^FS
^FO533,490^FR^FDKEARNY^FS
^BY4,3,180
^FO160,570^BC^FDP9VY1TFS^FS
^CFA, 25
^FO75,815^FR^FDRef1:^FS
^FO75,850^FR^FDRef2:^FS
^BY3,3 ^FO250,925^BX,6,200 ^FDKEARNY P9VY1TFS 123 East 236th street Unit 1 Bronx NY 10470 US^FS
^XZ
UPS Sure Post Label
For Surepost service, a shipping label will be retrieved from UPS and provided to the shipper without modification. We propose using the Orchestro ID as the Package ID # within the UPS section of the label.
UPS Mail Innovations Label
Below is the proposed label for Mail Innovations. For shipments using this service, a shipping label will be retrieved from UPS and used without modification. The Orchestro ID will be used as the Package ID # within the UPS section of the label.
