HIBC

Overview

The parser supports the ANSI HIBC 2.5 supplier labeling standard. For the complete documentation of the standard please refer to the official website.

Sample usage for HIBC parser and Barcode Capture

First, you need to create a DataCaptureContext, access a Camera and create HIBC parser:

DataCaptureContext dataCaptureContext = DataCaptureContext.forLicenseKey(SCANDIT_LICENSE_KEY);
Camera camera = Camera.getDefaultCamera();
camera.applySettings(BarcodeCapture.createRecommendedCameraSettings());
dataCaptureContext.setFrameSource(camera);
camera.switchToDesiredState(FrameSourceState.ON);

BarcodeCaptureSettings barcodeCaptureSettings = new BarcodeCaptureSettings();
barcodeCaptureSettings.enableSymbology(Symbology.DATA_MATRIX, true);
BarcodeCapture barcodeCapture = BarcodeCapture.forDataCaptureContext(dataCaptureContext, barcodeCaptureSettings);

Parser parser = Parser.forFormat(dataCaptureContext, ParserDataFormat.HIBC);

Then, you need to implement BarcodeCaptureListener:

class MyBarcodeCaptureListener implements BarcodeCaptureListener {
  @Override
  public void onBarcodeScanned(
    @NonNull BarcodeCapture barcodeCapture,
    @NonNull BarcodeCaptureSession session,
    @NonNull FrameData frameData
  ) {
      if (session.getNewlyRecognizedBarcode() == null) return;

      Barcode barcode = session.getNewlyRecognizedBarcode();
      String data = barcode.getData();

      try {
        ParsedData parsedData = parser.parseString(data);
        /*
         * Extract the fields relevant to your use case. Below, for example, we extract a label,
         * which has the type String, and an expiry date, which is represented as a map with keys
         * "year", "month", "day".
        */
        String serialNumber = (String) parsedData.getFieldsByName().get("lic").getParsed();

        Map<String, Object> expiryDate = (Map<String, Object>) parsedData.getFieldsByName().get("expiryDate").getParsed();
        int year = expiryDate.get("year");
        int month = expiryDate.get("month");
        int day = expiryDate.get("day");

        // Do something with the extracted fields.

      } catch (RuntimeException e) {
        message = e.getMessage();
      }
    }
    // Other callbacks omitted for brevity.
}

Finally, add the listener to the mode to receive scan results:

barcodeCapture.addListener(new MyBarcodeCaptureListener());

For details, go to the API docs.

Example

Parsing following code (without quotes):

"+A123BJC5D6E71G"

will result in following JSON output:

[
    {
       "name" : "lic",
       "parsed" : "A123",
       "rawString" : "A123"
    },
    {
       "name" : "pcn",
       "parsed" : "BJC5D6E7",
       "rawString" : "BJC5D6E7"
    },
    {
       "name" : "uom",
       "parsed" : 1,
       "rawString" : "1"
    },
    {
       "name" : "metadata",
       "parsed" : {
          "checksum" : "G",
          "primary" : true,
          "secondary" : false
       },
       "rawString" : ""
    }
 ]

Exposed fields

A code might contain a primary and/or secondary section. If it contains a secondary section, it might also contain an additional section for miscellaneous data. To check whether a primary/secondary/additional section is present, check the ‘metadata’ field. The order of the fields corresponds to order in the data string. The ‘metadata’ field, is always the last field.

Primary data fields

Field Name

Always present?

Parsed Data Sructure

Additional Notes

lic

yes (if primary present)

alphanumeric string

Label Identification Code

pcn

yes (if primary present)

alphanumeric string

Product or Catalogue Number

uom

yes (if primary present)

One-digit integer

Unit of Measure

Secondary data fields

Field Name

Always
present?

Parsed Data Structure

Additional Notes

quantity

no

integer

expiryDate

no

Dictionary with these
key/value pairs:
  • ‘year’ : YY,

  • ‘month’ : MM,

  • ‘day’ : DD,

  • (‘hour’ : HH)

where YY, MM, DD, HH are
two-digit integers. ‘hour’
is optional and not always
present.

serial

no

string

Serial number

lot

no

string

Lot/Batch number

Additional data fields

Field Name

Always
present?

Parsed Data Sructure

Additional Notes

serial

no

String
Serial number
If the serial number is
specified in the secondary
and the additional data,
then the first is ignored.

expiryDate

no

Dictionary with these
key/value pairs:
  • ‘year’ : YYYY,

  • ‘month’: MM,

  • ‘day’ : DD

with YYYY, MM, DD
integers
If the expiry date
specified in the secondary
and in the additional data,
then the first is ignored.

manufactureDate

no

Dictionary with these
key/value pairs:
  • ‘year’ : YYYY,

  • ‘month’: MM,

  • ‘day’ : DD

with YYYY, MM, DD
integers

Metadata field

Field Name

Always present?

Parsed Data Sructure

Additional Notes

metadata

yes

Dictionary with these
key/value pairs:
  • ‘primary’ : boolean,

  • ‘secondary’ : boolean,

  • ‘link’ : string, optional

  • ‘checksum’ : string

The primary and secondary
booleans indicate wether
the corresponding section
is present in the code.
The link string is one
character and is used to
link a separate primary and
secondary code together. It
is only present for
standalone secondary codes.
‘check’ is the checksum
character of the code. The
Scandit parser library
automatically checks the
ingerity of the code.