Status: Built, not yet released. The encoders for these three 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 three symbologies still have the status Planned, because that status changes only when their evidence is complete. See What the statuses mean. Everything marked "planned" is not usable yet.
ITF-14, GS1-128 and SSCC-18 are the barcodes of cartons, cases and pallets. They 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.
Symbology
Id in a template
What it carries
ITF-14
itf-14
A 14-digit product number (GTIN-14), on a carton or a case.
GS1-128
gs1-128
One or more GS1 element strings, each made of an identifier and its data.
SSCC-18
sscc-18
A shipping container number, 18 digits, for a pallet or a carton.
Digits. Give 13 digits and BarcoderX adds the last digit, the check digit. Or give all 14 and BarcoderX checks the last one. A wrong check digit is refused (BX4003) and so is any other number of digits (BX4002). A number of 12 digits is not accepted.
Example. 15400141288763 is the number printed under the bearer bars in Figure 5-32, on page 348, of the GS1 General Specifications, release 26.0. Its last digit, 3, is its check digit.
Bearer bars. Bearer bars are the bars or the frame around an ITF-14 barcode. By default they are drawn above and below the barcode, and each is twice as thick as the narrowest bar. Choose the frame when you print with printing plates. When the resolution is known, the frame is 4.83 mm thick by default. These sizes follow section 5.3.2.4 of the GS1 General Specifications, release 26.0. Bearer bars thinner than twice the narrowest bar are still drawn, with a warning (BX4017), and the barcode may not scan. Turning the bearer bars off also gives a warning (BX4018). The height that you give for the bars does not include the bearer bars.
The ratio of wide to narrow bars is 2.5 by default and can be set from 2.25 to 3.0 (section 5.3.2.2 of the GS1 General Specifications, release 26.0). A printer draws whole dots, so the ratio that is really used can differ a little from the one you asked for. BarcoderX uses the closest ratio that whole dots allow and tells you which one it used (BX4016). With a very narrow bar, only 3.0 is possible.
Quiet zones are 10 times the narrowest bar, on both sides (section 5.3.2.2 of the GS1 General Specifications, release 26.0).
The number under the barcode is worked out and reported. The label engine draws the text of a barcode when the barcode has a humanReadable setting (see The label engine); its tests of that part use an EAN-13, not these three barcodes. It puts the text one narrow bar below the bars, which is a choice of this project, and it does not check the distance that the specification asks for: section 5.3.2.2 of the GS1 General Specifications, release 26.0, asks for at least 1.02 mm between the bottom edge of the lower bearer bar and the top of the characters.
GS1-128
Content. The content is a string of element strings, one after the other: an identifier, then its data. BarcoderX adds the start marks and the Function 1 (FNC1) marks itself. You do not type them.
Separator. An element string of predefined length, one that is listed in Table 7-6 of the GS1 General Specifications, release 26.0 (section 7.8.4), such as (00) and (01), needs no separator. Any other element string needs the group separator character, which is ASCII 29, when another element string follows it. After the last element string no separator is needed. A separator that is not needed is accepted and dropped. A separator with no element string before it is an error (BX4020).
Length. At most 48 data characters fit, and the symbol with its quiet zones is at most 165.10 mm long (section 5.4.4.3 of the GS1 General Specifications, release 26.0). A symbol longer than 165.10 mm still gets made, with a warning (BX4021). Use a narrower bar or less data.
Check digits inside the data are checked, never computed. A wrong check digit is an error (BX4020).
Identifiers. For now only (00), the SSCC, and (01), the GTIN, are known. Any other identifier is refused (BX4019). The full list of identifiers is planned.
Parentheses. Typing identifiers in parentheses, such as (00) before a number, is not supported yet. The text under the barcode shows the identifier in parentheses (section 4.14 of the GS1 General Specifications, release 26.0), but BarcoderX does not take parentheses as part of the input yet. Give the identifier and the data without parentheses. For example, the content 00395123451234567895 is the identifier 00 followed by the 18 digits of the SSCC printed in Figure 5-34 of the GS1 General Specifications, release 26.0. The figure shows it under the barcode as (00)395123451234567895.
SSCC-18
Digits. Give 17 digits and BarcoderX adds the check digit, or give 18 and BarcoderX checks the last one.
Same symbol. An SSCC-18 barcode is the GS1-128 barcode of the element string with the identifier (00).
Example. 395123451234567895 is the SSCC printed as (00)395123451234567895 in Figure 5-34 of the GS1 General Specifications, release 26.0. Given as 17 digits, 39512345123456789, BarcoderX adds the check digit 5 and makes the same barcode.
What is the same for all three
BarcoderX draws the bars as rectangles on whole printer dots, with the width of the narrowest bar rounded to whole dots. It reports the width it really used. See Barcodes.
It does not check the height of the bars against the minimum that the GS1 General Specifications give for your use. Check the specification for the height that your label needs.
A printer's own barcode commands will be used only where they give the same result. See Printer languages.
Bad data gives a diagnostic code, not a crash. A setting that does not fit the symbology is refused (BX4015, BX4010).
The diagnostic codes of these barcodes are BX4001 to BX4003 and BX4010 to BX4021. Their texts, in English and Spanish, are in Diagnostic codes.
Not available yet
The full list of GS1 identifiers, and the checks that go with each one.
Identifiers typed in parentheses.
Checking the distance between the bearer bars and the text under the barcode.