CSV to Barcode Generator

Generate barcode images from CSV input.
Each row in the CSV produces one barcode image.
The actor outputs a ZIP archive containing all generated barcodes.

This actor is designed to be used as the first step in a barcode-to-receipt workflow, working especially well with Barcode Scans Receipt Generator .

---

Features

• Generate one barcode per CSV row
• Optional barcode format selection
• Optional labels under each barcode
• Dynamic label values from CSV headers
• Outputs a downloadable ZIP archive
• Designed to pair with Barcode Scans Receipt Generator for end-to-end workflows

---

Works well with

Barcode Scans Receipt Generator
This actor generates barcodes whose encoded values can be scanned and directly fed into the Barcode Scans Receipt Generator actor to produce a printable PNG receipt.

---

Typical workflow

1. Provide product or item data as CSV input
2. Generate barcode images using this actor
3. Print and scan the barcodes using any barcode scanner
4. Pass the decoded scan output into the Barcode Scans Receipt Generator actor
5. Receive a PNG receipt with aggregated items and totals

---

Input

body (required)

CSV content provided as a string.

id,name,price
1,Apple,0.99
2,Banana,0.59
3,Orange,0.79

---

barcode (optional)

Barcode format.
If omitted, a default format is used.

{
  "barcode": "CODE128"
}

Supported barcode formats:

• CODE128, CODE128A, CODE128B, CODE128C
• EAN13, EAN8, EAN5, EAN2
• UPCA, UPCE
• CODE39
• ITF, ITF14
• MSI10, MSI11, MSI1010, MSI1110
• Codabar
• Pharmacode
• CODE93

---

labeled (optional)

Controls whether labels are shown and their position.

Allowed values:

• left
• center
• right

If omitted, no label is rendered.

{
  "labeled": "center"
}

---

label (optional, array of strings)

Custom text displayed below the barcode.
Ignored if labeled is not set.

All array entries are rendered as a single line separated by | .

Supported formats:

• {header} → renders key and value
  Example: {id} → id: 1
• {{header}} → renders value only
  Example: {{name}} → Apple

Example:

{
  "label": [
    "{{id}}",
    "{{name}}",
    "{price}"
  ]
}

If label is omitted or empty, all CSV columns are rendered as a single line separated by | .

---

Barcode Data Format

Each generated barcode encodes plain text derived from the corresponding CSV row.

By default, all columns in a row are converted into a single-line key-value string, where each field is encoded as key=value and fields are separated by semicolons.

This encoded value is the actual data stored in the barcode and is independent of any optional labels, which are only visual text rendered below the barcode.

Example encoded value:

id=1;name=Apple;price=0.99

---

File Naming

The name of each generated barcode image depends on the presence of an id column in the CSV data.

• If the CSV contains an id column, each file is named:
  barcode-{id}.png
  Example: barcode-1.png, barcode-2.png
• If no id column is present, files are named incrementally starting from 1:
  barcode-1.png, barcode-2.png, barcode-3.png, …

---

Output

The actor produces a ZIP archive containing all generated barcode images.

Example dataset item:

{
  "zipUrl": "https://api.apify.com/v2/key-value-stores/STORE_ID/records/barcodes.zip"
}

---

Usage

1. Provide CSV data in the body input field
2. (Optional) Choose a barcode format
3. (Optional) Enable labels and define label content
4. Run the actor
5. Download the generated ZIP file

---

Notes

• Each data row in the CSV generates exactly one barcode image.
• The first row is always treated as the header row and is required; if headers are not provided, the first data row will be skipped and labels cannot be resolved.

---

License

MIT