facturama-ipz 0.0.3

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 8c394c0c233bddc2b5acadd34cbcaf48be1292386b6c12acb2cf6910b3c6d3c1
+  data.tar.gz: daeb67f028981bb38d7f6350492f7a643324fdf9e4a37767d18832f0f7edbed7
+SHA512:
+  metadata.gz: 7c8471782d8a0b4c9a75da07dce161e23f0670e6907f97a2116b7df604d9f0e866744932586cd6952e638667533fb985856c531647e0883bd8293f4ba50fe7b3
+  data.tar.gz: 48ed6db07737923171cdf81af85e517699852ba2279135962274d1e649915fb17fcd79e48b91b8967021be30d1449de0c5ad2fdc3729228ea941ed1f9e628e35

data/lib/facturama/facturama_api_multi.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+require_relative 'models/connection_info'
+
+module Facturama
+  require 'logger'
+  require 'base64'
+  require 'rest-client'
+  require 'uri'
+
+  class FacturamaApiMulti
+    def initialize(facturama_user, facturama_password, is_development = true)
+      @connection_info = Facturama::Models::ConnectionInfo.new(facturama_user, facturama_password, is_development)
+
+      @cfdi_service = Facturama::Services::CfdiMultiService.new(@connection_info)
+      @csd_service = Facturama::Services::CsdService.new(@connection_info)
+    end
+
+    # CSD
+    def csds
+      @csd_service
+    end
+
+    # CFDI (Facturas)
+    def cfdis
+      @cfdi_service
+    end
+  end
+end

data/lib/facturama/facturama_api_web.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+require_relative 'models/connection_info'
+
+module Facturama
+  require 'logger'
+  require 'base64'
+  require 'rest-client'
+  require 'uri'
+
+  class FacturamaApiWeb
+    def initialize(facturama_user, facturama_password, is_development = true)
+      @connection_info = Facturama::Models::ConnectionInfo.new(facturama_user, facturama_password, is_development)
+
+      @client_service = Facturama::Services::ClientService.new(@connection_info)
+      @product_service = Facturama::Services::ProductService.new(@connection_info)
+      @catalog_service = Facturama::Services::CatalogService.new(@connection_info)
+      @branch_office_service = Facturama::Services::BranchOfficeService.new(@connection_info)
+      @cfdi_service = Facturama::Services::CfdiService.new(@connection_info)
+    end
+
+    # Clientes
+    def clients
+      @client_service
+    end
+
+    # Artículos ( Productos o servicios para los conceptos )
+    def products
+      @product_service
+    end
+
+    # Catálogo
+    def catalog
+      @catalog_service
+    end
+
+    # Lugares de expedición (Sucursales)
+    def branch_office
+      @branch_office_service
+    end
+
+    # CFDI (Facturas)
+    def cfdis
+      @cfdi_service
+    end
+  end
+end

data/lib/facturama/models/address.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Facturama
+  module Models
+    class Address < Model
+      attr_accessor :Street,
+                    :ExteriorNumber,
+                    :InteriorNumber,
+                    :Neighborhood,
+                    :ZipCode,
+                    :Locality,
+                    :Municipality,
+                    :State,
+                    :Country
+    end
+  end
+end

data/lib/facturama/models/branch_office.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Facturama
+  module Models
+    class BranchOffice < Model
+      attr_accessor :Id,
+                    :Name,
+                    :Description
+
+      # :Address
+
+      validates :Name, :Description, :Address, presence: true
+      has_one_object :Address
+    end
+  end
+end

data/lib/facturama/models/cfdi.rb

@@ -0,0 +1,77 @@
+# frozen_string_literal: true
+
+#  CFDI de emisión (una factura)
+
+module Facturama
+  module CfdiType
+    INGRESO = 'I'
+    EGRESO = 'E'
+    TRASLADO = 'T'
+    PAGO = 'P'
+  end
+
+  module CfdiStatus
+    ALL = 'All'
+    ACTIVE = 'Active'
+    CANCEL = 'Cancel'
+  end
+
+  module InvoiceType
+    ISSUED = 'Issued'
+    RECEIVED = 'Received'
+    PAYROLL = 'Payroll'
+    ISSUED_LITE = 'issuedLite'
+  end
+
+  module FileFormat
+    XML = 'Xml'
+    PDF = 'Pdf'
+    HTML = 'Html'
+  end
+
+  module Models
+    class Cfdi < Model
+      attr_accessor :Id, # Solo Response
+                    :Folio, # Solo Response
+                    :CertNumber, # Solo Response
+                    :NameId,
+                    :Date,
+                    :Serie,
+                    :PaymentAccountNumber,
+                    :CurrencyExchangeRate,
+                    :Currency,
+                    :ExpeditionPlace,
+                    :PaymentConditions,
+                    # :Relations,
+                    :CfdiType,
+                    :PaymentForm,
+                    :PaymentMethod,
+                    :Exportation,
+                    :GlobalInformation,
+                    # :Receiver,
+                    :Items,
+                    # :Complemento, _jr_* Complemento no se considera para eso
+                    :Observations,
+                    :OrderNumber,
+                    :PaymentTerms,        # Solo Response
+                    :ExchangeRate,        # Solo Response - puede ser el mismo que  CurrencyExchangeRate
+                    :Subtotal,            # Solo Response
+                    :Discount,            # Solo Response
+                    :Total,               # Solo Response
+                    # :Issuer,             # Solo Response  - Es una entidad fiscal
+                    :Discount
+
+      # Taxes                # Solo Response
+      # :Complement           # Solo Response
+
+      validates :Email, :Rfc, :Name, presence: true
+      has_many_objects :Relations, :CfdiRelation
+      has_one_object :Receiver
+      has_many_objects :Issuer, :TaxEntity
+      # has_many_objects :Items, :Item
+      has_many_objects :Taxes, :Tax
+      has_one_object :Complement
+      # has_one_object :GlobalInformation
+    end
+  end
+end

data/lib/facturama/models/cfdi_relation.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Facturama
+  module Models
+    class CfdiRelation < Model
+      attr_accessor :Uuid
+
+      validates :Uuid, presence: true
+    end
+  end
+end

data/lib/facturama/models/cfdi_relations.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Facturama
+  module Models
+    class CfdiRelations < Model
+      attr_accessor :Type,
+                    :Cfdis
+
+      validates :Type, :Cfdis, presence: true
+      has_many_objects :Cfdis, :CfdiRelation
+    end
+  end
+end

data/lib/facturama/models/client.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Facturama
+  module Models
+    class Client < Model
+      attr_accessor :Email,
+                    :EmailOp1,
+                    :EmailOp2,
+                    :Rfc,
+                    :Name,
+                    :CfdiUse,
+                    :TaxResidence,
+                    :NumRegIdTrib
+
+      has_one_object :Address
+      validates :Email, :Rfc, :Name, presence: true
+    end
+  end
+end

data/lib/facturama/models/complement.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Facturama
+  module Models
+    class Complement < Model
+      attr_accessor :TaxStamp
+    end
+  end
+end

data/lib/facturama/models/connection_info.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Facturama
+  module Models
+    class ConnectionInfo
+      # API Endpoints
+      URL_DEV = 'https://apisandbox.facturama.mx'
+      URL_PROD = 'https://api.facturama.mx'
+
+      def initialize(facturama_user, facturama_password, is_development = true)
+        @facturama_user = facturama_user
+        @facturama_password = facturama_password
+        @is_development = is_development
+
+        @uri_base = is_development ? URL_DEV : URL_PROD
+      end
+
+      attr_reader :uri_base, :facturama_user, :facturama_password, :is_development
+    end
+  end
+end

data/lib/facturama/models/csd.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Facturama
+  module Models
+    class Csd < Model
+      attr_accessor :Rfc,
+                    :Certificate,
+                    :PrivateKey,
+                    :PrivateKeyPassword
+
+      validates :Certificate, :PrivateKey, :PrivateKeyPassword, presence: true
+    end
+  end
+end

data/lib/facturama/models/exception/facturama_exception.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+require_relative 'model_exception'
+
+class FacturamaException < StandardError
+  def initialize(exception_message, exception_details = nil)
+    super exception_message
+
+    @details = exception_details
+  end
+
+  attr_reader :details
+end

data/lib/facturama/models/exception/model_exception.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+class ModelException
+  def initialize
+    @message = ''
+    @details = ''
+  end
+end

data/lib/facturama/models/globalInformation.rb

@@ -0,0 +1,15 @@
+# -*- encoding : utf-8 -*-
+module Facturama
+    module Models
+      class GlobalInformation < Model
+        attr_accessor :Periodicity,      
+        :Months,
+        :Year
+
+  
+              
+        validates :Periodicity, :Months, :Year presence: true
+      end
+    end
+  end
+  

data/lib/facturama/models/image.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Facturama
+  module Models
+    class Image < Model
+      attr_accessor :Image,
+                    :Type
+
+      validates :Image, presence: true
+    end
+  end
+end

data/lib/facturama/models/item.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Facturama
+  module Models
+    class Item < Model
+      attr_accessor :ProductCode,
+                    :IdentificationNumber,
+                    :Description,
+                    :Unit,
+                    :UnitCode,
+                    :UnitPrice,
+                    :Quantity,
+                    :Subtotal,
+                    :Discount,
+                    # :Taxes,
+                    :CuentaPredial,
+                    :Total,
+                    :TaxObject,
+                    :ThirdPartyAccount,
+                    :Taxes,
+                    :UnitValue # solo Response
+
+      # :Complement  _jr_* por el momento, no se consideran los complementos
+
+      validates :ProductCode, :Description, :UnitCode, :UnitPrice, :Quantity, :Subtotal, :Total, presence: true
+      # has_many_objects :Taxes, :Tax
+    end
+  end
+end

data/lib/facturama/models/model.rb

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+
+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, __FILE__, __LINE__ + 1
+          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,25 @@
+# frozen_string_literal: true
+
+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 @@
+# frozen_string_literal: true
+
+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,18 @@
+# frozen_string_literal: true
+
+module Facturama
+  module Models
+    class Receiver < Model
+      attr_accessor :Id,
+                    :Rfc,
+                    :Name,
+                    :CfdiUse,
+                    :TaxResidence,
+                    :TaxRegistrationNumber,
+                    :TaxZipCode,
+                    :FiscalRegime
+
+      validates :Rfc, presence: true
+    end
+  end
+end

data/lib/facturama/models/serie.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+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,15 @@
+# frozen_string_literal: true
+
+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,22 @@
+# frozen_string_literal: true
+
+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,13 @@
+# frozen_string_literal: true
+
+module Facturama
+  module Models
+    class TaxStamp < Model
+      attr_accessor :Uuid,
+                    :Date,
+                    :CfdiSign,
+                    :SatCertNumber,
+                    :SatSign
+    end
+  end
+end

data/lib/facturama/models/thirdPartyAccount.rb

@@ -0,0 +1,14 @@
+# -*- encoding : utf-8 -*-
+module Facturama
+    module Models
+      class ThirdPartyAccount < Model
+        attr_accessor :Rfc,      
+        :Name,
+        :FiscalRegime,
+        :TaxZipCode
+
+        validates :Rfc, :Name, :FiscalRegime, :TaxZipCode presence: true
+      end
+    end
+  end
+  

data/lib/facturama/services/branch_office_service.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+require_relative 'crud_service'
+
+module Facturama
+  module Services
+    class BranchOfficeService < CrudService
+      def initialize(connection_info)
+        super(connection_info, 'BranchOffice')
+      end
+    end
+  end
+end

data/lib/facturama/services/catalog_service.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+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
+  end
+end