Intégration avec Neop

Neop gère l'accès physique à des espaces : portes, casiers, salles. Avec l'intégration, chaque réservation d'une ressource liée à un espace Neop crée une réservation dans Neop. Neop renvoie un code d'accès, que Dokos affiche à l'utilisateur dans le portail client.

Fonctionnement

      graph TD
    A[Utilisateur] -->|Réserve une ressource| B[Dokos]
    B -->|Crée la réservation| C[Neop]
    C -->|Renvoie un code d'accès| B
    B -->|Affiche le code| D[Portail client]
    A -->|Consulte sa réservation| D

    

1. Une réservation est créée, sur le portail ou par un gestionnaire dans le bureau.
2. Si sa ressource est liée à un espace Neop, et si son statut n'est ni Dans le panier ni Annulé, Dokos crée la réservation dans Neop en tâche de fond.
3. Dokos récupère le code d'accès et l'enregistre sur la réservation.
4. L'utilisateur ouvre sa réservation dans le portail client. Le Code d'accès Neop s'affiche si la réservation est Confirmé ou Non confirmé.

Quand vous modifiez les horaires d'une réservation, Dokos met à jour la réservation Neop. Quand vous passez une réservation au statut Annulé, Dokos supprime la réservation Neop.

Activer l'intégration

1. Demandez à Neop votre identifiant (PSEUDO) et votre mot de passe (PASSWORD) d'API.
2. Dans l'espace de travail Evènements & Ressources, ouvrez Paramètres d'intégration Neop.
3. Saisissez l'ID utilisateur et le Mot de passe.
4. Cochez Activé.
5. Enregistrez.

À l'enregistrement, Dokos vérifie la connexion à l'API Neop. Une erreur s'affiche si les identifiants sont faux. Dokos ajoute aussi un onglet Intégration Neop aux ressources réservables.

Lier une ressource à un espace Neop

1. Ouvrez la Ressource réservable.
2. Dans l'onglet Intégration Neop, sélectionnez l'espace dans le champ ID de zone Neop. La liste vient de votre compte Neop.
3. Enregistrez.

Les réservations de cette ressource reçoivent ensuite un code d'accès.

Synchronisation

Une tâche planifiée tourne toutes les heures, tant que l'intégration est activée. Elle :

1. supprime dans Neop les réservations annulées ;
2. récupère les codes d'accès manquants des réservations pas encore terminées ;
3. crée dans Neop les réservations qui n'y sont pas encore ;
4. met à jour les réservations modifiées depuis la dernière synchronisation.

Le champ Dernière synchronisation le des paramètres indique sa dernière exécution. Le bouton Synchroniser lance la tâche tout de suite. En cas d'erreur, Dokos crée un journal d'erreurs lié à la réservation, par exemple « Neop sync: could not create reservation ».

Exemple

Exemple fictif : un coworking lie la ressource « Salle Marco Polo » à l'espace Neop « Porte salle 1 ».

1. Un membre réserve la salle le 12 mars de 14 h à 16 h sur le portail et passe commande.
2. La réservation passe au statut Confirmé. Dokos crée la réservation dans Neop.
3. Le membre ouvre sa réservation dans le portail. Il lit son code d'accès et l'utilise le 12 mars pour ouvrir la porte.