FALLSTUDIE

Klemen Trade

Minimax-connected EAN13 label printing for fast retail operations.

Kurzüberblick

  • Branche: Retail / distribution (product labeling)
  • Lieferumfang: Lightweight web app for Minimax item lookup + printable EAN13 labels
  • Rolle: Architecture, implementation, print-flow UX
  • Integrationspunkte: Minimax OAuth2 + REST API (items lookup)
  • Status: Production internal tool

Kontext

Elektroplus maintains product data in Minimax and needs a fast way to print shelf/product labels with EAN13 barcodes. ERP UI flows are too slow for day-to-day labeling tasks, especially when printing multiple items in batches.

Problem

  • Employees need to find items by item code or EAN code and print labels immediately.
  • Printing must produce stable A4 label sheets with correct grid alignment and page breaks.
  • Partially used sheets require an offset (skip N labels before printing).
  • Labels must include EAN13 barcodes and a price breakdown (net/VAT/gross).

Projektziele

  • Minimal UI to add multiple items and quantities for a print run.
  • Fetch item data directly from Minimax to avoid manual entry errors.
  • Generate EAN13 barcodes in-browser and print in a consistent A4 grid layout.
  • Support offset/skip for partially used label sheets.

Lösungsüberblick

We delivered a small web app that:

  • Searches Minimax items by code or EAN and pre-fills label rows (name, EAN, price).
  • Lets users build a batch list with quantities and remove items as needed.
  • Renders print pages as a fixed 3×8 A4 grid (24 labels/page) with optional start offset.
  • Generates EAN13 barcodes client-side via JsBarcode and triggers printing.

Architektur & technischer Ansatz

Minimax integration

  • OAuth2 token handling with refresh support.
  • Item lookup endpoints: `/items/code(...)`, `/items?SearchString=...`, `/items/{id}`.
  • Single JSON endpoint that returns item payloads to the UI.

Print engine

  • Print-only DOM rendering (`@media print`) with `@page` A4 sizing.
  • Stable grid layout with automatic page breaks.
  • Offset support: inserts empty labels before printing the batch.

Barcode generation

  • Generates an <svg> per label and renders EAN13 using JsBarcode.
  • Ensures rendering completes before calling `window.print()`.

Technologie-Stack

  • PHP (Minimax client + JSON endpoint)
  • JavaScript + jQuery (UI interactions, batching, print flow)
  • JsBarcode (EAN13 rendering)
  • HTML/CSS print styling (`@page`, grid layout, print-only rendering)

Results & Impact

  • Fast daily workflow: search → add to batch → print.
  • Reduced errors by pulling names/EAN/prices directly from Minimax.
  • Consistent A4 output with predictable alignment and page breaks.
  • Less wasted label sheets thanks to the offset control.

Summary

A Minimax-connected label printing tool that lets staff search items by code/EAN and generate print-ready A4 sheets of EAN13 barcode labels with a price breakdown—optimized for fast retail operations.