# NowOS

## Docs

- [Create a reservation](https://docs.now-os.app/api-reference/create-a-reservation.md): One reservation, keyed by YOUR `externalId`. Re-creating an existing id is a 409 — updates go through PUT. A `seated` status with `tableIds` is a seat instruction: the till opens the order and you receive `table.seated` as confirmation (or `reservation.seat_rejected`).
- [Get the published floor plan](https://docs.now-os.app/api-reference/get-the-published-floor-plan.md): The latest PUBLISHED plan. Table `id` is the stable UUID every other endpoint accepts (store it as your `pos_table_id`). Labels are display-only and renamable; never key on them.
- [Floor plan import](https://docs.now-os.app/api-reference/import.md): One-shot onboarding: push your canvas, get the table-id mapping back.
- [Import a floor plan (one-shot onboarding)](https://docs.now-os.app/api-reference/import-a-floor-plan-one-shot-onboarding.md): Push your canvas; NowOS creates the DRAFT (the operator reviews and publishes in the backoffice) and returns the `externalTableId → tableId` mapping — persist it as your `pos_table_id` column, there is no manual mapping anywhere. Refused once the location has a draft (unless `replaceDraft`) and alwa…
- [Introduction](https://docs.now-os.app/api-reference/introduction.md): Plug a reservation system into NowOS: floor plan in, reservations in, table lifecycle out.
- [Reservation lifecycle](https://docs.now-os.app/api-reference/lifecycle.md): Statuses, bidirectional seating, and money collected upfront.
- [List reservations (read-back)](https://docs.now-os.app/api-reference/list-reservations-read-back.md): What NowOS currently holds for a window (`startsAt` in `[from, to)`). Reconciliation and debugging surface — never required for correct operation.
- [Update a reservation](https://docs.now-os.app/api-reference/update-a-reservation.md): Full-body update (no PATCH — you always have the whole object). Last-write-wins on YOUR `updatedAt`: an older write is acknowledged `stale` (200, nothing applied), so blind retries and out-of-order deliveries are always safe. Cancellation is `status: "cancelled"` — never a DELETE. Once a reservation…
- [Webhooks](https://docs.now-os.app/api-reference/webhooks.md): Signed events for table lifecycle, spend, and reservation outcomes.
- [Utiliser l’agent IA de support](https://docs.now-os.app/fr/backoffice/ai-support.md): Poser une question à l’agent NowOS, retrouver une demande et comprendre les informations qu’il peut consulter.
- [La facturation et votre offre](https://docs.now-os.app/fr/backoffice/billing.md): Consultez l'offre de chaque point de vente : formule, validité et terminaux autorisés.
- [Les formules et les lots](https://docs.now-os.app/fr/backoffice/combos.md): Vendez plusieurs articles à un prix unique — une formule au restaurant, un lot en boutique — sans dupliquer votre carte.
- [La conformité fiscale](https://docs.now-os.app/fr/backoffice/compliance.md): Vérifiez l'intégrité des registres fiscaux, téléchargez l'archive pour un contrôle, et en France imprimez l'attestation de conformité NF525.
- [Les appareils](https://docs.now-os.app/fr/backoffice/devices.md): Surveillez la caisse principale et les appareils secondaires depuis le backoffice : état de connexion, appareils associés, désignation et dissociation.
- [Les remises](https://docs.now-os.app/fr/backoffice/discounts.md): Préparez des remises nommées (« presets ») que la caisse applique en un geste, et gérez la liste des motifs de remise — pourcentage ou montant, autorisation manager optionnelle.
- [Premiers pas dans le backoffice](https://docs.now-os.app/fr/backoffice/getting-started.md): Créez votre compte, votre organisation et vos établissements, et repérez ce qui se gère au niveau de l'organisation.
- [Inventaire](https://docs.now-os.app/fr/backoffice/inventory.md): Suivez le stock disponible de vos produits depuis le backoffice : quantités en stock, alertes de stock bas, historique des mouvements, et l'historique des articles épuisés (86).
- [Les membres et les invitations](https://docs.now-os.app/fr/backoffice/members.md): Invitez d'autres administrateurs dans votre espace de travail, gérez leurs rôles et votre propre compte.
- [Le menu et les articles](https://docs.now-os.app/fr/backoffice/menu.md): Créez vos articles dans le backoffice, fixez leurs prix, organisez-les en écrans, puis publiez pour que vos caisses reçoivent la nouvelle version.
- [Les modificateurs et combos](https://docs.now-os.app/fr/backoffice/modifiers-combos.md): Ajoutez des groupes de choix à vos articles — tailles, suppléments, options — avec des sélections obligatoires ou facultatives et des suppléments de prix.
- [Commandes, ventes et remboursements](https://docs.now-os.app/fr/backoffice/orders.md): Suivre les commandes, consulter les ventes scellées et gérer les remboursements depuis le backoffice, où que vous soyez.
- [Les paramètres de l'organisation](https://docs.now-os.app/fr/backoffice/org-settings.md): Renommez votre enseigne et retrouvez tous vos points de vente au même endroit.
- [La disposition de la caisse](https://docs.now-os.app/fr/backoffice/pos-layout.md): Organisez vos articles en écrans et tuiles dans le backoffice : c'est exactement la grille que votre équipe verra sur la caisse.
- [Rapports](https://docs.now-os.app/fr/backoffice/reports.md): Les rapports du backoffice : les clôtures de journée (Z) et le rapport remboursements, et ce qui arrive ensuite.
- [Les réglages de l'établissement](https://docs.now-os.app/fr/backoffice/settings.md): Le tour des réglages du backoffice : coordonnées de l'établissement, identité des tickets, clôture de journée et imprimantes.
- [L'équipe et les codes PIN](https://docs.now-os.app/fr/backoffice/staff.md): Ajoutez vos managers et votre personnel, délivrez leurs codes PIN pour la caisse et réinitialisez-les en cas de besoin.
- [Tables et réservations](https://docs.now-os.app/fr/backoffice/tables.md): Dessinez et publiez votre plan de salle, connectez un prestataire de réservations, et suivez les réservations du jour depuis le backoffice.
- [Les taxes](https://docs.now-os.app/fr/backoffice/taxes.md): Configurez vos taux de TVA et vos groupes de taxes dans le backoffice, et comprenez ce qui s'affiche sur la caisse et sur le ticket.
- [Variantes](https://docs.now-os.app/fr/backoffice/variants.md): Vendez un même produit en plusieurs versions (format, taille…), chacune avec son prix, son code-barres et son stock.
- [Les concepts clés](https://docs.now-os.app/fr/concepts.md): Le backoffice et la caisse, la caisse principale, la journée commerciale, et le chemin de la commande à la vente.
- [Bienvenue sur NowOS](https://docs.now-os.app/fr/index.md): Découvrez NowOS, la caisse pour restaurants et boutiques, et trouvez le bon point de départ selon votre besoin.
- [Politique de confidentialité](https://docs.now-os.app/fr/legal/privacy.md): Comment l'application NowOS traite et protège les données personnelles.
- [Mode restaurant et mode boutique](https://docs.now-os.app/fr/modes.md): Chaque point de vente fonctionne en mode restaurant ou en mode boutique. Voici ce qui change entre les deux.
- [Clôture de journée](https://docs.now-os.app/fr/pos/close-of-day.md): Clôturer la journée commerciale sur la caisse NowOS : régler les commandes ouvertes, compter le tiroir en aveugle par coupures, constater l'écart et sceller le Z.
- [La connectivité](https://docs.now-os.app/fr/pos/connectivity.md): Comprendre les états de connexion de la caisse : ce qui bloque la prise de commandes, ce qui est sans gravité, et quoi faire dans chaque cas.
- [Le coursing (envoi par étapes)](https://docs.now-os.app/fr/pos/coursing.md): Organisez l'addition en étapes — entrées, plats, desserts — et envoyez-les en cuisine l'une après l'autre, au rythme de la table.
- [Les réglages de l'appareil](https://docs.now-os.app/fr/pos/device-settings.md): Visite guidée de l'onglet Plus : l'état de cet appareil, les préférences, l'équipe et l'aide.
- [Remises à la caisse](https://docs.now-os.app/fr/pos/discounts.md): Appliquer une remise — en pourcentage, en montant, ou via un preset configuré — sur un panier en mode boutique NowOS, avant le paiement.
- [La caisse principale](https://docs.now-os.app/fr/pos/main-register.md): Le rôle de la caisse principale, pourquoi cet iPad doit rester allumé et branché, et comment surveiller les appareils connectés du magasin.
- [Actions sur une commande](https://docs.now-os.app/fr/pos/order-actions.md): Ajouter une note cuisine, régler les couverts, imprimer l'addition, réimprimer un ticket cuisine et annuler une commande depuis l'onglet Actions de la caisse NowOS.
- [La liste des commandes](https://docs.now-os.app/fr/pos/orders-list.md): Retrouver les commandes ouvertes et les commandes clôturées du jour, comprendre les statuts et reprendre une commande en cours.
- [Encaisser un paiement](https://docs.now-os.app/fr/pos/payments.md): Encaisser en espèces ou par carte, combiner plusieurs paiements, partager l'addition et finaliser la vente sur la caisse NowOS.
- [Tickets et impression](https://docs.now-os.app/fr/pos/receipts-printing.md): Ce qui s'imprime sur la caisse NowOS — tickets, additions, tickets cuisine, tickets de remboursement — comment configurer vos imprimantes et quoi vérifier quand rien ne sort.
- [Rembourser une vente](https://docs.now-os.app/fr/pos/refunds.md): Rembourser tout ou partie d'une vente finalisée sur la caisse NowOS : articles ou montant libre, motif obligatoire, sortie de caisse automatique et ticket de remboursement.
- [Rapports sur la caisse](https://docs.now-os.app/fr/pos/reports.md): Ce que la caisse NowOS affiche pendant le service — résumé du jour, ventes récentes, réimpressions — et ce qui reste dans le backoffice.
- [Se connecter à la caisse](https://docs.now-os.app/fr/pos/sign-in.md): Déverrouillez la caisse avec votre code PIN, retrouvez votre carte dans l'équipe en service et changez d'utilisateur en cours de service.
- [Articles indisponibles (86)](https://docs.now-os.app/fr/pos/sold-out.md): Marquer un article ou une option « indisponible » depuis la caisse NowOS pour le retirer de la vente sur toutes les caisses en un instant, puis le remettre en vente.
- [Ouverture de journée](https://docs.now-os.app/fr/pos/start-of-day.md): Ouvrir la journée commerciale sur la caisse NowOS : saisir le fond de caisse, comprendre l'heure de bascule après minuit et la reprise automatique d'une journée oubliée.
- [Gérer le stock à la caisse](https://docs.now-os.app/fr/pos/stock.md): Réceptionner, ajuster et compter le stock d'un produit directement depuis la caisse NowOS, en mode boutique.
- [Tables et réservations](https://docs.now-os.app/fr/pos/tables.md): Le plan de salle sur la caisse : lire l'état des tables, placer les clients sans réservation et les réservations, et appliquer un prépaiement à l'encaissement.
- [Prendre une commande](https://docs.now-os.app/fr/pos/taking-orders.md): Parcourez le menu, ajoutez des articles, choisissez les modificateurs, basculez entre sur place et à emporter, puis envoyez en cuisine.
- [Le matériel nécessaire](https://docs.now-os.app/fr/setup/hardware.md): iPads, réseau Wi-Fi, imprimantes thermiques, tiroir-caisse : ce qu'il faut prévoir avant d'installer NowOS dans votre point de vente.
- [Associer vos appareils](https://docs.now-os.app/fr/setup/pairing.md): Désignez la caisse principale de votre magasin, puis associez chaque appareil secondaire — depuis le backoffice et directement sur les iPads.
- [Démarrage rapide](https://docs.now-os.app/fr/setup/quickstart.md): De la création de votre compte à votre première vente encaissée, en une seule session.

## OpenAPI Specs

- [openapi](https://docs.now-os.app/api-reference/openapi.json)