Ръководства/Firmify Public API Changelog

Firmify Public API Changelog

Формат и версиониране

Този changelog следва Keep a Changelog формат. Версионирането на API-то е на /api/v1 — breaking changes ще дойдат в /api/v2.


История на промените

2026-10-19

Changed

  • Базовият адрес на Public API е https://firmify.bg/api/v1. app.firmify.bg не е хост на продукта.
  • Подписан ZIP за регистрация (POST /api/v1/company-reg/{orgId}/upload-signed) и качване на един файл MANAGER_SPECIMEN: файлът трябва да е PDF сканиран от нотариално заверения образец. API-то проверява само заглавката %PDF. Не изисква квалифициран електронен подпис, не сравнява текста с генерирания бланкет и не праща файла към QSVS. Всеки друг очакван PDF остава със същите проверки (маркери за подпис, текстов отпечатък и криптографска валидация, когато QSVS е настроен). Контролният лист А4 остава помощен и не се изисква да е подписан.

2026-10-09

Added

  • articlesVariant при криптирано създаване на ЕООД и ООД: "short" (по подразбиране) или "long". Без полето документите са както досега. Имената във ZIP не се променят.
  • shareNominalCents (цели евроцентове, минимум 2) при евро превалутиране и в обекта euro на ООД батча. Без полето важи едноцентовото G1. Стойност 1 е грешка при валидация. Резултат извън 5% толеранс е HTTP 422 (BLOCKED).
  • newData.unanimityOptIn при промени. Прилага се само при дългия вариант на дружествения договор; при "short" се игнорира.
  • POST /api/v1/company-registration/amendments/batch — ООД: евро превалутиране плюс увеличение на капитала в едно събрание. EURO редът струва 0 кредита и се генерира веднага. CAPITAL редът струва 20 кредита и остава PAID, докато не се качи POST /api/v1/amendments/{id}/contribution-evidence и не се извика generate. ЕООД връща HTTP 422.
  • euroDeadlineWarning при самостоятелно евро превалутиране след 31 декември 2028 г. Преди тази дата полето липсва. Заявката не се отказва.

2026-07-14

Added

  • Redoc UI на /api/v1/docs/redoc (и /v1/docs/redoc)
  • Postman collection на /api/v1/postman.json
  • Changelog страница (/guide/api-changelog)
  • Актуализирани ръководства за разработчици (BG + EN)

Changed

  • OpenAPI описание: API Pro quota 30 docs/month (съответства на конфигурацията)
  • Developer portal quick-start: canonical legal-docs flow

2026-07-13 — Public API v1.1.0

Added

  • Пълен /api/v1/* surface: 11 категории документи
  • Hybrid billing: API Pro → key tier → credits → Stripe checkout/charge
  • Webhooks: payment.completed, doc.generated, doc.failed, job.completed, job.failed
  • Idempotency-Key header (24h TTL)
  • Async jobs: POST /docs/generate, GET /jobs/{id}
  • Utility endpoints: /catalog, /estimate, /batch, /analytics
  • Headless signup: POST /api/v1/register
  • Sandbox API keys
  • OpenAPI 3.1.1 spec с 100+ documented paths
  • Scalar + Swagger UI на /api/v1/docs

Changed

  • Canonical base path: /api/v1/* (mirror /v1/*)

Deprecated

  • /developer/v1/docs/* — връща 410 Gone; използвайте /api/v1/docs/*

2026-07-02 — Public API v1.0 (initial)

Added

  • API key auth (fmfy_...)
  • Developer portal (/developer)
  • Legal-docs и HR-docs programmatic generation
  • Stripe Checkout integration

Поддръжка

Въпроси: api@firmify.bg · Developer Portal · OpenAPI

Всички ръководства

Полезна ли беше тази статия?