⚡ B2B API

🔌 API для бухгалтеров

REST API для расчёта налогового резидентства по 12 странам. Один POST → полный отчёт по всем клиентам сразу. Free tier 100 запросов/час.

🚀 Попробовать API

⚡ Кому это

Бухгалтерские бюро, налоговые консультанты, юридические фирмы. Если у вас 10+ клиентов-релокантов — наш API экономит часы рутины: вместо ручного расчёта 183 дней по каждому, делаете один POST со всеми поездками и получаете полный статус по 12 странам с алертами.

💰 Тарифы

🆓 Free

$0/месяц

Для тестов и небольших проектов

100 запросов / час / IP
Все 12 стран в ответе
Без API-ключа
JSON через REST POST
Все алерты и статусы

Просто использовать

⭐ POPULAR

💼 Pro

$49/месяц

Для бухгалтерских бюро (10-100 клиентов)

10 000 запросов / месяц
Webhook-уведомления о смене статуса клиентов
Bulk-расчёт (до 50 клиентов в одном POST)
Кастомные правила tie-breaker
Выгрузка PDF-отчётов
Email поддержка

📩 Заказать через Telegram

🛠 Endpoints

Метод	Endpoint	Описание
POST	`/api/v1/calc-residency`	Расчёт статуса резидентства по списку поездок
GET	`/api/data/countries.json`	Open Tax Data — налоговые правила 12 стран

📝 Запрос

# Пример запроса (curl)
curl -X POST https://nerezidentam.com/api/v1/calc-residency \
  -H "Content-Type: application/json" \
  -d '{
    "trips": [
      {"country": "RU", "from": "2024-01-01", "to": "2024-03-15"},
      {"country": "GE", "from": "2024-03-16", "to": "2024-09-30"},
      {"country": "GE", "from": "2024-11-16", "to": "2025-04-30"}
    ],
    "as_of_date": "2025-06-15"
  }'

📦 Ответ

{
  "ok": true,
  "as_of": "2025-06-15",
  "days_by_country": {
    "RU": 0,
    "GE": 213,
    "AE": 0,
    ...
  },
  "residency_status": {
    "GE": {
      "is_resident": true,
      "days": 213,
      "threshold": 183,
      "remaining_to_resident": 0,
      "over_threshold": 30
    },
    ...
  },
  "primary_residency": "GE",
  "alerts": [
    {
      "severity": "warning",
      "country": "RU",
      "message": "Approaching RU residency: 130/183 days. 53 days remaining"
    }
  ],
  "rate_limit": {
    "limit": 100,
    "remaining": 99,
    "reset_at": "2025-06-15T15:00:00+00:00"
  }
}

💻 Примеры использования

Python (для автоматизации в бухгалтерии)

import requests

# Список ваших клиентов
clients = [
    {"name": "Иван Петров", "trips": [...]},
    {"name": "Мария Сидорова", "trips": [...]},
]

for client in clients:
    response = requests.post(
        "https://nerezidentam.com/api/v1/calc-residency",
        json={"trips": client["trips"]}
    )
    data = response.json()

    if data["primary_residency"] == "RU":
        print(f"⚠ {client['name']}: резидент РФ — нужна 3-НДФЛ")
    elif data["alerts"]:
        print(f"📋 {client['name']}: алерты {data['alerts']}")

JavaScript / Node.js

const response = await fetch('https://nerezidentam.com/api/v1/calc-residency', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    trips: [
      { country: 'GE', from: '2024-03-16', to: '2024-09-30' }
    ]
  })
});

const data = await response.json();
console.log('Residency:', data.primary_residency);
console.log('Alerts:', data.alerts);

1С (XDTO/HTTP-запрос)

// Для 1С Бухгалтерии — типовой паттерн
HTTPСоединение = Новый HTTPСоединение("nerezidentam.com", 443, , , , , Истина);
HTTPЗапрос = Новый HTTPЗапрос("/api/v1/calc-residency");
HTTPЗапрос.Заголовки.Вставить("Content-Type", "application/json");
HTTPЗапрос.УстановитьТелоИзСтроки(JSON.СериализоватьВJSON(СтруктураДанных));
HTTPОтвет = HTTPСоединение.ОтправитьДляОбработки(HTTPЗапрос);

🚦 Лимиты

Free: 100 запросов / час / IP
Pro ($49/мес): 10 000 запросов / месяц
Превышение → HTTP 429 с заголовком X-RateLimit-Reset
Время ответа: обычно < 100ms
Доступность: 99.5% uptime (без SLA)

🎯 Кейсы использования

🧾 Бухгалтерское бюро (50 клиентов)

Каждый понедельник — пакетный расчёт всех клиентов. Алерты «приближается к 183 дням» автоматически в Telegram бухгалтеру.

⚖️ Юридическая фирма

Перед составлением налогового плана — быстрая проверка статуса клиента по всем 12 странам через API.

💼 HR крупной компании

Релоканты компании отчитываются о поездках — HR через API проверяет актуальный статус для оформления зарплаты.

📱 Сторонний фин-сервис

Встройте калькулятор в свой Telegram-бот / банковское приложение / fintech-сервис.

❓ FAQ

FAQ

Можно ли использовать в коммерческом продукте?

Да. Free tier — для любого использования включая коммерческое (с указанием «Powered by Nerezidentam»). Pro tier — белый-лейбл без упоминаний.

Хранятся ли данные клиентов?

Нет. API полностью stateless — мы не сохраняем ни поездки, ни результаты. Только rate-limit счётчик по IP/API-key (хеш).

Как часто обновляются правила?

При значительных изменениях законодательства. Текущая версия v1 актуальна на 2026 год. Изменения анонсируются в Telegram @nerezidentam.

Есть ли webhook для уведомлений о смене статуса?

В Pro-плане — да. Каждый раз когда клиент пересекает порог 183 дней или приближается к нему — webhook на ваш URL. Free tier — pull-only через POST.

Готовы интегрировать?

Free tier — без регистрации. Просто сделайте POST. Для Pro — напишите в Telegram, ответим за день.

🔗 Endpoint 📩 Заказать Pro