cetustek 0.7.0 → 0.9.0

data/lib/cetustek/soap.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+require 'savon'
+
+module Cetustek
+  # Shared SOAP plumbing: every operation hits the same WSDL and authenticates
+  # with 網站代碼+APIPassword (source) and the 租賃者統編 (rentid).
+  module Soap
+    def soap_client
+      Savon.client(wsdl: Cetustek.config.url, open_timeout: 300, read_timeout: 300)
+    end
+
+    def source
+      Cetustek.config.site_id + Cetustek.config.password
+    end
+
+    def rentid
+      Cetustek.config.username
+    end
+
+    def soap_call(operation, message)
+      soap_client.call(operation, message: message.merge(source: source, rentid: rentid))
+    end
+
+    def soap_return(response, operation)
+      response.body[:"#{operation}_response"][:return]
+    end
+  end
+end

data/lib/cetustek/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Cetustek
-  VERSION = "0.7.0"
+  VERSION = "0.9.0"
 end

data/lib/cetustek/xml.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+require 'ox'
+require 'cgi'
+
+module Cetustek
+  # Every request document in the spec is the same shape: a UTF-8 declaration
+  # and a single <Invoice>/<Allowance> root carrying XSDVersion.
+  module Xml
+    XSD_VERSION = '2.8'
+
+    module_function
+
+    def document(root_name)
+      doc = Ox::Document.new
+      instruct = Ox::Instruct.new(:xml)
+      instruct[:version] = '1.0'
+      instruct[:encoding] = 'UTF-8'
+      doc << instruct
+
+      root = Ox::Element.new(root_name)
+      root[:XSDVersion] = XSD_VERSION
+      doc << root
+      yield root
+
+      Ox.dump(doc).force_encoding('UTF-8')
+    end
+
+    # Values are HTML-escaped so that special characters (&, <, >, ", ') in any
+    # dynamic field cannot break the XML or be used for injection.
+    def tag(name, value)
+      Ox::Raw.new("<#{name}>#{CGI.escapeHTML(value.to_s)}</#{name}>")
+    end
+
+    # Fields whose 備註 says "若未填，預設 X" are left out entirely when nil, so
+    # the platform applies its own default instead of parsing an empty value.
+    def append(element, name, value, skip_nil: false)
+      return if skip_nil && value.nil?
+
+      element << tag(name, value)
+    end
+  end
+end

data/lib/cetustek.rb

@@ -3,6 +3,8 @@
 require_relative "cetustek/version"
 require_relative "cetustek/errors"
 require_relative "cetustek/configuration"
+require_relative "cetustek/xml"
+require_relative "cetustek/soap"
 require_relative "cetustek/models/allowance_data"
 require_relative "cetustek/create_invoice"
 require_relative "cetustek/cancel_invoice"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: cetustek
 version: !ruby/object:Gem::Version
-  version: 0.7.0
+  version: 0.9.0
 platform: ruby
 authors:
 - Zac
@@ -65,9 +65,9 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3.12'
-description: Cetustek is a Ruby gem designed for handling electronic invoice operations,
-  including invoice cancellation. It communicates with the e-invoice system through
-  SOAP Web Services.
+description: 'Cetustek is a Ruby wrapper for the 鯨躍 Cetustek e-invoice API (虛擬多通路,
+  spec AVM-26-03): issuing and cancelling 電子發票 and 折讓單, the read-only queries, and
+  手機條碼 validation, over SOAP Web Services.'
 email:
 - 579103+7a6163@users.noreply.github.com
 executables: []
@@ -90,10 +90,11 @@ files:
 - lib/cetustek/phone_barcode.rb
 - lib/cetustek/queries.rb
 - lib/cetustek/query_invoice_by_order_id.rb
-- lib/cetustek/services/invoice_service.rb
 - lib/cetustek/services/invoice_xml_builder.rb
 - lib/cetustek/services/response_handler.rb
+- lib/cetustek/soap.rb
 - lib/cetustek/version.rb
+- lib/cetustek/xml.rb
 - sig/cetustek.rbs
 homepage: https://github.com/7a6163/cetustek
 licenses:
@@ -118,5 +119,5 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 rubygems_version: 4.0.16
 specification_version: 4
-summary: A Ruby gem for handling electronic invoice operations
+summary: A Ruby client for the Cetustek e-invoice API (電子發票加值中心)
 test_files: []

data/lib/cetustek/services/invoice_service.rb

@@ -1,49 +0,0 @@
-# frozen_string_literal: true
-
-require 'savon'
-require 'logger'
-
-module Cetustek
-  module Services
-    class InvoiceService
-      def initialize(xml, order_id = nil, hastax = 1)
-        @xml = xml
-        @order_id = order_id
-        @hastax = hastax
-      end
-
-      def create
-        client = build_soap_client
-        response = call_create_invoice(client)
-        log_response(response)
-        response
-      end
-
-      private
-
-      def build_soap_client
-        Savon.client(
-          wsdl: Cetustek.config.url,
-          open_timeout: 300,
-          read_timeout: 300
-        )
-      end
-
-      def call_create_invoice(client)
-        client.call(:create_invoice_v3, message: {
-          invoicexml: @xml,
-          source: Cetustek.config.site_id + Cetustek.config.password,
-          rentid: Cetustek.config.username,
-          hastax: @hastax
-        })
-      end
-
-      def log_response(response)
-        return unless defined?(Rails)
-
-        logger = Logger.new(Rails.root.join('log/invoice.log'))
-        logger.debug("#{@order_id} - #{response.body}") if @order_id
-      end
-    end
-  end
-end