factpulse 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (205) hide show
  1. checksums.yaml +7 -0
  2. data/CHANGELOG.md +28 -0
  3. data/Gemfile +9 -0
  4. data/Gemfile.lock +74 -0
  5. data/LICENSE +21 -0
  6. data/README.md +207 -0
  7. data/Rakefile +10 -0
  8. data/docs/AFNORPDPPAApi.md +69 -0
  9. data/docs/AFNORPDPPADirectoryServiceApi.md +1313 -0
  10. data/docs/AFNORPDPPAFlowServiceApi.md +258 -0
  11. data/docs/APIError.md +22 -0
  12. data/docs/AdresseElectronique.md +20 -0
  13. data/docs/AdressePostale.md +26 -0
  14. data/docs/CadreDeFacturation.md +22 -0
  15. data/docs/CategorieTVA.md +15 -0
  16. data/docs/CertificateInfoResponse.md +40 -0
  17. data/docs/ChorusProApi.md +1125 -0
  18. data/docs/ChorusProCredentials.md +26 -0
  19. data/docs/CodeCadreFacturation.md +15 -0
  20. data/docs/CodeRaisonReduction.md +15 -0
  21. data/docs/ConsulterFactureRequest.md +20 -0
  22. data/docs/ConsulterFactureResponse.md +34 -0
  23. data/docs/ConsulterStructureRequest.md +22 -0
  24. data/docs/ConsulterStructureResponse.md +34 -0
  25. data/docs/CredentialsAFNOR.md +22 -0
  26. data/docs/CredentialsChorusPro.md +26 -0
  27. data/docs/Destinataire.md +28 -0
  28. data/docs/Destination.md +79 -0
  29. data/docs/DestinationAFNOR.md +24 -0
  30. data/docs/DestinationChorusPro.md +20 -0
  31. data/docs/DonneesFactureSimplifiees.md +34 -0
  32. data/docs/ErrorLevel.md +15 -0
  33. data/docs/ErrorSource.md +15 -0
  34. data/docs/FactureEnrichieInfo.md +32 -0
  35. data/docs/FactureFacturX.md +46 -0
  36. data/docs/FormatSortie.md +15 -0
  37. data/docs/Fournisseur.md +36 -0
  38. data/docs/GenerateCertificateRequest.md +38 -0
  39. data/docs/GenerateCertificateResponse.md +32 -0
  40. data/docs/HTTPValidationError.md +18 -0
  41. data/docs/InformationSignatureAPI.md +28 -0
  42. data/docs/LigneDePoste.md +46 -0
  43. data/docs/LigneDePosteMontantRemiseHt.md +15 -0
  44. data/docs/LigneDePosteTauxTvaManuel.md +15 -0
  45. data/docs/LigneDeTVA.md +26 -0
  46. data/docs/ModeDepot.md +15 -0
  47. data/docs/ModePaiement.md +15 -0
  48. data/docs/MontantAPayer.md +15 -0
  49. data/docs/MontantBaseHt.md +15 -0
  50. data/docs/MontantHtTotal.md +15 -0
  51. data/docs/MontantRemiseGlobaleTtc.md +15 -0
  52. data/docs/MontantTotal.md +30 -0
  53. data/docs/MontantTotalAcompte.md +15 -0
  54. data/docs/MontantTotalLigneHt.md +15 -0
  55. data/docs/MontantTtcTotal.md +15 -0
  56. data/docs/MontantTva.md +15 -0
  57. data/docs/MontantTvaLigne.md +15 -0
  58. data/docs/MontantTvaTotal.md +15 -0
  59. data/docs/MontantUnitaireHt.md +15 -0
  60. data/docs/Note.md +20 -0
  61. data/docs/ObtenirIdChorusProRequest.md +22 -0
  62. data/docs/ObtenirIdChorusProResponse.md +24 -0
  63. data/docs/OptionsProcessing.md +24 -0
  64. data/docs/PDFFacturXInfo.md +22 -0
  65. data/docs/ParametresSignature.md +34 -0
  66. data/docs/ParametresStructure.md +22 -0
  67. data/docs/PieceJointeComplementaire.md +26 -0
  68. data/docs/ProfilAPI.md +15 -0
  69. data/docs/Quantite.md +15 -0
  70. data/docs/RechercherServicesResponse.md +24 -0
  71. data/docs/RechercherStructureRequest.md +26 -0
  72. data/docs/RechercherStructureResponse.md +24 -0
  73. data/docs/References.md +32 -0
  74. data/docs/ReponseTache.md +18 -0
  75. data/docs/ReponseValidationErreur.md +18 -0
  76. data/docs/ReponseValidationSucces.md +18 -0
  77. data/docs/ResultatAFNOR.md +26 -0
  78. data/docs/ResultatChorusPro.md +22 -0
  79. data/docs/ResultatValidationPDFAPI.md +62 -0
  80. data/docs/SantApi.md +131 -0
  81. data/docs/SchemeID.md +15 -0
  82. data/docs/ServiceStructure.md +24 -0
  83. data/docs/SignatureInfo.md +22 -0
  84. data/docs/SoumettreFactureCompleteRequest.md +26 -0
  85. data/docs/SoumettreFactureCompleteResponse.md +34 -0
  86. data/docs/SoumettreFactureRequest.md +46 -0
  87. data/docs/SoumettreFactureResponse.md +24 -0
  88. data/docs/StatutCelery.md +15 -0
  89. data/docs/StatutFacture.md +22 -0
  90. data/docs/StatutTache.md +22 -0
  91. data/docs/StructureInfo.md +26 -0
  92. data/docs/Tauxmanuel.md +15 -0
  93. data/docs/TraitementFactureApi.md +831 -0
  94. data/docs/TypeFacture.md +15 -0
  95. data/docs/TypeTVA.md +15 -0
  96. data/docs/Unite.md +15 -0
  97. data/docs/UtilisateurApi.md +74 -0
  98. data/docs/ValidationError.md +22 -0
  99. data/docs/ValidationErrorDetail.md +26 -0
  100. data/docs/ValidationErrorLocInner.md +15 -0
  101. data/factpulse.gemspec +39 -0
  102. data/git_push.sh +57 -0
  103. data/lib/factpulse/api/afnorpdppa_api.rb +79 -0
  104. data/lib/factpulse/api/afnorpdppa_directory_service_api.rb +1183 -0
  105. data/lib/factpulse/api/afnorpdppa_flow_service_api.rb +256 -0
  106. data/lib/factpulse/api/chorus_pro_api.rb +1103 -0
  107. data/lib/factpulse/api/sant_api.rb +136 -0
  108. data/lib/factpulse/api/traitement_facture_api.rb +835 -0
  109. data/lib/factpulse/api/utilisateur_api.rb +79 -0
  110. data/lib/factpulse/api_client.rb +397 -0
  111. data/lib/factpulse/api_error.rb +58 -0
  112. data/lib/factpulse/api_model_base.rb +88 -0
  113. data/lib/factpulse/configuration.rb +308 -0
  114. data/lib/factpulse/helpers/client.rb +300 -0
  115. data/lib/factpulse/helpers/exceptions.rb +21 -0
  116. data/lib/factpulse/helpers.rb +13 -0
  117. data/lib/factpulse/models/adresse_electronique.rb +196 -0
  118. data/lib/factpulse/models/adresse_postale.rb +189 -0
  119. data/lib/factpulse/models/api_error.rb +205 -0
  120. data/lib/factpulse/models/cadre_de_facturation.rb +207 -0
  121. data/lib/factpulse/models/categorie_tva.rb +47 -0
  122. data/lib/factpulse/models/certificate_info_response.rb +446 -0
  123. data/lib/factpulse/models/chorus_pro_credentials.rb +259 -0
  124. data/lib/factpulse/models/code_cadre_facturation.rb +42 -0
  125. data/lib/factpulse/models/code_raison_reduction.rb +45 -0
  126. data/lib/factpulse/models/consulter_facture_request.rb +176 -0
  127. data/lib/factpulse/models/consulter_facture_response.rb +261 -0
  128. data/lib/factpulse/models/consulter_structure_request.rb +188 -0
  129. data/lib/factpulse/models/consulter_structure_response.rb +261 -0
  130. data/lib/factpulse/models/credentials_afnor.rb +169 -0
  131. data/lib/factpulse/models/credentials_chorus_pro.rb +191 -0
  132. data/lib/factpulse/models/destinataire.rb +215 -0
  133. data/lib/factpulse/models/destination.rb +56 -0
  134. data/lib/factpulse/models/destination_afnor.rb +228 -0
  135. data/lib/factpulse/models/destination_chorus_pro.rb +194 -0
  136. data/lib/factpulse/models/donnees_facture_simplifiees.rb +342 -0
  137. data/lib/factpulse/models/error_level.rb +40 -0
  138. data/lib/factpulse/models/error_source.rb +46 -0
  139. data/lib/factpulse/models/facture_enrichie_info.rb +348 -0
  140. data/lib/factpulse/models/facture_factur_x.rb +443 -0
  141. data/lib/factpulse/models/format_sortie.rb +40 -0
  142. data/lib/factpulse/models/fournisseur.rb +271 -0
  143. data/lib/factpulse/models/generate_certificate_request.rb +323 -0
  144. data/lib/factpulse/models/generate_certificate_response.rb +254 -0
  145. data/lib/factpulse/models/http_validation_error.rb +149 -0
  146. data/lib/factpulse/models/information_signature_api.rb +216 -0
  147. data/lib/factpulse/models/ligne_de_poste.rb +390 -0
  148. data/lib/factpulse/models/ligne_de_poste_montant_remise_ht.rb +104 -0
  149. data/lib/factpulse/models/ligne_de_poste_taux_tva_manuel.rb +104 -0
  150. data/lib/factpulse/models/ligne_de_tva.rb +242 -0
  151. data/lib/factpulse/models/mode_depot.rb +41 -0
  152. data/lib/factpulse/models/mode_paiement.rb +44 -0
  153. data/lib/factpulse/models/montant_a_payer.rb +104 -0
  154. data/lib/factpulse/models/montant_base_ht.rb +104 -0
  155. data/lib/factpulse/models/montant_ht_total.rb +104 -0
  156. data/lib/factpulse/models/montant_remise_globale_ttc.rb +104 -0
  157. data/lib/factpulse/models/montant_total.rb +272 -0
  158. data/lib/factpulse/models/montant_total_acompte.rb +104 -0
  159. data/lib/factpulse/models/montant_total_ligne_ht.rb +104 -0
  160. data/lib/factpulse/models/montant_ttc_total.rb +104 -0
  161. data/lib/factpulse/models/montant_tva.rb +104 -0
  162. data/lib/factpulse/models/montant_tva_ligne.rb +104 -0
  163. data/lib/factpulse/models/montant_tva_total.rb +104 -0
  164. data/lib/factpulse/models/montant_unitaire_ht.rb +104 -0
  165. data/lib/factpulse/models/note.rb +175 -0
  166. data/lib/factpulse/models/obtenir_id_chorus_pro_request.rb +188 -0
  167. data/lib/factpulse/models/obtenir_id_chorus_pro_response.rb +230 -0
  168. data/lib/factpulse/models/options_processing.rb +207 -0
  169. data/lib/factpulse/models/parametres_signature.rb +235 -0
  170. data/lib/factpulse/models/parametres_structure.rb +175 -0
  171. data/lib/factpulse/models/pdf_factur_x_info.rb +205 -0
  172. data/lib/factpulse/models/piece_jointe_complementaire.rb +269 -0
  173. data/lib/factpulse/models/profil_api.rb +42 -0
  174. data/lib/factpulse/models/quantite.rb +104 -0
  175. data/lib/factpulse/models/rechercher_services_response.rb +214 -0
  176. data/lib/factpulse/models/rechercher_structure_request.rb +191 -0
  177. data/lib/factpulse/models/rechercher_structure_response.rb +216 -0
  178. data/lib/factpulse/models/references.rb +290 -0
  179. data/lib/factpulse/models/reponse_tache.rb +165 -0
  180. data/lib/factpulse/models/reponse_validation_erreur.rb +167 -0
  181. data/lib/factpulse/models/reponse_validation_succes.rb +165 -0
  182. data/lib/factpulse/models/resultat_afnor.rb +240 -0
  183. data/lib/factpulse/models/resultat_chorus_pro.rb +186 -0
  184. data/lib/factpulse/models/resultat_validation_pdfapi.rb +523 -0
  185. data/lib/factpulse/models/scheme_id.rb +43 -0
  186. data/lib/factpulse/models/service_structure.rb +247 -0
  187. data/lib/factpulse/models/signature_info.rb +186 -0
  188. data/lib/factpulse/models/soumettre_facture_complete_request.rb +239 -0
  189. data/lib/factpulse/models/soumettre_facture_complete_response.rb +355 -0
  190. data/lib/factpulse/models/soumettre_facture_request.rb +388 -0
  191. data/lib/factpulse/models/soumettre_facture_response.rb +213 -0
  192. data/lib/factpulse/models/statut_celery.rb +43 -0
  193. data/lib/factpulse/models/statut_facture.rb +203 -0
  194. data/lib/factpulse/models/statut_tache.rb +226 -0
  195. data/lib/factpulse/models/structure_info.rb +274 -0
  196. data/lib/factpulse/models/tauxmanuel.rb +104 -0
  197. data/lib/factpulse/models/type_facture.rb +40 -0
  198. data/lib/factpulse/models/type_tva.rb +42 -0
  199. data/lib/factpulse/models/unite.rb +44 -0
  200. data/lib/factpulse/models/validation_error.rb +218 -0
  201. data/lib/factpulse/models/validation_error_detail.rb +245 -0
  202. data/lib/factpulse/models/validation_error_loc_inner.rb +103 -0
  203. data/lib/factpulse/version.rb +15 -0
  204. data/lib/factpulse.rb +133 -0
  205. metadata +345 -0
data/lib/factpulse.rb ADDED
@@ -0,0 +1,133 @@
1
+ =begin
2
+ #API REST FactPulse
3
+
4
+ # API REST pour la facturation électronique en France : Factur-X, AFNOR PDP/PA, signatures électroniques. ## 🎯 Fonctionnalités principales ### 📄 Génération de factures Factur-X - **Formats** : XML seul ou PDF/A-3 avec XML embarqué - **Profils** : MINIMUM, BASIC, EN16931, EXTENDED - **Normes** : EN 16931 (directive UE 2014/55), ISO 19005-3 (PDF/A-3), CII (UN/CEFACT) - **🆕 Format simplifié** : Génération à partir de SIRET + auto-enrichissement (API Chorus Pro + Recherche Entreprises) ### ✅ Validation et conformité - **Validation XML** : Schematron (45 à 210+ règles selon profil) - **Validation PDF** : PDF/A-3, métadonnées XMP Factur-X, signatures électroniques - **VeraPDF** : Validation stricte PDF/A (146+ règles ISO 19005-3) - **Traitement asynchrone** : Support Celery pour validations lourdes (VeraPDF) ### 📡 Intégration AFNOR PDP/PA (XP Z12-013) - **Soumission de flux** : Envoi de factures vers Plateformes de Dématérialisation Partenaires - **Recherche de flux** : Consultation des factures soumises - **Téléchargement** : Récupération des PDF/A-3 avec XML - **Directory Service** : Recherche d'entreprises (SIREN/SIRET) - **Multi-client** : Support de plusieurs configs PDP par utilisateur (stored credentials ou zero-storage) ### ✍️ Signature électronique PDF - **Standards** : PAdES-B-B, PAdES-B-T (horodatage RFC 3161), PAdES-B-LT (archivage long terme) - **Niveaux eIDAS** : SES (auto-signé), AdES (CA commerciale), QES (PSCO) - **Validation** : Vérification intégrité cryptographique et certificats - **Génération de certificats** : Certificats X.509 auto-signés pour tests ### 🔄 Traitement asynchrone - **Celery** : Génération, validation et signature asynchrones - **Polling** : Suivi d'état via `/taches/{id_tache}/statut` - **Pas de timeout** : Idéal pour gros fichiers ou validations lourdes ## 🔒 Authentification Toutes les requêtes nécessitent un **token JWT** dans le header Authorization : ``` Authorization: Bearer YOUR_JWT_TOKEN ``` ### Comment obtenir un token JWT ? #### 🔑 Méthode 1 : API `/api/token/` (Recommandée) **URL :** `https://www.factpulse.fr/api/token/` Cette méthode est **recommandée** pour l'intégration dans vos applications et workflows CI/CD. **Prérequis :** Avoir défini un mot de passe sur votre compte **Pour les utilisateurs inscrits via email/password :** - Vous avez déjà un mot de passe, utilisez-le directement **Pour les utilisateurs inscrits via OAuth (Google/GitHub) :** - Vous devez d'abord définir un mot de passe sur : https://www.factpulse.fr/accounts/password/set/ - Une fois le mot de passe créé, vous pourrez utiliser l'API **Exemple de requête :** ```bash curl -X POST https://www.factpulse.fr/api/token/ \\ -H \"Content-Type: application/json\" \\ -d '{ \"username\": \"votre_email@example.com\", \"password\": \"votre_mot_de_passe\" }' ``` **Paramètre optionnel `client_uid` :** Pour sélectionner les credentials d'un client spécifique (PA/PDP, Chorus Pro, certificats de signature), ajoutez `client_uid` : ```bash curl -X POST https://www.factpulse.fr/api/token/ \\ -H \"Content-Type: application/json\" \\ -d '{ \"username\": \"votre_email@example.com\", \"password\": \"votre_mot_de_passe\", \"client_uid\": \"550e8400-e29b-41d4-a716-446655440000\" }' ``` Le `client_uid` sera inclus dans le JWT et permettra à l'API d'utiliser automatiquement : - Les credentials AFNOR/PDP configurés pour ce client - Les credentials Chorus Pro configurés pour ce client - Les certificats de signature électronique configurés pour ce client **Réponse :** ```json { \"access\": \"eyJ0eXAiOiJKV1QiLCJhbGc...\", // Token d'accès (validité: 30 min) \"refresh\": \"eyJ0eXAiOiJKV1QiLCJhbGc...\" // Token de rafraîchissement (validité: 7 jours) } ``` **Avantages :** - ✅ Automatisation complète (CI/CD, scripts) - ✅ Gestion programmatique des tokens - ✅ Support du refresh token pour renouveler automatiquement l'accès - ✅ Intégration facile dans n'importe quel langage/outil #### 🖥️ Méthode 2 : Génération via Dashboard (Alternative) **URL :** https://www.factpulse.fr/dashboard/ Cette méthode convient pour des tests rapides ou une utilisation occasionnelle via l'interface graphique. **Fonctionnement :** - Connectez-vous au dashboard - Utilisez les boutons \"Generate Test Token\" ou \"Generate Production Token\" - Fonctionne pour **tous** les utilisateurs (OAuth et email/password), sans nécessiter de mot de passe **Types de tokens :** - **Token Test** : Validité 24h, quota 1000 appels/jour (gratuit) - **Token Production** : Validité 7 jours, quota selon votre forfait **Avantages :** - ✅ Rapide pour tester l'API - ✅ Aucun mot de passe requis - ✅ Interface visuelle simple **Inconvénients :** - ❌ Nécessite une action manuelle - ❌ Pas de refresh token - ❌ Moins adapté pour l'automatisation ### 📚 Documentation complète Pour plus d'informations sur l'authentification et l'utilisation de l'API : https://www.factpulse.fr/documentation-api/
5
+
6
+ The version of the OpenAPI document: 1.0.0
7
+
8
+ Generated by: https://openapi-generator.tech
9
+ Generator version: 7.18.0-SNAPSHOT
10
+
11
+ =end
12
+
13
+ # Common files
14
+ require 'factpulse/api_client'
15
+ require 'factpulse/api_error'
16
+ require 'factpulse/api_model_base'
17
+ require 'factpulse/version'
18
+ require 'factpulse/configuration'
19
+
20
+ # Models
21
+ require 'factpulse/models/api_error'
22
+ require 'factpulse/models/adresse_electronique'
23
+ require 'factpulse/models/adresse_postale'
24
+ require 'factpulse/models/cadre_de_facturation'
25
+ require 'factpulse/models/categorie_tva'
26
+ require 'factpulse/models/certificate_info_response'
27
+ require 'factpulse/models/chorus_pro_credentials'
28
+ require 'factpulse/models/code_cadre_facturation'
29
+ require 'factpulse/models/code_raison_reduction'
30
+ require 'factpulse/models/consulter_facture_request'
31
+ require 'factpulse/models/consulter_facture_response'
32
+ require 'factpulse/models/consulter_structure_request'
33
+ require 'factpulse/models/consulter_structure_response'
34
+ require 'factpulse/models/credentials_afnor'
35
+ require 'factpulse/models/credentials_chorus_pro'
36
+ require 'factpulse/models/destinataire'
37
+ require 'factpulse/models/destination'
38
+ require 'factpulse/models/destination_afnor'
39
+ require 'factpulse/models/destination_chorus_pro'
40
+ require 'factpulse/models/donnees_facture_simplifiees'
41
+ require 'factpulse/models/error_level'
42
+ require 'factpulse/models/error_source'
43
+ require 'factpulse/models/facture_enrichie_info'
44
+ require 'factpulse/models/facture_factur_x'
45
+ require 'factpulse/models/format_sortie'
46
+ require 'factpulse/models/fournisseur'
47
+ require 'factpulse/models/generate_certificate_request'
48
+ require 'factpulse/models/generate_certificate_response'
49
+ require 'factpulse/models/http_validation_error'
50
+ require 'factpulse/models/information_signature_api'
51
+ require 'factpulse/models/ligne_de_poste'
52
+ require 'factpulse/models/ligne_de_poste_montant_remise_ht'
53
+ require 'factpulse/models/ligne_de_poste_taux_tva_manuel'
54
+ require 'factpulse/models/ligne_de_tva'
55
+ require 'factpulse/models/mode_depot'
56
+ require 'factpulse/models/mode_paiement'
57
+ require 'factpulse/models/montant_a_payer'
58
+ require 'factpulse/models/montant_base_ht'
59
+ require 'factpulse/models/montant_ht_total'
60
+ require 'factpulse/models/montant_remise_globale_ttc'
61
+ require 'factpulse/models/montant_total'
62
+ require 'factpulse/models/montant_total_acompte'
63
+ require 'factpulse/models/montant_total_ligne_ht'
64
+ require 'factpulse/models/montant_ttc_total'
65
+ require 'factpulse/models/montant_tva'
66
+ require 'factpulse/models/montant_tva_ligne'
67
+ require 'factpulse/models/montant_tva_total'
68
+ require 'factpulse/models/montant_unitaire_ht'
69
+ require 'factpulse/models/note'
70
+ require 'factpulse/models/obtenir_id_chorus_pro_request'
71
+ require 'factpulse/models/obtenir_id_chorus_pro_response'
72
+ require 'factpulse/models/options_processing'
73
+ require 'factpulse/models/pdf_factur_x_info'
74
+ require 'factpulse/models/parametres_signature'
75
+ require 'factpulse/models/parametres_structure'
76
+ require 'factpulse/models/piece_jointe_complementaire'
77
+ require 'factpulse/models/profil_api'
78
+ require 'factpulse/models/quantite'
79
+ require 'factpulse/models/rechercher_services_response'
80
+ require 'factpulse/models/rechercher_structure_request'
81
+ require 'factpulse/models/rechercher_structure_response'
82
+ require 'factpulse/models/references'
83
+ require 'factpulse/models/reponse_tache'
84
+ require 'factpulse/models/reponse_validation_erreur'
85
+ require 'factpulse/models/reponse_validation_succes'
86
+ require 'factpulse/models/resultat_afnor'
87
+ require 'factpulse/models/resultat_chorus_pro'
88
+ require 'factpulse/models/resultat_validation_pdfapi'
89
+ require 'factpulse/models/scheme_id'
90
+ require 'factpulse/models/service_structure'
91
+ require 'factpulse/models/signature_info'
92
+ require 'factpulse/models/soumettre_facture_complete_request'
93
+ require 'factpulse/models/soumettre_facture_complete_response'
94
+ require 'factpulse/models/soumettre_facture_request'
95
+ require 'factpulse/models/soumettre_facture_response'
96
+ require 'factpulse/models/statut_celery'
97
+ require 'factpulse/models/statut_facture'
98
+ require 'factpulse/models/statut_tache'
99
+ require 'factpulse/models/structure_info'
100
+ require 'factpulse/models/tauxmanuel'
101
+ require 'factpulse/models/type_facture'
102
+ require 'factpulse/models/type_tva'
103
+ require 'factpulse/models/unite'
104
+ require 'factpulse/models/validation_error'
105
+ require 'factpulse/models/validation_error_detail'
106
+ require 'factpulse/models/validation_error_loc_inner'
107
+
108
+ # APIs
109
+ require 'factpulse/api/afnorpdppa_api'
110
+ require 'factpulse/api/afnorpdppa_directory_service_api'
111
+ require 'factpulse/api/afnorpdppa_flow_service_api'
112
+ require 'factpulse/api/chorus_pro_api'
113
+ require 'factpulse/api/sant_api'
114
+ require 'factpulse/api/traitement_facture_api'
115
+ require 'factpulse/api/utilisateur_api'
116
+
117
+ module FactPulse
118
+ class << self
119
+ # Customize default settings for the SDK using block.
120
+ # FactPulse.configure do |config|
121
+ # config.username = "xxx"
122
+ # config.password = "xxx"
123
+ # end
124
+ # If no block given, return the default Configuration object.
125
+ def configure
126
+ if block_given?
127
+ yield(Configuration.default)
128
+ else
129
+ Configuration.default
130
+ end
131
+ end
132
+ end
133
+ end
metadata ADDED
@@ -0,0 +1,345 @@
1
+ --- !ruby/object:Gem::Specification
2
+ name: factpulse
3
+ version: !ruby/object:Gem::Version
4
+ version: 1.0.0
5
+ platform: ruby
6
+ authors:
7
+ - OpenAPI-Generator
8
+ autorequire:
9
+ bindir: bin
10
+ cert_chain: []
11
+ date: 2025-11-27 00:00:00.000000000 Z
12
+ dependencies:
13
+ - !ruby/object:Gem::Dependency
14
+ name: typhoeus
15
+ requirement: !ruby/object:Gem::Requirement
16
+ requirements:
17
+ - - "~>"
18
+ - !ruby/object:Gem::Version
19
+ version: '1.0'
20
+ - - ">="
21
+ - !ruby/object:Gem::Version
22
+ version: 1.0.1
23
+ type: :runtime
24
+ prerelease: false
25
+ version_requirements: !ruby/object:Gem::Requirement
26
+ requirements:
27
+ - - "~>"
28
+ - !ruby/object:Gem::Version
29
+ version: '1.0'
30
+ - - ">="
31
+ - !ruby/object:Gem::Version
32
+ version: 1.0.1
33
+ - !ruby/object:Gem::Dependency
34
+ name: rspec
35
+ requirement: !ruby/object:Gem::Requirement
36
+ requirements:
37
+ - - "~>"
38
+ - !ruby/object:Gem::Version
39
+ version: '3.6'
40
+ - - ">="
41
+ - !ruby/object:Gem::Version
42
+ version: 3.6.0
43
+ type: :development
44
+ prerelease: false
45
+ version_requirements: !ruby/object:Gem::Requirement
46
+ requirements:
47
+ - - "~>"
48
+ - !ruby/object:Gem::Version
49
+ version: '3.6'
50
+ - - ">="
51
+ - !ruby/object:Gem::Version
52
+ version: 3.6.0
53
+ description: " API REST pour la facturation électronique en France : Factur-X, AFNOR
54
+ PDP/PA, signatures électroniques. ## \U0001F3AF Fonctionnalités principales ###
55
+ \U0001F4C4 Génération de factures Factur-X - **Formats** : XML seul ou PDF/A-3 avec
56
+ XML embarqué - **Profils** : MINIMUM, BASIC, EN16931, EXTENDED - **Normes** : EN
57
+ 16931 (directive UE 2014/55), ISO 19005-3 (PDF/A-3), CII (UN/CEFACT) - **\U0001F195
58
+ Format simplifié** : Génération à partir de SIRET + auto-enrichissement (API Chorus
59
+ Pro + Recherche Entreprises) ### ✅ Validation et conformité - **Validation XML**
60
+ : Schematron (45 à 210+ règles selon profil) - **Validation PDF** : PDF/A-3, métadonnées
61
+ XMP Factur-X, signatures électroniques - **VeraPDF** : Validation stricte PDF/A
62
+ (146+ règles ISO 19005-3) - **Traitement asynchrone** : Support Celery pour validations
63
+ lourdes (VeraPDF) ### \U0001F4E1 Intégration AFNOR PDP/PA (XP Z12-013) - **Soumission
64
+ de flux** : Envoi de factures vers Plateformes de Dématérialisation Partenaires
65
+ - **Recherche de flux** : Consultation des factures soumises - **Téléchargement**
66
+ : Récupération des PDF/A-3 avec XML - **Directory Service** : Recherche d'entreprises
67
+ (SIREN/SIRET) - **Multi-client** : Support de plusieurs configs PDP par utilisateur
68
+ (stored credentials ou zero-storage) ### ✍️ Signature électronique PDF - **Standards**
69
+ : PAdES-B-B, PAdES-B-T (horodatage RFC 3161), PAdES-B-LT (archivage long terme)
70
+ - **Niveaux eIDAS** : SES (auto-signé), AdES (CA commerciale), QES (PSCO) - **Validation**
71
+ : Vérification intégrité cryptographique et certificats - **Génération de certificats**
72
+ : Certificats X.509 auto-signés pour tests ### \U0001F504 Traitement asynchrone
73
+ - **Celery** : Génération, validation et signature asynchrones - **Polling** : Suivi
74
+ d'état via `/taches/{id_tache}/statut` - **Pas de timeout** : Idéal pour gros fichiers
75
+ ou validations lourdes ## \U0001F512 Authentification Toutes les requêtes nécessitent
76
+ un **token JWT** dans le header Authorization : ``` Authorization: Bearer YOUR_JWT_TOKEN
77
+ ``` ### Comment obtenir un token JWT ? #### \U0001F511 Méthode 1 : API `/api/token/`
78
+ (Recommandée) **URL :** `https://www.factpulse.fr/api/token/` Cette méthode est
79
+ **recommandée** pour l'intégration dans vos applications et workflows CI/CD. **Prérequis
80
+ :** Avoir défini un mot de passe sur votre compte **Pour les utilisateurs inscrits
81
+ via email/password :** - Vous avez déjà un mot de passe, utilisez-le directement
82
+ \ **Pour les utilisateurs inscrits via OAuth (Google/GitHub) :** - Vous devez d'abord
83
+ définir un mot de passe sur : https://www.factpulse.fr/accounts/password/set/ -
84
+ Une fois le mot de passe créé, vous pourrez utiliser l'API **Exemple de requête
85
+ :** ```bash curl -X POST https://www.factpulse.fr/api/token/ \\ -H \"Content-Type:
86
+ application/json\" \\ -d '{ \"username\": \"votre_email@example.com\", \"password\":
87
+ \"votre_mot_de_passe\" }' ``` **Paramètre optionnel `client_uid` :** Pour sélectionner
88
+ les credentials d'un client spécifique (PA/PDP, Chorus Pro, certificats de signature),
89
+ ajoutez `client_uid` : ```bash curl -X POST https://www.factpulse.fr/api/token/
90
+ \\ -H \"Content-Type: application/json\" \\ -d '{ \"username\": \"votre_email@example.com\",
91
+ \ \"password\": \"votre_mot_de_passe\", \"client_uid\": \"550e8400-e29b-41d4-a716-446655440000\"
92
+ \ }' ``` Le `client_uid` sera inclus dans le JWT et permettra à l'API d'utiliser
93
+ automatiquement : - Les credentials AFNOR/PDP configurés pour ce client - Les credentials
94
+ Chorus Pro configurés pour ce client - Les certificats de signature électronique
95
+ configurés pour ce client **Réponse :** ```json { \"access\": \"eyJ0eXAiOiJKV1QiLCJhbGc...\",
96
+ \ // Token d'accès (validité: 30 min) \"refresh\": \"eyJ0eXAiOiJKV1QiLCJhbGc...\"
97
+ \ // Token de rafraîchissement (validité: 7 jours) } ``` **Avantages :** - ✅ Automatisation
98
+ complète (CI/CD, scripts) - ✅ Gestion programmatique des tokens - ✅ Support du refresh
99
+ token pour renouveler automatiquement l'accès - ✅ Intégration facile dans n'importe
100
+ quel langage/outil #### \U0001F5A5️ Méthode 2 : Génération via Dashboard (Alternative)
101
+ \ **URL :** https://www.factpulse.fr/dashboard/ Cette méthode convient pour des
102
+ tests rapides ou une utilisation occasionnelle via l'interface graphique. **Fonctionnement
103
+ :** - Connectez-vous au dashboard - Utilisez les boutons \"Generate Test Token\"
104
+ ou \"Generate Production Token\" - Fonctionne pour **tous** les utilisateurs (OAuth
105
+ et email/password), sans nécessiter de mot de passe **Types de tokens :** - **Token
106
+ Test** : Validité 24h, quota 1000 appels/jour (gratuit) - **Token Production** :
107
+ Validité 7 jours, quota selon votre forfait **Avantages :** - ✅ Rapide pour tester
108
+ l'API - ✅ Aucun mot de passe requis - ✅ Interface visuelle simple **Inconvénients
109
+ :** - ❌ Nécessite une action manuelle - ❌ Pas de refresh token - ❌ Moins adapté
110
+ pour l'automatisation ### \U0001F4DA Documentation complète Pour plus d'informations
111
+ sur l'authentification et l'utilisation de l'API : https://www.factpulse.fr/documentation-api/
112
+ \ "
113
+ email:
114
+ - ''
115
+ executables: []
116
+ extensions: []
117
+ extra_rdoc_files: []
118
+ files:
119
+ - CHANGELOG.md
120
+ - Gemfile
121
+ - Gemfile.lock
122
+ - LICENSE
123
+ - README.md
124
+ - Rakefile
125
+ - docs/AFNORPDPPAApi.md
126
+ - docs/AFNORPDPPADirectoryServiceApi.md
127
+ - docs/AFNORPDPPAFlowServiceApi.md
128
+ - docs/APIError.md
129
+ - docs/AdresseElectronique.md
130
+ - docs/AdressePostale.md
131
+ - docs/CadreDeFacturation.md
132
+ - docs/CategorieTVA.md
133
+ - docs/CertificateInfoResponse.md
134
+ - docs/ChorusProApi.md
135
+ - docs/ChorusProCredentials.md
136
+ - docs/CodeCadreFacturation.md
137
+ - docs/CodeRaisonReduction.md
138
+ - docs/ConsulterFactureRequest.md
139
+ - docs/ConsulterFactureResponse.md
140
+ - docs/ConsulterStructureRequest.md
141
+ - docs/ConsulterStructureResponse.md
142
+ - docs/CredentialsAFNOR.md
143
+ - docs/CredentialsChorusPro.md
144
+ - docs/Destinataire.md
145
+ - docs/Destination.md
146
+ - docs/DestinationAFNOR.md
147
+ - docs/DestinationChorusPro.md
148
+ - docs/DonneesFactureSimplifiees.md
149
+ - docs/ErrorLevel.md
150
+ - docs/ErrorSource.md
151
+ - docs/FactureEnrichieInfo.md
152
+ - docs/FactureFacturX.md
153
+ - docs/FormatSortie.md
154
+ - docs/Fournisseur.md
155
+ - docs/GenerateCertificateRequest.md
156
+ - docs/GenerateCertificateResponse.md
157
+ - docs/HTTPValidationError.md
158
+ - docs/InformationSignatureAPI.md
159
+ - docs/LigneDePoste.md
160
+ - docs/LigneDePosteMontantRemiseHt.md
161
+ - docs/LigneDePosteTauxTvaManuel.md
162
+ - docs/LigneDeTVA.md
163
+ - docs/ModeDepot.md
164
+ - docs/ModePaiement.md
165
+ - docs/MontantAPayer.md
166
+ - docs/MontantBaseHt.md
167
+ - docs/MontantHtTotal.md
168
+ - docs/MontantRemiseGlobaleTtc.md
169
+ - docs/MontantTotal.md
170
+ - docs/MontantTotalAcompte.md
171
+ - docs/MontantTotalLigneHt.md
172
+ - docs/MontantTtcTotal.md
173
+ - docs/MontantTva.md
174
+ - docs/MontantTvaLigne.md
175
+ - docs/MontantTvaTotal.md
176
+ - docs/MontantUnitaireHt.md
177
+ - docs/Note.md
178
+ - docs/ObtenirIdChorusProRequest.md
179
+ - docs/ObtenirIdChorusProResponse.md
180
+ - docs/OptionsProcessing.md
181
+ - docs/PDFFacturXInfo.md
182
+ - docs/ParametresSignature.md
183
+ - docs/ParametresStructure.md
184
+ - docs/PieceJointeComplementaire.md
185
+ - docs/ProfilAPI.md
186
+ - docs/Quantite.md
187
+ - docs/RechercherServicesResponse.md
188
+ - docs/RechercherStructureRequest.md
189
+ - docs/RechercherStructureResponse.md
190
+ - docs/References.md
191
+ - docs/ReponseTache.md
192
+ - docs/ReponseValidationErreur.md
193
+ - docs/ReponseValidationSucces.md
194
+ - docs/ResultatAFNOR.md
195
+ - docs/ResultatChorusPro.md
196
+ - docs/ResultatValidationPDFAPI.md
197
+ - docs/SantApi.md
198
+ - docs/SchemeID.md
199
+ - docs/ServiceStructure.md
200
+ - docs/SignatureInfo.md
201
+ - docs/SoumettreFactureCompleteRequest.md
202
+ - docs/SoumettreFactureCompleteResponse.md
203
+ - docs/SoumettreFactureRequest.md
204
+ - docs/SoumettreFactureResponse.md
205
+ - docs/StatutCelery.md
206
+ - docs/StatutFacture.md
207
+ - docs/StatutTache.md
208
+ - docs/StructureInfo.md
209
+ - docs/Tauxmanuel.md
210
+ - docs/TraitementFactureApi.md
211
+ - docs/TypeFacture.md
212
+ - docs/TypeTVA.md
213
+ - docs/Unite.md
214
+ - docs/UtilisateurApi.md
215
+ - docs/ValidationError.md
216
+ - docs/ValidationErrorDetail.md
217
+ - docs/ValidationErrorLocInner.md
218
+ - factpulse.gemspec
219
+ - git_push.sh
220
+ - lib/factpulse.rb
221
+ - lib/factpulse/api/afnorpdppa_api.rb
222
+ - lib/factpulse/api/afnorpdppa_directory_service_api.rb
223
+ - lib/factpulse/api/afnorpdppa_flow_service_api.rb
224
+ - lib/factpulse/api/chorus_pro_api.rb
225
+ - lib/factpulse/api/sant_api.rb
226
+ - lib/factpulse/api/traitement_facture_api.rb
227
+ - lib/factpulse/api/utilisateur_api.rb
228
+ - lib/factpulse/api_client.rb
229
+ - lib/factpulse/api_error.rb
230
+ - lib/factpulse/api_model_base.rb
231
+ - lib/factpulse/configuration.rb
232
+ - lib/factpulse/helpers.rb
233
+ - lib/factpulse/helpers/client.rb
234
+ - lib/factpulse/helpers/exceptions.rb
235
+ - lib/factpulse/models/adresse_electronique.rb
236
+ - lib/factpulse/models/adresse_postale.rb
237
+ - lib/factpulse/models/api_error.rb
238
+ - lib/factpulse/models/cadre_de_facturation.rb
239
+ - lib/factpulse/models/categorie_tva.rb
240
+ - lib/factpulse/models/certificate_info_response.rb
241
+ - lib/factpulse/models/chorus_pro_credentials.rb
242
+ - lib/factpulse/models/code_cadre_facturation.rb
243
+ - lib/factpulse/models/code_raison_reduction.rb
244
+ - lib/factpulse/models/consulter_facture_request.rb
245
+ - lib/factpulse/models/consulter_facture_response.rb
246
+ - lib/factpulse/models/consulter_structure_request.rb
247
+ - lib/factpulse/models/consulter_structure_response.rb
248
+ - lib/factpulse/models/credentials_afnor.rb
249
+ - lib/factpulse/models/credentials_chorus_pro.rb
250
+ - lib/factpulse/models/destinataire.rb
251
+ - lib/factpulse/models/destination.rb
252
+ - lib/factpulse/models/destination_afnor.rb
253
+ - lib/factpulse/models/destination_chorus_pro.rb
254
+ - lib/factpulse/models/donnees_facture_simplifiees.rb
255
+ - lib/factpulse/models/error_level.rb
256
+ - lib/factpulse/models/error_source.rb
257
+ - lib/factpulse/models/facture_enrichie_info.rb
258
+ - lib/factpulse/models/facture_factur_x.rb
259
+ - lib/factpulse/models/format_sortie.rb
260
+ - lib/factpulse/models/fournisseur.rb
261
+ - lib/factpulse/models/generate_certificate_request.rb
262
+ - lib/factpulse/models/generate_certificate_response.rb
263
+ - lib/factpulse/models/http_validation_error.rb
264
+ - lib/factpulse/models/information_signature_api.rb
265
+ - lib/factpulse/models/ligne_de_poste.rb
266
+ - lib/factpulse/models/ligne_de_poste_montant_remise_ht.rb
267
+ - lib/factpulse/models/ligne_de_poste_taux_tva_manuel.rb
268
+ - lib/factpulse/models/ligne_de_tva.rb
269
+ - lib/factpulse/models/mode_depot.rb
270
+ - lib/factpulse/models/mode_paiement.rb
271
+ - lib/factpulse/models/montant_a_payer.rb
272
+ - lib/factpulse/models/montant_base_ht.rb
273
+ - lib/factpulse/models/montant_ht_total.rb
274
+ - lib/factpulse/models/montant_remise_globale_ttc.rb
275
+ - lib/factpulse/models/montant_total.rb
276
+ - lib/factpulse/models/montant_total_acompte.rb
277
+ - lib/factpulse/models/montant_total_ligne_ht.rb
278
+ - lib/factpulse/models/montant_ttc_total.rb
279
+ - lib/factpulse/models/montant_tva.rb
280
+ - lib/factpulse/models/montant_tva_ligne.rb
281
+ - lib/factpulse/models/montant_tva_total.rb
282
+ - lib/factpulse/models/montant_unitaire_ht.rb
283
+ - lib/factpulse/models/note.rb
284
+ - lib/factpulse/models/obtenir_id_chorus_pro_request.rb
285
+ - lib/factpulse/models/obtenir_id_chorus_pro_response.rb
286
+ - lib/factpulse/models/options_processing.rb
287
+ - lib/factpulse/models/parametres_signature.rb
288
+ - lib/factpulse/models/parametres_structure.rb
289
+ - lib/factpulse/models/pdf_factur_x_info.rb
290
+ - lib/factpulse/models/piece_jointe_complementaire.rb
291
+ - lib/factpulse/models/profil_api.rb
292
+ - lib/factpulse/models/quantite.rb
293
+ - lib/factpulse/models/rechercher_services_response.rb
294
+ - lib/factpulse/models/rechercher_structure_request.rb
295
+ - lib/factpulse/models/rechercher_structure_response.rb
296
+ - lib/factpulse/models/references.rb
297
+ - lib/factpulse/models/reponse_tache.rb
298
+ - lib/factpulse/models/reponse_validation_erreur.rb
299
+ - lib/factpulse/models/reponse_validation_succes.rb
300
+ - lib/factpulse/models/resultat_afnor.rb
301
+ - lib/factpulse/models/resultat_chorus_pro.rb
302
+ - lib/factpulse/models/resultat_validation_pdfapi.rb
303
+ - lib/factpulse/models/scheme_id.rb
304
+ - lib/factpulse/models/service_structure.rb
305
+ - lib/factpulse/models/signature_info.rb
306
+ - lib/factpulse/models/soumettre_facture_complete_request.rb
307
+ - lib/factpulse/models/soumettre_facture_complete_response.rb
308
+ - lib/factpulse/models/soumettre_facture_request.rb
309
+ - lib/factpulse/models/soumettre_facture_response.rb
310
+ - lib/factpulse/models/statut_celery.rb
311
+ - lib/factpulse/models/statut_facture.rb
312
+ - lib/factpulse/models/statut_tache.rb
313
+ - lib/factpulse/models/structure_info.rb
314
+ - lib/factpulse/models/tauxmanuel.rb
315
+ - lib/factpulse/models/type_facture.rb
316
+ - lib/factpulse/models/type_tva.rb
317
+ - lib/factpulse/models/unite.rb
318
+ - lib/factpulse/models/validation_error.rb
319
+ - lib/factpulse/models/validation_error_detail.rb
320
+ - lib/factpulse/models/validation_error_loc_inner.rb
321
+ - lib/factpulse/version.rb
322
+ homepage: https://openapi-generator.tech
323
+ licenses:
324
+ - Unlicense
325
+ metadata: {}
326
+ post_install_message:
327
+ rdoc_options: []
328
+ require_paths:
329
+ - lib
330
+ required_ruby_version: !ruby/object:Gem::Requirement
331
+ requirements:
332
+ - - ">="
333
+ - !ruby/object:Gem::Version
334
+ version: '2.7'
335
+ required_rubygems_version: !ruby/object:Gem::Requirement
336
+ requirements:
337
+ - - ">="
338
+ - !ruby/object:Gem::Version
339
+ version: '0'
340
+ requirements: []
341
+ rubygems_version: 3.2.33
342
+ signing_key:
343
+ specification_version: 4
344
+ summary: API REST FactPulse Ruby Gem
345
+ test_files: []