Zovo Barcode Maker

Use this when the user wants a barcode generator: a UPC or EAN-13 barcode for a product, a Code 128 barcode for a SKU or label, GS1-128 with (01) GTIN, (17) expiry and (10) lot, Code 39, an ITF-14 carton code, or a book ISBN barcode. Computes or verifies the check digit (explains a wrong one), applies GS1 quiet zones and sizes, and returns SVG and PNG download links plus calculated print dimensions. One barcode per request; Code 128 up to 80 characters, Code 39 up to 60 characters, and GS1-128 up to 48 data characters including separator FNC1 characters. Does not issue or register GS1 numbers (real UPC/EAN numbers must be licensed from GS1), does not scan images or look up products. Do not use for QR codes.

{
  "type": "object",
  "properties": {
    "symbology": {
      "type": "string",
      "enum": [
        "ean13",
        "ean8",
        "upca",
        "upce",
        "code128",
        "gs1_128",
        "code39",
        "itf14",
        "isbn",
        "issn"
      ],
      "description": "Barcode type, e.g. ean13. ean13 (EAN-13 retail, 12 or 13 digits), ean8 (7 or 8 digits), upca (UPC-A, 11 or 12 digits), upce (UPC-E: 6-8 digits, or a 12-digit UPC-A to compress), code128 (any ASCII text such as SKUs; automatic code set A/B/C switching), gs1_128 (GS1-128 with Application Identifiers), code39 (A-Z, 0-9, - . space $ / + %), itf14 (GTIN-14 carton code with bearer bars, 13 or 14 digits), isbn (book barcode from an ISBN-10 or ISBN-13), issn (magazine barcode from an ISSN)."
    },
    "data": {
      "type": "string",
      "minLength": 1,
      "maxLength": 120,
      "description": "What to encode, e.g. 590123412345 (the check digit is added if missing; spaces, hyphens and a leading spreadsheet apostrophe are ignored in numbers), A-10442 for Code 128 (encoded exactly, plain ASCII), (01)09501101530003(17)261231(10)LOT42 for GS1-128 (parentheses recommended; unbracketed AI strings are also read), 0-306-40615-2 for ISBN."
    },
    "add_on": {
      "description": "Optional 2- or 5-digit add-on printed to the right of an EAN-13, UPC-A, UPC-E, EAN-8, ISBN or ISSN barcode, e.g. 51299 (book price code for 12.99 USD) or 07 (magazine issue).",
      "type": "string",
      "maxLength": 8
    },
    "fix_check_digit": {
      "description": "If the number already has a check digit and it is wrong, replace it with the correct one instead of returning an error, e.g. true. Default false.",
      "type": "boolean"
    },
    "code39_check_digit": {
      "description": "Code 39 only: append the optional modulo-43 check character, e.g. true. Default false.",
      "type": "boolean"
    },
    "magnification_percent": {
      "description": "EAN/UPC/ISBN/ISSN and ITF-14 size as a percentage of the GS1 nominal size, e.g. 100 (EAN-13 = 37.29 x 25.93 mm; GS1 retail range 80-200).",
      "type": "number",
      "minimum": 25,
      "maximum": 250
    },
    "x_dimension_mm": {
      "description": "Width of the narrowest bar in millimetres, e.g. 0.33. Overrides magnification. Defaults: 0.33 (EAN/UPC, Code 128, Code 39), 0.495 (GS1-128), 0.635 (ITF-14).",
      "type": "number",
      "minimum": 0.1,
      "maximum": 2
    },
    "bar_height_mm": {
      "description": "Bar height in millimetres, e.g. 15. Defaults to the GS1 height for retail codes, 31.75 mm for ITF-14 and GS1-128, else the larger of 12.7 mm and 15% of the symbol length.",
      "type": "number",
      "minimum": 3,
      "maximum": 300
    },
    "printer_dpi": {
      "description": "Resolution of the label printer, e.g. 203 or 300. Bar widths are snapped to whole printer dots so every bar prints exactly; the PNG is rendered at this resolution.",
      "type": "integer",
      "minimum": 100,
      "maximum": 1200
    },
    "show_text": {
      "description": "Print the human-readable digits/text under the bars, e.g. true (default).",
      "type": "boolean"
    }
  },
  "required": [
    "symbology",
    "data"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "kind": {
      "type": "string"
    },
    "symbology": {
      "type": "string"
    },
    "label": {
      "type": "string"
    },
    "data": {
      "type": "string"
    },
    "hri": {
      "type": "string"
    },
    "check": {},
    "related": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": "string"
      }
    },
    "gs1_prefix": {},
    "gs1_elements": {},
    "code128": {},
    "size": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "png": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "guidance": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "warnings": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "notes": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "gs1_notice": {
      "type": [
        "string",
        "null"
      ]
    },
    "render": {},
    "downloads": {
      "type": "object",
      "properties": {
        "svg": {
          "type": "string"
        },
        "png": {
          "type": "string"
        }
      },
      "required": [
        "svg",
        "png"
      ],
      "additionalProperties": false
    },
    "request": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    }
  },
  "required": [
    "kind",
    "symbology",
    "label",
    "data",
    "hri",
    "check",
    "related",
    "gs1_prefix",
    "size",
    "png",
    "guidance",
    "warnings",
    "notes",
    "gs1_notice",
    "render",
    "downloads",
    "request"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Use this when the user asks whether a UPC, EAN, GTIN-8/12/13/14, SSCC, ISBN-10/13 or ISSN number is valid, what its check digit should be, or wants to convert ISBN-10 to ISBN-13, UPC-E to UPC-A, or UPC-A to EAN-13/GTIN-14. Explains the check-digit arithmetic, gives the corrected number and the GS1 prefix meaning. Does not tell who owns a number, whether it is registered with GS1, or what product it is; does not look anything up online.

{
  "type": "object",
  "properties": {
    "number": {
      "type": "string",
      "minLength": 1,
      "maxLength": 40,
      "description": "The number to check, e.g. 5901234123457, 036000291452, 0-306-40615-2 (ISBN-10), 0317-8471 (ISSN) or 106141412345678908 (SSCC). Spaces and hyphens are ignored. Without its check digit (e.g. 03600029145) the check digit is computed."
    },
    "type": {
      "description": "Number type, e.g. auto (default: detected from the length). gtin8, gtin12 (UPC-A), gtin13 (EAN-13), gtin14, sscc, upce, isbn10, isbn13, issn. Use upce or issn for 8-digit numbers that are not EAN-8.",
      "type": "string",
      "enum": [
        "auto",
        "gtin8",
        "gtin12",
        "gtin13",
        "gtin14",
        "sscc",
        "upce",
        "isbn10",
        "isbn13",
        "issn"
      ]
    }
  },
  "required": [
    "number"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "kind": {
      "type": "string"
    },
    "input": {
      "type": "string"
    },
    "type": {
      "type": "string"
    },
    "type_label": {
      "type": "string"
    },
    "valid": {
      "type": "boolean"
    },
    "check_given": {
      "type": "string"
    },
    "check_expected": {
      "type": "string"
    },
    "corrected": {
      "type": "string"
    },
    "explanation": {
      "type": "string"
    },
    "equivalents": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": "string"
      }
    },
    "gs1_prefix": {},
    "notes": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "barcode": {}
  },
  "required": [
    "kind",
    "input",
    "type",
    "type_label",
    "valid",
    "check_given",
    "check_expected",
    "corrected",
    "explanation",
    "equivalents",
    "gs1_prefix",
    "notes",
    "barcode"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}