Интеграция PropNum с Битрикс24 — сумма прописью в CRM
Автоматически добавляйте сумму прописью в сделки, счета и документы Битрикс24 через REST API и бизнес-процессы.
Как подключить
- 1В Битрикс24 перейдите в Приложения → Вебхуки → Добавить входящий вебхук.
- 2Используйте REST API Битрикс24 для получения суммы сделки.
- 3Сделайте запрос к API PropNum с этой суммой.
- 4Запишите результат в пользовательское поле сделки или счёта.
- 5Настройте триггер в бизнес-процессе для автоматического обновления.
JavaScript — получение суммы прописью
Используйте в REST-приложении Битрикс24 или в скриптах автоматизации.
JavaScript
// Получить сумму прописью через API PropNum
async function getSumPropisyu(amount) {
const url = `https://propnum.ru/api/convert/num?amount=${amount}`;
const res = await fetch(url);
const data = await res.json();
return data.result.full;
}
// Обновить поле сделки в Битрикс24
async function updateDealWithPropisyu(dealId, amount) {
const text = await getSumPropisyu(amount);
// Запись в пользовательское поле UF_CRM_SUMMA_PROPISYU
await fetch(`${BX24_WEBHOOK}/crm.deal.update`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
id: dealId,
fields: { UF_CRM_SUMMA_PROPISYU: text }
})
});
return text;
}curl — прямой запрос к API
Для тестирования или использования в bash-скриптах и автоматизации.
curl / bash
# Получить сумму прописью
curl "https://propnum.ru/api/convert/num?amount=50000"
# Ответ:
# {
# "result": {
# "full": "Пятьдесят тысяч рублей 00 копеек",
# "rubles": "Пятьдесят тысяч",
# "kopecks": "00"
# }
# }
# Родительный падеж:
curl "https://propnum.ru/api/convert/num?amount=50000&case=gen"Частые вопросы
Можно ли использовать PropNum в бизнес-процессах Битрикс24?▾
Да. Добавьте активити «HTTP-запрос» в бизнес-процесс, укажите URL API PropNum и сохраните результат в переменную для дальнейшего использования.
Как добавить поле «Сумма прописью» в карточку сделки?▾
Создайте пользовательское поле типа «Строка» в настройках CRM → Поля. Затем заполняйте его через REST API или триггер бизнес-процесса.
Есть ли лимит на количество запросов?▾
API PropNum бесплатен и не требует регистрации. Лимит — 10 запросов в минуту и 3 запроса в секунду с одного IP. Для корпоративных нагрузок свяжитесь через страницу контактов.
Нужна помощь с интеграцией?
Смотрите полную документацию API или напишите нам — документация API, контакты.