3 endpoints · https://votre-cabinet.fiduciapro.ma/api/v1
Documentation de l'API FiduciaPro
L'API FiduciaPro est une API REST JSON servie en HTTPS. Chaque requête est authentifiée par clé API et strictement limitée aux données de votre cabinet. La v1 est en lecture seule — idéale pour le reporting, la BI et les synchronisations sortantes.
Démarrage
L'URL de base est celle de votre espace cabinet :
https://votre-cabinet.fiduciapro.ma/api/v1
L'accès API est inclus dans tous les plans. Les clés se créent depuis Paramètres → API & intégrations (rôle administrateur requis, maximum 10 clés actives par cabinet). Usage soumis à une politique de fair-use ; des quotas par clé seront publiés avec la v2.
Authentification
Envoyez votre clé en jeton Bearer dans l'en-tête Authorization :
curl https://votre-cabinet.fiduciapro.ma/api/v1/clients \ -H "Authorization: Bearer fp_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
fp_live_…— clé de production (40 caractères hexadécimaux après le préfixe). Le secret n'est affiché qu'une seule fois à la création.- Les clés sont stockées hachées (SHA-256)côté serveur et révocables à tout moment — la révocation coupe l'accès immédiatement.
- Chaque appel authentifié met à jour la date de dernier usage, visible dans le tableau de bord.
Un 401 signifie que la clé est absente, invalide ou révoquée :
{ "error": "Clé API manquante ou invalide (Authorization: Bearer fp_live_…)" }Pagination
/api/v1/ecritures accepte page (défaut 1) et page_size (défaut 100, max 500) et renvoie la page courante dans la réponse :
{
"data": [ ... ],
"page": 1,
"page_size": 100
}Erreurs
Toutes les erreurs partagent la même forme — { "error": "message lisible" } :
| 400 | Bad Request | Paramètre manquant ou invalide (ex. client_id requis). |
| 401 | Unauthorized | Clé API absente, invalide ou révoquée. |
| 404 | Not Found | Ressource inexistante ou hors de votre cabinet — l'API ne distingue pas les deux. |
| 429 | Too Many Requests | Fair-use dépassé (réessayez plus tard). |
| 500 | Internal Error | Erreur serveur — réessayez, puis contactez le support. |
Clients (dossiers)
/api/v1/clientsLister les dossiers clients
Renvoie tous les dossiers du cabinet, triés par raison sociale. Identifiants marocains inclus (IF, ICE, RC).
| id | uuid | Identifiant du dossier — à passer aux autres endpoints. |
| raison_sociale | string | Dénomination du client. |
| identifiant_fiscal | string | null | IF (identifiant fiscal DGI). |
| ice | string | null | ICE à 15 chiffres. |
| rc | string | null | Registre de commerce. |
| forme_juridique | enum | SARL, SA, SAS, AUTO_ENTREPRENEUR… |
| regime_tva | enum | ENCAISSEMENT | DEBIT | EXONERE. |
| periodicite_tva | enum | MENSUELLE | TRIMESTRIELLE. |
| secteur_activite | enum | COMMERCE, INDUSTRIE, SERVICES, BTP… |
| statut | enum | ACTIF | INACTIF | ARCHIVE. |
curl https://votre-cabinet.fiduciapro.ma/api/v1/clients \
-H "Authorization: Bearer fp_live_***"
# 200
{ "data": [ { "id": "3f6c…", "raison_sociale": "ERRADI BLOCS",
"ice": "002966235000093", "regime_tva": "ENCAISSEMENT", … } ] }Écritures comptables
/api/v1/ecrituresLister les écritures d'un dossier
Écritures au format plat, les plus récentes d'abord. Contrat des montants : montant = base HT, montant_tva = TVA de la pièce (null si aucune), montant_ttc = total TTC.
| client_id | uuid · requis | Le dossier (voir /api/v1/clients). |
| statut | string | VALIDE | BROUILLON — omis = toutes. |
| page | integer · défaut 1 | Numéro de page. |
| page_size | integer · défaut 100 (max 500) | Taille de page. |
| numero_piece | string | Numéro normalisé, ex. AC-2026-0001 (préfixe = journal CGNC). |
| journal | enum | ACHATS, VENTES, BANQUE, CAISSE, OPERATIONS_DIVERSES, A_NOUVEAU. |
| date | date | Date de la pièce (YYYY-MM-DD). |
| compte_debit / compte_credit | string | Codes CGNC 4-5 chiffres de l'opération principale. |
| montant | number | Base HT. |
| taux_tva | number | null | Taux de TVA en % (null = sans TVA). |
| montant_tva | number | null | TVA portée par la pièce. |
| montant_ttc | number | Total TTC. |
| statut | enum | BROUILLON | VALIDE. |
curl "https://votre-cabinet.fiduciapro.ma/api/v1/ecritures?client_id=3f6c…&statut=VALIDE" \
-H "Authorization: Bearer fp_live_***"
# 200
{ "data": [ { "numero_piece": "AC-2026-0042", "journal": "ACHATS",
"date": "2026-06-15", "compte_debit": "6111", "compte_credit": "4411",
"montant": 1000, "taux_tva": 20, "montant_tva": 200,
"montant_ttc": 1200, "statut": "VALIDE" } ],
"page": 1, "page_size": 100 }Documents
/api/v1/documentsLister les documents
Métadonnées des documents du cabinet (500 max, les plus récents d'abord). Les fichiers restent privés — aucune URL de stockage n'est exposée par l'API.
| client_id | uuid · optionnel | Filtre par dossier. |
| nom | string | Nom de fichier normalisé (ex. FA_FOURNISSEUR_2026-06-15.pdf). |
| type | enum | FACTURE_ACHAT, FACTURE_VENTE, RELEVE_BANCAIRE, AUTRE… |
| categorie | enum | Catégorie de classement GED. |
| workflow_statut | enum | CLASSE | COMPTABILISE | … |
curl "https://votre-cabinet.fiduciapro.ma/api/v1/documents?client_id=3f6c…" \ -H "Authorization: Bearer fp_live_***"
Feuille de route de l'API
Prochaines étapes (v2) : écriture (création de pièces et de clients), endpoints e-facture (création, finalisation, PDF/XML UBL), webhooks signés (ecriture.validee, document.scanne…), permissions par clé (scopes) et quotas de débit documentés. Un besoin prioritaire ? Parlez-nous de votre intégration.