@factpulse/sdk 3.0.19 → 3.0.24

package/dist/models/facture-electronique-rest-api-schemas-ereporting-invoice-type-code.js

@@ -0,0 +1,26 @@
+"use strict";
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * FactPulse REST API
+ *  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/
+ *
+ * The version of the OpenAPI document: 1.0.0
+ * Contact: contact@factpulse.fr
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FactureElectroniqueRestApiSchemasEreportingInvoiceTypeCode = void 0;
+/**
+ * Invoice type codes (UNTDID 1001).
+ */
+exports.FactureElectroniqueRestApiSchemasEreportingInvoiceTypeCode = {
+    _380: '380',
+    _381: '381',
+    _384: '384',
+    _389: '389',
+    _386: '386'
+};

package/dist/models/index.d.ts

@@ -132,6 +132,7 @@ export * from './directory-line-include';
 export * from './doc-type';
 export * from './document-type-info';
 export * from './ereporting-flow-type';
+export * from './ereporting-validation-error';
 export * from './electronic-address';
 export * from './enriched-invoice-info';
 export * from './error-level';
@@ -139,8 +140,7 @@ export * from './error-source';
 export * from './extraction-info';
 export * from './factur-xinvoice';
 export * from './factur-xpdfinfo';
-export * from './facture-electronique-models-invoice-type-code';
-export * from './facture-electronique-rest-api-schemas-ereporting-validation-error';
+export * from './facture-electronique-rest-api-schemas-ereporting-invoice-type-code';
 export * from './facture-electronique-rest-api-schemas-processing-chorus-pro-credentials';
 export * from './field-status';
 export * from './file-info';
@@ -212,6 +212,7 @@ export * from './report-period';
 export * from './report-sender';
 export * from './rounding-amount';
 export * from './routing-code-include';
+export * from './schematron-validation-error';
 export * from './scheme-id';
 export * from './search-flow-request';
 export * from './search-flow-response';

package/dist/models/index.js

@@ -148,6 +148,7 @@ __exportStar(require("./directory-line-include"), exports);
 __exportStar(require("./doc-type"), exports);
 __exportStar(require("./document-type-info"), exports);
 __exportStar(require("./ereporting-flow-type"), exports);
+__exportStar(require("./ereporting-validation-error"), exports);
 __exportStar(require("./electronic-address"), exports);
 __exportStar(require("./enriched-invoice-info"), exports);
 __exportStar(require("./error-level"), exports);
@@ -155,8 +156,7 @@ __exportStar(require("./error-source"), exports);
 __exportStar(require("./extraction-info"), exports);
 __exportStar(require("./factur-xinvoice"), exports);
 __exportStar(require("./factur-xpdfinfo"), exports);
-__exportStar(require("./facture-electronique-models-invoice-type-code"), exports);
-__exportStar(require("./facture-electronique-rest-api-schemas-ereporting-validation-error"), exports);
+__exportStar(require("./facture-electronique-rest-api-schemas-ereporting-invoice-type-code"), exports);
 __exportStar(require("./facture-electronique-rest-api-schemas-processing-chorus-pro-credentials"), exports);
 __exportStar(require("./field-status"), exports);
 __exportStar(require("./file-info"), exports);
@@ -228,6 +228,7 @@ __exportStar(require("./report-period"), exports);
 __exportStar(require("./report-sender"), exports);
 __exportStar(require("./rounding-amount"), exports);
 __exportStar(require("./routing-code-include"), exports);
+__exportStar(require("./schematron-validation-error"), exports);
 __exportStar(require("./scheme-id"), exports);
 __exportStar(require("./search-flow-request"), exports);
 __exportStar(require("./search-flow-response"), exports);

package/dist/models/invoice-input.d.ts

@@ -11,7 +11,7 @@
  */
 import type { Buyercountry } from './buyercountry';
 import type { Currency } from './currency';
-import type { InvoiceTypeCode } from './invoice-type-code';
+import type { FactureElectroniqueRestApiSchemasEreportingInvoiceTypeCode } from './facture-electronique-rest-api-schemas-ereporting-invoice-type-code';
 import type { Sellercountry } from './sellercountry';
 import type { TaxBreakdownInput } from './tax-breakdown-input';
 import type { Taxamount1 } from './taxamount1';
@@ -31,7 +31,7 @@ export interface InvoiceInput {
     /**
      * Invoice type code
      */
-    'typeCode'?: InvoiceTypeCode;
+    'typeCode'?: FactureElectroniqueRestApiSchemasEreportingInvoiceTypeCode;
     'currency'?: Currency;
     'dueDate'?: string | null;
     /**

package/dist/models/invoice-type-code.d.ts

@@ -10,13 +10,72 @@
  * Do not edit the class manually.
  */
 /**
- * Invoice type codes (UNTDID 1001).
+ * Document type according to BR-FR-04 (UNTDID 1001 codes).  | Code | Name | Description | |------|------|-------------| | 380 | INVOICE | Commercial invoice | | 389 | SELF_BILLED_INVOICE | Self-billed invoice | | 393 | FACTORED_INVOICE | Factored invoice | | 501 | SELF_BILLED_FACTORED_INVOICE | Self-billed factored invoice | | 386 | PREPAYMENT_INVOICE | Prepayment invoice | | 500 | SELF_BILLED_PREPAYMENT_INVOICE | Self-billed prepayment invoice | | 384 | CORRECTIVE_INVOICE | Corrective invoice | | 471 | SELF_BILLED_CORRECTIVE_INVOICE | Self-billed corrective invoice | | 472 | FACTORED_CORRECTIVE_INVOICE | Factored corrective invoice | | 473 | SELF_BILLED_FACTORED_CORRECTIVE_INVOICE | Self-billed factored corrective invoice | | 381 | CREDIT_NOTE | Credit note | | 261 | SELF_BILLED_CREDIT_NOTE | Self-billed credit note | | 262 | GLOBAL_ALLOWANCE_CREDIT_NOTE | Credit note for global allowance | | 396 | FACTORED_CREDIT_NOTE | Factored credit note | | 502 | SELF_BILLED_FACTORED_CREDIT_NOTE | Self-billed factored credit note | | 503 | PREPAYMENT_CREDIT_NOTE | Credit note for prepayment invoice |
  */
 export declare const InvoiceTypeCode: {
-    readonly _380: "380";
-    readonly _381: "381";
-    readonly _384: "384";
-    readonly _389: "389";
-    readonly _386: "386";
+    /**
+    * Commercial Invoice
+    */
+    readonly INVOICE: "380";
+    /**
+    * Self-billed Invoice
+    */
+    readonly SELF_BILLED_INVOICE: "389";
+    /**
+    * Factored Invoice
+    */
+    readonly FACTORED_INVOICE: "393";
+    /**
+    * Self-billed Factored Invoice
+    */
+    readonly SELF_BILLED_FACTORED_INVOICE: "501";
+    /**
+    * Prepayment Invoice
+    */
+    readonly PREPAYMENT_INVOICE: "386";
+    /**
+    * Self-billed Prepayment Invoice
+    */
+    readonly SELF_BILLED_PREPAYMENT_INVOICE: "500";
+    /**
+    * Corrective Invoice
+    */
+    readonly CORRECTIVE_INVOICE: "384";
+    /**
+    * Self-billed Corrective Invoice
+    */
+    readonly SELF_BILLED_CORRECTIVE_INVOICE: "471";
+    /**
+    * Factored Corrective Invoice
+    */
+    readonly FACTORED_CORRECTIVE_INVOICE: "472";
+    /**
+    * Self-billed Factored Corrective Invoice
+    */
+    readonly SELF_BILLED_FACTORED_CORRECTIVE_INVOICE: "473";
+    /**
+    * Credit Note
+    */
+    readonly CREDIT_NOTE: "381";
+    /**
+    * Self-billed Credit Note
+    */
+    readonly SELF_BILLED_CREDIT_NOTE: "261";
+    /**
+    * Global Allowance Credit Note
+    */
+    readonly GLOBAL_ALLOWANCE_CREDIT_NOTE: "262";
+    /**
+    * Factored Credit Note
+    */
+    readonly FACTORED_CREDIT_NOTE: "396";
+    /**
+    * Self-billed Factored Credit Note
+    */
+    readonly SELF_BILLED_FACTORED_CREDIT_NOTE: "502";
+    /**
+    * Prepayment Credit Note
+    */
+    readonly PREPAYMENT_CREDIT_NOTE: "503";
 };
 export type InvoiceTypeCode = typeof InvoiceTypeCode[keyof typeof InvoiceTypeCode];

package/dist/models/invoice-type-code.js

@@ -15,12 +15,71 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.InvoiceTypeCode = void 0;
 /**
- * Invoice type codes (UNTDID 1001).
+ * Document type according to BR-FR-04 (UNTDID 1001 codes).  | Code | Name | Description | |------|------|-------------| | 380 | INVOICE | Commercial invoice | | 389 | SELF_BILLED_INVOICE | Self-billed invoice | | 393 | FACTORED_INVOICE | Factored invoice | | 501 | SELF_BILLED_FACTORED_INVOICE | Self-billed factored invoice | | 386 | PREPAYMENT_INVOICE | Prepayment invoice | | 500 | SELF_BILLED_PREPAYMENT_INVOICE | Self-billed prepayment invoice | | 384 | CORRECTIVE_INVOICE | Corrective invoice | | 471 | SELF_BILLED_CORRECTIVE_INVOICE | Self-billed corrective invoice | | 472 | FACTORED_CORRECTIVE_INVOICE | Factored corrective invoice | | 473 | SELF_BILLED_FACTORED_CORRECTIVE_INVOICE | Self-billed factored corrective invoice | | 381 | CREDIT_NOTE | Credit note | | 261 | SELF_BILLED_CREDIT_NOTE | Self-billed credit note | | 262 | GLOBAL_ALLOWANCE_CREDIT_NOTE | Credit note for global allowance | | 396 | FACTORED_CREDIT_NOTE | Factored credit note | | 502 | SELF_BILLED_FACTORED_CREDIT_NOTE | Self-billed factored credit note | | 503 | PREPAYMENT_CREDIT_NOTE | Credit note for prepayment invoice |
  */
 exports.InvoiceTypeCode = {
-    _380: '380',
-    _381: '381',
-    _384: '384',
-    _389: '389',
-    _386: '386'
+    /**
+    * Commercial Invoice
+    */
+    INVOICE: '380',
+    /**
+    * Self-billed Invoice
+    */
+    SELF_BILLED_INVOICE: '389',
+    /**
+    * Factored Invoice
+    */
+    FACTORED_INVOICE: '393',
+    /**
+    * Self-billed Factored Invoice
+    */
+    SELF_BILLED_FACTORED_INVOICE: '501',
+    /**
+    * Prepayment Invoice
+    */
+    PREPAYMENT_INVOICE: '386',
+    /**
+    * Self-billed Prepayment Invoice
+    */
+    SELF_BILLED_PREPAYMENT_INVOICE: '500',
+    /**
+    * Corrective Invoice
+    */
+    CORRECTIVE_INVOICE: '384',
+    /**
+    * Self-billed Corrective Invoice
+    */
+    SELF_BILLED_CORRECTIVE_INVOICE: '471',
+    /**
+    * Factored Corrective Invoice
+    */
+    FACTORED_CORRECTIVE_INVOICE: '472',
+    /**
+    * Self-billed Factored Corrective Invoice
+    */
+    SELF_BILLED_FACTORED_CORRECTIVE_INVOICE: '473',
+    /**
+    * Credit Note
+    */
+    CREDIT_NOTE: '381',
+    /**
+    * Self-billed Credit Note
+    */
+    SELF_BILLED_CREDIT_NOTE: '261',
+    /**
+    * Global Allowance Credit Note
+    */
+    GLOBAL_ALLOWANCE_CREDIT_NOTE: '262',
+    /**
+    * Factored Credit Note
+    */
+    FACTORED_CREDIT_NOTE: '396',
+    /**
+    * Self-billed Factored Credit Note
+    */
+    SELF_BILLED_FACTORED_CREDIT_NOTE: '502',
+    /**
+    * Prepayment Credit Note
+    */
+    PREPAYMENT_CREDIT_NOTE: '503'
 };

package/dist/models/schematron-validation-error.d.ts

@@ -0,0 +1,33 @@
+/**
+ * FactPulse REST API
+ *  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/
+ *
+ * The version of the OpenAPI document: 1.0.0
+ * Contact: contact@factpulse.fr
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ * Erreur de validation Schematron avec suggestion de correction.
+ */
+export interface SchematronValidationError {
+    /**
+     * Code de la regle (BR-XX, BR-FR-XX)
+     */
+    'rule': string;
+    'bt_code'?: string | null;
+    /**
+     * Gravite: error, warning
+     */
+    'severity': string;
+    /**
+     * Message d\'erreur
+     */
+    'message': string;
+    'suggested_value'?: string | null;
+    'suggested_field'?: string | null;
+    'explanation'?: string | null;
+    'confidence'?: number | null;
+}

package/dist/models/schematron-validation-error.js

@@ -0,0 +1,15 @@
+"use strict";
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * FactPulse REST API
+ *  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/
+ *
+ * The version of the OpenAPI document: 1.0.0
+ * Contact: contact@factpulse.fr
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/models/simplified-invoice-data.d.ts

@@ -9,7 +9,7 @@
  * https://openapi-generator.tech
  * Do not edit the class manually.
  */
-import type { FactureElectroniqueModelsInvoiceTypeCode } from './facture-electronique-models-invoice-type-code';
+import type { InvoiceTypeCode } from './invoice-type-code';
 import type { InvoicingFrameworkCode } from './invoicing-framework-code';
 import type { OperationNature } from './operation-nature';
 /**
@@ -49,7 +49,7 @@ export interface SimplifiedInvoiceData {
     /**
      * Document type (UNTDID 1001). Default: 380 (Invoice).
      */
-    'invoiceType'?: FactureElectroniqueModelsInvoiceTypeCode;
+    'invoiceType'?: InvoiceTypeCode;
     'precedingInvoiceReference'?: string | null;
     'operationNature'?: OperationNature | null;
     'invoicingFramework'?: InvoicingFrameworkCode | null;

package/dist/models/validate-ereporting-response.d.ts

@@ -9,7 +9,7 @@
  * https://openapi-generator.tech
  * Do not edit the class manually.
  */
-import type { FactureElectroniqueRestApiSchemasEreportingValidationError } from './facture-electronique-rest-api-schemas-ereporting-validation-error';
+import type { EReportingValidationError } from './ereporting-validation-error';
 /**
  * Response after validating e-reporting data.
  */
@@ -29,11 +29,11 @@ export interface ValidateEReportingResponse {
     /**
      * List of validation errors (if any)
      */
-    'errors'?: Array<FactureElectroniqueRestApiSchemasEreportingValidationError>;
+    'errors'?: Array<EReportingValidationError>;
     /**
      * List of validation warnings (if any)
      */
-    'warnings'?: Array<FactureElectroniqueRestApiSchemasEreportingValidationError>;
+    'warnings'?: Array<EReportingValidationError>;
     /**
      * Status message
      */

package/dist/models/validation-info.d.ts

@@ -9,7 +9,7 @@
  * https://openapi-generator.tech
  * Do not edit the class manually.
  */
-import type { ValidationError } from './validation-error';
+import type { SchematronValidationError } from './schematron-validation-error';
 /**
  * Informations sur la validation.
  */
@@ -34,5 +34,5 @@ export interface ValidationInfo {
      * XML embarque dans PDF
      */
     'xml_embedded'?: boolean;
-    'errors'?: Array<ValidationError>;
+    'errors'?: Array<SchematronValidationError>;
 }

package/dist/src/helpers/client.d.ts

@@ -147,9 +147,22 @@ export declare class FactPulseClient {
      * IMPORTANT: This method uses the AFNOR OAuth token, NOT the FactPulse JWT!
      */
     private makeAfnorRequest;
-    rechercherSiretAfnor(siret: string): Promise<Record<string, unknown>>;
-    rechercherSirenAfnor(siren: string): Promise<Record<string, unknown>>;
-    listerCodesRoutageAfnor(siren: string): Promise<unknown[]>;
+    /** Gets a facility by SIRET in the AFNOR directory. */
+    getSiretAfnor(siret: string): Promise<Record<string, unknown>>;
+    /** Gets a legal unit by SIREN in the AFNOR directory. */
+    getSirenAfnor(siren: string): Promise<Record<string, unknown>>;
+    /** Searches for legal units (SIREN) in the AFNOR directory. */
+    searchSirenAfnor(options?: {
+        filters?: Record<string, unknown>;
+        limit?: number;
+    }): Promise<Record<string, unknown>>;
+    /** Searches for routing codes in the AFNOR directory. */
+    searchRoutingCodesAfnor(options?: {
+        filters?: Record<string, unknown>;
+        limit?: number;
+    }): Promise<Record<string, unknown>>;
+    /** Gets a routing code by SIRET and routing identifier. */
+    getRoutingCodeAfnor(siret: string, routingIdentifier: string): Promise<Record<string, unknown>>;
     /**
      * Submits an invoice to a PDP via the AFNOR API.
      * Authentication uses the AFNOR OAuth token (obtained automatically),

package/dist/src/helpers/client.js

@@ -551,19 +551,36 @@ class FactPulseClient {
         });
     }
     // ==================== AFNOR Directory ====================
-    rechercherSiretAfnor(siret) {
+    /** Gets a facility by SIRET in the AFNOR directory. */
+    getSiretAfnor(siret) {
         return __awaiter(this, void 0, void 0, function* () {
-            return this.makeAfnorRequest('GET', `/directory/siret/${siret}`);
+            return this.makeAfnorRequest('GET', `/directory/v1/siret/code-insee:${siret}`);
         });
     }
-    rechercherSirenAfnor(siren) {
+    /** Gets a legal unit by SIREN in the AFNOR directory. */
+    getSirenAfnor(siren) {
         return __awaiter(this, void 0, void 0, function* () {
-            return this.makeAfnorRequest('GET', `/directory/siren/${siren}`);
+            return this.makeAfnorRequest('GET', `/directory/v1/siren/code-insee:${siren}`);
         });
     }
-    listerCodesRoutageAfnor(siren) {
+    /** Searches for legal units (SIREN) in the AFNOR directory. */
+    searchSirenAfnor() {
+        return __awaiter(this, arguments, void 0, function* (options = {}) {
+            const { filters = {}, limit = 25 } = options;
+            return this.makeAfnorRequest('POST', '/directory/v1/siren/search', { data: { filters, limit } });
+        });
+    }
+    /** Searches for routing codes in the AFNOR directory. */
+    searchRoutingCodesAfnor() {
+        return __awaiter(this, arguments, void 0, function* (options = {}) {
+            const { filters = {}, limit = 25 } = options;
+            return this.makeAfnorRequest('POST', '/directory/v1/routing-code/search', { data: { filters, limit } });
+        });
+    }
+    /** Gets a routing code by SIRET and routing identifier. */
+    getRoutingCodeAfnor(siret, routingIdentifier) {
         return __awaiter(this, void 0, void 0, function* () {
-            return this.makeAfnorRequest('GET', `/directory/siren/${siren}/routing-codes`);
+            return this.makeAfnorRequest('GET', `/directory/v1/routing-code/siret:${siret}/code:${routingIdentifier}`);
         });
     }
     // ==================== AFNOR Flow ====================

package/docs/{FactureElectroniqueRestApiSchemasEreportingValidationError.md → EReportingValidationError.md}

@@ -1,6 +1,6 @@
-# FactureElectroniqueRestApiSchemasEreportingValidationError
+# EReportingValidationError
 
-Validation error detail.
+Validation error detail for E-Reporting.
 
 ## Properties
 
@@ -13,9 +13,9 @@ Name | Type | Description | Notes
 ## Example
 
 ```typescript
-import { FactureElectroniqueRestApiSchemasEreportingValidationError } from '@factpulse/sdk';
+import { EReportingValidationError } from '@factpulse/sdk';
 
-const instance: FactureElectroniqueRestApiSchemasEreportingValidationError = {
+const instance: EReportingValidationError = {
     field,
     message,
     code,

package/docs/FactureElectroniqueRestApiSchemasEreportingInvoiceTypeCode.md

@@ -0,0 +1,17 @@
+# FactureElectroniqueRestApiSchemasEreportingInvoiceTypeCode
+
+Invoice type codes (UNTDID 1001).
+
+## Enum
+
+* `_380` (value: `'380'`)
+
+* `_381` (value: `'381'`)
+
+* `_384` (value: `'384'`)
+
+* `_389` (value: `'389'`)
+
+* `_386` (value: `'386'`)
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

package/docs/InvoiceInput.md

@@ -8,7 +8,7 @@ Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **invoiceId** | **string** | Invoice identifier | [default to undefined]
 **issueDate** | **string** | Invoice issue date | [default to undefined]
-**typeCode** | [**InvoiceTypeCode**](InvoiceTypeCode.md) | Invoice type code | [optional] [default to undefined]
+**typeCode** | [**FactureElectroniqueRestApiSchemasEreportingInvoiceTypeCode**](FactureElectroniqueRestApiSchemasEreportingInvoiceTypeCode.md) | Invoice type code | [optional] [default to undefined]
 **currency** | [**Currency**](Currency.md) |  | [optional] [default to undefined]
 **dueDate** | **string** |  | [optional] [default to undefined]
 **sellerSiren** | **string** | Seller SIREN/SIRET | [default to undefined]

package/docs/InvoiceTypeCode.md

@@ -1,17 +1,39 @@
 # InvoiceTypeCode
 
-Invoice type codes (UNTDID 1001).
+Document type according to BR-FR-04 (UNTDID 1001 codes).  | Code | Name | Description | |------|------|-------------| | 380 | INVOICE | Commercial invoice | | 389 | SELF_BILLED_INVOICE | Self-billed invoice | | 393 | FACTORED_INVOICE | Factored invoice | | 501 | SELF_BILLED_FACTORED_INVOICE | Self-billed factored invoice | | 386 | PREPAYMENT_INVOICE | Prepayment invoice | | 500 | SELF_BILLED_PREPAYMENT_INVOICE | Self-billed prepayment invoice | | 384 | CORRECTIVE_INVOICE | Corrective invoice | | 471 | SELF_BILLED_CORRECTIVE_INVOICE | Self-billed corrective invoice | | 472 | FACTORED_CORRECTIVE_INVOICE | Factored corrective invoice | | 473 | SELF_BILLED_FACTORED_CORRECTIVE_INVOICE | Self-billed factored corrective invoice | | 381 | CREDIT_NOTE | Credit note | | 261 | SELF_BILLED_CREDIT_NOTE | Self-billed credit note | | 262 | GLOBAL_ALLOWANCE_CREDIT_NOTE | Credit note for global allowance | | 396 | FACTORED_CREDIT_NOTE | Factored credit note | | 502 | SELF_BILLED_FACTORED_CREDIT_NOTE | Self-billed factored credit note | | 503 | PREPAYMENT_CREDIT_NOTE | Credit note for prepayment invoice |
 
 ## Enum
 
-* `_380` (value: `'380'`)
+* `INVOICE` (value: `'380'`)
 
-* `_381` (value: `'381'`)
+* `SELF_BILLED_INVOICE` (value: `'389'`)
 
-* `_384` (value: `'384'`)
+* `FACTORED_INVOICE` (value: `'393'`)
 
-* `_389` (value: `'389'`)
+* `SELF_BILLED_FACTORED_INVOICE` (value: `'501'`)
 
-* `_386` (value: `'386'`)
+* `PREPAYMENT_INVOICE` (value: `'386'`)
+
+* `SELF_BILLED_PREPAYMENT_INVOICE` (value: `'500'`)
+
+* `CORRECTIVE_INVOICE` (value: `'384'`)
+
+* `SELF_BILLED_CORRECTIVE_INVOICE` (value: `'471'`)
+
+* `FACTORED_CORRECTIVE_INVOICE` (value: `'472'`)
+
+* `SELF_BILLED_FACTORED_CORRECTIVE_INVOICE` (value: `'473'`)
+
+* `CREDIT_NOTE` (value: `'381'`)
+
+* `SELF_BILLED_CREDIT_NOTE` (value: `'261'`)
+
+* `GLOBAL_ALLOWANCE_CREDIT_NOTE` (value: `'262'`)
+
+* `FACTORED_CREDIT_NOTE` (value: `'396'`)
+
+* `SELF_BILLED_FACTORED_CREDIT_NOTE` (value: `'502'`)
+
+* `PREPAYMENT_CREDIT_NOTE` (value: `'503'`)
 
 [[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

package/docs/SchematronValidationError.md

@@ -0,0 +1,35 @@
+# SchematronValidationError
+
+Erreur de validation Schematron avec suggestion de correction.
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**rule** | **string** | Code de la regle (BR-XX, BR-FR-XX) | [default to undefined]
+**bt_code** | **string** |  | [optional] [default to undefined]
+**severity** | **string** | Gravite: error, warning | [default to undefined]
+**message** | **string** | Message d\'erreur | [default to undefined]
+**suggested_value** | **string** |  | [optional] [default to undefined]
+**suggested_field** | **string** |  | [optional] [default to undefined]
+**explanation** | **string** |  | [optional] [default to undefined]
+**confidence** | **number** |  | [optional] [default to undefined]
+
+## Example
+
+```typescript
+import { SchematronValidationError } from '@factpulse/sdk';
+
+const instance: SchematronValidationError = {
+    rule,
+    bt_code,
+    severity,
+    message,
+    suggested_value,
+    suggested_field,
+    explanation,
+    confidence,
+};
+```
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

package/docs/SimplifiedInvoiceData.md

@@ -15,7 +15,7 @@ Name | Type | Description | Notes
 **comment** | **string** |  | [optional] [default to undefined]
 **purchaseOrderReference** | **string** |  | [optional] [default to undefined]
 **contractReference** | **string** |  | [optional] [default to undefined]
-**invoiceType** | [**FactureElectroniqueModelsInvoiceTypeCode**](FactureElectroniqueModelsInvoiceTypeCode.md) | Document type (UNTDID 1001). Default: 380 (Invoice). | [optional] [default to undefined]
+**invoiceType** | [**InvoiceTypeCode**](InvoiceTypeCode.md) | Document type (UNTDID 1001). Default: 380 (Invoice). | [optional] [default to undefined]
 **precedingInvoiceReference** | **string** |  | [optional] [default to undefined]
 **operationNature** | [**OperationNature**](OperationNature.md) |  | [optional] [default to undefined]
 **invoicingFramework** | [**InvoicingFrameworkCode**](InvoicingFrameworkCode.md) |  | [optional] [default to undefined]

package/docs/ValidateEReportingResponse.md

@@ -9,8 +9,8 @@ Name | Type | Description | Notes
 **valid** | **boolean** | Whether the data is valid | [default to undefined]
 **reportId** | **string** | Report identifier | [default to undefined]
 **flowType** | **string** | Flux type | [default to undefined]
-**errors** | [**Array<FactureElectroniqueRestApiSchemasEreportingValidationError>**](FactureElectroniqueRestApiSchemasEreportingValidationError.md) | List of validation errors (if any) | [optional] [default to undefined]
-**warnings** | [**Array<FactureElectroniqueRestApiSchemasEreportingValidationError>**](FactureElectroniqueRestApiSchemasEreportingValidationError.md) | List of validation warnings (if any) | [optional] [default to undefined]
+**errors** | [**Array<EReportingValidationError>**](EReportingValidationError.md) | List of validation errors (if any) | [optional] [default to undefined]
+**warnings** | [**Array<EReportingValidationError>**](EReportingValidationError.md) | List of validation warnings (if any) | [optional] [default to undefined]
 **message** | **string** | Status message | [default to undefined]
 
 ## Example

package/docs/ValidationInfo.md

@@ -11,7 +11,7 @@ Name | Type | Description | Notes
 **schematron_rules_total** | **number** | Total regles | [default to undefined]
 **pdfa_compliant** | **boolean** | PDF/A-3 conforme | [optional] [default to true]
 **xml_embedded** | **boolean** | XML embarque dans PDF | [optional] [default to true]
-**errors** | [**Array<ValidationError>**](ValidationError.md) |  | [optional] [default to undefined]
+**errors** | [**Array<SchematronValidationError>**](SchematronValidationError.md) |  | [optional] [default to undefined]
 
 ## Example
 

package/models/{facture-electronique-rest-api-schemas-ereporting-validation-error.ts → ereporting-validation-error.ts}

@@ -15,9 +15,9 @@
 
 
 /**
- * Validation error detail.
+ * Validation error detail for E-Reporting.
  */
-export interface FactureElectroniqueRestApiSchemasEreportingValidationError {
+export interface EReportingValidationError {
     /**
      * Field path with error
      */