Aller au contenu
Ce qui attend une personne

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.

  1. 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.
  2. L'envoi attend. La page d'accueil le compte dans « À traiter », pour la personne qui peut le valider.
  3. Une personne regarde. Elle voit l'aperçu que montrerait le fichier : ce qui est nouveau, ce qui change, ce qui manque.
  4. 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 envoyezAvecIl attendQui valide
Les deals, les contacts, les facturespropose_deals, propose_contacts, propose_invoicesSur la page DonnéesQui importe les fichiers
La dépense d'une régie, jour par jourpropose_ad_spendSur la page DonnéesQui importe les fichiers
Des dépenses suivies hors du produitpropose_spend_linesSur la page DonnéesQui saisit les dépenses
Des volumes suivis hors du CRMpropose_funnel_volumesSur la page DonnéesQui saisit les volumes
Le coût d'équipepropose_team_costsSur la page DonnéesLe CMO
Des contratspropose_contractsSur la page des contrats, en brouillonsQui crée les contrats
L'objectif de l'exercicepropose_objectivesSur l'écran ObjectifsQui 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, ou null pour 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.