API Документация
Мощный инструментарий для работы с документами и данными. Интегрируйте функции PropNum в свои приложения, сайты и таблицы.
Основные принципы
API построено на принципах REST. Запросы принимаются методами POST (JSON) и GET (для интеграций). Все ответы возвращаются в формате JSON.
https://propnum.ruapplication/json
Не требуется (Public API)
2. Дата прописью
Текстовое представление даты для договоров и приказов.
POST /api/convert/date{
"date": "01.01.2024",
"case": "gen"
}{
"full": "первого января две тысячи двадцать четвертого года",
"parts": { "day": "первого", "month": "января", "year": "две тысячи двадцать четвертого года" }
}3. Расчет НДС
Выделение и начисление НДС с автоматическим расчетом.
Параметры mode:
- extract— Выделить НДС из общей суммы (включен в стоимость).
- add— Начислить НДС сверх указанной суммы.
curl -X POST https://propnum.ru/api/convert/nds \
-d '{"amount": 1200, "rate": 20, "mode": "extract"}'4. Валидация ИНН
Проверка корректности ИНН по контрольным числам для Физлиц и Юрлиц.
Метод проверяет ИНН на соответствие формату (10 или 12 цифр) и вычисляет контрольное число согласно алгоритму ФНС.
curl -X POST https://propnum.ru/api/validate/inn \
-d '{"inn": "7707083893"}'Лимиты и ошибки
Мы предоставляем API бесплатно для всех пользователей. Для обеспечения стабильности мы используем гибкое ограничение частоты запросов.
Общие лимиты
- • 60 запросов в минуту на один IP
- • 1000 запросов в сутки бесплатно
- • Без регистрации
Коды ошибок
- • 429 — Превышен лимит запросов
- • 400 — Некорректные параметры
- • 500 — Внутренняя ошибка сервера
Интеграция в таблицы
Используйте мощь PropNum напрямую в Google Таблицах или Excel без программирования сложных формул.
GSGoogle Sheets (Apps Script)
Автоматизируйте работу в облачных таблицах без установки ПО:
- В Google Таблице перейдите в меню Расширения → Apps Script.
- Вставьте код функции, приведенный ниже, в редактор скриптов.
- Нажмите иконку Сохранить (дискету) и дайте проекту имя.
- Теперь используйте в любой ячейке формулу
=PROPNUM(A1).
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;
}⚡ Высокая стабильность через GET
💡 Совет: Используйте формат /api/convert/num для доступа к дополнительным параметрам (валюты, падежи).
XLExcel VBA (Макросы)
Используйте функции PropNum в локальных файлах Excel:
- Нажмите Alt + F11 в Excel для открытия редактора макросов.
- Перейдите в Вставка (Insert) → Модуль (Module).
- Вставьте код функции, приведенный ниже, в открывшееся окно.
- Теперь вам доступна новая функция
=PROPNUM(A1).
Function PROPNUM(amount As Double) As String
Dim xml As Object: Set xml = CreateObject("MSXML2.XMLHTTP.6.0")
xml.Open "GET", "https://propnum.ru/api/convert/num?amount=" & amount, False
xml.Send
Dim resp As String: resp = xml.ResponseText
If InStr(resp, """full"":""") > 0 Then
PROPNUM = Split(Split(resp, """full"":""")(1), """")(0)
Else: PROPNUM = "Ошибка": End If
End Function⚠️ Сохраняйте файл как .xlsm
Макросы требуют разрешения на выполнение при открытии документа.
CORS & Браузеры
Наше API поддерживает кросс-доменные запросы (CORS). Это значит, что вы можете вызывать методы напрямую из браузерного JavaScript без использования прокси-серверов.
Поддержка
Нужна помощь в интеграции или есть идеи по улучшению? Мы всегда открыты для диалога. Напишите нам, и мы ответим в течение 24 часов.
Связаться с нами