{"id":5695,"date":"2017-11-29T00:32:13","date_gmt":"2017-11-29T00:32:13","guid":{"rendered":"https:\/\/alt2.minisoft.com\/support\/?p=5695"},"modified":"2020-07-01T13:18:46","modified_gmt":"2020-07-01T20:18:46","slug":"maxicode","status":"publish","type":"post","link":"https:\/\/c002.minisoft.com\/support\/maxicode\/","title":{"rendered":"MaxiCode"},"content":{"rendered":"

The MaxiCode is used primarily by UPS to route and track packages:<\/p>\n

\"\"<\/a>
\n[)>~03001~02996890520000~029840~029003~0291Z12898809~029UPSN~029868124~029246~029~0291\/1~029000~029N~029~029HENDERSON~029NV~030~004<\/code><\/p>\n

MaxiCode barcodes are fixed-size codes which hold up to 93 data characters. MaxiCodes encode two messages. The main message typically encodes the postal code, country code and the service code. The secondary message typically encodes a shipping address, though it can also encode other information. The symbology may be used in different modes:<\/p>\n

MaxiCode Encoding Modes<\/h3>\n

0<\/strong> Obsolete.
\n1<\/strong> Obsolete.
\n2<\/strong> Primary message encodes the numeric postal code (US Carrier) up to nine digits in length, country code and service code while the secondary message encodes additional data. Up to 93 characters may be encoded.
\n3<\/strong> Primary message encodes the alphanumeric postal code (International Carrier) up to six digits in length, country code and service code while the secondary message encodes additional data. Up to 93 characters may be encoded.
\n4<\/strong> Standard Symbol. General information is encoded. Any data up to 90 data characters is automatically split between primary and secondary messages.
\n5<\/strong> Secure Symbol. General information is encoded. Any data up to 74 data characters is automatically split between primary and secondary messages. Enhanced error correction is employed.
\n6<\/strong> Reader Program. Used for programming hardware devices, such as barcode readers.<\/p>\n

The following is an example of encoding data in MaxiCode barcodes in eFORMz, using Mode 2. The data encoded begins with [)>RS01GS<\/code> as required by UPS. Next, the 2-digit format of the year (YY) is added. This is followed by the zip code, which is a numeric-only 5-digit zip code with a 4-digit zip code extension. If no extension exists, four zeros (0000) must be specified. Next, the 3-digit country code is added. For mode 2, which is used for US carriers, the country code is 840. For other country codes, mode 3 should be used instead. After this, the 3-digit class of service code is added. The secondary message follows, and it has more flexibility.<\/p>\n

The following basic format should look as follows: [)>RS01GSYearPostalCodeGSCountryGSServiceGSmessage<\/code>
\nOur detailed example, with a sample secondary message, will look as follows:
\n\u201c[)>\u201d+RS+ \u201c01\u201d+GS+ \u201c96890520000\u201d+GS+ \u201c840\u201d+GS+ \u201c003\u201d+GS+ \u201c1Z12898809\u201d+GS+\u201dUPSN\u201d+GS+\u201d868124\u201d+GS+\u201d246\u201d+GS+GS+\u201d1\/1\u201d+GS+GS+\u201dN\u201d+GS+GS+\u201dHENDERSON\u201d+GS+\u201dNV\u201d+RS+EOT<\/p>\n

There are three character delimiters used, each with an American Standard Code for Information Interchange (ASCII) value. The RS character delimiter has a value of ~030, the GS character delimiter has a value of ~029 and the EOT character delimeter has a value of ~004. The data is encoded with this string:
\n[)>~03001~02996890520000~029840~029003~0291Z12898809~029UPSN~029868124~029246~029~0291\/1~029~029N~029~029HENDERSON~029NV~030~004<\/p>\n

Options<\/strong><\/p>\n

Encoding Mode<\/em>
\nThe encoding mode options are noted in the MaxiCode Encoding Modes table on page 24. The default mode is the First character of data option, which compresses (encodes) the data based upon the the first character of the selected string being a single digit. This first character will not be a part of the barcode.<\/p>\n

Resolution<\/em>
\nThe density of the barcode. 96 dpi (dots-per-inch) is low resolution, while 600 dpi is high resolution. The default is 300 dpi.<\/p>\n

NOTE: A two-dimensional imaging device such as a CCD camera is necessary to scan the symbology.<\/p>\n

Tutorial<\/h2>\n

The following is the process of encoding data in MaxiCode barcodes in eFORMz, using Mode 2. To follow along, download the sample files here: MaxiCode<\/a><\/p>\n

1. From the eFORMz Project Window, right click the form and select Add Variable > By position.
\n2. The Variable dialog box will display. Enter \u2018Mode\u2019 in the Name field.
\n3. Right click the variable and select Add Function > Set Value.
\n4. The Set Value dialog box will display. Enter a value of 2 in the Constant field.<\/p>\n

\"\"<\/a><\/p>\n

5. From the eFORMz Project Window, right click the form and select Add Variable > By position. The Variable dialog box will display. Enter \u2018RS\u2019 in the Name field.
\n6. Right click the variable and select Add Function > Set Value. The Set Value dialog box will display. Enter a value of ~030 in the Constant field.<\/p>\n

\"\"<\/a><\/p>\n

7. From the eFORMz Project Window, right click the form and select Add Variable > By position. The Variable dialog box will display. Enter \u2018GS\u2019 in the Name field.
\n8. Right click the variable and select Add Function > Set Value. The Set Value dialog box will display. Enter a value of ~029 in the Constant field.<\/p>\n

\"\"<\/a><\/p>\n

9. From the eFORMz Project Window, right click the form and select Add Variable > By position. The Variable dialog box will display. Enter \u2018EOT\u2019 in the Name field.
\n10. Right click the variable and select Add Function > Set Value. The Set Value dialog box will display. Enter a value of ~004 in the Constant field.<\/p>\n

\"\"<\/a><\/p>\n

11. From the eFORMz Project Window, right click the form and select Add Variable > By position. The Variable dialog box will display. Enter \u2018ZipCode\u2019 in the Name field.
\n12. Right click the variable and select Add Function > Set Value. The Set Value dialog box will display. Enter the value for the zip code. The first two digits should be the year, followed by the nine digit zip code. For this example, a value of 96890520000 is entered in the Constant field. 96 represents the year, 89052-0000 is the zip code.<\/p>\n

\"\"<\/a><\/p>\n

13. From the eFORMz Project Window, right click the form and select Add Variable > By position. The Variable dialog box will display. Enter \u2018CountryCode\u2019 in the Name field.
\n14. Right click the variable and select Add Function > Set Value. The Set Value dialog box will display. Enter the value of the country code. For MaxiCode mode 2, this is typically the United States country code of 840. So, a value of 840 is entered in the Constant field.<\/p>\n

\"\"<\/a><\/p>\n

15. From the eFORMz Project Window, right click the form and select Add Variable > By position. The Variable dialog box will display. Enter \u2018ServiceCode\u2019 in the Name field.
\n16. Right click the variable and select Add Function > Set Value. The Set Value dialog box will display. Enter the value of the service code. For this example, a value of 003 is entered in the Constant field.<\/p>\n

\"\"<\/a><\/p>\n

17. After defining the delimiter characters and primary codes, the secondary message that will be encoded can be defined. From the eFORMz Project Window, right click the form and select Add Variable > By position. The Variable dialog box will display. Enter \u2018Message\u2019 in the Name field.
\n18. Right click the variable and select Add Function > Set Value. The Set Value dialog box will display. Enter the UPS tracking number. For this example, a value of 1Z12898809 is entered in the Constant field.<\/p>\n

\"\"<\/a><\/p>\n

19. Right click the \u2018Message\u2019 variable and select Add Function > Concatenate. The Concatenate dialog box will display. Select the \u2018GS\u2019 variable created earlier from the drop-down menu.<\/p>\n

\"\"<\/a><\/p>\n

20. Right click the \u2018Message\u2019 variable and select Add Function > Concatenate. The Concatenate dialog box will display. Enter a value of \u2018UPSN\u2019. This is the Standard Carrier Alpha Code for UPS.<\/p>\n

\"\"<\/a><\/p>\n

21. Right click the \u2018Message\u2019 variable and select Add Function > Concatenate. Select the \u2018GS\u2019 variable created earlier from the drop-down menu.
\n22. Right click the \u2018Message\u2019 variable and select Add Function > Concatenate. Enter the UPS shipper number. A value of \u2018868124\u2019 was entered for this example.<\/p>\n

\"\"<\/a><\/p>\n

23. Right click the \u2018Message\u2019 variable and select Add Function > Concatenate. Select the \u2018GS\u2019 variable created earlier from the drop-down menu.
\n24. Right click the \u2018Message\u2019 variable and select Add Function > Concatenate. Enter the Julian day of pickup. In this example, a value of \u2018246\u2019 was entered.<\/p>\n

\"\"<\/a><\/p>\n

25. Right click the \u2018Message\u2019 variable and select Add Function > Concatenate. Select the \u2018GS\u2019 variable created earlier from the drop-down menu.
\n26. Right click the \u2018Message\u2019 variable and select Add Function > Concatenate. Enter the 7-digit shipment ID number. In this example, a shipment ID number is not used. (If necessary)<\/em> Right click the \u2018Message\u2019 variable and select Add Function > Concatenate. Select the \u2018GS\u2019 variable created earlier from the drop-down menu. If not needed because a shipment ID wasn’t added, proceed to the next step.
\n27. Right click the \u2018Message\u2019 variable and select Add Function > Concatenate. Specify the number of packages (package x of y format). A value of \u20181\/1\u2019 is used in this example.<\/p>\n

\"\"<\/a><\/p>\n

28. Right click the \u2018Message\u2019 variable and select Add Function > Concatenate. Select the \u2018GS\u2019 variable created earlier from the drop-down menu.
\n29. Right click the \u2018Message\u2019 variable and select Add Function > Concatenate. Enter the package weight. A value of \u2018000\u2019 is used in this example.<\/p>\n

\"\"<\/a><\/p>\n

30. Right click the \u2018Message\u2019 variable and select Add Function > Concatenate. Select the \u2018GS\u2019 variable created earlier from the drop-down menu.
\n31. Right click the \u2018Message\u2019 variable and select Add Function > Concatenate. Enter a \u2018Y\u2019 or \u2018N\u2019 value for address validation. For our example, our address doesn\u2019t need to be validated, so a value of \u2018N\u2019 is entered.<\/p>\n

\"\"<\/a><\/p>\n

32. Right click the \u2018Message\u2019 variable and select Add Function > Concatenate. Select the \u2018GS\u2019 variable created earlier from the drop-down menu.
\n33. (If necessary)<\/em> Right click the \u2018Message\u2019 variable and select Add Function > Concatenate. Enter the ship-to street address. In this example, a street address is not used. Right click the \u2018Message\u2019 variable and select Add Function > Concatenate. Select the \u2018GS\u2019 variable created earlier from the drop-down menu. If not needed because a ship-to street address wasn’t added, proceed to the next step.
\n34. Right click the \u2018Message\u2019 variable and select Add Function > Concatenate. Enter the ship-to city. In this example, a value of \u2018HENDERSON\u2019 is used.<\/p>\n

\"\"<\/a><\/p>\n

35. Right click the \u2018Message\u2019 variable and select Add Function > Concatenate. Select the \u2018GS\u2019 variable created earlier from the drop-down menu.
\n36. Right click the \u2018Message\u2019 variable and select Add Function > Concatenate. Enter the ship-to city value. In this example, a value of \u2018NV\u2019 is used.<\/p>\n

\"\"<\/a><\/p>\n

37. With the secondary message complete, the primary carrier message and the secondary message can be encoded. From the eFORMz Project Window, right click the form and select Add Variable > By position. The Variable dialog box will display. Enter \u2018EncodedData\u2019 in the Name field.
\n38. Right click the variable and select Add Function > Set Value. The Set Value dialog box will display. Select the \u2018Mode\u2019 variable created earlier from the drop-down menu.<\/p>\n

\"\"<\/a><\/p>\n

39. The required opening data string of encoded data for a mode 2 message is \u2018[)>RS01GS\u2019. Right click the \u2018EncodedData\u2019 variable and select Add Function > Concatenate. Enter a value of \u2018[)>\u2019. This value is required by UPS and represents the beginning of the message header.<\/p>\n

\"\"<\/a><\/p>\n

40. Right click the \u2018EncodedData\u2019 variable and select Add Function > Concatenate. Select the \u2018RS\u2019 variable created earlier from the drop-down menu. The RS character delimiter is required by UPS and completes the message header portion of the required data string.<\/p>\n

\"\"<\/a><\/p>\n

41. Right click the \u2018EncodedData\u2019 variable and select Add Function > Concatenate. Enter a value of \u201801\u2019. This value is required by UPS and represents the beginning of the format header of the required data string.<\/p>\n

\"\"<\/a><\/p>\n

42. Right click the \u2018EncodedData\u2019 variable and select Add Function > Concatenate. Select the \u2018GS\u2019 variable created earlier from the drop-down menu. The GS character delimiter is required by UPS and completes the format header of the opening data string of the encoded data.<\/p>\n

\"\"<\/a><\/p>\n

43. Right click the \u2018EncodedData\u2019 variable and select Add Function > Concatenate. Select the \u2018ZipCode\u2019 variable created earlier from the drop-down menu.<\/p>\n

\"\"<\/a><\/p>\n

44. Right click the \u2018EncodedData\u2019 variable and select Add Function > Concatenate. Select the \u2018GS\u2019 variable created earlier from the drop-down menu.
\n45. Right click the \u2018EncodedData\u2019 variable and select Add Function > Concatenate. The Concatenate dialog box will display. Select the \u2018CountryCode\u2019 variable created earlier from the drop-down menu.<\/p>\n

\"\"<\/a><\/p>\n

46. Right click the \u2018EncodedData\u2019 variable and select Add Function > Concatenate. Select the \u2018GS\u2019 variable created earlier from the drop-down menu.
\n47. Right click the \u2018EncodedData\u2019 variable and select Add Function > Concatenate. Select the \u2018ServiceCode\u2019 variable created earlier from the drop-down menu.<\/p>\n

\"\"<\/a><\/p>\n

48. Right click the \u2018EncodedData\u2019 variable and select Add Function > Concatenate. Select the \u2018GS\u2019 variable created earlier from the drop-down menu.
\n49. Right click the \u2018EncodedData\u2019 variable and select Add Function > Concatenate. The Concatenate dialog box will display. Select the \u2018Message\u2019 variable created earlier from the drop-down menu.<\/p>\n

\"\"<\/a><\/p>\n

50. Right click the \u2018EncodedData\u2019 variable and select Add Function > Concatenate. Select the \u2018GS\u2019 variable created earlier from the drop-down menu.
\n51. Right click the \u2018EncodedData\u2019 variable and select Add Function > Concatenate. The Concatenate dialog box will display. Select the \u2018EOT\u2019 variable created earlier from the drop-down menu. This character concludes the encoded data message.<\/p>\n

\"\"<\/a><\/p>\n

The barcode can now be placed onto the form via Add Rule > 2D Barcode or in the Document Template via Add barcode > 2D barcode.<\/p>\n","protected":false},"excerpt":{"rendered":"

The MaxiCode is used primarily by UPS to route and track packages: [)>~03001~02996890520000~029840~029003~0291Z12898809~029UPSN~029868124~029246~029~0291\/1~029000~029N~029~029HENDERSON~029NV~030~004 MaxiCode barcodes are fixed-size codes which hold up to 93 data characters. MaxiCodes encode two messages. The main message typically encodes the postal code, country code and the service code. The secondary message typically encodes a shipping address, though it can also […]<\/p>\n","protected":false},"author":75,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[46],"tags":[103,302],"_links":{"self":[{"href":"https:\/\/c002.minisoft.com\/support\/wp-json\/wp\/v2\/posts\/5695"}],"collection":[{"href":"https:\/\/c002.minisoft.com\/support\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/c002.minisoft.com\/support\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/c002.minisoft.com\/support\/wp-json\/wp\/v2\/users\/75"}],"replies":[{"embeddable":true,"href":"https:\/\/c002.minisoft.com\/support\/wp-json\/wp\/v2\/comments?post=5695"}],"version-history":[{"count":11,"href":"https:\/\/c002.minisoft.com\/support\/wp-json\/wp\/v2\/posts\/5695\/revisions"}],"predecessor-version":[{"id":8170,"href":"https:\/\/c002.minisoft.com\/support\/wp-json\/wp\/v2\/posts\/5695\/revisions\/8170"}],"wp:attachment":[{"href":"https:\/\/c002.minisoft.com\/support\/wp-json\/wp\/v2\/media?parent=5695"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/c002.minisoft.com\/support\/wp-json\/wp\/v2\/categories?post=5695"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/c002.minisoft.com\/support\/wp-json\/wp\/v2\/tags?post=5695"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}