Aller au contenu
Envoyer des données/Envoyer le coût d'équipe

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èreValeur
AdressePOST /api/v1/team-costs/proposals
Par son nomPOST /api/v1/tools/propose_team_costs, la réponse sous data
Nom de l'outilpropose_team_costs
Droit demandéSaisir le coût d'équipe (teamCost.set)
Rôles qui ont ce droit par défautPropriétaire, CMO
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.
linesouiliste d'objets, 1 à 240 élémentsLes mois : un par ligne.
lines[].periodouimois, AAAA-MMLe mois, terminé.
lines[].marketingnonobjetL'équipe marketing.
lines[].marketing.centsouinombre entier, 0 ou plusLe montant du mois, en centimes.
lines[].marketing.headcountnonnombre entier, 1 ou plus, ou nullL'effectif. Absent, l'effectif enregistré reste. null, il est inconnu.
lines[].salesnonobjetL'équipe commerciale.
lines[].sales.centsouinombre entier, 0 ou plusLe montant du mois, en centimes.
lines[].sales.headcountnonnombre entier, 1 ou plus, ou nullL'effectif. Absent, l'effectif enregistré reste. null, il est inconnu.
lines[].commissionsnonobjetLes commissions.
lines[].commissions.centsouinombre entier, 0 ou plusLe montant du mois, en centimes.
lines[].commissions.headcountnonnombre entier, 1 ou plus, ou nullL'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.json

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