Ce qui attend une personne
Tout ce que l'API reçoit attend une validation à l'écran : où, et par qui.
Le principe
Ce qui arrive par l'API ne compte dans aucun chiffre tant qu'une personne ne l'a pas validé. L'envoi répond tout de suite ; la validation se fait dans le produit.
- Vous envoyez. L'API vérifie l'envoi comme l'écran vérifie une saisie ou un fichier. Ce qu'elle refuse revient tout de suite, avec la raison.
- L'envoi attend. La page d'accueil le compte dans « À traiter », pour la personne qui peut le valider.
- Une personne regarde. Elle voit l'aperçu que montrerait le fichier : ce qui est nouveau, ce qui change, ce qui manque.
- Elle valide ou refuse. Validé, l'envoi est écrit par le même chemin qu'un fichier, à son nom, avec l'origine « API ». Refusé, il est gardé avec son motif. Rien n'est supprimé.
Où chaque envoi attend
| Vous envoyez | Avec | Il attend | Qui valide |
|---|---|---|---|
| Les deals, les contacts, les factures | propose_deals, propose_contacts, propose_invoices | Sur la page Données | Qui importe les fichiers |
| La dépense d'une régie, jour par jour | propose_ad_spend | Sur la page Données | Qui importe les fichiers |
| Des dépenses suivies hors du produit | propose_spend_lines | Sur la page Données | Qui saisit les dépenses |
| Des volumes suivis hors du CRM | propose_funnel_volumes | Sur la page Données | Qui saisit les volumes |
| Le coût d'équipe | propose_team_costs | Sur la page Données | Le CMO |
| Des contrats | propose_contracts | Sur la page des contrats, en brouillons | Qui crée les contrats |
| L'objectif de l'exercice | propose_objectives | Sur l'écran Objectifs | Qui fixe les objectifs |
Deux appels écrivent sans attendre, parce qu'ils ne changent aucun chiffre : create_entity crée une entité, import_budget_lines écrit dans le brouillon d'un budget, qui se publie à l'écran.
Envoyer un export sous forme de tableau
Les deals, les contacts, les factures et la dépense des régies s'envoient comme le tableau de leur export. Le même lecteur lit le fichier et le tableau : mêmes colonnes, mêmes refus.
{
"name": "Deals du CRM",
"columns": ["Deal ID", "Deal Stage", "Create Date", "Amount"],
"rows": [
["9001", "Fermé gagné", "2026-08-04", 24000],
["9002", "Présentation planifiée", "2026-10-02", null]
]
}columns: l'en-tête, avec les noms que l'export donne à ses colonnes, en français ou en anglais.rows: une liste de cellules par ligne, dans l'ordre des colonnes. Un texte, un nombre, ounullpour une cellule vide.name: le nom de la proposition. Un envoi plus récent sous le même nom remplace celui qui attend.
Les montants d'un tableau sont en euros, comme dans le fichier. Partout ailleurs dans l'API, ils sont en centimes.
Ce que le lecteur refuse revient à l'envoi, ligne par ligne :
{ "message": "Ligne 2 : Date de création illisible : « pas une date »" }Ce qui ne passe pas par l'API
- Un relevé de carte, un export Spendesk : ils restent des fichiers.
- Le FEC : il s'importe à l'écran.
- Arrêter un mois, corriger une dépense, publier un budget, confirmer un contrat : ce sont des décisions, prises à l'écran.