How to set up environment to access test APIs and test portals?
Test environment of the solution (SIT and UAT/PreProd environments) depends on internally issued certificates. Therefore to be able to properly use either the Invoicing Portal or get to APIs that solution is exposing, first you need to configure trust of Root Certificate of the test environment in your own test and development environments (Note: do not install this certificate in your production environment).
- To do the configuration, please download the root CA certificate file as per the environment below:
|Environment||Root CA certificate file|
|SIT||Root CA certificate file|
|UAT/PreProd||Root CA certificate file|
Download the file to your local machine that will be used to test the APIs and portal of e-invoicing, right-click and choose
Install Certificate(Note: Admin rights on machine are needed)
Trusted Root Certification Authoritiesstore
Confirm the selection of store, press
Nextand then press
Finishon final confirmation screen
You should not be able to access portals and APIs of the UAT test environment without getting security warnings or certificate validation related errors.
Note! This instruction describes how to install the certificate on Windows 10 machine. If you are using older Windows or another operating system, please follow appropriate guidance from the vendor of the OS you have.
How to test our APIs via Postman?
For those that are using Postman to do quick tests and see how the APIs should be called both on identity service and actual document exchange, please use the Postman collection Egyptian e-Invoicing SDK.postman_collection.json (use right-click Save As…) and use Postman as per the environment below (use right-click Save As…).
|Environment||Postman Env. File|
|SIT||EEI - SIT Env.postman_environment.json|
|UAT/PreProd||EEI - UAT Env.postman_environment.json|
|Prod||EEI - PRD Env.postman_environment.json|
To install the environments file, follow these steps:
On the top right hand corner, click on the gear icon named
A popup named
Manage Environmentswill show up and you need to click on the
Importbutton, after clicking on the import button, select the right env. file named and click
A new environment named
EEI - UAT Envor
EEI - SIT Envshould be added to the drop down list on the top right corner, click again on the
gear iconand click on the newly added environment named
EEI - UAT Envor
EEI - SIT Env(Based on the environment you want to work on)
Note: In case you faced in PostMan an error stating “SSL Error: Self signed certificate in certificate chain” similar to the image below, you need to click on the link “Disable SSL Verification” or you need to follow the step in point 5.
Go to PostMan settings from the top right corner
Gear Icon, then turn off “SSL Certificate Verification” as shown in the image below.