Etiketten rendern, erzeugen und drucken. Mit einer einzigen Bibliothek.

Ein Paket statt vier

Ein NuGet-Paket für vier Aufgaben

Viele .NET-Teams kaufen für Etiketten gleich mehrere SDKs: einen ZPL-Emulator, einen EPL-Emulator, einen Label-Designer und eine Barcode-Bibliothek. zplCore.com übernimmt ZPL-Rendering, EPL-Rendering, Label-Design und Barcode-Erzeugung in einer Assembly.

Plattform & Cloud

Läuft dort, wo Ihr Backend läuft

Docker & Kubernetes

Dockerfile und Helm-Chart im Lieferumfang

• Alle Tests laufen grün in den offiziellen .NET-10-Container-Images für Debian und Azure Linux 3.0.
• Dockerfile.server im Lieferumfang: Distroless-Image, läuft ohne Root-Rechte, mit /health-Endpunkt.
• Helm-Chart für Kubernetes im Lieferumfang. Das Image bauen Sie selbst, es liegt in keiner öffentlichen Registry.
• Keine zusätzlichen Systempakete nötig, die nativen Bibliotheken bringt das NuGet-Paket mit.
• Zustandslos pro Renderer: Ein Webdienst skaliert horizontal.
• Asynchrones ASP.NET-Core-Minimal-API-Beispiel mit Job-Queue (199.000 Labels/s ZPL-Erzeugung auf einem Mac).

FROM mcr.microsoft.com/dotnet/sdk:10.0 AS build
WORKDIR /src
COPY . .
RUN dotnet publish samples/WebApiDemo -c Release -o /app

FROM mcr.microsoft.com/dotnet/aspnet:10.0-azurelinux3.0-distroless
WORKDIR /app
COPY --from=build /app .
ENTRYPOINT ["dotnet","WebApiDemo.dll"]

kind: Deployment
spec:
  replicas: 2
  template:
    spec:
      containers:
        - name: label-api
          resources:
            requests: { cpu: 500m, memory: 512Mi }
            limits:   { cpu: "1",  memory: 1Gi }
          readinessProbe:
            httpGet: { path: /health, port: 8080 }
---
kind: HorizontalPodAutoscaler
spec:
  metrics:
    - type: Resource
      resource:
        name: cpu
        target: { type: Utilization, averageUtilization: 70 }

Code

Drei Zeilen bis zur Vorschau

var renderer = new ZplRenderer(new ZplRenderSettings { Dpi = 203 }.WithLabelSizeMm(100, 150));
List<byte[]> pngs = renderer.ProcessCommands(
    "^XA^FO50,50^A0N,40,40^FDHallo Welt^FS^BY2^FO50,120^BCN,80^FD12345^FS^XZ");
renderer.Settings.OutputFormat = ZplOutputFormat.Pdf;
File.WriteAllBytes("preview.pdf", renderer.ProcessFile("labels.zpl")[0]);

using ZplCore.Labels;
var job = PrintJobTemplate.FromFiles("templates/leading.json", "templates/shipping.json", "templates/trailing.json");
job.JobName = "Tour 7";
job.KeyField = "TrackingNo";          // erster/letzter Schlüssel auf dem End-Label
job.CutAfterLastLabel = true;        // Schnitt nur nach dem letzten Label
job.StoredFormatName = "R:SHIP.ZPL";  // Vorlage einmal, danach nur Feldwerte
string zpl = job.For<Shipment>().ToZpl(db.Shipments.Where(s => !s.Printed).Take(50).ToList());
File.WriteAllText("job.zpl", zpl);     // 52 Labels in EINER Datei

# samples/WebApiDemo – ASP.NET Core Minimal API
dotnet run -c Release --project samples/WebApiDemo
# 50.000 Sendungen aus EF Core/SQLite als ZPL streamen
curl 'localhost:5080/api/jobs/db/zpl?country=AT&take=50000' -o at.zpl
# PDF-Vorschau aus JSON-Datensätzen
curl -X POST 'localhost:5080/api/jobs/preview?format=pdf' -H 'Content-Type: application/json' -d @records.json -o preview.pdf
# Asynchron über die Queue: 202 Accepted, 429 wenn voll
curl -X POST localhost:5080/api/queue -H 'Content-Type: application/json' -d '{"db":{"country":"AT","take":20000},"output":"zpl"}'

var epl = new EplRenderer(new ZplRenderSettings { Dpi = 203 });
List<byte[]> labels = epl.ProcessFile("label.epl");
string zpl = epl.ToZpl(File.ReadAllText("label.epl")); // EPL-Formulare nach ZPL migrieren

var bc = new ZplCore.Barcodes.Barcode
{
    Symbology = ZplCore.Barcodes.Symbology.Gs1_128,
    Code = "(01)09521234543213(10)LOT42",
    Unit = ZplCore.Barcodes.BarcodeUnit.Millimeter, BarWidth = 0.33, BarHeight = 20,
};
File.WriteAllText("gs1.svg", bc.ToSvg());

FAQ

Häufige Fragen