ETA/ETA.eReceipt.IntegrationToolkitv2.0.2

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();