@factpulse/sdk 2.0.11 → 2.0.49

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

@@ -0,0 +1,23 @@
+export declare class FactPulseError extends Error {
+    constructor(message: string);
+}
+export declare class FactPulseAuthError extends FactPulseError {
+    constructor(message?: string);
+}
+export declare class FactPulsePollingTimeout extends FactPulseError {
+    readonly taskId: string;
+    readonly timeout: number;
+    constructor(taskId: string, timeout: number);
+}
+export interface ValidationErrorDetail {
+    level?: string;
+    item?: string;
+    reason?: string;
+    source?: string;
+    code?: string;
+}
+export declare function formatValidationError(e: ValidationErrorDetail): string;
+export declare class FactPulseValidationError extends FactPulseError {
+    readonly errors: ValidationErrorDetail[];
+    constructor(message: string, errors?: ValidationErrorDetail[]);
+}

package/dist/src/helpers/exceptions.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FactPulseValidationError = exports.FactPulsePollingTimeout = exports.FactPulseAuthError = exports.FactPulseError = void 0;
+exports.formatValidationError = formatValidationError;
+class FactPulseError extends Error {
+    constructor(message) { super(message); this.name = 'FactPulseError'; Object.setPrototypeOf(this, FactPulseError.prototype); }
+}
+exports.FactPulseError = FactPulseError;
+class FactPulseAuthError extends FactPulseError {
+    constructor(message = "Erreur d'authentification") { super(message); this.name = 'FactPulseAuthError'; Object.setPrototypeOf(this, FactPulseAuthError.prototype); }
+}
+exports.FactPulseAuthError = FactPulseAuthError;
+class FactPulsePollingTimeout extends FactPulseError {
+    constructor(taskId, timeout) {
+        super(`Timeout (${timeout}ms) atteint pour la tâche ${taskId}`);
+        this.name = 'FactPulsePollingTimeout';
+        this.taskId = taskId;
+        this.timeout = timeout;
+        Object.setPrototypeOf(this, FactPulsePollingTimeout.prototype);
+    }
+}
+exports.FactPulsePollingTimeout = FactPulsePollingTimeout;
+function formatValidationError(e) {
+    return `[${e.item || 'unknown'}] ${e.reason || 'Unknown error'}`;
+}
+class FactPulseValidationError extends FactPulseError {
+    constructor(message, errors = []) {
+        const fullMessage = errors.length > 0 ? `${message}\n\nDétails:\n${errors.map(e => `  - ${formatValidationError(e)}`).join('\n')}` : message;
+        super(fullMessage);
+        this.name = 'FactPulseValidationError';
+        this.errors = errors;
+        Object.setPrototypeOf(this, FactPulseValidationError.prototype);
+    }
+}
+exports.FactPulseValidationError = FactPulseValidationError;

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

@@ -0,0 +1,3 @@
+export { FactPulseError, FactPulseAuthError, FactPulsePollingTimeout, FactPulseValidationError, ValidationErrorDetail, formatValidationError } from './exceptions';
+export { FactPulseClient, FactPulseClientConfig, ChorusProCredentials, AFNORCredentials } from './client';
+export { montant, montantTotal, ligneDePoste, ligneDeTva, adressePostale, adresseElectronique, fournisseur, destinataire } from './client';

package/dist/src/helpers/index.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.destinataire = exports.fournisseur = exports.adresseElectronique = exports.adressePostale = exports.ligneDeTva = exports.ligneDePoste = exports.montantTotal = exports.montant = exports.FactPulseClient = exports.formatValidationError = exports.FactPulseValidationError = exports.FactPulsePollingTimeout = exports.FactPulseAuthError = exports.FactPulseError = void 0;
+// Exceptions
+var exceptions_1 = require("./exceptions");
+Object.defineProperty(exports, "FactPulseError", { enumerable: true, get: function () { return exceptions_1.FactPulseError; } });
+Object.defineProperty(exports, "FactPulseAuthError", { enumerable: true, get: function () { return exceptions_1.FactPulseAuthError; } });
+Object.defineProperty(exports, "FactPulsePollingTimeout", { enumerable: true, get: function () { return exceptions_1.FactPulsePollingTimeout; } });
+Object.defineProperty(exports, "FactPulseValidationError", { enumerable: true, get: function () { return exceptions_1.FactPulseValidationError; } });
+Object.defineProperty(exports, "formatValidationError", { enumerable: true, get: function () { return exceptions_1.formatValidationError; } });
+// Client et configuration
+var client_1 = require("./client");
+Object.defineProperty(exports, "FactPulseClient", { enumerable: true, get: function () { return client_1.FactPulseClient; } });
+// Helpers pour les montants
+var client_2 = require("./client");
+Object.defineProperty(exports, "montant", { enumerable: true, get: function () { return client_2.montant; } });
+Object.defineProperty(exports, "montantTotal", { enumerable: true, get: function () { return client_2.montantTotal; } });
+Object.defineProperty(exports, "ligneDePoste", { enumerable: true, get: function () { return client_2.ligneDePoste; } });
+Object.defineProperty(exports, "ligneDeTva", { enumerable: true, get: function () { return client_2.ligneDeTva; } });
+Object.defineProperty(exports, "adressePostale", { enumerable: true, get: function () { return client_2.adressePostale; } });
+Object.defineProperty(exports, "adresseElectronique", { enumerable: true, get: function () { return client_2.adresseElectronique; } });
+Object.defineProperty(exports, "fournisseur", { enumerable: true, get: function () { return client_2.fournisseur; } });
+Object.defineProperty(exports, "destinataire", { enumerable: true, get: function () { return client_2.destinataire; } });

package/docs/AFNORPDPPAApi.md

@@ -4,8 +4,116 @@ All URIs are relative to *http://localhost*
 
 |Method | HTTP request | Description|
 |------------- | ------------- | -------------|
+|[**getAfnorCredentialsApiV1AfnorCredentialsGet**](#getafnorcredentialsapiv1afnorcredentialsget) | **GET** /api/v1/afnor/credentials | Récupérer les credentials AFNOR stockés|
+|[**getFluxEntrantApiV1AfnorFluxEntrantsFlowIdGet**](#getfluxentrantapiv1afnorfluxentrantsflowidget) | **GET** /api/v1/afnor/flux-entrants/{flow_id} | Récupérer et extraire une facture entrante|
 |[**oauthTokenProxyApiV1AfnorOauthTokenPost**](#oauthtokenproxyapiv1afnoroauthtokenpost) | **POST** /api/v1/afnor/oauth/token | Endpoint OAuth2 pour authentification AFNOR|
 
+# **getAfnorCredentialsApiV1AfnorCredentialsGet**
+> any getAfnorCredentialsApiV1AfnorCredentialsGet()
+
+Récupère les credentials AFNOR/PDP stockés pour le client_uid du JWT. Cet endpoint est utilisé par le SDK en mode \'stored\' pour récupérer les credentials avant de faire l\'OAuth AFNOR lui-même.
+
+### Example
+
+```typescript
+import {
+    AFNORPDPPAApi,
+    Configuration
+} from '@factpulse/sdk';
+
+const configuration = new Configuration();
+const apiInstance = new AFNORPDPPAApi(configuration);
+
+const { status, data } = await apiInstance.getAfnorCredentialsApiV1AfnorCredentialsGet();
+```
+
+### Parameters
+This endpoint does not have any parameters.
+
+
+### Return type
+
+**any**
+
+### Authorization
+
+[HTTPBearer](../README.md#HTTPBearer)
+
+### HTTP request headers
+
+ - **Content-Type**: Not defined
+ - **Accept**: application/json
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+|**200** | Credentials AFNOR récupérés avec succès |  -  |
+|**400** | Aucun client_uid dans le JWT |  -  |
+|**401** | Non authentifié - Token JWT manquant ou invalide |  -  |
+|**404** | Client non trouvé ou pas de credentials AFNOR configurés |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
+
+# **getFluxEntrantApiV1AfnorFluxEntrantsFlowIdGet**
+> FactureEntrante getFluxEntrantApiV1AfnorFluxEntrantsFlowIdGet()
+
+Télécharge un flux entrant depuis la PDP AFNOR et extrait les métadonnées de la facture vers un format JSON unifié. Supporte les formats Factur-X, CII et UBL.
+
+### Example
+
+```typescript
+import {
+    AFNORPDPPAApi,
+    Configuration
+} from '@factpulse/sdk';
+
+const configuration = new Configuration();
+const apiInstance = new AFNORPDPPAApi(configuration);
+
+let flowId: string; // (default to undefined)
+let includeDocument: boolean; // (optional) (default to false)
+
+const { status, data } = await apiInstance.getFluxEntrantApiV1AfnorFluxEntrantsFlowIdGet(
+    flowId,
+    includeDocument
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **flowId** | [**string**] |  | defaults to undefined|
+| **includeDocument** | [**boolean**] |  | (optional) defaults to false|
+
+
+### Return type
+
+**FactureEntrante**
+
+### Authorization
+
+[HTTPBearer](../README.md#HTTPBearer)
+
+### HTTP request headers
+
+ - **Content-Type**: Not defined
+ - **Accept**: application/json
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+|**200** | Facture extraite avec succès |  -  |
+|**400** | Format de facture non supporté ou invalide |  -  |
+|**401** | Non authentifié |  -  |
+|**404** | Flux non trouvé |  -  |
+|**503** | Service PDP indisponible |  -  |
+|**422** | Validation Error |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
+
 # **oauthTokenProxyApiV1AfnorOauthTokenPost**
 > any oauthTokenProxyApiV1AfnorOauthTokenPost()
 

package/docs/APIError.md

@@ -0,0 +1,25 @@
+# APIError
+
+Erreur API standardisée (alignée sur AFNOR Error schema).  Format unifié pour toutes les réponses d\'erreur HTTP.
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**errorCode** | **string** | Code alphanumérique identifiant précisément l\'erreur | [default to undefined]
+**errorMessage** | **string** | Message décrivant l\'erreur (non destiné à l\'utilisateur final) | [default to undefined]
+**details** | [**Array<ValidationErrorDetail>**](ValidationErrorDetail.md) |  | [optional] [default to undefined]
+
+## Example
+
+```typescript
+import { APIError } from '@factpulse/sdk';
+
+const instance: APIError = {
+    errorCode,
+    errorMessage,
+    details,
+};
+```
+
+[[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/Beneficiaire.md

@@ -0,0 +1,31 @@
+# Beneficiaire
+
+Informations sur le bénéficiaire du paiement (BG-10 / PayeeTradeParty).  Le bénéficiaire est la partie qui reçoit le paiement. Ce bloc est utilisé uniquement si le bénéficiaire est différent du vendeur (fournisseur).  **Cas d\'usage principal** : Affacturage (factoring) Quand une facture est affacturée, le factor (société d\'affacturage) devient le bénéficiaire du paiement à la place du fournisseur.  **Business Terms (EN16931)** : - BT-59 : Nom du bénéficiaire (obligatoire) - BT-60 : Identifiant du bénéficiaire (SIRET avec schemeID 0009) - BT-61 : Identifiant légal du bénéficiaire (SIREN avec schemeID 0002)  **Référence** : docs/guide_affacturage.md
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**nom** | **string** | Nom du bénéficiaire (BT-59). Obligatoire. | [default to undefined]
+**siret** | **string** |  | [optional] [default to undefined]
+**siren** | **string** |  | [optional] [default to undefined]
+**adresseElectronique** | [**AdresseElectronique**](AdresseElectronique.md) |  | [optional] [default to undefined]
+**iban** | **string** |  | [optional] [default to undefined]
+**bic** | **string** |  | [optional] [default to undefined]
+
+## Example
+
+```typescript
+import { Beneficiaire } from '@factpulse/sdk';
+
+const instance: Beneficiaire = {
+    nom,
+    siret,
+    siren,
+    adresseElectronique,
+    iban,
+    bic,
+};
+```
+
+[[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/BoundingBoxSchema.md

@@ -0,0 +1,33 @@
+# BoundingBoxSchema
+
+Coordonnées d\'une zone rectangulaire dans le PDF.  Les coordonnées sont en points PDF (1 point = 1/72 pouce). L\'origine (0,0) est en bas à gauche de la page.
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**x0** | **number** | Coordonnée X gauche | [default to undefined]
+**y0** | **number** | Coordonnée Y bas | [default to undefined]
+**x1** | **number** | Coordonnée X droite | [default to undefined]
+**y1** | **number** | Coordonnée Y haut | [default to undefined]
+**page** | **number** | Numéro de page (0-indexed) | [optional] [default to 0]
+**width** | **number** | Largeur de la zone | [default to undefined]
+**height** | **number** | Hauteur de la zone | [default to undefined]
+
+## Example
+
+```typescript
+import { BoundingBoxSchema } from '@factpulse/sdk';
+
+const instance: BoundingBoxSchema = {
+    x0,
+    y0,
+    x1,
+    y1,
+    page,
+    width,
+    height,
+};
+```
+
+[[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/CadreDeFacturation.md

@@ -1,12 +1,13 @@
 # CadreDeFacturation
 
-Définit le cadre de facturation (ex: A1 pour une facture fournisseur).
+Définit le cadre de facturation.  - code_cadre_facturation: Code Chorus Pro (A1, A2, A9, A12) - utilisé pour B2G - nature_operation: Nature de l\'opération (B1, S1, M1, etc.) - prioritaire pour Factur-X  Si nature_operation est fourni, il sera utilisé directement dans le XML Factur-X (BT-23). Sinon, le code sera déduit de code_cadre_facturation via un mapping automatique.  Exemple:     >>> cadre = CadreDeFacturation(     ...     code_cadre_facturation=CodeCadreFacturation.A1_FACTURE_FOURNISSEUR,     ...     nature_operation=NatureOperation.BIENS  # Force B1 au lieu de S1     ... )
 
 ## Properties
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **codeCadreFacturation** | [**CodeCadreFacturation**](CodeCadreFacturation.md) |  | [default to undefined]
+**natureOperation** | [**NatureOperation**](NatureOperation.md) |  | [optional] [default to undefined]
 **codeServiceValideur** | **string** |  | [optional] [default to undefined]
 **codeStructureValideur** | **string** |  | [optional] [default to undefined]
 
@@ -17,6 +18,7 @@ import { CadreDeFacturation } from '@factpulse/sdk';
 
 const instance: CadreDeFacturation = {
     codeCadreFacturation,
+    natureOperation,
     codeServiceValideur,
     codeStructureValideur,
 };

package/docs/ChampVerifieSchema.md

@@ -0,0 +1,37 @@
+# ChampVerifieSchema
+
+Un champ vérifié avec toutes ses informations (extraction + conformité + localisation).
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**business_term** | **string** | Business Term EN16931 (ex: BT-1) | [default to undefined]
+**label** | **string** | Libellé du champ (ex: N° Facture) | [default to undefined]
+**valeur_pdf** | **string** |  | [optional] [default to undefined]
+**valeur_xml** | **string** |  | [optional] [default to undefined]
+**statut** | [**StatutChampAPI**](StatutChampAPI.md) | Statut de conformité | [default to undefined]
+**message** | **string** |  | [optional] [default to undefined]
+**confiance** | **number** | Score de confiance (0-1) | [optional] [default to 1.0]
+**source** | **string** | Source d\'extraction | [optional] [default to 'pdf_natif']
+**bbox** | [**BoundingBoxSchema**](BoundingBoxSchema.md) |  | [optional] [default to undefined]
+
+## Example
+
+```typescript
+import { ChampVerifieSchema } from '@factpulse/sdk';
+
+const instance: ChampVerifieSchema = {
+    business_term,
+    label,
+    valeur_pdf,
+    valeur_xml,
+    statut,
+    message,
+    confiance,
+    source,
+    bbox,
+};
+```
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)