hcs/Hcs.ClientNet/Client/Api/BillsApi.cs

using Hcs.ClientNet.Api.Payload.Bills;
using Hcs.ClientNet.Api.Request.Bills;
using Hcs.Service.Async.Bills;
using System.Collections.Generic;
using System.Threading;
using System.Threading.Tasks;

namespace Hcs.ClientNet.Api
{
    // http://open-gkh.ru/BillsServiceAsync/
    public class BillsApi(ClientBase 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);
        }
    }
}