BillingoApi 1.0.0
See the version list below for details.
dotnet add package BillingoApi --version 1.0.0
NuGet\Install-Package BillingoApi -Version 1.0.0
<PackageReference Include="BillingoApi" Version="1.0.0" />
paket add BillingoApi --version 1.0.0
#r "nuget: BillingoApi, 1.0.0"
// Install BillingoApi as a Cake Addin
#addin nuget:?package=BillingoApi&version=1.0.0
// Install BillingoApi as a Cake Tool
#tool nuget:?package=BillingoApi&version=1.0.0
A simple API to interact with the Billingo online invoicing system
Requirements
This library targets .NET Standard 2.0, so you can use it in any of the supported platforms
Platforms
- .NET Core 2.0
- .NET Framework 4.6.1
- Mono 5.4
- Xamarin.iOS 10.14
- Xamarin.Mac 3.8
- Xamarin.Android 7.5
- Universal Windows Platform vNext
Usage
For now this library is focusing on Query features, reading Blocks / Invoices. You are welcome to contribute with additional features.
Get all available invoice blocks
// PublicKey and PrivateKey are string values
Blocks blocks = new Blocks(PublicKey, PrivateKey);
List<Block> blocksList = await blocks.LoadAllAsync();
var expected = new List<Block>
{
new Block
{
Name = "Számlák",
Prefix = "",
Uid = 44365521
},
new Block
{
Name = "Other block",
Prefix = "B2",
Uid = 4599810
},
};
Query Invoices
// PublicKey and PrivateKey are string values
Invoices invoices = new Invoices(PublicKey, PrivateKey);
List<Invoice> invoiceList = await invoices.QueryAsync(
blockId: 111111111,
fromInvoiceNo: 880,
yearStart: 2018);
Parmeters:
blockId
: optional, the ID of the invoice block for filteringfromInvoiceNo
: optional, list all the invoices from this number, inclusivelimit
: optional, limit of the results, defaults to 50yearStart
: optional, which year to list, defaults to current yearstartDateAsString
: optional, list invoices from this date, example format: "2018-01-01", defaults to "2010-01-01
DataLoader<T>
There is a lower level class to handle the API communication and to parse the results. You may use it when you implement additional features. For example the Blocks
class is using the DataLoader the following way:
public async Task<List<Block>> LoadAllAsync(int limit = 50)
{
var l = new DataLoader<Block>(connection, "/invoices/blocks");
return await l.FetchAllAsync(limit);
}
Connection
This class handles the authentication using the JWT tokens, based on the Billingo specification. This class is used implicitly by the DataLoader
, which in turn is used by the Invoices
and Blocks
classes
Models
There are various classes that are modelling the exact same datastructures that are defined by Billingo. When you fetch Invoices, it will return the mapped classes with deep structure.
Invoice
List<Items>
Item
Vat
Client
Address
Classes
- Address
- Bank
- Block
- Client
- Invoice
- Item
- Payment
- Vat
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 was computed. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
.NET Core | netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
.NET Standard | netstandard2.0 is compatible. netstandard2.1 was computed. |
.NET Framework | net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
MonoAndroid | monoandroid was computed. |
MonoMac | monomac was computed. |
MonoTouch | monotouch was computed. |
Tizen | tizen40 was computed. tizen60 was computed. |
Xamarin.iOS | xamarinios was computed. |
Xamarin.Mac | xamarinmac was computed. |
Xamarin.TVOS | xamarintvos was computed. |
Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETStandard 2.0
- System.IdentityModel.Tokens.Jwt (>= 5.2.2)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.