Aller au contenu
Envoyer des données/Envoyer des dépenses suivies hors du produit

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èreValeur
AdressePOST /api/v1/spend/proposals
Par son nomPOST /api/v1/tools/propose_spend_lines, la réponse sous data
Nom de l'outilpropose_spend_lines
Droit demandéAjouter ou corriger une dépense, arrêter un mois (spend.declare)
Rôles qui ont ce droit par défautPropriétaire, CMO, Marketing Ops
Par MCPOui : l'envoi attend une personne.

Paramètres

Les paramètres sont dans le corps de la requête, en JSON.

ParamètreRequisType et limitesÀ quoi il sert
entityIdouitexte, non videL'entité. list_entities donne les identifiants.
trackerNameouitexte, 1 à 80 caractèresLe nom du suivi. Gardez le même d'un envoi à l'autre.
linesouiliste d'objets, 1 à 2 000 élémentsLes lignes du suivi.
lines[].periodouimois, AAAA-MMLe mois de la dépense. Un mois à venir est refusé : c'est un plan.
lines[].labelouitexte, 1 à 120 caractèresLe libellé de la ligne. Un mois et un libellé identifient une ligne du suivi.
lines[].channelnontexte, 120 caractères au plusLe canal : une clé du catalogue ou son nom. Une autre valeur est associée une fois à un canal, à l'écran.
lines[].supplierNamenontexte, 120 caractères au plusLe fournisseur. Facultatif.
lines[].amountCentsouinombre entierLe 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.json

Le 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.