Écrire des lignes dans le brouillon d'un budget
Écrit des lignes dans le brouillon d'un budget, comme le ferait l'import d'un fichier.
Une ligne envoyée avec sa lineKey met à jour cette ligne. Sans lineKey, elle est créée. Donnez douze montants mensuels ou un montant annuel, en centimes. Tout l'envoi est écrit, ou rien.
Aucun chiffre ne bouge : le brouillon se publie à l'écran, par qui modifie le budget. Un budget déjà publié n'a pas de brouillon : démarrez une révision à l'écran avant d'envoyer. Par MCP, cet appel est refusé.
Appel
| Repère | Valeur |
|---|---|
| Adresse | POST /api/v1/budgets/:budgetId/lines |
| Par son nom | POST /api/v1/tools/import_budget_lines, la réponse sous data |
| Nom de l'outil | import_budget_lines |
| Droit demandé | Modifier le budget, les scénarios et le budget N+1 (budget.edit) |
| Rôles qui ont ce droit par défaut | Propriétaire, CMO, Marketing Ops |
| Par MCP | Non : cet appel écrit des données. Une application connectée par MCP propose, une personne valide. |
Paramètres
budgetId est dans l'adresse. Les autres sont dans le corps de la requête, en JSON.
| Paramètre | Requis | Type et limites | À quoi il sert |
|---|---|---|---|
budgetId | oui | texte, non vide | Le budget. list_budgets donne les identifiants. |
lines | oui | liste d'objets, 1 à 500 éléments | Les lignes à écrire. |
lines[].lineKey | non | texte | La clé d'une ligne du brouillon, pour la mettre à jour. |
lines[].kind | oui | valeur au choix, line, reserve | line pour une ligne de budget, reserve pour la réserve. |
lines[].channelKey | non | texte | Le canal de la ligne : une clé du catalogue (paid_media, events, content…). |
lines[].programName | non | texte | Le programme de la ligne. |
lines[].label | oui | texte, non vide | Le nom de la ligne. |
lines[].monthlyCents | non | liste de nombres entiers, 12 éléments | Les douze montants de la ligne, du premier au dernier mois du budget, en centimes. |
lines[].annualCents | non | nombre entier | Le montant de l'année, en centimes, à la place des douze mois. |
Exemple
curl -X POST "$MARVESTO_URL/api/v1/budgets/BUDGET_ID/lines" \
-H "x-api-key: $MARVESTO_API_KEY" \
-H "content-type: application/json" \
-d @corps.jsonLe fichier corps.json :
{
"lines": [
{
"kind": "line",
"channelKey": "events",
"programName": "Salons",
"label": "Salon B2B Paris",
"annualCents": 4800000
}
]
}Réponse
created et updated : le nombre de lignes créées et mises à jour.
{
"created": 1,
"updated": 0
}Refus
Un refus répond { "message": "…" }, en français, avec son statut HTTP : voir Droits et erreurs.