Интеграция с помощью API
API Контур.Маркета — это сервис, который встраивается в любую учетную систему вашей организации (1С, ERP, CRM, СЭД, интернет-магазин). Он автоматизирует работу бизнеса и позволяет быстро получать информацию из товароучетной системы Маркета на всех тарифах для розницы, общепита и сферы услуг.
Читайте в этом разделе:
Зачем нужен API Маркета
Ваша учетная система отправляет запрос и с помощью API получает полные данные из Маркета:
- Список организаций и их торговые точки.
- Список торговых точек (id, название, адрес).
- Список товаров, услуг и блюд (id, код товара, название, штрихкод, группа товара, цена и прочее).
- Список групп товаров, услуг и блюд.
- Список контрагентов и их реквизиты.
- Список клиентов (id, имя, телефон, процент скидки или количество бонусов и прочее).
- Чеки (все продажи через кассы, в том числе какие товары были проданы).
Дополнительно на тарифах «Оптимальный» и «Премиум» для розницы и общепита доступны данные:
- Остатки товаров на текущий момент времени.
- Входящие и расходные накладные.
- Акты постановки и списания.
С помощью API можно доработать Маркет под ваши сценарии работы:
- Построить собственные отчеты о продажах.
- Отслеживать остатки товаров и формировать заказы поставщикам.
- Настроить интеграцию с интернет-магазином или службой доставки.
API Маркета помогает быстро решить различные задачи:
- Получить всю актуальную номенклатуру из торговых точек со всеми параметрами, включая розничную цену и остатки.
- Получить все чеки продаж и возвратов с полной информацией из торговых точек за конкретный день или другой период. У каждого чека будет подробная информация: что купили (id товара), кто купил (id клиента), количество, сумма, размер потраченных бонусов.
- Получить все входящие и расходные накладные за конкретный день или промежуток времени.
- Получить все акты постановки и списания за любой период.
- Получить клиентскую базу системы лояльности с информацией о накопленных бонусах.
Техническая документация
Для подробного изучения API перейдите на страницу Техническая документация API Маркета.
Выпуск API-ключа
API-ключ — это уникальный ключ, который нужен для авторизации и работы с API Маркета.
API-ключ можно выпустить:
- На одну или несколько организаций в Маркете. Тогда через API будет доступна информация по всем торговым точкам, которые входят в эти организации.
- На одну или несколько торговых точек, чтобы предоставить доступ через API только к конкретным торговым точкам.
Как получить API-ключ:
- Напишите в чат техподдержки, что хотите получить API-ключ для работы с API Маркета.
- В чат напишите электронную почту, на которую зарегистрирована учетная запись администратора. Именно он должен иметь доступ к организации или торговым точкам, для которых нужно выпустить API-ключ.
- Если нужно предоставить доступ ко всем торговым точкам вашей организации, тогда сообщите техподдержке ее ИНН.
- Если нужно предоставить доступ к определенной торговой точке, тогда откройте ее в Маркете и скопируйте URL-адрес страницы (всю строку адреса, содержащую все идентификаторы после https://market.kontur.ru/…). Далее отправьте адрес страницы в чат техподдержки.
- На электронную почту придет письмо от Контура с темой «Приглашение в Кабинет Интегратора». Нажмите в письме «Принять».
- Откроется страница сервиса Контур.Интегратор, нажмите на название вашей организации.
- Для выпуска ключа нажмите «Выпустить ключ».
- В открывшемся окне появится ваш API-ключ — скопируйте и сохраните его в надежном месте, потому что он будет показан только один раз. Это сделано в целях безопасности — мы не храним ключи на своей стороне.
- Теперь вы можете использовать API-ключ для авторизации в API Маркета.
Нужна помощь?
Для подробного изучения API перейдите в Техническую документацию API Маркета.
Если остались вопросы или не получается работать с API, обратитесь в чат техподдержки.
