v1.7.6

• Добавили методы для документооборотов ПФР и ФСС
• Обновили библиотеки криптографии
• Добавили возможность работы с DSS-сертификатами
• Добавили PUT-методы для работы с конструктором черновиков
• Добавили метод для получения сертификатов всех пользователей, которые имеют доступ к учетной записи
• Разные исправления и улучшения

Весеннее обновление

v1.7.5

🌞 Краткй список изменений

• ⚡️ Добавили асинхронную работу, к примеру для методов черновиков: Проверка, Подготовка, Отправка.
• ⚡️Добавили методы для работы с билдером черновиков (документация: DraftsBuilder)
• ⚡️Добавили возможность распознавания приложения для требований ФНС.
• ⚡️Добавили возможность для работы со всеми документооборотами типа ION.
• ⚡️Добавили модуль с методами для тестирования API (генерации входящих ДО): extern-api-java-sdk-test-api.
• ⚡️Добавили методы для работы со связанными документами
• ⚡️Исправили некоторые ошибки внутренней реализации SDK.

🌚 Подробнее обо всём

• 💠 Асинхронная работа:
  Методы расположены в TaskService.
  Для каждой задачи возможны действия:

  • запустить задачу
  • получить статус задачи
  • дождаться завершения и получить результат выполнения

• 💠 Распознавание требований ФНС
  Для документооборота с типом FNS534_DEMAND и документа с типом Fns534Attachment в доступна возможность распознать номер требования, дату и список упомянутых инн. DocflowService#recognizeAsync.

• 💠 Draft Builder
  Набор сервисов, доступ которым открывается с помощью ExternEngine#getDraftsBuilderService#fnsInventory

• 💠 Ion
  Добавили методов для генерации документов типа ION из Java объектов. Для этого используеся DraftService#newIonRequestAsync. Сами контракты можно собрать классом IonBuilder.

2012 Gost

• Добавили поддержку сертификатов стандарта 2012 года.

Delete Account update

• Добавили возможность удаления аккаунта

Ionization

Значком ⚠️ обозначены изменения, несовместимые с предыдущими версиями. Также здесь есть некоторые рекомендации для лечения / профилактики возникающих ошибок.

• ⚠️ Разделили модель DraftMeta на две модели для запросов и ответов сервера. Если до этого вы явно использовали DraftMeta, то нужно будет изменить её использование на DraftMetaRequest в методах createDraft и updateDraftMeta (можно воспользоваться методом DraftMeta#toRequest()).

• Добавлены методы постраничного получения сертификатов и аккаунтов. Максимальный размер страницы - 100 записей. ⚠️ Раньше клиент по умолчанию ожидал, что вернутся все сертификаты и учетные записи.

• В модели DraftMeta у организации теперь возвращается определённое имя (см. #getPayer()#getName())

• Обновлены версии retrofit и okhttp

• Новые реализации фильтров для search-методов позволяют передавать null для игнорирования фильтрации по заданному параметру.

• Все остальные параметры сервисных методов явно помечены NotNull аннотациями

• В черновиках добавлены методы генерации документа "ИОН запрос" buildIonRequest и newIonRequest

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

Retrofitting

В этом обновлении

• инициализация и конфигурация ExternEngine с помощью ExternEngineBuilder
• внутренняя стабильность
• упрощение дебага приложений использующих сдк

Список изменений:

• Обновлён http клиент. Используем Retrofit с собственными плагинами для обращений к сервисам Контура.
• Сокращено количество требуемых конфигурационных параметров. Вся необходимая конфигурация настраивается один раз, при создании ExternEngine.
• Облегчена кодовую базу, при введении retrofit был убран слой архитектуры, связанный с преобразованием сырых http ответов.
• Повышена стабильность и качество обработки ошибочных ответов и исключительных ситуаций.
• Добавлено кэширование и автоматическое обновление токена аутентификации при продолжительной работе с сессией.
• Добавлено полное настраиваемое логирование http протокола.
• Увеличено стандартные значения таймаутов.
• Обновлена документацию.
• Добавлены методы и классы для использования тестового окружения (прим. SmsCodeProvider).
• Добавлены сценарии интеграций (вместо примеров).
• Расширена функциональность криптографической библиотеки (см. CryptoApi).
• Синхронизированы модели данных с сервером

Для начала работы с апи стоит прочитать readme.md и странички на wiki проекта

Maven central integration

Бинарные пакеты доступны на maven.central