---
title: "Создать шаблон этикетки"
method: POST
path: "/api/v1/marking/label-templates"
tags: ["Marking labels"]
---

# Создать шаблон этикетки

`POST /api/v1/marking/label-templates`

## Request

- Base URL: `https://erp.akeda.ru`
- URL: `https://erp.akeda.ru/api/v1/marking/label-templates`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-Api-Key`
  - OAuth 2 (authorization code, authorization URL `https://erp.akeda.ru/oauth2/authorize`, token URL `https://erp.akeda.ru/oauth2/token`, scopes: `akeda:delegate`)

Заводит свой шаблон: название, размер, формат штрихкода и строки с переменными. С `copy_from` — копией системного или своего шаблона: пустые поля берутся у него, название — «… (копия)». Неизвестная переменная — 400 с её именем. Нужно право администратора маркировки.

## Headers

- `X-Tenant` string, required

## Request body

- MarkingLabelTemplateInput
  - `name` string
  - `size` string
  - `width_mm` number: Свой размер (size = custom), шаг 0,5 мм
  - `height_mm` number
  - `format` '' | 'datamatrix' | 'ean13' | 'code128' | 'auto'
  - `channel` string
  - `blocks` MarkingLabelBlock[]
    - `type` 'text' | 'code' | 'barcode' | 'datamatrix' | 'logo', required: Текст с полями, код марки текстом, штрихкод, марка «Честного знака» (только на холсте) или знак юрлица
    - `text` string: Текст с полями в фигурных скобках: «Арт. {seller_article}»
    - `source` '' | 'barcode' | 'product' | 'card' | 'pack' | 'gtin': Штрихкод: выбранный при печати, свой основной, карточки канала, упаковки строки или EAN-13 по GTIN
    - `zone` '' | 'top' | 'bottom'
    - `size` '' | 'large' | 'medium' | 'small'
    - `bold` boolean
    - `lines` integer: Предел строк; 0 на холсте — сколько влезет
    - `required` boolean: Не легла на размер — отказ печати
    - `frame` object: Место блока на холсте (ERP-2185), мм от левого верхнего угла этикетки; у всех блоков шаблона или ни у одного
      - `x` number, required
      - `y` number, required
      - `w` number, required
      - `h` number, required
    - `align` '' | 'left' | 'center' | 'right'
    - `font_pt` number: Кегль блока холста, пт (4–72); 0 — по size
  - `copy_from` string: Шаблон-образец копии; копия шаблона строками встаёт на холст

## Response `201`

Шаблон создан

- MarkingLabelTemplateRecord
  - `id` string, required: Идентификатор своего шаблона или ключ системного
  - `system` boolean, required
  - `name` string, required
  - `kind` 'marking' | 'product', required
  - `size` string, required: Ключ размера или custom — свой размер width_mm×height_mm
  - `width_mm` number
  - `height_mm` number
  - `format` 'datamatrix' | 'ean13' | 'code128' | 'auto', required
  - `blocks` MarkingLabelBlock[], required
    - `type` 'text' | 'code' | 'barcode' | 'datamatrix' | 'logo', required: Текст с полями, код марки текстом, штрихкод, марка «Честного знака» (только на холсте) или знак юрлица
    - `text` string: Текст с полями в фигурных скобках: «Арт. {seller_article}»
    - `source` '' | 'barcode' | 'product' | 'card' | 'pack' | 'gtin': Штрихкод: выбранный при печати, свой основной, карточки канала, упаковки строки или EAN-13 по GTIN
    - `zone` '' | 'top' | 'bottom'
    - `size` '' | 'large' | 'medium' | 'small'
    - `bold` boolean
    - `lines` integer: Предел строк; 0 на холсте — сколько влезет
    - `required` boolean: Не легла на размер — отказ печати
    - `frame` object: Место блока на холсте (ERP-2185), мм от левого верхнего угла этикетки; у всех блоков шаблона или ни у одного
      - `x` number, required
      - `y` number, required
      - `w` number, required
      - `h` number, required
    - `align` '' | 'left' | 'center' | 'right'
    - `font_pt` number: Кегль блока холста, пт (4–72); 0 — по size
  - `canvas` boolean: Блоки на своих местах (редактор холста); false — шаблон строками прежнего конструктора
  - `channel` string: Канал продаж шаблона: чья карточка даёт штрихкод и артикулы, когда у документа канала нет
  - `preset` string: Вариант оформления системного шаблона
  - `is_active` boolean, required
  - `updated_at` string, date-time

## Other responses

- `400`: Шаблон заполнен с ошибкой, неизвестная переменная или размер
- `401`: Сессия, ключ или кабинет не подтверждены
- `403`: Текущая роль не имеет требуемого права
- `404`: Шаблон для копии не найден

---

[API](https://skmtc.dev/akeda/apis/akeda-erp-client-api.md) · [All operations](https://skmtc.dev/akeda/apis/akeda-erp-client-api/llms.txt) · [OpenAPI document](https://skmtc.dev/akeda/apis/akeda-erp-client-api/revisions/3c60ded179f2?raw)