Documentation – Supported Complex Barcode Types

Java: Swiss QR Barcodes

Mon, 01 Jan 0001 00:00:00 +0000

Swiss QR Barcodes

Swiss QR stores structured payment information in a QR Code carrier. The typed model includes account, amount, currency, creditor, debtor, payment reference, and additional messages.

The complete source code for this article is available on GitHub:

View SwissQRBarcodes.java

Create the payment model

SwissQRCodetext codetext =
        new SwissQRCodetext();

codetext.getBill()
        .setVersion(QrBillStandardVersion.V2_0);

codetext.getBill()
        .setAccount("CH4431999123000889012");

codetext.getBill()
        .setAmount(100.25);

codetext.getBill()
        .setCurrency("CHF");

Configure addresses

Address creditor = new Address();
creditor.setName("Robert Schneider AG");
creditor.setStreet("Rue du Lac");
creditor.setHouseNo("1268");
creditor.setPostalCode("2501");
creditor.setTown("Biel");
creditor.setCountryCode("CH");

codetext.getBill().setCreditor(creditor);

Configure the debtor with another Address object.

Add reference and messages

codetext.getBill().setReference(
        "210000000003139471430009017"
);

codetext.getBill().setUnstructuredMessage(
        "Invoice 2026-001"
);

codetext.getBill().setBillInformation(
        "//S1/10/2026001"
);

Generate the QR image

ComplexBarcodeGenerator generator =
        new ComplexBarcodeGenerator(codetext);

generator.save(
        "swiss_qr_bill.png",
        BarCodeImageFormat.PNG
);

Read and decode payment data

BarCodeReader reader =
        new BarCodeReader(outputPath, DecodeType.QR);

BarCodeResult[] results = reader.readBarCodes();

SwissQRCodetext decoded =
        ComplexCodetextReader.tryDecodeSwissQR(
                results[0].getCodeText()
        );

Validate account, amount, currency, reference, creditor, and debtor values.

Recommendations

Use a valid Swiss QR IBAN.
Populate required creditor fields.
Use supported currency values.
Validate reference format before generation.
Decode generated symbols in automated tests.
Compare all important payment fields after decoding.

Java: HIBC Barcodes

Mon, 01 Jan 0001 00:00:00 +0000

HIBC Barcodes

Aspose.BarCode for Java supports structured HIBC LIC and HIBC PAS models. LIC combines product identification with secondary production data, while PAS stores typed healthcare process records.

The complete source code for this article is available on GitHub:

View HIBCBarcodes.java

Configure HIBC LIC primary data

PrimaryData primaryData = new PrimaryData();

primaryData.setLabelerIdentificationCode("A999");
primaryData.setProductOrCatalogNumber("12345");
primaryData.setUnitOfMeasureID(1);

Configure HIBC LIC secondary data

SecondaryAndAdditionalData secondaryData =
        new SecondaryAndAdditionalData();

secondaryData.setExpiryDateFormat(
        HIBCLICDateFormat.YYYYMMDD
);
secondaryData.setExpiryDate(
        LocalDateTime.of(2027, 12, 31, 0, 0)
);
secondaryData.setQuantity(30);
secondaryData.setLotNumber("LOT123");
secondaryData.setSerialNumber("SERIAL123");

Generate and decode HIBC LIC

HIBCLICCombinedCodetext codetext =
        new HIBCLICCombinedCodetext();

codetext.setBarcodeType(EncodeTypes.HIBCQRLIC);
codetext.setPrimaryData(primaryData);
codetext.setSecondaryAndAdditionalData(secondaryData);

ComplexBarcodeGenerator generator =
        new ComplexBarcodeGenerator(codetext);

Decode the recognized text with ComplexCodetextReader.tryDecodeHIBCLIC and verify the returned subtype before casting.

Create HIBC PAS records

HIBCPASCodetext codetext =
        new HIBCPASCodetext();

codetext.setDataLocation(
        HIBCPASDataLocation.PATIENT
);

codetext.addRecord(
        HIBCPASDataType.LABELER_IDENTIFICATION_CODE,
        "A123"
);

codetext.addRecord(
        HIBCPASDataType.MANUFACTURER_SERIAL_NUMBER,
        "SERIAL123"
);

codetext.setBarcodeType(
        EncodeTypes.HIBC_DATA_MATRIX_PAS
);

Decode HIBC PAS

HIBCPASCodetext decoded =
        ComplexCodetextReader.tryDecodeHIBCPAS(
                results[0].getCodeText()
        );

Validate the data location and record collection after decoding.

Recommendations

Select the correct HIBC carrier type.
Keep primary and secondary LIC data separate.
Use the matching expiry-date format.
Use typed PAS identifiers for every record.
Validate decoded records and business fields.

Java: Royal Mail Mailmark Barcodes

Mon, 01 Jan 0001 00:00:00 +0000

Royal Mail Mailmark Barcodes

Aspose.BarCode for Java supports typed Royal Mail Mailmark 1D and Mailmark 2D payloads with postal routing and item-identification fields.

The complete source code for this article is available on GitHub:

View RoyalMailMailmarkBarcodes.java

Generate Mailmark 1D

MailmarkCodetext codetext =
        new MailmarkCodetext();

codetext.setFormat(1);
codetext.setVersionID(1);
codetext.setClass("1");
codetext.setSupplychainID(99);
codetext.setItemID(12345678);
codetext.setDestinationPostCodePlusDPS(
        "XY11     "
);

Generate the image with ComplexBarcodeGenerator and recognize it with DecodeType.MAILMARK.

Decode Mailmark 1D

MailmarkCodetext decoded =
        ComplexCodetextReader.tryDecodeMailmark(
                results[0].getCodeText()
        );

Verify format, version, class, supply-chain ID, item ID, and destination postcode plus DPS.

Generate Mailmark 2D

Mailmark2DCodetext codetext =
        new Mailmark2DCodetext();

codetext.setUPUCountryID("JGB ");
codetext.setInformationTypeID("0");
codetext.setVersionID("1");
codetext.setclass("1");
codetext.setSupplyChainID(1234567);
codetext.setItemID(12345678);
codetext.setDestinationPostCodeAndDPS("XY11     ");
codetext.setRTSFlag("0");
codetext.setReturnToSenderPostCode("B1 1AA");
codetext.setCustomerContent("ABC123");
codetext.setDataMatrixType(
        Mailmark2DType.TYPE_7
);

Decode Mailmark 2D

Mailmark 2D uses a Data Matrix carrier:

Mailmark2DCodetext decoded =
        ComplexCodetextReader.tryDecodeMailmark2D(
                results[0].getCodeText()
        );

Validate routing, return-to-sender, supply-chain, item, and customer-content fields.

Recommendations

Preserve required field lengths and padding.
Use the correct Mailmark 2D type.
Validate item and supply-chain identifiers.
Recognize the correct carrier symbology.
Compare decoded postal fields in regression tests.

Java: MaxiCode Barcodes

Mon, 01 Jan 0001 00:00:00 +0000

MaxiCode Barcodes

Aspose.BarCode for Java provides typed models for MaxiCode mode 2 and mode 3. The modes differ mainly in the postal-code format and both support structured second messages.

The complete source code for this article is available on GitHub:

View MaxiCodeBarcodes.java

Create MaxiCode mode 2

Mode 2 uses a numeric postal code:

MaxiCodeCodetextMode2 codetext =
        new MaxiCodeCodetextMode2();

codetext.setPostalCode("524032140");
codetext.setCountryCode(56);
codetext.setServiceCategory(999);

Add a structured second message

MaxiCodeStructuredSecondMessage message =
        new MaxiCodeStructuredSecondMessage();

message.add("MODE 2 MESSAGE");
message.add("WAREHOUSE 12");
message.setYear(26);

codetext.setSecondMessage(message);

Create MaxiCode mode 3

Mode 3 supports an alphanumeric postal code:

MaxiCodeCodetextMode3 codetext =
        new MaxiCodeCodetextMode3();

codetext.setPostalCode("B1050");
codetext.setCountryCode(56);
codetext.setServiceCategory(999);

Read the recognized mode

The recognized MaxiCode mode is available through extended parameters:

int mode = results[0]
        .getExtended()
        .getMaxiCode()
        .getMode();

Pass the mode and recognized text to the decoder:

MaxiCodeCodetext decoded =
        ComplexCodetextReader.tryDecodeMaxiCode(
                mode,
                results[0].getCodeText()
        );

Validate the decoded subtype

Check whether the result is MaxiCodeCodetextMode2 or MaxiCodeCodetextMode3 before casting. Then validate postal code, country code, service category, year, and second-message identifiers.

Recommendations

Use mode 2 for numeric postal codes.
Use mode 3 for alphanumeric postal codes.
Read the recognized mode from extended parameters.
Pass the mode to tryDecodeMaxiCode.
Validate the decoded subtype before casting.

Java: USA Driver ID Barcodes

Mon, 01 Jan 0001 00:00:00 +0000

USA Driver ID Barcodes

USA Driver ID data is represented as a structured AAMVA payload stored in a PDF417 carrier. The typed model separates header information, mandatory fields, and optional fields.

The complete source code for this article is available on GitHub:

View USADriverIDBarcodes.java

Configure the AAMVA header

USADriveIdCodetext codetext =
        new USADriveIdCodetext();

codetext.setIssuerIdentificationNumber("636026");
codetext.setAAMVAVersionNumber("08");
codetext.setJurisdictionVersionNumber("00");
codetext.setNumberOfEntries(1);

codetext.setSubfileDesignator(
        List.of(
                new USADriveIdCodetext
                .SubfileProperties("DL")
        )
                );

Configure mandatory fields

The mandatory AAMVA data includes identity, document, address, physical-description, and truncation fields. The following example matches the complete set used in the related TestNG class.

USADriveIdCodetext.MandatoryFields fields =
        new USADriveIdCodetext.MandatoryFields();

fields.setVehicleClass("C");
fields.setRestrictionCodes("NONE");
fields.setEndorsementCodes("NONE");

fields.setExpirationDate(LocalDate.of(2030, 12, 31));

fields.setFamilyName("DOE");
fields.setFirstName("JOHN");
fields.setMiddleName("Q");

fields.setIssueDate(LocalDate.of(2026, 1, 1));

fields.setDateOfBirth(LocalDate.of(1990, 5, 20));

fields.setSex(USADriveIdSex.MALE);
fields.setEyeColor(USADriveIdEyeColor.BROWN);
fields.setHeight("070 in");

fields.setAddressStreet1("123 MAIN STREET");
fields.setAddressCity("ANYTOWN");
fields.setAddressState("CA");
fields.setAddressPostalCode("90210");

fields.setCustomerIDNumber("D1234567");
fields.setDocumentDiscriminator("DOC123456789");

fields.setCountryIdentification(USADriveIdCountry.US);

fields.setFamilyNameTruncation("N");
fields.setFirstNameTruncation("N");
fields.setMiddleNameTruncation("N");

codetext.setMandatoryElements(fields);

These values are serialized into the AAMVA data structure before the PDF417 carrier is generated.

Configure optional fields

USADriveIdCodetext.OptionalFields optional =
        new USADriveIdCodetext.OptionalFields();

optional.setHairColor(USADriveIdHairColor.BROWN);
optional.setOrganDonorIndicator("1");

codetext.setOptionalElements(optional);

Optional fields extend the cardholder data without replacing the mandatory AAMVA elements.

Generate the PDF417 carrier

ComplexBarcodeGenerator generator = new ComplexBarcodeGenerator(codetext);

generator.save("usa_driver_id.png",BarCodeImageFormat.PNG);

Recognize the generated image with DecodeType.PDF_417.

BarCodeReader reader = new BarCodeReader("usa_driver_id.png",DecodeType.PDF_417);

BarCodeResult[] results = reader.readBarCodes();

Decode Driver ID data

USADriveIdCodetext decoded = ComplexCodetextReader.tryDecodeUSADriveId(results[0].getCodeText());

After decoding, the mandatory and optional objects can be accessed directly.

String familyName = decoded.getMandatoryElements().getFamilyName();

String documentNumber = decoded.getMandatoryElements().getCustomerIDNumber();

USADriveIdHairColor hairColor = decoded.getOptionalElements().getHairColor();

Validate issuer, AAMVA version, identity, document, address, physical-description, truncation, and optional cardholder fields.

Recommendations

Populate every mandatory AAMVA field required by the selected format.
Use the correct AAMVA and jurisdiction versions.
Preserve required date, height, address, and document formats.
Set truncation indicators explicitly when required by the data format.
Recognize the carrier as PDF417.
Validate both mandatory and optional decoded fields.