Счета

AACsearch выдаёт два типа биллинг-документов:

• Счета — за подписку на план (месячные или годовые).
• Чеки — за пополнения кошелька.

Оба уходят на биллинг-контакты и доступны в панели. Здесь — форматы, обработка налогов и retention.

Где счета

Клик на строку открывает детали со ссылкой на PDF и кнопкой повторной отправки.

Формат счёта

Счёт по плану включает:

• Invoice number — последовательный per-org, формат INV-{orgShortId}-{yyyy}-{nnnn}.
• Issued on — дата в часовом поясе биллинг-юр.лица.
• Due — обычно дата выпуска (оплачивается сохранённой картой); для net-30 enterprise — через 30 дней.
• Period — начало и конец биллинг-периода.
• Line items — по одной на каждую квоту с overage, плюс базовая плата плана.
• Subtotal.
• Tax — строки VAT / sales tax при необходимости.
• Total — итог.
• Payment method — последние 4 цифры карты или «Bank transfer» для счёта.
• Billing entity — ваше юр.лицо, адрес, VAT ID.
• AACsearch entity — наше юр.лицо и налоговые ID.

PDF генерируется packages/payments/lib/receipt-generator.ts и byte-stable для конкретного счёта — повторная загрузка даёт тот же файл.

Налоги по провайдерам

AACsearch роутит биллинг через одного из шести провайдеров в зависимости от региона. Налоги — по-разному.

Текущий провайдер виден в /[orgSlug]/settings/billing → Payment method. Меняется только через checkout заново.

Налоговые ID и юр.лицо

Чтобы налоговый ID попал на счёт, заполните Billing entity в /[orgSlug]/settings/billing → Billing details:

• Юр.название.
• Адрес (улица, город, регион, индекс, страна).
• Налоговый ID (VAT для EU, UTR для UK, EIN для US, ИНН/КПП для РФ).
• Опционально: биллинг-email отдельно от owner панели.

Изменения действуют для будущих счетов. Чтобы исправить прошлый — тикет в поддержку (re-issue с кредит-нотой, когда провайдер поддерживает).

Биллинг-контакты

До трёх контактов получают email со счетами. По умолчанию — owner организации. Добавьте в Billing details → Billing contacts:

• Имя + email на каждый.
• Контакты не занимают мест.
• Контакты не могут войти в панель с billing-only доступом — для этого пригласите как viewer.

Используйте для финансов / AP-команд, которым нужны счета без панели.

Валюта

Валюта плана фиксирована при первом checkout. Большинство — USD; RU-клиенты — RUB. Сменить только через отмену и пере-подписку (поддержка поможет).

Валюта кошелька независима, тоже single-currency — см. Кошелёк → Мульти-валюта.

Строки overage

Когда счёт включает overage — по одной строке на квоту:

Plan subscription (Pro)                 $99,00
Overage: search units (847 000 over)   $84,70
Overage: connector syncs (215 over)     $4,30
Subtotal                              $188,00
VAT 20%                                $37,60
Total                                 $225,60

Деталь overage раскрывается до per-day разбивки — чтобы атрибутировать пики к датам.

Диспуты и возвраты

Диспуты — через исходного провайдера:

• Stripe: chargeback через ваш банк → к Stripe; мы отвечаем с usage-логом.
• Lemon Squeezy / DodoPayments: возврат через их саппорт-портал.
• Tochka: возврат по 54-ФЗ (14 дней для потребительских платежей).

Для возврата — тикет в /[orgSlug]/settings/billing → Help. Мы не возвращаем напрямую — деньги у провайдера.

Retention

7 лет выбрано как максимум общих регуляторных сроков (Россия, Германия, часть США). Enterprise может договориться об увеличении контрактом.

Программный доступ

v1 REST даёт счета для автоматизации:

curl https://app.aacsearch.com/api/v1/invoices?status=paid \
  -H "Authorization: Bearer $AACSEARCH_ADMIN_KEY"

Возвращает список с подписанными URL (1 час TTL). Полезно для синка в учётку.

Аудит-трейл

Биллинг-события эмитят аудит:

Операции кошелька пишут в реестр кошелька, не в аудит; см. Кошелёк → Записи реестра.

Связанные страницы

• Планы — матрица и цены.
• Апгрейд и даунгрейд — правила пропорции.
• Кошелёк и AI-кредиты — чеки пополнений и экспорт реестра.
• Квоты — overage-механика, питающая строки счёта.