acube-rails 0.0.4

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: efa4cde8156a62daa4d25ae2da27e6f71be7b5ed36b27f97ad77fc3a0d961e1a
+  data.tar.gz: 262a5d9937aff89409b5d5c20093ed63bc81016db16c1eb4909cf3be5a6e6d4f
+SHA512:
+  metadata.gz: 6c204b4482d57e1acf2be4ed401d5f91e122aea8e541de4f9d40a6061604fb61666871c64a51bf483c8a44a3b8cb29244f83c999aa35dc93094e4407ad8ba6cf
+  data.tar.gz: 273f3cf9e669898581b5083ed102344248e5f30b421bf33131edf8684328cd5b8c10ae560e994e39303612abd1c6fb69d0bd357316d8ff31327191b6b8c1412a

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright 2023 Pietro Moro
+
+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,93 @@
+# ACube API - Rails [WIP]
+Wrapper library around the ACube API for ruby on rails. Quickly set up resources to manage invoices.
+
+## Usage
+This will copy over the initializer file to your rails application and the necessary migrations:
+```
+$ bin/rails g a_cube:install
+```
+
+In the initializer file you have to set at the very least the following:
+```ruby
+config.username = "your-login-email"
+config.password = "your-login-password"
+
+config.invoice_endpoint = ENV.fetch('ACUBE_INVOICE_ENDPOINT', "https://api-sandbox.acubeapi.com")
+config.common_endpoint = ENV.fetch('ACUBE_COMMON_ENDPOINT', "https://common-sandbox.api.acubeapi.com")
+```
+
+For a complete list of configuration options, see the initializer file.  
+You have to designate two models to be used that will serve as the supplier/consumer contacts.
+These will take care of the mapping between your application and the ACube API.
+```ruby
+include ACube::Support::Supplier
+
+as_supplier do |s|
+  s.first_name = "..."
+  s.last_name = :last_name
+end
+```
+String means constant value, symbol means method name on the model that will get called when the invoice is created.
+
+```ruby
+include ACube::Support::Consumer
+
+as_custoemr do |c|
+  c.first_name = "..."
+  c.last_name = :last_name
+end
+```
+For a full list of supported attributes, see the relevant file.
+
+The last model is the one that will be associated with the invoices, so the payment model per say.
+```ruby
+class Payment < ApplicationRecord
+  has_one_invoice :invoice
+
+  as_transaction do |t|
+    t.amount = :amount
+    t.currency = "EUR"
+    t.payment_date = :created_at
+  end
+end
+```
+The `has_one_invoice` method will create the association between the payment and the invoice.
+The `as_transaction` method will create the mapping between the payment and the invoice.
+
+The last step is to actually publish the invoice to the ACube API.
+```ruby
+# In your controller somewhere
+def create
+  @payment = Payment.new(payment_params)
+  supplier = Supplier.new(...)
+  consumer = Consumer.new(...)
+
+  if @payment.save
+    @payment.publish_invoice(supplier, consumer, :FPR12)
+    # ...
+  end
+end
+```
+
+## Installation
+Add this line to your application's Gemfile:
+
+```ruby
+gem "acube-rails", require: "acube"
+```
+
+And then execute:
+```bash
+$ bundle
+```
+
+Or install it yourself as:
+```bash
+$ gem install acube-rails
+```
+
+## Contributing
+Contribution directions go here.
+
+## License
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,3 @@
+require "bundler/setup"
+
+require "bundler/gem_tasks"

data/app/models/acube/invoice_record.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module ACube
+  class InvoiceRecord < ACube.invoice_base_class.constantize
+    self.table_name = 'acube_invoice_records'
+
+    belongs_to :record, polymorphic: true, touch: true
+    has_one_attached :pdf
+
+    enum format: %i[ FPA12 FPR12 ]
+    enum kind: %i[ TD01 TD02 TD03 TD04 TD05 TD06 TD16 TD17 TD18 TD19 TD20 TD21 TD22 TD23 TD24 TD25 TD26 TD27 TD28 ]
+
+    enum status: { notification_error: -4, download_error: -3, creation_error: -2, error: -1, created: 0, sent: 1, downloaded: 2, not_received: 3, rejected: 4, delivered: 5 }
+  end
+end
+
+ActiveSupport.run_load_hooks :acube_invoice_record, ACube::InvoiceRecord

data/app/models/acube/record.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module ACube
+  class Record < ActiveRecord::Base # :nodoc:
+    self.abstract_class = true
+  end
+end
+
+ActiveSupport.run_load_hooks :acube_record, ACube::Record

data/config/application.rb

@@ -0,0 +1,9 @@
+Rails.autoloaders.each do |autoloader|
+  autoloader.inflector.inflect(
+    'acube' => 'ACube'
+  )
+end
+
+ActiveSupport::Inflector.inflections(:en) do |inflect|
+  inflect.acronym "ACube"
+end

data/config/initializers/zeitwerk.rb

@@ -0,0 +1,7 @@
+# config/initializers/zeitwerk.rb
+
+Rails.autoloaders.each do |autoloader|
+  autoloader.inflector.inflect(
+    'acube' => 'ACube'
+  )
+end

data/config/routes.rb

@@ -0,0 +1,2 @@
+ACube::Engine.routes.draw do
+end

data/db/migrate/20230624195146_create_acube_invoice_records.rb

@@ -0,0 +1,46 @@
+class CreateACubeInvoiceRecords < ActiveRecord::Migration[7.0]
+  def up
+    if connection.adapter_name.downcase != 'postgresql'
+      raise "This migration is only compatible with PostgreSQL at the moment."
+    end
+
+    primary_key_type, foreign_key_type = primary_and_foreign_key_types
+
+    create_table :acube_invoice_records, id: primary_key_type do |t|
+      t.references :record, null: false, polymorphic: true, index: false, type: foreign_key_type
+
+      t.string :name, null: false
+      t.string :webhook_uuid
+      t.integer :status, null: false, default: 0
+      t.integer :format, null: false
+      t.integer :kind, null: false
+      t.string :progressive, null: false
+      t.text :json_body, size: :long
+      t.text :xml_body, size: :long
+
+      t.timestamps
+
+      t.index [ :record_type, :record_id, :name ], name: "index_acube_rails_acube_invoice_records_uniqueness", unique: true
+      t.index :progressive, unique: true
+      t.index :webhook_uuid, unique: true
+    end
+
+    execute <<-SQL
+      CREATE SEQUENCE acube_invoice_records_progressive_seq START 1 INCREMENT 1 OWNED BY acube_invoice_records.progressive;
+    SQL
+  end
+  
+  def down
+    drop_table :acube_invoice_records
+    execute "DROP SEQUENCE IF EXISTS acube_invoice_records_progressive_seq;"
+  end
+
+private
+  def primary_and_foreign_key_types
+    config = Rails.configuration.generators
+    setting = config.options[config.orm][:primary_key_type]
+    primary_key_type = setting || :primary_key
+    foreign_key_type = setting || :bigint
+    [primary_key_type, foreign_key_type]
+  end
+end

data/lib/acube/attribute.rb

@@ -0,0 +1,35 @@
+module ACube
+  module Attribute
+    extend ActiveSupport::Concern
+
+    class_methods do
+      def has_one_invoice(name, strict_loading: strict_loading_by_default)
+        class_eval <<-CODE, __FILE__, __LINE__ + 1
+          def #{name}
+            invoice_record_#{name} || build_invoice_record_#{name}
+          end
+
+          def publish_#{name}!(supplier, customer, format)
+            builder = ACube::Invoicer.from(supplier: supplier, customer: customer, invoice: self, format: format)
+            builder.create_invoice(self, "#{name}")
+          end
+
+          def #{name}?
+            invoice_record_#{name}.present?
+          end
+        CODE
+        
+        include ACube::Support::Transaction
+        has_one :"invoice_record_#{name}", -> { where(name: name) }, class_name: 'ACube::InvoiceRecord', as: :record, inverse_of: :record, autosave: true, dependent: :destroy, strict_loading: strict_loading
+      end
+
+      def with_all_invoice_records
+        eager_load(invoice_record_association_names)
+      end
+
+      def invoice_record_association_names
+        reflect_on_all_associations(:has_one).collect(&:name).select { |n| n.start_with?("invoice_record_") }
+      end
+    end
+  end
+end

data/lib/acube/endpoint/auth.rb

@@ -0,0 +1,33 @@
+module ACube
+  module Endpoint
+    class Auth < CommonBase
+      def login
+        response = connection.post do |req|
+          req.url "/login"
+          req.body = {
+            email: ACube.username,
+            password: ACube.password
+          }.to_json
+        end
+
+        if response.success?
+          token = JSON.parse(response.body)["token"]
+          Rails.cache.write(ACube.auth_token_cache_key, token, expires_in: 20.hours)
+          return token
+        else
+          raise "Login failed: #{response.body} -- #{response.inspect}"
+        end
+      end
+
+      def logout
+        Rails.cache.delete(ACube.auth_token_cache_key)
+      end
+
+      def token!
+        Rails.cache.fetch(ACube.auth_token_cache_key) do
+          login
+        end
+      end
+    end
+  end
+end

data/lib/acube/endpoint/common_base.rb

@@ -0,0 +1,16 @@
+require 'faraday'
+
+module ACube
+  module Endpoint
+    class CommonBase
+      attr_reader :connection
+
+      def initialize
+        @connection = Faraday.new(
+          url: ACube.common_endpoint,
+          headers: {'Content-Type' => 'application/json'}
+        )
+      end
+    end
+  end
+end

data/lib/acube/endpoint/invoices.rb

@@ -0,0 +1,32 @@
+module ACube
+  module Endpoint
+    class Invoices < ItApiBase
+      def create(invoice_xml)
+        response = connection.post do |req|
+          req.url "/invoices"
+          req.body = invoice_xml
+        end
+
+        if response.success?
+          return JSON.parse(response.body)["uuid"]
+        else
+          raise "Invoice creation failed: #{response.body} -- #{response.inspect} "
+        end
+      end
+
+      def download(uuid)
+        response = connection.get do |req|
+          req.url "/invoices/#{uuid}"
+          req.headers['Content-Type'] = 'application/pdf'
+          req.headers['X-PrintTheme'] = ACube.invoice_print_theme || 'standard'
+        end
+
+        if response.success?
+          return StringIO.new(response.body)
+        else
+          raise "Invoice download failed: #{response.body} -- #{response.inspect}"
+        end
+      end
+    end
+  end
+end

data/lib/acube/endpoint/it_api_base.rb

@@ -0,0 +1,20 @@
+require 'faraday'
+
+module ACube
+  module Endpoint
+    class ItApiBase
+      attr_reader :connection
+
+      def initialize
+        @connection = Faraday.new(
+          url: ACube.invoice_endpoint,
+          headers: {
+            'Content-Type' => 'application/xml',
+            'Authorization' => 'Bearer ' + ACube::Endpoint::Auth.new.token!,
+            'X-SendAsync' => 'true'
+          }
+        )
+      end
+    end
+  end
+end

data/lib/acube/engine.rb

@@ -0,0 +1,22 @@
+require "rails"
+require "active_record/railtie"
+require "action_controller/railtie"
+require "active_storage/engine"
+
+require "acube"
+
+module ACube
+  class Engine < ::Rails::Engine
+    isolate_namespace ACube
+    config.eager_load_namespaces << ACube
+    engine_name "acube"
+
+    config.autoload_paths << "#{root}/app/models"
+
+    initializer "acube.attribute" do
+      ActiveSupport.on_load(:active_record) do
+        include ACube::Attribute
+      end
+    end
+  end
+end

data/lib/acube/invoicer.rb

@@ -0,0 +1,116 @@
+module ACube
+  class Invoicer
+    attr_accessor :supplier, :customer, :invoice
+    attr_accessor :header, :document
+
+    def self.from(supplier:, customer:, invoice:, format: :FPR12)
+      raise "Format #{format} not supported" unless ACube::InvoiceRecord.formats.include?(format)
+      new(supplier, customer, invoice, format)
+    end
+
+    def create_invoice(invoice_base_record, name)
+      progressive_val = ACube::InvoiceRecord.connection.execute("SELECT nextval('acube_invoice_records_progressive_seq') FROM acube_invoice_records_progressive_seq").first["nextval"]
+      progressive_string = ACube.progressive_string.call(progressive_val)
+      document.fill_with(transmission_format: @format, progressive: progressive_string)
+      xml_body = document.to_xml
+
+      invoice_record = ACube::InvoiceRecord.create!(
+        record: invoice_base_record,
+        name: name,
+        format: @format,
+        kind: invoice.document_kind,
+        status: :created,
+        progressive: progressive_string,
+        xml_body: xml_body,
+      )
+
+      begin
+        uuid = ACube::Endpoint::Invoices.new.create(xml_body)
+        invoice_record.update_column(:webhook_uuid, uuid)
+      rescue => e
+        invoice_record.update_column(:status, :creation_error)
+        raise e
+      end
+    end
+
+    def regenerate_invoice(invoice_record_id, also_send: false)
+      invoice_record = ACube::InvoiceRecord.find(invoice_record_id)
+      raise "This Invoice was already sent to ACube" if invoice_record.status != "creation_error"
+
+      document.fill_with(transmission_format: invoice_record.format, progressive: invoice_record.progressive)
+      xml_body = document.to_xml
+
+      invoice_record.update_columns(
+        status: :created,
+        xml_body: xml_body,
+      )
+
+      if also_send
+        begin
+          uuid = ACube::Endpoint::Invoices.new.create(xml_body)
+          invoice_record.update_column(:webhook_uuid, uuid)
+        rescue => e
+          invoice_record.update_column(:status, :creation_error)
+          raise e
+        end
+      end
+    end
+
+    def self.retry_invoice_sending(invoice_record_id)
+      invoice_record = ACube::InvoiceRecord.find(invoice_record_id)
+      raise "This Invoice was already sent to ACube" if invoice_record.status != "creation_error"
+
+      begin
+        uuid = ACube::Endpoint::Invoices.new.create(invoice_record.xml_body)
+        invoice_record.update_column(:webhook_uuid, uuid)
+      rescue => e
+        invoice_record.update_column(:status, :creation_error)
+        raise e
+      end
+    end
+
+    def self.udate_invoice_attributes(invoice_id, json_body)
+      invoice_record = ACube::InvoiceRecord.find_by(webhook_uuid: invoice_id)
+      invoice_record.update_column(:json_body, json_body)
+      
+      begin
+        downloaded_pdf = ACube::Endpoint::Invoices.new.download(invoice_record.webhook_uuid)
+        downloaded_pdf.rewind
+        invoice_record.pdf.attach(io: downloaded_pdf, filename: "#{invoice_record.webhook_uuid}-invoice.pdf", content_type: 'application/pdf')
+        invoice_record.update_column(:status, :downloaded)
+      rescue => e
+        invoice_record.update_column(:status, :download_error)
+        raise e
+      end
+    end
+
+    def self.update_invoice_status(webhook_body)
+      notification = JSON.parse(webhook_body, symbolize_names: true)
+      invoice_record = ACube::InvoiceRecord.find_by(webhook_uuid: notification[:notification][:invoice_uuid])
+
+      status = case notification[:notification][:type]
+      when "MC" then :not_received
+      when "AT" then :not_received
+      when "RC" then :delivered
+      when "NS" then :rejected
+      else :notification_error
+      end
+
+      invoice_record.update_column(:status, status)
+    end
+
+  private
+    def initialize(supplier, customer, invoice, format)
+      @format = format
+
+      @supplier = ACube::Schema::Header::Supplier.from(supplier)
+      @customer = ACube::Schema::Header::Customer.from(customer)
+      @invoice = ACube::Schema::Body.from(invoice)
+
+      @invoice_base_record = invoice
+
+      @header = ACube::Schema::Header::Header.new(@supplier, @customer)
+      @document = ACube::Schema::Document.new(@header, @invoice)
+    end
+  end
+end

data/lib/acube/schema/body.rb

@@ -0,0 +1,96 @@
+module ACube
+  module Schema
+    class Body
+      DOCUMENT_KINDS = %w[TD01 TD02 TD03 TD04 TD05 TD06 TD16 TD17 TD18 TD19 TD20 TD21 TD22 TD23 TD24 TD25 TD26 TD27 TD28].freeze
+      PAYMENT_METHODS = %w[MP01 MP02 MP03 MP04 MP05 MP06 MP07 MP08 MP09 MP10 MP11 MP12 MP13 MP14 MP15 MP16 MP17 MP18 MP19 MP20 MP21 MP22 MP23].freeze
+
+      attr_accessor :document_kind, :date
+      attr_accessor :total_price
+      attr_accessor :connected_progressive
+      attr_accessor :description
+      attr_accessor :quantity
+      attr_accessor :causal
+      attr_accessor :payment_max_date
+      attr_accessor :payment_terms, :payment_method
+      attr_reader :progressive
+
+      def self.from(invoice)
+        new.tap do |body|
+          invoice.transaction_data.each do |key, value|
+            value = value.is_a?(Symbol) ? invoice.send(value) : value
+            body.send("#{key}=", value)
+          end
+        end
+      end
+
+      def set_progressive(progressive)
+        @progressive = progressive
+      end
+      
+      def to_xml
+        Nokogiri::XML::Builder.new do |xml|
+          xml.FatturaElettronicaBody {
+            xml.DatiGenerali {
+              xml.DatiGeneraliDocumento {
+                xml.TipoDocumento document_kind
+                xml.Divisa "EUR"
+                xml.Data date.strftime("%Y-%m-%d")
+                xml.Numero progressive
+                xml.ImportoTotaleDocumento total_price
+                xml.Causale causal if causal
+              }
+
+              if (document_kind == :TD04)
+                xml.DatiFattureCollegate {
+                  xml.IdDocumento connected_progressive
+                }
+              end
+            }
+
+            xml.DatiBeniServizi {
+              xml.DettaglioLinee {
+                xml.NumeroLinea 1
+                xml.Descrizione description
+                xml.Quantita ("%f" % quantity.to_f)
+                xml.PrezzoUnitario ("%f" % unitary_price.to_f)
+                xml.PrezzoTotale ("%f" % price_no_vat.to_f)
+                xml.AliquotaIVA ("%.2f" % (ACube.vat_amount * 100).to_f)
+              }
+
+              xml.DatiRiepilogo {
+                xml.AliquotaIVA ("%.2f" % (ACube.vat_amount * 100).to_f)
+                xml.ImponibileImporto ("%f" % price_no_vat.to_f)
+                xml.Imposta ("%f" % vat_amount.to_f)
+                xml.EsigibilitaIVA "I"
+              }
+            }
+
+            xml.DatiPagamento {
+              xml.CondizioniPagamento payment_terms
+              xml.DettaglioPagamento {
+                xml.ModalitaPagamento payment_method
+                xml.DataScadenzaPagamento payment_max_date.strftime("%Y-%m-%d")
+                xml.ImportoPagamento ("%f" % total_price.to_f)
+              }
+            }
+          }
+        end.to_xml(save_with: 2)
+      end
+
+    private
+      def unitary_price
+        unitary = total_price / quantity
+        unitary_vat = unitary * ACube.vat_amount
+        unitary - unitary_vat
+      end
+
+      def price_no_vat
+        total_price - vat_amount
+      end
+
+      def vat_amount
+        total_price * ACube.vat_amount
+      end
+    end
+  end
+end

data/lib/acube/schema/document.rb

@@ -0,0 +1,39 @@
+module ACube
+  module Schema
+    class Document
+      TRANSMISSION_FORMATS = %w[FPR12 FPA12].freeze
+      
+      attr_accessor :body, :header
+      attr_accessor :progressive, :transmission_format
+
+      def initialize(header, body)
+        @header = header
+        @body = body
+      end
+
+      def fill_with(transmission_format:, progressive:)
+        @transmission_format = transmission_format
+        @progressive = progressive
+
+        header.transmission_format = transmission_format
+        header.progressive = progressive
+        body.set_progressive(progressive)
+      end
+
+      def to_xml
+        Nokogiri::XML::Builder.new(encoding: 'UTF-8', namespace_inheritance:false) do |xml|
+          xml["p"].FatturaElettronica(
+            "versione" => header.transmission_format,
+            "xmlns:ds" => "http://www.w3.org/2000/09/xmldsig#",
+            "xmlns:p" => "http://ivaservizi.agenziaentrate.gov.it/docs/xsd/fatture/v1.2",
+            "xmlns:xsi" => "http://www.w3.org/2001/XMLSchema-instance",
+            "xsi:schemaLocation" => "http://ivaservizi.agenziaentrate.gov.it/docs/xsd/fatture/v1.2 http://www.fatturapa.gov.it/export/fatturazione/sdi/fatturapa/v1.2/Schema_del_file_xml_FatturaPA_versione_1.2.xsd"
+          ) do
+            xml << header.to_xml
+            xml << body.to_xml
+          end
+        end.to_xml
+      end
+    end
+  end
+end

data/lib/acube/schema/header/customer.rb

@@ -0,0 +1,49 @@
+module ACube
+  module Schema
+    module Header
+      class Customer
+        attr_accessor :vat_fiscal_id
+        attr_accessor :fiscal_code
+        attr_accessor :first_name, :last_name, :denomination, :title, :eori_code
+        attr_accessor :address, :civic_number, :zip, :city, :province, :nation
+
+        def self.from(customer)
+          new.tap do |cust|
+            customer.customer_data.each do |key, value|
+              value = value.is_a?(Symbol) ? customer.send(value).to_s : value.to_s
+              cust.send("#{key}=", value)
+            end
+          end
+        end
+
+        def to_xml
+          Nokogiri::XML::Builder.new do |xml|
+            xml.CessionarioCommittente {
+              xml.DatiAnagrafici {
+                xml.CodiceFiscale fiscal_code
+                xml.Anagrafica {
+                  if (first_name && last_name)
+                    xml.Nome first_name
+                    xml.Cognome last_name
+                  else
+                    xml.Denominazione denomination
+                  end
+                  xml.Titolo title if title
+                  xml.CodEORI eori_code if eori_code
+                }
+              }
+              xml.Sede {
+                xml.Indirizzo address
+                xml.NumeroCivico civic_number if civic_number
+                xml.CAP zip
+                xml.Comune city
+                xml.Provincia province
+                xml.Nazione nation
+              }
+            }
+          end.to_xml(save_with: 2)
+        end
+      end
+    end
+  end
+end

data/lib/acube/schema/header/header.rb

@@ -0,0 +1,36 @@
+module ACube
+  module Schema
+    module Header
+      class Header
+        attr_accessor :supplier, :customer
+        attr_accessor :transmission_format
+        attr_accessor :progressive
+
+        def initialize(supplier, customer)
+          @supplier = supplier
+          @customer = customer
+        end
+
+        def to_xml
+          Nokogiri::XML::Builder.new do |xml|
+            xml.FatturaElettronicaHeader {
+              xml.DatiTrasmissione {
+                xml.IdTrasmittente {
+                  xml.IdPaese ACube.transmission_nation_id
+                  xml.IdCodice ACube.transmission_id_code
+                }
+
+                xml.ProgressivoInvio progressive
+                xml.FormatoTrasmissione transmission_format
+                xml.CodiceDestinatario "0000000"
+              }
+
+              xml << supplier.to_xml
+              xml << customer.to_xml
+            }
+          end.to_xml(save_with: 2)
+        end
+      end
+    end
+  end
+end

data/lib/acube/schema/header/supplier.rb

@@ -0,0 +1,65 @@
+module ACube
+  module Schema
+    module Header
+      class Supplier
+        FISCAL_REGIMES = %w[RF01 RF02 RF03 RF04 RF05 RF06 RF07 RF08 RF09 RF10 RF11 RF12 RF13 RF14 RF15 RF16 RF17 RF18 RF19].freeze
+
+        attr_accessor :id_nation, :id_tax_code
+        attr_accessor :fiscal_code
+        attr_accessor :first_name, :last_name, :denomination, :title, :eori_code
+        attr_accessor :albo_professional, :aldo_province, :albo_subscription, :albo_subscription_date
+        attr_accessor :fiscal_regime
+        attr_accessor :address, :civic_number, :zip, :city, :province, :nation
+
+        def self.from(supplier)
+          new.tap do |supp|
+            supplier.supplier_data.each do |key, value|
+              value = value.is_a?(Symbol) ? supplier.send(value).to_s : value.to_s
+              supp.send("#{key}=", value)
+            end
+          end
+        end
+
+        def to_xml
+          Nokogiri::XML::Builder.new do |xml|
+            xml.CedentePrestatore {
+              xml.DatiAnagrafici {
+                xml.IdFiscaleIVA {
+                  xml.IdPaese id_nation
+                  xml.IdCodice id_tax_code
+                }
+                
+                xml.Anagrafica {
+                  if (first_name && last_name)
+                    xml.Nome first_name
+                    xml.Cognome last_name
+                  else
+                    xml.Denominazione denomination
+                  end
+                  xml.Titolo title if title
+                  xml.CodEORI eori_code if eori_code
+                }
+
+                xml.RegimeFiscale fiscal_regime
+                xml.CodiceFiscale fiscal_code if fiscal_code
+
+                xml.AlboProfessionale albo_professional if albo_professional
+                xml.ProvinciaAlbo aldo_province if aldo_province
+                xml.NumeroIscrizioneAlbo albo_subscription if albo_subscription
+                xml.DataIscrizioneAlbo albo_subscription_date if albo_subscription_date
+              }
+              xml.Sede {
+                xml.Indirizzo address
+                xml.NumeroCivico civic_number if civic_number
+                xml.CAP zip
+                xml.Comune city
+                xml.Provincia province
+                xml.Nazione nation
+              }
+            }
+          end.to_xml(save_with: 2)
+        end
+      end
+    end
+  end
+end

data/lib/acube/signature_checker.rb

@@ -0,0 +1,45 @@
+module ACube
+  class SignatureChecker
+    class InvalidSignatureError < StandardError; end
+
+    HASH_ALGORIGHTM = "sha256"
+    DEFAULT_KEY = "acube"
+    DEFAULT_GPG = <<-GPG
+      -----BEGIN PUBLIC KEY-----
+      MCowBQYDK2VwAyEAvZlhiFh4aORWSC9hKZvZyKYgn2g2VeSguWoxu4fbqRI=
+      -----END PUBLIC KEY-----
+    GPG
+
+    def self.verify_signature(request, payload)
+      new(request.headers, payload).verify_signature
+    end
+
+    attr_reader :headers, :payload
+    attr_accessor :signature, :input, :digest
+    def initialize(headers, payload)
+      @headers = headers
+      if (!ACube.webhook_secret_key.nil? && !ACube.webhook_secret.nil?)
+        raise InvalidSignatureError unless headers.has_key?("Authorization") && headers["Authorization"] == "#{ACube.webhook_secret_key} #{ACube.webhook_secret}"
+      end
+
+      raise InvalidSignatureError unless headers.has_key?("signature") && headers.has_key?("signature-input") && headers.has_key?("signature-digest")
+      signature, input, digest = headers["signature"], headers["signature-input"], headers["signature-digest"]
+
+      @payload = payload
+    end
+
+    def verify_signature
+      raw_data = url + params.sort.join
+      OpenSSL::HMAC.digest(HASH_ALGORITHM, signature_gpg, raw_data)
+    end
+
+  private
+    def signature_key
+      ACube.webhook_signature_key || DEFAULT_KEY
+    end
+
+    def signature_gpg
+      ACube.webhook_signature_gpg || DEFAULT_GPG
+    end
+  end
+end

data/lib/acube/support/customer.rb

@@ -0,0 +1,42 @@
+module ACube
+  module Support
+    module Customer
+      extend ActiveSupport::Concern
+      cattr_reader :customer_data
+      
+      included do
+      protected
+        def self.as_customer(&block)
+          config = CustomerBuilder.new
+          yield(config)
+          @@customer_data = config.finalize.dup
+        end
+      end
+
+      class CustomerBuilder
+        @@attributes = ACube::Schema::Header::Customer.instance_methods.select {|m| m.ends_with?("=") && m.starts_with?(/\w/) }
+        @customer_data = {}
+
+        def initialize
+          @customer_data = {}
+        end
+
+        def finalize
+          @customer_data
+        end
+        
+        def method_missing(method, value)
+          if (@@attributes.include?(method))
+            @customer_data[method[0..-2]] = value
+          else
+            super 
+          end
+        end
+      end
+
+      def to_customer
+        ACube::Schema::Header::Customer.from(self)
+      end
+    end
+  end
+end

data/lib/acube/support/supplier.rb

@@ -0,0 +1,42 @@
+module ACube
+  module Support
+    module Supplier
+      extend ActiveSupport::Concern
+      cattr_reader :supplier_data
+      
+      included do
+      protected
+        def self.as_supplier(&block)
+          config = SupplierBuilder.new
+          yield(config)
+          @@supplier_data = config.finalize.dup
+        end
+      end
+
+      class SupplierBuilder
+        @@attributes = ACube::Schema::Header::Supplier.instance_methods.select {|m| m.ends_with?("=") && m.starts_with?(/\w/) }
+        @supplier_data = {}
+
+        def initialize
+          @supplier_data = {}
+        end
+
+        def finalize
+          @supplier_data
+        end
+        
+        def method_missing(method, value)
+          if (@@attributes.include?(method))
+            @supplier_data[method[0..-2]] = value
+          else
+            super 
+          end
+        end
+      end
+
+      def to_supplier
+        ACube::Schema::Header::Supplier.from(self)
+      end
+    end
+  end
+end

data/lib/acube/support/transaction.rb

@@ -0,0 +1,42 @@
+module ACube
+  module Support
+    module Transaction
+      extend ActiveSupport::Concern
+      cattr_reader :transaction_data
+
+      included do
+      protected
+        def self.as_transaction(&block)
+          config = TransactionBuilder.new
+          yield(config)
+          @@transaction_data = config.finalize.dup
+        end
+      end
+
+      class TransactionBuilder
+        @@attributes = ACube::Schema::Body.instance_methods.select {|m| m.ends_with?("=") && m.starts_with?(/\w/) }
+        @transaction_data = {}
+
+        def initialize
+          @transaction_data = {}
+        end
+
+        def finalize
+          @transaction_data
+        end
+        
+        def method_missing(method, value)
+          if (@@attributes.include?(method))
+            @transaction_data[method[0..-2]] = value
+          else
+            super 
+          end
+        end
+      end
+
+      def to_transaction
+        ACube::Schema::Body.from(self)
+      end
+    end
+  end
+end

data/lib/acube/version.rb

@@ -0,0 +1,3 @@
+module ACube
+  VERSION = "0.0.4"
+end

data/lib/acube.rb

@@ -0,0 +1,84 @@
+require "active_support"
+require "active_support/rails"
+
+require "acube/version"
+require "acube/engine"
+
+require "zeitwerk"
+
+module ACube
+  extend ActiveSupport::Autoload
+
+  mattr_accessor :invoice_endpoint
+  mattr_accessor :common_endpoint
+
+  mattr_accessor :username
+  mattr_accessor :password
+
+  mattr_accessor :invoice_base_class, default: "ApplicationRecord"
+  
+  mattr_accessor :webhook_base_class, default: "ApplicationController"
+  mattr_accessor :webhook_endpoint, default: "/acube-api/webhook"
+  mattr_accessor :webhook_secret_key
+  mattr_accessor :webhook_secret
+
+  mattr_accessor :webhook_signature_key
+  mattr_accessor :webhook_signature_gpg
+  
+  mattr_accessor :auth_token_cache_key, default: "__acube__auth__token"
+
+  mattr_accessor :invoice_print_theme, default: "standard"
+  mattr_accessor :progressive_string, default: -> (number) { "#{number}" }
+  mattr_accessor :vat_amount, default: 0.22
+
+  mattr_accessor :transmission_nation_id, default: "IT"
+  mattr_accessor :transmission_id_code, default: "10442360961"
+
+  def self.configure
+    yield(self)
+  end
+
+  autoload :Attribute
+  autoload :SignatureChecker
+  autoload :Invoicer
+
+  module Endpoint
+    extend ActiveSupport::Autoload
+
+    autoload :CommonBase
+    autoload :ItApiBase
+
+    autoload :Auth
+    autoload :Invoices
+  end
+
+  module Schema
+    extend ActiveSupport::Autoload
+
+    module Header
+      extend ActiveSupport::Autoload
+
+      autoload :Supplier
+      autoload :Customer
+      autoload :Header
+    end
+
+    autoload :Body
+    autoload :Document
+  end
+
+  module Support
+    extend ActiveSupport::Autoload
+
+    autoload :Customer
+    autoload :Supplier
+    autoload :Transaction
+  end
+end
+
+loader = Zeitwerk::Loader.for_gem
+loader.ignore("#{__dir__}/generators")
+loader.inflector.inflect(
+  "acube" => "ACube"
+)
+loader.setup

data/lib/generators/a_cube/install/install_generator.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+require "pathname"
+
+module ACube
+  module Generators
+    class InstallGenerator < ::Rails::Generators::Base
+      source_root File.expand_path('templates', __dir__)
+
+      def create_migrations
+        rails_command "railties:install:migrations FROM=active_storage,acube", inline: true
+      end
+    end
+  end
+end

data/lib/tasks/acube.rake

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+desc "Copy over the migration"
+task "acube:install" do
+  Rails::Command.invoke :generate, ["acube:install"]
+end

metadata

@@ -0,0 +1,109 @@
+--- !ruby/object:Gem::Specification
+name: acube-rails
+version: !ruby/object:Gem::Version
+  version: 0.0.4
+platform: ruby
+authors:
+- Pietro Moro
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2023-07-03 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 7.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 7.0.0
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.7'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.7.6
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.7'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.7.6
+description: ACube api wrapper for rails
+email:
+- pietro@pietromoro.dev
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- MIT-LICENSE
+- README.md
+- Rakefile
+- app/models/acube/invoice_record.rb
+- app/models/acube/record.rb
+- config/application.rb
+- config/initializers/zeitwerk.rb
+- config/routes.rb
+- db/migrate/20230624195146_create_acube_invoice_records.rb
+- lib/acube.rb
+- lib/acube/attribute.rb
+- lib/acube/endpoint/auth.rb
+- lib/acube/endpoint/common_base.rb
+- lib/acube/endpoint/invoices.rb
+- lib/acube/endpoint/it_api_base.rb
+- lib/acube/engine.rb
+- lib/acube/invoicer.rb
+- lib/acube/schema/body.rb
+- lib/acube/schema/document.rb
+- lib/acube/schema/header/customer.rb
+- lib/acube/schema/header/header.rb
+- lib/acube/schema/header/supplier.rb
+- lib/acube/signature_checker.rb
+- lib/acube/support/customer.rb
+- lib/acube/support/supplier.rb
+- lib/acube/support/transaction.rb
+- lib/acube/version.rb
+- lib/generators/a_cube/install/install_generator.rb
+- lib/tasks/acube.rake
+homepage: https://github.com/pietromoro/acube-rails
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/pietromoro/acube-rails
+  source_code_uri: https://github.com/pietromoro/acube-rails
+  changelog_uri: https://github.com/pietromoro/acube-rails/blob/master/CHANGELOG.md
+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: []
+rubygems_version: 3.3.7
+signing_key: 
+specification_version: 4
+summary: ACube api wrapper for rails
+test_files: []