Envoyer les factures émises
Dépose les factures émises par votre outil de facturation, sous la forme du tableau de leur export.
Quatre colonnes au moins : un numéro, un client, une date et un montant hors taxes en euros (« Invoice number », « Customer », « Invoice date », « Amount excluding tax », ou leurs noms français). Un avoir est négatif. Le SIREN du client et son e-mail de facturation sont facultatifs. Une colonne nommée seulement « montant » n'est pas lue : elle ne dit pas qu'elle est hors taxes.
Le tableau est lu à l'envoi par le lecteur du fichier : ce qu'il refuse revient tout de suite, avec ses lignes, numérotées à partir de 1 dans rows. Il attend ensuite qui importe les fichiers, qui voit son aperçu sur la page Données et le valide ou le refuse. Rien n'est compté avant.
Un e-mail de facturation n'est gardé que sous forme d'empreinte SHA-256. Vous pouvez l'envoyer déjà haché : sha256: suivi de l'empreinte hexadécimale de l'adresse en minuscules.
Appel
| Repère | Valeur |
|---|---|
| Adresse | POST /api/v1/billing/invoices/proposals |
| Par son nom | POST /api/v1/tools/propose_invoices, la réponse sous data |
| Nom de l'outil | propose_invoices |
| Droit demandé | Importer un fichier (source.import) |
| Rôles qui ont ce droit par défaut | Propriétaire, CMO, Marketing Ops, DAF |
| 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 |
|---|---|---|---|
name | oui | texte, 1 à 80 caractères | Le nom de la proposition. Un envoi plus récent sous le même nom remplace celui qui attend. |
columns | oui | liste de textes, 1 à 120 éléments, chaque élément : 1 à 200 caractères | L'en-tête : les noms des colonnes, comme l'export les nomme, en français ou en anglais. |
rows | oui | liste de listes, 1 à 5 000 éléments | Les lignes, dans l'ordre des colonnes. |
rows[] | oui | liste de valeurs (texte, nombre ou null), 120 éléments au plus | Une ligne : pour chaque colonne, un texte, un nombre, ou null pour une cellule vide. Les dates au format AAAA-MM-JJ. |
Exemple
curl -X POST "$MARVESTO_URL/api/v1/billing/invoices/proposals" \
-H "x-api-key: $MARVESTO_API_KEY" \
-H "content-type: application/json" \
-d @corps.jsonLe fichier corps.json :
{
"name": "Factures d'octobre",
"columns": ["Invoice number", "Customer", "Invoice date", "Amount excluding tax"],
"rows": [
["F-2026-0412", "Atelier Nord", "2026-10-03", 4200],
["A-2026-0031", "Atelier Nord", "2026-10-20", -600]
]
}Réponse
proposalId, rowCount (les lignes lues), firstMonth et lastMonth (les mois couverts), superseded (les propositions en attente remplacées).
{
"proposalId": "PROPOSAL_ID",
"rowCount": 2,
"firstMonth": "2026-10",
"lastMonth": "2026-10",
"superseded": 0
}Refus
Un refus répond { "message": "…" }, en français, avec son statut HTTP : voir Droits et erreurs.