A small library to generate a bill's PDF
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
lib
spec
.gitignore
.rspec
.travis.yml
Gemfile
Gemfile.lock
LICENSE.txt
README.md
Rakefile
afip_bill.gemspec
bill_sample.pdf

README.md

AfipBill

AfipBill allows you to generate an AFIP bill in PDF format.

The end result will look like this: bill_sample.pdf

Installation

Include the gem in your Gemfile

gem 'afip_bill'

Install it

$ bundle install

Setup

In order to have the bills fully complete, you will need to setup some configuration about your business. If you're in a Rails application you can place that in config/initializers/afip_bill.rb

AfipBill.configuration[:header_business_name] = "Company Name"
AfipBill.configuration[:business_name] = "CompanyName SRL"
AfipBill.configuration[:business_address] = "Address 1234"
AfipBill.configuration[:business_start_date] = "01/01/2016"
AfipBill.configuration[:business_cuit] = "1234567890"
AfipBill.configuration[:city] = "Ciudad de Buenos Aires"
AfipBill.configuration[:ingresos_brutos] = "123-456789-0"
AfipBill.configuration[:iva] = "IVA Responsable Inscripto"
AfipBill.configuration[:sale_point] = "0001"

Also, one of the main things that you need to have, is a JSON for each of your bills. It must contain at least these attributes:

json_bill = {
  cae: "1234567890123",       # CAE number
  doc_num: "12345678901",     # CUIT number
  cbte_tipo: "01",            # Bill type (01 = A, 06 = B)
  cbte_fch: "20170125",       # Bill date
  imp_neto: 220.0,            # Net amount
  imp_iva: 46.2,              # IVA amount
  imp_total: 266.2,           # Total amount
  cbte_hasta: 1,              # Voucher number
  fch_serv_desde: "20170101", # Invoiced from
  fch_serv_hasta: "20170131", # Invoiced to
  fch_vto_pago: "20170115"    # CAE expiration date
}.to_json

In OmbuShop, we like to automatically generate this JSON using Bravo.

Usage

There are three important classes that you need to use: AfipBill::User, AfipBill::LineItem and AfipBill::Generator.

AfipBill::User

You should create a new instance of this class to provide some information about the bill. It receives four parameters: Company name, Owner name, Address, and Tax category.

user = AfipBill::User.new("Bill company name",
                          "Bill owner name",
                          "Bill address",
                          "Bill tax category")

AfipBill::LineItem

With this class you can define the line items for your bill. It receives three parameters: Name, Quantity, and Unit amount.

item_1 = AfipBill::LineItem.new("Item 1", 1, 100)
item_2 = AfipBill::LineItem.new("Item 2", 1, 120)
...

AfipBill::Generator

This class will generate the PDF bill. It receives three parameters: the json bill, the user, and the array of line items (all the parameters were defined above)

generator = AfipBill::Generator.new(json_bill, user, [item_1, item_2])

And finally you can render the PDF by using the generate_pdf_string method

generator.generate_pdf_string

Or if you're in a Rails app you can render it like this:

respond_to do |format|
  format.pdf { render text: generator.generate_pdf_string }
end

Special Thanks

AfipBill was inspired in code by nubis and gastonconcilio.

Initial development of this gem was sponsored by OmbuShop.

Thank you!

License

The gem is available as open source under the terms of the MIT License.