Factures (centralisé)

Cet endpoint permet à un logiciel externe utilisé par une organisation (gestionnaire de plusieurs structures d'accueil) de récupérer en une seule liste les factures de toutes ses structures, sans devoir interroger chaque structure une par une.

Les URIs ci-dessous sont relatives à https://abcreche.com/api/v1.

Le format des factures (champs, statuts, montants en centimes) est identique à celui de l'API par structure d'accueil : voir Factures.

Headers

Header	Valeur
Authorization	Bearer {token}
Accept	application/json

Accès

• Le token doit appartenir à un utilisateur lié à l'organisation, sinon l'API répond 403.
• Seules les factures des structures d'accueil auxquelles cet utilisateur a accès sont retournées. Si l'utilisateur n'est rattaché à aucune structure, la liste est vide. Vérifiez donc que l'utilisateur utilisé pour l'intégration a accès à toutes les structures concernées.

Liste des factures

Request

• HTTP Method: GET
• URI: /organization/{organizationUuid}/invoices

Les résultats sont paginés par 50 factures par page (non modifiable). Par défaut, les factures sont triées par référence décroissante.

Parameters

Property	Type	Required	Description
page	Integer	false	Numéro de page. Défaut : 1.
creche_uuids[]	Array of UUIDs	false	Limite les résultats à certaines structures d'accueil de l'organisation.
creche_types[]	Array of Strings	false	Limite les résultats à certains types de structure : creche, nursery (accueillante), aes, stage.
from	Date YYYY-MM-DD	false	Date de facture ≥ from. Si to n'est pas envoyé, to vaut automatiquement le dernier jour du mois de from.
to	Date YYYY-MM-DD	false	Date de facture ≤ to.
billable_month	Date YYYY-MM-DD	false	Mois facturé (mois des prestations). Envoyez le 1er jour du mois, ex. : 2026-05-01 pour mai 2026.
status	Integer	false	Statut de la facture (voir Statuts). Avec status=0 (impayé), seules les factures déjà envoyées sont retournées.
onlyOverdue	Boolean	false	Uniquement les factures impayées ou partiellement payées dont l'échéance est dépassée.
search	String	false	Recherche dans la référence de facture, la communication structurée, la référence de l'inscription ou le prénom/nom de l'enfant.
registration_uuid	UUID	false	Uniquement les factures d'une inscription (un enfant).
onlyCaution	Boolean	false	Uniquement les factures de caution.
onlyEvent	Boolean	false	Uniquement les factures liées à une inscription à un événement.
onlySEPA	Boolean	false	Uniquement les factures dont le parent paie par domiciliation SEPA.
onlyToParentNoEmail	Boolean	false	Uniquement les factures dont le parent ne reçoit pas ses factures par email.
meta[{clé}]	String	false	Uniquement les factures dont meta.{clé} vaut cette valeur. Ex. : meta[monerp_id]=F-42.
without_meta	String	false	Uniquement les factures sans la clé meta.{clé}. Ex. : without_meta=monerp_id retourne les factures pas encore importées.
order_by_value	String	false	Champ de tri, par exemple date, due_date, reference, total, billable_month, paid_at ou sent_at.
order_by_direction	String	false	asc (défaut) ou desc. Utilisé uniquement avec order_by_value.

Les booléens s'envoient sous la forme 1 / 0. Les filtres sont cumulables.

Différences avec l'API par structure d'accueil

L'API centralisée propose moins de filtres. Les paramètres suivants ne sont disponibles que sur l'API par structure (Factures) : per_page, date_from / date_to, due_date_*, sent_at_*, paid_at_*, min_total / max_total, onlyWithPayments, onlyWithoutPayments, onlyNotSent, onlyGrouped, parent_uuid, classroom_uuids[].

Si vous avez besoin de ces filtres, interrogez chaque structure d'accueil séparément avec son uuid.

Exemples

Toutes les factures émises en juin 2026, triées par date :

GET /organization/5f963d99-0a8f-47e1-a04d-6c0d5b7b7d43/invoices?from=2026-06-01&to=2026-06-30&order_by_value=date

Factures en retard de deux structures précises :

GET /organization/5f963d99-0a8f-47e1-a04d-6c0d5b7b7d43/invoices?onlyOverdue=1&creche_uuids[]=9928c211-abd9-4902-8db3-d3e8d2b89b0a&creche_uuids[]=9928c212-abd9-4902-8db3-d3e8d2b89b0a

Response

Même format que la liste des factures par structure, avec en plus l'objet creche sur chaque facture pour savoir à quelle structure d'accueil elle appartient :

{
  "data": [
    {
      "uuid": "b1e4c9a2-6f1d-4c1b-9a77-3f0e2d5c8a10",
      "reference": "2026-000123",
      "creche": {
        "uuid": "9928c211-abd9-4902-8db3-d3e8d2b89b0a",
        "name": "Crèche A",
        "...": "..."
      },
      "total": 45230,
      "paid_total": 20000,
      "status": 1,
      "status_label": "Partiellement payé",
      "...": "..."
    }
  ],
  "links": { "first": "...", "last": "...", "prev": null, "next": "..." },
  "meta": { "current_page": 1, "last_page": 12, "per_page": 50, "total": 587 }
}

Pour récupérer toutes les factures, suivez links.next jusqu'à ce qu'il vaille null.

Détail d'une facture

• HTTP Method: GET
• URI: /organization/{organizationUuid}/invoices/{invoiceUuid}

Retourne une facture avec ses lignes, ses paiements, sa structure d'accueil et son historique. Même format que le détail par structure.

Télécharger le PDF d'une facture

• HTTP Method: GET
• URI: /organization/{organizationUuid}/invoices/{invoiceUuid}/pdf

La réponse est le fichier PDF (Content-Type: application/pdf).

Écrire dans meta

• HTTP Method: PATCH
• Content Type: application/json
• URI: /organization/{organizationUuid}/invoices/{invoiceUuid}/meta

Permet à votre logiciel d'enregistrer ses propres informations sur une facture (identifiant dans votre système, date d'import…). Fonctionnement identique à l'API par structure : fusion des clés, null pour supprimer une clé, clés réservées non modifiables. Voir Écrire dans meta.

{
  "meta": {
    "monerp_id": "F-2026-0042"
  }
}

Import incrémental de toutes les structures en une fois :

1. GET /organization/{organizationUuid}/invoices?without_meta=monerp_id
2. Importer chaque facture dans votre logiciel.
3. PATCH /organization/{organizationUuid}/invoices/{invoiceUuid}/meta avec votre identifiant.

Gestion des erreurs

Code	Signification	Action recommandée
401	Token absent, invalide ou expiré.	Se ré-authentifier via /authenticate.
403	L'utilisateur n'est pas lié à cette organisation, ou la facture n'appartient pas à l'organisation.	Vérifier l'uuid de l'organisation et les droits de l'utilisateur.
404	Organisation ou facture introuvable.	Vérifier les UUIDs utilisés.
422	Paramètre invalide (ex. : date au mauvais format).	Corriger la requête selon les erreurs retournées.

Implémentation recommandée

1. Vérifiez que l'utilisateur de l'intégration a accès à toutes les structures d'accueil de l'organisation.
2. Récupérez les factures par période avec from / to, en parcourant toutes les pages.
3. Utilisez creche.uuid pour rattacher chaque facture à la bonne structure dans votre logiciel (liste complète via Structures d'accueil), et uuid comme identifiant unique de la facture.
4. Pour suivre les paiements, re-synchronisez régulièrement les factures encore ouvertes (status=0 et status=1), puisque l'API ne propose pas de filtre « modifié depuis ».