Aller au contenu
Envoyer des données/Envoyer les factures émises

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èreValeur
AdressePOST /api/v1/billing/invoices/proposals
Par son nomPOST /api/v1/tools/propose_invoices, la réponse sous data
Nom de l'outilpropose_invoices
Droit demandéImporter un fichier (source.import)
Rôles qui ont ce droit par défautPropriétaire, CMO, Marketing Ops, DAF
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
nameouitexte, 1 à 80 caractèresLe nom de la proposition. Un envoi plus récent sous le même nom remplace celui qui attend.
columnsouiliste de textes, 1 à 120 éléments, chaque élément : 1 à 200 caractèresL'en-tête : les noms des colonnes, comme l'export les nomme, en français ou en anglais.
rowsouiliste de listes, 1 à 5 000 élémentsLes lignes, dans l'ordre des colonnes.
rows[]ouiliste de valeurs (texte, nombre ou null), 120 éléments au plusUne 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.json

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