Центр поддержки kilbil

To Kaiten

Вопросы по работе с API

При самостоятельной настройке интеграции kilbil с вашими сервисами изучите документацию.

Шаг 1. Ознакомьтесь со следующей документацией:

  1. Логика работы интеграции кассы/интернет-магазина

  2. Логика настройки обмена с товароучетной системой

  3. Вебхуки

  4. kilbil loyalty api (программный интерфейс приложения)

  5. kilbil webhook api (программный интерфейс приложения)

В документации под "Кассой" (кассовым ПО, РМК, точкой продаж) понимается любая из следующих сущностей: 

  • Касса (Рабочее место кассира)

  • Работа с продажами (например, в программе 1С через документ "реализация")

  • Интернет-магазин (продажи осуществляются на сайте или в мобильном приложении).

Доступные для изучения разделы в loyalty api
Доступные для изучения разделы в loyalty api

Шаг 2. Запросите тестовый контур. Как это сделать

Шаг 3. Если на основе документации и тестового контура, не удается настроить интеграцию, обратитесь в техподдержку. 

Как связаться с поддержкой

Вопросы по работе с API принимаются в письменном виде с указанием:

даты и времени запроса, ссылки, заголовка, тела запроса и описания проблемы

В запросе должна быть указана следующая информация:

  1. ID Личного кабинета (боевого или тестового контура).

  2. С чем проводите интеграцию: интернет-магазин/ кассовый софт/ товароучетная система и пр. 

  3. Цель интеграции: выгрузка товаров, кассовая интеграция, подключаем интернет-магазин, прием вебхуков (Механизм взаимодействия между сервисами, который позволяет автоматически отправлять данные в реальном времени при возникновении определенного события), дописываем функционал обмена/выгрузки "под себя" и пр.)

  4. Запрос к API, который не получается выполнить:

  • дата и время запроса с указанием часового пояса (запрос не старше 7 дней)

  • request:
    - url (полная ссылка запроса)
    - headres (заголовки запроса)
    - body (тело в json запроса)
    response:
    - headres (заголовки ответа)
    - body (тело в json ответа)

  • описание проблемы (что хотите получить → что не получается)

  1. Если логика запроса сложная →  опишите логику пошагово. Вся информация предоставляется текстом.

Техподдержка kilbil не оказывает консультации по разъяснению документации и методов программирования