Envoyer le coût d'équipe
Dépose le coût d'équipe de mois terminés, pour une entité : l'équipe marketing, l'équipe commerciale et les commissions.
Des totaux seulement, jamais une personne. Chaque partie est un montant en centimes, avec un effectif facultatif. Une partie absente garde ce que le mois contient déjà.
Rien n'est compté à l'envoi. Le CMO examine la proposition sur la page Données et la valide ou la refuse. Un envoi plus récent pour la même entité remplace celui qui attend.
Un mois n'apparaît qu'une fois. Un mois non terminé est refusé. Seuls le CMO et le propriétaire envoient un coût d'équipe.
Appel
| Repère | Valeur |
|---|---|
| Adresse | POST /api/v1/team-costs/proposals |
| Par son nom | POST /api/v1/tools/propose_team_costs, la réponse sous data |
| Nom de l'outil | propose_team_costs |
| Droit demandé | Saisir le coût d'équipe (teamCost.set) |
| Rôles qui ont ce droit par défaut | Propriétaire, CMO |
| 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. |
lines | oui | liste d'objets, 1 à 240 éléments | Les mois : un par ligne. |
lines[].period | oui | mois, AAAA-MM | Le mois, terminé. |
lines[].marketing | non | objet | L'équipe marketing. |
lines[].marketing.cents | oui | nombre entier, 0 ou plus | Le montant du mois, en centimes. |
lines[].marketing.headcount | non | nombre entier, 1 ou plus, ou null | L'effectif. Absent, l'effectif enregistré reste. null, il est inconnu. |
lines[].sales | non | objet | L'équipe commerciale. |
lines[].sales.cents | oui | nombre entier, 0 ou plus | Le montant du mois, en centimes. |
lines[].sales.headcount | non | nombre entier, 1 ou plus, ou null | L'effectif. Absent, l'effectif enregistré reste. null, il est inconnu. |
lines[].commissions | non | objet | Les commissions. |
lines[].commissions.cents | oui | nombre entier, 0 ou plus | Le montant du mois, en centimes. |
lines[].commissions.headcount | non | nombre entier, 1 ou plus, ou null | L'effectif. Absent, l'effectif enregistré reste. null, il est inconnu. |
Exemple
curl -X POST "$MARVESTO_URL/api/v1/team-costs/proposals" \
-H "x-api-key: $MARVESTO_API_KEY" \
-H "content-type: application/json" \
-d @corps.jsonLe fichier corps.json :
{
"entityId": "ENTITY_ID",
"lines": [
{
"period": "2026-10",
"marketing": {
"cents": 3200000,
"headcount": 6
},
"sales": {
"cents": 5400000,
"headcount": 9
},
"commissions": {
"cents": 800000
}
}
]
}Réponse
proposalId, lineCount (les mois reçus) 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.