cpro-client 0.2.2 → 0.2.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: dc05774f720962053cfcd6f9f11b4fd9521f704d9f40d4e5178a439c37b03ffd
-  data.tar.gz: 63dc3902ac1d84c6bb49f93a0d90b4f1e5035708c69c0a635deef4475bba63d1
+  metadata.gz: eed2218b6135210909bb231938a2adf3d8f9b432a19468576b232ffd2f352d7a
+  data.tar.gz: 95739510c05be2fdc248b2f001e4b53e08b3487162dbb29f50bc26606d929e06
 SHA512:
-  metadata.gz: e627c2faa3a057a63fc84c3fe37aca1fd3a2020175a05c0e40a0216958ff28686460d366eeae61476480a191a0f2bfcfb4eb3cf576aec3c8f0743e771f9143a7
-  data.tar.gz: 95a17ff0f1069454907f6e415b14fdecdf75acdfd959f5d5f30dfcdf8c7532d6f56f0586d7f7fe258234a7fe28de14f6813cfbbd612201579550cbdeae9a9b3b
+  metadata.gz: 7208819c95be0220d40498c3d09c5df5479619c652c6103aac41903ce1cac6054f47b53a7c87638fd7b474e99581a61b6924ab1d0f17b633bb18a72d431e8a94
+  data.tar.gz: 4c292e8c13863bdff0fe54ab567e42880c4d25e5d928ca70fb6c1a83284198912cc14b5dd787f0733763e181a7923f08ab7768a0ee5007b5b4e52b3719c4b7f0

data/CHANGELOG.md

@@ -1,6 +1,40 @@
 ## [Unreleased]
 
 
+## [0.2.3] - 2026-08-31
+
+### Ajouté
+- `Cpro::Resources::Annuaire#find_identifiant_actif` résout une valeur d'adressage — SIREN, SIRET,
+  SIRET_SERVICE ou SIREN_SIRET_SERVICE — vers la ligne d'annuaire active la plus proche : la
+  valeur elle-même si sa plateforme est active, sinon son parent le plus proche, en remontant
+  jusqu'au SIREN. Rend `nil` lorsqu'aucun niveau n'est adressable. Un seul appel réseau, la
+  consultation par SIREN retournant aussi les lignes SIRET et service.
+- `Cpro::Resources::Annuaire#find_lignes_adressage` rend les mêmes lignes sans filtre de
+  plateforme, pour distinguer « unité légale inconnue » de « connue mais sans plateforme active ».
+- `Cpro::Adressage` décompose une valeur d'adressage en SIREN, SIRET et code service. Le code
+  service se lit comme tout ce qui suit le SIRET : il contient lui-même des underscores
+  (`SERVICE_PUBLIQUE_1_71915767420316`) et peut être numérique (`2026`), un découpage sur « _ »
+  serait donc faux. Un SIREN incohérent avec le SIRET qui le suit lève une `ArgumentError`.
+- `Cpro::Entities::LigneAnnuaire#to_s` rend l'identifiant d'adressage, la valeur à porter en BT-49.
+
+### Corrigé
+- `Cpro::Enveloppe.from` prenait un `Pathname` pour un flux, celui-ci répondant à `read` sans
+  porter de `path` : tout dépôt fait à partir d'un `Pathname` — la forme naturelle sous Rails, où
+  les chemins viennent de `Rails.root.join` — échouait sur `ArgumentError (un nom de fichier est
+  requis)` alors même qu'un chemin était fourni. Un `Pathname` est désormais traité comme un
+  chemin, donc relu en binaire plutôt que dans l'encodage par défaut du processus.
+- Les sources qui sont réellement des flux passent en `binmode` avant lecture, pour qu'un IO
+  ouvert en mode texte ne dénature pas le PDF.
+
+
+## [0.2.2] - 2026-08-30
+
+### Corrigé
+- `lib/cpro/middleware/json.rb` et son test étaient absents de la 0.2.1 : n'ayant pas été suivis
+  par git, ils étaient exclus de `spec.files`, que le gemspec construit depuis `git ls-files`. La
+  gem publiée échouait donc au chargement sur `require_relative`.
+
+
 ## [0.2.1] - 2026-08-28
 
 ### Modifié

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    cpro-client (0.2.2)
+    cpro-client (0.2.4)
       faraday (>= 0.9, < 3.0)
 
 GEM

data/README.md

@@ -136,6 +136,34 @@ codes.first.actif?
 
 Filtrez sur `siret`, faute de quoi la réponse balaie tout l'annuaire.
 
+## Adresser une facture
+
+BT-49, l'adresse électronique de l'acheteur, ne se transmet pas à l'API : elle voyage dans le XML
+Factur-X, et c'est d'elle que le PPF déduit l'acheminement. Une facture qui la porte mal est
+rejetée `REJ_ADR` — « le destinataire n'est pas trouvable » — plusieurs minutes après le dépôt.
+
+`find_identifiant_actif` fait la résolution en un appel. Il accepte les quatre formes d'une valeur
+d'adressage — SIREN, SIRET, SIRET_SERVICE, SIREN_SIRET_SERVICE — et remonte la hiérarchie
+SIREN → SIRET → service jusqu'à trouver une ligne dont la plateforme est active :
+
+```ruby
+ligne = client.annuaire.find_identifiant_actif("71915767420316")
+ligne.to_s                  # => "719157674_71915767420316", à porter en BT-49
+ligne.identifiant_routage   # => "" — l'adresse de base de l'établissement
+
+client.annuaire.find_identifiant_actif("71915767420316_SERVICE_INEXISTANT").to_s
+# => "719157674_71915767420316" — service inconnu, on retombe sur son parent
+```
+
+`nil` signifie qu'aucun niveau n'est adressable, donc qu'on ne peut pas facturer. Pour savoir
+*pourquoi*, `find_lignes_adressage` rend les mêmes lignes sans filtrer : une unité légale inconnue
+lève une `Cpro::NotFoundError`, tandis qu'une unité connue mais non raccordée rend ses lignes avec
+`plateforme_active?` à faux.
+
+Deux limites à connaître. La résolution ne redescend jamais vers les enfants : un SIREN nu ne
+remonte rien si la structure n'a d'adresses qu'au niveau SIRET. Et une adresse active n'est pas une
+promesse d'acheminement — elle garantit que le destinataire est identifiable, pas qu'il recevra.
+
 ## Transmission d'une facture Factur-X
 
 ```ruby

data/lib/cpro/adressage.rb

@@ -0,0 +1,70 @@
+# frozen_string_literal: true
+
+module Cpro
+  # Situe une valeur d'adressage dans la hiérarchie de l'annuaire : SIREN → SIRET → service.
+  # Quatre formes sont acceptées — SIREN, SIRET, SIRET_SERVICE et SIREN_SIRET_SERVICE.
+  #
+  # Le service ne se lit jamais par découpage sur « _ » : il en contient lui-même
+  # (SERVICE_PUBLIQUE_1_71915767420316) et peut être purement numérique ("2026"). Il se lit comme
+  # tout ce qui suit le SIRET.
+  class Adressage
+    PREFIXE_SIREN = /\A(\d{9})_(?=\d{14})/.freeze
+    SIRET = /\A(\d{14})/.freeze
+    SIREN_SEUL = /\A(\d{9})\z/.freeze
+
+    attr_reader :siren, :siret, :service
+
+    def self.parse(valeur)
+      texte = valeur.to_s.strip
+      raise ArgumentError, "valeur d'adressage vide" if texte.empty?
+
+      prefixe = texte[PREFIXE_SIREN, 1]
+      reste = prefixe ? texte[10..] : texte
+      depuis_siret(prefixe, reste) || depuis_siren(reste) ||
+        raise(ArgumentError, "valeur d'adressage illisible : #{valeur.inspect} " \
+                             "(attendus : SIREN, SIRET, SIRET_SERVICE ou SIREN_SIRET_SERVICE)")
+    end
+
+    def self.depuis_siret(prefixe, reste)
+      siret = reste[SIRET, 1]
+      return nil if siret.nil?
+
+      raise ArgumentError, "SIREN #{prefixe} incohérent avec le SIRET #{siret}" if prefixe && prefixe != siret[0, 9]
+
+      new(siren: siret[0, 9], siret: siret, service: reste[14..].to_s.sub(/\A_/, ""))
+    end
+    private_class_method :depuis_siret
+
+    def self.depuis_siren(reste)
+      siren = reste[SIREN_SEUL, 1]
+      siren && new(siren: siren, siret: nil, service: nil)
+    end
+    private_class_method :depuis_siren
+
+    def initialize(siren:, siret: nil, service: nil)
+      @siren = siren
+      @siret = siret
+      @service = service.nil? || service.empty? ? nil : service
+    end
+
+    # Du plus précis au plus général : la valeur elle-même, puis ses parents successifs. C'est
+    # l'ordre dans lequel une adresse active est cherchée.
+    def paliers
+      [
+        (self.class.new(siren: siren, siret: siret, service: service) if service),
+        (self.class.new(siren: siren, siret: siret) if siret),
+        self.class.new(siren: siren)
+      ].compact
+    end
+
+    # Une ligne d'annuaire correspond à ce palier si elle décrit le même niveau de précision.
+    def correspond?(ligne)
+      ligne.siret == siret && ligne.identifiant_routage.to_s.empty? == service.nil? &&
+        (service.nil? || ligne.identifiant_routage == service)
+    end
+
+    def to_s
+      [siret ? "#{siren}_#{siret}" : siren, service].compact.join("_")
+    end
+  end
+end

data/lib/cpro/entities/ligne_annuaire.rb

@@ -37,6 +37,11 @@ module Cpro
       def plateforme_en_attente?
         statut_plateforme == PLATEFORME_EN_ATTENTE
       end
+
+      # L'identifiant d'adressage est ce qu'on porte en BT-49 : c'est la valeur utile de la ligne.
+      def to_s
+        identifiant_adressage.to_s
+      end
     end
   end
 end

data/lib/cpro/enveloppe.rb

@@ -17,15 +17,28 @@ module Cpro
     attr_reader :content, :name, :code_interface
 
     def self.from(source, code_interface:, name: nil)
-      if source.respond_to?(:read)
-        resolved = name || (File.basename(source.path) if source.respond_to?(:path))
-        new(content: source.read, name: resolved, code_interface: code_interface)
-      else
-        path = source.to_s
-        new(content: File.binread(path), name: name || File.basename(path),
-            code_interface: code_interface)
-      end
+      return depuis_flux(source, code_interface, name) if flux?(source)
+
+      chemin = source.respond_to?(:to_path) ? source.to_path : source.to_s
+      new(content: File.binread(chemin), name: name || File.basename(chemin),
+          code_interface: code_interface)
+    end
+
+    # Répondre à `read` ne suffit pas à faire un flux : un Pathname en répond aussi, sans être
+    # ouvrable ni porter de `path`. Le distinguer par `binmode`, que tout IO possède et qu'aucun
+    # chemin n'a, évite de le traiter en flux anonyme — et le fait relire en binaire, là où
+    # Pathname#read l'aurait rendu dans l'encodage par défaut.
+    def self.flux?(source)
+      source.respond_to?(:read) && source.respond_to?(:binmode)
+    end
+    private_class_method :flux?
+
+    def self.depuis_flux(source, code_interface, name)
+      source.binmode
+      new(content: source.read, code_interface: code_interface,
+          name: name || (File.basename(source.path) if source.respond_to?(:path)))
     end
+    private_class_method :depuis_flux
 
     def initialize(content:, name:, code_interface:)
       raise ArgumentError, "le contenu du flux est vide" if content.nil? || content.empty?

data/lib/cpro/resources/annuaire.rb

@@ -77,6 +77,33 @@ module Cpro
         Entities::ResultatRecherche.new(payload, item_class: Entities::CodeRoutage, total_key: TOTAL_KEY)
       end
 
+      # Adresse active la plus proche d'une valeur d'adressage : la valeur elle-même si elle porte
+      # une plateforme active, sinon son parent le plus proche, et ainsi de suite jusqu'au SIREN.
+      # Rend la ligne d'annuaire, dont `to_s` donne l'identifiant à porter en BT-49.
+      #
+      # `nil` a un sens unique — aucun niveau n'est adressable, donc on ne peut pas facturer. Pour
+      # distinguer « SIREN inconnu » de « connu mais sans plateforme active », voir
+      # `#find_lignes_adressage`, qui ne filtre pas et laisse remonter le 404.
+      #
+      # Un seul appel réseau : `GET /siren/code-insee:` retourne aussi les lignes SIRET et service.
+      def find_identifiant_actif(valeur)
+        adressage = Adressage.parse(valeur)
+        actives = find_lignes_adressage(adressage).select(&:plateforme_active?)
+        adressage.paliers.each do |palier|
+          ligne = actives.find { |active| palier.correspond?(active) }
+          return ligne if ligne
+        end
+        nil
+      rescue NotFoundError
+        nil
+      end
+
+      # Toutes les lignes d'annuaire de l'unité légale, sans filtre de plateforme.
+      def find_lignes_adressage(valeur, **options)
+        adressage = valeur.is_a?(Adressage) ? valeur : Adressage.parse(valeur)
+        find_by_siren(adressage.siren, **options).lignes_annuaire
+      end
+
       def healthcheck
         get("healthcheck")
       end

data/lib/cpro/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Cpro
-  VERSION = "0.2.2"
+  VERSION = "0.2.4"
 end

data/lib/cpro.rb

@@ -6,6 +6,7 @@ require_relative "cpro/version"
 require_relative "cpro/errors"
 require_relative "cpro/configuration"
 require_relative "cpro/account"
+require_relative "cpro/adressage"
 require_relative "cpro/auth/token"
 require_relative "cpro/auth/token_provider"
 require_relative "cpro/middleware/json"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: cpro-client
 version: !ruby/object:Gem::Version
-  version: 0.2.2
+  version: 0.2.4
 platform: ruby
 authors:
 - Hôtentic
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-08-30 00:00:00.000000000 Z
+date: 2026-09-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -53,6 +53,7 @@ files:
 - lib/cpro-client.rb
 - lib/cpro.rb
 - lib/cpro/account.rb
+- lib/cpro/adressage.rb
 - lib/cpro/archive.rb
 - lib/cpro/auth/token.rb
 - lib/cpro/auth/token_provider.rb