It generates PDF files for Brazilian DANFE (Documento Auxiliar da Nota Fiscal Eletrônica) from a valid NF-e XML.
It also generates Brazilian DACTE (Documento Auxiliar do Conhecimento de Transporte Eletrônico).
This project is inspired on NFePHP class.
gem install ruby_danfe
If you have the xml saved in a file:
require "ruby_danfe"
RubyDanfe.generate("sample.pdf", "sample.xml")
If you have the xml in a variable:
xml = RubyDanfe::XML.new(my_xml_string)
pdf = RubyDanfe.generatePDF(xml)
pdf.render_file "output.pdf"
You can install all necessaries dependencies using bunder like above:
$ bundle install
At test
folder you will find the generate.rb
file. It shows how to generate a pdf file from a valid xml.
You can use it following the steps above:
$ cd test
$ ruby generate.rb nfe_with_ns.xml
You can also use an special version of irb with all classes pre-loaded. Just use:
$ rake console
RubyDanfe.generate("output.pdf", "test/nfe_with_ns.xml")
or
$ rake console
my_xml_string = ""
file = File.new("test/nfe_with_ns.xml", "r")
while (line = file.gets)
my_xml_string = my_xml_string + line
end
file.close
xml = RubyDanfe::XML.new(my_xml_string)
pdf = RubyDanfe.generatePDF(xml)
pdf.render_file "output.pdf"
You can run all specs using:
$ rspec
In the spec/fixtures
folder, you are going to find some xml files. Each one represent a different NF-e context.
Each xml file must have its respective pdf file.
If you did some change that caused general visual changes at output pdfs, so you have to rebuild all fixtures pdf files.
You can do this automagically running the following taks:
$ rake spec:fixtures:recreate_pdfs
Code coverage is available through of SimpleCov. Just run rspec
and open the coverage report in your browser.
You can build using one of the above tasks
$ rake build # Build ruby_danfe-X.X.X.gem into the pkg directory
$ rake install # Build and install ruby_danfe-X.X.X.gem into system gems
$ rake release # Create tag vX.X.X and build and push ruby_danfe-X.X.X.gem to Rubygems
We encourage you to contribute to Ruby DANFE!
- Fork it
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Add some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create new Pull Request
Ruby DANFE is released under the MIT License.