Guide Python

Ce guide fournit des instructions détaillées pour utiliser le SDK Python de Koncile.

Installation

pip install koncile

Pour le développement, utilisez un environnement virtuel :

python -m venv venv
source venv/bin/activate  # Windows: .\venv\Scripts\activate
pip install koncile

Initialisation du client

from koncile_sdk.client import KoncileAPIClient

client = KoncileAPIClient(api_key="your_api_key")

Téléchargement de fichiers

upload_response = client.files.upload(
    folder_id="folder_id",
    template_id="template_id",
    file_paths=["./invoices/invoice1.pdf", "./invoices/invoice2.pdf"]
)

task_ids = upload_response['task_ids']

Récupération des résultats

from koncile_sdk.clients.tasks import TaskStatus
import time

for task_id in task_ids:
    response = client.tasks.fetch_tasks_results(task_id)

    if response["status"] == TaskStatus.DONE.value:
        print("Tâche terminée :", response)
    elif response["status"] == TaskStatus.FAILED.value:
        print("Tâche échouée")
    elif response["status"] == TaskStatus.DUPLICATE.value:
        print("Doublon détecté")

Polling pour les résultats

from koncile_sdk.clients.tasks import TaskStatus
import time

def wait_for_results(client, task_id, timeout=300):
    start_time = time.time()

    while time.time() - start_time < timeout:
        response = client.tasks.fetch_tasks_results(task_id)

        if response["status"] == TaskStatus.DONE.value:
            return response
        elif response["status"] == TaskStatus.FAILED.value:
            raise Exception(f"Tâche échouée : {response.get('status_message')}")

        time.sleep(2)

    raise TimeoutError("Délai de polling dépassé")

# Utilisation
result = wait_for_results(client, task_ids[0])
print(f"General Fields : {result['General_fields']}")
print(f"Line Fields : {result['Line_fields']}")

Pour plus d'exemples, consultez le dépôt GitHub du SDK.