factpulse 1.0.0 → 1.0.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4b18d85cbff7b4e8aa1f678bc18acba5121fd4b5df4b160a86b785bf56f4ec35
-  data.tar.gz: a7205107926d1a7b97474851c10a6af637281168926dcecc037675a6d3783c2f
+  metadata.gz: 3ce0f1f2fe92c3fa54367c5becea06a2cc0f8a2235e14fdea09a8eb59fe3a336
+  data.tar.gz: 61180b0780bd01888e992885050450d294a5bedbf6ed7487ac18bcc59598a2ce
 SHA512:
-  metadata.gz: 43f8765a2cb63397a997f530c8d050faf120b7bd5be88acb8261f44f4dbfbda376f3dbc472b8194d6fee113246553165d4c19a329a919deae0af54580f96aa4e
-  data.tar.gz: 81cca817bfa1fdbc3d743f3feb49ab8ac19543aa8a2d4cd06f13f8866ebb1330f935e2870f9ee554effcaa548c80c348be98004189961a6e751deb7c044d06f7
+  metadata.gz: 2b2513e2925b6a89191bdc6918c1ab3cd453eb9a672646f244a0688f425e9053efbd2b28187f8593c8a3586b31ab5ee4764112684b031955cfc7d10aee426036
+  data.tar.gz: 6c08603a0b953b86c18e2d9402bb4f93fa3fcafdc8e696c24fc94e8a4cd69dbc789f342f814770380320413682a5b25b62ee62c27365099c1b148e1a35cd2436

data/CHANGELOG.md

@@ -7,7 +7,7 @@ et ce projet adhère au [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
 
 ## [Unreleased]
 
-## [1.0.0] - 2025-11-27
+## [1.0.8] - 2025-11-13
 
 ### Added
 - Version initiale du SDK ruby
@@ -24,5 +24,5 @@ et ce projet adhère au [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
 - 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
+[Unreleased]: https://github.com/factpulse/sdk-ruby/compare/v1.0.8...HEAD
+[1.0.8]: https://github.com/factpulse/sdk-ruby/releases/tag/v1.0.8

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    factpulse (1.0.0)
+    factpulse (1.0.8)
       typhoeus (~> 1.0, >= 1.0.1)
 
 GEM

data/README.md

@@ -8,7 +8,7 @@ Client Ruby officiel pour l'API FactPulse - Facturation électronique française
 - **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`
+- **Traitement asynchrone** : Support Celery pour opérations longues
 - **Ruby 2.7+** : Compatible avec les versions modernes de Ruby
 
 ## 🚀 Installation
@@ -25,175 +25,129 @@ 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 :
+### 1. Authentification
 
 ```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'
-)
+# Configuration du client
+FactPulse.configure do |config|
+  config.host = 'https://factpulse.fr/api/facturation'
+  config.access_token = 'votre_token_jwt'
+end
+
+api_instance = FactPulse::TraitementFactureApi.new
+```
+
+### 2. Générer une facture Factur-X
+
+```ruby
+require 'json'
 
 # Données de la facture
 facture_data = {
-  numero_facture: 'FAC-2025-001',
-  date_facture: '2025-01-15',
+  numero_facture: "FAC-2025-001",
+  date_facture: "2025-01-15",
+  montant_total_ht: "1000.00",
+  montant_total_ttc: "1200.00",
   fournisseur: {
-    nom: 'Mon Entreprise SAS',
-    siret: '12345678901234',
+    nom: "Mon Entreprise SAS",
+    siret: "12345678901234",
     adresse_postale: {
-      ligne_un: '123 Rue Example',
-      code_postal: '75001',
-      nom_ville: 'Paris',
-      pays_code_iso: 'FR'
+      ligne_un: "123 Rue Example",
+      code_postal: "75001",
+      nom_ville: "Paris",
+      pays_code_iso: "FR"
     }
   },
   destinataire: {
-    nom: 'Client SARL',
-    siret: '98765432109876',
+    nom: "Client SARL",
+    siret: "98765432109876",
     adresse_postale: {
-      ligne_un: '456 Avenue Test',
-      code_postal: '69001',
-      nom_ville: 'Lyon',
-      pays_code_iso: 'FR'
+      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'
+    denomination: "Prestation de conseil",
+    quantite: "10.00",
+    montant_unitaire_ht: "100.00",
+    montant_ligne_ht: "1000.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
+# Générer le PDF Factur-X
+pdf_bytes = api_instance.generer_facture_api_v1_traitement_generer_facture_post(
+  facture_data.to_json,
+  'EN16931',
+  'pdf'
 )
 
 # Sauvegarder
-File.binwrite('facture_facturx.pdf', pdf_bytes)
+File.open('facture.pdf', 'wb') { |f| f.write(pdf_bytes) }
+```
+
+### 3. Soumettre une facture complète (Chorus Pro / AFNOR PDP)
+
+```ruby
+response = api_instance.soumettre_facture_complete_api_v1_traitement_factures_soumettre_complete_post({
+  facture: facture_data,
+  destination: {
+    type: "chorus_pro",
+    credentials: {
+      login: "votre_login_chorus",
+      password: "votre_password_chorus"
+    }
+  }
+})
+
+puts "Facture soumise : #{response.id_facture_chorus}"
 ```
 
-### Méthode alternative : SDK brut
+## 🔑 Obtention du token JWT
 
-Pour un contrôle total, utilisez le SDK généré directement :
+### Via l'API
 
 ```ruby
-require 'factpulse'
 require 'net/http'
 require 'json'
+require 'uri'
 
-# 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 = 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)
+result = JSON.parse(response.body)
+token = result['access']
 ```
 
-## 🔧 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
+**Accès aux credentials d'un client spécifique :**
 
-### Client UID (multi-clients)
-
-Si vous gérez plusieurs clients :
+Si vous gérez plusieurs clients et souhaitez accéder aux credentials (Chorus Pro, AFNOR PDP) d'un client particulier, ajoutez le champ `client_uid` :
 
 ```ruby
-client = Factpulse::Helpers::FactPulseClient.new(
-  email: 'votre_email@example.com',
+request.body = {
+  username: '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
-)
+}.to_json
 ```
 
-## 💡 Formats de montants acceptés
-
-L'API accepte plusieurs formats pour les montants :
+### Via le Dashboard
 
-```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"
-```
+1. Connectez-vous sur https://factpulse.fr/api/dashboard/
+2. Générez un token API
+3. Copiez et utilisez le token dans votre configuration
 
 ## 📚 Ressources