Programmer s Label Guide

Transcription

1 Ship Manager API Label Guide Programmer s Label Guide January 2006

2 Legal Terms and Conditions Use of this system constitutes your agreement to the service conditions in the current FedEx Service Guide, available upon request. FedEx will not be responsible for any claim in excess of $100 per package, whether the result of loss, damage, delay, non-delivery, misdelivery, or misinformation, unless you declare a higher value, pay an additional charge, document your actual loss, and file a timely claim. Limitations found in the current FedEx Service Guide apply. Your right to recover from FedEx for any loss, including intrinsic value of the package, loss of sales, income interest, profit, attorney s fees, cost and other forms of damage whether direct, incidental, consequential, or special is limited to the greater of $100 or the authorized declared value. Recovery cannot exceed actual documented loss. Maximum for items of extraordinary value is $500, e.g. jewelry, precious metals, negotiable instruments, and other items listed in our service guide. Written items must be filed within strict time limits, see current FedEx Service Guide. FedEx will not be liable for loss or damage to prohibited items in any event or for your acts or omissions, including, without limitation, improper or insufficient packaging, securing, marking or addressing, or the acts or omissions, or the recipient, or anyone else with an interest in the package. To obtain information regarding how to file a claim or to obtain a FedEx Service Guide, please call Go.FedEx ( ). Confidential and Proprietary The information contained in this Label Guide is confidential and proprietary to FedEx Corporate Services, Inc. and its affiliates (collectively "FedEx"). No part of this Label Guide may be distributed or disclosed in any form to any third party without written permission of FedEx. This Label Guide is provided to you under and its use is subject to the terms and conditions of the FedEx End User and/or Consultant License Agreement. The information in this document may be changed at any time without notice. Any conflict between either of these guides, the FedEx End User and/or Consultant License Agreement, and the FedEx Service Guide shall be governed by the FedEx End User and/or Consultant License Agreement and the FedEx Service Guide, in that order FedEx. FedEx and the FedEx logo are registered service marks. All rights reserved. Unpublished.

3 Table of Contents Table of Contents Introduction... 2 General Printing Overview and Methods...2 What's New... 3 Referenced Documents... 4 Chapter 1: Plain Paper and Thermal Label Specifications... 5 FedEx Shipping Label...5 Shipping Label Attributes...5 PNG Plain Paper Label...6 4x6 PNG Label... 7 Determining Screen Resolution... 7 Custom Labels... 8 Label Data Buffer... 8 Using Buffer Data to Print PNG or Thermal Labels...9 Chapter 2: Plain Paper Shipping Label Samples...13 Plain Paper Types and Documentation...13 FedEx Express Shipping Labels FedEx Ground Shipping Labels Plain Paper Labels Express Plain Paper Labels Ground Chapter 3: Thermal Shipping Label Samples Thermal Label Types and Documentation...35 FedEx Express Shipping Label FedEx Ground Shipping Labels Thermal Labels FedEx Express Thermal Labels FedEx Ground Acronyms Index FedEx Ship Manager API Label Guide, January

4 Introduction Introduction General Printing Overview and Methods The FedEx ASTRA bar code was designed to accommodate automated scanning and sorting at the stations and hubs. The specifications are written to allow the various scanning systems throughout FedEx to accurately and reliably de-code the information in the bar code. The only way to ensure that the bar codes will work reliably with present and future scanning systems is to make sure that they always meet FedEx minimum standard specifications for print quality. There can be no deviation from these specifications nor can any waiver or modifications be allowed. Print methods: direct thermal thermal transfer LASER (xerographic) or ink jet These print methods are chosen due to their ability to maintain a high and constant quality output throughout the life of the printer and supplies. With these systems, FedEx can check the quality of a customer produced bar code once to verify that the major print components are correct, and be confident that the production bar code will continue to maintain very similar quality. Dot-matrix printers are not permitted. This is because even in the best of conditions, the print quality is highly variable. Some dot matrix printers are capable of printing quality bar codes when the ribbon life and platen pressure are in optimum condition, but in actual production this is nearly impossible to monitor and control. While FSM API will support the printing of both plain paper and thermal labels, FedEx does not provide the hardware with which to produce either type label. FedEx Ship Manager API Label Guide, January

5 What s New What's New Version Feature Description Jan06 4x6 PNG Label Requirements for the 4x6 PNG Label have been included in this guide. Jan06 PNG Label measurement Measurements for the PNG label have been updated, from 7½ x 5 1/8 to 7 x4.75. Jan06 PNG Label measurement The code in Example: Sample code implementing Shipping plain paper label in Netscape Browser has been updated to reflect the label size update from 675 to 700 and 467 to 475. FedEx Ship Manager API Label Guide, January

6 Referenced Documents Referenced Documents Title Version/Revision Location FedEx Service Guide Current Call Go.FedEx ( ). FedEx Ship Manager API Label Guide, January

7 Chapter 1: Plain Paper and Thermal Label Specifications Chapter 1: Plain Paper and Thermal Label Specifications FedEx Shipping Label To prepare your package for shipment, you need to do the following: 1. Use the Print button in your browser to print this page to your laser printer. 2. Fold the first printed page in half and use as the shipping label. The second page is for your records, and contains both the terms and conditions of shipping, and information useful for tracking your package. 3. After printing the label, place it in a waybill pouch and affix it to your shipment so that the barcode portion of the label can be read and scanned. Shipping Label Attributes Labels can be categorized by three attributes: label type printer type format type The label type is specified with field 1368 in the Ship transaction: 2 = 2D Common The printer type is specified with field 1369: 1 = plain paper (laser) 2 = Eltron Orion 3 = Eltron Eclipse 4 = Zebra ZPL 5 = Unimark The format type is specified with field 1370: 3 = 4x6¾ thermal with doc-tab at the bottom 4 = 4x6 without doc-tab 5 = plain paper PNG 6 = 4x6¾ thermal with doc-tab at the top The shipping label data will be returned in field 188 in the response transaction. If there is a COD return label, it will be returned in field 411. If you requested a PNG label, the data returned will be a PNG file. If you requested a thermal label, it will be a series of command codes that can be serially transmitted to a thermal printer to cause a label to be printed. To ensure fast, reliable parsing of tagged transactions, certain characters are not allowed in the data values of fields. Any occurrences of those characters within a field will have been encoded with other, legal, characters. Thus, after you extract the bytes of data from the label fields (188 and 411), they must be decoded to get the PNG or thermal label image. FedEx Ship Manager API Label Guide, January

8 Chapter 1: Plain Paper and Thermal Label Specifications PNG Plain Paper Label Printing the plain paper label is different than printing the thermal label. The image orientation dimensions can be manipulated when using a print manager to print a plain paper label. Image Orientation Dimensions are determined when the label is viewed in an imaging editor application. Image orientations for both Shipping and Tracking Signature Proof of Delivery (SPOD) PNG plain paper shipping labels are listed in the corresponding table: PNG Plain Paper Image Orientation Dimensions Print Manager Dimensions Width By Height Shipping PNG (browser and non-browser) 7.0 X 4.75 SPOD PNG (browser and non-browser) 6.8 X 7.6 When the label is printed, it can either increase or decrease in size if the print manager dimensions are not properly set. If the dimensions are increased, the following will result: All human readable, barcode data and barcodes will be increased in size and bar codes may become unable to be scanned by the Courier and Ground Operations division. Since the label will need to be folded in half and inserted into the FedEx Pouch, the ASTRA barcode (field 35 in the table below) will need to be fully visible. To ensure full visibility, there should be between 5/16" and ¾" of white space from the bottom of the ASTRA barcode to the fold. If the dimensions are decreased, the following will result: All human readable, barcode data and barcodes will be decreased in size. When the label is decreased in size barcodes may become unable to be scanned by the Courier and Ground Operations division. Additionally, if the size is increased or decreased, this may result in the delay of switching the user's application from the validation to production environment. For the Browser based label, the user will need to ensure the appropriate HTML wrapper is attached. The following represents the Page name and File path of a Browser based label: FedEx Ship Manager API Label Page file://c:/program Files/FedEx/Fed ples/vb/ html Reference the Browser based shipping label in the following plain paper shipping label attachments for verbiage orientation. FedEx Ship Manager API Label Guide, January

9 Chapter 1: Plain Paper and Thermal Label Specifications 4x6 PNG Label FedEx Ship Manager API allows users to request a 4" x 6" PNG graphic of the current FedEx thermal label. These label images can then be embedded into your shipping documentation to alleviate the need for a custom label. The following requirements apply when using the 4"x 6" PNG graphic embedded into your shipping document: 4"x 6" PNG labels should only be used with peel & stick label stock. 4"x 6" PNG labels that are not on peel & stick label stock will be rejected by the FedEx Ground and FedEx Express label certification teams. Laserjet printers are recommended for printing labels. Inkjet printers should not be used. Most labels created with inkjet printers have been rejected by the label certification teams due to poor print quality. 4"x 6" PNG format should NOT be used on plain paper and will be rejected automatically if submitted for certification on plain paper. 4"x 6" PNG labels should not be printed with a color printer. Most labels created with a color printer have been rejected by the label certification teams due to poor print quality. Determining Screen Resolution Printing the Plain paper shipping labels and SPOD letters require proper sizing. This requires determining the screen resolution selected on the device running the browser. The HTTP parameters <WIDTH> and <HEIGHT> will need to be calculated using the screen DPI values and the desired reproduced screen width and height. Below lists the typical screen resolutions for Windows and Macintosh based on the font size selected. Browser Windows using small fonts Windows using large fonts Macintosh Screen resolution (typical default) 96 DPI 120 DPI 72 DPI Examples of populating HTML tag Height and Width values: Width (pixels) = ScreenDPI * (desired image reproduced width) Height (pixels = ScreenDPI * (desired image reproduced height) Example: Sample code implementing Shipping plain paper label in Netscape Browser: <HTML> <SCRIPT LANGUAGE="JavaScript1.1"> var NS4 = (document.layers)? true : false ; var resolution = 96; FedEx Ship Manager API Label Guide, January

10 Chapter 1: Plain Paper and Thermal Label Specifications if (NS4 && navigator.javaenabled()) { var toolkit = java.awt.toolkit.getdefaulttoolkit(); resolution = toolkit.getscreenresolution(); } </SCRIPT> <SCRIPT LANGUAGE="JavaScript"> document.write('<img WIDTH=' + (700 * resolution )/100 + '<img HEIGHT=' + (475 * resolution )/100 + ' alt="astra Barcode" src="path/test.png">'); </SCRIPT> </HTML> Example for getting screen resolution using Microsoft MFC library: DC hdc = CreateDC( DISPLAY, NULL, NULL, NULL ); int DPI = getdevicecaps ( hdc, LOGPIXELSX); DeleteDC(hDC); Custom Labels FedEx does not support the creation or use of a custom label for either Ship Manager API Ground or Express shipping. Label Data Buffer Upon a successful Ship a Package Request Transaction, the following buffer is returned: This example does NOT include all possible fields of the Ship Request and Reply transactions. This is only an example. The label type generated by this example data string is a PNG label. Sends to FedEx: 0,"021"4,"ABC Company"5,"1234 Main Street"7,"Memphis"8,"TN"9,"38101"11,"XYZ Company"13,"9876 Southwest Street"15,"New York"16,"NY"17,"10042"18," "23,"1"50,"US"74,"US"75,"LBS"117,"U S"183," "1115,"123456"1116,"I"1273,"02"1274,"01"1401,"2.0"3025,"FDXE"10," "498," "24," "99,"" FedEx Ship Manager API Label Guide, January

11 Chapter 1: Plain Paper and Thermal Label Specifications Received from FedEx: 0,"121"33,"AA"1136,"XY"30,"XY AYZA"29," "526,"0201"1402,"2.0"1419,"25.22"1416,"24.25"1417, ".97"1090,"USD"1 089,"01552"1092,"5"65," "194,"THU"195,"E WR"409,"01JUN00" 431,"N"188, <Label Binary Data Stored Here> 99,"" Field 188 will contain the label data. In the next section we cover how to use this data buffer to print the FedEx shipping label. When a Ship a Package transaction is performed, the data necessary for producing a shipping label (and possibly a COD return label) is returned in one or more fields. The kind of label data returned depends on the printer type and format specified in your Ship request. Using Buffer Data to Print PNG or Thermal Labels The rule for encoding the PNG or thermal image in the returned label buffer was designed to eliminate certain illegal characters (byte values) by replacing them with an escape sequence. Those values that are not allowed include: NULL Double Quote (0x00 hex) (0x22 hex) The percent character % (0x25 hex) is used as the escape character, and therefore it must be replaced where it occurs naturally. Whenever a disallowed character or the escape character '%' is encountered, it is replaced by the escape character % (0x25 hex) followed by two characters comprising the hexadecimal numeral representing the value of the character. For example, the NULL character (0x00 hex) is replaced by three characters: '%' (0x25) '0' (0x30) '0' (0x30) The percent character 0x25 is replaced by three characters: '%' (0x25) '2 (0x32) '5' (0x35) The algorithm for decoding the PNG image in the returned label buffer is as follows. Read bytes from the label field one at a time. When a byte read is not equal to the % character (0x25 hex), pass it through unchanged. When a byte is read that is equal to the % character (0x25 hex), read an additional two bytes, which will each take a value from 0 (0x30 hex) through 9 (0x39 hex) or A (0x41 hex) through F (0x46 hex). These two bytes are interpreted as a character representation of a two-digit hexadecimal FedEx Ship Manager API Label Guide, January

12 Chapter 1: Plain Paper and Thermal Label Specifications numeral ranging from 0x00 through 0xFF. The single byte having the integral value represented by that numeral is appended to your output. For example, when the 3-byte string '%22' is encountered, (0x22) - the double quote character - is passed out. When the 3 bytes '%00' are read, the null character is written. In essence, the developer will need to take the data received from FedEx and store it in a buffer that has sufficient memory to hold the entire data stream. Once the data has been stored, the program might use a function similar to the one described below in order to parse the data in the buffer and extract only the PNG image data. From that point, the developers program must be able to call a print function to send the image to the laser printer. The following sample C function illustrates how this is accomplished. int create_fedex_ship_label(char *receive_buffer) { FILE *fedex_label; int c; int data_decoded = 0; int temp_label_counter; int label_data_found = 0; int result = 1; int load_label_data = 0; } char data; char temp_label_buffer[20]; char label_file_name[20]= { FedEx Label.png }; char data_field_buffer[6]= { 188, }; if((fedex_label = fopen(label_file_name, "wb")) == NULL) { return(1); c = 0; while(data_decoded!= 1) { data = receive_buffer[c]; if(data == '1') { temp_label_buffer[temp_label_counter] = data; temp_label_counter++; c++; data = receive_buffer[c]; if((data == '8') && (temp_label_buffer[0] == '1')) { temp_label_buffer[temp_label_counter] = data; temp_label_counter++; c++; data = receive_buffer[c]; } FedEx Ship Manager API Label Guide, January

13 Chapter 1: Plain Paper and Thermal Label Specifications else { temp_label_counter = 0; } if((data == '8') && (temp_label_buffer[1] == '8')) { temp_label_buffer[temp_label_counter] = data; temp_label_counter++; c++; data = receive_buffer[c]; } else { temp_label_counter = 0; } if((data == ',') && (temp_label_buffer[2] == '8')) { temp_label_buffer[temp_label_counter] = data; temp_label_counter++; c++; temp_label_buffer[temp_label_counter] = 0x00; label_data_found = 1; } else { temp_label_counter = 0; } } else c++; if(label_data_found) { result = strcmp(temp_label_buffer, data_field_buffer); if(result == 0) load_label_data = 1; data = receive_buffer[c]; } if(load_label_data) { data = '0'; c++; while(data!= 0x22) { data = receive_buffer[c]; c++; FedEx Ship Manager API Label Guide, January

14 Chapter 1: Plain Paper and Thermal Label Specifications if(data!= '%') fprintf(fedex_label, "%c", data); if(data == '%') { for(e=0; e<2; e++) { data = receive_buffer[c]; c++; if(((data >= 0x30) && (data <= 0x39)) ((data >= 0x41) && (data <= 0x46))) { if(e == 1) { d = data; d = d & 0x0f; if((data >= 0x41) && (data <= 0x46)) d += 9; store = store d; } else { d = data; d = d & 0x0f; if((data >= 0x41) && (data <= 0x46)) d += 9; store = d << 4; } } } fprintf(fedex_label, "%c", store); } } data_decoded = 1; } } fclose(fedex_label); return(0); FedEx Ship Manager API Label Guide, January

15 Chapter 2: Plain Paper Shipping Label Samples Chapter 2: Plain Paper Shipping Label Samples Plain Paper Types and Documentation The following pages are comprised of both Express and Ground plain paper shipping label types, and their supporting documentation. FedEx Express Shipping Labels Figure Number Label Type Description 2.0 7" x 4.75" PNG Plain Paper Label Express Domestic Sample Label 2.1 7" x 4.75" PNG Plain Paper Label Express Domestic Residential Delivery Sample Label 2.2 7" x 4.75" PNG Plain Paper Label Express Domestic Signature Release Sample Label 2.3 7" x 4.75" PNG Plain Paper Label Express Domestic Saturday Delivery Sample Label 2.4 7" x 4.75" PNG Plain Paper Label Express Domestic Dry Ice Sample Label 2.5 7" x 4.75" PNG Plain Paper Label Express Domestic Hold At Location (HAL) Sample Label 2.6 7" x 4.75" PNG Plain Paper Label Express Domestic Dangerous Goods Sample Label 2.7 7" x 4.75" PNG Plain Paper Label Express Domestic COD Sample Label " x 4.75" PNG Plain Paper Label Express Domestic COD Return Sample Label 2.8 7" x 4.75" PNG Plain Paper Label Express Domestic Freight Sample Label 2.9 7" x 4.75" PNG Plain Paper Label Express International Sample Label " x 4.75" PNG Plain Paper Label Express International (Intra Canada) Sample Label FedEx Ship Manager API Label Guide, January

16 Chapter 2: Plain Paper Shipping Label Samples FedEx Ground Shipping Labels Figure Number Label Type Description " x 4.75" PNG Plain Paper Label Pre-Paid Ground Sample Label " x 4.75" PNG Plain Paper Label Home Delivery (Ground) Sample Label " x 4.75" PNG Plain Paper Label Home Delivery (Ground) Signature Required Sample Label " x 4.75" PNG Plain Paper Label Ground Hazardous Material Sample Label " x 4.75" PNG Plain Paper Label Ground COD Sample Label requirements " x 4.75" PNG Plain Paper Label Ground COD Return Sample Label " x 4.75" PNG Plain Paper Label Ground International Sample Label FedEx Ship Manager API Label Guide, January

17 Chapter 2: Plain Paper Shipping Label Samples Plain Paper Labels Express Figure 2.0 7" x 4.75" PNG Plain Paper Express Domestic Sample Shipping 2-D Label FedEx Ship Manager API Label Guide, January

18 Chapter 2: Plain Paper Shipping Label Samples Figure 2.1 7" x 4.75" PNG Plain Paper Express Residential Delivery Domestic Sample Shipping 2-D Label For the Express Domestic Residential Delivery plain paper label, a bold RES must be printed above the bar code in the right bottom section of the 2-D label. FedEx Ship Manager API Label Guide, January

19 Chapter 2: Plain Paper Shipping Label Samples Figure 2.2 7" x 4.75" PNG Plain Paper Express Domestic Signature Release Sample Shipping Label For the Express Domestic Signature Release plain paper label, a bold RELEASE# must be printed in the center top right section of the 2-D label. Additionally, the shipper s Signature Release Authorization Number will be printed to the right of the RELEASE# text. FedEx Ship Manager API Label Guide, January

20 Chapter 2: Plain Paper Shipping Label Samples Figure 2.3 7" x 4.75" PNG Plain Paper Express Saturday Delivery Domestic Sample Shipping Label For the Express Domestic Saturday Delivery plain paper label, a bold PRIORITY SATURDAY with a row of black astericks above and below must be printed in the top left corner of the center right section of the 2-D label. FedEx Ship Manager API Label Guide, January

21 Chapter 2: Plain Paper Shipping Label Samples Figure 2.4 7" x 4.75" PNG Plain Paper Express Dry Ice Domestic Sample Shipping Label For the Express Domestic Dry Ice plain paper label, a bold ICE must be printed above the bar code in the right bottom section of the 2-D label. Additionally, the text Dry Ice and the total weight of the dry ice will be printed at the top right section of the 2-D label. FedEx Ship Manager API Label Guide, January

22 Chapter 2: Plain Paper Shipping Label Samples Figure 2.5 7" x 4.75" PNG Plain Paper Express Hold At Location (Station) Domestic Sample Shipping Label For the Express Domestic Hold At Location plain paper label, a bold HLD must be printed above the bar code in the right bottom section of the 2-D label. FedEx Ship Manager API Label Guide, January

23 Chapter 2: Plain Paper Shipping Label Samples Figure 2.6 7" x 4.75" PNG Plain Paper Express Domestic Dangerous Goods Sample Shipping Label For the Express Domestic Dangerous Goods plain paper label, a bold ADG for Accessible or IDG for Inaccessible Dangerous Goods must be printed above the bar code in the right bottom section of the 2-D label. FedEx Ship Manager API Label Guide, January

24 Chapter 2: Plain Paper Shipping Label Samples Figure 2.7 7" x 4.75" PNG Plain Paper Express Domestic C.O.D. Sample Shipping Label For the Express Domestic Collect On Delivery (COD) plain paper label, the letters COD must be printed in the bottom right section of the 2-D label. FedEx Ship Manager API Label Guide, January

25 Chapter 2: Plain Paper Shipping Label Samples Figure " x 4.75" PNG Plain Paper Express Domestic C.O.D. Return Sample Shipping Label For the Ground COD Return plain paper label, the bold letters COD RETURN must be printed in the top right corner of the center right section of the 2-D label. Additionally, the collection type and required amount will be printed below the bold COD RETURN text and above the bar code. FedEx Ship Manager API Label Guide, January

26 Chapter 2: Plain Paper Shipping Label Samples Figure 2.8 7" x 4.75" PNG Plain Paper Express Domestic Freight Sample Shipping Label For the Express Domestic Freight plain paper label, a bold Freight with the service type must be printed in the top left corner of the center right section of the 2-D label. Additionally, the Booking number will be printed in the center of the top right section of the 2-D label. FedEx Ship Manager API Label Guide, January

27 Chapter 2: Plain Paper Shipping Label Samples Figure 2.9 7" x 4.75" PNG Plain Paper Express International Sample Shipping Label For the Express International plain paper label, a bold INTL with the service type must be printed in the top left corner of the bottom right section of the 2-D label. Additionally, the commodity information is printed in the section above this heading, and the Total Weight of the shipment will be printed in the right top corner of the 2-D label. FedEx Ship Manager API Label Guide, January

28 Chapter 2: Plain Paper Shipping Label Samples Figure " x 4.75" PNG Plain Paper Express International (Intra Canada) Sample Shipping Label FedEx Ship Manager API Label Guide, January

29 Chapter 2: Plain Paper Shipping Label Samples Plain Paper Labels Ground Figure " x 4.75" PNG Plain Paper Pre-Paid Ground Sample Shipping Label Figure 2.12 FedEx Ship Manager API Label Guide, January

30 Chapter 2: Plain Paper Shipping Label Samples 7" x 4.75" PNG Plain Paper Home Delivery (Ground) Sample Shipping Label For the Ground Home Deliver plain paper label, a bold H must be printed in the center of the 2-D label. Additionally, the service type printed below the bar code will reflect HOME as well as the home delivery type. Figure 2.13 FedEx Ship Manager API Label Guide, January

31 Chapter 2: Plain Paper Shipping Label Samples 7" x 4.75" PNG Plain Paper Home Delivery (Ground) Signature Required Sample Shipping Label For the Ground Home Delivery plain paper label, a bold H must be printed in the center of the 2-D label. Additionally, the service type printed below the bar code will reflect HOME, as well as the home delivery type. FedEx Ship Manager API Label Guide, January

32 Chapter 2: Plain Paper Shipping Label Samples Figure " x 4.75" PNG Plain Paper Ground Hazardous Material Sample Shipping Label For the Ground Hazard Materials plain paper label, a bold HAZ with a black background block must be printed in the center of the left section of the 2-D label. Additionally, the shipper number and emergency contact number will be printed to the right of the HAZ text. FedEx Ship Manager API Label Guide, January

33 Chapter 2: Plain Paper Shipping Label Samples Figure " x 4.75" PNG Plain Paper Ground COD Sample Shipping Label For the Ground Collect on Delivery (COD) plain paper label, the letters COD must be printed in the bottom of the right section of the 2-D label. Additionally, the collection type will be printed below the COD text. FedEx Ship Manager API Label Guide, January

34 Chapter 2: Plain Paper Shipping Label Samples Figure " x 4.75" PNG Plain Paper Ground COD Return Sample Shipping Label For the Ground COD Return plain paper label, the bold letters COD must be printed in the center of the right section of the 2-D label. Additionally, the collection type and required amount will be printed below the bold COD text. FedEx Ship Manager API Label Guide, January

35 Chapter 2: Plain Paper Shipping Label Samples Figure " x 4.75" PNG Plain Paper International Ground Sample Shipping Label For the Ground International plain paper label, the letters INT-GND must be printed in the bottom left corner of the right section of the 2-D label. Additionally, the Shipper s Export Declaration (SED) information and a bold DV with a black block background will be printed in the bottom left corner of the 2-D label. FedEx Ship Manager API Label Guide, January

36 Chapter 2: Plain Paper Shipping Label Samples Figure " x 4.75" PNG Plain Paper Ground Intra Canada Shipping Label For the Ground Intra-Canada plain paper label, a bold DV with a black block background must be printed in the bottom left corner of the 2-D label. FedEx Ship Manager API Label Guide, January

37 Chapter 3: Thermal Shipping Label Samples Chapter 3: Thermal Shipping Label Samples Thermal Label Types and Documentation The following pages include both FedEx Express and FedEx Ground thermal shipping label types and supporting documentation for each. FedEx Express Shipping Label Figure Number Label Type Description 3.1 4" x 6 ¾" Thermal Label w/ doc-tab Express Domestic Sample Label 3.2 4" x 6 ¾" Thermal Label w/ doc-tab Express Domestic Hold At Location (HAL) Sample Label 3.3 N/A Express Domestic Dry Ice Sample Label 3.4 4" x 6 ¾" Thermal Label w/ doc-tab Express Domestic C.O.D. Sample Label " x 6 ¾" Thermal Label w/ doc-tab Express Domestic C.O.D. Return Sample Label 3.5 N/A Express Domestic Freight Sample Label 3.6 4" x 6 ¾" Thermal Label w/ doc-tab Express International Sample Label FedEx Ground Shipping Labels Figure Number Label Type Description 4.1 4" x 6 ¾" Thermal Label w/ doc-tab Pre-Paid Ground Sample Label 4.2 4" x 6 ¾" Thermal Label w/ doc-tab Home Delivery (Ground) Sample Label 4.3 4" x 6 ¾" Thermal Label w/ doc-tab Ground Domestic Hazardous Material Sample Label 4.4 4" x 6 ¾" Thermal Label w/ doc-tab Ground Domestic COD Sample Label N/A Ground Domestic COD Return Sample Label FedEx Ship Manager API Label Guide, January

38 Chapter 3: Thermal Shipping Label Samples 4.5 4" x 6 ¾" Thermal Label w/ doc-tab Ground International Sample Label FedEx Ship Manager API Label Guide, January

39 Chapter 3: Thermal Shipping Label Samples Thermal Labels FedEx Express Figure 3.1 4" x 6 ¾" Thermal Label w/ doc-tab Express Domestic Sample Thermal Shipping Label FedEx Ship Manager API Label Guide, January

40 Chapter 3: Thermal Shipping Label Samples Figure 3.2 4" x 6 ¾" Thermal Label w/ doc-tab Express Domestic (HAL) Hold At Location Sample Thermal Shipping Label For the Express Domestic Hold At Location (HAL) thermal label, a bold HLD must be printed above the bar code in the left bottom section of the 2-D label. Additionally, the service type and HLD Hold At Location special service will be printed on the doc-tab. FedEx Ship Manager API Label Guide, January

41 Chapter 3: Thermal Shipping Label Samples Figure 3.3 4" x 6 ¾" Thermal Label w/ doc-tab Express Domestic Dry Ice Sample Thermal Shipping Label For the Express Domestic Dry Ice thermal label, a bold ICE must be printed above the bar code in the left bottom section of the 2-D label. Additionally, the service type and ICE Dry Ice special service will be printed on the doc-tab; as well as, the total weight of the dry ice will be printed at the top right section of the 2-D label. FedEx Ship Manager API Label Guide, January

42 Chapter 3: Thermal Shipping Label Samples Figure 3.4 4" x 6 ¾" Thermal Label w/ doc-tab Express Domestic C.O.D. Sample Thermal Shipping Label For the Express Domestic C.O.D. thermal label, the letters COD must be printed in the bottom of the right section of the 2-D label. Additionally, the collection type will be printed underneath the COD text. FedEx Ship Manager API Label Guide, January

43 Chapter 3: Thermal Shipping Label Samples Figure " x 6 ¾" Thermal Label w/ doc-tab Express Domestic C.O.D. Return Sample Thermal Shipping Label For the Ground COD Return plain paper label, the bold letters COD RETURN must be printed in the top right corner of the center right section of the 2-D label. Additionally, the collection type and required amount will be printed below the COD RETURN text and above the bar code. FedEx Ship Manager API Label Guide, January

44 Chapter 3: Thermal Shipping Label Samples Figure 3.5 4" x 6 ¾" Thermal Label w/ doc-tab Express Domestic Freight Sample Thermal Shipping Label For the Express Domestic Freight thermal label, a bold FREIGHT along with the service type must be printed in the top left corner of the center right section of the 2-D label. Additionally, the Booking number will be printed in the center of the top right section of the 2-D label; as well as, the service type will be printed on the doc-tab. A second label will be printed along with the primary Freight shipping label. FedEx Ship Manager API Label Guide, January

45 Chapter 3: Thermal Shipping Label Samples Figure 3.6 4" x 6 ¾" Thermal Label w/ doc-tab Express International Sample Thermal Shipping Label For the Express International thermal label, a bold INTL along with the service type must be printed left in the center section of the 2-D label. Additionally, the commodity information is printed below this text on the 2-D label. FedEx Ship Manager API Label Guide, January

46 Chapter 3: Thermal Shipping Label Samples Thermal Labels FedEx Ground Figure 4.1 4" x 6 ¾" Thermal Label w/ doc-tab Pre-Paid Ground Sample Thermal Shipping Label FedEx Ship Manager API Label Guide, January

47 Chapter 3: Thermal Shipping Label Samples Figure 4.2 4" x 6 ¾" Thermal Label w/ doc-tab Home Delivery (Ground) Sample Thermal Shipping Label For the Ground Home Delivery plain paper label, a bold H must be printed in the top center of the 2-D label. Additionally, the service type printed below the bar code will reflect HOME ; as well as, the Home Delivery type. Also, the Home Delivery service type will be printed on the doc-tab. FedEx Ship Manager API Label Guide, January

48 Chapter 3: Thermal Shipping Label Samples Figure 4.3 4" x 6 ¾" Thermal Label w/ doc-tab Ground Domestic (Hazardous Material) Sample Thermal Shipping Label For the Ground Hazardous Material thermal label, a bold HAZ with black background block must be printed in the bottom right section of the 2-D label. Additionally, the shipper s emergency contact number will be printed below the HAZ text. FedEx Ship Manager API Label Guide, January

49 Chapter 3: Thermal Shipping Label Samples Figure 4.4 4" x 6 ¾" Thermal Label w/ doc-tab Ground Domestic COD Sample Thermal Shipping Label For the Ground COD thermal label, the letters COD must be printed below the bar code along with the collection type. Additionally, the Ground COD service type and COD information will be printed on the doc-tab. FedEx Ship Manager API Label Guide, January

50 Chapter 3: Thermal Shipping Label Samples Figure " x 6 ¾" Thermal Label w/ doc-tab Ground Domestic COD Return Thermal Shipping Label For the Ground COD Return thermal label, the bold letters COD must be printed in the top right corner of the 2-D label. Additionally, the collection type and required amount will be printed on the bottom half of the thermal 2-D label. FedEx Ship Manager API Label Guide, January

51 Chapter 3: Thermal Shipping Label Samples Figure 4.5 4" x 6 ¾" Thermal Label w/ doc-tab Pre-Paid Ground International shipping thermal label For the Ground International thermal label, the letters INT-GND must be printed below the bar code at the bottom left section of the 2-D label. Additionally, a bold DV with black block background will be printed on the left center side of the 2-D label. Also, the Ground International service type and shipment information will be printed on the doc-tab. FedEx Ship Manager API Label Guide, January

52 Acronyms Acronyms API ADG ASTRA COD DPI FSM HAL HazMat HTML IDG PNG SED SPOD Application Programming Interface An interface between the operating system and application programs. Accessible Dangerous Goods Advanced Sorting Tracking Routing Assistance Collect on Delivery Dots Per Inch FedEx Ship Manager Hold At Location Hazardous Materials HyperText Markup Language The language used to create World Wide Web pages, with hyperlinks and markup for text formatting. Inaccessible Dangerous Goods Portable Network Graphics bitmap (filename extension) Shipper s Export Declaration Signature Proof Of Delivery FedEx Ship Manager API Label Guide, January

53 Index Index A Acronyms, 50 D dot-matrix printers, 2 F FedEx Express shipping labels plain paper, 13, 15 thermal, 35, 37 FedEx Ground shipping labels plain paper, 14, 27 thermal, 35, 44 H HTML sample code, 7 HTML tag height and width, 7 I Introduction, 2 L label specifications, 5 4x6 PNG Label, 7 attributes, 5 custom labels, 8 label data buffer, 8 PNG plain paper label, 6 prepare package for shipment, 5 using buffer data to print, 9 P plain paper shipping label samples, 13 FedEx Express, 13, 15 FedEx Ground, 14, 27 print methods, 2 R Referenced Documents, 4 S sample, 10 Sample labels Express Domestic, 15 Express Domestic C.O.D., 22 Express Domestic C.O.D. Return, 23 Express Domestic C.O.D. Return thermal, 41 Express Domestic C.O.D. thermal, 40 Express Domestic Dangerous Goods, 21 Express Domestic Dry Ice, 19 Express Domestic Dry Ice thermal, 39 Express Domestic Freight, 24 Express Domestic Freight thermal, 42 Express Domestic HAL, 20 Express Domestic HAL thermal, 38 Express Domestic Residential Delivery, 16 Express Domestic Saturday Delivery, 18 Express Domestic Signature Release, 17 Express Domestic thermal, 37 Express International, 25 Express International Intra Canada, 26 Express International thermal, 43 Ground COD, 31 Ground COD Return, 32 Ground Domestic COD Return thermal, 48 Ground Domestic COD thermal, 47 Ground Domestic HazMat thermal, 46 Ground Hazardous Material, 30 Ground Intra Canada, 34 Home Delivery Ground, 28 Home Delivery Ground Signature Required, 29 Home Delivery Ground thermal, 45 International Ground, 33 Pre-Paid Ground, 27 Pre-Paid Ground International thermal, 49 Pre-Paid Ground thermal, 44 screen resolution, 7 T thermal shipping label samples, 35 FedEx Express, 35, 37 FedEx Ground, 35, 44 FedEx Ship Manager API Label Guide, January