L'erreur UNAPPROVABLE est renvoyée par l'API Approvals de Zoho CRM lorsqu'un enregistrement ne peut pas entrer ou progresser dans un flux d'approbation car il échoue à la validation, manque de configuration requise ou viole les conditions d'approbation. Cette erreur signale un problème de règle métier ou de configuration plutôt qu'une défaillance d'authentification ou de réseau.
Ce que cela signifie — explication concrète liée à la surface de l'API Zoho
UNAPPROVABLE se produit lorsque le point d'accès Approvals (par exemple POST /crmv2/Approvals ou les API d'approbation spécifiques au module) détermine que l'enregistrement cible ne peut pas être approuvé selon les règles actuelles. Les vérifications typiques au niveau de l'API incluent des champs requis manquants pour la règle d'approbation, l'état de l'enregistrement ne correspondant pas aux critères de la règle, ou le workflow d'approbation n'étant pas activé ou mal configuré pour ce module ou ce type d'enregistrement [3][4].
Causes courantes
- Un champ requis utilisé par la règle d'approbation est vide ou contient des données invalides, ce qui entraîne l'échec de l'évaluation de la règle [4].
- Les critères de la règle d'approbation ne correspondent pas à l'état de l'enregistrement (statut, étape, valeur de liste déroulante), de sorte que le workflow refuse de démarrer [3].
- Le workflow ou le processus d'approbation est désactivé, supprimé ou non attribué au profil/rôle de l'enregistrement, empêchant l'API Approvals de router la demande [3].
- La requête API référence le mauvais module, le mauvais ID d'enregistrement ou le mauvais nom d'API de champ personnalisé, de sorte que Zoho traite l'enregistrement comme non applicable à une règle d'approbation [3][4].
Comment le résoudre
- Reproduisez l'échec dans l'interface utilisateur pour le même enregistrement. Ouvrez l'enregistrement dans CRM et tentez la même action d'approbation pour voir les avertissements de l'interface utilisateur ou les champs manquants.
- Vérifiez la configuration de la règle d'approbation : ouvrez Configuration > Automatisation > Approbations et confirmez que le processus est actif, appliqué au bon module et ciblé sur le profil/rôle de l'enregistrement. Vérifiez que les règles d'attribution et les critères d'entrée correspondent exactement aux valeurs de l'enregistrement [3].
- Validez les champs requis et les types de données utilisés par l'approbation : confirmez que les champs requis sont renseignés et que les valeurs des listes déroulantes/API correspondent aux chaînes attendues. Utilisez l'appel GET de l'enregistrement (GET /crm/v3/Modules/{module}/records/{id}) pour inspecter les clés de champ et les valeurs utilisées dans la charge utile de l'API [4].
- Confirmez que la charge utile de la requête API utilise les bons noms d'API de champ et le bon ID d'enregistrement. Comparez les clés de la charge utile avec Configuration > Personnalisation > Modules et champs pour éviter les noms d'API incorrects. Si vous envoyez des maps imbriquées, assurez-vous que la structure JSON correspond au schéma de l'API Approvals de Zoho.
- Si l'approbation dépend d'enregistrements associés (champs de recherche), confirmez que l'enregistrement associé existe et répond à ses propres critères. Réexécutez l'API après avoir corrigé les champs ou activé le workflow.
- Ajoutez une journalisation pour le corps de la réponse de l'API et tous les objets "details" renvoyés ; ils incluent souvent le champ ou le nom de la règle défaillant. Utilisez ce détail pour cibler les corrections et réessayer.
Quand escalader
Si vous avez vérifié que le processus d'approbation est actif, que les champs de l'enregistrement sont corrects et que la charge utile de l'API correspond aux noms des champs du module, mais que l'erreur persiste, contactez le support Zoho avec l'ID de la requête, la requête/réponse API complète (masquez les secrets) et des captures d'écran de la configuration d'approbation. Le support peut inspecter l'évaluation des règles côté serveur et les journaux au-delà de la réponse de l'API.
[3]: CRM | Dépannage | Base de connaissances (https://help.zoho.com/portal/en/kb/crm/troubleshooting)
[4]: Zoho Learn / exemples communautaires montrant des données invalides et des erreurs de champ API (https://help.zoho.com/portal/en/community)