Не нашли ответ?Поддержка JustPay на связи в рабочие дни с 7:00 до 18:00 (МСК).

Номенклатура

Номенклатура — справочник всего, что вы продаёте: товаров, услуг, платежей. Из него позиции попадают в планограмму вендингового автомата, в каталог POS-точки и мобильного кассира, а оттуда — на экран терминала, в чек и в отчёты. Здесь задаются название, цена, ставка НДС, тип позиции для чека, категория, картинка и признак «18+».

  • Где: Товароучёт → Номенклатура
  • Кому: администратору, товароведу
  • Действует на: планограмму и каталог конфигурации, терминал, мобильного кассира, чек, складской учёт, телеметрию

Зачем нужна номенклатура и где она используется

Каждая продажа в JustPay привязана к позиции номенклатуры. Сама по себе позиция на терминал не попадает: её нужно выбрать в конфигурации — в строке планограммы (вендинг, витрина, пожертвования, АЗС и другие типы с планограммой) или в шаге «Каталог» (POS-точка, POS-точка с реле, мобильный кассир).

  1. Категории
  2. Номенклатура
  3. Планограмма или каталог конфигурации
  4. Точка обслуживания
  5. Терминал, чек, отчёты

Заведите номенклатуру до настройки конфигурации. Если для кнопки вендингового автомата в планограмме не выбран товар, оплата на терминале не начнётся. Если в шаге «Каталог» нет позиций, покупателю нечего выбрать. Поэтому даже для простой точки (пожертвования, платный вход, одна услуга) нужна хотя бы одна позиция.

Где используетсяЧто берётся из номенклатуры
Планограмма (вендинг, витрина, реле, пожертвования, АЗС)Название позиции. Цена и ставка НДС при выборе товара в строке копируются в планограмму и дальше живут там.
Шаг «Каталог» конфигурации (POS-точка, POS-точка с реле)Копия позиции целиком: код, название, цена, ставка НДС, тип, категории, картинка, обработчик.
Мобильный кассирПозиции из шага «Каталог» конфигурации его точки: название, цена, ставка НДС, картинка, категория, «18+», код для поиска по штрихкоду.
POS-терминал и касса«Номенклатура по умолчанию» конфигурации: название и ставка НДС для оплаты, пришедшей от кассовой программы.
АвтомойкаВ таблице цен мойки при выборе позиции копируются её название и цена.
ЧекНазвание, цена, ставка НДС и признак предмета расчёта — из того места, где позиция выбрана (см. таблицы ниже).
Складской учётПозиции выбираются в приходах, перемещениях и инвентаризации; остатки считаются по продажам этих позиций.
Идентификация MAXФлажок «Для 18+»: перед оплатой такого товара терминал запрашивает подтверждение возраста.
Интеграции и телеметрия«Обработчик» и «Внешний идентификатор»: после оплаты продажа передаётся во внешнюю систему.
Платежи, СводкаКод и название в составе платежа и в статистике продаж по товарам; единица измерения в составе платежа.

Список номенклатуры

Откройте Товароучёт → Номенклатура. В списке — все действующие позиции вашей организации, новые сверху. Внизу — переключатель «Показывать по» (сколько строк на странице), счётчик «1–10 из N» и стрелки страниц.

Список номенклатуры: поиск, фильтры, кнопки «Добавить», «Выгрузить», «Импорт» и таблица позиций
Список номенклатуры. Справа вверху — значок настройки колонок
  1. Поиск — введите текст и нажмите Enter. Ищет по коду номенклатуры, наименованию, описанию, внешнему идентификатору и коду поиска цены. Чтобы найти позиции, где есть оба слова, разделите их знаком «+»: гель+5 л.
  2. Фильтры — окно с условиями отбора (см. ниже). Применённые фильтры показываются под строкой поиска.
  3. Добавить — новая позиция.
  4. Выгрузить — скачать список в файл CSV.
  5. Импорт — загрузить позиции из файла прайс-листа.
  6. Значок таблицы — выбор видимых колонок. Набор запоминается для вашей учётной записи и влияет на состав выгрузки.

Колонки

Все колонки списка
КолонкаЧто показывает
ДействияЗначок «≡»: меню «Открыть», «Изменить», «Удалить».
Код номенклатурыВаш артикул позиции.
НаименованиеНазвание, которое видит покупатель.
КлиентОрганизация, которой принадлежит позиция.
ОписаниеДополнительный текст из карточки.
Категория, ПодкатегорияГруппы из раздела Категории.
Тип номенклатурыПризнак предмета расчёта для чека.
СтоимостьЦена из карточки, в рублях.
Единица измеренияШтука, литр и т. п.
НДССтавка НДС.
Остаток, На реализацииЧисла, введённые вручную в карточке (не расчётные остатки склада).
Тип маркировкиЗначение справочного поля карточки, обычно «Нет».
Для 18+«Да», если товар требует подтверждения возраста; иначе пусто.

Фильтры

Окно «Фильтры» номенклатуры с полями отбора
Окно «Фильтры». Поля можно комбинировать; список полей прокручивается

Доступные условия: Код номенклатуры, Наименование, Клиент, Категория, Подкатегория, Тип номенклатуры, Поставщик, Единица измерения, НДС, а ниже (после прокрутки) — Тип маркировки и Для 18 + («Да» / «Нет»). Фильтры запоминаются в браузере до следующего изменения. Подробнее о работе с таблицами — Сводка и работа с таблицами.

Действия в строке

Меню действий в строке номенклатуры: Открыть, Изменить, Удалить
Меню «≡» в колонке «Действия»
ПунктЧто делает
ОткрытьКарточка только для просмотра, без кнопки «Сохранить».
ИзменитьКарточка для редактирования. Пункт виден, если роль разрешает изменять номенклатуру (все позиции или только созданные вами) — см. Роли и пользователи.
УдалитьПосле подтверждения «Вы уверены?» позиция пропадает из списка и из выбора в конфигурациях. Что при этом происходит с терминалом — в разделе «Как убрать позицию с терминала».

Выгрузить

Кнопка скачивает файл CSV: разделитель — точка с запятой, кодировка — Windows-1251 (открывается в Excel двойным щелчком). Первые колонки всегда «Дата создания», «Дата обновления», «Номер» (системный номер позиции), дальше — колонки, включённые в настройке таблицы.

  • Единица измерения выгружается числовым кодом, а не словом.
  • Колонки «Тип маркировки» и «Для 18+» в файл не выгружаются — оставьте их выключенными в настройке колонок, чтобы не получить пустые столбцы.
  • Если у роли есть доступ ко всей номенклатуре, выгружается весь справочник организации, независимо от поиска и фильтров на экране. Если роль видит только свои позиции — выгружаются позиции, созданные этим пользователем.
  • Выгруженный файл не подходит для обратного импорта: в нём русские заголовки и другая кодировка (см. Импорт).

Как добавить позицию

  1. При необходимости сначала создайте группы в Товароучёт → Категории — Категории.
  2. Откройте Товароучёт → Номенклатура и нажмите Добавить.
  3. Заполните вкладку Основное: код, наименование, клиента, тип номенклатуры, при необходимости категорию и картинку.
  4. Перейдите на вкладку Стоимость: цена, единица измерения, НДС.
  5. Если товар продаётся только совершеннолетним или подключена телеметрия — вкладка Дополнительно.
  6. Нажмите Сохранить — появится «Данные успешно сохранены», карточка закроется. Назад закрывает без сохранения.
  7. Добавьте позицию в планограмму или каталог конфигурации, сохраните конфигурацию и отправьте на терминал задание — см. «Когда изменения дойдут до терминала».
Пустая форма новой позиции, вкладка «Основное»
Новая позиция: вкладка «Основное»
Пустая форма новой позиции, вкладка «Стоимость»
Вкладка «Стоимость»: числовые поля по умолчанию 0

Обязательных полей форма не отмечает и сохранит даже пустую карточку. Но без наименования, цены, типа номенклатуры и ставки НДС позиция не годится для продажи: на кнопке будет пусто, а в чеке не будет нужных реквизитов. Заполняйте их всегда.

Список номенклатуры: поиск, фильтры, кнопка «Добавить», колонки «Действия», «Код номенклатуры», «Наименование», «Клиент»
«Товароучёт → Номенклатура»: кнопка «Добавить» справа вверху
Окно новой позиции: вкладки «Основные», «Стоимость», «Дополнительно», заполнены код номенклатуры и наименование
Окно позиции: три вкладки, начните с кода и наименования

Подсказки из практики

  • Код номенклатуры — любая удобная нумерация, но без повторов. Для штучного товара удобно взять штрихкод с упаковки.
  • Наименование пишите так, как оно должно выглядеть на кнопке терминала: «Американо 200 мл», «Взрослый билет», «Пожертвование».
  • В поле Клиент нажмите стрелку и выберите свою организацию.
  • Категории и изображения нужны только для каталога с группировкой (POS-точка, мобильный кассир). Для вендинга, пожертвований, платного входа и АЗС их можно не заполнять.
  • На вкладке «Стоимость» достаточно заполнить «Стоимость», «Единицу измерения» и «НДС»; остальные поля справочные.

Вкладка «Основное»

Карточка позиции, вкладка «Основное»: код, наименование, клиент, описание, категории, изображения, тип, поставщик
Вкладка «Основное» заполненной позиции
ПолеЧто задаётНа что влияет
Код номенклатуры
заполняйте всегда
Ваш артикул: любые цифры или буквы. Если продаёте штучный товар со штрихкодом — впишите сюда штрихкод с упаковки.Передаётся в составе платежа как артикул, по нему строится статистика продаж по товарам. В каталоге POS-точки и в мобильном кассире по этому коду ищется товар при сканировании штрихкода. По нему импорт находит уже существующие позиции. Делайте коды уникальными.
Наименование
заполняйте всегда
Название позиции, например «Американо 200 мл».Подпись на кнопке товара в каталоге и на экране оплаты, строка в чеке, название в списке платежей. Ограничения длины в карточке нет, но в чек по правилам ФФД попадает не больше 128 символов, а длинное название на кнопке терминала переносится и обрезается. Ориентир — до 40 символов, главное в начале.
КлиентОрганизация, которой принадлежит позиция. В списке — ваша организация (и подчинённые, если они есть).Позиция видна только в конфигурациях и на точках этой организации. Если оставить пустым, при создании подставится текущая организация.
ОписаниеСвободный текст: объём, состав, вкус.Показывается в списке и выгрузке, участвует в поиске. В каталоге POS-точки поиск на терминале ищет и по описанию.
КатегорияГруппа первого уровня из раздела Категории.В каталоге POS-точки товары группируются по категориям — по ним строятся кнопки разделов. В диалоге «Из номенклатуры» конфигурации по категории удобно отбирать позиции.
ПодкатегорияВторой уровень. В списке — только подкатегории выбранной категории.Дополнительный уровень группировки в каталоге и фильтр списка.
ПодподкатегорияТретий уровень.Ещё один уровень группировки каталога. Нужен только при очень разветвлённом ассортименте.
Основное изображениеФото товара. Форматы JPG, PNG, GIF, один файл.Показывается на карточке товара в каталоге POS-точки (тип 8 и POS-точка с реле) и в мобильном кассире. В вендинге и на экранах с планограммой не используется.
Дополнительное изображениеВторое фото, один файл.Хранится в карточке; приложения терминала и мобильного кассира его не показывают.
Тип номенклатуры
заполняйте всегда
Признак предмета расчёта: товар, услуга, платёж и т. д. Все значения — ниже.Попадает в чек как «признак предмета расчёта» при продаже через каталог POS-точки. В планограмме признак задаётся отдельно, в колонке «Тип» её строки.
ПоставщикСправочное поле: от кого получен товар.Используется для фильтра и выгрузки. В чек данные поставщика из этого поля не передаются — агентские реквизиты для чека настраиваются отдельно (поддержка JustPay поможет, если вы агент).

Тип номенклатуры выбирается из раскрывающегося списка; он длинный, прокручивайте его.

Раскрытый список «Тип номенклатуры»: Товар, Подакцизный товар, Работа, Услуга…
Список «Тип номенклатуры»

Тип номенклатуры — все значения

Тип — это признак предмета расчёта, обязательный реквизит кассового чека (тег 1212). Значение в скобках — код, который используется при импорте. Если сомневаетесь, какой признак нужен вашему бизнесу, уточните у бухгалтера.

Все 20 значений и когда какое выбирать
Значение (код)Когда выбирать
Товар (1)Любой товар: кофе и снеки в автомате, продукты микромаркета, разливная химия, тара, сувениры. Выбирайте его, если не подходит ничего другое.
Подакцизный товар (2)Товар, облагаемый акцизом (перечень — ст. 181 НК РФ). Нужен ли этот признак в вашем случае, решает бухгалтер.
Работа (3)Работа с материальным результатом: ремонт, изготовление, монтаж.
Услуга (4)Автомойка, парковка, платный вход, прокат, аренда шкафчика, зарядка, стирка, доступ к сервису.
Ставка азартной игры (5)Приём ставок организатором азартных игр.
Выигрыш азартной игры (6)Выплата выигрыша в азартной игре.
Лотерейный билет (7)Продажа лотерейных билетов.
Выигрыш лотереи (8)Выплата выигрыша лотереи.
Предоставление РИД (9)Права на результаты интеллектуальной деятельности: лицензии на программы, цифровой контент.
Платеж (10)Аванс, предоплата, взнос, пожертвование, пополнение счёта, штраф и другие платежи, которые не являются продажей товара или услуги.
Агентское вознаграждение (11)Вознаграждение агента (комиссионера, поверенного).
Выплата (12)Выплаты, например возврат средств или выплата страхового возмещения.
Иной предмет расчета (13)Если ни одно значение не подходит.
Имущественное право (14)Передача имущественных прав.
Внереализационный доход (15)Доходы, не связанные с реализацией.
Иные платежи и взносы (16)Взносы, уменьшающие налог (страховые и подобные).
Торговый сбор (17)Уплата торгового сбора.
Курортный сбор (18)Курортный (туристический) сбор.
Залог (19)Приём залога: например, за инвентарь, ключ, тару.
Расход (20)Расходы, уменьшающие доход.

Типовые сочетания: вендинг, микромаркет, АЗС, розлив — «Товар»; мойка, парковка, вход, прокат — «Услуга»; пожертвования — «Платеж». Пустой тип не оставляйте: в чеке должен быть признак предмета расчёта.

Вкладка «Стоимость»

Карточка позиции, вкладка «Стоимость»: стоимость, себестоимость, единица измерения, НДС, остаток, на реализации, минимальное значение, учитывать баланс
Вкладка «Стоимость»
Поля «Стоимость» (10) и «Себестоимость» (0) крупным планом
«Стоимость» — цена для покупателя, она подставится в планограмму или каталог. «Себестоимость» можно оставить 0
ПолеЧто задаётНа что влияет
Стоимость
заполняйте всегда
Цена за единицу в рублях, можно с копейками.Копируется в планограмму (обе колонки стоимости) или в каталог конфигурации в момент добавления туда позиции. Дальше терминал берёт цену оттуда, а не из карточки — см. когда изменения дойдут до терминала. Для «Номенклатуры по умолчанию» POS-терминала цена из карточки может использоваться напрямую.
СебестоимостьВаша закупочная цена.Справочно: в выгрузке. На терминал и в чек не попадает.
Единица измеренияШтука, грамм, миллилитр, литр. Список ведёт поддержка JustPay; если нужной единицы нет — обратитесь в поддержку.Показывается в списке и в составе платежа в личном кабинете. На экран терминала не выводится. Для услуг и платежей выбирайте «Штука».
НДС
заполняйте всегда
Ставка НДС. Все значения — ниже.Копируется в планограмму или каталог при добавлении позиции, оттуда попадает в чек. В таблице каталога и планограммы ставку можно поправить для конкретной строки.
ОстатокЧисло, введённое вручную.Только для справки в карточке, списке и выгрузке. Продажи его не уменьшают; реальные остатки по точкам считаются в разделе Складской учёт → Остатки по приходам, перемещениям и продажам.
На реализацииЧисло, введённое вручную.Только для справки, как и «Остаток».
Минимальное значение на точкеЖелаемый неснижаемый запас на точке, целое число.Сохраняется в карточке. Автоматических уведомлений о пополнении по этому полю личный кабинет не отправляет.
Учитывать балансФлажок.Сохраняется в карточке; на продажу и работу терминала не влияет.

Для организаций из Киргизии вместо списка «НДС» показываются свои ставки НДС (0% и 12%) и поле «НСП» (налог с продаж). Выбор страны организации определяет, какой набор полей вы увидите.

НДС — все ставки

Ставка должна совпадать с той, что применяет ваша организация к этому товару. Организации без НДС (например, на УСН без обязанности платить НДС) выбирают «НДС не облагается». Код — для импорта (колонка nds).

КодЗначение в ЛККогда применяется
1НДС 20%Основная ставка до 2026 года. Для новых продаж проверьте у бухгалтера, не нужна ли ставка 22%.
2НДС 10%Льготная ставка: отдельные продукты питания, детские и медицинские товары и др.
3НДС по расч. ставке 20/120Расчётная ставка к основной 20%: предоплата, аванс и другие случаи, когда налог выделяется из суммы.
4НДС по расч. ставке 10/110Расчётная ставка к 10%.
5НДС 0%Нулевая ставка: экспорт и другие случаи по НК РФ.
6НДС не облагаетсяПродажа без НДС.
7НДС 5%Пониженная ставка для плательщиков УСН, выбравших её.
8НДС 7%Пониженная ставка для плательщиков УСН, выбравших её.
9НДС по расч. ставке 5/105Расчётная ставка к 5%.
10НДС по расч. ставке 7/107Расчётная ставка к 7%.
11НДС 22%Основная ставка с 2026 года.
12НДС по расч. ставке 22/122Расчётная ставка к 22%.

Сменили ставку в карточке — это не меняет её в уже настроенных планограммах и каталогах. Поправьте ставку и там, иначе чеки пойдут со старой ставкой. Порядок — в разделе «Когда изменения дойдут до терминала».

Вкладка «Дополнительно»

Карточка позиции, вкладка «Дополнительно»: обработчик, идентификаторы, код поиска цены, тип маркировки, GTIN, флажок «Для 18+»
Вкладка «Дополнительно». Большинству точек нужен только флажок «Для 18+»
ПолеЧто задаётНа что влияет
ОбработчикИнтеграция из раздела Интеграции, которой передаётся продажа этой позиции. В списке — только интеграции вашей организации.После успешной оплаты сервер смотрит на первую позицию платежа: если у неё указан обработчик-телеметрия TeWo, продажа отправляется в TeWo; если обработчик-почта — уходит письмо. Обработчик копируется и в каталог POS-точки вместе с позицией (колонка «Интеграция»).
Уникальный идентификатор продуктаИдентификатор позиции во внешней системе.Заполняется автоматически при загрузке номенклатуры из TeWo. Вручную обычно не нужен.
Внешний идентификаторНомер этого товара (напитка) во внешней системе телеметрии. Для TeWo — целое число.Именно этот номер JustPay передаёт в TeWo вместе с продажей. Пусто или неверно — продажа в телеметрии не сопоставится с товаром. Участвует в поиске по списку.
Код поиска ценыКод PLU из внешней системы.Заполняется при загрузке из TeWo; участвует в поиске по списку. На терминал не влияет.
Тип маркировкиСправочное поле: «Нет», «Другое», «Алкоголь», «Табак», «Обувь», «СИЗ», «ОСУ», «Парфюмерия», «Лекарственный препарат», «Ветеренарный препарат», «Натуральный мех». По умолчанию «Нет».Показывается в списке и фильтре. Терминал по этому полю код маркировки не запрашивает и не сканирует, в чек он не передаётся.
GTINКод товара в системе маркировки (14 цифр).Хранится в карточке для справки; на терминал и в чек не передаётся.
Для 18+Флажок «товар только для совершеннолетних».Перед оплатой такого товара терминал (и мобильный кассир) запрашивает подтверждение возраста через MAX — если в точке включена идентификация MAX со значением «Если есть товар 18+». Без настроенной в точке идентификации флажок ни на что не влияет.

Маркированные товары. Поля «Тип маркировки» и «GTIN» не включают продажу с кодом маркировки: терминал не сканирует код «Честного знака» и не передаёт его в чек. Если вы продаёте маркированную продукцию, до начала продаж обсудите схему с поддержкой JustPay.

Как «Для 18+» влияет на терминал

Терминал проверяет флажок по справочнику номенклатуры, который получает вместе с конфигурацией. Поэтому после установки или снятия флажка отправьте на терминал задание «Обновление параметров» или «Обновление конфигурации». В мобильном кассире признак берётся из позиции в каталоге — после изменения кассир должен выполнить в приложении «Обновление конфигурации».

Когда изменения дойдут до терминала

Это самое важное в работе с номенклатурой. Кнопка «Сохранить» меняет только карточку в справочнике. Планограммы и каталоги конфигураций хранят свою копию данных позиции, сделанную в момент её добавления, а терминал получает данные с сервера только при запуске приложения или по заданию.

Что изменили в карточкеВендинг и другие типы с планограммойКаталог POS-точки и мобильного кассира
НаименованиеКонфигурацию трогать не нужно: терминал берёт название из справочника. Отправьте задание «Обновление параметров» или «Обновление конфигурации».В копии каталога осталось старое название. Уберите позицию из каталога, добавьте заново кнопкой «Из номенклатуры», сохраните конфигурацию, отправьте задание.
СтоимостьЦена живёт в планограмме. Исправьте «Стоимость (наличные)» и «Стоимость (безналичные)» в строке планограммы (или выберите товар в строке заново), сохраните конфигурацию, отправьте задание.Цена в таблице каталога не редактируется. Уберите позицию и добавьте заново, сохраните конфигурацию, отправьте задание.
НДСИсправьте «Ставку НДС» в строке планограммы, сохраните, отправьте задание.Исправьте «Ставку НДС» прямо в таблице каталога (или переподключите позицию), сохраните, отправьте задание.
Тип номенклатурыНа чек не влияет: признак берётся из колонки «Тип» планограммы.Исправьте «Тип» в таблице каталога (или переподключите позицию), сохраните, отправьте задание.
Картинка, категорииНе используются.Переподключите позицию в каталоге, сохраните, отправьте задание.
«Для 18+»Терминал: достаточно задания, конфигурацию трогать не нужно. Мобильный кассир: переподключите позицию в каталоге и сохраните конфигурацию.
Обработчик, внешний идентификаторДействует сразу после сохранения карточки: сервер читает эти поля при каждой продаже. Задание не нужно.

«Из номенклатуры» не обновляет уже добавленные позиции. Если позиция уже есть в каталоге, повторный выбор её в диалоге «Выберите номенклатуры» пропускается — в каталоге остаются старые цена и название. Сначала уберите строку кнопкой «Убрать», потом добавьте позицию снова. После этого проверьте настройки строки: код ячейки, реле, сценарий, оборудование, переход на следующий шаг — их нужно задать заново.

Какое задание отправить

  • «Обновление параметров» — терминал перечитывает конфигурацию и справочник номенклатуры без перезапуска приложения. На АЗС не выполняется во время налива топлива.
  • «Обновление конфигурации» — приложение перезапускается и загружает всё заново. Надёжнее, если менялся каталог или планограмма: экраны гарантированно перерисуются.
  • Мобильный кассир — заданий не получает: кассир открывает меню приложения и нажимает Обновление конфигурации.

Как создать задание и проверить, что оно выполнено, — Задания и сверка итогов. Терминал должен быть включён и в сети.

Откуда берутся данные в чеке

СценарийНазваниеЦенаСтавка НДСПризнак предмета расчёта
Вендинг и типы с планограммойСправочник номенклатурыСтрока планограммыСтрока планограммыКолонка «Тип» планограммы
Каталог POS-точки, POS-точка с релеКопия позиции в шаге «Каталог» конфигурации
Мобильный кассирКопия позиции в шаге «Каталог»Задаётся приложением
POS-терминал с кассовой программой«Номенклатура по умолчанию» (если включена), иначе «Продажа»Сумма от кассыСправочник номенклатуры (если включена «Номенклатура по умолчанию»)Товар

Фискализация и настройка ККТ — в статье Фискализация и ККТ.

Импорт прайс-листа

Кнопка Импорт загружает много новых позиций сразу из текстового файла. Сначала файл показывается списком, вы отмечаете нужные строки и подтверждаете загрузку.

Требования к файлу

  • Текстовый файл (.txt или .csv) в кодировке UTF-8. В Excel: «Сохранить как» → «CSV UTF-8 (разделитель — запятая)», затем в Блокноте замените запятые на точки с запятой, либо сразу готовьте файл в Блокноте.
  • Разделитель колонок — точка с запятой «;». Внутри значений точку с запятой не используйте.
  • Первая строка — заголовки на латинице, строчными буквами, ровно как в таблице ниже. Порядок колонок любой, лишние колонки игнорируются.
  • Каждая следующая строка — одна позиция. Пустых строк (в том числе в конце файла) быть не должно.
ЗаголовокПоле карточкиФормат
articleКод номенклатурыТекст. По нему ищутся уже существующие позиции.
nameНаименованиеТекст.
ndsНДСКод ставки 1–12 из таблицы ставок.
unitЕдиница измеренияЧисловой код единицы из справочника (для «Штука» в примерах используется 1). Если не уверены в кодах — не включайте колонку и выберите единицу в карточках после импорта.
code_extВнешний идентификаторТекст; можно оставить пустым.
typeТип номенклатурыКод 1–20 из таблицы типов.
priceСтоимостьЧисло без пробелов и знака рубля. Надёжнее всего — целые рубли.

Пример файла:

article;name;nds;unit;code_ext;type;price
10062;Шоколад 300 мл;6;1;;1;130
10065;Кофе зерновой 300 мл;6;1;;1;140
20001;Мойка 5 минут;6;1;;4;100
30001;Пожертвование;6;1;;10;100

Как загрузить

  1. Подготовьте файл по требованиям выше.
  2. В списке номенклатуры нажмите Импорт.
  3. Выберите организацию и загрузите файл (или выберите интеграцию, если загружаете позиции из телеметрии TeWo).
  4. Проверьте показанный список и отметьте строки, которые нужно загрузить.
  5. Нажмите Импортировать. Через секунду список номенклатуры обновится.
  6. Откройте несколько новых позиций и проверьте цену, НДС, тип и единицу измерения.

Что делает импорт

  • Новый код (такого article у вас ещё нет) — создаётся новая позиция с данными из файла.
  • Существующий код — позиция остаётся такой, как в личном кабинете: название, цена, НДС, тип и единица из файла не применяются, обновляется только «Внешний идентификатор». Менять цены импортом нельзя — правьте карточки вручную.
  • Импорт ничего не удаляет и не добавляет позиции в конфигурации — это делается в конфигурации отдельно.
  • Категории, картинки, «Для 18+» импортом не задаются.

Если импорт не прошёл

Что видноПричинаЧто сделать
Список после загрузки файла пустой или «Ошибка при загрузке файла»Пустая ячейка или текст в колонке nds, unit, type, price; пустая строка в файле; разделитель не «;».Заполните числовые колонки во всех строках (или уберите колонку целиком), удалите пустые строки, проверьте разделитель.
Русские буквы превратились в «кракозябры»Файл сохранён не в UTF-8 (например, это файл из кнопки «Выгрузить» — он в Windows-1251).Пересохраните файл в UTF-8.
Колонка не загрузиласьЗаголовок написан иначе: по-русски, с заглавной буквы, с пробелом.Используйте заголовки строго из таблицы.
Цена или название не изменилисьПозиция с таким кодом уже была.Это ожидаемо — исправьте карточку вручную.
«Ошибка при импорте» сразу после нажатия кнопкиОкно импорта не открылось.Обновите страницу и повторите. Если ошибка повторяется — отправьте файл в поддержку JustPay, позиции загрузят за вас.

Как убрать позицию с терминала

Удаление позиции из номенклатуры не убирает её с терминала: планограммы и каталоги, где она уже выбрана, продолжают её продавать. Правильный порядок:

  1. Найдите конфигурации, где используется позиция: Точки обслуживания → Конфигурации — Конфигурации.
  2. Вендинг и другие типы с планограммой: удалите строку планограммы или выберите в ней другой товар — Планограмма.
  3. Каталог POS-точки: в шаге «Каталог» нажмите «Убрать» в строке позиции.
  4. Сохраните конфигурацию и отправьте на терминалы задание «Обновление конфигурации». Мобильному кассиру — «Обновление конфигурации» в приложении.
  5. Только после этого, если позиция больше нигде не нужна, удалите её в номенклатуре.

Удалённая позиция пропадает из списка и из выбора в конфигурациях, но история продаж по ней в платежах и отчётах сохраняется. Если позицию удалили по ошибке, проще создать её заново с тем же кодом; восстановить прежнюю карточку поможет поддержка.

Типовые сценарии

Вендинговый автомат: завести напитки

  1. Создайте категорию «Напитки» (по желанию).
  2. Добавьте позиции: код — номер напитка (или артикул из телеметрии), наименование — как на кнопке автомата, тип «Товар», цена, НДС.
  3. В конфигурации автомата на вкладке «Планограмма» для каждого кода ячейки выберите товар — цена и НДС подставятся сами. Проверьте колонку «Тип».
  4. Сохраните конфигурацию, отправьте «Обновление конфигурации». Подробно — Вендинг.

Микромаркет или POS-точка: каталог с картинками

  1. Создайте категории и подкатегории — они станут разделами каталога.
  2. Добавьте позиции: код — штрихкод с упаковки (тогда товар можно будет найти сканером), категория, картинка, цена, НДС, тип «Товар». Для алкоголя и табака — «Для 18+».
  3. В конфигурации, в шаге «Каталог», нажмите «Из номенклатуры» и отметьте позиции. Для POS-точки с реле привяжите позиции к реле или оборудованию.
  4. Сохраните, отправьте задание. Подробно — POS-точка.

Услуга или пожертвование без каталога

  1. Создайте одну позицию: «Мойка», «Вход», «Пожертвование». Тип — «Услуга» или «Платеж», единица — «Штука».
  2. Выберите её в планограмме конфигурации (или как «Номенклатуру по умолчанию» для POS-терминала).
  3. Сохраните, отправьте задание. См. Пожертвования, Витрина и платный вход, Автомойка.

Поднять цену

  1. Измените «Стоимость» в карточке и сохраните — чтобы новая цена подставлялась при следующих добавлениях.
  2. Планограмма: поправьте обе стоимости в строке. Каталог: уберите позицию и добавьте заново, затем восстановите настройки строки.
  3. Сохраните конфигурацию и отправьте «Обновление конфигурации».
  4. Сделайте тестовую покупку и проверьте сумму и чек.

Подключить телеметрию TeWo

  1. Создайте интеграцию TeWo в разделе Интеграции, укажите внешний идентификатор точки.
  2. В карточках напитков выберите эту интеграцию в поле «Обработчик» и впишите «Внешний идентификатор» — номер напитка в TeWo. Позиции можно загрузить из TeWo через «Импорт», выбрав интеграцию: идентификаторы заполнятся сами.
  3. После оплаты продажа уходит в TeWo; результат виден в истории платежа.

Частые ошибки

Что происходитПричинаЧто сделать
Изменили цену, а терминал продаёт по старойЦена хранится в планограмме или каталоге конфигурации; либо задание не отправлено.См. «Когда изменения дойдут до терминала».
Нажали «Из номенклатуры», а в каталоге старые данныеУже добавленные позиции при повторном выборе пропускаются.«Убрать» строку и добавить заново.
Вендинг: покупатель выбирает напиток, оплата не начинаетсяДля этого кода ячейки в планограмме нет строки или в ней не выбран товар.Заполните планограмму, сохраните, отправьте задание.
Позицию удалили, а она продаётсяУдаление из справочника не меняет конфигурации.Уберите позицию из планограммы или каталога — порядок.
Позиции нет в списке «Товар» планограммы или в диалоге «Из номенклатуры»Позиция заведена на другую организацию (поле «Клиент») или удалена.Проверьте «Клиент» в карточке; создайте позицию заново.
Сканер находит не тот товар или не находит вовсеШтрихкод не записан в «Код номенклатуры» или у двух позиций одинаковый код.Впишите штрихкод в код, сделайте коды уникальными, переподключите позиции в каталоге.
Не запрашивается подтверждение возрастаВ точке не включена идентификация MAX, или терминал не получил обновление.Настройте Идентификацию MAX, отправьте задание.
Нет нужной категории в спискеКатегория не создана, или для подкатегории не выбрана категория выше.Создайте в Категориях; сначала выберите категорию, потом подкатегорию.
Нет нужной единицы измеренияСписок единиц общий для платформы.Обратитесь в поддержку JustPay.
Не видно пункта «Изменить» или кнопки «Добавить»Роли не хватает прав на номенклатуру.Попросите администратора организации расширить роль — Роли и пользователи.
Продажа не дошла до телеметрииНе выбран «Обработчик» или неверный «Внешний идентификатор» у первой позиции платежа.Проверьте вкладку «Дополнительно» и настройки интеграции.

Что дальше