factpulse 2.0.13

API REST FactPulse

FactPulse SDK Python

Client Python officiel pour l'API FactPulse - Facturation électronique française.

🎯 Fonctionnalités

• Factur-X : Génération et validation de factures électroniques (profils MINIMUM, BASIC, EN16931, EXTENDED)
• Chorus Pro : Intégration avec la plateforme de facturation publique française
• AFNOR PDP/PA : Soumission de flux conformes à la norme XP Z12-013
• Signature électronique : Signature PDF (PAdES-B-B, PAdES-B-T, PAdES-B-LT)
• Traitement asynchrone : Support Celery pour opérations longues

🚀 Installation

pip install factpulse

📖 Démarrage rapide

1. Authentification

from factpulse import ApiClient, Configuration

# Configuration du client
config = Configuration(host='https://factpulse.fr/api/facturation/')
config.access_token = 'votre_token_jwt'

client = ApiClient(configuration=config)

2. Générer une facture Factur-X

from factpulse.api.traitement_facture_api import TraitementFactureApi
import json

api = TraitementFactureApi(client)

# Données de la facture
# IMPORTANT: Les montants sont des strings pour préserver la précision monétaire
facture_data = {
    "numero_facture": "FAC-2025-001",
    "date_facture": "2025-01-15",
    "montant_total_ht": "1000.00",  # String, pas float !
    "montant_total_ttc": "1200.00",  # String, pas float !
    "fournisseur": {
        "nom": "Mon Entreprise SAS",
        "siret": "12345678901234",
        "adresse_postale": {
            "ligne_un": "123 Rue Example",
            "code_postal": "75001",
            "nom_ville": "Paris",
            "pays_code_iso": "FR"
        }
    },
    "destinataire": {
        "nom": "Client SARL",
        "siret": "98765432109876",
        "adresse_postale": {
            "ligne_un": "456 Avenue Test",
            "code_postal": "69001",
            "nom_ville": "Lyon",
            "pays_code_iso": "FR"
        }
    },
    "lignes_de_poste": [{
        "numero": 1,
        "denomination": "Prestation de conseil",
        "quantite": "10.00",
        "montant_unitaire_ht": "100.00",
        "montant_ligne_ht": "1000.00"
    }]
}

# Générer le PDF Factur-X (multipart/form-data)
pdf_bytes = api.generer_facture_api_v1_traitement_generer_facture_post(
    donnees_facture=json.dumps(facture_data),
    profil='EN16931',
    format_sortie='pdf'
)

# Sauvegarder
with open('facture.pdf', 'wb') as f:
    f.write(pdf_bytes)

3. Soumettre une facture complète (Chorus Pro / AFNOR PDP)

from factpulse.api.traitement_facture_api import TraitementFactureApi

api = TraitementFactureApi(client)

# Soumettre une facture avec destination Chorus Pro
response = api.soumettre_facture_complete_api_v1_traitement_factures_soumettre_complete_post(
    body={
        "facture": facture_data,
        "destination": {
            "type": "chorus_pro",
            "credentials": {
                "login": "votre_login_chorus",
                "password": "votre_password_chorus"
            }
        }
    }
)

print(f"Facture soumise : {response.id_facture_chorus}")

🔑 Obtention du token JWT

Via l'API

import requests

response = requests.post(
    'https://factpulse.fr/api/token/',
    json={
        'username': '[e-mail]',
        'password': 'votre_mot_de_passe'
    }
)

token = response.json()['access']

Accès aux credentials d'un client spécifique :

Si vous gérez plusieurs clients et souhaitez accéder aux credentials (Chorus Pro, AFNOR PDP) d'un client particulier, ajoutez le champ client_uid :

response = requests.post(
    'https://factpulse.fr/api/token/',
    json={
        'username': '[e-mail]',
        'password': 'votre_mot_de_passe',
        'client_uid': 'identifiant_client'  # UID du client cible
    }
)

token = response.json()['access']

Via le Dashboard

1. Connectez-vous sur https://factpulse.fr/api/dashboard/
2. Générez un token API
3. Copiez et utilisez le token dans votre configuration

📚 Ressources

• Documentation API : https://factpulse.fr/api/facturation/documentation
• Code source : https://github.com/factpulse/sdk-python
• Issues : https://github.com/factpulse/sdk-python/issues
• Support : [e-mail]

📄 Licence

MIT License - Copyright (c) 2025 FactPulse