Skip to main content

SR Invoice Parser is a small library(crawler) that is parsing invoices and extracting relevant information from URL. For Serbian market.

Project description

SR Invoice Parser

build-status-image

SR Invoice Parser is a small library that is parsing invoices and extracting relevant information. It is designed to work with invoices from the TaxCore Tax Administration of the Republic of Serbia (Poreska uprava Republike Srbije).

It works on domain suf.purs.gov.rs where they use TaxCore website to show invoices.

QR code gives a URL to the invoice web page, and this parser extracts the relevant information from the web page, like a crawler.

Installation

To install SR Invoice Parser, follow these steps:

pip install sr-invoice-parser

Usage

The InvoiceParser class is the entry point for using the parser.

Methods

  • get_data() - Extracts all the data from the invoice and returns it as a dictionary
  • get_company_name() - Extracts the company name.
  • get_company_tin() - Extracts the company's tax identification number/PFR.
  • get_buyer_tin() - Extracts the buyer's tax identification number/PFR.
  • get_total_amount() - Extracts the total amount of the invoice.
  • get_dt() - Extracts the date and time of the invoice and converts it to UTC as a datetime object.
  • get_invoice_number() - Extracts the invoice number.
  • get_invoice_text() - Extracts the full text of the invoice with QR code base64.
  • get_items() - Extracts items details from the invoice. This is array of dictionaries with keys: name, quantity, price, total_price.

Here's a basic example of how to use it:

from sr_invoice_parser import InvoiceParser

parser = InvoiceParser(url="https://suf.purs.gov.rs/v/?vl=...")
# or
parser = InvoiceParser(html_text="<HTML source code of invoice web page>")

parser.data()

parser.get_company_name()
parser.get_company_tin()
parser.get_buyer_tin()
parser.get_total_amount()
parser.get_dt()
parser.get_invoice_number()
parser.get_invoice_text()
parser.get_items()

Example response data

{
    "company_name": "Company Name",
    "company_tin": "123456789",
    "buyer_tin": "987654321",
    "invoice_number": "QWERTYU1-QWERTYU1-12345",
    "invoice_datetime": datetime.datetime(2021, 1, 1, 0, 0, tzinfo=datetime.timezone.utc),
    "invoice_total_amount": 123.45,
    "invoice_text": "============ ФИСКАЛНИ РАЧУН ============.....",
    "invoice_items": [
        {
            "name": "Item 1",
            "quantity": 1,
            "price": 123.45,
            "total_price": 123.45
        }
    ]
}

Check the test_parser.py file for more examples.

Handling Exceptions

The module has custom exceptions for handling various error scenarios:

  • ParserParseException - Raised when any error occurs during parsing the HTML content.
  • ParserRequestException - Raised for errors related to fetching HTML content.

Package Dependencies

Thanks to the following packages:

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

If you have any questions, please contact us via email: hello@innovigo.co

License

This project is licensed under the MIT License.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

sr_invoice_parser-1.0.1.tar.gz (4.8 kB view details)

Uploaded Source

Built Distribution

sr_invoice_parser-1.0.1-py3-none-any.whl (5.9 kB view details)

Uploaded Python 3

File details

Details for the file sr_invoice_parser-1.0.1.tar.gz.

File metadata

  • Download URL: sr_invoice_parser-1.0.1.tar.gz
  • Upload date:
  • Size: 4.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.0 CPython/3.11.3

File hashes

Hashes for sr_invoice_parser-1.0.1.tar.gz
Algorithm Hash digest
SHA256 c36bf85edff1ec5ace3ccb6f47959f3ff5f815a73a0099607949f5429244c6e2
MD5 7e3c9f2efc5f5894b3f9b82a5577862e
BLAKE2b-256 6692726dc939a2c1b7fd08588df77d75c128e5059955ea96732c5129af21ba6e

See more details on using hashes here.

File details

Details for the file sr_invoice_parser-1.0.1-py3-none-any.whl.

File metadata

File hashes

Hashes for sr_invoice_parser-1.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 ca46f7eac0ee48330e6d3351280f96601608df4c7b779bec0629acc3d76ad091
MD5 717baa8ac0e2b7ce35a9ae8954fe6063
BLAKE2b-256 2de196846fffab8914d7f0d607289726e49b6b5b8c479c29552b5fd49d7d0ee9

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page