API et clés d'API

L'API Softic.Invoice permet à un ERP ou à un logiciel de facturation de pousser lui-même ses factures, de demander leur traitement, de lire leur statut légal et de récupérer les documents. Elle est décrite en OpenAPI sur /services/swagger et dans le guide d'intégration.

Clés d'API

Facturation > Clés d'API (administrateurs) : une clé par système appelant. À la création, la clé complète s'affiche une seule fois : copiez-la, seule son empreinte est conservée. Une clé peut être limitée à la création de brouillons et à la lecture, ou autorisée à traiter (émettre, signer, déposer, annuler). Elle peut expirer, être désactivée ou supprimée ; sa dernière utilisation est visible.

Ce que fait l'API

• POST /api/v1/invoices : crée ou met à jour des brouillons au format JSON (le même que l'import), idempotent par référence externe, avec traitement immédiat optionnel.
• Lecture par identifiant, par référence externe, ou des changements depuis une date (sondage régulier par l'ERP).
• Actions : émettre, signer, déposer, traiter en un appel, interroger la plateforme, annuler.
• Documents légaux (XML signé, réponse de la plateforme, élément SAF-T) et facture imprimable dans la langue voulue.
• Référentiel de la société : régime, codes de taxes, clients, articles.

Les factures créées par l'API apparaissent dans l'écran Factures avec, dans leur journal, le nom de la clé qui a agi.