Giter VIP home page Giter VIP logo

afip_bill's Introduction

AfipBill

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

Installation

Include the gem in your Gemfile:

gem 'afip_bill'

Setup

In order to have the bills fully complete, you will need to setup some configuration about your business. You can put all of it inside a config/initializers/afip_bill.rb if you want:

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 with Bravo gem.

Usage

There are three important classes that you need to use. Those are: 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 accepts four params: Company name, Owner name, Address, and Tax category. So, you should do something like this:

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 accepts three params: 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 is the main class. Here you will generate the PDF bill. It accepts three params: the json bill, the user, and the array of line items

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

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

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

Demo

This is a sample of one of the PDFs generated with this gem:

bill_sample.pdf

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.

afip_bill's People

Contributors

lubc avatar etagwerker avatar

Watchers

 avatar Matias Montoto 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.