Skip to main content

Кактус: для разработчиков

Адрес API: https://app.kak2c.ru/

Адрес API тестового контура: https://app-test.kak2c.ru/

Варианты интеграции с сайтом (подключение собственного интернет-магазина)

Варианты расположены по степени сложности - от самого простого до самого сложного (и более гибког...

Виджет корзины

Руководство для разработчиков виджета корзины

Инициализация корзины: <script src="https://static.kak2c.ru/v2/kak2c.checkout.js"></script> <li...

Настройка Google Analytics и Yandex Metrica для корзины

Базовая настройка аналитики: kaktusWidget({ domain: kak2c_domain, basketClickC...

Стилизация корзины

Иконка корзины имеет следующую структуру &lt;div className="basket-round"&gt; &lt;span classNa...

Замена иконки корзины по умолчанию на собственную

Для заменя иконки корзины по умолчанию на свою собственную, достаточно: Скрыть существующую ико...

Интеграция в Ecwid

1. В настройках внешнего вида сайта Ecwid включите отображение артикула на странице товара. Это в...

Интеграция в Tilda

1. Из ЛК Кактус перейдите в редактор интернет-магазина Кликнув по иконке с изображением шестер...

Открытие попапа корзины при каждом добавлении в нее товара

Полное описание интеграции корзины находится здесь. Нужно добавить следующий фрагмент кода: &lt;...

Интеграция в LPMotor

Подключение виджета умной корзины Кактус Войдите в общие настройки сайта В поле "Вставка в ...

Интеграция в WordPress

При наличии WooCommerce (или одной из тем, базирующихся на нем) 1. Зайти в редактор тем WP и най...

Интеграция с Platforma LP

Для интеграции корзины Кактус необходимо зайти в админку сайта на Platforma LP и открыть настройк...

Интеграция с MODX

Установка корзины Кактус в CMS MODX В панели управления MODX перейти в Элементы - Шаблоны. Соста...

Интеграция с Shop-Script

Для установки умной корзины Кактус в магазин на Shop-Script зайдите в админку магазина, перейдите...

Интеграция с Magento

Установка корзины Зайдите в админку вашего сайта на Magento. На панели управления выберите "Сист...

Интеграция с Insales

Установка корзины Кактус в Insales В админ панели Insales перейти в Настройки > Настройки сайта ...

Интеграция с 1С

Введение В целях упрощения процесса интеграции, мы подготовили обработку для типовой конфигураци...

Подключение информационного виджета расчета доставки

Данный скрипт позволяет отрисовать виджет &lt;!--Добавить в head (рекомендуется) или в body ст...

Карта ПВЗ

Подключение виджета: <link href="https://static.kak2c.ru/kak2c.pvz-map.css" rel="stylesheet"> <...

Витрина Кактус

Авторизация

Необходимо во всех вызовах, содержащих /pub, /dlv, /prompter, кроме регистрации и авторизации, (н...

Аккаунт

Товары

Комментарии по синхронизации товаров и остатков

Для создания новых товаров и обновления существующих, следует использовать метод POST /api/lite/...

/api/lite/products

Запрос списка продуктов (GET /api/lite/products) /api/lite/products Метод возвращает перечень в...

/api/lite/products/attributes

Атрибуты – дополнительные характеристики для описания номенклатуры. Используются для более полног...

/api/lite/products/features

По продуктам можно задавать варианты, и есть справочник опций и их значений на каждого клиента, п...

/api/lite/products/filters

Получение блоков фильтров /api/lite/products/filters Возвращает для заданной коллекции перечень...

/api/lite/products/image

Создание картинки к продукту (/api/lite/products/image) /api/lite/products/image Загружает на с...

/api/lite/products/variants

У каждого продукта есть хотя бы один вариант. Вариант – реальный товар, имеющий характеристики, ...

/api/lite/file/image

Закачка картинки в облако /api/lite/file/image Закачка картинки в облако и получение url Однов...

/api/lite/pub/products

Запрос указанного продукта (публичный) /api/lite/pub/products Метод возвращает продукты с вариа...

/api/lite/pub/products/filters

Получение блоков фильтров /api/lite/pub/products/filters Возвращает для заданной коллекции пере...

/api/lite/products/templates/items

Получение шаблона импорта номенклатуры /api/lite/products/templates/items В ответ возвращается ...

/api/lite/products/additional_descriptions

Дополнительные описания – текстовые характеристики для описания номенклатуры. Используются для от...

/api/lite/products/reviews

Получение отзывов /api/lite/products/reviews Возвращает отзывы на товары. Отзывы отсортированы ...

/api/lite/pub/products/reviews

Получение отзывов /api/lite/pub/products/reviews Возвращает подтвержденные отзывы на товары. От...

/api/lite/products/features/appearance

По свойствам продуктов можно задавать дополнительно код цвета и url картинки Запрос свойств отоб...

/api/lite/pub/products/features/appearance

По свойствам продуктов можно запрашивать дополнительно код цвета и url картинки Запрос свойств о...

/api/lite/products/export_ff

Выгрузка номенклатуры в Темполайн /api/lite/products/export_ff Создает/обновляет указанную номе...

/api/lite/products/accounting_attributes

Атрибуты учета – дополнительные характеристики для учета товара при отгрузке. Используются для пр...

/api/lite/products/stock_revise

Сверка остатков с Темполайн /api/lite/products/stock_revise Возвращает списки расхождений по то...

/api/lite/products/wb_categories

Запрос категорий товаров Wildberries /api/lite/products/wb_categories Получает список вариантов...

/api/lite/products/delete_barcodes_ff

Удаление ШК у номенклатуры в Темполайн /api/lite/products/delete_barcodes_ff Удаляет ШК у указа...

Коллекции

Заказы

Комментарии по выгрузке заказов в Кактус

Для передачи заказов в Кактус, используется метод:   POST /api/lite/orders Важно передать корр...

/api/lite/orders

Внимание! Не путать с методами /api/lite/order - это старые методы, которые будут удалены. Запро...

/api/lite/orders/cancelled

Заказ → отменить /api/lite/orders/cancelled Производит отмену заказа.  пример запроса: {  "o...

/api/lite/orders/confirm

Заказ - подтверждение /api/lite/orders/confirm Проставление статуса Подтверждения у заказа. Пр...

/api/lite/orders/payment

Проставить статус оплаты заказа /api/lite/orders/payment Проставление статуса оплаты у заказа. ...

/api/lite/orders/delivery_result

Заказ - отметить доставку /api/lite/orders/delivery_result Для доставки своими курьерами - прос...

/api/lite/orders/history

Получение истории по заказу /api/lite/orders/history Возвращает историю событий по указанному з...

/api/lite/orders/invoice_and_stiсker

Заказ → получить инвойс + стикер к заказу /api/lite/orders/invoice_and_stiсker Получение комбин...

/api/lite/orders/items

Заказ → обновление товарной части /api/lite/orders/items Возможность обновить только табличную ...

/api/lite/orders/nearest

Получение ближайших заказов к заданному /api/lite/orders/nearest Возвращает по 10 заказов до и ...

/api/lite/orders/receiver

Заказ → обновление контактной информации получателя /api/lite/orders/receiver Возможность обнов...

/api/lite/orders/refresh-reserve

Обновление резервов по заказу /api/lite/orders/refresh-reserve Обновляет резервы по заказу, осн...

/api/lite/orders/statuses

Получение сводки по статусам заказов /api/lite/orders/statuses Возвращает сводные данные по кол...

/api/lite/orders/packing

Заказ → упаковать /api/lite/orders/packing Производит упаковку указанного подтвержденного заказ...

/api/lite/orders/packing_control

Заказ → контроль упаковки /api/lite/orders/packing_control Производит контроль упаковки по ШК, ...

/api/lite/orders/tag

Заказ → установить метку на заказе /api/lite/orders/tag Пример запроса: { "id": "1000", ...

/api/lite/orders/calc_insurance_sum

Расчет страховой стоимости заказа /api/lite/orders/calc_insurance_sum Расчет страховой стоимост...

/api/lite/tag

Создание/редактирование/удаление метки Для создания / редактирования /api/lite/tag Для создани...

/api/lite/report/order

XLS Отчёт по заказам /api/lite/report/order Возвращает отчёт по всем заказам в формате XLS. По...

/api/lite/pub/orders

Создание заказа для виджета /api/lite/pub/orders Создание заказа для корзины и других клиентов ...

/api/lite/pub/order-discount

Запросить размер скидок по заказу (публичный) -(V1) Проверка переданного промокода на активность...

/api/lite/pub/payment

Оплата заказа покупателем /api/lite/pub/payment?orderId=humanId Параметр: humanId заказа покупа...

/api/lite/pub/orders/discount

Запросить размер скидок по заказу (публичный)   /api/lite/pub/orders/discount По отправленным ...

/api/lite/orders/copy

Копирование заказа /api/lite/orders/copy   Копирует указанный заказ черновиком и возвращает но...

/api/lite/pub/promocode/conditions/check

Запросить проверку применения промокода по заказу (публичный)   /api/lite/pub/promocode/conditi...

/api/lite/orders/receiver/address

Заказ → обновление адреса доставки получателю /api/lite/orders/receiver/address Возможность обн...

/api/lite/orders/file

/api/lite/orders/file Добавляет файл к заказу. Параметры передаются как form-data: upfile Ф...

/api/lite/orders/file/edit

/api/lite/orders/file/edit Пример запроса: { "id": "b9e3efdd-455e-af10-996f-2cf6f03d9775",...

/api/lite/orders/discounts

Применение промокода и скидки /api/lite/orders/discounts Позволяет применить или удалить промок...

/api/lite/orders/email/repeat

Заказ - повторить отправку email покупателю /api/lite/orders/email/repeat Отправляет email поку...

/api/lite/orders/sync_ff

Заказ - синхронизация с Фулфилмент складом /api/lite/orders/sync_ff Выгрузка текущего состояния...

/api/lite/orders/delivery

Заказ → обновление данных доставки /api/lite/orders/delivery Возможность обновить все данные по...

/api/lite/orders/comments

Заказ → обновление комментариев /api/lite/orders/comments Возможность обновить комментарии по з...

/api/lite/orders/diff_history

Запрос истории состояний заказа /api/lite/orders/diff_history На данный момент возвращает тольк...

/api/lite/orders/packing_export

Выгрузка файла для загрузки ШК Wildberries по схеме FBW /api/lite/orders/packing_export Возвращ...

/api/lite/orders/add_wb_barcodes

Загрузка файла с ШК Wildberries по схеме FBW /api/lite/orders/add_wb_barcodes Заменяет текущие ...

Комментарии по анализу возвратов от фулфилмента

Поставка на склад (Заказы поставщику)

/api/lite/purchase_orders

Запрос списка заказов поставщиков /api/lite/purchase_orders Метод возвращает список заказов с з...

/api/lite/purchase_orders/history

Получение истории по заказу поставщика /api/lite/purchase_orders/history Возвращает историю соб...

/api/lite/purchase_orders/confirm

Заказ - подтверждение /api/lite/purchase_orders/confirm Проставление статуса Подтверждения у за...

/api/lite/purchase_orders/accept_diff

Заказ - подтверждение /api/lite/purchase_orders/accept_diff Проставление флага согласия с рахож...

/api/lite/purchase_orders/set_in_process

Заказ - вернуть в обработку (свой склад) /api/lite/purchase_orders/set_in_process Для принятого...

/api/lite/purchase_orders/completed

Заказ - завершить приемку (свой склад) /api/lite/purchase_orders/set_in_process Для заказа по с...

/api/lite/purchase_orders/items/fact

Заказ - задать число принятых товаров (свой склад) /api/lite/purchase_orders/items/fact Для зак...

/api/lite/purchase_orders/file

/api/lite/purchase_orders/file Добавляет файл к заказу. Параметры передаются как form-data: ...

/api/lite/purchase_orders/file/edit

/api/lite/purchase_orders/file/edit Пример запроса: { "id": "b9e3efdd-455e-af10-996f-2cf6f...

Отгрузка заказов

Настройки аккаунта

/api/lite/pub/settings/checkout

Получение настроек работы виджета чекаута (публичный) /api/lite/pub/settings/checkout Метод воз...

/api/lite/settings/organization

Получение настроек организации аккаунта /api/lite/settings/organization Пример ответа: { ...

/api/lite/settings/catalog

Получение текущего основного каталога /api/lite/settings/catalog/default Пример успешного ответ...

/api/lite/settings/checkout

Получение настроек работы виджета чекаута /api/lite/settings/checkout Метод возвращает настройк...

/api/lite/settings/counteragents

Получение перечня контрагентов /api/lite/settings/counteragents Возвращает перечень контрагенто...

/api/lite/settings/delivery-info-list

Получение перечня способов доставки для аккаунта /api/lite/settings/delivery-info-list Возвраща...

/api/lite/settings/domainAlias

Проверка доступности домена 3 уровня /api/lite/settings/domainAlias Метод возвращает флаг досту...

/api/lite/settings/email/order

Получение текста заголовка и подвала для email оформления заказа /api/lite/settings/email/order ...

/api/lite/settings/email/personal

Обновление данных по текущим настройкам почты /api/lite/settings/email/personal Обновляет данны...

/api/lite/settings/offer-id-type

Задать тип поля - ключа для работы с предложениями /api/lite/settings/offer-id-type Задание пол...

/api/lite/settings/payment/payu

Записать данные собственного аккаунта payU /api/lite/settings/payment/payu Записать данные акка...

/api/lite/settings/payment/robokassa

Записать данные собственного аккаунта Робокасса /api/lite/settings/payment/robokassa Записать д...

/api/lite/settings/payment/yandex

Записать данные собственного аккаунта Yandex Касса /api/lite/settings/payment/yandex Записать д...

/api/lite/settings/payment-methods

Получение перечня способов оплаты для аккаунта /api/lite/settings/payment-methods Возвращает пе...

/api/lite/settings/pickup

Сохранение настроек точки сбора /api/lite/settings/pickup Сохранение ФИО, телефона сотрудника н...

/api/lite/settings/promocode

Получить список промокодов аккаунта (/api/lite/settings/promocode) /api/lite/settings/promocode ...

/api/lite/settings/user_notification

Сохранение настроек уведомлений /api/lite/settings/user_notification Описание....

/api/lite/settings/warehouses

Получение перечня складов для аккаунта /api/lite/settings/warehouses Возвращает перечень складо...

/api/lite/settings/price-types

Получение перечня типов цен аккаунта /api/lite/settings/price-types Возвращает перечень типов...

/api/lite/brief_report

Сводка по аккаунту (/api/lite/brief_report) /api/lite/brief_report Сводка включает блоки ста...

/api/lite/settings/countries

Получение списка стран /api/lite/settings/countries Метод возвращает список всех стран, поддерж...

/api/lite/settings/payment/portmone

Записать данные собственного аккаунта Portmone /api/lite/settings/payment/portmone Записать дан...

/api/lite/settings/email/templates

Получение шаблона для email, которые можно настроить /api/lite/settings/email/templates Метод в...

/api/lite/settings/email/templates/init

Инициализация шаблонов по умолчанию /api/lite/settings/email/order/init Метод  добавит шаблоны ...

/api/lite/settings/users/roles

/api/lite/settings/users/roles Метод возвращает все доступные роли Пример ответа: { "succ...

/api/lite/settings/users

/api/lite/settings/users Метод возвращает пользователей, созданных для магазина. Пример ответа:...

/api/lite/settings/checkout/payment

Получение настроек онлайн оплаты /api/lite/settings/checkout/payment Метод возвращает настройки...

/api/lite/settings/checkout/delivery-region-settings

Редактирование настроек регионов доставки /api/lite/settings/checkout/delivery-region-settings ...

/api/lite/settings/regions

Получение списка регионов /api/lite/settings/regions Ответ: { "regions": [ { ...

Тарификация

Комментарии к использованию методов Тарификации

1. Получение тарифов доставки (от Кактуса), для показа в процессе чекаута Для получения тарифов ...

/api/prompter/address

Подсказка полного адреса (/api/prompter/address) /api/prompter/address Для запроса необходим...

/api/prompter/street

Подсказка улицы для заданного населенного пункта  /api/prompter/street Для запроса не...

/api/prompter/location

Подсказка населенного пункта /api/prompter/location Для запроса необходимо выполнить следующи...

/api/prompter/iplocation

Определение населенного пункта по IP адресу /api/prompter/iplocation Для запроса необ...

/api/lite/pub/check_pickup_location

Проверка адреса сбора на возможность обслуживания (публичный) /api/lite/pub/check_pickup_locatio...

/api/lite/pub/products/dimensions

Получение габаритов условного минимального упакованного места  /api/lite/pub/products/dimensions...

/api/lite/pub/dimensions (deprecated)

Получение габаритов упаковки товаров (deprecated) новый метод: /api/lite/pub/products/dimensions...

/api/lite/pub/dimensions-by-package

Получение габаритов упаковки товаров по перечню параметров упаковок /api/lite/pub/dimensions-by-...

/api/dlv/tariffs

Расчет тарифов (/api/dlv/tariffs) /api/dlv/tariffs Выполняет расчет доставки от пункт...

/api/dlv/delivery_points

Список постаматов / ПВЗ /api/dlv/delivery_points Выполняет поиск постаматов/ПВЗ  в ук...

/api/dlv/delivery_point

Данные по одному ПВЗ /api/dlv/delivery_point Выполняет поиск одного ПВЗ по коду курье...

/api/lite/tariffs

Расчет тарифов приватный /api/lite/tariffs Метод тарификации для вызова из ЛК (приватного дос...

/api/lite/delivery_points

Список постаматов / ПВЗ /api/lite/delivery_points Метод списка ПВЗ для вызова из ЛК (...

/api/lite/delivery_point

Данные по одному ПВЗ /api/lite/delivery_point Метод загрузки одного ПВЗ для вызова из...

/api/prompter/region

Подсказка улицы для заданного населенного пункта  /api/prompter/region Для запроса не...

/api/prompter/countries

Список стран /api/prompter/countries Выводит список стран с их кодами Пример ответа: { "...

Описание методов (old)

Импорт/экспорт

Импорт и экспорт номенклатуры, заказов, итд

/api/lite/import/upload

Загрузка файла  (/api/lite/import/upload) POST /api/lite/import/upload /api/li...

/api/lite/import/preview

  Получить первые N строк загруженного файла (/api/lite/import/preview) /api/lite/import/...

/api/lite/import/task

Список заданий(подробная информация по заданию) (/api/lite/import/task) /api/lite/import/task ...

/api/lite/import/process

Запустить обработку загруженного файла (/api/lite/import/process) /api/lite/import/process пара...

/api/lite/import/field_list

Получить список возможных полей номенклатуры(/api/lite/import/field_list) /api/lite/import/fie...

/api/lite/export/sku

Список результатов экспорта(подробная информация по экспорту) (/api/lite/export/sku) /api/lite...

/api/lite/import/templates/sku

Получение шаблона импорта номенклатуры (с вариантами) /api/lite/import/templates/sku В ответ во...

/api/lite/export/order

Список результатов экспорта заказов(подробная информация по экспорту) (/api/lite/export/order) ...

Шаблоны подписок

Создание/редактирование шаблона подписок /api/lite/product/subscription/parse Создаёт структуру...

/api/lite/export/purchase_order

Инициировать экспорт заказа поставщику  (/api/lite/export/purchase_order?id=1016) (синхронный за...

/api/lite/import/order_field_list

Получить список возможных полей заказа(/api/lite/import/order_field_list) /api/lite/import/ord...

/api/lite/export/sku/movements/json

Получить движения по товару в json формате (/api/lite/export/sku/movements/json?id=MA001) (синхр...

/api/lite/export/sku/movements

Получить движения по товару в xls файле (/api/lite/export/sku/movements?id=MA001) (синхронный за...

/api/lite/export/order/count

Подсчитать кол-во заказов  (/api/lite/export/order/count) /api/lite/export/order/count Пример з...

/api/lite/import/templates/order

Получение шаблона импорта заказов /api/lite/import/templates/order В ответ возвращается в бинар...

/api/lite/export/order/now

Экспеорт выбранного заказа в Excel (/api/lite/export/order/now) /api/lite/export/order/now Па...

/api/lite/export/order/invoice

Экспорт инвойса по номеру заказа (/api/lite/export/order/invoice) /api/lite/export/order/invoi...

Дэшборд

Получение отчетов для дэшборда /api/lite/reports Возвращает список всех отчетов для дэшборда. ...

Личный кабинет покупателей

Апи для работы с личным кабинетом покупателей

Покупатели

Апи для менеджеров магазина, позволяет создавать и редактировать покупателей

Фиды для Я.Маркета

Интеграция с 1С-Битрикс

Интеграция с Битрикс делится на 3 части: 1) Синхронизация товаров кактус-битрикс 2) Модуль ...

Установка модуля доставки Opencart

Важно! Модуль доставки Kak2c будет гарантированно работать только с модулем упрощенного оформле...

Сервис уведомлений (Кактус)

Апи для работы с настройкой уведомлений для аккаунта

Физические наборы

Наложенные платежи

API osTicket

Биллинг

Интеграции

CAM