Api umi cms: Документация по разработке нестандартного функционала UMI.CMS

Содержание

Инструкция по установке и настройке модуля МодульКасса для UMI.CMS

#Онлайн-кассы

#UMI-CMS

#МодульКасса

Установка модуля «ModulKassa»

Для установки модуля необходимо:

  1. Перейти в UMI.Market.
  2. В боковом меню UMI.Market раскрыть выпадающее меню «Модули и расширения». В выпавшем списке кликнуть по пункту «Магазинам»:
  3. Найти в списке модуль «ModulKassa» и кликнув по нему, перейти в его карточку
  4. В карточке модуля выбрать необходимую редакцию и нажать на кнопку с указанием цены, находящуюся слева от поля выбора редакции.
  5. Перейти в свой магазин и войти в кабинет администратора. В боковом меню кликнуть по вкладке «Модули». В открывшемся окне перейти в модуль «Маркет»:
  6. В модуле «Маркет» перейти на вкладку «Установка и удаление модулей». В поле «Список модулей, доступных для установки» найти строку с названием «ModulKassa» и кликнуть по иконке установки:

Настройка модуля «ModulKassa»

Для настройки модуля необходимо:

  1. Перейти в свой магазин и войти в кабинет администратора. В боковом меню кликнуть по вкладке «Модули». В открывшемся окне перейти в модуль «Маркет»:
  2. Перейдя на страницу настройки модуля «ModulKassa» заполнить следующие поля:
  3. Перейдя на страницу настройки модуля «ModulKassa» заполнить следующие поля:
    1. Поля «Логин» и «Секретный ключ (Пароль для API)». Содержимое этих полей соответствует данным регистрации вашей учетной записи в сервисе «МодульКасса»:

    2. Поле «UUID точки продажи»:

      UUID – это секретный идентификатор вашей точки продажи. Получить его возможно, перейдя в свою учетную запись сервиса «МодульКасса». В главном меню кликните по выпадающему меню «Мой магазин» в выпавшем списке перейдите в пункт «Все точки продажи»:

      На странице со всеми Вашими точками продажи кликните по необходимой. В появившейся форме скопируйте строку с идентификатором:

    3. Поле «ИНН». Содержимое данного поля должно совпадать с ИНН, который вы указали для своей точки продажи в сервисе «МодульКасса»:

    4. Поле «Чеки для способов оплаты». Данное поле отвечает за определение тех способов оплаты, для которых касса будет формировать чеки:

    5. Данное поле поддерживает множественный выбор содержимого, это значит, что вы можете указать несколько способов оплаты с которыми будет работать данный модуль:

    6. Поля «Система налогообложения», «НДС на товары», «НДС на доставку», «Предмет расчета». Содержимое этих полей будет использовано при формировании чеков:

    7. Поле «Количество печатаемых чеков». При выборе количества печатаемых чеков равным 2, Вы получите возможность сначала формировать чеки с признаком расчета «Предоплата», а затем с «Полный расчет». Такая схема уместна в случае, если отпуск товара интернет-магазином осуществляется при условии оплаты при получении в пункте выдачи или при взаимодействии с курьером:

  4. По окончанию заполнения всех полей, для завершения настройки модуля нажмите на кнопку «Сохранить» в правом нижнем углу:

Порядок работы модуля «ModulKassa»

Порядок работы модуля ModulKassa:

  1. После установки и корректной настройки модуля, чеки будут автоматически формироваться в вашем персональном кабинете сервиса «МодульКасса»:
  2. Если вы в настройках модуля «ModulKassa» указали количество печатаемых чеков равным 2, то вам необходимо учитывать, что первый сформированный чек имеет признак расчета «Предоплата». Для формирования второго чека с признаком расчета «Полный расчет», перейдите в карточку данного заказа и измените статус оплаты с «Принята» на «Подтверждена».
  3. Если возникла потребность в возврате/отмене платежа, то измените статус оплаты заказа с «Принята» на «Отменена» для отмены платежа, если количество печатаемых чеков равно 2, либо для возврата если количество печатаемых чеков равно 1. При смене статуса оплаты с «Подтверждена» на «Отменена», при установке количества печатаемых чеков равным 2 произойдет возврат денежных средств:

ВНИМАНИЕ: При переустановке Вашего сайта, смене домена, и т.д. обязательно произведите удаление модуля из системы, чтобы удалить привязку модуля к Вашей учетной записи в сервисе «МодульКасса».

UMI.CMS — универсальная коммерческая система управления сайтами

​Универсальная коммерческая CMS. Обладает приятным интерфейсом, позволяет создавать информационные сайты, сайты-каталоги и интернет-магазины.

Мы занимаемся разработкой сайтов на UMI.CMS последние шесть лет, данная система управления действительно более понятна нашим Заказчикам, нежели остальные платформы. При этом система достаточно функциональна и очень гибко настраивается.

Наиболее подходит для разработки простых сайтов и сайтов средней сложности, рассчитанных под среднюю нагрузку. На сложных проектах или в условиях высокой нагрузки бывают проблемы с производительностью, что иногда требует достаточно серьёзных доработок. Хорошая техническая поддержка и документация, система активно развивается.

CMS разработана на языке программирования PHP и использует СУБД MySQL. Данный программный продукт создаётся с 2004 года российской компанией «Юмисофт». В массовую продажу данная система поступила в 2007 году. Распространяется в том числе и по модели SaaS (программный продукт как услуга), что позволяет очень быстро и дёшево создавать типовые сайты.

Главная идеологическая особенность UMI.CMS — дружелюбный интерфейс. Например, поддерживается изменение структуры сайта с использованием технологии «drag & drop» (управления структурой путём перетаскивания объектов), являющейся привычной для большинства пользователей ПК. В последних версиях используется способ редактирования содержания страницы и компонентов страниц на самом сайте без перехода в административный интерфейс и диалоговых окон. UMI.CMS используются поведенческие технологии. Система позволяет отслеживать, как двигался по сайту посетитель, настраивать рекламу индивидуально под каждого пользователя, создавать персональные разделы и сервисы.

UMI.CMS использует стандартный XSLT-шаблонизатор или внутренний системный шаблонизатор TPL. Для связи с базой данных используется управляемая объектная модель, поверх которой построена CMS. Система управления построена на базе паттерна MVC. Открытый программный код и наличие документации по API позволяют изменять заложенную разработчиками логику системы, а также разрабатывать специализированные модули самостоятельно.

В плане хостинга UMI.CMS не требует серьёзных ресурсов, система работоспособна даже на виртуальном хостинге. Кроссплатформенна (работает на ОС семейства UNIX и BSD, Microsoft Windows).

Назначение:

  • Сайты визитки
  • Персональные сайты
  • Корпоративные сайты
  • Сайты с нестандартными интеграциями
  • Небольшие и средние магазины
  • Блоги и городские порталы

Преимущества:

  • Простота управления и 500 готовых шаблонов
  • Мультисайтовость
  • Поведенческие технологии
  • SEO-friendly
  • Интеграция с 1С, платежными системами, Купи в Кредит и доставкой, любой другой системой

Недостатки:

  • Специфические требования к хостингу
  • Мало качественных разработчиков
  • Отсутствие корпортала
  • Сложность кастомизации прав доступа
  • Не развиты модули для сообществ

API-маршрутов · Темы GitHub · GitHub

Вот
49 публичных репозиториев
соответствует этой теме…

хтуниклифф
/

следующее API-промежуточное ПО

Спонсор

Звезда
247

tsaxena4k
/

Next.

js-Mongodb-Аутентификация-приложение

Звезда
50

умийс
/

umi-блог-пример

Звезда
24

свет
/

Октокит-лайт

Спонсор

Звезда
9

кодирование с muhib
/

Счет-заявка

Звезда
8

джлеонскеннеди
/

nextjs-graphql-пример

Звезда
7

неадекватное будущее
/

nextjs-graphql-sequelize-стартер

Звезда
5

дхауссер
/

следующий шаблон

Звезда
3

Эдшав
/

nextjs-auth-mongo

Звезда
2

Торинабоенке
/

геовикторина

Звезда
2

йозефсаллай
/

следующий-api-paginate

Спонсор

Звезда
2

Скендалл74
/

ИзысканныйТруп

Звезда
1

ЙонаНью
/

конечные точки

Звезда
1

Винисиус Тей
/

подкастр

Звезда
1

Родриго001-dev
/

апи-следующий

Звезда
1

Adairjuneoaf
/

мои финансы

Звезда
1

диаджан
/

Персональный веб

Звезда
1

стены
/

АкулаНет

Звезда
1

врикоп
/

кликаса

Звезда
1

ИгорьЛАП
/

игньюс

Звезда
1

Улучшить эту страницу

Добавьте описание, изображение и ссылки на
API-маршруты
страницу темы, чтобы разработчикам было легче узнать о ней.

Курировать эту тему

Добавьте эту тему в свой репозиторий

Чтобы связать ваш репозиторий с
API-маршруты
тему, перейдите на целевую страницу репозитория и выберите «управление темами».

Учить больше

REST API службы SendPulse | SendPulse

Введение

Наш интерфейс API используется для интеграции возможностей сервиса рассылки SendPulse с личными проектами клиента. API предназначен для разработчиков и сопровождается подробной документацией.

Описание

REST API SendPulse работает по протоколу HTTPS и, по сути, представляет собой набор методов, используемых для выполнения запросов и получения ответов для каждой операции. Все ответы возвращаются в виде структур JSON.

Максимальное количество запросов – 10 запросов в секунду.

Междоменные запросы (пример jQuery Ajax) не допускаются.

Библиотеки API SendPulse

Последние версии клиентских библиотек API SendPulse доступны на GitHub.

  • PHP-оболочка
  • Оболочка Python
  • Рубиновая обертка
  • Java-оболочка
  • Оболочка Node.js
  • Оболочка C#
  • Оболочка Go (стороннее решение)

Вы также можете проверить другие сторонние решения на Github.

Базовый URL-адрес

Все ссылки на запросы API в этом документе включают корневой URL:

.

https://api.sendpulse.com

Авторизация

Процесс авторизации требует персонального ключа для подписи каждого последующего запроса API.

Необходимые параметры для получения ключа можно найти на странице настроек частной учетной записи, которая находится по следующему URL на вкладке API.

Для получения ключа необходимо отправить POST запрос на:

https://api. sendpulse.com/oauth/access_token

Параметры запроса:

Параметр Тип Описание
тип_гранта строка Должен быть равен client_credentials требуется
client_id строка Ваш ID требуется
клиент_секрет строка Твой секрет требуется

Пример запроса:

 {
   "grant_type":"client_credentials",
   "client_id":"237b4af9c99d0f89bdbd876dcd5a0000",
   "client_secret":"a99e7d506d3701c5c04de3db1913eeee"
}
 

Если запрос выполнен успешно, вы получите ответ:

 {
  "access_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImp0aSI6IjI5NTQ4NDVjZWJlZjg5Nzk0YmYzMzk4ZDdiNTQ3OTA2MWUzNDQ2N2I5NTUwMmFlNzE1YmViZmU4MDBmNTMxMjIxMTU2MTcyOWM2MjI5NGRjIn0. eyJhdWQiOiIyMzdiNGFmOWM5OWQwZjg5YmRiZDg3NmRjZDVhMDE3ZiIsImp0aSI6IjI5NTQ4NDVjZWJlZjg5Nzk0YmYzMzk4ZDdiNTQ3OTA2MWUzNDQ2N2I5NTUwMmFlNzE1YmViZmU4MDBmNTMxMjIxMTU2MTcyOWM2MjI5NGRjIiwiaWF0IjaaNjI0NTI0OTA0LCJuYmYiOjE2MjQ1MjQ5MDQsImV4cCI6MTYyNDUyODUwNCwic3ViIjoiIiwic2NvcGVzIjpbXSwidXNlciI6eyJpZCI6Njc0MTgwNCwiZ3JvdXBfaWQiOm51bGwsInBhcmVudF9pZCI6bnVsbCwiYXJlYSI6InJlc3QifX0.jiP3Sv7IF1mHGmW0oGIrPAw0oOiIEnC8Tb6wlWu5eVM2UrHL6RZsDlIslLSQNEvL_e50nDlgtgyfX5Qty4qlQ4XyW53FAgjwHbyQG7DJ6iVRAtVBtFNbkFVNbHvKw8zQy7WyxhICpAF8zdF8-gBHBnzuMhKSnASYEosJ9IAPqUkxQXrd8LpUSk-etzjEqcpMkbGj2M7Y0OxO4_BfRhVNU6ZcbiawD09m0A9uWoSnoZKxXw0o64PE3anJta6lFns5SDuyeGxanOtuZSS5I3umI2OOnUVzNG9_5WjCe6LPVQLAPAPt0m8S5WkI35_jCJ0A-gDBBdsgnUudGCvsDcgEog",
  "token_type": "Носитель",
  "expires_in": 3600
} 

Образец ключа:

 Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImp0aSI6IjI5NTQ4NDVjZWJlZjg5Nzk0YmYzMzk4ZDdiNTQ3OTA2MWUzNDQ2N2I5NTUwMmFlNzE1YmViZmU4MDBmNTMxMjIxMTU2MTcyOWM2MjI5NGRjIn0.eyJhdWQiOiIyMzdiNGFmOWM5OWQwZjg5YmRiZDg3NmRjZDVhMDE3ZiIsImp0aSI6IjI5NTQ4NDVjZWJlZjg5Nzk0YmYzMzk4ZDdiNTQ3OTA2MWUzNDQ2N2I5NTUwMmFlNzE1YmViZmU4MDBmNTMxMjIxMTU2MTcyOWM2MjI5NGRjIiwiaWF0IjaaNjI0NTI0OTA0LCJuYmYiOjE2MjQ1MjQ5MDQsImV4cCI6MTYyNDUyODUwNCwic3ViIjoiIiwic2NvcGVzIjpbXSwidXNlciI6eyJpZCI6Njc0MTgwNCwiZ3JvdXBfaWQiOm51bGwsInBhcmVudF9pZCI6bnVsbCwiYXJlYSI6InJlc3QifX0. jiP3Sv7IF1mHGmW0oGIrPAw0oOiIEnC8Tb6wlWu5eVM2UrHL6RZsDlIslLSQNEvL_e50nDlgtgyfX5Qty4qlQ4XyW53FAgjwHbyQG7DJ6iVRAtVBtFNbkFVNbHvKw8zQy7WyxhICpAF8zdF8-gBHBnzuMhKSnASYEosJ9IAPqUkxQXrd8LpUSk-etzjEqcpMkbGj2M7Y0OxO4_BfRhVNU6ZcbiawD09m0A9uWoSnoZKxXw0o64PE3anJta6lFns5SDuyeGxanOtuZSS5I3umI2OOnUVzNG9_5WjCe6LPVQLAPAPt0m8S5WkI35_jCJ0A-gDBBdsgnUudGCvsDcgEog 

Полученный ключ действителен в течение 1 часа и не требует дополнительных запросов для каждой операции. Запрос на новый ключ должен быть отправлен до истечения срока действия текущего ключа.

Код ключа (токена) необходимо отправлять в шапке всех запросов, кроме запросов на получение самого токена (когда ключ не требуется).

Лимиты запросов

Существуют лимиты и квоты на запросы API SendPulse, чтобы защитить систему от получения большего количества данных, чем она может обработать, и обеспечить справедливое распределение системных ресурсов. Лимиты API в минуту и ​​в день зависят от категории выбранного вами тарифного плана

Общие лимиты квот

Следующие квоты применяются к отправке запросов API:

Категория тарифного плана запросов в минуту запросов в день Тарифный план в услугах
Бесплатно 1000 500 000 Все бесплатные тарифные планы в службах SMTP, Landing Page, Push и Chatbot
Стандарт 2000 1 миллион Все тарифные планы от «Free» до «Enterprise»
Предприятие 3000 3 миллиона Для сервисов Email и Landing Pages с категорией «Enterprise» и для Push-сервиса с категорией «Pro» и количеством подписчиков более 50 000;

для сервиса «Чат-бот» категории «Pro» с более чем 5000 подписчиков;
для службы SMTP с более чем 100 000 электронных писем.

Превышение квоты

Если вы превысите эту квоту, API вернет следующую ошибку:

 429 Слишком много запросов 

Чтобы иметь возможность отправлять больше запросов, вам необходимо обновить текущий тарифный план.

Коды ошибок и описания

Код ошибки Описание
8 Нет данных
10 Адрес электронной почты отправителя отсутствует
11 Не удается найти адреса получателей
13 Пустое поле содержимого сообщения электронной почты
14 Не удается найти адрес электронной почты с указанным идентификатором
17 Не удается найти адрес электронной почты
19 Адрес электронной почты уже существует
20 Использование бесплатных почтовых сервисов (не разрешено)
21 Нет такого адреса электронной почты, ожидающего активации
97 Недопустимый тип адреса электронной почты. Использование бесплатных почтовых сервисов не допускается.
201 Имя пустого списка рассылки
203 Это имя списка рассылки уже существует
211 Список рассылки пуст
213 Список рассылки не найден
303 Не удается найти адреса электронной почты в списке рассылки
400 Указанный пользователь SMTP не существует. Создайте учетную запись SMTP.
502 Не удается найти адрес электронной почты
602 Не удается найти кампанию. Возможно, оно уже отправлено.
701 Адрес электронной почты или имя отправителя не указаны.
703 Не удается найти список рассылки
704 Не удается найти отправителя
707 Баланс аккаунта исчерпан
711 Подождите 15 минут перед повторной отправкой в ​​тот же список
720 Пустое поле темы
721 Сообщение электронной почты пусто
722 Идентификатор списка рассылки не указан
791 Превышен лимит API-кампаний (5 в час)
799 Неверный формат даты.