Gestion des établissements

La gestion des établissements couvre les modifications effectuées après la découverte de vos ressources : créer un restaurant dans une organisation commerciale, mettre à jour son profil et configurer son fonctionnement quotidien. Si vous devez encore trouver un identifiant d’organisation ou d’établissement, commencez par Trouver vos ressources.

Créer ou modifier un établissement

Ajoutez un restaurant à une organisation ou maintenez son profil et son adresse.

Paramètres d’un établissement

Choisissez les paramètres opérationnels à consulter ou modifier.

Horaires d’ouverture

Remplacez les horaires hebdomadaires de livraison et de retrait.

Fermetures exceptionnelles

Planifiez les jours fériés, événements privés et autres fermetures ponctuelles.

Les paramètres appartiennent à un établissement

Chaque ressource de paramètres possède son propre endpoint :

/v1/locations/{location_id}
├── /order_settings
├── /opening_hours
├── /delivery_settings
├── /acceptance_settings
├── /ai_instructions
└── /special_closings

Lisez la valeur actuelle avant de la modifier. La plupart des paramètres utilisent PATCH : les champs omis conservent leur valeur. Les horaires utilisent PUT : le planning envoyé remplace le planning actuel.

Permissions

Les permissions sont séparées afin de n’accorder à une intégration que les actions nécessaires.

Tâche	Permission
Créer un établissement dans une organisation	`location.create`
Modifier le profil d’un établissement	`location.update`
Lire ou modifier les paramètres de commande	`orderSettings.read` / `orderSettings.write`
Lire ou remplacer les horaires	`openingHoursSettings.read` / `openingHoursSettings.write`
Lire ou modifier les paramètres de livraison	`deliverySettings.read` / `deliverySettings.write`
Lire ou modifier l’acceptation des commandes	`locationStatusSettings.read` / `locationStatusSettings.write`
Lire ou modifier les instructions du commis IA	`ai.read` / `ai.write`
Lire ou gérer les fermetures exceptionnelles	`openingHoursSettings.read` / `openingHoursSettings.write`

L’établissement ciblé doit également se trouver dans le périmètre de la clé.