facturama 0.0.1

data/lib/facturama/models/model.rb

@@ -0,0 +1,75 @@
+# -*- encoding : utf-8 -*-
+require 'active_model'
+
+module Facturama
+  module Models
+    class Model
+
+      include ActiveModel::Validations
+      include ActiveModel::Serializers::JSON
+
+      attr_accessor :all_errors
+
+      def initialize(values)
+        values.each_pair do |k, v|
+          send("#{k}=", v)
+        end
+        after_initialize
+      end
+
+      def after_initialize
+      end
+
+      def attributes
+        instance_values
+      end
+
+      def prepare_data
+        prepare_keys.to_json
+      end
+
+      def get_instance_values
+        instance_values.delete_if do |k, v|
+          %w(all_errors errors validation_context).include?(k)
+        end
+      end
+
+
+      class << self
+
+        def has_many_objects(association, class_name)
+          define_writer(association, class_name)
+          define_reader(association)
+        end
+
+        def has_one_object(association)
+          define_writer(association, association)
+          define_reader(association)
+        end
+
+        def define_writer(association, class_name)
+          class_eval <<-CODE
+          def #{association}=(value)
+            @#{association} =
+            if value.class.name == "Array"
+              value.collect do |val|
+                #{class_name.to_s.camelize}.new(val)
+              end
+            else
+              #{class_name.to_s.camelize}.new(value)
+            end
+          end
+          CODE
+        end
+
+        def define_reader(association)
+          attr_reader association
+        end
+
+      end
+
+
+
+    end
+  end
+end

data/lib/facturama/models/product.rb

@@ -0,0 +1,27 @@
+# -*- encoding : utf-8 -*-
+module Facturama
+
+  module Models
+
+    require_relative "product_tax"
+
+    class Product < Model
+      attr_accessor :Unit,
+      :UnitCode,
+      :IdentificationNumber,
+      :Name,
+      :Description,
+      :Price,
+      :CodeProdServ,
+      :CuentaPredial,
+      :Complement,
+      :Id,
+      :Taxes
+
+
+      validates :Unit,  :Name, :Description, :Price,  presence: true
+      #has_many_objects , :ProductTax
+      #has_many_objects :Taxes, ProductTax
+    end
+  end
+end

data/lib/facturama/models/product_tax.rb

@@ -0,0 +1,14 @@
+# -*- encoding : utf-8 -*-
+module Facturama
+  module Models
+    class ProductTax < Model
+      attr_accessor :Name, 
+      :Rate, 
+      :IsRetention,
+      :IsFederalTax,
+      :IsQuota,
+      :Total      
+      
+    end
+  end
+end

data/lib/facturama/models/receiver.rb

@@ -0,0 +1,15 @@
+# -*- encoding : utf-8 -*-
+module Facturama
+  module Models
+    class Receiver < Model
+      attr_accessor :Id,      
+      :Rfc,
+      :Name,
+      :CfdiUse,
+      :TaxResidence,      
+      :TaxRegistrationNumber      
+            
+      validates :Rfc,  presence: true
+    end
+  end
+end

data/lib/facturama/models/serie.rb

@@ -0,0 +1,13 @@
+# -*- encoding : utf-8 -*-
+module Facturama
+  module Models
+    class Serie < Model
+      attr_accessor :IdBranchOffice, 
+      :Name, 
+      :Description
+      :Folio
+      
+      validates :IdBranchOffice,  :Name,  presence: true      
+    end
+  end
+end

data/lib/facturama/models/tax.rb

@@ -0,0 +1,14 @@
+# -*- encoding : utf-8 -*-
+module Facturama
+  module Models
+    class Tax < Model
+      attr_accessor :Total,
+      :Name, 
+      :Base, 
+      :Rate,
+      :Type, 
+      :IsRetention,
+      :IsQuota
+    end
+  end
+end

data/lib/facturama/models/tax_entity.rb

@@ -0,0 +1,21 @@
+# -*- encoding : utf-8 -*-
+module Facturama
+  module Models
+    class TaxEntity < Model
+      attr_accessor :FiscalRegime, 
+      :ComercialName, 
+      :Rfc,
+      :TaxName,
+      :Email,
+      :Phone,
+      #:TaxAddress,
+      :PasswordSat,
+      :UrlLogo              #solo Response
+      
+      validates :FiscalRegime,  :Rfc, :TaxName, :Email,  presence: true
+      has_many_objects :TaxAddress, :Address      #solo Response
+      has_many_objects :IssuedIn, :Address        #solo Response
+      has_many_objects :Csd, :Csd               #solo Response
+    end
+  end
+end

data/lib/facturama/models/tax_stamp.rb

@@ -0,0 +1,12 @@
+# -*- encoding : utf-8 -*-
+module Facturama
+  module Models
+    class TaxStamp < Model
+      attr_accessor :Uuid,
+      :Date,
+      :CfdiSign,
+      :SatCertNumber,
+      :SatSign      
+    end
+  end
+end

data/lib/facturama/services/branch_office_service.rb

@@ -0,0 +1,16 @@
+require_relative "crud_service"
+
+module Facturama
+
+    module Services
+        class BranchOfficeService < CrudService
+
+            def initialize(connection_info )
+                super(connection_info, "BranchOffice")
+            end
+
+        end # class BranchOfficeService
+
+    end  # module Services
+
+end     # module Facturama

data/lib/facturama/services/catalog_service.rb

@@ -0,0 +1,42 @@
+require_relative "crud_service"
+
+module Facturama
+
+    module Services
+        class CatalogService < CrudService
+
+            def initialize( connection_info )
+                super(connection_info, "catalogs")
+            end
+
+            def units(keyword = nil)
+                parameters = (keyword.to_s.empty?)? "" : "?keyword=" + keyword
+                get("units" + parameters)
+            end
+
+            def name_ids
+                get("NameIds")
+            end
+
+            def products_or_services(keyword)
+                get("ProductsOrServices?keyword="+keyword)
+            end
+
+            def currencies(keyword = nil)
+                parameters = (keyword.to_s.empty?)? "" : "?keyword=" + keyword
+                get("currencies" + parameters)
+            end
+
+            def payment_forms
+                get("paymentforms")
+            end
+
+            def payment_methods
+                get("paymentmethods")
+            end
+
+        end # class CatalogService
+
+    end  # module Services
+
+end     # module Facturama

data/lib/facturama/services/cfdi_multi_service.rb

@@ -0,0 +1,164 @@
+require_relative "crud_service"
+require 'base64'
+
+module Facturama
+
+    module Services
+        class CfdiMultiService < CrudService
+
+            def initialize( connection_info )
+                super(connection_info, "")
+            end
+
+
+            # ------------------------ CRUD ------------------------
+
+
+            def create(model)
+                post(model, "api-lite/2/cfdis")
+            end
+
+
+            def remove(id)
+
+                if !id.nil? && id != ""
+                    delete("api-lite/cfdis/" + id )
+                else
+                    raise( FacturamaException("El Id del cfdi a eliminar es obligatorio") )
+                end
+            end
+
+
+            def retrieve(id)
+                get("api-lite/cfdis/" + id )
+            end
+
+
+            # ------------------------ DESCARGA DE ARCHIVOS (PDF, XML, HTML) ------------------------
+
+
+
+            # Obtiene un archivo referente a un CFDI del tipo "Issued"
+            # @param id Identificador del CFDI
+            # @param format Formato deseado ( pdf | html | xml )
+            # @param type Tipo de comprobante ( payroll | received | issued )
+            # @return Archivo en cuestion
+            def get_file(id, format, type)
+                resource = "cfdi/" +  format + "/" + type + "/"  + id
+                get(resource)
+            end
+
+
+            # Decodifica y guarda un archivo base64 en una ruta
+            def save_file(file_path, file_content_base64)
+                file_content_decoded = Base64.decode64(file_content_base64)
+                File.open(file_path, "wb") do |f|
+                    f.write(file_content_decoded)
+                end
+            end
+
+
+            def save_pdf(file_path, id, type = Facturama::InvoiceType::ISSUED_LITE)
+                file_content = get_file(id, Facturama::FileFormat::PDF, type)
+                save_file(file_path, file_content['Content'])
+            end
+
+            def save_xml(file_path, id, type = Facturama::InvoiceType::ISSUED_LITE)
+                file_content = get_file(id, Facturama::FileFormat::XML, type)
+                save_file(file_path, file_content['Content'])
+            end
+
+            def save_html(file_path, id, type = Facturama::InvoiceType::ISSUED_LITE)
+                file_content = get_file(id, Facturama::FileFormat::HTML, type)
+                save_file(file_path, file_content['Content'])
+            end
+
+
+
+
+            # ------------------------ LISTADO DE CFDIS ------------------------
+
+            # Listado de Cfdi filtrando por palabra clave
+            def list_by_keyword(keyword,
+                     status = Facturama::CfdiStatus::ACTIVE)
+
+                resource = "api-lite/cfdis?status=" + status + "&keyword=" + keyword
+                get(resource)
+            end
+
+
+
+            # Listado de Cfdi filtrando por palabra RFC
+            def list_by_rfc(rfc,
+                    status = Facturama::CfdiStatus::ACTIVE,
+                    type = Facturama::InvoiceType::ISSUED)
+
+                resource = "api-lite/cfdis?status=" + status + "&rfc=" + rfc
+                get(resource)
+            end
+
+
+
+
+            # Listado con todas las opciones posibles
+            def list(folio_start = -1, folio_end = -1,
+                     rfc = nil,  tax_entity_name = nil,
+                     date_start = nil, date_end = nil,
+                     id_branch = nil,  serie = nil,
+                     status = Facturama::CfdiStatus::ACTIVE,
+                     type = Facturama::InvoiceType::ISSUED)
+
+                resource = "api-lite/cfdis?type=" +  type + "&status=" + status
+
+                if folio_start > -1
+                    resource += "&folioStart=" + folio_start
+                end
+
+                if folio_end > -1
+                    resource += "&folioEnd=" + folio_end
+                end
+
+                if rfc != nil
+                    resource += "&rfc=" + rfc
+                end
+
+                if tax_entity_name != nil
+                    resource += "&taxEntityName=" + tax_entity_name
+                end
+
+                if date_start != nil
+                    resource += "&dateStart=" + date_start
+                end
+
+                if date_end != nil
+                    resource += "&dateEnd=" + date_end
+                end
+
+                if id_branch != nil
+                    resource += "&idBranch=" + id_branch
+                end
+
+                if serie != nil
+                    resource += "&serie=" + serie
+                end
+
+
+                get(resource)
+            end
+
+
+
+            # ------------------------ ENVIO POR CORREO ------------------------
+
+            # Envía el CFDI por correo, con el asunto especificado
+            def send_by_mail(id, email, subject, type = Facturama::InvoiceType::ISSUED_LITE)
+                response = post(nil,"cfdi?cfdiType=#{type}&cfdiId=#{id}&email=#{email}&subject=#{subject}")
+                !!response['success']
+            end
+
+
+        end # class CfdiService
+
+    end  # module Services
+
+end     # module Facturama

data/lib/facturama/services/cfdi_service.rb

@@ -0,0 +1,172 @@
+require_relative "crud_service"
+require 'base64'
+
+module Facturama
+
+    module Services
+        class CfdiService < CrudService
+
+            def initialize( connection_info )
+                super(connection_info, "")
+            end
+
+
+            # ------------------------ CRUD ------------------------
+
+
+            def create(model)
+                post(model, "2/cfdis")
+            end
+
+
+            def remove(id)
+
+                if !id.nil? && id != ""
+                    delete("cfdi/" + id  + "?type=issued")
+                else
+                    raise( FacturamaException("El Id del cfdi a eliminar es obligatorio") )
+                end
+            end
+
+
+            def retrieve(id, type = nil)
+
+                if type.nil?
+                    str_type = "Issued"
+                else
+                    str_type = type
+                end
+
+                get("cfdi/" + id + "?type=#{str_type}")
+            end
+
+
+            # ------------------------ DESCARGA DE ARCHIVOS (PDF, XML, HTML) ------------------------
+
+
+
+            # Obtiene un archivo referente a un CFDI del tipo "Issued"
+            # @param id Identificador del CFDI
+            # @param format Formato deseado ( pdf | html | xml )
+            # @param type Tipo de comprobante ( payroll | received | issued )
+            # @return Archivo en cuestion
+            def get_file(id, format, type)
+                resource = "api/cfdi/" +  format + "/" + type + "/"  + id
+                get(resource)
+            end
+
+
+            # Decodifica y guarda un archivo base64 en una ruta
+            def save_file(file_path, file_content_base64)
+                file_content_decoded = Base64.decode64(file_content_base64)
+                File.open(file_path, "wb") do |f|
+                    f.write(file_content_decoded)
+                end
+            end
+
+
+            def save_pdf(file_path, id, type = Facturama::InvoiceType::ISSUED)
+                file_content = get_file(id, Facturama::FileFormat::PDF, type)
+                save_file(file_path, file_content['Content'])
+            end
+
+            def save_xml(file_path, id, type = Facturama::InvoiceType::ISSUED)
+                file_content = get_file(id, Facturama::FileFormat::XML, type)
+                save_file(file_path, file_content['Content'])
+            end
+
+            def save_html(file_path, id, type = Facturama::InvoiceType::ISSUED)
+                file_content = get_file(id, Facturama::FileFormat::HTML, type)
+                save_file(file_path, file_content['Content'])
+            end
+
+
+
+
+            # ------------------------ LISTADO DE CFDIS ------------------------
+
+            # Listado de Cfdi filtrando por palabra clave
+            def list_by_keyword(keyword,
+                     status = Facturama::CfdiStatus::ACTIVE,
+                     type = Facturama::InvoiceType::ISSUED)
+
+                resource = "cfdi?type=" +  type + "&status=" + status + "&keyword=" + keyword
+                get(resource)
+            end
+
+
+
+            # Listado de Cfdi filtrando por palabra RFC
+            def list_by_rfc(rfc,
+                    status = Facturama::CfdiStatus::ACTIVE,
+                    type = Facturama::InvoiceType::ISSUED)
+
+                resource = "cfdi?type=" +  type + "&status=" + status + "&rfc=" + rfc
+                get(resource)
+            end
+
+
+
+
+            # Listado con todas las opciones posibles
+            def list(folio_start = -1, folio_end = -1,
+                     rfc = nil,  tax_entity_name = nil,
+                     date_start = nil, date_end = nil,
+                     id_branch = nil,  serie = nil,
+                     status = Facturama::CfdiStatus::ACTIVE,
+                     type = Facturama::InvoiceType::ISSUED)
+
+                resource = "cfdi?type=" +  type + "&status=" + status
+
+                if folio_start > -1
+                    resource += "&folioStart=" + folio_start
+                end
+
+                if folio_end > -1
+                    resource += "&folioEnd=" + folio_end
+                end
+
+                if rfc != nil
+                    resource += "&rfc=" + rfc
+                end
+
+                if tax_entity_name != nil
+                    resource += "&taxEntityName=" + tax_entity_name
+                end
+
+                if date_start != nil
+                    resource += "&dateStart=" + date_start
+                end
+
+                if date_end != nil
+                    resource += "&dateEnd=" + date_end
+                end
+
+                if id_branch != nil
+                    resource += "&idBranch=" + id_branch
+                end
+
+                if serie != nil
+                    resource += "&serie=" + serie
+                end
+
+
+                get(resource)
+            end
+
+
+
+            # ------------------------ ENVIO POR CORREO ------------------------
+
+            # Envía el CFDI por correo, con el asunto especificado
+            def send_by_mail(id, email, subject, type = Facturama::InvoiceType::ISSUED)
+                response = post(nil,"cfdi?cfdiType=#{type}&cfdiId=#{id}&email=#{email}&subject=#{subject}")
+                !!response['success']
+            end
+
+
+        end # class CfdiService
+
+    end  # module Services
+
+end     # module Facturama