An AWS-based stack that stores NIFs from Portuguese companies along with their corresponding e-Fatura category.
This service is used by my Efatura Amigo browser extension to help
automatically select the most appropriate category when validating invoices on the e-Fatura portal.
The stack has a public and a private API to serve the data that is processed every minute by a cron job
-
Category lookup by NIF
- Returns the category associated with a given NIF
- If the NIF is not found, it is added to the database for later processing
-
Scheduled processing (cron Lambda)
- Runs every minute and calls NIF.pt to retrieve the company’s CAE
- Maps the CAE to the corresponding e-Fatura category
- Due to NIF.pt’s free usage limits, only one NIF can be processed per minute
- Saves the processed company into Companies dynamo and Algolia index
-
Company lookup by NIF
- Returns the company associated with a given NIF from dynamo
-
Search company
- Returns the search results based on the Algolia query