ETA.eReceipt.IntegrationToolkit 1.0.152-preview

This is a prerelease version of ETA.eReceipt.IntegrationToolkit.
There is a newer version of this package available.
See the version list below for details.
dotnet add package ETA.eReceipt.IntegrationToolkit --version 1.0.152-preview                
NuGet\Install-Package ETA.eReceipt.IntegrationToolkit -Version 1.0.152-preview                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="ETA.eReceipt.IntegrationToolkit" Version="1.0.152-preview" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add ETA.eReceipt.IntegrationToolkit --version 1.0.152-preview                
#r "nuget: ETA.eReceipt.IntegrationToolkit, 1.0.152-preview"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install ETA.eReceipt.IntegrationToolkit as a Cake Addin
#addin nuget:?package=ETA.eReceipt.IntegrationToolkit&version=1.0.152-preview&prerelease

// Install ETA.eReceipt.IntegrationToolkit as a Cake Tool
#tool nuget:?package=ETA.eReceipt.IntegrationToolkit&version=1.0.152-preview&prerelease                

ETA.eReceipt.IntegrationToolkit is a .Net6 NuGet exposed as a set APIs to the taxpayers’ POS/ERP systems and developers as well. It’s optional for the taxpayer to integrate their systems with the toolkit.

The nuget is intended to support different scenarios that can be performed in offline mode. The different set of functionalities/APIs that will be supported in offline mode will be as follows:

• Issue Receipt • Generate Receipt QR code • Assign globally unique receipt UUID • Export issued receipts • Validate documents locally while issuing and generation of UUID and QR codes

Other than working offline, the toolkit will have to be used in online mode for specific scenarios that require connection to the eReceipt solution. It will also use external APIs exposed by the eReceipt solution’s server-side to perform the following: • Help authenticate POS • Synchronize receipts • Update codes and business rules in local cache

Nuget is implemented to store receipts in SQLlite database, So developer need to configure how to connect to it while initialization of application services.

To integrate toolkit into your application follow the next steps

1- Add configuration section to apsettings.json "ToolkitConfig": { // connection string of sqllit database "LocalConnectionsString": "Data Source=C:\Users\Administrator\AppData\Local\LocalReceipts.db;", //Egypt tax authority configuration section "EtaConfig": {

  // identity service url to acquire access token to invoicing APIs
  "IdentityServiceUrl": "https://id.preprod.eta.gov.eg/connect/token",
  
  // invoicing portal base url, will be used while generation of QR codes
  "InvoicingServiceBaseUrl": "https://api.preprod.invoicing.eta.gov.eg",

  // invoicing service base url, will be used while submission and syncing receipts
  "InvoicingPortalBaseUrl": "https://preprod.invoicing.eta.gov.eg/",

  // version of invoicing service
  "InvoicingServiceVersion": "1",

  // The involved POS while integration with invoicing through nuget
  "PosSerial": "",
  "SubTypeAttributeKey": "AmountType",
  "SubTypeAttributeValue": "amount"
}

}

2- Add it to service collection using extension method // By calling this service u can inject IToolkitHandler service // and use any of its exposed functionality like issue, submit, sync ... and son services.AddToolkit(configuration);

Usage Notes 1- You can combine the previous two steps in one step by calling the following line of code where you pass configuration object apart from your configuration file: services.AddToolkit(configuration, ToolkitConfig);

2- You can delegate the creation of SQLite database to nuget by adding the following line of code in application startup: app.MigrateToolkitLocalStorage();

Product Compatible and additional computed target framework versions.
.NET net6.0 is compatible.  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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

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
3.1.3-rc 286 7/10/2023
3.1.2-rc 127 7/6/2023
3.1.1-rc 123 6/22/2023
3.1.0 582 8/1/2023
3.0.5 313 5/5/2023
3.0.5-rc 157 4/16/2023
3.0.4-rc 137 4/16/2023
3.0.3-rc 136 4/14/2023
3.0.2-rc 142 4/11/2023
3.0.1-rc 159 4/9/2023
3.0.0-rc 201 3/29/2023
2.0.2 323 3/23/2023
2.0.2-preview 167 3/13/2023
2.0.1-preview 169 2/20/2023
2.0.0 1,324 12/2/2022
1.0.169-preview 122 7/6/2023
1.0.168-preview 121 6/5/2023
1.0.167-preview 143 5/31/2023
1.0.166-preview 149 5/28/2023
1.0.165-preview 137 5/23/2023
1.0.164-preview 115 5/23/2023
1.0.161-preview 121 5/23/2023
1.0.159-preview 105 5/23/2023
1.0.158-preview 130 5/17/2023
1.0.157-preview 130 4/16/2023
1.0.156-preview 127 4/16/2023
1.0.155-preview 174 3/22/2023
1.0.153-preview 166 3/2/2023
1.0.152-preview 155 2/27/2023
1.0.151-preview 160 2/15/2023
1.0.150-preview 180 2/7/2023
1.0.149-preview 158 2/6/2023
1.0.148-preview 178 2/5/2023
1.0.147-preview 168 2/4/2023
1.0.146-preview 188 2/2/2023
0.0.1 184 7/31/2023