Mews.Fiscalizations.Spain
6.0.0
Prefix Reserved
See the version list below for details.
dotnet add package Mews.Fiscalizations.Spain --version 6.0.0
NuGet\Install-Package Mews.Fiscalizations.Spain -Version 6.0.0
<PackageReference Include="Mews.Fiscalizations.Spain" Version="6.0.0" />
paket add Mews.Fiscalizations.Spain --version 6.0.0
#r "nuget: Mews.Fiscalizations.Spain, 6.0.0"
// Install Mews.Fiscalizations.Spain as a Cake Addin #addin nuget:?package=Mews.Fiscalizations.Spain&version=6.0.0 // Install Mews.Fiscalizations.Spain as a Cake Tool #tool nuget:?package=Mews.Fiscalizations.Spain&version=6.0.0
📃 Description
This library uses the SII to report e-invoices, please check their Documentation.
SII stands for Suministro Inmediato de Información del IVA, which translates to Immediate Supply of Information on VAT. It's an online API provided by Spanish authorities in a form of a SOAP Web Service.
⚙️ Installation
The library can be installed through NuGet packages or the command line as mentioned below:
Install-Package Mews.Fiscalizations.Spain
🎯 Features
- Functional approach via FuncSharp.
- No Spanish abbreviations.
- Early data validation.
- Asynchronous I/O.
- All endpoints are covered with tests.
- Intuitive immutable DTOs.
- Pipelines that run on both Windows and Linux operating systems.
- Cross platform (uses .NET Standard).
- Logging support.
❗ Known issues
- We didn't implement deleting or modifying already existing records.
📦 NuGet
We have published the library as Mews.Fiscalizations.Spain.
👀 Code Examples
Listed below are some of the common examples. If you want to see more code examples, please check the Tests.
Creating the client There are 3 required properties that need to be provided when creating the client
- Certificate: the certificate can be obtained from the SII website
- Environment: production/test.
- HttpTimeout: the timespan to wait before the request times out.
var certificate = new X509Certificate2(.....);
var client = new Client(certificate, Environment.Test, httpTimeout: TimeSpan.FromSeconds(30));
Creating the IssuingCompany (supplier/issuer) First step is to create the tax payer object:
var taxpayerIdentificationNumber = TaxpayerIdentificationNumber.Create(Countries.Spain, "INSERT_ISSUER_TAX_NUMBER").Success.Get();
and to create the IssuingCompany object:
var issuingCompany = new LocalCompany(
name: Name.CreateUnsafe("Name of the issuing company"),
taxpayerIdentificationNumber: taxpayerIdentificationNumber
);
Creating the invoice
var issueDateUtc = nowUtc.Date;
var vat = 21m;
var baseValue = 42.07m;
var taxRateSummaries = new[]
{
new TaxRateSummary(
taxRatePercentage: Percentage.Create(vat).Success.Get(),
taxBaseAmount: Amount.Create(baseValue).Success.Get(),
taxAmount: Amount.Create(Math.Round(baseValue * vat / 100, 2)).Success.Get()
);
};
var taxExemptItems = new[] { new TaxExemptItem(Amount.Create(20m).Success.Get(), CauseOfExemption.OtherGrounds) };
var invoice = return new SimplifiedInvoice(
taxPeriod: new TaxPeriod(Year.Create(issueDateUtc.Year).Success.Get(), (Month)(issueDateUtc.Month - 1)),
id: new InvoiceId(issuingCompany.TaxpayerIdentificationNumber, String1To60.CreateUnsafe("Invoice_number"), issueDateUtc),
schemeOrEffect: SchemeOrEffect.GeneralTaxRegimeActivity,
description: String0To500.CreateUnsafe("Invoice description."),
taxBreakdown: new TaxBreakdown(TaxSummary.Create(taxExempt: taxExemptItems, taxed: taxRateSummaries).Success.Get()),
issuedByThirdParty: true
);
Submitting the invoice
var model = SimplifiedInvoicesToSubmit.Create(
header: new Header(IssuingCompany, CommunicationType.Registration),
invoices: new[] { invoice }
).Success.Get();
var response = await client.SubmitSimplifiedInvoiceAsync(model);
🧑 Authors
Development: @PavelKalandra, @MiroslavVeith
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
- FuncSharp (>= 4.0.0)
- Mews.Fiscalizations.Core (>= 4.0.0)
- System.Net.Http (>= 4.3.4)
- System.ServiceModel.Primitives (>= 4.8.1)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated |
---|---|---|
12.0.2 | 115 | 7/3/2024 |
12.0.1 | 315 | 1/30/2024 |
12.0.0 | 280 | 1/29/2024 |
11.0.0 | 612 | 8/27/2023 |
10.0.2 | 687 | 8/2/2023 |
10.0.1 | 681 | 7/26/2023 |
10.0.0 | 656 | 7/24/2023 |
9.0.5 | 914 | 10/24/2022 |
9.0.4 | 917 | 10/21/2022 |
9.0.2 | 886 | 10/17/2022 |
9.0.1 | 944 | 9/15/2022 |
9.0.0 | 912 | 9/6/2022 |
8.0.3 | 959 | 7/4/2022 |
8.0.2 | 947 | 5/24/2022 |
8.0.1 | 987 | 4/25/2022 |
8.0.0 | 940 | 4/21/2022 |
7.0.4 | 969 | 4/14/2022 |
7.0.3 | 970 | 4/14/2022 |
7.0.2 | 989 | 1/12/2022 |
7.0.1 | 1,935 | 11/26/2021 |
7.0.0 | 812 | 11/23/2021 |
6.0.0 | 871 | 11/8/2021 |
5.0.1 | 840 | 11/5/2021 |
5.0.0 | 897 | 7/21/2021 |
4.0.0 | 1,421 | 5/24/2021 |