PropNum.ruPropNum

Сумма прописью в Google Таблицах — Apps Script

Добавьте функцию =PROPNUM() в Google Sheets через Apps Script — работает прямо в браузере, без установки.

Как подключить

  1. 1Откройте вашу Google Таблицу.
  2. 2В меню выберите Расширения → Apps Script.
  3. 3Удалите стандартный код и вставьте функцию PROPNUM ниже.
  4. 4Нажмите иконку Сохранить (дискета) и дайте проекту имя.
  5. 5Вернитесь в таблицу и введите =PROPNUM(A1) в любую ячейку.

Функция для Google Apps Script

Функция использует UrlFetchApp для обращения к API PropNum. Работает во всех Google Sheets без ограничений.

Apps Script (JavaScript)
function PROPNUM(amount) {
  if (!amount) return "";
  const cleanAmount = amount.toString()
    .replace(/\s/g, '')
    .replace(',', '.');
  const url = "https://propnum.ru/api/convert/num?amount="
    + encodeURIComponent(cleanAmount);
  const res = UrlFetchApp.fetch(url, {
    muteHttpExceptions: true
  });
  if (res.getResponseCode() !== 200) {
    return "Ошибка: " + res.getResponseCode();
  }
  const data = JSON.parse(res.getContentText());
  return data.result.full;
}

Расширенная версия с падежом

Для получения родительного падежа (шапка договора) добавьте параметр case=gen.

Apps Script (JavaScript)
function PROPNUM_GEN(amount) {
  if (!amount) return "";
  const url = "https://propnum.ru/api/convert/num?amount="
    + encodeURIComponent(amount) + "&case=gen";
  const res = UrlFetchApp.fetch(url, {
    muteHttpExceptions: true
  });
  const data = JSON.parse(res.getContentText());
  return data.result.full;
}

// Использование:
// =PROPNUM(A1)      → "Пятьдесят тысяч рублей 00 копеек"
// =PROPNUM_GEN(A1)  → "пятидесяти тысяч рублей 00 копеек"

Частые вопросы

Платно ли использовать Apps Script с внешними API?
Нет, Google Apps Script бесплатен. API PropNum тоже бесплатен без регистрации. Лимит Apps Script — 20 000 запросов в день.
Как добавить функцию ко всем листам Google Sheets?
Скрипт, добавленный через Расширения → Apps Script, доступен во всех листах текущей таблицы. Для использования в других таблицах повторите установку.
Формула не обновляется при изменении ячейки
Google Sheets кэширует результаты пользовательских функций. Добавьте второй аргумент: =PROPNUM(A1, NOW()) — это заставит формулу пересчитываться.

Нужна помощь с интеграцией?

Смотрите полную документацию API или напишите нам — документация API, контакты.