Git Product home page Git Product logo

api-fatoora's Introduction


GitHub stars GitHub forks Code style: black GitHub license ZATCA FastAPI Heroku

fast-fatoora

You can try it with simple ui @ Heroku

fast-fatoora is an open API to help generating QR-code for ZATCA's e-invoice known as "Fatoorah"

full API documentations


how to use it

lets say you have the following data

{
  "seller_name":"Nafie",
  "tax_number":"981293479834",
  "date":"2021-12-06 16:14:17.374909",
  "total_amount":"100.00",
  "tax_amount":"0.50"
}

To base64

Use /to_base64 to get base64 encoded information

Parameter :
  seller_name: required
  tax_number: required
  date: optional, if not provided created date and time will be added
  total: required
  tax_amount: required
  
  
https://api-fatoora.herokuapp.com/to_base64?seller_name=Nafie&tax_number=981293479834&total=100.00&tax_amount=0.50&date=2021-12-06%2016%3A14%3A17.374909

Try it

To QR-Code image

Use /to_qrcode_image to generate QR-Code image

Parameter :
  seller_name: required
  tax_number: required
  date: optional, if not provided created date and time will be added
  total: required
  tax_amount: required
  
  

https://api-fatoora.herokuapp.com/to_qrcode_image?seller_name=Nafi&tax_number=981293479834&total=100.00&tax_amount=0.50&date=2021-12-06%2016%3A14%3A17.374909

Try it

Full E-Invoice(fatoora)

Use /full_fatoora to get e-invoice with qrcode image

Parameter :
  fat_number: Optional, e-ivoice number/id if not ptovided it will be filled with random numbers
  seller_name: required
  tax_number: required
  date: optional, if not provided created date and time will be added
  total: required
  tax_amount: required
  
  

https://api-fatoora.herokuapp.com/full_fatoora?seller_name=Nafie&tax_number=981293479834&total=100.00&tax_amount=0.50&date=2021-12-06%2016%3A14%3A17.374909&fat_number=5837

Try it

Devolepment

To start your local devolepment

clone repo

git clone https://github.com/NafieAlhilaly/fast-fatoora.git
cd fast-fatoora

install dependencies

using pip:

pip install -r requirements.txt

using poetry(recommended):

poerty install

run the local devolepment server

python app/main.py

server will run on https://127.0.0.1:8000

api-fatoora's People

Contributors

nafiealhilaly avatar sudanalhilali avatar

Stargazers

 avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.