TTauracoDocumentation
FREN
Le site Tauracoapp.tauraco.io
Accueil › Portail développeurs › Documentation Tauraco Collateral
Menu du document← Accueil
Portail développeurs
  1. Démarrage rapide
  2. Authentification
  3. Référence API REST
  4. Guide des webhooks
  5. Guide des exports
  6. Guide d'intégration ERP
  7. Guide d'intégration bancaire
  8. Documentation Tauraco Collateral
  9. Documentation MCP
  10. Exemples de code
  11. Gestion des erreurs
  12. Environnements sandbox
  13. Versions et changelog
  14. FAQ
  15. Support développeurs
Développeurs

Documentation Tauraco Collateral

Tauraco Collateral suit les sûretés OHADA attachées aux financements : gages de stocks confiés à un tiers détenteur, nantissements, inscriptions au registre, mainlevées, alertes d'échéance. Le hub l'expose en lecture seule, avec un avertissement juridique systématique.

État au 2026-11-05 : jeu collateral_depots, lecture REST, événements collateral.*, outils MCP et vue banque développés et testés ; en production depuis le 2026-11-05, avec les modules correspondants (exports, API publique, webhooks v2, MCP, API banque).

Ce qui est exposé

SurfaceContenuScope
Lecture REST : GET /collateral/depots (liste paginée) et GET /collateral/depots/{depot_id}mêmes champs que le jeu collateral_depotscollateral:read, délégant ERP_OWNER seulement
Export, depuis l'application ou par POST /exports (côté entreprise)jeu collateral_depots : id, type_garantie, nature, pays, statut_metier, date_acte, date_peremption (facultative), created_at, updated_at, avertissement_juridiquecollateral:read (et exports:write pour demander l'export par l'API)
MCP (côté entreprise)tauraco_list_collateral, tauraco_get_collateral_statusmcp:read et collateral:read
API banque (côté établissement)sûretés au bénéfice de l'établissement : liste avec alertes résumées, fiche sans note privée, chronologie ; ni registre de l'actif ni fiche d'alerte en v1bank:collateral:read
Webhooks (côté établissement)collateral.registered, collateral.released (guarantee_id, partial, dates, legal_notice)collateral:read

Aucun montant, aucune valeur de stock, aucun taux n'est servi par ces surfaces.

Avertissement juridique

Chaque ligne porte un avertissement. Pour les dépôts confiés à un tiers détenteur, le texte actuel est : « Information de suivi : cette ligne constate la remise d'un stock gagé à un tiers détenteur. Elle ne vaut ni inscription au registre compétent, ni preuve de l'opposabilité ou du rang de la sûreté. »

Ce texte a été validé le 2026-11-05 (décision de Sega), avant l'ouverture de l'API banque. Ne l'utilisez pas comme une qualification juridique, et ne présentez jamais une donnée de Tauraco comme la preuve d'une sûreté opposable.

Ce qui n'est pas exposé

  • Aucune radiation, aucune mainlevée, aucune inscription par API ou par MCP : ces gestes sont réservés à un décideur humain, dans le portail, après les contrôles de bénéficiaire et d'habilitation.
  • Aucune note privée de dossier (dossier_prive).
  • Le scope guarantees:read (cautions de l'écosystème) est réservé : aucune ressource en v1.

Lire les dépôts

curl -sS -X POST "https://api.tauraco.io/public/v1/exports" \
  -H "Authorization: Bearer ${TAURACO_TOKEN}" -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"datasets":[{"dataset":"collateral_depots"}],"format":"json"}'

Le jeu se lit en REST (GET /collateral/depots, délégant ERP_OWNER seulement), par un export (ci-dessus, puis GET /exports/{job_id}/download), depuis Mes exports ou par les outils MCP. Chaque ligne porte avertissement_juridique.