Генератор этикеток и штрихкодов (v1.0)

Скрипты

Быстрый старт

Одна этикетка

from label_builder import build_label
path = build_label(
    name="Футболка мужская",
    barcode_value="4680000000001",
    brand="MyBrand",
    article="FT-001",
    composition="хлопок 100%",
    country="Китай",
    size="XL",
    marks=["EAC"],
    label_size="58x40",
    output_path=cw.output_path("label.png"),
)

Пакетная генерация → PDF

from batch_labels import batch_generate
products = [
    {"name": "Футболка", "barcode": "4680000000001", "brand": "Brand", "qty": 10},
    {"name": "Джинсы", "barcode": "4680000000002", "article": "J-100", "qty": 5},
]
path = batch_generate(
    products,
    label_size="58x40",
    page_format="a4",        # "a4" | "58x40" | "58x30" | "40x30"
    preset="70x37",           # A4 раскладка
    output_path=cw.output_path("labels.pdf"),
)

Только штрихкод

from barcode_gen import generate_barcode
path = generate_barcode("4680000000001", fmt="ean13")

Свой PDF из готовых этикеток

from pdf_builder import build_pdf_a4, build_pdf_thermal
# A4
build_pdf_a4(["l1.png", "l2.png"], quantities=[10, 5], preset="70x37")
# Термо
build_pdf_thermal(["l1.png"], quantities=[20], page_size="58x40")

Параметры этикетки

Размеры этикеток

A4 раскладки (preset)

Интеграция с маркетплейсами

Импорт товаров из WB

connector(service="wildberries", action="POST /content/v2/get/cards/list", params={"settings": {"cursor": {"limit": 100}, "filter": {"withPhoto": -1}}})

Маппинг: title → name, vendorCode → article, sizes[].skus[] → barcode.

Импорт товаров из Ozon

connector(service="ozon", action="POST /v3/product/list", params={"filter": {"visibility": "ALL"}, "last_id": "", "limit": 1000})

filter обязателен (минимум {"visibility": "ALL"}) — иначе 400. Пагинация по last_id.

Затем батч-инфо (до 1000 id за раз):

connector(service="ozon", action="POST /v3/product/info/list", params={"offer_id": ["SKU-001", "SKU-002"]})

Принимает любой из массивов: product_id[] | offer_id[] | sku[].

Маппинг: items[].name → name, items[].offer_id → article, items[].barcodes[0] → barcode_value.

FBO этикетки

Для FBO поставок используй SKU-баркоды маркетплейса:

• WB: barcode из карточки товара (поле sizes[].skus[])
• Ozon: barcode из карточки товара (см. секцию «Импорт товаров из Ozon» выше)

Генерируй информационные этикетки с этими баркодами через batch_generate().

FBS стикеры

Стикеры заказов получаются через API маркетплейса (готовые файлы):

• WB: connector(service="wildberries", action="POST /api/v3/orders/stickers", params={"orders": [id1, id2]})
• Ozon: connector(service="ozon", action="POST /v2/posting/fbs/package-label", params={"posting_number": ["..."]})

Скачай стикеры через коннектор. При необходимости объедини несколько PDF через pdf_builder.

Запреты

• Не генерируй невалидные EAN-13 (должно быть 12 цифр + контрольная, библиотека считает сама).
• Не хардкодь контрольную цифру EAN-13 — передавай 12 цифр, python-barcode добавит 13-ю.
• Для Code128 допустимы буквы и символы.

Пути

Перед отдачей

• Убедись что файл сгенерирован без ошибок
• present_files для отдачи результата пользователю