Désactiver l'application Cegid Loop APIs Standard

Présentation générale de l'API et finalité fonctionnelle

Cette API permet de désactiver l'application Cegid Loop APIs Standard pour un ou plusieurs dossiers clients du cabinet. Elle retourne un identifiant de tâche (jobId) pour suivre l'avancement.

POST/deactivateStandardAPI

Cette API désactive l'application Cegid Loop APIs Standard sur les dossiers demandés.

Lien vers la documentation technique

Cas d'usage

Cette API permet de désactiver l'application Cegid Loop APIs Standard sur une sélection de dossiers clients.
Elle permet également de désactiver l'application sur l'ensemble des dossiers du cabinet grâce au paramètre allCompanyFiles.
Pour suivre l'avancement, conserver le jobId et interroger getStandardAPIProgressStatus.

Procédure

Appeler l'endpoint de désactivation.
Enregistrer le jobId retourné.
Interroger GET /getStandardAPIProgressStatus jusqu'à ce que status vaille completed ou failed.

https://api.cegid.com/loop-api-publiques/deactivateStandardAPI

Route	Méthode http	Description
/deactivateStandardAPI	POST	Désactive l'application Cegid Loop APIs Standard et retourne un jobId

Jusqu'à 50 dossiers, le traitement peut être synchrone : la réponse contient déjà total, success, failed, details et status. Pour tous les dossiers (allCompanyFiles à true) ou plus de 50 dossiers, le traitement est asynchrone : la réponse contient jobId, message et type.

Paramétrage de l'appel

Méthode http pour la demande : POST

Header(s) attendu(s) obligatoire(s) de la demande

Champ	Description
Ocp-Apim-Subscription-Key	Subscription key
x-apikey	API Key & Secret

Body de la demande

Champ	Type	Description	Obligatoire
companyFiles	array of string	Liste des codes des dossiers clients sur lesquels désactiver l'application	Non*
allCompanyFiles	boolean	Désactive l'application sur l'ensemble des dossiers du cabinet	Non*

* Soit allCompanyFiles est true, soit companyFiles contient au moins un code. Si allCompanyFiles est true, companyFiles doit être vide ou omis.

Exemple de body

{
    "companyFiles": ["dossier1", "dossier2"],
    "allCompanyFiles": false
}

Code retour

En cas de succès

Code retour http de la réponse : 200

En cas d'échec

Lien vers la liste des codes d'erreur

Structure du retour

Format du retour

Même structure que l'activation. type vaut removeApplicationAndWorkGroupFromDossier. La réponse contient toujours un jobId. Selon le périmètre, le détail par dossier peut être présent immédiatement (synchrone) ou uniquement via getStandardAPIProgressStatus (asynchrone).

Champ	Type	Description
jobId	string	Identifiant de tâche à utiliser avec getStandardAPIProgressStatus
message	string	Message lorsque le traitement est asynchrone
type	string	`removeApplicationAndWorkGroupFromDossier`
total	integer	Nombre total de dossiers (réponse synchrone)
success	integer	Nombre de dossiers désactivés avec succès (réponse synchrone)
failed	integer	Nombre de dossiers en échec (réponse synchrone)
details	array	Détail du résultat par dossier (réponse synchrone)
details[].codeIbs	string	Code du dossier
details[].status	string	`success` ou `failed`
details[].reason	string	Raison de l'échec, le cas échéant
status	string	`inProgress`, `completed` ou `failed` (réponse synchrone)

Exemple de retour asynchrone

{
    "jobId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "message": "Request to deactivate the application has been accepted.",
    "type": "removeApplicationAndWorkGroupFromDossier"
}

Exemple de retour synchrone (petit périmètre)

{
    "jobId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "total": 2,
    "success": 1,
    "failed": 1,
    "details": [
        {
            "codeIbs": "dossier1",
            "status": "success"
        },
        {
            "codeIbs": "dossier2",
            "status": "failed",
            "reason": "Dossier introuvable"
        }
    ],
    "type": "removeApplicationAndWorkGroupFromDossier",
    "status": "failed"
}

Table of Contents