factpulse 3.0.37 → 4.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 042423d8a45da018867073e59b0173cdea776ce1d91e9155df003e4b584cda35
-  data.tar.gz: a1a81f9968d061000feea31ea45210afaecbef46f3e06fcef5d97a2ba47f91e5
+  metadata.gz: 0061473ad13efd96d8c31a87f167aa5c1d8722e43f960266fce4a50b66adee83
+  data.tar.gz: 6d066ab2f7b58959051286436f2a7f5d267873d105ba5fffa8b715a31f6bf57a
 SHA512:
-  metadata.gz: 01a510615ea1d102201119fa8d5b006c5d194a049b6ab97bfda1b9f2ffb6055c5c46ab4e755e420efa32f4eeb53d8112722a389f1fab928cf1e5ecac7f310313
-  data.tar.gz: 5b8e610cee66c82ca4543a2e7038854f822da21dbb6871ddd7fc46483ee3fd1187e31ec4d81f2bbefbaea829b3bcb6028708958e1bebef2119b2edcac4a6ddd2
+  metadata.gz: 3d4487a0f6b114af93c883946f6b5ac51973de38f8de2161e5d125e42e505c14dd6f06f6f1ff9a5c48cf5baaea86971ab626f60af374f7de5aa72ff4c239e9c6
+  data.tar.gz: acec505dcfe90e493a3b5b61b3a479ef507935d5ad7888988f338f64b603a3520ab42a21788ff4c8f441ee2256888b1e2554de46e7e8c9fb2bc04b7b6815197d

data/CHANGELOG.md

@@ -7,18 +7,11 @@ et ce projet adhère au [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
 
 ## [Unreleased]
 
-## [3.0.37] - 2026-01-17
+## [4.0.1] - 2026-01-20
 
-### Added
-- Version initiale du SDK ruby
-- Support complet de l'API FactPulse
-- Endpoints Factur-X (génération, validation)
-- Endpoints AFNOR PDP/PA (Flow Service, Directory Service)
-- Endpoints Chorus Pro (recherche entreprise, soumission factures)
-- Endpoints Signature électronique (PAdES-B-B, PAdES-B-T, PAdES-B-LT)
-- Support des deux modes d'authentification (stored credentials et zero-trust)
-- Documentation complète et exemples
+### Fixed
+- Gestion post multipart
 
 
-[Unreleased]: https://github.com/factpulse/sdk-ruby/compare/v3.0.37...HEAD
-[3.0.37]: https://github.com/factpulse/sdk-ruby/releases/tag/v3.0.37
+[Unreleased]: https://github.com/factpulse/sdk-ruby/compare/v4.0.1...HEAD
+[4.0.1]: https://github.com/factpulse/sdk-ruby/releases/tag/v4.0.1

data/Gemfile.lock

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

data/README.md

@@ -5,10 +5,10 @@ Official Ruby client for the FactPulse API - French electronic invoicing.
 ## Features
 
 - **Factur-X**: Generation and validation of electronic invoices (MINIMUM, BASIC, EN16931, EXTENDED profiles)
-- **Chorus Pro**: Integration with the French public sector invoicing platform
-- **AFNOR PDP/PA**: Submission of flows compliant with the XP Z12-013 standard
-- **Electronic signature**: PDF signature (PAdES-B-B, PAdES-B-T, PAdES-B-LT)
-- **Simplified client**: JWT authentication and integrated polling via `helpers`
+- **Chorus Pro**: Integration with the French public invoicing platform
+- **AFNOR PDP/PA**: Submission of flows compliant with XP Z12-013 standard
+- **Electronic signature**: PDF signing (PAdES-B-B, PAdES-B-T, PAdES-B-LT)
+- **Thin HTTP wrapper**: Generic `post` and `get` methods with automatic JWT auth and polling
 
 ## Installation
 
@@ -24,180 +24,178 @@ gem 'factpulse'
 
 ## Quick Start
 
-The `FactPulse::Helpers` module provides a simplified API with automatic authentication and polling:
-
 ```ruby
 require 'factpulse'
-
-include FactPulse::Helpers
+require 'base64'
 
 # Create the client
-client = FactPulseClient.new(
+client = FactPulse::Client.new(
   email: 'your_email@example.com',
-  password: 'your_password'
+  password: 'your_password',
+  client_uid: 'your-client-uuid'  # From dashboard: Configuration > Clients
 )
 
-# Build the invoice using simplified format (auto-calculates totals)
-invoice_data = {
-  'number' => 'INV-2025-001',
-  'supplier' => {
-    'name' => 'My Company SAS',
-    'siret' => '12345678901234',
-    'iban' => 'FR7630001007941234567890185'
-  },
-  'recipient' => {
-    'name' => 'Client SARL',
-    'siret' => '98765432109876'
+# Read your source PDF
+pdf_b64 = Base64.strict_encode64(File.binread('source_invoice.pdf'))
+
+# Generate Factur-X and submit to PDP in one call
+result = client.post('processing/invoices/submit-complete-async',
+  invoiceData: {
+    number: 'INV-2025-001',
+    supplier: {
+      siret: '12345678901234',
+      iban: 'FR7630001007941234567890185',
+      routing_address: '12345678901234'
+    },
+    recipient: {
+      siret: '98765432109876',
+      routing_address: '98765432109876'
+    },
+    lines: [
+      {
+        description: 'Consulting services',
+        quantity: 10,
+        unitPrice: 100.0,
+        vatRate: 20.0
+      }
+    ]
   },
-  'lines' => [
-    {
-      'description' => 'Consulting services',
-      'quantity' => 10,
-      'unitPrice' => 100.0,
-      'vatRate' => 20
-    }
-  ]
-}
-
-# Generate the Factur-X PDF
-pdf_bytes = client.generate_facturx(invoice_data, 'source_invoice.pdf')
-
-File.binwrite('invoice_facturx.pdf', pdf_bytes)
-```
-
-## Available Helpers (FactPulse::Helpers::AmountHelpers module)
-
-### amount(value)
-
-Converts a value to a formatted string for monetary amounts.
+  sourcePdf: pdf_b64,
+  profile: 'EN16931',
+  destination: { type: 'afnor' }
+)
 
-```ruby
-include FactPulse::Helpers
+# PDF is in result['content'] (auto-polled, auto-decoded)
+File.binwrite('facturx_invoice.pdf', result['content'])
 
-AmountHelpers.amount(1234.5)      # "1234.50"
-AmountHelpers.amount('1234.56')   # "1234.56"
-AmountHelpers.amount(nil)         # "0.00"
+puts "Flow ID: #{result['afnorResult']['flowId']}"
 ```
 
-### invoice_totals(excl_tax, vat, incl_tax, amount_due, ...)
+## API Methods
 
-Creates a complete invoice totals object.
+The SDK provides two generic methods that map directly to API endpoints:
 
 ```ruby
-totals = AmountHelpers.invoice_totals(
-  1000.00,                  # excl_tax
-  200.00,                   # vat
-  1200.00,                  # incl_tax
-  1200.00,                  # amount_due
-  discount_incl_tax: 50.00, # optional
-  discount_reason: 'Loyalty discount', # optional
-  prepayment: 100.00        # optional
-)
-```
+# POST /api/v1/{path}
+result = client.post('path/to/endpoint', key1: value1, key2: value2)
 
-### invoice_line(number, description, quantity, unit_price_excl_tax, line_total_excl_tax, ...)
+# GET /api/v1/{path}
+result = client.get('path/to/endpoint', param1: value1)
+```
 
-Creates an invoice line.
+### Common Endpoints
 
-```ruby
-line = AmountHelpers.invoice_line(
-  1,
-  'Consulting services',
-  5,
-  200.00,
-  1000.00,
-  vat_rate: '20.00',    # vatRateManual
-  vat_category: 'S',    # S, Z, E, AE, K
-  unit: 'LUMP_SUM',     # LUMP_SUM, PIECE, HOUR, DAY...
-  reference: 'REF-001'  # optional
-)
-```
+| Endpoint | Method | Description |
+|----------|--------|-------------|
+| `processing/invoices/submit-complete-async` | POST | Generate Factur-X + submit to PDP |
+| `processing/generate-invoice` | POST | Generate Factur-X XML or PDF |
+| `processing/validate-xml` | POST | Validate Factur-X XML |
+| `processing/validate-facturx-pdf` | POST | Validate Factur-X PDF |
+| `processing/sign-pdf` | POST | Sign PDF with certificate |
+| `afnor/flow/v1/flows` | POST | Submit flow to AFNOR PDP |
+| `afnor/incoming-flows/{flow_id}` | GET | Get incoming invoice |
+| `chorus-pro/factures/soumettre` | POST | Submit to Chorus Pro |
 
-### vat_line(rate_manual, base_amount_excl_tax, vat_amount, category)
+## Webhooks
 
-Creates a VAT breakdown line.
+Instead of polling, you can receive results via webhook by adding `callbackUrl`:
 
 ```ruby
-vat = AmountHelpers.vat_line(
-  '20.00',    # rate_manual
-  1000.00,    # base_amount_excl_tax
-  200.00,     # vat_amount
-  category: 'S'  # S, Z, E, AE, K
+result = client.post('processing/invoices/submit-complete-async',
+  invoiceData: invoice_data,
+  sourcePdf: pdf_b64,
+  destination: { type: 'afnor' },
+  callbackUrl: 'https://your-server.com/webhook/factpulse',
+  webhookMode: 'INLINE'  # or 'DOWNLOAD_URL'
 )
-```
 
-### postal_address(line1, postal_code, city, ...)
+task_id = result['taskId']
+# Result will be POSTed to your webhook URL
+```
 
-Creates a structured postal address.
+### Webhook Receiver Example (Sinatra)
 
 ```ruby
-address = AmountHelpers.postal_address(
-  '123 Republic Street',
-  '75001',
-  'Paris',
-  country: 'FR',        # default: 'FR'
-  line2: 'Building A'   # optional
-)
+require 'sinatra'
+require 'json'
+require 'openssl'
+
+WEBHOOK_SECRET = 'your-shared-secret'
+
+def verify_signature(payload, signature)
+  return false unless signature&.start_with?('sha256=')
+
+  expected = OpenSSL::HMAC.hexdigest('SHA256', WEBHOOK_SECRET, payload)
+  Rack::Utils.secure_compare(expected, signature[7..])
+end
+
+post '/webhook/factpulse' do
+  payload = request.body.read
+  signature = request.env['HTTP_X_WEBHOOK_SIGNATURE']
+
+  unless verify_signature(payload, signature)
+    halt 401, { error: 'Invalid signature' }.to_json
+  end
+
+  event = JSON.parse(payload)
+  event_type = event['event_type']
+  data = event['data']
+
+  case event_type
+  when 'submission.completed'
+    flow_id = data.dig('afnorResult', 'flowId')
+    puts "Invoice submitted: #{flow_id}"
+  when 'submission.failed'
+    puts "Submission failed: #{data['error']}"
+  end
+
+  content_type :json
+  { status: 'received' }.to_json
+end
 ```
 
-### supplier(name, siret, address_line1, postal_code, city, options)
-
-Creates a complete supplier with automatic calculation of SIREN and intra-community VAT.
+### Webhook Event Types
 
-```ruby
-s = AmountHelpers.supplier(
-  'My Company SAS',
-  '12345678901234',
-  '123 Example Street',
-  '75001',
-  'Paris',
-  iban: 'FR7630006000011234567890189'
-)
-# SIREN and intra-community VAT automatically calculated
-```
+| Event | Description |
+|-------|-------------|
+| `generation.completed` | Factur-X generated successfully |
+| `generation.failed` | Generation failed |
+| `validation.completed` | Validation passed |
+| `validation.failed` | Validation failed |
+| `signature.completed` | PDF signed |
+| `submission.completed` | Submitted to PDP/Chorus |
+| `submission.failed` | Submission failed |
 
-### recipient(name, siret, address_line1, postal_code, city, options)
+## Zero-Storage Mode
 
-Creates a recipient (customer) with automatic calculation of SIREN.
+Pass PDP credentials directly in the request (no server-side storage):
 
 ```ruby
-r = AmountHelpers.recipient(
-  'Client SARL',
-  '98765432109876',
-  '456 Test Avenue',
-  '69001',
-  'Lyon'
+result = client.post('processing/invoices/submit-complete-async',
+  invoiceData: invoice_data,
+  sourcePdf: pdf_b64,
+  destination: {
+    type: 'afnor',
+    flowServiceUrl: 'https://api.pdp.example.com/flow/v1',
+    tokenUrl: 'https://auth.pdp.example.com/oauth/token',
+    clientId: 'your_pdp_client_id',
+    clientSecret: 'your_pdp_client_secret'
+  }
 )
 ```
 
-## Zero-Trust Mode (Chorus Pro / AFNOR)
-
-To pass your own credentials without server-side storage:
+## Error Handling
 
 ```ruby
-include FactPulse::Helpers
-
-chorus_creds = ChorusProCredentials.new(
-  piste_client_id: 'your_client_id',
-  piste_client_secret: 'your_client_secret',
-  chorus_pro_login: 'your_login',
-  chorus_pro_password: 'your_password',
-  sandbox: true
-)
-
-afnor_creds = AFNORCredentials.new(
-  flow_service_url: 'https://api.pdp.fr/flow/v1',
-  token_url: 'https://auth.pdp.fr/oauth/token',
-  client_id: 'your_client_id',
-  client_secret: 'your_client_secret'
-)
+require 'factpulse'
 
-client = FactPulseClient.new(
-  email: 'your_email@example.com',
-  password: 'your_password',
-  chorus_credentials: chorus_creds,
-  afnor_credentials: afnor_creds
-)
+begin
+  result = client.post('processing/validate-xml', xmlContent: xml_string)
+rescue FactPulse::Error => e
+  puts "Error: #{e.message}"
+  puts "Status code: #{e.status_code}"
+  puts "Details: #{e.details}"
+end
 ```
 
 ## Resources

data/docs/AllowanceCharge.md

@@ -5,7 +5,7 @@
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **is_charge** | **Boolean** | True for charge, False for allowance (ChargeIndicator). |  |
-| **amount** | [**Amount1**](Amount1.md) |  |  |
+| **amount** | [**Amount2**](Amount2.md) |  |  |
 | **base_amount** | [**BaseAmount**](BaseAmount.md) |  | [optional] |
 | **percentage** | [**Percentage**](Percentage.md) |  | [optional] |
 | **reason** | **String** |  | [optional] |

data/docs/Amount2.md

@@ -0,0 +1,15 @@
+# FactPulse::Amount2
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+
+## Example
+
+```ruby
+require 'factpulse'
+
+instance = FactPulse::Amount2.new()
+```
+