​
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.

RefNameRequiredSample ValueDescription
1Ship FromYesJohn Doe Acme Inc 1633 77th St Unit 1 Brooklyn NY 11214 USAOrigin address of the parcel
2Ship ToYesJane Doe AB LLC. 123 East 236th STREET Unit 1 Bronx, NY 10470Destination address of the parcel
3Service TypeYesGRDType of service booked by customer
4Destination Sort Hub CodeYesKEARNYHub nearest to the destination ZIP
5ID barcodeYesGS1 128 barcode storing Orchestro tracking ID and connector code
6Tracking IDYesP9VY1TFSTracking ID: Eight-character, base 34 alphanumeric starting with ‘P’ for parcel
7Reference FieldsNoFragileSpace 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 NameA/NF/VSizeSample ValueRequiredComments
Sort CodeAF10KEARNYYesDefines the region code which is a function of Airport code
Orchestro Tracking CodeAF8P9VY1TFSYesAn 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 1AV35123 East 236th STREETYesStreet Address Line (not intended for contact name or company name)
Destination Address Line 2AF2Unit 1ConditionalField is populated when address includes an extended address line (such as a suite)
Destination CityAV9BronxYesCity Name
Destination State / ProvinceAF2NYConditionalField is populated for US and Canada destinations only
Destination Postal CodeAV910470YesNo space for or dashes are allowed
Destination Country CodeNF3USYesUse 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.

WebhookStandard Manifest Format