Documentation
L'API de Marvesto lit les chiffres des écrans et reçoit vos données. Ce qu'elle reçoit attend une personne : rien n'est compté avant sa validation.
Envoyer des données
- Créer une entité
POST /api/v1/entitiesCrée une entité : la société dont le budget est piloté. - Écrire des lignes dans le brouillon d'un budget
POST /api/v1/budgets/:budgetId/linesÉcrit des lignes dans le brouillon d'un budget, comme le ferait l'import d'un fichier. - Envoyer des dépenses suivies hors du produit
POST /api/v1/spend/proposalsDépose les dépenses que le CMO suit ailleurs (événements, salons, opérations terrain), hors taxes, pour une entité et un suivi nommé. - Envoyer des volumes suivis hors du CRM
POST /api/v1/funnel/volume-proposalsDépose des volumes que le CMO suit hors du CRM (salons, opérations terrain) : pour un canal et un mois, le nombre de leads, de MQL, de SQL, de SQO ou de deals gagnés. - Envoyer les deals du CRM
POST /api/v1/crm/deals/proposalsDépose les deals du CRM, sous la forme du tableau de leur export. - Envoyer les contacts du CRM
POST /api/v1/crm/contacts/proposalsDépose les contacts du CRM, sous la forme du tableau de leur export. - Envoyer les factures émises
POST /api/v1/billing/invoices/proposalsDépose les factures émises par votre outil de facturation, sous la forme du tableau de leur export. - Envoyer la dépense d'une régie, jour par jour
POST /api/v1/spend/daily/proposalsDépose la dépense d'une régie publicitaire jour par jour, pour une entité, sous la forme du tableau de son rapport. - Envoyer des contrats
POST /api/v1/contracts/proposalsDépose des contrats signés avec des fournisseurs, pour une entité : chacun devient un brouillon sur la page des contrats. - Envoyer l'objectif de l'exercice
POST /api/v1/objectives/proposalsDépose l'objectif de nouveau revenu de l'exercice : celui de l'entreprise, celui du marketing, ou les deux. - Envoyer le coût d'équipe
POST /api/v1/team-costs/proposalsDépose le coût d'équipe de mois terminés, pour une entité : l'équipe marketing, l'équipe commerciale et les commissions.
Lire les chiffres
- Lister les budgets
GET /api/v1/budgetsListe les budgets de l'organisation. - Lire le pipeline
GET /api/v1/pipelineDonne le pipeline sur une période qui finit avec le dernier mois entier de l'export du CRM. - Lire un deal
GET /api/v1/pipeline/deals/:crmIdDonne un deal par son identifiant dans le CRM. - Lire un canal d'un budget
GET /api/v1/budgets/:budgetId/channels/:channelKeyDonne un canal d'un budget, comme l'écran de pilotage le lit à un jour donné. - Lire le pilotage d'un budget
POST /api/v1/tools/get_steeringDonne le pilotage d'un budget à un jour donné, comme l'écran « Budget et fin d'année » le lit. - Lire le fil de l'euro
POST /api/v1/tools/get_euro_threadDonne le fil de l'euro d'un budget à un jour donné : de l'euro dépensé au revenu signé, sur les mêmes mois. - Lire les SQO face au besoin
POST /api/v1/tools/get_sqo_vs_needDonne, par canal d'un budget, le dépensé face au plan à date et les SQO face à ce que demande l'objectif du canal. - Lire les recommandations de pilotage
POST /api/v1/tools/get_recommendationsDonne les recommandations de pilotage d'un budget à un jour donné. - Lire ce qui attend
POST /api/v1/tools/get_queueDonne ce qui attend une décision ou une donnée pour un budget, à un jour donné. - Lire la vue CEO
POST /api/v1/tools/get_ceo_viewDonne la vue CEO d'un budget à un jour donné, en totaux seulement. - Lire la revue d'un mois
POST /api/v1/tools/get_month_reviewDonne la revue d'un mois d'un budget : du budget au dépensé, canal par canal. - Lire le rendement par canal
POST /api/v1/tools/get_channel_returnDonne le rendement par canal à un jour donné. - Lire le funnel
POST /api/v1/tools/get_funnelDonne le funnel sur une période qui finit avec le dernier mois entier de l'export du CRM. - Lire la prévision du pipeline ouvert
POST /api/v1/tools/get_pipeline_forecastDonne la prévision du pipeline ouvert à un jour donné. - Lire l'objectif à date
POST /api/v1/tools/get_objective_progressDonne l'objectif de l'exercice à un jour donné : ce qui était demandé, et ce qui est signé. - Lire les contrats
POST /api/v1/tools/get_contractsDonne les contrats à un jour donné. - Lire l'état des données
POST /api/v1/tools/get_data_stateDonne l'état des données de l'organisation : les cinq couches et ce qui alimente chacune.
Organisation et réglages
- Lire l'organisation de la clé
GET /api/v1/organizationDit à quelle organisation appartient la clé utilisée. - Lister les membres
GET /api/v1/membersListe les membres de l'organisation, avec leur rôle et leur profil. - Lire un membre
GET /api/v1/members/:memberIdDonne un membre de l'organisation par son identifiant. - Lire l'abonnement
GET /api/v1/subscriptionDonne l'offre de l'organisation, l'état de son abonnement et ses limites. - Lire la version des règles de calcul
GET /api/v1/rules/versionDonne la version des règles de calcul avec laquelle les chiffres sont lus, et la date de son dernier changement. - Lister les entités
GET /api/v1/entitiesListe les entités de l'organisation.