P4 Software
/
BarcoderX English
Applies to: BarcoderX Basic and Ultimate
Status: Built, not yet released. The encoders for these two symbologies exist inside the engine that is still being built, and they are tested. There is no released package, there is no public interface that you can call to encode a barcode directly, and the licensed engine will be the only public way to produce output. In the symbology registry, which the web API is planned to list, the two symbologies still have the status Planned, because that status changes only when their evidence is complete. The symbology list for the editor marks a symbology implemented when an encoder exists, and an encoder exists for both. See What the statuses mean. Everything marked "planned" is not usable yet.
The USPS Facing Identification Mark (FIM) and the USPS Intelligent Mail barcode are two postal symbologies of the United States Postal Service (USPS). They belong to the second group of symbologies (family 2), and postal symbologies are in the Basic edition. See Barcodes and Editions and licensing. This page describes what BarcoderX does with them.
| Symbology | Id in a template | What it carries |
|---|---|---|
| USPS Facing Identification Mark | fim | One letter, A to E. The letter is the whole of the data. |
| USPS Intelligent Mail barcode (also listed in the registry as USPS OneCode 4CB) | usps-imb | A tracking code of 20 digits, with or without a routing code after it. |
In a template, a barcode names its symbology and gives its content. See The label template format.
Both are built from the publisher's own text. The FIM follows USPS Publication 25, Designing Letter and Reply Mail, November 2018, chapter 10, checked against the Domestic Mail Manual. The Intelligent Mail barcode follows USPS-B-3200, Intelligent Mail Barcode 4-State Specification, Rev H, 20 April 2015.
The FIM is a pattern of bars that the USPS prints on the upper right of a letter-size reply piece so that its machines can face and cancel it. It has no digits and no check character. The letter that you choose is the whole of the data. Which letter your mail needs is decided by the postal rules for your mail, not by BarcoderX.
a and A give the same symbol. This is a convenience of BarcoderX, not a rule of the postal text. No other character is turned into a letter: a letter with an accent, a full-width letter and a space are all refused.A gives the FIM A. The content a gives the same symbol.| What you gave | What BarcoderX says | What to do |
|---|---|---|
Nothing, or more than one character, or a letter with a space next to it, such as AB or A | The data has the wrong length (BX4002). | Give exactly one letter. |
One character that is not A to E, such as F, a digit or a space | A character cannot be encoded (BX4001), at position 1. | Use one of A, B, C, D or E. |
| Any option | The option cannot be used for this barcode type (BX4015). | Remove the option. The FIM has no option. |
The Intelligent Mail barcode is a four-state barcode. It is made of 65 bars, and each bar is one of four kinds: a full bar, a bar that reaches up, a bar that reaches down, and a short bar in the middle. The bars are worked out from the digits, and a check value is built into the symbol. You do not type it.
01234567094987654321 has 20 digits and no routing code. Followed by the routing code 01234, it is 0123456709498765432101234 (25 digits). Followed by a routing code of 9 digits, 012345678, it is 29 digits. Followed by a routing code of 11 digits, 01234567891, it is 0123456709498765432101234567891 (31 digits). These are the tracking code and the routing codes of the worked examples of USPS-B-3200, Appendix C, which the tests of the encoder use.| What you gave | What BarcoderX says | What to do |
|---|---|---|
| A length that is not 20, 25, 29 or 31, an empty content included | The data length is not one of the accepted lengths (BX4023). The message gives the length that you gave and lists the accepted lengths. | Shorten or complete the data to one of the lengths in the message. |
| A character that is not a digit, such as a space, a hyphen or a letter | A character cannot be encoded (BX4001), with the position of the character. | Remove the character, or replace it with a digit. |
| A second digit of 5 to 9 | A character cannot be encoded (BX4001), at position 2. | Use a barcode identifier whose second digit is 0 to 4. |
| Any option | The option cannot be used for this barcode type (BX4015). | Remove the option. This barcode has no option. |
tests/BarcoderX.Engine.Tests/PostalBarcodeTests.cs draw both symbols through the label engine and show this:
BarcoderX is a product of P4 Software.
Was this page helpful?