einvoicing-connect 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a3d4d4580d842a03b65af1d21a25c888685ad7fa8f69e3ee2b8b537c51bab015
-  data.tar.gz: bc35697fb4f88aa875b9460a106bffc2dc2578a57b0d8a19b32065a71bfb1c30
+  metadata.gz: c1d5afb37eec4ff165c07ca7f35ca30470385c3c9820fe012f69bdb2b663d347
+  data.tar.gz: 79882e661a1683484e4a5ffdcc53640916e70b0b5e997a85b0a58ee14e74dfb2
 SHA512:
-  metadata.gz: '080192ef85f10fe22030b187abadcebcb44efc726c9438af82235d6e6e81a9df38c932ccbbf22bcc43941bad9165103c29620d8ef5f297bb545aa38a37ab90a7'
-  data.tar.gz: eafe755d1d350e52efb9096170030a417e4db99d6dd420d0f773cbd8ace143482e561669bf2fe13791d47c910b307ab7229fb67862b4eb9cf713b8d1f3b39bc4
+  metadata.gz: c8f426765e61378bbbb5a8e7c7ea0860b93c9e73d0be38287b7d690731a095277ee62ed4d97570c4181f3086f6eae5ceacc1e706b15cbb470a1be779b524c71d
+  data.tar.gz: cec80f177749ff036fb921d011fa2f4b909647c1dfa29af808e49984a334cfe1ca4cb1ae0308eb20be6e0a0516212eb2bdb11f03d1f44b914e79ef94dcf34b9c

data/lib/einvoicing/connect/fr/pennylane/client.rb

@@ -3,6 +3,7 @@
 require "net/http"
 require "json"
 require "uri"
+require "cgi"
 require "securerandom"
 
 module Einvoicing
@@ -36,6 +37,46 @@ module Einvoicing
             get("/customer_invoices/#{id}")
           end
 
+          # Find a customer by the caller's own identifier.
+          #
+          # Pennylane does not match a customer from the invoice itself: a
+          # document imported without +customer_id+ lands as "incomplete" with
+          # customer nil, whatever SIRET or VAT number the Factur-X carries.
+          # +external_reference+ is the caller's key into Pennylane's own
+          # numbering, which is what makes resolution repeatable.
+          #
+          # @return [Hash, nil] the customer, or nil when none carries that reference
+          def customer_by_reference(reference)
+            filter = JSON.generate([ { field: "external_reference", operator: "eq", value: reference } ])
+            get("/customers?filter=#{CGI.escape(filter)}")["items"]&.first
+          end
+
+          # Create a company customer (an organisation, invoiced under its own name).
+          #
+          # @param attributes [Hash] at least +name+ and +billing_address+;
+          #   +reg_no+ carries the SIRET, +external_reference+ the caller's key.
+          def create_company_customer(attributes)
+            post("/company_customers", attributes)
+          end
+
+          # Create an individual customer (a private person).
+          def create_individual_customer(attributes)
+            post("/individual_customers", attributes)
+          end
+
+          # The customer for +reference+, created from +attributes+ if Pennylane
+          # does not know it yet. Idempotent as long as the caller keeps the
+          # reference stable, which is the point of it.
+          #
+          # @param company [Boolean] an organisation rather than a private person
+          def find_or_create_customer(reference:, attributes:, company: true)
+            existing = customer_by_reference(reference)
+            return existing if existing
+
+            payload = attributes.merge(external_reference: reference)
+            company ? create_company_customer(payload) : create_individual_customer(payload)
+          end
+
           private
 
           def current_token

data/lib/einvoicing/connect/version.rb

@@ -2,6 +2,6 @@
 
 module Einvoicing
   module Connect
-    VERSION = "0.2.0"
+    VERSION = "0.3.0"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: einvoicing-connect
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Nathan Le Ray