> Источник: https://apipay.kz/guides/zapolnenie-kataloga-apipay · Обновлено: 2026-07-09 · apipay.kz
> ApiPay — независимый сервис приёма платежей поверх вашего Kaspi Pay.

# Как заполнить каталог товаров в ApiPay: поля, штрихкод, НТИН

**TL;DR.** Каталог нужен, чтобы в чеке Kaspi покупатель видел **позиции** (название, цена, количество), а не одну сумму. Обязательные поля товара — **имя**, **цена**, **единица измерения**; штрихкод, НТИН и GTIN — по желанию. Главное правило: **один штрихкод (или НТИН) = один товар** — разные размеры/фасовки под одним штрихкодом Kaspi считает одним товаром. НТИН попадает в фискальный чек, только если он **задан** у товара; пустой НТИН можно дорезолвить сканированием штрихкода прямо в кабинете.

> Эта статья — для владельца/сотрудника, который ведёт каталог руками в кабинете ApiPay. Техническую сторону синхронизации из 1С разбирает статья [Каталог для 1С: синк без дублей](/guides/katalog-dlya-integratorov-1c).

## Какие поля есть у товара и на что влияют

| Поле | Обязательно | На что влияет |
|---|---|---|
| **Имя** | да | Наименование позиции в чеке Kaspi. До 255 символов |
| **Цена** | да | Цена за единицу (от 0.01 ₸). В счёте её можно переопределить для конкретной продажи |
| **Единица измерения** | да | Штука, кг, литр и т.п. — как считается количество в чеке |
| **Штрихкод** | нет | Идентификатор товара. До 32 символов. Позволяет находить товар сканером и в Нацкаталоге |
| **НТИН** | нет | Код Нацкаталога. Если задан — попадёт в фискальный чек Kaspi как маркировка |
| **GTIN** | нет | Международный код GS1 (приходит вместе с НТИН при сканировании штрихкода) |
| **external_ref** | нет | Ваша ссылка на товар в 1С/CRM. Нужна, если каталог ведёт интегратор (см. ниже) |

## Правило «один штрихкод = один товар»

Kaspi разрешает **ровно один товар на штрихкод и на НТИН**.

- **Разные размеры/фасовки под одним штрихкодом — это ОДИН товар.** Если «Ручка гелевая синяя 0.5» и «Ручка гелевая синяя 0.7» помечены **одним и тем же** штрихкодом, завести их двумя позициями не получится: система найдёт по штрихкоду существующий товар и дополнит его (например, проставит пустой НТИН), оставив прежнее название, а новую карточку не создаст.
- **Что делать.** Либо дайте каждому варианту **свой** штрихкод, либо ведите их как один товар. Если штрихкода нет — оставьте поле пустым, товар заведётся по имени и цене.

## Когда НТИН попадает в чек Kaspi

> **Если НТИН задан у товара в каталоге ApiPay** (вписали вручную, получили сканированием штрихкода или его прислал ваш интегратор) — **он попадёт в фискальный чек Kaspi**. Если поле НТИН пустое — **в чек он не попадёт**.

У позиции, где **штрихкод есть, а НТИН пустой**, стоит пометка «НТИН не указан» (в API это флаг `ntin_missing`). Продажу она не блокирует — товар продаётся и без НТИН, просто в чеке не будет кода маркировки.

## Как дорезолвить НТИН сканированием штрихкода

Если товар маркированный, а НТИН пустой — не вписывайте код наугад, дайте системе найти его по штрихкоду:

1. В карточке товара нажмите **«Найти НТИН»** (сканирование штрихкода в Нацкаталоге Kaspi).
2. Система вернёт кандидатов из Нацкаталога с готовыми НТИН и GTIN. Иногда кандидатов несколько (общий GTIN, разные НТИН) — выберите нужный.
3. Сохраните — НТИН и GTIN проставятся, и дальше товар пойдёт в чек с маркировкой.

Если штрихкод в Нацкаталоге **не нашёлся** — это нормально: значит товар немаркированный, оставьте НТИН пустым. Пустой результат поиска — не ошибка.

> Не вписывайте случайные цифры в поле НТИН, чтобы «убрать» пометку. Неверный НТИН хуже пустого: он уйдёт в чек и в систему маркировки как чужой код.

## Зачем `external_ref`, если каталог ведёт интегратор

Если товары в ApiPay заливает программа (1С, ваша CRM), попросите интегратора проставлять у каждого товара **`external_ref`** — ссылку на этот товар в его системе (код номенклатуры, GUID, артикул). Это «якорь», по которому товар потом однозначно находится при обновлении цены и сверке; без него сопоставлять приходится по штрихкоду или имени, а по одному штрихкоду у вас может быть несколько связанных позиций.

Вам как владельцу делать ничего не нужно, кроме одного: **сказать интегратору использовать `external_ref`**. Детали — в статье [Каталог для 1С](/guides/katalog-dlya-integratorov-1c).

## Частые вопросы

**Добавил товар, а в каталоге появилась не новая карточка, а старая с прежним названием. Почему?**
Штрихкод или НТИН уже занят: система нашла существующий товар и дополнила его. Найдите позицию поиском по штрихкоду и правьте её.

**Я не вижу в каталоге товары со статусом «ошибка» или «в обработке». Куда они делись?**
По умолчанию каталог показывает только активные товары. Остальные статусы (в обработке, ошибка, удалён) включаются фильтром статусов в поиске.

## Что дальше

- **Трек M:** ведёте каталог руками и что-то не сходится — напишите в поддержку ApiPay.
- **Трек D:** каталог заливает 1С или ваша CRM — отдайте разработчику статью [Каталог для 1С: синк без дублей](/guides/katalog-dlya-integratorov-1c) и ссылку apipay.kz/for-ai.

---

ApiPay — независимый сервис и не аффилирован с АО «Kaspi Bank». Kaspi и Kaspi Pay — товарные знаки их правообладателя.
База знаний: https://apipay.kz/guides