factpulse 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 4b18d85cbff7b4e8aa1f678bc18acba5121fd4b5df4b160a86b785bf56f4ec35
+  data.tar.gz: a7205107926d1a7b97474851c10a6af637281168926dcecc037675a6d3783c2f
+SHA512:
+  metadata.gz: 43f8765a2cb63397a997f530c8d050faf120b7bd5be88acb8261f44f4dbfbda376f3dbc472b8194d6fee113246553165d4c19a329a919deae0af54580f96aa4e
+  data.tar.gz: 81cca817bfa1fdbc3d743f3feb49ab8ac19543aa8a2d4cd06f13f8866ebb1330f935e2870f9ee554effcaa548c80c348be98004189961a6e751deb7c044d06f7

data/CHANGELOG.md

@@ -0,0 +1,28 @@
+# Changelog
+
+Toutes les modifications notables de ce projet seront documentées dans ce fichier.
+
+Le format est basé sur [Keep a Changelog](https://keepachangelog.com/fr/1.0.0/),
+et ce projet adhère au [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [1.0.0] - 2025-11-27
+
+### Added
+- Version initiale du SDK ruby
+- Support complet de l'API FactPulse v1.0.0
+- Endpoints Factur-X (génération, validation)
+- Endpoints AFNOR PDP/PA (Flow Service, Directory Service)
+- Endpoints Chorus Pro (recherche entreprise, soumission factures)
+- Endpoints Signature électronique (PAdES-B-B, PAdES-B-T, PAdES-B-LT)
+- Support des deux modes d'authentification (stored credentials et zero-trust)
+- Documentation complète et exemples
+
+### Documentation
+- README.md avec quickstart et exemples
+- Guide d'authentification JWT
+- Configuration avancée (timeout, proxy, debug)
+
+[Unreleased]: https://github.com/factpulse/sdk-ruby/compare/v1.0.0...HEAD
+[1.0.0]: https://github.com/factpulse/sdk-ruby/releases/tag/v1.0.0

data/Gemfile

@@ -0,0 +1,9 @@
+source 'https://rubygems.org'
+
+gemspec
+
+group :development, :test do
+  gem 'rake', '~> 13.0.1'
+  gem 'pry-byebug'
+  gem 'rubocop', '~> 0.66.0'
+end

data/Gemfile.lock

@@ -0,0 +1,74 @@
+PATH
+  remote: .
+  specs:
+    factpulse (1.0.0)
+      typhoeus (~> 1.0, >= 1.0.1)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    ast (2.4.3)
+    byebug (11.1.3)
+    coderay (1.1.3)
+    date (3.5.0)
+    diff-lcs (1.6.2)
+    ethon (0.15.0)
+      ffi (>= 1.15.0)
+    ffi (1.17.2)
+    jaro_winkler (1.5.6)
+    method_source (1.1.0)
+    parallel (1.27.0)
+    parser (3.3.10.0)
+      ast (~> 2.4.1)
+      racc
+    pry (0.14.2)
+      coderay (~> 1.1)
+      method_source (~> 1.0)
+    pry-byebug (3.10.1)
+      byebug (~> 11.0)
+      pry (>= 0.13, < 0.15)
+    psych (5.2.6)
+      date
+      stringio
+    racc (1.8.1)
+    rainbow (3.1.1)
+    rake (13.0.6)
+    rspec (3.13.2)
+      rspec-core (~> 3.13.0)
+      rspec-expectations (~> 3.13.0)
+      rspec-mocks (~> 3.13.0)
+    rspec-core (3.13.6)
+      rspec-support (~> 3.13.0)
+    rspec-expectations (3.13.5)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-mocks (3.13.7)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-support (3.13.6)
+    rubocop (0.66.0)
+      jaro_winkler (~> 1.5.1)
+      parallel (~> 1.10)
+      parser (>= 2.5, != 2.5.1.1)
+      psych (>= 3.1.0)
+      rainbow (>= 2.2.2, < 4.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 1.4.0, < 1.6)
+    ruby-progressbar (1.13.0)
+    stringio (3.1.8)
+    typhoeus (1.5.0)
+      ethon (>= 0.9.0, < 0.16.0)
+    unicode-display_width (1.5.0)
+
+PLATFORMS
+  x86_64-linux
+
+DEPENDENCIES
+  factpulse!
+  pry-byebug
+  rake (~> 13.0.1)
+  rspec (~> 3.6, >= 3.6.0)
+  rubocop (~> 0.66.0)
+
+BUNDLED WITH
+   2.2.33

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 FactPulse
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,207 @@
+# FactPulse SDK Ruby
+
+Client Ruby officiel pour l'API FactPulse - Facturation électronique française.
+
+## 🎯 Fonctionnalités
+
+- **Factur-X** : Génération et validation de factures électroniques (profils MINIMUM, BASIC, EN16931, EXTENDED)
+- **Chorus Pro** : Intégration avec la plateforme de facturation publique française
+- **AFNOR PDP/PA** : Soumission de flux conformes à la norme XP Z12-013
+- **Signature électronique** : Signature PDF (PAdES-B-B, PAdES-B-T, PAdES-B-LT)
+- **Client simplifié** : Authentification JWT et polling intégrés via `helpers`
+- **Ruby 2.7+** : Compatible avec les versions modernes de Ruby
+
+## 🚀 Installation
+
+```bash
+gem install factpulse
+```
+
+Ou dans votre Gemfile :
+
+```ruby
+gem 'factpulse'
+```
+
+## 📖 Démarrage rapide
+
+### Méthode recommandée : Client simplifié avec helpers
+
+Le module `helpers` offre une API simplifiée avec authentification et polling automatiques :
+
+```ruby
+require 'factpulse'
+require 'factpulse/helpers'
+
+# Créer le client (authentification automatique)
+client = Factpulse::Helpers::FactPulseClient.new(
+  email: 'votre_email@example.com',
+  password: 'votre_mot_de_passe'
+)
+
+# Données de la facture
+facture_data = {
+  numero_facture: 'FAC-2025-001',
+  date_facture: '2025-01-15',
+  fournisseur: {
+    nom: 'Mon Entreprise SAS',
+    siret: '12345678901234',
+    adresse_postale: {
+      ligne_un: '123 Rue Example',
+      code_postal: '75001',
+      nom_ville: 'Paris',
+      pays_code_iso: 'FR'
+    }
+  },
+  destinataire: {
+    nom: 'Client SARL',
+    siret: '98765432109876',
+    adresse_postale: {
+      ligne_un: '456 Avenue Test',
+      code_postal: '69001',
+      nom_ville: 'Lyon',
+      pays_code_iso: 'FR'
+    }
+  },
+  montant_total: {
+    montant_ht_total: '1000.00',
+    montant_tva: '200.00',
+    montant_ttc_total: '1200.00',
+    montant_a_payer: '1200.00'
+  },
+  lignes_de_poste: [{
+    numero: 1,
+    denomination: 'Prestation de conseil',
+    quantite: '10.00',
+    unite: 'PIECE',
+    montant_unitaire_ht: '100.00'
+  }]
+}
+
+# Lire le PDF source
+pdf_source = File.binread('facture_source.pdf')
+
+# Générer le PDF Factur-X (polling automatique)
+pdf_bytes = client.generer_facturx(
+  facture_data,
+  pdf_source,
+  profil: 'EN16931',
+  format_sortie: 'pdf',
+  sync: true  # Attend le résultat automatiquement
+)
+
+# Sauvegarder
+File.binwrite('facture_facturx.pdf', pdf_bytes)
+```
+
+### Méthode alternative : SDK brut
+
+Pour un contrôle total, utilisez le SDK généré directement :
+
+```ruby
+require 'factpulse'
+require 'net/http'
+require 'json'
+
+# 1. Obtenir le token JWT
+uri = URI('https://factpulse.fr/api/token/')
+http = Net::HTTP.new(uri.host, uri.port)
+http.use_ssl = true
+
+request = Net::HTTP::Post.new(uri.path, { 'Content-Type' => 'application/json' })
+request.body = {
+  username: 'votre_email@example.com',
+  password: 'votre_mot_de_passe'
+}.to_json
+
+response = http.request(request)
+token = JSON.parse(response.body)['access']
+
+# 2. Configurer le client
+Factpulse.configure do |config|
+  config.host = 'https://factpulse.fr/api/facturation'
+  config.access_token = token
+end
+
+# 3. Appeler l'API
+api = Factpulse::TraitementFactureApi.new
+response = api.generer_facture_api_v1_traitement_generer_facture_post(
+  facture_data.to_json,
+  'EN16931',
+  'pdf',
+  File.open('facture_source.pdf', 'rb')
+)
+
+# 4. Polling manuel pour récupérer le résultat
+task_id = response.id_tache
+# ... (implémenter le polling)
+```
+
+## 🔧 Avantages des helpers
+
+| Fonctionnalité | SDK brut | helpers |
+|----------------|----------|---------|
+| Authentification | Manuelle | Automatique |
+| Refresh token | Manuel | Automatique |
+| Polling tâches async | Manuel | Automatique (backoff) |
+| Retry sur 401 | Manuel | Automatique |
+
+## 🔑 Options d'authentification
+
+### Client UID (multi-clients)
+
+Si vous gérez plusieurs clients :
+
+```ruby
+client = Factpulse::Helpers::FactPulseClient.new(
+  email: 'votre_email@example.com',
+  password: 'votre_mot_de_passe',
+  client_uid: 'identifiant_client'  # UID du client cible
+)
+```
+
+### Configuration avancée
+
+```ruby
+client = Factpulse::Helpers::FactPulseClient.new(
+  email: 'votre_email@example.com',
+  password: 'votre_mot_de_passe',
+  api_url: 'https://factpulse.fr',  # URL personnalisée
+  polling_interval: 2.0,  # Intervalle de polling initial (secondes)
+  polling_timeout: 120.0,  # Timeout de polling (secondes)
+  max_retries: 2  # Tentatives en cas de 401
+)
+```
+
+## 💡 Formats de montants acceptés
+
+L'API accepte plusieurs formats pour les montants :
+
+```ruby
+# String (recommandé pour la précision)
+montant = '1234.56'
+
+# Float
+montant = 1234.56
+
+# Integer
+montant = 1234
+
+# BigDecimal
+require 'bigdecimal'
+montant = BigDecimal('1234.56')
+
+# Helper de formatage
+montant_formate = Factpulse::Helpers::FactPulseClient.format_montant(1234.5)  # => "1234.50"
+```
+
+## 📚 Ressources
+
+- **Documentation API** : https://factpulse.fr/api/facturation/documentation
+- **Code source** : https://github.com/factpulse/sdk-ruby
+- **Issues** : https://github.com/factpulse/sdk-ruby/issues
+- **Support** : contact@factpulse.fr
+
+## 📄 Licence
+
+MIT License - Copyright (c) 2025 FactPulse

data/Rakefile

@@ -0,0 +1,10 @@
+require "bundler/gem_tasks"
+
+begin
+  require 'rspec/core/rake_task'
+
+  RSpec::Core::RakeTask.new(:spec)
+  task default: :spec
+rescue LoadError
+  # no rspec available
+end

data/docs/AFNORPDPPAApi.md

@@ -0,0 +1,69 @@
+# FactPulse::AFNORPDPPAApi
+
+All URIs are relative to *http://localhost*
+
+| Method | HTTP request | Description |
+| ------ | ------------ | ----------- |
+| [**oauth_token_proxy_api_v1_afnor_oauth_token_post**](AFNORPDPPAApi.md#oauth_token_proxy_api_v1_afnor_oauth_token_post) | **POST** /api/v1/afnor/oauth/token | Endpoint OAuth2 pour authentification AFNOR |
+
+
+## oauth_token_proxy_api_v1_afnor_oauth_token_post
+
+> Object oauth_token_proxy_api_v1_afnor_oauth_token_post
+
+Endpoint OAuth2 pour authentification AFNOR
+
+Endpoint proxy OAuth2 pour obtenir un token d'accès AFNOR. Fait proxy vers le mock AFNOR (sandbox) ou la vraie PDP selon MOCK_AFNOR_BASE_URL. Cet endpoint est public (pas d'auth Django requise) car il est appelé par le SDK AFNOR.
+
+### Examples
+
+```ruby
+require 'time'
+require 'factpulse'
+
+api_instance = FactPulse::AFNORPDPPAApi.new
+
+begin
+  # Endpoint OAuth2 pour authentification AFNOR
+  result = api_instance.oauth_token_proxy_api_v1_afnor_oauth_token_post
+  p result
+rescue FactPulse::ApiError => e
+  puts "Error when calling AFNORPDPPAApi->oauth_token_proxy_api_v1_afnor_oauth_token_post: #{e}"
+end
+```
+
+#### Using the oauth_token_proxy_api_v1_afnor_oauth_token_post_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(Object, Integer, Hash)> oauth_token_proxy_api_v1_afnor_oauth_token_post_with_http_info
+
+```ruby
+begin
+  # Endpoint OAuth2 pour authentification AFNOR
+  data, status_code, headers = api_instance.oauth_token_proxy_api_v1_afnor_oauth_token_post_with_http_info
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => Object
+rescue FactPulse::ApiError => e
+  puts "Error when calling AFNORPDPPAApi->oauth_token_proxy_api_v1_afnor_oauth_token_post_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+This endpoint does not need any parameter.
+
+### Return type
+
+**Object**
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+