Add new Hcs.Broker to communicate with ГИС ЖКХ via CryptoPro LibCore

2025-09-28 15:45:15 +09:00
parent 904988780a
commit 2b49320014
171 changed files with 185618 additions and 0 deletions
--- a/Hcs.Broker/Api/BillsApi.cs
+++ b/Hcs.Broker/Api/BillsApi.cs
@ -0,0 +1,65 @@
+using Hcs.Broker.Api.Payload.Bills;
+using Hcs.Broker.Api.Request.Bills;
+using Hcs.Service.Async.Bills;
+
+namespace Hcs.Broker.Api
+{
+    // http://open-gkh.ru/BillsServiceAsync/
+    public class BillsApi(Client client) : ApiBase(client)
+    {
+        /// <summary>
+        /// Экспорт платежных документов
+        /// </summary>
+        /// <param name="paymentDocumentID">Идентификатор платежного документа</param>
+        /// <param name="token">Токен отмены</param>
+        /// <returns>Платежные документы</returns>
+        public async Task<IEnumerable<exportPaymentDocumentResultType>> ExportPaymentDocumentDataByPaymentDocumentIDAsync(string paymentDocumentID, CancellationToken token = default)
+        {
+            var request = new ExportPaymentDocumentDataRequest(client);
+            return await request.ExecuteByPaymentDocumentIDAsync(paymentDocumentID, token);
+        }
+
+        /// <summary>
+        /// Экспорт платежных документов
+        /// </summary>
+        /// <param name="year">Год</param>
+        /// <param name="month">Месяц</param>
+        /// <param name="fiasHouseGuid">Глобальный уникальный идентификатор дома по ФИАС</param>
+        /// <param name="accountNumber">Номер лицевого счета/иной идентификатор плательщика</param>
+        /// <param name="token">Токен отмены</param>
+        /// <returns>Платежные документы</returns>
+        public async Task<IEnumerable<exportPaymentDocumentResultType>> ExportPaymentDocumentDataByAccountNumberAsync(short year, int month, string fiasHouseGuid, string accountNumber, CancellationToken token = default)
+        {
+            var request = new ExportPaymentDocumentDataRequest(client);
+            return await request.ExecuteByAccountNumberAsync(year, month, fiasHouseGuid, accountNumber, token);
+        }
+
+        /// <summary>
+        /// Экспорт платежных документов
+        /// </summary>
+        /// <param name="year">Год</param>
+        /// <param name="month">Месяц</param>
+        /// <param name="fiasHouseGuid">Глобальный уникальный идентификатор дома по ФИАС</param>
+        /// <param name="paymentDocumentNumber">Номер платежного документа, по которому внесена плата,
+        /// присвоенный такому документу исполнителем в целях осуществления расчетов по внесению платы</param>
+        /// <param name="token">Токен отмены</param>
+        /// <returns>Платежные документы</returns>
+        public async Task<IEnumerable<exportPaymentDocumentResultType>> ExportPaymentDocumentDataByPaymentDocumentNumberAsync(short year, int month, string fiasHouseGuid, string paymentDocumentNumber, CancellationToken token = default)
+        {
+            var request = new ExportPaymentDocumentDataRequest(client);
+            return await request.ExecuteByPaymentDocumentNumberAsync(year, month, fiasHouseGuid, paymentDocumentNumber, token);
+        }
+
+        /// <summary>
+        /// Импорт сведений о платежных документах
+        /// </summary>
+        /// <param name="payload">Пейлоад сведений о платежных документах</param>
+        /// <param name="token">Токен отмены</param>
+        /// <returns>true, если операция выполнена успешно, иначе - false</returns>
+        public async Task<bool> ImportPaymentDocumentDataAsync(ImportPaymentDocumentDataPayload payload, CancellationToken token = default)
+        {
+            var request = new ImportPaymentDocumentDataRequest(client);
+            return await request.ExecuteAsync(payload, token);
+        }
+    }
+}