История изменений API

Апрель 2025

  • Сделали код СФР не обязательным. Теперь при сдаче отчетов ЕФС-1, АДВ-1,2,3 и УПУП можно не указывать код контролирующего органа, достаточно указать единый регистрационный номер (ЕРН).

Март 2025

Февраль 2025

Декабрь 2024

Ноябрь 2024

Октябрь 2024

Август 2024

Июль 2024

Май 2023

Апрель 2023

Январь 2023

Сентябрь 2022

  • Добавили возможность передавать созданные в API черновики в веб-интерфейс Контур.Экстерна.

Июль 2022

  • Поддержали работу с машиночитаемой доверенностью в ФСС. Алгоритм работы в API смотрите в статье.

Июнь 2022

Апрель 2022

  • Добавили новый тип DraftsBuilder для работы с письмами ФНС в конструкторе черновиков.

Январь 2022

Ноябрь 2021

  • В метаинформации документооборота 4-ФСС (модель FssReportRequisites) добавили новое поле sender-certificate-thumbprint. Поле возвращает отпечаток сертификата, которым был подписан отчет.

  • В метаинформации документооборота требований (модель DemandAttachmentRequisites) добавили новые поля:

    • tax-department-name — наименование налогового органа;

    • tax-event-name — наименование мероприятия налогового контроля.

Обновление в Extern Test Tools:

Октябрь 2021

  • Исправлены ошибки по определению признаков зашифрованности encrypted и сжатости compressed контента для документов ПФР.

Август 2021

Март 2021

  • Исправлена ошибка 500, которая появлялась при попытке печати приложений в письмах от ПФР в формате ods/excel. Теперь API возвращает ошибку 400 PrintUnsupported.

  • Для поручений, которые приходят вместе с требованиями от ФНС, добавлена возможность распознавания корректного КНД из файла. Чтобы отличить поручение от требования добавлено новое поле demand_knd (модели DemandAttachmentRequisites и RecognizedMeta), в котором будет лежать КНД поручения. Чтобы поле заполнилось нужно вызвать метод Распознавания требования.

Февраль 2021

  • Новый документооборот для отправки писем в Росстат, подробнее в статье Отправка писем в Росстат.

  • В метаинформации документоооборота письма в ФНС (модель LetterDescription) добавлено новое поле sender-inn.

  • В метаинформации документоооборота письма из ФНС (модель CuLetterDescription) добавлено новое поле recipient-inn.

Декабрь 2020

  • В документации появилась новая cтатья по криптографии.

  • Исправлена ошибка при отправке Заявления на подключение к ЭДОК.

  • В методе распознавания требования добавлена проверка, что файл требования в формате pdf.

  • В метаинформации документооборота требования (модель DemandDescription) добавлено новое поле sent-on-report-filename — имя файла отчета, на которое сформировано требование.

  • В метаинформации документооборота 4-ФСС (модель FssReportDescription) добавлено новое поле correction-number — номер корректировки.

Обновления в Extern Test Tools:

  • Поддержан новый способ аутентификации по протоколу OpenId Connect. Рекомендуется выполнять запросы при помощи Postman. Старый способ аутентификации через auth.sid будет поддерживаться для реализованных интеграций.

Ноябрь 2020

  • Для устаревших методов по получению зашифрованного и расшифрованного контента введены ограничения на размер запрашиваемого контента: 32 МБ на тестовой и 64 МБ на рабочей площадке. Для получения больших контентов вместо старых методов рекомендуется использовать Сервис контентов.

  • В свойствах документа документа в документообороте реализован новый вспомогательный параметр SupportPrint (модель DocflowDocumentDescription), который поможет определить возможность печати документа. Параметр может иметь одно из трех значений: Yes, No, Unknown. Подробнее в статье Печать.

Октябрь 2020

Новый способ аутентификации по протоколу OpenId Connect. Старый способ аутентификации через auth.sid будет поддерживаться для реализованных интеграций.

Сентябрь 2020

  • Новый вид документооборота с ЦБ РФ. Доступен только для получения списка документооборотов. Отправить документы в ЦБ РФ можно в веб-интерфейсе Экстерна.

  • API теперь поддерживает новые формы заявления регистрации бизнеса. Полный список кодов заявлений описан в методе Создания DraftsBuilder (параметр application-code).

Обновления в Extern Test Tools:

  • Исправлена ошибка экранирования кавычек, из-за которой в некоторых случаях могло некорректно сформироваться входящее требование.

Август 2020

  • В методах API добавлен новый метод проверки требований. Метод помогает определить корректность поступившего требования. Если требование не прошло проверки, будут сформированы коды ошибок, которые нужно использовать при формировании уведомления об отказе. Подробнее в инструкции Проверка требований.

  • Настроено корректное отображение размера расшифрованного контента документа в поле decrypted-content-size.

  • Исправлена ошибка печати документов из документооборота ПОВЭД: в печатной форме отчета корректно проставляется дата отчета и наименование организации.

Июнь 2020

  • В методах API добавлена возможность формирования подписи xmlDsig для подписания отчета СЗВ-ТД и заявления на подключение к ЭДОК в ПФР. Подробное описание в документации: Подпись XMLDsig для отчетов в ПФР.

Май 2020

  • Добавили в методы формирования файлов в черновике возможность генерации заявления на подключение к ЭДОК. Достаточно передать валидный JSON контракт, метод сгенерирует контент файла и положит его в документ черновика.

  • О штампах в печатных формах:

    • Внесли правки в печати штампов на отчетах.

    • Добавили в штампы помимо названия инспекции ее код.

    • Добавили штампы в печатные формы отчета 2-НДФЛ.

  • В печатных формах добавили указание общего количества страниц.

  • В документации добавили новый раздел Начало работы с API.

Апрель 2020

  • Доработали поиск документооборотов: теперь можно запрашивать сразу несколько типов в параметре type. Например, type=fns534-report&type=pfr-report.

  • Новый вид отчетности в ПФР: отправка отчета СЗВ-ТД и готового заявления на подключение к ЭДОК.

  • Добавили в description документооборота ИНН-КПП реорганизованных и ликвидированных организаций, которые лежат внутри отчетов по таким организациям.

Март 2020

  • Добавили возможность асинхронной печати документов, теперь можно ставить задачи на печать (Tasks).

  • Исправили появление дублей в документообороте Росстата.

  • Добавили ссылки в документообороте 4-ФСС, которые ведут в веб-интерфейс Экстерна.

  • Добавили проверку сертификата подписи при отправке ответных документов ФНС: ИНН в сертификате подписи должен быть равен ИНН в поле Sender.

Февраль 2020

  • Изменили поиск документооборотов:

    • теперь в общий список не будут попадать документообороты регистрации бизнеса. Чтобы получить документообороты по данному типу нужно передать параметр type = business-registration;

    • добавили новый тип документооборота с ФСС — Подтверждение основного вида экономической деятельности (ПОВЭД). Данный тип документооборота можно только получить. Отправить электронную форму ПОВЭД можно только в Экстерне.

  • Научились распознавать срок ответа на требование из PDF файла требования ФНС. Метод распознавания требования POST Recognize.

  • Исправили текст сообщений об ошибках отправки черновика (Send) для случаев, когда указан неверный тип контента или некорректный ip-адрес.

  • Исправили ошибку генерации ответного документа (reply document), у которого нет печатной формы.

  • В документации добавили статью по работе с методами ленты событий, также описаны Статусы ленты событий.

  • Добавили новые методы по работе с контентом, см. раздел в swagger сервис контентов:

    • Реализована работа с большими файлами документов документооборотов: методы позволяют скачивать контент любого размера.

    • В модели документооборотов, созданных от 02.02.2020, добавлены идентификаторы контентов документов.

    • В методах по работе с контентами файлов можно передавать только идентификатор контента, например, для печати документа.

Январь 2020

Обновления в API Контур.Экстерна:

  • Добавили уведомления в ленту событий по документооборотам ФСС и ПФР.

  • Добавили контентам документов описание состояния: сжат, зашифрован, расшифрован и т.д. Ранее описание состояния было только у документа и могло быть некорректным.

  • Исправили ошибку при создании черновика: для ИП не обязательно заполнение Payer.Organization.

Обновления в Extern Test Tools:

  • В методах генерации требований и писем добавили поле ifnsCode, что позволит тестировать получение требований от разных ИФНС.

Ранее мы не вели практику написания изменений в API, поэтому обновлений за 2018-2019 год нет.