furs_fiscal_verification 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 6756121600fe215b234975a303e2ef15e9386dcb
+  data.tar.gz: d4c4233733cf7b30ba1ce5a4e59df0b02170120c
+SHA512:
+  metadata.gz: 46a0aab60b40469c92bd9ddd4bf7c574e101810045071784446c00b7b4905a09425aacca6a96f5ea92cda69b05b5679389111e1d6a15194622b26bbe510d47b7
+  data.tar.gz: 36473595db94c5d4c1c28dd0d56cc184fec2a15e06830f98e3b7d0571fd3817467af5b5f49bcd2648c20ea06be400d280a89e85d31d47b31cb96eac45b10f763

data/.gitignore

@@ -0,0 +1,9 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/

data/Gemfile

@@ -0,0 +1,6 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in furs_fiscal_verification.gemspec
+gemspec
+
+gem 'jwt'

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2016 Matic Jurglic
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,129 @@
+# Ruby library for fiscal invoice verification in Republic of Slovenia (Ruby koda za davčno potrjevanje računov)
+
+**DISCLAIMER**: This code was not  tested in production yet and I can not guarantee it's completely conformed to FURS's technical specification. Test cases described below have been tested in the FURS sandbox environment. The code is a Ruby port of  [python-furs-fiscal](https://github.com/boris-savic/python-furs-fiscal), which is offering more info on the topic. See also [official documentation](http://www.datoteke.fu.gov.si/dpr/files/TehnicnaDokumentacijaVer1.6.pdf). Pull requests are most welcome. 
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'furs_fiscal_verification'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install furs_fiscal_verification
+
+## Usage
+
+# Initialize the client
+
+```ruby
+furs = Furs.new(cert_path: "/path/to/your-certificate.p12", cert_password: "SCREWFURS")
+```
+
+*You can pass either sandbox or production certificate*
+
+# Register an immovable business premise
+
+```ruby
+response = furs.register_immovable_business_premise(
+  tax_number: 10115609, 
+  premise_id: 'BP105', 
+  real_estate_cadastral_number: 112, 
+  real_estate_building_number: 11, 
+  real_estate_building_section_number: 1, 
+  street: 'Trzaska cesta', 
+  house_number: '24', 
+  house_number_additional: 'A', 
+  community: 'Ljubljana', 
+  city: 'Ljubljana', 
+  postal_code: '1000', 
+  validity_date: Date.today, 
+  software_supplier_tax_number: 24564444, 
+  foreign_software_supplier_name: 'Neki')
+```
+
+If response is OK and withour errors, you should receive this response:
+
+`#<Net::HTTPOK 200 OK readbody=true>`
+
+In case there is data/parameters missing (or they are of wrong type - be careful about integer and string parameters), you may get this:
+
+`#<Net::HTTPOK 200 VAT error readbody=true>`
+
+To see the error, you need to decode the response:
+
+```ruby
+JSON.parse(Base64.urlsafe_decode64(response.body.split('.')[1]))
+=> {"BusinessPremiseResponse"=>{"Header"=>{"MessageID"=>"b7b1e98f-dcae-47af-b829-3237802a2688", "DateTime"=>"2016-07-27T23:15:05"}, "Error"=>{"ErrorCode"=>"S002", "ErrorMessage"=>"Sporočilo ni v skladu s shemo JSON"}}}
+```
+
+# Invoice verification
+
+Prepare your invoice data and calculate ZOI code:
+
+```
+zoi = furs.calculate_zoi(
+        tax_number: 10115609, 
+        issued_date: Date.today, 
+        invoice_number: '11', 
+        business_premise_id: 'BP105', 
+        electronic_device_id: '0001', 
+        invoice_amount: 19.15)
+ 
+ => "51a40dcabb147d1c76d843ee98f951aa"
+```
+
+Now that we got this ZOI code, we send it together with other stuff to FURS and get back the response that contains EOR (unique invoice code):
+
+```ruby
+response = furs.report_invoice(
+            zoi: zoi, 
+            tax_number: 10115609, 
+            issued_date: Date.today,
+            invoice_number: '11', 
+            business_premise_id: 'BP105', 
+            electronic_device_id: '0001', 
+            invoice_amount: 19.15, 
+            low_tax_rate_base: 35.14, 
+            low_tax_rate_amount: 3.34, 
+            high_tax_rate_base: 23.14, 
+            high_tax_rate_amount: 5.09)
+```
+
+If everything goes OK, we can extract the EOR code like so:
+
+```ruby
+eor = JSON.parse(Base64.decode64(response.body.split('.')[1]))["InvoiceResponse"]["UniqueInvoiceID"]
+ => "dedc5383-169f-4c0e-b369-d64ec8797170"
+```
+
+Now we have ZOI and EOR code. We need to print both to our invoice. We also need to print a QR code. The code that we use to generate the QR code is generated like this:
+
+```ruby
+furs.prepare_printable(invoice_number, zoi, issued_date)
+=> "108519284076690038963265761078884782506111607270000000"
+```
+
+Use the latter for input to your QR rendering library.
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/matixmatix/furs_fiscal_verification.
+
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).
+

data/Rakefile

@@ -0,0 +1,2 @@
+require "bundler/gem_tasks"
+task :default => :spec

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "furs_fiscal_verification"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/furs_fiscal_verification.gemspec

@@ -0,0 +1,23 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'furs_fiscal_verification/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "furs_fiscal_verification"
+  spec.version       = FursFiscalVerification::VERSION
+  spec.authors       = ["Matic Jurglic"]
+  spec.email         = ["matic@jurglic.si"]
+
+  spec.summary       = "Fiscal verification of invoices (davčno potrjevanje računov)"
+  spec.homepage      = "http://codeandtechno.com"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.11"
+  spec.add_development_dependency "rake", "~> 10.0"
+end

data/lib/furs_fiscal_verification.rb

@@ -0,0 +1,270 @@
+require "furs_fiscal_verification/version"
+require 'uri'
+require 'net/http'
+require 'net/https'
+require 'digest'
+require 'jwt'
+require 'openssl'
+
+class Furs
+  FURS_TEST_ENDPOINT = 'https://blagajne-test.fu.gov.si:9002'
+  FURS_PRODUCTION_ENDPOINT = 'https://blagajne.fu.gov.si:9003'
+
+  REGISTER_BUSINESS_UNIT_PATH = '/v1/cash_registers/invoices/register'
+  INVOICE_ISSUE_PATH = '/v1/cash_registers/invoices'
+
+  LOW_TAX_RATE = 9.5
+  HIGH_TAX_RATE = 22
+
+  def initialize(cert_path:, cert_password:, production: false)
+    @cert = OpenSSL::PKCS12.new(File.read(cert_path), cert_password)
+    @endpoint = production ? FURS_PRODUCTION_ENDPOINT : FURS_TEST_ENDPOINT
+  end
+
+  def furs_accessible?(msg: 'ping')
+    data = { 'EchoRequest' => msg }
+    response = _post(data: data, path: "/v1/cash_registers/echo", sign: false)
+    JSON.parse(response.body)["EchoResponse"] == msg
+  end
+
+  def calculate_zoi(tax_number:, issued_date:, invoice_number:, business_premise_id:, electronic_device_id:,
+                    invoice_amount:)
+    content = "#{tax_number}#{issued_date.strftime('%d-%m-%Y %H:%M:%S')}#{invoice_number}#{business_premise_id}
+               #{electronic_device_id}#{invoice_amount}"
+
+    Digest::MD5.hexdigest(_sign(content))
+  end
+
+  def report_invoice(zoi:,
+                     tax_number:,
+                     issued_date:,
+                     invoice_number:,
+                     business_premise_id:,
+                     electronic_device_id:,
+                     invoice_amount:,
+                     low_tax_rate_base: nil,
+                     low_tax_rate_amount: nil,
+                     high_tax_rate_base: nil,
+                     high_tax_rate_amount: nil,
+                     other_taxes_amount: nil,
+                     exempt_vat_taxable_amount: nil,
+                     reverse_vat_taxable_amount: nil,
+                     non_taxable_amount: nil,
+                     special_tax_rules_amount: nil,
+                     payment_amount: nil,
+                     customer_vat_number: nil,
+                     returns_amount: nil,
+                     operator_tax_number: nil,
+                     foreign_operator: nil,
+                     subsequent_submit: nil,
+                     reference_invoice_number: nil,
+                     reference_invoice_business_premise_id: nil,
+                     reference_invoice_electronic_device_id: nil,
+                     reference_invoice_issued_date: nil,
+                     numbering_structure: 'B',
+                     special_notes: '')
+
+    data = {}
+    data['InvoiceRequest'] = {
+      "Header" => {
+        "MessageID" => SecureRandom.uuid,
+        "DateTime" => DateTime.now.strftime("%Y-%m-%dT%H:%M:%SZ")
+      },
+      'Invoice' => {
+        'TaxNumber' => tax_number.to_i,
+        'IssueDateTime' => issued_date.strftime("%Y-%m-%dT%H:%M:%SZ"),
+        'NumberingStructure' => numbering_structure,
+        'InvoiceIdentifier' => {
+          'BusinessPremiseID' => business_premise_id,
+          'ElectronicDeviceID' => electronic_device_id,
+          'InvoiceNumber' => invoice_number
+        },
+        'InvoiceAmount' => invoice_amount,
+        'PaymentAmount' => if payment_amount then payment_amount else invoice_amount end,
+        'ProtectedID' => zoi,
+        'TaxesPerSeller' => []
+      }
+    }
+
+    tax_spec = {}
+    if low_tax_rate_base || high_tax_rate_base
+      tax_spec['VAT'] = _build_tax_specification(
+        low_tax_rate_base,
+        low_tax_rate_amount,
+        high_tax_rate_base,
+        high_tax_rate_amount)
+    end
+
+    tax_spec['NontaxableAmount'] = non_taxable_amount if non_taxable_amount
+
+    if reverse_vat_taxable_amount
+      tax_spec['ReverseVATTaxableAmount'] = reverse_vat_taxable_amount
+    end
+
+    if exempt_vat_taxable_amount
+      tax_spec['ExemptVATTaxableAmount'] = exempt_vat_taxable_amount
+    end
+
+    tax_spec['OtherTaxesAmount'] = other_taxes_amount if other_taxes_amount
+
+    data['InvoiceRequest']['Invoice']['TaxesPerSeller'] << tax_spec
+
+    if customer_vat_number
+      data['InvoiceRequest']['Invoice']['CustomerVATNumber'] = customer_vat_number
+    end
+
+    if returns_amount
+      data['InvoiceRequest']['Invoice']['ReturnsAmount'] = returns_amount
+    end
+
+    if operator_tax_number
+      data['InvoiceRequest']['Invoice']['OperatorTaxNumber'] = operator_tax_number
+    end
+
+    if foreign_operator
+      data['InvoiceRequest']['Invoice']['ForeignOperator'] = true
+    end
+
+    if subsequent_submit
+      data['InvoiceRequest']['Invoice']['SubsequentSubmit'] = true
+    end
+
+    if reference_invoice_number
+      reference_invoice = [{
+        'ReferenceInvoiceIdentifier' => {
+          'BusinessPremiseID' => reference_invoice_business_premise_id,
+          'ElectronicDeviceID' => reference_invoice_electronic_device_id,
+          'InvoiceNumber' => reference_invoice_number
+        },
+        'ReferenceInvoiceIssueDateTime' => reference_invoice_issued_date.strftime("%Y-%m-%dT%H:%M:%SZ")
+      }]
+
+      data['InvoiceRequest']['Invoice']['ReferenceInvoice'] = reference_invoice
+    end
+
+    _post(path: INVOICE_ISSUE_PATH, data: data)
+  end
+
+  def _build_tax_specification(low_tax_rate_base,
+                               low_tax_rate_amount,
+                               high_tax_rate_base,
+                               high_tax_rate_amount)
+    low_tax_spec = {
+      'TaxRate' => LOW_TAX_RATE,
+      'TaxableAmount' => low_tax_rate_base,
+      'TaxAmount' => low_tax_rate_amount
+    }
+
+    high_tax_spec = {
+      'TaxRate' => HIGH_TAX_RATE,
+      'TaxableAmount' => high_tax_rate_base,
+      'TaxAmount' => high_tax_rate_amount
+    }
+
+    [low_tax_spec, high_tax_spec].select { |spec| !spec['TaxableAmount'].nil? }
+  end
+
+  def register_immovable_business_premise(tax_number:,
+                                          premise_id:,
+                                          real_estate_cadastral_number:,
+                                          real_estate_building_number:,
+                                          real_estate_building_section_number:,
+                                          street:,
+                                          house_number:,
+                                          house_number_additional:,
+                                          community:,
+                                          city:,
+                                          postal_code:,
+                                          validity_date:,
+                                          software_supplier_tax_number: nil,
+                                          foreign_software_supplier_name: nil,
+                                          special_notes: 'No notes')
+
+    data = {
+      "BusinessPremiseRequest" => {
+        "Header" => {
+          "MessageID" => SecureRandom.uuid,
+          "DateTime" => DateTime.now.strftime("%Y-%m-%dT%H:%M:%SZ")
+        },
+        "BusinessPremise" => {
+          "TaxNumber" => tax_number.to_i,
+          "BusinessPremiseID" => premise_id,
+          "BPIdentifier" => {
+            "RealEstateBP" => {
+              "PropertyID" => {
+                "CadastralNumber" => real_estate_cadastral_number.to_i,
+                "BuildingNumber" => real_estate_building_number.to_i,
+                "BuildingSectionNumber" => real_estate_building_section_number.to_i
+              },
+              "Address" => {
+                "Street" => street,
+                "HouseNumber" => house_number.to_s,
+                "HouseNumberAdditional" => house_number_additional,
+                "Community" => community,
+                "City" => city,
+                "PostalCode" => postal_code.to_s
+              }
+            }
+          },
+          "ValidityDate" => validity_date.strftime("%Y-%m-%d"),
+          "SoftwareSupplier" => [
+            {
+              "NameForeign" => foreign_software_supplier_name
+            }
+          ],
+          "SpecialNotes" => special_notes
+        }
+      }
+    }
+
+    _post(path: REGISTER_BUSINESS_UNIT_PATH, data: data)
+  end
+
+  def prepare_printable(tax_number, zoi, issued_date)
+    formatted_date = issued_date.strftime('%y%m%d%H%M%S')
+    zoi_base_10 = zoi.hex.to_s(10).rjust(39, '0')
+    data = "#{zoi_base_10}#{tax_number}#{formatted_date}"
+    control = data.chars.map(&:to_i).inject(:+) % 10
+    "#{data}#{control}"
+  end
+
+  private
+  def _post(path:, data:, sign: true)
+    if sign
+      data = {
+        'token' => _jwt_sign(header: _jws_header, payload: data)
+      }
+    end
+
+    url = "#{@endpoint}#{path}"
+    uri = URI(url)
+    https = Net::HTTP.new(uri.host, uri.port)
+    https.use_ssl = true
+    https.open_timeout = 60
+    https.read_timeout = 60
+    https.verify_mode = OpenSSL::SSL::VERIFY_NONE # should probably verify...
+    https.cert = @cert.certificate
+    https.key = @cert.key
+    req = Net::HTTP::Post.new(uri.path, 'Content-Type' => 'application/json; charset=UTF-8')
+    https.request(req, data.to_json)
+  end
+
+  def _jws_header
+    {
+      'alg' => 'RS256',
+      'subject_name' => @cert.certificate.subject.to_a.map { |subject| "#{subject[0]}=#{subject[1]}" }.join(","),
+      'issuer_name' => @cert.certificate.issuer.to_a.map { |subject| "#{subject[0]}=#{subject[1]}" }.join(","),
+      'serial' => @cert.certificate.serial.to_i
+    }
+  end
+
+  def _jwt_sign(header:, payload:)
+    private_key = @cert.key
+    JWT.encode(payload, private_key, 'RS256', header)
+  end
+
+  def _sign(content)
+    digest = OpenSSL::Digest::SHA256.new
+    @cert.key.sign(digest, content)
+  end
+end

data/lib/furs_fiscal_verification/version.rb

@@ -0,0 +1,3 @@
+module FursFiscalVerification
+  VERSION = "0.1.0"
+end

metadata

@@ -0,0 +1,83 @@
+--- !ruby/object:Gem::Specification
+name: furs_fiscal_verification
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Matic Jurglic
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2016-07-27 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.11'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.11'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+description: 
+email:
+- matic@jurglic.si
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- furs_fiscal_verification.gemspec
+- lib/furs_fiscal_verification.rb
+- lib/furs_fiscal_verification/version.rb
+homepage: http://codeandtechno.com
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.8
+signing_key: 
+specification_version: 4
+summary: Fiscal verification of invoices (davčno potrjevanje računov)
+test_files: []
+has_rdoc: