API FO Procedure MyGuichet.lu

L’API Front Office Procedure MyGuichet.lu permet :

• d’initier des démarches sur MyGuichet.lu nécessitant une authentification ;
• de déposer ces démarches dans un espace personnel sélectionné par l’utilisateur authentifié sur MyGuichet.lu.

L’API FO Procedure permet aux applications clientes d’initier des démarches MyGuichet.lu nécessitant une authentification et de générer une URL permettant à l’utilisateur de poursuivre ou finaliser la démarche dans son espace personnel.

Toutes les démarches authentifiées ne sont pas systématiquement éligibles à ce cas d’usage.
Un échange préalable avec MyGuichet.lu est requis pour confirmer l’éligibilité.

Fonctionnalités principales

Initiation de démarches authentifiées
L’API génère une URL personnalisée permettant à l’utilisateur connecté de démarrer une nouvelle démarche dans l’espace sélectionné.

Intégration de pré-remplissage
Elle accepte des fichiers XML de pré-remplissage, déposés préalablement via l'API FO Main MyGuichet.lu.

Gestion des pièces jointes
Lors de l’initiation d’une procédure, il est possible d’ajouter une liste de documents, chacun référencé via les fichiers temporaires envoyés par l'API FO Main MyGuichet.lu.

Rôle dans l’écosystème FO MyGuichet.lu

L’API FO Procedure est utilisée lorsque l'application partenaire souhaite :

• préparer une démarche à l’avance (ex. pré‑remplir le formulaire) ;
• intégrer MyGuichet.lu dans un flux applicatif existant ;
• permettre à l’utilisateur final d’être directement redirigé vers la démarche à initier.

Elle dépend de l'API FO Main MyGuichet.lu pour :

• la validation des droits (check-action-access) ;
• l’obtention du token d’accès ;
• la gestion des fichiers temporaires (pré-remplissages et pièces jointes).