factpulse 1.0.9__py3-none-any.whl → 2.0.37__py3-none-any.whl

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.

Potentially problematic release.


This version of factpulse might be problematic. Click here for more details.

Files changed (147) hide show
  1. factpulse/__init__.py +54 -50
  2. factpulse/api/__init__.py +1 -0
  3. factpulse/api/afnorpdppa_api.py +552 -2
  4. factpulse/api/afnorpdppa_directory_service_api.py +4312 -65
  5. factpulse/api/afnorpdppa_flow_service_api.py +1 -1
  6. factpulse/api/chorus_pro_api.py +152 -194
  7. factpulse/api/sant_api.py +246 -1
  8. factpulse/api/traitement_facture_api.py +25 -27
  9. factpulse/api/utilisateur_api.py +1 -1
  10. factpulse/api/vrification_pdfxml_api.py +1719 -0
  11. factpulse/api_client.py +5 -5
  12. factpulse/configuration.py +5 -3
  13. factpulse/exceptions.py +7 -4
  14. factpulse/models/__init__.py +26 -25
  15. factpulse/models/adresse_electronique.py +1 -1
  16. factpulse/models/adresse_postale.py +1 -1
  17. factpulse/models/{body_ajouter_fichier_api_v1_chorus_pro_transverses_ajouter_fichier_post.py → api_error.py} +24 -24
  18. factpulse/models/{body_completer_facture_api_v1_chorus_pro_factures_completer_post.py → bounding_box_schema.py} +23 -27
  19. factpulse/models/cadre_de_facturation.py +11 -3
  20. factpulse/models/categorie_tva.py +11 -11
  21. factpulse/models/certificate_info_response.py +1 -1
  22. factpulse/models/champ_verifie_schema.py +129 -0
  23. factpulse/models/chorus_pro_credentials.py +1 -1
  24. factpulse/models/code_cadre_facturation.py +2 -2
  25. factpulse/models/code_raison_reduction.py +9 -9
  26. factpulse/models/consulter_facture_request.py +1 -1
  27. factpulse/models/consulter_facture_response.py +1 -1
  28. factpulse/models/consulter_structure_request.py +1 -1
  29. factpulse/models/consulter_structure_response.py +1 -1
  30. factpulse/models/credentials_afnor.py +1 -1
  31. factpulse/models/credentials_chorus_pro.py +1 -1
  32. factpulse/models/destinataire.py +16 -2
  33. factpulse/models/destination.py +1 -1
  34. factpulse/models/destination_afnor.py +1 -1
  35. factpulse/models/destination_chorus_pro.py +1 -1
  36. factpulse/models/{quota_info.py → dimension_page_schema.py} +12 -18
  37. factpulse/models/direction_flux.py +1 -1
  38. factpulse/models/donnees_facture_simplifiees.py +1 -1
  39. factpulse/models/error_level.py +37 -0
  40. factpulse/models/error_source.py +43 -0
  41. factpulse/models/{facture_enrichie_info_output.py → facture_enrichie_info.py} +4 -4
  42. factpulse/models/facture_entrante.py +196 -0
  43. factpulse/models/facture_factur_x.py +12 -2
  44. factpulse/models/flux_resume.py +1 -1
  45. factpulse/models/format_facture.py +38 -0
  46. factpulse/models/format_sortie.py +1 -1
  47. factpulse/models/fournisseur.py +9 -2
  48. factpulse/models/fournisseur_entrant.py +144 -0
  49. factpulse/models/generate_certificate_request.py +1 -1
  50. factpulse/models/generate_certificate_response.py +1 -1
  51. factpulse/models/http_validation_error.py +1 -1
  52. factpulse/models/information_signature_api.py +1 -1
  53. factpulse/models/ligne_de_poste.py +7 -12
  54. factpulse/models/ligne_de_poste_montant_remise_ht.py +2 -2
  55. factpulse/models/ligne_de_poste_taux_tva_manuel.py +2 -2
  56. factpulse/models/ligne_de_tva.py +24 -10
  57. factpulse/models/mode_depot.py +1 -1
  58. factpulse/models/mode_paiement.py +1 -1
  59. factpulse/models/{montantapayer.py → montant_a_payer.py} +6 -6
  60. factpulse/models/{montantbaseht.py → montant_base_ht.py} +6 -6
  61. factpulse/models/montant_ht_total.py +4 -4
  62. factpulse/models/{montant_total_montant_remise_globale_ttc.py → montant_remise_globale_ttc.py} +7 -13
  63. factpulse/models/montant_total.py +16 -21
  64. factpulse/models/montant_total_acompte.py +2 -2
  65. factpulse/models/{ligne_de_poste_montant_total_ligne_ht.py → montant_total_ligne_ht.py} +7 -13
  66. factpulse/models/montant_ttc_total.py +4 -4
  67. factpulse/models/montant_tva.py +2 -2
  68. factpulse/models/{montanttva1.py → montant_tva_ligne.py} +7 -7
  69. factpulse/models/{montantttctotal.py → montant_tva_total.py} +7 -7
  70. factpulse/models/{montantunitaireht.py → montant_unitaire_ht.py} +5 -5
  71. factpulse/models/nature_operation.py +49 -0
  72. factpulse/models/{body_valideur_rechercher_factures_api_v1_chorus_pro_factures_valideur_rechercher_post.py → note.py} +14 -24
  73. factpulse/models/{utilisateur.py → note_obligatoire_schema.py} +40 -44
  74. factpulse/models/obtenir_id_chorus_pro_request.py +1 -1
  75. factpulse/models/obtenir_id_chorus_pro_response.py +1 -1
  76. factpulse/models/options_processing.py +1 -1
  77. factpulse/models/parametres_signature.py +1 -1
  78. factpulse/models/parametres_structure.py +1 -1
  79. factpulse/models/pdf_factur_x_info.py +1 -1
  80. factpulse/models/pdp_credentials.py +10 -3
  81. factpulse/models/piece_jointe_complementaire.py +1 -1
  82. factpulse/models/profil_api.py +1 -1
  83. factpulse/models/profil_flux.py +1 -1
  84. factpulse/models/quantite.py +1 -1
  85. factpulse/models/rechercher_services_response.py +1 -1
  86. factpulse/models/rechercher_structure_request.py +1 -1
  87. factpulse/models/rechercher_structure_response.py +1 -1
  88. factpulse/models/references.py +1 -1
  89. factpulse/models/reponse_healthcheck_afnor.py +1 -1
  90. factpulse/models/reponse_recherche_flux.py +1 -1
  91. factpulse/models/reponse_soumission_flux.py +1 -1
  92. factpulse/models/reponse_tache.py +1 -1
  93. factpulse/models/reponse_validation_erreur.py +1 -1
  94. factpulse/models/reponse_validation_succes.py +1 -1
  95. factpulse/models/reponse_verification_succes.py +135 -0
  96. factpulse/models/requete_recherche_flux.py +1 -1
  97. factpulse/models/requete_soumission_flux.py +1 -1
  98. factpulse/models/resultat_afnor.py +1 -1
  99. factpulse/models/resultat_chorus_pro.py +1 -1
  100. factpulse/models/resultat_validation_pdfapi.py +1 -1
  101. factpulse/models/scheme_id.py +7 -7
  102. factpulse/models/service_structure.py +1 -1
  103. factpulse/models/signature_info.py +1 -1
  104. factpulse/models/soumettre_facture_complete_request.py +1 -1
  105. factpulse/models/soumettre_facture_complete_response.py +4 -4
  106. factpulse/models/soumettre_facture_request.py +19 -7
  107. factpulse/models/soumettre_facture_response.py +1 -1
  108. factpulse/models/statut_acquittement.py +1 -1
  109. factpulse/models/statut_celery.py +40 -0
  110. factpulse/models/statut_champ_api.py +40 -0
  111. factpulse/models/statut_facture.py +1 -1
  112. factpulse/models/statut_tache.py +7 -9
  113. factpulse/models/structure_info.py +1 -1
  114. factpulse/models/syntaxe_flux.py +1 -1
  115. factpulse/models/tauxmanuel.py +2 -2
  116. factpulse/models/type_document.py +40 -0
  117. factpulse/models/type_facture.py +1 -1
  118. factpulse/models/type_flux.py +1 -1
  119. factpulse/models/type_tva.py +1 -1
  120. factpulse/models/unite.py +1 -1
  121. factpulse/models/validation_error.py +1 -1
  122. factpulse/models/{body_rechercher_factures_fournisseur_api_v1_chorus_pro_factures_rechercher_fournisseur_post.py → validation_error_detail.py} +27 -24
  123. factpulse/models/validation_error_loc_inner.py +1 -1
  124. factpulse/rest.py +8 -3
  125. factpulse-2.0.37.dist-info/METADATA +292 -0
  126. factpulse-2.0.37.dist-info/RECORD +134 -0
  127. factpulse-2.0.37.dist-info/top_level.txt +2 -0
  128. factpulse_helpers/__init__.py +96 -0
  129. factpulse_helpers/client.py +1887 -0
  130. factpulse_helpers/exceptions.py +253 -0
  131. factpulse/api/processing_endpoints_unifis_api.py +0 -592
  132. factpulse/api/signature_lectronique_api.py +0 -1358
  133. factpulse/models/body_lister_services_structure_api_v1_chorus_pro_structures_id_structure_cpp_services_get.py +0 -102
  134. factpulse/models/body_rechercher_factures_destinataire_api_v1_chorus_pro_factures_rechercher_destinataire_post.py +0 -104
  135. factpulse/models/body_recycler_facture_api_v1_chorus_pro_factures_recycler_post.py +0 -104
  136. factpulse/models/body_telecharger_groupe_factures_api_v1_chorus_pro_factures_telecharger_groupe_post.py +0 -104
  137. factpulse/models/body_traiter_facture_recue_api_v1_chorus_pro_factures_traiter_facture_recue_post.py +0 -104
  138. factpulse/models/body_valideur_consulter_facture_api_v1_chorus_pro_factures_valideur_consulter_post.py +0 -104
  139. factpulse/models/body_valideur_traiter_facture_api_v1_chorus_pro_factures_valideur_traiter_post.py +0 -104
  140. factpulse/models/facture_enrichie_info_input.py +0 -123
  141. factpulse/models/montanthttotal.py +0 -139
  142. factpulse/models/montanttva.py +0 -139
  143. factpulse-1.0.9.dist-info/METADATA +0 -182
  144. factpulse-1.0.9.dist-info/RECORD +0 -131
  145. factpulse-1.0.9.dist-info/top_level.txt +0 -1
  146. {factpulse-1.0.9.dist-info → factpulse-2.0.37.dist-info}/WHEEL +0 -0
  147. {factpulse-1.0.9.dist-info → factpulse-2.0.37.dist-info}/licenses/LICENSE +0 -0
@@ -1,592 +0,0 @@
1
- # coding: utf-8
2
-
3
- """
4
- API REST FactPulse
5
-
6
- 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\" }' ``` **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/
7
-
8
- The version of the OpenAPI document: 1.0.0
9
- Generated by OpenAPI Generator (https://openapi-generator.tech)
10
-
11
- Do not edit the class manually.
12
- """ # noqa: E501
13
-
14
- import warnings
15
- from pydantic import validate_call, Field, StrictFloat, StrictStr, StrictInt
16
- from typing import Any, Dict, List, Optional, Tuple, Union
17
- from typing_extensions import Annotated
18
-
19
- from factpulse.models.reponse_tache import ReponseTache
20
- from factpulse.models.soumettre_facture_complete_request import SoumettreFactureCompleteRequest
21
- from factpulse.models.soumettre_facture_complete_response import SoumettreFactureCompleteResponse
22
-
23
- from factpulse.api_client import ApiClient, RequestSerialized
24
- from factpulse.api_response import ApiResponse
25
- from factpulse.rest import RESTResponseType
26
-
27
-
28
- class ProcessingEndpointsUnifisApi:
29
- """NOTE: This class is auto generated by OpenAPI Generator
30
- Ref: https://openapi-generator.tech
31
-
32
- Do not edit the class manually.
33
- """
34
-
35
- def __init__(self, api_client=None) -> None:
36
- if api_client is None:
37
- api_client = ApiClient.get_default()
38
- self.api_client = api_client
39
-
40
-
41
- @validate_call
42
- def soumettre_facture_complete_api_v1_traitement_factures_soumettre_complete_post(
43
- self,
44
- soumettre_facture_complete_request: SoumettreFactureCompleteRequest,
45
- _request_timeout: Union[
46
- None,
47
- Annotated[StrictFloat, Field(gt=0)],
48
- Tuple[
49
- Annotated[StrictFloat, Field(gt=0)],
50
- Annotated[StrictFloat, Field(gt=0)]
51
- ]
52
- ] = None,
53
- _request_auth: Optional[Dict[StrictStr, Any]] = None,
54
- _content_type: Optional[StrictStr] = None,
55
- _headers: Optional[Dict[StrictStr, Any]] = None,
56
- _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
57
- ) -> SoumettreFactureCompleteResponse:
58
- """Soumettre une facture complète (génération + signature + soumission)
59
-
60
- Endpoint unifié pour soumettre une facture complète vers différentes destinations. **Workflow automatisé :** 1. **Auto-enrichissement** (optionnel) : récupère les données via APIs publiques et Chorus Pro/AFNOR 2. **Génération PDF Factur-X** : crée un PDF/A-3 avec XML embarqué 3. **Signature électronique** (optionnelle) : signe le PDF avec un certificat 4. **Soumission** : envoie vers la destination choisie (Chorus Pro ou AFNOR PDP) **Destinations supportées :** - **Chorus Pro** : plateforme B2G française (factures vers secteur public) - **AFNOR PDP** : Plateformes de Dématérialisation Partenaires **Credentials de destination - 2 modes disponibles :** **Mode 1 - Récupération via JWT (recommandé) :** - Les credentials sont récupérés automatiquement via le `client_uid` du JWT - Ne pas fournir le champ `credentials` dans `destination` - Architecture 0-trust : aucun secret dans le payload - Exemple : `\"destination\": {\"type\": \"chorus_pro\"}` **Mode 2 - Credentials dans le payload :** - Fournir les credentials directement dans le payload - Utile pour tests ou intégrations tierces - Exemple : `\"destination\": {\"type\": \"chorus_pro\", \"credentials\": {...}}` **Signature électronique (optionnelle) - 2 modes disponibles :** **Mode 1 - Certificat stocké (recommandé) :** - Le certificat est récupéré automatiquement via le `client_uid` du JWT - Aucune clé à fournir dans le payload - Signature PAdES-B-LT avec horodatage (conforme eIDAS) - Exemple : `\"signature\": {\"raison\": \"Conformité Factur-X\"}` **Mode 2 - Clés dans le payload (pour tests) :** - Fournir `key_pem` et `cert_pem` directement - Format PEM accepté : brut ou base64 - Utile pour tests ou cas spéciaux sans certificat stocké - Exemple : `\"signature\": {\"key_pem\": \"-----BEGIN...\", \"cert_pem\": \"-----BEGIN...\"}` Si `key_pem` et `cert_pem` sont fournis → Mode 2 Sinon → Mode 1 (certificat récupéré via `client_uid`)
61
-
62
- :param soumettre_facture_complete_request: (required)
63
- :type soumettre_facture_complete_request: SoumettreFactureCompleteRequest
64
- :param _request_timeout: timeout setting for this request. If one
65
- number provided, it will be total request
66
- timeout. It can also be a pair (tuple) of
67
- (connection, read) timeouts.
68
- :type _request_timeout: int, tuple(int, int), optional
69
- :param _request_auth: set to override the auth_settings for an a single
70
- request; this effectively ignores the
71
- authentication in the spec for a single request.
72
- :type _request_auth: dict, optional
73
- :param _content_type: force content-type for the request.
74
- :type _content_type: str, Optional
75
- :param _headers: set to override the headers for a single
76
- request; this effectively ignores the headers
77
- in the spec for a single request.
78
- :type _headers: dict, optional
79
- :param _host_index: set to override the host_index for a single
80
- request; this effectively ignores the host_index
81
- in the spec for a single request.
82
- :type _host_index: int, optional
83
- :return: Returns the result object.
84
- """ # noqa: E501
85
-
86
- _param = self._soumettre_facture_complete_api_v1_traitement_factures_soumettre_complete_post_serialize(
87
- soumettre_facture_complete_request=soumettre_facture_complete_request,
88
- _request_auth=_request_auth,
89
- _content_type=_content_type,
90
- _headers=_headers,
91
- _host_index=_host_index
92
- )
93
-
94
- _response_types_map: Dict[str, Optional[str]] = {
95
- '200': "SoumettreFactureCompleteResponse",
96
- '422': "HTTPValidationError",
97
- }
98
- response_data = self.api_client.call_api(
99
- *_param,
100
- _request_timeout=_request_timeout
101
- )
102
- response_data.read()
103
- return self.api_client.response_deserialize(
104
- response_data=response_data,
105
- response_types_map=_response_types_map,
106
- ).data
107
-
108
-
109
- @validate_call
110
- def soumettre_facture_complete_api_v1_traitement_factures_soumettre_complete_post_with_http_info(
111
- self,
112
- soumettre_facture_complete_request: SoumettreFactureCompleteRequest,
113
- _request_timeout: Union[
114
- None,
115
- Annotated[StrictFloat, Field(gt=0)],
116
- Tuple[
117
- Annotated[StrictFloat, Field(gt=0)],
118
- Annotated[StrictFloat, Field(gt=0)]
119
- ]
120
- ] = None,
121
- _request_auth: Optional[Dict[StrictStr, Any]] = None,
122
- _content_type: Optional[StrictStr] = None,
123
- _headers: Optional[Dict[StrictStr, Any]] = None,
124
- _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
125
- ) -> ApiResponse[SoumettreFactureCompleteResponse]:
126
- """Soumettre une facture complète (génération + signature + soumission)
127
-
128
- Endpoint unifié pour soumettre une facture complète vers différentes destinations. **Workflow automatisé :** 1. **Auto-enrichissement** (optionnel) : récupère les données via APIs publiques et Chorus Pro/AFNOR 2. **Génération PDF Factur-X** : crée un PDF/A-3 avec XML embarqué 3. **Signature électronique** (optionnelle) : signe le PDF avec un certificat 4. **Soumission** : envoie vers la destination choisie (Chorus Pro ou AFNOR PDP) **Destinations supportées :** - **Chorus Pro** : plateforme B2G française (factures vers secteur public) - **AFNOR PDP** : Plateformes de Dématérialisation Partenaires **Credentials de destination - 2 modes disponibles :** **Mode 1 - Récupération via JWT (recommandé) :** - Les credentials sont récupérés automatiquement via le `client_uid` du JWT - Ne pas fournir le champ `credentials` dans `destination` - Architecture 0-trust : aucun secret dans le payload - Exemple : `\"destination\": {\"type\": \"chorus_pro\"}` **Mode 2 - Credentials dans le payload :** - Fournir les credentials directement dans le payload - Utile pour tests ou intégrations tierces - Exemple : `\"destination\": {\"type\": \"chorus_pro\", \"credentials\": {...}}` **Signature électronique (optionnelle) - 2 modes disponibles :** **Mode 1 - Certificat stocké (recommandé) :** - Le certificat est récupéré automatiquement via le `client_uid` du JWT - Aucune clé à fournir dans le payload - Signature PAdES-B-LT avec horodatage (conforme eIDAS) - Exemple : `\"signature\": {\"raison\": \"Conformité Factur-X\"}` **Mode 2 - Clés dans le payload (pour tests) :** - Fournir `key_pem` et `cert_pem` directement - Format PEM accepté : brut ou base64 - Utile pour tests ou cas spéciaux sans certificat stocké - Exemple : `\"signature\": {\"key_pem\": \"-----BEGIN...\", \"cert_pem\": \"-----BEGIN...\"}` Si `key_pem` et `cert_pem` sont fournis → Mode 2 Sinon → Mode 1 (certificat récupéré via `client_uid`)
129
-
130
- :param soumettre_facture_complete_request: (required)
131
- :type soumettre_facture_complete_request: SoumettreFactureCompleteRequest
132
- :param _request_timeout: timeout setting for this request. If one
133
- number provided, it will be total request
134
- timeout. It can also be a pair (tuple) of
135
- (connection, read) timeouts.
136
- :type _request_timeout: int, tuple(int, int), optional
137
- :param _request_auth: set to override the auth_settings for an a single
138
- request; this effectively ignores the
139
- authentication in the spec for a single request.
140
- :type _request_auth: dict, optional
141
- :param _content_type: force content-type for the request.
142
- :type _content_type: str, Optional
143
- :param _headers: set to override the headers for a single
144
- request; this effectively ignores the headers
145
- in the spec for a single request.
146
- :type _headers: dict, optional
147
- :param _host_index: set to override the host_index for a single
148
- request; this effectively ignores the host_index
149
- in the spec for a single request.
150
- :type _host_index: int, optional
151
- :return: Returns the result object.
152
- """ # noqa: E501
153
-
154
- _param = self._soumettre_facture_complete_api_v1_traitement_factures_soumettre_complete_post_serialize(
155
- soumettre_facture_complete_request=soumettre_facture_complete_request,
156
- _request_auth=_request_auth,
157
- _content_type=_content_type,
158
- _headers=_headers,
159
- _host_index=_host_index
160
- )
161
-
162
- _response_types_map: Dict[str, Optional[str]] = {
163
- '200': "SoumettreFactureCompleteResponse",
164
- '422': "HTTPValidationError",
165
- }
166
- response_data = self.api_client.call_api(
167
- *_param,
168
- _request_timeout=_request_timeout
169
- )
170
- response_data.read()
171
- return self.api_client.response_deserialize(
172
- response_data=response_data,
173
- response_types_map=_response_types_map,
174
- )
175
-
176
-
177
- @validate_call
178
- def soumettre_facture_complete_api_v1_traitement_factures_soumettre_complete_post_without_preload_content(
179
- self,
180
- soumettre_facture_complete_request: SoumettreFactureCompleteRequest,
181
- _request_timeout: Union[
182
- None,
183
- Annotated[StrictFloat, Field(gt=0)],
184
- Tuple[
185
- Annotated[StrictFloat, Field(gt=0)],
186
- Annotated[StrictFloat, Field(gt=0)]
187
- ]
188
- ] = None,
189
- _request_auth: Optional[Dict[StrictStr, Any]] = None,
190
- _content_type: Optional[StrictStr] = None,
191
- _headers: Optional[Dict[StrictStr, Any]] = None,
192
- _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
193
- ) -> RESTResponseType:
194
- """Soumettre une facture complète (génération + signature + soumission)
195
-
196
- Endpoint unifié pour soumettre une facture complète vers différentes destinations. **Workflow automatisé :** 1. **Auto-enrichissement** (optionnel) : récupère les données via APIs publiques et Chorus Pro/AFNOR 2. **Génération PDF Factur-X** : crée un PDF/A-3 avec XML embarqué 3. **Signature électronique** (optionnelle) : signe le PDF avec un certificat 4. **Soumission** : envoie vers la destination choisie (Chorus Pro ou AFNOR PDP) **Destinations supportées :** - **Chorus Pro** : plateforme B2G française (factures vers secteur public) - **AFNOR PDP** : Plateformes de Dématérialisation Partenaires **Credentials de destination - 2 modes disponibles :** **Mode 1 - Récupération via JWT (recommandé) :** - Les credentials sont récupérés automatiquement via le `client_uid` du JWT - Ne pas fournir le champ `credentials` dans `destination` - Architecture 0-trust : aucun secret dans le payload - Exemple : `\"destination\": {\"type\": \"chorus_pro\"}` **Mode 2 - Credentials dans le payload :** - Fournir les credentials directement dans le payload - Utile pour tests ou intégrations tierces - Exemple : `\"destination\": {\"type\": \"chorus_pro\", \"credentials\": {...}}` **Signature électronique (optionnelle) - 2 modes disponibles :** **Mode 1 - Certificat stocké (recommandé) :** - Le certificat est récupéré automatiquement via le `client_uid` du JWT - Aucune clé à fournir dans le payload - Signature PAdES-B-LT avec horodatage (conforme eIDAS) - Exemple : `\"signature\": {\"raison\": \"Conformité Factur-X\"}` **Mode 2 - Clés dans le payload (pour tests) :** - Fournir `key_pem` et `cert_pem` directement - Format PEM accepté : brut ou base64 - Utile pour tests ou cas spéciaux sans certificat stocké - Exemple : `\"signature\": {\"key_pem\": \"-----BEGIN...\", \"cert_pem\": \"-----BEGIN...\"}` Si `key_pem` et `cert_pem` sont fournis → Mode 2 Sinon → Mode 1 (certificat récupéré via `client_uid`)
197
-
198
- :param soumettre_facture_complete_request: (required)
199
- :type soumettre_facture_complete_request: SoumettreFactureCompleteRequest
200
- :param _request_timeout: timeout setting for this request. If one
201
- number provided, it will be total request
202
- timeout. It can also be a pair (tuple) of
203
- (connection, read) timeouts.
204
- :type _request_timeout: int, tuple(int, int), optional
205
- :param _request_auth: set to override the auth_settings for an a single
206
- request; this effectively ignores the
207
- authentication in the spec for a single request.
208
- :type _request_auth: dict, optional
209
- :param _content_type: force content-type for the request.
210
- :type _content_type: str, Optional
211
- :param _headers: set to override the headers for a single
212
- request; this effectively ignores the headers
213
- in the spec for a single request.
214
- :type _headers: dict, optional
215
- :param _host_index: set to override the host_index for a single
216
- request; this effectively ignores the host_index
217
- in the spec for a single request.
218
- :type _host_index: int, optional
219
- :return: Returns the result object.
220
- """ # noqa: E501
221
-
222
- _param = self._soumettre_facture_complete_api_v1_traitement_factures_soumettre_complete_post_serialize(
223
- soumettre_facture_complete_request=soumettre_facture_complete_request,
224
- _request_auth=_request_auth,
225
- _content_type=_content_type,
226
- _headers=_headers,
227
- _host_index=_host_index
228
- )
229
-
230
- _response_types_map: Dict[str, Optional[str]] = {
231
- '200': "SoumettreFactureCompleteResponse",
232
- '422': "HTTPValidationError",
233
- }
234
- response_data = self.api_client.call_api(
235
- *_param,
236
- _request_timeout=_request_timeout
237
- )
238
- return response_data.response
239
-
240
-
241
- def _soumettre_facture_complete_api_v1_traitement_factures_soumettre_complete_post_serialize(
242
- self,
243
- soumettre_facture_complete_request,
244
- _request_auth,
245
- _content_type,
246
- _headers,
247
- _host_index,
248
- ) -> RequestSerialized:
249
-
250
- _host = None
251
-
252
- _collection_formats: Dict[str, str] = {
253
- }
254
-
255
- _path_params: Dict[str, str] = {}
256
- _query_params: List[Tuple[str, str]] = []
257
- _header_params: Dict[str, Optional[str]] = _headers or {}
258
- _form_params: List[Tuple[str, str]] = []
259
- _files: Dict[
260
- str, Union[str, bytes, List[str], List[bytes], List[Tuple[str, bytes]]]
261
- ] = {}
262
- _body_params: Optional[bytes] = None
263
-
264
- # process the path parameters
265
- # process the query parameters
266
- # process the header parameters
267
- # process the form parameters
268
- # process the body parameter
269
- if soumettre_facture_complete_request is not None:
270
- _body_params = soumettre_facture_complete_request
271
-
272
-
273
- # set the HTTP header `Accept`
274
- if 'Accept' not in _header_params:
275
- _header_params['Accept'] = self.api_client.select_header_accept(
276
- [
277
- 'application/json'
278
- ]
279
- )
280
-
281
- # set the HTTP header `Content-Type`
282
- if _content_type:
283
- _header_params['Content-Type'] = _content_type
284
- else:
285
- _default_content_type = (
286
- self.api_client.select_header_content_type(
287
- [
288
- 'application/json'
289
- ]
290
- )
291
- )
292
- if _default_content_type is not None:
293
- _header_params['Content-Type'] = _default_content_type
294
-
295
- # authentication setting
296
- _auth_settings: List[str] = [
297
- 'HTTPBearer'
298
- ]
299
-
300
- return self.api_client.param_serialize(
301
- method='POST',
302
- resource_path='/api/v1/traitement/factures/soumettre-complete',
303
- path_params=_path_params,
304
- query_params=_query_params,
305
- header_params=_header_params,
306
- body=_body_params,
307
- post_params=_form_params,
308
- files=_files,
309
- auth_settings=_auth_settings,
310
- collection_formats=_collection_formats,
311
- _host=_host,
312
- _request_auth=_request_auth
313
- )
314
-
315
-
316
-
317
-
318
- @validate_call
319
- def soumettre_facture_complete_async_api_v1_traitement_factures_soumettre_complete_async_post(
320
- self,
321
- soumettre_facture_complete_request: SoumettreFactureCompleteRequest,
322
- _request_timeout: Union[
323
- None,
324
- Annotated[StrictFloat, Field(gt=0)],
325
- Tuple[
326
- Annotated[StrictFloat, Field(gt=0)],
327
- Annotated[StrictFloat, Field(gt=0)]
328
- ]
329
- ] = None,
330
- _request_auth: Optional[Dict[StrictStr, Any]] = None,
331
- _content_type: Optional[StrictStr] = None,
332
- _headers: Optional[Dict[StrictStr, Any]] = None,
333
- _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
334
- ) -> ReponseTache:
335
- """Soumettre une facture complète (asynchrone avec Celery)
336
-
337
- Version asynchrone de l'endpoint `/factures/soumettre-complete` utilisant Celery pour le traitement en arrière-plan. **Workflow automatisé (identique à la version synchrone) :** 1. **Auto-enrichissement** (optionnel) : récupère les données via APIs publiques et Chorus Pro/AFNOR 2. **Génération PDF Factur-X** : crée un PDF/A-3 avec XML embarqué 3. **Signature électronique** (optionnelle) : signe le PDF avec un certificat 4. **Soumission** : envoie vers la destination choisie (Chorus Pro ou AFNOR PDP) **Destinations supportées :** - **Chorus Pro** : plateforme B2G française (factures vers secteur public) - **AFNOR PDP** : Plateformes de Dématérialisation Partenaires **Différences avec la version synchrone :** - ✅ **Non-bloquant** : Retourne immédiatement un `id_tache` (HTTP 202 Accepted) - ✅ **Traitement en arrière-plan** : La facture est traitée par un worker Celery - ✅ **Suivi d'avancement** : Utilisez `/taches/{id_tache}/statut` pour suivre le statut - ✅ **Idéal pour gros volumes** : Permet de traiter de nombreuses factures en parallèle **Comment utiliser :** 1. **Soumission** : Appelez cet endpoint avec vos données de facture 2. **Retour immédiat** : Vous recevez un `id_tache` (ex: \"abc123-def456\") 3. **Suivi** : Appelez `/taches/{id_tache}/statut` pour vérifier l'avancement 4. **Résultat** : Quand `statut = \"SUCCESS\"`, le champ `resultat` contient la réponse complète **Credentials et signature** : Mêmes modes que la version synchrone (JWT ou payload).
338
-
339
- :param soumettre_facture_complete_request: (required)
340
- :type soumettre_facture_complete_request: SoumettreFactureCompleteRequest
341
- :param _request_timeout: timeout setting for this request. If one
342
- number provided, it will be total request
343
- timeout. It can also be a pair (tuple) of
344
- (connection, read) timeouts.
345
- :type _request_timeout: int, tuple(int, int), optional
346
- :param _request_auth: set to override the auth_settings for an a single
347
- request; this effectively ignores the
348
- authentication in the spec for a single request.
349
- :type _request_auth: dict, optional
350
- :param _content_type: force content-type for the request.
351
- :type _content_type: str, Optional
352
- :param _headers: set to override the headers for a single
353
- request; this effectively ignores the headers
354
- in the spec for a single request.
355
- :type _headers: dict, optional
356
- :param _host_index: set to override the host_index for a single
357
- request; this effectively ignores the host_index
358
- in the spec for a single request.
359
- :type _host_index: int, optional
360
- :return: Returns the result object.
361
- """ # noqa: E501
362
-
363
- _param = self._soumettre_facture_complete_async_api_v1_traitement_factures_soumettre_complete_async_post_serialize(
364
- soumettre_facture_complete_request=soumettre_facture_complete_request,
365
- _request_auth=_request_auth,
366
- _content_type=_content_type,
367
- _headers=_headers,
368
- _host_index=_host_index
369
- )
370
-
371
- _response_types_map: Dict[str, Optional[str]] = {
372
- '202': "ReponseTache",
373
- '422': "HTTPValidationError",
374
- }
375
- response_data = self.api_client.call_api(
376
- *_param,
377
- _request_timeout=_request_timeout
378
- )
379
- response_data.read()
380
- return self.api_client.response_deserialize(
381
- response_data=response_data,
382
- response_types_map=_response_types_map,
383
- ).data
384
-
385
-
386
- @validate_call
387
- def soumettre_facture_complete_async_api_v1_traitement_factures_soumettre_complete_async_post_with_http_info(
388
- self,
389
- soumettre_facture_complete_request: SoumettreFactureCompleteRequest,
390
- _request_timeout: Union[
391
- None,
392
- Annotated[StrictFloat, Field(gt=0)],
393
- Tuple[
394
- Annotated[StrictFloat, Field(gt=0)],
395
- Annotated[StrictFloat, Field(gt=0)]
396
- ]
397
- ] = None,
398
- _request_auth: Optional[Dict[StrictStr, Any]] = None,
399
- _content_type: Optional[StrictStr] = None,
400
- _headers: Optional[Dict[StrictStr, Any]] = None,
401
- _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
402
- ) -> ApiResponse[ReponseTache]:
403
- """Soumettre une facture complète (asynchrone avec Celery)
404
-
405
- Version asynchrone de l'endpoint `/factures/soumettre-complete` utilisant Celery pour le traitement en arrière-plan. **Workflow automatisé (identique à la version synchrone) :** 1. **Auto-enrichissement** (optionnel) : récupère les données via APIs publiques et Chorus Pro/AFNOR 2. **Génération PDF Factur-X** : crée un PDF/A-3 avec XML embarqué 3. **Signature électronique** (optionnelle) : signe le PDF avec un certificat 4. **Soumission** : envoie vers la destination choisie (Chorus Pro ou AFNOR PDP) **Destinations supportées :** - **Chorus Pro** : plateforme B2G française (factures vers secteur public) - **AFNOR PDP** : Plateformes de Dématérialisation Partenaires **Différences avec la version synchrone :** - ✅ **Non-bloquant** : Retourne immédiatement un `id_tache` (HTTP 202 Accepted) - ✅ **Traitement en arrière-plan** : La facture est traitée par un worker Celery - ✅ **Suivi d'avancement** : Utilisez `/taches/{id_tache}/statut` pour suivre le statut - ✅ **Idéal pour gros volumes** : Permet de traiter de nombreuses factures en parallèle **Comment utiliser :** 1. **Soumission** : Appelez cet endpoint avec vos données de facture 2. **Retour immédiat** : Vous recevez un `id_tache` (ex: \"abc123-def456\") 3. **Suivi** : Appelez `/taches/{id_tache}/statut` pour vérifier l'avancement 4. **Résultat** : Quand `statut = \"SUCCESS\"`, le champ `resultat` contient la réponse complète **Credentials et signature** : Mêmes modes que la version synchrone (JWT ou payload).
406
-
407
- :param soumettre_facture_complete_request: (required)
408
- :type soumettre_facture_complete_request: SoumettreFactureCompleteRequest
409
- :param _request_timeout: timeout setting for this request. If one
410
- number provided, it will be total request
411
- timeout. It can also be a pair (tuple) of
412
- (connection, read) timeouts.
413
- :type _request_timeout: int, tuple(int, int), optional
414
- :param _request_auth: set to override the auth_settings for an a single
415
- request; this effectively ignores the
416
- authentication in the spec for a single request.
417
- :type _request_auth: dict, optional
418
- :param _content_type: force content-type for the request.
419
- :type _content_type: str, Optional
420
- :param _headers: set to override the headers for a single
421
- request; this effectively ignores the headers
422
- in the spec for a single request.
423
- :type _headers: dict, optional
424
- :param _host_index: set to override the host_index for a single
425
- request; this effectively ignores the host_index
426
- in the spec for a single request.
427
- :type _host_index: int, optional
428
- :return: Returns the result object.
429
- """ # noqa: E501
430
-
431
- _param = self._soumettre_facture_complete_async_api_v1_traitement_factures_soumettre_complete_async_post_serialize(
432
- soumettre_facture_complete_request=soumettre_facture_complete_request,
433
- _request_auth=_request_auth,
434
- _content_type=_content_type,
435
- _headers=_headers,
436
- _host_index=_host_index
437
- )
438
-
439
- _response_types_map: Dict[str, Optional[str]] = {
440
- '202': "ReponseTache",
441
- '422': "HTTPValidationError",
442
- }
443
- response_data = self.api_client.call_api(
444
- *_param,
445
- _request_timeout=_request_timeout
446
- )
447
- response_data.read()
448
- return self.api_client.response_deserialize(
449
- response_data=response_data,
450
- response_types_map=_response_types_map,
451
- )
452
-
453
-
454
- @validate_call
455
- def soumettre_facture_complete_async_api_v1_traitement_factures_soumettre_complete_async_post_without_preload_content(
456
- self,
457
- soumettre_facture_complete_request: SoumettreFactureCompleteRequest,
458
- _request_timeout: Union[
459
- None,
460
- Annotated[StrictFloat, Field(gt=0)],
461
- Tuple[
462
- Annotated[StrictFloat, Field(gt=0)],
463
- Annotated[StrictFloat, Field(gt=0)]
464
- ]
465
- ] = None,
466
- _request_auth: Optional[Dict[StrictStr, Any]] = None,
467
- _content_type: Optional[StrictStr] = None,
468
- _headers: Optional[Dict[StrictStr, Any]] = None,
469
- _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
470
- ) -> RESTResponseType:
471
- """Soumettre une facture complète (asynchrone avec Celery)
472
-
473
- Version asynchrone de l'endpoint `/factures/soumettre-complete` utilisant Celery pour le traitement en arrière-plan. **Workflow automatisé (identique à la version synchrone) :** 1. **Auto-enrichissement** (optionnel) : récupère les données via APIs publiques et Chorus Pro/AFNOR 2. **Génération PDF Factur-X** : crée un PDF/A-3 avec XML embarqué 3. **Signature électronique** (optionnelle) : signe le PDF avec un certificat 4. **Soumission** : envoie vers la destination choisie (Chorus Pro ou AFNOR PDP) **Destinations supportées :** - **Chorus Pro** : plateforme B2G française (factures vers secteur public) - **AFNOR PDP** : Plateformes de Dématérialisation Partenaires **Différences avec la version synchrone :** - ✅ **Non-bloquant** : Retourne immédiatement un `id_tache` (HTTP 202 Accepted) - ✅ **Traitement en arrière-plan** : La facture est traitée par un worker Celery - ✅ **Suivi d'avancement** : Utilisez `/taches/{id_tache}/statut` pour suivre le statut - ✅ **Idéal pour gros volumes** : Permet de traiter de nombreuses factures en parallèle **Comment utiliser :** 1. **Soumission** : Appelez cet endpoint avec vos données de facture 2. **Retour immédiat** : Vous recevez un `id_tache` (ex: \"abc123-def456\") 3. **Suivi** : Appelez `/taches/{id_tache}/statut` pour vérifier l'avancement 4. **Résultat** : Quand `statut = \"SUCCESS\"`, le champ `resultat` contient la réponse complète **Credentials et signature** : Mêmes modes que la version synchrone (JWT ou payload).
474
-
475
- :param soumettre_facture_complete_request: (required)
476
- :type soumettre_facture_complete_request: SoumettreFactureCompleteRequest
477
- :param _request_timeout: timeout setting for this request. If one
478
- number provided, it will be total request
479
- timeout. It can also be a pair (tuple) of
480
- (connection, read) timeouts.
481
- :type _request_timeout: int, tuple(int, int), optional
482
- :param _request_auth: set to override the auth_settings for an a single
483
- request; this effectively ignores the
484
- authentication in the spec for a single request.
485
- :type _request_auth: dict, optional
486
- :param _content_type: force content-type for the request.
487
- :type _content_type: str, Optional
488
- :param _headers: set to override the headers for a single
489
- request; this effectively ignores the headers
490
- in the spec for a single request.
491
- :type _headers: dict, optional
492
- :param _host_index: set to override the host_index for a single
493
- request; this effectively ignores the host_index
494
- in the spec for a single request.
495
- :type _host_index: int, optional
496
- :return: Returns the result object.
497
- """ # noqa: E501
498
-
499
- _param = self._soumettre_facture_complete_async_api_v1_traitement_factures_soumettre_complete_async_post_serialize(
500
- soumettre_facture_complete_request=soumettre_facture_complete_request,
501
- _request_auth=_request_auth,
502
- _content_type=_content_type,
503
- _headers=_headers,
504
- _host_index=_host_index
505
- )
506
-
507
- _response_types_map: Dict[str, Optional[str]] = {
508
- '202': "ReponseTache",
509
- '422': "HTTPValidationError",
510
- }
511
- response_data = self.api_client.call_api(
512
- *_param,
513
- _request_timeout=_request_timeout
514
- )
515
- return response_data.response
516
-
517
-
518
- def _soumettre_facture_complete_async_api_v1_traitement_factures_soumettre_complete_async_post_serialize(
519
- self,
520
- soumettre_facture_complete_request,
521
- _request_auth,
522
- _content_type,
523
- _headers,
524
- _host_index,
525
- ) -> RequestSerialized:
526
-
527
- _host = None
528
-
529
- _collection_formats: Dict[str, str] = {
530
- }
531
-
532
- _path_params: Dict[str, str] = {}
533
- _query_params: List[Tuple[str, str]] = []
534
- _header_params: Dict[str, Optional[str]] = _headers or {}
535
- _form_params: List[Tuple[str, str]] = []
536
- _files: Dict[
537
- str, Union[str, bytes, List[str], List[bytes], List[Tuple[str, bytes]]]
538
- ] = {}
539
- _body_params: Optional[bytes] = None
540
-
541
- # process the path parameters
542
- # process the query parameters
543
- # process the header parameters
544
- # process the form parameters
545
- # process the body parameter
546
- if soumettre_facture_complete_request is not None:
547
- _body_params = soumettre_facture_complete_request
548
-
549
-
550
- # set the HTTP header `Accept`
551
- if 'Accept' not in _header_params:
552
- _header_params['Accept'] = self.api_client.select_header_accept(
553
- [
554
- 'application/json'
555
- ]
556
- )
557
-
558
- # set the HTTP header `Content-Type`
559
- if _content_type:
560
- _header_params['Content-Type'] = _content_type
561
- else:
562
- _default_content_type = (
563
- self.api_client.select_header_content_type(
564
- [
565
- 'application/json'
566
- ]
567
- )
568
- )
569
- if _default_content_type is not None:
570
- _header_params['Content-Type'] = _default_content_type
571
-
572
- # authentication setting
573
- _auth_settings: List[str] = [
574
- 'HTTPBearer'
575
- ]
576
-
577
- return self.api_client.param_serialize(
578
- method='POST',
579
- resource_path='/api/v1/traitement/factures/soumettre-complete-async',
580
- path_params=_path_params,
581
- query_params=_query_params,
582
- header_params=_header_params,
583
- body=_body_params,
584
- post_params=_form_params,
585
- files=_files,
586
- auth_settings=_auth_settings,
587
- collection_formats=_collection_formats,
588
- _host=_host,
589
- _request_auth=_request_auth
590
- )
591
-
592
-