Перейти к содержимому

Необходимые cookie-файлы нужны для работы сайта. Аналитические cookie (Яндекс Метрика) — только с вашего согласия. Политика cookie-файлов

Акт выполненных работ

Распознавание актов выполненных работ и оказанных услуг

Исполнитель и заказчик, договор-основание, перечень работ и услуг, суммы и итог — из подписанного скана или PDF акта.

Что извлекается

Готовая схема: берите как есть или добавьте свои поля. Если значения нет в документе, поле вернётся null со статусом missing.

ПолеОписаниеТипПроверка
numberНомер актаstring
dateДата актаstring (date)
contractorИсполнительobject
nameНаименованиеstring
innИННstringИНН
customerЗаказчикobject
nameНаименованиеstring
innИННstringИНН
contractДоговор-основаниеobject
numberНомер договораstring
dateДата договораstring (date)
services[]Работы и услугиarray
nameНаименованиеstring
amountСуммаnumber
vat_amountНДС (null — без НДС)number
totalИтогоnumberсумма строк

Пример результата

Данные вымышлены, структура — ровно по схеме из таблицы. Рамкой отмечены реквизиты, которые Typizer проверяет.

result.json
{
  "number": "57",
  "date": "2026-09-30",
  "contractor": {
    "name": "ООО «Разработка и сопровождение»",
    "inn": "0055667788"
  },
  "customer": {
    "name": "АО «Условный завод»",
    "inn": "0044332211"
  },
  "contract": {
    "number": "12/2026",
    "date": "2026-02-01"
  },
  "services": [
    {
      "name": "Сопровождение информационной системы, сентябрь 2026 г.",
      "amount": 180000
    },
    {
      "name": "Доработка отчётов",
      "amount": 45000
    }
  ],
  "vat_amount": null,
  "total": 225000
}

Особенности документа

  • Акт ссылается на договор: номер и дата договора-основания — отдельные поля, по ним удобно сопоставлять акты с договорами в учёте.
  • На сканах подписанных актов печати и подписи часто перекрывают текст. Источник у каждого значения показывает, где именно было найдено значение, — спорные места видно сразу.
  • Период оказания услуг встречается и как диапазон дат, и как «за сентябрь 2026 г.». Опишите в схеме, в каком виде он вам нужен.

Что проверяет Typizer

  • ИНН исполнителя и заказчика — контрольные цифры.
  • Итого — сумма строк работ и услуг против итоговой суммы.

Не прошло — поле получает статус warn и причину. У найденных значений есть источник на странице.

Вызов API с этой схемой

Один запрос к /v1/extract: файл, схема и инструкция. Ключ — в кабинете после регистрации.

Инструкция: Номер и дата акта, исполнитель и заказчик с ИНН, номер и дата договора, работы и услуги с суммами, НДС, итого

curl
curl -X POST 'https://api.typizer.ru/v1/extract?wait=60' \
  -H 'Authorization: Bearer tz_live_YOUR_API_KEY' \
  -H "Idempotency-Key: $(uuidgen)" \
  -F 'file=@document.pdf' \
  --form-string 'schema={"type":"object","properties":{"number":{"type":"string","description":"Номер акта"},"date":{"type":"string","format":"date","description":"Дата акта"},"contractor":{"type":"object","description":"Исполнитель","properties":{"name":{"type":"string","description":"Наименование"},"inn":{"type":"string","description":"ИНН","x-typizer-check":"inn"}},"required":["name","inn"]},"customer":{"type":"object","description":"Заказчик","properties":{"name":{"type":"string","description":"Наименование"},"inn":{"type":"string","description":"ИНН","x-typizer-check":"inn"}},"required":["name","inn"]},"contract":{"type":"object","description":"Договор-основание","properties":{"number":{"type":"string","description":"Номер договора"},"date":{"type":"string","format":"date","description":"Дата договора"}},"required":["number","date"]},"services":{"type":"array","description":"Работы и услуги","items":{"type":"object","properties":{"name":{"type":"string","description":"Наименование"},"amount":{"type":"number","description":"Сумма"}},"required":["name","amount"]}},"vat_amount":{"type":"number","description":"НДС (null — без НДС)"},"total":{"type":"number","description":"Итого","x-typizer-check":"sum_of","x-typizer-sum-of":"services[].amount"}},"required":["number","date","contractor","customer","contract","services","vat_amount","total"]}' \
  --form-string 'instructions=Номер и дата акта, исполнитель и заказчик с ИНН, номер и дата договора, работы и услуги с суммами, НДС, итого'

FAQ

Вопросы о распознавании актов выполненных работ

Не нашли ответ? Напишите — ответит человек.

hello@typizer.ruДокументация
Можно ли обработать сразу сотни актов за квартал?

Да: до 500 файлов или ZIP-архив за один запрос пакетной обработки, общая выгрузка в XLSX или CSV. В кабинете — то же самое без кода.

Что делать, если сумма прописью не совпадает с суммой цифрами?

Добавьте в схему оба поля. Typizer извлечёт каждое со своим источником; расхождение будет видно в результате, а не скрыто «исправлением».

Поддерживаются ли акты сверки?

Да, это тоже документ с таблицей: опишите нужные поля — сальдо, обороты по датам, документы-основания — и получите их в своей схеме.

Первые страницы — за наш счёт.

100 страниц при регистрации и ещё 200 страниц за ИНН компании. Без карты и без подписки.