Un service centralisé du MESS qui permet à vos systèmes de mission de produire des correspondances (lettres, avis, formulaires) à partir de gabarits Word, de les imprimer en lot et de les déposer automatiquement dans la GED.

Consulter la vue d'ensemble de l'architecture d'intégration.

Avant d'appeler GCO, votre équipe doit avoir complété les étapes suivantes dans l'application GCO :

1. Créer l'équipe et la correspondance (avec son code, ex. J08);
2. Créer une version de la correspondance et téléverser le gabarit .docx;
3. Configurer les attributs de la version (GED:Type, GED:LigneAffaire, etc.);
4. Déployer la version dans l'environnement cible.

1. Connectez-vous à l'interface GCO et naviguez vers votre équipe → Clés d'API;
2. Générez une nouvelle clé en sélectionnant le type d'environnement souhaité;
3. Notez la clé générée et le Client Id associé — la clé ne sera plus affichable intégralement par la suite.

Consulter le guide complet d'authentification.

Effectuez un appel POST /systeme/correspondances/generer avec les en-têtes et le corps suivants :

POST /systeme/correspondances/generer
Authorization: Api-Key {votre-cle-api}
x-client-id: {votre-client-id}
Content-Type: application/json
Accept: application/json

Consulter le guide complet de GCO212.

Le paramètre modeImpression détermine ce qu'il advient du PDF après sa production :

1. PREVIEW — PDF retourné directement, sans impression ni dépôt GED;
2. LOT — PDF mis en file d'attente pour impression en lot différé;
3. LOTDIFF — Lot retenu jusqu'au déclenchement manuel;
4. IMMEDIAT — Impression locale sur l'imprimante du profil de l'utilisateur;
5. NUMERIQUE — Dépôt dans la GED uniquement, sans impression.

Consulter la description détaillée de chaque mode.

1. Passez "indDepotGED": true dans votre requête;
2. Fournissez l'objet metadonneesDocument avec au moins un identifiant (individu, clé de repérage ou id unique GED);
3. Vérifiez que les attributs GED:Type et GED:LigneAffaire sont configurés sur la version déployée dans GCO.

Consulter le guide de dépôt GED.

• Référence complète des modèles JSON — schémas, énumérations, contraintes de validation;
• Codes d'erreur et dépannage — erreurs HTTP, codes fonctionnels, conseils;
• Exemples de requêtes — exemples prêts à l'emploi pour tous les modes.

1. Consultez les codes d'erreur et conseils de dépannage;
2. Consultez la spécification fonctionnelle détaillée de GCO212;
3. Contactez l'équipe GCO via votre canal de support habituel.

1. Vérifiez si la documentation fonctionnelle source dans /Documentation contient l'information à jour;
2. Proposez une correction directement dans le code source du dépôt SPFS-GCO.

L'interface Swagger est disponible à {url-de-base}/Swagger/index.html pour chaque environnement.