Интеграция с помощью API

API Контур.Маркета — это сервис, который встраивается в любую учетную систему вашей организации (1С, ERP, CRM, СЭД, интернет-магазин). Он автоматизирует работу бизнеса и позволяет быстро получать информацию из товароучетной системы Маркета на всех тарифах для розницы, общепита и сферы услуг.

Читайте в этом разделе: 

Зачем нужен API Маркета

Ваша учетная система отправляет запрос и с помощью API получает полные данные из Маркета:

  • Список организаций и их торговые точки.
  • Список торговых точек (id, название, адрес).
  • Список товаров, услуг и блюд (id, код товара, название, штрихкод, группа товара, цена и прочее).
  • Список групп товаров, услуг и блюд.
  • Список контрагентов и их реквизиты.
  • Список клиентов (id, имя, телефон, процент скидки или количество бонусов и прочее).
  • Чеки (все продажи через кассы, в том числе какие товары были проданы).

Дополнительно на тарифах «Оптимальный» и «Премиум» для розницы и общепита доступны данные:

  • Остатки товаров на текущий момент времени.
  • Входящие и расходные накладные.
  • Акты постановки и списания.

С помощью API можно доработать Маркет под ваши сценарии работы:

  • Построить собственные отчеты о продажах.
  • Отслеживать остатки товаров и формировать заказы поставщикам.
  • Настроить интеграцию с интернет-магазином или службой доставки.

API Маркета помогает быстро решить различные задачи:

  1. Получить всю актуальную номенклатуру из торговых точек со всеми параметрами, включая розничную цену и остатки.
  2. Получить все чеки продаж и возвратов с полной информацией из торговых точек за конкретный день или другой период. У каждого чека будет подробная информация: что купили (id товара), кто купил (id клиента), количество, сумма, размер потраченных бонусов.
  3. Получить все входящие и расходные накладные за конкретный день или промежуток времени.
  4. Получить все акты постановки и списания за любой период.
  5. Получить клиентскую базу системы лояльности с информацией о накопленных бонусах.

Техническая документация

Для подробного изучения API перейдите на страницу Техническая документация API Маркета.

Выпуск API-ключа

API-ключ — это уникальный ключ, который нужен для авторизации и работы с API Маркета.

API-ключ можно выпустить:

  1. На одну или несколько организаций в Маркете. Тогда через API будет доступна информация по всем торговым точкам, которые входят в эти организации.
  2. На одну или несколько торговых точек, чтобы предоставить доступ через API только к конкретным торговым точкам.

Как получить API-ключ:

  1. Напишите в чат техподдержки, что хотите получить API-ключ для работы с API Маркета.
  2. В чат напишите электронную почту, на которую зарегистрирована учетная запись администратора. Именно он должен иметь доступ к организации или торговым точкам, для которых нужно выпустить API-ключ.
  3. Если нужно предоставить доступ ко всем торговым точкам вашей организации, тогда сообщите техподдержке ее ИНН.
  4. Если нужно предоставить доступ к определенной торговой точке, тогда откройте ее в Маркете и скопируйте URL-адрес страницы (всю строку адреса, содержащую все идентификаторы после https://market.kontur.ru/…). Далее отправьте адрес страницы в чат техподдержки.
  5. На электронную почту придет письмо от Контура с темой «Приглашение в Кабинет Интегратора». Нажмите в письме «Принять».
  6. Откроется страница сервиса Контур.Интегратор, нажмите на название вашей организации.
  7. Для выпуска ключа нажмите «Выпустить ключ».
  8. В открывшемся окне появится ваш API-ключ — скопируйте и сохраните его в надежном месте, потому что он будет показан только один раз. Это сделано в целях безопасности — мы не храним ключи на своей стороне.
  9. Теперь вы можете использовать API-ключ для авторизации в API Маркета.

Нужна помощь?

Для подробного изучения API перейдите в Техническую документацию API Маркета.

Если остались вопросы или не получается работать с API, обратитесь в чат техподдержки.


База знаний