API & MCP

Droit : aucun · lecture

Renvoie l'application connectée, son salon et ses droits (scopes). Aucun droit requis : à appeler en premier pour savoir ce que le jeton permet.

Aucun paramètre.

curl -H "Authorization: Bearer pgo_…" "https://pre-go.fr/api/v1/me"

Réponse

{
  "data": {
    "app": {
      "id": "app_x",
      "name": "Mon tableur"
    },
    "shop": {
      "id": 4,
      "slug": "le-barbier",
      "timezone": "Europe/Paris"
    },
    "scopes": [
      "shop:read",
      "appointments:read"
    ]
  }
}

Droit : shop:read · lecture

Renvoie le salon lié au jeton : nom, adresse, contact, fuseau horaire (toutes les heures de l'API sont exprimées dans ce fuseau), horaires d'ouverture et lien de réservation en ligne.

Aucun paramètre.

curl -H "Authorization: Bearer pgo_…" "https://pre-go.fr/api/v1/shop"

Réponse

{
  "data": {
    "id": 4,
    "name": "Le Barbier",
    "slug": "le-barbier",
    "timezone": "Europe/Paris",
    "businessHours": {
      "monday": {
        "open": "09:00",
        "close": "19:00",
        "closed": false
      }
    },
    "bookingUrl": "https://pre-go.fr/sites/le-barbier/booking"
  }
}

Droit : services:read · lecture

Liste les prestations du salon avec prix (en euros TTC), durée (en minutes) et catégorie. Par défaut, seules les prestations actives.

curl -H "Authorization: Bearer pgo_…" "https://pre-go.fr/api/v1/services"

Réponse

{
  "data": [
    {
      "id": 12,
      "name": "Coupe homme",
      "category": "Haircut",
      "price": 25,
      "discountPrice": null,
      "durationMinutes": 30,
      "bookableOnline": true,
      "isActive": true
    }
  ]
}

Droit : staff:read · lecture

Liste les barbiers (et membres du back-office) du salon. acceptsBookings indique qui peut recevoir des rendez-vous ; utilisez leur id comme staffId ailleurs.

curl -H "Authorization: Bearer pgo_…" "https://pre-go.fr/api/v1/staff"

Réponse

{
  "data": [
    {
      "id": "mbr_x1",
      "firstName": "Karim",
      "lastName": "B.",
      "title": "Barber",
      "acceptsBookings": true,
      "isActive": true
    }
  ]
}

Droit : availability:read · lecture

Renvoie les créneaux libres d'une journée pour une prestation, tous barbiers confondus ou pour un barbier donné. Mêmes règles que la réservation en ligne : horaires, congés, rendez-vous existants, créneaux passés exclus. Utilisez un créneau renvoyé ici pour create_appointment.

curl -H "Authorization: Bearer pgo_…" "https://pre-go.fr/api/v1/availability"

Réponse

{
  "data": {
    "date": "2026-10-02",
    "slots": [
      {
        "startTime": "10:00",
        "endTime": "10:30",
        "staffId": "mbr_x1"
      }
    ]
  }
}

Droit : appointments:read · lecture

Liste les rendez-vous entre deux dates incluses (92 jours au plus), triés par date puis heure. Filtres facultatifs : barbier, client, statut. Heures au format HH:mm dans le fuseau du salon ; startsAt est l'instant UTC exact.

curl -H "Authorization: Bearer pgo_…" "https://pre-go.fr/api/v1/appointments"

Réponse

{
  "data": [
    {
      "id": "apt_9f2",
      "date": "2026-10-02",
      "startTime": "10:00",
      "endTime": "10:30",
      "status": "confirmed",
      "staff": {
        "id": "mbr_x1",
        "name": "Karim B."
      },
      "service": {
        "id": 12,
        "name": "Coupe homme"
      },
      "customer": {
        "id": "c81e",
        "name": "Jean Dupont",
        "email": "jean@example.com",
        "phone": "+33612345678"
      },
      "price": 25
    }
  ],
  "meta": {
    "count": 1,
    "limit": 200,
    "offset": 0,
    "hasMore": false
  }
}

Droit : appointments:read · lecture

Renvoie un rendez-vous, avec toutes ses lignes de prestation.

curl -H "Authorization: Bearer pgo_…" "https://pre-go.fr/api/v1/appointments/<id>"

Droit : appointments:write · écriture

Réserve un créneau pour un client. Mêmes garde-fous que la réservation en ligne : refus d'un créneau passé ou déjà pris (409 conflict). Sans staffId, le salon choisit le barbier selon sa règle d'attribution. Le rendez-vous est confirmé d'office. Par défaut le client reçoit sa confirmation (e-mail, et SMS si le salon l'a activé) et le barbier est prévenu, comme pour une réservation en ligne. Vérifiez d'abord le créneau avec get_availability.

curl -X POST -H "Authorization: Bearer pgo_…" \
  -H "Content-Type: application/json" -d '{…}' "https://pre-go.fr/api/v1/appointments"

Réponse

{
  "data": {
    "bookingGroupId": "bkg_1",
    "appointments": [
      {
        "id": "apt_9f2",
        "date": "2026-10-02",
        "startTime": "10:00",
        "status": "confirmed"
      }
    ]
  }
}

Droit : appointments:write · écriture

Déplace un rendez-vous (date, heure, barbier), change son statut ou ses notes. Passe par la même logique que le planning du QG : le barbier est prévenu d'un déplacement ou d'une annulation, la liste d'attente est sollicitée sur un créneau libéré. Attention : comme dans le QG, un déplacement n'est pas refusé s'il chevauche un autre rendez-vous — vérifiez get_availability avant. L'encaissement (statut completed) se fait au QG, pas ici. Pour annuler, préférez cancel_appointment.

curl -X PATCH -H "Authorization: Bearer pgo_…" \
  -H "Content-Type: application/json" -d '{…}' "https://pre-go.fr/api/v1/appointments/<id>"

Droit : appointments:write · écriture

Annule un rendez-vous au nom du salon. Le barbier est prévenu et la liste d'attente est sollicitée, comme depuis le planning du QG. Le client n'est pas prévenu automatiquement (même comportement que le QG). Idempotent : annuler un rendez-vous déjà annulé le renvoie tel quel.

curl -X POST -H "Authorization: Bearer pgo_…" \
  -H "Content-Type: application/json" -d '{…}' "https://pre-go.fr/api/v1/appointments/<id>/cancel"

Droit : customers:read · lecture

Liste les clients du salon, triés par nom. search cherche dans le prénom, le nom, l'e-mail et le téléphone (le format du numéro n'importe pas : 0612345678 trouve « 06 12 34 56 78 »). Un numéro enregistré ou modifié désormais est renvoyé au format international E.164 (+33612345678) ; une fiche plus ancienne garde le format saisi à l'époque, et un numéro non reconnu (étranger hors format international, coquille) reste tel que saisi.

curl -H "Authorization: Bearer pgo_…" "https://pre-go.fr/api/v1/customers"

Réponse

{
  "data": [
    {
      "id": "c81e",
      "firstName": "Jean",
      "lastName": "Dupont",
      "email": "jean@example.com",
      "phone": "+33612345678",
      "totalVisits": 7,
      "lastVisitDate": "2026-09-12T08:00:00.000Z"
    }
  ],
  "meta": {
    "count": 1,
    "limit": 50,
    "offset": 0,
    "hasMore": false
  }
}

Droit : customers:read · lecture

Renvoie la fiche d'un client : coordonnées, consentements, statistiques de visite. Ses rendez-vous s'obtiennent avec list_appointments et customerId.

curl -H "Authorization: Bearer pgo_…" "https://pre-go.fr/api/v1/customers/<id>"

Droit : customers:write · écriture

Crée une fiche client. Si l'e-mail correspond déjà à une fiche, ou le téléphone avec un nom proche (un numéro peut être partagé en famille), renvoie 422 avec l'id existant dans details.existingCustomerId au lieu de créer un doublon ; passez allowDuplicate: true pour forcer.

curl -X POST -H "Authorization: Bearer pgo_…" \
  -H "Content-Type: application/json" -d '{…}' "https://pre-go.fr/api/v1/customers"

Droit : customers:write · écriture

Met à jour les coordonnées ou les consentements d'un client. Seuls les champs envoyés changent ; null efface l'e-mail ou le téléphone.

curl -X PATCH -H "Authorization: Bearer pgo_…" \
  -H "Content-Type: application/json" -d '{…}' "https://pre-go.fr/api/v1/customers/<id>"

Droit : sales:read · lecture

Liste les tickets de caisse entre deux dates incluses (jours du salon, 92 jours au plus), du plus récent au plus ancien, avec un résumé : nombre de tickets, total encaissé et pourboires (tickets remboursés exclus du résumé). Montants en euros TTC.

curl -H "Authorization: Bearer pgo_…" "https://pre-go.fr/api/v1/sales"

Réponse

{
  "data": [
    {
      "id": "sal_1",
      "receiptNumber": "T-2026-0042",
      "createdAt": "2026-10-02T09:12:00.000Z",
      "total": 30,
      "tipAmount": 5,
      "paymentMethod": "card",
      "paymentStatus": "completed",
      "staffId": "mbr_x1",
      "customerId": "c81e",
      "appointmentId": "apt_9f2"
    }
  ],
  "meta": {
    "count": 1,
    "limit": 200,
    "offset": 0,
    "hasMore": false
  },
  "summary": {
    "salesCount": 1,
    "total": 30,
    "tips": 5
  }
}

Droit : sms:read · lecture

Volumes SMS entre deux jours inclus (jours du salon, 366 jours au plus ; par défaut le mois en cours) : total, par barbier, par type de message et par jour. Mêmes chiffres que l'écran « Consommation SMS » du QG. Seuls les SMS facturés comptent (statuts pending, sent, delivered) ; unbilled dit combien de tentatives ne l'ont pas été (numéro invalide, plafond atteint, erreur du fournisseur). messages = SMS envoyés (un par destinataire) ; segments = unités facturées (un message long en compte plusieurs) — c'est segments qu'on refacture. Le barbier d'un SMS est celui du rendez-vous qui l'a déclenché ; staffId: null = sans barbier (SMS de test…). Le détail ligne à ligne est dans list_sms_messages.

curl -H "Authorization: Bearer pgo_…" "https://pre-go.fr/api/v1/sms/usage"

Réponse

{
  "data": {
    "period": {
      "from": "2026-09-01",
      "to": "2026-09-30",
      "timeZone": "Europe/Paris"
    },
    "totals": {
      "messages": 412,
      "segments": 431
    },
    "byStaff": [
      {
        "staffId": "mbr_k4r1m",
        "name": "Karim Benali",
        "messages": 240,
        "segments": 251
      },
      {
        "staffId": "mbr_s4m1",
        "name": "Sami Haddad",
        "messages": 170,
        "segments": 178
      },
      {
        "staffId": null,
        "name": "Sans barbier",
        "messages": 2,
        "segments": 2
      }
    ],
    "byType": [
      {
        "type": "reminder_24h",
        "label": "Rappel 24h",
        "messages": 300,
        "segments": 300
      },
      {
        "type": "booking_confirmation",
        "label": "Confirmation de réservation",
        "messages": 110,
        "segments": 129
      },
      {
        "type": "sms_test",
        "label": "SMS de test",
        "messages": 2,
        "segments": 2
      }
    ],
    "byDay": [
      {
        "date": "2026-09-01",
        "messages": 14,
        "segments": 15
      }
    ],
    "unbilled": 3
  }
}

Droit : sms:read · lecture

Le détail qui justifie une refacturation : un SMS par ligne, du plus récent au plus ancien, entre deux jours inclus (jours du salon, 366 jours au plus ; par défaut le mois en cours). Par défaut seuls les SMS facturés (statuts pending, sent, delivered) ; status=unbilled pour les tentatives non facturées, status=all pour tout. Chaque ligne donne le barbier du rendez-vous, le type de message, le nombre de segments facturés, et les identifiants du rendez-vous et du client. Ni numéro ni texte du message. day est le jour du salon qui sert aux totaux de get_sms_usage.

curl -H "Authorization: Bearer pgo_…" "https://pre-go.fr/api/v1/sms/messages"

Réponse

{
  "data": [
    {
      "id": 98123,
      "sentAt": "2026-09-30T21:30:00.000Z",
      "day": "2026-09-30",
      "staff": {
        "id": "mbr_k4r1m",
        "name": "Karim Benali"
      },
      "type": "reminder_24h",
      "typeLabel": "Rappel 24h",
      "segments": 1,
      "status": "delivered",
      "billed": true,
      "appointmentId": "apt_9f2",
      "customerId": "c81e"
    }
  ],
  "meta": {
    "count": 1,
    "limit": 200,
    "offset": 0,
    "hasMore": false
  },
  "period": {
    "from": "2026-09-01",
    "to": "2026-09-30",
    "timeZone": "Europe/Paris"
  }
}

Droit : inventory:read · lecture

Liste les produits du salon (vente au comptoir, consommables, linge réutilisable) avec leur stock. stock.status vaut out (épuisé), low (au seuil minimum ou dessous, comme l'alerte du QG) ou ok. Filtre stock=low pour la liste à recommander (épuisés compris). summary porte sur tous les produits actifs, pas seulement la page : nombre, produits bas, épuisés, valeur du stock au prix d'achat (€ HT).

curl -H "Authorization: Bearer pgo_…" "https://pre-go.fr/api/v1/products"

Réponse

{
  "data": [
    {
      "id": 31,
      "name": "Cire mate 100 ml",
      "sku": "CIRE-MAT-100",
      "barcode": "3760000000017",
      "brand": "Reuzel",
      "category": {
        "id": 2,
        "name": "Coiffants"
      },
      "kind": "retail",
      "sellingPrice": 19.9,
      "costPrice": 9.5,
      "taxRate": 20,
      "stock": {
        "current": 2,
        "status": "low",
        "minimum": 3,
        "maximum": 12,
        "reorderPoint": null,
        "reorderQuantity": 6,
        "tracked": true,
        "allowNegative": false
      },
      "openUnit": null,
      "reusable": null,
      "isActive": true
    }
  ],
  "meta": {
    "count": 1,
    "limit": 100,
    "offset": 0,
    "hasMore": false
  },
  "summary": {
    "products": 24,
    "lowStock": 3,
    "outOfStock": 1,
    "stockValueAtCost": 812.4
  }
}

Droit : inventory:read · lecture

Renvoie un produit, son stock et ses dix derniers mouvements (le plus récent d'abord). L'historique complet s'obtient avec list_stock_movements et productId.

curl -H "Authorization: Bearer pgo_…" "https://pre-go.fr/api/v1/products/<id>"

Droit : inventory:read · lecture

Liste les catégories de produits du salon, dans l'ordre d'affichage du QG. Utilisez leur id comme categoryId dans list_products, create_product et update_product.

Aucun paramètre.

curl -H "Authorization: Bearer pgo_…" "https://pre-go.fr/api/v1/product-categories"

Réponse

{
  "data": [
    {
      "id": 2,
      "name": "Coiffants",
      "description": null,
      "parentId": null,
      "color": "#3B82F6",
      "isActive": true
    }
  ]
}

Droit : inventory:read · lecture

Liste les entrées et sorties de stock, de la plus récente à la plus ancienne. type : purchase (réception), sale (vente en caisse), service_use (consommé pendant une prestation), waste (perte, casse, périmé), adjustment (correction ou inventaire), transfer. quantity est signée : positive pour une entrée, négative pour une sortie. Période facultative en jours du salon (92 jours au plus si from et to sont donnés).

curl -H "Authorization: Bearer pgo_…" "https://pre-go.fr/api/v1/stock-movements"

Réponse

{
  "data": [
    {
      "id": 912,
      "product": {
        "id": 31,
        "name": "Cire mate 100 ml"
      },
      "type": "purchase",
      "quantity": 6,
      "stockBefore": 2,
      "stockAfter": 8,
      "unitCost": 9.5,
      "totalCost": 57,
      "reason": "Réception",
      "reference": "BL-2026-118",
      "recordedBy": "Karim B.",
      "connectedApp": {
        "id": "app_x",
        "name": "Mon tableur"
      },
      "createdAt": "2026-10-02T08:30:00.000Z"
    }
  ],
  "meta": {
    "count": 1,
    "limit": 100,
    "offset": 0,
    "hasMore": false
  }
}

Droit : inventory:write · écriture

Modifie le stock d'un produit en laissant une trace dans son historique. Quatre cas : - type: "purchase" + quantity > 0 : livraison reçue, le stock monte de quantity. - type: "waste" + quantity > 0 : perte, casse ou périmé, le stock baisse de quantity. - type: "adjustment" + quantity signée (≠ 0) : correction ponctuelle. - type: "adjustment" + countedStock : inventaire, le stock devient exactement countedStock. Les quantités sont des unités entières (flacons fermés pour un consommable). Une sortie qui ferait passer le stock sous zéro est refusée (422) sauf si le produit l'autorise. Pour un réutilisable (linge), une réception ou une perte change aussi le nombre possédé. Idempotence : avec une reference (n° de bon de livraison…), un second appel identique sur le même produit renvoie le mouvement déjà enregistré avec replayed: true au lieu de compter deux fois. Une vente se fait en caisse au QG, pas ici.

curl -X POST -H "Authorization: Bearer pgo_…" \
  -H "Content-Type: application/json" -d '{…}' "https://pre-go.fr/api/v1/products/<id>/stock-movements"

Réponse

{
  "data": {
    "movement": {
      "id": 912,
      "type": "purchase",
      "quantity": 6,
      "stockBefore": 2,
      "stockAfter": 8,
      "reference": "BL-2026-118"
    },
    "product": {
      "id": 31,
      "name": "Cire mate 100 ml",
      "stock": {
        "current": 8,
        "status": "ok"
      }
    }
  },
  "replayed": false
}

Droit : inventory:write · écriture

Ajoute un produit au catalogue du salon. Prix en euros : sellingPrice TTC, costPrice HT. Si un produit porte déjà ce sku (casse ignorée), renvoie 422 avec son id dans details.existingProductId au lieu de créer un doublon ; passez allowDuplicateSku: true pour forcer. initialStock crée le stock de départ avec un mouvement « Stock initial » dans l'historique.

curl -X POST -H "Authorization: Bearer pgo_…" \
  -H "Content-Type: application/json" -d '{…}' "https://pre-go.fr/api/v1/products"

Droit : inventory:write · écriture

Met à jour la fiche d'un produit : prix, seuils de stock, référence, catégorie, archivage (isActive: false). Seuls les champs envoyés changent ; null efface un champ facultatif. Le stock lui-même ne se modifie pas ici : utilisez create_stock_movement, qui garde l'historique.

curl -X PATCH -H "Authorization: Bearer pgo_…" \
  -H "Content-Type: application/json" -d '{…}' "https://pre-go.fr/api/v1/products/<id>"