Служба API проверки GTIN
GTIN — базовый идентификатор товаров, который используется по всему миру в розничной торговле, на маркетплейсах, таких как Amazon и eBay, и в здравоохранении для быстрой и безопасной идентификации продукции. API проверки GTIN позволяет убедиться, что номера GTIN, которые вы используете в своих системах, корректны, действительны и лицензированы организацией-членом GS1.
Как работает проверка GTIN
API даёт информацию, необходимую для управления качеством данных о товарах. Передав номера GTIN на проверку, вы получите ответ по каждому из них:
- Корректна ли структура GTIN: длина, формат и контрольная цифра.
- Существует ли префикс компании GS1 (GCP) и присвоен ли он действующему члену GS1.
- Есть ли в Глобальном реестре GS1 (Verified by GS1) данные о товаре: наименование, бренд, описание, категория GPC, нетто-содержимое, изображение, страна продажи, а также данные владельца лицензии.
Для казахстанских номеров (префикс 487) ответ дополняется данными локальной базы GS1 Kazakhstan: БИН владельца, результат проверки заполнения карточки и ссылка на карточку товара. Сводный статус по каждому номеру возвращается одним полем: COMPLETE, INCOMPLETE, INACTIVE, DISCONTINUED, INVALID или UNKNOWN. Для некорректных номеров дополнительно приходит код причины и пояснение.
Как получить доступ
Доступ предоставляется через партнёрскую платформу ECR Kazakhstan в несколько шагов:
- Заявка. Подайте заявку на странице проекта «Служба API проверки GTIN» на ecr.kz, указав данные компании и контактное лицо.
- Тестовый доступ. После одобрения заявки вы получите логин и пароль от кабинета клиента . В кабинете вы увидите свой API-ключ, документацию с уже подставленным ключом для пробных запросов и статистику использования. Тестовый ключ рассчитан на 500 проверок и действует 6 месяцев. При первом входе потребуется задать собственный пароль.
- Договор и оплата. После тестирования интеграции в заявке заключается договор, подписываемый ЭЦП, и выставляется счёт.
- Продуктивный режим. После подтверждения оплаты ключ автоматически переводится в продуктивный режим.
Технические характеристики
- Запросы POST по защищённому HTTPS, данные и ответы в формате JSON.
- Авторизация персональным ключом в заголовке Authorization: Bearer.
- Проверка GTIN, GLN и других ключей GS1 (SSCC, GRAI, GIAI, GSRN, GDTI, GINC, GSIN, GCN, CPID, GMN, ITIP).
- Лимит 60 запросов в минуту, в одном запросе можно передать несколько номеров. Каждый номер списывается из пакета как одна проверка.
Начать
Подать заявку на доступ к API проверки GTIN
По вопросам подключения: d.seitkanov@gs1.kz