factpulse 1.0.8

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 3ce0f1f2fe92c3fa54367c5becea06a2cc0f8a2235e14fdea09a8eb59fe3a336
+  data.tar.gz: 61180b0780bd01888e992885050450d294a5bedbf6ed7487ac18bcc59598a2ce
+SHA512:
+  metadata.gz: 2b2513e2925b6a89191bdc6918c1ab3cd453eb9a672646f244a0688f425e9053efbd2b28187f8593c8a3586b31ab5ee4764112684b031955cfc7d10aee426036
+  data.tar.gz: 6c08603a0b953b86c18e2d9402bb4f93fa3fcafdc8e696c24fc94e8a4cd69dbc789f342f814770380320413682a5b25b62ee62c27365099c1b148e1a35cd2436

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.8] - 2025-11-13
+
+### 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.8...HEAD
+[1.0.8]: https://github.com/factpulse/sdk-ruby/releases/tag/v1.0.8

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.8)
+      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,161 @@
+# 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)
+- **Traitement asynchrone** : Support Celery pour opérations longues
+- **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
+
+### 1. Authentification
+
+```ruby
+require 'factpulse'
+
+# 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",
+  montant_total_ht: "1000.00",
+  montant_total_ttc: "1200.00",
+  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"
+    }
+  },
+  lignes_de_poste: [{
+    numero: 1,
+    denomination: "Prestation de conseil",
+    quantite: "10.00",
+    montant_unitaire_ht: "100.00",
+    montant_ligne_ht: "1000.00"
+  }]
+}
+
+# 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.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}"
+```
+
+## 🔑 Obtention du token JWT
+
+### Via l'API
+
+```ruby
+require 'net/http'
+require 'json'
+require 'uri'
+
+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)
+result = JSON.parse(response.body)
+token = result['access']
+```
+
+**Accès aux credentials d'un client spécifique :**
+
+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
+request.body = {
+  username: 'votre_email@example.com',
+  password: 'votre_mot_de_passe',
+  client_uid: 'identifiant_client'  # UID du client cible
+}.to_json
+```
+
+### Via le Dashboard
+
+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
+
+- **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
+

data/docs/AFNORPDPPADirectoryServiceApi.md

@@ -0,0 +1,196 @@
+# FactPulse::AFNORPDPPADirectoryServiceApi
+
+All URIs are relative to *http://localhost*
+
+| Method | HTTP request | Description |
+| ------ | ------------ | ----------- |
+| [**directory_healthcheck_proxy_api_v1_afnor_directory_v1_healthcheck_get**](AFNORPDPPADirectoryServiceApi.md#directory_healthcheck_proxy_api_v1_afnor_directory_v1_healthcheck_get) | **GET** /api/v1/afnor/directory/v1/healthcheck | Healthcheck Directory Service |
+| [**get_company_proxy_api_v1_afnor_directory_v1_companies_siren_get**](AFNORPDPPADirectoryServiceApi.md#get_company_proxy_api_v1_afnor_directory_v1_companies_siren_get) | **GET** /api/v1/afnor/directory/v1/companies/{siren} | Récupérer une entreprise |
+| [**search_companies_proxy_api_v1_afnor_directory_v1_companies_search_post**](AFNORPDPPADirectoryServiceApi.md#search_companies_proxy_api_v1_afnor_directory_v1_companies_search_post) | **POST** /api/v1/afnor/directory/v1/companies/search | Rechercher des entreprises |
+
+
+## directory_healthcheck_proxy_api_v1_afnor_directory_v1_healthcheck_get
+
+> Object directory_healthcheck_proxy_api_v1_afnor_directory_v1_healthcheck_get
+
+Healthcheck Directory Service
+
+Vérifier la disponibilité du Directory Service
+
+### Examples
+
+```ruby
+require 'time'
+require 'factpulse'
+
+api_instance = FactPulse::AFNORPDPPADirectoryServiceApi.new
+
+begin
+  # Healthcheck Directory Service
+  result = api_instance.directory_healthcheck_proxy_api_v1_afnor_directory_v1_healthcheck_get
+  p result
+rescue FactPulse::ApiError => e
+  puts "Error when calling AFNORPDPPADirectoryServiceApi->directory_healthcheck_proxy_api_v1_afnor_directory_v1_healthcheck_get: #{e}"
+end
+```
+
+#### Using the directory_healthcheck_proxy_api_v1_afnor_directory_v1_healthcheck_get_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(Object, Integer, Hash)> directory_healthcheck_proxy_api_v1_afnor_directory_v1_healthcheck_get_with_http_info
+
+```ruby
+begin
+  # Healthcheck Directory Service
+  data, status_code, headers = api_instance.directory_healthcheck_proxy_api_v1_afnor_directory_v1_healthcheck_get_with_http_info
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => Object
+rescue FactPulse::ApiError => e
+  puts "Error when calling AFNORPDPPADirectoryServiceApi->directory_healthcheck_proxy_api_v1_afnor_directory_v1_healthcheck_get_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
+
+
+## get_company_proxy_api_v1_afnor_directory_v1_companies_siren_get
+
+> Object get_company_proxy_api_v1_afnor_directory_v1_companies_siren_get(siren)
+
+Récupérer une entreprise
+
+Récupérer les informations d'une entreprise par son SIREN
+
+### Examples
+
+```ruby
+require 'time'
+require 'factpulse'
+
+api_instance = FactPulse::AFNORPDPPADirectoryServiceApi.new
+siren = 'siren_example' # String | 
+
+begin
+  # Récupérer une entreprise
+  result = api_instance.get_company_proxy_api_v1_afnor_directory_v1_companies_siren_get(siren)
+  p result
+rescue FactPulse::ApiError => e
+  puts "Error when calling AFNORPDPPADirectoryServiceApi->get_company_proxy_api_v1_afnor_directory_v1_companies_siren_get: #{e}"
+end
+```
+
+#### Using the get_company_proxy_api_v1_afnor_directory_v1_companies_siren_get_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(Object, Integer, Hash)> get_company_proxy_api_v1_afnor_directory_v1_companies_siren_get_with_http_info(siren)
+
+```ruby
+begin
+  # Récupérer une entreprise
+  data, status_code, headers = api_instance.get_company_proxy_api_v1_afnor_directory_v1_companies_siren_get_with_http_info(siren)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => Object
+rescue FactPulse::ApiError => e
+  puts "Error when calling AFNORPDPPADirectoryServiceApi->get_company_proxy_api_v1_afnor_directory_v1_companies_siren_get_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **siren** | **String** |  |  |
+
+### Return type
+
+**Object**
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## search_companies_proxy_api_v1_afnor_directory_v1_companies_search_post
+
+> Object search_companies_proxy_api_v1_afnor_directory_v1_companies_search_post
+
+Rechercher des entreprises
+
+Rechercher des entreprises dans l'annuaire AFNOR
+
+### Examples
+
+```ruby
+require 'time'
+require 'factpulse'
+
+api_instance = FactPulse::AFNORPDPPADirectoryServiceApi.new
+
+begin
+  # Rechercher des entreprises
+  result = api_instance.search_companies_proxy_api_v1_afnor_directory_v1_companies_search_post
+  p result
+rescue FactPulse::ApiError => e
+  puts "Error when calling AFNORPDPPADirectoryServiceApi->search_companies_proxy_api_v1_afnor_directory_v1_companies_search_post: #{e}"
+end
+```
+
+#### Using the search_companies_proxy_api_v1_afnor_directory_v1_companies_search_post_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(Object, Integer, Hash)> search_companies_proxy_api_v1_afnor_directory_v1_companies_search_post_with_http_info
+
+```ruby
+begin
+  # Rechercher des entreprises
+  data, status_code, headers = api_instance.search_companies_proxy_api_v1_afnor_directory_v1_companies_search_post_with_http_info
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => Object
+rescue FactPulse::ApiError => e
+  puts "Error when calling AFNORPDPPADirectoryServiceApi->search_companies_proxy_api_v1_afnor_directory_v1_companies_search_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
+