factpulse 3.0.24 → 3.0.26
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.
- checksums.yaml +4 -4
- data/CHANGELOG.md +3 -3
- data/Gemfile.lock +1 -1
- data/README.md +19 -26
- data/docs/AFNORPDPPADirectoryServiceApi.md +96 -286
- data/docs/{AcceptLanguage.md → FactureElectroniqueModelsInvoiceTypeCode.md} +2 -2
- data/docs/InvoiceInput.md +1 -1
- data/docs/SimplifiedInvoiceData.md +1 -1
- data/lib/factpulse/api/afnorpdppa_directory_service_api.rb +18 -105
- data/lib/factpulse/helpers/client.rb +2 -2
- data/lib/factpulse/models/{facture_electronique_rest_api_schemas_ereporting_invoice_type_code.rb → facture_electronique_models_invoice_type_code.rb} +20 -9
- data/lib/factpulse/models/invoice_input.rb +1 -1
- data/lib/factpulse/models/invoice_type_code.rb +6 -17
- data/lib/factpulse/models/simplified_invoice_data.rb +1 -1
- data/lib/factpulse/version.rb +1 -1
- data/lib/factpulse.rb +1 -5
- metadata +3 -11
- data/docs/DirectoryLineInclude.md +0 -15
- data/docs/FactureElectroniqueRestApiSchemasEreportingInvoiceTypeCode.md +0 -15
- data/docs/RoutingCodeInclude.md +0 -15
- data/docs/SiretInclude.md +0 -15
- data/lib/factpulse/models/accept_language.rb +0 -40
- data/lib/factpulse/models/directory_line_include.rb +0 -42
- data/lib/factpulse/models/routing_code_include.rb +0 -40
- data/lib/factpulse/models/siret_include.rb +0 -39
|
@@ -14,15 +14,26 @@ require 'date'
|
|
|
14
14
|
require 'time'
|
|
15
15
|
|
|
16
16
|
module FactPulse
|
|
17
|
-
class
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
17
|
+
class FactureElectroniqueModelsInvoiceTypeCode
|
|
18
|
+
INVOICE = "380".freeze
|
|
19
|
+
SELF_BILLED_INVOICE = "389".freeze
|
|
20
|
+
FACTORED_INVOICE = "393".freeze
|
|
21
|
+
SELF_BILLED_FACTORED_INVOICE = "501".freeze
|
|
22
|
+
PREPAYMENT_INVOICE = "386".freeze
|
|
23
|
+
SELF_BILLED_PREPAYMENT_INVOICE = "500".freeze
|
|
24
|
+
CORRECTIVE_INVOICE = "384".freeze
|
|
25
|
+
SELF_BILLED_CORRECTIVE_INVOICE = "471".freeze
|
|
26
|
+
FACTORED_CORRECTIVE_INVOICE = "472".freeze
|
|
27
|
+
SELF_BILLED_FACTORED_CORRECTIVE_INVOICE = "473".freeze
|
|
28
|
+
CREDIT_NOTE = "381".freeze
|
|
29
|
+
SELF_BILLED_CREDIT_NOTE = "261".freeze
|
|
30
|
+
GLOBAL_ALLOWANCE_CREDIT_NOTE = "262".freeze
|
|
31
|
+
FACTORED_CREDIT_NOTE = "396".freeze
|
|
32
|
+
SELF_BILLED_FACTORED_CREDIT_NOTE = "502".freeze
|
|
33
|
+
PREPAYMENT_CREDIT_NOTE = "503".freeze
|
|
23
34
|
|
|
24
35
|
def self.all_vars
|
|
25
|
-
@all_vars ||= [
|
|
36
|
+
@all_vars ||= [INVOICE, SELF_BILLED_INVOICE, FACTORED_INVOICE, SELF_BILLED_FACTORED_INVOICE, PREPAYMENT_INVOICE, SELF_BILLED_PREPAYMENT_INVOICE, CORRECTIVE_INVOICE, SELF_BILLED_CORRECTIVE_INVOICE, FACTORED_CORRECTIVE_INVOICE, SELF_BILLED_FACTORED_CORRECTIVE_INVOICE, CREDIT_NOTE, SELF_BILLED_CREDIT_NOTE, GLOBAL_ALLOWANCE_CREDIT_NOTE, FACTORED_CREDIT_NOTE, SELF_BILLED_FACTORED_CREDIT_NOTE, PREPAYMENT_CREDIT_NOTE].freeze
|
|
26
37
|
end
|
|
27
38
|
|
|
28
39
|
# Builds the enum from string
|
|
@@ -36,8 +47,8 @@ module FactPulse
|
|
|
36
47
|
# @param [String] The enum value in the form of the string
|
|
37
48
|
# @return [String] The enum value
|
|
38
49
|
def build_from_hash(value)
|
|
39
|
-
return value if
|
|
40
|
-
raise "Invalid ENUM value #{value} for class #
|
|
50
|
+
return value if FactureElectroniqueModelsInvoiceTypeCode.all_vars.include?(value)
|
|
51
|
+
raise "Invalid ENUM value #{value} for class #FactureElectroniqueModelsInvoiceTypeCode"
|
|
41
52
|
end
|
|
42
53
|
end
|
|
43
54
|
end
|
|
@@ -112,7 +112,7 @@ module FactPulse
|
|
|
112
112
|
{
|
|
113
113
|
:'invoice_id' => :'String',
|
|
114
114
|
:'issue_date' => :'Date',
|
|
115
|
-
:'type_code' => :'
|
|
115
|
+
:'type_code' => :'InvoiceTypeCode',
|
|
116
116
|
:'currency' => :'Currency',
|
|
117
117
|
:'due_date' => :'Date',
|
|
118
118
|
:'seller_siren' => :'String',
|
|
@@ -15,25 +15,14 @@ require 'time'
|
|
|
15
15
|
|
|
16
16
|
module FactPulse
|
|
17
17
|
class InvoiceTypeCode
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
SELF_BILLED_PREPAYMENT_INVOICE = "500".freeze
|
|
24
|
-
CORRECTIVE_INVOICE = "384".freeze
|
|
25
|
-
SELF_BILLED_CORRECTIVE_INVOICE = "471".freeze
|
|
26
|
-
FACTORED_CORRECTIVE_INVOICE = "472".freeze
|
|
27
|
-
SELF_BILLED_FACTORED_CORRECTIVE_INVOICE = "473".freeze
|
|
28
|
-
CREDIT_NOTE = "381".freeze
|
|
29
|
-
SELF_BILLED_CREDIT_NOTE = "261".freeze
|
|
30
|
-
GLOBAL_ALLOWANCE_CREDIT_NOTE = "262".freeze
|
|
31
|
-
FACTORED_CREDIT_NOTE = "396".freeze
|
|
32
|
-
SELF_BILLED_FACTORED_CREDIT_NOTE = "502".freeze
|
|
33
|
-
PREPAYMENT_CREDIT_NOTE = "503".freeze
|
|
18
|
+
N380 = "380".freeze
|
|
19
|
+
N381 = "381".freeze
|
|
20
|
+
N384 = "384".freeze
|
|
21
|
+
N389 = "389".freeze
|
|
22
|
+
N386 = "386".freeze
|
|
34
23
|
|
|
35
24
|
def self.all_vars
|
|
36
|
-
@all_vars ||= [
|
|
25
|
+
@all_vars ||= [N380, N381, N384, N389, N386].freeze
|
|
37
26
|
end
|
|
38
27
|
|
|
39
28
|
# Builds the enum from string
|
|
@@ -111,7 +111,7 @@ module FactPulse
|
|
|
111
111
|
:'comment' => :'String',
|
|
112
112
|
:'purchase_order_reference' => :'String',
|
|
113
113
|
:'contract_reference' => :'String',
|
|
114
|
-
:'invoice_type' => :'
|
|
114
|
+
:'invoice_type' => :'FactureElectroniqueModelsInvoiceTypeCode',
|
|
115
115
|
:'preceding_invoice_reference' => :'String',
|
|
116
116
|
:'operation_nature' => :'OperationNature',
|
|
117
117
|
:'invoicing_framework' => :'InvoicingFrameworkCode'
|
data/lib/factpulse/version.rb
CHANGED
data/lib/factpulse.rb
CHANGED
|
@@ -115,7 +115,6 @@ require 'factpulse/models/afnor_update_put_routing_code_body'
|
|
|
115
115
|
require 'factpulse/models/afnor_webhook_callback_content'
|
|
116
116
|
require 'factpulse/models/api_error'
|
|
117
117
|
require 'factpulse/models/api_profile'
|
|
118
|
-
require 'factpulse/models/accept_language'
|
|
119
118
|
require 'factpulse/models/acknowledgment_status'
|
|
120
119
|
require 'factpulse/models/additional_document'
|
|
121
120
|
require 'factpulse/models/aggregated_payment_input'
|
|
@@ -148,7 +147,6 @@ require 'factpulse/models/currency'
|
|
|
148
147
|
require 'factpulse/models/currency_code'
|
|
149
148
|
require 'factpulse/models/delivery_party'
|
|
150
149
|
require 'factpulse/models/destination'
|
|
151
|
-
require 'factpulse/models/directory_line_include'
|
|
152
150
|
require 'factpulse/models/doc_type'
|
|
153
151
|
require 'factpulse/models/document_type_info'
|
|
154
152
|
require 'factpulse/models/e_reporting_flow_type'
|
|
@@ -160,7 +158,7 @@ require 'factpulse/models/error_source'
|
|
|
160
158
|
require 'factpulse/models/extraction_info'
|
|
161
159
|
require 'factpulse/models/factur_x_invoice'
|
|
162
160
|
require 'factpulse/models/factur_xpdf_info'
|
|
163
|
-
require 'factpulse/models/
|
|
161
|
+
require 'factpulse/models/facture_electronique_models_invoice_type_code'
|
|
164
162
|
require 'factpulse/models/facture_electronique_rest_api_schemas_processing_chorus_pro_credentials'
|
|
165
163
|
require 'factpulse/models/field_status'
|
|
166
164
|
require 'factpulse/models/file_info'
|
|
@@ -231,7 +229,6 @@ require 'factpulse/models/recipient'
|
|
|
231
229
|
require 'factpulse/models/report_period'
|
|
232
230
|
require 'factpulse/models/report_sender'
|
|
233
231
|
require 'factpulse/models/rounding_amount'
|
|
234
|
-
require 'factpulse/models/routing_code_include'
|
|
235
232
|
require 'factpulse/models/schematron_validation_error'
|
|
236
233
|
require 'factpulse/models/scheme_id'
|
|
237
234
|
require 'factpulse/models/search_flow_request'
|
|
@@ -244,7 +241,6 @@ require 'factpulse/models/signature_info'
|
|
|
244
241
|
require 'factpulse/models/signature_info_api'
|
|
245
242
|
require 'factpulse/models/signature_parameters'
|
|
246
243
|
require 'factpulse/models/simplified_invoice_data'
|
|
247
|
-
require 'factpulse/models/siret_include'
|
|
248
244
|
require 'factpulse/models/structure_info'
|
|
249
245
|
require 'factpulse/models/structure_parameters'
|
|
250
246
|
require 'factpulse/models/structure_service'
|
metadata
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
|
2
2
|
name: factpulse
|
|
3
3
|
version: !ruby/object:Gem::Version
|
|
4
|
-
version: 3.0.
|
|
4
|
+
version: 3.0.26
|
|
5
5
|
platform: ruby
|
|
6
6
|
authors:
|
|
7
7
|
- OpenAPI-Generator
|
|
@@ -216,7 +216,6 @@ files:
|
|
|
216
216
|
- docs/AFNORWebhookCallbackContent.md
|
|
217
217
|
- docs/APIError.md
|
|
218
218
|
- docs/APIProfile.md
|
|
219
|
-
- docs/AcceptLanguage.md
|
|
220
219
|
- docs/AcknowledgmentStatus.md
|
|
221
220
|
- docs/AdditionalDocument.md
|
|
222
221
|
- docs/AggregatedPaymentInput.md
|
|
@@ -250,7 +249,6 @@ files:
|
|
|
250
249
|
- docs/CurrencyCode.md
|
|
251
250
|
- docs/DeliveryParty.md
|
|
252
251
|
- docs/Destination.md
|
|
253
|
-
- docs/DirectoryLineInclude.md
|
|
254
252
|
- docs/DocType.md
|
|
255
253
|
- docs/DocumentConversionApi.md
|
|
256
254
|
- docs/DocumentTypeInfo.md
|
|
@@ -265,7 +263,7 @@ files:
|
|
|
265
263
|
- docs/ExtractionInfo.md
|
|
266
264
|
- docs/FacturXInvoice.md
|
|
267
265
|
- docs/FacturXPDFInfo.md
|
|
268
|
-
- docs/
|
|
266
|
+
- docs/FactureElectroniqueModelsInvoiceTypeCode.md
|
|
269
267
|
- docs/FactureElectroniqueRestApiSchemasProcessingChorusProCredentials.md
|
|
270
268
|
- docs/FieldStatus.md
|
|
271
269
|
- docs/FileInfo.md
|
|
@@ -339,7 +337,6 @@ files:
|
|
|
339
337
|
- docs/ReportPeriod.md
|
|
340
338
|
- docs/ReportSender.md
|
|
341
339
|
- docs/RoundingAmount.md
|
|
342
|
-
- docs/RoutingCodeInclude.md
|
|
343
340
|
- docs/SchematronValidationError.md
|
|
344
341
|
- docs/SchemeID.md
|
|
345
342
|
- docs/SearchFlowRequest.md
|
|
@@ -352,7 +349,6 @@ files:
|
|
|
352
349
|
- docs/SignatureInfoAPI.md
|
|
353
350
|
- docs/SignatureParameters.md
|
|
354
351
|
- docs/SimplifiedInvoiceData.md
|
|
355
|
-
- docs/SiretInclude.md
|
|
356
352
|
- docs/StructureInfo.md
|
|
357
353
|
- docs/StructureParameters.md
|
|
358
354
|
- docs/StructureService.md
|
|
@@ -426,7 +422,6 @@ files:
|
|
|
426
422
|
- lib/factpulse/helpers/client.rb
|
|
427
423
|
- lib/factpulse/helpers/exceptions.rb
|
|
428
424
|
- lib/factpulse/helpers/helpers.rb
|
|
429
|
-
- lib/factpulse/models/accept_language.rb
|
|
430
425
|
- lib/factpulse/models/acknowledgment_status.rb
|
|
431
426
|
- lib/factpulse/models/additional_document.rb
|
|
432
427
|
- lib/factpulse/models/afnor_acknowledgement.rb
|
|
@@ -556,7 +551,6 @@ files:
|
|
|
556
551
|
- lib/factpulse/models/currency_code.rb
|
|
557
552
|
- lib/factpulse/models/delivery_party.rb
|
|
558
553
|
- lib/factpulse/models/destination.rb
|
|
559
|
-
- lib/factpulse/models/directory_line_include.rb
|
|
560
554
|
- lib/factpulse/models/doc_type.rb
|
|
561
555
|
- lib/factpulse/models/document_type_info.rb
|
|
562
556
|
- lib/factpulse/models/e_reporting_flow_type.rb
|
|
@@ -568,7 +562,7 @@ files:
|
|
|
568
562
|
- lib/factpulse/models/extraction_info.rb
|
|
569
563
|
- lib/factpulse/models/factur_x_invoice.rb
|
|
570
564
|
- lib/factpulse/models/factur_xpdf_info.rb
|
|
571
|
-
- lib/factpulse/models/
|
|
565
|
+
- lib/factpulse/models/facture_electronique_models_invoice_type_code.rb
|
|
572
566
|
- lib/factpulse/models/facture_electronique_rest_api_schemas_processing_chorus_pro_credentials.rb
|
|
573
567
|
- lib/factpulse/models/field_status.rb
|
|
574
568
|
- lib/factpulse/models/file_info.rb
|
|
@@ -639,7 +633,6 @@ files:
|
|
|
639
633
|
- lib/factpulse/models/report_period.rb
|
|
640
634
|
- lib/factpulse/models/report_sender.rb
|
|
641
635
|
- lib/factpulse/models/rounding_amount.rb
|
|
642
|
-
- lib/factpulse/models/routing_code_include.rb
|
|
643
636
|
- lib/factpulse/models/schematron_validation_error.rb
|
|
644
637
|
- lib/factpulse/models/scheme_id.rb
|
|
645
638
|
- lib/factpulse/models/search_flow_request.rb
|
|
@@ -652,7 +645,6 @@ files:
|
|
|
652
645
|
- lib/factpulse/models/signature_info_api.rb
|
|
653
646
|
- lib/factpulse/models/signature_parameters.rb
|
|
654
647
|
- lib/factpulse/models/simplified_invoice_data.rb
|
|
655
|
-
- lib/factpulse/models/siret_include.rb
|
|
656
648
|
- lib/factpulse/models/structure_info.rb
|
|
657
649
|
- lib/factpulse/models/structure_parameters.rb
|
|
658
650
|
- lib/factpulse/models/structure_service.rb
|
|
@@ -1,15 +0,0 @@
|
|
|
1
|
-
# FactPulse::FactureElectroniqueRestApiSchemasEreportingInvoiceTypeCode
|
|
2
|
-
|
|
3
|
-
## Properties
|
|
4
|
-
|
|
5
|
-
| Name | Type | Description | Notes |
|
|
6
|
-
| ---- | ---- | ----------- | ----- |
|
|
7
|
-
|
|
8
|
-
## Example
|
|
9
|
-
|
|
10
|
-
```ruby
|
|
11
|
-
require 'factpulse'
|
|
12
|
-
|
|
13
|
-
instance = FactPulse::FactureElectroniqueRestApiSchemasEreportingInvoiceTypeCode.new()
|
|
14
|
-
```
|
|
15
|
-
|
data/docs/RoutingCodeInclude.md
DELETED
data/docs/SiretInclude.md
DELETED
|
@@ -1,40 +0,0 @@
|
|
|
1
|
-
=begin
|
|
2
|
-
#FactPulse REST API
|
|
3
|
-
|
|
4
|
-
# REST API for electronic invoicing in France: Factur-X, AFNOR PDP/PA, electronic signatures. ## 🎯 Main Features ### 📄 Factur-X Invoice Generation - **Formats**: XML only or PDF/A-3 with embedded XML - **Profiles**: MINIMUM, BASIC, EN16931, EXTENDED - **Standards**: EN 16931 (EU directive 2014/55), ISO 19005-3 (PDF/A-3), CII (UN/CEFACT) - **🆕 Simplified Format**: Generation from SIRET + auto-enrichment (Chorus Pro API + Business Search) ### ✅ Validation and Compliance - **XML Validation**: Schematron (45 to 210+ rules depending on profile) - **PDF Validation**: PDF/A-3, Factur-X XMP metadata, electronic signatures - **VeraPDF**: Strict PDF/A validation (146+ ISO 19005-3 rules) - **Asynchronous Processing**: Celery support for heavy validations (VeraPDF) ### 📡 AFNOR PDP/PA Integration (XP Z12-013) - **Flow Submission**: Send invoices to Partner Dematerialization Platforms - **Flow Search**: View submitted invoices - **Download**: Retrieve PDF/A-3 with XML - **Directory Service**: Company search (SIREN/SIRET) - **Multi-client**: Support for multiple PDP configs per user (stored credentials or zero-storage) ### ✍️ PDF Electronic Signature - **Standards**: PAdES-B-B, PAdES-B-T (RFC 3161 timestamping), PAdES-B-LT (long-term archival) - **eIDAS Levels**: SES (self-signed), AdES (commercial CA), QES (QTSP) - **Validation**: Cryptographic integrity and certificate verification - **Certificate Generation**: Self-signed X.509 certificates for testing ### 🔄 Asynchronous Processing - **Celery**: Asynchronous generation, validation and signing - **Polling**: Status tracking via `/tasks/{task_id}/status` - **No timeout**: Ideal for large files or heavy validations ## 🔒 Authentication All requests require a **JWT token** in the Authorization header: ``` Authorization: Bearer YOUR_JWT_TOKEN ``` ### How to obtain a JWT token? #### 🔑 Method 1: `/api/token/` API (Recommended) **URL:** `https://factpulse.fr/api/token/` This method is **recommended** for integration in your applications and CI/CD workflows. **Prerequisites:** Having set a password on your account **For users registered via email/password:** - You already have a password, use it directly **For users registered via OAuth (Google/GitHub):** - You must first set a password at: https://factpulse.fr/accounts/password/set/ - Once the password is created, you can use the API **Request example:** ```bash curl -X POST https://factpulse.fr/api/token/ \\ -H \"Content-Type: application/json\" \\ -d '{ \"username\": \"your_email@example.com\", \"password\": \"your_password\" }' ``` **Optional `client_uid` parameter:** To select credentials for a specific client (PA/PDP, Chorus Pro, signing certificates), add `client_uid`: ```bash curl -X POST https://factpulse.fr/api/token/ \\ -H \"Content-Type: application/json\" \\ -d '{ \"username\": \"your_email@example.com\", \"password\": \"your_password\", \"client_uid\": \"550e8400-e29b-41d4-a716-446655440000\" }' ``` The `client_uid` will be included in the JWT and allow the API to automatically use: - AFNOR/PDP credentials configured for this client - Chorus Pro credentials configured for this client - Electronic signature certificates configured for this client **Response:** ```json { \"access\": \"eyJ0eXAiOiJKV1QiLCJhbGc...\", // Access token (validity: 30 min) \"refresh\": \"eyJ0eXAiOiJKV1QiLCJhbGc...\" // Refresh token (validity: 7 days) } ``` **Advantages:** - ✅ Full automation (CI/CD, scripts) - ✅ Programmatic token management - ✅ Refresh token support for automatic access renewal - ✅ Easy integration in any language/tool #### 🖥️ Method 2: Dashboard Generation (Alternative) **URL:** https://factpulse.fr/api/dashboard/ This method is suitable for quick tests or occasional use via the graphical interface. **How it works:** - Log in to the dashboard - Use the \"Generate Test Token\" or \"Generate Production Token\" buttons - Works for **all** users (OAuth and email/password), without requiring a password **Token types:** - **Test Token**: 24h validity, 1000 calls/day quota (free) - **Production Token**: 7 days validity, quota based on your plan **Advantages:** - ✅ Quick for API testing - ✅ No password required - ✅ Simple visual interface **Disadvantages:** - ❌ Requires manual action - ❌ No refresh token - ❌ Less suited for automation ### 📚 Full Documentation For more information on authentication and API usage: https://factpulse.fr/documentation-api/
|
|
5
|
-
|
|
6
|
-
The version of the OpenAPI document: 1.0.0
|
|
7
|
-
Contact: contact@factpulse.fr
|
|
8
|
-
Generated by: https://openapi-generator.tech
|
|
9
|
-
Generator version: 7.19.0-SNAPSHOT
|
|
10
|
-
|
|
11
|
-
=end
|
|
12
|
-
|
|
13
|
-
require 'date'
|
|
14
|
-
require 'time'
|
|
15
|
-
|
|
16
|
-
module FactPulse
|
|
17
|
-
class AcceptLanguage
|
|
18
|
-
FR = "fr".freeze
|
|
19
|
-
EN = "en".freeze
|
|
20
|
-
|
|
21
|
-
def self.all_vars
|
|
22
|
-
@all_vars ||= [FR, EN].freeze
|
|
23
|
-
end
|
|
24
|
-
|
|
25
|
-
# Builds the enum from string
|
|
26
|
-
# @param [String] The enum value in the form of the string
|
|
27
|
-
# @return [String] The enum value
|
|
28
|
-
def self.build_from_hash(value)
|
|
29
|
-
new.build_from_hash(value)
|
|
30
|
-
end
|
|
31
|
-
|
|
32
|
-
# Builds the enum from string
|
|
33
|
-
# @param [String] The enum value in the form of the string
|
|
34
|
-
# @return [String] The enum value
|
|
35
|
-
def build_from_hash(value)
|
|
36
|
-
return value if AcceptLanguage.all_vars.include?(value)
|
|
37
|
-
raise "Invalid ENUM value #{value} for class #AcceptLanguage"
|
|
38
|
-
end
|
|
39
|
-
end
|
|
40
|
-
end
|
|
@@ -1,42 +0,0 @@
|
|
|
1
|
-
=begin
|
|
2
|
-
#FactPulse REST API
|
|
3
|
-
|
|
4
|
-
# REST API for electronic invoicing in France: Factur-X, AFNOR PDP/PA, electronic signatures. ## 🎯 Main Features ### 📄 Factur-X Invoice Generation - **Formats**: XML only or PDF/A-3 with embedded XML - **Profiles**: MINIMUM, BASIC, EN16931, EXTENDED - **Standards**: EN 16931 (EU directive 2014/55), ISO 19005-3 (PDF/A-3), CII (UN/CEFACT) - **🆕 Simplified Format**: Generation from SIRET + auto-enrichment (Chorus Pro API + Business Search) ### ✅ Validation and Compliance - **XML Validation**: Schematron (45 to 210+ rules depending on profile) - **PDF Validation**: PDF/A-3, Factur-X XMP metadata, electronic signatures - **VeraPDF**: Strict PDF/A validation (146+ ISO 19005-3 rules) - **Asynchronous Processing**: Celery support for heavy validations (VeraPDF) ### 📡 AFNOR PDP/PA Integration (XP Z12-013) - **Flow Submission**: Send invoices to Partner Dematerialization Platforms - **Flow Search**: View submitted invoices - **Download**: Retrieve PDF/A-3 with XML - **Directory Service**: Company search (SIREN/SIRET) - **Multi-client**: Support for multiple PDP configs per user (stored credentials or zero-storage) ### ✍️ PDF Electronic Signature - **Standards**: PAdES-B-B, PAdES-B-T (RFC 3161 timestamping), PAdES-B-LT (long-term archival) - **eIDAS Levels**: SES (self-signed), AdES (commercial CA), QES (QTSP) - **Validation**: Cryptographic integrity and certificate verification - **Certificate Generation**: Self-signed X.509 certificates for testing ### 🔄 Asynchronous Processing - **Celery**: Asynchronous generation, validation and signing - **Polling**: Status tracking via `/tasks/{task_id}/status` - **No timeout**: Ideal for large files or heavy validations ## 🔒 Authentication All requests require a **JWT token** in the Authorization header: ``` Authorization: Bearer YOUR_JWT_TOKEN ``` ### How to obtain a JWT token? #### 🔑 Method 1: `/api/token/` API (Recommended) **URL:** `https://factpulse.fr/api/token/` This method is **recommended** for integration in your applications and CI/CD workflows. **Prerequisites:** Having set a password on your account **For users registered via email/password:** - You already have a password, use it directly **For users registered via OAuth (Google/GitHub):** - You must first set a password at: https://factpulse.fr/accounts/password/set/ - Once the password is created, you can use the API **Request example:** ```bash curl -X POST https://factpulse.fr/api/token/ \\ -H \"Content-Type: application/json\" \\ -d '{ \"username\": \"your_email@example.com\", \"password\": \"your_password\" }' ``` **Optional `client_uid` parameter:** To select credentials for a specific client (PA/PDP, Chorus Pro, signing certificates), add `client_uid`: ```bash curl -X POST https://factpulse.fr/api/token/ \\ -H \"Content-Type: application/json\" \\ -d '{ \"username\": \"your_email@example.com\", \"password\": \"your_password\", \"client_uid\": \"550e8400-e29b-41d4-a716-446655440000\" }' ``` The `client_uid` will be included in the JWT and allow the API to automatically use: - AFNOR/PDP credentials configured for this client - Chorus Pro credentials configured for this client - Electronic signature certificates configured for this client **Response:** ```json { \"access\": \"eyJ0eXAiOiJKV1QiLCJhbGc...\", // Access token (validity: 30 min) \"refresh\": \"eyJ0eXAiOiJKV1QiLCJhbGc...\" // Refresh token (validity: 7 days) } ``` **Advantages:** - ✅ Full automation (CI/CD, scripts) - ✅ Programmatic token management - ✅ Refresh token support for automatic access renewal - ✅ Easy integration in any language/tool #### 🖥️ Method 2: Dashboard Generation (Alternative) **URL:** https://factpulse.fr/api/dashboard/ This method is suitable for quick tests or occasional use via the graphical interface. **How it works:** - Log in to the dashboard - Use the \"Generate Test Token\" or \"Generate Production Token\" buttons - Works for **all** users (OAuth and email/password), without requiring a password **Token types:** - **Test Token**: 24h validity, 1000 calls/day quota (free) - **Production Token**: 7 days validity, quota based on your plan **Advantages:** - ✅ Quick for API testing - ✅ No password required - ✅ Simple visual interface **Disadvantages:** - ❌ Requires manual action - ❌ No refresh token - ❌ Less suited for automation ### 📚 Full Documentation For more information on authentication and API usage: https://factpulse.fr/documentation-api/
|
|
5
|
-
|
|
6
|
-
The version of the OpenAPI document: 1.0.0
|
|
7
|
-
Contact: contact@factpulse.fr
|
|
8
|
-
Generated by: https://openapi-generator.tech
|
|
9
|
-
Generator version: 7.19.0-SNAPSHOT
|
|
10
|
-
|
|
11
|
-
=end
|
|
12
|
-
|
|
13
|
-
require 'date'
|
|
14
|
-
require 'time'
|
|
15
|
-
|
|
16
|
-
module FactPulse
|
|
17
|
-
class DirectoryLineInclude
|
|
18
|
-
SIREN = "siren".freeze
|
|
19
|
-
SIRET = "siret".freeze
|
|
20
|
-
ROUTING_CODE = "routingCode".freeze
|
|
21
|
-
PLATFORM = "platform".freeze
|
|
22
|
-
|
|
23
|
-
def self.all_vars
|
|
24
|
-
@all_vars ||= [SIREN, SIRET, ROUTING_CODE, PLATFORM].freeze
|
|
25
|
-
end
|
|
26
|
-
|
|
27
|
-
# Builds the enum from string
|
|
28
|
-
# @param [String] The enum value in the form of the string
|
|
29
|
-
# @return [String] The enum value
|
|
30
|
-
def self.build_from_hash(value)
|
|
31
|
-
new.build_from_hash(value)
|
|
32
|
-
end
|
|
33
|
-
|
|
34
|
-
# Builds the enum from string
|
|
35
|
-
# @param [String] The enum value in the form of the string
|
|
36
|
-
# @return [String] The enum value
|
|
37
|
-
def build_from_hash(value)
|
|
38
|
-
return value if DirectoryLineInclude.all_vars.include?(value)
|
|
39
|
-
raise "Invalid ENUM value #{value} for class #DirectoryLineInclude"
|
|
40
|
-
end
|
|
41
|
-
end
|
|
42
|
-
end
|
|
@@ -1,40 +0,0 @@
|
|
|
1
|
-
=begin
|
|
2
|
-
#FactPulse REST API
|
|
3
|
-
|
|
4
|
-
# REST API for electronic invoicing in France: Factur-X, AFNOR PDP/PA, electronic signatures. ## 🎯 Main Features ### 📄 Factur-X Invoice Generation - **Formats**: XML only or PDF/A-3 with embedded XML - **Profiles**: MINIMUM, BASIC, EN16931, EXTENDED - **Standards**: EN 16931 (EU directive 2014/55), ISO 19005-3 (PDF/A-3), CII (UN/CEFACT) - **🆕 Simplified Format**: Generation from SIRET + auto-enrichment (Chorus Pro API + Business Search) ### ✅ Validation and Compliance - **XML Validation**: Schematron (45 to 210+ rules depending on profile) - **PDF Validation**: PDF/A-3, Factur-X XMP metadata, electronic signatures - **VeraPDF**: Strict PDF/A validation (146+ ISO 19005-3 rules) - **Asynchronous Processing**: Celery support for heavy validations (VeraPDF) ### 📡 AFNOR PDP/PA Integration (XP Z12-013) - **Flow Submission**: Send invoices to Partner Dematerialization Platforms - **Flow Search**: View submitted invoices - **Download**: Retrieve PDF/A-3 with XML - **Directory Service**: Company search (SIREN/SIRET) - **Multi-client**: Support for multiple PDP configs per user (stored credentials or zero-storage) ### ✍️ PDF Electronic Signature - **Standards**: PAdES-B-B, PAdES-B-T (RFC 3161 timestamping), PAdES-B-LT (long-term archival) - **eIDAS Levels**: SES (self-signed), AdES (commercial CA), QES (QTSP) - **Validation**: Cryptographic integrity and certificate verification - **Certificate Generation**: Self-signed X.509 certificates for testing ### 🔄 Asynchronous Processing - **Celery**: Asynchronous generation, validation and signing - **Polling**: Status tracking via `/tasks/{task_id}/status` - **No timeout**: Ideal for large files or heavy validations ## 🔒 Authentication All requests require a **JWT token** in the Authorization header: ``` Authorization: Bearer YOUR_JWT_TOKEN ``` ### How to obtain a JWT token? #### 🔑 Method 1: `/api/token/` API (Recommended) **URL:** `https://factpulse.fr/api/token/` This method is **recommended** for integration in your applications and CI/CD workflows. **Prerequisites:** Having set a password on your account **For users registered via email/password:** - You already have a password, use it directly **For users registered via OAuth (Google/GitHub):** - You must first set a password at: https://factpulse.fr/accounts/password/set/ - Once the password is created, you can use the API **Request example:** ```bash curl -X POST https://factpulse.fr/api/token/ \\ -H \"Content-Type: application/json\" \\ -d '{ \"username\": \"your_email@example.com\", \"password\": \"your_password\" }' ``` **Optional `client_uid` parameter:** To select credentials for a specific client (PA/PDP, Chorus Pro, signing certificates), add `client_uid`: ```bash curl -X POST https://factpulse.fr/api/token/ \\ -H \"Content-Type: application/json\" \\ -d '{ \"username\": \"your_email@example.com\", \"password\": \"your_password\", \"client_uid\": \"550e8400-e29b-41d4-a716-446655440000\" }' ``` The `client_uid` will be included in the JWT and allow the API to automatically use: - AFNOR/PDP credentials configured for this client - Chorus Pro credentials configured for this client - Electronic signature certificates configured for this client **Response:** ```json { \"access\": \"eyJ0eXAiOiJKV1QiLCJhbGc...\", // Access token (validity: 30 min) \"refresh\": \"eyJ0eXAiOiJKV1QiLCJhbGc...\" // Refresh token (validity: 7 days) } ``` **Advantages:** - ✅ Full automation (CI/CD, scripts) - ✅ Programmatic token management - ✅ Refresh token support for automatic access renewal - ✅ Easy integration in any language/tool #### 🖥️ Method 2: Dashboard Generation (Alternative) **URL:** https://factpulse.fr/api/dashboard/ This method is suitable for quick tests or occasional use via the graphical interface. **How it works:** - Log in to the dashboard - Use the \"Generate Test Token\" or \"Generate Production Token\" buttons - Works for **all** users (OAuth and email/password), without requiring a password **Token types:** - **Test Token**: 24h validity, 1000 calls/day quota (free) - **Production Token**: 7 days validity, quota based on your plan **Advantages:** - ✅ Quick for API testing - ✅ No password required - ✅ Simple visual interface **Disadvantages:** - ❌ Requires manual action - ❌ No refresh token - ❌ Less suited for automation ### 📚 Full Documentation For more information on authentication and API usage: https://factpulse.fr/documentation-api/
|
|
5
|
-
|
|
6
|
-
The version of the OpenAPI document: 1.0.0
|
|
7
|
-
Contact: contact@factpulse.fr
|
|
8
|
-
Generated by: https://openapi-generator.tech
|
|
9
|
-
Generator version: 7.19.0-SNAPSHOT
|
|
10
|
-
|
|
11
|
-
=end
|
|
12
|
-
|
|
13
|
-
require 'date'
|
|
14
|
-
require 'time'
|
|
15
|
-
|
|
16
|
-
module FactPulse
|
|
17
|
-
class RoutingCodeInclude
|
|
18
|
-
SIREN = "siren".freeze
|
|
19
|
-
SIRET = "siret".freeze
|
|
20
|
-
|
|
21
|
-
def self.all_vars
|
|
22
|
-
@all_vars ||= [SIREN, SIRET].freeze
|
|
23
|
-
end
|
|
24
|
-
|
|
25
|
-
# Builds the enum from string
|
|
26
|
-
# @param [String] The enum value in the form of the string
|
|
27
|
-
# @return [String] The enum value
|
|
28
|
-
def self.build_from_hash(value)
|
|
29
|
-
new.build_from_hash(value)
|
|
30
|
-
end
|
|
31
|
-
|
|
32
|
-
# Builds the enum from string
|
|
33
|
-
# @param [String] The enum value in the form of the string
|
|
34
|
-
# @return [String] The enum value
|
|
35
|
-
def build_from_hash(value)
|
|
36
|
-
return value if RoutingCodeInclude.all_vars.include?(value)
|
|
37
|
-
raise "Invalid ENUM value #{value} for class #RoutingCodeInclude"
|
|
38
|
-
end
|
|
39
|
-
end
|
|
40
|
-
end
|
|
@@ -1,39 +0,0 @@
|
|
|
1
|
-
=begin
|
|
2
|
-
#FactPulse REST API
|
|
3
|
-
|
|
4
|
-
# REST API for electronic invoicing in France: Factur-X, AFNOR PDP/PA, electronic signatures. ## 🎯 Main Features ### 📄 Factur-X Invoice Generation - **Formats**: XML only or PDF/A-3 with embedded XML - **Profiles**: MINIMUM, BASIC, EN16931, EXTENDED - **Standards**: EN 16931 (EU directive 2014/55), ISO 19005-3 (PDF/A-3), CII (UN/CEFACT) - **🆕 Simplified Format**: Generation from SIRET + auto-enrichment (Chorus Pro API + Business Search) ### ✅ Validation and Compliance - **XML Validation**: Schematron (45 to 210+ rules depending on profile) - **PDF Validation**: PDF/A-3, Factur-X XMP metadata, electronic signatures - **VeraPDF**: Strict PDF/A validation (146+ ISO 19005-3 rules) - **Asynchronous Processing**: Celery support for heavy validations (VeraPDF) ### 📡 AFNOR PDP/PA Integration (XP Z12-013) - **Flow Submission**: Send invoices to Partner Dematerialization Platforms - **Flow Search**: View submitted invoices - **Download**: Retrieve PDF/A-3 with XML - **Directory Service**: Company search (SIREN/SIRET) - **Multi-client**: Support for multiple PDP configs per user (stored credentials or zero-storage) ### ✍️ PDF Electronic Signature - **Standards**: PAdES-B-B, PAdES-B-T (RFC 3161 timestamping), PAdES-B-LT (long-term archival) - **eIDAS Levels**: SES (self-signed), AdES (commercial CA), QES (QTSP) - **Validation**: Cryptographic integrity and certificate verification - **Certificate Generation**: Self-signed X.509 certificates for testing ### 🔄 Asynchronous Processing - **Celery**: Asynchronous generation, validation and signing - **Polling**: Status tracking via `/tasks/{task_id}/status` - **No timeout**: Ideal for large files or heavy validations ## 🔒 Authentication All requests require a **JWT token** in the Authorization header: ``` Authorization: Bearer YOUR_JWT_TOKEN ``` ### How to obtain a JWT token? #### 🔑 Method 1: `/api/token/` API (Recommended) **URL:** `https://factpulse.fr/api/token/` This method is **recommended** for integration in your applications and CI/CD workflows. **Prerequisites:** Having set a password on your account **For users registered via email/password:** - You already have a password, use it directly **For users registered via OAuth (Google/GitHub):** - You must first set a password at: https://factpulse.fr/accounts/password/set/ - Once the password is created, you can use the API **Request example:** ```bash curl -X POST https://factpulse.fr/api/token/ \\ -H \"Content-Type: application/json\" \\ -d '{ \"username\": \"your_email@example.com\", \"password\": \"your_password\" }' ``` **Optional `client_uid` parameter:** To select credentials for a specific client (PA/PDP, Chorus Pro, signing certificates), add `client_uid`: ```bash curl -X POST https://factpulse.fr/api/token/ \\ -H \"Content-Type: application/json\" \\ -d '{ \"username\": \"your_email@example.com\", \"password\": \"your_password\", \"client_uid\": \"550e8400-e29b-41d4-a716-446655440000\" }' ``` The `client_uid` will be included in the JWT and allow the API to automatically use: - AFNOR/PDP credentials configured for this client - Chorus Pro credentials configured for this client - Electronic signature certificates configured for this client **Response:** ```json { \"access\": \"eyJ0eXAiOiJKV1QiLCJhbGc...\", // Access token (validity: 30 min) \"refresh\": \"eyJ0eXAiOiJKV1QiLCJhbGc...\" // Refresh token (validity: 7 days) } ``` **Advantages:** - ✅ Full automation (CI/CD, scripts) - ✅ Programmatic token management - ✅ Refresh token support for automatic access renewal - ✅ Easy integration in any language/tool #### 🖥️ Method 2: Dashboard Generation (Alternative) **URL:** https://factpulse.fr/api/dashboard/ This method is suitable for quick tests or occasional use via the graphical interface. **How it works:** - Log in to the dashboard - Use the \"Generate Test Token\" or \"Generate Production Token\" buttons - Works for **all** users (OAuth and email/password), without requiring a password **Token types:** - **Test Token**: 24h validity, 1000 calls/day quota (free) - **Production Token**: 7 days validity, quota based on your plan **Advantages:** - ✅ Quick for API testing - ✅ No password required - ✅ Simple visual interface **Disadvantages:** - ❌ Requires manual action - ❌ No refresh token - ❌ Less suited for automation ### 📚 Full Documentation For more information on authentication and API usage: https://factpulse.fr/documentation-api/
|
|
5
|
-
|
|
6
|
-
The version of the OpenAPI document: 1.0.0
|
|
7
|
-
Contact: contact@factpulse.fr
|
|
8
|
-
Generated by: https://openapi-generator.tech
|
|
9
|
-
Generator version: 7.19.0-SNAPSHOT
|
|
10
|
-
|
|
11
|
-
=end
|
|
12
|
-
|
|
13
|
-
require 'date'
|
|
14
|
-
require 'time'
|
|
15
|
-
|
|
16
|
-
module FactPulse
|
|
17
|
-
class SiretInclude
|
|
18
|
-
SIREN = "siren".freeze
|
|
19
|
-
|
|
20
|
-
def self.all_vars
|
|
21
|
-
@all_vars ||= [SIREN].freeze
|
|
22
|
-
end
|
|
23
|
-
|
|
24
|
-
# Builds the enum from string
|
|
25
|
-
# @param [String] The enum value in the form of the string
|
|
26
|
-
# @return [String] The enum value
|
|
27
|
-
def self.build_from_hash(value)
|
|
28
|
-
new.build_from_hash(value)
|
|
29
|
-
end
|
|
30
|
-
|
|
31
|
-
# Builds the enum from string
|
|
32
|
-
# @param [String] The enum value in the form of the string
|
|
33
|
-
# @return [String] The enum value
|
|
34
|
-
def build_from_hash(value)
|
|
35
|
-
return value if SiretInclude.all_vars.include?(value)
|
|
36
|
-
raise "Invalid ENUM value #{value} for class #SiretInclude"
|
|
37
|
-
end
|
|
38
|
-
end
|
|
39
|
-
end
|