Paiement en ligne and Gestion des activités: Difference between pages

From Documentation de la solution web de gestion OpenFlyers
(Difference between pages)
Jump to navigation Jump to search
 
 
Line 1: Line 1:
=Présentation=
=Présentation=
L'objet de cette page est de regrouper les informations sur le paiement en ligne et notamment la mise en place d'une terminal de paiement (TPE) virtuel.
L'objet de cette page est de présenter la '''gestion des activités''' sur la [[Accueil|version 4 d'OpenFlyers]].


==Modèle économique==
==Paramétrage des vols solos supervisés==
OpenFlyers a fait le choix de s'interfacer directement avec les TPE virtuels proposés par les banques. L'autre solution qu'il aurait été possible de mettre en place c'est de proposer un seul fournisseur de TPE. Côté OpenFlyers, cela aurait simplifier la maintenance. En effet, les banques ont tendance à changer leur technologie tous les 5 ans. Cela nécessite à chaque de reprendre intégralement le développement côté OpenFlyers. Aujourd'hui [[#Modules-de-paiement-reconnus-par-OpenFlyers|OpenFlyers s'interface avec près d'une dizaine de TPE]]. Cela fait autant de technologies à maintenir. Aussi, l'interfaçage avec un TPE est facturé en supplément de l'abonnement sauf pour l'abonnement Business+ où il est inclus. Ce supplément permet de financer la maintenance des interfaçages.
La réglementation aéronautique EASA, différencie les instructeurs en 2 catégories : les instructeurs restreints et non restreints. Les instructeurs sont restreints tant qu'ils ont effectués moins de 100 heures d'instruction. Pour le décompte de leurs heures d'instruction, il est possible de prendre en compte les heures solo, effectuées par leurs élèves, heures solos qu'ils ont supervisées. De plus, le rapport annuel de statistiques [[AERAL]] nécessite de faire remonter les heures solos supervisées par instructeur ainsi que par activité.


Si OpenFlyers avait imposé un fournisseur alors, le coût de l'interfaçage aurait été quasiment nul pour OpenFlyers et il n'y aurait pas de surcoût d'abonnement à supporter. Mais dans ce cas, étant donné que le TPE n'est pas fourni par la banque, la structure devrait demander à la banque un numéro contrat VAD permettant au fournisseur de communiquer avec la banque. Ce contrat VAD est facturé par la banque mensuellement et cela revidendrait nettement plus cher que l'option d'interfaçage côté OpenFlyers.
OpenFlyers déconseille de saisir les heures de solo supervisées en renseignant le nom de l'instructeur dans le champ '''Place droite''' ou '''Instructeur''' afin de ne pas créer d'effets de bords sur l'ensemble du logiciel.


==Principe de fonctionnement du couplage entre OpenFlyers et un TPE virtuel==
Lorsque une plateforme OpenFlyers est couplée à un terminal de paiement par internet fourni par une banque voici la chronologie de son utilisation :
#Un utilisateur autorisé, se connecte à OpenFlyers.
#Il va sur la page OpenFlyers lui permettant de [[Utilisation-de-la-comptabilité#Saisir-un-encaissement|saisir un encaissement]].
#Il sélectionne le type de paiement "carte bancaire en ligne" (l'intitulé est modifiable pour chaque plateforme)
#Il saisit le montant qu'il souhaite verser sur son compte client.
#Il valide le formulaire de saisie de l'approvisionnement et se retrouve dirigé sur l'interface du terminal de paiement électronique de la banque
#Là, il saisit ses coordonnées bancaires : elles ne sont donc pas transmises à OpenFlyers
#Si la transaction est acceptée par la banque, le serveur OpenFlyers hébergeant la plateforme est automatiquement informé
#Le compte de l'utilisateur est crédité du montant correspondant et la contre-partie va sur le compte de trésorerie correspondant à ce mode de paiement. Cette écriture est automatiquement validée car elle a été sécurisée.
Il n'y a donc rien à faire côté gestion.
Sur le compte de trésorerie, le mouvement apparait comme pour les autres mouvements qui correspondent à des encaissements :
*Dans la colonne '''Compte affecté''' est indiqué le nom du compte de contre-partie, c'est à dire le compte de l'utilisateur avec son nom et prénom.
*Dans la colonne '''Commentaire''' apparait le type de paiement, par exemple "carte bancaire en ligne".


Les avantages d'un TPE virtuel sur un TPE physique sont les suivants :
OpenFlyers recommande de paramétrer le suivi des heures solos supervisées de la façon suivante :
*Un utilisateur peut approvisionner son compte depuis n'importe où, à partir du moment où il a une connexion internet. Avec un TPE physique il est obligé de se déplacer là où il y a le TPE pour effectuer son approvisionnement. Le TPE virtuel permet de rendre acceptable des restrictions liées au solde du compte. Ainsi, il est tout à fait acceptable pour un utilisateur de se retrouver bloqué pour pouvoir réserver par manque d'argent sur son solde si parallèlement il a la possibilité d'approvisionner son solde.
*Cela supprime une tâche de pointage pour le gestionnaire.


Les inconvénients d'un TPE virtuel sur un TPE physique sont les suivants :
*Il y a un surcoût d'abonnement côté OpenFlyers de 120 € HT/an sauf dans le cas de l'abonnement Business+ où il est inclus dans l'abonnement.


Il n'y a pas de différence entre un TPE virtuel et un TPE physique pour les éléments suivants :
;Créer un type d'activité ''Solo supervisé''
*Les coûts bancaires : ils sont normalement identiques par rapport à un TPE physique.
*'''Admin > Types d'activités > Types d'activités > Actifs'''
*Les paiements extérieurs : il est possible pour les clients concernés de saisir directement leur numéro de carte bancaire dans le TPE virtuel. Il faut simplement qu'un gestionnaire se connecte à OpenFlyers et ensuite affiche l'interface de saisie des encaissements en précisant "non-utilisateur" puis le nom du client OpenFlyers, qui peut être générique et le montant. Après redirection vers le TPE virtuel, il faut laisser le client saisir le numéor de sa carte bancaire avec les éléments associés.
En bas du tableau '''Liste des types d'activités''', sur la dernière ligne qui doit être vide :
*Champ '''Nom''', indiquer ''Solo supervisé''
*Champ '''Couleur''', sélectionner une couleur, de préférence proche de la couleur pour l'instruction
*Cliquer sur le bouton avec un pictogramme symbolisant le signe plus
*Aller à nouveau dans '''Admin > Types d'activités > Types d'activités > Actifs''' pour mettre à jour les autres tableaux
Dans le tableau '''Types d'activités incompatibles''', rendre incompatible le type d'activité ''Solo supervisé'' avec les autres types d'activités qui doivent être incompatible, notamment ''Instruction'', ''Baptême'', ''Maintenance'', ''Vol découverte'', etc.


==Sécurité des données bancaires et double authentification 3-D secure==
OpenFlyers ne reçoit, et à fortiori, ne stocke aucune donnée bancaire. Par donnée bancaire, il faut entendre les éléments liés à la carte bancaire d'un utilisateur. En effet, chaque utilisateur qui effectue un paiement par carte bancaire en ligne depuis OpenFlyers, est redirigé sur le TPE de la banque de la structure. Les données bancaires sont donc stockées auprès de la solution TPE souscrite auprès de la banque par la structure. Cela permet de garantir le niveau le plus élevé de sécurisation des transactions.


Chaque banque propose ou impose une double authentification dite [[Wikipedia-fr:3-D_Secure|3-D secure]]. Il s'agit du fait que l'utilisateur qui insère les éléments de sa carte bancaire devra ensuite confirmer qu'il s'agit bien de lui en renseignant un code reçu par exemple par SMS.
;Créer un champ métier "Instructeur superviseur" pour le formulaire de saisie d'activité afin de pouvoir noter le nom de l'instructeur pour les vols solos des élèves
*'''Admin > Structure > Variables > Champs métiers'''
Tout en bas sur la dernière ligne qui doit être vide :
*Champ '''Nom de variable''', indiquer ''supervisor''
*Champ '''Intitulé''', indiquer ''Instructeur superviseur''
*Champ '''Catégorie''', indiquer ''Activité''
*Champ '''Type de valeur''', indiquer ''dbObject::Person(Instructeur)''
*Cliquer sur le bouton '''Ajouter'''
*Mettre à jour le paramétrage [[AERAL#Activité-correspondant-à-Solo-supervisé|Activité correspondant à Solo supervisé]] pour AERAL :
*'''Admin > Structure > Paramétrage > Export Aeral'''
Formulaire '''Activité correspondant à Solo supervisé''' :
*Champ '''Solo supervisé''', indiquer '''Solo supervisé'''
*Désactiver l'interrupteur '''instructeur en place droite'''
*Champ '''Champ métier correspondant au superviseur''', indiquer ''Instructeur superviseur''
*Cliquer sur le bouton '''Enregistrer''' en haut ou en bas à droite de la page


La double authentification a pour objectif d'empêcher une utilisation frauduleuse des éléments d'une carte bancaire qui auraient été dérobés. Cela protège le vendeur contre le risque de livrer un produit pour lequel il aurait à faire face à un impayé. En effet, si le propriétaire de la carte bancaire fait opposition, l'argent que devait recevoir le vendeur peut lui être retiré. Si le produit est déjà livré, c'est trop tard.


Dans le cadre des structures aéronautiques, le risque d'impayé lié à un vol de carte bancaire est très faible. En effet :
;Ensuite, pour chaque vol solo supervisé, il faut dans le formulaire de saisie d'activité
*le produit fourni est immatériel (il s'agit en général d'effectuer des heures de vol) et la livraison est décalée dans le temps. De ce fait, la probabilité pour un voleur d'obtenir la livraison des heures de vols avant qu'il y ait une opposition est très faible
*Cocher le type d'activité ''Solo supervisé''
*le cercle des clients est souvent fermé (les membres d'une structure par exemple) et ils sont rencontrés physiquement. Là encore, il serait présomptueux pour un voleur d'utiliser une carte bancaire dérobée pour payer ses heures de vols.
*Renseigner le nom de l'instructeur dans le champ ''Instructeur superviseur''


Néanmoins, la double authentification a un aspect psychologique : elle peut rassurer certains utilisateurs finaux qui auront le sentiment d'être dans un environnement rassurant si lorsqu'ils font un paiement par carte bancaire, ils doivent confirmer ses éléments insérés par l'utilisation d'un code de confirmation.


A l'inverse, elle peut freiner certains utilisateurs qui ne sauront pas récupérer l'élément de confirmation ou ne comprendront pas ce qu'ils doivent renseigner.
;Mettre en place une validité "Élève autorisé solo"
Dans le cas où la structure met en place des restrictions sur les réservations ou la saisie des vols, un élève en solo supervisé, n'ayant donc pas les validités d'un pilote breveté, peut se retrouver bloqué. Pour contourner ces restrictions, il est recommandé de créer un type de validité "Élève autorisé solo" et de lui permettre de contourner les exigences des autres validités non détenues par un élève.
*'''Admin > Utilisateurs > Types de validités'''
*Cliquer sur le bouton '''Ajouter un type de validités'''
*Champ '''Nom''', indiquer ''Élève autorisé solo''
*Cliquer sur la case à cocher '''Soumise à échéance'''
*Champs '''Profils autorisés à gérer pour eux-mêmes''' et '''Profils autorisés à gérer/certifier pour les autres''', cocher les profils ''admin'', ''gestionnaire'' (ou équivalents) et ''instructeur''
*Cliquer sur le bouton '''Enregistrer"
*'''Admin > Types de ressource'''
Pour chaque type de ressource :
*Cliquer sur le bouton '''Validité'''
*Pour chaque ligne de validité qui exige une validité qu'un élève n'a pas l'obligation de détenir, cocher le type de validité ''Élève autorisé solo''


Il appartient donc à chaque structure, si sa solution TPE qui lui est proposée lui permet de choisir ou non l'activation de 3-D secure, de peser les avantages et inconvénients. Voir la [[Wikipedia-fr:3-D_Secure|page Wikipedia 3-D secure]] pour plus de renseignements.
=Afficher la vue d'ensemble des activités selon les ressources=
*Naviguer vers la section '''Gestion > Activités > Activités > Liste'''.


=Modules de paiement reconnus par OpenFlyers=
Une synthèse sous forme de tableau des activités '''actives''' et '''physiques''', s'affiche automatiquement :
OpenFlyers a développé des interfaçages avec les modules de paiement des différentes banques françaises.
*les ressources actives y figurent toujours.
*les ressources désactivées ou celles pour lesquelles l'interrupteur '''Saisie d'activité''' (accessible via '''Gestion > Ressources > Actives''') est décoché réapparaissent dès qu'elles possèdent au moins une activité non validée.


'''4 points d'attention''' :
Ainsi, aucune action supplémentaire n'est nécessaire pour retrouver les ressources portant encore des validations à effectuer.
*Pour certaines banques, il existe plusieurs modules de paiement possibles : cela peut dépendre de la région géographique ou d'une évolution au niveau de la banque qui lui fait abandonner un ancien système au profit d'un plus récent.
*OpenFlyers s'interface '''UNIQUEMENT''' avec les modules de paiement des banques et en aucun cas directement avec les modules de paiement qui peuvent être proposés par des sociétés tierces spécialisées dans le paiement en ligne (PayPal, PayBox, Ogone, Bluepaid). Cela évite à nos clients d'avoir à souscrire un contrat au près d'un fournisseur supplémentaire : ils souscrivent un contrat uniquement auprès de leur banque. Par contre, pour les banques dont l'intermédiaire est une société tierce, OpenFlyers s'nterface avec la solution. C'est le cas, par exemple, pour PayBox.
*Bien vérifier les numéros de version avant de souscrire à une solution. Derrière un numéro de version "commercial" peut se cacher un changement de prestataire ou de technologie utilisée pour l'interfaçage. De ce fait, cela peut rendre incompatible telle version avec OpenFlyers.
*Ne surtout pas souscrire à un contrat de "VAD (vente à distance) sur internet". Car il n'inclut pas l'interface web dite de "TPE virtuel".


Modules de paiement interfacés par OpenFlyers :
=Alertes=
*AXEPTA utilisé par les banques suivantes :
==[[Gestion-armoire-à-clés#Alertes-lors-de-la-saisie-d'une-activité|Alertes générées par le contrôle d'accès]]==
**BNP Paribas
*CLIC&PAY :
**Crédit du Nord
*CMCIC version 1.2open et version 3.5 (nom commercial : [https://www.monetico-paiement.fr/fr/accueil.html Monetico Paiement]) utilisés par les banques suivantes :
**Crédit Mutuel
**CIC
*PAYBOX utilisé par les banques suivantes :
**Crédit Agricole (Up2pay e-transactions). ''A noter que la [[#Procédure_Paybox_Vision|procédure de mise en place "Paybox Vision"]] est lourde et impose des actions de la part du gestionnaire de la structure. De plus, elle nécessite de disposer d'une adresse qui ne soit pas en @free.fr ou @orange.fr.''
**Crédit Coopératif
*PAYLINE utilisé par les banques suivantes :
**Crédit Mutuel (citélis)
*PAYZEN utilisé par les banques suivantes :
**La Banque Postale (Scellius)
**La Société Générale (sogecommerce)
*SIPS ATOS v. 2 utilisé par les banques suivantes :
**<s>BNP Paribas (mercanet v.2)</s> (doit être arrêté fin 2023 et remplacé par AXEPTA)
**LCL (sherlocks v.2)
**Société Générale (sogenactif v. 2)
*SYSTEMPAY utilisé par les banques suivantes :
**Banque de Savoie
**Banque Populaire (cyberplus paiement)
**Caisse d'Epargne


=Procédure=
==[[Facturation-des-clients#Alertes-générées-par-le-moteur-de-facturation|Alertes générées par le moteur de facturation]]==
==Mettre en place un TPE virtuel==
Voici comment procéder pour créer un TPE virtuel (Terminal de Paiement Electronique en ligne) :
#Contacter votre banque pour :
#*connaitre le module de paiement qu'elle propose et nous l'indiquer afin de vérifier qu'[[#Liste-des-modules-de-paiement-reconnus-par-OpenFlyers|OpenFlyers est bien compatible]]. Il faut aussi nous indiquer le nom de la banque.
#*obtenir son accord de principe sur la mise en place d'un TPE virtuel (normalement cela ne devrait pas poser de problème)
#Nous envoyer un e-mail en nous indiquant le système utilisé par votre banque. Trois cas peuvent se présenter :
#*nous avons déjà fait un interfaçage avec la solution utilisée par votre banque. Dans ce cas, la mise en place peut être très rapide.
#*nous n'avons pas encore fait d'interfaçage mais plusieurs clients d'OF sont intéressés et nous sommes en mesure de le réaliser pour un coût raisonnable. Dans ce cas, le délai peut être de quelques mois ou plus rapide si vous prenez en charge le coût de réalisation.
#*nous n'avons pas fait d'interfaçage et cette solution est très spécifique. Dans ce cas, nous ne ferons un interfaçage que si vous acceptez de supporter les coûts de développement.
#Une fois que nous vous avons répondu positivement, il vous appartient de nous confirmer votre demande de mise en place
#Nous éditons la facture correspondant aux frais de maintenance annuels (voir notre [http://www.openflyers.com/doc/catalogue-tarifaire.pdf catalogue tarifaire]) et nous vous communiquons les informations nécessaires à votre banque '''qui dépendent du système utilisé par la banque'''. Voici les informations génériques pour toutes les banques :
#*Nom du commerçant ou raison sociale du commerçant : mettre le nom de votre structure
#*Nom de la boutique, du site de e-commerce, intitulé de l'enseigne commerciale : mettre le nom de votre structure
#*Type de site web marchand : indiquer qu'il s'agit d'une solution générique développée l'éditeur logiciel OpenFlyers
#*Nom du client ou nom du propriétaire du TPE : mettre le nom de votre structure
#*Nom du représentant : mettre le nom d'une personne agissant en qualité de représentant de la structure
#*Adresse email du représentant : '''Attention''' pour l'adresse qui recevra le couple identifiant/mot de passe d'accès à la gestion du TPE mettre impérativement une adresse email pérenne de la structure et '''surtout pas''' une adresse email OpenFlyers.
#*Adresse du site internet, adresse du site marchand : il s'agit de l'adresse de votre plateforme OpenFlyers par exemple https://openflyers.com/demo-fr/
#*Éditeur du site internet, nom de l'hébergeur : S.A.R.L. OPENFLYERS. Les mentions légales (adresse, numéro SIRET, etc.) figurent sur nos factures.
#*Nom et prénom de la personne en charge du site ou interlocuteur technique : Indiquer le nom de votre contact OpenFlyers.
#*Adresse de l'hébergeur : mettre l'adresse courrier d'OpenFlyers indiqué sur nos factures.
#*Adresse e-mail de l'hébergeur : mettre l'adresse e-mail de votre interlocuteur chez OpenFlyers.
#*Numéro de téléphone de l'hébergeur : laisser vide ou mettre le numéro 0892.494.123.
#*Système d'exploitation : Linux 64 bits
#*Environnement de développement : PHP
#*Interlocuteur technique : Mettre le nom de votre interlocuteur chez OpenFlyers.
#*Interlocuteur Administratif ou administrateur web pour l'accès au back-office : il s'agit du back-office de la banque. Il faut indiquer le nom de la personne dans votre structure qui sera en charge d'aller consulter. En général il s'agit de la même personne que celle qui fait office d'administrateur OpenFlyers. Cela peut être aussi une personne en charge de la comptabilité. Mais dans ce cas, il faut qu'elle est aussi des notions en informatique.
#:'''Attention''' : dans le cas d'un [[#Liste_des_systèmes_implémentés_par_OpenFlyers|TPE SIPS ATOS]] il faut préciser dans le formulaire que l'exécutable devant contenir la clé de décryptage doit être compilée pour Windows 64 bits.
#Vous payez la facture
#Vous nous communiquez les éléments de votre banque nous permettant de raccorder OpenFlyers à votre TPE virtuel en suivant la [[#Procédures_TPE|procédure TPE]] correspondante à votre type de TPE.
#:'''Attention''' : dans le cas où la banque vous fait parvenir par courrier des documents, conservez-les. Ne transmettez à OpenFlyers que les certificats finaux que vous aurez récupéré directement soit depuis une interface web de la banque soit depuis un programme à installer sur le PC.
#Nous effectuons le raccordement
#Nous testons et quand c'est positif nous vous envoyons un e-mail. Charge à vous, lorsque c'est demandé par votre banque, de renseigner le PV de test.


'''Notre prestation ne prévoit pas d'intervention auprès de la banque et nous ne pouvons agir en tant qu'intermédiaire. En effet, la mise du TPE nécessite de la part de la structure la souscription d'un contrat auprès de sa banque : nous ne pouvons signer les papiers contractuels à la place de la structure ni s'engager en son nom. De plus, il est indispensable que la structure soit destinatrice de l'ensemble des documents envoyés par la banque et qu'ensuite elle nous remette uniquement ce qui nous est nécessaire et que nous demandons en fonction du TPE à mettre en place.'''
==[[Validités#Alertes-lors-d'une-réservation-ou-une-saisie-d'activité|Alertes générées sur les validités]]==


Certaines banques vérifient la présence des mentions légales lors de la demande de mise en place du TPE. Ces mentions légales doivent être présentes sur le site vitrine de la structure. La plateforme OpenFlyers doit être considérée comme une sous-partie privative de ce site et n'a donc pas vocation à accueillir les mentions légales.
==L'aéronef est déjà en l'air==
Si en tentant d'ouvrir le vol d'un aéronef, apparait une alerte rouge '''L'aéronef est déjà en l'air''' cela veut dire qu'un vol a déjà ouvert avec cet aéronef. S'il s'agit d'un vol qui n'a pas été fermé et qui doit être supprimé, il faut [[#Annuler-un-vol-ouvert|annuler le vol ouvert]].


==Mettre en place un TPE CAWL==
==La différence entre le temps de vol calculé et le temps de vol saisi est de : X:XX heure(s)==
;Configuration côté back-office CAWL
Cette alerte est suivie du message :
::;Connecter au back-office CAWL
<pre>Veuillez contacter votre administrateur à propos de l'incompatibilité entre votre saisie et la formule du temps de vol choisie pour le type d'aéronef : X</pre>
::*Aller sur le [https://portail.preprod.cawl-solutions.fr Merchant Portal]
::*Saisir votre '''Adresse email''' et '''Mot de passe'''
::*Cliquer sur le bouton '''Connexion'''
::*Connecter avec votre application d'authentification : Authy, Google authenticator ou Microsoft authenticator
::*Saisir la '''Mot de passe à usage unique'''
::*Cliquer sur le bouton '''Connexion'''


Cette alerte apparait lorsque la valeur saisie du temps d'activité est incompatible avec la valeur calculée par la [[Formules-de-calcul#Temps-d'activité|formule de calcul du temps d'activité]] définie pour la ressource X.


::;Récupérer le Merchant Id '''PSPID'''
En général elle provient du fait que le temps de vol qui avait été calculé automatiquement dans le formulaire lors de la saisie des champs de compteurs départ/arrivée et/ou des heures de départ/arrivée ont été modifiés manuellement.
::*Aller à '''Développeur > API de paiement'''
::*Le '''PSPID''' est affiché en haut à droite de l'écran


Lorsqu'une telle erreur apparait, vous devez :
*Essayer de reprendre la saisie et essayer de comprendre pourquoi vous saisissez mal les valeurs dans les champs concernés
*Si vous n'arrivez pas à comprendre la raison, contacter sans délai un gestionnaire de votre structure afin qu'il vous explique les erreurs que vous commettez lorsque le problème vient d'une saisie erronée ou qu'il analyser lui-même le problème.
*Si vous êtes vous-même un gestionnaire de la plateforme, vous devez également pousser l'analyse pour comprendre en quoi votre saisie est incompatible avec la formule de calcul et le cas échéant faire effectuer une modification du paramétrage.


::;Configurer les Clés API
Voir également, comment [[#Forcer-la-saisie-d'une-durée-d'activité-incompatible-avec-sa-formule-de-calcul|Forcer la saisie d'une durée d'activité incompatible avec sa formule de calcul]].
::*Aller à '''Développeur > API de paiement'''
::*Si aucune configuration n'existe, l'écran affichera Aucune clé générée
::*Cliquer sur Ajouter une clé API
::*L'écran affiche maintenant les deux codes dans le tableau respectivement sur les lignes Identifiant de '''la clé API / La clé secret API'''
::::NB: La clé secrète API ne sera affichée qu'une seule fois, assurez-vous de la copier dans un endroit sûr.


==Le pilote X est déjà en l'air==
Ce message apparait lorsque vous tentez de saisir un vol en ouverture de vol et que le pilote occupant la position X est déjà enregistré sur un vol ouvert, c'est à dire en l'air.


::;Configurer les clés de Webhook
Cette protection permet de ne pas avoir un utilisateur occupé simultanément sur 2 ressources.
::*Aller à '''Développeur > Webhooks'''
::*Si aucune configuration n'existe, l'écran affichera Aucune clé générée
::*Cliquer sur Créer des clés de webhook
::*L'écran affiche maintenant les deux codes dans le tableau respectivement sur les lignes Identifiant du webhook / Clé secret du webhook
::::NB: La clé secrète Webhook ne sera affichée qu'une seule fois, assurez-vous de la copier dans un endroit sûr.


S'il s'agit d'un vol qui n'a pas été fermé et qui doit être supprimé, il faut [[#Annuler-un-vol-ouvert|annuler le vol ouvert]].


::;Définir le point de terminaison des Webhooks
==Seul le type de vol requis dans le cas de la présence d'un second pilote a été sélectionné, vous devez en sélectionner au moins un autre en plus==
::*Aller à '''Développeur > Webhooks'''
Lors de la saisie d'un vol, cette alerte s'affiche si la configuration de la plateforme nécessite la saisie d'au moins un type de vol supplémentaire en plus du type de vol obligatoire dans le cas de la présence d'un second pilote.
::*Cliquer sur Ajouter un point de terminaison de webhook
::*Entrer l'URL de votre point de terminaison recevant les webhooks sur votre serveur dans la boîte de dialogue par exemple https://openflyers.com/OF_Plateforme_Name
::*Cliquer sur '''Confirmer'''


C'est typiquement le cas pour les vols d'instruction où le paramétrage nécessite généralement de préciser un 2ème type de vol comme "local", "navigation", etc.


::;Nous transmettre par e-mail les éléments suivants (les clés API / Secret ainsi que le PSPID), en précisant si vous les avez obtenus depuis l'interface de production ou depuis l'interface de test.
==Vous êtes actuellement en l'air==
Si en tentant de saisir un vol, l'alerte '''Vous êtes actuellement en l'air''' apparait cela veut dire qu'il y a déjà un vol d'ouvert à votre nom. S'il s'agit d'un vol qui n'a pas été fermé et qui doit être supprimé, il faut [[#Annuler-un-vol-ouvert|annuler le vol ouvert]].


==Vous ne pouvez ouvrir un vol avec une date de début dépassée==
Cette protection empêche d'ouvrir une activité avec un horodatage de début antérieur à l'heure actuelle moins 15 minutes.


;Configuration côté OpenFlyers
En général, pour un tel cas, le souhait n'est pas d'ouvrir une activité mais de fermer une activité. Il faut donc penser à passer le champ '''Etat du vol''' en "Retour de vol".
Cet étape doit être réalisée après confirmation par OpenFlyers que la configuration de la base de données a été effectuée.


::;Prérequis
=Annuler une activité validée=
::*La structure doit avoir payé l'abonnement pour un TPE en ligne sur l'espace client OpenFlyers
Contrairement à la [[#Supprimer-une-activité|suppression des activités non validées]] et du fait de l'[[Comptabilité#Inaltérabilité-des-données|inaltérabilité des données]], il n'est pas possible de supprimer physiquement une activité après [[#Valider-une-activité|sa validation]]. Par contre, la fonction d'annulation de la saisie d'une activité permet d'en annuler son effet.
::*L'administrateur doit disposer des droits :
::**[[Gestion-des-profils#Gestion-des-comptes|Gestion des comptes]]
::**[[Gestion-des-profils#Gestion-des-types-d'encaissements|Gestion des types d'encaissements]]
::**[[Gestion-des-profils#Saisir-les-encaissements-pour-les-tiers|Saisir les encaissements pour les tiers]]


'''C'est cette fonction qu'il faut utiliser dans le cas où une activité validée doit être corrigée. L'utilisateur assurant la gestion :'''
#'''Annule l'activité validée qui n'a pas été saisie correctement'''
#'''Saisie une nouvelle activité avec les bonnes données'''


::;Mettre en place un compte de remise
::*Aller dans '''Gestion > Comptes > Comptes > Trésorerie'''
::Sur la dernière ligne du bas du tableau :
::*Colonne '''Nom''' : saisir ''Compte remise CB CAWL''
::*Colonne '''Compte d'export''' : saisir un numéro de compte de racine 582 correspondant au premier numéro disponible. Ainsi, s'il n'y a pas déjà de compte de racine 582, saisir 582001.
::*Cliquer sur le bouton symbolisant le signe "+" dans la colonne Action


La fonction d'annulation d'activité génère les enregistrements suivants en base de données :
#Création d'une même activité que l'activité à annuler mais avec une durée opposée. Cela permet de garantir que les totaux d'heures d'activités sont correctement corrigés. De plus, le champ commentaire contient une référence à l'activité ciblée par l'annulation.
#Création des écritures comptables associées correspondant à l'identique à celles de l'activité à annuler mais de sens opposé (débit au lieu de crédit et vice versa).
Ces enregistrements sont générées à la date du jour et sont automatiquement validés. Cela permet de garantir la traçabilité des opérations.


::;Créer le type de paiement
'''Attention''' : il est possible d'annuler plusieurs fois une même activité.
::*Aller dans '''Admin > Comptes > Encaissements > Types'''
::*Cliquer sur le bouton '''Ajouter''' en haut à droite du tableau
::*Champ '''Nom''' : saisir ''Paiement en ligne CAWL''
::*Cocher l'interrupteur '''Accessible uniquement aux personnes autorisées à saisir pour les tiers'''
::*Champ '''Compte de trésorerie affecté''' : sélectionner '''Compte remise CB CAWL'''
::*Champ '''Prestataire paiement en ligne''' : sélectionner l'option '''Cawl(x)'''
::*Cliquer sur le bouton '''Enregistrer'''




::;Tester le paiement en ligne
Pour utiliser cette fonction :
::*Aller dans '''Planning > Comptes > Actions > Approvisionner'''
* [[Gestion-des-activités#Afficher-la-vue-d'ensemble-des-activités-selon-les-ressources|Afficher la vue d'ensemble des activités selon les ressources]].
::*Champ '''Encaissement de l'utilisateur''' : saisir son propre nom
* Dans la colonne '''Annuler une activité validée''', cliquer sur l’icône rouge symbolisant une flèche qui fait demi-tour
::*Champ '''Type de règlement''' : sélectionner '''Paiement en ligne CAWL'''
* Une page listant les activités validées apparait :
::*Champ '''Montant''' : saisir un '''montant cohérent qui sera réellement débité''' de sa carte bancaire
** Dans la colonne '''Annuler''', sélectionner l'activité à annuler
::*Cliquer sur le bouton '''Enregistrer'''
** Cliquer sur le bouton '''Annuler l'activité sélectionnée (cette action est irréversible)'''
::L'utilisateur est redirigé vers l'interface CAWL pour sélectionner son mode de paiement
::*Choisir le mode de paiement
::*Cliquer sur le bouton '''Procéder aux détails de paiement'''
::*Rensigner les élements suivantes:
::**Numéro de la carte
::**Titulaire de la carte
::**Date d'expiration
::**Code de vérification de la carte
::*Cliquer sur le bouton '''Payer de façon sécurisée'''
::Une fois la validation du paiement effectuée, l'utilisateur est automatiquement redirigé vers la page de son compte dans OpenFlyers :
::*Vérifier qu'une nouvelle ligne d'encaissement à la date du jour a été générée dont le montant correspond à celui préalablement saisi dans OpenFlyers


=Annuler un vol ouvert=
*Aller sur le planning
*Cliquer sur le rectangle sur fond bleu correspondant à l'immatriculation de l'aéronef considéré
*Cliquer sur le bouton '''Annuler le vol''' tout en bas du formulaire.


::;Permettre à tous les utilisateurs d'utiliser ce type d'encaissement
=Lister les activités=
::*Aller dans '''Admin > Comptes > Encaissements > Types'''
La liste des activités est accessible depuis:
::*Cliquer sur le bouton symbolisant un crayon à droite de la ligne du type d'encaissement '''Paiement en ligne CAWL'''
* [[Gestion-des-activités#Afficher-la-vue-d'ensemble-des-activités-selon-les-ressources|Afficher la vue d'ensemble des activités selon les ressources]].
::*Décocher l'interrupteur '''Accessible uniquement aux personnes autorisées à saisir pour les tiers'''
* Cliquer sur l'icône correspondant à la colonne '''Valider les activités sélectionnées'''.
::*Cliquer sur le bouton '''Enregistrer'''
* Ou bien Cliquer sur l'icône correspondant à la colonne '''Vérifier la succession des activités'''.
** la page de Contrôle des compteurs de la resource a apparu.
** Entrer Le compteur de départ, puis Sélectionner la date de début et de fin de l'intervale que vous voulez visualiser.
** Cliquer sur le bouton '''Visualiser'''.


==Mettre en place un TPE CMCICv3==
La liste des activités synthétise les informations les plus importantes pour l'ensemble des activités dans un intervalle de temps:
*Aller sur [https://www.cmcicpaiement.fr/fr/identification/default.cgi l'interface d'administration]
*Dans le champ '''Identifiant''' saisir l'identifiant communiqué par e-mail par la banque
*Dans le champ '''Mot de passe''' saisir le mot de passe communiqué par e-mail par la banque
*Cliquer sur le bouton '''VALIDER'''
Une fois connecté, vous êtes soit sur l'interface back-office de production soit sur l'interface back-office de test. L'interface back-office de test est reconnaissable aux mots "test" qui apparaissent un peu partout dans le bandeau supérieur de l'interface.
*Si l'interface indique ''Votre identifiant n'est associé à aucun TPE sur l'environnement de XXX'', basculer sur l'autre interface en cliquant à droite dans la boite '''Environnement''' sur le lien '''Cliquez ici pour basculer vers le Tableau de Bord de XXX.'''
*Cliquer sur le menu '''Paramétrage'''.
*Cliquer sur le sous-menu '''Clé de sécurité'''.
*Sélectionner l'e-mail sur lequel vous souhaitez recevoir le ''code de téléchargement''.
*Cliquer sur le bouton '''VALIDER'''.
'''Attention : ''' Ne pas fermer la page '''Obtention de la clé de sécurité''' permettant de récupérer la clé
*Copier depuis sa messagerie e-mail le '''Code de confirmation'''
*Coller ce code dans l'interface '''Obtention de la clé de sécurité'''
*Cliquer sur le bouton '''VALIDER'''
*Cliquer sur le lien '''Télécharger la clé de sécurité'''
*Enregistrer le fichier XXXXXXX.key
*Nous transmettre par e-mail ce fichier en nous précisant si vous l'avez obtenu depuis l'interface de production ou depuis l'interface de test.


==Mettre en place un TPE HelloAsso Checkout==
* '''Pointer''': contient les deux icônes '''tout cocher''' et '''tout décocher''', aussi les cases à cocher de chaque ligne,  en cochant la case puis en Cliquant sur le bouton '''Pointer les activités sélectionnées (attention cette action est irréversible)''' vous pouvez valider l'activité.
;Prérequis
* '''Date''': date et heure de départ de vol, elle est affichée en fonction des [[Configuration#Patron-de-format-de-date|patrons de format de date]], affichée en rouge lorsque la date est dans le futur ( demain ou plus tard) ou bien lorsque la date de début de l'activité précédente chevauche une activité existante, c'est-à-dire  la date de début de l'activité précédente + sa durée dépasse la date de début de l'activité actuelle. Un interrupteur Date en '''UTC''' permet d'afficher sous la date locale une ligne orange indiquant l'heure '''UTC''' si la conversion reste le même jour, ou la date complète en '''UTC''' lorsque la conversion recule sur la veille.
*La structure doit avoir payé l'abonnement pour un TPE en ligne sur l'espace client OpenFlyers
* le champ place_tag qui permet d'étiqueter le numéro de place '''0''' (par exemple: place droite, pilote, Elève, Ouvert): la personne attribué au position 0,  affichée en rouge lorsque l'activité n'avait pas de pilote.
*L'administrateur doit disposer des droits :
* le champ place_tag qui permet d'étiqueter le numéro de place '''1''' s'il existe (par exemple: place gauche, instructeur, Adhérent): la personne attribué au position 1.
**[[Gestion-des-profils#Gestion-des-comptes|Gestion des comptes]]
* '''Activités''' : les types d'activités sélectionnés pour l'activité (par exemple: Voltige, Instruction, Vol technique, ...).
**[[Gestion-des-profils#Gestion-des-types-d'encaissements|Gestion des types d'encaissements]]
* '''Durée''' : la durée de l'activité, elle est affichée en fonction des [[Configuration#Patron-de-format-d'heure|patrons de format d'heure]], en vert pour les activités non validées et en noir gras pour les  activités validées.
**[[Gestion-des-profils#Saisir-les-encaissements-pour-les-tiers|Saisir les encaissements pour les tiers]]
* '''Départ''' : Terrain de départ affiché en rouge lorsque l'activité n'avait pas de terrain de départ.
* '''Arrivée''': Terrain d'arrivée affiché en rouge lorsque l'activité n'avait pas de terrain d'arrivée.
* '''Att.''' : Nombre d'atterrissages.
* '''Ajouts réservoirs''': Réapprovisionnement de réservoir avant/après vol, ils sont affichées sous format suivante " quantité + Unité (Type de éservoir)".
* les éventuelles colonnes correspondant aux champs métiers de type "Activité".
* '''Compteurs''': affichés en deux manières ( compteur hexadécimal : HH:MM , compteur décimal: HH,CC ).
** '''Départ''' : Le compteur de départ, affiché en rouge si le compteur de départ de l'activité actuelle inférieur au compteur d'arrivée de l'activité précédente ou bien si '''(''' le compteur de départ de l'activité actuelle '''-''' le compteur d'arrivée de l'activité précédente '''-''' la tolérance ''') > 1'''.
** '''Arrivée''' : Le compteur d'arrivée.
** '''Diff.''' : la difference entre les compteurs. affiché en rouge si le compteur de départ de l'activité actuelle dépasse le compteur d'arrivée de l'activité actuelle ou bien si '''(''' le compteur d'arrivée de l'activité actuelle '''-''' le compteur de départ de l'activité actuelle '''-''' la tolérance ''') > 1'''.
* '''Actions''': L'utilisateur peut effectuer sur une activité les actions suivantes:
** Modifier : L'utilisateur peut modifier une activité s'il a des autoristations pour gérer ses activités et qu'il est l'instructeur de l'activité ou bien s'il peut gérer les activités des autres utilisteurs. ET si l'activité n'est pas validée.
** Supprimer : L'utilisateur peut supprimer une activité s'il a des autoristations pour gérer ses activités et qu'il est l'instructeur de l'activité ou bien s'il peut gérer les activités des autres utilisteurs. ET si l'activité n'est pas validée.
** Ajouter : L'utilisateur peut ajouter une activité s'il a des autoristations pour gérer ses activités et qu'il est l'instructeur de l'activité ou bien s'il peut gérer les activités des autres utilisteurs. ET si '''(''' le compteur de départ de l'activité actuelle '''-''' le compteur d'arrivée de l'activité précédente '''-''' la tolérance ''') > 1'''.
** Afficher la trace de vol: L'utilisateur peut afficher la trace de vol s'il est sur le vol ou s'il a le droit de voir les traces de vol.


=Mettre à jour les entrées comptables associées à des activités non validées=
Dans le cas où, suite à une saisie d'activité, des changements de facturations ont été fait, il est nécessaire de mettre à jour les entrées comptables associées à celle-ci.
La mise à jour ne peut se faire que sur les activités non validées ayant au moins un utilisateur et étant associées à une ressource active.


;Mettre en place un compte de remise
Procédure pour mettre à jour les écritures comptables d'une ou plusieurs activités :
*Aller dans '''Gestion > Comptes > Comptes > Trésorerie'''
*[[Gestion-des-activités#Afficher-la-vue-d'ensemble-des-activités-selon-les-ressources|Afficher la vue d'ensemble des activités selon les ressources]].
Sur la dernière ligne du bas du tableau :
*Cliquer sur l'icône correspondant à la ligne de la ressource et de la colonne '''Mettre à jour les entrées comptables des activités non validées'''. Si l'icône est grisée alors il n'y a aucune activité non validée.
*Colonne '''Nom''' : saisir ''Compte remise CB HelloAsso''
*Sélectionner les lignes d'activités dont il est nécessaire de mettre à jour les entrées comptables en cochant la case à cocher de la ligne correspondante dans la colonne '''Pointer'''.
*Colonne '''Compte d'export''' : saisir un numéro de compte de racine 582 correspondant au premier numéro disponible. Ainsi, s'il n'y a pas déjà de compte de racine 582, saisir 582001.
*Cliquer sur le bouton '''Mettre à jour les activités sélectionnées'''
*Cliquer sur le bouton symbolisant le signe "+" dans la colonne Action


=Modifier une activité=
Une activité peut être saisie :
*Soit à l'état ouvert
*Soit à l'état fermé


;Créer et interfacer le type de paiement
Si l'activité est saisie à l'état ouvert, aucune écriture comptable n'est encore générée. Pour fermer une telle activité, il faut sur le planning de réservation :
*Aller dans '''Admin > Comptes > Encaissements > Types'''
*Soit, cliquer sur le rectangle de la ressource considérée qui doit être sur fond bleu pour indiquer que la ressource est en l'air
*Cliquer sur le bouton '''Ajouter''' en haut à droite du tableau
*Soit, cliquer la zone en bleue correspondante à la période du vol ouvert.
*Champ '''Nom''' : saisir ''Paiement en ligne HelloAsso''
*Cocher l'interrupteur '''Accessible uniquement aux personnes autorisées à saisir pour les tiers'''
*Champ '''Compte de trésorerie affecté''' : sélectionner '''Compte remise CB HelloAsso'''
*Champ '''Prestataire paiement en ligne''' : sélectionner l'option '''HelloAsso (x)''' si l'utilisateur a déjà connecté HelloAsso, sinon sélectionner l'option '''Paiement par Internet HelloAsso''' et procéder selon les indications suivantes :


:Une fenêtre contextuelle s'affiche
Si l'activité est saisie à l'état fermée, pour la modifier, il faut :
*Soit aller sur le compte de l'un des utilisateurs concerné par l'activité et pour lequel une écriture a été générée
*Soit aller sur le carnet de vol ou le carnet de route impacté
Dans tous les cas, il faut ensuite cliquer sur l'icône crayon qui apparait sur la ligne correspondante à l'activité.


:*Lire la phrase expliquant le modèle économique de HelloAsso
Tout activité saisie reste modifiable tant qu'elle n'est pas validée.
:*Cliquer sur le bouton '''Connecter à HelloAsso'''


:L'administrateur est redirigé vers la mire d'autorisation HelloAsso
Si l'objectif est de mettre à jour des calculs de facturation sur plusieurs activités, alors il est recommandé de suivre la procédure [[#Mettre-à-jour-les-entrées-comptables-associées-à-des-activités-non-validées|Mettre à jour les entrées comptables associées à des activités non validées]] pour gagner du temps.


:*Saisir l'adresse email et le mot de passe du compte HelloAsso
Si l'activité à modifier est validée, il faut utiliser la fonction d'[[#Annuler-une-activité-validée|annulation d'une activité validée]] puis saisir une nouvelle activité.
:*Sélectionner l'association à connecter (s'il en a plusieurs), si une seule association est disponible, elle est sélectionnée automatiquement


:Si la structure ne possède pas encore de compte HelloAsso :
=Saisir une activité=
*Aller dans '''Planning > Activités > Activités > Saisir'''


:*Cliquer le bouton '''Créer mon compte HelloAsso''', situé sous la phrase ''Vous n'avez pas encore de compte ?''


:Une fois l'inscription finalisée, L'utilisateur sera redirigé vers la mire d'autorisation pour terminer le processus de liaison
;Mécanismes de traitement
*[[Formulaires#Valeur-par-défaut|Champs avec des valeurs par défaut]]
*La [[Formulaires#Valeur-par-défaut|valeur par défaut]] du champ '''terrain de départ''' correspond au '''terrain d'arrivée''' du vol précédent renseigné par l'aéronef sélectionné. Changer la date de début d'activité ou l'aéronef entraîne un rafraîchissement de la page et la valeur par défaut du champ '''terrain de départ''' se met à jour. S'il n'y a pas de vol précédent, la valeur par défaut est le terrain associé à la plateforme.
*Le compteur de départ par défaut équivaut au compteur d'arrivée du vol précédent renseigné par l'aéronef sélectionné. Changer la date de départ rafraîchi la page si la date de départ est antérieure à la date de départ du vol précédent. Le compteur est mis à jour en fonction. Si le compteur est changé manuellement, le compteur n'est pas mis à jour lors du rafraîchissement. Changer d'aéronef réinitialise ce comportement.
*Suivant l'activité choisie et le [[Configuration#Terrain-d'arrivée-égal-au-terrain-de-départ,-lorsque-l'une-des-activités-suivantes-est-sélectionnée|paramétrage de la plateforme]], le terrain d'arrivée peut être automatiquement rempli avec la même valeur que celle du terrain de départ.
*La saisie d'une activité d'une durée inférieure à 15 minutes déclenche l'affichage d'un message d'avertissement (en orange). Cliquer sur '''Confirmer la validation''' au dessous de ce message pour saisir définitivement l'activité.
*Lorsqu'un utilisateur est saisi, un champ pour définir son statut apparaît. Ce champ disparaît si l'utilisateur n'est pas défini.
*Lors de la saisie des utilisateurs, le nombre de personnes à bord se mets automatiquement à jour. Le nombre de personnes à bord est égal au nombre d'utilisateurs saisis. Si le nombre de personnes à bord est défini manuellement, la valeur n'est pas changée automatiquement par la suite."
*Lors de la saisie d'un lieu, si aucun lieu correspondant n'est trouvé, [[#Demander-l'ajout-d'un-lieu|une option]] apparait afin de demander à OpenFlyers l'ajout du lieu.


:Une fois la liaison terminée, l'utilisateur est redirigé vers la page de type d'encaissement, où le champ '''Prestataire paiement en ligne''' affiche '''HelloAsso (x)'''


*Cliquer sur le bouton '''Enregistrer'''
;Champs de saisie date/heure départ/arrivée
A gauche du champ de saisie est indiqué le fuseau horaire défini par la structure et dans lequel le couple date/heure (horodatage) doit être saisi.


Les champs de saisie pour l'horodatage de départ et d'arrivée sont conçus pour :
*La saisie optimisée avec un clavier en ne nécessitant de saisir que les informations utiles : la barre oblique entre le jour et le mois ou le mois et l'année ne doit pas être saisie.
*La saisie avec un écran tactile en affichant, à droite du champ, un pictogramme qu'il faut toucher pour faire apparaitre des zones de saisies dédiées.


;Tester le paiement en ligne
En-dessous du champ de saisie de l'horodatage départ/arrivée apparait une ligne qui affiche l'horodatage en UTC.
*Aller dans '''Planning > Comptes > Actions > Approvisionner'''
*Champ '''Encaissement de l'utilisateur''' : saisir son propre nom
*Champ '''Type de règlement''' : sélectionner '''Paiement en ligne HelloAsso'''
*Champ '''Montant''' : saisir un '''montant cohérent qui sera réellement débité''' de sa carte bancaire
*Cliquer sur le bouton '''Enregistrer'''
L'utilisateur est redirigé vers l'interface HelloAsso proposant de compléter le montant de la transaction avec un montant proposé par HelloAsso :
*Corriger le montant comme souhaité, il est possible d'indiquer 0 €
*Cliquer sur le bouton ''Indiquer le nom du bouton''
*Saisir les coordonnées de sa carte bancaire et effectuer les opérations de vérification demandées par sa banque
Une fois la validation du paiement effectuée, l'utilisateur est automatiquement redirigé vers la page de son compte dans OpenFlyers :
*Vérifier qu'une nouvelle ligne d'encaissement à la date du jour a été générée dont le montant correspond à celui préalablement saisi dans OpenFlyers


Tant que l'aéronef n'est pas encore sélectionné, si l'utilisateur ouvre le formulaire de saisie d'activité puis modifie le premier champ (en passant de '''départ en vol''' à '''retour de vol''' ou l'inverse), OpenFlyers recalcule et propose de nouvelles heures par défaut conformément aux deux règles ci-dessous :


;Permettre à tous les utilisateurs d'utiliser ce type d'encaissement
*Lorsque la structure est configurée en mode '''Fermeture seulement''' :
*Aller dans '''Admin > Comptes > Encaissements > Types'''
**L'heure de retour proposée correspond à ''l'heure actuelle''.
*Cliquer sur le bouton symbolisant un crayon à droite de la ligne du type d'encaissement '''Paiement en ligne HelloAsso'''
**L'heure de départ est automatiquement calculée en soustrayant la durée d'activité par défaut à cette heure de fin.
*Décocher l'interrupteur '''Accessible uniquement aux personnes autorisées à saisir pour les tiers'''
*Cliquer sur le bouton '''Enregistrer'''


==Mettre en place un TPE Paybox Vision==
*Lorsque la structure est configurée en mode '''Ouverture et fermeture''' :
''Cette procédure débute après que l'identifiant et le mot de passe ait été changé conformément aux préconisations d'e-transactions. L'identifiant doit correspondre à une adresse e-mail autre que @free.fr ou @orange.fr''
*L'heure de départ proposée est ''l'heure actuelle + 10 minutes''
*Aller sur https://www.ca-moncommerce.com/espace-client-mon-commerce/up2pay-e-transactions/portail-vision-air/
*L'heure de retour est automatiquement calculée en ajoutant la durée d'activité par défaut à cette heure de début.
*Suivre la procédure consistant à :
**Télécharger et installer Adobe Air
**Télécharger et installer Vision Air
*Lancer Vision Air depuis son PC
*Dans le champ '''Login''', saisir l'identifiant qui correspond normalement à une adresse e-mail
*Dans le champ '''Mot de passe''', saisir le mot de passe qui a été préalablement modifié. '''/!\ Il faut saisir le mot de passe et ne pas faire un copier/coller'''
*Cliquer sur le bouton '''Se connecter'''
*Cliquer sur le menu représentant une clé de mécanicien.
*Dans la zone de gauche cliquer sur les icônes pour déplier les éléments jusqu'à faire apparaitre '''un élément avec une icône caddy''' puis cliquer sur cette icône pour faire apparaitre un formulaire dans la zone principale à droite
*Dans le tableau, copier/coller sur un fichier texte les champs '''Numéro du magasin''', '''Numéro de rang''' et '''Identifiant Paybox'''. Attention : '''Numéro de rang''' doit être recopié sur 2 chiffres et non pas trois (exemple : 01).
*Dans le tableau, dans le champ '''Réception du ticket de paiement''' sélectionner '''Inactif'''.
*Cliquer sur le bouton '''Enregistrer'''
*Tout en haut de l'interface, saisir des caractères dans le champ '''Phrase de passe''' de façon à ce que le bouton à droite du champ passe à "Fort"
*Cliquer sur le bouton en-dessous du champ intitulé '''Générer la clé'''
*Une fois la clé générée, recopier le contenu de la clé qui apparait en-dessous du bouton '''Générer la clé''' à côté du champ '''Clé :'''
*'''Valider l'e-mail reçu pour acceptation de la clé'''
*Transmettre par e-mail à OpenFlyers les informations suivantes :
**Numéro du magasin
**Numéro de rang
**Identifiant Paybox
**Clé


==Mettre en place un TPE SIPS ATOS v2==
Lorsque l'aéronef est sélectionné et que l'utilisateur modifie le premier champ du formulaire (en passant de '''départ en vol''' à '''retour de vol''' ou l'inverse), OpenFlyers conserve les heures déjà renseignées dans les champs.
*Aller sur l'interface de téléchargement soit de :
**[https://mercanet-telechargement.bnpparibas.net/ Mercanet BNP Paribas]
**[https://sherlocks-telecharger.portail.secure.lcl.fr Sherlocks LCL]
**[https://download.sips-atos.com/ SIPS Worldline (Sogenactif Société Générale)]
*Dans le champ '''Utilisateur''', saisir l'identifiant de connexion communiqué par la banque
*Dans le champ '''Mot de passe''', saisir le mot de passe de connexion communiqué par la banque
*Cliquer sur le bouton '''Se connecter'''
''S'il s'agit de la première connexion, le système demandera de changer le mot de passe''
Sur les interfaces SIPS Worldline et BNP Paribas :
*En haut à droite, cliquer sur le bouton '''Clés secrètes''' ou '''GESTION DES CLÉS'''
Sur l'interface LCL Sherlocks :
*'''Téléchargement > Gestion des clés'''
*Cliquer sur le bouton '''DEMANDE DE GENERATION'''
*Sauvegarder le fichier et le transmettre par email à OpenFlyers.


==Renouveler une clé secrète==
;Introduction
Certains TPE nécessitent un renouvellement régulier de la clé secrète. Le gestionnaire est averti de cette nécessité par email.


;Procédure
*S'il s'agit de la solution Sherlocks LCL, il faut renouveler la clé secrète en suivant la procédure [[#Mettre-en-place-un-TPE-SIPS-ATOS-v2|Mettre en place un TPE SIPS ATOS v2]]


==Tester un TPE virtuel==
;Champs de saisie [[Formules-de-calcul#Temps-d'activité|durée d'activité]]
S'assurer avant de procéder à des tests avec le TPE, que les utilisateurs disposent d'une adresse email valide.
Lorsque la durée d'actvité est affiché en unité de temps '''heures minutes''':
*La saisie optimisée avec un clavier en ne nécessitant de saisir que les informations utiles : les deux points entre l'heure et les minutes ne doit pas être saisie.
*La saisie avec un écran tactile en affichant, à droite du champ, un pictogramme qu'il faut toucher pour faire apparaitre des zones de saisies dédiées.
 
Si la durée inclut des jours, un champ numérique (avec les boutons '''+''' et '''–''') apparaît à gauche du champ de type time pour renseigner le nombre de jours. Lorsque la valeur atteint 0, ce champ disparaît.
 
 
 
;Synchronisation d'une saisie avec Gesasso
Lors de la saisie d'une activité et lorsque la plateforme est configurée pour la synchronisation externe avec [[Interfaçage-OpenFlyers-et-Gesasso|Gesasso]], le bouton de validation a deux affichages possibles :
 
*'''Enregistrer''' : Si la ressource sélectionnée n'a pas de numéro d'immatriculation Gesasso valide, ou si l'un des pilotes ne dispose pas d'une licence FFVP valide, alors la synchronisation avec Gesasso est ignorée dans ce cas.
 
*'''Enregistrer et Synchroniser avec Gesasso''' : indique que les ressources et les pilotes sélectionnés remplissent les critères requis, et que la synchronisation avec Gesasso est effectuée après l'enregistrement de l'activité.
 
 
;Mécanismes d'alertes
*[[Formulaires#Surbrillance-jaune|Effet de surbrillance jaune]]
*[[Formulaires#Surbrillance-rouge|Effet de surbrillance rouge]]
*Des [[Présentation-générale-des-alertes|alertes]] bloquantes ou non bloquantes peuvent être affichées après l'envoi du formulaire nécessitant une action complémentaire de l'utilisateur
 
 
;Page affichée par défaut après la saisie d'une activité
*Le planning lors d'une ouverture d'activité.
*La page du [[Gestion-des-activit%C3%A9s#Saisir-un-suivi-de-formation|saisie de progression]] lors d'une fermeture d'activité.
*A nouveau le formulaire de saisie d'activité lorsque l'activité précédemment saisie l'était en fermeture et que le terrain d'arrivée saisi était différent du terrain par défaut de la structure.
*Dans les autres cas, l'[[Gestion-de-la-comptabilité-côté-utilisateur#Extrait-de-compte|extrait de compte]] de la personne en première place. Si plusieurs comptes sont impactés, c'est le premier compte impacté de la personne qui est choisi.
*Si l'utilisateur connecté n'a pas le droit de visualiser le compte concerné, alors c'est le carnet de route qui est affiché.
 
==Demander l'ajout d'un aérodrome==
Lors de la saisie du terrain de départ, ou d'arrivée, il se peut que le lieu que l'utilisateur souhaite saisir ne soit pas dans nos bases de données. Une proposition apparait alors :
<pre>XXXX ( Demander l'ajout du lieu à OpenFlyers )</pre>
Il suffit à l'utilisateur de sélectionner cette option afin d'effectuer la demande d'ajout à OpenFlyers.
Cette option ne prend en compte que les lieux recensés par l'OACI ou la FFPLUM.
 
Attention, pour demander l'ajout d'un lieu, il faut saisir uniquement le code OACI (code à 4 lettres) ou FFPLUM (code au format LF + 4 chiffres) du lieu.
 
Une fois l'option sélectionnée, la demande est enregistrée par OpenFlyers, mais le lieu n'est pas ajouté immédiatement, il faut donc saisir temporairement un autre lieu.
 
==Forcer la saisie d'une durée d'activité incompatible avec sa formule de calcul==
Un gestionnaire peut forcer la saisie d'un [[#La-différence-entre-le-temps-de-vol-calculé-et-le-temps-de-vol-saisi-est-de-:-X:XX-heure(s)|temps d'activité incompatible avec la formule de calcul]] associée au type ressource pour lequel on souhaite saisir l'activité.


=Qualité de service d'un TPE=
Pour cela, il doit :
Selon les Terminal de Paiement Électroniques virtuel, certains systèmes n'effectuent pas de renvoi de l'avis de débit aux serveurs dans le cas ou le premier envoi à échouer (cf. [[#Paiement-d'un-utilisateur-n'apparaissant-pas-sur-son-compte-dans-OpenFlyers|Paiement d'un utilisateur n'apparaissant pas sur son compte dans OpenFlyers]]). Ce type de situation est rare mais peut arriver (problème de liaison internet par exemple ou indisponibilité momentanée du serveur recevant les avis de transactions). A contrario, les bons systèmes enregistrent les échecs, attendent un certain délai puis effectuent une nouvelle tentative d'envoi.
*Saisir l'activité en modifiant le compteur d'arrivé de sorte à obtenir le temps d'activité souhaité.
*[[Gestion-des-ressources#Changer-la-valeur-du-compteur-en-cours|Changer la valeur du compteur en cours]] de la ressource.


De même certains systèmes envoient un e-mail d'erreur lorsque la transaction n'est pas prise en compte par la plateforme OpenFlyers.
Dans le cas où plusieurs activités successives doivent être saisies, il est alors judicieux de ne mettre à jour le compteur de la ressource qu'une que toutes les activités ont été saisies.


Il est donc recommandé de vérifier auprès de sa banque si la solution TPE proposée effectue ce type de surveillance et de renvoi systématique.
=Supprimer une activité=
Si l'activité à supprimer est validée, il faut utiliser la fonction d'[[#Annuler-une-activité-validée|annulation d'une activité validée]].


==Liste des TPE effectuant plusieurs tentatives d'avis de paiement==
Si l'activité à supprimer n'est pas validée, pour effectuer sa suppression il faut :
*systempay
*[[Gestion-des-activités#Afficher-la-vue-d'ensemble-des-activités-selon-les-ressources|Afficher la vue d'ensemble des activités selon les ressources]].
*Cliquer sur l'icône correspondant à la ligne de la ressource et de la colonne '''Valider les activités sélectionnés'''. Si l'icône est grisée alors il n'y a aucune activité non validée.
*Dans le tableau qui va lister les activités, cliquer sur l'icône poubelle correspondant à l'activité à supprimer et confirmer.


=Troubleshooting=
==Email de la banque "transaction soumise plusieurs fois lors d'achats"==
Une sécurité côté TPE bancaire consiste à empêcher d'utiliser un même numéro de transaction à plusieurs reprises afin qu'il n'y ait pas de problème d'identification de l'utilisateur à l'origine de la demande de crédit.


Certaines banques envoient un email pour indiquer qu'il y a eu une tentative, infructueuse, d'utilisation d'un même numéro de transaction à plusieurs reprises.
=Valider les activités d'une ressource désactivée ou n'ayant plus la saisie des activités=
Pour valider les activités d'une ressource désactivée ou n'ayant plus la saisie des activités de cochée, il existe 2 solutions :
*Si l'objectif c'est de clôturer la comptabilité et donc de valider toutes les écritures antérieure à une certaine date, alors la solution la plus simple est de valider toutes les écritures antérieures à cette date en suivant la procédure [[Utilisation-de-la-comptabilité#Valider-toutes-les-écritures|Valider toutes les écritures]].
*Si l'objectif est de contrôler, voir de modifier les activités liées à la ressource avant de réellement les valider, alors il faut réactiver temporairement la ressource pour qu'elle apparaisse dans '''Gestion > Activités > Liste''' et ainsi pouvoir contrôler et valider ses activités associées. Pour cela il faut :
**Aller dans '''Gestion > Ressources > Actives'''
**Décocher '''Réservable''' et '''Saisie d'activité''' d'une ressource existante
**Cocher '''Saisie d'activité''' pour la ressource dont on souhaite contrôler les activités puis les valider
**valider les activités en allant dans '''Gestion > Activités > Liste'''
**Revenir sur '''Gestion > Ressources > Actives'''
**Décocher '''Saisie d'activité''' pour cette ressource
**Re-cocher '''Réservable''' et '''Saisie d'activité''' pour la ressource qui devait être temporairement décochée


Cela arrive si par exemple un utilisateur revient en arrière dans son navigateur et/ou rafraichit une page de demande de transaction.
=Valider une activité=
;Introduction
La validation des activités doit être effectuée à intervalle régulier comme préconisé dans le [[Bien-débuter-avec-OpenFlyers#Validation-des-écritures|workflow de validation des activités]].


Il n'y a besoin de rien faire car dans tous les cas, la 2ème fois, la banque bloque la tentative de transaction et côté OpenFlyers il n'y a pas d'enregistrement d'effectué.
Lorsqu'il existe des écritures non validées qui datent de plus de 30 jours, un message d'alerte de configuration s'affiche indiquant ''[[Alertes-de-configuration#Il-y-a-des-activités-non-validées-qui-datent-de-plus-de-30-jours|Il y a des activités non validées qui datent de plus de 30 jours]]''.


==Paiement d'un utilisateur n'apparaissant pas sur son compte dans OpenFlyers==
Option disponible pour la validation : [[Configuration#Regrouper-les-activités-en-une-facture-lors-de-la-validation|Regrouper les activités en une facture lors de la validation]]
Si le paiement effectué par un utilisateur n'apparait pas dans OpenFlyers, il faut tout d'abord vérifier que cette transaction a bien eu lieu. Pour cela, il faut se connecter à l'interface de gestion du TPE proposé par la banque, retrouver la ligne correspondant à la transaction. Cette ligne doit comporter un message d'anomalie indiquant que le serveur OpenFlyers n'a pas accusé réception de l'avis de transaction.


Ensuite, il faut vérifier le [[Bibliothèque-des-rapports#Paiement-en-ligne|rapport listant les tentatives de paiements]] qui permet de vérifier s'il y a bien eu une tentative de paiement d'initiée côté OpenFlyers.
;Procédure pour valider une ou plusieurs activités
*[[Gestion-des-activités#Afficher-la-vue-d'ensemble-des-activités-selon-les-ressources|Afficher la vue d'ensemble des activités selon les ressources]].
*Cliquer sur l'icône correspondant à la ligne de la ressource et de la colonne '''Valider les activités sélectionnés'''. Si l'icône est grisée alors il n'y a aucune activité non validée.
*Sélectionner les lignes d'activités à valider en cochant la case à cocher de la ligne correspondante dans la colonne '''Pointer'''.
*Cliquer sur le bouton '''Pointer les activités sélectionnées (attention cette action est irréversible)'''


A la suite de quoi, en transmettant les copies d'écran à OpenFlyers, il est possible de regarder les logs pour voir il y a eu une tentative de transaction. Si à la suite de cette investigation, OpenFlyers n'a pas retrouvé d'enregistrement d'avis de transaction cela veut dire que le message n'est pas parvenu au serveur et que le TPE n'effectue pas de nouvel envoi en cas d'échec (cf. [[#Qualité-de-service-d'un-TPE|Qualité de service d'un TPE]]).
Dans le cas où une activité a été validée alors qu'elle ne devait pas l'être, il est toujours possible d'en [[#Annuler-une-activité-validée|annuler l'effet]].


Nous recommandons alors de faire remonter le problème auprès de la banque concernée afin qu'ils améliorent leur processus en mettant en place une surveillance des avis en échec et un renouvellement de l'envoi.
Dans le cas d'une activité incomplète (Pas de pilote ou pas de localisation d'arrivée ou de départ) l'activité ne peut pas être validée il est donc impossible de la pointer. Ce cas ne devrait arriver que pour les activités générées via [[Interfaçage-OpenFlyers-et-Charterware|l'interfaçage avec Charterware]] ou [[Interfaçage-OpenFlyers-et-ClickAndTakeoff|l'interfaçage avec ClickAndTakeoff]].

Revision as of 08:40, 6 October 2025

Présentation

L'objet de cette page est de présenter la gestion des activités sur la version 4 d'OpenFlyers.

Paramétrage des vols solos supervisés

La réglementation aéronautique EASA, différencie les instructeurs en 2 catégories : les instructeurs restreints et non restreints. Les instructeurs sont restreints tant qu'ils ont effectués moins de 100 heures d'instruction. Pour le décompte de leurs heures d'instruction, il est possible de prendre en compte les heures solo, effectuées par leurs élèves, heures solos qu'ils ont supervisées. De plus, le rapport annuel de statistiques AERAL nécessite de faire remonter les heures solos supervisées par instructeur ainsi que par activité.

OpenFlyers déconseille de saisir les heures de solo supervisées en renseignant le nom de l'instructeur dans le champ Place droite ou Instructeur afin de ne pas créer d'effets de bords sur l'ensemble du logiciel.


OpenFlyers recommande de paramétrer le suivi des heures solos supervisées de la façon suivante :


Créer un type d'activité Solo supervisé
  • Admin > Types d'activités > Types d'activités > Actifs

En bas du tableau Liste des types d'activités, sur la dernière ligne qui doit être vide :

  • Champ Nom, indiquer Solo supervisé
  • Champ Couleur, sélectionner une couleur, de préférence proche de la couleur pour l'instruction
  • Cliquer sur le bouton avec un pictogramme symbolisant le signe plus
  • Aller à nouveau dans Admin > Types d'activités > Types d'activités > Actifs pour mettre à jour les autres tableaux

Dans le tableau Types d'activités incompatibles, rendre incompatible le type d'activité Solo supervisé avec les autres types d'activités qui doivent être incompatible, notamment Instruction, Baptême, Maintenance, Vol découverte, etc.


Créer un champ métier "Instructeur superviseur" pour le formulaire de saisie d'activité afin de pouvoir noter le nom de l'instructeur pour les vols solos des élèves
  • Admin > Structure > Variables > Champs métiers

Tout en bas sur la dernière ligne qui doit être vide :

  • Champ Nom de variable, indiquer supervisor
  • Champ Intitulé, indiquer Instructeur superviseur
  • Champ Catégorie, indiquer Activité
  • Champ Type de valeur, indiquer dbObject::Person(Instructeur)
  • Cliquer sur le bouton Ajouter
  • Mettre à jour le paramétrage Activité correspondant à Solo supervisé pour AERAL :
  • Admin > Structure > Paramétrage > Export Aeral

Formulaire Activité correspondant à Solo supervisé :

  • Champ Solo supervisé, indiquer Solo supervisé
  • Désactiver l'interrupteur instructeur en place droite
  • Champ Champ métier correspondant au superviseur, indiquer Instructeur superviseur
  • Cliquer sur le bouton Enregistrer en haut ou en bas à droite de la page


Ensuite, pour chaque vol solo supervisé, il faut dans le formulaire de saisie d'activité
  • Cocher le type d'activité Solo supervisé
  • Renseigner le nom de l'instructeur dans le champ Instructeur superviseur


Mettre en place une validité "Élève autorisé solo"

Dans le cas où la structure met en place des restrictions sur les réservations ou la saisie des vols, un élève en solo supervisé, n'ayant donc pas les validités d'un pilote breveté, peut se retrouver bloqué. Pour contourner ces restrictions, il est recommandé de créer un type de validité "Élève autorisé solo" et de lui permettre de contourner les exigences des autres validités non détenues par un élève.

  • Admin > Utilisateurs > Types de validités
  • Cliquer sur le bouton Ajouter un type de validités
  • Champ Nom, indiquer Élève autorisé solo
  • Cliquer sur la case à cocher Soumise à échéance
  • Champs Profils autorisés à gérer pour eux-mêmes et Profils autorisés à gérer/certifier pour les autres, cocher les profils admin, gestionnaire (ou équivalents) et instructeur
  • Cliquer sur le bouton Enregistrer"
  • Admin > Types de ressource

Pour chaque type de ressource :

  • Cliquer sur le bouton Validité
  • Pour chaque ligne de validité qui exige une validité qu'un élève n'a pas l'obligation de détenir, cocher le type de validité Élève autorisé solo

Afficher la vue d'ensemble des activités selon les ressources

  • Naviguer vers la section Gestion > Activités > Activités > Liste.

Une synthèse sous forme de tableau des activités actives et physiques, s'affiche automatiquement :

  • les ressources actives y figurent toujours.
  • les ressources désactivées ou celles pour lesquelles l'interrupteur Saisie d'activité (accessible via Gestion > Ressources > Actives) est décoché réapparaissent dès qu'elles possèdent au moins une activité non validée.

Ainsi, aucune action supplémentaire n'est nécessaire pour retrouver les ressources portant encore des validations à effectuer.

Alertes

Alertes générées par le contrôle d'accès

Alertes générées par le moteur de facturation

Alertes générées sur les validités

L'aéronef est déjà en l'air

Si en tentant d'ouvrir le vol d'un aéronef, apparait une alerte rouge L'aéronef est déjà en l'air cela veut dire qu'un vol a déjà ouvert avec cet aéronef. S'il s'agit d'un vol qui n'a pas été fermé et qui doit être supprimé, il faut annuler le vol ouvert.

La différence entre le temps de vol calculé et le temps de vol saisi est de : X:XX heure(s)

Cette alerte est suivie du message :

Veuillez contacter votre administrateur à propos de l'incompatibilité entre votre saisie et la formule du temps de vol choisie pour le type d'aéronef : X

Cette alerte apparait lorsque la valeur saisie du temps d'activité est incompatible avec la valeur calculée par la formule de calcul du temps d'activité définie pour la ressource X.

En général elle provient du fait que le temps de vol qui avait été calculé automatiquement dans le formulaire lors de la saisie des champs de compteurs départ/arrivée et/ou des heures de départ/arrivée ont été modifiés manuellement.

Lorsqu'une telle erreur apparait, vous devez :

  • Essayer de reprendre la saisie et essayer de comprendre pourquoi vous saisissez mal les valeurs dans les champs concernés
  • Si vous n'arrivez pas à comprendre la raison, contacter sans délai un gestionnaire de votre structure afin qu'il vous explique les erreurs que vous commettez lorsque le problème vient d'une saisie erronée ou qu'il analyser lui-même le problème.
  • Si vous êtes vous-même un gestionnaire de la plateforme, vous devez également pousser l'analyse pour comprendre en quoi votre saisie est incompatible avec la formule de calcul et le cas échéant faire effectuer une modification du paramétrage.

Voir également, comment Forcer la saisie d'une durée d'activité incompatible avec sa formule de calcul.

Le pilote X est déjà en l'air

Ce message apparait lorsque vous tentez de saisir un vol en ouverture de vol et que le pilote occupant la position X est déjà enregistré sur un vol ouvert, c'est à dire en l'air.

Cette protection permet de ne pas avoir un utilisateur occupé simultanément sur 2 ressources.

S'il s'agit d'un vol qui n'a pas été fermé et qui doit être supprimé, il faut annuler le vol ouvert.

Seul le type de vol requis dans le cas de la présence d'un second pilote a été sélectionné, vous devez en sélectionner au moins un autre en plus

Lors de la saisie d'un vol, cette alerte s'affiche si la configuration de la plateforme nécessite la saisie d'au moins un type de vol supplémentaire en plus du type de vol obligatoire dans le cas de la présence d'un second pilote.

C'est typiquement le cas pour les vols d'instruction où le paramétrage nécessite généralement de préciser un 2ème type de vol comme "local", "navigation", etc.

Vous êtes actuellement en l'air

Si en tentant de saisir un vol, l'alerte Vous êtes actuellement en l'air apparait cela veut dire qu'il y a déjà un vol d'ouvert à votre nom. S'il s'agit d'un vol qui n'a pas été fermé et qui doit être supprimé, il faut annuler le vol ouvert.

Vous ne pouvez ouvrir un vol avec une date de début dépassée

Cette protection empêche d'ouvrir une activité avec un horodatage de début antérieur à l'heure actuelle moins 15 minutes.

En général, pour un tel cas, le souhait n'est pas d'ouvrir une activité mais de fermer une activité. Il faut donc penser à passer le champ Etat du vol en "Retour de vol".

Annuler une activité validée

Contrairement à la suppression des activités non validées et du fait de l'inaltérabilité des données, il n'est pas possible de supprimer physiquement une activité après sa validation. Par contre, la fonction d'annulation de la saisie d'une activité permet d'en annuler son effet.

C'est cette fonction qu'il faut utiliser dans le cas où une activité validée doit être corrigée. L'utilisateur assurant la gestion :

  1. Annule l'activité validée qui n'a pas été saisie correctement
  2. Saisie une nouvelle activité avec les bonnes données


La fonction d'annulation d'activité génère les enregistrements suivants en base de données :

  1. Création d'une même activité que l'activité à annuler mais avec une durée opposée. Cela permet de garantir que les totaux d'heures d'activités sont correctement corrigés. De plus, le champ commentaire contient une référence à l'activité ciblée par l'annulation.
  2. Création des écritures comptables associées correspondant à l'identique à celles de l'activité à annuler mais de sens opposé (débit au lieu de crédit et vice versa).

Ces enregistrements sont générées à la date du jour et sont automatiquement validés. Cela permet de garantir la traçabilité des opérations.

Attention : il est possible d'annuler plusieurs fois une même activité.


Pour utiliser cette fonction :

  • Afficher la vue d'ensemble des activités selon les ressources.
  • Dans la colonne Annuler une activité validée, cliquer sur l’icône rouge symbolisant une flèche qui fait demi-tour
  • Une page listant les activités validées apparait :
    • Dans la colonne Annuler, sélectionner l'activité à annuler
    • Cliquer sur le bouton Annuler l'activité sélectionnée (cette action est irréversible)

Annuler un vol ouvert

  • Aller sur le planning
  • Cliquer sur le rectangle sur fond bleu correspondant à l'immatriculation de l'aéronef considéré
  • Cliquer sur le bouton Annuler le vol tout en bas du formulaire.

Lister les activités

La liste des activités est accessible depuis:

  • Afficher la vue d'ensemble des activités selon les ressources.
  • Cliquer sur l'icône correspondant à la colonne Valider les activités sélectionnées.
  • Ou bien Cliquer sur l'icône correspondant à la colonne Vérifier la succession des activités.
    • la page de Contrôle des compteurs de la resource a apparu.
    • Entrer Le compteur de départ, puis Sélectionner la date de début et de fin de l'intervale que vous voulez visualiser.
    • Cliquer sur le bouton Visualiser.

La liste des activités synthétise les informations les plus importantes pour l'ensemble des activités dans un intervalle de temps:

  • Pointer: contient les deux icônes tout cocher et tout décocher, aussi les cases à cocher de chaque ligne, en cochant la case puis en Cliquant sur le bouton Pointer les activités sélectionnées (attention cette action est irréversible) vous pouvez valider l'activité.
  • Date: date et heure de départ de vol, elle est affichée en fonction des patrons de format de date, affichée en rouge lorsque la date est dans le futur ( demain ou plus tard) ou bien lorsque la date de début de l'activité précédente chevauche une activité existante, c'est-à-dire la date de début de l'activité précédente + sa durée dépasse la date de début de l'activité actuelle. Un interrupteur Date en UTC permet d'afficher sous la date locale une ligne orange indiquant l'heure UTC si la conversion reste le même jour, ou la date complète en UTC lorsque la conversion recule sur la veille.
  • le champ place_tag qui permet d'étiqueter le numéro de place 0 (par exemple: place droite, pilote, Elève, Ouvert): la personne attribué au position 0, affichée en rouge lorsque l'activité n'avait pas de pilote.
  • le champ place_tag qui permet d'étiqueter le numéro de place 1 s'il existe (par exemple: place gauche, instructeur, Adhérent): la personne attribué au position 1.
  • Activités : les types d'activités sélectionnés pour l'activité (par exemple: Voltige, Instruction, Vol technique, ...).
  • Durée : la durée de l'activité, elle est affichée en fonction des patrons de format d'heure, en vert pour les activités non validées et en noir gras pour les activités validées.
  • Départ : Terrain de départ affiché en rouge lorsque l'activité n'avait pas de terrain de départ.
  • Arrivée: Terrain d'arrivée affiché en rouge lorsque l'activité n'avait pas de terrain d'arrivée.
  • Att. : Nombre d'atterrissages.
  • Ajouts réservoirs: Réapprovisionnement de réservoir avant/après vol, ils sont affichées sous format suivante " quantité + Unité (Type de éservoir)".
  • les éventuelles colonnes correspondant aux champs métiers de type "Activité".
  • Compteurs: affichés en deux manières ( compteur hexadécimal : HH:MM , compteur décimal: HH,CC ).
    • Départ : Le compteur de départ, affiché en rouge si le compteur de départ de l'activité actuelle inférieur au compteur d'arrivée de l'activité précédente ou bien si ( le compteur de départ de l'activité actuelle - le compteur d'arrivée de l'activité précédente - la tolérance ) > 1.
    • Arrivée : Le compteur d'arrivée.
    • Diff. : la difference entre les compteurs. affiché en rouge si le compteur de départ de l'activité actuelle dépasse le compteur d'arrivée de l'activité actuelle ou bien si ( le compteur d'arrivée de l'activité actuelle - le compteur de départ de l'activité actuelle - la tolérance ) > 1.
  • Actions: L'utilisateur peut effectuer sur une activité les actions suivantes:
    • Modifier : L'utilisateur peut modifier une activité s'il a des autoristations pour gérer ses activités et qu'il est l'instructeur de l'activité ou bien s'il peut gérer les activités des autres utilisteurs. ET si l'activité n'est pas validée.
    • Supprimer : L'utilisateur peut supprimer une activité s'il a des autoristations pour gérer ses activités et qu'il est l'instructeur de l'activité ou bien s'il peut gérer les activités des autres utilisteurs. ET si l'activité n'est pas validée.
    • Ajouter : L'utilisateur peut ajouter une activité s'il a des autoristations pour gérer ses activités et qu'il est l'instructeur de l'activité ou bien s'il peut gérer les activités des autres utilisteurs. ET si ( le compteur de départ de l'activité actuelle - le compteur d'arrivée de l'activité précédente - la tolérance ) > 1.
    • Afficher la trace de vol: L'utilisateur peut afficher la trace de vol s'il est sur le vol ou s'il a le droit de voir les traces de vol.

Mettre à jour les entrées comptables associées à des activités non validées

Dans le cas où, suite à une saisie d'activité, des changements de facturations ont été fait, il est nécessaire de mettre à jour les entrées comptables associées à celle-ci. La mise à jour ne peut se faire que sur les activités non validées ayant au moins un utilisateur et étant associées à une ressource active.

Procédure pour mettre à jour les écritures comptables d'une ou plusieurs activités :

  • Afficher la vue d'ensemble des activités selon les ressources.
  • Cliquer sur l'icône correspondant à la ligne de la ressource et de la colonne Mettre à jour les entrées comptables des activités non validées. Si l'icône est grisée alors il n'y a aucune activité non validée.
  • Sélectionner les lignes d'activités dont il est nécessaire de mettre à jour les entrées comptables en cochant la case à cocher de la ligne correspondante dans la colonne Pointer.
  • Cliquer sur le bouton Mettre à jour les activités sélectionnées

Modifier une activité

Une activité peut être saisie :

  • Soit à l'état ouvert
  • Soit à l'état fermé

Si l'activité est saisie à l'état ouvert, aucune écriture comptable n'est encore générée. Pour fermer une telle activité, il faut sur le planning de réservation :

  • Soit, cliquer sur le rectangle de la ressource considérée qui doit être sur fond bleu pour indiquer que la ressource est en l'air
  • Soit, cliquer la zone en bleue correspondante à la période du vol ouvert.

Si l'activité est saisie à l'état fermée, pour la modifier, il faut :

  • Soit aller sur le compte de l'un des utilisateurs concerné par l'activité et pour lequel une écriture a été générée
  • Soit aller sur le carnet de vol ou le carnet de route impacté

Dans tous les cas, il faut ensuite cliquer sur l'icône crayon qui apparait sur la ligne correspondante à l'activité.

Tout activité saisie reste modifiable tant qu'elle n'est pas validée.

Si l'objectif est de mettre à jour des calculs de facturation sur plusieurs activités, alors il est recommandé de suivre la procédure Mettre à jour les entrées comptables associées à des activités non validées pour gagner du temps.

Si l'activité à modifier est validée, il faut utiliser la fonction d'annulation d'une activité validée puis saisir une nouvelle activité.

Saisir une activité

  • Aller dans Planning > Activités > Activités > Saisir


Mécanismes de traitement
  • Champs avec des valeurs par défaut
  • La valeur par défaut du champ terrain de départ correspond au terrain d'arrivée du vol précédent renseigné par l'aéronef sélectionné. Changer la date de début d'activité ou l'aéronef entraîne un rafraîchissement de la page et la valeur par défaut du champ terrain de départ se met à jour. S'il n'y a pas de vol précédent, la valeur par défaut est le terrain associé à la plateforme.
  • Le compteur de départ par défaut équivaut au compteur d'arrivée du vol précédent renseigné par l'aéronef sélectionné. Changer la date de départ rafraîchi la page si la date de départ est antérieure à la date de départ du vol précédent. Le compteur est mis à jour en fonction. Si le compteur est changé manuellement, le compteur n'est pas mis à jour lors du rafraîchissement. Changer d'aéronef réinitialise ce comportement.
  • Suivant l'activité choisie et le paramétrage de la plateforme, le terrain d'arrivée peut être automatiquement rempli avec la même valeur que celle du terrain de départ.
  • La saisie d'une activité d'une durée inférieure à 15 minutes déclenche l'affichage d'un message d'avertissement (en orange). Cliquer sur Confirmer la validation au dessous de ce message pour saisir définitivement l'activité.
  • Lorsqu'un utilisateur est saisi, un champ pour définir son statut apparaît. Ce champ disparaît si l'utilisateur n'est pas défini.
  • Lors de la saisie des utilisateurs, le nombre de personnes à bord se mets automatiquement à jour. Le nombre de personnes à bord est égal au nombre d'utilisateurs saisis. Si le nombre de personnes à bord est défini manuellement, la valeur n'est pas changée automatiquement par la suite."
  • Lors de la saisie d'un lieu, si aucun lieu correspondant n'est trouvé, une option apparait afin de demander à OpenFlyers l'ajout du lieu.


Champs de saisie date/heure départ/arrivée

A gauche du champ de saisie est indiqué le fuseau horaire défini par la structure et dans lequel le couple date/heure (horodatage) doit être saisi.

Les champs de saisie pour l'horodatage de départ et d'arrivée sont conçus pour :

  • La saisie optimisée avec un clavier en ne nécessitant de saisir que les informations utiles : la barre oblique entre le jour et le mois ou le mois et l'année ne doit pas être saisie.
  • La saisie avec un écran tactile en affichant, à droite du champ, un pictogramme qu'il faut toucher pour faire apparaitre des zones de saisies dédiées.

En-dessous du champ de saisie de l'horodatage départ/arrivée apparait une ligne qui affiche l'horodatage en UTC.

Tant que l'aéronef n'est pas encore sélectionné, si l'utilisateur ouvre le formulaire de saisie d'activité puis modifie le premier champ (en passant de départ en vol à retour de vol ou l'inverse), OpenFlyers recalcule et propose de nouvelles heures par défaut conformément aux deux règles ci-dessous :

  • Lorsque la structure est configurée en mode Fermeture seulement :
    • L'heure de retour proposée correspond à l'heure actuelle.
    • L'heure de départ est automatiquement calculée en soustrayant la durée d'activité par défaut à cette heure de fin.
  • Lorsque la structure est configurée en mode Ouverture et fermeture :
  • L'heure de départ proposée est l'heure actuelle + 10 minutes
  • L'heure de retour est automatiquement calculée en ajoutant la durée d'activité par défaut à cette heure de début.

Lorsque l'aéronef est sélectionné et que l'utilisateur modifie le premier champ du formulaire (en passant de départ en vol à retour de vol ou l'inverse), OpenFlyers conserve les heures déjà renseignées dans les champs.


Champs de saisie durée d'activité

Lorsque la durée d'actvité est affiché en unité de temps heures minutes:

  • La saisie optimisée avec un clavier en ne nécessitant de saisir que les informations utiles : les deux points entre l'heure et les minutes ne doit pas être saisie.
  • La saisie avec un écran tactile en affichant, à droite du champ, un pictogramme qu'il faut toucher pour faire apparaitre des zones de saisies dédiées.

Si la durée inclut des jours, un champ numérique (avec les boutons + et ) apparaît à gauche du champ de type time pour renseigner le nombre de jours. Lorsque la valeur atteint 0, ce champ disparaît.


Synchronisation d'une saisie avec Gesasso

Lors de la saisie d'une activité et lorsque la plateforme est configurée pour la synchronisation externe avec Gesasso, le bouton de validation a deux affichages possibles :

  • Enregistrer : Si la ressource sélectionnée n'a pas de numéro d'immatriculation Gesasso valide, ou si l'un des pilotes ne dispose pas d'une licence FFVP valide, alors la synchronisation avec Gesasso est ignorée dans ce cas.
  • Enregistrer et Synchroniser avec Gesasso : indique que les ressources et les pilotes sélectionnés remplissent les critères requis, et que la synchronisation avec Gesasso est effectuée après l'enregistrement de l'activité.


Mécanismes d'alertes


Page affichée par défaut après la saisie d'une activité
  • Le planning lors d'une ouverture d'activité.
  • La page du saisie de progression lors d'une fermeture d'activité.
  • A nouveau le formulaire de saisie d'activité lorsque l'activité précédemment saisie l'était en fermeture et que le terrain d'arrivée saisi était différent du terrain par défaut de la structure.
  • Dans les autres cas, l'extrait de compte de la personne en première place. Si plusieurs comptes sont impactés, c'est le premier compte impacté de la personne qui est choisi.
  • Si l'utilisateur connecté n'a pas le droit de visualiser le compte concerné, alors c'est le carnet de route qui est affiché.

Demander l'ajout d'un aérodrome

Lors de la saisie du terrain de départ, ou d'arrivée, il se peut que le lieu que l'utilisateur souhaite saisir ne soit pas dans nos bases de données. Une proposition apparait alors :

XXXX ( Demander l'ajout du lieu à OpenFlyers )

Il suffit à l'utilisateur de sélectionner cette option afin d'effectuer la demande d'ajout à OpenFlyers. Cette option ne prend en compte que les lieux recensés par l'OACI ou la FFPLUM.

Attention, pour demander l'ajout d'un lieu, il faut saisir uniquement le code OACI (code à 4 lettres) ou FFPLUM (code au format LF + 4 chiffres) du lieu.

Une fois l'option sélectionnée, la demande est enregistrée par OpenFlyers, mais le lieu n'est pas ajouté immédiatement, il faut donc saisir temporairement un autre lieu.

Forcer la saisie d'une durée d'activité incompatible avec sa formule de calcul

Un gestionnaire peut forcer la saisie d'un temps d'activité incompatible avec la formule de calcul associée au type ressource pour lequel on souhaite saisir l'activité.

Pour cela, il doit :

Dans le cas où plusieurs activités successives doivent être saisies, il est alors judicieux de ne mettre à jour le compteur de la ressource qu'une que toutes les activités ont été saisies.

Supprimer une activité

Si l'activité à supprimer est validée, il faut utiliser la fonction d'annulation d'une activité validée.

Si l'activité à supprimer n'est pas validée, pour effectuer sa suppression il faut :

  • Afficher la vue d'ensemble des activités selon les ressources.
  • Cliquer sur l'icône correspondant à la ligne de la ressource et de la colonne Valider les activités sélectionnés. Si l'icône est grisée alors il n'y a aucune activité non validée.
  • Dans le tableau qui va lister les activités, cliquer sur l'icône poubelle correspondant à l'activité à supprimer et confirmer.


Valider les activités d'une ressource désactivée ou n'ayant plus la saisie des activités

Pour valider les activités d'une ressource désactivée ou n'ayant plus la saisie des activités de cochée, il existe 2 solutions :

  • Si l'objectif c'est de clôturer la comptabilité et donc de valider toutes les écritures antérieure à une certaine date, alors la solution la plus simple est de valider toutes les écritures antérieures à cette date en suivant la procédure Valider toutes les écritures.
  • Si l'objectif est de contrôler, voir de modifier les activités liées à la ressource avant de réellement les valider, alors il faut réactiver temporairement la ressource pour qu'elle apparaisse dans Gestion > Activités > Liste et ainsi pouvoir contrôler et valider ses activités associées. Pour cela il faut :
    • Aller dans Gestion > Ressources > Actives
    • Décocher Réservable et Saisie d'activité d'une ressource existante
    • Cocher Saisie d'activité pour la ressource dont on souhaite contrôler les activités puis les valider
    • valider les activités en allant dans Gestion > Activités > Liste
    • Revenir sur Gestion > Ressources > Actives
    • Décocher Saisie d'activité pour cette ressource
    • Re-cocher Réservable et Saisie d'activité pour la ressource qui devait être temporairement décochée

Valider une activité

Introduction

La validation des activités doit être effectuée à intervalle régulier comme préconisé dans le workflow de validation des activités.

Lorsqu'il existe des écritures non validées qui datent de plus de 30 jours, un message d'alerte de configuration s'affiche indiquant Il y a des activités non validées qui datent de plus de 30 jours.

Option disponible pour la validation : Regrouper les activités en une facture lors de la validation

Procédure pour valider une ou plusieurs activités
  • Afficher la vue d'ensemble des activités selon les ressources.
  • Cliquer sur l'icône correspondant à la ligne de la ressource et de la colonne Valider les activités sélectionnés. Si l'icône est grisée alors il n'y a aucune activité non validée.
  • Sélectionner les lignes d'activités à valider en cochant la case à cocher de la ligne correspondante dans la colonne Pointer.
  • Cliquer sur le bouton Pointer les activités sélectionnées (attention cette action est irréversible)

Dans le cas où une activité a été validée alors qu'elle ne devait pas l'être, il est toujours possible d'en annuler l'effet.

Dans le cas d'une activité incomplète (Pas de pilote ou pas de localisation d'arrivée ou de départ) l'activité ne peut pas être validée il est donc impossible de la pointer. Ce cas ne devrait arriver que pour les activités générées via l'interfaçage avec Charterware ou l'interfaçage avec ClickAndTakeoff.