Generate a UCC-128 (GS1-128) Label

Overview

Orderful offers a label printing API that generates a ZPL (Zebra Programming Language) file. This file can then be sent to a compatible printer to print a shipping label. The shipping labels Orderful generates include barcodes in GS1-128 (formerly UCC / EAN-128) format, including SSCC-18 barcodes where required.

Generating a shipping label is a three step process:

  1. You POST to the /labels endpoint with the appropriate data for that company.
  2. Orderful will respond with a text payload in ZPL format.
  3. You Send the ZPL content to your printer.

📘

Print Density

Orderful's print templates are built for a print density of 8 dpmm (203 dpi). If you print a label and it appears much too big or small, please confirm your print density setting.

Currently Orderful supports generating shipping labels for the following companies:

To request support for a different company, please contact Orderful Support.

Label Validation

If any required information is missing or otherwise non-compliant with either Orderful or the company's requirements, the API will return an error describing the problem. For example, if the "Ship From Name" is missing, the API will return the following error:

{
    "type": "argumentError",
    "ref": "user",
    "message": "There are errors with your label data.",
    "errors": [
        {
            "type": "argumentError",
            "ref": "shipFrom.name",
            "message": "Field must be provided for this label type."
        }
    ]
}

Report an Error

If you experience any problems with your shipping label, please contact Orderful support.