API Companies - Query : pourquoi les champs customs des établissements ne sont-ils pas retournés ?
Comprendre les limites de l'endpoint Companies - Query et comment récupérer les champs personnalisés
Problème
Lorsqu'on interroge l'API quarksUp via l'endpoint Companies - Query, les champs customs (champs personnalisés créés sur les établissements) ne sont pas inclus dans la réponse, même s'ils sont bien renseignés dans l'interface.
Explication
L'endpoint Companies - Query est conçu pour retourner les propriétés standard des établissements. Les champs customs, créés spécifiquement par votre organisation, ne font pas partie du schéma standard exposé par cet endpoint.
Solutions
Option 1 — Récupérer les champs customs établissement par établissement
Il est possible d'interroger un établissement individuel via un endpoint de type Companies - Get by ID, qui peut inclure les champs customs si l'API le supporte pour ce niveau de détail.
Option 2 — Contacter le support quarksUp
Si vous avez besoin de récupérer les champs customs de tous vos établissements en un seul appel API, contactez le support quarksUp pour :
- Vérifier si une évolution de l'API Companies - Query est prévue pour inclure les champs customs
- Explorer des alternatives (export ETL, rapport décisionnel dédié)
Option 3 — Export via le module Décisionnel
Les champs customs des établissements peuvent souvent être extraits via un rapport personnalisé dans le module Analyser & Piloter, puis exportés en Excel.
En résumé
L'API Companies - Query ne retourne pas les champs customs par défaut. Pour des besoins d'extraction complète, orientez-vous vers un export décisionnel ou contactez le support quarksUp pour étudier les options disponibles.