https://github.com/spoleto-software/spoleto.taxcom
.NET SDK для работы с API сервиса Taxcom
https://github.com/spoleto-software/spoleto.taxcom
dotnet dotnet-pipeline ofd taxcom taxcomapi
Last synced: 2 months ago
JSON representation
.NET SDK для работы с API сервиса Taxcom
- Host: GitHub
- URL: https://github.com/spoleto-software/spoleto.taxcom
- Owner: spoleto-software
- License: mit
- Created: 2025-03-13T17:32:05.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-03-14T18:25:25.000Z (over 1 year ago)
- Last Synced: 2025-03-14T19:26:46.094Z (over 1 year ago)
- Topics: dotnet, dotnet-pipeline, ofd, taxcom, taxcomapi
- Language: C#
- Homepage: https://spoleto.ru
- Size: 41 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Spoleto.Taxcom
[](https://github.com/spoleto-software/Spoleto.Taxcom/blob/main/LICENSE)
[](https://www.nuget.org/packages/Spoleto.Taxcom/)
## Описание
SDK для работы с API сервиса Taxcom (https://lk-ofd.taxcom.ru), предоставляющее простой и удобный способ интеграции с сервисом Taxcom.
## Особенности
- Поддержка REST API Taxcom
- Автоматическое управление авторизацией и токенами
- Асинхронные методы для максимальной производительности
- Синхронные версии всех методов для использования в коде без возможности асинхронности
## Установка
```bash
Install-Package Spoleto.Taxcom
```
## Быстрый старт
### Использование `Microsoft Dependency`:
```csharp
using Spoleto.Taxcom;
services.AddSingleton(taxcomOptions);
services.AddSingleton();
// Далее либо:
var provider = _serviceProvider.GetRequiredService();
// Либо инжектировать в свой класс:
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`:
```csharp
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`.
```bash
dotnet test
```