einvoicing-connect 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 54ce574178b7dcbed5b437a34f88672ae3d0d5923f7262d679cbc927d582265e
+  data.tar.gz: 96f661a9749c2b1c41b79bc5f52c9c48823bef8d314a7432e783137c560be7c8
+SHA512:
+  metadata.gz: 4d32efd286fb9e98e0b3e9038e409e40f4f44f9d3b641e4dccb94584e4866daa076146799d8d2985dfbe5799966d8f3c8af43332d9f70a8daafeeface89c9909
+  data.tar.gz: 03df43147ea54a77683c0775bfda4f94c0e492cfca4427c8e7a1ded0215d266f79fe845984fb7864ef70f783cf13fb93d80f848ed8656860ebb5787a4ed47c90

data/config/locales/en.yml

@@ -0,0 +1,13 @@
+en:
+  einvoicing:
+    connect:
+      ppf:
+        auth_failed: "OAuth token request failed: %{code} %{body}"
+        unauthorized: "Unauthorized: %{body}"
+        forbidden: "Forbidden: %{body}"
+        not_found: "Not found: %{body}"
+        api_error: "API error %{code}: %{body}"
+        structure_not_found: "Buyer SIRET %{siret} not found in Chorus Pro"
+      fr:
+        siret_api_error: "SIRET lookup failed: %{message}"
+        siret_not_found: "No company found for SIREN: %{siren}"

data/config/locales/fr.yml

@@ -0,0 +1,13 @@
+fr:
+  einvoicing:
+    connect:
+      ppf:
+        auth_failed: "Échec de la requête de jeton OAuth : %{code} %{body}"
+        unauthorized: "Non autorisé : %{body}"
+        forbidden: "Accès interdit : %{body}"
+        not_found: "Non trouvé : %{body}"
+        api_error: "Erreur API %{code} : %{body}"
+        structure_not_found: "SIRET acheteur %{siret} non trouvé dans Chorus Pro"
+      fr:
+        siret_api_error: "Échec de la recherche SIRET : %{message}"
+        siret_not_found: "Aucune entreprise trouvée pour le SIREN : %{siren}"

data/lib/einvoicing/connect/i18n.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+require "i18n"
+
+module Einvoicing
+  module Connect
+    module I18nSetup
+      def self.setup
+        ::I18n.load_path += Dir[File.join(__dir__, "../../../config/locales/*.yml")]
+        ::I18n.backend.load_translations
+      end
+    end
+  end
+end
+
+Einvoicing::Connect::I18nSetup.setup

data/lib/einvoicing/connect/version.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Einvoicing
+  module Connect
+    VERSION = "0.1.0"
+  end
+end

data/lib/einvoicing/connect.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+require_relative "connect/version"
+
+module Einvoicing
+  module Connect
+    # einvoicing-connect adds platform connectivity to the einvoicing gem.
+    # Requires: gem "einvoicing-connect" in your Gemfile.
+  end
+end

data/lib/einvoicing/fr/siret_lookup.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+require "net/http"
+require "uri"
+require "json"
+
+module Einvoicing
+  module FR
+    module SiretLookup
+      API_URL = "https://recherche-entreprises.api.gouv.fr/search" unless defined?(API_URL)
+
+      # Find SIRET for a given SIREN using the French government Sirene API.
+      # Returns { siret:, name:, address: } or nil on any error.
+      def self.find(siren)
+        return nil unless siren.to_s.match?(/\A\d{9}\z/)
+
+        uri = URI(API_URL)
+        uri.query = URI.encode_www_form(q: siren.to_s, mtq: "true")
+
+        response = Net::HTTP.start(uri.host, uri.port, use_ssl: true,
+                                   open_timeout: 5, read_timeout: 10) do |http|
+          http.get(uri.request_uri)
+        end
+
+        return nil unless response.code == "200"
+
+        data = JSON.parse(response.body)
+        result = data["results"]&.first
+        return nil unless result
+
+        siege = result["siege"] || {}
+        siret = siege["siret"]
+        return nil if siret.nil? || siret.empty?
+
+        { siret: siret, name: result["nom_complet"], address: siege["adresse"] }
+      rescue StandardError
+        nil
+      end
+
+      # Enrich a Party object by fetching and setting its SIRET from the API.
+      # Only calls the API if party.siren is present and party.siret is blank.
+      # Returns the party.
+      def self.enrich!(party)
+        return party if party.siren.to_s.strip.empty?
+        return party if party.respond_to?(:siret) && !party.siret.to_s.strip.empty?
+
+        result = find(party.siren.to_s.gsub(/\s/, ""))
+        return party unless result&.dig(:siret)
+
+        party.with(siret: result[:siret])
+      end
+    end
+  end
+end

data/lib/einvoicing/ppf/client.rb

@@ -0,0 +1,117 @@
+# frozen_string_literal: true
+
+require "net/http"
+require "json"
+
+module Einvoicing
+  module PPF
+    class Client
+      SANDBOX_OAUTH_URL = "https://sandbox-oauth.piste.gouv.fr" unless defined?(SANDBOX_OAUTH_URL)
+      SANDBOX_API_URL   = "https://sandbox-api.piste.gouv.fr/cpro/factures" unless defined?(SANDBOX_API_URL)
+      PROD_OAUTH_URL    = "https://oauth.piste.gouv.fr" unless defined?(PROD_OAUTH_URL)
+      PROD_API_URL      = "https://api.piste.gouv.fr/cpro/factures" unless defined?(PROD_API_URL)
+
+      attr_reader :sandbox
+
+      def initialize(client_id:, client_secret:, sandbox: true)
+        @client_id        = client_id
+        @client_secret    = client_secret
+        @sandbox          = sandbox
+        @token            = nil
+        @token_expires_at = nil
+      end
+
+      # Returns current access token, refreshing if expired.
+      def access_token
+        refresh_token! if token_expired?
+        @token
+      end
+
+      # POST /v1/rechercher/structure — find structure by SIRET, returns idStructureCPP.
+      def find_structure(siret:)
+        post("/v1/rechercher/structure", { siret: siret })
+      end
+
+      # POST /v1/consulter/structure — get mandatory params (engagement, service codes).
+      def get_structure(id_structure_cpp:)
+        post("/v1/consulter/structure", { idStructureCPP: id_structure_cpp })
+      end
+
+      # POST /v1/rechercher/service/structure — list active services for a structure.
+      def list_services(id_structure_cpp:, page: 1)
+        post("/v1/rechercher/service/structure", {
+          idStructureCPP: id_structure_cpp,
+          pageResultat:   page
+        })
+      end
+
+      # POST /v1/soumettre/factures — submit an invoice.
+      # facture_hash: Hash matching the Chorus Pro invoice schema.
+      def submit_invoice(facture_hash)
+        post("/v1/soumettre/factures", facture_hash)
+      end
+
+      private
+
+      def base_url
+        sandbox ? SANDBOX_API_URL : PROD_API_URL
+      end
+
+      def oauth_url
+        sandbox ? SANDBOX_OAUTH_URL : PROD_OAUTH_URL
+      end
+
+      def token_expired?
+        @token.nil? || @token_expires_at.nil? || Time.now >= @token_expires_at
+      end
+
+      def refresh_token!
+        uri = URI("#{oauth_url}/api/oauth/token")
+        req = Net::HTTP::Post.new(uri)
+        req.set_form_data(
+          grant_type:    "client_credentials",
+          client_id:     @client_id,
+          client_secret: @client_secret,
+          scope:         "openid"
+        )
+        res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |h| h.request(req) }
+        raise AuthenticationError, ::I18n.t("einvoicing.connect.ppf.auth_failed", code: res.code, body: res.body) unless res.is_a?(Net::HTTPSuccess)
+
+        data = JSON.parse(res.body)
+        @token            = data["access_token"]
+        @token_expires_at = Time.now + data.fetch("expires_in", 3600).to_i - 60
+      end
+
+      def post(path, body)
+        uri = URI("#{base_url}#{path}")
+        req = Net::HTTP::Post.new(uri)
+        req["Authorization"] = "Bearer #{access_token}"
+        req["Content-Type"]  = "application/json;charset=UTF-8"
+        req["Accept"]        = "application/json"
+        req.body = body.to_json
+        res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |h| h.request(req) }
+        handle_response(res)
+      end
+
+      def handle_response(res)
+        body = begin
+          JSON.parse(res.body)
+        rescue StandardError
+          res.body
+        end
+        case res
+        when Net::HTTPSuccess
+          body
+        when Net::HTTPUnauthorized
+          raise AuthenticationError, ::I18n.t("einvoicing.connect.ppf.unauthorized", body: body)
+        when Net::HTTPForbidden
+          raise AuthorizationError, ::I18n.t("einvoicing.connect.ppf.forbidden", body: body)
+        when Net::HTTPNotFound
+          raise NotFoundError, ::I18n.t("einvoicing.connect.ppf.not_found", body: body)
+        else
+          raise APIError, ::I18n.t("einvoicing.connect.ppf.api_error", code: res.code, body: body)
+        end
+      end
+    end
+  end
+end

data/lib/einvoicing/ppf/errors.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Einvoicing
+  module PPF
+    Error               = Class.new(StandardError) unless defined?(Error)
+    AuthenticationError = Class.new(Error) unless defined?(AuthenticationError)
+    AuthorizationError  = Class.new(Error) unless defined?(AuthorizationError)
+    NotFoundError       = Class.new(Error) unless defined?(NotFoundError)
+    APIError            = Class.new(Error) unless defined?(APIError)
+    ValidationError     = Class.new(Error) unless defined?(ValidationError)
+  end
+end

data/lib/einvoicing/ppf/invoice_adapter.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+module Einvoicing
+  module PPF
+    class InvoiceAdapter
+      # Converts an Einvoicing::Invoice to a Chorus Pro SoumettreFacture payload.
+      #
+      # @param invoice [Einvoicing::Invoice]
+      # @param id_structure_cpp [Integer] from find_structure()
+      # @param code_service [String, nil] from list_services() — optional
+      # @param numero_engagement [String, nil] buyer PO/engagement number — optional for B2B
+      def self.to_chorus_payload(invoice, id_structure_cpp:, code_service: nil, numero_engagement: nil)
+        {
+          idStructureCPP:   id_structure_cpp,
+          codeService:      code_service,
+          numeroEngagement: numero_engagement,
+          cadreFacturation: {
+            codeCadreFacturation: "FACTURE_FOURNISSEUR",
+            codeServiceValideur:  nil
+          },
+          identifiantFactureFournisseur: invoice.invoice_number,
+          dateFacture:             invoice.issue_date.strftime("%Y-%m-%dT00:00:00.000+01:00"),
+          dateEcheancePaiement:    invoice.due_date&.strftime("%Y-%m-%dT00:00:00.000+01:00"),
+          montantHT:               invoice.net_total.to_f,
+          montantTVA:              invoice.tax_total.to_f,
+          montantTTC:              invoice.gross_total.to_f,
+          devise:                  invoice.currency || "EUR",
+          siretFournisseur:        invoice.seller.siret,
+          siretDestinataire:       invoice.buyer.siret,
+          typeFacture:             "FACTURE",
+          lignesPoste:             invoice.lines.map.with_index(1) { |line, i| line_to_chorus(line, i) },
+          modePaiement:            chorus_payment_mode(invoice)
+        }.compact
+      end
+
+      private_class_method def self.line_to_chorus(line, index)
+        {
+          numeroLigne:    index,
+          designation:    line.description,
+          quantite:       line.quantity.to_f,
+          unite:          "U",
+          prixUnitaireHT: line.unit_price.to_f,
+          montantHT:      line.net_amount.to_f,
+          tauxTVA:        (line.vat_rate * 100).to_f,
+          montantTVA:     (line.net_amount * line.vat_rate).to_f.round(2)
+        }
+      end
+
+      private_class_method def self.chorus_payment_mode(invoice)
+        return nil unless invoice.respond_to?(:payment_means_code) && invoice.payment_means_code
+
+        code_map = { 30 => "VIREMENT", 42 => "VIREMENT", 58 => "VIREMENT" }
+        mode     = code_map[invoice.payment_means_code] || "VIREMENT"
+        result   = { modePaiement: mode }
+        result[:iban] = invoice.iban if invoice.respond_to?(:iban) && invoice.iban
+        result[:bic]  = invoice.bic  if invoice.respond_to?(:bic)  && invoice.bic
+        result
+      end
+    end
+  end
+end

data/lib/einvoicing/ppf/submitter.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module Einvoicing
+  module PPF
+    class Submitter
+      def initialize(client)
+        @client = client
+      end
+
+      # Submit an invoice to Chorus Pro / PPF.
+      # Returns the submission result hash from the API.
+      #
+      # @param invoice [Einvoicing::Invoice]
+      # @param code_service [String, nil] optional service code from list_services
+      # @param numero_engagement [String, nil] optional engagement number
+      def submit(invoice, code_service: nil, numero_engagement: nil)
+        structure    = @client.find_structure(siret: invoice.buyer.siret)
+        id_structure = structure["idStructureCPP"] || structure.dig("parametres", "idStructureCPP")
+        raise ValidationError, ::I18n.t("einvoicing.connect.ppf.structure_not_found", siret: invoice.buyer.siret) unless id_structure
+
+        payload = InvoiceAdapter.to_chorus_payload(
+          invoice,
+          id_structure_cpp:  id_structure,
+          code_service:      code_service,
+          numero_engagement: numero_engagement
+        )
+
+        @client.submit_invoice(payload)
+      end
+    end
+  end
+end

data/lib/einvoicing-connect.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+require "einvoicing"
+require_relative "einvoicing/connect/version"
+require_relative "einvoicing/connect/i18n"
+require_relative "einvoicing/fr/siret_lookup"
+require_relative "einvoicing/ppf/errors"
+require_relative "einvoicing/ppf/client"
+require_relative "einvoicing/ppf/invoice_adapter"
+require_relative "einvoicing/ppf/submitter"
+
+module Einvoicing
+  module Connect
+    # einvoicing-connect adds platform connectivity to the einvoicing gem.
+    # Requires: gem "einvoicing-connect" in your Gemfile.
+  end
+end

metadata

@@ -0,0 +1,141 @@
+--- !ruby/object:Gem::Specification
+name: einvoicing-connect
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Nathan Le Ray
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-03-14 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: einvoicing
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.5'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.5'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.13'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.13'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.70'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.70'
+- !ruby/object:Gem::Dependency
+  name: rubocop-rails-omakase
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rubocop-rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+description: Adds French PPF/Chorus Pro invoice submission and SIRET lookup to the
+  einvoicing gem.
+email:
+- nathan@sxnlabs.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- config/locales/en.yml
+- config/locales/fr.yml
+- lib/einvoicing-connect.rb
+- lib/einvoicing/connect.rb
+- lib/einvoicing/connect/i18n.rb
+- lib/einvoicing/connect/version.rb
+- lib/einvoicing/fr/siret_lookup.rb
+- lib/einvoicing/ppf/client.rb
+- lib/einvoicing/ppf/errors.rb
+- lib/einvoicing/ppf/invoice_adapter.rb
+- lib/einvoicing/ppf/submitter.rb
+homepage: https://www.sxnlabs.com/en/gems/einvoicing/
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://www.sxnlabs.com/en/gems/einvoicing/
+  source_code_uri: https://github.com/sxnlabs/einvoicing-connect
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.2'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.22
+signing_key:
+specification_version: 4
+summary: Platform connectors for the einvoicing gem — PPF/Chorus Pro, SIRET lookup
+test_files: []