aktywnitu / python-ifirma

Simple python wrapper for iFirma API

python-ifirma (in progress)

Extremely simple wrapper for iFirma API.

##Features

Implemented

• generating invoice in iFirma service
• downloading invoice PDF

Very soon

• generating proforma invoice
• generating invoice based on proforma

##Prerequisites

Go to your iFirma account and generate API keys of following types:

• faktura (required)
• abonent (optional)

Testing

iFirma offers demo account that can be used for testing and development

##Installation

Just add following line to your requirements.txt and let pip do rest of the work

-e -e git+git://github.com/DariuszAniszewski/python-ifirma.git#egg=python-ifirma

##Usage

#####1. Create instance of iFirmaAPI

ifirma_client = iFirmaAPI(TEST_IFIRMA_USER, TEST_IFIRMA_INVOICE_KEY, TEST_IFIRMA_USER_KEY)

#####2. Create invoice parameters

client = Client(
    "Dariusz Aniszewski's Company",  # company name
    "PL1231231212",  # Tax ID
    Address(
        "Otwock",  # City
        "00-000"  # Zip code
    ),
    email="[email protected]",
)

position = Position(
    VAT.VAT_23,  # VAT rate 
    1,  # Quantity
    1000.00,  # Unit total price
    "nazwa",  # Position name
    "szt"  # Position unit
)

#####3. Create invoice in iFirma service and get it's id and number

invoice = NewInvoiceParams(client, [position])
invoice_id, invoice_number = ifirma_client.generate_invoice(invoice)

#####4. Download invoice PDF In order to get PDF file with created invoice use get_invoice_pdf(invoice_id) method. It will return file handler.

pdf_file_obj = ifirma_client.get_invoice_pdf(invoice_id)

That's all folks