Уважаемые налогоплательщики!
В ИС «ЭСФ» с 23 апреля 2020 года вносятся изменения в API для работы с Актами выполненных работ на портале ИС «ЭСФ».
Документ с описанием изменений API для Актов выполненных работ располагается для скачивания на портале Комитета государственных доходов МФ РК.
Описание изменений API для Актов выполненных работ
С 23.04.2020 года вносятся изменения в API для работы с Актами выполненных работ на портале ИС ЭСФ:
1. В связи с добавлением новых полей «ИИН/БИН исполнителя (поставщика)»/ Наименование НП в раздел I. «Сведения по ЭЦП исполнителя (поставщика)», ИИН/БИН заказчика (получателя)/Наименование НП в раздел J. «Сведения по ЭЦП заказчика (получателя)» в АВР на портале ИС ЭСФ:
и изменением печатной формы бланка АВР:
пользователь при получении АВР по API также будет видеть дополнительное поле в теге <participantInfo>(123456789021) ТОО "Асем-2"</participantInfo>, например, как на представленном ниже скрине:
2. Добавлена возможность отправки Акта выполненных работ по API с возможностью ручной корректировки. Для этого в xml АВР добавлен тег <autoCalculating>______</autoCalculating>, смотрите скрин ниже:
Если вы пользуетесь только прямым автоматическим расчетом в разделе АВР по API, то вам ничего менять не нужно. Система будет применять по умолчанию, флаг «true» для поля autoCalculating.
В случае, если система из-за разницы в округлении десятичных дробей, не принимает ваш Акт выполненных работ по API, необходимо, добавить в xml АВР тег <autoCalculating>false</autoCalculating> со значением «false».
При изменение расчета, когда не требуется ручная корректировка, флаг в поле autoCalculating меняется опять на «true».
Обновленный комплект разработчика располагается по ссылке: http://kgd.gov.kz/ru/content/api-interfeys-web-prilozheniya-elektronnye-scheta-faktury-1
В целях реализации интеграции ERP-систем налогоплательщиков с ИС ЭСФ посредством API-интерфейса, для Вас доступен обновленный комплект разработчика на 23 апреля 2020 г., который содержит в себе:
- Документацию по API
- Шаблоны ЭСФ в XML формате
- Проект ЭСФ для SOAP
- Приложение генерации подписи
- Файлы библиотеки
Для того, чтобы понять, как работает API механизм, выполните следующие шаги:
Шаг1:
Скачать комплект разработчика.
Шаг 2:
В папке localserver есть приложение, которое позволит вам генерировать подпись. Его нужно запустить из консоли от имени Администратора вызовом файла start.bat
Шаг 3:
В паке soapui находится XML файл, содержащий проект по ЭСФ. Проект нужно открыть в SoapUI, который можно скачать на официальном сайте. Открыв проект, найдете ссылки на описание методов и сервисов.
Также в нем предусмотрены два тестовых сценария поочередного выполнения всех операций.
Шаг 4:
Запускаете сценарий, ожидаете завершения его выполнения.
В окне сможете увидеть каждый шаг выполнения каждого запроса. При двойном клике на запрос вы сможете увидеть само тело запроса и ответ, пришедший от системы.
Результаты выполнения сценария можно увидеть на тестовом стенде ИС ЭСФ.
Вход в в тестовый стенд можно осуществить с использованием собственных сертификатов.
Подробное описание сервисов и методов вы сможете найти в документации, в проекте SOAP или по ссылке
Комитет государственных доходов МФ РК