Envoyer des dépenses suivies hors du produit
Dépose les dépenses que le CMO suit ailleurs (événements, salons, opérations terrain), hors taxes, pour une entité et un suivi nommé.
Rien n'est compté à l'envoi. Qui saisit les dépenses examine la proposition sur la page Données, comme un réimport de ce suivi : lignes nouvelles, modifiées, absentes. Il la valide ou la refuse.
Un envoi plus récent pour le même suivi remplace celui qui attend. Marketing Ops n'envoie que si le CMO lui a délégué la saisie des dépenses.
Appel
| Repère | Valeur |
|---|---|
| Adresse | POST /api/v1/spend/proposals |
| Par son nom | POST /api/v1/tools/propose_spend_lines, la réponse sous data |
| Nom de l'outil | propose_spend_lines |
| Droit demandé | Ajouter ou corriger une dépense, arrêter un mois (spend.declare) |
| Rôles qui ont ce droit par défaut | Propriétaire, CMO, Marketing Ops |
| Par MCP | Oui : l'envoi attend une personne. |
Paramètres
Les paramètres sont dans le corps de la requête, en JSON.
| Paramètre | Requis | Type et limites | À quoi il sert |
|---|---|---|---|
entityId | oui | texte, non vide | L'entité. list_entities donne les identifiants. |
trackerName | oui | texte, 1 à 80 caractères | Le nom du suivi. Gardez le même d'un envoi à l'autre. |
lines | oui | liste d'objets, 1 à 2 000 éléments | Les lignes du suivi. |
lines[].period | oui | mois, AAAA-MM | Le mois de la dépense. Un mois à venir est refusé : c'est un plan. |
lines[].label | oui | texte, 1 à 120 caractères | Le libellé de la ligne. Un mois et un libellé identifient une ligne du suivi. |
lines[].channel | non | texte, 120 caractères au plus | Le canal : une clé du catalogue ou son nom. Une autre valeur est associée une fois à un canal, à l'écran. |
lines[].supplierName | non | texte, 120 caractères au plus | Le fournisseur. Facultatif. |
lines[].amountCents | oui | nombre entier | Le montant hors taxes, en centimes. |
Exemple
curl -X POST "$MARVESTO_URL/api/v1/spend/proposals" \
-H "x-api-key: $MARVESTO_API_KEY" \
-H "content-type: application/json" \
-d @corps.jsonLe fichier corps.json :
{
"entityId": "ENTITY_ID",
"trackerName": "Événements 2026",
"lines": [
{
"period": "2026-10",
"label": "Salon B2B Paris",
"channel": "events",
"supplierName": "Expo Lutèce",
"amountCents": 1850000
}
]
}Réponse
proposalId, lineCount (les lignes reçues) et superseded (les propositions en attente remplacées).
{
"proposalId": "PROPOSAL_ID",
"lineCount": 1,
"superseded": 0
}Refus
Un refus répond { "message": "…" }, en français, avec son statut HTTP : voir Droits et erreurs.