Détail d’une taxation patente ou d’une fiche — accès par référence

La référence est l’identifiant métier du dossier (souvent aligné sur Ref_id / Reference en base). Remplacez {REF} par la référence exacte, en encodant les caractères spéciaux dans l’URL (espace → %20, etc.).

Notre {BASE} = URL racine de l’application (ex. https://serveur/ePatente ou http://localhost:8210 selon le déploiement).

1. Interface web (tableau de bord, agent connecté)

Ces pages chargent le détail via l’API interne. Une session / connexion agent est requise (sinon redirection vers la page de login) ; le site et le code agent doivent être présents côté client (ex. localStorage).

Taxation patente

{BASE}/detail-taxation/{REF}

Exemple : {BASE}/detail-taxation/PT-2024-00123

Fiche de recensement

{BASE}/detail-fiche/{REF}

Même principe : la fiche est résolue par sa référence métier telle qu’enregistrée en base.

2. API REST (lecture du détail JSON)

Méthode GET, sans corps. La référence est le dernier segment de chemin (décodage côté serveur). Réponse : enveloppe status / message / data (schéma détaillé côté client mobile ou Postman).

Resource Taxation patente (ticket)
Requête GET {BASE}/api/verify-ticket/{REF}
Usage Alimente l’écran detail_taxation : état, montant, assujetti, dates, bordereau, etc.
Resource Fiche de recensement
Requête GET {BASE}/api/verify-fiche/{REF}
Usage Alimente l’écran detail_fiche (données complètes fiche, état, dates, opérateur, etc.).

En cas d’inexistence : réponse d’erreur (ex. statut 204 ou message métier) avec corps JSON ; le message est affiché sur la page de détail.

3. Vérification publique (QR code, sans connexion)

Point d’entrée pour un scan (QR) ou un lien public : le contrôleur tente d’abord une taxation patente, puis une fiche, avec la même référence.

GET {BASE}/verify/{REF}

4. Impression des cartes (liens associés)

Ces URL ouvrent le gabarit d’impression (navigateur). L’accès effectif dépend de la politique d’hébergement (authentification, rôle).

5. Rappel pratique