P4 Software
/
BarcoderX English
Applies to: BarcoderX Basic and Ultimate
Status: Built, not yet released. The encoders for UPC-E and for the add-on symbols 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, these symbologies still have the status Planned, because that status changes only when their evidence is complete. See What the statuses mean. The label engine draws them, and its tests cover them. Everything marked "planned" is not usable yet.
UPC-E is the short form of a UPC-A barcode. An add-on is a small extra symbol that sits to the right of an EAN-13, a UPC-A or a UPC-E. UPC-E, and the add-ons that go with an EAN-13, a UPC-A or a UPC-E, belong to the first group of symbologies and are in the Basic edition. This page describes what BarcoderX does with them. Their rules come from the GS1 General Specifications, release 26.0. BarcoderX is designed to meet them. See GS1 support.
| Barcode | Id in a template | What it carries |
|---|---|---|
| UPC-E | upc-e | A UPC-A number that can be shortened, as 6 digits in the barcode. |
| Two-digit add-on | ean-addon-2 | 2 digits. |
| Five-digit add-on | ean-addon-5 | 5 digits. |
| EAN-13 with an add-on | ean-13-2, ean-13-5 | The EAN-13 and a two-digit or a five-digit add-on, in one symbol. |
| UPC-A with an add-on | upc-a-2, upc-a-5 | The UPC-A and a two-digit or a five-digit add-on. |
| UPC-E with an add-on | upc-e-2, upc-e-5 | The UPC-E and a two-digit or a five-digit add-on. |
In a template, a barcode names its symbology and gives its content. See The label template format. The shipping barcodes are on Shipping barcodes: ITF-14, GS1-128 and SSCC-18.
The GS1 General Specifications, release 26.0, say this about add-on symbols:
| Publication | Two-digit add-on |
|---|---|
| Weekly | The number of the week, 01 to 53. |
| Monthly | The number of the month, 01 to 12. |
| Annual | The first digit is the last digit of the year, and the second is 5. |
For five digits, the specification says that the information can include the actual date of issue, to tell successive issues apart (section 2.1.3.5, page 87).
The GS1 General Specifications, release 26.0, say that an add-on is used together with a UPC-A, a UPC-E or an EAN-13 barcode (section 2.1.3.4, page 85), and that a two-digit or a five-digit add-on may be used to accompany an EAN-13, a UPC-A or a UPC-E (sections 5.2.2.5.1 and 5.2.2.5.2, pages 329 and 330). BarcoderX builds add-ons for those three. The registry also lists add-ons for the EAN-8 (ean-8-2 and ean-8-5), and the table of the first group on the page Barcodes counts them. They are not built: they wait for the ISO/IEC 15420 standard, which has not been read.
To draw an add-on next to a main symbol, choose one of the six ids of the table above and give the number of the main symbol followed directly by the digits of the add-on, with nothing between them. The id says how many digits the add-on has. The main number follows the rules of its own symbol: for example, an EAN-13 with a two-digit add-on takes 14 digits, or 15 with the check digit of the EAN-13.
| Id | Content | Printed in the specification |
|---|---|---|
ean-13-2 | 977138452401712: the EAN-13 9771384524017 and the add-on 12 | Figure 5-19, page 330 |
ean-13-5 | 978087779930654321: the EAN-13 9780877799306 and the add-on 54321 | Figure 5-20, page 331 |
upc-a-2 | 01234567890524: the UPC-A 012345678905 and the add-on 24 | Figure 5-27, page 343 |
ean-13-5 | 123456789101945678: the EAN-13 1234567891019 and the add-on 45678 | Figure 5-28, page 343 |
The two add-on types also exist on their own, ean-addon-2 with exactly 2 digits and ean-addon-5 with exactly 5. They are for drawing an add-on separately. The specification says that an add-on is never scanned alone.
The add-on sits to the right of the main symbol and parallel to it. The same module width is used for both. The space between them is at least the right quiet zone of the main symbol, 7 modules for an EAN-13 and a UPC-E and 9 for a UPC-A, and at most 12 modules (section 5.2.3.6 and Table 5-11 of the GS1 General Specifications, release 26.0). By default BarcoderX uses the smallest. The tables of the specification do not agree for a UPC-E: Table 5-11 gives 9 to 12 for the add-ons of a UPC, while Tables 5-12 and 5-63 need 7. BarcoderX uses 7 for a UPC-E and accepts 9. A value outside the range is refused (BX4015).
With the default space and the minimum quiet zones, the whole symbol has the length that Table 5-12 gives, in modules:
| With a two-digit add-on | Modules | With a five-digit add-on | Modules |
|---|---|---|---|
| EAN-13 | 138 | EAN-13 | 165 |
| UPC-A | 138 | UPC-A | 165 |
| UPC-E | 92 | UPC-E | 119 |
The specification asks that the digits of an add-on are shown above its bars, with the same height as the digits of the main symbol (section 5.2.5, page 337). The encoder reports them that way, and the label engine draws them that way, when the barcode has a humanReadable setting. The digits of an add-on sit one module above its bars, with their upper edges level with the top of the main bars, and they have the same size as the other digits of the symbol (they shrink together with them when they do not fit). The distance of one module and the rule for the size are choices of this project: the specification gives a minimum. If the bars are too short to hold the digits, the digits are drawn anyway and BX3907 says so.
The diagnostic codes of these barcodes are BX4001 to BX4003 and BX4010 to BX4022. Their texts, in English and Spanish, are in Diagnostic codes.
ean-8-2 and ean-8-5), which waits for the ISO/IEC 15420 standard.BarcoderX is a product of P4 Software.
Was this page helpful?