Spoleto.Taxcom

Описание

SDK для работы с API сервиса Taxcom (https://lk-ofd.taxcom.ru), предоставляющее простой и удобный способ интеграции с сервисом Taxcom.

Особенности

• Поддержка REST API Taxcom
• Автоматическое управление авторизацией и токенами
• Асинхронные методы для максимальной производительности
• Синхронные версии всех методов для использования в коде без возможности асинхронности

Установка

Install-Package Spoleto.Taxcom

Быстрый старт

Использование Microsoft Dependency:

using Spoleto.Taxcom;

services.AddSingleton(taxcomOptions);
services.AddSingleton<ITaxcomProvider, TaxcomProvider>();

// Далее либо:
var provider = _serviceProvider.GetRequiredService<ITaxcomProvider>();

// Либо инжектировать в свой класс:
public class YourClass
{
    private readonly ITaxcomProvider _provider;

    public YourClass(ITaxcomProvider taxcomProvider)
    {
        _provider = taxcomProvider;
    }
}

// И далее, например, получение ссылки на чек
var searchModel = new DocumentUrlSearchModel
{
	FnFactoryNumber = "123456789",
	FdNumber = 12345
};

var documentUrlModel = await provider.GetDocumentUrlAsync(searchModel);

Использование TaxcomProviderFactory:

using Spoleto.Taxcom;

var provider = new TaxcomProviderFactory().WithOptions("integratorId", "login", "password").Build();

// Получение ссылки на чек
var searchModel = new DocumentUrlSearchModel
{
	FnFactoryNumber = "123456789",
	FdNumber = 12345
};

var documentUrlModel = await provider.GetDocumentUrlAsync(searchModel);

Лицензия

MIT

Требования

• .NET Standard 2.0+
• .NET 8+

Тестирование

Создан проект для тестов Spoleto.Taxcom.Tests.

dotnet test