---
title: "Druk etykiet i kodów kreskowych przez API"
description: "Wysyłaj gotowe etykiety produktowe, magazynowe i kodowe w PDF, ZPL, TSPL lub CPCL do zgodnej lokalnej drukarki."
---
<nav class="docs-breadcrumb" aria-label="Breadcrumb"><a href="/pl/docs/">Dokumentacja CloudPrint</a><span aria-hidden="true">/</span><span>Procesy drukowania</span></nav>

# Druk etykiet i kodów kreskowych przez API

<p class="docs-lead">CloudPrint dostarcza gotowe etykiety produktowe, magazynowe i kodowe do lokalnych drukarek. Aplikacja przygotowuje treść, a CloudPrint przyjmuje gotowy PDF albo dane RAW w ZPL, TSPL lub CPCL, sprawdza trasę i śledzi zadanie.</p>

## Przygotuj końcową etykietę

Wygeneruj kod kreskowy, tekst i układ w sklepie internetowym, systemie magazynowym, ERP lub WMS. CloudPrint nie jest projektantem etykiet i nie zmienia danych biznesowych. Przed przesłaniem sprawdź, czy produkt, partia, zamówienie i wartość kodu dotyczą tej samej operacji.

## Wybierz PDF albo język drukarki

PDF sprawdza się dla etykiety przygotowanej jako strona, jeśli kolejka obsługuje druk systemowy lub dostępny renderer. Dla bezpośredniego druku termicznego ustaw `document_format=raw` oraz `document_raw_language`: `zpl`, `tspl` albo `cpcl`. CloudPrint nie konwertuje języków drukarek.

## Sprawdź wykryte możliwości

Wywołaj `GET /api/v1/printers` i odczytaj `capabilities.language_profiles` wraz z `endpoint.raw_passthrough_available`. Agent wykrywa te dane z drukarki i kolejki. Wybierz trasę, która ogłasza potrzebny język; nie zgaduj po marce ani nazwie i nie każ operatorowi przypisywać języka ręcznie.

## Dopasuj fizyczny nośnik

Rozmiar strony lub poleceń musi odpowiadać etykiecie. W razie potrzeby ustaw `media_width_mm`, `media_height_mm` i `dpi`, a w drukarce skalibruj czujnik, gęstość oraz prędkość. Przed wdrożeniem wydrukuj i zeskanuj rzeczywiste próbki; status `printed` nie potwierdza czytelności obciętego kodu.

## Świadomie kieruj i ponawiaj

Zapisz `printer_id` dla każdego stanowiska lub zastosowania etykiety. Utwórz zadanie ze stabilnym `Idempotency-Key`, zapisz `print_job_id` i sprawdź wynik końcowy. Ponowienie po przekroczeniu czasu zachowuje klucz; celowy dodruk używa nowego klucza i zapisanej przyczyny.

## Następne kroki

<div class="docs-card-grid"><a class="docs-card" href="/pl/docs/guides/shipping-labels/"><strong>Drukowanie etykiet wysyłkowych z aplikacji</strong><span>Wysyłaj gotowe etykiety PDF albo dane RAW w języku ZPL, TSPL lub CPCL ze sklepu internetowego, WMS albo ERP na właściwą drukarkę.</span></a>
<a class="docs-card" href="/pl/docs/guides/print-formats/"><strong>PDF i języki drukarek RAW</strong><span>Wybierz PDF albo jawny język RAW — ZPL, TSPL, CPCL lub ESC/POS — i kieruj zadanie wyłącznie do zgodnej drukarki.</span></a>
<a class="docs-card" href="/pl/docs/api/print-jobs/"><strong>Tworzenie i śledzenie zadań druku</strong><span>Twórz idempotentne zadania CloudPrint, sprawdzaj opcje drukarki i bezpiecznie śledź je aż do stanu końcowego.</span></a></div>

<nav class="docs-resource-links" aria-label="Następne kroki"><a href="https://cloudprint.me/status/">Status usługi</a><a href="/pl/docs/api/v1/explorer/">OpenAPI</a><a href="https://developer.cloudprint.me">Developer Portal</a><a href="https://my.cloudprint.me">Otwórz panel</a><a href="/docs/legal/privacy/">Polityka prywatności</a><a href="/pl/docs/legal/terms/">Regulamin</a><a href="/pl/docs/legal/data-processing/">DPA</a><a href="/docs/legal/service-level-agreement/">Service Level Agreement</a></nav>