Какие поля есть у товара и на что влияют
| Поле | Обязательно | На что влияет |
|---|---|---|
| Имя | да | Наименование позиции в чеке Kaspi. До 255 символов |
| Цена | да | Цена за единицу (от 0.01 ₸). В счёте её можно переопределить для конкретной продажи |
| Единица измерения | да | Штука, кг, литр и т.п. — как считается количество в чеке |
| Штрихкод | нет | Идентификатор товара. До 32 символов. Позволяет находить товар сканером и в Нацкаталоге |
| НТИН | нет | Код Нацкаталога. Если задан — попадёт в фискальный чек Kaspi как маркировка |
| GTIN | нет | Международный код GS1 (приходит вместе с НТИН при сканировании штрихкода) |
| external_ref | нет | Ваша ссылка на товар в 1С/CRM. Нужна, если каталог ведёт интегратор (см. ниже) |
Правило «один штрихкод = один товар»
Kaspi разрешает ровно один товар на штрихкод и на НТИН.
- Разные размеры/фасовки под одним штрихкодом — это ОДИН товар. Если «Ручка гелевая синяя 0.5» и «Ручка гелевая синяя 0.7» помечены одним и тем же штрихкодом, завести их двумя позициями не получится: система найдёт по штрихкоду существующий товар и дополнит его (например, проставит пустой НТИН), оставив прежнее название, а новую карточку не создаст.
- Что делать. Либо дайте каждому варианту свой штрихкод, либо ведите их как один товар. Если штрихкода нет — оставьте поле пустым, товар заведётся по имени и цене.
Когда НТИН попадает в чек Kaspi
Если НТИН задан у товара в каталоге ApiPay (вписали вручную, получили сканированием штрихкода или его прислал ваш интегратор) — он попадёт в фискальный чек Kaspi. Если поле НТИН пустое — в чек он не попадёт.
У позиции, где штрихкод есть, а НТИН пустой, стоит пометка «НТИН не указан» (в API это флаг ntin_missing). Продажу она не блокирует — товар продаётся и без НТИН, просто в чеке не будет кода маркировки.
Как дорезолвить НТИН сканированием штрихкода
Если товар маркированный, а НТИН пустой — не вписывайте код наугад, дайте системе найти его по штрихкоду:
- В карточке товара нажмите «Найти НТИН» (сканирование штрихкода в Нацкаталоге Kaspi).
- Система вернёт кандидатов из Нацкаталога с готовыми НТИН и GTIN. Иногда кандидатов несколько (общий GTIN, разные НТИН) — выберите нужный.
- Сохраните — НТИН и GTIN проставятся, и дальше товар пойдёт в чек с маркировкой.
Если штрихкод в Нацкаталоге не нашёлся — это нормально: значит товар немаркированный, оставьте НТИН пустым. Пустой результат поиска — не ошибка.
Не вписывайте случайные цифры в поле НТИН, чтобы «убрать» пометку. Неверный НТИН хуже пустого: он уйдёт в чек и в систему маркировки как чужой код.
Зачем `external_ref`, если каталог ведёт интегратор
Если товары в ApiPay заливает программа (1С, ваша CRM), попросите интегратора проставлять у каждого товара external_ref — ссылку на этот товар в его системе (код номенклатуры, GUID, артикул). Это «якорь», по которому товар потом однозначно находится при обновлении цены и сверке; без него сопоставлять приходится по штрихкоду или имени, а по одному штрихкоду у вас может быть несколько связанных позиций.
Вам как владельцу делать ничего не нужно, кроме одного: сказать интегратору использовать external_ref. Детали — в статье Каталог для 1С.
Частые вопросы
Добавил товар, а в каталоге появилась не новая карточка, а старая с прежним названием. Почему?
Штрихкод или НТИН уже занят: система нашла существующий товар и дополнила его. Найдите позицию поиском по штрихкоду и правьте её.
Я не вижу в каталоге товары со статусом «ошибка» или «в обработке». Куда они делись?
По умолчанию каталог показывает только активные товары. Остальные статусы (в обработке, ошибка, удалён) включаются фильтром статусов в поиске.
Что дальше
- Трек M: ведёте каталог руками и что-то не сходится — напишите в поддержку ApiPay.
- Трек D: каталог заливает 1С или ваша CRM — отдайте разработчику статью Каталог для 1С: синк без дублей и ссылку apipay.kz/for-ai.