B B2BOmra Pro · Documentation
Accueil / Documentation / Documents et passeports des pèlerins

🪪 Documents et passeports des pèlerins

Le passeport est la donnée la plus sensible que vous gérez. B2BOmra a été conçue pour le protéger avec un niveau de garantie supérieur à WhatsApp, Excel, Google Drive ou l'email. Voici exactement ce qui se passe.

Téléverser un passeport

Vous pouvez ajouter un scan de passeport à une fiche pèlerin de deux manières :

  • En cliquant sur « Scanner le passeport » depuis la fiche pèlerin ou le formulaire de création. La modale de scan ouvre la caméra ou l'explorateur de fichiers.
  • En allant dans la section Documents de la fiche et en téléversant un PDF ou une image.

Format supportés

  • Images : JPG, JPEG, PNG, WEBP (taille max 5 Mo après compression auto) ;
  • PDF : passeport scanné ou export numérique (taille max 5 Mo).

Compression automatique

Les images sont compressées automatiquement avant stockage : redimension à 1280 px sur la plus grande dimension et réencodage JPEG qualité 85. En pratique, une photo iPhone de 5 Mo devient une image de ~400 Ko, plus rapide à charger et qui occupe moins d'espace.

Où sont stockés les fichiers

Les fichiers sont stockés dans une zone privée du serveur, dans une arborescence par agence :

  • pelerin_docs/{agence}/{pelerin}/… : scans passeport et autres documents.
  • pelerin_photos/{agence}/{pelerin}/… : photos personnelles (cropées).

Ces dossiers ne sont pas accessibles via une URL publique. Aucune adresse web ne pointe directement vers ces fichiers. Le serveur web ne les sert pas.

Accès aux fichiers

Pour consulter ou télécharger un fichier, vous passez systématiquement par une route authentifiée qui :

  1. Vérifie que vous êtes connecté(e) ;
  2. Vérifie que vous êtes membre de l'agence propriétaire du fichier ;
  3. Vérifie que votre rôle vous autorise l'accès ;
  4. Sert le fichier uniquement à ce moment-là, dans la réponse HTTP, sans jamais exposer une URL réutilisable.

Concrètement, si vous copiez le lien de téléchargement d'un passeport et que vous le partagez par email à une personne extérieure à votre agence, le lien est inutilisable par cette personne. Elle obtiendra une erreur 403 (accès refusé).

Types de documents recommandés

Pour chaque pèlerin, vous pouvez classer vos documents par catégorie :

  • Passeport (généré automatiquement lors du scan) ;
  • Visa (une fois obtenu auprès des autorités saoudiennes) ;
  • Billet d'avion ;
  • Autre (certificat de vaccination, carte de mutamir, document de transit, etc.).

Suppression

Vous pouvez supprimer un document à tout moment. La suppression est :

  • Immédiate côté agence : le fichier disparaît de la fiche et n'est plus téléchargeable.
  • Effective au niveau disque : le fichier est supprimé physiquement.
  • Tracée dans le journal d'audit : vous savez qui a supprimé quoi et quand.
  • Conservée dans les sauvegardes selon la durée légale de rétention (cf. RGPD).

Champs MRZ et arabe

La zone MRZ (Machine Readable Zone) est la zone à 2 lignes en bas de la page photo d'un passeport. Elle contient l'identité et le numéro de document sous forme standardisée (ICAO Doc 9303). Quand vous scannez un passeport, B2BOmra lit cette zone et préremplit les champs.

Pour les passeports maghrébins (Maroc, Algérie, Tunisie…) et du Golfe (Arabie Saoudite, Émirats, Qatar…), les champs en caractères arabes de la page photo sont aussi extraits et préremplis dans la fiche. Vous pouvez les corriger en utilisant le clavier arabe virtuel intégré.

Détection des doublons

Quand vous scannez ou saisissez un passeport, B2BOmra vérifie immédiatement si ce numéro existe déjà dans votre agence. Si oui, une alerte vous propose :

  • D'ouvrir la fiche existante (pour vérifier qu'il s'agit bien du même pèlerin) ;
  • De créer quand même un nouveau pèlerin si vous savez qu'il y a une homonymie réelle (rare).

Cette détection est limitée à votre agence : nous ne croisons jamais les numéros de passeport entre agences (confidentialité stricte).

Règle Arabie Saoudite : 6 mois de validité

Le Royaume d'Arabie Saoudite exige un passeport valide au moins 6 mois après la date de retour pour autoriser le visa. B2BOmra surveille automatiquement :

  • À la saisie : alerte visuelle si la date d'expiration est trop proche.
  • Six mois avant le départ d'un groupe : tâche de rappel automatique créée pour les pèlerins concernés.
  • Sur la fiche pèlerin : badge coloré (vert / orange / rouge) selon la marge restante.

Pour aller plus loin