|
3.3. .NET SDK
|
|
|
Такском-Доклайнз .NET SDK - это набор библиотек, которые предоставляют необходимые методы для реализации юридически значимого ЭДО. Эти библиотеки автоматически совершают последовательность транзакций для всех регламентов ЭДО, включая создание и подписание служебных извещений в соответствии с законодательством РФ.
Перед использованием набора библиотек Такском-Доклайнз .NET SDK рекомендуется изучить следующие разделы документации:
Также необходимо произвести следующие действия для начала работ с SDK:
|
✓
|
Убедиться, что в системе установлен пакет Microsoft .NET Framework версии 4.0 или выше.
|
|
✓
|
|
✓
|
Установить сертификаты и их закрытые ключи участников ЭДО в раздел хранилища "Личное" для текущего пользователя Windows.
|
|
✓
|
Установить корневые сертификаты УЦ Такском (http://www.taxcom.ru/centr/norm_doc_uc/#17) в раздел хранилища сертификатов “Доверенные корневые центры сертификации”.
|
|
✓
|
Библиотека Taxcom.Client.Api.dll должна быть подключена к проекту интеграционного решения.
|
|
✓
|
Ссылка на пространство имён Taxcom.Client.Api должно быть добавлено во всех местах проекта, где используется библиотека.
|
Интеграционное решение, основанное на наборе библиотек Такском-Доклайнз .NET SDK включает в себя следующие модули:
Интеграционное решение на базе Такском-Доклайнз .NET SDK предполагает использование главного класса TaxcomApi, методы которого реализуют все необходимые модули интеграционного решения (экземпляр класса TaxcomApi должен быть создан для каждого участника ЭДО, который отправляет и получает документы с помощью интеграционного решения):
|
Модули для интеграционного решения
|
Методы класса .NET SDK TaxcomApi или класса TaxcomContainer (для примера экземпляры класса обозначены как api1 или ttc1)
|
Описание
|
|
Авторизация (1)
|
api1.Login
|
Метод авторизации в сервисах ЭДО Такском-Доклайнз с помощью набора открытого и закрытых ключей в классе TaxcomApi.
|
|
Регламент отправки приглашений к участию в ЭДО (2)
|
api1.SendContacts
|
Метод отправки приглашений новым контрагентам или удаления контрагента из списка активных контактов для ЭДО в классе TaxcomApi.
|
|
api1.GetContactListUpdates
|
Метод для получения обновлённых статусов изменения списка активных контактов.
| |
|
api1.AcceptContact
|
Метод для принятия приглашения к участию в ЭДО.
| |
|
api1.RejectContact
|
Метод для отправки отказа от приглашения к участию в ЭДО.
| |
|
api1.GetContacts
|
Метод для возвращения текущего списка активных контактов-участников ЭДО в классе TaxcomApi.
| |
|
Обмен электронными документами (3)
|
api1.AutoSendReceive
|
Метод запускает автоматическое выполнение регламентов обмена документами в сервисах ЭДО Такском-Доклайнз в классе TaxcomApi.
|
|
api1.GetDocflowsList
|
Метод возвращает список электронных документов и их статусов для участника ЭДО.
| |
|
api1.GetDocflowUpdates
|
Метод GetDocflowUpdates позволяет получить список документооборотов, отвечающим заданным параметрам.
| |
|
api1.Send
|
Метод для отправки ТКТ с электронным документом участнику ЭДО из списка активных контактов.
| |
|
api1.GetMainDocumentContainerFromDocflow
|
Метод для получения электронных документов с сервера системы Такском-Доклайнз.
| |
|
api1.GetDocflowRawData
|
Метод для получения электронных документов со служебными сообщениями с сервера системы Такском-Доклайнз.
| |
|
api1.PrintDocument
|
Метод для получения отправленных или полученных формализованных электронных документов (только счетов-фактур, актов о выполнении работ и ТОРГ-12) в виде PDF файлов.
| |
|
api1.GetStatus
|
Метод для получения статуса конкретного исходящего документа, который следует использовать только при отладке.
| |
|
Импорт и экспорт ТКТ (4)
|
ttc1.ImportFromZip
|
Метод импорта ТКТ из ZIP-архива.
|
|
ttc1.ExportToZip
|
Метод экспорта ТКТ в ZIP-архив.
|
Возможность замены сертификата абонента обеспечивают методы, описанные в п. 3.3.7. Личный кабинет абонента.